Repository navigation
v0.7.0
v0.7.0:历史授权查询
新增:一键查询历史授权
http://127.0.0.1:<dsh-web-port>/dsh-approval/history
每一次真实提权都会被记下来:模型要做什么、当时的 AI 注释说了什么、
你当时选了允许还是拒绝,可搜索、可筛选、可追溯,重启后仍在。
| 查询参数 | 含义 |
|---|---|
| (无) | HTML 页面 |
?raw=1 |
JSON |
?q= |
关键字:工具 / 路径 / 注释 / 申请理由 |
?decision=allow |
allow / deny / cancel / pending |
?risk=high |
low / medium / high |
?session= |
只查某个会话 |
?since= / ?until= |
ISO 时间范围 |
?limit= |
默认 100,上限 1000 |
?refresh=1 |
绕过 revision 缓存 |
POST /dsh-approval/history/clear 清空注释文件。
设计:只存注释,决策读宿主
插件只存自己的注释(annotations.jsonl)。
决策——允许 / 拒绝 / 取消——从 DSH 自己的会话日志读,那里本来就有成对的
approval/asked + approval/decided 事件。两者按 callId 关联。
为什么不自己存决策:宿主才是"谁批准了什么"的权威。插件再存一份,
只会制造第二个真相,而它迟早与宿主漂移。
绝不写/删宿主的会话日志。 未知事件类型会让旧版 harness fail-closed
拒读整份日志,那是不可恢复的破坏。
关联的三级兜底
正常审批 100% 有 callId(实测 73/73)。契约上它是可选字段,所以有兜底:
| 级 | 键 | 窗口 |
|---|---|---|
| ① | sessionId + callId |
— |
| ② | sessionId + toolName + reason |
非对称 [锚点-10min, 锚点+60s] |
| ③ | 同会话同 toolName,选离锚点最近的 | 同上 |
锚点是 at - tookMs(生成开始时刻 = 审批被请求的时刻)。
窗口为什么非对称:注释是在 approval/request 触发的瞬间开始生成的,
所以一次审批不可能显著晚于那个时刻——未来的审批在那一刻根本不存在。
用对称窗口会把「别人的、稍后发生的审批」匹配进来,导致张冠李戴。
歧义宁可 unlinked:同一 reason 命中多条、或两条等距时,不猜。
决策列显示「未关联」而不是显示一个错的——错的比缺的更糟。
健壮性
- 宿主读取有超时:每会话 4 秒 + 总预算 20 秒。宿主挂起时页面仍能返回,
带着已读到的部分,而不是白屏挂死。 - 读取失败可见:
list()失败 → 页面显示降级横幅;逐会话失败 → 提示
「有 N 个会话读取失败,决策列可能缺失」。 - revision 门控 + 缓存 + 并发合并:读全部会话实测 601ms(18 个),
二次读走缓存;100 会话量级靠总预算兜底。 - 非法参数返回 400,不 500。
- XSS:模型输出全部转义,22 项载荷验证;另加
nosniff/ CSP /no-referrer。 - 清空只删插件自己的文件,GET 返回 405。
新增:监听器失效自检
历史页会比对「宿主里本进程启动后的审批数」与「插件实际收到的次数」。
宿主更多就显示严重警告:
审批监听器可能已失效 —— 宿主里本进程启动后有 3 次审批,但插件只收到 0 次。
处理办法:重启 DSH。
这条是为了解决一类没有任何信号的故障:插件监听器失效时不会崩、不会报错、
/diag 也会说"工作正常"(它拿的是旧计数)。用户只会觉得"这插件没用了"。
为什么历史页不用前端框架
服务端渲染、零客户端依赖。这是诊断类页面:它的存在意义是
"出问题时还能打开看看",所以它必须比它诊断的东西更结实——
不依赖浏览器半区、不发 fetch、不用 React。
升级注意
- 宿主半区有改动,必须重启 DSH。 只刷新页面不够。
- 运行时端口可能变(由 DSH 选择),文档里用
<dsh-web-port>指代。 engines.dsh: ">=0.2.0-rc.1 <0.3.0-0"- 若宿主不提供
sessionPersistence(旧版本),历史页仍能打开并说明原因,
注释可看,只是决策列不可用。