静态 动态 prompt

Author: linyuan.yang

packages/channel.xiaoai/tsconfig.tsbuildinfo

@@ -1,7 +1,5 @@
 ---
 vars:
-  currentTime: 当前时间 (如 2026/1/1 12:00:00)
   extraInfo: 渠道注入的额外信息 (XML 片段，可为空)
 ---
-<current-time>{currentTime}</current-time>
 {extraInfo}

packages/desktop/src-tauri/icons/icon.icns

@@ -63,7 +63,6 @@ export class AgentRunner {
         if (!threadId.trim())  throw new Error("threadId not specified");
 
         const signal = sessionManager.getOrCreate(threadId).signal;
-        const now = new Date();
         const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
         const assetsDir = config.getConfigPath('assets', true);
         const httpUrl = config.getHttpUrl();
@@ -83,10 +82,7 @@ export class AgentRunner {
 
         /** 动态 system prompts（每次请求变化，不可缓存） */
         const dynamicPrompts: string[] = [
-            loadPrompt('system/dynamic_context.txt', {
-                currentTime: now.toLocaleString(undefined, { timeZone: timezone, hour12: false }),
-                extraInfo,
-            }),
+            ...(extraInfo?.trim() ? [loadPrompt('system/dynamic_context.txt', { extraInfo })] : []),
         ];
 
         const container = new ServiceContainer();

packages/sbot/prompts/system/dynamic_context.txt

@@ -8,6 +8,7 @@ export enum BuiltinProvider {
     WebFetch = 'builtin_webfetch',
     Archive = 'builtin_archive',
     Sleep = 'builtin_sleep',
+    Time = 'builtin_time',
 
     Playwright = 'builtin_playwright',
     ChromeDevTools = 'builtin_chrome-devtools-mcp',
@@ -39,6 +40,10 @@ export function initGlobalAgentToolService() {
         const { createSleepTool } = await import("../Tools/Sleep/index.js");
         return [createSleepTool()];
     }, '等待/暂停执行');
+    globalAgentToolService.registerToolFactory(BuiltinProvider.Time, async () => {
+        const { createTimeTool } = await import("../Tools/Time/index.js");
+        return [createTimeTool()];
+    }, '获取当前时间');
     globalAgentToolService.registerMcpServers({
         [BuiltinProvider.Playwright]: {
             "command": "npx",
@@ -78,6 +83,7 @@ export async function refreshBuiltinTools() {
         BuiltinProvider.WebFetch,
         BuiltinProvider.Archive,
         BuiltinProvider.Sleep,
+        BuiltinProvider.Time,
         // BuiltinProvider.GameData,
     );
 }

packages/sbot/src/Agent/AgentRunner.ts

@@ -0,0 +1,18 @@
+import { DynamicStructuredTool, type StructuredToolInterface } from '@langchain/core/tools';
+import { z } from 'zod';
+import { createTextContent, createSuccessResult, type MCPToolResult } from 'scorpio.ai';
+
+export const TIME_TOOL_NAME = 'get_current_time' as const;
+
+export function createTimeTool(): StructuredToolInterface {
+    return new DynamicStructuredTool({
+        name: TIME_TOOL_NAME,
+        description: 'Get the current date and time with timezone information.',
+        schema: z.object({}) as any,
+        func: async (): Promise<MCPToolResult> => {
+            const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+            const now = new Date().toLocaleString(undefined, { timeZone: timezone, hour12: false });
+            return createSuccessResult(createTextContent(`${now} (${timezone})`));
+        },
+    });
+}

packages/sbot/src/Agent/GlobalAgentToolService.ts

@@ -43,13 +43,18 @@ export class AnthropicModelService implements IModelService {
     const input = typeof prompt === 'string' ? prompt : this.applyCache(toBaseMessages(prompt));
     const result = await m.invoke(input, {
       ...(options?.signal && { signal: options.signal }),
-      ...(this.cacheControl && { cache_control: this.cacheControl }),
     });
     return toChatMessage(result);
   }
 
   bindTools(tools: any[]): void {
-    this.boundModel = this.model!.bindTools(tools);
+    if (this.cacheControl && tools.length > 0) {
+      const formatted = (this.model! as any).formatStructuredToolToAnthropic(tools);
+      formatted[formatted.length - 1].cache_control = this.cacheControl;
+      this.boundModel = (this.model! as any).withConfig({ tools: formatted });
+    } else {
+      this.boundModel = this.model!.bindTools(tools);
+    }
   }
 
   async invokeStructured<T = any>(schema: any, prompt: string | ChatMessage[], options?: { signal?: AbortSignal }): Promise<T> {
@@ -62,7 +67,6 @@ export class AnthropicModelService implements IModelService {
     const input = typeof messages === 'string' ? messages : this.applyCache(toBaseMessages(messages));
     const lcStream = await m.stream(input, {
       ...(options?.signal && { signal: options.signal }),
-      ...(this.cacheControl && { cache_control: this.cacheControl }),
     });
     return (async function* () {
       let accumulated: AIMessageChunk | undefined;
@@ -80,24 +84,33 @@ export class AnthropicModelService implements IModelService {
   }
 
   private applyCache(messages: BaseMessage[]): BaseMessage[] {
-    if (!this.cacheControl) return messages;
+    if (!this.cacheControl || messages.length === 0) return messages;
 
+    // breakpoint 1: system message (last block) — covers static + dynamic as a whole
+    // system is built once per stream() call, so within a ReAct loop it's always identical
     for (const msg of messages) {
       if (msg instanceof SystemMessage) {
-        this.addCacheMarker(msg);
+        this.addCacheMarker(msg, 'last');
         break;
       }
     }
 
+    // breakpoint 2: conversation history tail — next call reuses the entire prefix
+    const last = messages[messages.length - 1];
+    if (!(last instanceof SystemMessage)) {
+      this.addCacheMarker(last, 'first');
+    }
+
     return messages;
   }
 
-  private addCacheMarker(message: BaseMessage): void {
+  private addCacheMarker(message: BaseMessage, position: 'first' | 'last' = 'first'): void {
     const content = message.content;
     if (typeof content === 'string') {
       message.content = [{ type: "text", text: content, cache_control: this.cacheControl }];
     } else if (Array.isArray(content) && content.length > 0) {
-      content[0] = { ...content[0], cache_control: this.cacheControl };
+      const idx = position === 'last' ? content.length - 1 : 0;
+      content[idx] = { ...content[idx], cache_control: this.cacheControl };
     }
   }
 }