@zhin.js/agent 0.0.16 → 0.0.17

package/src/init/register-builtin-tools.ts

@@ -5,11 +5,14 @@
 import * as fs from 'fs';
 import * as os from 'os';
 import * as path from 'path';
-import { getPlugin, type Tool, type SkillFeature } from '@zhin.js/core';
+import { getPlugin, type Tool, type SkillFeature, type AgentPreset } from '@zhin.js/core';
 import {
   collectPluginSkillSearchRoots,
   createBuiltinTools,
   discoverWorkspaceSkills,
+  discoverWorkspaceAgents,
+  discoverWorkspaceTools,
+  buildToolFromMeta,
   loadAlwaysSkillsContent,
   buildSkillsSummaryXML,
 } from '../builtin-tools.js';
@@ -33,6 +36,10 @@ export function registerBuiltinTools(refs: AIServiceRefs): void {
     const builtinTools = createBuiltinTools({
       skillInstructionMaxChars: resolveSkillInstructionMaxChars(fullCfg, modelName),
       pluginSkillRootsResolver: () => collectPluginSkillSearchRoots(root),
+      skillFileLookup: (name: string) => {
+        const skillFeature = root.inject?.('skill') as SkillFeature | undefined;
+        return skillFeature?.get(name)?.filePath;
+      },
     });
     const disposers: (() => void)[] = [];
     for (const tool of builtinTools) disposers.push(toolService.addTool(tool, root.name));
@@ -42,6 +49,7 @@ export function registerBuiltinTools(refs: AIServiceRefs): void {
 
     let skillWatchers: fs.FSWatcher[] = [];
     let skillReloadDebounce: ReturnType<typeof setTimeout> | null = null;
+    let toolReloadDebounce: ReturnType<typeof setTimeout> | null = null;
 
     async function syncWorkspaceSkills(): Promise<number> {
       const skillFeature = root.inject?.('skill') as SkillFeature | undefined;
@@ -71,11 +79,89 @@ export function registerBuiltinTools(refs: AIServiceRefs): void {
           keywords: s.keywords || [],
           tags: s.tags || [],
           pluginName: root.name,
+          filePath: s.filePath,
+          always: s.always,
         }, root.name);
       }
       return skills.length;
     }
 
