前言¶
DSH 的插件生态允许在 Web 会话中叠加不同视图。已有轨迹视图通常用于查看原始 Trajectory，当事件较多时，按动作类型定位记录或理解问题到方案的调用链，仍需要反复展开和筛选。dsh-client-ui-trajectory-categories 是一个纯客户端 DSH Web 插件，它在保留原始轨迹列表的基础上，将轨迹整理为中文优先、零额外 token 的分类、合计和画布视图。
这是什么¶
dsh-client-ui-trajectory-categories 由 QWQ-nn 维护，许可证为 MIT。插件定位为 DSH Web 的 client-side 插件，用于把 raw trajectory 转成中文优先、零 token 的摘要视图。
它会复用 @deepseek-ai/dsh-client-ui-trajectory 提供的 trajectory 视图投影，同时依赖 @deepseek-ai/dsh-client-runtime 和 @deepseek-ai/dsh-client-ui-conversation。插件主体面向浏览器端，lib/index.js 是 host-side no-op。
核心功能¶
新增「分类」标签页¶
安装后，会话头部会出现「分类」(Categories) 标签页。原始 Trajectory 列表保持不变。
「合计」面板¶
「合计」(Summary) 面板位于左上角，按动作类型统计记录：写入/读取/删除/下载/命令/搜索/子代理/其他工具/消息/压缩。
分类标签始终为中文，并支持中文与英文工具名/术语匹配。面板中按分类展示记录；点击分类 chip 可展开该分类记录，再次点击该 chip 或点击 × 可清除/收起。点击记录可查看参数 (args)、结果 (result)、错误 (error)。
思维导图画布¶
画布按「问题 → 方案 → 工具调用」重建轨迹。一次展示一个问题，其他问题通过「问题画布」标签切换。
在画布中可以点击问题节点展开/收起其子流程，点击方案 pill 展开/收起工具调用链，点击工具 chip 打开详情面板。详情面板可查看做了什么、输出/日志、修改内容、参数、错误。
画布支持拖拽平移、Ctrl + wheel 或缩放按钮缩放、节点拖动与惯性连线。
零额外 token 消耗¶
该插件只做客户端聚合，不发起模型请求，也不做 LLM 摘要，因此不产生额外 token 消耗。它复用 ui-trajectory 的 trajectory 视图投影，不重新处理事件流。默认按懒加载和按需渲染，每类先加载 40 条记录。
安装与启用¶
使用安装命令：
dsh plugin --profile web add dsh-client-ui-trajectory-categories
安装后重启 dsh web 服务并刷新页面，会话头部会出现「分类」标签。
如果希望手动控制 patch 层，可以按下面的方式安装。
1、将包放入目标 profile 的 node_modules 目录，例如（以实际 profile 路径为准）：
~/.dsh/profiles/node_modules/dsh-client-ui-trajectory-categories
2、在目标 profile 的 cordis.patch.yml 中追加该插件配置：
- insert:
- id: ui-trajectory-categories
name: 'dsh-client-ui-trajectory-categories'
3、重启 dsh web 并刷新页面。
典型用法¶
先完成安装并刷新页面，然后在会话头部点击「分类」。
1、在「合计」面板中点击分类 chip，展开该分类记录；再次点击该 chip 或点击 × 可清除/收起。
2、点击某条记录，查看参数 (args)、结果 (result)、错误 (error)。
3、切换到「问题画布」标签，查看不同问题对应的画布。
4、点击问题节点，展开/收起其子流程。
5、点击方案 pill，展开/收起工具调用链。
6、点击工具 chip，打开详情面板，查看做了什么、输出/日志、修改内容、参数、错误。
7、拖拽画布平移，使用 Ctrl + wheel 或缩放按钮缩放，拖动节点并观察惯性连线。
适用场景与注意¶
这个插件适合在 DSH Web 会话较长、需要快速查看动作统计、工具调用细节、问题与方案关系时使用。它不会改变原始 Trajectory 列表，也不依赖模型请求。
安装前建议先检查源码与许可证。该插件以当前 dsh 进程权限运行，属于 browser-only/client-side 插件，lib/index.js 为 host-side no-op。许可证为 MIT，维护者为 QWQ-nn。依赖项包括：
@deepseek-ai/dsh-client-ui-trajectory@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-client-ui-conversation
链接¶
GitHub 仓库：
https://github.com/QWQ-nn/dsh-client-ui-trajectory-categories
目录页：已核实资料未提供具体目录页 URL；不要把 DSH 社区目录理解成官方应用商店。如需查看目录页，请在 DSH 社区目录中按插件名 dsh-client-ui-trajectory-categories 检索。
