DeepSeek Harness (DSH) 提供了强大的智能体编排能力，但在调试复杂流程、子代理调用和工具执行时，缺乏系统化的 trace 数据支持。Litefuse 插件旨在解决这个问题，它将 DSH 的运行时数据转化为符合规范的可观测性追踪。
这是什么¶
该插件是 DeepSeek Harness 的一个官方插件，用于接入 Litefuse 的可观测性与评估能力。它将每一次用户交互转化为一个独立的 trace，并严格遵循 Litefuse agent-trace spec v1.2 规范。
插件由 litefuse 维护，采用 MIT 许可证。
核心功能¶
该插件具备以下核心能力：
- Turn 级 Trace 映射：每个用户轮次生成一个 trace，包含一个
agent根节点。根节点下包含每个模型调用的generation、每个工具执行的tool，以及委托给子代理的嵌套容器。 - 零依赖：没有运行时依赖，不依赖 Langfuse SDK。数据直接通过 OTLP 发送到 Litefuse 端点。
- 子代理支持：支持子代理和委托场景，能够准确记录委托开销（Delegation Overhead）。
- 代码模式支持：支持代码模式，直接追踪
run_code程序中的工具调用，避免与普通工具调用混淆。 - OTLP 集成：支持通过 OTLP 协议将 trace 数据发送到 Litefuse。
安装与启用¶
安装插件需要使用 npx 命令。
npx @deepseek-ai/dsh plugin --profile web add -w dsh-litefuse-plugin
安装完成后，需要配置凭证。
- 在
~/.dsh/.env中设置 Litefuse 的公钥和私钥：
LITEFUSE_PUBLIC_KEY=pk-lf-…
LITEFUSE_SECRET_KEY=sk-lf-…
这些密钥需要在 Litefuse 项目的设置中创建。
- 启动 DeepSeek Harness：
npx @deepseek-ai/dsh web
典型用法¶
完成上述配置后，当你在 DSH 中发送一条消息时：
- 打开浏览器访问 https://litefuse.cloud 并进入对应项目。
- 在 Tracing 页面查看数据。
- Trace 会在该轮次的第一个 span 完成时出现，而不是在轮次结束时。
插件读取配置时优先从环境变量读取，也可以通过 ~/.dsh/profiles/<name>/cordis.patch.yml 进行覆盖。
注意事项¶
- 凭据处理：配置中的凭据是引用，不是实际值。插件从 harness 的凭证存储（
~/.dsh/.credentials.yaml）或进程环境变量中读取值。任何配置项都不会将密钥写入文件，且只记录公钥的前 10 个字符。 - Trace 出现时机：Trace 仅在第一个 span 完成时可见。
- 权限：插件以当前 DSH 进程的权限运行，安装前建议检查源码和许可证。
- 配置位置：默认配置读取自环境变量；若需覆盖，需编辑
~/.dsh/profiles/<name>/cordis.patch.yml。
生态背景¶
DeepSeek Harness 的理念是“一切皆插件”。社区目录（如 SkillHub）提供了插件的索引，但与 DeepSeek 或幻方 AI 无官方从属关系。
该插件通过直接订阅 DSH 的 session/event 事件流，实现了对真实执行过程（而非事后重构）的精确记录，包括真实的延迟、Token 使用量、上下文压缩事件等。
