理脈 limai

理華와 理月의 공유 신경계 — 캐릭터에서 제일 원리로 추출한 독립 기관.

제일원리 도출

버린 것: 캐릭터의 LLM 작업 프롬프트（성격은 이전하지 않음）, 기억의 JS eval 트리거（보안）. 남긴 정수: 가중 무작위 스케줄링 아이디어→하트비트 백오프（heartbeat backoff）；STALE_READ 가드；SSRF 방어；경계 읽기（bounded reading）.

시작

npm install
npm run start          # ① stdio → Claude Desktop / Cursor 等本地客戶端
npm run serve:http     # ② HTTP MCP → GPT 客戶端 / 區網 / 遠端
npm run tick           # ③ 手動跑一次心跳（驗證感知層）

CLI 는 AI 에이전트 가 위해 설계됨

limai shot                       # → {"file":...,"width":1920,"height":1080,"bytes":...}
limai win                        # → {"foreground":...,"windows":[{process,title},…]}
limai clip [--json]              # 剪貼簿原文走 stdout（利於管線）
limai tick                       # 心跳一次，生命徵象 JSON
limai web search <q>             # → [{title,url,snippet},…]
limai web fetch <url>            # 正文走 stdout、中繼 stderr；--json 得全包裝
limai fs ls|read|write|edit|find|grep …
limai mem … / limai todo …       # 同前

에이전트 규악:

• 기본 출력은 JSON、오류 코드 접두사는 stderr 메시지（STALE_READ: …）로；종료 코드가 0이 아니면 실패

• fs edit 규약은 MCP와 동일하게: 반드시 fs read 먼저；관측 상태는 fs-state.json에 저장, "read 호출 → edit 호출" 이 호출을 가로질러도 유효，외부 변경은 반드시 차단（--force로 우회 가능）

• 성공한 fs write 도 관측을 만들어 edit 연결 가능（o-pi의 "성공 직후 연결" 규칙과 동일）

아키텍처에서 MCP는 핵심 모듈 위의 여러가지 인터페이스 중 하나일 뿐: 같은 vision 웹 / filesys / memory / todo / heartbeat 를 CLI 서브명령과 MCP 도구가 동시에 호출, 두 인터페이스는 데이터와 보안 계약을 공유.`

최초 실행 시 ~/.limai/（config.json・memory.json heart.json・todo.json・vitals.*・screenshots/）로 자동 생성하고 에코 token.

연동

로컬（stdio）

// claude_desktop_config.json
{ "mcpServers": { "limai": { "command": "node", "args": ["F:\\fount開發項目\\理脈\\src\\cli.mjs", "serve", "--stdio"] } } }

랜／같은기 GPT 클라이언트（Cherry Studio、LobeChat、OpenWebUI…）

node src/cli.mjs serve --http                # 預設 127.0.0.1:8931
# 對區網開放：--host 0.0.0.0 --token <強密碼>

{ "type": "http", "url": "http://192.168.x.x:8931/mcp",
  "headers": { "Authorization": "Bearer <token>" } }

클라우드 ChatGPT（Connectors／개발자 모드）

ChatGPT는 localhost에 접근 못하므로 공인 HTTPS가 필요합니다:

cloudflared tunnel --url http://127.0.0.1:8931
# → https://xxxx.trycloudflare.com

연결 URL 는 https://xxxx.trycloudflare.com/api？token=<token>（GPT류 클라이언트는 header 를 커스텀 할 수 없을 때가 많아, query로 전송이 가능）. 장기 계획: Tailscale를 사용하는 구멍 없이, 또는 Caddy 리버스 프록시로 자체 도메인 적용.

보안 경계

• 파일: config.json 의 allowedRoots에 구속；.git 은 영구히 차단；fs_edit 은 반드시 fs_read 먼저（STALE_READ 버전 가드）；원텍스트는 유일해야 함

• 네트워크: localhost/사설망/링크local 차단（SSRF）, 리다이렉트 단계별 재확인, 2MB 상한, 30초 타임아웃

• 인증: HTTP 전체 Bearer/query-token；기본으로 127.0.0.1만 바인딩

• 프라이버시: 심장박스는 포그라운드 창 제목과 클립보드 해시만 기억（변동 시 이전 60자 저장）；픽셀 스크린샷은 명시적으로screen_capture를 호출한 때만 지원

하트비트 의미（理華 계속）

15 분 1회（설정 가능 heartbeat.intervalMin）. 매 토크 수집: 전창 윈도우・윈도우 목록（상위8）・빈 공백 시간（초）・클립보드 변화・개설 작업수. 실패하면 배간격 ×2（최대△8）, 성공 시 리셋. 기록은 vitals.ndjson에 회전 저장.

업스트림 동기화（o-pi）

• 2026-08-23 검사: 하루의 여러 커밋은 내부 리펙터링（file-tools/user-tools/filesystem/lsp 단순화）, 여섯 도구＋두 가지 웹 도구의 행동 계약은 같음；`" "duckduckgo-html-provider"는 아직도 제로-핵심 退 · … … … …

(That's it)