用途:cli-anything-mubu 是 Mubu 实时桥接的规范打包入口,面向命令行与 AI 智能体,用于在本地发现、检查并修改 Mubu 文档。
主要能力:分为四组命令。Discover 提供 docs、folders、folder-docs、path-docs、recent、daily、daily-current,用于列出本地备份快照、文件夹元数据、近期文档与每日文档。Inspect 提供 show、search、changes、links、open-path、doc-nodes、daily-nodes,用于查看备份树、搜索节点文本、解析同步变更、提取文档链接及定位实时节点。Mutate 提供 create-child、delete-node、update-text,对 Mubu API 做原子化编辑。Session 提供 status、state-path、use-doc、use-node、use-daily、clear-doc、clear-node、history,维护当前文档/节点上下文与本地命令历史。
使用方式:需 Python 3.10+、本机有活动的 Mubu 桌面会话及本地 Mubu 配置数据;安装命令为 pip install -e .。入口为 cli-anything-mubu 或 python -m cli_anything.mubu,不带子命令时进入交互式 REPL。无参数每日助手需显式传入每日文件夹引用或设置 MUBU_DAILY_FOLDER。推荐流程:discover daily-current '<daily-folder-ref>' --json,再 inspect daily-nodes '<daily-folder-ref>' --query '<anchor>' --json,然后 session use-doc '<doc_path>',最后执行 mutate 命令。
限制与安全:实时修改默认干跑,仅在检查载荷后加 --execute 才执行;delete-node 会删除整个目标子树;即使文本相同也可能推进文档版本历史;智能体应优先使用分组命令与 --json,先 discover/inspect 再 mutate,优先用 --node-id 与 --parent-node-id 而非文本匹配,并在修改后验证结果。更严格的操作细节需查阅包内 TEST.md 与 README.md。版本 0.1.1。