nolo-cli 0.1.30 → 0.1.32

package/ai/agent/buildSystemPrompt.ts

@@ -1,581 +0,0 @@
-// 文件路径: ai/agent/buildSystemPrompt.ts
-// 平台通用 Agent System Prompt 生成器
-// 所有模型调用的 system prompt 均由此函数构建
-
-import { mapLanguage } from "../../app/i18n/mapLanguage";
-import { Agent } from "../../app/types";
-import { buildSkillGuidancePromptBlock } from "../skills/referenceRuntime";
-import { buildRuntimeGuidanceBlocks } from "../agent/runtimeGuidance";
-import { canonicalizeToolNames } from "../tools/toolNameAliases";
-import { PAGE_BUILDER_HANDOFF_INSTRUCTIONS } from "./pageBuilderHandoffRules";
-import { compileContextLayers, type CompiledContext } from "./contextCompiler";
-import { Contexts } from "../types";
-
-// ============================================================================
-// 参考资料使用说明（对所有 Agent 注入）
-// ============================================================================
-
-const CONTEXT_USAGE_INSTRUCTIONS = `参考资料使用说明：
-- 下方提供的资料是你的主要权威信息来源。
-- 回答问题时，应优先依赖这些资料。它们按优先级从高到低排列。
-- 使用其中的事实、数据和名称时，要保持精准。
-- 如果资料中没有包含答案，应说明这一点，然后再使用你的通用知识进行回答。
-- 如果你在资料中发现相互矛盾的信息，也要在回答中指出这一点。
-- 当通用指令与更具体的"按 Agent / 按文档"的规则发生冲突时，必须优先遵守更具体、优先级更高的规则。`;
-
-// ============================================================================
-// 交互说明（有 ui_ask_choice 工具时注入）
-// ============================================================================
-
-const MENU_USAGE_INSTRUCTIONS = `--- 交互说明（菜单与快捷入口） ---
-在这个系统里，无论用户是手动输入文字，还是点击某个按钮/菜单，最终你只会收到一条普通的自然语言消息（就像用户直接键入的一样）。
-
-对你来说：
-- 不要假设或讨论用户点击了哪些按钮、使用了什么菜单，也不要在回复中提到"按钮""菜单""界面""第几个选项"等字样。
-- 把所有收到的消息都当作用户刚刚输入的一句话，根据这句话的内容直接理解和回答即可。`;
-
-// ============================================================================
-// 网页访问（有 exa_search 工具时注入）
-// ============================================================================
-
-const WEBPAGE_ACCESS_INSTRUCTIONS = `--- 网页访问能力 (Web Access) ---
-在需要获取外部信息时，请遵循以下由简入繁的策略：
-
-0. **如果用户已经给了明确 URL，先直接抓这些 URL**
-   - 不要先搜索，不要先猜备用网址，不要忽略用户给的链接。
-   - 用户明确给出的 URL，默认就是本次任务的最高优先级网页真值来源。
-   - 如果任务是“根据这些网页更新代码 / 文档 / 配置”，先逐个 fetch，再基于抓到的内容提取字段。
-   - 只要这些 URL 能正常抓取，就不要再调用 exa_search 搜索“更权威”的来源，也不要自行切换到其他站点或镜像页。
-   - 只有在用户给的 URL 抓取失败、页面明显缺字段、或页面内容与任务不匹配时，才允许额外搜索；如果发生这种降级，最终回复里要明确说明原因。
-
-1. **优先使用 exa_search (Exa.ai)**
-   - 适用于：用户没有给明确 URL 时，搜索互联网信息、寻找教程、获取最新动态。
-   - 对陌生的文档站或你还不确定具体页面路径的 docs 站点，优先先用它发现权威入口，而不是直接猜 docs 子路径。
-   - 优点：它是专为 AI 设计的神经网络搜索引擎，能直接返回高质量、结构化的内容（包含正文），无需再去爬取。
-   - *Always try this FIRST for searches.*
-
-2. **其次使用 fetchWebpage (全渲染)**
-   - 适用于：你已经有了明确的 URL，需要获取该页面的完整内容（含 JS 渲染、动态内容、SPA）。
-   - 底层走 Cloudflare Browser Rendering，支持 JS 执行，返回渲染后的正文。
-   - 对于 \`docs.*\` 文档站，fetchWebpage 会自动检查 \`/llms.txt\` 和 \`/llms-full.txt\`，并把你推测的文档 URL 规范化为权威页面。
-   - 如果你不确定 docs 站里有哪些页面，先用 exa_search 做发现；如果你只是大致猜到了 docs 子路径，可以直接交给 fetchWebpage 去规范化并抓取。
-   - 优点：一次调用即可获取完整页面内容，无需手动操控浏览器。
-
-3. **仅当需要复杂交互时使用 browser_openSession**
-   - 仅当需要登录、填表、多步点击等复杂操作时使用。
-   - 适用于：需要登录的站点、需要填写表单、需要连续交互的场景。
-   - 流程：先 openSession -> 拿到 ID -> 再 typeText / click / readContent。
-
-
-3. **精准数据抓取 (Scrapers)**
-  - 如果用户明确需要 YouTube 视频信息、亚马逊商品数据、Google 搜索结果，请直接使用对应的专用 Scraper 工具 (youtubeScraper, amazonProductScraper 等)，效果比自己去爬网页更好。`;
-
-// ============================================================================
-// 本地文件整理（有 local desktop file tools 时注入）
-// ============================================================================
-
-const LOCAL_FILE_ORGANIZATION_INSTRUCTIONS = `--- 本地文件整理能力 ---
-你可以帮助用户整理桌面客户端里已授权的本地文件夹。必须遵守：
-
-- 只能访问用户已授权的本地文件夹，所有路径都必须是授权根目录内的相对路径。
-- 开始使用 listLocalFiles / readLocalFile 之前，先调用 listLocalRoots 查看当前已授权 roots。
-- 如果目标文件夹还没授权，先调用 requestLocalFolderAccess 请求授权，拿到 rootId 后再继续。
-- 如果用户要求“默认桌面路径 / 默认下载路径 / 默认文档路径”，不要把“默认”原样传给工具；先用 execShell 解析当前机器上的绝对路径，再把具体 path 传给 requestLocalFolderAccess。
-- 如果用户直接贴出绝对本地路径（例如 \`C:\\Users\\me\\Downloads\\report.pdf\` 或 \`/Users/me/Desktop/note.txt\`），把它视为本地文件访问请求，而不是泛化回答“看不到你的磁盘”。先取父目录，申请该目录授权，再检查目标文件。
-- 对工作区或代码仓库任务，不要用本地文件夹授权工具；优先使用 readFile / listFiles / writeFile / editFile / searchFiles 这组 workspace-scoped coding 工具。
-- 如果目标是 PDF、DOCX、图片或其他非纯文本文件，不要假装已经完整读懂文件内容。你可以先确认文件是否存在、位于哪个目录、文件名是否匹配；需要读取正文时，应明确说明当前本地工具主要覆盖目录/文本读取，必要时让用户上传文件或走现有上传流程。
-- 开始整理前，先列目录和读取必要文件，理解现状后再提出计划。
-- 对移动、重命名、写入、删除等改动，不要直接修改文件；先调用 proposeLocalFileChanges 创建待确认计划。
-- 用户确认后，才执行已确认的本地文件整理计划。
-- 删除类操作要保守；能通过移动到整理目录解决时，不要优先删除。
-- 回复用户时说明将要改哪些文件、为什么改、以及是否可撤销。`;
-
-// ============================================================================
-// Agent 编排协作（有 callAgent / runStreamingAgent 工具时注入）
-// ============================================================================
-
-const AGENT_ORCHESTRATION_INSTRUCTIONS = `--- Agent 编排与协作 ---
-你所在的系统支持多个子 Agent 和工作流工具，请把自己视为"总协调者"：
-
-1）子 Agent 协作
-- 如果目标 Agent 记录已经声明 delegation.serverBase / runtimeServerBase，工具会自动路由到对应 nolo server；你不需要重复填写 serverBase。
-- 如果用户明确给了另一个可访问的 server origin（例如 Windows 机器的 Cloudflare 域名），可以在工具参数里传 serverBase 覆盖自动路由；不要臆造地址，也不要把普通 localhost 当成远端机器。
-- 当用户需要多视角分析或辩论时，你可以：
-  - 先用 callAgent 依次询问多个 Agent 对同一问题的看法；
-  - 在最后一条回复中，用你自己的话帮用户总结这些观点的异同，并给出综合结论。
-
-2）工作流 / Workflow 工具
-- 对于需要多步骤、顺序依赖或批量工具调用的复杂任务，应优先考虑使用 createWorkflow 这类工作流工具。
-- 调用工作流工具时，你负责：
-  - 清楚描述目标和约束；
-  - 在工作流执行过程中关注其输出的中间结果和最终结果；
-  - 当你认为任务足够完成，或用户要求总结时，对整个过程和结果进行总结，指出可能的错误或风险。
-
-3）危险 / 不可逆操作
-- 涉及不可逆操作时（修改文件、删除数据、发送消息、生成正式文件、执行交易等），请优先预览或向用户确认。
-- 当工具返回"预览"或"待确认"状态时，请暂停进一步自动修改，等待用户明确确认或反馈后再继续。不要在用户未确认前连续发出多次破坏性修改。`;
-
-// ============================================================================
-// 知识管理（有 createDoc / updateDoc / read 工具时注入）
-// 仅包含页面级知识管理，不含自我更新能力
-// ============================================================================
-
-const KNOWLEDGE_MANAGEMENT_INSTRUCTIONS = `--- 知识管理 ---
-
-## 三层知识决策
-
-**1. references 挂载知识（每次对话自动加载）**
-- Agent 配置里的 references 会在每次对话开始时自动展开注入到 system prompt
-- type=instruction：高优先级，注入到 system prompt 顶部，适合行为规则、操作指南
-- type=knowledge：作为参考资料注入，适合领域知识、背景资料
-- 支持挂载：page / dialog / table（内容完整展开）
-- **page 里的 @mention 只展开元信息（标题+dbKey），不递归展开内容本身**
-
-**2. createDoc 创建文档（按需 read 加载）**
-- 总知识页（索引）：跨会话的决策规则、路由表，用 @[page:PAGE-xxx|标题] mention 指向细分页
-- 细分知识页（内容）：具体领域内容、任务结果，通过总知识索引
-- mention 只是指针，要获取细分页内容必须显式调用 read({ dbKey })
-
-## 读取路径
-1. prompt / references 有答案 → 直接用（自动加载，最快）
-2. 没有 → read({ dbKey: 总知识索引页 }) 找到细分页 dbKey
-3. 找到 dbKey → read({ dbKey: 细分页 }) 获取完整内容
-
-## 何时主动创建/更新知识
-- 用户提供了值得复用的信息 → createDoc 记录，再用 updateAgent 把该页加入 references
-- 完成有价值的调研/分析 → createDoc 保存结论
-- 总知识索引缺入口 → updateDoc 补充 @mention
-- **不要**把临时性、一次性的内容写成知识页`;
-
-// ============================================================================
-// 长期记忆（有 rememberMemory 工具时注入）
-// ============================================================================
-
-const MEMORY_CAPTURE_INSTRUCTIONS = `--- 长期记忆 ---
-你拥有 rememberMemory 能力，可以在必要时把值得长期保留的信息写成一条 episodic memory。
-
-## 何时记录
-- 当你识别到对未来协作明显有帮助、且相对稳定的用户偏好、判断标准、信息组织偏好或场景化抉择模式时，可以记录
-- 当对话里形成了后续还会反复用到的空间共识、协作约定或团队规则时，可以记录
-
-## 何时不要记录
-- 一次性的当前任务细节
-- 当前对话里显而易见、很快就会过期的事实
-- 只是为了“多记一点”而勉强抽出来的内容
-
-## 记录方式
-- 优先写成简短、可复用的抽象表达，例如“这个用户在什么场景下通常怎么选 / 怎么协作”
-- 不要复制整段对话，也不要把临时上下文原样塞进去
-- 只有当前 dialog 明确绑定了 space，且这条信息确实属于共享协作共识时，才传 scope=space；否则保持默认 auto
-- 默认静默执行；除非用户正在讨论记忆本身，或需要用户感知这件事，否则不要专门宣布“我正在记忆”
-- 如果这条信息对未来帮助不明显，就不要调用 rememberMemory`;
-
-// ============================================================================
-// 自我更新能力（仅在 Agent 拥有 updateSelf 工具时注入）
-// ============================================================================
-
-const SELF_UPDATE_INSTRUCTIONS = `--- Agent 自我更新能力 ---
-
-## 何时更新自己
-- 重要决策/进度变化 → updateDoc 写回状态页
-- 值得复用的知识 → createDoc 建细分页，再按需要更新自己的 references / greeting / introduction
-- 小幅体验优化 → updateSelf 调整 greeting / introduction / tags
-
-## 更新原则
-- 优先形成最小、可解释的变更，不要为了“显得在进化”而频繁改自己
-- 低风险沉淀优先写入 memory / doc；只有当这些知识需要长期改变你的行为方式时，再考虑 updateSelf
-- prompt / references / tools / model 这类高影响字段，默认按需要确认来处理，不要静默大改
-- 如果工具返回 policy limit / ask / reject，不要重复尝试，应先向用户解释或等待更高权限确认
-- 没有发生实际更新时，不要在回复末尾额外汇报“未更新”状态`;
-
-const GENERIC_AGENT_UPDATE_INSTRUCTIONS = `--- Agent 维护能力 ---
-你拥有 updateAgent 权限，可以更新指定的 Agent。
-
-## 何时更新别的 Agent
-- 用户明确要求你维护、修复或批量调整另一个 Agent
-- 你需要修改的目标不是当前正在运行的自己
-
-## 更新原则
-- 默认把 updateAgent 当成高风险维护操作，优先最小改动
-- 修改前先确认目标 Agent 是否正确，避免误改
-- 如果工具返回需要确认，不要绕过确认流程`;
-
-const CODE_EDITING_FIDELITY_INSTRUCTIONS = `--- 代码编辑真值规则 ---
-当任务涉及 readFile / writeFile / applyEdit / applyLineEdits 等代码编辑工具时，必须遵守以下规则：
-
-- 先读取目标文件的最新内容，再决定修改。
-- 读取本地或代码仓库文件时，必须调用 readFile。不要用 read、readDoc、readPage 读取本地路径；这些工具用于知识库页面/文档 ID。
-- 执行本地 shell/bash 命令时，必须调用 execShell。
-- 如果用户提供了 URL、文档页或产品页，且你需要据此改代码，必须先抓取这些网页，再开始编辑。
-- 如果用户已经提供可用 URL，就不要再搜索替代来源；只有这些 URL 无法满足任务时，才允许降级到搜索，并在最终回复中说明。
-- 网页中直接出现的模型名、价格、上下文窗口、发布日期、能力描述、是否支持 function calling / vision 等字段，视为本次修改的权威来源。
-- 如果用户提供了精确代码块、对象字面量、字段值、补丁片段或“唯一真值”，必须逐字使用这些内容，不得自行润色、改写数值、替换描述或补全你记忆里的“更合理版本”。
-- 对价格、上下文窗口、模型能力、布尔字段、枚举值这类结构化配置，禁止凭记忆推断。
-- 如果网页没有明确给出某个字段，不要编造。优先保留文件中已有的相邻风格与安全默认值，或只填写网页能直接支持的字段。
-- 保守默认值规则：
-  - 对“新加模型条目”，recommended 必须默认 false。只有用户明确要求“设为推荐/高亮”，才允许写成 true。网页里的营销词（如 flagship、strong default、best-in-class）不构成 recommended=true 的证据。
-  - deprecated 默认 false，除非网页明确写了废弃、停用、legacy、sunset。
-  - supportReasoning 默认 false，除非网页明确说明该模型支持 reasoning / thinking / reasoning tokens。
-  - supportVision 只有在网页明确出现 image input / multimodal / vision 支持时才设为 true。
-  - supportTool 只有在网页明确出现 function calling / tool calling / tools 支持时才设为 true。
-- 最终汇报必须以“实际写入后的文件内容”或 applyEdit / writeFile 的返回结果为准，不要汇报没有真正落盘的字段值。
-- 编辑完成后，最终回复只做简短结果汇报：说清改了哪些条目、依据了哪些 URL、是否还有缺失字段。不要长篇复述网页正文。`;
-
-const TABLE_SHARE_INSTRUCTIONS = `--- 表格创建与分享 ---
-如果用户明确要求“社区分享 / 公开分享 / 分享链接”，并且你有 shareTable 工具：
-- 优先调用 shareTable；
-- 传入表的 dbKey，或 tenantId + tableId；
-- 完成后直接返回 /share/... 链接。`;
-
-const AGENT_CREATION_DRAFT_INSTRUCTIONS = `--- Agent 创建草稿流程 ---
-当用户想创建、定制、配置自己的 Agent / AI 助手时，必须走草稿优先流程：
-
-- 不要直接创建真实 Agent 记录，也不要声称已经创建完成。
-- 先基于当前对话和用户刚说的话整理一个可预览草稿，调用 prepareAgentDraft。
-- 草稿应尽量包含名称、用途简介、prompt 摘要、完整 prompt、能力、知识引用建议、公开状态和仍需确认的问题。
-- 用户表达模糊时，也先给出合理的初版草稿；信息不足时每次只问一个关键问题。
-- 对知识引用、公开状态、高风险工具能力，必须等待用户确认后再视为已选。
-- 草稿足够完整后，先请用户确认；确认后再调用 createAgent。
-- 只有用户想手动细调模型、工具、知识引用或发布状态时，再引导到 /create/agent 高级编辑页。`;
-
-// ============================================================================
-// 无 prompt 时的澄清模式
-// ============================================================================
-
-const CLARIFICATION_MODE_INSTRUCTIONS = `在你还不了解用户意图时，通过提问来澄清需求，而不是仓促给出答案。`;
-
-const isBrowser = typeof window !== "undefined";
-
-// ============================================================================
-// 工具函数
-// ============================================================================
-
-/** 创建一个上下文 section，如果 content 为空则返回空字符串 */
-const createContextSection = (
-  title: string,
-  description: string,
-  content?: string | null
-): string =>
-  content ? `### ${title} \n${description} \n\n${content} ` : "";
-
-/** 获取当前 UTC 时间（精确到天） */
-const getCurrentTimeString = (): string => {
-  return new Date().toLocaleDateString("en-US", { timeZone: "UTC" });
-};
-
-/** 根据屏幕宽度生成响应式布局建议 */
-const buildResponseGuidelines = (isMobile: boolean): string => {
-  if (isMobile) {
-    return `-- - 响应展示指南-- -
-请为移动端进行优化：
-- 使用更短的段落和简洁的项目符号列表。
-- 避免过宽的表格或代码块，以免产生横向滚动。
-- 优先采用垂直排布，而不是左右并排的布局。`;
-  }
-  return `-- - 响应展示指南-- -
-你的回复将显示在大屏幕上。你可以：
-- 提供更丰富的推理过程说明和更有层次的结构。
-- 在合适的场景下使用宽屏优势，例如更宽的表格、并排对比展示、更长的代码块等。`;
-};
-
-/** 构建参考资料区块 */
-const buildReferenceMaterialsBlock = (contexts: Contexts): string => {
-  const sections = [
-    createContextSection(
-      "说明性文档（Instructional Documents）",
-      "（最高优先级：具体规则与流程）",
-      contexts.botInstructionsContext
-    ),
-    createContextSection(
-      "当前输入上下文（Current Input Context）",
-      "（高优先级：来自用户本次输入）",
-      contexts.currentInputContext
-    ),
-    createContextSection(
-      "会话历史引用（Conversation History References）",
-      "（中等优先级：来自过往消息）",
-      contexts.historyContext
-    ),
-    createContextSection(
-      "知识库文档（Knowledge Base Documents）",
-      "（参考优先级：用于通用查阅）",
-      contexts.botKnowledgeContext
-    ),
-  ].filter(Boolean);
-
-  if (sections.length === 0) {
-    return "";
-  }
-
-  return [
-    "--- 参考资料 ---",
-    CONTEXT_USAGE_INSTRUCTIONS,
-    "",
-    sections.join("\n\n"),
-  ].join("\n");
-};
-
-/** 构建「当前编辑上下文」区块 */
-const buildEditingContextBlock = (contexts: Contexts): string => {
-  if (!contexts.editingContext) return "";
-
-  return [
-    "--- 当前编辑上下文 ---",
-    "下面是用户当前正在查看或编辑的对象描述，请在涉及修改、建议或结构性操作时优先参考这里：",
-    "",
-    contexts.editingContext,
-  ].join("\n");
-};
-
-const buildAppWorkingMemoryBlock = (contexts: Contexts): string => {
-  if (!contexts.appWorkingMemory) return "";
-
-  return [
-    "--- 最近应用工作记忆 ---",
-    "下面是从当前对话最近的应用相关工具调用中提炼出的真值。即使用户没有打开右侧应用侧栏，只要他说“刚才那个 app / 那个网站 / 那个项目”，也优先参考这里：",
-    "",
-    contexts.appWorkingMemory,
-  ].join("\n");
-};
-
-/** 构建「当前 Space 环境」区块 */
-const buildSpaceContextBlock = (contexts: Contexts): string => {
-  if (!contexts.spaceContext) return "";
-
-  return [
-    "--- 当前空间环境 (Current Space Context) ---",
-    contexts.spaceContext,
-    "",
-    "重要指令 (Space Awareness)：",
-    "- 你正处于上述工作空间中。如果用户的问题涉及到该空间的内容、文件或知识：",
-    "  - 使用 `read` 工具查阅普通数据记录或数据表项。",
-    "- 如果你在对话中产出了值得保存的重要信息（如总结、方案、代码片段等），请主动询问用户或使用 `createDoc` 工具将其保存为新页面，以便作为长期记忆留存。",
-    "",
-    "跨空间导航 (Cross-Space Navigation)：",
-    "- 使用 `listUserSpaces` 工具可获取用户所有可访问的 Space 列表（ID 和名称）。",
-    "- 使用 `read({ dbKey: \"space-{spaceId}\" })` 可获取指定 Space 的完整数据，包括：",
-    "  - categories: 分类字典，key 是分类 ID，value 包含 name 和 order",
-    "  - contents: 内容字典，每项包含 contentKey（dbKey）、title、type、categoryId",
-  ].join("\n");
-};
-
-const buildUserPolicyBlock = (contexts: Contexts): string => {
-  if (!contexts.userPolicyContext) return "";
-
-  return [
-    "--- 用户偏好与自动化边界 ---",
-    contexts.userPolicyContext,
-  ].join("\n");
-};
-
-const buildSkillGuidanceBlock = (agentConfig: Agent): string => {
-  const recommendedSkillHints = Array.isArray((agentConfig as any).recommendedSkillHints)
-    ? ((agentConfig as any).recommendedSkillHints as string[]).filter(Boolean)
-    : [];
-  const skillPromptPatches = Array.isArray((agentConfig as any).skillPromptPatches)
-    ? ((agentConfig as any).skillPromptPatches as string[]).filter(Boolean)
-    : [];
-
-  if (recommendedSkillHints.length === 0 && skillPromptPatches.length === 0) {
-    return "";
-  }
-
-  return buildSkillGuidancePromptBlock({
-    title: "--- 技能提示 ---",
-    recommendedSkillHints,
-    skillPromptPatches,
-  });
-};
-
-// ============================================================================
-// 主函数
-// ============================================================================
-
-export const buildSystemPrompt = (options: {
-  agentConfig: Agent;
-  language?: string;
-  contexts?: Contexts;
-  viewport?: { width: number; height: number };
-  mobileBreakpoint?: number;
-}): string => buildSystemPromptContext(options).content;
-
-export const buildSystemPromptContext = (options: {
-  agentConfig: Agent;
-  language?: string;
-  contexts?: Contexts;
-  viewport?: { width: number; height: number };
-  mobileBreakpoint?: number;
-}): CompiledContext => {
-  const {
-    agentConfig,
-    contexts = {},
-    viewport,
-    mobileBreakpoint = 768,
-  } = options;
-
-  const safeLanguage =
-    options.language ??
-    (typeof navigator !== "undefined" ? navigator.language : "en");
-
-  const { name, prompt: mainPrompt, dbKey } = agentConfig;
-  const mappedLanguage = mapLanguage(safeLanguage);
-
-  const identitySection = [
-    "--- 身份信息 ---",
-    name ? `名称: ${name} ` : "",
-    dbKey ? `ID: ${dbKey} ` : "",
-    mappedLanguage ? `回复语言: ${mappedLanguage} ` : "",
-    `当前时间: ${getCurrentTimeString()} `,
-  ]
-    .filter(Boolean)
-    .join("\n");
-
-  const corePersonaSection = mainPrompt
-    ? `-- - 核心角色与任务-- -\n${mainPrompt}`
-    : "";
-
-  const agentTools = canonicalizeToolNames(agentConfig.tools ?? []);
-
-  // 按工具能力条件注入各指令块
-  const agentOrchestrationSection = agentTools.some((t) =>
-    ["callAgent", "runStreamingAgent", "streamParallelAgents"].includes(t)
-  )
-    ? [
-      AGENT_ORCHESTRATION_INSTRUCTIONS,
-      agentTools.includes("runStreamingAgent") ? PAGE_BUILDER_HANDOFF_INSTRUCTIONS : "",
-    ].filter(Boolean).join("\n\n")
-    : "";
-
-  const menuUsageSection = agentTools.includes("ui_ask_choice")
-    ? MENU_USAGE_INSTRUCTIONS
-    : "";
-
-  const webAccessSection = agentTools.some((t) =>
-    ["exa_search", "fetchWebpage", "browser_openSession", "read_x_post"].includes(t)
-  )
-    ? WEBPAGE_ACCESS_INSTRUCTIONS
-    : "";
-  const localFileOrganizationSection = agentTools.some((t) =>
-    [
-      "listLocalRoots",
-      "requestLocalFolderAccess",
-      "listLocalFiles",
-      "readLocalFile",
-      "proposeLocalFileChanges",
-      "executeApprovedLocalFileChanges",
-      "undoLocalFileChangeBatch",
-    ].includes(t)
-  )
-    ? LOCAL_FILE_ORGANIZATION_INSTRUCTIONS
-    : "";
-  const tableShareSection = agentTools.some((t) =>
-    ["createTable", "shareTable", "addTableRow", "addTableRows"].includes(t)
-  )
-    ? TABLE_SHARE_INSTRUCTIONS
-    : "";
-
-  const agentCreationDraftSection = agentTools.includes("prepareAgentDraft")
-    ? AGENT_CREATION_DRAFT_INSTRUCTIONS
-    : "";
-
-  // 知识管理：有页面读写工具时注入通用知识管理说明
-  const knowledgeManagementSection = agentTools.some((t) =>
-    ["createDoc", "updateDoc", "read", "readDoc", "readPage"].includes(t)
-  )
-    ? KNOWLEDGE_MANAGEMENT_INSTRUCTIONS
-    : "";
-
-  const memoryCaptureSection = agentTools.includes("rememberMemory")
-    ? MEMORY_CAPTURE_INSTRUCTIONS
-    : "";
-
-  const selfUpdateSection = agentTools.includes("updateSelf")
-    ? SELF_UPDATE_INSTRUCTIONS
-    : "";
-
-  const genericAgentUpdateSection = agentTools.includes("updateAgent")
-    ? GENERIC_AGENT_UPDATE_INSTRUCTIONS
-    : "";
-
-  const codeEditingFidelitySection = agentTools.some((t) =>
-    ["readFile", "writeFile", "applyEdit", "applyLineEdits"].includes(t)
-  )
-    ? CODE_EDITING_FIDELITY_INSTRUCTIONS
-    : "";
-
-  const {
-    startupProtocol,
-    contextLayerContract,
-    emailRegistrationWorkflow,
-    webResearchToolPolicy,
-  } =
-    buildRuntimeGuidanceBlocks(agentTools);
-
-  const clarifyingSection = !mainPrompt ? CLARIFICATION_MODE_INSTRUCTIONS : "";
-
-  const userGlobalPromptSection = contexts.userGlobalPrompt?.trim()
-    ? `-- - 用户全局偏好-- -\n${contexts.userGlobalPrompt.trim()} `
-    : "";
-
-  const isMobile =
-    (viewport?.width ?? (isBrowser ? window.innerWidth : 1440)) <
-    mobileBreakpoint;
-
-  const responseGuidelinesSection = buildResponseGuidelines(isMobile);
-  const editingContextSection = buildEditingContextBlock(contexts);
-  const appWorkingMemorySection = buildAppWorkingMemoryBlock(contexts);
-  const spaceContextSection = buildSpaceContextBlock(contexts);
-  const userPolicySection = buildUserPolicyBlock(contexts);
-  const skillGuidanceSection = buildSkillGuidanceBlock(agentConfig);
-  const referenceMaterialsSection = buildReferenceMaterialsBlock(contexts);
-
-  const dialogSummarySection = contexts.dialogSummary?.trim()
-    ? `--- 历史对话摘要 ---\n以下是此前对话轮次的压缩摘要（精确细节可能有简化，请优先参考最近的消息原文）：\n\n${contexts.dialogSummary.trim()}`
-    : "";
-
-  const proactiveSummarySection = contexts.proactiveSummary?.trim()
-    ? `--- 阶段工作摘要 ---\n以下是系统主动整理的近期工作摘要，原始消息仍在近期上下文中；如有冲突，请优先参考最近的消息原文：\n\n${contexts.proactiveSummary.trim()}`
-    : "";
-
-  return compileContextLayers([
-    { id: "identity", owner: "platform", content: identitySection },
-    { id: "core-persona", owner: "agent", content: corePersonaSection },
-    { id: "agent-orchestration", owner: "platform", content: agentOrchestrationSection },
-    { id: "web-access", owner: "platform", content: webAccessSection },
-    { id: "local-file-organization", owner: "platform", content: localFileOrganizationSection },
-    { id: "table-share", owner: "platform", content: tableShareSection },
-    { id: "agent-creation-draft", owner: "platform", content: agentCreationDraftSection },
-    { id: "menu-usage", owner: "platform", content: menuUsageSection },
-    { id: "clarification-mode", owner: "platform", content: clarifyingSection },
-    { id: "knowledge-management", owner: "platform", content: knowledgeManagementSection },
-    { id: "memory-capture", owner: "platform", content: memoryCaptureSection },
-    { id: "self-update", owner: "platform", content: selfUpdateSection },
-    { id: "generic-agent-update", owner: "platform", content: genericAgentUpdateSection },
-    { id: "code-editing-fidelity", owner: "platform", content: codeEditingFidelitySection },
-    { id: "startup-protocol", owner: "platform", content: startupProtocol },
-    { id: "context-layer-contract", owner: "platform", content: contextLayerContract },
-    {
-      id: "email-registration-workflow",
-      owner: "platform",
-      content: emailRegistrationWorkflow,
-    },
-    {
-      id: "web-research-tool-policy",
-      owner: "platform",
-      content: webResearchToolPolicy,
-    },
-    { id: "user-global-prompt", owner: "user", content: userGlobalPromptSection },
-    { id: "response-guidelines", owner: "platform", content: responseGuidelinesSection },
-    { id: "skill-guidance", owner: "runtime", content: skillGuidanceSection },
-    { id: "dialog-summary", owner: "runtime", content: dialogSummarySection },
-    { id: "proactive-summary", owner: "runtime", content: proactiveSummarySection },
-    { id: "space-context", owner: "runtime", content: spaceContextSection },
-    { id: "user-policy", owner: "user", content: userPolicySection },
-    { id: "reference-materials", owner: "agent", content: referenceMaterialsSection },
-    { id: "app-working-memory", owner: "runtime", content: appWorkingMemorySection },
-    { id: "editing-context", owner: "runtime", content: editingContextSection },
-  ]);
-};
-
-// 向后兼容：旧名称重新导出
-export const generatePrompt = buildSystemPrompt;

