@jsonstudio/rcc 0.90.323 → 0.90.364

package/dist/config/user-config-migration.js

@@ -0,0 +1,188 @@
+import fs from 'node:fs';
+import fsAsync from 'node:fs/promises';
+import path from 'node:path';
+import { resolveLegacyRouteCodexUserDir, resolveRccUserDir } from './user-data-paths.js';
+const USER_CONFIG_MIGRATION_ENTRIES = [
+    {
+        id: 'config_file',
+        kind: 'file',
+        legacyRelativePath: 'config.json',
+        targetRelativePath: 'config.json'
+    },
+    {
+        id: 'config_dir',
+        kind: 'dir',
+        legacyRelativePath: 'config',
+        targetRelativePath: 'config'
+    },
+    {
+        id: 'provider_dir',
+        kind: 'dir',
+        legacyRelativePath: 'provider',
+        targetRelativePath: 'provider',
+        skipRelativeSegments: ['samples']
+    },
+    {
+        id: 'auth_dir',
+        kind: 'dir',
+        legacyRelativePath: 'auth',
+        targetRelativePath: 'auth'
+    }
+];
+async function fileExists(targetPath) {
+    try {
+        await fsAsync.access(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function areFilesEqual(sourcePath, targetPath) {
+    try {
+        const [source, target] = await Promise.all([fsAsync.readFile(sourcePath), fsAsync.readFile(targetPath)]);
+        return source.equals(target);
+    }
+    catch {
+        return false;
+    }
+}
+function collectFilesUnderDir(baseDir, relativePrefix = '') {
+    const entries = fs.readdirSync(baseDir, { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        if (entry.name === '.DS_Store') {
+            continue;
+        }
+        const relativePath = relativePrefix ? path.join(relativePrefix, entry.name) : entry.name;
+        const absolutePath = path.join(baseDir, entry.name);
+        const stats = fs.lstatSync(absolutePath);
+        if (stats.isSymbolicLink()) {
+            continue;
+        }
+        if (stats.isDirectory()) {
+            files.push(...collectFilesUnderDir(absolutePath, relativePath));
+            continue;
+        }
+        if (stats.isFile()) {
+            files.push(relativePath);
+        }
+    }
+    return files;
+}
+function shouldSkipRelativePath(relativePath, skipRelativeSegments) {
+    if (!skipRelativeSegments || skipRelativeSegments.length === 0) {
+        return false;
+    }
+    const normalizedParts = relativePath.split(path.sep).filter(Boolean);
+    return normalizedParts.some((part) => skipRelativeSegments.includes(part));
+}
+async function collectEntryItems(entry, legacyRoot, targetRoot, overwrite) {
+    const sourceRoot = path.join(legacyRoot, entry.legacyRelativePath);
+    if (!fs.existsSync(sourceRoot)) {
+        return { missingRoot: entry.legacyRelativePath, items: [] };
+    }
+    const sourceStats = fs.lstatSync(sourceRoot);
+    if (sourceStats.isSymbolicLink()) {
+        return { missingRoot: entry.legacyRelativePath, items: [] };
+    }
+    const relativeFiles = entry.kind === 'file'
+        ? sourceStats.isFile()
+            ? ['']
+            : []
+        : sourceStats.isDirectory()
+            ? collectFilesUnderDir(sourceRoot)
+            : [];
+    const items = [];
+    for (const relativePath of relativeFiles) {
+        if (shouldSkipRelativePath(relativePath, entry.skipRelativeSegments)) {
+            continue;
+        }
+        const sourcePath = relativePath ? path.join(sourceRoot, relativePath) : sourceRoot;
+        const targetPath = relativePath
+            ? path.join(targetRoot, entry.targetRelativePath, relativePath)
+            : path.join(targetRoot, entry.targetRelativePath);
+        const sourceFileStats = await fsAsync.stat(sourcePath);
+        const targetExists = await fileExists(targetPath);
+        let action = 'copy';
+        if (targetExists) {
+            const same = await areFilesEqual(sourcePath, targetPath);
+            if (same) {
+                action = 'unchanged';
+            }
+            else {
+                action = overwrite ? 'overwrite' : 'conflict';
+            }
+        }
+        items.push({
+            entryId: entry.id,
+            relativePath: relativePath || path.basename(entry.targetRelativePath),
+            sourcePath,
+            targetPath,
+            action,
+            bytes: sourceFileStats.size
+        });
+    }
+    return { items };
+}
+export async function collectUserConfigMigrationPlan(options) {
+    const homeDir = options?.homeDir;
+    const overwrite = options?.overwrite === true;
+    const legacyRoot = resolveLegacyRouteCodexUserDir(homeDir);
+    const targetRoot = resolveRccUserDir(homeDir);
+    const items = [];
+    const missingRoots = [];
+    for (const entry of USER_CONFIG_MIGRATION_ENTRIES) {
+        const result = await collectEntryItems(entry, legacyRoot, targetRoot, overwrite);
+        if (result.missingRoot) {
+            missingRoots.push(result.missingRoot);
+        }
+        items.push(...result.items);
+    }
+    items.sort((left, right) => left.targetPath.localeCompare(right.targetPath));
+    const summary = {
+        total: items.length,
+        copy: items.filter((item) => item.action === 'copy').length,
+        overwrite: items.filter((item) => item.action === 'overwrite').length,
+        unchanged: items.filter((item) => item.action === 'unchanged').length,
+        conflict: items.filter((item) => item.action === 'conflict').length,
+        missingRoots
+    };
+    return {
+        legacyRoot,
+        targetRoot,
+        overwrite,
+        items,
+        summary
+    };
+}
+export async function applyUserConfigMigrationPlan(plan) {
+    let copied = 0;
+    let overwritten = 0;
+    let skippedConflicts = 0;
+    for (const item of plan.items) {
+        if (item.action === 'unchanged') {
+            continue;
+        }
+        if (item.action === 'conflict') {
+            skippedConflicts += 1;
+            continue;
+        }
+        await fsAsync.mkdir(path.dirname(item.targetPath), { recursive: true });
+        await fsAsync.copyFile(item.sourcePath, item.targetPath);
+        const stats = await fsAsync.stat(item.sourcePath);
+        await fsAsync.chmod(item.targetPath, stats.mode);
+        if (item.action === 'copy') {
+            copied += 1;
+        }
+        else {
+            overwritten += 1;
+        }
+    }
+    return {
+        copied,
+        overwritten,
+        skippedConflicts
+    };
+}
+//# sourceMappingURL=user-config-migration.js.map

package/dist/config/user-config-migration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-config-migration.js","sourceRoot":"","sources":["../../src/config/user-config-migration.ts"],"names":[],"mappings":"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"}

package/dist/config/user-data-paths.d.ts

@@ -0,0 +1,59 @@
+export declare const RCC_SUBDIRS: {
+    readonly auth: "auth";
+    readonly tokens: "tokens";
+    readonly quota: "quota";
+    readonly state: "state";
+    readonly logs: "logs";
+    readonly sessions: "sessions";
+    readonly snapshots: "codex-samples";
+    readonly provider: "provider";
+    readonly config: "config";
+    readonly guardian: "guardian";
+    readonly login: "login";
+    readonly statics: "statics";
+    readonly errorsamples: "errorsamples";
+    readonly llmsShadow: "llms-shadow";
+    readonly camoufoxFingerprint: "camoufox-fp";
+    readonly camoufoxProfiles: "camoufox-profiles";
+    readonly docs: "docs";
+    readonly precommand: "precommand";
+};
+export type RccSubdirKey = keyof typeof RCC_SUBDIRS;
+export declare function resolveRccUserDir(homeDir?: string): string;
+export declare function resolveLegacyRouteCodexUserDir(homeDir?: string): string;
+export declare function resolveRccUserDirForRead(homeDir?: string): string;
+export declare function resolveRccPath(...segments: string[]): string;
+export declare function resolveLegacyRouteCodexPath(...segments: string[]): string;
+export declare function resolveRccPathForRead(...segments: string[]): string;
+export declare function resolveRccSubdir(key: RccSubdirKey, homeDir?: string): string;
+export declare function resolveRccSubdirForRead(key: RccSubdirKey, homeDir?: string): string;
+export declare function resolveRccAuthDir(homeDir?: string): string;
+export declare function resolveRccAuthDirForRead(homeDir?: string): string;
+export declare function resolveRccTokensDir(homeDir?: string): string;
+export declare function resolveRccTokensDirForRead(homeDir?: string): string;
+export declare function resolveRccQuotaDir(homeDir?: string): string;
+export declare function resolveRccQuotaDirForRead(homeDir?: string): string;
+export declare function resolveRccStateDir(homeDir?: string): string;
+export declare function resolveRccStateDirForRead(homeDir?: string): string;
+export declare function resolveRccLogsDir(homeDir?: string): string;
+export declare function resolveRccLogsDirForRead(homeDir?: string): string;
+export declare function resolveRccSessionsDir(homeDir?: string): string;
+export declare function resolveRccSessionsDirForRead(homeDir?: string): string;
+export declare function resolveRccSnapshotsDir(homeDir?: string): string;
+export declare function resolveRccSnapshotsDirForRead(homeDir?: string): string;
+export declare function resolveRccProviderDir(homeDir?: string): string;
+export declare function resolveRccProviderDirForRead(homeDir?: string): string;
+export declare function resolveRccConfigDir(homeDir?: string): string;
+export declare function resolveRccConfigDirForRead(homeDir?: string): string;
+export declare function resolveRccGuardianDir(homeDir?: string): string;
+export declare function resolveRccLoginDir(homeDir?: string): string;
+export declare function resolveRccStaticsDir(homeDir?: string): string;
+export declare function resolveRccErrorsamplesDir(homeDir?: string): string;
+export declare function resolveRccLlmsShadowDir(homeDir?: string): string;
+export declare function resolveRccCamoufoxFingerprintDir(homeDir?: string): string;
+export declare function resolveRccCamoufoxProfilesDir(homeDir?: string): string;
+export declare function resolveRccDocsDir(homeDir?: string): string;
+export declare function resolveRccPrecommandDir(homeDir?: string): string;
+export declare function resolveRccConfigFile(homeDir?: string): string;
+export declare function resolveRccConfigFileForRead(homeDir?: string): string;
+export declare function ensureRccUserDirEnvironment(homeDir?: string): string;

package/dist/config/user-data-paths.js

@@ -0,0 +1,174 @@
+import path from 'node:path';
+import { homedir } from 'node:os';
+const PRIMARY_DIR_NAME = '.rcc';
+const LEGACY_DIR_NAME = '.routecodex';
+const USER_DIR_ENV_KEYS = ['RCC_HOME', 'ROUTECODEX_USER_DIR', 'ROUTECODEX_HOME'];
+export const RCC_SUBDIRS = {
+    auth: 'auth',
+    tokens: 'tokens',
+    quota: 'quota',
+    state: 'state',
+    logs: 'logs',
+    sessions: 'sessions',
+    snapshots: 'codex-samples',
+    provider: 'provider',
+    config: 'config',
+    guardian: 'guardian',
+    login: 'login',
+    statics: 'statics',
+    errorsamples: 'errorsamples',
+    llmsShadow: 'llms-shadow',
+    camoufoxFingerprint: 'camoufox-fp',
+    camoufoxProfiles: 'camoufox-profiles',
+    docs: 'docs',
+    precommand: 'precommand'
+};
+function resolveHomeDir(homeDir) {
+    const explicit = String(homeDir || '').trim();
+    if (explicit) {
+        return path.resolve(explicit);
+    }
+    const envHome = String(process.env.HOME || '').trim();
+    if (envHome) {
+        return path.resolve(envHome);
+    }
+    const resolved = homedir();
+    return path.resolve(resolved);
+}
+function expandHome(value, homeDir) {
+    if (!value.startsWith('~/')) {
+        return value;
+    }
+    return path.join(resolveHomeDir(homeDir), value.slice(2));
+}
+export function resolveRccUserDir(homeDir) {
+    for (const key of USER_DIR_ENV_KEYS) {
+        const raw = String(process.env[key] || '').trim();
+        if (raw) {
+            return path.resolve(expandHome(raw, homeDir));
+        }
+    }
+    return path.join(resolveHomeDir(homeDir), PRIMARY_DIR_NAME);
+}
+export function resolveLegacyRouteCodexUserDir(homeDir) {
+    return path.join(resolveHomeDir(homeDir), LEGACY_DIR_NAME);
+}
+export function resolveRccUserDirForRead(homeDir) {
+    return resolveRccUserDir(homeDir);
+}
+export function resolveRccPath(...segments) {
+    return path.join(resolveRccUserDir(), ...segments);
+}
+export function resolveLegacyRouteCodexPath(...segments) {
+    return path.join(resolveLegacyRouteCodexUserDir(), ...segments);
+}
+export function resolveRccPathForRead(...segments) {
+    return resolveRccPath(...segments);
+}
+export function resolveRccSubdir(key, homeDir) {
+    return path.join(resolveRccUserDir(homeDir), RCC_SUBDIRS[key]);
+}
+export function resolveRccSubdirForRead(key, homeDir) {
+    return resolveRccSubdir(key, homeDir);
+}
+export function resolveRccAuthDir(homeDir) {
+    return resolveRccSubdir('auth', homeDir);
+}
+export function resolveRccAuthDirForRead(homeDir) {
+    return resolveRccSubdirForRead('auth', homeDir);
+}
+export function resolveRccTokensDir(homeDir) {
+    return resolveRccSubdir('tokens', homeDir);
+}
+export function resolveRccTokensDirForRead(homeDir) {
+    return resolveRccSubdirForRead('tokens', homeDir);
+}
+export function resolveRccQuotaDir(homeDir) {
+    return resolveRccSubdir('quota', homeDir);
+}
+export function resolveRccQuotaDirForRead(homeDir) {
+    return resolveRccSubdirForRead('quota', homeDir);
+}
+export function resolveRccStateDir(homeDir) {
+    return resolveRccSubdir('state', homeDir);
+}
+export function resolveRccStateDirForRead(homeDir) {
+    return resolveRccSubdirForRead('state', homeDir);
+}
+export function resolveRccLogsDir(homeDir) {
+    return resolveRccSubdir('logs', homeDir);
+}
+export function resolveRccLogsDirForRead(homeDir) {
+    return resolveRccSubdirForRead('logs', homeDir);
+}
+export function resolveRccSessionsDir(homeDir) {
+    return resolveRccSubdir('sessions', homeDir);
+}
+export function resolveRccSessionsDirForRead(homeDir) {
+    return resolveRccSubdirForRead('sessions', homeDir);
+}
+export function resolveRccSnapshotsDir(homeDir) {
+    return resolveRccSubdir('snapshots', homeDir);
+}
+export function resolveRccSnapshotsDirForRead(homeDir) {
+    return resolveRccSubdirForRead('snapshots', homeDir);
+}
+export function resolveRccProviderDir(homeDir) {
+    return resolveRccSubdir('provider', homeDir);
+}
+export function resolveRccProviderDirForRead(homeDir) {
+    return resolveRccSubdirForRead('provider', homeDir);
+}
+export function resolveRccConfigDir(homeDir) {
+    return resolveRccSubdir('config', homeDir);
+}
+export function resolveRccConfigDirForRead(homeDir) {
+    return resolveRccSubdirForRead('config', homeDir);
+}
+export function resolveRccGuardianDir(homeDir) {
+    return resolveRccSubdir('guardian', homeDir);
+}
+export function resolveRccLoginDir(homeDir) {
+    return resolveRccSubdir('login', homeDir);
+}
+export function resolveRccStaticsDir(homeDir) {
+    return resolveRccSubdir('statics', homeDir);
+}
+export function resolveRccErrorsamplesDir(homeDir) {
+    return resolveRccSubdir('errorsamples', homeDir);
+}
+export function resolveRccLlmsShadowDir(homeDir) {
+    return resolveRccSubdir('llmsShadow', homeDir);
+}
+export function resolveRccCamoufoxFingerprintDir(homeDir) {
+    return resolveRccSubdir('camoufoxFingerprint', homeDir);
+}
+export function resolveRccCamoufoxProfilesDir(homeDir) {
+    return resolveRccSubdir('camoufoxProfiles', homeDir);
+}
+export function resolveRccDocsDir(homeDir) {
+    return resolveRccSubdir('docs', homeDir);
+}
+export function resolveRccPrecommandDir(homeDir) {
+    return resolveRccSubdir('precommand', homeDir);
+}
+export function resolveRccConfigFile(homeDir) {
+    return path.join(resolveRccUserDir(homeDir), 'config.json');
+}
+export function resolveRccConfigFileForRead(homeDir) {
+    return resolveRccConfigFile(homeDir);
+}
+export function ensureRccUserDirEnvironment(homeDir) {
+    const userDir = resolveRccUserDir(homeDir);
+    if (!String(process.env.RCC_HOME || '').trim()) {
+        process.env.RCC_HOME = userDir;
+    }
+    if (!String(process.env.ROUTECODEX_USER_DIR || '').trim()) {
+        process.env.ROUTECODEX_USER_DIR = userDir;
+    }
+    if (!String(process.env.ROUTECODEX_HOME || '').trim()) {
+        process.env.ROUTECODEX_HOME = userDir;
+    }
+    return userDir;
+}
+//# sourceMappingURL=user-data-paths.js.map

package/dist/config/user-data-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-data-paths.js","sourceRoot":"","sources":["../../src/config/user-data-paths.ts"],"names":[],"mappings":"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"}

package/dist/config/virtual-router-builder.d.ts

@@ -1,7 +1,7 @@
 import type { UnknownRecord, VirtualRouterInput } from './virtual-router-types.js';
 /**
  * Build a VirtualRouterInput in "v2" mode by combining:
- * - Provider v2 configs loaded from ~/.routecodex/provider (or a custom root)
+ * - Provider v2 configs loaded from ~/.rcc/provider (or a custom root)
  * - Routing configuration from the user config (virtualrouter.routing 或旧式 routing 字段)
  *
  * 当前函数仅用于迁移与测试，尚未接入 HTTP server 运行路径。

package/dist/config/virtual-router-builder.js

@@ -26,7 +26,7 @@ function extractRoutingFromUserConfig(userConfig) {
 }
 /**
  * Build a VirtualRouterInput in "v2" mode by combining:
- * - Provider v2 configs loaded from ~/.routecodex/provider (or a custom root)
+ * - Provider v2 configs loaded from ~/.rcc/provider (or a custom root)
  * - Routing configuration from the user config (virtualrouter.routing 或旧式 routing 字段)
  *
  * 当前函数仅用于迁移与测试，尚未接入 HTTP server 运行路径。

package/dist/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/dist/index.js

@@ -21,6 +21,7 @@ import { listManagedServerPidsByPort } from './utils/managed-server-pids.js';
 import { inferUngracefulPreviousExit, resolveRuntimeLifecyclePath, safeMarkRuntimeExit, safeReadRuntimeLifecycle, safeWriteRuntimeLifecycle } from './utils/runtime-exit-forensics.js';
 import { resolveRouteCodexConfigPath } from './config/config-paths.js';
 import { loadRouteCodexConfig } from './config/routecodex-config-loader.js';
+import { ensureRccUserDirEnvironment, resolveRccPath, resolveRccPathForRead } from './config/user-data-paths.js';
 let runtimeMinimalLogFilterInstalled = false;
 function resolveBoolFromEnv(value, fallback) {
     if (!value) {
@@ -77,6 +78,7 @@ function ensureProcessCwdAccessible() {
     }
 }
 ensureProcessCwdAccessible();
+ensureRccUserDirEnvironment();
 function resolveExpectedParentPid() {
     const raw = String(process.env.ROUTECODEX_EXPECT_PARENT_PID ?? process.env.RCC_EXPECT_PARENT_PID ?? '').trim();
     if (!raw) {
@@ -567,7 +569,7 @@ function getDefaultModulesConfigPath() {
         scriptDir ? path.join(scriptDir, '..', 'config', 'modules.json') : null,
         path.join(execDir, 'config', 'modules.json'),
         path.join(safeProcessCwd(execDir), 'config', 'modules.json'),
-        path.join(homedir(), '.routecodex', 'config', 'modules.json')
+        resolveRccPathForRead('config', 'modules.json')
     ];
     for (const configPath of possiblePaths) {
         if (configPath && fsSync.existsSync(configPath)) {
@@ -639,7 +641,7 @@ class RouteCodexApp {
             // This is required to avoid cold-start tool-call failures after server restarts.
             try {
                 const { warmupAntigravitySessionSignatureModule, configureAntigravitySessionSignaturePersistence } = await import('./modules/llmswitch/bridge.js');
-                const stateDir = path.join(homedir(), '.routecodex', 'state');
+                const stateDir = resolveRccPath('state');
                 try {
                     fsSync.mkdirSync(stateDir, { recursive: true });
                 }
@@ -782,7 +784,7 @@ class RouteCodexApp {
             // 异步写入 PID 文件，不阻塞启动流程
             void (async () => {
                 try {
-                    const routeCodexHome = path.join(homedir(), '.routecodex');
+                    const routeCodexHome = resolveRccPath();
                     await fs.mkdir(routeCodexHome, { recursive: true });
                     await fs.writeFile(path.join(routeCodexHome, `server-${bindPort}.pid`), String(process.pid), 'utf8');
                 }
@@ -1011,7 +1013,7 @@ class RouteCodexApp {
                     }
                 }
             }
-            // 使用共享解析逻辑解析用户配置路径（支持 ~/.routecodex/config 目录）
+            // 使用共享解析逻辑解析用户配置路径（支持 ~/.rcc/config 目录）
             try {
                 const sharedPath = resolveRouteCodexConfigPath();
                 if (sharedPath && fsSync.existsSync(sharedPath)) {
@@ -1030,7 +1032,7 @@ class RouteCodexApp {
                 // ignore and fall back
             }
             // 最后检查默认配置文件
-            const defaultConfigPath = path.join(homedir(), '.routecodex', 'config.json');
+            const defaultConfigPath = resolveRccPathForRead('config.json');
             if (fsSync.existsSync(defaultConfigPath)) {
                 const defaultStats = fsSync.statSync(defaultConfigPath);
                 if (!defaultStats.isFile()) {