前言¶
用 DeepSeek Harness（DSH）做智能體開發時，會話日誌裏會不斷出現 write、edit、str_replace_editor 等寫入類工具調用，但宿主本身並不直接給出「生成了多少行代碼、文檔寫了多少、改動的採納率、按模型分攤的成本」這類彙總。若要復盤效率或覈對花費，往往只能翻日誌或靠外部腳本，口徑也不統一。
output-overview 是社區維護的 DSH 第三方插件：讀取本機 ~/.dsh/sessions 下的會話歷史，離線聚合代碼與文檔產出、兩種採納率以及按輪次歸集的成本，並通過 Web 設置面板與 HTTP API 展示。計算全部在本機完成，不訪問外部服務。DSH 生態主張「一切皆插件」；SkillHub 等目錄頁由社區獨立維護，與 DeepSeek / 幻方無官方從屬關係。
這是什麼¶
維護者：MarchingWorkhorse。倉庫：Output-Overview，目錄頁：SkillHub - Output-Overview。當前 package 版本 0.3.1，許可證 MIT。
插件通過宿主掛載的 ctx.sessionQuery 只讀會話日誌，識別文件寫入操作並做近似重放統計；在 web profile 下依賴內置的 webServer 註冊路由與前端面板。分類上在目錄中常歸爲「記憶」類，實際能力側重產出統計與成本歸集，而非長期記憶存儲。
核心功能¶
下面指標口徑均來自插件 README，窗口過濾（全部 / 今天 / 最近 7 / 30 天 / 自定義 from/to）只計窗口期操作；內容重放仍用全量歷史以保證「代碼存活」判定準確。
| 指標 | 說明 |
|---|---|
| 生成代碼行數 | write 全文行數 + 編輯工具新增行數；按擴展名排除文檔類文件 |
| 文檔統計 | .md、.markdown、.mdx、.txt、.rst、.adoc 的文件數與生成行數 |
| 採納率（代碼存活） | 重放全部寫入/編輯並做行級來源追蹤：窗口內生成且現仍存活的行數 ÷ 窗口內生成行數 |
| 採納率（工具執行） | 寫入類工具調用成功執行的比例；被拒、報錯或無結果算不採納；只讀 view 不計入 |
| 成本 | 按輪次歸集 token 成本（未緩存輸入 / 緩存讀 / 緩存寫 / 輸出），再按該輪生成的代碼/文檔行數比例分攤；無寫入的輪次計入「對話開銷」；默認以人民幣（CNY，¥）顯示，可按配置匯率由 USD 折算 |
| 展示維度 | 總覽卡片、按會話、按日期、按文件 Top 榜；面板含最近 14 天趨勢與文件 Top 10 |
README 中給出過某真實環境示例（37 個會話）：生成代碼 12,604 行，代碼存活採納率 80.5%，工具執行採納率 88.0%，文檔 58 個 / 4,682 行，總成本 ¥58.06（含代碼、文檔、對話開銷分項，按 1 USD = 6.70 CNY 折算）。該數字僅作口徑說明，不代表你的環境結果。
安裝與啓用¶
安裝命令須使用資料原文（web profile）：
dsh plugin --profile web add https://github.com/MarchingWorkhorse/Output-Overview.git
裝好後重啓 DSH（插件進入 bundle 棧，需進程重載）。打開 Web 界面 設置 → 產出總覽 即可查看面板。
本地開發調試可用目錄路徑安裝（Windows 示例爲 junction 鏈接，改代碼後重啓生效）：
dsh plugin --profile web add D:\path\to\output-overview
兼容性：README 記載在 DSH 0.1.5-rc.1（web profile） 已驗證。headless 等 profile 無 Web 面板意義，文檔標明未測試。
典型用法¶
Web 面板¶
- 進入 設置 → 「產出總覽」。
- 頂部可多選工作區（點擊列表項切換；「全部工作區」清空選擇）、開關子代理會話、選擇時間範圍。
- 下方查看趨勢表與文件 Top 10。成本以 ¥ 顯示並註明匯率。選定工作區後，所有卡片（含總成本）只統計該工作區的會話；右上角會顯示「N 個會話（全部 M）」。
- 點 「定價配置」 可從會話日誌提取模型列表、填四類單價、選單價幣種（USD/CNY）、默認模型、顯示幣種與匯率，保存並重算 寫入
~/.dsh/output-overview-config.json（優先於cordis.patch.yml）。
HTTP API¶
彙總數據：
GET /output-overview/api/summary
常用查詢參數：
workspace=<cwd>：可重複，實現多選（缺省爲全部）。subagents=false：控制是否計入子代理會話。from=<ms>&to=<ms>：自定義時間窗（epoch 毫秒，雙閉區間）。refresh=1：刷新緩存。
返回中包含代碼/文檔/採納率/成本聚合；所有指標（含成本與會話數）均跟隨工作區過濾——sessionCount 爲所選工作區會話數，全庫總數爲 totalSessionCount。成本字段已按 displayCurrency 折算（costs.currency、costs.fx.rate 標註幣種與匯率）。
定價與幣種覆蓋：
GET /output-overview/api/config
POST /output-overview/api/config
POST 保存後 summary 緩存自動失效。
定價與幣種（YAML 可選）¶
除面板外，也可在 profile 的 cordis.patch.yml 中配置（改完需重啓）。多模型分表計價示例（節選）：
- id: output-overview
config:
pricing:
default: glm-5.3-flash
unit: CNY
models:
glm-5.3-flash:
hit: 0.11
miss: 0.42
write: 1.4
out: 1.4
currency:
code: CNY
symbol: "¥"
fx: 6.7
默認內置一檔 glm-5.3-flash（USD 報價：輸入 $0.06 / 緩存讀 $0.01725 / 緩存寫 $0.21 / 輸出 $0.21）。顯示默認 CNY，匯率默認 1 USD = 6.70 CNY（README 標註 2026-10-12 牌價）。
適用場景與注意¶
適合誰：需要在同一 Web 界面裏按工作區、時間範圍查看 DSH 生成代碼/文檔規模、採納率與模型成本分攤的開發者；也適合用 HTTP API 做二次展示或腳本拉數。
權限與數據：插件以當前 DSH 進程權限 運行，能讀 ~/.dsh/sessions 與會話內的工具參數。安裝前應自行審閱 源碼與 MIT 許可證。文檔說明：統計路由爲 GET、不執行 shell、不訪問外網、不收集遙測；唯一寫操作是面板保存定價時原子寫入 ~/.dsh/output-overview-config.json。
統計侷限：編輯重放按字面量子串替換語義執行；若文件被 AI 以外手段修改，極端情況下指標可能偏差。被拒絕或執行失敗的寫入不計入生成行數。
結尾¶
output-overview 把 DSH 會話裏的寫入類工具調用轉成可讀的產出總覽與成本分項，並集中在 設置 → 產出總覽 與 /output-overview/api/* 接口中，適合在本機離線復盤 AI 輔助開發的「寫了多少、留了多少、花了多少」。
- 目錄頁：https://www.skillhub.cn/plugins/MarchingWorkhorse/Output-Overview
- GitHub：https://github.com/MarchingWorkhorse/Output-Overview
