cc-viewer 1.6.325 → 1.6.326

package/dist/index.html

@@ -21,7 +21,7 @@
     // 整体显示大小已弃用 CSS zoom：Electron 改用 webFrame.setZoomFactor（首屏抢占见
     // electron/tab-content-preload.js），纯浏览器交由用户用浏览器自带快捷键缩放，故此处不再设 zoom。
   </script>
-  <script type="module" crossorigin src="/assets/index-rSvTNrmP.js"></script>
+  <script type="module" crossorigin src="/assets/index-CqCAViSO.js"></script>
   <link rel="modulepreload" crossorigin href="/assets/vendor-antd-x2KtHa4R.js">
   <link rel="modulepreload" crossorigin href="/assets/vendor-codemirror-z6VSi4ab.js">
   <link rel="modulepreload" crossorigin href="/assets/vendor-mdxeditor-Zi3mchEB.js">

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-viewer",
-  "version": "1.6.325",
+  "version": "1.6.326",
   "description": "Claude Code Logger visualization management tool",
   "license": "MIT",
   "main": "server.js",

package/server/lib/adapters/feishu-adapter.js

@@ -23,6 +23,22 @@ function tokenHost(region) {
   return region === 'lark' ? 'https://open.larksuite.com' : 'https://open.feishu.cn';
 }
 
+// AI 卡片(CardKit v1)里那个被逐字流式覆写的 markdown 组件 id（建卡与流式更新都引用它）。
+const AI_CARD_ELEMENT_ID = 'md';
+
+/** 构造一个 Card JSON 2.0 流式卡片：单 markdown 组件 + streaming_mode。建卡时 streaming=true。 */
+function buildStreamCardJson(content, { streaming, headerTemplate = 'blue' } = {}) {
+  return {
+    schema: '2.0',
+    config: { streaming_mode: !!streaming },
+    header: { title: { tag: 'plain_text', content: 'Claude' }, template: headerTemplate },
+    body: { elements: [{ tag: 'markdown', element_id: AI_CARD_ELEMENT_ID, content: content || '' }] },
+  };
+}
+
+/** Feishu 返回 HTTP 200 但 body.code 非 0 表示失败；统一判定。 */
+function isErr(r) { return r && typeof r.code === 'number' && r.code !== 0; }
+
 async function loadSdk() {
   if (sdkFactory) return sdkFactory();
   return import('@larksuiteoapi/node-sdk');
@@ -130,9 +146,39 @@ const feishuAdapter = {
     }
   },
 
+  // ─── 逐字流式（AI 卡片）─── 用 CardKit v1：建卡片实例(streaming_mode) → 引用 card_id 发消息 →
+  // cardElement.content 逐帧覆写正文(飞书自动 diff 出打字机效果) → settings 关流收尾。无模板 id 概念，
+  // 开关就是 cfg.aiCard；建卡失败(如缺 cardkit:card:write scope)安全回退到 1.0 占位卡片。
+  streamEnabled(cfg) { return !!cfg?.aiCard; },
+
   async sendAckCard(cfg, target, statusText, ctx) {
     const client = ctx.store.sendClient;
     if (!client) throw new Error('feishu send client not initialized');
+    // 流式路径：CardKit 建卡 + 引用发送。任何环节失败 → 落诊断并回退到下面的 1.0 占位卡片。
+    if (cfg?.aiCard && client.cardkit?.v1?.card?.create) {
+      try {
+        const created = await client.cardkit.v1.card.create({
+          data: { type: 'card_json', data: JSON.stringify(buildStreamCardJson(statusText, { streaming: true })) },
+        });
+        if (isErr(created)) throw new Error(`card.create ${created.code}: ${created.msg || ''}`);
+        const cardId = created?.data?.card_id;
+        if (!cardId) throw new Error('card.create returned no card_id');
+        const r = await client.im.v1.message.create({
+          params: { receive_id_type: target.receiveIdType },
+          data: {
+            receive_id: target.receiveId,
+            msg_type: 'interactive',
+            content: JSON.stringify({ type: 'card', data: { card_id: cardId } }),
+          },
+        });
+        if (isErr(r)) throw new Error(`send ${r.code}: ${r.msg || ''}`);
+        return { messageId: r?.data?.message_id, cardId, elementId: AI_CARD_ELEMENT_ID, streaming: true, seq: 0 };
+      } catch (e) {
+        if (ctx.store) ctx.store.lastAiCardError = String(e?.message || e);
+        // fall through → 1.0 占位卡片（非流式），保证 ack 不丢
+      }
+    }
+    // ── 1.0 占位卡片（非流式；aiCard 关闭或 CardKit 不可用时走这条，行为同旧版） ──
     const card = {
       config: { wide_screen_mode: true },
       header: { title: { tag: 'plain_text', content: 'Claude' }, template: 'blue' },
@@ -142,16 +188,54 @@ const feishuAdapter = {
       params: { receive_id_type: target.receiveIdType },
       data: { receive_id: target.receiveId, msg_type: 'interactive', content: JSON.stringify(card) },
     });
-    if (r && typeof r.code === 'number' && r.code !== 0) {
-      throw new Error(`sendAckCard ${r.code}: ${r.msg || 'failed'}`);
-    }
+    if (isErr(r)) throw new Error(`sendAckCard ${r.code}: ${r.msg || 'failed'}`);
     return { messageId: r?.data?.message_id };
   },
 
