koishi-plugin-dify-ai 0.1.5 → 0.1.6

package/lib/api/client.d.ts

@@ -18,7 +18,6 @@ export declare class DifyClient {
     /** blocking JSON 请求（本插件只用 blocking 模式） */
     private request;
     getAppInfo(): Promise<DifyAppInfo>;
-    getParameters(): Promise<any>;
     /** chat / agent-chat / advanced-chat（conversation_id 传空串表示新建会话） */
     runChat(body: {
         inputs: Record<string, any>;

package/lib/config.d.ts

@@ -120,8 +120,9 @@ export declare function resolveUploadConfig(config: Config): {
     maxMb: number;
 };
 /**
- * 引用触发消息配置（含 0.1.x 布尔开关迁移）：schema 形态缺失时
- * 旧 quoteTrigger 若被配置层透传保留则迁移，否则按总是引用处理。
+ * 引用触发消息配置（含 0.1.x 布尔开关迁移）：schema 会给旧配置填默认 quote 对象，
+ * 因此迁移判据是「旧布尔被配置层透传保留 且 quote 仍是默认形态（用户未在新表单改过）」——
+ * 此时以旧布尔为准；用户改过新表单（quote 非默认）则新值优先。
  */
 export declare function resolveQuoteConfig(config: Config): {
     enabled: boolean;

package/lib/history.d.ts

@@ -11,8 +11,12 @@ export interface HistoryEntry {
     userId: string;
     username: string;
     messageId?: string;
-    /** 纯文本 + 图片占位符 */
+    /** 原貌（含 @bot 渲染与图片占位）：统一格式行（query/历史变量）用 */
     content: string;
+    /** 剔除 @bot 的原貌：content 变量与精简行用 */
+    contentText: string;
+    /** 图片元素 URL（按元素序，与 content 中 [image:摘要] 序一致）：窗口类触发的上传依据 */
+    imageUrls?: string[];
     timestamp: number;
     quote?: QuotedMessage;
 }
@@ -24,6 +28,8 @@ export interface HistoryEntry {
 export declare function formatHistoryEntry(entry: HistoryEntry): string;
 /** 多条消息逐行拼接 */
 export declare function formatHistoryEntries(entries: HistoryEntry[]): string;
+/** 精简行：只记消息 ID 与剔除 @bot 的原貌内容，不带时间与作者前缀——窗口触发的 content 变量用 */
+export declare function formatHistoryBrief(entries: HistoryEntry[]): string;
 /** 从会话消息构造记录条目（历史缓冲 / 消息池共用）；assistant 行标注为机器人自己的发言 */
 export declare function buildHistoryEntry(session: Session, role?: 'user' | 'assistant'): HistoryEntry | null;
 /**

package/lib/index.js

@@ -509,10 +509,9 @@ function parseTextSafe(content) {
   }
 }
 __name(parseTextSafe, "parseTextSafe");
-function extractText(session, options = {}) {
+function extractText(session) {
   if (session.elements?.length) {
-    const elements = options.excludeAt ? session.elements.filter((element) => element.type !== "at") : session.elements;
-    return import_koishi2.h.select(elements, "text").join("").trim();
+    return import_koishi2.h.select(session.elements, "text").join("").trim();
   }
   return parseTextSafe(session.content);
 }
@@ -545,6 +544,9 @@ function extractTextWithPlaceholders(session) {
     if (element.type === "text") {
       const text = element.attrs?.["content"] ?? "";
       if (text) parts.push(text);
+    } else if (element.type === "at") {
+      const name2 = element.attrs?.["name"] ?? element.attrs?.["id"];
+      if (name2) parts.push(`@${name2}`);
     } else if (element.type === "img" || element.type === "image") {
       parts.push(imagePlaceholder(element.attrs?.["url"] ?? element.attrs?.["src"]));
     }
@@ -572,6 +574,10 @@ function formatHistoryEntries(entries) {
   return entries.map(formatHistoryEntry).join("\n");
 }
 __name(formatHistoryEntries, "formatHistoryEntries");
+function formatHistoryBrief(entries) {
+  return entries.map((entry) => entry.messageId ? `[msg:${entry.messageId}] ${entry.content}` : entry.content).join("\n");
+}
+__name(formatHistoryBrief, "formatHistoryBrief");
 function buildQuote(session) {
   const quote = session.quote;
   if (!quote?.user?.id) return void 0;
@@ -631,38 +637,39 @@ function hasAt(session, id) {
 __name(hasAt, "hasAt");
 function evaluateCondition(condition, session) {
   const text = extractText(session);
+  const verbatim = extractTextWithPlaceholders(session);
   switch (condition.type) {
     case "keyword-prefix": {
       const keyword = condition.keywords.find((k) => k && text.startsWith(k));
       if (!keyword) return null;
       const rest = text.slice(keyword.length).trim();
-      return { type: "keyword-prefix", queryText: rest || text };
+      return { type: "keyword-prefix", queryText: rest || verbatim };
     }
     case "keyword-contains": {
       const keyword = condition.keywords.find((k) => k && text.includes(k));
       if (!keyword) return null;
-      return { type: "keyword-contains", queryText: text };
+      return { type: "keyword-contains", queryText: verbatim };
     }
     case "at-bot": {
       const botId = session.bot?.userId;
       if (!botId) return null;
       if (!session.stripped?.atSelf && !hasAt(session, botId)) return null;
-      return { type: "at-bot", queryText: extractText(session, { excludeAt: true }) };
+      return { type: "at-bot", queryText: verbatim };
     }
     case "at-user": {
       const isAtAnyUser = condition.userIds.some((id) => hasAt(session, id));
       if (!isAtAnyUser) return null;
-      return { type: "at-user", queryText: text };
+      return { type: "at-user", queryText: verbatim };
     }
     case "quote-bot": {
       const botId = session.bot?.userId;
       if (!botId || session.quote?.user?.id !== botId) return null;
-      return { type: "quote-bot", queryText: extractText(session, { excludeAt: true }) };
+      return { type: "quote-bot", queryText: verbatim };
     }
     case "quote-user": {
       const author = session.quote?.user?.id;
       if (!author || !condition.userIds.includes(author)) return null;
-      return { type: "quote-user", queryText: extractText(session, { excludeAt: true }) };
+      return { type: "quote-user", queryText: verbatim };
     }
     default:
       return null;
@@ -1057,7 +1064,6 @@ var TriggerEngine = class {
   }
   fireDensity(fire, session) {
     this.beginCooldown(channelKeyOf(session.platform, session.channelId), fire.rule.name, densityLane(fire.conditionIndex));
-    const windowText = formatHistoryEntries(fire.entries);
     this.run({
       session,
       platform: session.platform,
@@ -1067,8 +1073,8 @@ var TriggerEngine = class {
       userId: session.userId,
       triggerType: "density",
       rule: fire.rule,
-      queryText: windowText,
-      contentText: windowText
+      queryText: formatHistoryEntries(fire.entries),
+      contentText: formatHistoryBrief(fire.entries)
     });
   }
   /** 冷却到期：把缓冲内的触发消息合并为一次触发，session 取首条（供投递与文件上传） */
@@ -1093,7 +1099,6 @@ var TriggerEngine = class {
   /** 密度冷却到期复查达标：无当前消息，用池身份构造上下文（投递同定时路径） */
   fireDensityExpiry(rule, conditionIndex, channel) {
     this.beginCooldown(channelKeyOf(channel.platform, channel.channelId), rule.name, densityLane(conditionIndex));
-    const windowText = formatHistoryEntries(channel.entries);
     this.run({
       platform: channel.platform,
       selfId: channel.selfId,
@@ -1101,8 +1106,8 @@ var TriggerEngine = class {
       guildId: channel.guildId,
       triggerType: "density",
       rule,
-      queryText: windowText,
-      contentText: windowText
+      queryText: formatHistoryEntries(channel.entries),
+      contentText: formatHistoryBrief(channel.entries)
     });
   }
   /**
@@ -1111,7 +1116,6 @@ var TriggerEngine = class {
    */
   fireSchedule(rule) {
     for (const channel of this.pool.takeSchedule(rule)) {
-      const windowText = formatHistoryEntries(channel.entries);
       this.run({
         platform: channel.platform,
         selfId: channel.selfId,
@@ -1119,8 +1123,8 @@ var TriggerEngine = class {
         guildId: channel.guildId,
         triggerType: "schedule",
         rule,
-        queryText: windowText,
-        contentText: windowText
+        queryText: formatHistoryEntries(channel.entries),
+        contentText: formatHistoryBrief(channel.entries)
       });
     }
   }

package/lib/requester/files.d.ts

@@ -27,6 +27,6 @@ export interface UploadResult {
     files: DifyInputFileObject[];
     dropped: string[];
 }
-/** 提取并上传消息中的文件（先按数量上限截断候选，再逐个上传） */
-export declare function uploadMessageFiles(ctx: Context, client: DifyClient, session: Session, difyUser: string, limit: UploadLimit): Promise<UploadResult>;
+/** 上传一批候选（入口按 type:source 去重，再按数量上限截断、逐个上传） */
+export declare function uploadCandidates(ctx: Context, client: DifyClient, candidates: FileCandidate[], difyUser: string, limit: UploadLimit): Promise<UploadResult>;
 export {};

package/lib/requester/runner.d.ts

@@ -28,6 +28,8 @@ export declare class RequestRunner {
     /** 应用类型：schema 显式指定优先，auto 时用探测结果（未探测到回退 chat） */
     private appTypeOf;
     run(fireCtx: FireContext): Promise<void>;
+    /** 引用判定：开关开启、回复耗时达到阈值、且由消息触发（定时与密度没有单一触发消息） */
+    private shouldQuoteReply;
     /** 按应用类型分流：workflow/completion 无会话，chat 系续接 conversation_id */
     private dispatch;
     private deliver;

package/lib/state/conversation.d.ts

@@ -15,6 +15,8 @@ export declare class ConversationStore {
     apps: Map<string, AppConfigEntry>);
     /** 粒度归一：bindingKey 与 difyUser 共用，保证两者始终对齐 */
     private resolveScopeDimension;
+    /** 私聊判定：有 session 读 session，无 session 的主动触发读池透传的标记 */
+    private isDirectOf;
     /** bindingKey = 应用 ID + 粒度 + 平台身份 */
     computeBindingKey(appId: string, rule: DifyRule, fireCtx: FireContext): string;
     /**
@@ -32,10 +34,15 @@ export declare class ConversationStore {
     /**
      * 重置匹配的绑定：本地删行 + 尽力删除 Dify 侧会话（失败仅记录）。
      * 表已无 guildKey 列，按频道匹配时全表读回后解析 bindingKey 过滤（行数量级很小）。
+     * 覆盖 guild / user（群内）/ channel 段与私聊执行时的 private 段；
+     * global 段跨频道，不随单频道重置。
      */
     resetWhere(filter: {
         bindingKey?: string;
         guildKey?: string;
+        channelKey?: string;
+        isDirect?: boolean;
+        userId?: string;
     }): Promise<number>;
     /** 按应用 ID（apps 配置的 appId 字段）反查应用 */
     private findByAppId;

package/lib/trigger/conditions.d.ts

@@ -2,10 +2,10 @@ import { Session } from 'koishi';
 import { MessageTriggerType, TriggerCondition, TriggerScope } from '../types';
 export interface ConditionMatched {
     type: MessageTriggerType;
-    /** 触发后用作 content 变量的剥离文本（query 由引擎按统一消息格式另行构造） */
-    queryText: string;
+    /** content 变量的剥离文本，保留 @ 与图片占位（query 由引擎按统一消息格式另行构造） */
+    contentText: string;
 }
-/** 评估单个消息条件；返回 null 表示未命中 */
+/** 评估单个消息条件；返回 null 表示未命中（匹配基于纯文本，@ 元素不参与判定） */
 export declare function evaluateCondition(condition: TriggerCondition, session: Session): ConditionMatched | null;
 /** 作用域过滤：留空的维度不做限制 */
 export declare function matchScope(scope: TriggerScope, session: Session): boolean;

package/lib/trigger/cooldown.d.ts

@@ -10,6 +10,8 @@ export interface PendingMessage {
 }
 /** 冷却通道：message = 规则内全部消息类条件共享；density:N = 第 N 个密度条件独立 */
 export type CooldownLane = 'message' | `density:${number}`;
+/** 密度通道名的下标前缀 */
+export declare const DENSITY_LANE_PREFIX = "density:";
 /** 密度条件的通道名 */
 export declare function densityLane(index: number): CooldownLane;
 /** 到期扫描交出的通道产物 */
@@ -34,13 +36,15 @@ export declare class TriggerCooldown {
     /** 触发发起时登记冷却 */
     begin(channelKey: string, ruleName: string, lane: CooldownLane, now: number): void;
     isCooling(channelKey: string, ruleName: string, lane: CooldownLane, now: number): boolean;
-    /** 滑动窗口顺延：截止时间顺延到「now + 最小窗口」，不超过「触发时刻 + 最大窗口」 */
+    /** 滑动窗口顺延：截止推到「now + 最小窗口」，不超过「触发时刻 + 最大窗口」 */
+    private slide;
+    /** 滑动窗口顺延：已到期的通道不复活 */
     extend(channelKey: string, ruleName: string, lane: CooldownLane, now: number): void;
-    /** 该频道所有密度通道由一条过路消息顺延（密度冷却期内的消息积攒驱动窗口滑动） */
+    /** 该频道所有密度通道由一条过路消息顺延（密度冷却期内的消息积攒驱动窗口滑动）；已到期的不复活 */
     extendDensityLanes(channelKey: string, now: number): void;
     /** 冷却期内缓存一条命中消息（仅消息通道） */
     bufferMessage(channelKey: string, ruleName: string, message: PendingMessage): void;
-    /** 到期扫描：取走全部到期通道（连缓冲一并交出），由调用方决定是否重新登记 */
-    collectExpired(now: number): ExpiredCooldown[];
+    /** 到期扫描：取走到期通道（连缓冲一并交出），由调用方决定是否重新登记；限定频道时只扫该频道 */
+    collectExpired(now: number, channelKey?: string): ExpiredCooldown[];
     private lanesOf;
 }

package/lib/trigger/engine.d.ts

@@ -33,7 +33,7 @@ export declare class TriggerEngine {
      * 频道身份取自池内最近一条消息；无消息的频道自然跳过。定时不受冷却影响。
      */
     private fireSchedule;
-    /** 每秒扫描冷却到期：消息通道合并触发，密度通道复查池 */
+    /** 扫描冷却到期（带频道只扫该频道，消息路径用；每秒 interval 全量扫描）：消息通道合并触发，密度通道复查池 */
     private tickCooldown;
     private onCooldownExpired;
 }

package/lib/types.d.ts

@@ -110,6 +110,10 @@ export interface FireContext {
     rule: DifyRule;
     /** 发给 Dify 的 query：统一消息格式（消息触发为单行，窗口触发为逐行拼接） */
     queryText: string;
-    /** content 变量的值：消息触发为剥离文本，窗口触发为统一格式拼接 */
+    /** content 变量的值：消息触发为剥离文本（剔除 @bot），窗口触发为精简行拼接 */
     contentText: string;
+    /** 本次触发相关消息的图片 URL（合并/密度/定时的池或缓冲条目合集）：供上传管线补齐非首条消息的图片 */
+    imageUrls?: string[];
+    /** 无 session 的主动触发（定时/密度到期）从消息池透传的私聊标记：会话绑定与 isDirect 变量用 */
+    isDirect?: boolean;
 }

package/lib/utils/session-text.d.ts

@@ -1,4 +1,6 @@
 import { Session } from 'koishi';
+/** 图片占位符携带的 URL 摘要长度（hex 位） */
+export declare const IMAGE_HASH_LENGTH = 8;
 /**
  * 会话文本提取的统一入口。此前有四个变体（条件匹配、历史记录、变量、@ 剥离）
  * 各自实现「elements 有则取 text 元素，否则解析 content」，trim 与解析行为已经漂移，
@@ -6,21 +8,24 @@ import { Session } from 'koishi';
  */
 /** 把可解析的消息文本（含元素标记）转纯文本；解析失败回退原文 */
 export declare function parseTextSafe(content: string | undefined): string;
-interface ExtractTextOptions {
-    /** 去掉 @ 元素（at-bot 触发的 query 语义） */
-    excludeAt?: boolean;
-}
-/** 会话消息纯文本：优先 elements，退回 content 解析；统一 trim */
-export declare function extractText(session: Session, options?: ExtractTextOptions): string;
+/** 会话消息纯文本：优先 elements，退回 content 解析；统一 trim（@ 元素不产生文本，仅供条件匹配） */
+export declare function extractText(session: Session): string;
 /** 消息中的图片元素在文本形态里的占位符（图片无 URL 时的兜底形态） */
 export declare const IMAGE_PLACEHOLDER = "[\u56FE\u7247]";
-/** 图片占位符带 URL 摘要前 8 位：同 URL 同标识，query 里的占位符与上传文件可全局对应 */
+/** 图片占位符带 URL 摘要：同 URL 同标识，query 里的占位符与上传文件可全局对应 */
 export declare function imagePlaceholder(url?: string): string;
 /** 给被丢弃图片的占位符追加已丢弃注记：按 URL 摘要全局定位，无需与元素顺序对齐 */
 export declare function annotateDroppedPlaceholders(text: string, droppedUrls: string[]): string;
+interface ExtractVerbatimOptions {
+    /** 跳过 @ 机器人自身的渲染（content 变量语义：@bot 是触发结构而非消息内容） */
+    excludeBotAt?: boolean;
+}
 /**
- * 带媒体占位符的消息文本：text 元素按序拼接，img/image 元素渲染为 [image:URL摘要]，
- * 供聊天记录呈现（历史消息变量 / 定时摘要 / 密度触发共用）。
+ * 消息原貌文本：text 元素按序拼接，@ 元素渲染为 @名字（缺名字用 ID），
+ * img/image 元素渲染为 [image:URL摘要]——统一格式行（query/池/历史）用默认形态，
+ * content 变量通道用 excludeBotAt 形态剔除 @bot。
  */
-export declare function extractTextWithPlaceholders(session: Session): string;
+export declare function extractTextWithPlaceholders(session: Session, options?: ExtractVerbatimOptions): string;
+/** 消息中图片元素的 URL 列表（按元素序，与原貌文本中 [image:摘要] 的出现序一致） */
+export declare function extractImageUrls(session: Session): string[];
 export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-dify-ai",
   "description": "Invoke Dify apps (chatflow / workflow / completion) in Koishi with triggers and conversation bindings",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "author": "PinkElysia",
   "license": "MIT",
   "homepage": "https://github.com/PinkElysiaDev/dify-ai-plugin-for-Koishi#readme",