前言¶
在 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 與文檔目錄。
