CLI 命令
convert-import - 转换导入内容
把 imports 暂存区中的一批旧文档转换为 canonical draft 页面。
`convert-import` 是旧文档迁移的第二阶段:先通过 `import` 暂存,再把指定批次写入 canonical 页面与导航。
Steps
- 先执行 import 获取 importId
- 把暂存批次转换为 canonical 页面
- 检查生成的草稿、导航和报告
- 逐页审核,再发布需要上线的页面
先执行 import 获取 importId
先用 `import` 把旧文档目录放入 `imports/<importId>/` 暂存区。
npx @anydocs/cli import ./legacy-docs ./my-docs-project zh把暂存批次转换为 canonical 页面
拿到 `importId` 后,执行 `convert-import`,把该批次写入 `pages/<lang>/` 并更新目标语言导航。
npx @anydocs/cli convert-import <importId> ./my-docs-project检查生成的草稿、导航和报告
重点核对自动推断出的 `title`、`description`、`slug`,以及导航末尾追加的导入分组是否符合你的信息架构;同时查看转换报告和 warnings。
逐页审核,再发布需要上线的页面
转换结果默认是 `draft`。在 Studio 或 MCP 中整理内容、补细节,并只发布你真正要公开的页面。
为什么默认是 draft: 历史文档导入后不会自动公开,这样可以避免未经审核的旧内容直接进入 reader 与 AI 产物。
两步合并: 如果你希望导入后立即进入转换阶段,可以在 `import` 时加 `--convert`。