cc-viewer 1.7.21 → 1.7.22

package/server/proxy.js

@@ -8,13 +8,17 @@ import { setupInterceptor } from './interceptor.js';
 import { extractApiErrorMessage, formatProxyRequestError } from './lib/proxy-errors.js';
 import { getProxyDispatcher } from './lib/proxy-env.js';
 import { getClaudeConfigDir } from '../findcc.js';
-import { isAnthropicApiPath } from './lib/interceptor-core.js';
+import { isAnthropicApiPath, classifyProxyRole } from './lib/interceptor-core.js';
 import { executeRequest, extractModel } from './lib/proxy-retry.js';
 import { buildRecord, appendRecord, dailyFilePath, todayStr, emitProxyStatsUpdate } from './lib/proxy-stats.js';
+import { reportSwallowed } from './lib/error-report.js';
 import { LOG_DIR } from '../findcc.js';
 
 // Setup interceptor to patch fetch
 setupInterceptor();
+// 官方端点判定注册：本进程的 _defaultConfig 捕获的是出站 URL（可能被当时的 profile 污染），
+// 休眠判定的"官方端点"应回答「main=Default 时实际会去哪」——即 settings/env 默认链。
+interceptor.setDefaultEndpointResolver(() => getOriginalBaseUrl(null));
 
 // 通知 stats-worker 重扫 proxy 明细（review P2：原实现动态 import('./server.js') 反向触达
 // statsWorker 单例——若未来出现 proxy-only 进程，首条请求会因模块加载副作用意外拉起第二个
@@ -64,12 +68,14 @@ function getBaseUrlFromSettings(settingsPath) {
   return null;
 }
 
