@kne/fastify-live-components-site 0.1.1 → 0.1.9

package/README.md

@@ -111,6 +111,7 @@ npm i --save @kne/fastify-live-components-site
   messages: [{ role: 'user'|'assistant', content: string }],
   content?: string,
   scope?: object,
+  props?: object,
   libs?: string[],
   remotes?: [{ name, version, packageName? }],
   selection?: { startLine, endLine, code, label }
@@ -120,7 +121,7 @@ npm i --save @kne/fastify-live-components-site
 返回 `{ streamToken }`。随后 `GET {host}/ai/stream?token=` 以 SSE 推送：
 
 - `{ text, done: false }` 增量文本
-- `{ done: true, suggestedScope? }` 结束
+- `{ done: true, suggestedScope?, suggestedProps? }` 结束（生成阶段可通过工具声明组件域 / 组件参数）
 
 前端从 `@kne/remote-loader` preset 收集 `remotes`，并从当前环境合并 `libs` 键名一并上传。服务端按「库名/版本」缓存组件文档索引（`load-npm-info` + `md-doc`）。
 

package/libs/ai/catalog.js

@@ -59,6 +59,7 @@ const readCachedCatalog = async (dir, remoteName, version) => {
     remote: remoteName,
     version,
     packageName: meta.packageName,
+    meta,
     index,
     components
   };
