nolo-cli 0.1.39 → 0.1.41

package/commandRegistry.ts

@@ -69,8 +69,8 @@ export function renderHelpText() {
     "  nolo space read 01KKY77TT0DA9NY7TNW3R7255N --content-key page-user-id --brief",
     "  nolo space delete --name-prefix rn_owner_verify_0504 --yes",
     "  nolo table query --table 01ABCXYZ",
-    '  nolo table query --table meta-b2e06f801f-NOLOTASKBOARD --columns \'["title","status","owner","priority","codeStatus"]\' --no-base-fields --output items',
-    '  nolo table update-row --table meta-b2e06f801f-NOLOTASKBOARD --row 01ROWID --changes \'{"status":"已完成"}\'',
+    '  nolo table query --table meta-0e95801d90-NOLOTASKBOARD --columns \'["title","status","owner","priority","codeStatus"]\' --no-base-fields --output items',
+    '  nolo table update-row --table meta-0e95801d90-NOLOTASKBOARD --row 01ROWID --changes \'{"status":"已完成"}\'',
     "  nolo task-run read-context --row-dbkey row-user-table-row",
     "  nolo llama status",
   ];

package/core/builtinAgents.ts

@@ -0,0 +1,209 @@
+import { APP_BUILDER_PRESET } from "../ai/tools/agent/presets/appBuilderPreset";
+import { FIREWORKS_KIMI_LATEST_MODEL } from "../ai/llm/kimi";
+
+export const BUILTIN_NOLO_AGENT_KEY = "agent-pub-01NOLOAPPBLD000000019KCKT0";
+export const BUILTIN_APP_BUILDER_AGENT_KEY =
+  "agent-pub-01APPBUILDER00000001YAII3I";
+export const BUILTIN_ECOMMERCE_AGENT_KEY =
+  "agent-pub-01ECOMMERCEAG00000001PYQ2J";
+export const BUILTIN_AGENT_CREATOR_AGENT_KEY =
+  "agent-pub-01NOLOAGENTCRT000000000001";
+export const BUILTIN_NOLO_AGENT_ID = "01NOLOAPPBLD000000019KCKT0";
+export const BUILTIN_APP_BUILDER_AGENT_ID = "01APPBUILDER00000001YAII3I";
+export const BUILTIN_ECOMMERCE_AGENT_ID = "01ECOMMERCEAG00000001PYQ2J";
+export const BUILTIN_AGENT_CREATOR_AGENT_ID = "01NOLOAGENTCRT000000000001";
+
+const BUILTIN_PUBLIC_RUNTIME_SERVER_BASE = "https://nolo.chat";
+
+const buildBuiltinBaseAgent = (overrides: Record<string, unknown>) => {
+  const timestamp = Date.now();
+  return {
+    type: "agent",
+    isPublic: true,
+    userId: "builtin",
+    createdAt: timestamp,
+    updatedAt: timestamp,
+    references: [],
+    ...overrides,
+  };
+};
+
+const BUILTIN_NOLO_PROMPT = [
+  "你是 nolo，负责帮助刚进入产品的用户理解现在能做什么，并把他们带到合适的下一步。",
+  "优先直接回答、解释入口、帮用户开始对话、创建 AI、创建文档，或把任务交给更合适的 agent。",
+  "用户只是泛泛提问时，先收敛问题，不要立刻切换到重型流程。",
+  `当用户明确要创建、定制或发布 AI / Agent / 智能体时，调用 runStreamingAgent 转交给 AI 创建助手，agentKey 是 ${BUILTIN_AGENT_CREATOR_AGENT_KEY}。`,
+  "不要自己调用 prepareAgentDraft 或 createAgent；AI 创建助手负责草稿预览、用户确认和最终创建。",
+  "不要调用 deleteSpaces 这类高风险能力。",
+].join("\n");
+
+export const BUILTIN_AGENT_CREATOR_PROMPT = [
+  "你是 Nolo 的 AI 创建助手，只负责通过对话帮助用户创建或调整一个新的 Agent。",
+  "先理解用户想让这个 AI 服务谁、完成什么任务、使用什么语气、需要哪些能力、是否需要知识引用，以及是否适合公开。",
+  "当信息足够形成初版配置时，先调用 prepareAgentDraft，生成可预览草稿；信息不足时每次只问一个关键问题。",
+  "prepareAgentDraft 只生成草稿，不代表已经创建真实 Agent。",
+  "草稿展示后，等待用户明确确认，例如“确认创建”“就按这个创建”“创建这个 AI”。",
+  "只有得到明确确认后，才调用 createAgent 创建真实 Agent。",
+  "用户只是讨论、补充、修改或说“先看看”时，不要调用 createAgent。",
+  "默认模型使用 provider=fireworks, model=accounts/fireworks/models/kimi-latest；除非用户明确要求且平台已知支持，不要选择 Claude/Anthropic 等当前 runtime 不支持的 provider。",
+  "公开状态保持保守：你可以建议公开，但只有用户明确要求公开发布时，createAgent 的 isPublic 才能为 true。",
+  "如果用户想手动微调模型、工具、知识引用或发布状态，可以引导用户进入 /create/agent 高级编辑页。",
+].join("\n");
+
+export const buildBuiltinNoloRecord = () =>
+  buildBuiltinBaseAgent({
+    dbKey: BUILTIN_NOLO_AGENT_KEY,
+    id: BUILTIN_NOLO_AGENT_ID,
+    name: "nolo",
+    introduction:
+      "专门用来引导用户理解 Nolo 能做什么，并把问题带到正确入口或更合适的 Agent。",
+    greeting:
+      "你好，我是 nolo。你可以直接说你想做什么，我会帮你开始、解释入口，或把任务交给更合适的能力。",
+    provider: "fireworks",
+    model: FIREWORKS_KIMI_LATEST_MODEL,
+    useServerProxy: true,
+    apiSource: "platform",
+    runtimeServerBase: BUILTIN_PUBLIC_RUNTIME_SERVER_BASE,
+    inputPrice: 0.95 * 8,
+    outputPrice: 4 * 8,
+    hasVision: true,
+    tags: ["nolo", "引导", "分发"],
+    tools: ["fetchWebpage", "runStreamingAgent"],
+    prompt: BUILTIN_NOLO_PROMPT,
+  });
+
+export const buildBuiltinAppBuilderRecord = () =>
+  buildBuiltinBaseAgent({
+    ...APP_BUILDER_PRESET,
+    dbKey: BUILTIN_APP_BUILDER_AGENT_KEY,
+    id: BUILTIN_APP_BUILDER_AGENT_ID,
+    runtimeServerBase: BUILTIN_PUBLIC_RUNTIME_SERVER_BASE,
+    tags: ["应用构建", "App Builder", "无代码"],
+  });
+
+export const buildBuiltinEcommerceAgentRecord = () =>
+  buildBuiltinBaseAgent({
+    dbKey: BUILTIN_ECOMMERCE_AGENT_KEY,
+    id: BUILTIN_ECOMMERCE_AGENT_ID,
+    name: "电商商品参数助手",
+    introduction:
+      "专门获取淘宝、天猫、京东等电商商品真实参数、SKU、价格、库存和店铺信息，并做结构化对比。",
+    greeting: "发给我淘宝、天猫或京东商品链接，我会尽量获取真实商品参数。",
+    provider: "fireworks",
+    model: FIREWORKS_KIMI_LATEST_MODEL,
+    useServerProxy: true,
+    apiSource: "platform",
+    runtimeServerBase: BUILTIN_PUBLIC_RUNTIME_SERVER_BASE,
+    inputPrice: 0.95 * 8,
+    outputPrice: 4 * 8,
+    hasVision: false,
+    tags: ["电商", "商品参数", "数据抓取"],
+    tools: ["taobaoTmallProductScraper", "jdProductScraper"],
+    prompt: [
+      "你是电商商品参数助手，只负责获取和整理电商商品真实数据。",
+      "当用户给淘宝/天猫链接或商品 ID 时，先提取数字 itemId，再调用 taobaoTmallProductScraper。",
+      "当用户给京东链接或 SKU 时，先提取数字 skuId，再调用 jdProductScraper。",
+      "输出要结构化：商品标题、品牌、型号、店铺、价格、SKU/规格、库存、尺寸重量、质保、数据来源和缺失项。",
+      "用户问参数或详情时，必须展开工具返回的详细参数，不要只摘要基础字段。",
+      "只输出用户请求的数据结果；不要输出寒暄、确认、过渡句或结尾追问。",
+      "如果用户给多个商品，逐个调用对应工具后再做对比表。",
+      "如果工具返回缺失字段，如实说明缺失；不要编造参数，也不要要求用户手抄页面。",
+    ].join("\n"),
+  });
+
+export const buildBuiltinAgentCreatorRecord = () =>
+  buildBuiltinBaseAgent({
+    dbKey: BUILTIN_AGENT_CREATOR_AGENT_KEY,
+    id: BUILTIN_AGENT_CREATOR_AGENT_ID,
+    name: "AI 创建助手",
+    introduction:
+      "通过对话帮你整理专属 AI 的用途、能力、Prompt、知识引用和发布建议，并在确认后创建。",
+    greeting:
+      "告诉我你想创建一个什么样的 AI：它要帮谁、完成什么、需要哪些能力或资料？",
+    provider: "fireworks",
+    model: "accounts/fireworks/models/kimi-latest",
+    useServerProxy: true,
+    apiSource: "platform",
+    runtimeServerBase: BUILTIN_PUBLIC_RUNTIME_SERVER_BASE,
+    inputPrice: 0.95 * 8,
+    outputPrice: 4 * 8,
+    hasVision: false,
+    tags: ["AI 创建", "Agent 创建", "配置助手"],
+    tools: ["prepareAgentDraft", "createAgent"],
+    prompt: BUILTIN_AGENT_CREATOR_PROMPT,
+  });
+
+export const normalizeBuiltinPublicAgentRecord = <T extends Record<string, any>>(
+  agent: T,
+): T => {
+  if (!agent || typeof agent !== "object") return agent;
+  const key = typeof agent.dbKey === "string" ? agent.dbKey : "";
+  const id = typeof agent.id === "string" ? agent.id : "";
+  const isBuiltinCreator =
+    key === BUILTIN_AGENT_CREATOR_AGENT_KEY || id === BUILTIN_AGENT_CREATOR_AGENT_ID;
+
+  if (!isBuiltinCreator) return agent;
+
+  const builtin = buildBuiltinAgentCreatorRecord();
+  return {
+    ...agent,
+    name: builtin.name,
+    introduction: builtin.introduction,
+    greeting: builtin.greeting,
+    provider: builtin.provider,
+    model: builtin.model,
+    useServerProxy: builtin.useServerProxy,
+    apiSource: builtin.apiSource,
+    runtimeServerBase: builtin.runtimeServerBase,
+    inputPrice: builtin.inputPrice,
+    outputPrice: builtin.outputPrice,
+    hasVision: builtin.hasVision,
+    references: builtin.references,
+    tags: builtin.tags,
+    tools: builtin.tools,
+    prompt: builtin.prompt,
+  };
+};
+
+export const BUILTIN_PLATFORM_AGENT_KEYS = [
+  BUILTIN_NOLO_AGENT_KEY,
+  BUILTIN_APP_BUILDER_AGENT_KEY,
+  BUILTIN_ECOMMERCE_AGENT_KEY,
+  BUILTIN_AGENT_CREATOR_AGENT_KEY,
+] as const;
+
+const BUILTIN_PLATFORM_AGENT_KEY_SET = new Set<string>(BUILTIN_PLATFORM_AGENT_KEYS);
+
+export const isBuiltinPlatformAgentRecord = (agent: {
+  dbKey?: string | null;
+  id?: string | null;
+}): boolean => {
+  const dbKey = typeof agent?.dbKey === "string" ? agent.dbKey : "";
+  if (dbKey && BUILTIN_PLATFORM_AGENT_KEY_SET.has(dbKey)) return true;
+
+  const id = typeof agent?.id === "string" ? agent.id : "";
+  if (!id) return false;
+
+  return BUILTIN_PLATFORM_AGENT_KEYS.some((key) => key.endsWith(id));
+};
+
+export const shouldHideBuiltinAgentFromPublicPlaza = (agent: {
+  dbKey?: string | null;
+  id?: string | null;
+}): boolean => isBuiltinPlatformAgentRecord(agent);
+
+export const buildBuiltinPlatformAgentRecord = (dbKey: string) => {
+  if (dbKey === BUILTIN_NOLO_AGENT_KEY) {
+    return buildBuiltinNoloRecord();
+  }
+  if (dbKey === BUILTIN_APP_BUILDER_AGENT_KEY) {
+    return buildBuiltinAppBuilderRecord();
+  }
+  if (dbKey === BUILTIN_ECOMMERCE_AGENT_KEY) {
+    return buildBuiltinEcommerceAgentRecord();
+  }
+  if (dbKey === BUILTIN_AGENT_CREATOR_AGENT_KEY) {
+    return buildBuiltinAgentCreatorRecord();
+  }
+  return null;
+};

