nolo-cli 0.1.30 → 0.1.32

package/ai/agent/_executeModel.ts

@@ -1,144 +0,0 @@
-import { RootState } from "../../app/store";
-import { Agent, Message } from "../../app/types";
-import { selectCurrentDialogConfig } from "../../chat/dialog/dialogSlice";
-import { read } from "../../database/dbSlice";
-import { fetchAgentContexts } from "../agent/fetchAgentContexts";
-import { filterAndCleanMessages } from "../../integrations/openai/filterAndCleanMessages";
-import { selectAllMsgs } from "../../chat/messages/messageSlice";
-import { generateRequestBody } from "../llm/generateRequestBody";
-import { getApiEndpoint } from "../llm/providers";
-import { selectCurrentServer } from "../../app/settings/settingSlice";
-import { selectCurrentToken } from "../../auth/authSlice";
-import { applyChatCompletionsStreamMode } from "../../integrations/openai/chatCompletionStreamMode";
-
-import { sendOpenAICompletionsRequest } from "../chat/sendOpenAICompletionsRequest";
-import { performFetchRequest } from "../chat/fetchUtils";
-import { updateTokensAction } from "../../chat/dialog/actions/updateTokensAction";
-import { extractCustomId } from "../../core/prefix";
-
-export const _executeModel = async (
-  options: {
-    isStreaming: boolean;
-    withAgentContext: boolean;
-    withChatHistory: boolean;
-    agentConfigOverrides?: Record<string, any>;
-  },
-  args: {
-    llmConfig?: Partial<Agent> & Pick<Agent, "provider" | "model">;
-    agentKey?: string;
-    agentConfig?: Partial<Agent> & Pick<Agent, "provider" | "model">;
-    content: any;
-    parentMessageId?: string;
-    billingDialogKey?: string;
-  },
-  thunkApi: any
-) => {
-  const { isStreaming, withAgentContext, withChatHistory, agentConfigOverrides } = options;
-  const { getState, dispatch, rejectWithValue } = thunkApi;
-  const { content } = args;
-  const state = getState() as RootState;
-
-  let agentConfig: Partial<Agent> & Pick<Agent, "provider" | "model">;
-  if (args.llmConfig) {
-    agentConfig = args.llmConfig;
-  } else if (args.agentConfig) {
-    agentConfig = args.agentConfig;
-  } else {
-    const agentKey = args.agentKey || selectCurrentDialogConfig(state)?.cybots?.[0];
-    if (!agentKey) {
-      const msg = "Model execution failed: No llmConfig, agentConfig, or agentKey provided.";
-      console.error(msg);
-      return rejectWithValue(msg);
-    }
-    try {
-      agentConfig = await dispatch(read({ dbKey: agentKey })).unwrap();
-    } catch (error: any) {
-      console.error(`_executeModel failed to load agent [${agentKey}]`, error);
-      return rejectWithValue(error.message);
-    }
-  }
-
-  try {
-    const resolvedConfig = agentConfigOverrides
-      ? { ...agentConfig, ...agentConfigOverrides }
-      : agentConfig;
-    const agentContexts = withAgentContext
-      ? await fetchAgentContexts(resolvedConfig.references, dispatch)
-      : {};
-
-    let messages: Message[];
-    if (withChatHistory) {
-      messages = filterAndCleanMessages(selectAllMsgs(state));
-      messages.push({ role: "user", content: args.content });
-    } else {
-      messages = [{ role: "user", content: args.content }];
-    }
-
-    const requestBody = generateRequestBody({
-      agentConfig: resolvedConfig,
-      messages,
-      userInput: content,
-      contexts: agentContexts,
-    });
-    const bodyData = applyChatCompletionsStreamMode(requestBody, isStreaming);
-
-    if (isStreaming) {
-      await sendOpenAICompletionsRequest({
-        bodyData,
-        agentConfig: resolvedConfig,
-        thunkApi,
-        dialogKey: selectCurrentDialogConfig(state)?.dbKey,
-        parentMessageId: args.parentMessageId,
-      });
-    } else {
-      const response = await performFetchRequest({
-        agentConfig: resolvedConfig,
-        api: getApiEndpoint(resolvedConfig),
-        bodyData,
-        currentServer: selectCurrentServer(state),
-        token: selectCurrentToken(state),
-      });
-      if (!response.ok) {
-        let message = `Model request failed with HTTP ${response.status}`;
-        try {
-          const errorBody = await response.json();
-          const upstreamMessage =
-            typeof errorBody?.error?.message === "string"
-              ? errorBody.error.message
-              : typeof errorBody?.message === "string"
-                ? errorBody.message
-                : "";
-          if (upstreamMessage.trim()) message = upstreamMessage.trim();
-        } catch {
-          // Keep the status-based message when the response body is not JSON.
-        }
-        throw new Error(message);
-      }
-      const result = await response.json();
-      const content = result?.choices?.[0]?.message?.content;
-      if (typeof content !== "string") {
-        const upstreamMessage =
-          typeof result?.error?.message === "string" ? result.error.message : "";
-        throw new Error(
-          upstreamMessage.trim() ||
-          "Model response missing choices[0].message.content"
-        );
-      }
-      if (args.billingDialogKey && result?.usage) {
-        await updateTokensAction(
-          {
-            dialogId: extractCustomId(args.billingDialogKey),
-            dialogKey: args.billingDialogKey,
-            usage: result.usage,
-            agentConfig: resolvedConfig,
-          },
-          thunkApi
-        );
-      }
-      return content;
-    }
-  } catch (error: any) {
-    console.error(`_executeModel failed`, error);
-    return rejectWithValue(error.message);
-  }
-};

