claude-simple 0.2.24 → 0.2.26

package/README.md

@@ -14,6 +14,27 @@ Inspired by [cc-connect](https://github.com/chenhg5/cc-connect) agent adapters:
 
 **本地跑不需要中心端。** 单机默认就是 Standalone：UI + 后端 + agent 都在同一个 Node 进程里。
 
+### Multi-user, locks, port maps, Flutter
+
+Design: [`docs/multiuser-portmap-design.md`](docs/multiuser-portmap-design.md).
+
+| Piece | What it does |
+|-------|----------------|
+| Roles | `owner` / `admin` / `editor` / `viewer` — live role on mutating APIs |
+| Locks | Lease locks (`POST /api/collab/locks`, heartbeat/release/break). 423 if held. Auto-claim 30s on unguarded writes |
+| Port map | `POST /api/collab/routes` then visit `/r/{slug}/…` — Hub tunnels to edge `host:port` (loopback by default) |
+| Flutter 轻应用 | `app/` — login, machines, locks, routes, users; local JSON cache + sync |
+| 微信小程序 | `miniprogram/` — login, sessions, history and streaming chat over the same Hub APIs |
+
+Hub stores users/locks/routes under `hub-data/`. Standalone uses `.collab.json` plus `.credentials.json` (`role` on each user). Invite users: `POST /api/collab/users` as admin/owner.
+
+```
+cd app && flutter run
+# Hub URL e.g. http://127.0.0.1:8080
+```
+
+微信小程序可直接使用微信开发者工具导入 `miniprogram/`。开发工具中可临时关闭合法域名校验；上线前需要将 Hub 的 HTTPS/WSS 域名分别加到 request/socket 合法域名。完整说明见 [`miniprogram/README.md`](miniprogram/README.md)。
+
 前端会探测 `GET /api/hub`：没有该接口即按单机模式工作，逻辑与多机无关。
 
 ```
@@ -70,6 +91,8 @@ npm install -g @openai/codex
 | `CURSOR_HOME`        | `~/.cursor`                     | Cursor home (UI session journal)         |
 | `JWT_SECRET`         | persisted in `.credentials.json` | Override JWT signing key                 |
 | `AUTH_USERNAME` / `AUTH_PASSWORD` | —                    | Bootstrap first user from env            |
+| `ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_MODEL` | — | Anthropic-compatible APIs (DeepSeek etc.). LaunchAgent does **not** inherit shell `export` — use Settings → Claude env, `~/.claude/settings.json` `env`, or `~/.claude-simple-edge/agent-env.json` |
+| `ANTHROPIC_DEFAULT_*_MODEL` / `CLAUDE_CODE_SUBAGENT_MODEL` / `CLAUDE_CODE_EFFORT_LEVEL` | — | Merged into the Claude spawn env (`effort` e.g. `max`) |
 
 Edge-only env (when connecting to a hub):
 
@@ -140,7 +163,7 @@ Top bar **✦ Agent** — OpenAI-compatible tool agent (DeepSeek / OpenAI / loca
 | **代码** | `write_file` + `run_command` 生成并运行（有危险命令拦截） |
 | **VLM** | 粘贴/选图 → 上传为 `[imgN](路径)` 文本引用；需要时 `analyze_images`；`thread_id` 支持多轮追问 |
 
-API Key 存在服务端 `.ai_config.json`（已 gitignore）。配置入口：Agent 面板 ⚙。
+Meta Agent 由 **Hub** 托管；API Key、VLM Key、配置和会话数据都保存在 Hub 的持久化数据目录，不下发给 Edge 或 App（且不写入 Git）。配置接口只返回是否已配置，绝不回显 Key 明文。Hub 重启会中断进行中的 SSE，但不会删除已落盘的 Meta 会话或 VLM thread。
 
 **Session 持久化（同一 sessionId；多图 = 多个 VLM thread 文件）**
 
@@ -158,7 +181,7 @@ API Key 存在服务端 `.ai_config.json`（已 gitignore）。配置入口：Ag
 
 删除会话会整目录删除。旧版 `session.json`、`vlm.jsonl`、`vlm/*.json`、全局 `.ai/vlm/` 会自动迁移。
 
-Meta Agent 的实现入口：`src/agents/meta-agent.js`、`src/app.js`（`/api/ai/*`）与 `public/agent-panel.js`。
+Meta Agent 的 API 由 Hub 提供；旧版 Node/Edge 实现路径仅供迁移和历史参考。
 
 ## Multi-machine (optional)
 

package/client.js

@@ -150,15 +150,32 @@ async function refreshSessionCatalog() {
       const key = catalogKey(session);
       if (session.sessionId) next[key] = session;
     }
-    const before = syncState.catalog || {};
+    // Prefer the in-flight snapshot so a missing Hub ACK cannot re-diff
+    // against a stale committed catalog on every file watch.
+    const before = syncState.catalogPending?.next || syncState.catalog || {};
+    const fingerprint = (session) => {
+      if (!session) return '';
+      const { updatedAt, ...rest } = session;
+      return JSON.stringify(rest);
+    };
     const upserts = Object.entries(next)
-      .filter(([key, value]) => JSON.stringify(before[key]) !== JSON.stringify(value))
+      .filter(([key, value]) => fingerprint(before[key]) !== fingerprint(value))
       .map(([, value]) => value);
     const removes = Object.keys(before).filter(key => !next[key]);
     if (upserts.length || removes.length) {
       // Keep the outgoing delta on disk until the Hub confirms it. Retrying
       // is safe because Hub-side upserts/removes are idempotent.
-      const id = ++syncState.catalogSeq;
+      // If the Hub never ACKs (older hub, drop), do not mint a new seq or log
+      // on every fs watch — that flooded edge.out.log with "+1 -0".
+      const prev = syncState.catalogPending;
+      const same = prev
+        && JSON.stringify(prev.upserts) === JSON.stringify(upserts)
+        && JSON.stringify(prev.removes) === JSON.stringify(removes);
+      if (same) {
+        flushCatalogOutbox();
+        return;
+      }
+      const id = prev?.id || ++syncState.catalogSeq;
       syncState.catalogPending = { id, upserts, removes, next };
       void persistSyncState();
       flushCatalogOutbox();