+    // 文件化 Tool 的 disposer（用于热重载时移除旧 tool）
+    let toolFileDisposers: (() => void)[] = [];
+
+    /**
+     * Discover *.tool.md files and register them as tools.
+     */
+    async function syncWorkspaceTools(): Promise<number> {
+      // 移除之前文件化注册的 tool
+      for (const d of toolFileDisposers) d();
+      toolFileDisposers = [];
+
+      const toolMetas = await discoverWorkspaceTools(root);
+      if (toolMetas.length === 0) return 0;
+
+      let added = 0;
+      for (const meta of toolMetas) {
+        // 跳过已通过程序化方式注册的同名 tool
+        if (toolService.get(meta.name)) {
+          logger.debug(`Tool '${meta.name}' 已存在（程序化注册），跳过文件化版本`);
+          continue;
+        }
+        const tool = await buildToolFromMeta(meta);
+        if (!tool) continue;
+        const dispose = toolService.addTool(tool, root.name);
+        toolFileDisposers.push(dispose);
+        added++;
+      }
+      return added;
+    }
+
+    // 已发现的 Agent 预设（本地缓存，无需存储到 Plugin 树）
+    const discoveredAgents = new Map<string, AgentPreset>();
+
+    /**
+     * Discover *.agent.md files and register agent presets.
+     */
+    async function syncWorkspaceAgents(): Promise<number> {
+      const agentMetas = await discoverWorkspaceAgents(root);
+      if (agentMetas.length === 0) return 0;
+      const allRegisteredTools = toolService.getAll();
+      const toolNameIndex = new Map<string, import('@zhin.js/core').Tool>();
+      for (const t of allRegisteredTools) {
+        toolNameIndex.set(t.name, t);
+      }
+      let added = 0;
+      for (const meta of agentMetas) {
+        if (discoveredAgents.has(meta.name)) continue;
+        const associatedTools: import('@zhin.js/core').Tool[] = [];
+        for (const toolName of meta.toolNames || []) {
+          const tool = toolService.get(toolName) || toolNameIndex.get(toolName);
+          if (tool) associatedTools.push(tool);
+        }
+        // Read body as systemPrompt
+        let systemPrompt: string | undefined;
+        try {
+          const content = await fs.promises.readFile(meta.filePath, 'utf-8');
+          const body = content.replace(/^---\s*\n[\s\S]*?\n---\s*(?:\n|$)/, '').trim();
+          if (body) systemPrompt = body;
+        } catch { /* ignore */ }
+        discoveredAgents.set(meta.name, {
+          name: meta.name,
+          description: meta.description,
+          keywords: meta.keywords,
+          tags: meta.tags,
+          tools: associatedTools.length > 0 ? associatedTools : undefined,
+          systemPrompt,
+          model: meta.model,
+          provider: meta.provider,
+          maxIterations: meta.maxIterations,
+          filePath: meta.filePath,
+        });
+        added++;
+      }
+      return added;
+    }
+
     (async () => {
       // Step 1: discover workspace skills
       try {
@@ -88,6 +174,26 @@ export function registerBuiltinTools(refs: AIServiceRefs): void {
         logger.warn(`Failed to discover workspace skills: ${e.message}`);
       }
 
+      // Step 1b: discover *.tool.md file-based tools
+      try {
+        const toolCount = await syncWorkspaceTools();
+        if (toolCount > 0) {
+          logger.info(`Registered ${toolCount} workspace file-based tools`);
+        }
+      } catch (e: any) {
+        logger.warn(`Failed to discover workspace tools: ${e.message}`);
+      }
+
+      // Step 1c: discover *.agent.md agent presets
+      try {
+        const agentCount = await syncWorkspaceAgents();
+        if (agentCount > 0) {
+          logger.info(`Registered ${agentCount} workspace agent presets`);
+        }
+      } catch (e: any) {
+        logger.debug(`Failed to discover workspace agents: ${e.message}`);
+      }
+
       // Step 2: load bootstrap files
       const loadedFiles: string[] = [];
       try {
@@ -140,6 +246,30 @@ export function registerBuiltinTools(refs: AIServiceRefs): void {
         bootstrapFiles: loadedFiles,
       }));
 
+      // Hot-reload tool directories
+      const workspaceToolDir = path.join(process.cwd(), 'tools');
+      const onToolDirChange = () => {
+        if (toolReloadDebounce) clearTimeout(toolReloadDebounce);
+        toolReloadDebounce = setTimeout(async () => {
+          toolReloadDebounce = null;
+          try {
+            const count = await syncWorkspaceTools();
+            if (count >= 0) logger.info(`[Tool热重载] 已更新，工作区文件化Tool: ${count}`);
+          } catch (e: any) {
+            logger.warn(`[Tool热重载] 失败: ${e.message}`);
+          }
+        }, 400);
+      };
+      if (fs.existsSync(workspaceToolDir)) {
+        try {
+          const w = fs.watch(workspaceToolDir, { recursive: true }, onToolDirChange);
+          skillWatchers.push(w);
+          logger.debug(`[Tool热重载] 监听目录: ${workspaceToolDir}`);
+        } catch (e: any) {
+          logger.debug(`[Tool热重载] 无法监听 ${workspaceToolDir}: ${e.message}`);
+        }
+      }
+
       // Hot-reload skill directories
       const workspaceSkillDir = path.join(process.cwd(), 'skills');
       const localSkillDir = path.join(os.homedir(), '.zhin', 'skills');
@@ -157,7 +287,7 @@ export function registerBuiltinTools(refs: AIServiceRefs): void {
               refs.zhinAgent.setSkillsSummaryXML(skillsXml);
             }
             await triggerAIHook(createAIHookEvent('agent', 'skills-reloaded', undefined, { skillCount: count }));
-            if (count >= 0) logger.info(`[技能热重载] 已更新，当前工作区技能数: ${count}`);
+            if (count >= 0) logger.info(`[技能热重载] 已更新，工作区技能: ${count}`);
           } catch (e: any) {
             logger.warn(`[技能热重载] 失败: ${e.message}`);
           }
@@ -178,9 +308,12 @@ export function registerBuiltinTools(refs: AIServiceRefs): void {
 
     return () => {
       disposers.forEach(d => d());
+      toolFileDisposers.forEach(d => d());
+      toolFileDisposers = [];
       skillWatchers.forEach(w => w.close());
       skillWatchers = [];
       if (skillReloadDebounce) clearTimeout(skillReloadDebounce);
+      if (toolReloadDebounce) clearTimeout(toolReloadDebounce);
     };
   });
 }

