docs(agent): 补齐 AI 修改动作与暂存写回流程

docs/v2/features/action-panel/action-drafts.md

@@ -41,6 +41,21 @@ Quicker V2 新增了本机动作暂存区。它适合保存尚未确定放置位
 
 超过 30 天没有活动的暂存动作会显示清理提示，但 Quicker 不会据此自动删除。确认不再需要后，应由用户手工丢弃。
 
+## 新动作与已有动作的编辑副本
+
+暂存区既可以保存新动作，也可以保存 AI 修改已有正式动作时建立的编辑副本。两者完成修改后的操作不同：
+
+| 暂存内容 | 确认可用后的操作 | 正式生效前 |
+| --- | --- | --- |
+| 新建或安装的动作 | **保留到场景** | 只在本机暂存区保存和试用 |
+| 已有正式动作的编辑副本 | **写回原动作** | 原动作的面板入口和热键继续运行原内容 |
+
+编辑副本也可以保存本机版本、试运行和调试。选择 **写回原动作** 并确认后，Quicker 用副本内容覆盖原动作；通常会在写回成功后移除该暂存项。
+
+如果原动作在建立副本后又被修改，写回会被拒绝，避免覆盖较新的内容。当前不会自动合并：先保留需要的修改，再丢弃旧副本、重新打开最新原动作继续处理。如果确认写回期间暂存副本又发生变化，也需要检查最新内容并重新确认。
+
+丢弃编辑副本不会删除它对应的正式动作，但会删除副本及其本机版本历史。
+
 ## 保留为正式动作
 
 选择“保留到场景”，再指定目标场景和分组，即可把暂存动作写入正式动作库，并在目标位置增加入口。手动新建、导入安装和 AI 创建的暂存动作都使用这条路径正式化。
@@ -51,17 +66,17 @@ Quicker V2 新增了本机动作暂存区。它适合保存尚未确定放置位
 
 ## 与正式动作和同步的区别
 
-暂存动作不会注册到正式动作库，也不会出现在普通动作选择器和触发规则选择器中。试运行只执行暂存区最近保存的内容，不会临时建立正式动作引用。
+暂存内容不会作为独立的正式动作出现在普通动作选择器和触发规则选择器中。已有动作的编辑副本不会替换选择器中的原动作；只有完成写回，原动作才使用修改后的内容。暂存区的试运行只执行该暂存项最近保存的内容，不会临时建立正式动作引用。
 
 暂存动作、暂存分组和本机版本历史保存在当前账号的本机数据中，不参与云同步。切换账号后会看到该账号自己的暂存区；换一台电脑也不会自动出现这里的动作。
 
-如果希望跨设备使用，请先把动作保留到正式场景，并等待正式动作同步完成。
+如果希望跨设备使用，新暂存动作需先保留到正式场景，已有动作的编辑副本需先写回原动作，再等待正式动作同步完成。
 
 ## 删除和恢复边界
 
 “丢弃”会删除该暂存动作及其本机版本历史。“全部删除”会清空当前账号的整个暂存区。这些操作不会把内容移入正式动作回收站，确认后无法从暂存区恢复。
 
-暂存动作尚未正式保存时没有云端副本。删除前如果仍可能需要，请先复制动作，或先保留到一个临时场景。
+暂存内容尚未正式保存或写回时没有云端副本。删除前如果仍可能需要，请先复制需要保留的内容；新暂存动作也可以先保留到一个临时场景。
 
 ## 相关链接
 

docs/v2/features/ai-and-agent.md

@@ -24,6 +24,34 @@ comments: true
 
 首次使用 AI 能力前，需要在「配置 API」中添加服务商、模型和 API Key。多数服务需要自备账号和额度；API Key 只在本机加密保存，不随动作分享，也不随普通设置文件拷到另一台电脑。
 
