@jsonstudio/rcc 0.90.323 → 0.90.352

package/docs/daemon-admin-ui.html

@@ -720,8 +720,8 @@
           <div class="title">
             <h1>RouteCodex Daemon Admin</h1>
             <p>
-              Writes to <span class="mono">~/.routecodex/config.json</span>. This UI requires an admin password:
-              first visit will ask you to set one (stored at <span class="mono">~/.routecodex/login</span>), then you login with it.
+              Writes to <span class="mono">~/.rcc/config.json</span>. This UI requires an admin password:
+              first visit will ask you to set one (stored at <span class="mono">~/.rcc/login</span>), then you login with it.
             </p>
           </div>
           <div class="statusline">
@@ -1039,7 +1039,7 @@
                   <input
                     id="apikeyValueInput"
                     type="password"
-                    placeholder="will be written to ~/.routecodex/auth/*.key"
+                    placeholder="will be written to ~/.rcc/auth/*.key"
                     style="flex: 1; min-width: 260px;"
                   />
                 </div>
@@ -1074,7 +1074,7 @@
                   <input
                     id="cookieFileInput"
                     type="text"
-                    placeholder="~/.routecodex/auth/iflow-work.cookie"
+                    placeholder="~/.rcc/auth/iflow-work.cookie"
                     style="flex: 1; min-width: 280px;"
                   />
                 </div>
@@ -1171,7 +1171,7 @@
             <div class="card" style="box-shadow:none;">
               <p class="section-title">Stats (historical)</p>
               <p class="section-sub">
-                Aggregated from <span class="mono">~/.routecodex/logs/provider-stats.jsonl</span> (best-effort).
+                Aggregated from <span class="mono">~/.rcc/logs/provider-stats.jsonl</span> (best-effort).
               </p>
               <div class="notice mono" id="statsHistoricalTotalsBox" style="white-space: pre-wrap;"></div>
               <div class="table-wrap" style="margin-top: 10px;">
@@ -1233,7 +1233,7 @@
               <p class="section-title">Token usage (session + historical)</p>
               <p class="section-sub">
                 Session stats reset on server restart. Historical totals are aggregated from
-                <span class="mono">~/.routecodex/logs/provider-stats.jsonl</span> (best-effort).
+                <span class="mono">~/.rcc/logs/provider-stats.jsonl</span> (best-effort).
               </p>
               <div class="row" style="margin-bottom: 10px;">
                 <button id="refreshTokensBtn" class="primary">Refresh</button>
@@ -1263,7 +1263,7 @@
             <div class="card" style="box-shadow:none;">
               <p class="section-title">Auth Inventory</p>
               <p class="section-sub">
-                Token files + API key authfiles in <span class="mono">~/.routecodex/auth</span>.
+                Token files + API key authfiles in <span class="mono">~/.rcc/auth</span>.
               </p>
               <div class="row" style="margin-bottom: 10px;">
                 <button id="refreshCredentialsBtn" class="primary">Refresh</button>
@@ -2292,7 +2292,7 @@
             type: "iflow",
             baseURL: "https://apis.iflow.cn/v1",
             compatibilityProfile: "chat:iflow",
-            auth: { type: "iflow-cookie", cookieFile: "~/.routecodex/auth/iflow-work.cookie" },
+            auth: { type: "iflow-cookie", cookieFile: "~/.rcc/auth/iflow-work.cookie" },
             models: {}
           };
         }
