多语言文档 AI 驱动导入（I18nDocumentAiImport）简化版演示说明

适用版本：1.1.7
演示目的：展示人工智能工具生成 Markdown、提交审核、后台发布的完整流程。

一、演示前准备

请确认以下模块已经安装并启用：

• I18nDocument；
• I18nDocumentMarkdown；
• I18nDocumentAiImport。

后台应能看到：

内容管理
└─ AI驱动导入
   ├─ AI API 客户端
   ├─ AI API 调用审计
   ├─ AI 导入任务
   └─ AI 接入说明

演示时建议关闭“允许 API 直接发布”，让文档先进入后台审核。

二、创建客户端密钥

1. 进入“内容管理－AI驱动导入－AI API 客户端”。
2. 填写客户端名称。
3. 有效期保持默认 30 天。
4. 选择读取分类、检查文档和创建任务三项权限。
5. 点击“创建客户端密钥”。

创建完成后会得到网站接口地址、App ID 和 App Secret。

三、测试连接

1. 在客户端列表点击“查看接入”。
2. 点击“发送测试请求”。
3. 页面显示“连接成功”，并显示语言数量和分类数量。

这一步只检查网络、密钥和权限，不会创建任务，也不会发布文档。

四、安装示例 Skill

1. 进入“AI 接入说明－新手示例－示例 Skill 安装”。
2. 下载 1.2.1 示例套件。
3. 解压后，把四个 Skill 文件夹复制到页面列出的工具目录。
4. 完全退出并重新打开 Codex、WorkBuddy、Trae 或 Qoder。

压缩包中的 suite-manifest.json 只用于核对版本，不需要复制到 Skill 目录。

五、配置人工智能工具

把“查看接入”页面中的三项内容保存到人工智能工具的安全变量中：

RESDOC_BASE_URL
RESDOC_APP_ID
RESDOC_APP_SECRET

不要把 App Secret 写入文档、项目源码、版本库或公开对话。

六、生成并提交文档

1. 在“查看接入”页面点击“复制不含密钥的一键提示词”。
2. 把提示词发送到需要整理的当前对话。
3. 人工智能工具会在当前工作目录创建 fileMD_YYYYMMDDhhmmss 文件夹。
4. 工具会整理当前完整对话，生成 Skill 和经验文章。
5. 工具会读取网站最新语言和分类，检查文档并创建待审核任务。
6. 完成后会返回 requestId 和 taskId。

如果没有返回 taskId，表示任务没有真正创建成功，不能继续按成功流程演示。

七、审核并发布

1. 进入“内容管理－AI驱动导入－AI 导入任务”。
2. 根据 taskId 或 requestId 找到刚创建的任务。
3. 打开“查看文档与审核”。
4. 检查标题、语言、分类、正文和安全提示。
5. 对正确的文档点击“审核通过并发布此文档”。
6. 对有问题的文档填写原因后点击“驳回此文档”。

也可以使用批量处理功能。批量发布会逐篇执行，页面显示的成功数量只统计实际保存成功的文档。

八、确认最终结果

发布后检查：

• 文档是否出现在正确分类；
• 标题和语言是否正确；
• Markdown 排版是否正常；
• 图片和附件是否可以访问；
• 任务成功数量是否与实际发布数量一致。

最后进入“AI API 调用审计”，确认本次读取分类、检查文档、创建任务和查询状态的调用记录完整。

九、演示通过标准

同时满足以下条件，即可认为演示通过：

• 客户端密钥创建成功；
• 测试连接成功；
• 人工智能工具生成了本地 Markdown 文件；
• 后台收到待审核任务；
• 管理员可以逐篇发布或驳回；
• 正式文档内容和分类正确；
• 调用记录中不包含 Markdown 正文和完整密钥。

十、安全提醒

• 演示过程中不要展示完整 App Secret。
• 不要使用包含真实密钥的提示词进行公开演示。
• 不要上传原始对话、密码、环境变量或版本库凭证。
• 演示完成后，可以停用测试客户端或轮换密钥。

