cc-viewer 1.6.293 → 1.6.294

package/server/lib/im-bridge-core.js

@@ -23,6 +23,7 @@ import { existsSync, readFileSync, appendFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { LOG_DIR } from '../../findcc.js';
 import { t } from '../i18n.js';
+import { upsertSender } from './im-senders.js';
 
 // ─── tunables (shared across platforms; per-platform rate caps come from adapter.rateLimit) ───
 const SEEN_MAX = 500;
@@ -93,6 +94,51 @@ function ctxFor(inst) {
   return { fetch: coreFetch, store: inst.store };
 }
 
+// 发送者身份解析的缓存有效期：同一 senderId 在此窗口内只解析一次（避免每条消息打 contact API）。
+const SENDER_RESOLVE_TTL_MS = 7 * 24 * 60 * 60 * 1000;
+// 负缓存有效期：解析「没拿到任何身份」（外部用户 / 无 scope / API 失败）也要短期记一笔，否则像飞书这种
+// 无免费字段、靠 contact API 的平台会对每条消息重复打 API（触发租户限流）。10min 后再重试，兼顾「拿到瞬时失败可恢复」。
+const SENDER_NEG_TTL_MS = 10 * 60 * 1000;
+
+/**
+ * 后台解析发送者 {name, avatar} 并持久化到 IM_<id>/im-senders.json（供 /senders 路由 + 对话记录展示）。
+ * 优先用 normalizeInbound 免费带出的 senderName/senderAvatar；缺失再调可选的 adapter.resolveSender
+ * （需打 contact API 的平台）。整段静默：任何失败都不得影响消息注入。**调用方必须 void（不 await）。**
+ */
+async function resolveAndPersistSender(inst, senderId, normalized) {
+  if (!senderId) return;
+  const store = inst.store || (inst.store = {});
+  const cache = store.senderCache || (store.senderCache = {});
+  const now = Date.now();
+  // 缓存项形如 { ts, ok }：解析成功用 7d TTL，负缓存（没拿到）用 10min TTL。
+  const c = cache[senderId];
+  if (c && (now - c.ts) < (c.ok ? SENDER_RESOLVE_TTL_MS : SENDER_NEG_TTL_MS)) return;
+  try {
+    let name = normalized.senderName != null ? String(normalized.senderName) : null;
+    let avatar = normalized.senderAvatar != null ? String(normalized.senderAvatar) : null;
+    // 免费字段不全且适配器支持 → 调一次 contact API 补齐（仅 feishu；dingtalk/wecom 无 resolveSender）。
+    let attemptedResolve = false;
+    if ((!name || !avatar) && typeof inst.adapter.resolveSender === 'function') {
+      attemptedResolve = true;
+      const r = await inst.adapter.resolveSender(inst.bridgeDeps.getConfig(), senderId, ctxFor(inst));
+      if (r) {
+        if (!name && r.name != null) name = String(r.name);
+        if (!avatar && r.avatar != null) avatar = String(r.avatar);
+      }
+    }
+    if (name || avatar) {
+      upsertSender(inst.adapter.id, senderId, { name, avatar });
+      cache[senderId] = { ts: now, ok: true };
+    } else if (attemptedResolve) {
+      // 调过 contact API 但什么都没拿到 → 负缓存，避免对该发送者每条消息反复打 API。
+      cache[senderId] = { ts: now, ok: false };
+    }
+  } catch (e) {
+    cache[senderId] = { ts: now, ok: false }; // 失败也负缓存（短 TTL，10min 后自动重试）
+    audit(inst, 'resolve-sender-error', { senderId, error: String(e?.message || e) });
+  }
+}
+
 function queueCap(inst) {
   return inst.maxQueueOverride ?? MAX_QUEUE;
 }
@@ -129,12 +175,15 @@ function bracketPasteSubmit(text) {
   return ['\x1b[200~' + text + '\x1b[201~', '\r'];
 }
 
-/** Prepend the IM-origin marker `⟦im:<id>⟧`, EXCEPT for slash commands (a marker prefix would
- *  stop the CLI from recognizing `/clear` etc.). trim() guards leading whitespace / full-width
- *  spaces. KEEP IN SYNC with IM_ORIGIN_RE in src/utils/imOrigin.js. */
-function markOrigin(id, content) {
+/** Prepend the IM-origin marker `⟦im:<id>⟧` or `⟦im:<id>:<senderId>⟧`, EXCEPT for slash commands
+ *  (a marker prefix would stop the CLI from recognizing `/clear` etc.). trim() guards leading
+ *  whitespace / full-width spaces. senderId is embedded only when it's "safe" (no space / `:` / `⟧`)
+ *  so the marker stays unambiguous; otherwise it degrades to the platform-only form.
+ *  KEEP IN SYNC with IM_ORIGIN_RE in src/utils/imOrigin.js. */
+function markOrigin(id, senderId, content) {
   if (content.trim().startsWith('/')) return content;
-  return `⟦im:${id}⟧` + content;
+  const safe = (typeof senderId === 'string' && /^[^\s:⟧]+$/.test(senderId)) ? `:${senderId}` : '';
+  return `⟦im:${id}${safe}⟧` + content;
 }
 
 /**
@@ -312,6 +361,9 @@ function handleInboundInner(inst, normalized) {
   }
 
   audit(inst, 'in', { msgId, senderId, conversationId, len: text.length });
+  // 后台解析并持久化发送者身份（姓名/头像）供「对话记录」展示。fire-and-forget：
+  // 绝不 await（解析可能要打 contact API），不阻塞/不影响下面的消息注入。
+  void resolveAndPersistSender(inst, senderId, normalized);
   if (!text) return; // non-text messages (image/voice/file) are ignored in v1
 
   if (isStopCommand(text)) {
@@ -331,7 +383,7 @@ function handleInboundInner(inst, normalized) {
     void sendReply(inst, target, tr(inst, 'queueFull'));
     return;
   }
-  inst.queue.push({ ...target, content: text });
+  inst.queue.push({ ...target, senderId, content: text });
   if (activeInjection || inst.bridgeDeps.isStreaming()) {
     void sendReply(inst, target, tr(inst, 'busyQueued'));
   }
@@ -374,7 +426,7 @@ function drainQueue(inst) {
     // React to a failed injection (PTY gone/died mid-write → onComplete(false)). Without this the
     // prompt never submits, no turn_end ever comes, and the slot wedges until the timeout. Only
     // act if THIS injection still owns the slot (a /stop or timeout may have released it).
-    d.writeToPtySequential(bracketPasteSubmit(markOrigin(inst.adapter.id, item.content)), (ok) => {
+    d.writeToPtySequential(bracketPasteSubmit(markOrigin(inst.adapter.id, item.senderId, item.content)), (ok) => {
       if (ok) return;
       if (!activeInjection || activeInjection.platformId !== inst.adapter.id || activeInjection.since !== since) return;
       audit(inst, 'inject-failed', { conversationId: item.conversationId });

package/server/lib/im-claude-md.js

@@ -3,9 +3,14 @@
 // + 强制 allowlist（见 plan §安全）。但它仍是抑制交互式工具、控制回复风格的主要手段。
 //
 // 用 openSync(path,'wx') 原子创建：从不覆盖用户已编辑的文件（避免 existsSync→write 的 TOCTOU）。
-import { openSync, writeFileSync, closeSync, mkdirSync } from 'node:fs';
+import { openSync, writeFileSync, closeSync, mkdirSync, readFileSync, unlinkSync } from 'node:fs';
 import { join } from 'node:path';
+import { randomBytes } from 'node:crypto';
 import { imDir } from './im-lock.js';
+import { renameSyncWithRetry } from './file-api.js';
+
+// CLAUDE.md 写入上限（字符数，按 String.length / UTF-16 码元计）：远超任何合理人格定义，纯防失控大 body。
+export const MAX_CLAUDE_MD_CHARS = 256 * 1024;
 
 // id → 双语展示名（CLAUDE.md 为内联内容，不走 i18n.js）。
 const PLATFORM_LABELS = {
@@ -80,3 +85,34 @@ export function ensureImClaudeMd(id, dir = imDir(id)) {
   }
   return true;
 }
+
+/**
+ * 读取 IM_<id>/CLAUDE.md 当前内容（供「模型性格定义」编辑器加载）。
+ * 文件不存在 → 返回预置文本（尚未落盘），让编辑器展示默认人格供用户定制；保存时才写盘。
+ */
+export function readImClaudeMd(id) {
+  try {
+    return readFileSync(join(imDir(id), 'CLAUDE.md'), 'utf-8');
+  } catch (e) {
+    if (e && e.code === 'ENOENT') return buildImClaudeMdPreset(id);
+    throw e;
+  }
+}
+
+/**
+ * 覆盖写 IM_<id>/CLAUDE.md（原子：temp + rename，mode 0600）。下次该 IM worker 重启时生效
+ * （CLAUDE.md 仅在 worker 启动时读取一次）。
+ */
+export function writeImClaudeMd(id, content) {
+  const text = String(content ?? '');
+  const dir = imDir(id);
+  mkdirSync(dir, { recursive: true });
+  const tmp = join(dir, `CLAUDE.md.tmp-${process.pid}-${randomBytes(4).toString('hex')}`);
+  try {
+    writeFileSync(tmp, text, { mode: 0o600 });
+    renameSyncWithRetry(tmp, join(dir, 'CLAUDE.md'));
+  } catch (err) {
+    try { unlinkSync(tmp); } catch { /* best-effort */ }
+    throw err;
+  }
+}

package/server/lib/im-senders.js

@@ -0,0 +1,73 @@
+// IM 发送者身份持久化 —— 每个 IM worker 把解析到的「发送者 senderId → {name, avatar}」写到
+// ~/.claude/cc-viewer/IM_<id>/im-senders.json，供主进程的 /api/im/:platform/senders 读取，
+// 让「对话记录」弹窗能按 senderId 显示真实姓名 + 头像。
+//
+// 设计（与 im-lock.js 同风格）：
+// - 原子写：temp + renameSyncWithRetry，读方永不见半写 JSON。
+// - 读容忍：坏 / 缺 / 非对象一律降级为 {}，绝不抛。
+// - 容量上限：按 ts 保留最近 MAX_SENDERS 个，避免无限增长（群聊发送者可能很多）。
+// - 这些是本地数据（不入 preferences、不外发），与现有本地日志同级。
+import { openSync, closeSync, readFileSync, writeFileSync, unlinkSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { randomBytes } from 'node:crypto';
+import { imDir } from './im-lock.js';
+import { renameSyncWithRetry } from './file-api.js';
+
+export const MAX_SENDERS = 500;
+
+function sendersPath(id) { return join(imDir(id), 'im-senders.json'); }
+
+/** 读发送者映射；不存在 / 坏 JSON / 非对象 → {}。 */
+export function readSenders(id) {
+  try {
+    const o = JSON.parse(readFileSync(sendersPath(id), 'utf-8'));
+    return (o && typeof o === 'object' && !Array.isArray(o)) ? o : {};
+  } catch { return {}; }
+}
+
+/** 原子写整张映射（temp + rename）。 */
+function writeSenders(id, map) {
+  const dir = imDir(id);
+  mkdirSync(dir, { recursive: true });
+  const tmp = join(dir, `im-senders.json.tmp-${process.pid}-${randomBytes(4).toString('hex')}`);
+  try {
+    writeFileSync(tmp, JSON.stringify(map), { mode: 0o600 });
+    renameSyncWithRetry(tmp, sendersPath(id));
+  } catch (err) {
+    try { unlinkSync(tmp); } catch { /* best-effort */ }
+    throw err;
+  }
+}
+
+/**
+ * upsert 一个发送者。merge 进现有映射，盖上 ts；超过 MAX_SENDERS 时丢弃最旧的。
+ * name/avatar 任一为空都接受（部分平台只有名字没头像）。整段失败静默（持久化失败非致命）。
+ * @returns {boolean} 是否实际写入
+ */
+export function upsertSender(id, senderId, profile = {}) {
+  if (typeof senderId !== 'string' || !senderId) return false;
+  const name = profile.name != null ? String(profile.name) : null;
+  const avatar = profile.avatar != null ? String(profile.avatar) : null;
+  try {
+    const map = readSenders(id);
+    const prev = map[senderId];
+    // 无新信息（name/avatar 都没变且都已存在）→ 跳过写盘，省 IO。
+    if (prev && prev.name === name && prev.avatar === avatar) return false;
+    map[senderId] = { name, avatar, ts: tsNow() };
+
+    const keys = Object.keys(map);
+    if (keys.length > MAX_SENDERS) {
+      keys
+        .sort((a, b) => (map[a].ts || 0) - (map[b].ts || 0))
+        .slice(0, keys.length - MAX_SENDERS)
+        .forEach((k) => { delete map[k]; });
+    }
+    writeSenders(id, map);
+    return true;
+  } catch {
+    return false; // 持久化失败不影响消息流
+  }
+}
+
+// 单独抽出便于测试注入（避免直接用 Date.now 影响可测性，但保持简单）。
+function tsNow() { return Date.now(); }

package/server/routes/im.js

@@ -15,11 +15,16 @@
 // reports its own in-process adapter (deps.im.getBridgeStatus) — that's what the manager probes.
 import { getDescriptor, loadConfig, loadState, saveConfig } from '../lib/im-config.js';
 import { findRecentLog } from '../lib/interceptor-core.js';
+import { readSenders } from '../lib/im-senders.js';
+import { readImClaudeMd, writeImClaudeMd, MAX_CLAUDE_MD_CHARS } from '../lib/im-claude-md.js';
+import { imDir } from '../lib/im-lock.js';
+import { listSkills, moveSkill } from '../lib/skills-api.js';
+import { importSkillTo } from './skills.js';
 import { LOG_DIR } from '../../findcc.js';
 import { join, basename } from 'node:path';
 
 const JSON_HEADERS = { 'Content-Type': 'application/json' };
-const IM_RE = /^\/api\/im\/([a-z0-9_-]+)\/(status|config|test|process|logs)$/;
+const IM_RE = /^\/api\/im\/([a-z0-9_-]+)\/(status|config|test|process|logs|senders|claude-md|skills|skills\/toggle|skills\/import)$/;
 
 /** Resolve a known platform id from the URL, or null (→ 404) for an unknown one. */
 function platformOf(url) {
@@ -126,10 +131,15 @@ function imConfigPost(req, res, parsedUrl, isLocal, deps) {
       }
     }
     const saved = saveConfig(id, incoming);
+    // applyProcess（默认 true，保持旧调用方语义）：前端 onBlur 自动保存传 false → 仅存盘、不驱动进程，
+    // 否则每次输入框失焦都会重启 worker。显式「启动/停止」按钮则不传（=true），沿用下述驱动逻辑。
+    // 注：applyProcess 是未知字段，saveConfig/normalize 不会把它写盘。
     // 驱动进程管理器（替代旧的在进程 reloadBridge）：启用→重启 worker（吸收新凭证），停用→停 worker。
     try {
-      if (saved.enabled) await deps.im.restartProcess(id);
-      else await deps.im.stopProcess(id);
+      if (incoming.applyProcess !== false) {
+        if (saved.enabled) await deps.im.restartProcess(id);
+        else await deps.im.stopProcess(id);
+      }
     } catch (e) {
       // 进程操作失败不应阻塞配置保存的响应，但必须记录——否则 worker 起不来时用户看到乐观的
       // running:true 却毫无线索（spawn 失败 / EACCES on process.out.log 等）。
@@ -209,10 +219,114 @@ function imLogs(req, res, parsedUrl, isLocal, deps) {
   res.end(JSON.stringify({ project, latest }));
 }
 
+// 发送者身份映射（senderId → {name, avatar, ts}）：供「对话记录」按 senderId 显示真实姓名+头像。
+// loopback-only：姓名/头像属个人信息，不向局域网暴露（与 config/test/process 同级）。
+function imSenders(req, res, parsedUrl, isLocal, deps) {
+  const id = platformOf(parsedUrl.pathname);
+  if (!id) { notFound(res); return; }
+  if (!isLocal) { loopbackOnly(res); return; }
+  res.writeHead(200, JSON_HEADERS);
+  res.end(JSON.stringify({ platform: id, senders: readSenders(id) }));
+}
+
+// 「模型性格定义」= 该 IM worker 工作目录下的 CLAUDE.md。loopback-only：本地文件内容、admin-only。
+// CLAUDE.md 仅在 worker 启动时读取一次，故保存后需重启该 IM worker 才生效（前端据此提示用户）。
+function imClaudeMdGet(req, res, parsedUrl, isLocal, deps) {
+  const id = platformOf(parsedUrl.pathname);
+  if (!id) { notFound(res); return; }
+  if (!isLocal) { loopbackOnly(res); return; }
+  try {
+    res.writeHead(200, JSON_HEADERS);
+    res.end(JSON.stringify({ platform: id, content: readImClaudeMd(id) }));
+  } catch (e) {
+    res.writeHead(500, JSON_HEADERS);
+    res.end(JSON.stringify({ error: String(e?.message || e) }));
+  }
+}
+
+function imClaudeMdPost(req, res, parsedUrl, isLocal, deps) {
+  const id = platformOf(parsedUrl.pathname);
+  if (!id) { notFound(res); return; }
+  if (!isLocal) { loopbackOnly(res); return; }
+  readBody(req, deps, (body) => {
+    let incoming;
+    try { incoming = JSON.parse(body); }
+    catch { res.writeHead(400, JSON_HEADERS); res.end(JSON.stringify({ error: 'Invalid JSON' })); return; }
+    if (typeof incoming.content !== 'string') {
+      res.writeHead(400, JSON_HEADERS); res.end(JSON.stringify({ error: 'content must be a string' })); return;
+    }
+    if (incoming.content.length > MAX_CLAUDE_MD_CHARS) {
+      res.writeHead(413, JSON_HEADERS); res.end(JSON.stringify({ error: 'content too large' })); return;
+    }
+    try {
+      writeImClaudeMd(id, incoming.content);
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify({ ok: true, platform: id }));
+    } catch (e) {
+      res.writeHead(500, JSON_HEADERS);
+      res.end(JSON.stringify({ error: String(e?.message || e) }));
+    }
+  });
+}
+
+// 「${IM} SKILL 管理」= 该 IM worker 工作目录下的 .claude/skills/。loopback-only（本地文件操作、admin-only）。
+// 复用 skills-api 的 listSkills/moveSkill（按 projectDir 参数化）+ skills.js 的 importSkillTo（按 skillsRoot 参数化）。
+// IM worker 仅在启动时读取 skills，故增删/启停后需重启该 IM worker 才生效（前端提示用户）。
+function imSkills(req, res, parsedUrl, isLocal, deps) {
+  const id = platformOf(parsedUrl.pathname);
+  if (!id) { notFound(res); return; }
+  if (!isLocal) { loopbackOnly(res); return; }
+  try {
+    const dir = imDir(id);
+    // projectDir 与 homeDir 都指向 IM 目录：两次扫描命中同一 .claude/skills（user+project 重复），
+    // 过滤 source==='project' 去重并排除 plugin/builtin → 恰好是该 IM 自己的 skills(+skills-skip)。
+    const skills = listSkills({ projectDir: dir, homeDir: dir }).filter((s) => s.source === 'project');
+    res.writeHead(200, JSON_HEADERS);
+    res.end(JSON.stringify({ platform: id, skills }));
+  } catch (e) {
+    res.writeHead(500, JSON_HEADERS);
+    res.end(JSON.stringify({ error: String(e?.message || e) }));
+  }
+}
+
+function imSkillsToggle(req, res, parsedUrl, isLocal, deps) {
+  const id = platformOf(parsedUrl.pathname);
+  if (!id) { notFound(res); return; }
+  if (!isLocal) { loopbackOnly(res); return; }
+  readBody(req, deps, (body) => {
+    let incoming;
+    try { incoming = JSON.parse(body); }
+    catch { res.writeHead(400, JSON_HEADERS); res.end(JSON.stringify({ error: 'Invalid JSON' })); return; }
+    try {
+      moveSkill({ source: 'project', name: incoming.name, enable: !!incoming.enable, projectDir: imDir(id) });
+      res.writeHead(200, JSON_HEADERS);
+      res.end(JSON.stringify({ ok: true }));
+    } catch (err) {
+      const statusMap = { INVALID_NAME: 400, INVALID_SOURCE: 400, PATH_ESCAPE: 400, SYMLINK: 400, SOURCE_MISSING: 404, DEST_CONFLICT: 409 };
+      const status = statusMap[err?.code] || 500;
+      res.writeHead(status, JSON_HEADERS);
+      res.end(JSON.stringify({ error: err?.message || 'internal_error', code: err?.code || 'unknown' }));
+    }
+  });
+}
+
+function imSkillsImport(req, res, parsedUrl, isLocal, deps) {
+  const id = platformOf(parsedUrl.pathname);
+  if (!id) { notFound(res); return; }
+  if (!isLocal) { loopbackOnly(res); return; }
+  importSkillTo(req, res, { skillsRoot: join(imDir(id), '.claude', 'skills'), windowsReserved: deps.WINDOWS_RESERVED_NAMES });
+}
+
 export const imRoutes = [
   { predicate: imPredicate('status', 'GET'), handler: imStatus },
   { predicate: imPredicate('config', 'POST'), handler: imConfigPost },
   { predicate: imPredicate('test', 'POST'), handler: imTestPost },
   { predicate: imPredicate('process', 'POST'), handler: imProcessPost },
   { predicate: imPredicate('logs', 'GET'), handler: imLogs },
+  { predicate: imPredicate('senders', 'GET'), handler: imSenders },
+  { predicate: imPredicate('claude-md', 'GET'), handler: imClaudeMdGet },
+  { predicate: imPredicate('claude-md', 'POST'), handler: imClaudeMdPost },
+  { predicate: imPredicate('skills', 'GET'), handler: imSkills },
+  { predicate: imPredicate('skills/toggle', 'POST'), handler: imSkillsToggle },
+  { predicate: imPredicate('skills/import', 'POST'), handler: imSkillsImport },
 ];