-function getOriginalBaseUrl() {
+function getOriginalBaseUrl(profileOverride) {
   // 热切换 profile 最高优先：UI 里用户选中的 baseURL 直接作为上游目标，
   // 让 log/UI 显示的 URL 与实际去向一致，且避免 settings.json 残留的本地
   // 代理 URL（如 127.0.0.1:xxxx）导致 ccv proxy 自环 404。
   // Via namespace import to pick up watchFile 刷新（ES module live binding）。
-  const ap = interceptor._activeProfile;
+  // profileOverride：调用方按角色解析后的有效 profile（undefined = 沿用 main 活跃 profile，
+  // null = 该角色显式无 profile → 落到 settings/env 默认链）。
+  const ap = profileOverride !== undefined ? profileOverride : interceptor._activeProfile;
   if (ap && ap.baseURL) return ap.baseURL;
 
   let cwd;
@@ -100,8 +106,6 @@ function getOriginalBaseUrl() {
 export function startProxy() {
   return new Promise((resolve, reject) => {
     const server = createServer(async (req, res) => {
-      const originalBaseUrl = getOriginalBaseUrl();
-
       // Use the patched fetch (which logs to cc-viewer)
       try {
         // Convert incoming headers
@@ -116,6 +120,32 @@ export function startProxy() {
         }
         const body = Buffer.concat(buffers);
 
+        // 按角色选源：LLM 路径在 body 缓冲后分类（同进程 team 标记 / cc_is_subagent），
+        // 解析该角色的有效 profile（含休眠）。roleProfile 三态：
+        //   undefined = 未分类（非 LLM 路径 / utility / 无显式角色分配）→ 沿用 main 活跃 profile
+        //   null      = 该角色显式无 profile（Default/休眠）→ settings/env 默认链
+        //   object    = 该角色自己的 profile → 其 baseURL 作上游
+        // utility（count_tokens/heartbeat）按 URL 先行排除（跟随 main，且免解析大 body）；
+        // 无显式角色分配时分类结果不影响选路，直接跳过解析（-c checkpoint 可达数十 MB）。
+        // 与 interceptor fetch hook 对 trace 请求的改写输入相同、结论一致（URL 幂等，
+        // auth 由 hook 注入，model 由重试引擎按同一 profile 替换）。已知窗口：配置在选路后、
+        // hook 改写前被热改时两层解析可不一致（单请求自愈，与 main 切换的既有竞态同类；backlog）。
+        // req.url 是 origin-form 相对路径，new URL 需补基址，否则锚定判定落空到宽松正则。
+        const _reqPath = (() => { try { return new URL(req.url || '/', 'http://x').pathname; } catch { return req.url || ''; } })();
+        const _isUtility = /\/messages\/count_tokens$/.test(_reqPath) || /^\/api\/eval\/sdk-/.test(_reqPath);
+        let roleProfile;
+        if (body.length > 0 && isAnthropicApiPath(_reqPath) && !_isUtility && interceptor.hasExplicitRoleAssignments()) {
+          let parsedBody = null;
+          try { parsedBody = JSON.parse(body.toString('utf8')); } catch { /* 非 JSON body → 保持 main 语义 */ }
+          if (parsedBody && typeof parsedBody === 'object') {
+            try {
+              const role = classifyProxyRole(parsedBody, {});
+              roleProfile = interceptor.getEffectiveRoleProfile(role);
+            } catch (err) { reportSwallowed('proxy.role-classify', err); }
+          }
+        }
+        const originalBaseUrl = getOriginalBaseUrl(roleProfile);
+
         const fetchOptions = {
           method: req.method,
           headers: headers,
@@ -136,7 +166,7 @@ export function startProxy() {
         // 模型替换由重试引擎用 resolveProfileModel 纯函数完成（interceptor 对 trace 请求会再跑一次，幂等 no-op）。
         // 非大模型 API 请求走原逻辑（同样用 x-cc-viewer-trace 让 interceptor 记录，但不经重试引擎）。
         if (isAnthropicApiPath(fullUrl)) {
-          await handleLlmApiRequest(req, res, fullUrl, fetchOptions, body, proxyDispatcher);
+          await handleLlmApiRequest(req, res, fullUrl, fetchOptions, body, proxyDispatcher, roleProfile);
           return;
         }
 
@@ -226,10 +256,11 @@ export function startProxy() {
 // 每请求取最新值，UI 改 retry-config.json 后下一个请求即生效，无需重启。
 const _retryConfigGetter = () => interceptor._retryConfigState;
 
-async function handleLlmApiRequest(req, res, fullUrl, fetchOptions, body, proxyDispatcher) {
+async function handleLlmApiRequest(req, res, fullUrl, fetchOptions, body, proxyDispatcher, roleProfile) {
   const statsEnabled = process.env.CCV_PROXY_STATS !== 'off';
   const retryConfig = _retryConfigGetter(); // live binding：每请求取最新重试配置
-  const profile = interceptor._activeProfile || null;
+  // 角色解析后的有效 profile（上游/模型替换/统计归属）。undefined = 未分类 → 沿用 main 活跃 profile。
+  const profile = roleProfile !== undefined ? roleProfile : (interceptor._activeProfile || null);
 
   // 清理可能的 trace 头（singleFetch 会重新加，避免旧值干扰）；interceptor 会正常记录请求
   // 同时清理 hop-by-hop / 传输编码头：body 已被 buffer 成完整 Buffer，

package/server/pty-manager.js

@@ -239,6 +239,12 @@ async function _spawnClaudeImpl(proxyPort, cwd, extraArgs = [], claudePath = nul
   env.CCV_LOG_DIR = LOG_DIR; // 让 fork 出的 Claude Code 进程找到同一份 profile.json 等资源
   // 剥离 cc-viewer 的内部短路开关，避免泄漏给 claude 子进程
   delete env.CCV_SKIP_THINKING_DISPLAY;
+  // 剥离 server 专属的模式标记：spawned claude（尤其 teammate 子进程，它们会装 fetch hook）
+  // 不是 ccv server —— 继承 CCV_WORKSPACE_MODE 会让 interceptor 的 workspace 绑定终生为空
+  // （teammate 角色分配静默失效）；CCV_ELECTRON_MULTITAB 同理只应由 server 进程持有
+  // （im-process-manager 对 IM worker 已有同款剥离先例）。
+  delete env.CCV_WORKSPACE_MODE;
+  delete env.CCV_ELECTRON_MULTITAB;
   // Claude Code NO_FLICKER 会让嵌入式 xterm 走 alt-screen 并丢失 scrollback。
   // cc-viewer 默认剥离继承值；确实需要时可显式设 CCV_KEEP_CLAUDE_CODE_NO_FLICKER=1。
   stripClaudeNoFlickerUnlessOptedIn(env);

package/server/routes/expert.js

@@ -7,11 +7,15 @@
 // 鉴权沿用 dispatch 之前的全局鉴权（与 files-fs 写操作一致，不额外 gate isLocal）。
 import { join } from 'node:path';
 import { readFileSync } from 'node:fs';
-import { readWorkspaceSystemText, writeWorkspaceSystemText } from '../lib/system-prompt-files.js';
+import {
+  readWorkspaceSystemText, writeWorkspaceSystemText,
+  isNonEmptyFile, SYSTEM_PROMPT_FILE, APPEND_SYSTEM_PROMPT_FILE, DISABLE_AUTO_SYSTEM_PROMPT_ENV,
+} from '../lib/system-prompt-files.js';
 import {
   MODEL_PROMPT_DIR, normalizeModelName, listModelPrompts,
-  writeModelPrompt, deleteModelPrompt,
+  writeModelPrompt, deleteModelPrompt, matchModelPrompt,
 } from '../lib/model-system-prompts.js';
+import { resolveSpawnModel } from '../lib/spawn-model-resolver.js';
 import { listSystemPromptPresets, groupPresetsByCategory, getSystemPromptVariablesDoc } from '../lib/system-prompt-presets.js';
 import { LOG_DIR } from '../../findcc.js';
 
@@ -37,6 +41,30 @@ function sendJson(res, code, obj) {
   } catch { /* socket 已关闭：忽略 */ }
 }
 
+// Single source for "is a custom system prompt configured to inject" — mirrors the
+// spawn-time injection semantics of buildSystemPromptFileArgs: the env kill switch wins;
+// a matched model entry supersedes the Default sentinels for activation purposes.
+// Fidelity note: spawn-only gates this helper cannot see (insideLogDir skip, manual
+// --system-prompt-file flags, one-shot skip tokens) may rarely make "active" a false
+// positive — acceptable for a UI hint.
+function computeSystemPromptStatus(dir) {
+  if (process.env[DISABLE_AUTO_SYSTEM_PROMPT_ENV] === '1') {
+    return { active: false, modelId: null, matched: null, defaultActive: false };
+  }
+  const defaultActive = !!dir && (
+    isNonEmptyFile(join(dir, SYSTEM_PROMPT_FILE)) || isNonEmptyFile(join(dir, APPEND_SYSTEM_PROMPT_FILE))
+  );
+  const modelId = resolveSpawnModel(dir, process.env);
+  const match = modelId
+    ? matchModelPrompt(modelId, [
+        { dir: dir ? join(dir, MODEL_PROMPT_DIR) : null, scope: 'workspace' },
+        { dir: join(LOG_DIR, MODEL_PROMPT_DIR), scope: 'global' },
+      ])
+    : null;
+  const matched = match ? { scope: match.scope, name: match.name, mode: match.mode } : null;
+  return { active: !!matched || defaultActive, modelId, matched, defaultActive };
+}
+
 async function getSystemText(req, res, parsedUrl, isLocal, deps) {
   try {
     const dir = await resolveDir(deps);
@@ -95,12 +123,17 @@ async function getModelPrompts(req, res, parsedUrl, isLocal, deps) {
   try {
     const dir = await resolveDir(deps);
     const globalDir = join(LOG_DIR, MODEL_PROMPT_DIR);
+    const status = computeSystemPromptStatus(dir);
     sendJson(res, 200, {
       workspaceDir: dir || null,
       workspaceActive: !!dir,
       globalDir,
       workspace: dir ? collectModelEntries(join(dir, MODEL_PROMPT_DIR)) : [],
       global: collectModelEntries(globalDir),
+      // 当前生效配置解析出的模型 id 及其命中的条目(未命中为 null)——弹窗据此把默认页签
+      // 指向命中条目；matched.name 为规范化大写名，与页签 key 的构成一致。
+      modelId: status.modelId,
+      matched: status.matched,
     });
   } catch (e) {
     console.error('[CC Viewer] expert model-prompts GET failed:', e.message);
@@ -108,6 +141,17 @@ async function getModelPrompts(req, res, parsedUrl, isLocal, deps) {
   }
 }
 
+// 轻量状态查询(不内联提示词文本)：头部工具栏据此决定是否自动露出「系统提示词修改」入口。
+async function getSystemPromptStatus(req, res, parsedUrl, isLocal, deps) {
+  try {
+    const dir = await resolveDir(deps);
+    sendJson(res, 200, computeSystemPromptStatus(dir));
+  } catch (e) {
+    console.error('[CC Viewer] expert system-prompt-status GET failed:', e.message);
+    sendJson(res, 500, { error: 'read_failed' });
+  }
+}
+
 function postModelPrompts(req, res, parsedUrl, isLocal, deps) {
   let body = '';
   let truncated = false;
@@ -174,4 +218,5 @@ export const expertRoutes = [
   { method: 'GET', match: 'exact', path: '/api/expert/model-prompts', handler: getModelPrompts },
   { method: 'POST', match: 'exact', path: '/api/expert/model-prompts', handler: postModelPrompts },
   { method: 'GET', match: 'exact', path: '/api/expert/system-prompt-presets', handler: getSystemPromptPresets },
+  { method: 'GET', match: 'exact', path: '/api/expert/system-prompt-status', handler: getSystemPromptStatus },
 ];

package/server/routes/preferences.js

@@ -3,8 +3,8 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import { LOG_DIR, setLogDir, getClaudeConfigDir, discoverClaudeExecutables, resolveExplicitClaudePath, CLAUDE_EXECUTABLE_PREF_KEY } from '../../findcc.js';
-import { PROFILE_PATH, _defaultConfig, getActiveProfileId, setActiveProfileForWorkspace, _loadProxyProfile, RETRY_CONFIG_PATH, _retryConfigState, _loadRetryConfigState } from '../interceptor.js';
-import { migrateProxyProfileList } from '../lib/interceptor-core.js';
+import { PROFILE_PATH, _defaultConfig, getActiveProfileId, getStoredRoles, isOfficialDefaultEndpoint, setActiveProfileForWorkspace, _loadProxyProfile, RETRY_CONFIG_PATH, _retryConfigState, _loadRetryConfigState } from '../interceptor.js';
+import { migrateProxyProfileList, isValidRoleValue, PROXY_ROLE_KEYS } from '../lib/interceptor-core.js';
 import { DEFAULT_RETRY_CONFIG, validateRetryConfig, resolveRetryConfig } from '../lib/proxy-retry.js';
 import { discoverCcSwitchProviders, mergeImportedProfiles } from '../lib/ccswitch-import.js';
 import { reportSwallowed } from '../lib/error-report.js';
@@ -307,7 +307,9 @@ function proxyProfilesGet(req, res, parsedUrl, isLocal, deps) {
     // 本机(127.0.0.1)= admin：下发明文 profile.apiKey 供本人在编辑表单(👁 折叠)里查阅/复制；已授权
     // 的远程客户端只拿脱敏值(****+后4位)。保存时若回传脱敏值，POST 侧 isMasked() 会保留磁盘原值。
     // 镜像 /api/auth/state 的密码、/api/dingtalk/status 的 appSecret 策略。
-    const full = { ...data, active: effectiveActive };
+    // roles 返回**存储值**（不做休眠调整）：休眠只是请求侧不生效，若返回有效值，UI 缓存后
+    // 在下次无关 POST 回写会把休眠中的分配清掉。officialDefault 驱动 UI 隐藏角色分配区。
+    const full = { ...data, active: effectiveActive, roles: getStoredRoles(), officialDefault: isOfficialDefaultEndpoint() };
     const payload = isLocal ? full : deps.maskProfiles(full);
     // defaultConfig.apiKey 始终脱敏：它在列表里是常显文本(无 👁 折叠)，且 Max/OAuth 默认配置的 key
     // 可能是 OAuth token；只有可编辑 profile 的 key 才按 isLocal 明文下发。
@@ -351,9 +353,24 @@ function proxyProfilesPost(req, res, parsedUrl, isLocal, deps) {
       const dir = dirname(PROFILE_PATH);
       if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
       writeFileSync(PROFILE_PATH, JSON.stringify(toWrite, null, 2), { mode: 0o600 });
-      // active 走 workspace 级别存储（当前进程独占）
-      if (typeof incoming.active === 'string' && incoming.active) {
-        setActiveProfileForWorkspace(incoming.active);
+      // 角色分配校验：只认 subagent/teammate 两个 key（roles.main 之类的杂键直接丢弃）；
+      // 值必须是 follow / max / 入参 profiles 里存在的 id（按将落盘的列表校验，而非旧文件），
+      // 非法值归 'follow'（宽容风格，不 400）。被删 profile 的悬空角色由读取时归 follow 兜底。
+      let sanitizedRoles;
+      if (incoming.roles && typeof incoming.roles === 'object' && !Array.isArray(incoming.roles)) {
+        const byId = new Map(incoming.profiles.map(p => [p.id, p]));
+        sanitizedRoles = {};
+        for (const k of PROXY_ROLE_KEYS) {
+          if (!(k in incoming.roles)) continue; // 未提交的 key 不进 patch → 合并时保留存储值
+          const v = incoming.roles[k];
+          // key 提交了但值非法（非字符串 / 悬空 id）→ 归 'follow'（显式纠正，不是保留）
+          sanitizedRoles[k] = (typeof v === 'string' && v && isValidRoleValue(v, byId)) ? v : 'follow';
+        }
+      }
+      // active/roles 走 workspace 级别存储（当前进程独占）；合并语义：缺省字段保留文件现值
+      const hasActive = typeof incoming.active === 'string' && incoming.active;
+      if (hasActive || sanitizedRoles) {
+        setActiveProfileForWorkspace(hasActive ? incoming.active : undefined, sanitizedRoles);
       } else {
         _loadProxyProfile(); // 仅列表变化时也刷新一次以反映删除 / 重命名
       }
@@ -361,7 +378,7 @@ function proxyProfilesPost(req, res, parsedUrl, isLocal, deps) {
       const effectiveActive = getActiveProfileId();
       const activeProfile = incoming.profiles?.find(p => p.id === effectiveActive) || null;
       const maskedProfile = activeProfile?.apiKey ? { ...activeProfile, apiKey: deps.maskApiKey(activeProfile.apiKey) } : activeProfile;
-      sendEventToClients(deps.clients, 'proxy_profile', { active: effectiveActive, profile: maskedProfile });
+      sendEventToClients(deps.clients, 'proxy_profile', { active: effectiveActive, profile: maskedProfile, roles: getStoredRoles() });
       res.writeHead(200, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify({ ok: true }));
     } catch {

package/src/utils/v3Assembler.js

@@ -95,6 +95,7 @@ export function createV3Assembler() {
       // teammates, persisted server-side (see agent-id.js).
       if (row.agent) entry.agent = row.agent;
       if (row.proxyUrl) entry.proxyUrl = row.proxyUrl;
+      if (row.proxyRole) entry.proxyRole = row.proxyRole;
       if (isSnapshot) entry._isCheckpoint = true;
       if (row.inProgress) {
         entry.inProgress = true;

package/src/utils/v3Rows.js

@@ -17,6 +17,7 @@ export function rowToListItem(row) {
     timestamp: row.timestamp,
     url: row.url,
     proxyUrl: row.proxyUrl,
+    proxyRole: row.proxyRole,
     duration: row.duration,
     inProgress: row.inProgress === true,
     isHeartbeat: row.kind === 'heartbeat',