+## 用 AI 编写和修改动作
+
+### 新建动作
+
+在新版主窗口的暂存区点击 **用 AI 写**，说明输入、处理规则和希望得到的结果。例如：“读取选中的多行文字，去掉空行和重复行，保持原顺序，把结果复制到剪贴板。”
+
+助手生成并保存后，先打开暂存动作检查步骤、变量和输出，再按需要试运行或调试。确认可用后选择 **保留到场景**，将它放入已有场景；在此之前，动作仍只保存在本机暂存区。
+
+### 修改已有正式动作
+
+在 AI 对话中通过 `@` 搜索并引用目标动作，同时说明要改什么、哪些行为需要保留。助手打开正式动作进行编写时，会建立或复用它的暂存编辑副本。后续保存先更新这个副本；原动作的面板入口和热键仍运行原来的内容。
+
+检查并试运行暂存副本后，选择 **写回原动作**，或让助手发起写回并按提示确认。写回会用暂存内容覆盖原动作；它与新动作的“保留到场景”是两种不同操作。
+
+如果提示原动作已变化，不要反复要求强制覆盖。先保留仍需要的修改内容，再丢弃旧编辑副本、重新打开最新原动作，将需要的改动重新应用。当前不会自动合并两边的修改。暂存版本和删除限制见 [本机动作暂存区](./action-panel/action-drafts.md)。
+
+### 在设计器内修改
+
+使用设计器内的程序助手时，助手修改的是当前编辑内容，成功的修改会显示在设计器中。检查结果后，仍需通过设计器的保存操作保存动作；保存到正式动作还是暂存区，取决于当前正在编辑的动作身份。
+
+这与独立 AI 对话中“保存暂存副本，再写回原动作”的流程不同。判断修改是否完成，应看当前设计器和暂存区的实际状态，而不只看助手回复。
+
+### 保存不等于运行验证
+
+保存时的检查可以发现部分格式、参数或引用问题，但不会替你执行动作，也不能保证业务逻辑符合要求。设计器中已显示修改、已保存暂存动作、已写回原动作和已试运行成功，是不同的状态。
+
+涉及文件修改、网络请求或界面操作时，先确认目标和输入，再选择合适的测试数据。试运行会真实执行步骤，并非无副作用的预览。复杂修改应同时检查相关变量、子程序调用和脚本，确认原有的不相关功能仍能正常使用。
+
 ## AI 助手工作区和历史对话
 
 2.2.18 起，AI 助手正式版可以选择工作区。选择本地文件夹后，助手对普通文件的修改会直接保存到该文件夹；请先确认当前目录、备份和版本管理方式。
@@ -57,6 +85,8 @@ comments: true
 
 连接信息与令牌从自己的设置页获取，不要把令牌贴入公开动作或文档。
 
+通过 MCP 编写动作也使用暂存流程：新动作确认后保留到场景，已有正式动作的编辑副本确认后写回原动作。允许 MCP 写入不等于每次修改都会自动成为正式动作；完成后请在 Quicker 中检查实际保存位置和动作内容。
+
 ## 对话与图片输入
 
 2.2.18 起，新建对话可选择工作区，重新打开历史对话时会恢复对应目录；导出对话后会显示保存位置，并可直接打开文件夹。工作区设置会随对话保留，回退到不支持自选工作区的旧版后，不要继续编辑对应项目对话。

docs/v2/xaction/concepts/xaction-editor.md

@@ -32,6 +32,14 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z"
 3. 改图标和标题。
 4. 保存。
 
+## 使用 AI 修改
+
+设计器内的程序助手可以根据要求修改当前程序。说明目标步骤、输入输出和需要保留的行为；如果涉及变量或子程序接口，也应说明相关调用如何调整。
+
+助手成功修改后，结果会显示在设计器中。检查步骤和变量后，通过设计器的保存操作保存；显示了修改不代表已经保存，也不代表运行结果已经验证。按需要使用测试数据试运行或调试。
+
+独立 AI 对话修改正式动作时，使用的是暂存编辑副本，需要检查后再 **写回原动作**。两种入口的区别和操作流程见 [用 AI 编写和修改动作](/v2/features/ai-and-agent#用-ai-编写和修改动作)。
+
 ## 工具箱
 
 左侧按分类列出模块。点左侧标签切换分类（个别模块会落在多个分类里）。