package/src/init/register-db-models.ts

@@ -2,9 +2,9 @@
  * Define AI-related database models (7 tables).
  */
 import { getPlugin } from '@zhin.js/core';
-import { AI_SESSION_MODEL } from '../session.js';
-import { CHAT_MESSAGE_MODEL, CONTEXT_SUMMARY_MODEL } from '../context-manager.js';
-import { AI_MESSAGE_MODEL, AI_SUMMARY_MODEL } from '../conversation-memory.js';
+import { AI_SESSION_MODEL } from '@zhin.js/ai';
+import { CHAT_MESSAGE_MODEL, CONTEXT_SUMMARY_MODEL } from '@zhin.js/ai';
+import { AI_MESSAGE_MODEL, AI_SUMMARY_MODEL } from '@zhin.js/ai';
 import { AI_USER_PROFILE_MODEL } from '../user-profile.js';
 import { AI_FOLLOWUP_MODEL } from '../follow-up.js';
 

package/src/init/register-db-upgrade.ts

@@ -7,8 +7,8 @@
 import './types.js';
 import { getPlugin } from '@zhin.js/core';
 import type { AIConfig } from '@zhin.js/core';
-import { createDatabaseSessionManager } from '../session.js';
-import { createContextManager } from '../context-manager.js';
+import { createDatabaseSessionManager } from '@zhin.js/ai';
+import { createContextManager } from '@zhin.js/ai';
 import type { AIServiceRefs } from './shared-refs.js';
 
 export function registerDbUpgrade(refs: AIServiceRefs): void {

package/src/init/register-management-tools.ts

@@ -3,7 +3,7 @@
  */
 import './types.js';
 import { getPlugin, Message, ZhinTool } from '@zhin.js/core';
-import { SessionManager } from '../session.js';
+import { SessionManager } from '@zhin.js/ai';
 
 export function registerManagementTools(): void {
   const plugin = getPlugin();

package/src/init/register-message-recorder.ts

@@ -2,7 +2,7 @@
  * Register middleware that records messages to the context manager.
  */
 import { getPlugin, Message } from '@zhin.js/core';
-import type { MessageRecord } from '../context-manager.js';
+import type { MessageRecord } from '@zhin.js/ai';
 import type { AIServiceRefs } from './shared-refs.js';
 
 export function registerMessageRecorder(refs: AIServiceRefs): void {

package/src/service.ts

@@ -25,14 +25,28 @@ import {
 import {
   SessionManager,
   createMemorySessionManager,
-  createDatabaseSessionManager,
-} from './session.js';
-import { Agent, createAgent } from './agent.js';
+} from '@zhin.js/ai';
+import { Agent, createAgent } from '@zhin.js/ai';
 import { getBuiltinTools } from './tools.js';
-import type { ContextManager, ContextConfig } from './context-manager.js';
+import type { ContextManager, ContextConfig } from '@zhin.js/ai';
+import { PERM_MAP } from './zhin-agent/config.js';
 
 const aiLogger = new Logger(null, 'AI');
 
+/** Provider 注册表：key → 构造函数 + 是否需要 apiKey */
+const PROVIDER_REGISTRY: Array<{
+  key: keyof NonNullable<AIConfig['providers']>;
+  factory: new (config: any) => AIProvider;
+  requireApiKey: boolean;
+}> = [
+  { key: 'openai', factory: OpenAIProvider, requireApiKey: true },
+  { key: 'anthropic', factory: AnthropicProvider, requireApiKey: true },
+  { key: 'deepseek', factory: DeepSeekProvider, requireApiKey: true },
+  { key: 'moonshot', factory: MoonshotProvider, requireApiKey: true },
+  { key: 'zhipu', factory: ZhipuProvider, requireApiKey: true },
+  { key: 'ollama', factory: OllamaProvider, requireApiKey: false },
+];
+
 export class AIService {
   private providers: Map<string, AIProvider> = new Map();
   private defaultProvider: string;
@@ -55,23 +69,11 @@ export class AIService {
     this.sessions = createMemorySessionManager(this.sessionConfig);
     this.builtinTools = getBuiltinTools().map(tool => this.convertToolToAgentTool(tool.toTool()));
 
-    if (config.providers?.openai?.apiKey) {
-      this.registerProvider(new OpenAIProvider(config.providers.openai));
-    }
-    if (config.providers?.anthropic?.apiKey) {
-      this.registerProvider(new AnthropicProvider(config.providers.anthropic));
-    }
-    if (config.providers?.deepseek?.apiKey) {
-      this.registerProvider(new DeepSeekProvider(config.providers.deepseek));
-    }
-    if (config.providers?.moonshot?.apiKey) {
-      this.registerProvider(new MoonshotProvider(config.providers.moonshot));
-    }
-    if (config.providers?.zhipu?.apiKey) {
-      this.registerProvider(new ZhipuProvider(config.providers.zhipu));
-    }
-    if (config.providers?.ollama) {
-      this.registerProvider(new OllamaProvider(config.providers.ollama));
+    for (const { key, factory, requireApiKey } of PROVIDER_REGISTRY) {
+      const providerConfig = config.providers?.[key];
+      if (!providerConfig) continue;
+      if (requireApiKey && !(providerConfig as any).apiKey) continue;
+      this.registerProvider(new factory(providerConfig as any));
     }
   }
 
@@ -79,98 +81,15 @@ export class AIService {
     return this.providers.size > 0;
   }
 
-  private static readonly PRE_EXEC_TIMEOUT = 10_000;
-
   async process(
     content: string,
     context: ToolContext,
-    tools: Tool[],
-  ): Promise<string | AsyncIterable<string>> {
+    _tools: Tool[],
+  ): Promise<string> {
     const { platform, senderId, sceneId } = context;
     const sessionId = SessionManager.generateId(platform || '', senderId || '', sceneId);
-    const allTools = this.collectAllToolsWithExternal(tools);
-    const baseSystemPrompt = 'You are a helpful AI assistant. Reply in the language specified in [User profile] (key: language / preferred_language), or in the user\'s message language if not set.';
-
-    if (allTools.length === 0) {
-      return this.finishAndSave(sessionId, content, baseSystemPrompt, sceneId);
-    }
-
-    const callerPermissionLevel = context.senderPermissionLevel
-      ? (AIService.PERM_MAP[context.senderPermissionLevel] ?? 0)
-      : (context.isOwner ? 4 : context.isBotAdmin ? 3 : context.isGroupOwner ? 2 : context.isGroupAdmin ? 1 : 0);
-
-    const relevantTools = Agent.filterTools(content, allTools, {
-      callerPermissionLevel,
-      maxTools: 8,
-      minScore: 0.1,
-    });
-
-    if (relevantTools.length === 0) {
-      return this.finishAndSave(sessionId, content, baseSystemPrompt, sceneId);
-    }
-
-    const noParamTools: AgentTool[] = [];
-    const paramTools: AgentTool[] = [];
-    for (const tool of relevantTools) {
-      const required = tool.parameters?.required;
-      (!required || required.length === 0) ? noParamTools.push(tool) : paramTools.push(tool);
-    }
-
-    let preExecutedData = '';
-    const preExecutedCalls: { tool: string; args: Record<string, any>; result: any }[] = [];
-
-    if (noParamTools.length > 0) {
-      const results = await Promise.allSettled(
-        noParamTools.map(async (tool) => {
-          const result = await Promise.race([
-            tool.execute({}),
-            new Promise<never>((_, reject) =>
-              setTimeout(() => reject(new Error('预执行超时')), AIService.PRE_EXEC_TIMEOUT)),
-          ]);
-          return { name: tool.name, result };
-        }),
-      );
-      for (const r of results) {
-        if (r.status === 'fulfilled') {
-          const s = typeof r.value.result === 'string' ? r.value.result : JSON.stringify(r.value.result);
-          preExecutedData += `\n${s}`;
-          preExecutedCalls.push({ tool: r.value.name, args: {}, result: r.value.result });
-        }
-      }
-    }
-
-    let finalResponse: string;
-
-    if (paramTools.length === 0 && preExecutedData) {
-      const singleShotPrompt = `You are a helpful AI assistant. Reply in the language specified in [User profile] (key: language / preferred_language), or in the user's message language if not set.\n\nPre-fetched data:\n${preExecutedData}\n\nAnswer the user's question based on the data above. Do not mention data sources or tool names. Summarize clearly and highlight key information.`;
-      finalResponse = await this.simpleChat(content, singleShotPrompt);
-    } else {
-      const agentSystemPrompt = `You are a helpful AI assistant. Reply in the language specified in [User profile] (key: language / preferred_language), or in the user's message language if not set.
-${preExecutedData ? `\nPre-fetched data:\n${preExecutedData}\n` : ''}
-## Requirements
-- After calling tools, give a complete answer based on the results; do not mention tool names or data sources
-- Summarize in natural language and highlight key information`;
-
-      const agent = this.createAgent({
-        systemPrompt: agentSystemPrompt,
-        tools: paramTools.length > 0 ? paramTools : relevantTools,
-        useBuiltinTools: false,
-        collectExternalTools: false,
-        maxIterations: 3,
-      });
-
-      const agentResult = await agent.run(content);
-      finalResponse = agentResult.content || this.formatToolCallsFallback(
-        [...preExecutedCalls, ...agentResult.toolCalls],
-      );
-    }
-
-    await this.sessions.addMessage(sessionId, { role: 'user', content });
-    await this.sessions.addMessage(sessionId, { role: 'assistant', content: finalResponse });
-    if (this.contextManager && sceneId) {
-      this.contextManager.autoSummarizeIfNeeded(sceneId).catch(() => {});
-    }
-    return finalResponse;
+    const systemPrompt = 'You are a helpful AI assistant. Reply in the language specified in [User profile] (key: language / preferred_language), or in the user\'s message language if not set.';
+    return this.finishAndSave(sessionId, content, systemPrompt, sceneId);
   }
 
   private async finishAndSave(sessionId: string, content: string, systemPrompt: string, sceneId?: string): Promise<string> {
@@ -183,13 +102,6 @@ ${preExecutedData ? `\nPre-fetched data:\n${preExecutedData}\n` : ''}
     return response;
   }
 
-  private formatToolCallsFallback(toolCalls: { tool: string; args: any; result: any }[]): string {
-    if (toolCalls.length === 0) return 'Done.';
-    return toolCalls.map(tc => {
-      return typeof tc.result === 'string' ? tc.result : JSON.stringify(tc.result, null, 2);
-    }).join('\n\n');
-  }
-
   private async simpleChat(content: string, systemPrompt: string): Promise<string> {
     const provider = this.getProvider();
     const response = await this.chat({
@@ -203,22 +115,6 @@ ${preExecutedData ? `\nPre-fetched data:\n${preExecutedData}\n` : ''}
     return typeof msgContent === 'string' ? msgContent : '';
   }
 
-  private collectAllToolsWithExternal(externalTools: Tool[]): AgentTool[] {
-    const tools: AgentTool[] = [];
-    tools.push(...this.builtinTools);
-    tools.push(...this.customTools.values());
-    for (const tool of externalTools) {
-      if (tool.name.startsWith('cmd_') || tool.name.startsWith('process_')) continue;
-      tools.push(this.convertToolToAgentTool(tool));
-    }
-    if (tools.length > 30) return tools.slice(0, 30);
-    return tools;
-  }
-
-  private static readonly PERM_MAP: Record<string, number> = {
-    'user': 0, 'group_admin': 1, 'group_owner': 2, 'bot_admin': 3, 'owner': 4,
-  };
-
   private convertToolToAgentTool(tool: Tool): AgentTool {
     const agentTool: AgentTool = {
       name: tool.name,
@@ -227,7 +123,7 @@ ${preExecutedData ? `\nPre-fetched data:\n${preExecutedData}\n` : ''}
       execute: async (args) => tool.execute(args),
     };
     if (tool.tags?.length) agentTool.tags = tool.tags;
-    if (tool.permissionLevel) agentTool.permissionLevel = AIService.PERM_MAP[tool.permissionLevel] ?? 0;
+    if (tool.permissionLevel) agentTool.permissionLevel = PERM_MAP[tool.permissionLevel] ?? 0;
     if (tool.keywords?.length) agentTool.keywords = tool.keywords;
     return agentTool;
   }

package/src/subagent.ts

@@ -11,7 +11,7 @@
 import { randomUUID } from 'crypto';
 import { Logger } from '@zhin.js/core';
 import type { AIProvider, AgentTool } from '@zhin.js/core';
-import { createAgent } from './agent.js';
+import { createAgent } from '@zhin.js/ai';
 import type { ZhinAgentConfig } from './zhin-agent/config.js';
 import { applyExecPolicyToTools } from './zhin-agent/exec-policy.js';
 

package/src/zhin-agent/builtin-tools.ts

@@ -7,7 +7,7 @@
 
 import type { ToolContext } from '@zhin.js/core';
 import type { AgentTool } from '@zhin.js/core';
-import type { ConversationMemory } from '../conversation-memory.js';
+import type { ConversationMemory } from '@zhin.js/ai';
 import type { UserProfileStore } from '../user-profile.js';
 import type { FollowUpManager } from '../follow-up.js';
 import type { SubagentManager, SubagentOrigin } from '../subagent.js';

package/src/zhin-agent/config.ts

@@ -2,8 +2,8 @@
  * ZhinAgent 配置、常量、类型定义
  */
 
-import type { RateLimitConfig } from '../rate-limiter.js';
-import { DEFAULT_CONTEXT_TOKENS } from '../compaction.js';
+import type { RateLimitConfig } from '@zhin.js/ai';
+import { DEFAULT_CONTEXT_TOKENS } from '@zhin.js/ai';
 
 export type ModelSizeHint = 'small' | 'medium' | 'large';
 
@@ -56,6 +56,14 @@ export const PERM_MAP: Record<string, number> = {
 
 export type OnChunkCallback = (chunk: string, full: string) => void;
 
+/** 上下文感知内置工具的关键词触发正则 */
+export const KEYWORD_TRIGGERS = {
+  chatHistory: /之前|上次|历史|回忆|聊过|记录|还记得|曾经/i,
+  userProfile: /偏好|设置|配置|档案|资料|时区|timezone|profile|喜好|我叫|叫我|记住我/i,
+  scheduleFollowUp: /提醒|定时|过一会|跟进|别忘|取消提醒|reminder|分钟后|小时后/i,
+  spawnTask: /后台|子任务|spawn|异步|background|并行|独立处理/i,
+} as const;
+
 export interface ZhinAgentConfig {
   persona?: string;
   maxIterations?: number;

package/src/zhin-agent/index.ts

@@ -18,21 +18,21 @@
 
 import { Logger } from '@zhin.js/core';
 import type { Tool, ToolContext, SkillFeature, AIProvider, AgentTool, ChatMessage, ContentPart } from '@zhin.js/core';
-import { createAgent } from '../agent.js';
-import { SessionManager, createMemorySessionManager } from '../session.js';
-import type { ContextManager } from '../context-manager.js';
-import { ConversationMemory } from '../conversation-memory.js';
-import type { OutputElement } from '../output.js';
-import { parseOutput } from '../output.js';
+import { createAgent } from '@zhin.js/ai';
+import { SessionManager, createMemorySessionManager } from '@zhin.js/ai';
+import type { ContextManager } from '@zhin.js/ai';
+import { ConversationMemory } from '@zhin.js/ai';
+import type { OutputElement } from '@zhin.js/ai';
+import { parseOutput } from '@zhin.js/ai';
 import { UserProfileStore } from '../user-profile.js';
-import { RateLimiter } from '../rate-limiter.js';
-import { detectTone } from '../tone-detector.js';
+import { RateLimiter } from '@zhin.js/ai';
+import { detectTone } from '@zhin.js/ai';
 import { FollowUpManager, type FollowUpSender } from '../follow-up.js';
 import { SubagentManager, type SubagentResultSender } from '../subagent.js';
 import {
   pruneHistoryForContext,
   DEFAULT_CONTEXT_TOKENS,
-} from '../compaction.js';
+} from '@zhin.js/ai';
 import { triggerAIHook, createAIHookEvent } from '../hooks.js';
 
 // ── Sub-modules ─────────────────────────────────────────────────────
@@ -40,6 +40,7 @@ import {
   type ZhinAgentConfig,
   type OnChunkCallback,
   DEFAULT_CONFIG,
+  KEYWORD_TRIGGERS,
 } from './config.js';
 import { applyExecPolicyToTools } from './exec-policy.js';
 import { collectRelevantTools } from './tool-collector.js';
@@ -62,6 +63,11 @@ export type { ZhinAgentConfig, OnChunkCallback } from './config.js';
 const logger = new Logger(null, 'ZhinAgent');
 const now = () => performance.now();
 
+/** Strip `<think>…</think>` blocks that some reasoning models embed in content. */
+function stripThinkBlocks(text: string): string {
+  return text.replace(/<think>[\s\S]*?<\/think>\s*/g, '').trim();
+}
+
 // ============================================================================
 // ZhinAgent
 // ============================================================================
@@ -212,16 +218,16 @@ export class ZhinAgent {
     });
 
     // Inject context-aware built-in tools on keyword match
-    if (/之前|上次|历史|回忆|聊过|记录|还记得|曾经/i.test(content)) {
+    if (KEYWORD_TRIGGERS.chatHistory.test(content)) {
       allTools.push(createChatHistoryTool(sessionId, this.memory));
     }
-    if (/偏好|设置|配置|档案|资料|时区|timezone|profile|喜好|我叫|叫我|记住我/i.test(content)) {
+    if (KEYWORD_TRIGGERS.userProfile.test(content)) {
       allTools.push(createUserProfileTool(userId, this.userProfiles));
     }
-    if (/提醒|定时|过一会|跟进|别忘|取消提醒|reminder|分钟后|小时后/i.test(content)) {
+    if (KEYWORD_TRIGGERS.scheduleFollowUp.test(content)) {
       allTools.push(createScheduleFollowUpTool(sessionId, context, this.followUps));
     }
-    if (this.subagentManager && /后台|子任务|spawn|异步|background|并行|独立处理/i.test(content)) {
+    if (this.subagentManager && KEYWORD_TRIGGERS.spawnTask.test(content)) {
       allTools.push(createSpawnTaskTool(context, this.subagentManager));
     }
 
@@ -352,7 +358,7 @@ ${preData ? `\nPre-fetched data:\n${preData}\n` : ''}`;
 
       const userMessageWithHistory = buildUserMessageWithHistory(historyMessages, content);
       const result = await agent.run(userMessageWithHistory, []);
-      reply = result.content || this.fallbackFormat(result.toolCalls);
+      reply = stripThinkBlocks(result.content) || this.fallbackFormat(result.toolCalls);
       logger.info(`[Agent 路径] 过滤=${filterMs}ms, 记忆=${memMs}ms, Agent=${(now() - tAgent).toFixed(0)}ms, 总=${(now() - t0).toFixed(0)}ms`);
     }
 
@@ -433,16 +439,25 @@ ${preData ? `\nPre-fetched data:\n${preData}\n` : ''}`;
     let reply = '';
     try {
       for await (const chunk of this.provider.chatStream({ model: visionModel, messages })) {
-        const delta = chunk.choices?.[0]?.delta?.content;
-        if (delta && typeof delta === 'string') {
-          reply += delta;
-          if (onChunk) onChunk(delta, reply);
+        const delta = chunk.choices?.[0]?.delta;
+        if (!delta) continue;
+        const text = typeof delta.content === 'string' ? delta.content : '';
+        if (text) {
+          reply += text;
+          if (onChunk) onChunk(text, reply);
         }
       }
+      reply = stripThinkBlocks(reply);
+      if (!reply) {
+        logger.warn('[processMultimodal] 流式响应内容为空，尝试非流式回退');
+        const response = await this.provider.chat({ model: visionModel, messages });
+        const msg = response.choices[0]?.message?.content;
+        reply = stripThinkBlocks(typeof msg === 'string' ? msg : '');
+      }
     } catch {
       const response = await this.provider.chat({ model: visionModel, messages });
       const msg = response.choices[0]?.message?.content;
-      reply = typeof msg === 'string' ? msg : '';
+      reply = stripThinkBlocks(typeof msg === 'string' ? msg : '');
     }
 
     if (!reply) reply = '抱歉，我无法理解这条消息。';
@@ -474,20 +489,27 @@ ${preData ? `\nPre-fetched data:\n${preData}\n` : ''}`;
     try {
       let result = '';
       for await (const chunk of this.provider.chatStream({ model, messages })) {
-        const delta = chunk.choices?.[0]?.delta?.content;
-        if (delta && typeof delta === 'string') {
-          result += delta;
-          if (onChunk) onChunk(delta, result);
+        const delta = chunk.choices?.[0]?.delta;
+        if (!delta) continue;
+        const text = typeof delta.content === 'string' ? delta.content : '';
+        if (text) {
+          result += text;
+          if (onChunk) onChunk(text, result);
         }
       }
-      return result;
+      result = stripThinkBlocks(result);
+      if (result) return result;
+      // Streaming returned empty content — fall back to non-streaming
+      logger.warn('[streamChat] 流式响应内容为空，尝试非流式回退');
     } catch {
-      const response = await this.provider.chat({ model, messages });
-      const msg = response.choices[0]?.message?.content;
-      const result = typeof msg === 'string' ? msg : '';
-      if (onChunk && result) onChunk(result, result);
-      return result;
+      // Stream failed — fall back to non-streaming
     }
+    const response = await this.provider.chat({ model, messages });
+    const msg = response.choices[0]?.message?.content;
+    let result = typeof msg === 'string' ? msg : '';
+    result = stripThinkBlocks(result);
+    if (onChunk && result) onChunk(result, result);
+    return result;
   }
 
   private async saveToSession(

package/src/zhin-agent/tool-collector.ts

@@ -5,7 +5,7 @@
 import { Logger } from '@zhin.js/core';
 import type { Tool, ToolContext, SkillFeature } from '@zhin.js/core';
 import type { AgentTool } from '@zhin.js/core';
-import { Agent } from '../agent.js';
+import { Agent } from '@zhin.js/ai';
 import type { ZhinAgentConfig } from './config.js';
 import { PERM_MAP } from './config.js';