Skip to content

v0.7.0

Choose a tag to compare

@ArisuYuuko ArisuYuuko released this 18 Oct 04:31
· 7 commits to main since this release

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(旧版本),历史页仍能打开并说明原因,
    注释可看,只是决策列不可用。