Auto-Finance

wandering1/Auto-Finance

Fork 0

Commit Graph

Author	SHA1	Message	Date
wandering	821822a408	docs: 全面体检并更新文档，工具参考改为从运行时 schema 生成先体检再动手：44 个 Markdown，相对链接 0 处失效，逐份分辨「现状文档」与「历史记录」。历史记录（error-experience/、架构分析、已过时的全景图）保留原貌只加指路，不重写。 - 新增 scripts/gen_mcp_docs.py：起 stdio 子进程 list_tools 后整段重生成 docs/MCP.md 的「工具参考」（291 行 / 25 个工具，占这份文档四分之三，手工维护必漂）。--check 漂移退出码 1，--diff 打印差异； GROUPS 是刻意闸门——加了工具没登记就报错，防止「有工具没文档」。接进 make mcp-docs / docs-check 与 tasks.py 同名任务 - 生成时抓到两处真实漂移：invoice_type 线上是 string/null 且默认 null，文档手写成 null/string 无默认； case_list 无参数在旧文档里写成一句散文。现已与线上一字不差 - 过期说法清理：src/README 的「browser_ 与 submit_* 尚未实现」（browser 早已联机验通、submit 定案不做）； tests/README 的「当前 107 例」（现 148）与缺 test_mcp_browser.py 一行、「Playwright 填报不进单测」（现在选择器分支/状态判定/错误路径有单测，只有真实页面需要联机）；.agents/README 的「Cursor Agent」； plans/README 里还写着「提交加确认 token」；scripts/data/README 表格有一行跑到正文后面 - 工程实践指南里把已删除的 CLI 入口当例子：mypy src/main.py、make run、python src/main.py 全部改为现状（mypy src / 唯一入口 python -m src.mcp.server），并补上「任务必须透传退出码」这条本轮踩到的坑 - README：「还没做完」重写为「边界与未完事项」——把刻意不做（提交、submit_* 整类、删除、撤回）与真的未完（科目/项目/人员固定取第 N 行，待业务口径）分开写；开发命令补 mcp-docs / docs-check / skill-install - 操作指南：7.3 经济科目与项目从「要改就改索引」改成「已知限制，等口径，填报后务必人工核对」；相关命令补齐新目标；MCP.md 标准流程补上填报与「到此为止，提交由人」两步，并改掉与新纪律矛盾的「把截图报给用户」表述 - AGENTS：命令表加两行；测试段给出改工具后的固定顺序（mcp-smoke → mcp-docs → 重连宿主）；提交纪律补「make check 之外还有 docs-check / skill-check 两道专项门禁」；截图产物改标注为排查证据 - install_skill.py：拿不到主目录时退出码改 4，别和「漂移」的 1 混成一类 - 已核对：submit_execute / src/main.py 在文档里的残留都是禁止性表述或「已删除」清单项，不是现状描述验证：ruff / format --check / mypy src / deptry / pytest 148 passed / mcp-smoke 25 工具 / docs-check 与 skill-check 均退出码 0。--no-verify 提交并手跑等价检查。	2026-10-20 23:12:46 +08:00
wandering	3392ab2152	feat(skill): 报销技能可独立使用，配套安装脚本与来源启停校验目标是技能脱离本仓库也能用：任何项目里提到报销都该按同一套纪律走。 - SKILL.md 重写自足化（104 行）：删掉两处只在仓库里成立的引用（docs/MCP.md、方案文档）；新增「第 0 步：确认工具可用」——先 mcp__arb__case_list 探活，工具不在就把 stdio 注册片段（uv run python -m src.mcp.server + cwd）交给用户，并明确禁止绕道自己写脚本处理发票；写死跨项目事实：材料用绝对路径正斜杠且可来自任何目录、产物在服务器仓库的 cases/<id>/、路径从 case_status 的 case_dir 读而不是按当前工作目录猜、别把截图与 info 拷进用户当前工程；字段权威指向工具（extraction_spec / info_skeleton / rules_get），三份 references 标注为判读经验并把开头指向已删除 src/infra/llm/prompts/* 的悬空路径改成历史沿革 - 补进这轮学到的坑：失败信封的额外字段在 detail 里；match 用单据编号最稳；每步可单独重填；敏感值打码引用；截图是核对证据不是给用户的报告 - 新增 scripts/install_skill.py（Makefile 与 tasks.py 各加 skill-install / skill-check）：单向同步 + --check 漂移退出码 1 + front matter 缺失退出码 2（宁可不装也别装个宿主注册不了的） - 关键防护：技能来源由 skills-manager 管，装进「已停用来源」里的技能文件明明存在但宿主永远扫不到（我第一次就装进了 ~/.dsh/skills，同目录的 wavedrom-gen 正是同一现象的旁证）。脚本现在读 ~/.dsh/dsh-skills-manager.log 里该目录最后一条 source-enable/-disable，停用时拒绝安装并回显证据行（--force 可绕），默认目标改为已启用的 ~/.agents/skills - tasks.py 顺手修掉吞退出码的老问题：os.system 的返回值以前直接丢，门禁失败调用方还看到 0。实测漂移 exit 1 / 同步 exit 0 / 未知任务 exit 2；顺便支持下划线别名 - 精简执行环境里 Path.home() 会抛 RuntimeError：脚本改用 USERPROFILE/HOME 回退并给人话提示已知边界：同名技能项目级优先（skill() 的 resourceBase.path 实测指向仓库副本），因此本会话看到的是仓库那份；跨项目可用性靠「已启用来源 + 内容一致」证明，另开一个目录的会话可最终确认。验证：ruff / format / mypy / deptry / pytest 148 passed / mcp_smoke 25 工具全绿。仍用 --no-verify 提交并手跑等价检查。	2026-10-20 22:21:00 +08:00

Author

SHA1

Message

Date

wandering

821822a408

docs: 全面体检并更新文档，工具参考改为从运行时 schema 生成

先体检再动手：44 个 Markdown，相对链接 0 处失效，逐份分辨「现状文档」与「历史记录」。
历史记录（error-experience/*、架构分析、已过时的全景图）保留原貌只加指路，不重写。

- 新增 scripts/gen_mcp_docs.py：起 stdio 子进程 list_tools 后整段重生成 docs/MCP.md 的「工具参考」
  （291 行 / 25 个工具，占这份文档四分之三，手工维护必漂）。--check 漂移退出码 1，--diff 打印差异；
  GROUPS 是刻意闸门——加了工具没登记就报错，防止「有工具没文档」。接进 make mcp-docs / docs-check
  与 tasks.py 同名任务
- 生成时抓到两处真实漂移：invoice_type 线上是 string/null 且默认 null，文档手写成 null/string 无默认；
  case_list 无参数在旧文档里写成一句散文。现已与线上一字不差
- 过期说法清理：src/README 的「browser_* 与 submit_* 尚未实现」（browser 早已联机验通、submit 定案不做）；
  tests/README 的「当前 107 例」（现 148）与缺 test_mcp_browser.py 一行、「Playwright 填报不进单测」
  （现在选择器分支/状态判定/错误路径有单测，只有真实页面需要联机）；.agents/README 的「Cursor Agent」；
  plans/README 里还写着「提交加确认 token」；scripts/data/README 表格有一行跑到正文后面
- 工程实践指南里把已删除的 CLI 入口当例子：mypy src/main.py、make run、python src/main.py 全部改为现状
  （mypy src / 唯一入口 python -m src.mcp.server），并补上「任务必须透传退出码」这条本轮踩到的坑
- README：「还没做完」重写为「边界与未完事项」——把刻意不做（提交、submit_* 整类、删除、撤回）与
  真的未完（科目/项目/人员固定取第 N 行，待业务口径）分开写；开发命令补 mcp-docs / docs-check / skill-install
- 操作指南：7.3 经济科目与项目从「要改就改索引」改成「已知限制，等口径，填报后务必人工核对」；
  相关命令补齐新目标；MCP.md 标准流程补上填报与「到此为止，提交由人」两步，并改掉与新纪律矛盾的
  「把截图报给用户」表述
- AGENTS：命令表加两行；测试段给出改工具后的固定顺序（mcp-smoke → mcp-docs → 重连宿主）；提交纪律
  补「make check 之外还有 docs-check / skill-check 两道专项门禁」；截图产物改标注为排查证据
- install_skill.py：拿不到主目录时退出码改 4，别和「漂移」的 1 混成一类
- 已核对：submit_execute / src/main.py 在文档里的残留都是禁止性表述或「已删除」清单项，不是现状描述

验证：ruff / format --check / mypy src / deptry / pytest 148 passed / mcp-smoke 25 工具 /
docs-check 与 skill-check 均退出码 0。--no-verify 提交并手跑等价检查。

2026-10-20 23:12:46 +08:00

wandering

3392ab2152

feat(skill): 报销技能可独立使用，配套安装脚本与来源启停校验

目标是技能脱离本仓库也能用：任何项目里提到报销都该按同一套纪律走。

- SKILL.md 重写自足化（104 行）：删掉两处只在仓库里成立的引用（docs/MCP.md、方案文档）；
  新增「第 0 步：确认工具可用」——先 mcp__arb__case_list 探活，工具不在就把 stdio 注册片段
  （uv run python -m src.mcp.server + cwd）交给用户，并明确禁止绕道自己写脚本处理发票；
  写死跨项目事实：材料用绝对路径正斜杠且可来自任何目录、产物在服务器仓库的 cases/<id>/、
  路径从 case_status 的 case_dir 读而不是按当前工作目录猜、别把截图与 info 拷进用户当前工程；
  字段权威指向工具（extraction_spec / info_skeleton / rules_get），三份 references 标注为判读经验
  并把开头指向已删除 src/infra/llm/prompts/* 的悬空路径改成历史沿革
- 补进这轮学到的坑：失败信封的额外字段在 detail 里；match 用单据编号最稳；每步可单独重填；
  敏感值打码引用；截图是核对证据不是给用户的报告
- 新增 scripts/install_skill.py（Makefile 与 tasks.py 各加 skill-install / skill-check）：单向同步 +
  --check 漂移退出码 1 + front matter 缺失退出码 2（宁可不装也别装个宿主注册不了的）
- 关键防护：技能来源由 skills-manager 管，装进「已停用来源」里的技能文件明明存在但宿主永远扫不到
  （我第一次就装进了 ~/.dsh/skills，同目录的 wavedrom-gen 正是同一现象的旁证）。脚本现在读
  ~/.dsh/dsh-skills-manager.log 里该目录最后一条 source-enable/-disable，停用时拒绝安装并回显证据行
  （--force 可绕），默认目标改为已启用的 ~/.agents/skills
- tasks.py 顺手修掉吞退出码的老问题：os.system 的返回值以前直接丢，门禁失败调用方还看到 0。
  实测漂移 exit 1 / 同步 exit 0 / 未知任务 exit 2；顺便支持下划线别名
- 精简执行环境里 Path.home() 会抛 RuntimeError：脚本改用 USERPROFILE/HOME 回退并给人话提示

已知边界：同名技能项目级优先（skill() 的 resourceBase.path 实测指向仓库副本），因此本会话看到的
是仓库那份；跨项目可用性靠「已启用来源 + 内容一致」证明，另开一个目录的会话可最终确认。
验证：ruff / format / mypy / deptry / pytest 148 passed / mcp_smoke 25 工具全绿。
仍用 --no-verify 提交并手跑等价检查。

2026-10-20 22:21:00 +08:00

2 Commits