taojianmin
a3b4092a30
新增：
- 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>
54 lines
4.2 KiB
Markdown
54 lines
4.2 KiB
Markdown
# 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` 补全
|