前言¶
DeepSeek Harness（DSH）社區推崇“一切皆插件”的理念。在開發或調試智能體會話時，開發者往往需要快速回顧會話中發生了什麼、產出了哪些文件以及消耗了多少 Token。現有的工具可能偏向實時監控，缺乏對整體工作的可視化復盤。下面介紹 dsh-office-suite，一個將會話數據摺疊成獨立 HTML 儀表盤的插件。
插件定位¶
這是一個 DeepSeek Harness（DSH）插件，由 steven95 維護。它將“這次會話幹了什麼、產出了什麼、花了多少 token”摺疊成一份可獨立打開的辦公室動畫儀表盤 HTML。與 dsh-office（實時精靈辦公室面板）不同，本插件聚焦於會話復盤——任務收尾時一鍵生成可視化工作彙報，含工作日誌、產出物、token 統計與辦公室場景動畫。
核心功能¶
- 工作日誌：從 session 事件流摺疊回合、步驟、用戶消息、工具調用、助手消息，包含工具產出文件與 token 用量。
- 產出物：提取成功寫入的文件路徑，去重保序，記錄出現次數。
- Token 統計：輸出、輸入、緩存讀、緩存寫、推理分項，以及回合、步驟、工具調用次數。
- 辦公室動畫：自包含 HTML，展示 AI 助手在辦公桌前打字、思考氣泡、時鐘走動、數據進度條動畫。
- 產出物預覽：文本文件返回內容摘要，圖片、音視頻、壓縮包返回類型與大小。
安裝與啓用¶
使用官方命令安裝：
dsh plugin add dsh-office-suite
手動安裝需在 profile 的 package.json 的 dependencies 與 dsh.profile.bundles 中加入 dsh-office-suite，並確保 cordis.patch.yml 包含以下配置：
- insert:
- id: office-suite
name: dsh-office-suite
inject: [tools]
該插件依賴 @deepseek-ai/cordis 和 @deepseek-ai/dsh-tools，且要求 Node 版本 >=18。
典型用法¶
在會話中讓助手調用 office_dashboard 工具，或直接發送自然語言指令：
生成辦公室儀表盤，輸出到 ~/Desktop
執行後，會在指定目錄生成 office-dashboard.html，用瀏覽器打開即可查看動畫儀表盤。
需要查看日誌、產出物或 token 統計時，可使用對應的工具：
* office_log：查詢工作日誌（limit 可調）
* office_deliverables：查詢產出物列表
* office_tokens：查詢 token 統計
* office_preview：預覽產出物文件
架構與實現¶
插件入口位於 index.js，內部包含以下模塊：
* lib/log.js：工作日誌投影單元（事件摺疊）
* lib/deliverables.js：產出物投影單元（文件路徑提取）
* lib/tokens.js：token 統計投影單元（usage 摺疊）
* lib/dashboard.js：辦公室動畫儀表盤 HTML 生成器（純函數）
* lib/preview.js：產出物預覽（純函數）
* cordis.patch.yml：bundle 聲明
業務邏輯全部爲純函數，可獨立測試，不依賴 DSH 運行時。投影單元通過 ctx.inject(['sessionProjections'], ...) 可選注入，headless 環境不受影響。
注意事項¶
插件以當前 DSH 進程權限運行。安裝前請檢查源碼與許可證（MIT）。該插件適合需要可視化復盤會話的開發者與團隊。
相關資源¶
- 插件目錄：https://www.skillhub.cn/plugins/steven95/dsh-office-suite
- GitHub 倉庫：https://github.com/steven95/dsh-office-suite
