GitHub 仓库 · 发布者 TransmuteLabs

catalyst-probes

Name: catalyst-probes
Author: TransmuteLabs

# catalyst-probes

TransmuteLabs@TransmuteLabs

TransmuteLabs/Catalyst/tree/main/plugins/catalyst-probes

已翻译

关于这个 mod

一个 hooks 模块提供咨询引擎和确定性的表单裁判。咨询者和表单规则在 probes.toml 中配置，启用方式与咨询者契约记录在 NOTES.md。

Form boundary

重定向、tee 和列出的写入器会接受判断；解释器内部的记录不在判断范围内。

列出的写入器包括 cp、mv、install、dd of=、原地 sed 和 perl、truncate，以及强制符号 ln。目标必须能够静态确定。动态目标词和未知工作目录会被标记为警告。命令模型覆盖 bash 和 zsh 视图的并集，包括 shell 快照、静态赋值、glob 候选项和管道状态变体。

写入会在执行后判断，即使执行抛出异常也一样；但 log_only 下的候选扇出会跳过执行后判断（form-post-skipped-fanout）。拒绝类使用原始文件、链接或不存在状态进行比较与恢复；指纹变化或不可用，以及父路径被重新指向，会阻止恢复并产生明确警告。恢复会替换路径对象，而不是新链接所指向的内容。回滚警告会补充原始记录，不替代拒绝结果。

每个目标的备份资格是 F 加该目标的 A1–A3/C1。所有适用类别都设为 log_only 时，该目标不备份也不恢复，其字节不占用共享备份预算。准备阶段允许缺少父目录，但恢复会检查保存的祖先和新的目录链。恢复使用平台特定的目标为志，并在替换后检查文件指纹或链接拼写。

每次调用的备份预算是 4 MiB 判断阈值的 8 倍：超过备份容量会在执行前拒绝调用。

模块版本是 0.1.55。一次交付中先交付模块，再交付 canon。缺少必需的 canon 键会明确给出 F，而不是静默关闭表单判断。验证和测试不会激活已安装的插件。

安装

请先查看作者 README 确认 marketplace 和插件名称；命令可能随仓库结构改变。

claude plugin marketplace add TransmuteLabs/Catalyst
claude plugin install catalyst-probes

原文 / README

catalyst-probes

One hooks module provides the consultation engine and deterministic form judge. Consultants and form rules are configured in probes.toml; arming and the consultant contract are documented in NOTES.md.

Form boundary

судятся перенаправления, tee и перечисленные писатели; записи внутри интерпретаторов — вне суда

The listed writers are cp, mv, install, dd of=, in-place sed and perl, truncate, and forced symbolic ln. Targets must be statically determinable. Dynamic target words and unknown working directories are named warnings. The command model covers the union of bash and zsh views, including shell snapshots, static assignments, glob candidates, and pipeline state variants.

Writes are judged after execution, including when execution throws, except that candidate fan-out under log_only skips post-judgment (form-post-skipped-fanout). Refusing classes use compare-and-restore of the original file/link/absent state; changed or unavailable fingerprints and retargeted parent paths prevent restoration and produce named warnings. Restoration replaces the path object, not the contents of a new link's referent. Rollback warnings augment the original record without replacing its refusal. Backup eligibility is computed per target: F plus that target's A1–A3/C1. All applicable classes set to log_only means no backup and no restoration for that target; its bytes do not consume the shared backup budget. Missing parents are allowed during preparation, but restoration checks the saved ancestor and new directory chain. Restoration uses platform-specific destination flags and checks the resulting file fingerprint or link spelling after replacement. The backup budget is 8 times the 4 MiB judgment threshold per call: превышение объёма бэкапа отказывает вызов до исполнения.

The module version is 0.1.55. Deliver the module first and its canon second, in one delivery step. Missing required canon keys give an explicit F rather than silently disabling form judgment. Validation/tests do not activate the installed plugin.

作品信息

