koishi-plugin-isthattrue 0.1.99

package/README.md

@@ -0,0 +1,104 @@
+# koishi-plugin-isthattrue
+
+[![npm](https://img.shields.io/npm/v/koishi-plugin-isthattrue?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-isthattrue)
+
+事实核查插件 - 使用多 Agent LLM 架构验证消息真实性
+
+## 功能特点
+
+- 多 Agent 协作：主控 Agent 编排任务，子搜索 Agent 并行检索
+- 多搜索源支持：Tavily、Anspire、Kimi、智谱、Chatluna Search
+- 支持文本和图片内容（OCR 识别）
+- 可引用消息进行核查
+- 输出判定结果：TRUE / FALSE / PARTIALLY_TRUE / UNCERTAIN
+
+## 安装
+
+```bash
+npm install koishi-plugin-isthattrue
+```
+
+## 依赖
+
+- [koishi-plugin-chatluna](https://github.com/ChatLunaLab/chatluna) - LLM 服务接入
+
+## 使用方法
+
+```
+tof [内容]        # 核查指定内容
+tof               # 引用一条消息后使用，核查被引用的消息
+```
+
+别名：`鉴定`、`核查`
+
+## 配置说明
+
+### 模型配置
+
+| 配置项 | 说明 | 推荐 |
+|--------|------|------|
+| mainModel | 主控 Agent 模型，用于编排和最终判决 | Gemini-3-Flash |
+| subSearchModel | 子搜索 Agent 模型，用于深度搜索 | Grok-4-1 |
+
+### 搜索 API 配置
+
+| 配置项 | 说明 |
+|--------|------|
+| tavilyApiKey | Tavily API Key（可选） |
+| anspireApiKey | Anspire API Key（可选） |
+| kimiApiKey | Kimi API Key（可选） |
+| zhipuApiKey | 智谱 API Key（可选） |
+| chatlunaSearchModel | Chatluna Search 使用的模型 |
+| enableChatlunaSearch | 启用 Chatluna 搜索集成 |
+| chatlunaSearchDiversifyModel | 搜索关键词多样化模型 |
+
+### Agent 配置
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| timeout | 60000 | 单次请求超时时间（毫秒） |
+| maxRetries | 2 | 失败重试次数 |
+
+### 其他设置
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| verbose | false | 显示详细验证过程 |
+| outputFormat | auto | 输出格式（auto/markdown/plain） |
+| useForwardMessage | true | 使用合并转发消息展示详情（仅 QQ） |
+| bypassProxy | false | 绕过系统代理 |
+| logLLMDetails | false | 打印 LLM 请求详情（调试用） |
+
+## 工作流程
+
+1. 用户发送 `tof` 命令（可引用消息或直接输入内容）
+2. MessageParser 提取文本和图片，如有图片则进行 OCR
+3. 主控 Agent 分析内容，生成搜索计划
+4. 子搜索 Agent 并行执行多源搜索
+5. 主控 Agent 综合搜索结果，输出最终判定
+
+## 架构
+
+```
+src/
+├── index.ts              # 插件入口，注册 tof 命令
+├── config.ts             # 配置 Schema
+├── types.ts              # TypeScript 类型定义
+├── agents/
+│   ├── mainAgent.ts      # 主控 Agent（编排 + 判决）
+│   └── subSearchAgent.ts # 子搜索 Agent（多源检索）
+├── services/
+│   ├── chatluna.ts       # Chatluna LLM 适配器
+│   ├── chatlunaSearch.ts # Chatluna Search 集成
+│   ├── messageParser.ts  # 消息解析（文本/图片）
+│   ├── tavily.ts         # Tavily 搜索
+│   ├── anspire.ts        # Anspire 搜索
+│   ├── kimi.ts           # Kimi 搜索
+│   └── zhipu.ts          # 智谱搜索
+└── utils/
+    └── prompts.ts        # LLM Prompt 模板
+```
+
+## License
+
+MIT

package/lib/agents/index.d.ts

@@ -0,0 +1,3 @@
+export { VerifyAgent } from './verifyAgent';
+export { MainAgent } from './mainAgent';
+export { SubSearchAgent } from './subSearchAgent';

package/lib/agents/mainAgent.d.ts

@@ -0,0 +1,30 @@
+import { Context } from 'koishi';
+import { Config } from '../config';
+import { VerificationResult, MessageContent } from '../types';
+/**
+ * 主控 Agent
+ * 流程：并行搜索 (Chatluna + Grok) -> URL处理 -> Gemini判决
+ */
+export declare class MainAgent {
+    private ctx;
+    private config;
+    private subSearchAgent;
+    private chatlunaSearchAgent;
+    private verifyAgent;
+    private chatluna;
+    private messageParser;
+    private logger;
+    constructor(ctx: Context, config: Config);
+    /**
+     * 执行完整的核查流程
+     */
+    verify(content: MessageContent): Promise<VerificationResult>;
+    /**
+     * 带超时的 Promise 包装
+     */
+    private withTimeout;
+    /**
+     * 从图片中提取描述（用于纯图片输入场景）
+     */
+    private extractImageDescription;
+}

package/lib/agents/searchAgent.d.ts

@@ -0,0 +1,53 @@
+import { Context } from 'koishi';
+import { Config } from '../config';
+import { SearchResult } from '../types';
+/**
+ * 搜索Agent
+ * 负责从特定角度搜索和收集信息
+ */
+export declare class SearchAgent {
+    private ctx;
+    private config;
+    private id;
+    private perspective;
+    private model;
+    private chatluna;
+    constructor(ctx: Context, config: Config, agentIndex: number, model: string);
+    /**
+     * 执行搜索
+     */
+    search(content: string): Promise<SearchResult>;
+    /**
+     * 解析Agent响应的JSON
+     */
+    private parseResponse;
+}
+/**
+ * 搜索Agent管理器
+ * 负责创建和协调多个搜索Agent
+ */
+export declare class SearchAgentManager {
+    private ctx;
+    private config;
+    private agents;
+    private tavilyAgent;
+    private anspireAgent;
+    private kimiAgent;
+    private zhipuAgent;
+    private chatlunaSearchAgent;
+    private logger;
+    constructor(ctx: Context, config: Config);
+    private initAgents;
+    /**
+     * 并行执行所有Agent的搜索
+     */
+    searchAll(content: string): Promise<SearchResult[]>;
+    /**
+     * 带超时的Promise包装 (LLM Agent)
+     */
+    private withTimeout;
+    /**
+     * 带超时的Promise包装 (通用)
+     */
+    private withTimeoutGeneric;
+}

package/lib/agents/subSearchAgent.d.ts

@@ -0,0 +1,21 @@
+import { Context } from 'koishi';
+import { Config } from '../config';
+import { SearchResult } from '../types';
+/**
+ * 子搜索 Agent
+ * 专门负责深度搜索（主要使用 Grok，擅长 X/Twitter 搜索）
+ * 独立搜索，不依赖其他搜索结果
+ */
+export declare class SubSearchAgent {
+    private ctx;
+    private config;
+    private chatluna;
+    private logger;
+    constructor(ctx: Context, config: Config);
+    /**
+     * 执行深度搜索
+     * @param claim 原始声明文本
+     */
+    deepSearch(claim: string): Promise<SearchResult>;
+    private parseResponse;
+}

package/lib/agents/verifyAgent.d.ts

@@ -0,0 +1,37 @@
+import { Context } from 'koishi';
+import { Config } from '../config';
+import { SearchResult, VerificationResult, MessageContent } from '../types';
+/**
+ * 验证Agent
+ * 负责综合搜索结果并做出最终判决
+ */
+export declare class VerifyAgent {
+    private ctx;
+    private config;
+    private chatluna;
+    private logger;
+    constructor(ctx: Context, config: Config);
+    /**
+     * 执行验证判决
+     * @param originalContent 原始消息内容
+     * @param searchResults 搜索结果
+     * @param images 可选的图片 base64 列表（多模态验证）
+     */
+    verify(originalContent: MessageContent, searchResults: SearchResult[], images?: string[]): Promise<VerificationResult>;
+    /**
+     * 解析验证响应
+     */
+    private parseVerifyResponse;
+    /**
+     * 标准化判决结果
+     */
+    private normalizeVerdict;
+    /**
+     * 从文本中提取判决
+     */
+    private extractVerdictFromText;
+    /**
+     * 汇总所有来源
+     */
+    private aggregateSources;
+}

package/lib/config.d.ts

@@ -0,0 +1,45 @@
+import { Schema } from 'koishi';
+/**
+ * 插件配置 Schema
+ */
+export interface Config {
+    /** 主控 Agent 模型 - 用于最终判决 (推荐 Gemini-3-Flash) */
+    mainModel: string;
+    /** 子搜索 Agent 模型 - 用于深度搜索 (推荐 Grok) */
+    subSearchModel: string;
+    /** Tavily API Key */
+    tavilyApiKey: string;
+    /** Anspire API Key */
+    anspireApiKey: string;
+    /** Kimi API Key */
+    kimiApiKey: string;
+    /** 智谱 API Key */
+    zhipuApiKey: string;
+    /** Chatluna Search 使用的模型 */
+    chatlunaSearchModel: string;
+    /** 启用 Chatluna 搜索集成 */
+    enableChatlunaSearch: boolean;
+    /** 搜索关键词多样化模型 */
+    chatlunaSearchDiversifyModel: string;
+    /** 超时时间(毫秒) */
+    timeout: number;
+    /** 最大重试次数 */
+    maxRetries: number;
+    /** 是否显示详细过程 */
+    verbose: boolean;
+    /** 输出格式 */
+    outputFormat: 'auto' | 'markdown' | 'plain';
+    /** 是否使用合并转发消息 */
+    useForwardMessage: boolean;
+    /** 合并转发最大节点数，超过则回退普通消息 */
+    forwardMaxNodes: number;
+    /** 合并转发总字符数上限，超过则回退普通消息 */
+    forwardMaxTotalChars: number;
+    /** 合并转发单节点字符数上限 */
+    forwardMaxSegmentChars: number;
+    /** 是否绕过代理 */
+    bypassProxy: boolean;
+    /** 是否打印 LLM 请求体和响应 */
+    logLLMDetails: boolean;
+}
+export declare const Config: Schema<Config>;

package/lib/index.d.ts

@@ -0,0 +1,7 @@
+import { Context } from 'koishi';
+import { Config } from './config';
+export declare const name = "isthattrue";
+export declare const inject: string[];
+export declare const usage = "\n## \u4E8B\u5B9E\u6838\u67E5\u63D2\u4EF6\n\n\u4F7F\u7528\u591AAgent\u67B6\u6784\u5BF9\u6D88\u606F\u8FDB\u884C\u4E8B\u5B9E\u6838\u67E5\u9A8C\u8BC1\u3002\n\n### \u4F7F\u7528\u65B9\u6CD5\n\n1. \u5F15\u7528\u4E00\u6761\u9700\u8981\u9A8C\u8BC1\u7684\u6D88\u606F\n2. \u53D1\u9001 `tof` \u6307\u4EE4\n3. \u7B49\u5F85\u9A8C\u8BC1\u7ED3\u679C\n\n### \u5DE5\u4F5C\u6D41\u7A0B\n\n1. **\u89E3\u6790\u9636\u6BB5**: \u63D0\u53D6\u5F15\u7528\u6D88\u606F\u4E2D\u7684\u6587\u672C\u548C\u56FE\u7247\n2. **\u641C\u7D22\u9636\u6BB5**: \u591A\u4E2AAgent\u5E76\u884C\u4ECE\u4E0D\u540C\u89D2\u5EA6\u641C\u7D22\u4FE1\u606F\n3. **\u9A8C\u8BC1\u9636\u6BB5**: \u7EFC\u5408\u641C\u7D22\u7ED3\u679C\uFF0C\u7531\u4F4E\u5E7B\u89C9\u7387LLM\u505A\u51FA\u5224\u51B3\n\n### \u5224\u51B3\u7C7B\u522B\n\n- \u2705 **\u771F\u5B9E**: \u6709\u5145\u5206\u53EF\u9760\u8BC1\u636E\u652F\u6301\n- \u274C **\u865A\u5047**: \u6709\u5145\u5206\u53EF\u9760\u8BC1\u636E\u53CD\u9A73\n- \u26A0\uFE0F **\u90E8\u5206\u771F\u5B9E**: \u58F0\u660E\u4E2D\u90E8\u5206\u5185\u5BB9\u5C5E\u5B9E\n- \u2753 **\u65E0\u6CD5\u786E\u5B9A**: \u8BC1\u636E\u4E0D\u8DB3\u6216\u76F8\u4E92\u77DB\u76FE\n";
+export { Config } from './config';
+export declare function apply(ctx: Context, config: Config): void;