+  async streamCardText(cfg, target, handle, fullText, ctx) {
+    const client = ctx.store.sendClient;
+    if (!client || !handle?.cardId || !client.cardkit?.v1?.cardElement?.content) return false;
+    try {
+      const seq = ++handle.seq; // 单 in-flight + 单调自增,保证 sequence 严格递增、不乱序
+      const r = await client.cardkit.v1.cardElement.content({
+        path: { card_id: handle.cardId, element_id: handle.elementId || AI_CARD_ELEMENT_ID },
+        data: { content: fullText, sequence: seq, uuid: `c_${handle.cardId}_${seq}` },
+      });
+      return !isErr(r);
+    } catch { return false; }
+  },
+
   async updateAckCard(cfg, target, handle, content, status, ctx) {
     try {
       const client = ctx.store.sendClient;
       if (!client) return false;
+      // 流式句柄：先以权威全文覆写正文(打字机收口) → settings 关 streaming_mode + 更新预览摘要
+      //（缺摘要会让消息列表预览卡在「生成中」）。状态由文本本身承载,CardKit 无 header 状态标签。
+      if (handle?.streaming && handle.cardId && client.cardkit?.v1?.cardElement?.content) {
+        const seqC = ++handle.seq;
+        const rc = await client.cardkit.v1.cardElement.content({
+          path: { card_id: handle.cardId, element_id: handle.elementId || AI_CARD_ELEMENT_ID },
+          data: { content, sequence: seqC, uuid: `c_${handle.cardId}_${seqC}` },
+        });
+        if (isErr(rc)) return false;
+        if (client.cardkit?.v1?.card?.settings) {
+          const seqS = ++handle.seq;
+          const preview = String(content).replace(/\s+/g, ' ').trim().slice(0, 40);
+          await client.cardkit.v1.card.settings({
+            path: { card_id: handle.cardId },
+            data: {
+              settings: JSON.stringify({ config: { streaming_mode: false, summary: { content: preview } } }),
+              sequence: seqS,
+              uuid: `s_${handle.cardId}_${seqS}`,
+            },
+          }).catch((e) => {
+            // 关流失败:内容已落定,飞书 10min 后会自动关流;仅记诊断(消息列表预览可能短暂卡在「生成中」)。
+            if (ctx.store) ctx.store.lastAiCardError = 'settings close: ' + String(e?.message || e);
+          });
+        }
+        return true;
+      }
+      // 非流式句柄（1.0 占位卡片）：保持原整卡 patch + header 状态色。
       const templateMap = { done: 'green', interrupted: 'orange', error: 'red' };
       const card = {
         config: { wide_screen_mode: true },
@@ -162,7 +246,7 @@ const feishuAdapter = {
         path: { message_id: handle.messageId },
         data: { content: JSON.stringify(card) },
       });
-      if (r && typeof r.code === 'number' && r.code !== 0) return false;
+      if (isErr(r)) return false;
       return true;
     } catch { return false; }
   },

package/server/lib/adapters/wecom-adapter.js

@@ -11,6 +11,7 @@
 //
 // Console prerequisite (no code equivalent — surfaced in the UI help/README): create a 智能机器人,
 // set its API 接收模式 to 长连接, copy the botId + secret, and add the bot to a chat.
+import { randomUUID } from 'node:crypto';
 import { registerAdapter } from '../im-bridge-core.js';
 
 // ─── test seam: a fake SDK factory (zero real SDK / socket) ───
@@ -46,7 +47,10 @@ function normalizeInbound(frame) {
     isGroup,
     senderId,
     msgId: b.msgid,
-    target: { conversationId: receiveId, receiveId },
+    // 逐字流式（aiCard）靠被动回复 replyStream，须透传入站帧的 req_id。core 入队是浅展开
+    // `{ ...target, ... }`，故把整帧挂进 target 内层才能随队列项流转到 sendAckCard/streamCardText/
+    // updateAckCard。非流式路径不读它，无副作用。
+    target: { conversationId: receiveId, receiveId, _frame: frame },
   };
 }
 