package/ai/agent/appWorkingMemory.ts

@@ -1,126 +0,0 @@
-import type { Message } from "../../chat/messages/types";
-import type { ToolRun } from "../tools/toolRunSlice";
-
-const APP_TOOL_NAMES = new Set([
-  "appList",
-  "appRead",
-  "appDeploy",
-  "appPreflight",
-  "appDelete",
-]);
-
-const contentToText = (content: Message["content"] | undefined): string => {
-  if (!content) return "";
-  if (typeof content === "string") return content;
-  if (Array.isArray(content)) {
-    return content
-      .map((part) => ("text" in part ? part.text ?? "" : ""))
-      .join("\n");
-  }
-  return "";
-};
-
-const parseAppListEntries = (text: string): string[] =>
-  text
-    .split("\n")
-    .map((line) => line.trim())
-    .filter((line) => line.startsWith("- **") && line.includes("(appId:"));
-
-export const buildRecentAppToolMemory = (
-  messages: Message[],
-  toolRuns: ToolRun[],
-): string | null => {
-  const messageById = new Map(messages.map((msg) => [msg.id, msg]));
-  const recentRuns = [...toolRuns]
-    .filter((run) => APP_TOOL_NAMES.has(run.toolName))
-    .sort((a, b) => (b.startedAt ?? 0) - (a.startedAt ?? 0))
-    .slice(0, 8);
-
-  if (recentRuns.length === 0) return null;
-
-  const lines: string[] = [
-    "这些信息来自当前对话里最近的 app 工具调用，不依赖右侧编辑态。",
-  ];
-
-  const latestDeployLike = recentRuns.find((run) =>
-    ["appDeploy", "appRead", "appPreflight"].includes(run.toolName),
-  );
-  if (latestDeployLike) {
-    const input = latestDeployLike.input ?? {};
-    const parts = [
-      `- 最近一次关键 app 操作: ${latestDeployLike.toolName}`,
-      typeof input.appId === "string" ? `appId=${input.appId}` : null,
-      typeof input.name === "string" ? `name=${input.name}` : null,
-      typeof input.framework === "string" ? `framework=${input.framework}` : null,
-    ].filter(Boolean);
-    lines.push(parts.join("，"));
-  }
-
-  const relatedMessages = recentRuns
-    .map((run) => messageById.get(run.messageId))
-    .filter((msg): msg is Message => !!msg);
-
-  const appListMessage = relatedMessages.find((msg) => msg.toolName === "appList");
-  if (appListMessage) {
-    const entries = parseAppListEntries(contentToText(appListMessage.content)).slice(0, 5);
-    if (entries.length > 0) {
-      lines.push("- 最近一次 appList 结果：");
-      lines.push(...entries.map((entry) => `  ${entry}`));
-    }
-  }
-
-  const latestReadMessage = relatedMessages.find((msg) => msg.toolName === "appRead");
-  if (latestReadMessage) {
-    const text = contentToText(latestReadMessage.content);
-    const appId = text.match(/- appId:\s*(.+)/)?.[1]?.trim();
-    const url = text.match(/- 访问地址:\s*(.+)/)?.[1]?.trim();
-    if (appId || url) {
-      lines.push(
-        [
-          "- 最近一次 appRead 真值:",
-          appId ? `appId=${appId}` : null,
-          url ? `url=${url}` : null,
-        ]
-          .filter(Boolean)
-          .join("，"),
-      );
-    }
-  }
-
-  const latestPreflightRun = recentRuns.find((run) => run.toolName === "appPreflight");
-  if (latestPreflightRun) {
-    lines.push(
-      [
-        "- 最近一次 appPreflight:",
-        latestPreflightRun.status === "failed" ? "失败" : "已执行",
-        latestPreflightRun.outputSummary ? `摘要=${latestPreflightRun.outputSummary}` : null,
-      ]
-        .filter(Boolean)
-        .join("，"),
-    );
-  }
-
-  const latestDeployMessage = relatedMessages.find((msg) => msg.toolName === "appDeploy");
-  if (latestDeployMessage) {
-    const text = contentToText(latestDeployMessage.content);
-    const appId = text.match(/- appId:\s*(.+)/)?.[1]?.trim();
-    const url = text.match(/- 访问地址:\s*(.+)/)?.[1]?.trim();
-    if (appId || url) {
-      lines.push(
-        [
-          "- 最近一次 appDeploy 结果:",
-          appId ? `appId=${appId}` : null,
-          url ? `url=${url}` : null,
-        ]
-          .filter(Boolean)
-          .join("，"),
-      );
-    }
-  }
-
-  lines.push(
-    "- 如果用户说“刚才那个 app / 那个网站”，优先把它理解为上面最近一次被读取、预检或部署的应用；若仍有歧义，再用 appList 或 appRead 确认。",
-  );
-
-  return lines.join("\n");
-};

