上下文检索代理 EvilIrving/dsh-context-proxy

dsh-context-proxy

为 DeepSeek Harness 提供轻量的按需上下文检索层。

Awesome DSH Plugin

自动截断、落盘、压缩和 token 计量已经由 output-retention、spill-policy、compaction-basic 和 session-query 负责。这个包只补上缺的那一块：三个面向模型的工具，按需把已经持久化的历史读回来。

安装

dsh plugin --profile <name> add github:EvilIrving/dsh-context-proxy

或者，从本地检出安装：

dsh plugin --profile <name> add ./dsh-context-proxy

bundle 补丁会插入一行插件记录（dsh-context-proxy）。sessionQuery 和 subprocess 是可选后端（ctx.get）：没有 sessionQuery 后端时，每个工具都会退化成 isError 结果，而不是一直等下去。

工具

| 工具 | 依赖接缝 | 返回 |
| context_query | sessionQuery.filterEvents | 轻量的 { seq, type, text } 匹配，按 seq/type/surface/text 过滤 |
| context_slice | sessionQuery.readEvent | 一个事件，外加一段有界的 before/after 窗口 |
| context_grep | subprocess（打包的 rg）或 sessionQuery.filterEvents | 匹配结果，带 { text, citation } |

引用可安全重放：context_query/context_slice 引用 session:<seq>（可从规范日志重建），context_grep 引用落盘路径（path:line，本地快速路径）或 session:<seq>（没有提供或拿不到落盘路径时，退回语义文本）。

配置

export interface Config {
readWindowDefault: number // context_slice 默认的 before/after（默认 0） grepMaxBytes: number // rg stdout 内存上限（默认 1 MiB） rgGraceMs: number // rg 终止宽限期（默认 5000） }

依赖

- sessionQuery 和 subprocess 是可选服务，通过 ctx.get(...) 读取。缺少 sessionQuery 后端时，每个工具都会退化成 isError 结果（session query backend unavailable），而不是让插件一直等下去；context_grep 带显式路径时，subprocess 同理。
- tools 是硬依赖（inject）。
- 打包的 ripgrep 二进制来自 @vscode/ripgrep —— 和 dsh-tool-fs-search 用的是同一套机制 —— 所以不需要在系统里装 rg，argv 向量和 ripgrep 之间也没有 shell 层。

模型体验

请求上下文与条件

模型看到什么

三个工具 schema（context_query、context_slice、context_grep）注册进智能体的工具集。每个结果都是紧凑的 JSON 对象，包含匹配项/条目和引用；不返回散文，模型不用自己从里面解析 id。

Token 影响

工具被调用前，直接影响为零；每次调用的开销受查询/切片窗口和 grepMaxBytes 上限约束。

KV Cache 影响

只追加：工具结果追加到表层，绝不重写早先的请求 token。

已知限制与待办工作

- context_grep 的行解析格式是 path:line:text —— 如果溢出路径里含换行符（持久定位符无法表达这种路径），解析器就会出错；绝对溢出路径永远不会含换行符。
- 回退文本扫描是字面匹配，不是正则 —— 没有提供溢出路径时，context_grep 回退到 sessionQuery 的字面扫描：不区分大小写、空白符灵活，而不是正则搜索。
- 写入 bundle 没有沙箱隔离 —— 这里不写任何文件；检索只通过接缝读取。