@@ -114,6 +118,57 @@ const wecomAdapter = {
     }
   },
 
+  // ─── 逐字流式（AI 卡片）─── 用智能机器人长连接的 stream 被动回复(replyStream)：首帧即 ack(确立
+  // streamId、落 5s 首回复窗口)，streamTick 逐帧推累计全文，finalize 以 finish=true 收尾(落 10min
+  // 流式窗口内)。无模板 id 概念，开关就是 cfg.aiCard。
+  streamEnabled(cfg) { return !!cfg?.aiCard; },
+
+  async sendAckCard(cfg, target, statusText, ctx) {
+    if (!cfg?.aiCard) return null;             // 未开 aiCard → 返回 null,core 回退 proactive 文本 ack(旧行为)
+    const client = ctx.store.client;
+    const frame = target?._frame;
+    if (!client || !frame) {                   // 无连接/无帧(无法被动回复) → 回退
+      if (ctx.store && !frame) ctx.store.lastAiCardError = 'no inbound frame';
+      return null;
+    }
+    try {
+      const streamId = randomUUID();
+      // 首帧 finish=false：开流 + 即时 ack 文本。
+      await client.replyStream(frame, streamId, statusText, false);
+      return { streamId, frame, streaming: true };
+    } catch (e) {
+      if (ctx.store) ctx.store.lastAiCardError = String(e?.message || e);
+      return null;                             // 开流失败 → 回退 proactive 文本 ack
+    }
+  },
+
+  async streamCardText(cfg, target, handle, fullText, ctx) {
+    const client = ctx.store.client;
+    const frame = handle?.frame || target?._frame;
+    if (!client || !frame || !handle?.streamId) return false;
+    try {
+      // 优先非阻塞：上一帧未 ack 则跳过本帧(返回 'skipped')，避免中间帧排队积压;最终全文由 finalize 兜底。
+      if (typeof client.replyStreamNonBlocking === 'function') {
+        const r = await client.replyStreamNonBlocking(frame, handle.streamId, fullText, false);
+        return r !== 'skipped';
+      }
+      await client.replyStream(frame, handle.streamId, fullText, false);
+      return true;
+    } catch { return false; }
+  },
+
+  async updateAckCard(cfg, target, handle, fullText, status, ctx) {
+    // 流式收尾：finish=true 的最终帧 SDK 保证发送(不受非阻塞跳帧限制)。WeCom stream 无状态标签，
+    // 中断/失败语义由 core 传入的 fullText 文本自身承载，status 此处不额外渲染。
+    try {
+      const client = ctx.store.client;
+      const frame = handle?.frame || target?._frame;
+      if (!client || !frame || !handle?.streamId) return false;
+      await client.replyStream(frame, handle.streamId, fullText, true);
+      return true;
+    } catch { return false; }
+  },
+
   async testConnection(cfg) {
     // No REST validate endpoint exists for the smart-robot mode — auth is in the WS handshake. Open
     // a throwaway probe and wait for 'authenticated'. NOTE: WeCom allows one connection per bot, so

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

@@ -95,6 +95,17 @@ function newInstance(adapter) {
  * @property {(ackCtx:*, client:*)=>void} [ack]  Ack an inbound msg (platforms that redeliver if not acked).
  * @property {(cfg:Object, target:Object, content:string, ctx:{fetch,store})=>Promise<void>} sendOne  Send one chunk.
  * @property {(cfg:Object, ctx:{fetch,store})=>Promise<{ok:boolean, detail?:string}>} testConnection  Validate creds, no socket.
+ *
+ * ── Optional AI-card streaming (only platforms that support an updatable card implement these) ──
+ * @property {(cfg:Object)=>boolean} [streamEnabled]  Whether per-character streaming is on for this cfg.
+ *           When absent the core falls back to `!!cfg.aiCardTemplateId` (DingTalk's template-id switch).
+ * @property {(cfg:Object, target:Object, statusText:string, ctx:Object)=>Promise<?Object>} [sendAckCard]
+ *           Send the instant ack as an (ideally streamable) card; return a handle ({streaming:true,…})
+ *           to enable streaming, a non-streaming handle, or null to fall back to a plain-text ack.
+ * @property {(cfg:Object, target:Object, handle:Object, fullText:string, ctx:Object)=>Promise<boolean>} [streamCardText]
+ *           Push the cumulative reply text into the card (best-effort; drives the typewriter effect).
+ * @property {(cfg:Object, target:Object, handle:Object, fullText:string, status:string, ctx:Object)=>Promise<boolean>} [updateAckCard]
+ *           Finalize the card with the authoritative reply text + terminal status (done/interrupted/error).
  */
 
 /** Register a platform adapter (called at adapter-module import). Idempotent per id. */
@@ -275,10 +286,17 @@ function armActiveInjection(inst, target, since) {
   // 逐字流式（钉钉 AI 卡片）：仅当配了 aiCardTemplateId、开了 ack 卡片、且平台具备流式能力（worker
   // 注入了 getLiveText + 适配器实现 streamCardText）时启动常驻推送定时器。注入轮次开始即重置文本源。
   const cfg = inst.bridgeDeps?.getConfig?.();
-  if (cfg && cfg.aiCardTemplateId) {
+  // 流式总开关：钉钉用专属 aiCardTemplateId（非空即开）；其它平台(飞书/微信)无模板 id，改由适配器
+  // 自报 streamEnabled(cfg)（通常 !!cfg.aiCard）。适配器未定义 → 回落旧逻辑，钉钉零回归。
+  const streamEnabled = !!cfg && (typeof inst.adapter.streamEnabled === 'function'
+    ? !!inst.adapter.streamEnabled(cfg)
+    : !!cfg.aiCardTemplateId);
+  if (streamEnabled) {
     const canStream = cfg.ackCard !== false
       && typeof inst.bridgeDeps.getLiveText === 'function'
-      && typeof inst.adapter.streamCardText === 'function';
+      && typeof inst.adapter.streamCardText === 'function'
+      // 同时要求 updateAckCard：能逐字推却无法 finalize 会让卡片永远停在流式中途、停在「生成中」。
+      && typeof inst.adapter.updateAckCard === 'function';
     if (canStream) {
       inst.bridgeDeps.resetLiveText?.();
       if (inst.store) inst.store.lastAiCardError = null; // 清上一轮的诊断残留
@@ -295,7 +313,8 @@ function armActiveInjection(inst, target, since) {
       audit(inst, 'stream-skip', {
         reason: cfg.ackCard === false ? 'ackCardOff'
           : typeof inst.bridgeDeps?.getLiveText !== 'function' ? 'noGetLiveText(非 worker?)'
-            : 'noStreamCardText',
+            : typeof inst.adapter.streamCardText !== 'function' ? 'noStreamCardText'
+              : 'noUpdateAckCard',
       });
     }
   }

package/server/lib/im-config.js

@@ -57,7 +57,7 @@ const DESCRIPTORS = {
     allowListField: 'allowUserIds',
     defaults: {
       enabled: false, appId: '', appSecret: '', region: 'feishu', allowUserIds: [],
-      maxChunkChars: 3800, blockOnSkipPermissions: false, ackCard: true,
+      maxChunkChars: 3800, blockOnSkipPermissions: false, ackCard: true, aiCard: false,
     },
     fields: [
       { key: 'enabled', type: 'bool' },
@@ -68,6 +68,9 @@ const DESCRIPTORS = {
       { key: 'maxChunkChars', type: 'chunk' },
       { key: 'blockOnSkipPermissions', type: 'bool' },
       { key: 'ackCard', type: 'bool', default: true },
+      // 开启即用 CardKit v1 流式卡片逐字回复（需应用具备 cardkit:card:write scope）；关闭/缺 scope
+      // 回退到「占位卡片 + 整段替换」。
+      { key: 'aiCard', type: 'bool', default: false },
     ],
   },
   wecom: {
@@ -75,7 +78,7 @@ const DESCRIPTORS = {
     allowListField: 'allowUserIds',
     defaults: {
       enabled: false, botId: '', secret: '', allowUserIds: [],
-      maxChunkChars: 3800, blockOnSkipPermissions: false, ackCard: true,
+      maxChunkChars: 3800, blockOnSkipPermissions: false, ackCard: true, aiCard: false,
     },
     fields: [
       { key: 'enabled', type: 'bool' },
@@ -85,6 +88,8 @@ const DESCRIPTORS = {
       { key: 'maxChunkChars', type: 'chunk' },
       { key: 'blockOnSkipPermissions', type: 'bool' },
       { key: 'ackCard', type: 'bool', default: true },
+      // 开启即用智能机器人长连接 stream 消息逐字回复；关闭回退到「整段 proactive 文本」。
+      { key: 'aiCard', type: 'bool', default: false },
     ],
   },
   discord: {