前言¶
在 DeepSeek Harness（DSH）裏跑完一輪多輪對話和工具調用後，界面通常能感知上下文壓力，卻很難一眼看清：這輪會話實際走了多少輪、調了哪些工具、Token 如何拆分、緩存命中率多少、按官網標價算下來大概花多少錢。事後寫復盤、給同事同步，也往往要從日誌或記憶裏拼細節。
下面介紹社區插件 dsh-session-recap（維護者 SAS-159，分類：客戶端）。它把當前會話整理成一張 會話復盤卡片，並在 Composer 區域提供一鍵導出 Markdown 或獨立 HTML，數據只在瀏覽器內從會話已有信息推導，不發起外網請求。
這是什麼¶
dsh-session-recap 是一個 DSH bundle（npm 包名 dsh-session-recap，當前版本 0.1.0，許可證 MIT）。定位是：把任意一次 Harness 會話變成可分享的 recap card，彙總輪次、步數、工具調用、Token 拆分、緩存命中率，以及按 DeepSeek Flash 官網定價估算的低谷價–高峯價花費區間。
插件掛在 Web 會話 UI 的 conversation.composer.dock 槽位，緊挨內置的活動與用量 pill 之後出現一個入口 pill；點開即可查看卡片並複製或下載。
核心功能¶
卡片上展示的內容與 README 示意圖一致，主要包括：
- 會話統計：輪次、步數、耗時、工具調用次數（來自
useProjection('sessionStats')）。 - Token 拆分：未緩存輸入、緩存讀取、緩存寫入、輸出等（來自
useProjection('tokenUsage')），並給出緩存命中率。 - 工具使用：從 Chat 快照的
legacy.nodes中彙總tool-call行，按工具名分組。 - 花費預估：按 DeepSeek 官方定價 的 DeepSeek Flash 列表價（USD/1M tokens）計算區間；高峯時段爲工作日 UTC 01:00–04:00 與 06:00–10:00，會話總價以低谷–高峯範圍顯示。定價常量在
client.js頂部PRICE，官網調價時需自行更新。 - 導出：一鍵複製 Markdown、下載
.md、下載自包含.html，便於事後分析、團隊同步或寫文章說明 agent 行爲。
與「只有上下文壓力、沒有賬單視角」的默認體驗相比，這張卡直接回答：這輪會話做了什麼、大概花了多少。
隱私與兼容¶
卡片數據完全來自當前頁面已開放的會話信息，在瀏覽器本地渲染；除用戶點擊下載外不寫盤，會話之間不持久化，無遙測、無額外存儲。
兼容 DSH 桌面版 / Web 版（platform: web）。若 react-dom 不可用，客戶端會退回就地面板而非 portal；若部分 projection 缺失（較舊構建），仍可從 Chat 快照單獨渲染卡片。
安裝與啓用¶
社區市場經 dshmarket 與 awesome-dsh-plugin 策展收錄後，可在市場 UI 安裝，或使用官方文檔中的命令（profile 爲 web）：
dsh plugin --profile web add dsh-session-recap
倉庫也自帶 format-1 市場索引 market/index.json：用靜態 HTTP 服務託管後，在 Plugins → Discover → Index sources 添加該索引 URL 即可從自定義索引安裝。本地開發 bundle 時可用 plugin_manager 的 install_bundle 指向構建產物目錄；倉庫已提交 dist/，從索引或已發佈 npm 包安裝通常無需本地 build。
安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證。插件以當前 DSH 進程權限運行，與任何客戶端插件一樣，只應安裝你信任的來源。
典型用法¶
- 在 DSH Web 界面正常完成一輪或多輪對話（含工具調用）。
- 在 Composer 停靠區找到會話復盤入口 pill（位於內置 activity / usage pill 之後），打開卡片。
- 覈對輪次、Token 拆分、緩存命中率與預估花費區間；需要留檔時選擇 複製 Markdown、下載 .md 或 下載 .html。
定價邏輯與高峯時段規則以倉庫 client.js 與 README「How it works」表爲準；官方價變動時維護者或使用者需同步更新 PRICE 常量。
適用場景與注意¶
適合：需要量化單次 agent 會話成本與行爲的開發者；要寫 post-mortem、團隊週報或技術文章、需要可分享結構化摘要的場景。
注意：
- 花費爲按列表價的估算區間，不是賬單對賬；模型與時段需與當時實際調用一致纔有參考價值。
- 無網絡、無上報的設計意味着卡片不會自動同步到雲端，導出文件由用戶自行保管。
- 社區目錄 SkillHub 插件頁 與 GitHub 爲同一項目的不同入口；安裝命令與行爲以倉庫 README 爲準。
DSH 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-session-recap 把當前會話的輪次、工具、Token 與緩存、預估花費收成一張本地生成的復盤卡，並支持 Markdown / HTML 導出，補上了「花了多少錢、幹了什麼」這一層可觀測性。