package/core/config.ts

@@ -0,0 +1,15 @@
+const providerName = "nolotus";
+
+const slogonforYou =
+  "The goodness or badness of this world concerns every individual.";
+
+// be cart  CryptoJS.PBKDF2  keySize: 256 / AUTH_VERSION[1].keylen,
+// even keylen same ,maybe error rn with web version
+export const AUTH_VERSION = {
+  "1": {
+    iterations: 10000,
+    salt: providerName + slogonforYou,
+    keylen: 32,
+  },
+};
+export const SALT = AUTH_VERSION[1].salt;

package/core/crypto.ts

@@ -0,0 +1,51 @@
+import nacl from "tweetnacl";
+import { Base64 } from "js-base64";
+
+export const signMessage = (
+  message: string,
+  secretKeyBase64: string
+): string => {
+  const messageUint8 = new TextEncoder().encode(message);
+  const signedMessage = nacl.sign(
+    messageUint8,
+    Base64.toUint8Array(secretKeyBase64)
+  );
+  return Base64.fromUint8Array(signedMessage);
+};
+
+export const verifySignedMessage = (
+  signedMessageBase64: string,
+  publicKeyBase64: string
+): string => {
+  const message = nacl.sign.open(
+    Base64.toUint8Array(signedMessageBase64),
+    Base64.toUint8Array(publicKeyBase64)
+  );
+
+  if (!message) throw new Error("Decoding failed");
+  return new TextDecoder().decode(message);
+};
+
+export const detachedSign = (message: string, secretKeyBase64: string) => {
+  const signature = nacl.sign.detached(
+    new TextEncoder().encode(message),
+    Base64.toUint8Array(secretKeyBase64)
+  );
+  return Base64.fromUint8Array(signature, true);
+};
+
+export const verifyDetachedSignature = (
+  message: string,
+  signatureBase64: string,
+  publicKeyBase64: string
+): boolean => {
+  try {
+    return nacl.sign.detached.verify(
+      new TextEncoder().encode(message),
+      Base64.toUint8Array(signatureBase64),
+      Base64.toUint8Array(publicKeyBase64)
+    );
+  } catch {
+    return false;
+  }
+};

package/core/generateKeyPairFromSeedV1.ts

@@ -0,0 +1,15 @@
+// keypair.ts
+import nacl from "tweetnacl";
+import { Base64 } from "js-base64";
+
+export const generateKeyPairFromSeedV1 = (seedData: string) => {
+  const seed = new TextEncoder().encode(seedData);
+  const hashSeed = nacl.hash(seed);
+  const seed32 = hashSeed.slice(0, 32);
+  const keyPair = nacl.sign.keyPair.fromSeed(seed32);
+
+  return {
+    publicKey: Base64.fromUint8Array(keyPair.publicKey, true),
+    secretKey: Base64.fromUint8Array(keyPair.secretKey, true),
+  };
+};

package/core/generateMainKey.ts

@@ -0,0 +1,22 @@
+import nacl from "tweetnacl";
+
+export const generateUserIdV1 = (
+  publicKey: string,
+  username: string,
+  language: string,
+  extra: string = ""
+) => {
+  const text = publicKey + username + language + extra;
+  const encodedText = new TextEncoder().encode(text);
+  const hash = nacl.hash(encodedText);
+
+  // 方案1：使用Array.from和map
+  const hexString = Array.from(hash)
+    .map((b) => b.toString(16).padStart(2, "0"))
+    .join("");
+
+  // 方案2：更简洁的写法，用Uint8Array直接转
+  // const hexString = [...hash].map(x => x.toString(16).padStart(2,'0')).join('');
+
+  return hexString.slice(0, 10);
+};

package/core/init.ts

@@ -0,0 +1,41 @@
+import { BUILTIN_NOLO_AGENT_KEY } from "./builtinAgents";
+
+export const nolotusId = "0e95801d90";
+export const copilotDemoId = "b2e06f801f";
+
+const ADMIN_IDS = new Set([nolotusId, copilotDemoId]);
+
+export const isSystemAdmin = (userId?: string | null) =>
+  userId != null && ADMIN_IDS.has(userId);
+
+export const AI_ADMIN_ROLE = "AI管理员";
+
+const envAiAdminIds = () =>
+  new Set(
+    (process.env.AI_ADMIN_USER_IDS ?? "")
+      .split(",")
+      .map((item) => item.trim())
+      .filter(Boolean)
+  );
+
+const recordHasAiAdminRole = (record: unknown): boolean => {
+  if (!record || typeof record !== "object") return false;
+  const value = record as Record<string, unknown>;
+  const scalarFields = [value.role, value.globalRole, value.systemRole];
+  if (scalarFields.some((item) => item === AI_ADMIN_ROLE)) return true;
+  const listFields = [value.roles, value.globalRoles, value.systemRoles, value.permissions];
+  return listFields.some(
+    (item) => Array.isArray(item) && item.includes(AI_ADMIN_ROLE)
+  );
+};
+
+export const isAIAdmin = (
+  userId?: string | null,
+  ...records: unknown[]
+) =>
+  isSystemAdmin(userId) ||
+  (userId != null && envAiAdminIds().has(userId)) ||
+  records.some(recordHasAiAdminRole);
+
+export const legacyNoloAgentId = "cybot-pub-01JYRSTM0MPPGQC9S25S3Y9J20";
+export const noloAgentId = BUILTIN_NOLO_AGENT_KEY;

package/core/localOrigins.ts

@@ -0,0 +1,8 @@
+export const DEFAULT_LOCAL_HOST = "127.0.0.1";
+export const DEFAULT_LOCAL_API_PORT = "38123";
+
+export const DEFAULT_LOCAL_API_ORIGIN = `http://${DEFAULT_LOCAL_HOST}:${DEFAULT_LOCAL_API_PORT}`;
+
+export function normalizeOrigin(value: string): string {
+  return value.trim().replace(/\/+$/, "");
+}

package/core/password.ts

@@ -0,0 +1,13 @@
+import CryptoJS from "crypto-js";
+import { SALT, AUTH_VERSION } from ".//config";
+
+export const hashPasswordV1 = async (password: string): Promise<string> => {
+  const hash = CryptoJS.PBKDF2(password, SALT, {
+    keySize: 256 / AUTH_VERSION[1].keylen,
+    iterations: AUTH_VERSION[1].iterations,
+    hasher: CryptoJS.algo.SHA512,
+  });
+
+  // 将 salt 和 hash 组合存储
+  return hash.toString(CryptoJS.enc.Base64);
+};

package/core/prefix.ts

@@ -0,0 +1,23 @@
+const extractKeyPart = (key: string, index: number): string => {
+  const parts = key.split("-");
+  if (index < 2) {
+    return parts[index];
+  }
+  return parts.slice(index).join("-");
+};
+
+export const extractUserId = (key: string): string => {
+  const parts = key.split("-");
+
+  if (parts.length === 2) {
+    return parts[0];
+  }
+
+  if (parts[0] === "user" && parts[1] === "pref" && parts.length >= 3) {
+    return parts[2];
+  }
+
+  return extractKeyPart(key, 1);
+};
+
+export const extractCustomId = (key: string): string => extractKeyPart(key, 2);

