AI 助手

Kiny Editor 带一个可选的 AI 面板。它能在项目上下文里回答问题、创建节点、修改文本并运行校验；不用 AI 也不会少任何 Kin 语言、预览或导出能力。

AI 只在桌面编辑器里提供。你正在阅读的网页文档站，以及页面里的“运行”示例，都没有 AI 功能。

打开面板

从视图 → AI 面板打开右侧栏。顶部可以新建对话、查看本项目的历史对话，或关闭面板；左边缘可以拖动调宽。

首次打开会显示“未配置”。点前往「设置 · AI」，或者从视图 → 设置… → AI进入配置。

连接你自己的模型服务

当前编辑器连接 OpenAI 兼容的 chat/completions 接口，需要三项：

• Base URL——供应商接口的基础地址；
• 模型——该服务实际提供的模型名；
• API Key——你在供应商处申请的密钥。

请求从本机直接发往你填写的 endpoint，不经过 Kiny 服务器；额度、数据处理和可用性由你选择的服务负责。不同供应商对 OpenAI 兼容接口的支持程度不同，模型名和地址以供应商当前文档为准。

API Key 会以明文保存在本机应用存储里，并未加密。不要在共享或公用设备上长期保存；用完可以在设置中“清除”并保存。密钥不要写进 .kin、项目清单、截图或聊天提示。

AI 能看到和改到什么

对话围绕当前项目进行。AI 可以调用编辑器提供的工具读取文件、修改文本，再运行项目校验。文本改写通常先进入可审查、可撤销的编辑缓冲；但 AI 也能调用保存、创建文件或文件夹、重命名和删除等工具，这些操作会直接改动磁盘。工具执行记录会显示在回复里——让它动手前先说清允许改什么，重要项目先用版本管理或副本留好退路。

你可以这样提问：

• “列出从 栈桥 能到达的节点，找出没有出口的分支。”
• “给酒馆场景补两个只出现一次的调查选项，不要改现有结局。”
• “解释问题面板里的这条错误，只告诉我原因，先不要改文件。”

要求越具体，越容易核对。把目标节点、不能改的部分和验收条件写进提示，比只说“帮我润色”更可控。

作者仍然负责验收

AI 可能误解情节、写出能编译但不好读的分支，也可能给出错误的语法。每次修改后至少做三件事：

1. 查看源码差异，确认它只改了你授权的范围；
2. 清空问题面板里的新错误和警告；
3. 在预览里亲自走一遍受影响的选择。

需要停下正在运行的请求时，点面板底部的停止。AI 运行期间编辑区暂时只读，是为了避免作者输入和工具修改互相覆盖；请求结束后会恢复。

对话记录

历史对话只存在本机应用数据目录。设置里可以指定多少天后自动清理不再活动的对话，也可以关闭自动清理；删除某条历史不会删除作品文件。发送给模型的具体数据仍受所选供应商的隐私条款约束。

把 AI 当成一个会使用编辑器工具、但需要复核的协作者就好。作品能否发布，最终仍由真实诊断、预览和你的阅读判断决定。