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 스타일 폴더를 찾고 그 안의 문서를 나열합니다. |
daily-current | 하나의 Daily 스타일 폴더에서 현재 일일 문서를 해석합니다. |
inspect
트리 보기, 검색, 링크, 동기화 이벤트 및 라이브 노드 타겟팅을 위한 검사 명령입니다.
| 명령어 | 설명 |
|---|---|
show | 하나의 문서에 대한 최신 백업 트리를 표시합니다. |
search | 최신 백업에서 일치하는 노드 텍스트나 노트 내용을 검색합니다. |
changes | 로컬 로그에서 최근 클라이언트 동기화 변경 이벤트를 구문 분석합니다. |
links | 하나의 문서 백업에서 나가는 Mubu 문서 링크를 추출합니다. |
open-path | 전체 경로, 접미사 경로, 제목 또는 문서 ID로 문서를 엽니다. |
doc-nodes | 노드 ID 및 업데이트 대상 경로와 함께 라이브 문서 노드를 나열합니다. |
daily-nodes | 한 번에 현재 일일 문서에서 라이브 노드를 나열합니다. |
mutate
Mubu API에 대한 dry-run 우선 원자적 라이브 편집을 위한 변형 명령입니다.
| 명령어 | 설명 |
|---|---|
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 | 세션 상태에 저장된 최근 명령 기록을 표시합니다. |
권장 에이전트 워크플로
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 는 페이로드 검사 후에만 수행
안전 규칙
- 에이전트 사용을 위해 그룹화된 명령을 선호하십시오. 플랫 레거시 명령은 호환성을 위해 유지됩니다.
- 에이전트가 출력을 구문 분석할 때는 항상
--json을 사용하십시오. mutate명령 전에는discover또는inspect명령을 선호하십시오.- 라이브 변형은 기본적으로 dry-run 모드이며
--execute를 통해서만 실행됩니다. - 텍스트 일치보다는
--node-id및--parent-node-id를 선호하십시오. delete-node는 대상 전체 하위 트리를 제거합니다.- 동일한 텍스트 업데이트라도 문서 버전 기록을 진행시킬 수 있습니다.
- 인수 없는 일일 도우미를 사용하기 전에 daily-folder 참조를 명시적으로 전달하거나
MUBU_DAILY_FOLDER를 설정하십시오.
예제
대화형 REPL 세션
영구 문서 및 노드 컨텍스트를 사용하여 대화형 세션을 시작합니다.
cli-anything-mubu
# 명령을 대화형으로 입력
# 'help'를 사용하여 내장 명령 보기
# 세션 명령을 사용하여 current-doc/current-node 유지
현재 일일 노트 발견
명시적 폴더 참조에서 현재 일일 노트를 해석합니다.
cli-anything-mubu --json discover daily-current '<daily-folder-ref>'
Dry-Run 원자적 업데이트
라이브 변형 전에 정확한 발신 페이로드를 검사합니다.
cli-anything-mubu mutate update-text '<doc-ref>' --node-id <node-id> --text 'new text' --json
세션 상태
CLI는 JSON으로 간단한 세션 상태를 유지합니다:
current_doccurrent_node- 로컬 명령 기록
이 상태를 검사하거나 업데이트하려면 session 명령 그룹을 사용하십시오.
AI 에이전트를 위한 참고 사항
mutate가 아닌discover또는inspect로 시작하십시오.session status --json을 사용하여 유지된 컨텍스트를 복구하십시오.- 생성된 프롬프트와 자동화에서 그룹화된 명령을 사용하십시오.
- 라이브 변형 후에는 사후 조건을 확인하십시오.
- 더 엄격한 운영 세부 정보가 필요할 때는 패키지의
TEST.md및README.md를 읽으십시오.
버전
0.1.1