package/ai/agent/avatarUtils.ts

@@ -1,24 +0,0 @@
-// packages/ai/agent/avatarUtils.ts
-// Resolves an agent's avatarFileId → a displayable URL
-
-import { buildDatabaseFileContentUrl } from "../../database/fileUrl";
-
-/**
- * Returns a URL for displaying the agent avatar, or null.
- * - If avatarFileId is an http(s) URL → use directly
- * - Otherwise build server file-content URL
- */
-export function resolveAvatarUrl(
-  avatarFileId: string | undefined | null,
-  server: string | undefined | null
-): string | null {
-  if (!avatarFileId) return null;
-  if (avatarFileId.startsWith("http") || avatarFileId.startsWith("blob:")) {
-    return avatarFileId;
-  }
-  if (avatarFileId.startsWith("/")) {
-    if (!server) return avatarFileId;
-    return `${server}${avatarFileId}`;
-  }
-  return buildDatabaseFileContentUrl(server, avatarFileId);
-}

package/ai/agent/buildEditingContext.ts

@@ -1,378 +0,0 @@
-// 文件路径: ai/agent/buildEditingContext.ts
-
-import type { RootState } from "../../app/store";
-import type { AgentRuntimeOptions } from "./types";
-import { buildCanvasNodeEditingContextSummary } from "./canvasEditingContext";
-import { selectCurrentTable, selectTableRows } from "../../render/table/tableSlice";
-import { selectDoc } from "../../render/page/docSlice";
-
-type AppConstraintPack = {
-    id: string;
-    title: string;
-    rules: string[];
-};
-
-const buildAppConstraintPacks = (args: {
-    framework: string;
-    fileNames: string[];
-    externalImports: string[];
-}): AppConstraintPack[] => {
-    const imports = new Set(args.externalImports);
-    const fileSet = new Set(args.fileNames);
-    const packs: AppConstraintPack[] = [
-        {
-            id: "repair-loop",
-            title: "预检与定点修复",
-            rules: [
-                "每次改完代码后，先调用 appPreflight，只有预检通过后再调用 appDeploy。",
-                "如果 preflight / deploy 失败，优先根据返回的 issues 做定点修复，然后重新 preflight；不要无关重写整页应用。",
-                "如果工具结果里带有 repairPlan，默认立即执行 repairPlan 中的局部修复步骤，不要先停下来问用户。",
-                "如果工具结果明确说明是 HTML / 非 JSON 响应、transport failure 或 retryable=false，停止自动 deploy 重试；这说明当前是平台通道异常，不是代码问题。",
-            ],
-        },
-        {
-            id: "design-system",
-            title: "设计系统与小改动约束",
-            rules: [
-                "先检查当前应用是否已经有 theme / tokens / designSystem / 共享样式常量；如果已有，优先沿用这套设计系统，不要平行再造一套。",
-                "如果当前应用还没有设计系统，而用户需求涉及 UI / 样式 / 新页面，优先补一层最小共享 token（colors、typography、spacing、radius、shadow），再让组件消费这些 token。",
-                "如果当前应用是旧写法：视觉值散落在多个组件的硬编码 style / 常量里，而本次需求只是调字体、颜色、间距、圆角、阴影，默认执行一次最小 token 迁移，再在 token 层完成调整；不要继续把新数字散落写回多个位置。",
-                "当用户只是想调字体大小、字重、颜色、圆角、阴影、间距等视觉参数时，优先修改 token 或命中的局部组件，不要顺手重写整个页面结构。",
-                "除非用户明确要求整体改版或重做风格，否则不要连带修改布局、组件树、文案、数据流、路由或未命中的页面。",
-                "如果只是小改一处，尽量把变更收敛在少数文件，并保持未命中文件的结构与命名稳定。",
-            ],
-        },
-    ];
-
-    if (args.framework === "react-spa" || fileSet.has("main.tsx") || fileSet.has("App.tsx")) {
-        packs.push({
-            id: "react-spa-core",
-            title: "React SPA 形态保持",
-            rules: [
-                '继续沿用 framework: "react-spa" + files，不要退回单文件 Worker。',
-                "保留稳定入口结构，优先维护 main.tsx + App.tsx，再局部修改组件文件。",
-            ],
-        });
-    }
-
-    if (imports.has("react-icons/lu")) {
-        packs.push({
-            id: "react-icons-lu",
-            title: "Lucide 图标安全规则",
-            rules: [
-                "只能使用 react-icons/lu 中真实存在的图标名，不要猜测变体名。",
-                "如果不确定图标名，优先使用 LuCircle、LuCheck、LuX、LuInfo、LuArrowRight 这类基础图标。",
-            ],
-        });
-    }
-
-    if (imports.has("leaflet") || imports.has("react-leaflet")) {
-        packs.push({
-            id: "leaflet",
-            title: "Leaflet 地图约束",
-            rules: [
-                "不要手动 import leaflet.css；平台会自动注入 Leaflet 样式。",
-                "修改地图时优先保留现有坐标、缩放和图层结构，只做必要的交互或视觉调整。",
-            ],
-        });
-    }
-
-    if (imports.has("@xyflow/react")) {
-        packs.push({
-            id: "xyflow",
-            title: "Flow 图编辑约束",
-            rules: [
-                "不要新增外部 CSS import；需要样式时直接补最小必要内联样式或组件内 style 标签。",
-                "优先复用现有节点/边数据结构，避免重写整套 flow 画布。",
-            ],
-        });
-    }
-
-    if (imports.has("echarts") || imports.has("echarts-for-react")) {
-        packs.push({
-            id: "echarts",
-            title: "图表改动约束",
-            rules: [
-                "优先局部修改 option 配置、数据映射和组件 props，不要重写整个图表页面。",
-                "响应式布局优先靠容器尺寸和现有组件结构调整，不要额外引入 CSS 文件。",
-            ],
-        });
-    }
-
-    if (imports.has("docx") || imports.has("xlsx")) {
-        packs.push({
-            id: "file-processing",
-            title: "文档/表格处理约束",
-            rules: [
-                "不要把大型数据或模板内容直接内嵌进代码常量；优先保留运行时加载方式。",
-                "修改导入导出逻辑时，优先沿用现有文件处理链路和数据结构。",
-            ],
-        });
-    }
-
-    return packs;
-};
-
-const formatAppConstraintPacks = (packs: AppConstraintPack[]): string[] => {
-    if (packs.length === 0) return [];
-
-    return [
-        "",
-        "当前激活约束包（按当前应用依赖/形态动态注入）：",
-        ...packs.flatMap((pack) => [
-            `- ${pack.title}（${pack.id}）`,
-            ...pack.rules.map((rule) => `  - ${rule}`),
-        ]),
-    ];
-};
-
-/**
- * 根据当前 Redux 状态 + 本次调用的 runtimeOptions，生成「当前编辑对象」的自然语言描述。
- *
- * 设计目标：
- * - 只返回一段 string 或 null，不关心 Prompt 结构。
- * - 不涉及任何持久化（DialogConfig / AgentConfig），完全是运行时。
- * - 目前重点支持:
- *   - kind === "table": 当前表格 + 部分行数据
- *   - kind === "page" | "article": 当前页面/文章的标题（正文后面可以再丰富）
- */
-export const buildEditingContextSummary = (
-    state: RootState,
-    runtimeOptions?: AgentRuntimeOptions
-): string | null => {
-    const targetKind = runtimeOptions?.editingTarget?.kind;
-
-    // 1) 表格场景：基于当前表 meta + 行数据
-    if (targetKind === "table") {
-        const table = selectCurrentTable(state);
-        const rows = selectTableRows(state);
-        const metadata = runtimeOptions?.editingTarget?.metadata;
-        const focusContext =
-            metadata && typeof metadata === "object" ? metadata.focusContext : null;
-
-
-        if (!table) return null;
-
-
-        const columns = Array.isArray(table.columns) ? table.columns : [];
-
-
-        const columnSummaries = columns.length
-            ? columns.map((c) => {
-                const displayName = c.label || c.name;
-                const type = c.type || "text";
-                const requiredFlag = c.required ? "必填" : "可选";
-                const primaryFlag = c.isPrimary ? "，主字段" : "";
-                const optionsStr =
-                    Array.isArray(c.options) && c.options.length
-                        ? `，可选值：${c.options.join(" | ")}`
-                        : "";
-                const descStr = c.description ? `。说明：${c.description}` : "";
-
-
-                return `- ${c.name}（显示名：${displayName}，类型：${type}，${requiredFlag}${primaryFlag}${optionsStr}${descStr}）`;
-            })
-            : ["- (当前表尚未定义字段)"];
-
-
-        // 只给出前 20 行作为结构示例，避免 prompt 过长
-        const sampleRows = Array.isArray(rows) ? rows.slice(0, 20) : [];
-        const rowsPreview = sampleRows.length
-            ? JSON.stringify(sampleRows, null, 2)
-            : "(当前表暂无行数据)";
-
-
-        const tableTitle = table.displayName ?? table.tableId ?? "(未命名表)";
-        const tableDesc = table.description
-            ? `用途说明：${table.description}`
-            : "(暂无用途说明)";
-
-
-        // ✅ 新增：如果有表级 tags，把它们也告诉 Agent
-        const tableTagsLine =
-            Array.isArray(table.tags) && table.tags.length
-                ? `- 关键词标签: ${table.tags.join(", ")}`
-                : null;
-
-
-        return [
-            "当前编辑目标：一张数据表（Editing Table）。",
-            `- 表 ID: ${table.tableId}`,
-            `- 显示名称: ${tableTitle}`,
-            `- ${tableDesc}`,
-            ...(tableTagsLine ? [tableTagsLine] : []),
-            ...(focusContext &&
-                typeof focusContext === "object" &&
-                "columnName" in focusContext
-                ? [
-                    "",
-                    "当前焦点（Focus Context）：",
-                    `- 当前单元格列: ${String((focusContext as any).columnName ?? "(未知列)")}`,
-                    ...((focusContext as any).rowTitle
-                        ? [`- 当前行标题: ${String((focusContext as any).rowTitle)}`]
-                        : []),
-                    ...((focusContext as any).rowIndex !== null &&
-                        (focusContext as any).rowIndex !== undefined
-                        ? [`- 当前行号: ${Number((focusContext as any).rowIndex) + 1}`]
-                        : []),
-                    ...((focusContext as any).cellPreview
-                        ? [`- 当前单元格内容预览: ${String((focusContext as any).cellPreview)}`]
-                        : []),
-                  ]
-                : []),
-            "",
-            "字段定义（Field Schema）：",
-            ...columnSummaries,
-            "",
-            "【给 AI 的操作指南 / 非用户原话】",
-            "当用户希望在当前表中“新增一行 / 新增记录 / 插入一条 / 帮我记一条 xxx”时：",
-            "1. 必须调用工具 addTableRow（而不是只在回答中口头描述要新增的数据）。",
-            "2. 调用 addTableRow 时：",
-            "   - 使用参数 values（一个对象），其中每个 key 必须是上面字段名之一（name，而不是 label）。",
-            '   - 例如：{"values":{"title":"修 Bug #123","status":"todo","note":"高优先级"}}。',
-            "   - 尽量从用户的自然语言中推断并填满所有相关字段；对于必填字段（required=true）尤其要注意。",
-            '   - 用户没有提到的字段，可以使用空字符串 "" 或 null 作为占位。',
-            "   - 绝不要传入空对象 {} 作为 values。",
-            "",
-            "以下是部分示例行（最多 20 行，用于帮助你理解列含义，请避免在回答中完整粘贴整表）：",
-            rowsPreview,
-        ].join("\n");
-    }
-
-
-
-
-    // 2) 页面 / 文章场景：先只提供标题信息（正文后面可以在这里丰富）
-    if (targetKind === "page" || targetKind === "article") {
-        const page = selectDoc(state);
-        const metadata = runtimeOptions?.editingTarget?.metadata;
-        const focusContext =
-            metadata && typeof metadata === "object" ? metadata.focusContext : null;
-        if (!page) return null;
-
-        const title = page.title ?? "(未命名页面)";
-
-        return [
-            "当前编辑目标：一个页面 / 文章（Editing Document）。",
-            `- 标题: ${title}`,
-            ...(focusContext &&
-                typeof focusContext === "object" &&
-                "anchorPath" in focusContext
-                ? [
-                    "",
-                    "当前焦点（Focus Context）：",
-                    `- 光标是否折叠: ${Boolean((focusContext as any).isCollapsed) ? "是" : "否"}`,
-                    ...((focusContext as any).blockType
-                        ? [`- 当前块类型: ${String((focusContext as any).blockType)}`]
-                        : []),
-                    ...((focusContext as any).selectedText
-                        ? [`- 当前选中文本: ${String((focusContext as any).selectedText)}`]
-                        : []),
-                    ...((focusContext as any).anchorPath?.length
-                        ? [`- 当前锚点路径: ${(focusContext as any).anchorPath.join(" > ")}`]
-                        : []),
-                  ]
-                : []),
-            "",
-            "如果用户要求你对这篇文章进行修改或优化，请在回答中明确指出修改方向。",
-            "如果存在当前选区或光标上下文，优先围绕该局部位置做定点改写，而不是泛泛重写整篇文档。",
-        ].join("\n");
-    }
-
-    if (targetKind === "app") {
-        const editingTarget = runtimeOptions?.editingTarget;
-        const metadata = editingTarget?.metadata;
-        const appId = editingTarget?.key ?? "(未知 appId)";
-        const title = editingTarget?.title ?? "(未命名应用)";
-        const framework =
-            typeof metadata?.framework === "string"
-                ? metadata.framework
-                : "worker";
-        const appUrl =
-            typeof metadata?.appUrl === "string" ? metadata.appUrl : null;
-        const fileNames = Array.isArray(metadata?.fileNames)
-            ? metadata.fileNames.filter((name): name is string => typeof name === "string")
-            : [];
-        const externalImports = Array.isArray(metadata?.externalImports)
-            ? metadata.externalImports.filter(
-                (name): name is string => typeof name === "string"
-            )
-            : [];
-        const sourceSummary =
-            typeof editingTarget?.summary === "string" && editingTarget.summary.trim()
-                ? editingTarget.summary.trim()
-                : null;
-        const constraintPacks = buildAppConstraintPacks({
-            framework,
-            fileNames,
-            externalImports,
-        });
-
-        return [
-            "当前编辑目标：一个 Web 应用（Editing App）。",
-            `- 应用 ID: ${appId}`,
-            `- 名称: ${title}`,
-            `- 技术形态: ${framework}`,
-            ...(appUrl ? [`- 当前访问地址: ${appUrl}`] : []),
-            ...(fileNames.length
-                ? [`- 当前源码文件: ${fileNames.join(", ")}`]
-                : ["- 当前源码文件: (未提供多文件清单；可能是单文件源码，也可能只剩部署产物)"]),
-            ...(externalImports.length
-                ? [`- 当前依赖白名单命中: ${externalImports.join(", ")}`]
-                : []),
-            ...(sourceSummary ? ["", sourceSummary] : []),
-            "",
-            "【给 AI 的操作指南 / 非用户原话】",
-            "1. 用户要求修改当前应用时，先调用 appRead 获取当前代码/文件，再基于现有实现修改。",
-            "2. 先识别当前应用是否已有 theme / tokens / design system；已有就优先改这层，没有再补一层最小共享 token，再基于 token 调整组件。",
-            "3. 如果当前应用还是旧写法：视觉值散落在组件硬编码 style 里，而用户只是做字体/颜色/间距等视觉微调，默认先把命中的视觉值抽到最小 token 层，再完成本次修改；除非用户明确要求不要重构。",
-            `4. 重新部署当前应用时，appDeploy 必须继续传同一个 appId（${appId}），避免创建新应用。`,
-            framework === "react-spa"
-                ? '5. 当前应用是 React SPA，修改时继续沿用 framework: "react-spa" + files，不要退回单文件 Worker。'
-                : "5. 当前应用目前是 Worker 形态；如果需求变成复杂交互或图表，可以评估升级为 React SPA。",
-            ...(fileNames.length
-                ? []
-                : [
-                    "6. 当前没有源码文件清单时，必须先用 appRead 判断读到的是可维护源码还是部署产物 / 打包 bundle。",
-                    "7. 如果 appRead 返回的是 HTML 壳、importmap、压缩 bundle 或明显不是原始源码文件，禁止在未告知用户风险的情况下整站重写；应先说明“当前缺少原始源码快照，继续修改更像整体重建”，等用户确认后再继续。",
-                ]),
-            "8. 如果用户只是要调字体大小、配色、圆角、阴影、留白等视觉细节，默认优先改设计 token 或命中的局部组件；对旧写法应用则优先做最小 token 迁移，不要只改散落硬编码。",
-            "9. 每次修改完成后，先 appPreflight，再 appDeploy；如果失败，按返回 issues 定点修复。",
-            "10. 回复用户时优先说明做了什么变化、现在应用可以怎么用，而不是直接堆代码。",
-            ...formatAppConstraintPacks(constraintPacks),
-        ].join("\n");
-    }
-
-    if (targetKind === "image" || targetKind === "file") {
-        const editingTarget = runtimeOptions?.editingTarget;
-        const metadata = editingTarget?.metadata;
-        const title = editingTarget?.title ?? "(未命名对象)";
-        const objectKey = editingTarget?.key ?? "(未知 key)";
-        const fileId =
-            typeof metadata?.fileId === "string" ? metadata.fileId : null;
-        const url = typeof metadata?.url === "string" ? metadata.url : null;
-        const size =
-            typeof metadata?.size === "number" ? metadata.size : null;
-
-        return [
-            `当前编辑目标：一个${targetKind === "image" ? "图片" : "文件"}对象（Editing ${targetKind === "image" ? "Image" : "File"}）。`,
-            `- 对象 key: ${objectKey}`,
-            `- 标题: ${title}`,
-            ...(fileId ? [`- fileId: ${fileId}`] : []),
-            ...(url ? [`- 资源地址: ${url}`] : []),
-            ...(size !== null ? [`- 文件大小: ${size} bytes`] : []),
-            "",
-            "【给 AI 的操作指南 / 非用户原话】",
-            targetKind === "image"
-                ? "当前阶段优先帮助用户理解图片内容、提炼重点、命名归类和下一步处理建议。不要假装已经完成复杂图片编辑。"
-                : "当前阶段优先帮助用户理解文件用途、提取处理思路、给出整理建议和下一步操作建议。不要假装已经完整解析文件内容。",
-        ].join("\n");
-    }
-
-    if (targetKind === "canvas_node") {
-        return buildCanvasNodeEditingContextSummary(runtimeOptions);
-    }
-
-    // 其它 kind 以后按需扩展
-    return null;
-};