mcpField
C
cli-anything-mubu

cli-anything-mubu

github.com/hkuds生产力57.6k475 次安装5 周前更新
代码仓库

关于 cli-anything-mubu

cli-anything-mubu 是 Mubu 的命令行入口，供本机有活跃 Mubu 桌面会话的用户发现、检查和编辑文档。它支持本地数据检索，并以默认试运行方式执行实时修改。

主要功能

  1. 01发现文件夹与文档
  2. 02搜索备份内容
  3. 03查看文档节点与链接
  4. 04管理会话文档和节点上下文
  5. 05试运行后执行实时编辑

适用场景

  1. 01查找当前每日文档
  2. 02搜索备份中的笔记内容
  3. 03检查文档结构和同步变更
  4. 04在确认载荷后修改文档节点

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-mubu

安装后在 Claude Code 中输入/cli-anything-mubu确认已加载。

详细介绍

cli-anything-mubu

Mubu 实时桥接的规范打包入口。

安装

此 CLI 从规范的 agent-harness 源码树打包而来：

pip install -e .

前提条件：

  • Python 3.10+
  • 此机器上有一个活跃的 Mubu 桌面会话
  • CLI 可访问本地 Mubu 配置文件数据
  • 如需无参数每日助手，请设置 MUBU_DAILY_FOLDER

入口点

cli-anything-mubu
python -m cli_anything.mubu

不带子命令调用时，CLI 进入交互式 REPL 会话。

命令组

发现

用于文件夹、文档、最近记录及每日文档解析的发现命令。

命令描述

| docs | 列出本地备份中最新已知的文档快照。 |

| folders | 列出本地 RxDB 存储中的文件夹元数据。 |

| folder-docs | 列出某个文件夹的文档元数据。 |

| path-docs | 列出某个文件夹路径或文件夹 id 下的文档。 |

| recent | 利用备份、元数据及同步日志列出近期活跃的文档。 |

| daily | 查找 Daily 风格的文件夹并列出其中的文档。 |

| daily-current | 从某个 Daily 风格的文件夹解析当前每日文档。 |

检视

用于树视图、搜索、链接、同步事件及实时节点定位的检视命令。

命令描述

| show | 显示某个文档的最新备份树。 |

| search | 在最新备份中搜索匹配的节点文本或笔记内容。 |

| changes | 从本地日志解析最近的客户端同步变更事件。 |

| links | 从某个文档备份中提取出站 Mubu 文档链接。 |

| open-path | 通过完整路径、后缀路径、标题或文档 id 打开某个文档。 |

| doc-nodes | 列出实时文档节点及其节点 id 和更新目标路径。 |

| daily-nodes | 一步列出当前每日文档中的实时节点。 |

变更

针对 Mubu API 的干运行优先原子实时编辑的变更命令。

命令描述

| create-child | 针对实时 Mubu API 构建或执行一次子节点创建。 |

| delete-node | 针对实时 Mubu API 构建或执行一次节点删除。 |

| update-text | 针对实时 Mubu API 构建或执行一次文本更新。 |

会话

用于当前文档/节点上下文及本地命令历史的会话与状态命令。

命令描述

| 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 only after payload inspection

安全规则

  1. Agent 使用时优先采用分组命令；扁平的传统命令保留以兼容。
  2. 当 Agent 需要解析输出时，使用 --json。
  3. 在执行任何 mutate 命令之前，优先使用 discover 或 inspect 命令。
  4. 实时变更默认干运行，仅在使用 --execute 时执行。
  5. 优先使用 --node-id 和 --parent-node-id 而非文本匹配。
  6. delete-node 会移除整个目标子树。
  7. 即使文本相同的更新仍可能推进文档版本历史。
  8. 在使用无参数每日助手之前，显式传入每日文件夹引用或设置 MUBU_DAILY_FOLDER。

示例

交互式 REPL 会话

启动带有持久文档和节点上下文的交互式会话。

cli-anything-mubu
# Enter commands interactively
# Use 'help' to see builtins
# Use session commands to persist 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_doc
  • current_node
  • 本地命令历史

使用 session 命令组来查看或更新此状态。

面向 AI Agent

  1. 从 discover 或 inspect 开始，而不是 mutate。
  2. 使用 session status --json 恢复持久化的上下文。
  3. 在生成的提示词和自动化中使用分组命令。
  4. 在任何实时变更后验证后置条件。
  5. 当需要更严格的操作细节时，阅读包中的 TEST.md 和 README.md。

版本

0.1.1

评论

支持 Markdown