cdxiaodong/dsh-llm-inspector
30最近提交 2026年8月15日
dsh-llm-inspector DSH 插件
dsh-llm-inspector 是 DeepSeek Harness 的插件，通过配置开关整合了四项能力：推理控制、外部思考导出、流量/包分析以及会话落盘审计。它拦截 LLM 请求和响应，提供对模型行为的洞察和控制。
如何安装 dsh-llm-inspector DSH 插件
dsh plugin --profile <你的profile> add github:cdxiaodong/dsh-llm-inspector来源命令需要人工核对。复制不会执行命令。
dsh-llm-inspector DSH 插件数据来源
dsh-llm-inspector DSH 插件快照日期：2026年8月16日
discovered
dsh-llm-inspector DSH 插件能做什么
- 通过 `agent/request` 瀑布覆盖推理努力值，设置 `reasoningEffort` 为 'none'、'low'、'medium' 或 'high'。
- 对加密推理的模型（OpenAI、Anthropic、Gemini）导出外部思考：注册 `think` 工具并注入系统提示。
- 在 `llm/stream` 瀑布中捕获并分析流量块，包括推理块和工具调用块。
- 将会话事件和流式块持久化到 `audit.jsonl` 以进行审计。
- 提供两个服务（`inspectorTraffic` 和 `inspectorAudit`），可被其他插件注入使用。
dsh-llm-inspector DSH 插件适合哪些场景
- 通过将 `reasoningEffort` 设为 'none' 来关闭推理，以降低开销或延迟。
- 对隐藏推理的模型，使用外部思考导出捕获模型内部推理作为 think 工具调用。
- 监控和记录 LLM 流量，用于调试、性能分析或合规性。
- 使用 `persistSession` 审计完整的对话历史，供后续审查或报告。
- 通过暴露的服务将流量统计或审计日志集成到其他插件中。
dsh-llm-inspector DSH 插件适合谁
- 需要检查或修改 LLM 请求/响应行为的 DSH 插件开发者。
- 希望在 DSH 环境中审计 LLM 交互的操作者或研究人员。
dsh-llm-inspector DSH 插件的限制
- 仅适用于 DeepSeek Harness（DSH）插件生态，不能独立运行。
- 对加密推理模型（OpenAI、Anthropic、Gemini）的外部思考是“软强制” via 系统提示，不保证 100% 触发率。
- 需要通过 YAML 配置手动启用每个能力。
- 会话审计日志可能包含敏感数据；用户需确保安全存储和访问控制。
dsh-llm-inspector DSH 插件的仓库 README 摘录
以下文字摘自 dsh-llm-inspector DSH 插件的上游仓库 cdxiaodong/dsh-llm-inspector 的 README，版权归原作者，仅作引用。
> 统一 LLM 请求/响应检查器 —— [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 插件 一个插件收编四类能力，全部通过配置开关：reasoning 控制、外部思考（think）导出、流量/包分析、会话落盘审计。 ## 功能 | 功能 | 实现机制 | 配置项 | |------|----------|--------| | **reasoning 控制** | 挂 `agent/request` waterfall，改写 `LlmCallConfig.reasoningEffort`（关推理 / 调 budget） | `reasoningEffort` | | **外部思考导出** | 注册 `think` 工具（schema 自动流入请求体）+ `systemPrompt` 注入"先调 think"指令，再从 `llm/stream` 抓回 `thoughts` 参数 | `externalThinking` | | **流量/包分析** | 挂 `llm/stream` waterfall 拦截每个 chunk，按类型统计 token/字符、捕获 reasoning 与 tool-call 块 | `trafficAnalysis` | | **会话落盘审计** | 订阅 `session/event` + 命中的流式块，写入 `audit.jsonl` | `persistSession` | ### 外部思考（external thinking）说明 对**明文返回 reasoning 的模型**（DeepSeek 等开源模型），本插件直接从 `llm/stream` 抓 `reasoning` 块，零侵入。 对**加密推理的模型**（OpenAI / Anthropic / Gemini），原生推理被厂商加密藏起。本插件复刻 [oh-my-pi](https://github.com/can1357/oh-my-pi) 的 externalThinking 思路： 1. `reasoningEffort: 'none'` 关掉原生隐藏推理； 2. 注册一个 `think` 工具（description 为 "private scratchpad; not shown to user"），其 schema 经 `ctx.tools.register()` 自动进入发往 LLM 的请求体； 3. 通过 `systemPrompt.section()` 注入"回答任何问题前必须先调用 think"的指令； 4. 模型把推理写进 `think` 的 `thoughts` 参数，本插件在 `llm/stream` 拦截该 tool-call 块并抓
阅读完整 README仓库未声明许可，使用前请先与作者确认。
dsh-llm-inspector DSH 插件常见问题
如何安装 dsh-llm-inspector？
使用命令 `dsh plugin --profile <你的profile> add github:cdxiaodong/dsh-llm-inspector` 安装。请确保已安装 DeepSeek Harness (DSH) 并配置了 profile。插件会自动下载并注册。
这个插件支持 OpenAI 模型吗？
支持，但外部思考导出功能对 OpenAI 模型采用“软强制”方式，因为 OpenAI 加密了推理。插件会设置 `reasoningEffort: 'none'` 关闭原生推理，然后注入 `think` 工具和系统提示，迫使模型以工具调用的形式输出推理。触发率可能无法达到 100%。
如何启用流量分析？
在 DSH 配置文件的 `plugins.dsh-llm-inspector` 下设置 `trafficAnalysis: true`。插件会拦截 `llm/stream` 瀑布中的每个块，统计 token、字符，并捕获推理和工具调用块。你也可以通过 `inspectorTraffic` 服务获取快照。
审计日志文件路径是什么？
默认日志目录是工作目录下的 `.dsh-inspector`，可通过配置中的 `logDir` 自定义。审计文件名为 `audit.jsonl`。请注意存储位置和访问权限，因为它可能包含敏感数据。
是否可以不配置 YAML 直接使用这个插件？
不行，插件的四个功能（`reasoningEffort`、`externalThinking`、`trafficAnalysis`、`persistSession`）默认都是关闭的，需要在 DSH 配置文件中至少设置一项才能启用相应功能。