← 返回主页 ↑ 顶部

📚 深圳公积金追讨 Agent · 使用文档

基于《住房公积金管理条例》和深圳市住房公积金管理中心公开信息构建的查询 + 证据整理工具。

项目简介

本工具帮助深圳职工解决单位未缴/少缴住房公积金的追讨问题,提供三大能力:

🔍 查询 Agent

基于关键词路由的知识库问答,覆盖法规、渠道、时限、处罚等 7 类问题。

📋 证据模块清单

6 大类、33 项证据的勾选清单,自动跟踪收集进度。

📷 截图识别 (m3 Vision)

上传工资条/合同/聊天截图,自动识别并匹配证据项。

快速开始

# 1. 安装依赖
pip install -r requirements.txt

# 2. 启动服务
python agent.py

# 3. 打开浏览器
http://localhost:8765

环境要求:Python ≥ 3.10,ANTHROPIC_BASE_URL 指向 MiniMax 兼容端点(已在 ~/.claude/settings.json 配置)。

✅ 视觉识别需要有效 API Key。/api/health 可检查 vision 模型是否可用。

功能架构

┌──────────────────────────────────────────────────────────┐
│                    浏览器 (index.html)                    │
├──────────────┬───────────────────────────┬───────────────┤
│ 左侧:证据模块 │    中间:对话查询          │ 右侧:截图识别  │
│  33 项勾选   │   关键词路由 + 知识库     │  m3 Vision    │
│  进度同步    │   7 类意图匹配            │  自动勾选     │
└──────┬───────┴─────────────┬─────────────┴───────┬───────┘
       │ POST /api/check     │ POST /api/query     │ POST /api/recognize
       ▼                     ▼                     ▼
┌──────────────────────────────────────────────────────────┐
│              FastAPI 后端 (agent.py)                     │
├──────────────────────────────────────────────────────────┤
│  knowledge.py ── 知识库(法规/流程/证据模块)              │
│  state.json   ── 勾选状态持久化                          │
└──────────────────────────────────────────────────────────┘
                          │
                          ▼
                  ┌───────────────┐
                  │  MiniMax-M3   │
                  │  Vision API   │
                  └───────────────┘

证据模块

深圳公积金追讨所需证据分为 6 大类,共 33 项:

① 主体身份证据 (4 项)

② 劳动关系证据 (6 项)

③ 工资基数证据 (6 项)

④ 公积金缴存证据 (4 项)

⑤ 单位违规证据 (5 项)

⑥ 程序性文书 (8 项)

截图识别 (m3 Vision)

右侧栏拖拽上传证据截图,系统自动完成:

上传截图 → base64 编码 → m3 Vision → 提取文字 → 匹配模块
⚠️ 隐私提示:截图会发送给 m3 视觉 API。涉及敏感信息(身份证、银行卡)建议打码后再上传。

公积金追讨完整流程

从发现单位违规到最终追回公积金的完整路径:

① 发现违规 → ② 收集证据 → ③ 行政投诉 → ④ 责令补缴
⑤ 单位补缴 ↗ 完成 ↘ 拒不执行
⑥ 法院强制执行 → ⑦ 行政处罚 → ⑧ 信用惩戒

关键时限

环节时限
行政处理决定受理之日起 60 日 内作出
行政复议申请收到决定后 60 日 内
行政诉讼收到决定后 6 个月 内
申请法院强制执行3 个月 内
12345 热线处理一般 30 工作日,复杂 60 工作日
公告送达登报之日起 60 日 视为送达

操作步骤

  1. 打开主页 → http://localhost:8765
  2. 查看证据模块 → 左侧 6 类清单,了解需要收集什么
  3. 上传截图识别 → 右侧拖拽上传工资条/合同/银行流水等,m3 自动识别 + 自动勾选
  4. 手动补充勾选 → 左侧对识别遗漏的纸质证据手动打勾
  5. 查询具体问题 → 中间对话框输入,如"投诉渠道"、"处理时限"、"罚款多少"
  6. 跟进进度 → 右侧进度面板查看整体完成度
  7. 拨打 12329 预约窗口投诉 → 携带身份证、劳动合同、工资流水原件
  8. 关注公众号跟踪 → "深圳市住房和建设局" → "业务办理-快速查(案件信息查询)"

法律依据

⚠️ 2026 年 8 月修订版拟将罚款上限提至 5万~30万,待核实生效日期。

常见问题

Q1:能追溯多少年的公积金?

深圳目前无明确统一规定。行政处理无时效限制,民事路径适用《民法典》3 年诉讼时效。建议拨打 0755-12329 或现场咨询个人案件。

Q2:外地户籍离职怎么提取?

账户封存满 6 个月 且未在本地重新开户 → 销户提取。材料:身份证、离职证明、银行卡。

Q3:单位说"试用期内不缴公积金"合法吗?

不合法。《住房公积金管理条例》第十五条规定:单位应为在职职工缴存,不区分试用期。

Q4:投诉会被单位知道吗?

会。公积金中心需向单位送达责令补缴通知。如担心,可先通过 12345 匿名反映线索。

Q5:截图识别准确率怎么样?

典型场景(工资条、合同、流水)准确率较高,置信度通常 ≥ 0.85。低质量截图或复杂版面可能误判,建议核对后手动调整勾选。

Q6:数据存在哪里?会泄露吗?

勾选状态存于本地 state.json。截图发送给 m3 Vision API (MiniMax) 处理,不在本地留存原图。如需归档请自行备份。

联系渠道

渠道联系方式
公积金热线0755-12329 (转人工)
政务热线12345
官网gjjjjzx.sz.gov.cn
微信公众号"深圳市住房和建设局"
深圳市政府互动sz.gov.cn/hdjlpt

⚖️ 本工具仅提供信息整理和证据跟踪辅助,不构成法律意见。复杂案件建议咨询专业律师。