AI 创作助手 (AiAssistant)使用方法

在后台撰写文章/页面时，右侧会出现一个 AI 对话框：输入内容后可让 AI 制作标题、正文、摘要、标签，并一键推送到对应的输入框；也支持自由对话。兼容 PHP 8.3+，适配 Typecho 1.3 正式版。

一、安装

将 AiAssistant 文件夹上传至 Typecho 站点的 usr/plugins/ 目录（或后台「控制台 → 插件 → 上传」安装 zip 包）。
后台「控制台 → 插件」中找到 AI 创作助手，点击启用。
点击插件下方的设置，配置模型服务商与 API Key（见下文）。

要求：PHP 8.3 及以上；服务器可访问外网（调用大模型接口需要出网权限）；建议开启 cURL 扩展（未开启时插件自动降级为 stream 方式请求）。

二、配置模型（插件设置面板）

服务商选择（下拉框）

按推荐优先级排列：

国内 · 免费（优先推荐，注册即用）

服务商	默认模型	API Key 获取地址	说明
智谱 GLM	glm-4.5-flash	https://open.bigmodel.cn	flash 系列模型免费，注册即可用；新模型（如 glm-5.3-flash）可在「模型名称」覆盖
讯飞星火	lite	https://console.xfyun.cn	Spark Lite 免费；密钥填控制台的 APIPassword

国内 · 其他

服务商	默认模型	API Key 获取地址
阿里通义千问	qwen-flash	https://bailian.console.aliyun.com （新用户有免费额度）
DeepSeek	deepseek-chat	https://platform.deepseek.com
字节豆包	doubao-seed-1-6-flash	https://console.volcengine.com/ark （模型名可填接入点 ID `ep-xxxx`）
百度千帆	ernie-speed-128k	https://console.bce.baidu.com/qianfan
月之暗面 Kimi	moonshot-v1-8k	https://platform.moonshot.cn

国外大厂

服务商	默认模型	API Key 获取地址
OpenAI	gpt-4o-mini	https://platform.openai.com
Anthropic Claude	claude-3-5-haiku-latest	https://console.anthropic.com
Google Gemini	gemini-2.0-flash	https://aistudio.google.com

自定义接口（两类）

【自定义】OpenAI 兼容接口：适用于各类中转站、OneAPI、Ollama、LM Studio 等任何兼容 chat/completions 的服务。
【自定义】Anthropic 格式接口：Claude 系中转。

自定义时需填写：接口地址（完整 chat completions 地址）、API Key、模型名称。

其他设置项

设置项	默认值	说明
API Key	空	所选内置服务商的密钥
模型名称	空	留空用内置默认；服务商出新模型时可在此覆盖
温度 temperature	0.7	0~2，越大越发散
单次最大 Token	2048	生成长度的上限
请求超时(秒)	60	调用模型接口的超时时间
写作语言	中文	AI 输出所用语言
角色设定(persona)	空	追加到系统提示词，例如「你是资深科技博主，文风幽默」
摘要自定义字段名	excerpt	Typecho 没有内置摘要框，生成的摘要写入这个自定义字段；SEO 主题一般用 `description`，按你主题的要求修改
正文推送方式	追加	「追加」= 推送时保留原正文；「替换」= 推送时经确认后覆盖全文

配置完成后保存，回到「管理 → 撰写新文章」即可看到右侧的 AI 对话框。

三、撰写页功能

打开「管理 → 撰写文章」（独立页面同样支持），右侧出现 AI 创作助手 面板：

快捷按钮（生成后自动推送）

标题：根据你输入的主题/要求 + 当前正文，生成一个博客标题 → 自动填入 标题框。
正文：根据输入的主题生成 Markdown 正文 → 自动写入 正文编辑框（空正文直接写入；已有内容按设置的「追加/替换」方式处理）。
摘要：根据当前正文生成约 100 字摘要 → 自动写入 自定义字段（默认 excerpt，字段不存在时自动新建一行；无正文时会提示先写正文）。
标签：根据当前正文提取 3~8 个标签 → 自动加入 标签框（独立页面无标签框时会提示）。

自由对话

下方输入框输入任意内容，回车（或点「发送」）即可与 AI 对话，例如：

「帮我把正文改写得更口语化，先给我第一段」
「围绕这个主题列一个大纲」
「给这篇文章想 3 个不同风格的标题」

每条 AI 回复下方都有四个按钮：推送标题 / 推送正文 / 推送摘要 / 推送标签，点击即可将回复内容填入对应输入框。

其他

面板可点击「—」收起，收起后通过右上角蓝色「AI 助手」按钮再次展开（状态会记住）。
面板头部显示当前服务商与模型，点击可跳转到插件设置。

四、常见问题

Q: 提示「请先在控制台-插件-AI创作助手-设置中保存服务商与密钥」？
A: 未保存插件配置，去设置面板填好 Key 并保存。

Q: 提示「API Key 无效或无权限 (xxx 401)」？
A: 检查 Key 是否填错、是否选择了对应服务商；智谱/星火等需在官网开通模型服务。

Q: 摘要写到哪了？前台怎么显示？
A: 写入文章自定义字段（默认 excerpt）。主题模板中可用 $this->fields->excerpt 输出；如主题使用 description 字段做 SEO，把设置里的字段名改为 description 即可。

Q: 想用本地 Ollama / LM Studio？
A: 选择「【自定义】OpenAI 兼容接口」，地址填 http://127.0.0.1:11434/v1/chat/completions（Ollama），Key 随意填，模型名填本地模型（如 qwen2.5:7b）。

Q: 豆包/千帆调用报 404？
A: 模型名不对。豆包可填接入点 ID（ep-xxxx），千帆确认已开通对应模型；均可在设置「模型名称」中覆盖。

安全说明：AJAX 端点要求登录且为投稿人及以上权限，并校验 Typecho 表单令牌（防 CSRF）；API Key 保存在站点数据库配置中，仅后台服务端使用，不会输出到页面。

文章目录

AI 创作助手 (AiAssistant)使用方法

Typecho AI 创作助手 (AiAssistant) 插件使用说明