返回资讯中心
外部精选
软件工程
#开发者实时流

watchdeck 发布:实时展示 Claude Code 每次会话被拦截的操作

来源标题:Watchdeck: See what every Claude Code session was stopped from doing

watchdeck 可把你机器上每个 Claude Code 会话展示为实时地图,呈现每次工具调用及决策来源,并能一键把一次拒绝转为规则。该工具本地运行、注重隐私,以单个二进制文件分发,支持脚本、Homebrew、Claude Code 插件及源码安装。安装脚本可加 --verify 用 GitHub CLI 或 cosign 校验发布来源。

Hacker News 最新pandataps2026/11/5 · 12 天前15 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

watchdeck 把你机器上每一个 Claude Code 会话显示成一张实时地图,每一次工具调用都标明是谁做的决定,并且一键就能把一次拒绝变成一条规则。本地运行,隐私不外泄,单个二进制文件。

curl -fsSL https://raw.githubusercontent.com/Panda-Taps-LLC/watchdeck/main/scripts/install.sh | sh

加上 --verify(curl … | sh -s -- --verify),就能在安装任何东西之前,用 GitHub CLI 或 cosign 校验该发布版本的来源。脚本取自 main 分支,安装的是最新发布版;用 --version vX.Y.Z 并改从该 tag 的 URL 获取脚本(而不是从 main),则两者都会被固定。也可以从 Homebrew tap 安装,其 formula 随每次发布更新:

brew install Panda-Taps-LLC/tap/watchdeck

或者在 Claude Code 里输入插件命令,它会在提示符上方显示状态条,并提供 /watchdeck:open 和 /watchdeck:status;它同样需要那个二进制文件,所以要在上面两种安装方式之一完成后再装:

/plugin install watchdeck --marketplace Panda-Taps-LLC/watchdeck

或者从源码构建(Go 1.27+):

git clone https://github.com/Panda-Taps-LLC/watchdeck && cd watchdeck go build -o ~/.local/bin/watchdeck ./cmd/watchdeck && watchdeck setup

setup 会测试沙箱、提供推荐规则,并添加 watchdeck 所需的 Claude Code 设置,每次写入前都会询问。watchdeck uninstall 经一次确认即可全部移除。

GIF 的左半部分是一个终端的渲染画面,标注为 demo。右半部分是运行在 fixture home 上的仪表盘,会话是合成的。两者的制作方式见:docs/images/README.md。

状态:v0.1.0,2026-11-04。macOS 上的强制执行已通过端到端验证。Linux(bubblewrap)通过了 CI,但尚未在开发者机器上运行过。许可证:Apache-2.0。

每个会话都在这里,进行中的排在最前,每个会话的最后几次调用显示为一条泳道。

这台机器上所有限制 agent 的东西,按强度从高到低排列;可以拿一次调用去试,也可以一步添加一条规则。

一次拒绝会变成一条规则,或者被确认,然后列表就清空了。

auto mode 一次只在一个会话内决定一次调用,它的 Recently denied 标签页只显示该会话。watchdeck 保留这台机器上每个会话的每一个决定,并写入 Claude Code 的 deny 和 ask 规则,auto mode 会在自己的检查之前应用这些规则。在 Claude Code 没有沙箱的地方,比如 skill 的脚本或 MCP server,watchdeck 会把每一个都放进各自的 OS 沙箱里运行。

文字指令。SKILL.md 仍然可以说服 agent 滥用 Read 或 WebFetch;只有脚本会被沙箱化。

auto mode 自己的决定。watchdeck 会记录它们并把它们变成规则,但不会改变 Claude Code 的检查如何决策。

bypassPermissions 模式。Claude Code 可以在那里不经你同意就处理掉一个 ask,所以 watchdeck 的 ask 会去掉沙箱重写;交互式的 bypass 会话尚未验证。

有人把它关掉。任何能编辑你的 Claude Code 设置的人都能移除 watchdeck 的 hooks;watchdeck doctor 会告诉你它什么时候没被安装。

运行时才构建出来的命令。命令执行时由另一个程序产生的词,比如通过管道送进 shell 的 tr、sed 或 base64 输出,是看不到的。

Claude Code 之外的东西。一个以你的身份运行、但不是由 Claude Code 启动的程序,不在覆盖范围内。

完整列表,以及每条背后的测试:docs/GUIDE.md。

在被拒绝时模型实际做了什么,来自 2026-10-20 和 2026-10-21 的 18 个无头会话,以及 2026-10-25 的另外四个会话(每条路径和泄漏都有对应规则和监视):docs/DENIED.md。

一切都留在这台机器上。仪表盘只监听 127.0.0.1,位于 token 之后,并且没有遥测。transcript 以只读方式读取:当仪表盘在 ~/.claude/projects 上构建会话索引时,以及当你打开一个会话时。其中 watchdeck 只保留一个本地搜索索引,watchdeck ui --no-transcripts 会把两者都关掉。索引和 watchdeck 自己的活动日志是你状态目录中的文件,权限模式 0600。

每个发布版都附带 checksums.txt、无密钥的 cosign 包 checksums.txt.sigstore.json 以及 GitHub 构建来源证明,全部由本仓库对应 tag 的发布工作流生成。使用 cosign 3.x(brew install cosign):

tag=v0.1.0 # 你下载的发布版;压缩包、checksums.txt 和 checksums.txt.sigstore.json 放在一起 cosign verify-blob
--certificate-identity "https://github.com/Panda-Taps-LLC/watchdeck/.github/workflows/release.yml@refs/tags/$tag"
--certificate-oidc-issuer https://token.actions.githubusercontent.com
--bundle checksums.txt.sigstore.json checksums.txt

grep watchdeck_0.1.0_darwin_arm64.tar.gz checksums.txt | shasum -a 256 -c # 你的压缩包;Linux 上用 sha256sum -c

第二条通道,用的是 Rekor 加工作流身份,而不是第二次下载:gh attestation verify watchdeck_0.1.0_darwin_arm64.tar.gz --repo Panda-Taps-LLC/watchdeck --signer-workflow Panda-Taps-LLC/watchdeck/.github/workflows/release.yml。失败意味着什么、该给我们发什么:SECURITY.md。维护者可以运行 scripts/verify-release.sh <tag>,它会针对 checksums.txt 跑 cosign 那段,对每个压缩包跑 gh 那段,并核对一个发布版的每个 sha256。安装脚本在带 --verify 时会替你跑 gh 那行(当 gh 未登录时跑 cosign 那行),一旦失败就什么都不装;这是设计如此,尚未针对真实发布版测试过。第一个签名发布版会随公开仓库一起到来。

命令 功能 watchdeck 在浏览器中打开仪表盘,需要时在后台启动它 watchdeck setup 首次运行:沙箱自检、推荐规则、watchdeck 所需的 Claude Code 设置;每次写入前都会询问 watchdeck status 一屏看全:防护状态、进行中的会话、需要你处理的事项、仪表盘和安装检查 watchdeck rules 这台机器上的所有规则,按强度从高到低排列,也是添加规则的地方 watchdeck doctor 检查安装,每项检查一行,并给出每个问题的修复方法 watchdeck uninstall 经一次确认即可移除 watchdeck,并说明它写入你的 Claude Code 设置的内容

更多命令:watchdeck help advanced。

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →