client-huashang/alert-contract-expiring-hr
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity
Files
04d562745f09956630d8ce4017d18339e5b556b3
alert-contract-expiring-hr/CHANGELOG.md
taojianmin 04d562745f
All checks were successful
技能自动化发布 / release (push) Successful in 6s
Details
chore: auto release commit (2026-09-14 18:23:05)
2026-09-14 18:23:06 +08:00

14 KiB
Raw Blame History

Changelog

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

1.1.10

  • RPA 已登录态检测优化（profile cookie 复用零打扰）
    • SPA_HOME 探针时延长等待：从 POST_LOGIN_SETTLE_MS=2s 改为 SPA_HYDRATION_MS=3s，sandbox SPA 异步验证 cookie 时间更充分，避免误判未登录
    • _fill_spa_login 入口先检测 _is_logged_in：已登录态直接 return True 跳过自动 fill，不再强制 demo fill 破坏 session
    • fill 后再检测 _is_logged_in：避免 sandbox demo 凭据失效时 URL 跳 /app/home 但 cookie 没写入的误判
    • 用户反馈驱动：用户要求「如果已经登录了不需要用户再登录」—— v1.1.8/v1.1.9 的探针逻辑在 sandbox SPA 异步验证 cookie 时机不准时仍会触发 fallback 手工登录；本次彻底修掉
    • 实跑（2026-09-14）：profile 已登录态下，collect-from-platform --show-browser --limit 1 完全静默自动跑（无 [登录] 提示、无弹窗打扰），13 秒抓 3 行 + 卡片 381 字 + 落库

1.1.9

  • RPA headed 模式改用系统 Edge（解决浏览器弹窗不可见）
    • 根因：v1.1.8 headed 模式用 Playwright 内置 chromium，在 Windows 桌面 session 下能创建浏览器对象但 GUI 窗口不可见（子进程 bash session 与用户桌面 session 不同），导致 --show-browser 看似启动 headed 实际用户看不到弹窗、无法手工登录，180s 后 LOGIN_TIMEOUT
    • 修复：headed 模式改为 Playwright channel="msedge" 启动系统 Microsoft Edge（跟用户桌面 session 同源，能真正弹窗）；系统 Edge 缺失时 fallback Playwright 内置 chromium
    • 验证（2026-09-14）：collect-from-platform --show-browser --limit 1 --human-wait-timeout 240 → 系统 Edge 弹出窗口 → 用户手工登录 → RPA 24 秒内检测到 → 抓 3 行合同（钱实验/孙助理/王明远）→ 抓卡片 381 字 → 落库 saved_contracts=1 / downloaded_materials=1
    • 测试：28/28 passed

1.1.8

  • RPA 首次登录采集修复（用户反馈驱动）
    • 不再强制 goto login 打断手工登录态：collect_all 启动时先调 _is_logged_in(page) 检测是否已登录（如 profile cookie 复用）；已登录态直接 goto SPA_HOME，未登录态才走 login → 自动 fill → fallback 手工登录等待
    • 首次登录后不再强制 page.reload：原 5.5 步骤「刷新触发 mock 数据」会打断刚登录的 SPA session，导致 sandbox 把已登录态踢回 login；改为默认不刷新，表格等 10s 未出现才触发兜底刷新（5.5/5.6 逻辑下沉到 _try_reload_after_table_timeout，仅在表格超时调用）
    • 表格列数自适应：sandbox 首次登录未刷新时表格是 7 列（姓名/单位/到期日/剩余天数/预警/建议/按钮），刷新后才是 10 列（多 工号/岗位/合同类型/起止日期）；原代码硬编码 10 列解析 → 7 列时 r[7]/r[8] IndexError。改为「首列匹配工号正则 ^[A-Za-z]?\d+$ 走 10 列，否则走 7 列」双布局自适应
    • contract_id 派生兼容 7 列：7 列布局无工号 → 用 teacher_name 派生 contract_id（如 RPA-钱实验-20260415），避免与 10 列工号布局冲突
  • 实跑验证（2026-09-14）
    • 命令：python scripts/main.py collect-from-platform --show-browser --limit 1 --human-wait-timeout 180
    • 结果：自动 fill demo 失败 → fallback 手工登录 → 你登录后 RPA 不刷新直接跳 hr/contracts → 抓 3 行（钱实验/孙助理/王明远）→ 抓卡片 381 字 → 落库 saved_contracts=1 / downloaded_materials=1
    • 退出码 0

1.1.7

  • RPA 手工登录 fallback 实跑验证（2026-09-14）
    • sandbox 演示账号 demo/123456 已失效（多次尝试 + 6 组常见 demo 凭据全部返回「用户名或密码错误」），按 v1.1.6 设计自动切到 _wait_for_manual_login 手工登录分支
    • 实跑命令：python scripts/main.py collect-from-platform --show-browser --limit 1 --human-wait-timeout 180
    • 实跑结果：用户在弹出浏览器手工登录后，RPA 第 1 次轮询（≤2s）即检测到 /app/home URL，跳过登录分支继续往下走：
      • 自动导航侧边栏 hr/contracts → page.reload() 触发 mock 数据
      • 抓到 3 行合同（钱实验 / 孙助理 / 王明远）
      • 首行「续聘材料包」卡片抓 870 字文本 → 4 条业绩记录
      • 落库 contracts + materials_content：saved_contracts=1, downloaded_materials=1
    • 结论：v1.1.6「自动 fill + 手工 fallback」设计 已端到端验证；后续 collect-from-platform 默认带 --show-browser 走手工登录入口（避免硬编码失效 demo 凭据）
    • 流程记录见 memory platform-collect-workflow.md

