@dsh-plugin/dsh-synapse 0.1.0-dev.41044228975 → 0.1.0

package/vendor/gugle-chat-bot/src/features/hermes/reaction.ts

@@ -1,181 +1,181 @@
-import fs from 'node:fs';
-import path from 'node:path';
-import { QQBot } from '@/index';
-import { getHermesConfig } from '@/features/hermes/config';
-import { writeConfigFile } from '@/config/manager';
-
-/**
- * AI「处理中」表情回应管理。
- *
- * 用户消息触发 Hermes 运行时，给触发消息贴上表情回应（QQ 走 NapCat
- * set_msg_emoji_like，Discord 走 message.react）；完整回复完成（含查询技能的
- * 回喂轮）后摘除。
- *
- * 记录立即持久化到 data/hermes-reactions.json：若回应期间进程重启/宕机，
- * 下次启动时按残留记录逐条摘除并清空（cleanupQQ 由 after-start 钩子调用，
- * Discord 残留由 DiscordBridge 在 clientReady 后调用 listDiscord/drop 处理），
- * 避免「处理中」表情永久残留。
- */
-
-/** 一条待摘除的表情回应记录 */
-export interface PendingReaction {
-  /** 唯一键：`qq:{messageId}` / `discord:{channelId}:{messageId}` */
-  key: string;
-  platform: 'qq' | 'discord';
-  /** QQ: OneBot message_id 字符串；Discord: 消息 snowflake */
-  messageId: string;
-  /** Discord 频道 snowflake（QQ 记录无此字段） */
-  channelId?: string;
-  /** QQ: emoji_id；Discord: unicode emoji */
-  emoji: string;
-  createdAt: number;
-}
-
-interface ReactionStoreFile {
-  version: number;
-  reactions: PendingReaction[];
-}
-
-export class ReactionManager {
-  private static instance?: ReactionManager;
-
-  public static getInstance(): ReactionManager {
-    if (!ReactionManager.instance) ReactionManager.instance = new ReactionManager();
-    return ReactionManager.instance;
-  }
-
-  private readonly file = path.resolve(process.cwd(), 'data', 'hermes-reactions.json');
-  private readonly records = new Map<string, PendingReaction>();
-  private loaded = false;
-
-  private constructor() {}
-
-  /** 懒加载持久化记录（损坏按空处理） */
-  private load(): void {
-    if (this.loaded) return;
-    this.loaded = true;
-    try {
-      if (!fs.existsSync(this.file)) return;
-      const raw = JSON.parse(fs.readFileSync(this.file, 'utf-8')) as ReactionStoreFile;
-      if (!Array.isArray(raw?.reactions)) return;
-      for (const record of raw.reactions) {
-        if (record && typeof record.key === 'string' && typeof record.messageId === 'string') {
-          this.records.set(record.key, record);
-        }
-      }
-    } catch {
-      // 文件损坏或格式错误，按空记录处理
-    }
-  }
-
-  /** 立即落盘（原子写，复用 config/manager 的 writeConfigFile） */
-  private persist(): void {
-    try {
-      writeConfigFile(this.file, { version: 1, reactions: [...this.records.values()] } satisfies ReactionStoreFile);
-    } catch {
-      // 持久化失败不阻塞主流程
-    }
-  }
-
-  /**
-   * QQ：给消息贴「处理中」表情，成功后立即持久化记录并返回记录键。
-   * 返回 null 表示没贴上（功能关闭或 NapCat 拒绝，例如私聊消息通常不支持表情回应），
-   * 调用方据此决定是否改用文字回执；具体原因写入日志便于排查。
-   */
-  public async addQQ(bot: QQBot, messageId: number): Promise<string | null> {
-    const config = getHermesConfig();
-    if (!config.reactionEnabled) {
-      bot.logger?.debug(`[Hermes] 表情回应已关闭，跳过（message ${messageId}）`);
-      return null;
-    }
-    try {
-      await bot.axiosInstance.post('/set_msg_emoji_like', {
-        message_id: messageId,
-        emoji_id: config.reactionEmojiQq,
-        set: true
-      });
-    } catch (error) {
-      bot.logger?.warn(
-        `[Hermes] 表情回应失败（message ${messageId}）: ${(error as Error).message}` +
-          `；NapCat 对私聊消息通常不支持 set_msg_emoji_like`
-      );
-      return null;
-    }
-    const key = `qq:${messageId}`;
-    this.load();
-    this.records.set(key, {
-      key,
-      platform: 'qq',
-      messageId: String(messageId),
-      emoji: config.reactionEmojiQq,
-      createdAt: Date.now()
-    });
-    this.persist();
-    return key;
-  }
-
-  /**
-   * Discord：message.react 成功后调用，立即持久化记录并返回记录键。
-   */
-  public persistDiscord(channelId: string, messageId: string, emoji: string): string {
-    const key = `discord:${channelId}:${messageId}`;
-    this.load();
-    this.records.set(key, { key, platform: 'discord', messageId, channelId, emoji, createdAt: Date.now() });
-    this.persist();
-    return key;
-  }
-
-  /**
-   * QQ：摘除表情（set=false）。无论摘除成败都移除持久化记录
-   * （失败多为消息已被撤回等不可重试原因，残留记录只会在下次启动时再次失败）。
-   */
-  public async removeQQ(bot: QQBot | undefined, key: string): Promise<void> {
-    this.load();
-    const record = this.records.get(key);
-    if (this.records.delete(key)) this.persist();
-    if (!record || !bot) return;
-    try {
-      await bot.axiosInstance.post('/set_msg_emoji_like', {
-        message_id: Number(record.messageId),
-        emoji_id: record.emoji,
-        set: false
-      });
-    } catch (error) {
-      bot.logger?.warn(`[Hermes] 摘除表情回应失败（${key}）: ${(error as Error).message}`);
-    }
-  }
-
-  /** 移除一条记录（Discord 摘除动作由调用方完成后调用） */
-  public drop(key: string): void {
-    this.load();
-    if (this.records.delete(key)) this.persist();
-  }
-
-  /** 全部残留的 Discord 记录（启动清理用，摘除后逐条 drop） */
-  public listDiscord(): PendingReaction[] {
-    this.load();
-    return [...this.records.values()].filter(record => record.platform === 'discord');
-  }
-
-  /** 启动清理：摘除全部残留的 QQ 表情回应并清空对应记录 */
-  public async cleanupQQ(bot: QQBot): Promise<void> {
-    this.load();
-    const stale = [...this.records.values()].filter(record => record.platform === 'qq');
-    for (const record of stale) {
-      try {
-        await bot.axiosInstance.post('/set_msg_emoji_like', {
-          message_id: Number(record.messageId),
-          emoji_id: record.emoji,
-          set: false
-        });
-      } catch {
-        // 消息已撤回/不存在等：放弃摘除，仅清理记录
-      }
-      this.records.delete(record.key);
-    }
-    if (stale.length > 0) {
-      this.persist();
-      bot.logger?.info(`[Hermes] 已清理 ${stale.length} 条残留的 QQ 表情回应`);
-    }
-  }
-}
+import fs from 'node:fs';
+import path from 'node:path';
+import { QQBot } from '@/index';
+import { getHermesConfig } from '@/features/hermes/config';
+import { writeConfigFile } from '@/config/manager';
+
+/**
+ * AI「处理中」表情回应管理。
+ *
+ * 用户消息触发 Hermes 运行时，给触发消息贴上表情回应（QQ 走 NapCat
+ * set_msg_emoji_like，Discord 走 message.react）；完整回复完成（含查询技能的
+ * 回喂轮）后摘除。
+ *
+ * 记录立即持久化到 data/hermes-reactions.json：若回应期间进程重启/宕机，
+ * 下次启动时按残留记录逐条摘除并清空（cleanupQQ 由 after-start 钩子调用，
+ * Discord 残留由 DiscordBridge 在 clientReady 后调用 listDiscord/drop 处理），
+ * 避免「处理中」表情永久残留。
+ */
+
+/** 一条待摘除的表情回应记录 */
+export interface PendingReaction {
+  /** 唯一键：`qq:{messageId}` / `discord:{channelId}:{messageId}` */
+  key: string;
+  platform: 'qq' | 'discord';
+  /** QQ: OneBot message_id 字符串；Discord: 消息 snowflake */
+  messageId: string;
+  /** Discord 频道 snowflake（QQ 记录无此字段） */
+  channelId?: string;
+  /** QQ: emoji_id；Discord: unicode emoji */
+  emoji: string;
+  createdAt: number;
+}
+
+interface ReactionStoreFile {
+  version: number;
+  reactions: PendingReaction[];
+}
+
+export class ReactionManager {
+  private static instance?: ReactionManager;
+
+  public static getInstance(): ReactionManager {
+    if (!ReactionManager.instance) ReactionManager.instance = new ReactionManager();
+    return ReactionManager.instance;
+  }
+
+  private readonly file = path.resolve(process.cwd(), 'data', 'hermes-reactions.json');
+  private readonly records = new Map<string, PendingReaction>();
+  private loaded = false;
+
+  private constructor() {}
+
+  /** 懒加载持久化记录（损坏按空处理） */
+  private load(): void {
+    if (this.loaded) return;
+    this.loaded = true;
+    try {
+      if (!fs.existsSync(this.file)) return;
+      const raw = JSON.parse(fs.readFileSync(this.file, 'utf-8')) as ReactionStoreFile;
+      if (!Array.isArray(raw?.reactions)) return;
+      for (const record of raw.reactions) {
+        if (record && typeof record.key === 'string' && typeof record.messageId === 'string') {
+          this.records.set(record.key, record);
+        }
+      }
+    } catch {
+      // 文件损坏或格式错误，按空记录处理
+    }
+  }
+
+  /** 立即落盘（原子写，复用 config/manager 的 writeConfigFile） */
+  private persist(): void {
+    try {
+      writeConfigFile(this.file, { version: 1, reactions: [...this.records.values()] } satisfies ReactionStoreFile);
+    } catch {
+      // 持久化失败不阻塞主流程
+    }
+  }
+
+  /**
+   * QQ：给消息贴「处理中」表情，成功后立即持久化记录并返回记录键。
+   * 返回 null 表示没贴上（功能关闭或 NapCat 拒绝，例如私聊消息通常不支持表情回应），
+   * 调用方据此决定是否改用文字回执；具体原因写入日志便于排查。
+   */
+  public async addQQ(bot: QQBot, messageId: number): Promise<string | null> {
+    const config = getHermesConfig();
+    if (!config.reactionEnabled) {
+      bot.logger?.debug(`[Hermes] 表情回应已关闭，跳过（message ${messageId}）`);
+      return null;
+    }
+    try {
+      await bot.axiosInstance.post('/set_msg_emoji_like', {
+        message_id: messageId,
+        emoji_id: config.reactionEmojiQq,
+        set: true
+      });
+    } catch (error) {
+      bot.logger?.warn(
+        `[Hermes] 表情回应失败（message ${messageId}）: ${(error as Error).message}` +
+          `；NapCat 对私聊消息通常不支持 set_msg_emoji_like`
+      );
+      return null;
+    }
+    const key = `qq:${messageId}`;
+    this.load();
+    this.records.set(key, {
+      key,
+      platform: 'qq',
+      messageId: String(messageId),
+      emoji: config.reactionEmojiQq,
+      createdAt: Date.now()
+    });
+    this.persist();
+    return key;
+  }
+
+  /**
+   * Discord：message.react 成功后调用，立即持久化记录并返回记录键。
+   */
+  public persistDiscord(channelId: string, messageId: string, emoji: string): string {
+    const key = `discord:${channelId}:${messageId}`;
+    this.load();
+    this.records.set(key, { key, platform: 'discord', messageId, channelId, emoji, createdAt: Date.now() });
+    this.persist();
+    return key;
+  }
+
+  /**
+   * QQ：摘除表情（set=false）。无论摘除成败都移除持久化记录
+   * （失败多为消息已被撤回等不可重试原因，残留记录只会在下次启动时再次失败）。
+   */
+  public async removeQQ(bot: QQBot | undefined, key: string): Promise<void> {
+    this.load();
+    const record = this.records.get(key);
+    if (this.records.delete(key)) this.persist();
+    if (!record || !bot) return;
+    try {
+      await bot.axiosInstance.post('/set_msg_emoji_like', {
+        message_id: Number(record.messageId),
+        emoji_id: record.emoji,
+        set: false
+      });
+    } catch (error) {
+      bot.logger?.warn(`[Hermes] 摘除表情回应失败（${key}）: ${(error as Error).message}`);
+    }
+  }
+
+  /** 移除一条记录（Discord 摘除动作由调用方完成后调用） */
+  public drop(key: string): void {
+    this.load();
+    if (this.records.delete(key)) this.persist();
+  }
+
+  /** 全部残留的 Discord 记录（启动清理用，摘除后逐条 drop） */
+  public listDiscord(): PendingReaction[] {
+    this.load();
+    return [...this.records.values()].filter(record => record.platform === 'discord');
+  }
+
+  /** 启动清理：摘除全部残留的 QQ 表情回应并清空对应记录 */
+  public async cleanupQQ(bot: QQBot): Promise<void> {
+    this.load();
+    const stale = [...this.records.values()].filter(record => record.platform === 'qq');
+    for (const record of stale) {
+      try {
+        await bot.axiosInstance.post('/set_msg_emoji_like', {
+          message_id: Number(record.messageId),
+          emoji_id: record.emoji,
+          set: false
+        });
+      } catch {
+        // 消息已撤回/不存在等：放弃摘除，仅清理记录
+      }
+      this.records.delete(record.key);
+    }
+    if (stale.length > 0) {
+      this.persist();
+      bot.logger?.info(`[Hermes] 已清理 ${stale.length} 条残留的 QQ 表情回应`);
+    }
+  }
+}

