一句话定位:让 AI 工作区自己照顾自己,而不占用你和 Agent 的每一轮对话。
| 能力 | 状态 | 说明 |
|---|---|---|
| TTL | ✅ 已落地 | 产物注册追踪表(可持久化);到期判定 + product.expired 生命周期事件 + 追踪表移除 |
| trash(回收站) | ✅ native 已做实 / 🚧 其他目标降级 | native 用 moonbitlang/async/fs 的 mkdir/rename 真实移入 <watch_dir>/.trash/<name>.<ts>(零新增 C FFI);js/wasm 无此 API,诚实返回"不支持" |
| 加密 | 🚧 明确降级(不可做实) | rx 的 Fernet 原语是 extern "js"(node:crypto),native/wasm 加密返回空串;本项返回可诊断 Err,绝不写空密文破坏产物,待 rx 补 native crypto FFI |
| command | ✅ 已落地 | argv 数组执行,ExecPolicy 显式白名单(规则不会自动放行命令);拒绝事件现已落结果记录、可 e2e 对拍 |
| mcp_tool_call / webhook / internal | 🚧 扩展位 EP-01 | 返回可诊断错误 |
设计取舍详见 workbuddy/plan/p3-feasibility.md(历史定位)。trash 后续发现 moonbitlang/async@0.22.9(rx 0.4.4 传递依赖)在 native 提供 mkdir/rename C stub, 实测可做实,故由"规划中"升级为"native 已做实";加密因底层依赖 node:crypto 无法在 native 做实,维持诚实降级。两条路径均以实测为准,不把 no-op 包装成已实现。
| 门禁 | 位置 | 判定 | 失败处置 |
|---|---|---|---|
| guard(守卫门) | 动作执行前 | 单命令必须 exit 0(argv 与 command 同走白名单校验,绝不走 shell) | on_fail=skip:记 guard_fail 事件跳过本次动作(规则存活);on_fail=stop:记事件并停止本规则后续处理 |
| acceptance(验收门) | 动作执行后 | expect_exit / stdout_contains(AND) / stdout_not_contains / stderr_not_contains / artifact_glob(相对 watch_dir 至少命中 1 文件) | accepted=false(保留真实 exit 与输出原文),触发 product.invalid 进入既有 TTL/trash 回收流,不做自动重试(重试留给上层) |
声明式规则 (.mcp-watch.json)
│
▼
┌──────────────────┐
│ watch 后端 │ inotify / FSEvents / ReadDirectoryChangesW
└────────┬─────────┘
▼
┌──────────────────┐
│ rule 两层匹配 │ 事件类型 + glob → exclude 优先 → 条件(AND)
└────────┬─────────┘
▼
┌──────────────────┐
│ action 生命周期 │ TTL✅ / trash(native✅) / 加密🚧 / command✅ / mcp🚧 / webhook🚧
└──────────────────┘
│
▼
自治结果(落盘 / 回写 / 通知),全程无需 Agent 介入| 包 | 职责 |
|---|---|
| config | 规则 DSL 模型 + JSON 解析 + 累积式校验 |
| watch | 文件系统事件源(后端扩展点 EP-01) |
| rule | 两层匹配算法(事件+glob、exclude 优先、条件 AND) |
| action | 生命周期动作(TTL✅ / trash native✅·其他🚧 / 加密🚧 / command✅…)扩展点 EP-01 |
| ext | 扩展位注册表(EP-01~EP-12) |
| cron | cron 表达式解析与下次触发计算(纯逻辑、可测) |
| scheduler | 事件源 + cron 合并的主循环(待接入 rx EventBus) |
| cmd/main | CLI 入口(start/stop/status/run/validate) |
实现期将复用兄弟项目 rx-mbt(响应式内核:EventBus / 真实时钟 / 原生监控 / 命令 Observable),详见 rx-mbt/PLAN-mcp-watcher-apis.md。
moon build --target native
./mcp-watch validate --config .mcp-watch.json # 校验规则
./mcp-watch run --config .mcp-watch.json # 后台自治运行
./mcp-watch status # 观测
./mcp-watch stop # 终止Install
Download zip