AI 开发助手

作用：不会写 PHP 也能加功能 —— 说清楚要什么，它把代码写好给你确认。

出错 → 看 排错手册。

怎么装#

1. 登录后台
2. 左侧点「插件」
3. 找到「AI 开发助手」
4. 点「安装」，再点「启用」

怎么填模型#

1. 左侧点「AI 开发助手」
2. 点右上角「模型设置」
3. 只填三项：

1. 点「测试连通」
2. 看到成功提示 → 点「保存」

支持哪些？ 任何兼容 OpenAI Chat Completions 协议的服务： DeepSeek、通义、智谱、Kimi、火山、OpenAI、本地 Ollama / vLLM 都能用。 用 Claude 官方接口的选 Anthropic 协议。

换模型只改上面三行，不用改代码。

怎么用命令#

回到工作台，在输入框里打字。想指定任务类型就用命令开头：

命令后面换行写需求：

/plugin 名称=seo-tools
需求：内容保存时自动按正文首段生成 description

不想记命令？ 工作台右上角的下拉框能切换模式，/命令 只是更快。

怎么带上文件一起问#

带上原文，答案准确率会高很多。

1. 点输入框左边的文件选择框
2. 挑 1-6 个站点文件（比如要改的那个）
3. 再输入需求，发送

配置文件和密钥是禁区，选不到，也读不走。

看服务器与数据库#

不用你填写任何服务器信息——助手自动知道这些（都写进了提示词）：

• 服务器：PHP 版本、运行模式、操作系统、站点根目录
• 数据库：驱动、库名、表前缀

找"数据在哪张表"：文件选择框第一项是 db/schema.md（数据库表结构）， 勾上它再提问，AI 就能看到全部数据表的字段、类型、索引和行数 （只有表结构元数据，不含任何行数据，也不含数据库口令）。

比如问"题库在哪张表"，勾上它，AI 会直接告诉你表名和字段含义。

它凭什么写得对#

系统提示词里写死了这套 CMS 的规矩：

外加当站实况：版本、PHP、数据库驱动、已启用插件、已装主题、内容模型。

改了核心规范 → 记得同步 plugin/ai/src/PromptLibrary.php。

怎么固化团队约定#

作用：让 AI 每次都遵守你的规矩（例如"插件必须带 uninstall.php"）。

1. 「AI 开发助手」→「模型设置」
2. 拉到最下面，找「附加规则」
3. 写上你的约定
4. 保存

这里的文字会作为优先级最高的指令一起发给模型。

它不会乱写#

以下限制写死在代码里，不因配置放宽：

想让它只给代码、不碰文件？ 后台 → 插件 → AI 助手 → 配置，把 allow_write 关掉。

出问题怎么办#

怎么自测（给开发者）#

php tests/ai_plugin_selfcheck.php     # 179 项：白名单、拦截、备份回滚、密钥加密、解析
php tests/ai_admin_smoke.php           # 25 项：后台页面与接口的 HTTP 冒烟（需先起服）
php tests/ai_e2e_mock.php              # 20 项：设置→对话→落盘→回滚 全链路（用假接口）

相关章节#

• 手工写插件 → 插件开发
• 改完不生效 → 缓存怎么清、缓存名怎么改