前言¶
在 DeepSeek Harness（DSH）里做业务自动化时，常见需求是把订单表、结算表等源数据填进公司已有的 Excel 模板，并在导出前核对金额与异常。手工复制粘贴容易漏行、难追溯；纯脚本改 xlsx 又常破坏样式、合并单元格或公式。社区插件 dsh-sheetflow（维护者 Lostforest7，分类：工作流）面向「固定模板 + 可重复规则 + 人工确认异常」这一类流程：先定义映射，预览每一次写入，逐条审阅对账异常，再导出模板副本，并附带 HTML 报告与 JSON 追溯。
这是什么¶
DSH SheetFlow 是 DeepSeek Harness 的独立社区插件（非 DeepSeek / 幻方官方应用）。一句话定位：Fill recurring Excel templates, review reconciliation exceptions, and trace every value to its source（填写周期性 Excel 模板、复核对账异常、将每个数值追溯到来源）。
目录页：skillhub.cn/plugins/Lostforest7/dsh-sheetflow
源码：github.com/Lostforest7/dsh-sheetflow
当前为 v0.1.0-pre 预览版（package.json 版本 0.1.0，MIT 许可证）。README 注明在 Windows、Node 24.19.0、DSH Web 0.2.0-rc.2 上做过验证；中英文工作台可用。插件协助数据准备与对账审阅，不提供会计、税务或财务建议，也不是会计系统；AI 映射与导出的金额、公式、异常均需独立复核后再用于业务。
核心功能¶
以下能力均来自项目 README，预览版有明确范围限制（见后文「适用场景与注意」）。
显式映射
为每个数据源指定文件、工作表、表头行、匹配键、金额字段，以及模板中预留的可写单元格区域。
精确小数比较
金额按两位小数比较，可选容差；支持分笔付款聚合。空白金额视为不可用。
可解释的异常
缺失记录、重复键、无效输入、金额差异等异常保留来源文件 / 工作表 / 行 / 单元格证据，便于人工判断。
模板副本
导出时尽量保留原 ZIP 部件与单元格样式，保护公式单元格与合并区域，并预览清除旧的无用行。
可重复配方（recipe）
规则可保存、导入、导出；表头变更会使复用的规则停止生效。本地历史按工作区与 DSH 会话隔离。
人工审阅
导出前每条异常必须被「确认（acknowledge）」；输入变更会使审阅失效。确认仅表示已检查，不表示异常已解决或付款已批准。
DSH 工具集成
AI 可在有界样本上检查并提交 proposed recipe；执行、确认与导出仍由工作台操作完成。
本地三步试用¶
不安装 Microsoft Excel、也不配置模型 API Key 即可跑内置样例。Node 需 24，或 22.x 且 ≥22.19.0。
在解压后的源码目录执行：
# Run in the extracted source folder
npm ci --cache .cache/npm
npm run build
npm run dev
终端会打印本地 URL。打开后选择 Load sample mapping，确认映射，再 Generate preview。样例共八条记录：两条匹配、六条异常。查看证据并对全部异常确认后导出；新的 .xlsx、.html、.json 会保存在输入旁的 examples/month-end/。独立预览用于验证规则执行；AI 提案在 DSH 内使用。
在 DSH 中安装与启用¶
- 按 DSH 官方说明 安装并配置 DSH。在本插件源码目录用上一节的命令完成
npm ci、npm run build，再注册插件：
dsh plugin --profile web add /absolute/path/to/dsh-sheetflow
# A built .tgz can be registered with the same command.
dsh web
-
在 DSH 中选择包含两张源表与模板的工作区；试用可指向插件内的
examples/month-end。打开 SheetFlow 填表台，需要时可切换英文界面。 -
确认映射与可写区域，生成预览，检查异常后导出新副本。若需 AI 辅助：发送映射说明，等待当前 DSH 会话结束，再选 Load proposal 并确认。
建议将 .dsh-sheetflow/ 以及生成的 sheetflow-*.xlsx、sheetflow-*.html、sheetflow-*.json 加入业务工作区 .gitignore；历史与报告可能含业务数据。确定性处理时输入文件留在本地；使用 AI 时，你提供的说明、有界样本与检查结果会经你配置的 DSH 模型提供商发送。
典型用法要点¶
起步材料：一张订单表、一张结算表、一份已有业务模板。流程是：确认映射一次 → 预览每次写入 → 审阅每条异常 → 导出模板副本 + HTML 报告 + JSON trace。
高级入口可导入其他 fixture 的 recipe.json。例如 README 提到将 SHEETFLOW_WORKSPACE 设为 examples/next-month 后 npm run dev，可演示 0.10 + 0.20 = 0.30 等场景；supplier 示例涉及另一张表、行范围与预填模板。
支持范围（预览版）：普通 .xlsx 模板；源为 .xlsx 或 UTF-8 逗号分隔 .csv；每个源一个键、一个两位小数金额；共享币种与业务期间；固定预留可写区；多源可为同一工作簿的不同 sheet。Recipe 按 DSH 会话保存，跨环境用 JSON 传递。
不包含：不计算 Excel 公式、不做币种换算、不做模糊匹配或多对多对账、不做 OCR/PDF；不插入模板行。公式保留并会使缓存失效——在 Excel 中打开副本并强制重算后再依赖公式结果。宏、数字签名、外部工作簿链接、受保护目标 sheet 会被拒绝。完整限制见仓库 docs/compatibility.md。
适用场景与注意¶
适合谁
月结、供应商对账等「同一套 Excel 模板反复填数、必须留痕、异常要人工过一遍」的流程；希望在 DSH 工作区内与 AI 协作起草映射，但导出仍由人把关的团队。
运行与权限
插件以当前 DSH 进程权限运行；安装前请自行审阅源码与 MIT 许可证，确认符合内控要求。社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。
验证预期
README 如实说明：真实 deepseek-v4-pro / max 跑通过一次 assisted success，曾需两次源表头行修正；不能据此推断无人值守映射或生产级 workbook 兼容性。Pre-release 可从 GitHub Releases v0.1.0-pre 下载；该预览未发布到 npm。
开发自检：npm run check、npm run test:e2e；浏览器测试优先 Windows Chrome，否则 npx playwright install chromium，可用环境变量 SHEETFLOW_CHROMIUM_PATH 指定浏览器。
结尾¶
dsh-sheetflow 把「填表 + 对账异常 + 溯源」收进 DSH 工作流：映射显式、导出可预览、异常必确认，并输出 HTML 与 JSON 便于审计。进一步说明见仓库 README.zh-CN.md 与文档目录。
