trajectory-clean：DeepSeek Harness 的清洁轨迹视图插件

智能体开发者调试时，需要在海量消息中快速定位输入、Token 消耗或工具调用细节。原始视图往往缺乏结构化分组，难以一眼看清上下文。

trajectory-clean 是一个用于 DeepSeek Harness 的清洁轨迹视图插件。它由 gaogx96 维护，旨在通过更整洁的界面和结构化的信息展示，解决轨迹查看时的信息过载问题。

核心功能¶

该插件通过标签页和分组的方式重构了会话视图：

标签页集成：在会话顶部添加“轨迹”标签页，与原版“聊天”并列。
消息分组：按用户消息分组，标题直接显示输入内容，便于快速定位。
类型标签：每条消息显示类型标签（用户/模型/工具/命令/错误等）。
Token 统计：显示输入、输出和缓存命中（chip 标签样式）的 Token 消耗。
详情展开：点击展开查看文本、思考过程、工具参数与结果、Token 详情、模型名称和首 Token 延迟。
顶部概览：提供总记录数、轮次、输入/输出 Token、缓存、错误和工具调用的统计概览。
主题适配：使用 --dsw-alias-* CSS 变量，适配所有主题（包括深海女仆皮肤等）。
极简风格：界面无 emoji，无装饰性 AI 元素，保持工具风格的干净。

安装与启用¶

支持三种安装方式，根据你的项目结构选择其一。

方式一：本地包安装¶

将整个 trajectory-clean 目录复制到你的项目目录。
在 package.json 的 dsh.profile.bundles 数组中添加 "trajectory-clean"。

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "trajectory-clean"
      ]
    }
  }
}

重启 dsh web 或刷新页面。

方式二：NPM 安装¶

发布到 npm：

    npm publish

或其他用户安装：

    npm install trajectory-clean

在 web profile 的 package.json 中添加依赖和 bundle。

方式三：dshmarket 包¶

按照 dshmarket 规范打包。
发布到 dshmarket 仓库。
其他用户通过 dshmarket 安装。

典型用法¶

安装后，在会话顶部点击“轨迹”标签页：

快速定位：利用按用户消息分组的标题，快速找到特定的输入内容。
查看消耗：在概览栏或消息行查看 Token 统计，包括缓存命中的情况。
深入调试：点击任意消息展开，查看模型的思考过程、工具调用的具体参数与返回结果，以及首 Token 延迟等细节。

适用场景与注意¶

适用人群：需要频繁分析智能体运行轨迹、调试工具调用或监控 Token 消耗的开发者。
运行机制：插件运行时自动通过 useSession 读取会话快照。
依赖项：依赖 @deepseek-ai/dsh-client-ui-conversation 和 @deepseek-ai/dsh-client-ui-trajectory。
许可协议：MIT 许可证。
安全提示：插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。

总结¶

trajectory-clean 提供了一个结构化、低干扰的轨迹查看方案。它通过标签页、分组和清晰的信息层级，帮助开发者更高效地分析会话数据。