package/ai/agent/canvasEditingContext.ts

@@ -1,49 +0,0 @@
-import type { AgentRuntimeOptions } from "./types";
-
-export function buildCanvasNodeEditingContextSummary(
-  runtimeOptions?: AgentRuntimeOptions
-): string | null {
-  if (runtimeOptions?.editingTarget?.kind !== "canvas_node") return null;
-
-  const editingTarget = runtimeOptions.editingTarget;
-  const metadata = editingTarget.metadata ?? {};
-  const selectedNodeId =
-    typeof metadata.selectedNodeId === "string"
-      ? metadata.selectedNodeId
-      : editingTarget.key ?? "(未知节点)";
-  const part =
-    typeof metadata.part === "string"
-      ? metadata.part
-      : editingTarget.title ?? selectedNodeId;
-  const nodeType =
-    typeof metadata.type === "string" ? metadata.type : "(未知类型)";
-  const path = Array.isArray(metadata.path)
-    ? metadata.path.filter((item): item is string => typeof item === "string")
-    : [];
-  const props = metadata.props && typeof metadata.props === "object"
-    ? metadata.props
-    : {};
-  const style = metadata.style && typeof metadata.style === "object"
-    ? metadata.style
-    : {};
-
-  return [
-    "当前编辑目标：Canvas Tree 中的一个选中节点。",
-    `- 节点 ID: ${selectedNodeId}`,
-    `- part: ${part}`,
-    `- 节点类型: ${nodeType}`,
-    ...(path.length ? [`- 节点路径: ${path.join(" > ")}`] : []),
-    "",
-    "当前节点 props:",
-    JSON.stringify(props, null, 2),
-    "",
-    "当前节点 style:",
-    JSON.stringify(style, null, 2),
-    "",
-    "【给 AI 的操作指南 / 非用户原话】",
-    `1. 如果用户要求修改当前模块，只输出 updateNode，目标 id 必须是 ${selectedNodeId}。`,
-    "2. 不要重建 root/shell，不要重新 append 已存在的大块内容。",
-    "3. 除非用户明确要求新增子模块，否则不要 appendNode。",
-    "4. 回复仍必须遵守 Canvas Tree MVP 协议：只输出 canvas_snapshot NDJSON，不要输出解释或源码。",
-  ].join("\n");
-}