白博客

随便写写 自己的项目之类的记录

AIPolish - Typecho AI 文章一键润色插件

AIPolish 是一款为 Typecho 博客系统打造的写作辅助插件。它可以直接嵌入 Typecho 的文章和页面编辑器,提供正文一键润色、标题润色,以及根据正文生成标题等功能。

写这个插件的初衷,是想给个人博主一个顺手好用的写作辅助工具。通过内置的去 AI 腔提示词和历史文风学习机制,润色后的文字能尽量保留博主自己的写作习惯,不会写出来一股套路味。

Github项目链接 https://github.com/Whbgz/AIPolish
方便的话给我点个Star~

博客文章链接 https://www.baiboke.cn/archives/161/

image.png


核心功能

1. 流式响应 (SSE)

基于 HTML5 Server-Sent Events (SSE) 技术,润色过程采用流式输出。文字会实时逐字填入编辑器,并配合字数接收统计,整个交互过程比较顺滑,不用干等。

2. 一键撤销

每次润色完,如果在右侧对比里觉得效果不太理想,点一下“撤销”(或“撤销润色”)按钮,就能把文本瞬间还原回润色前的样子。如果之前是部分选中润色,撤销时也会精准恢复到原来选中的那段。

3. 上下文感知

AI 润色不再是孤立的字面处理:

  • 正文润色时:插件会自动把当前文章的标题一起发给 AI 作为上下文,让它能结合主题来优化。
  • 标题润色或生成时:自动抓取正文前 1000~2000 字作为参考,生成出来的标题会更贴近文章实际内容。

4. 历史文章文风学习

为了避免写出“AI 腔”,插件在发起请求时,会自动从数据库里取出当前作者最近发布的 3 篇文章(每篇截取前 300 字作为文风样本)一起喂给 AI。配合系统提示词里的“去 AI 味”指令,AI 会学习并模仿你真实的写作风格和句式习惯。

5. 原生 UI 与连通性测试

  • 原生适配:按钮直接用了 Typecho 后台自带的 .btn .btn-s 样式类,没加任何多余的装饰,能很好地适配各种后台主题(包括暗黑模式)。
  • 即时测试:插件设置页面提供了“测试连接”功能。直接读取当前表单里填的值,发一个消耗极低的迷你请求,验证接口和 Key 是否可用,不用反复保存配置。

安装方法

  1. 下载插件源码,把文件夹命名为 AIPolish
  2. AIPolish 文件夹上传到 Typecho 安装目录的 /usr/plugins/ 下。
  3. 登录 Typecho 后台,进入 控制台 -> 插件
  4. 找到 AIPolish 插件,点击 启用
  5. 点击插件右侧的 设置 按钮,配置 API 接口信息。

插件配置

AIPolish 兼容所有遵循 OpenAI 标准的 API 接口(如 OpenAI、DeepSeek、各种中转 API 等):

配置项说明示例
接口地址 (API URL)服务商提供的 Chat 接口地址https://api.deepseek.com/chat/completions
API Key在平台申请的 API 密钥sk-xxxxxxxxxxxxxxxx
模型名称 (Model Name)指定调用的模型代号deepseek-chatgpt-4o
系统提示词内置的默认润色规则(可自由修改)规定保留 Markdown 格式、语气等
提示:配置填完后,先不用保存,可以直接点 测试连接。看到连接成功并能正常返回测试结果后,再点保存就行。

注意事项

  1. Markdown 格式保护:默认的系统提示词经过了细致调优,能保证文章里的图片标记(如 ![image.png][4] 这种形式)、链接、加粗、代码块等 Markdown 标记不会被 AI 改动或删掉。
  2. 局部润色:在编辑器里,如果鼠标选中了部分文字,点“AI 一键润色”就只润色选中的那段;如果没选中任何内容,则默认对整篇文章进行润色。

关于作者

使用过程中有任何问题,欢迎提交 Issue 或 Pull Request,一起把这个插件做得更好。

文章评论已关闭