作者: TransmuteLabs
用途: 开发与调试
收录于: 2026年10月4日
来源更新: 2026年10月4日
星数: 3
权限足迹: L3
次浏览: 0

claude-code-pluginconsultationfilesystem-guardform-judgehooksl3-networkneeds-human-reviewrollback

回报这个作品这是你的作品？认领

赞助

在此刊登，$10/周起

权限足迹 L3

权限足迹

数据来自自动扫描，安装前请自行查看源码。等级描述能力，不代表安全认证。

执行命令
读文件
写文件
环境变量
模型调用
提交提示词
工具拦截
注册工具

查看命中位置（107）

执行命令 · 第372 行plugins/catalyst-probes/hooks/register.tsconst m = QUOTA_RECOVERY_RX.exec(s)

执行命令 · 第590 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_TEMPORAL_RX.exec(before)) !== null) {

执行命令 · 第618 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_STRONG_RX.exec(t)) !== null) {

执行命令 · 第622 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_AMBIGUOUS_RX.exec(t)) !== null) {

执行命令 · 第628 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_TOO_LONG_RX.exec(t)) !== null) {

执行命令 · 第640 行plugins/catalyst-probes/hooks/register.tswhile ((sm = REFUSAL_SIZE_FREE_SUBJECT_RX.exec(t)) !== null) {

执行命令 · 第681 行plugins/catalyst-probes/hooks/register.tsconst w = REFUSAL_WRAP_STATUS_RX.exec(text)

执行命令 · 第694 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_TOO_LONG_RX.exec(p)) !== null) {

执行命令 · 第705 行plugins/catalyst-probes/hooks/register.tswhile ((sm = REFUSAL_SIZE_FREE_SUBJECT_RX.exec(p)) !== null) {

执行命令 · 第722 行plugins/catalyst-probes/hooks/register.tsconst w = REFUSAL_WRAP_STATUS_RX.exec(text)

执行命令 · 第735 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_STRONG_RX.exec(p)) !== null) {

执行命令 · 第739 行plugins/catalyst-probes/hooks/register.tswhile ((m = REFUSAL_SIZE_AMBIGUOUS_RX.exec(p)) !== null) {

执行命令 · 第928 行plugins/catalyst-probes/hooks/register.tsconst m = RX_RESETS.exec(String(line || ""))

执行命令 · 第998 行plugins/catalyst-probes/hooks/register.tsconst st = REFUSAL_WRAP_STATUS_RX.exec(text)

执行命令 · 第1439 行plugins/catalyst-probes/hooks/register.tsconst m = /^"([\s\S]*)"\s*(?:#.*)?$/.exec(s)

执行命令 · 第1443 行plugins/catalyst-probes/hooks/register.tsconst m = /^'([\s\S]*)'\s*(?:#.*)?$/.exec(s)

执行命令 · 第1447 行plugins/catalyst-probes/hooks/register.tsconst m = /^\[([\s\S]*)\]\s*(?:#.*)?$/.exec(s)

执行命令 · 第1467 行plugins/catalyst-probes/hooks/register.tsconst m = /^\{([\s\S]*)\}\s*(?:#.*)?$/.exec(s)

执行命令 · 第1475 行plugins/catalyst-probes/hooks/register.tsconst kv = /^(?:"([^"]+)"|'([^']+)'|([A-Za-z0-9_.-]+))\s*=\s*([\s\S]*)$/.exec(el)

执行命令 · 第1547 行plugins/catalyst-probes/hooks/register.tsconst aa = /^\[\[(.+)\]\]$/.exec(s)

执行命令 · 第1549 行plugins/catalyst-probes/hooks/register.tsconst sec = /^\[(.+)\]$/.exec(s)

执行命令 · 第1553 行plugins/catalyst-probes/hooks/register.tsconst kv = /^(?:"([^"]+)"|'([^']+)'|([A-Za-z0-9_.-]+))\s*=\s*([\s\S]*)$/.exec(s)

执行命令 · 第1879 行plugins/catalyst-probes/hooks/register.tsconst m = re.exec(first)

执行命令 · 第1883 行plugins/catalyst-probes/hooks/register.tsconst mm = re.exec(lines[i].trim())

读文件 · 第1996 行plugins/catalyst-probes/hooks/register.tsconst v = await $.fs.read(path)

写文件 · 第2034 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(jpath + ".shard." + safe, line)

写文件 · 第2397 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(

环境变量 · 第2487 行plugins/catalyst-probes/hooks/register.tstry { cwd = String(await $.env.get("PWD") || "").trim() } catch (x) { cwd = ""; noteLost("cwd-env-read", x, $) }

执行命令 · 第3680 行plugins/catalyst-probes/hooks/register.tsconst w = (/^[^\s<>|;&()]*/.exec(tx.slice(q, e)) as RegExpExecArray)[0]

环境变量 · 第3845 行plugins/catalyst-probes/hooks/register.tstry { JUDGE_CARRIER = await $.env.get("CLAUDE_JUDGE_CARRIER") } catch (x) { unreadable.push("CLAUDE_JUDGE_CARRIER") }

环境变量 · 第3847 行plugins/catalyst-probes/hooks/register.tstry { JUDGE = await $.env.get("CLAUDE_JUDGE") } catch (x) { unreadable.push("CLAUDE_JUDGE") }

环境变量 · 第3849 行plugins/catalyst-probes/hooks/register.tstry { JUDGE_MODEL = await $.env.get("CLAUDE_JUDGE_MODEL") } catch (x) { unreadable.push("CLAUDE_JUDGE_MODEL") }

环境变量 · 第3851 行plugins/catalyst-probes/hooks/register.tstry { JUDGE_PROMPT = await $.env.get("CLAUDE_JUDGE_PROMPT") } catch (x) { unreadable.push("CLAUDE_JUDGE_PROMPT") }

环境变量 · 第3853 行plugins/catalyst-probes/hooks/register.ts

try { JUDGE_TIMEOUT = await $.env.get("CLAUDE_JUDGE_TIMEOUT_MS") } catch (x) { unreadable.push("CLAUDE_JUDGE_TIMEOUT_MS") }

环境变量 · 第3855 行plugins/catalyst-probes/hooks/register.tstry { FORM_CARRIER = await $.env.get("CLAUDE_FORM_CARRIER") } catch (x) { unreadable.push("CLAUDE_FORM_CARRIER") }

环境变量 · 第3857 行plugins/catalyst-probes/hooks/register.tstry { FORM = await $.env.get("CLAUDE_FORM") } catch (x) { unreadable.push("CLAUDE_FORM") }

环境变量 · 第3859 行plugins/catalyst-probes/hooks/register.tstry { IDLE_CARRIER = await $.env.get("CLAUDE_IDLE_CARRIER") } catch (x) { unreadable.push("CLAUDE_IDLE_CARRIER") }

环境变量 · 第3861 行plugins/catalyst-probes/hooks/register.tstry { IDLE = await $.env.get("CLAUDE_IDLE") } catch (x) { unreadable.push("CLAUDE_IDLE") }

环境变量 · 第3863 行plugins/catalyst-probes/hooks/register.tstry { PROBES = await $.env.get("CLAUDE_PROBES") } catch (x) { unreadable.push("CLAUDE_PROBES") }

环境变量 · 第3865 行plugins/catalyst-probes/hooks/register.tstry { PROMPTS = await $.env.get("CLAUDE_PROMPTS") } catch (x) { unreadable.push("CLAUDE_PROMPTS") }

环境变量 · 第3867 行plugins/catalyst-probes/hooks/register.tstry { PROBES_DIR = await $.env.get("CLAUDE_PROBES_DIR") } catch (x) { unreadable.push("CLAUDE_PROBES_DIR") }

环境变量 · 第3869 行plugins/catalyst-probes/hooks/register.tstry { CONFIG_DIR = await $.env.get("CLAUDE_CONFIG_DIR") } catch (x) { unreadable.push("CLAUDE_CONFIG_DIR") }

环境变量 · 第3871 行plugins/catalyst-probes/hooks/register.tstry { HOME = await $.env.get("HOME") } catch (x) { unreadable.push("HOME") }

环境变量 · 第3873 行plugins/catalyst-probes/hooks/register.tstry { PWD = await $.env.get("PWD") } catch (x) { unreadable.push("PWD") }

环境变量 · 第3875 行plugins/catalyst-probes/hooks/register.ts

try { ROUTING_TABLE = await $.env.get("CATALYST_ROUTING_TABLE") } catch (x) { unreadable.push("CATALYST_ROUTING_TABLE") }

执行命令 · 第4239 行plugins/catalyst-probes/hooks/register.tswhile ((mm = rx.exec(prompt)) && att.length < atn) {

写文件 · 第4384 行plugins/catalyst-probes/hooks/register.tstry { await $.fs.write(recPath, JSON.stringify(Object.assign({}, rec, { inflight: true }))) } catch (x) {

模型调用 · 第4439 行plugins/catalyst-probes/hooks/register.tsconst ans = readComplete(await raceDeadline($, $.model.complete(arg), tmo, used, rec, "probe-rung-late"))

写文件 · 第4577 行plugins/catalyst-probes/hooks/register.tstry { await $.fs.write(recPath, JSON.stringify(rec)) } catch (x) { noteLost("judge-record", x, $) }

写文件 · 第4596 行plugins/catalyst-probes/hooks/register.tsif (cfg.record !== false) await $.fs.write(recPath, JSON.stringify(rec))

执行命令 · 第5093 行plugins/catalyst-probes/hooks/register.tsconst m = /^(?:[\s({!]+|(?:then|do|else|elif|if|while|until|time)(?=\s)|[A-Za-z_][A-Za-z0-9_]*=\S*(?=\s))/.exec(r)

执行命令 · 第5101 行plugins/catalyst-probes/hooks/register.tsconst w = (/^[^\s<>|;&()]*/.exec(cmdHead(seg)) as RegExpExecArray)[0]

执行命令 · 第5177 行plugins/catalyst-probes/hooks/register.tsconst rd = /^(?:\d*)?(?:&>>!?|&>!?|>>!?|>\||>!|>&|>|<<<|<<-?|<&|<)/.exec(tx.slice(p, hi))

执行命令 · 第5196 行plugins/catalyst-probes/hooks/register.tsconst m = /^\$(?:\{[A-Za-z_][A-Za-z0-9_]*\}|[A-Za-z_][A-Za-z0-9_]*)/.exec(tx.slice(p))

读文件 · 第5391 行plugins/catalyst-probes/hooks/register.tstry { entries = await $.fs.list(dir) } catch (x) {

执行命令 · 第5407 行plugins/catalyst-probes/hooks/register.tsconst m = /^alias -- ([^=\s]+)=(.*)$/.exec(line)

读文件 · 第5539 行plugins/catalyst-probes/hooks/register.ts

try { entries = await $.fs.list(dir || "/") } catch (x) { if (!fleetEnoent(x)) noteLost("form-target-list", x, $); continue }

读文件 · 第5620 行plugins/catalyst-probes/hooks/register.ts

try { isDir = (await $.fs.stat(formResolve(dest.text, home, view.cwd))).kind === "dir" } catch (x) { if (!fleetEnoent(x)) noteLost("form-writer-stat", x, $) }

执行命令 · 第5637 行plugins/catalyst-probes/hooks/register.tsconst result = await $.process.run(["/usr/bin/readlink", path], { timeoutMs: 5000 })

执行命令 · 第5642 行plugins/catalyst-probes/hooks/register.tsconst platform = await $.process.run(["/usr/bin/uname", "-s"], { timeoutMs: 5000 })

读文件 · 第5649 行plugins/catalyst-probes/hooks/register.tsconst stat = await $.fs.stat(formParent(path), { resolve: true })

读文件 · 第5658 行plugins/catalyst-probes/hooks/register.tsconst stat = await $.fs.stat(ancestor, { resolve: true })

读文件 · 第5673 行plugins/catalyst-probes/hooks/register.tsconst ancestor = await $.fs.stat(path, { resolve: true })

读文件 · 第5677 行plugins/catalyst-probes/hooks/register.tsconst stat = await $.fs.stat(path)

读文件 · 第5715 行plugins/catalyst-probes/hooks/register.tsif (!stat) try { stat = await $.fs.stat(path) } catch (x) {

读文件 · 第5719 行plugins/catalyst-probes/hooks/register.tstry { resolved = await $.fs.stat(path, { resolve: true }) } catch (x) { return null }

执行命令 · 第5726 行plugins/catalyst-probes/hooks/register.ts

const result = await $.process.run(linux ? ["/usr/bin/sha256sum", "--", path] : ["/usr/bin/shasum", "-a", "256", "--", path], { timeoutMs: 5000 })

读文件 · 第5732 行plugins/catalyst-probes/hooks/register.tsconst bytes = knownBytes === undefined ? await $.fs.read(path, { as: "bytes" }) : { base64: knownBytes }

执行命令 · 第5743 行plugins/catalyst-probes/hooks/register.tsconst result = await $.process.run(["/bin/rm", "-f", "--", saved.path], { timeoutMs: 5000 })

执行命令 · 第5751 行plugins/catalyst-probes/hooks/register.tsconst copied = await $.process.run(["/bin/cp", state.copyFlag!, "--", saved.backup, temp], { timeoutMs: 5000 })

读文件 · 第5754 行plugins/catalyst-probes/hooks/register.tstry { current = await $.fs.stat(saved.path) } catch (x) { if (!fleetEnoent(x)) throw x }

执行命令 · 第5758 行plugins/catalyst-probes/hooks/register.tsconst moved = await $.process.run(["/bin/mv", "-f", destinationFlag, "--", temp, saved.path], { timeoutMs: 5000 })

读文件 · 第5760 行plugins/catalyst-probes/hooks/register.tsconst restored = await $.fs.stat(saved.path)

读文件 · 第5762 行plugins/catalyst-probes/hooks/register.tsconst resolved = await $.fs.stat(saved.path, { resolve: true })

执行命令 · 第5771 行plugins/catalyst-probes/hooks/register.tsconst removed = await $.process.run(["/bin/rm", "-f", "--", path], { timeoutMs: 5000 })

读文件 · 第5780 行plugins/catalyst-probes/hooks/register.tsconst stat = await $.fs.stat(target.path)

读文件 · 第5793 行plugins/catalyst-probes/hooks/register.tstry { stat = await $.fs.stat(target.path, { resolve: true }) } catch (x) { if (!fleetEnoent(x)) throw x }

读文件 · 第5801 行plugins/catalyst-probes/hooks/register.tstry { stat = await $.fs.stat(copyFrom, { resolve: true }) } catch (x) { if (fleetEnoent(x)) stat = null; else throw x }

执行命令 · 第5811 行plugins/catalyst-probes/hooks/register.tsconst made = await $.process.run(["/bin/mkdir", "-p", "-m", "700", "--", dir], { timeoutMs: 5000 })

执行命令 · 第5813 行plugins/catalyst-probes/hooks/register.tsconst privateDir = await $.process.run(["/bin/chmod", "700", "--", dir], { timeoutMs: 5000 })

执行命令 · 第5819 行plugins/catalyst-probes/hooks/register.tsconst result = await $.process.run(["/bin/cp", state.copyFlag!, "--", copyFrom, saved.backup], { timeoutMs: 5000 })

执行命令 · 第5830 行plugins/catalyst-probes/hooks/register.tsconst result = await $.process.run(["/bin/rm", "-f", "--", saved.backup], { timeoutMs: 5000 })

读文件 · 第5849 行plugins/catalyst-probes/hooks/register.tstry { stat = await $.fs.stat(target.path) } catch (x) {

读文件 · 第5856 行plugins/catalyst-probes/hooks/register.tsconst raw = await $.fs.read(target.path, { as: "bytes" })

读文件 · 第5861 行plugins/catalyst-probes/hooks/register.tsconst after = await $.fs.stat(target.path)

读文件 · 第5904 行plugins/catalyst-probes/hooks/register.tsconst resolved = await $.fs.stat(target.path, { resolve: true })

读文件 · 第5905 行plugins/catalyst-probes/hooks/register.tsconst referentStat = await $.fs.stat(saved.referent)

读文件 · 第5946 行plugins/catalyst-probes/hooks/register.tstry { current = await $.fs.stat(saved.path) } catch (x) { if (!fleetEnoent(x)) throw x }

执行命令 · 第5949 行plugins/catalyst-probes/hooks/register.ts

const linked = await $.process.run(["/bin/ln", "-s", "-f", destinationFlag, "--", saved.link!, saved.path], { timeoutMs: 5000 })

读文件 · 第5951 行plugins/catalyst-probes/hooks/register.tsconst restored = await $.fs.stat(saved.path)

写文件 · 第6145 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(recPath, JSON.stringify(record))

写文件 · 第6146 行plugins/catalyst-probes/hooks/register.ts} else await $.fs.write(recPath, JSON.stringify(formRec))

写文件 · 第6537 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(fleetDir(world) + "/" + fleetSafe(sid) + ".json", JSON.stringify(rec))

读文件 · 第6555 行plugins/catalyst-probes/hooks/register.tstry { ents = await $.fs.list(dir) } catch (x) {

读文件 · 第6585 行plugins/catalyst-probes/hooks/register.tstry { await $.fs.stat(path) } catch (x) { gone = fleetEnoent(x) }

执行命令 · 第6598 行plugins/catalyst-probes/hooks/register.tsconst pr = await $.process.run(["/bin/rm", "-f", path], { timeoutMs: 5000 })

提交提示词 · 第7168 行plugins/catalyst-probes/hooks/register.tsPromise.resolve().then(() => $.prompt.submit({ text })).then(

工具拦截 · 第7516 行plugins/catalyst-probes/hooks/register.tsif (!(await probeFiltered($, packed.world, p, "not-main", "tool.call", now, n))) {

工具拦截 · 第7696 行plugins/catalyst-probes/hooks/register.tsconst ev = snapEvent($, e, "tool.call")

写文件 · 第7945 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(modRecPath(world, p.id, ev), JSON.stringify({

写文件 · 第7961 行plugins/catalyst-probes/hooks/register.tsawait $.fs.write(modRecPath(world, p.id, ev), JSON.stringify({

注册工具 · 第8110 行plugins/catalyst-probes/hooks/register.ts

await $.tool.register({ name: FLEET_TOOL, description: FLEET_TOOL_DESCRIPTION, inputSchema: { type: "object", properties: {} } })

工具拦截 · 第8224 行plugins/catalyst-probes/hooks/register.tson("tool.call", async ($: any, e: any, next: any) => {

工具拦截 · 第8277 行plugins/catalyst-probes/hooks/register.ts.catch(($: any, e: any, next: any) => decisiveFailClosed($, "tool.call", e, next))

环境变量 · 第8580 行plugins/catalyst-probes/hooks/register.ts

try { stallRaw = await $.env.get("CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS") } catch (x) { stallRaw = undefined; noteLost("failover-stall-env", x, $) }

执行命令 · 第9044 行plugins/catalyst-probes/hooks/register.tsconst pr = await $.process.run(["/bin/sleep", sp.arg], { timeoutMs: sp.limit })

执行命令 · 第9473 行plugins/catalyst-probes/hooks/register.tsran = await $.process.run(["/bin/sleep", sp.arg], { timeoutMs: sp.limit })

catalyst-probes

关于这个 mod

Form boundary

安装

catalyst-probes

Form boundary

更多类似作品

thimble-cc-mod

flaky-memory

install-doctor