SublinkPro 提供了一个面向模板编辑器的 AI 辅助改写工作流：您可以用自然语言描述想要的调整方向，让系统生成候选草稿，再通过编辑模式与对比模式完成审阅、应用和回退。
这是一个强调 人工可见、人工确认、可回退 的特色功能。AI 负责给出候选方案，是否真正写入模板仍由您自己决定。
| 功能 | 说明 |
|---|---|
| 🧠 自然语言改模板 | 直接输入「想怎么改」，AI 会基于当前模板生成候选草稿 |
| 🪟 编辑器内浮动命令栏 | AI 指令输入框悬浮在代码编辑区上方，不会打断正常编辑流程 |
| 🔍 编辑 / 对比双视图 | 可在普通编辑视图与左右对比视图之间切换，像查看代码变更一样审阅 AI 结果 |
| ✅ 本地应用 | AI 草稿不会自动覆盖当前内容，点击“应用”后才会写入编辑器 |
| ↩️ 本地回退 | 对 AI 结果不满意时，可回退到最近一次应用前的编辑器内容 |
| ⚙️ 系统级设置接入 | 模板 AI 使用系统中的设置 -> AI 助手配置作为生成入口 |
AI 模板编辑特别适合下面这些任务：
- 为现有模板补充新的代理组、规则段或注释
- 在不大改整体结构的前提下，优化模板可读性
- 把口语化思路快速变成一版可审阅的候选模板
- 先生成再对比，减少手工改 YAML / INI 的成本
它更适合“在已有模板基础上改写”，而不是完全替代您的审阅过程。
要使用模板 AI，您需要先完成 AI 助手设置。
进入：
设置 -> AI 助手
至少需要完成这些配置：
- Base URL
- 模型名称
- API Key
可选的 Max Tokens 默认值为 400000；如果在设置页填写 0，系统会使用该服务端默认值。
Important
当前 AI 助手仅支持提供 /responses endpoint 的服务。如果某个服务只支持 /chat/completions 或其他兼容层，而不支持 /responses，则无法用于本项目的 AI 模板编辑与连接测试。
Tip
模板编辑器中的 AI 功能使用的是 设置 -> AI 助手 中保存的系统级配置。建议先完成配置并测试连接，再回到模板编辑器生成草稿。
如果模板页提示：
AI 助手当前不可用AI 设置不完整
请前往：
设置 -> AI 助手
检查是否已启用 AI，并确认 Base URL、模型名称和 API Key 已正确填写。
同时请确认该 Base URL 对应的 AI 服务实际支持 /responses endpoint；仅有传统 chat/completions 能力的接口当前不可用。
进入模板管理页面后，您可以：
- 新建模板
- 编辑已有模板
在编辑器中先准备一份基础模板内容，再输入 AI 指令会更稳定。
在编辑器上方的浮动 AI 命令栏中，用自然语言描述您希望的改动。
例如：
保留现有结构，增加一个自动选择香港节点的策略组不要移除注释，帮我把规则段整理得更清晰将这份模板改得更适合常规 Clash 使用场景
点击 生成 后，系统会基于：
- 当前模板内容
- 当前分类（如 Clash / Surge）
- 当前规则来源及相关配置
- 您输入的 AI 指令
生成一份候选草稿。
生成成功后，编辑器会自动进入 对比模式，方便您直接查看改动前后差异。
Note
生成过程中，AI 命令输入框会被临时禁用，避免在同一次生成尚未完成时继续修改指令，造成状态混乱。
模板编辑器支持两种主视图：
- 用于直接修改当前模板内容
- 适合做最终手工微调
- 只有在编辑模式下才能保存模板
- 左侧显示生成前的原始模板
- 右侧显示 AI 生成的候选草稿
- 适合像查看代码变更一样快速确认改动
如果您只是想判断 AI 有没有改对，优先看 对比模式。
如果您已经决定采纳这次生成结果，再点击 应用 将草稿写回编辑器。
点击浮动命令栏中的 对勾按钮，会把当前 AI 候选草稿写入编辑器。
应用后的特点：
- 编辑器正文会变成 AI 草稿内容
- 您可以继续手工修改
- 之后可以正常保存模板
如果刚刚应用了 AI 草稿，但又想回到应用前的内容，可以点击 回退按钮。
回退后的特点：
- 仅恢复最近一次本地应用前的编辑器内容
- 不影响其他模板
- 适合快速试错
Important
AI 草稿不会在生成后自动写入模板。只有您点击“应用”之后，候选内容才会进入编辑器正文。
比起简单说“帮我优化”，更推荐说明：
- 要保留什么
- 想新增什么
- 哪些段落不要碰
例如：
保留现有注释和节点占位结构，只新增一个手动切换的日本策略组。
如果模板较长，建议把需求拆成多次生成：
- 先调整策略组
- 再整理规则段
- 最后优化注释或命名
这样更容易审阅，也更容易回退。
推荐顺序是：
- 输入指令
- 生成
- 在对比模式确认差异
- 应用到编辑器
- 手工微调并保存
这也是当前最稳妥、最符合这个功能设计的使用方式。
说明当前系统中的 AI 助手尚未启用。
请前往：
设置 -> AI 助手
启用 AI 助手并保存设置。
通常说明下列配置至少有一项缺失：
- Base URL
- 模型名称
- API Key
请前往：
设置 -> AI 助手
完成配置后再回来生成。
因为 对比模式 是只读审阅视图，不是最终编辑态。
请先点击 应用，把候选内容写回编辑器，再切回编辑模式保存。
如果您在生成后又修改了：
- 模板正文
- 文件名
- 分类
- 规则来源
- 代理下载相关配置
那么当前 AI 草稿就可能不再对应最新上下文，需要重新生成。
回退只针对最近一次本地应用 AI 草稿。
如果您还没有点击过“应用”，或者已经清除了这次本地快照，就不会有可回退内容。
- 把 AI 生成结果当作“候选方案”，而不是最终答案
- 生成后优先查看对比，再决定是否应用
- 对关键模板建议保留原始版本，逐步调整
- 如果结果方向不对，优先修改指令重新生成，而不是在错误草稿上继续堆叠修改
Tip
最理想的使用方式不是“让 AI 一次生成最终模板”，而是“让 AI 先给出一版高质量草稿，然后由您快速审阅、应用并微调”。这样效率最高，也最安全。