@@ -3216,7 +3216,7 @@
         if (authMode === "cookie") {
           base.auth = {
             type: "iflow-cookie",
-            cookieFile: ($("cookieFileInput").value || "").trim() || "~/.routecodex/auth/iflow.cookie"
+            cookieFile: ($("cookieFileInput").value || "").trim() || "~/.rcc/auth/iflow.cookie"
           };
         }
         if (authMode === "oauth") {

package/docs/design/servertool-stopmessage-lifecycle.md

@@ -45,6 +45,11 @@ Design goals:
 - Normal servertools (e.g. search/vision) may use `reenterPipeline`.
 - `stopMessage/clock/continue_execution` must use client injection dispatcher only.
 
+2. Continue-execution stripping:
+- `continue_execution` 的 tool_call 对客户端必须透明；响应侧在 chat process 的
+  `resp_process_stage2_finalize` 统一剥离该 tool_call，并将对应 choice 的
+  `finish_reason` 从 `tool_calls` 修正为 `stop`。
+
 2. No fallback:
 - No old session-based fallback compare.
 - No daemon-only fallback for stopMessage matching.

package/docs/golden-ci-library.md

@@ -28,10 +28,10 @@ roundtrip/工具校验，而不需要访问真实 provider。
 命令会按照下面的顺序执行：
 
 1. `node scripts/tools/capture-provider-goldens.mjs --custom-only --update-golden`
-   - 优先读取 `~/.routecodex/golden_samples/new/<entry>/<provider>/`；
+   - 优先读取 `~/.rcc/golden_samples/new/<entry>/<provider>/`；
    - 若用户目录缺失，则自动回退到 `samples/ci-goldens/...`；
    - 最后才会使用 `samples/chat-blackbox/**/request-basic.json` 做最小回放。
-   - 结果写入 `~/.routecodex/golden_samples/provider_golden_samples/**`，供 Provider
+   - 结果写入 `~/.rcc/golden_samples/provider_golden_samples/**`，供 Provider
      单测与 mock 回放使用。
 2. `node scripts/mock-provider/run-regressions.mjs`
    - 使用仓库内 `samples/mock-provider/_registry` 的样本，通过 mock provider
@@ -39,28 +39,28 @@ roundtrip/工具校验，而不需要访问真实 provider。
    - 默认启用 `ROUTECODEX_MOCK_ENTRY_FILTER=all`，确保 chat/responses/anthropic
      都被验证。
 
-如果检测到 `~/.routecodex/codex-samples`，脚本会提示可以运行
+如果检测到 `~/.rcc/codex-samples`，脚本会提示可以运行
 `node scripts/mock-provider/capture-from-configs.mjs` 将真实请求转成 mock 回放样本。
-该命令会根据本地 `~/.routecodex/provider/**/config*.json` 与
-`~/.routecodex/golden_samples/new/**` 生成新的 `samples/mock-provider/...`
+该命令会根据本地 `~/.rcc/provider/**/config*.json` 与
+`~/.rcc/golden_samples/new/**` 生成新的 `samples/mock-provider/...`
 目录，并刷新 `_registry/index.json`。随后再次执行 `npm run test:golden` 即可把
 “真实” provider 行为也纳入回归。
 
 ### 如何补充新的 provider 样本
 
 1. 在本地 `routecodex` 服务上真实跑通一次请求，确认
-   `~/.routecodex/golden_samples/new/<entry>/<provider>/request.sample.json` 已生成。
+   `~/.rcc/golden_samples/new/<entry>/<provider>/request.sample.json` 已生成。
 2. 运行 `npm run sync:ci-goldens`（或直接执行
    `node scripts/tools/sync-ci-goldens.mjs --entry <entry> --provider <id>`）把刚产生的
    样本复制到 `samples/ci-goldens/<entry>/<provider>/`，脚本会自动生成/刷新 `meta.json`
    并用 `source: "ci-goldens"` 标识。
 3. 运行 `npm run test:golden`，确认新的样本能够被
    `capture-provider-goldens.mjs` 消费并写入
-   `~/.routecodex/golden_samples/provider_golden_samples/<provider>/<entry>/`。
+   `~/.rcc/golden_samples/provider_golden_samples/<provider>/<entry>/`。
 4. 如需把同一份请求加入 mock provider 回放，可执行
    `node scripts/mock-provider/capture-from-configs.mjs --filter <providerId>`，
    该命令会复用刚才的 `request.sample` 生成 `samples/mock-provider/...` 记录。
 
 > 注意：CI goldens 只存储对齐 chat 入口输入字段的最终 JSON，不包含任何密钥或本地路径。
 > 如需测试特定机密字段，请在本地运行 `capture-provider-goldens` 并利用私有
-> `~/.routecodex/golden_samples/new/**`，不要把敏感样本提交到仓库。
+> `~/.rcc/golden_samples/new/**`，不要把敏感样本提交到仓库。

package/docs/monitoring/Design.md

@@ -19,7 +19,7 @@ This document describes a passive monitoring and replay system for RouteCodex.
 - ReplayExecutor (future): replay `response.json` or `stream-events.jsonl`
 
 ## Storage Layout
-Root: `~/.routecodex/monitor/sessions/<YYYYMMDD>/<protocol>/<reqId>/`
+Root: `~/.rcc/monitor/sessions/<YYYYMMDD>/<protocol>/<reqId>/`
 
 - `meta.json`             — meta + routing snapshot + redaction flags
 - `request.json`          — original input (protocol‑native)
@@ -45,7 +45,7 @@ Root: `~/.routecodex/monitor/sessions/<YYYYMMDD>/<protocol>/<reqId>/`
 
 ```bash
 npm run build
-node scripts/virtualrouter-dry-run-matrix.mjs --config ~/.routecodex/config/verified_0.46.32/multi-provider.json
+node scripts/virtualrouter-dry-run-matrix.mjs --config ~/.rcc/config/verified_0.46.32/multi-provider.json
 ```
 
 ## Integration Plan (Phased)

package/docs/multi-token-auth-guide.md

@@ -16,28 +16,28 @@ The `alias` part is optional and ignored by the system - it's just for your refe
 
 ## Automatic Discovery
 
-The system automatically scans `~/.routecodex/auth/` for token files matching the pattern and creates multiple provider instances. No manual configuration needed.
+The system automatically scans `~/.rcc/auth/` for token files matching the pattern and creates multiple provider instances. No manual configuration needed.
 
 ## Authentication Commands
 
 ### Authenticate specific token:
 ```bash
 # Token 1
-IFLOW_TOKEN_FILE="$HOME/.routecodex/auth/iflow-oauth-1-primary.json" node scripts/auth-iflow-token-direct.mjs
+IFLOW_TOKEN_FILE="$HOME/.rcc/auth/iflow-oauth-1-primary.json" node scripts/auth-iflow-token-direct.mjs
 
 # Token 2
-IFLOW_TOKEN_FILE="$HOME/.routecodex/auth/iflow-oauth-2-backup.json" node scripts/auth-iflow-token-direct.mjs
+IFLOW_TOKEN_FILE="$HOME/.rcc/auth/iflow-oauth-2-backup.json" node scripts/auth-iflow-token-direct.mjs
 ```
 
 ### Manual authentication (if device flow fails):
 ```bash
-IFLOW_TOKEN_FILE="$HOME/.routecodex/auth/iflow-oauth-1-primary.json" node scripts/auth-iflow-manual.mjs
+IFLOW_TOKEN_FILE="$HOME/.rcc/auth/iflow-oauth-1-primary.json" node scripts/auth-iflow-manual.mjs
 ```
 
 ### Delete and re-authenticate:
 ```bash
-rm ~/.routecodex/auth/iflow-oauth-1-primary.json
-IFLOW_TOKEN_FILE="$HOME/.routecodex/auth/iflow-oauth-1-primary.json" node scripts/auth-iflow-token-direct.mjs
+rm ~/.rcc/auth/iflow-oauth-1-primary.json
+IFLOW_TOKEN_FILE="$HOME/.rcc/auth/iflow-oauth-1-primary.json" node scripts/auth-iflow-token-direct.mjs
 ```
 
 ## How It Works

package/docs/oauth-authentication-guide.md

@@ -118,7 +118,7 @@ const provider = new ChatHttpProvider(iflowConfig, dependencies);
 await provider.initialize(); // → 打开浏览器 → 授权 → 获取 API Key
 
 // 3. 后续使用直接读取本地 token 文件
-// ~/.routecodex/auth/iflow-oauth.json 包含：
+// ~/.rcc/auth/iflow-oauth.json 包含：
 // {
 //   "access_token": "...",
 //   "refresh_token": "...",

package/docs/oauth-iflow-implementation.md

@@ -102,7 +102,7 @@ const provider = new ChatHttpProvider(iflowConfig, dependencies);
 await provider.initialize(); // → 打开浏览器 → 授权 → 获取 API Key
 
 // 3. 后续使用直接读取本地 token 文件
-// ~/.routecodex/auth/iflow-oauth.json 包含：
+// ~/.rcc/auth/iflow-oauth.json 包含：
 // {
 //   "access_token": "...",
 //   "refresh_token": "...",
@@ -140,7 +140,7 @@ const response = await provider.processIncoming({
 
 ```bash
 # 测试 OAuth 流程
-node -e "const { TokenFileAuthProvider } = require('./dist/providers/auth/tokenfile-auth.js'); const provider = new TokenFileAuthProvider({type: 'oauth', tokenFile: '~/.routecodex/auth/iflow-oauth.json'}); provider.initialize().then(() => console.log('✅ iFlow OAuth working:', provider.getStatus()));"
+node -e "const { TokenFileAuthProvider } = require('./dist/providers/auth/tokenfile-auth.js'); const provider = new TokenFileAuthProvider({type: 'oauth', tokenFile: '~/.rcc/auth/iflow-oauth.json'}); provider.initialize().then(() => console.log('✅ iFlow OAuth working:', provider.getStatus()));"
 
 # 测试 API Key 提取
 node -e "const { fetchIFlowUserInfo } = require('./dist/providers/auth/iflow-userinfo-helper.js'); fetchIFlowUserInfo('test_token').catch(e => console.log('✅ Error handling working:', e.message));"

package/docs/pipeline-routing-report.md

@@ -80,7 +80,7 @@
 
 ## 配置情况
 
-- 用户 `~/.routecodex/config.json`（或 `ROUTECODEX_CONFIG_PATH` 指定的文件）由 `bootstrapVirtualRouterConfig` 直接解析，得到 `virtualRouter` + `targetRuntime`，HTTP 服务按该结果构造 Hub Pipeline 与 Provider。
+- 用户 `~/.rcc/config.json`（或 `ROUTECODEX_CONFIG_PATH` 指定的文件）由 `bootstrapVirtualRouterConfig` 直接解析，得到 `virtualRouter` + `targetRuntime`，HTTP 服务按该结果构造 Hub Pipeline 与 Provider。
 - OpenAI Router 中的 `targetUrl` 由构造参数/默认值直接决定，并非来自 `modules.json`：
   - `src/server/protocol-handler.ts:89`
 

package/docs/plans/manager-daemon/PLAN.md

@@ -12,7 +12,7 @@
 ## 模块划分
 
 - `TokenManager`（模块 id: `token`）
-  - 继承现有 token daemon 职责：监控 `~/.routecodex/auth/`、刷新 OAuth token、触发重新认证。
+  - 继承现有 token daemon 职责：监控 `~/.rcc/auth/`、刷新 OAuth token、触发重新认证。
   - API：供 CLI / HTTP server 查询 token 状态与触发刷新。
    - 通过 host 级 leader lock（基于 PID 的锁文件）保证 **全局仅有一个 Token 刷新器**（server 内置 TokenManager 与外部 `token-daemon` 互斥）。
 

package/docs/plans/provider-config-v2-plan.md

@@ -3,7 +3,7 @@
 ## 目标与约束
 
 - 将现有「virtualrouter 内联 providers + routing」改为：
-  - Provider 配置：按 provider 维度拆分到 `~/.routecodex/provider/<id>/config.v2.json`。
+  - Provider 配置：按 provider 维度拆分到 `~/.rcc/provider/<id>/config.v2.json`。
   - Routing 配置：保留在主配置（或单独 routing 文件）中，仅描述 route → pool → providerKey 关系。
 - v2 配置通过 `version: "2.0.0"` 与 v1 完全区分，不影响已有 v1 配置（`config.v1.json` / `config.json.virtualrouter.providers`）。
 - 正式运行路径**不做 v1/v2 兼容合并**：v2 模式只读 provider v2 配置；v1 配置仅供迁移脚本和回溯分析使用。
@@ -15,12 +15,12 @@
 
 1. 顶层 Provider 目录
 
-- 路径：`~/.routecodex/provider`
+- 路径：`~/.rcc/provider`
 - 启动行为：
   - 若目录不存在：启动时自动创建。
   - 若存在：每个子目录代表一个 provider 实例（`<providerId>` 或 `<providerId>-<profile>`）。
 
-2. 单个 Provider 目录结构（示例：`~/.routecodex/provider/antigravity`）
+2. 单个 Provider 目录结构（示例：`~/.rcc/provider/antigravity`）
 
 - 静态配置（v2）：
   - 文件：`config.v2.json`
@@ -35,7 +35,7 @@
       "auth": {
         "mode": "oauth",
         "oauthProviderId": "antigravity",
-        "tokenFile": "~/.routecodex/auth/antigravity-oauth-1-geetasamodgeetasamoda.json"
+        "tokenFile": "~/.rcc/auth/antigravity-oauth-1-geetasamodgeetasamoda.json"
       },
       "models": [
         {
@@ -91,7 +91,7 @@
 2. VirtualRouterInput 组合逻辑（v2 模式）
 
 - 启动时步骤：
-  1. 扫描 `~/.routecodex/provider`：
+  1. 扫描 `~/.rcc/provider`：
      - 如不存在则创建空目录。
      - 对每个子目录：若存在 `config.v2.json`：解析为 `ProviderConfigV2`；否则跳过（无隐式迁移）。
   2. 从 `config.json` / routing 文件读取 routing 配置。
@@ -130,7 +130,7 @@
 - 预览：
   - 在终端打印拟写入的 `config.v2.json`，高亮关键字段。
 - 确认：
-  - 用户确认后写入/覆盖 `~/.routecodex/provider/<id>/config.v2.json`。
+  - 用户确认后写入/覆盖 `~/.rcc/provider/<id>/config.v2.json`。
 
 3. list/delete 行为
 
@@ -139,7 +139,7 @@
 - delete：
   - 询问确认后：
     - 仅删除 `config.v2.json`（保留 runtime-state 调试），或
-    - 删除整个 `~/.routecodex/provider/<id>` 目录（可作为高级选项，默认不做）。
+    - 删除整个 `~/.rcc/provider/<id>` 目录（可作为高级选项，默认不做）。
 
 ---
 
@@ -152,7 +152,7 @@
    - 定义 `config.v2.json` 的 TypeScript 接口与基础校验逻辑。
 
 2. 阶段 2：Provider v2 loader（只读，不接入 runtime）
-   - 实现扫描 `~/.routecodex/provider` 的 ProviderConfigV2 loader（**只读取显式 `config.v2.json`**，不做自动迁移）。
+   - 实现扫描 `~/.rcc/provider` 的 ProviderConfigV2 loader（**只读取显式 `config.v2.json`**，不做自动迁移）。
    - 编写单元测试：确保 loader 对合法 v2 配置的读取行为稳定、可预期；迁移逻辑由单独脚本负责。
 
 3. 阶段 3：Routing loader 与 VirtualRouterInput 组合器

package/docs/plans/provider-runtime-manager-plan.md

@@ -71,10 +71,10 @@ interface ProviderRuntimeState {
   type ProviderRuntimeTable = Map<string, ProviderRuntimeState>; // key = providerKey
   ```
 - 磁盘持久化：
-  - 全局快照（可选）：`~/.routecodex/state/providers/<serverId>/providers.jsonl`
+  - 全局快照（可选）：`~/.rcc/state/providers/<serverId>/providers.jsonl`
   - 每 provider 本地状态（推荐）：
-    - `~/.routecodex/provider/<id>/runtime-state.json`
-    - `~/.routecodex/provider/<id>/events.jsonl`（ProviderErrorEvent / 手动操作日志）
+    - `~/.rcc/provider/<id>/runtime-state.json`
+    - `~/.rcc/provider/<id>/events.jsonl`（ProviderErrorEvent / 手动操作日志）
 - TTL 约束：
   - 所有 `cooldownExpiresAt` / `blacklistExpiresAt` 必须**硬性截断**在 24 小时以内：
     - 写入前：`expiresAt = min(now + requestedTtl, now + 24h)`。
@@ -179,7 +179,7 @@ Provider runtime 可以在发起请求前调用 `isRoutable` 做一次最终检
 
 1. Server 启动时：
    - ProviderRuntimeManager：
-     - 扫描 `~/.routecodex/provider/*/runtime-state.json`。
+     - 扫描 `~/.rcc/provider/*/runtime-state.json`。
      - 合并为全局 `ProviderRuntimeTable`，丢弃所有 `expiresAt <= now` 的条目。
    - Virtual Router Engine：
      - 通过注入的 `ProviderRuntimeView` 在首次构造时就能看到恢复后的状态。

package/docs/provider-analysis.md

@@ -39,7 +39,7 @@
    ▼
 ┌─────────────────────────────────────────────────────────────────┐
 │  3. Provider 配置生成 (writeProviderV2)                        │
-│     位置: ~/.routecodex/provider/{providerId}/config.v2.json  │
+│     位置: ~/.rcc/provider/{providerId}/config.v2.json  │
 │                                                                   │
 │  配置结构:                                                       │
 │  {                                                               │
@@ -59,7 +59,7 @@
    ▼
 ┌─────────────────────────────────────────────────────────────────┐
 │  4. 主配置生成 (buildV2ConfigObject)                            │
-│     位置: ~/.routecodex/config.json                              │
+│     位置: ~/.rcc/config.json                              │
 │                                                                   │
 │  配置结构:                                                       │
 │  {                                                               │
@@ -119,7 +119,7 @@ routecodex init --providers openai,qwen --default-provider qwen --force
 1. **创建 Provider 配置目录**:
 
 ```bash
-mkdir -p ~/.routecodex/provider/myprovider
+mkdir -p ~/.rcc/provider/myprovider
 ```
 
 2. **创建 config.v2.json**:
@@ -198,7 +198,7 @@ routecodex provider doctor myprovider
    - Provider 鉴权类型对照表
 
 2. **Provider 目录结构** (README.md 第 142-144 行):
-   - `~/.routecodex/provider/<providerId>/config.v2.json`
+   - `~/.rcc/provider/<providerId>/config.v2.json`
 
 3. **Provider 类型文档**:
    - `docs/PROVIDER_TYPES.md` - Provider 类型说明
@@ -264,7 +264,7 @@ routecodex provider validate myprovider
 
 #### A. Provider Catalog 扩展
 
-- [ ] 支持自定义 catalog 扩展 (`~/.routecodex/provider-catalog.json`)
+- [ ] 支持自定义 catalog 扩展 (`~/.rcc/provider-catalog.json`)
 - [ ] 支持从远程 URL 加载 catalog
 - [ ] catalog 版本管理和更新检查
 

package/docs/provider-quota-design.md

@@ -4,7 +4,7 @@
 
 ## 1. 文件结构
 
-- 根目录：`~/.routecodex/quota/`
+- 根目录：`~/.rcc/quota/`
   - `provider-quota.json`：当前生效的 quota 快照（virtual-router 只读）。
   - `provider-errors.ndjson`：错误事件流水（daemon 可选使用，用于恢复 / 调试）。
 
@@ -134,7 +134,7 @@
 ### Phase 4：virtual-router 接线（可通过 feature flag 控制）
 
 - 在 virtual-router 构建 provider 池时：
-  - 可选读取 `~/.routecodex/quota/provider-quota.json`：
+  - 可选读取 `~/.rcc/quota/provider-quota.json`：
     - 过滤 `inPool !== true` 或 `cooldownUntil/blacklistUntil > now` 的 provider。
     - 按 `priorityTier` 做 tier 调度。
 - 初期通过环境变量开启（例如 `ROUTECODEX_QUOTA_ENABLED=1`），待稳定后再作为默认路径。

package/docs/providers/antigravity-fingerprint-ua-warmup.md

@@ -8,7 +8,7 @@
 
 ## 0) 你需要知道的文件/目录/入口
 
-### 关键目录（默认都在 `~/.routecodex/`）
+### 关键目录（默认都在 `~/.rcc/`）
 
 - OAuth token：`auth/antigravity-oauth-*.json`
 - Camoufox profile：`camoufox-profiles/rc-gemini.<alias>/...`
@@ -54,7 +54,7 @@ RouteCodex 的版本号来源（从高到低）：
 1. `ROUTECODEX_ANTIGRAVITY_USER_AGENT` / `RCC_ANTIGRAVITY_USER_AGENT`（完全覆盖）
 2. `ROUTECODEX_ANTIGRAVITY_UA_VERSION` / `RCC_ANTIGRAVITY_UA_VERSION`
 3. 远程拉取（可通过 `ROUTECODEX_ANTIGRAVITY_UA_DISABLE_REMOTE=1` 禁用）
-4. `~/.routecodex/state/antigravity-ua-version.json`
+4. `~/.rcc/state/antigravity-ua-version.json`
 5. 兜底版本（仅保证“有值”，不保证不过期）
 
 ### 修复步骤
@@ -64,7 +64,7 @@ RouteCodex 的版本号来源（从高到低）：
    - `routecodex oauth antigravity-auto <token-selector-or-path>`
    - 或批量：`routecodex oauth reauth-required`
 3. 如果 Google 提示需要二次验证（账户风控页），用对应 alias 的 profile 打开浏览器完成验证（“养号/解封”）：
-   - `rcc camoufox ~/.routecodex/auth/antigravity-oauth-<alias>.json --url '<verify_url>'`
+   - `rcc camoufox ~/.rcc/auth/antigravity-oauth-<alias>.json --url '<verify_url>'`
 
 > 关键点：必须用 **同一个 alias 的 Camoufox profile** 打开验证页，否则容易造成“验证通过但指纹漂移 → 继续 403”。
 
@@ -105,7 +105,7 @@ RouteCodex 的版本号来源（从高到低）：
 - `chat:gemini` 不会跑 `gemini_cli_request_wrap`（因此不会做历史 `thoughtSignature` 注入）
 - Antigravity 必须用 `chat:gemini-cli`（Cloud Code Assist wrapper 对齐 + signature 注入）
 
-修复点：确保你的用户配置中（`~/.routecodex/config.json`）：
+修复点：确保你的用户配置中（`~/.rcc/config.json`）：
 
 ```jsonc
 {
@@ -143,7 +143,7 @@ RouteCodex 的版本号来源（从高到低）：
 > 这个验证不依赖“你是否真的有 quota”；只要 upstream 在某次响应里下发过 signature，后续注入就应当可见。
 
 ### 如何确认 compat profile 真的生效
-用 `--snap` 或 dev 默认快照（`~/.routecodex/codex-samples/...`）检查 pipeline stage8：
+用 `--snap` 或 dev 默认快照（`~/.rcc/codex-samples/...`）检查 pipeline stage8：
 - `chat_process.req.stage8.outbound.compat.json` 里必须出现 `chat:gemini-cli`
 - 如果你看到的是 `chat:gemini`，说明 profile 仍然配错（很容易复发“第一次 OK，第二次 429”）
 

package/docs/providers/antigravity-gemini-provider-compat.md

@@ -172,14 +172,14 @@ antigravity/<version> <os>/<arch>
 1. 显式 UA：`ROUTECODEX_ANTIGRAVITY_USER_AGENT` / `RCC_ANTIGRAVITY_USER_AGENT`（完全覆盖）
 2. 显式版本号：`ROUTECODEX_ANTIGRAVITY_UA_VERSION` / `RCC_ANTIGRAVITY_UA_VERSION`
 3. 远程拉取：`VERSION_URL`，失败时回退 `CHANGELOG_URL`（可用 `ROUTECODEX_ANTIGRAVITY_UA_DISABLE_REMOTE=1` 禁用）
-4. 本地磁盘 cache：`~/.routecodex/state/antigravity-ua-version.json`
+4. 本地磁盘 cache：`~/.rcc/state/antigravity-ua-version.json`
 5. 最后兜底：`KNOWN_STABLE_VERSION`（当前 `4.1.24`，对齐 Antigravity-Manager）
 
 ### 4.3 `<os>/<arch>` suffix 如何从指纹推断（并且为何禁 linux）
 
 实现位置：`src/providers/auth/antigravity-fingerprint.ts`
 
-- 指纹文件：`~/.routecodex/camoufox-fp/<profileId>.json`
+- 指纹文件：`~/.rcc/camoufox-fp/<profileId>.json`
 - 从 `CAMOU_CONFIG_1` 的 `navigator.*` 字段推断：
   - `windows|macos|linux`
   - `amd64|aarch64`
@@ -191,7 +191,7 @@ RouteCodex 约束：
 
 实现位置：`src/providers/core/config/camoufox-launcher.ts`
 
-- 每个 alias 都对应一个稳定 profileId（目录在 `~/.routecodex/camoufox-profiles/`）。
+- 每个 alias 都对应一个稳定 profileId（目录在 `~/.rcc/camoufox-profiles/`）。
 - `gemini-cli` 与 `antigravity` 共享同一“指纹家族（gemini）”，因此同 alias 在两者之间共享 profileId（避免一个账号跑出两套指纹）。
 - OS policy：对 `(providerFamily, alias)` 做稳定 hash，把不同 alias 分布到 `windows/macos`，并**严格禁止 linux**。
 

package/docs/providers/deepseek-web-provider-design.md

@@ -78,7 +78,7 @@
             {
               "alias": "1",
               "type": "deepseek-account",
-              "tokenFile": "~/.routecodex/auth/deepseek-account-1.json"
+              "tokenFile": "~/.rcc/auth/deepseek-account-1.json"
             }
           ]
         },

package/docs/providers/gemini-provider.md

@@ -42,7 +42,7 @@
 
 ```bash
 node dist/tools/provider-update/index.js \
-  --config /Users/you/.routecodex/provider/gemini/config.json \
+  --config /Users/you/.rcc/provider/gemini/config.json \
   --write --probe-keys --verbose
 ```
 

package/docs/providers/provider-composite-testing.md

@@ -77,8 +77,8 @@ test('protocol mismatch fails fast', async () => {
 ```
 npm run build
 node scripts/pipeline-dry-run.mjs \
-  --config ~/.routecodex/config.json \
-  --samples ~/.routecodex/codex-samples \
+  --config ~/.rcc/config.json \
+  --samples ~/.rcc/codex-samples \
   --out demo-results/pipeline-dryrun
 ```
 

package/docs/providers/tabglm-claude-code-compat.md

@@ -10,7 +10,7 @@ tabglm 的 Anthropic 入口会对请求做“官方客户端”校验；当 `sys
 
 ## 启用方式（推荐：只改 config）
 
-在 `~/.routecodex/config.json`（或你的自定义 config）里为 tabglm provider 开启 compat profile（必须显式配置，禁止推断）：
+在 `~/.rcc/config.json`（或你的自定义 config）里为 tabglm provider 开启 compat profile（必须显式配置，禁止推断）：
 
 - 推荐：`virtualrouter.providers.tabglm.compatibilityProfile = "anthropic:claude-code"`
 - 也支持：`virtualrouter.providers.tabglm.compatibilityProfile = "chat:claude-code"`

package/docs/replay-evidence-iflow-400.txt

@@ -6,13 +6,13 @@
 - Before fix: HTTP 400 business error 514
 - After fix: HTTP 200, successful response
 - Output saved: /tmp/replay-iflow-base-req_1770377342669_6d3e332c.txt (no longer available)
-- Verification command: `npm run replay:codex-sample -- --sample ~/.routecodex/codex-samples/openai-responses/iflow.1-186.kimi-k2.5/req_1770377342669_6d3e332c/client-request.json`
+- Verification command: `npm run replay:codex-sample -- --sample ~/.rcc/codex-samples/openai-responses/iflow.1-186.kimi-k2.5/req_1770377342669_6d3e332c/client-request.json`
 
 ### Sample 2: Stop_followup request (openai-responses-iflow.1-186...20260207T100636992-003_stop_followup)
 - Before fix: HTTP 400 business error 514
 - After fix: HTTP 200, successful response
 - Output saved: /tmp/replay-iflow-stop-followup-20260207T100636992-003.withkey.txt (no longer available)
-- Verification command: `npm run replay:codex-sample -- --sample ~/.routecodex/codex-samples/openai-responses/iflow.1-186.kimi-k2.5/.../client-request.json`
+- Verification command: `npm run replay:codex-sample -- --sample ~/.rcc/codex-samples/openai-responses/iflow.1-186.kimi-k2.5/.../client-request.json`
 
 ## Unaffected Provider (tab.gpt-5.3-codex) - Control Replay
 
@@ -20,7 +20,7 @@
 - Before fix: HTTP 200, unchanged
 - After fix: HTTP 200, unchanged
 - Output saved: /tmp/replay-control-tab-key1.req_1770381056958_a35ee9ff.txt (no longer available)
-- Verification command: `npm run replay:codex-sample -- --sample ~/.routecodex/codex-samples/openai-chat/tab.key1.gpt-5.3-codex/req_1770381056958_a35ee9ff/client-request.json`
+- Verification command: `npm run replay:codex-sample -- --sample ~/.rcc/codex-samples/openai-chat/tab.key1.gpt-5.3-codex/req_1770381056958_a35ee9ff/client-request.json`
 
 ## Summary
 All same-shape and control replays pass. The fix ensures:

package/docs/reports/routing-classification-report.json

@@ -13,12 +13,12 @@
     "vision"
   ],
   "sampleByCategory": {
-    "thinking": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1762999988376_zyns5xw9n_provider-request.json",
-    "longContext": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763000100195_09q89vvi2_provider-request.json",
-    "tools": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763002108961_i6ia6jndk_provider-request.json",
-    "webSearch": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763002108961_k3ysf83dl_provider-request.json",
-    "coding": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763002110308_iyj8j09zq_provider-request.json",
-    "default": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763014458732_3yfsckrin_provider-request.json"
+    "thinking": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1762999988376_zyns5xw9n_provider-request.json",
+    "longContext": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763000100195_09q89vvi2_provider-request.json",
+    "tools": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763002108961_i6ia6jndk_provider-request.json",
+    "webSearch": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763002108961_k3ysf83dl_provider-request.json",
+    "coding": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763002110308_iyj8j09zq_provider-request.json",
+    "default": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763014458732_3yfsckrin_provider-request.json"
   },
   "errors": []
 }

package/docs/reports/routing-classification-report.md

@@ -6,12 +6,12 @@
 
 ## Samples
 
-- thinking: /Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1762999988376_zyns5xw9n_provider-request.json
-- longContext: /Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763000100195_09q89vvi2_provider-request.json
-- tools: /Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763002108961_i6ia6jndk_provider-request.json
-- webSearch: /Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763002108961_k3ysf83dl_provider-request.json
-- coding: /Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763002110308_iyj8j09zq_provider-request.json
-- default: /Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763014458732_3yfsckrin_provider-request.json
+- thinking: /Users/fanzhang/.rcc/codex-samples/openai-chat/req_1762999988376_zyns5xw9n_provider-request.json
+- longContext: /Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763000100195_09q89vvi2_provider-request.json
+- tools: /Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763002108961_i6ia6jndk_provider-request.json
+- webSearch: /Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763002108961_k3ysf83dl_provider-request.json
+- coding: /Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763002110308_iyj8j09zq_provider-request.json
+- default: /Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763014458732_3yfsckrin_provider-request.json
 
 ## Errors
 

package/docs/reports/thinking-keywords-report.json

@@ -9,11 +9,11 @@
     "analyze": 12
   },
   "samplePerKeyword": {
-    "analysis": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1762999988376_zyns5xw9n_provider-request.json",
-    "思考": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763002108523_9wlgh144y_provider-request.json",
-    "推理": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763002108523_9wlgh144y_provider-request.json",
-    "分析": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763002108523_9wlgh144y_provider-request.json",
-    "reasoning": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763002387567_v2m2i4vc2_provider-request.json",
-    "analyze": "/Users/fanzhang/.routecodex/codex-samples/openai-chat/req_1763085298297_n028lwxea_provider-request.json"
+    "analysis": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1762999988376_zyns5xw9n_provider-request.json",
+    "思考": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763002108523_9wlgh144y_provider-request.json",
+    "推理": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763002108523_9wlgh144y_provider-request.json",
+    "分析": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763002108523_9wlgh144y_provider-request.json",
+    "reasoning": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763002387567_v2m2i4vc2_provider-request.json",
+    "analyze": "/Users/fanzhang/.rcc/codex-samples/openai-chat/req_1763085298297_n028lwxea_provider-request.json"
   }
 }