package/vendor/gugle-chat-bot/src/features/hermes/render.ts

@@ -1,118 +1,118 @@
-import { Template, tryGenerateImage } from '@/image';
-import { getHermesConfig } from '@/features/hermes/config';
-import { RunCurrentTool, RunToolRecord } from '@/features/hermes/types';
-
-/**
- * Hermes 进度/审批卡片渲染（移植自 qq-hermes-bridge src/renderer.ts，MIT 协议，原作者 Amorter）。
- * HTML/CSS 拆为模板文件，渲染改用 src/image 的共享 Chrome + 串行截图队列。
- * 渲染失败返回 null，调用方降级为纯文本。
- */
-
-/** 进度卡片渲染数据 */
-export interface ProgressCardData {
-  tools: RunToolRecord[];
-  currentTool: RunCurrentTool | null;
-  messageDelta?: string;
-  elapsed: string;
-}
-
-/** 审批卡片渲染数据 */
-export interface ApprovalCardData {
-  command: string;
-  riskLevel: string;
-  toolName?: string;
-  runId?: string;
-  preview?: string;
-}
-
-function escapeHtml(text: unknown): string {
-  return String(text || '')
-    .replace(/&/g, '&')
-    .replace(/</g, '&lt;')
-    .replace(/>/g, '&gt;')
-    .replace(/"/g, '&quot;');
-}
-
-function formatDuration(ms: number): string {
-  if (ms < 1000) return `${ms}ms`;
-  if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
-  return `${Math.floor(ms / 60000)}m${Math.round((ms % 60000) / 1000)}s`;
-}
-
-function render(templateName: string, template: Template): Promise<string> {
-  return new Promise<string>((resolve, reject) => {
-    const templateFile = template.file();
-    template
-      .handler()
-      .then(html => tryGenerateImage(resolve, reject, html, 500, templateFile))
-      .catch(reject);
-  });
-}
-
-/** 渲染进度卡片为 base64 图片；progressAsImage=false 或渲染失败时返回 null */
-export async function renderProgressImage(data: ProgressCardData): Promise<string | null> {
-  const config = getHermesConfig();
-  if (!config.progressAsImage) return null;
-  try {
-    const toolRows = data.tools
-      .slice(-config.progressMaxTools)
-      .map(tool => {
-        const icon = tool.error ? '❌' : '✅';
-        const duration = tool.duration ? ` (${formatDuration(tool.duration)})` : '';
-        return `<div class="tool-row">
-      <span class="icon">${icon}</span>
-      <span class="name">${escapeHtml(tool.name)}</span>
-      <span class="dur">${duration}</span>
-    </div>
-    ${tool.preview ? `<div class="preview">${escapeHtml(tool.preview).slice(0, 120)}</div>` : ''}`;
-      })
-      .join('\n');
-
-    const currentHtml = data.currentTool
-      ? `<div class="current-tool">
-        <span class="spinner">⏳</span>
-        <span class="name">${escapeHtml(data.currentTool.name)}</span>
-        ${data.currentTool.preview ? `<div class="preview">${escapeHtml(data.currentTool.preview).slice(0, 120)}</div>` : ''}
-      </div>`
-      : '';
-
-    const previewHtml = data.messageDelta
-      ? `<div class="response-preview">${escapeHtml(data.messageDelta.slice(-300))}</div>`
-      : '';
-
-    const template = Template.load('progress', 'src/features/hermes/template')
-      .arg('elapsed', escapeHtml(data.elapsed))
-      .arg('tools', toolRows)
-      .arg('current', currentHtml)
-      .arg('preview', previewHtml)
-      .arg('botName', escapeHtml(config.botName));
-    return await render('progress', template);
-  } catch {
-    return null;
-  }
-}
-
-/** 渲染审批卡片为 base64 图片；渲染失败时返回 null */
-export async function renderApprovalImage(data: ApprovalCardData): Promise<string | null> {
-  try {
-    const riskColors: Record<string, string> = { high: '#E94560', medium: '#F5C842', low: '#53D8FB' };
-    const riskColor = riskColors[data.riskLevel] || riskColors.high!;
-
-    const toolSection = data.toolName
-      ? `<div class="section"><div class="label">工具</div><div class="value">${escapeHtml(data.toolName)}</div></div>`
-      : '';
-    const previewSection = data.preview
-      ? `<div class="section"><div class="label">说明</div><div class="value">${escapeHtml(data.preview).slice(0, 200)}</div></div>`
-      : '';
-
-    const template = Template.load('approval', 'src/features/hermes/template')
-      .arg('riskColor', riskColor)
-      .arg('toolSection', toolSection)
-      .arg('command', escapeHtml(data.command))
-      .arg('previewSection', previewSection)
-      .arg('runId', escapeHtml(data.runId?.slice(-8) ?? ''));
-    return await render('approval', template);
-  } catch {
-    return null;
-  }
-}
+import { Template, tryGenerateImage } from '@/image';
+import { getHermesConfig } from '@/features/hermes/config';
+import { RunCurrentTool, RunToolRecord } from '@/features/hermes/types';
+
+/**
+ * Hermes 进度/审批卡片渲染（移植自 qq-hermes-bridge src/renderer.ts，MIT 协议，原作者 Amorter）。
+ * HTML/CSS 拆为模板文件，渲染改用 src/image 的共享 Chrome + 串行截图队列。
+ * 渲染失败返回 null，调用方降级为纯文本。
+ */
+
+/** 进度卡片渲染数据 */
+export interface ProgressCardData {
+  tools: RunToolRecord[];
+  currentTool: RunCurrentTool | null;
+  messageDelta?: string;
+  elapsed: string;
+}
+
+/** 审批卡片渲染数据 */
+export interface ApprovalCardData {
+  command: string;
+  riskLevel: string;
+  toolName?: string;
+  runId?: string;
+  preview?: string;
+}
+
+function escapeHtml(text: unknown): string {
+  return String(text || '')
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;');
+}
+
+function formatDuration(ms: number): string {
+  if (ms < 1000) return `${ms}ms`;
+  if (ms < 60000) return `${(ms / 1000).toFixed(1)}s`;
+  return `${Math.floor(ms / 60000)}m${Math.round((ms % 60000) / 1000)}s`;
+}
+
+function render(templateName: string, template: Template): Promise<string> {
+  return new Promise<string>((resolve, reject) => {
+    const templateFile = template.file();
+    template
+      .handler()
+      .then(html => tryGenerateImage(resolve, reject, html, 500, templateFile))
+      .catch(reject);
+  });
+}
+
+/** 渲染进度卡片为 base64 图片；progressAsImage=false 或渲染失败时返回 null */
+export async function renderProgressImage(data: ProgressCardData): Promise<string | null> {
+  const config = getHermesConfig();
+  if (!config.progressAsImage) return null;
+  try {
+    const toolRows = data.tools
+      .slice(-config.progressMaxTools)
+      .map(tool => {
+        const icon = tool.error ? '❌' : '✅';
+        const duration = tool.duration ? ` (${formatDuration(tool.duration)})` : '';
+        return `<div class="tool-row">
+      <span class="icon">${icon}</span>
+      <span class="name">${escapeHtml(tool.name)}</span>
+      <span class="dur">${duration}</span>
+    </div>
+    ${tool.preview ? `<div class="preview">${escapeHtml(tool.preview).slice(0, 120)}</div>` : ''}`;
+      })
+      .join('\n');
+
+    const currentHtml = data.currentTool
+      ? `<div class="current-tool">
+        <span class="spinner">⏳</span>
+        <span class="name">${escapeHtml(data.currentTool.name)}</span>
+        ${data.currentTool.preview ? `<div class="preview">${escapeHtml(data.currentTool.preview).slice(0, 120)}</div>` : ''}
+      </div>`
+      : '';
+
+    const previewHtml = data.messageDelta
+      ? `<div class="response-preview">${escapeHtml(data.messageDelta.slice(-300))}</div>`
+      : '';
+
+    const template = Template.load('progress', 'src/features/hermes/template')
+      .arg('elapsed', escapeHtml(data.elapsed))
+      .arg('tools', toolRows)
+      .arg('current', currentHtml)
+      .arg('preview', previewHtml)
+      .arg('botName', escapeHtml(config.botName));
+    return await render('progress', template);
+  } catch {
+    return null;
+  }
+}
+
+/** 渲染审批卡片为 base64 图片；渲染失败时返回 null */
+export async function renderApprovalImage(data: ApprovalCardData): Promise<string | null> {
+  try {
+    const riskColors: Record<string, string> = { high: '#E94560', medium: '#F5C842', low: '#53D8FB' };
+    const riskColor = riskColors[data.riskLevel] || riskColors.high!;
+
+    const toolSection = data.toolName
+      ? `<div class="section"><div class="label">工具</div><div class="value">${escapeHtml(data.toolName)}</div></div>`
+      : '';
+    const previewSection = data.preview
+      ? `<div class="section"><div class="label">说明</div><div class="value">${escapeHtml(data.preview).slice(0, 200)}</div></div>`
+      : '';
+
+    const template = Template.load('approval', 'src/features/hermes/template')
+      .arg('riskColor', riskColor)
+      .arg('toolSection', toolSection)
+      .arg('command', escapeHtml(data.command))
+      .arg('previewSection', previewSection)
+      .arg('runId', escapeHtml(data.runId?.slice(-8) ?? ''));
+    return await render('approval', template);
+  } catch {
+    return null;
+  }
+}