@@ -110,10 +111,24 @@ const ensureRemoteCatalog = async (remote, options) => {
 
   const dir = getCacheDir(options, name, version);
   if (isCacheComplete(dir)) {
-    return readCachedCatalog(dir, name, version);
+    const cached = await readCachedCatalog(dir, name, version);
+    if ((cached.index || []).length || Object.keys(cached.components || {}).length) {
+      return cached;
+    }
   }
 
   const packageName = resolvePackageName(remote, options);
+  const writeEmpty = async error => {
+    await fsp.mkdir(dir, { recursive: true });
+    const empty = { index: [], components: {} };
+    await Promise.all([
+      fsp.writeFile(path.join(dir, 'meta.json'), JSON.stringify({ packageName, version, error, builtAt: Date.now() }, null, 2)),
+      fsp.writeFile(path.join(dir, 'index.json'), JSON.stringify(empty.index, null, 2)),
+      fsp.writeFile(path.join(dir, 'components.json'), JSON.stringify(empty.components, null, 2))
+    ]);
+    return { remote: name, version, packageName, error, ...empty };
+  };
+
   const loadOpts = {};
   if (options.ai?.npmRegistry) {
     loadOpts.registry = options.ai.npmRegistry;
@@ -125,43 +140,53 @@ const ensureRemoteCatalog = async (remote, options) => {
     info = await loadNpmInfo(pkgSpec, loadOpts);
   } catch (e) {
     console.warn(`[ai-catalog] load-npm-info failed for ${packageName}@${version}: ${e.message}`);
+    return writeEmpty(e.message);
+  }
+
+  try {
+    const { index, components } = buildCatalogFromReadme(info.readme, name);
     await fsp.mkdir(dir, { recursive: true });
-    const empty = { index: [], components: {} };
     await Promise.all([
-      fsp.writeFile(path.join(dir, 'meta.json'), JSON.stringify({ packageName, version, error: e.message, builtAt: Date.now() }, null, 2)),
-      fsp.writeFile(path.join(dir, 'index.json'), JSON.stringify(empty.index, null, 2)),
-      fsp.writeFile(path.join(dir, 'components.json'), JSON.stringify(empty.components, null, 2))
+      fsp.writeFile(path.join(dir, 'meta.json'), JSON.stringify({ packageName, version: info.version || version, builtAt: Date.now() }, null, 2)),
+      fsp.writeFile(path.join(dir, 'index.json'), JSON.stringify(index, null, 2)),
+      fsp.writeFile(path.join(dir, 'components.json'), JSON.stringify(components, null, 2))
     ]);
-    return { remote: name, version, packageName, ...empty };
+
+    return {
+      remote: name,
+      version: info.version || version,
+      packageName,
+      index,
+      components
+    };
+  } catch (e) {
+    console.warn(`[ai-catalog] build failed for ${packageName}@${version}: ${e.message}`);
+    return writeEmpty(e.message);
   }
+};
 
-  const { index, components } = buildCatalogFromReadme(info.readme, name);
-  await fsp.mkdir(dir, { recursive: true });
-  await Promise.all([
-    fsp.writeFile(path.join(dir, 'meta.json'), JSON.stringify({ packageName, version: info.version || version, builtAt: Date.now() }, null, 2)),
-    fsp.writeFile(path.join(dir, 'index.json'), JSON.stringify(index, null, 2)),
-    fsp.writeFile(path.join(dir, 'components.json'), JSON.stringify(components, null, 2))
+const withTimeout = (promise, ms, label) => {
+  let timer;
+  return Promise.race([
+    Promise.resolve(promise).finally(() => clearTimeout(timer)),
+    new Promise((_, reject) => {
+      timer = setTimeout(() => reject(new Error(`${label} timeout after ${ms}ms`)), ms);
+    })
   ]);
-
-  return {
-    remote: name,
-    version: info.version || version,
-    packageName,
-    index,
-    components
-  };
 };
 
 const ensureRemotesCatalogs = async (remotes, options) => {
   const list = Array.isArray(remotes) ? remotes : [];
-  const catalogs = [];
-  for (const remote of list) {
-    const cat = await ensureRemoteCatalog(remote, options);
-    if (cat) {
-      catalogs.push(cat);
-    }
-  }
-  return catalogs;
+  const timeoutMs = Number(options.ai?.catalogTimeoutMs) > 0 ? Number(options.ai.catalogTimeoutMs) : 20000;
+  const results = await Promise.all(
+    list.map(remote =>
+      withTimeout(ensureRemoteCatalog(remote, options), timeoutMs, remote?.name || 'remote').catch(e => {
+        console.warn(`[ai-catalog] ${remote?.name || '?'}: ${e.message}`);
+        return null;
+      })
+    )
+  );
+  return results.filter(Boolean);
 };
 
 const getExampleCode = (catalogs, { remote, version, component, exampleId }) => {

package/libs/ai/extract-props.js

@@ -0,0 +1,61 @@
+const escapeRegExp = value => String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+const inferPropDef = (code, name) => {
+  if (/^on[A-Z]/.test(name)) {
+    return { type: 'function', defaultValue: '()=>null' };
+  }
+  const access = `props(?:\\?\\.)?\\.${escapeRegExp(name)}`;
+  const orString = code.match(new RegExp(`${access}\\s*(?:\\|\\||\\?\\?)\\s*['"\`]([^'"\`]*)['"\`]`));
+  if (orString) {
+    return { type: 'string', defaultValue: orString[1] };
+  }
+  const orNum = code.match(new RegExp(`${access}\\s*(?:\\|\\||\\?\\?)\\s*(-?\\d+(?:\\.\\d+)?)`));
+  if (orNum) {
+    return { type: 'number', defaultValue: orNum[1] };
+  }
+  const orBool = code.match(new RegExp(`${access}\\s*(?:\\|\\||\\?\\?)\\s*(true|false)\\b`));
+  if (orBool) {
+    return { type: 'boolean', defaultValue: orBool[1] };
+  }
+  if (new RegExp(`${access}\\s*(?:\\|\\||\\?\\?)\\s*\\[`).test(code)) {
+    return { type: 'array', defaultValue: '[]' };
+  }
+  if (new RegExp(`${access}\\s*(?:\\|\\||\\?\\?)\\s*\\{`).test(code)) {
+    return { type: 'object', defaultValue: '{}' };
+  }
+  return { type: 'string', defaultValue: '' };
+};
+
+/** 从生成代码中扫描 props.xxx，补齐 suggestProps 可能漏掉的声明 */
+const extractPropsFromCode = (code, existingProps = {}) => {
+  const text = String(code || '');
+  if (!text.trim()) {
+    return {};
+  }
+  // 去掉 markdown 围栏外壳再扫，避免漏检
+  const stripped = text.replace(/^```(?:jsx|javascript|js|tsx|ts)?\s*/i, '').replace(/```\s*$/i, '');
+  const names = new Set();
+  const re = /props(?:\?\.)?\.([A-Za-z_$][\w$]*)|props\[\s*['"`]([^'"`]+)['"`]\s*\]/g;
+  let match;
+  while ((match = re.exec(stripped))) {
+    const name = match[1] || match[2];
+    if (name) {
+      names.add(name);
+    }
+  }
+  const result = {};
+  names.forEach(name => {
+    if (existingProps && existingProps[name]) {
+      return;
+    }
+    result[name] = inferPropDef(stripped, name);
+  });
+  return result;
+};
+
+const mergeSuggestedProps = (code, suggestedProps, existingProps = {}) => Object.assign({}, extractPropsFromCode(code, existingProps), suggestedProps && typeof suggestedProps === 'object' ? suggestedProps : {});
+
+module.exports = {
+  extractPropsFromCode,
+  mergeSuggestedProps
+};

package/libs/ai/prompts.js

@@ -7,19 +7,55 @@ const stripHtml = html =>
 const LIVE_COMPONENT_SPEC = `
 ## Live 组件规范（必须遵守）
 
-1. 编辑对象是配置里的 content 字段：一段 JSX 表达式源码，不是完整 .js 模块，也不是 PlantUML 编码串。
-2. 运行时会编译为 render(<content>);，因此 content 应是可放入 render(...) 的表达式；不要写 import / export / 外层 render(。
+1. 编辑对象是配置里的 content 字段：一段 **JSX 表达式**源码，不是完整 .js 模块，也不是 PlantUML 编码串。
+2. 运行时会编译为 \`render(<content>);\`，因此 content **只能是可放入 JSX 子节点位置的表达式**（通常是一个根 JSX 元素，或用 \`<>...</>\` / \`(...)\` 包裹的表达式）。
+   - **禁止**写 \`import\` / \`export\` / 外层 \`render(\`。
+   - **禁止**在 content 里写 JS 语句：\`const\` / \`let\` / \`var\` / \`function\` / \`class\` / \`return\` / \`if\` 语句块等。
+   - **禁止**伪代码块：\`<>{ const x = 1; return (<div/>); }</>\` 或 IIFE \`(()=>{...})()\`（除非整段仍是纯表达式且无语句；默认不要用）。
+   - 需要临时数据时，把数组/对象 **内联**在 JSX 属性里，例如 \`options={[{ label: '男', value: '男' }]}\`。
 3. 运行时可用标识：
-   - React、Antd（antd 全量）、props（合并后的组件参数）
+   - React、Antd（antd 全量，但表单场景有额外禁令，见第 8 条）、props（合并后的组件参数）
    - scope 声明的变量名（如 FormInfo ← components-core:FormInfo），另有 PureGlobal
    - libs：仅限当前请求告知的 libKeys，禁止使用未列出的 lib 标识符
 4. 组件选用优先级（强制）：
    1) 远程组件优先（本次 remotes 索引 / 当前 scope 中已有）
-   2) 其次 Antd.*
+   2) 其次 Antd.*（**表单除外，见第 8 条**）
    3) 最后原生 HTML；禁止用 HTML 重复实现已有远程或 Antd 能力
-5. props：{ name: { type, defaultValue } }，代码里用 props.xxx；scope：{ 变量名: 'moduleToken' }。若使用了当前 scope 没有的远程组件，须通过 suggestScope 工具声明 suggestedScope。
+5. props 与 scope（生成时必须显式声明，不能只写在 content 里假设已存在）：
+   - props 形态：\`{ name: { type: 'string'|'number'|'boolean'|'array'|'object'|'function', defaultValue } }\`，代码里用 \`props.xxx\`。
+   - scope 形态：\`{ 变量名: 'moduleToken' }\`（如 \`FormInfo: 'components-core:FormInfo'\`）。
+   - 使用了当前 scope 没有的远程组件 → **必须**调用 \`suggestScope\`。
+   - content 使用了 \`props.xxx\` 且当前 props 没有该字段 → **必须**调用 \`suggestProps\` 补齐声明（含 type 与合理 defaultValue；function 类型 defaultValue 用 \`'()=>null'\`）。
 6. 使用 FormInfo 时字段须落在 <FormInfo.Form> 上下文中（已有则保持；缺失可包一层）。
 7. 保持现有代码风格；不引入 npm 包名式 import。文档示例中的 _FormInfo / @components/FormInfo 在 Live 中应写成 scope 变量 FormInfo + token components-core:FormInfo。
+8. **表单强制规范（最高优先级，覆盖第 4 条的 Antd 选型）**：
+   - 凡涉及表单（录入、校验、提交、表单项布局），**必须**用 \`components-core:FormInfo\` 实现，并确保 scope 含 \`FormInfo: 'components-core:FormInfo'\`（可用 suggestScope）。
+   - **禁止**使用 \`Antd.Form\` / \`Antd.Form.Item\` / \`Antd.Form.List\` 以及把 \`Antd.Input\` / \`Antd.Select\` / \`Antd.DatePicker\` 等当作表单字段直接拼表单。
+   - **禁止** \`const { Input } = FormInfo.fields\` 这类解构（属于 JS 语句，Live 无法运行）。字段必须写成 \`FormInfo.fields.Input\` / \`FormInfo.fields.Select\` 等。
+   - 标准写法示例（注意整段都是 JSX，无 const/return）：
+\`\`\`jsx
+<FormInfo.Form data={{}}>
+  <FormInfo
+    title="基础信息"
+    list={[
+      <FormInfo.fields.Input name="name" label="姓名" rule="REQ" placeholder="请输入姓名" />,
+      <FormInfo.fields.Select
+        name="gender"
+        label="性别"
+        rule="REQ"
+        options={[
+          { label: '男', value: '男' },
+          { label: '女', value: '女' }
+        ]}
+        placeholder="请选择性别"
+      />
+    ]}
+  />
+  <FormInfo.SubmitButton>提交</FormInfo.SubmitButton>
+</FormInfo.Form>
+\`\`\`
+   - 字段必须带 FormInfo 字段契约：\`name\`、\`label\`，校验用 \`rule\` 字符串（如 \`REQ\`、\`REQ EMAIL\`、\`LEN-3-50\`），需要自定义规则时走 FormInfo.Form 的 \`rules\` / \`interceptors\`，不要用 Antd rules。
+   - **自定义字段类型**：不得手写 Antd Form.Item 包装。必须符合 FormInfo 字段规范——优先复用 \`FormInfo.fields.*\`；若确需自定义，只能用表达式方式挂到已有字段能力上，且仍出现在 \`FormInfo\` 的 \`list\` 与 \`FormInfo.Form\` 上下文中（不要在 content 里声明新组件函数）。
 `.trim();
 
 const buildLibsSection = libKeys => {
@@ -91,6 +127,10 @@ const collectHitComponentNames = ({ messages = [], scope = {}, catalogs = [] })
       }
     });
   });
+  // 表单相关需求强制带上 FormInfo 文档命中，便于注入 L2
+  if (/表单|校验|FormInfo|Form\.Item|录入|提交|字段/.test(text)) {
+    hits.add('FormInfo');
+  }
   return Array.from(hits);
 };
 
@@ -106,38 +146,62 @@ const buildRefineSystemPrompt = ctx => {
     detail,
     hasSelection ? `当前讨论范围限定在选中组件：${selectionLabel || '已选中片段'}。` : '当前讨论整份 content。',
     `行为规则：
-1. 推荐组件时遵守：远程 → Antd → HTML。
-2. 涉及 UI 结构时，必须用 ASCII 线框给出 2～4 个方案（A/B/C…），简述差异，请用户选择；选定前不要宣称需求已确认。
-3. 信息与布局都够了后，用短结构化小结（目标 / 改动点 / 选用布局 / 建议组件 / 是否动 props·scope），并明确提示用户点击界面上的「开始生成」按钮。
-4. 不要暗示会自动写代码或自行进入生成阶段。
-5. 不要输出完整组件实现。`
+1. 推荐组件时遵守：远程 → Antd → HTML；但**凡表单必须推荐 FormInfo**，禁止建议 Antd.Form / Form.Item。
+2. 涉及表单时提醒：字段写 FormInfo.fields.*（禁止解构 const），options 等数据内联在 JSX 属性；必须是纯 JSX 表达式；scope 需 FormInfo。
+3. 涉及 UI 结构时，必须用 **HTML 线框示意**给出 2～4 个方案（A/B/C…），简述差异，请用户选择；**禁止 ASCII 字符画**。HTML 必须放在 Markdown 的 \`\`\`html 围栏中（前端会渲染为真实 DOM，不要指望当代码展示）。示例外层可用 class="ui-mock" 或 "layout-mock"。回复整体使用 Markdown。选定前不要宣称需求已确认。
+4. 信息与布局都够了后，用短结构化小结（目标 / 改动点 / 选用布局 / 建议组件 / 是否动 props·scope），并明确提示用户点击界面上的「开始生成」按钮。
+5. 不要暗示会自动写代码或自行进入生成阶段。
+6. 不要输出完整组件实现（可运行 JSX）。`
   ]
     .filter(Boolean)
     .join('\n\n');
 };
 
+const buildCurrentPropsSection = props => {
+  const keys = props && typeof props === 'object' ? Object.keys(props) : [];
+  if (!keys.length) {
+    return '当前组件参数 props：（空）若 content 使用 props.xxx，必须 suggestProps 声明。';
+  }
+  return `当前组件参数 props：\n${JSON.stringify(props, null, 2)}\n若新增 props.xxx，必须 suggestProps 补齐未声明字段。`;
+};
+
+const buildCurrentScopeSection = scope => {
+  const keys = scope && typeof scope === 'object' ? Object.keys(scope) : [];
+  if (!keys.length) {
+    return '当前组件域 scope：（空）若使用远程组件，必须 suggestScope 声明。';
+  }
+  return `当前组件域 scope：\n${JSON.stringify(scope, null, 2)}\n若使用未列出的远程组件，必须 suggestScope 补齐。`;
+};
+
 const buildGenerateSystemPrompt = ctx => {
-  const { libKeys = [], catalogs = [], messages = [], scope = {}, hasSelection, selectionLabel } = ctx;
+  const { libKeys = [], catalogs = [], messages = [], scope = {}, props = {}, hasSelection, selectionLabel } = ctx;
   const hits = collectHitComponentNames({ messages, scope, catalogs });
   // generate：对命中组件 + 索引前列组件提供详情；若无命中则不塞过多
   const detailNames = hits.length ? hits : (catalogs[0]?.index || []).slice(0, 5).map(i => i.name);
   const detail = buildComponentDetailSection(catalogs, detailNames);
   return [
-    '你是 Live content 代码生成器。根据已完善的需求对话，一次产出可直接写入编辑器的源码。',
+    '你是 Live content 代码生成器。根据已完善的需求对话，一次产出可直接写入编辑器的源码，并同步声明所需的 scope / props。',
     LIVE_COMPONENT_SPEC,
     buildLibsSection(libKeys),
+    buildCurrentScopeSection(scope),
+    buildCurrentPropsSection(props),
     buildCatalogIndexSection(catalogs),
     detail,
     hasSelection ? `只输出替换后的选中片段源码（选中：${selectionLabel || ''}）。不要输出整文件。` : '输出替换后的整份 content 源码。',
     `工具：
 - getComponentExample：按示例 id 读取完整示例 code（先看示例目录的 description 再决定是否拉取）。
-- suggestScope：若使用了当前 scope 没有的远程组件，调用此工具声明 { 变量名: 'remote:Component' }。
+- suggestScope：声明需要合并进编辑器「组件域」的 scope，形如 { FormInfo: 'components-core:FormInfo' }。
+- suggestProps：声明需要合并进编辑器「组件参数」的 props，形如 { title: { type: 'string', defaultValue: '标题' } }。
 
 输出契约：
 1. 优先纯代码；不要追问、不要复述需求、不要解释。
-2. 选型：远程 → Antd → HTML。
-3. 只能使用本次 libs 键与 scope∪suggestedScope。
-4. 需要官方示例时根据 description 挑选后调用 getComponentExample。`
+2. **输出必须是纯 JSX 表达式**（可被 \`render(<content>);\` 包裹）；禁止 const/let/return/函数声明，禁止 \`<>{ const ...; return (...); }</>\`。
+3. 选型：远程 → Antd → HTML；**表单必须 FormInfo，禁止 Antd.Form / Form.Item**；字段用 \`FormInfo.fields.Xxx\`，options 内联在 JSX 属性中。
+4. 只能使用本次 libs 键与 scope∪suggestedScope；用到 FormInfo 时必须 suggestScope（若 scope 尚无）。
+5. content 中凡出现 props.xxx，必须已在当前 props 或本次 suggestProps 中声明；不要虚构未声明参数。
+6. 自定义表单字段优先复用 FormInfo.fields；禁止在 content 里新声明组件函数。
+7. 需要官方示例时根据 description 挑选后调用 getComponentExample（优先 FormInfo）；仿写时把示例里的 \`const { Input } = fields\` 改成 \`FormInfo.fields.Input\`。
+8. **工具调用结束后必须再输出完整 JSX 正文**；禁止只调 suggestScope/suggestProps/getComponentExample 而不写代码。不要包 Markdown 说明；若使用代码围栏，仅允许一个 \`\`\`jsx 围栏且围栏内是完整可运行 JSX。`
   ]
     .filter(Boolean)
     .join('\n\n');

package/libs/ai/run.js

@@ -2,6 +2,7 @@ const { streamText, tool, stepCountIs } = require('ai');
 const { z } = require('zod');
 const { buildRefineSystemPrompt, buildGenerateSystemPrompt } = require('./prompts');
 const { getExampleCode } = require('./catalog');
+const { mergeSuggestedProps } = require('./extract-props');
 
 const writeSse = (reply, data) => {
   reply.raw.write(`data: ${JSON.stringify(data)}\n\n`);
@@ -20,6 +21,9 @@ const buildUserMessages = job => {
     if (job.scope && Object.keys(job.scope).length) {
       parts.push(`[当前 scope]\n${JSON.stringify(job.scope, null, 2)}`);
     }
+    if (job.props && Object.keys(job.props).length) {
+      parts.push(`[当前 props]\n${JSON.stringify(job.props, null, 2)}`);
+    }
     if (parts.length) {
       messages.push({ role: 'user', content: parts.join('\n\n') });
     }
@@ -34,6 +38,11 @@ const buildUserMessages = job => {
   return messages;
 };
 
+const propDefSchema = z.object({
+  type: z.enum(['string', 'number', 'boolean', 'array', 'object', 'function']),
+  defaultValue: z.any().optional()
+});
+
 const runAiStream = async (job, reply) => {
   const model = await job.getAIModel();
   if (!model) {
@@ -49,11 +58,14 @@ const runAiStream = async (job, reply) => {
     libKeys: job.libs || [],
     catalogs: job.catalogs || [],
     messages: job.messages || [],
-    scope: job.scope || {}
+    scope: job.scope || {},
+    props: job.props || {}
   };
 
   const system = job.mode === 'generate' ? buildGenerateSystemPrompt(ctx) : buildRefineSystemPrompt(ctx);
   let suggestedScope = {};
+  let suggestedProps = {};
+  let streamedText = '';
 
   const exampleTool = tool({
     description: job.mode === 'generate' ? '按示例 id 读取远程组件文档中的完整示例代码' : '可选：查看某示例代码以便更准确描述需求（refine 阶段仍不要输出业务实现代码）',
@@ -73,7 +85,7 @@ const runAiStream = async (job, reply) => {
       ? {
           getComponentExample: exampleTool,
           suggestScope: tool({
-            description: '声明需要合并进编辑器的 scope（远程组件 token）',
+            description: '声明需要合并进编辑器「组件域」的 scope（远程组件 token）',
             inputSchema: z.object({
               scope: z.record(z.string())
             }),
@@ -81,6 +93,16 @@ const runAiStream = async (job, reply) => {
               suggestedScope = Object.assign({}, suggestedScope, scope || {});
               return { ok: true, suggestedScope };
             }
+          }),
+          suggestProps: tool({
+            description: '声明需要合并进编辑器「组件参数」的 props；content 使用 props.xxx 时必须调用。形如 { title: { type: "string", defaultValue: "标题" } }',
+            inputSchema: z.object({
+              props: z.record(propDefSchema)
+            }),
+            execute: async ({ props }) => {
+              suggestedProps = Object.assign({}, suggestedProps, props || {});
+              return { ok: true, suggestedProps };
+            }
           })
         }
       : {
@@ -97,17 +119,50 @@ const runAiStream = async (job, reply) => {
 
   for await (const part of result.fullStream) {
     if (part.type === 'text-delta') {
-      const text = part.text || '';
+      const text = part.text || part.delta || part.textDelta || '';
       if (text) {
+        streamedText += text;
         writeSse(reply, { text, done: false });
       }
     }
   }
 
+  let finalText = streamedText;
+  try {
+    const fromResult = await result.text;
+    if (typeof fromResult === 'string' && fromResult) {
+      if (!streamedText) {
+        finalText = fromResult;
+        writeSse(reply, { text: fromResult, done: false });
+      } else if (fromResult.length > streamedText.length && fromResult.startsWith(streamedText)) {
+        const rest = fromResult.slice(streamedText.length);
+        finalText = fromResult;
+        if (rest) {
+          writeSse(reply, { text: rest, done: false });
+        }
+      } else if (!streamedText.trim() && fromResult.trim()) {
+        finalText = fromResult;
+        writeSse(reply, { text: fromResult, done: false });
+      }
+    }
+  } catch (e) {
+    // ignore text aggregation errors; streamedText may still be enough
+  }
+
   const donePayload = { done: true };
+  if (!streamedText.trim() && finalText.trim()) {
+    donePayload.text = finalText;
+  }
   if (Object.keys(suggestedScope).length) {
     donePayload.suggestedScope = suggestedScope;
   }
+  // 即使模型未调 suggestProps，也从生成代码扫描 props.xxx 补齐声明
+  if (job.mode === 'generate' && finalText.trim()) {
+    suggestedProps = mergeSuggestedProps(finalText, suggestedProps, job.props || {});
+  }
+  if (Object.keys(suggestedProps).length) {
+    donePayload.suggestedProps = suggestedProps;
+  }
   writeSse(reply, donePayload);
 };
 

package/libs/controllers/entry.js

@@ -368,6 +368,34 @@ module.exports = fp(async (fastify, options) => {
     }
   );
 
+  fastify.post(
+    `${options.prefix}/:shorten/move`,
+    {
+      onRequest: withEntryAuth,
+      schema: {
+        summary: '移动文件或文件夹到目标目录',
+        params: {
+          type: 'object',
+          required: ['shorten'],
+          properties: {
+            shorten: { type: 'string' }
+          }
+        },
+        body: {
+          type: 'object',
+          required: ['id'],
+          properties: {
+            id: { type: 'string' },
+            parentId: { type: ['string', 'null'] }
+          }
+        }
+      }
+    },
+    async request => {
+      return services.node.move(request.authenticatePayload, request.body);
+    }
+  );
+
   fastify.post(
     `${options.prefix}/:shorten/remove`,
     {

package/libs/services/ai.js

@@ -36,6 +36,7 @@ module.exports = fp(async (fastify, options) => {
     const remotes = Array.isArray(body.remotes) ? body.remotes : [];
     const libs = Array.isArray(body.libs) ? body.libs.map(String) : [];
     const scope = body.scope && typeof body.scope === 'object' ? body.scope : {};
+    const props = body.props && typeof body.props === 'object' ? body.props : {};
     const content = typeof body.content === 'string' ? body.content : '';
     const selection = body.selection && typeof body.selection === 'object' ? body.selection : null;
 
@@ -43,16 +44,18 @@ module.exports = fp(async (fastify, options) => {
       throw new BadRequest('messages 不能为空');
     }
 
-    const catalogs = await ensureRemotesCatalogs(remotes, options);
+    // 不在 start 阻塞拉文档索引（易触发网关/代理 504）；在 stream 阶段再确保
     const streamToken = createStreamJob({
       mode,
       messages,
       remotes,
       libs,
       scope,
+      props,
       content,
       selection,
-      catalogs,
+      catalogs: null,
+      catalogOptions: options,
       getAIModel: options.ai.getAIModel
     });
 
@@ -80,6 +83,9 @@ module.exports = fp(async (fastify, options) => {
     });
 
     try {
+      if (!job.catalogs) {
+        job.catalogs = await ensureRemotesCatalogs(job.remotes, job.catalogOptions || options);
+      }
       await runAiStream(job, reply);
     } catch (e) {
       reply.raw.write(`data: ${JSON.stringify({ text: e.message || 'AI 流式失败', done: true })}\n\n`);

package/libs/services/node.js

@@ -227,6 +227,60 @@ module.exports = fp(async (fastify, options) => {
     };
   };
 
+  const isDescendantOf = async (siteId, ancestorId, maybeDescendantId) => {
+    let currentId = toId(maybeDescendantId);
+    const visited = new Set();
+    while (currentId) {
+      if (currentId === toId(ancestorId)) {
+        return true;
+      }
+      if (visited.has(currentId)) {
+        return false;
+      }
+      visited.add(currentId);
+      const current = await models.node.findOne({
+        where: { id: currentId, siteId },
+        attributes: ['parentId']
+      });
+      currentId = toId(current?.parentId);
+    }
+    return false;
+  };
+
+  const move = async (authenticatePayload, { id, parentId }) => {
+    const siteId = getSiteId(authenticatePayload);
+    const node = await findNode(siteId, id);
+    assertWritable(node);
+
+    const targetParentId = toId(parentId);
+    const currentParentId = toId(node.parentId);
+    if (targetParentId === currentParentId) {
+      throw new BadRequest('INVALID_MOVE_TARGET');
+    }
+    if (targetParentId && targetParentId === toId(node.id)) {
+      throw new BadRequest('INVALID_MOVE_TARGET');
+    }
+    if (node.type === 'directory' && targetParentId) {
+      const looping = await isDescendantOf(siteId, node.id, targetParentId);
+      if (looping) {
+        throw new BadRequest('INVALID_MOVE_TARGET');
+      }
+    }
+
+    await resolveParent(siteId, targetParentId);
+    await assertUniqueSiblingName(siteId, targetParentId, node.name, node.id);
+
+    node.parentId = targetParentId;
+    await node.save();
+    return {
+      id: String(node.id),
+      name: node.name,
+      type: node.type,
+      permission: node.permission,
+      parentId: targetParentId
+    };
+  };
+
   const remove = async (authenticatePayload, { ids }) => {
     const siteId = getSiteId(authenticatePayload);
     const idList = Array.isArray(ids) ? ids : [ids];
@@ -272,6 +326,7 @@ module.exports = fp(async (fastify, options) => {
       create,
       save,
       rename,
+      move,
       remove
     }
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kne/fastify-live-components-site",
-  "version": "0.1.1",
+  "version": "0.1.9",
   "description": "Fastify 插件：为 LiveComponentEditor 提供远程站点文件树与短链访问管理",
   "main": "index.js",
   "scripts": {
@@ -42,7 +42,7 @@
   "dependencies": {
     "@kne/load-npm-info": "^0.1.8",
     "@kne/md-doc": "^0.1.24",
-    "ai": "^5.0.220",
+    "ai": "^7.0.37",
     "http-errors": "^2.0.0",
     "lodash": "^4.17.21",
     "zod": "^3.25.76"