client-huashang/alert-contract-expiring-hr

Files

taojianmin 2f06291270 v1.1.1 final: 标注「续聘材料包」功能待 sandbox 部署

当前 sandbox mock 未部署「续聘材料包」按钮：
- RPA 仅采集 6 列台账（姓名/单位/到期日/剩余天数/预警/建议）
- 材料下载代码已就绪，sandbox 补按钮后自动生效
- parse-materials CLI + material_parser 链路可用（本地放 PDF/Word 即可）

更新：
- SKILL.md: 数据来源章节标注 sandbox 材料按钮缺失
- CHANGELOG.md: v1.1.1 条目加实测结果 + sandbox 状态说明

Co-Authored-By: Claude Code <noreply@anthropic.com>

2026-09-14 15:37:40 +08:00

4.5 KiB

Raw Blame History

Changelog

本文件对应技能市场 「更新日志」 Tab。

1.1.1

AI 续聘建议升级：本地规则版 → LLM 优先 + 规则降级
- 新增 scripts/service/llm_decision.py：调宿主 jiangchang_skill_core.llm_manager.call_llm_json（prompt 含教师信息 + 业绩 + 材料文本摘要），输出 decision_source ∈ {llm, rules, rules_no_materials}
- scripts/service/task_generator.py：AI 决策统一改为调 llm_decision.decide_suggestion；降级版 reason 文案加「已结合材料包（含 X 个文件，Y 字内容）」前缀
SmartCampus HR 平台 RPA 采集（新增）
- 新增 scripts/service/platform_collector.py：Playwright 持久化 browser profile 复用登录态 → 抓合同表（姓名/单位/到期日/剩余天数/预警/建议） → 点"续聘材料包"按钮下载 PDF/Word → 落库
- 平台：https://sandbox.jc2009.com/industries/campus/smartcampus/app/hr/contracts
- 新增 CLI collect-from-platform [--limit N] [--show-browser]
- 当前 sandbox mock 未部署「续聘材料包」按钮，RPA 仅采集 6 列台账；材料下载代码已就绪，sandbox 补按钮后自动生效
- 实测：headless 模式 + profile cookie 复用，抓 3 行合同（钱实验/孙助理/王明远）→ 落 contracts 表
材料包 PDF/Word 文本提取（新增）
- 新增 scripts/service/material_parser.py：pypdf → pdf2image + pytesseract OCR（扫描件兜底）；python-docx 抽 docx；antiword 兜底 .doc
- 新增 CLI parse-materials [--contract-id C001]
数据模型扩展
- 新增表 materials_content（contract_id / file_name / file_path / extracted_text / parse_method / parsed_at）
- renewal_tasks 加列：decision_source / materials_summary
- 新增 scripts/db/migrations.py：idempotent ALTER/CREATE，init-db 自动应用
HTML 任务书升级
- scripts/templates/task.html.j2 footer 加 "AI 建议来源：{{DECISION_SOURCE}} · 已审阅材料 {{MATERIALS_COUNT}} 份"
- scripts/service/html_renderer.py 模板 ctx 加 DECISION_SOURCE / MATERIALS_COUNT
CLI 列表：v1.1.0 的 9 个 + 2 个新增 = 11 个
- 新增：collect-from-platform / parse-materials
依赖新增（requirements.txt）：playwright / pypdf / python-docx / pdf2image / pytesseract / Pillow
.env.example 新增项：SMARTCAMPUS_BASE_URL / SMARTCAMPUS_PROFILE_DIR / MATERIALS_DOWNLOAD_DIR / OCR_LANG / LLM_MODEL_NAME
SKILL.md：version 1.1.0 → 1.1.1；用户意图路由表加 2 行；加「数据来源」段说明三层来源 + AI 决策来源透明化

1.1.0

实现核心业务逻辑（9 个 CLI 命令全部可运行）
新增 scripts/cli/app.py：argparse 子命令分发
新增 scripts/util/{constants,date_util,runtime_paths,logging_setup}.py
新增 scripts/db/{connection,seed_data,repository}.py：SQLite + 5 张表 + 50 份样例合同 + 150 条业绩记录
新增 scripts/service/scanner.py：扫描核心（90/60/30 三级预警 + 写 alerts + 生成任务）
新增 scripts/service/task_generator.py：规则版 AI 续聘建议（师德/考核/趋势三规则）
新增 scripts/service/dispatcher.py：按单位/月份派发 payload（dry-run 模式）
新增 scripts/service/html_renderer.py：Jinja2 任务书 HTML 渲染（无 jinja2 时降级到 str.replace）
新增 scripts/templates/task.html.j2：任务书模板（基于 assets/html/example-report.html）
新增 examples/{contracts_sample,performance_sample}.csv：本地样例数据
scripts/main.py：重写为降级模式（jiangchang_skill_core 可选）
.env.example：新增 DB_PATH / HTML_OUTPUT_DIR / JIANGCHANG_DATA_DIR
验收：本地 python scripts/main.py <cmd> 9 个命令全部 exit code = 0

1.0.1

初版：基于匠厂 skill-template 主仓 v1.0.108 派生
实现核心业务：合同到期智能预警与续聘辅助（每日定时扫描 + 三级预警 + 个人版任务书 + 单位版清单 + 自动抄送）
输出形态：合同台账表状态更新 + 预警记录表 + 个人版 HTML 任务书 + 单位版 PDF 清单 + 派发日志
预期提效：因合同逾期未续签导致的劳动纠纷降为 0；人事处年终集中突击签合同的工作量减少 60%
业务行生命周期：可预警 → 预警中 → 已续签 / 已驳回 / 已过期
占位说明：本版仅完成骨架与文档，业务实现细节（scripts/ 下 Python 模块、人事系统 API 对接、定时调度）由开发者后续按 development/REQUIREMENTS.md 补全

4.5 KiB Raw Blame History Unescape Escape

Changelog

1.1.1

1.1.0

1.0.1

4.5 KiB

Raw Blame History