前言¶
DeepSeek Harness(DSH)采用“一切皆插件”的架构理念。在处理复杂的多步骤任务时,AI 对话中会包含系统指令、模型回复、工具调用、思考过程以及子 Agent 任务,标准列表视图难以清晰区分角色和上下文。DSH 群聊风格视图插件旨在解决这一问题,通过模仿微信群聊的界面,将原本平铺的对话重构为多角色互动的场景,方便开发者查看工具调用细节和子任务执行状态。
核心功能¶
该插件主要提供以下能力:
- 角色区分与视觉标识:每个角色拥有独立的头像、昵称和气泡颜色。
- Markdown 支持:消息以气泡形式展示,支持 Markdown 渲染,包括标题、代码块、表格等。
- 工具调用折叠:工具调用(Tool)消息可折叠或展开,输入参数与输出结果自动合并为一张卡片。
- 子 Agent 嵌套展示:子 Agent 任务以嵌套的群聊形式展示,支持展开查看实时消息流。
- 元数据查看:点击头像可查看消息详细元数据(模型名、温度、Token 用量、耗时等)。
- 深色模式:界面跟随 DSH 主题自动切换。
- 国际化:支持中文和英文界面。
- 自动滚动与折叠:滚动到底部后自动跟随新消息;离开底部时右下角出现“回到底部”按钮;顶部按钮可一键折叠所有工具消息或思考内容。
安装与配置¶
安装该插件需要 DSH 环境已就绪,并满足 Node.js 版本要求(>= 22.19.0 或 >= 24.0.0)。
执行安装命令:
dsh plugin add github:tang-zhilei/dsh-group-chat-view
首次安装时,pnpm 会要求授权构建脚本(prepare 脚本会自动编译 TypeScript)。DSH 会提示你将以下配置添加到 profile 目录下的 pnpm-workspace.yaml 文件中:
allowBuilds:
dsh-group-chat-view: true
添加完成后,重新执行上述安装命令即可。
安装完成后,重启 DSH。在会话视图顶部会出现 「群聊」 标签,点击即可切换至群聊风格视图。
界面与角色映射¶
在群聊视图中,不同的 DSH 角色对应不同的群聊身份:
| DSH 角色 | 群聊身份 | 视觉表现 |
|---|---|---|
| System | 系统公告 | 黄色警告条,居中显示 |
| Assistant | DeepSeek | 浅灰色气泡,左侧 |
| Tool | 工具人 | 浅蓝色气泡,左侧,可折叠 |
| User | 我 | 绿色气泡,右侧 |
| Reasoning | 思考中 | 半透明紫色气泡,左侧 |
| SubAgent | 子 Agent | 浅紫色气泡,嵌套展示 |
限制与注意事项¶
- 子 Agent 状态:子 Agent 状态目前只有「运行中」和「完成」两档(DSH 目录无失败状态位)。
- 元数据字段:元数据弹窗显示的字段取决于 DSH 快照实际提供的数据,若未加载轨迹插件,部分字段可能缺失。
- 开发依赖:插件项目结构包含
src/目录,其中包含服务端入口和各类客户端组件(如 MessageList、MessageBubble、ToolCallCard 等)。
结语¶
DSH 群聊风格视图通过重构对话视图,让复杂的 AI 执行过程变得直观可读。如果你习惯以群聊视角审视多智能体协作,可以通过以下链接获取该插件源码: