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 工作階段。
命令群組
探索（Discover）
用於資料夾、文件、近期活動及每日文件解析的探索命令。
| 命令 | 說明 |
|---|---|
docs | 從本機備份中列出最新的已知文件快照。 |
folders | 從本機 RxDB 儲存中列出資料夾中繼資料。 |
folder-docs | 列出單一資料夾內的文件中繼資料。 |
path-docs | 依資料夾路徑或資料夾 ID 列出文件。 |
recent | 使用備份、中繼資料和同步日誌列出近期活躍文件。 |
daily | 尋找每日風格的資料夾並列出其中的文件。 |
daily-current | 從一個每日風格的資料夾中解析出當前的每日文件。 |
檢查（Inspect）
用於樹狀檢視、搜尋、連結、同步事件及即時節點定位的檢查命令。
| 命令 | 說明 |
|---|---|
show | 顯示一份文件的最新備份樹。 |
search | 在最新備份中搜尋符合條件的節點文字或筆記內容。 |
changes | 從本機日誌中解析最近的用戶端同步變更事件。 |
links | 從一份文件備份中提取輸出的 Mubu 文件連結。 |
open-path | 依完整路徑、尾綴路徑、標題或文件 ID 開啟文件。 |
doc-nodes | 列出即時文件節點及其節點 ID 與更新目標路徑。 |
daily-nodes | 一次列出當前每日文件中的即時節點。 |
變更（Mutate）
針對 Mubu API 進行預設為乾執行的原子級即時編輯之變更命令。
| 命令 | 說明 |
|---|---|
create-child | 建立或執行一次子節點建立作業，作用於即時 Mubu API。 |
delete-node | 建立或執行一次節點刪除作業，作用於即時 Mubu API。 |
update-text | 建立或執行一次文字更新作業，作用於即時 Mubu API。 |
工作階段（Session）
用於目前文件/節點上下文及本機命令歷史記錄的工作階段與狀態命令。
| 命令 | 說明 |
|---|---|
status | 顯示目前的工作階段狀態。 |
state-path | 顯示工作階段狀態檔案的路徑。 |
use-doc | 持久化目前的文件參照。 |
use-node | 持久化目前的節點參照。 |
use-daily | 解析並持久化當前的每日文件參照。 |
clear-doc | 清除目前的文件參照。 |
clear-node | 清除目前的節點參照。 |
history | 顯示儲存在工作階段狀態中的近期命令歷史。 |
建議的代理工作流程
探索 daily-current '<daily-folder-ref>' --json
->
檢查 daily-nodes '<daily-folder-ref>' --query '<anchor>' --json
->
工作階段 use-doc '<doc_path>'
->
變更 update-text / create-child / delete-node --json
->
--只有在檢查過負載後才執行
安全規則
- 對於代理使用，建議使用分組命令；舊有的平面命令仍保留以相容舊版。
- 當代理需要解析輸出時，請使用
--json。 - 在任何
變更命令之前，建議先使用探索或檢查命令。 - 即時變更預設為乾執行，只有在加上
--execute時才會實際執行。 - 建議使用
--node-id和--parent-node-id，避免依賴文字比對。 delete-node會移除整個目標子樹。- 即使文字相同，更新仍然可能推進文件的版本歷史。
- 在使用無引數的每日輔助功能之前，請明確傳遞一個每日資料夾參照，或設定
MUBU_DAILY_FOLDER。
範例
互動式 REPL 工作階段
啟動一個具有持久化文件與節點上下文的互動式工作階段。
cli-anything-mubu
# 以互動方式輸入命令
# 使用 'help' 查看內建命令
# 使用工作階段命令來持久化目前文件/目前節點
探索當前每日筆記
從明確的資料夾參照解析當前的每日筆記。
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- 本機命令歷史記錄
請使用 工作階段 命令群組來檢查或更新此狀態。
給 AI 代理的說明
- 從
探索或檢查開始，不要從變更開始。 - 使用
工作階段 狀態 --json來復原持久化的上下文。 - 在產生的提示和自動化腳本中使用分組命令。
- 在執行任何即時變更後，請驗證後置條件。
- 當需要更嚴格的操作細節時，請閱讀套件的
TEST.md和README.md。
版本
0.1.1