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

taxi-blackbox

flaky-memory