模块介绍

“多语言文档 AI 驱动导入”用于连接 Codex、WorkBuddy、Trae、Qoder 等人工智能工具与多语言文档系统。人工智能工具可以整理对话或读取用户指定的 Markdown 文件，按照网站现有分类提交文档；管理员在后台检查内容后再决定发布或驳回。

模块只接收 .md 和 .markdown 文档。网站语言、文档分类和接口地址均从当前系统读取，不需要在提示词中写死。

适用场景

• 把当前人工智能对话整理成操作方法、问题解决记录或可重复使用的技能文档；
• 批量导入用户指定文件夹中的 Markdown 文档；
• 为同一篇文档增加其他语言内容；
• 在准确确认原文档后更新已有内容；
• 配合人工智能工具的定时任务，持续生成文档并提交后台审核。

主要功能

• 为不同人工智能工具创建独立的客户端密钥，可设置权限、有效期、访问地址和调用次数；
• 自动提供网站当前启用的语言和文档分类，避免提交到不存在的分类；
• 提交前检查文件名、标题、语言、分类和 Markdown 正文；
• 默认创建待审核任务，支持逐篇发布、逐篇驳回和批量处理；
• 按每篇文档的实际处理结果统计成功与失败数量；
• 支持安全重试，减少网络重试造成的重复任务；
• 提供示例技能包、完整示例提示词和用户自定义提示词所需的核心内容；
• 提供 Codex、WorkBuddy、Trae、Qoder 的接入说明和浏览器连接测试；
• 记录接口调用时间、结果和错误原因，不保存完整密钥及 Markdown 正文；
• 网站接口地址根据当前网站配置自动生成，兼容反向代理和子目录访问。

使用流程

1. 安装并启用依赖模块及本模块。
2. 在“AI API 客户端”中创建客户端密钥。
3. 打开“查看接入”，保存三项安全配置并发送测试请求。
4. 按“AI 接入说明”安装示例技能包，复制适合的提示词。
5. 让人工智能工具生成或读取 Markdown，获取最新分类并创建待审核任务。
6. 在“AI 导入任务”中逐篇检查，确认后发布，不合适的内容可以填写原因并驳回。

安全说明

• 普通客户端默认只创建待审核任务，不直接发布文档；
• 直接发布必须同时开启模块设置并授予客户端相应权限；
• 更新已有内容时必须提供准确的文档记录和最新内容摘要，不能只按标题猜测并覆盖；
• 客户端密钥应保存到人工智能工具的安全变量中，不应写入文档、源码、版本库或公开对话；
• 模块不会让服务器下载远程资源，也不会接受本机磁盘路径作为图片或附件地址。

运行要求

• Vendor 4.8.0 及以上；
• I18nDocument 1.6.0 及以上；
• I18nDocumentMarkdown 1.1.0 及以上；
• ModStart 5.0.0 及以上；
• 支持 Laravel 5 和 Laravel 9 运行环境。

后台菜单

• 内容管理
• 内容管理 → AI驱动导入
• 内容管理 → AI驱动导入 → AI API 客户端
• 内容管理 → AI驱动导入 → AI API 调用审计
• 内容管理 → AI驱动导入 → AI 导入任务
• 内容管理 → AI驱动导入 → AI 接入说明
• 内容管理 → AI驱动导入 → AI API 客户端密钥接入凭证
• 内容管理 → AI驱动导入 → AI API 客户端密钥新增
• 内容管理 → AI驱动导入 → AI API 客户端密钥轮换
• 内容管理 → AI驱动导入 → AI API 客户端密钥状态
• 内容管理 → AI驱动导入 → AI 导入任务详情
• 内容管理 → AI驱动导入 → AI 导入任务审核通过
• 内容管理 → AI驱动导入 → AI 导入任务驳回
• 内容管理 → AI驱动导入 → AI 导入任务逐文档审核通过
• 内容管理 → AI驱动导入 → AI 导入任务逐文档驳回
• 内容管理 → AI驱动导入 → AI Skill 套件下载