client-huashang/alert-contract-expiring-hr
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity
Files
a3b4092a306cfd2378bde3a9b342fea8d944b56f
alert-contract-expiring-hr/CHANGELOG.md
taojianmin a3b4092a30 v1.1.1: 升级 AI 续聘建议为 LLM + Playwright RPA 采集 SmartCampus 平台材料 
新增：

- scripts/service/platform_collector.py：Playwright RPA（持久化 browser profile 复用登录态），抓合同表（姓名/单位/到期日/剩余天数/预警/建议），逐行点"续聘材料包"按钮下载 PDF/Word 到 data/materials/

- scripts/service/material_parser.py：PDF/Word 文本提取（pypdf → pdf2image + pytesseract OCR 扫描件兜底；python-docx 抽 docx；antiword 兜底 .doc）

- scripts/service/llm_decision.py：AI 决策统一入口（优先调宿主 jiangchang_skill_core.llm_manager.call_llm_json；本地降级到规则版；输出 decision_source ∈ {llm, rules, rules_no_materials}）

- scripts/db/migrations.py：idempotent ALTER/CREATE，建 materials_content 表 + renewal_tasks 加 decision_source / materials_summary 列

修改：

- scripts/db/connection.py：init_db() 自动调 apply_all() 应用 v1.1.1 迁移

- scripts/db/repository.py：加 insert_material / list_materials_for_contract / list_pending_materials / summarize_materials / get_task_full

- scripts/service/task_generator.py：AI 决策统一改为调 llm_decision.decide_suggestion(materials_summary=...)；reason 文案加「已结合材料包（X 份文件，Y 字 / 待解析）综合判断：...」

- scripts/service/html_renderer.py：ctx 加 DECISION_SOURCE（LLM 推理 / 本地规则 / 本地规则（无材料））+ MATERIALS_COUNT

- scripts/templates/task.html.j2：footer 加 "AI 建议来源：{{DECISION_SOURCE}} · 已审阅材料 {{MATERIALS_COUNT}} 份"

- scripts/cli/app.py：新增 2 个 CLI（collect-from-platform / parse-materials）；现有 9 个不动

- 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 / LLM_API_BASE_URL / LLM_API_TOKEN

- SKILL.md：version 1.1.0 → 1.1.1；用户意图路由表加 2 行；新增「数据来源」段（三层来源 + AI 决策透明化）

- README.md：使用前要准备 → 加 playwright install chromium 步骤

- CHANGELOG.md：v1.1.1 条目

- scripts/util/constants.py：SKILL_VERSION 1.1.0 → 1.1.1

本地验证：11 个 CLI 全部 exit 0；decision_source=rules；reason 含「已结合材料包（6 份文件，待解析）」；HTML footer 含决策来源。

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-09-14 15:01:24 +08:00

4.2 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]
  • 材料包 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 补全
Reference in New Issue View Git Blame Copy Permalink