1.1.6

  • RPA 重构（按 skill-template examples/real_browser_rpa 设计模式）
    • 超时参数统一抽到 constants.py：新增 HUMAN_WAIT_TIMEOUT=180 / HUMAN_POLL_INTERVAL=2.0 / DEFAULT_PAGE_TIMEOUT_MS=15s / GOTO_TIMEOUT_MS=60s / SPA_LOGIN_* / TABLE_* / SIDEBAR_LINK_TIMEOUT_MS 等 24 个常量（与 skill-template human_verification 同名常量对齐）
    • 新增手工登录 fallback：自动 fill demo/123456 失败时自动切到 _wait_for_manual_login（轮询 _is_logged_in 每 2s 一次，最多 HUMAN_WAIT_TIMEOUT 秒，超时抛 LoginTimeoutError），给用户手工登录机会（与 skill-template task_rpa.py::_ensure_logged_in 设计对齐）
    • 结构化错误码：RPAError 基类 + LoginTimeoutError（ERROR:LOGIN_TIMEOUT）/ MissingBrowserError（ERROR:MISSING_BROWSER）/ TableNotFoundError（ERROR:TABLE_NOT_FOUND），供 CLI/宿主解析
    • CLI 新增 --human-wait-timeout N flag
    • _goto 默认 timeout 改用 GOTO_TIMEOUT_MS=60s；新增 page.set_default_timeout(DEFAULT_PAGE_TIMEOUT_MS)
  • 依赖清单修复：删除 requirements.txt 中违规的 playwright>=1.40.0（playwright 由宿主 jiangchang_skill_core runtime 提供，文件顶部注释已声明）
  • 环境变量：.env.example 新增 HUMAN_WAIT_TIMEOUT / RPA_PAGE_TIMEOUT_MS / RPA_GOTO_TIMEOUT_MS 覆盖项
  • 保留 v1.1.5 自动 fill 优势：sandbox demo/123456 已知凭据自动登录（生产环境切换无 demo 凭据时自动 fallback 手工）

1.1.5

  • platform_collector RPA 采集修复（登录等待时间太短 → 拿不到数据）
    • _fill_spa_login：settle_ms 默认 0 → 4000ms，等 username input timeout 10s → 20s，wait_for_url（URL 真的跳离 login）20s → 30s；URL 判断增加 /auth/ 路径（覆盖 SPA 中间态）
    • _goto(SPA_LOGIN_URL) 后：wait 1500ms → 3000ms（SPA hydration）
    • 登录按钮 click 后：新增 wait_for_timeout(2000)，等 SPA token 写入 cookie + 路由稳定再 goto home（之前直接打断 pending 跳转）
    • 步骤 4 改为 retry 循环（最多 2 次），检查 /app/ in url 且不含 /login 才退出
  • 采集流程健壮性修复
    • 步骤 5 侧边栏 link 等待：15s → 30s（sandbox mock 慢启动不 fallback 到 pushState）
    • 步骤 5.5 page.reload() timeout：20s → 30s
    • 新增 5.6：刷新后检查 URL，若被踢回 /login 则重新登录一次（之前刷新丢 session 后还继续往后走，导致 40s 找不到表格）
    • 「续聘材料包」按钮 click 后：wait 1500ms → 3000ms（卡片动画慢导致文本抓不全）
    • 抽出 _dump_page(page, path, label) helper，自动 mkdir(parents=True)，修复 5 处 dump 路径父目录可能不存在的静默失败

1.1.4

  • 多平台发布声明：SKILL.md metadata.openclaw.brands 新增 jiangchang + huashang，发布后同步挂匠厂主站与华商 OEM 市场。CI 会幂等补写 skill_market_relations 两行（只补不删）。

1.1.3

  • 版本对齐修复：v1.1.2 tag（commit 4af2b4f）发布时 SKILL.md version / scripts/util/constants.py SKILL_VERSION 未同步升级（仍为 1.1.1），本次发布将 manifest 升至 1.1.3 并与代码现状对齐
  • 内容同 v1.1.2：sandbox 卡片采集功能（详见 1.1.2 条目）

说明：v1.1.2 与 v1.1.3 实质内容相同（均含 sandbox 卡片采集）。v1.1.2 tag 视为已发布但 manifest 错位的历史遗留；v1.1.3 为首次 manifest 版本号与代码对齐的 release tag。

1.1.2

  • sandbox 卡片采集：表格 10 列（工号/姓名/单位/岗位/合同类型/起止日期/剩余天数/预警/建议/材料包按钮），进入 hr/contracts 页面后 page.reload() 刷新触发 mock 数据加载
  • 「续聘材料包」按钮行为：不触发浏览器 download event，而是展开页面下方「续聘准备任务书」+「单位清单」卡片（含 checklist + 近三年考核表）。RPA 改为抓卡片 inner_text 存 materials_content（parse_method='sandbox_card'）
  • 卡片文本解析进 performance_records：新增 repository.parse_sandbox_card_performance（双模式正则：行格式 2024\t称职 + 叙述式 2024年：等次「称职」）+ repository.upsert_performance_record（等次→分数：优秀=90 称职=75 基本称职=60 不称职=30）
  • contract_id 改用工号（稳定，不随姓名变化）：_gen_contract_id(emp_id, end_date)
  • 实测（sandbox 3 合同）：
    contract_id 教师 解析 perf 条数 AI 决策
    RPA-T20190033-20260415 钱实验 4 observe
    RPA-T20200055-20260630 孙助理 6 observe
    RPA-T20180021-20260831 王明远 6 observe

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 补全
Reference in New Issue View Git Blame Copy Permalink