dsh-gif-gate

dsh-gif-gate

看动图前的策略闸门。Host-only，无 UI。

为什么

2026-11-08 20:42，gif-reading 技能和 Daily Chat 的 AGENTS.md 规则同时落地，当晚出现了两种结果：

• 有规则的工作区（Daily Chat）：20:50 收到一张 GIF，模型用 read 读了策略文档，再按流程拼条带判读；全程没有调 skill 工具。
• 没有规则的工作区（framedelta）：21:03 catalog 刚把 gif-reading 刷新进来，25 秒后（21:04）模型仍直接 read_animation 读了 D:\Desktop\88A9….gif——没调技能，也没读策略。

事后扫了 170 个会话 / 1401 轮：skill 工具共 121 次调用，gif-reading 0 次。所以问题不是「策略没人读」，而是：工作区规则能让人读，但只在那一个工作区；技能作为触发不可靠，换个工作区就失效。 约束因此挂到工具入口。

行为

• 监听 tools/pre-execute，只看 read_image / read_animation（可配）、只对 .gif / .webp
• 本会话未读策略时拒绝，拒绝理由里附策略文档前 30 行
• 用 read 读过策略文档后，本会话放行
• 最多拦两次，之后放行 —— 防死锁，也防模型无视两次还卡住
• 默认策略文档是包内自带的 strategy-template.md（一页检查单），装上就能跑
• 策略文档不存在时放行，并在启动日志里 warning（fail-open，但不再静默）
• guardStatic: true 时，拦截范围从动图扩到所有图片：不再看扩展名，凡 read_image / read_animation 调用都先过闸——heic、apng（.png 里的动图）、无后缀截图、大写扩展名同样拦。默认 false，旧行为不变

安装

# 本地目录（未发布时）
dsh plugin --profile <profile> add link:/absolute/path/to/dsh-gif-gate

# GitHub（发布后）
dsh plugin --profile <profile> add github:nacivageer/dsh-gif-gate

没有 dsh CLI 时，用 Plugin Manager 的 install_bundle 指向本目录绝对路径。

用你自己的策略文档

自带的模板只是示例。复制 strategy-template.md，改成你的判读流程，然后二选一：

• 环境变量：DSH_GIF_STRATEGY=<绝对路径>
• profile 的 patch 行：strategyPath: <绝对路径>

路径指向任意 .md。插件靠文件名判断「模型读的是不是这份文档」，所以读一份同名文件也会放行；换了文件名就照新名字匹配。

开了 guardStatic 的话，这份文档就是所有识图动作的入口——把「先查什么库、什么条件下才开图、看完登记到哪」写在最前面，因为拦截提示只展开前 30 行。

配置

不声明 Config，用环境变量或 patch 行覆盖：

键	默认
strategyPath / DSH_GIF_STRATEGY	包内 strategy-template.md
tools	['read_image', 'read_animation']
guardStatic / DSH_GIF_GATE_STATIC=1	false（只拦动图）

限制

• 只拦已知的看图工具；将来若换工具名需要同步改 tools
• 动图模式下只覆盖按文件路径读 .gif / .webp。贴进聊天框的动图由 dsh-read-animation 在附件入库时解成胶片条，不经过 read_image，这里拦不到
• guardStatic 模式下判断依据是工具不是扩展名：只要走 read_image / read_animation 就拦，因此动画 WebP、APNG 也会一起被拦（本来也该拦），副作用是「读图」这个动作变贵了一次
• 拦截状态在内存，重启后重置（可接受：每个会话本来就该过一次）
• 拦的是"读动图"这个动作，不校验模型读完策略后是否真按策略做了
• 截至 2026-11-11，拦截都来自探针（2026-11-08 22:30 的安装验证、2026-11-11 重启后的配置验证）；真实任务尚无拦截记录

English

A host-only gate for DeepSeek Harness: the first read_image / read_animation of a .gif / .webp in a session is denied once, with the opening lines of a strategy document in the reason. After the model reads that document, the session is released. Two denials at most, then it fails open.

It ships a one-page strategy-template.md so it works out of the box; point it at your own document with DSH_GIF_STRATEGY or strategyPath. It only covers reads by file path; GIFs pasted into the composer are decoded by dsh-read-animation before any tool runs and are out of scope.

With guardStatic: true (off by default) the gate stops filtering by extension: every read_image / read_animation call is gated, so static images (heic, apng, extension-less screenshots) are covered too.

License

MIT © 2026 72NG