dsh-context-pilot

让用户看到「模型到底收到了什么」，并把浪费的上下文变成可回滚的优化补丁。

优先级	状态	名称核查	形态
A	MVP 已发布（阶段一 + 阶段二预览，2026-08-16）	`dsh-context-pilot` 未被占用（2026-08-15）	插件 + bakeoff 联动（阶段三）

解决什么问题

每一轮模型请求的上下文由系统提示词分节、动态上下文、工具 Schema、Skill 目录、注入上下文与历史消息拼装而成，用户既看不到构成，也不知道哪里在浪费。本插件在 /context 命令下只读诊断当前会话：

构成树：系统提示词按分节归属（装配观察 + 持久化 request/header 对账）、动态上下文、工具 Schema、Skill Catalog、注入上下文、会话历史；
诊断：重复指令（3-gram 相似度）、冲突提示（分句粒度相反极性启发式，只提示不判定）、Skill 遮蔽（作用域胜者 vs 全局胜者）、工具「从未调用」标记（对照 tool/call 历史）、MCP 工具面（mcp__<server>__<tool> 前缀启发式）、请求头变化序列（Prompt Cache 失效归因）；
计价：固定密度启发式（chars/4 + 每块 4 开销，与官方 token-meter 同口径）；Provider 精确用量如实汇总，不用于分节归属；
建议 + 补丁预览：每条建议附「预计每请求减少 X tokens」的计算依据；补丁只出 YAML 预览行，绝不自动应用（应用路径属阶段二/三，经 bakeoff A/B 验证）。

用法

/context     # 只读诊断当前会话（人发起，不回送模型）

产出：

.context-pilot/reports/<sessionId>/report-<时间戳>-<序号>.{md,json}（Markdown 报告 + JSON 产物，ContextReport Schema v1）；
context/report 会话持久事件（Web 会话时间线渲染诊断卡片；rc.6 平台差异见下方注意事项）。

配置（Profile 下发）

context-pilot:
  reportsDir: .context-pilot/reports   # 报告产物根目录
  sessionEvent: true                   # 是否写 context/report 会话事件
  similarityThreshold: 0.7             # 重复检测相似度阈值
  conflictHints: true                  # 冲突提示（保守启发式）
  maxSkillBodies: 40                   # Skill 正文计价数量上限（0 = 不加载正文）
  maxInjectedEntries: 20               # 报告展示的注入上下文条目上限
  formats: [markdown, json]            # 报告产物格式

三阶段路线

阶段	内容	状态
一（只读）	上下文构成树、重复/冲突/遮蔽诊断、Token 排名、诊断报告	✅ 已发布
二（补丁）	生成优化补丁 + 预估收益 + 预览（不自动应用）	⚠️ 预览已随 MVP 提供（`patchPreviews`），应用动作未做
三（闭环）	原配置 vs 优化配置经 bakeoff 同任务 A/B，确认后应用/回滚	依赖 dsh-bakeoff（已发布）

差异化定位

现有项目	Star	已覆盖	本插件增量
dsh-context	40	上下文构成展示面板	诊断 → 补丁 → A/B → 应用的完整闭环
dsh-context-doctor	8	指令链/Skill/工具 Schema 审计、重复与遮蔽检测	同上；且补丁可回滚、收益可验证
billion-context-dsh	13	模型驱动的主动上下文剪枝（ACP）	运行时剪枝 vs 配置级优化，互补；本插件改的是配置源头

注意事项（developer preview）

P1（平台差异）：rc.6 的 Session.append 尚无 ignorable 写入面，含 context/report 事件的会话在持久化读取路径会被拒绝（无法恢复；当前运行与会话内容不受影响）。需要可恢复会话的部署请设 sessionEvent: false（报告仅落盘）。详见 docs/verification-report.md 第 7 节。
计价是估算：pricing.mode 恒为 heuristic；收益声明附计算依据，横向比较在同口径下成立。
MCP 分组是启发式：mcp__<server>__<tool> 前缀约定未经 DSH 官方文档核实，报告已明确标注。
阶段一只读不变式：除报告产物与 context/report 事件外，不修改任何配置、注册表或会话内容（报告内 readonlyInvariant 运行时校验）。

文档导航

docs/verification-report.md — MVP 验证证据、平台差异（P1–P4）、实现取舍（D1–D8）
docs/design.md — 采集/分析/补丁三层设计
docs/research.md — 竞品档案与命名核查
e2e/README.md — 隔离环境场景回归装置

dsh-context-pilot

Cài đặt

Mã nguồn

Thẻ

Readme

dsh-context-pilot

解决什么问题

用法

配置（Profile 下发）

三阶段路线

差异化定位

注意事项（developer preview）

文档导航