Anydocs Documents
CLI 命令

convert-import - 转换导入内容

把 imports 暂存区中的一批旧文档转换为 canonical draft 页面。

`convert-import` 是旧文档迁移的第二阶段:先通过 `import` 暂存,再把指定批次写入 canonical 页面与导航。

Steps

  1. 先执行 import 获取 importId
  2. 把暂存批次转换为 canonical 页面
  3. 检查生成的草稿、导航和报告
  4. 逐页审核,再发布需要上线的页面

先执行 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`。