cli-anything-mubu 是做什么的？
幕布实时桥梁的标准打包入口点。
安装
此CLI从规范的 agent-harness 源代码树打包而来：
pip install -e .
先决条件：
- Python 3.10+
- 此机器上正在运行的幕布桌面会话
- CLI可访问的本地幕布配置文件数据
- 如需使用无参数每日辅助功能，请设置
MUBU_DAILY_FOLDER
入口点
cli-anything-mubu
python -m cli_anything.mubu
当不带子命令调用时，CLI会进入一个交互式REPL会话。
命令组
发现 (Discover)
用于发现文件夹、文档、最近记录以及每日文档解析的命令。
| 命令 | 描述 |
|---|
| docs | 从本地备份中列出最新的已知文档快照。 |
| folders | 从本地RxDB存储中列出文件夹元数据。 |
| folder-docs | 列出一个文件夹内的文档元数据。 |
| path-docs | 根据文件夹路径或文件夹ID列出文档。 |
| recent | 使用备份、元数据和同步日志列出最近活动的文档。 |
| daily | 查找每日格式的文件夹并列出其中的文档。 |
| daily-current | 从一个每日格式的文件夹中解析出当前的每日文档。 |
检查 (Inspect)
用于树形视图、搜索、链接、同步事件和实时节点定位的检查命令。
| 命令 | 描述 |
|---|
| show | 显示一个文档的最新备份树。 |
| search | 在最新备份中搜索匹配的节点文本或笔记内容。 |
| changes | 从本地日志中解析最近的客户端同步变更事件。 |
| links | 从一个文档备份中提取出站的幕布文档链接。 |
| open-path | 通过完整路径、后缀路径、标题或文档ID打开一个文档。 |
| doc-nodes | 列出具有节点ID和更新目标路径的实时文档节点。 |
| daily-nodes | 一步列出当前每日文档中的实时节点。 |
变异 (Mutate)
针对幕布API进行原子级实时编辑的变异命令（默认空运行）。
| 命令 | 描述 |
|---|
| create-child | 针对实时幕布API构建或执行一次子节点创建操作。 |
| delete-node | 针对实时幕布API构建或执行一次节点删除操作。 |
| update-text | 针对实时幕布API构建或执行一次文本更新操作。 |
会话 (Session)
用于当前文档/节点上下文和本地命令历史的会话与状态命令。
| 命令 | 描述 |
|---|
| status | 显示当前会话状态。 |
| state-path | 显示会话状态文件的路径。 |
| use-doc | 持久化当前文档引用。 |
| use-node | 持久化当前节点引用。 |
| use-daily | 解析并持久化当前每日文档引用。 |
| clear-doc | 清除当前文档引用。 |
| clear-node | 清除当前节点引用。 |
| history | 显示会话状态中存储的最近命令历史。 |
推荐的Agent工作流程
discover daily-current '<daily-folder-ref>' --json
->
inspect daily-nodes '<daily-folder-ref>' --query '<anchor>' --json
->
session use-doc '<doc_path>'
->
mutate update-text / create-child / delete-node --json
->
--execute 仅在检查负载之后
安全规则
- 建议Agent优先使用分组命令；旧的扁平命令保留用于兼容。
- 当Agent需要解析输出时，请使用
--json。 - 在任何
mutate命令之前，优先使用discover或inspect命令。 - 实时变异默认为空运行，仅当指定
--execute时才执行。 - 优先使用
--node-id和--parent-node-id而非文本匹配。 delete-node会移除整个目标子树。- 即使是相同文本的更新，也可能推进文档版本历史。
- 在使用无参数的每日辅助功能之前，请显式传递每日文件夹引用或设置
MUBU_DAILY_FOLDER。
示例
交互式REPL会话
启动一个具有持久文档和节点上下文的交互式会话。
cli-anything-mubu
# 交互式输入命令
# 输入 'help' 查看内置命令
# 使用会话命令持久化 current-doc/current-node
发现当前每日笔记
从显式的文件夹引用中解析当前每日笔记。
cli-anything-mubu --json discover daily-current '<daily-folder-ref>'
空运行原子更新
在执行实时变异之前检查确切的传出负载。
cli-anything-mubu mutate update-text '<doc-ref>' --node-id <node-id> --text 'new text' --json
会话状态
CLI以JSON格式维护轻量级的会话状态：
current_doccurrent_node- 本地命令历史
使用 session 命令组来检查或更新此状态。
给AI Agent的建议
- 从
discover或inspect开始，而不是mutate。 - 使用
session status --json来恢复持久化的上下文。 - 在生成的提示和自动化脚本中使用分组命令。
- 在任何实时变异之后验证后置条件。
- 当需要更严格的操作细节时，请阅读包的
TEST.md和README.md。
版本
0.1.1