QQ扫一扫联系
本模块用于接收人工智能工具生成或整理的 Markdown 文档。人工智能工具先读取网站当前启用的语言和文档分类,再检查准备提交的内容,最后创建待审核任务。
管理员可以在后台逐篇查看标题、语言、分类和正文。确认无误后发布,不适合发布的文档可以填写原因并驳回。
当前只接收扩展名为 .md 或 .markdown 的文档。
安装本模块前,请先安装并启用:
安装步骤:
后台菜单如下:
内容管理
└─ AI驱动导入
├─ AI API 客户端
├─ AI API 调用审计
├─ AI 导入任务
└─ AI 接入说明
如果菜单没有出现,请先确认模块已经启用,再检查当前管理员是否拥有相应权限。
进入模块设置后可以调整以下内容:
| 设置项 | 默认值 | 说明 |
|---|---|---|
| 启用 AI 导入 API | 开启 | 关闭后,所有外部导入请求都会被拒绝 |
| 允许 API 直接发布 | 关闭 | 开启后仍需客户端拥有直接发布权限;普通使用建议保持关闭 |
| 单批最大文档数 | 50 | 每次允许提交的文档数量,系统实际允许范围为 1~200 |
正式使用时建议保留人工审核,不要为普通客户端开启直接发布。
“直接发布文档”可以跳过人工审核,普通客户端不要勾选。
创建成功后,打开“查看接入”,页面会显示:
网站接口地址根据当前网站配置自动生成,不需要手工修改模块代码。建议把三项内容保存到人工智能工具提供的安全变量中:
RESDOC_BASE_URL
RESDOC_APP_ID
RESDOC_APP_SECRET
不要把客户端密钥保存到 Markdown、源码、版本库或公开对话中。
在“查看接入”页面点击“发送测试请求”。连接成功时,页面会显示网站语言和分类的数量。
测试只检查网站地址、客户端密钥、权限和访问限制,不会创建任务,也不会发布文档。
压缩包根目录中的 suite-manifest.json 是版本和文件清单,只用于核对套件是否完整,不需要复制到技能安装目录。
“查看接入”页面提供三种提示词:
把不含密钥的一键提示词发送到需要整理的当前对话后,工具应直接完成以下工作:
fileMD_YYYYMMDDhhmmss 文件夹。如果目录不可写、技能缺失、安全变量未配置、分类不可靠或网站返回失败,工具应停止并说明原因,不能把未完成的操作报告为成功。已经生成的本地文件应保留,方便修正后重新提交。
如果要导入已有文件,应明确告诉人工智能工具文件夹和语言,例如:
请导入 D:\Docs\待发布 目录中的 Markdown 文档,语言为 zh-CN。
只读取这个目录中的 .md 和 .markdown 文件。
请使用网站提供的核心提示词完成分类、检查并创建待审核任务。
不要要求工具扫描整个磁盘,也不要授权读取与本次导入无关的目录。
新增同一主文档的其他语言内容时,需要提供准确的主文档编号。更新已有语言内容时,需要提供准确的内容记录编号和最新内容摘要。如果无法唯一确认目标,工具应停止,不能只按标题猜测并覆盖。
也可以批量处理所有仍在等待审核的文档。系统会逐篇保存并显示处理进度,只有实际保存成功的文档才计入成功数量。部分文档失败时,应打开对应文档查看原因,修正后用新的请求编号重新提交。
| 入口 | 用途 |
|---|---|
| AI API 客户端 | 创建、查看、停用和轮换客户端密钥,设置权限及调用限制 |
| AI API 调用审计 | 查看调用时间、接口、结果和错误原因,不显示完整密钥及文档正文 |
| AI 导入任务 | 查看任务和文档,逐篇或批量审核 |
| AI 接入说明 | 查看使用说明、新手示例、接口文档、技能安装方法和提示词 |
普通用户不需要自己编写调用代码。接口路径、请求字段、签名方法和手工调试示例统一放在“AI 接入说明-接口文档”中。
file:// 地址或网络共享路径作为文档资源。检查网站接口地址、客户端编号和客户端密钥是否正确;再检查客户端是否启用、是否过期、当前访问地址是否在允许范围内,以及电脑时间是否准确。
“检查文档”只验证内容,不会保存任务。应确认工具继续执行了“创建待审核任务”,并返回了真实的任务编号。
新任务默认等待审核。管理员需要进入任务详情,审核通过后文档才会发布。
检查 Markdown 中是否仍使用本机路径或相对路径。请先把资源上传到网站,再改为站内地址或安全的网络地址。
同一请求编号只能重试完全相同的内容。文档内容发生变化后,应生成新的请求编号。
打开任务详情查看每篇文档的处理结果。已经发布成功的文档不会撤销,只需修正失败内容并重新提交。