DeepSeek Harness 插件：dsh-skill-trail

在 DeepSeek Harness (DSH) 的开发与调试过程中，追踪技能触发和工具调用是常见需求。模型有时会自报状态，导致日志数据不可靠。为了解决这个问题，需要一种基于引擎日志而非模型自报的方案，来展示每个回复下方的技能和工具使用情况。

dsh-skill-trail 是一个 DSH 插件，用于在对话界面渲染紧凑的轨迹信息。

是什么¶

该插件在 DeepSeek Harness 中运行，负责在每个助手回复下方渲染轨迹。它显示哪些技能被触发（🧠）以及哪些工具被实际使用（✓）或失败（✗）。数据来源是引擎日志，而非模型输出。

维护者：Bryan-cmf
类别：记忆
许可证：MIT

核心功能¶

渲染轨迹：在每个助手回复下方展示紧凑的技能和工具徽章。
零模型自报：数据完全基于引擎日志的投影折叠，不依赖模型输出。
基于引擎日志：通过 session-projection 单位处理日志，确保数据真实。
结构化与可重放：数据结构化，支持通过缓存和回填进行重放。
逐轮显示：每个回复对应显示其轮次的轨迹。
技能感知：技能工具调用渲染为 🧠 并显示解析后的技能名称。
折叠会话日志：支持折叠会话日志。

安装与启用¶

插件需要 DSH 版本 >= 0.1.0-rc.6。

安装路径 A（推荐）：
在项目的 package.json 中配置 dsh.profile.bundles，将插件加入其中：

{
  "dsh": {
    "profile": {
      "bundles": ["@bryan-cmf/dsh-skill-trail"]
    }
  }
}

安装并重启 DSH 后，投影单元会在全局注册，客户端渲染器会在每个对话中显示轨迹。

典型用法¶

配置示例：
可以在配置中限制轮次和每轮调用数：
* maxTurns=500：每会话保留的轮数上限。
* maxCallsPerTurn=50：每轮触发的条目上限。

投影值获取：
通过 useProjection('skillTrail') 获取结构化数据，返回类型为 Record<turn, { triggered, used, failed }>。

{
  "12": {
    "triggered": [
      {
        "name": "skill",
        "skill": "ak-hk-stock-dd",
        "status": "ok",
        "callId": "call_1"
      }
    ],
    "used": {
      "skill": 1,
      "read": 3,
      "bash": 2
    },
    "failed": ["web_search"]
  }
}

适用场景与注意¶

依赖项：该插件依赖 @deepseek-ai/cordis、react、zod 等 peerDependencies。
版本状态：当前版本为 0.1.4-alpha.0，处于 Alpha 状态。
替代关系：该插件已被 @bryan-cmf/dsh-skill-ledger 取代，本仓库已归档，仅作为设计历史记录保留。

结尾¶

dsh-skill-trail 通过投影引擎日志的方式，实现了零模型自报的技能与工具轨迹追踪，提供了结构化且可重放的数据视图。由于其已被新插件取代，建议关注设计历史记录。

GitHub：https://github.com/Bryan-cmf/dsh-skill-trail
目录页：https://www.skillhub.cn/plugins/Bryan-cmf/dsh-skill-trail