前言¶
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
