nolo-cli 0.1.23 → 0.1.29

package/ai/tools/agent/agentTools.ts

@@ -8,6 +8,10 @@ import {
     createAgentToolFunctionSchema,
     createAgentToolFunc,
 } from "./createAgentTool";
+import {
+    prepareAgentDraftToolFunctionSchema,
+    prepareAgentDraftToolFunc,
+} from "./prepareAgentDraftTool";
 import {
     createSkillAgentToolFunctionSchema,
     createSkillAgentToolFunc,
@@ -48,6 +52,23 @@ import {
 import type { ToolDefinition } from "../index";
 
 export const agentToolDefinitions: ToolDefinition[] = [
+    {
+        id: "prepareAgentDraft",
+        schema: prepareAgentDraftToolFunctionSchema,
+        executor: prepareAgentDraftToolFunc,
+        description: {
+            name: "prepareAgentDraft",
+            description:
+                "整理 Agent 创建草稿并交给用户预览确认，不创建真实 Agent。",
+            category: "计划与编排",
+        },
+        behavior: "data",
+        uiGroup: "agent",
+        capability: "general",
+        riskLevel: "low",
+        costLevel: "low",
+        defaultConsent: "auto",
+    },
     {
         id: "createAgent",
         schema: createAgentToolFunctionSchema,

package/ai/tools/agent/agentUpdateShared.ts

@@ -1,10 +1,10 @@
-import type { Agent } from "app/types";
-import type { FormData as AgentFormData } from "ai/agent/createAgentSchema";
+import type { Agent } from "../../../app/types";
+import type { FormData as AgentFormData } from "../../agent/createAgentSchema";
 import {
   type AgentUpdateField,
   AGENT_UPDATE_FIELD_NAMES,
-} from "ai/policy/selfUpdateFields";
-import { ToolResultError } from "ai/tools/toolResultError";
+} from "../../policy/selfUpdateFields";
+import { ToolResultError } from "../../tools/toolResultError";
 
 type ReasoningEffort = "low" | "medium" | "high";
 

package/ai/tools/agent/callAgentTool.ts

@@ -1,8 +1,8 @@
 // 文件路径: ai/tools/agent/callAgentTool.ts
 
-import type { RootState } from "app/store";
-import { runAgent } from "ai/agent/agentSlice";
-import { runAgentBackground } from "ai/agent/runAgentBackground";
+import type { RootState } from "../../../app/store";
+import { runAgent } from "../../agent/agentSlice";
+import { runAgentBackground } from "../../agent/runAgentBackground";
 
 
 /**

package/ai/tools/agent/createAgentTool.ts

@@ -1,15 +1,15 @@
 // 文件路径: ai/tools/agent/createAgentTool.ts
 
-import type { RootState } from "app/store";
-import type { Agent } from "app/types";
-import { createAgent } from "ai/agent/agentSlice";
-import { selectAllMemberSpaces, addContentToSpace } from "create/space/spaceSlice";
-import { ContentType } from "app/types";
-import { createAgentKey, } from "database/keys";
-import type { FormData as AgentFormData } from "ai/agent/createAgentSchema";
-import { selectCurrentUserBalance, selectUserId } from "auth/authSlice";
-import type { ModelWithProvider } from "ai/llm/models";
-import i18n from "app/i18n";
+import type { RootState } from "../../../app/store";
+import type { Agent } from "../../../app/types";
+import { createAgent } from "../../agent/agentSlice";
+import { selectAllMemberSpaces, addContentToSpace } from "../../../create/space/spaceSlice";
+import { ContentType } from "../../../app/types";
+import { createAgentKey, } from "../../../database/keys";
+import type { FormData as AgentFormData } from "../../agent/createAgentSchema";
+import { selectCurrentUserBalance, selectUserId } from "../../../auth/authSlice";
+import type { ModelWithProvider } from "../../llm/models";
+import i18n from "../../../app/i18n";
 
 type ReasoningEffort = "low" | "medium" | "high";
 
@@ -71,7 +71,7 @@ const findModelConfig = async (
     modelName: string,
     provider?: string
 ): Promise<ModelWithProvider | null> => {
-    const { ALL_MODELS } = await import("ai/llm/models");
+    const { ALL_MODELS } = await import("../../llm/models");
     const name = toTrimmed(modelName);
     const prov = toTrimmed(provider ?? "");
     if (!name) return null;
@@ -314,7 +314,7 @@ const buildFormDataFromArgs = async (args: CreateAgentToolArgs): Promise<AgentFo
 
     // 用 (model, provider) 查模型元数据，顺便拿 hasVision 等能力
     const modelConfig = await findModelConfig(trimmedModel, trimmedProvider);
-    const { getModelPricing } = await import("ai/llm/getPricing");
+    const { getModelPricing } = await import("../../llm/getPricing");
 
     const formData: AgentFormData = {
         name: trimmedName,

package/ai/tools/agent/createDialogTool.ts

@@ -1,8 +1,8 @@
 // 文件路径: ai/tools/agent/createDialogTool.ts
 
-import type { RootState } from "app/store";
-import { createDialogAction } from "chat/dialog/actions/createDialogAction";
-import { streamAgentChatTurn } from "ai/agent/agentSlice";
+import type { RootState } from "../../../app/store";
+import { createDialogAction } from "../../../chat/dialog/actions/createDialogAction";
+import { streamAgentChatTurn } from "../../agent/agentSlice";
 
 export const createDialogFunctionSchema = {
     name: "createDialog",

package/ai/tools/agent/parallelBudget.ts

@@ -1,5 +1,5 @@
-import { prepareTokenUsageData } from "ai/token/prepareTokenUsageData";
-import type { RawUsage } from "ai/token/types";
+import { prepareTokenUsageData } from "../../token/prepareTokenUsageData";
+import type { RawUsage } from "../../token/types";
 
 const roundCredits = (value: number) => Number(value.toFixed(6));
 const toRoundedFiniteNumber = (value: unknown): number | null =>

package/ai/tools/agent/prepareAgentDraftTool.ts

@@ -0,0 +1,173 @@
+import { DEFAULT_MODEL } from "../../llm/providers";
+import {
+  GUIDED_AGENT_CAPABILITIES,
+  mapCapabilityIdsToToolIds,
+} from "../../agent/guidedCreation/capabilities";
+import type {
+  GuidedAgentCapabilityId,
+  GuidedAgentDraft,
+  GuidedAgentReferenceChoice,
+} from "../../agent/guidedCreation/types";
+
+export type PrepareAgentDraftToolArgs = Partial<GuidedAgentDraft>;
+
+const capabilityIds = new Set(Object.keys(GUIDED_AGENT_CAPABILITIES));
+
+const trim = (value: unknown) =>
+  typeof value === "string" ? value.trim() : "";
+
+const stringArray = (value: unknown): string[] =>
+  Array.isArray(value)
+    ? value.map((item) => trim(item)).filter(Boolean)
+    : [];
+
+const guidedCapabilityArray = (value: unknown): GuidedAgentCapabilityId[] =>
+  stringArray(value).filter((id): id is GuidedAgentCapabilityId =>
+    capabilityIds.has(id)
+  );
+
+const referencesArray = (value: unknown): GuidedAgentReferenceChoice[] =>
+  Array.isArray(value)
+    ? value
+        .filter((item): item is Record<string, unknown> =>
+          !!item && typeof item === "object" && !Array.isArray(item)
+        )
+        .map((item) => ({
+          dbKey: trim(item.dbKey),
+          title: trim(item.title),
+          type: item.type === "instruction" ? "instruction" : "knowledge",
+          selected: item.selected === true,
+          ...(trim(item.reason) ? { reason: trim(item.reason) } : {}),
+        }))
+        .filter((item) => item.dbKey)
+    : [];
+
+const buildPrompt = (args: PrepareAgentDraftToolArgs) => {
+  const prompt = trim(args.prompt);
+  if (prompt) return prompt;
+  const name = trim(args.name) || "用户的专属 AI";
+  const summary = trim(args.promptSummary) || trim(args.introduction);
+  return [
+    `你是${name}。`,
+    summary || "你需要理解用户目标，并给出清晰、可执行、有边界的帮助。",
+    "如果信息不足，先提出必要澄清问题；不要编造用户没有确认的资料来源。",
+  ].join("\n");
+};
+
+export const buildPreparedAgentDraft = (
+  args: PrepareAgentDraftToolArgs
+): GuidedAgentDraft => {
+  const selectedCapabilities = guidedCapabilityArray(args.capabilityIds);
+  const providedToolIds = stringArray(args.toolIds);
+  const mappedToolIds = mapCapabilityIdsToToolIds(selectedCapabilities);
+  return {
+    name: trim(args.name),
+    introduction: trim(args.introduction),
+    prompt: buildPrompt(args),
+    promptSummary: trim(args.promptSummary),
+    provider: trim(args.provider) || DEFAULT_MODEL.provider,
+    model: trim(args.model) || DEFAULT_MODEL.name,
+    isPublic: args.isPublic === true,
+    capabilityIds: selectedCapabilities,
+    toolIds: Array.from(new Set([...providedToolIds, ...mappedToolIds])),
+    references: referencesArray(args.references),
+    tags: stringArray(args.tags),
+    unresolved: stringArray(args.unresolved),
+  };
+};
+
+export const prepareAgentDraftToolFunctionSchema = {
+  name: "prepareAgentDraft",
+  description:
+    "整理一个可预览的 Agent 创建草稿。只生成草稿，不创建真实 Agent 记录。",
+  parameters: {
+    type: "object",
+    properties: {
+      name: { type: "string", description: "建议的 Agent 名称。" },
+      introduction: { type: "string", description: "面向用户展示的简介。" },
+      prompt: { type: "string", description: "完整系统 prompt 草稿。" },
+      promptSummary: { type: "string", description: "prompt 的简短摘要。" },
+      provider: { type: "string", description: "建议 provider。" },
+      model: { type: "string", description: "建议模型名称。" },
+      isPublic: { type: "boolean", description: "是否建议公开。" },
+      capabilityIds: {
+        type: "array",
+        items: {
+          type: "string",
+          enum: Object.keys(GUIDED_AGENT_CAPABILITIES),
+        },
+        description: "已确认或高度确定的能力标签。",
+      },
+      toolIds: {
+        type: "array",
+        items: { type: "string" },
+        description: "可选的底层工具名；通常由 capabilityIds 推导。",
+      },
+      references: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            dbKey: { type: "string" },
+            title: { type: "string" },
+            type: { type: "string", enum: ["knowledge", "instruction"] },
+            selected: { type: "boolean" },
+            reason: { type: "string" },
+          },
+          required: ["dbKey"],
+        },
+        description: "建议挂载的知识引用，默认等待用户确认。",
+      },
+      tags: {
+        type: "array",
+        items: { type: "string" },
+      },
+      unresolved: {
+        type: "array",
+        items: { type: "string" },
+        description: "仍需确认的字段或问题。",
+      },
+    },
+    required: ["name", "introduction", "promptSummary"],
+  },
+};
+
+export async function prepareAgentDraftToolFunc(
+  args: PrepareAgentDraftToolArgs
+): Promise<{
+  rawData: {
+    draft: GuidedAgentDraft;
+    createUrl: string;
+    primaryAction: { kind: "confirmInChat"; label: string };
+    secondaryAction: { kind: "advancedEdit"; label: string; url: string };
+  };
+  displayData: string;
+}> {
+  const draft = buildPreparedAgentDraft(args);
+  const missing = draft.unresolved.length
+    ? `\n- 待确认: ${draft.unresolved.join(", ")}`
+    : "";
+  return {
+    rawData: {
+      draft,
+      createUrl: "/create/agent",
+      primaryAction: {
+        kind: "confirmInChat",
+        label: "确认后在对话中创建",
+      },
+      secondaryAction: {
+        kind: "advancedEdit",
+        label: "高级编辑",
+        url: "/create/agent",
+      },
+    },
+    displayData: [
+      `Agent 草稿: ${draft.name || "未命名 AI"}`,
+      draft.promptSummary ? `- 摘要: ${draft.promptSummary}` : "",
+      draft.capabilityIds.length
+        ? `- 能力: ${draft.capabilityIds.join(", ")}`
+        : "",
+      missing,
+    ].filter(Boolean).join("\n"),
+  };
+}

package/ai/tools/agent/presets/appBuilderPreset.ts

@@ -9,7 +9,7 @@
  *   preset with a read/pull of agent-pub-01APPBUILDER00000001YAII3I and leave
  *   only a tiny emergency placeholder here.
  */
-import { FIREWORKS_KIMI_LATEST_MODEL } from "ai/llm/kimi";
+import { FIREWORKS_KIMI_LATEST_MODEL } from "../../../llm/kimi";
 
 export const APP_BUILDER_PRESET = {
   name: "App Builder",

package/ai/tools/agent/runLlmTool.ts

@@ -11,7 +11,7 @@
  * - callAgent：可能多轮（agent 内部有 tool loop），带完整 agent 上下文
  */
 
-import { runLlm } from "ai/agent/agentSlice";
+import { runLlm } from "../../agent/agentSlice";
 
 export const runLlmFunctionSchema = {
     name: "runLlm",

package/ai/tools/agent/skillAgentPreset.ts

@@ -1,13 +1,13 @@
-import type { Agent } from "app/types";
-import { DataType } from "create/types";
-import { createAgentKey } from "database/keys";
+import type { Agent } from "../../../app/types";
+import { DataType } from "../../../create/types";
+import { createAgentKey } from "../../../database/keys";
 import { ulid } from "ulid";
 import {
   normalizeReferences,
   type FormData as AgentFormData,
-} from "ai/agent/createAgentSchema";
-import { ALL_MODELS, type ModelWithProvider } from "ai/llm/models";
-import { getModelPricing } from "ai/llm/getPricing";
+} from "../../agent/createAgentSchema";
+import { ALL_MODELS, type ModelWithProvider } from "../../llm/models";
+import { getModelPricing } from "../../llm/getPricing";
 import {
   buildCreateSkillAgentArgs,
   type CreateSkillAgentToolArgs,

package/ai/tools/agent/updateAgentTool.ts

@@ -1,9 +1,9 @@
 // ai/tools/agent/updateAgentTool.ts
 
-import type { RootState } from "app/store";
-import type { Agent } from "app/types";
-import { updateAgent } from "ai/agent/agentSlice";
-import { selectUserId } from "auth/authSlice";
+import type { RootState } from "../../../app/store";
+import type { Agent } from "../../../app/types";
+import { updateAgent } from "../../agent/agentSlice";
+import { selectUserId } from "../../../auth/authSlice";
 import {
     type UpdateAgentToolArgs,
     agentUpdateFieldSchemaProperties,

package/ai/tools/agent/updateSelfTool.ts

@@ -1,13 +1,13 @@
-import type { RootState } from "app/store";
-import type { Agent } from "app/types";
-import { updateAgent } from "ai/agent/agentSlice";
+import type { RootState } from "../../../app/store";
+import type { Agent } from "../../../app/types";
+import { updateAgent } from "../../agent/agentSlice";
 import {
   selectAutoApproveSelfUpdateFields,
-} from "app/settings/settingSlice";
-import { selectUserId } from "auth/authSlice";
-import { selectCurrentDialogConfig } from "chat/dialog/dialogSlice";
-import { resolveMessageAgentKey } from "chat/messages/messageAgent";
-import { selectMsgById } from "chat/messages/messageSlice";
+} from "../../../app/settings/settingSlice";
+import { selectUserId } from "../../../auth/authSlice";
+import { selectCurrentDialogConfig } from "../../../chat/dialog/dialogSlice";
+import { resolveMessageAgentKey } from "../../../chat/messages/messageAgent";
+import { selectMsgById } from "../../../chat/messages/messageSlice";
 import {
   type UpdateSelfToolArgs,
   agentUpdateFieldSchemaProperties,

package/ai/tools/appTools.ts

@@ -4,9 +4,9 @@
 
 import { toolRunUpdated, type ToolRunStep } from "./toolRunSlice";
 import { callToolApi, getToolRequestContext } from "./toolApiClient";
-import { syncAppRecord } from "app/actions/syncAppRecord";
-import { deleteDbKey } from "app/hooks/deleteDbKey";
-import { selectAllMsgs, selectCurrentDialogId } from "chat/messages/messageSlice";
+import { syncAppRecord } from "../../app/actions/syncAppRecord";
+import { deleteDbKey } from "../../app/hooks/deleteDbKey";
+import { selectAllMsgs, selectCurrentDialogId } from "../../chat/messages/messageSlice";
 import { ToolResultError } from "./toolResultError";
 import {
   analyzeAppStyleSystem,

package/ai/tools/category/createCategoryTool.ts

@@ -1,7 +1,7 @@
 // ai/tools/createCategoryTool.ts
 
-import { addCategory, selectCurrentSpaceId } from "create/space/spaceSlice";
-import type { RootState } from "app/store";
+import { addCategory, selectCurrentSpaceId } from "../../../create/space/spaceSlice";
+import type { RootState } from "../../../app/store";
 
 /**
  * [Schema] 定义了 'createCategory' 工具的结构，供 LLM 调用。

package/ai/tools/category/queryContentsByCategoryTool.ts

@@ -1,7 +1,7 @@
 // ai/tools/queryContentsByCategoryTool.ts
 
-import { selectCurrentSpaceId } from "create/space/spaceSlice";
-import type { RootState } from "app/store";
+import { selectCurrentSpaceId } from "../../../create/space/spaceSlice";
+import type { RootState } from "../../../app/store";
 
 /**
  * [Schema] 定义了 'queryContentsByCategory' 工具的结构，供 LLM 调用。

package/ai/tools/category/updateContentCategoryTool.ts

@@ -3,8 +3,8 @@
 import {
   updateContentCategory,
   selectCurrentSpaceId,
-} from "create/space/spaceSlice";
-import type { RootState } from "app/store";
+} from "../../../create/space/spaceSlice";
+import type { RootState } from "../../../app/store";
 
 /**
  * [Schema] 定义了 'updateContentCategory' 工具的结构，供 LLM 调用。

package/ai/tools/checkEnvTool.ts

@@ -3,39 +3,60 @@
 
 import { callToolApi } from "./toolApiClient";
 
-export type CheckEnvArgs = {
-    check?: "build" | "context";
-};
+export type CheckEnvArgs = {
+    check?: "build" | "context";
+    key?: string;
+};
 
 export const checkEnvFunctionSchema = {
     name: "checkEnv",
     description: [
-        "执行环境检查并返回结构化结果。",
-        "check='context' 可查看当前平台、工作目录与可用 shell；check='build' 可快速验证是否可编译。",
+        "执行环境检查并返回结构化结果。",
+        "check='context' 可查看当前平台、工作目录与可用 shell；check='build' 可快速验证是否可编译。",
+        "key 可检查某个本地工具，例如 key='gemini' 会探测本机 Gemini CLI 与 npm 最新版本。",
     ].join("\n"),
     parameters: {
         type: "object",
         properties: {
-            check: {
-                type: "string",
-                enum: ["build", "context"],
-                description: "检查项：context 返回当前运行环境；build 执行构建检查。",
-            },
-        },
-    },
-};
+            check: {
+                type: "string",
+                enum: ["build", "context"],
+                description: "检查项：context 返回当前运行环境；build 执行构建检查。",
+            },
+            key: {
+                type: "string",
+                enum: ["gemini", "node", "npm", "bun", "python", "git", "shell"],
+                description: "可选：探测某个本地工具，不执行 build。常用值如 gemini、node、npm、bun、python、git、shell。",
+            },
+        },
+    },
+};
+
+const formatProbeOutput = (probe: any): string => {
+    const status = probe?.ok ? "OK" : "FAIL";
+    const lines = [`- [${status}] ${probe?.label ?? "probe"}`];
+    const stdout = typeof probe?.stdout === "string" ? probe.stdout.trim() : "";
+    const stderr = typeof probe?.stderr === "string" ? probe.stderr.trim() : "";
+    const error = typeof probe?.error === "string" ? probe.error.trim() : "";
+    if (stdout) lines.push(`  stdout: ${stdout}`);
+    if (stderr) lines.push(`  stderr: ${stderr}`);
+    if (error) lines.push(`  error: ${error}`);
+    return lines.join("\n");
+};
 
 export async function checkEnvFunc(
     args: CheckEnvArgs,
     thunkApi: any,
     context?: { agentKey?: string }
 ): Promise<{ rawData: any; displayData: string }> {
-    const check = args?.check === "context" ? "context" : "build";
-
+    const key = typeof args?.key === "string" ? args.key.trim().toLowerCase() : "";
+    const check = args?.check === "context" ? "context" : "build";
+    const payload = key ? { key } : { check };
+
     const result = await callToolApi<any>(
         thunkApi,
         "/api/check-env",
-        { check },
+        payload,
         {
             withAuth: true,
             agentKey: context?.agentKey,
@@ -45,7 +66,18 @@ export async function checkEnvFunc(
     const ok = !!result?.ok;
     const exitCode = typeof result?.exitCode === "number" ? result.exitCode : -1;
 
-    if (check === "context") {
+    if (result?.check === "tool") {
+        const probes = Array.isArray(result?.probes) ? result.probes : [];
+        return {
+            rawData: result,
+            displayData: [
+                `本地工具检查: ${result?.key ?? key}`,
+                ...probes.map(formatProbeOutput),
+            ].join("\n"),
+        };
+    }
+
+    if (check === "context") {
         const displayParts = [
             `平台: ${result?.platform ?? "unknown"}`,
             `cwd: ${result?.cwd ?? "unknown"}`,
@@ -59,9 +91,9 @@ export async function checkEnvFunc(
             rawData: result,
             displayData: `🧭 当前环境\n${displayParts.join("\n")}`,
         };
-    }
-
-    return {
+    }
+
+    return {
         rawData: result,
         displayData: ok
             ? `✅ 环境检查通过: ${check}`

package/ai/tools/convertMarxistsBookTool.ts

@@ -0,0 +1,103 @@
+import { convertMarxistsBookToOfflineHtml } from "./marxistsOfflineBook";
+
+export const convertMarxistsBookToOfflineHtmlFunctionSchema = {
+  name: "convertMarxistsBookToOfflineHtml",
+  description:
+    "将 Marxists.org 中文旧式书籍页面转换成离线单 HTML。会从章节 URL 推导目录页，下载同目录章节、CSS 和背景图，保留原始排版并内嵌资源，适合 iPad/移动设备离线阅读。",
+  parameters: {
+    type: "object",
+    properties: {
+      startUrl: {
+        type: "string",
+        description:
+          "任意一个 Marxists.org 中文书籍章节 URL，例如 https://www.marxists.org/chinese/fromm/1973/01.htm。",
+      },
+      encoding: {
+        type: "string",
+        description: "源站 HTML/CSS 编码，老中文页面通常是 gb2312。默认 gb2312。",
+        default: "gb2312",
+      },
+      outputMode: {
+        type: "string",
+        enum: ["summary", "html"],
+        description:
+          "summary 只返回元数据和文件引用；html 同时返回完整 HTML 字符串。需要直接拿到文件内容时用 html。",
+        default: "summary",
+      },
+      singleFileName: {
+        type: "string",
+        description:
+          "生成文件建议名称，默认根据书名或 URL 生成；server-side agent 可用它作为保存文件名。",
+      },
+      maxPages: {
+        type: "number",
+        description: "最多允许抓取的同目录章节页数量，默认 80，防止误抓整个站点。",
+        default: 80,
+      },
+      saveAsFile: {
+        type: "boolean",
+        description:
+          "server-side agent 可设为 true，将 HTML 保存为 Nolo 文件并返回下载 URL；如果只需要 HTML 字符串，可设为 false。",
+        default: true,
+      },
+    },
+    required: ["startUrl"],
+  },
+};
+
+export type ConvertMarxistsBookToolArgs = {
+  startUrl: string;
+  encoding?: string;
+  outputMode?: "summary" | "html";
+  singleFileName?: string;
+  maxPages?: number;
+  saveAsFile?: boolean;
+};
+
+export async function convertMarxistsBookToOfflineHtmlFunc(
+  args: ConvertMarxistsBookToolArgs,
+): Promise<{ rawData: Record<string, unknown>; displayData: string }> {
+  const result = await convertMarxistsBookToOfflineHtml({
+    startUrl: args.startUrl,
+    encoding: args.encoding,
+    maxPages: args.maxPages,
+  });
+
+  const rawData: Record<string, unknown> = {
+    title: result.title,
+    startUrl: result.startUrl,
+    indexUrl: result.indexUrl,
+    stylesheetUrl: result.stylesheetUrl,
+    pages: result.pages,
+    validation: result.validation,
+    fileName: args.singleFileName,
+  };
+  if (args.outputMode === "html") {
+    rawData.html = result.html;
+  }
+
+  return {
+    rawData,
+    displayData: formatMarxistsOfflineBookDisplayData({
+      ...rawData,
+      htmlIncluded: args.outputMode === "html",
+    }),
+  };
+}
+
+export function formatMarxistsOfflineBookDisplayData(data: Record<string, unknown>): string {
+  const validation = (data.validation ?? {}) as any;
+  const pages = Array.isArray(data.pages) ? data.pages : [];
+  return [
+    "✅ 已生成离线 HTML",
+    `书名：${data.title || "未知"}`,
+    `章节数：${validation.pageCount ?? pages.length}`,
+    `大小：${validation.byteLength ?? "未知"} bytes`,
+    `资源内嵌：${validation.hasEmbeddedAssets ? "是" : "否"}`,
+    `残留网络 URL：${validation.hasNetworkUrls ? "是" : "否"}`,
+    data.fileUrl ? `文件：${data.fileUrl}` : undefined,
+    data.htmlIncluded ? "已在 rawData.html 返回完整 HTML。" : undefined,
+  ]
+    .filter(Boolean)
+    .join("\n");
+}

package/ai/tools/createDocTool.ts

@@ -1,8 +1,8 @@
 // 文件路径: ai/tools/createDocTool.ts
 
-import { createDoc } from "render/page/docSlice";
-import { selectCurrentSpaceId } from "create/space/spaceSlice";
-import type { RootState } from "app/store";
+import { createDoc } from "../../render/page/docSlice";
+import { selectCurrentSpaceId } from "../../create/space/spaceSlice";
+import type { RootState } from "../../app/store";
 
 export interface CreateDocToolArgs {
   title?: string;