dsh-context-doctor

使用

模型直接调用工具：

context_audit            # 审计当前会话工作目录
context_audit cwd=/path/to/project
context_audit includeSkillBodies=true maxSkillBodies=20
context_audit detail=developer  # 摘要 + 可定位的 context-audit receipt

输出 canonical JSON（AuditReport）：

{
  "tool": "context_audit",
  "version": 1,
  "cwd": "/path/to/project",
  "injected": {
    "instructions": { "files": [{ "path": "...", "bytes": 3421, "tokens": 812 }], "totalTokens": 812, "duplicateBlocks": [...] },
    "skills": { "catalogCount": 177, "catalogDescriptionTokens": 4150, "bySource": [...], "duplicateDescriptions": [...] },
    "tools": { "visibleCount": 42, "schemaTokens": 9800, "nativeCount": 38, "nativeTokens": 6100,
               "mcp": { "servers": [{ "server": "github", "tools": 12, "schemaTokens": 2400 }], "totalTools": 12, "totalTokens": 2400 } }
  },
  "conflicts": [{ "name": "skill-x", "winner": {"source": "project-dsh", ...}, "shadowed": [...] }],
  "suggestions": [{ "severity": "high", "text": "..." }]
}

Native 渲染为分节可读报告（指令链 / 技能 / 工具 / 冲突 / 建议），模型可直接照建议执行裁剪。

两级输出

• 默认摘要：成本、冲突与按严重度排序的修复建议，适合每次诊断调用。
• detail=developer 回执：附加 context-audit receipt，逐项列出已加载的 AGENTS.md / CLAUDE.md（路径、字节、token、加载顺序与重复块短预览）、catalog 注入的 skills（名称、来源、provider、描述字节）、每个 tool schema 的序列化字节与签名、重复 MCP 签名、shadowed skill 关系和可执行修复建议。

trimmed 只有在 DSH 暴露上下文装配轨迹后才会给出条目；当前版本固定标记为 unavailable，避免将不可观测状态误报成已裁剪内容。回执不含完整 prompt 或技能正文，Agent 可依据路径和名称进行定点读取。

配置

context-doctor:
  defaultCwd: /path/to/project   # 浏览器面板不带 cwd 参数时的默认审计目录（缺省为进程启动目录）
  cacheTtlMs: 60000              # 审计结果缓存时长（毫秒）