package/create/editor/transforms/fromMarkdown/index.ts

@@ -0,0 +1,260 @@
+// create/editor/transforms/fromMarkdown.ts
+
+import { processInlineNodes } from "./inline";
+import { transformTable } from "./table";
+
+interface SlateNode {
+  type: string;
+  children: Array<any>;
+  text?: string;
+  bold?: boolean;
+  italic?: boolean;
+  ordered?: boolean;
+  url?: string;
+  language?: string | null;
+  alt?: string;
+  title?: string;
+  header?: boolean;
+  checked?: boolean;
+  html?: string;
+  start?: number;
+  value?: number;
+  columns?: any[];
+  // 从 Markdown meta 里解析出来的 preview 标记
+  // 使用字符串是为了兼容 element.preview === "true" 的判断
+  preview?: string;
+}
+
+/**
+ * 创建一个空段落节点
+ */
+function createEmptyParagraph(): SlateNode {
+  return {
+    type: "paragraph",
+    children: [{ text: "" }],
+  };
+}
+
+/**
+ * 安全获取 children 数组
+ */
+function getChildren(node: any): any[] {
+  if (!node || typeof node !== "object") return [];
+  if (!Array.isArray(node.children)) return [];
+  return node.children;
+}
+
+/**
+ * 从 mdast 的 code 节点中解析 preview meta
+ * 支持：
+ * ```tsx preview
+ * ```tsx preview=true
+ */
+function getPreviewFlagFromMeta(node: any): "true" | undefined {
+  const meta = typeof node?.meta === "string" ? node.meta.trim() : "";
+  if (!meta) return undefined;
+
+  const tokens = meta.split(/\s+/);
+
+  const hasPreview = tokens.some((tok) => {
+    if (tok === "preview") return true;
+    if (tok.startsWith("preview=")) {
+      const [, value] = tok.split("=");
+      return value === "true";
+    }
+    return false;
+  });
+
+  return hasPreview ? "true" : undefined;
+}
+
+/**
+ * 将一个 list 节点转换为 Slate list 节点
+ */
+function convertList(node: any): SlateNode {
+  const start = typeof node.start === "number" ? node.start : 1;
+  const items = getChildren(node);
+
+  return {
+    type: "list",
+    ordered: !!node.ordered,
+    start,
+    children: items.map((item: any, index: number) =>
+      convertListItem(item, start + index)
+    ),
+  };
+}
+
+/**
+ * 将 listItem 节点转换为 Slate list-item 节点
+ */
+function convertListItem(item: any, value: number): SlateNode {
+  const children = convertListItemChildren(item);
+
+  const listItemNode: SlateNode = {
+    type: "list-item",
+    value,
+    children: children.length ? children : [createEmptyParagraph()],
+  };
+
+  if (item && (item.checked === true || item.checked === false)) {
+    listItemNode.checked = item.checked;
+  }
+
+  return listItemNode;
+}
+
+/**
+ * 将 listItem 里的子节点统一转换
+ * 支持：
+ * - 段落
+ * - 嵌套列表
+ * - 引用
+ * - 代码块
+ * - 表格
+ * - 分割线
+ * - HTML
+ * - 标题等
+ */
+function convertListItemChildren(item: any): SlateNode[] {
+  const children = getChildren(item);
+  if (!children.length) return [createEmptyParagraph()];
+
+  return convertBlockChildren(children);
+}
+
+/**
+ * 转换一组「块级」节点（用于 root / blockquote / listItem 等容器）
+ */
+function convertBlockChildren(nodes: any[]): SlateNode[] {
+  const result: SlateNode[] = [];
+
+  for (const node of nodes || []) {
+    const converted = convertBlockNode(node);
+    if (!converted) continue;
+
+    if (Array.isArray(converted)) {
+      result.push(...converted);
+    } else {
+      result.push(converted);
+    }
+  }
+
+  return result;
+}
+
+/**
+ * 将单个 mdast「块级」节点转换为 Slate 节点
+ * 这里处理所有可以作为块的类型：paragraph / heading / list / blockquote / code / table / html / thematicBreak ...
+ */
+function convertBlockNode(node: any): SlateNode | SlateNode[] | null {
+  if (!node || typeof node !== "object") return null;
+
+  switch (node.type) {
+    // 段落
+    case "paragraph":
+      return {
+        type: "paragraph",
+        children: node.children?.length
+          ? processInlineNodes(node.children)
+          : [{ text: "" }],
+      };
+
+    // 标题
+    case "heading": {
+      const depth = (node as any).depth || 1;
+      const headings = ["one", "two", "three", "four", "five", "six"];
+      const suffix = headings[depth - 1] || "one";
+      return {
+        type: `heading-${suffix}`,
+        children: node.children?.length
+          ? processInlineNodes(node.children)
+          : [{ text: "" }],
+      };
+    }
+
+    // 代码块（支持 preview meta）
+    case "code":
+      return {
+        type: "code-block",
+        language: node.lang || "text",
+        preview: getPreviewFlagFromMeta(node),
+        children: (node.value || "").split("\n").map((line: string) => ({
+          type: "code-line",
+          children: [{ text: line }],
+        })),
+      };
+
+    // 列表
+    case "list":
+      return convertList(node);
+
+    // 引用块（blockquote）
+    case "blockquote": {
+      const children = convertBlockChildren(getChildren(node));
+      return {
+        type: "quote",
+        children: children.length ? children : [createEmptyParagraph()],
+      };
+    }
+
+    // 表格
+    case "table": {
+      const tableNode = transformTable(node);
+      return tableNode || null;
+    }
+
+    // 分割线
+    case "thematicBreak":
+      return { type: "thematic-break", children: [{ text: "" }] };
+
+    // 原始 HTML（块级）
+    case "html": {
+      // 原来的实现只处理 position.start.column === 1 的块级 html
+      // 这里保持同样逻辑，避免行为改变太大
+      const isBlockHtml = !node.position || node.position.start?.column === 1;
+
+      if (!isBlockHtml) return null;
+
+      return {
+        type: "html-block",
+        html: node.value || "",
+        children: [{ text: "" }],
+      };
+    }
+
+    // root：取 children 继续处理
+    case "root":
+      return convertBlockChildren(getChildren(node));
+
+    default:
+      return null;
+  }
+}
+
+/**
+ * 顶层入口：MDAST -> Slate 数组
+ */
+export function mdastToSlate(mdastTree: any): SlateNode[] {
+  if (!mdastTree) {
+    return [createEmptyParagraph()];
+  }
+
+  let rootChildren: any[] = [];
+
+  if (mdastTree.type === "root") {
+    rootChildren = getChildren(mdastTree);
+  } else if (Array.isArray(mdastTree.children)) {
+    // 非 root 但有 children 的场景也兼容一下
+    rootChildren = mdastTree.children;
+  } else {
+    // 单节点也走统一转换
+    const single = convertBlockNode(mdastTree);
+    if (!single) return [createEmptyParagraph()];
+    return Array.isArray(single) ? single : [single];
+  }
+
+  const slateNodes = convertBlockChildren(rootChildren);
+
+  return slateNodes.length ? slateNodes : [createEmptyParagraph()];
+}