From 3763e58023f43c338df033237461da8f437c8a76 Mon Sep 17 00:00:00 2001
From: Cea <41898282+github-actions[bot]@users.noreply.github.com>
Date: Fri, 25 Sep 2026 05:58:19 +0800
Subject: [PATCH 1/2] =?UTF-8?q?docs:=20=E8=A1=A5=E9=BD=90=202.2.21=20?=
 =?UTF-8?q?=E7=94=A8=E6=88=B7=E5=8F=AF=E8=A7=81=E8=AF=B4=E6=98=8E=EF=BC=88?=
 =?UTF-8?q?=E8=A1=A5=E5=85=A8=E6=9C=8D=E5=8A=A1=E3=80=81=E6=96=87=E6=9C=AC?=
 =?UTF-8?q?=E7=AA=97=E5=8F=A3=E3=80=81=E9=9D=A2=E6=9D=BF=E5=85=B1=E7=94=A8?=
 =?UTF-8?q?=E5=85=A5=E5=8F=A3=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/important-notice.md                        |  6 ++++++
 docs/release-notes/index.md                     |  4 +++-
 docs/v2/features/action-panel/faq.md            |  4 ++--
 docs/v2/features/action-panel/usage.md          |  6 ++++++
 .../what's-new/xaction-steps/csharp-script.md   |  2 +-
 docs/v2/xaction/concepts/xaction-editor.md      | 17 +++++++++++++++++
 docs/v2/xaction/modules/text/showtext.md        |  7 +++++++
 7 files changed, 42 insertions(+), 4 deletions(-)

diff --git a/docs/important-notice.md b/docs/important-notice.md
index a74cc9a..9b102db 100644
--- a/docs/important-notice.md
+++ b/docs/important-notice.md
@@ -99,6 +99,12 @@ AI 助手正式版支持选择本地工作区。选择本地文件夹后，AI 
 
 2.2.20 起新增的显示器、虚拟桌面步骤需要新版客户端。含这些步骤的动作在旧版客户端中可能无法识别或运行；多设备同步或分享给他人前，请确认目标设备已升级到 2.2.20 或更高版本。
 
+## 2.2.21 代码补全服务
+
+2.2.21 起，组合动作与表达式等编辑器的代码补全默认走在线服务，以减小安装包并节约本机内存。需要离线或不希望上传代码时，可在 **设置 → 动作设计 → 代码补全服务** 中单独安装本地补全组件，并勾选 **使用本地补全服务** 后保存。该选项默认关闭。
+
+使用在线补全时，Quicker 会向服务器发送正在编辑的代码、变量类型和默认 using。本地模式下，组件不可用时不会自动改用在线服务。操作入口见 [代码补全服务](/v2/xaction/concepts/xaction-editor#代码补全服务)。
+
 ## 相关链接
 
 <RelatedDocs
diff --git a/docs/release-notes/index.md b/docs/release-notes/index.md
index 7874c56..78e5b14 100644
--- a/docs/release-notes/index.md
+++ b/docs/release-notes/index.md
@@ -12,7 +12,7 @@ comments: true
 
 **[https://getquicker.net/v2/versions](https://getquicker.net/v2/versions)**
 
-本站功能说明已按 2.2.20 补充，新增了[显示器与虚拟桌面步骤](/v2/features/displays-and-desktops)及其参数页、[子程序输入参数设置](/v2/xaction/modules/subprogram#输入参数)、[录屏 FFmpeg 参数](/v2/xaction/modules/screen-recording-ui#参数说明)、[AI 对话导入导出](/v2/features/ai-and-agent)和[贴图窗口阴影快捷键](/v2/features/screenshot/capture-pro#移动模式)等说明。版本是否已开放下载、完整条目及安装包校验值，以官网为准。
+本站功能说明已按 2.2.21 补充，新增了[代码补全服务](/v2/xaction/concepts/xaction-editor#代码补全服务)（在线默认、可选本地组件）、[文本窗口记住位置和大小](/v2/xaction/modules/showtext#记住上次位置和大小)，以及[动作面板共用入口与删除关联位置](/v2/features/action-panel/usage#复制后同时添加与删除关联)等说明。版本是否已开放下载、完整条目及安装包校验值，以官网为准。
 
 安装包也从 [https://getquicker.net/V2](https://getquicker.net/V2) 下载，不要使用仍提供 1.x 的 `/Download` 页。
 
@@ -38,6 +38,8 @@ comments: true
 
 2.2.20 补充了 [显示器与虚拟桌面步骤](/v2/features/displays-and-desktops)及其参数页、[子程序输入参数的代码语言和高级分组](/v2/xaction/modules/subprogram#输入参数)、[屏幕录制](/v2/xaction/modules/screen-recording-ui#参数说明)与[后台屏幕录制](/v2/xaction/modules/screen-recording#参数说明)可填写 FFmpeg 编码参数、[AI 对话导入导出和侧边设计器](/v2/features/ai-and-agent)，以及[贴图窗口按 `Y` 切换阴影、右键菜单常用窗口操作上移](/v2/features/screenshot/capture-pro#移动模式)。含显示器或虚拟桌面步骤的动作需要 2.2.20 或更高版本客户端，见 [体验前必读](/important-notice#2220-显示器与虚拟桌面步骤)；完整条目仍以[官网版本记录](https://getquicker.net/V2/Versions)为准。
 
+2.2.21 补充了 [代码补全服务](/v2/xaction/concepts/xaction-editor#代码补全服务)改为在线提供并可在「设置 → 动作设计」安装本地组件、[文本窗口「记住上次位置和大小」](/v2/xaction/modules/showtext#记住上次位置和大小)，以及[动作面板复制后「同时添加到这里」与删除时显示场景关联位置](/v2/features/action-panel/usage#复制后同时添加与删除关联)。在线补全会向服务器发送编辑中的代码等信息，见 [体验前必读](/important-notice#2221-代码补全服务)；完整条目仍以[官网版本记录](https://getquicker.net/V2/Versions)为准。
+
 升级到 2.1.23 或更高版本时仍需特别检查：**后台屏幕录制**步骤的默认录制范围改为“主屏幕”。已明确保存录制范围的动作不受影响；其它旧动作升级后请打开动作确认录制范围，避免原本依赖旧默认值的动作录到不符合预期的屏幕区域。
 
 体验、降级和回退风险见 [体验前必读](/important-notice)。
diff --git a/docs/v2/features/action-panel/faq.md b/docs/v2/features/action-panel/faq.md
index 5919f39..3db4ac3 100644
--- a/docs/v2/features/action-panel/faq.md
+++ b/docs/v2/features/action-panel/faq.md
@@ -89,7 +89,7 @@ comments: true
 
 可以按住 `Ctrl`，把动作拖到另一个场景或分组。这样会在目标场景增加一个入口，同时保留来源场景的入口。
 
-在“场景与动作管理”窗口中，也可以多选动作后点击“同时添加到…”。如果要处理整个分组，右键分组并选择“同时添加分组到其它场景…”。
+在“场景与动作管理”窗口中，也可以多选动作后点击“同时添加到…”。如果要处理整个分组，右键分组并选择“同时添加分组到其它场景…”。2.2.21 起，先在面板复制动作，再到目标空白处右键选 **同时添加到这里**，效果相同。
 
 这些方式都会复用原动作本体，不会创建内容互相独立的副本。编辑动作后，各场景入口会同时显示更新后的内容。
 
@@ -116,7 +116,7 @@ comments: true
 
 不会。删除具名分组时，其中的动作会保留在当前场景，并移到“未分组”。
 
-如果要删除动作本体，请右键动作选择“删除”，并仔细查看确认框列出的动作页、面板场景、快捷键和其它引用。不要把“删除分组”“从此场景移除”和“删除动作”混为一谈。
+如果要删除动作本体，请右键动作选择“删除”，并仔细查看确认框列出的动作页、面板场景、快捷键和其它引用。2.2.21 起，确认框还会显示该动作在场景中的关联位置。不要把“删除分组”“从此场景移除”和“删除动作”混为一谈。
 
 ## “从此场景移除”和“删除”有什么区别？
 
diff --git a/docs/v2/features/action-panel/usage.md b/docs/v2/features/action-panel/usage.md
index 8cb4fdd..2531106 100644
--- a/docs/v2/features/action-panel/usage.md
+++ b/docs/v2/features/action-panel/usage.md
@@ -124,6 +124,12 @@ comments: true
 
 从本地文件导入时可识别 Quicker 1.x 和 2.0 动作 JSON。若导入动作的 ID 已存在，Quicker 会为导入副本生成新的 ID，避免覆盖现有动作。
 
+### 复制后同时添加与删除关联 {#复制后同时添加与删除关联}
+
+2.2.21 起，在面板中 **复制** 某个动作后，可到另一场景或分组的空白处右键，选择 **同时添加到这里**：目标位置会增加一个入口，并与来源共用同一个动作本体（不会生成内容互相独立的副本）。这和按住 `Ctrl` 拖动、「场景与动作管理」里的「同时添加到…」一样，都是增加入口而不是复制内容。
+
+删除动作本体时，确认框会列出它在各场景中的关联位置，便于核对后再确认。若只想整理面板而不删本体，请继续使用「从此场景移除」、移动或「同时添加」。
+
 ## 整理动作和分组
 
 ### 自由格子布局
diff --git a/docs/v2/what's-new/xaction-steps/csharp-script.md b/docs/v2/what's-new/xaction-steps/csharp-script.md
index d0ad7f3..50dcd80 100644
--- a/docs/v2/what's-new/xaction-steps/csharp-script.md
+++ b/docs/v2/what's-new/xaction-steps/csharp-script.md
@@ -8,7 +8,7 @@ comments: true
 
 # 运行C#代码模块
 
-2.x 的普通运行模式改用 Quicker 自带的 Roslyn 编译链，不再依赖 1.x 使用的旧脚本组件，并提供与当前运行环境一致的本地代码补全和诊断。
+2.x 的普通运行模式改用 Quicker 自带的 Roslyn 编译链，不再依赖 1.x 使用的旧脚本组件，并提供与当前运行环境一致的代码补全和诊断。2.2.21 起补全默认走在线服务，也可在「设置 → 动作设计」安装并启用本地补全组件，见 [代码补全服务](/v2/xaction/concepts/xaction-editor#代码补全服务)。
 
 除了继续支持完整的 `Exec(context)` 方法，现在也可以直接编写顶层脚本，通过 `context` 读写动作变量，并把末行表达式作为返回值。脚本返回 `Task` 或 `ValueTask` 时，Quicker 会等待完成并输出解包后的结果。
 
diff --git a/docs/v2/xaction/concepts/xaction-editor.md b/docs/v2/xaction/concepts/xaction-editor.md
index adddf2f..d8fb94c 100644
--- a/docs/v2/xaction/concepts/xaction-editor.md
+++ b/docs/v2/xaction/concepts/xaction-editor.md
@@ -439,6 +439,18 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z"
 
 在某个动作页里建一个名叫 `_template_` 的动作。之后在同一页新建动作时，会复制它的变量和步骤当初始内容。
 
+## 代码补全服务 {#代码补全服务}
+
+2.2.21 起，动作设计器与表达式等代码编辑框的补全默认使用 **在线补全服务**，从而减小安装包并降低 Quicker 进程占用的内存。需要离线编写，或不希望把代码发到服务器时，可在 **设置 → 动作设计 → 代码补全服务** 中安装本地补全组件，勾选 **使用本地补全服务** 后保存。
+
+注意：
+
+- 「使用本地补全服务」默认关闭；开启前须先完成本地组件安装。
+- 在线模式下，补全会向服务器发送正在编辑的代码、变量类型和默认 using。
+- 本地模式下，组件不可用时 **不会** 自动改回在线服务。
+
+隐私与风险说明见 [体验前必读](/important-notice#2221-代码补全服务)。表达式侧的补全交互仍见 [表达式高级话题](/v2/xaction/concepts/expression-adv#补全与验证)。
+
 ## 限制与排障
 
 - 拖模块进列表放不准时，先点一下目标位置附近的步骤再拖，或改用双击加到末尾再移动。
@@ -480,5 +492,10 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z"
       label: '调试运行组合动作',
       description: '运行钮、选中步骤和日志',
     },
+    {
+      href: '/important-notice#2221-代码补全服务',
+      label: '体验前必读：代码补全',
+      description: '在线补全会发送代码；本地默认关闭',
+    },
   ]}
 />
diff --git a/docs/v2/xaction/modules/text/showtext.md b/docs/v2/xaction/modules/text/showtext.md
index e9cb748..d18370c 100644
--- a/docs/v2/xaction/modules/text/showtext.md
+++ b/docs/v2/xaction/modules/text/showtext.md
@@ -165,6 +165,12 @@ legacyContentUpdatedAt: "2025-06-04T23:29:00.000Z"
   - 百分比相对桌面工作区，如 `50%,50%` 约占工作区 1/4。
   - 宽和高可分别用数字和百分比，如 `300,90%`。
 
+### 记住上次位置和大小 {#记住上次位置和大小}
+
+2.2.21 起，显示窗口时可开启 **记住上次位置和大小**：再次运行同一动作时，会恢复上次关闭前的窗口位置和尺寸。需要固定初始布局时保持关闭，并继续用上方的「窗口位置类型」和「窗口尺寸/位置」控制。
+
+参数表待 `data/xaction` 同步后由模块预览自动带出；完整版本记录见[官网](https://getquicker.net/V2/Versions)。
+
 **字体大小**：初始字号，默认 `14`。
 
 **字体名称**：仅需要时填写。多个字体用英文逗号分隔。
@@ -459,3 +465,4 @@ $={params}["参数名"]
 - 1.39.33 增加等待窗口关闭。
 - 20240717 「Esc 键关闭窗口」改为独立参数。
 - 20250605 补充快速访问键说明。
+- 2.2.21 新增「记住上次位置和大小」。

From 5603046294a122806d768eae5a6c3440e8de8c7f Mon Sep 17 00:00:00 2001
From: Cea <ceastld@users.noreply.github.com>
Date: Fri, 25 Sep 2026 06:06:44 +0800
Subject: [PATCH 2/2] =?UTF-8?q?fix(docs):=20=E5=8E=BB=E6=8E=89=20MDX=20?=
 =?UTF-8?q?=E4=B8=8D=E5=85=BC=E5=AE=B9=E7=9A=84=E6=A0=87=E9=A2=98=20{#id}?=
 =?UTF-8?q?=20=E5=86=99=E6=B3=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/v2/features/action-panel/usage.md     | 2 +-
 docs/v2/xaction/concepts/xaction-editor.md | 2 +-
 docs/v2/xaction/modules/text/showtext.md   | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/v2/features/action-panel/usage.md b/docs/v2/features/action-panel/usage.md
index 2531106..28ea10a 100644
--- a/docs/v2/features/action-panel/usage.md
+++ b/docs/v2/features/action-panel/usage.md
@@ -124,7 +124,7 @@ comments: true
 
 从本地文件导入时可识别 Quicker 1.x 和 2.0 动作 JSON。若导入动作的 ID 已存在，Quicker 会为导入副本生成新的 ID，避免覆盖现有动作。
 
-### 复制后同时添加与删除关联 {#复制后同时添加与删除关联}
+### 复制后同时添加与删除关联
 
 2.2.21 起，在面板中 **复制** 某个动作后，可到另一场景或分组的空白处右键，选择 **同时添加到这里**：目标位置会增加一个入口，并与来源共用同一个动作本体（不会生成内容互相独立的副本）。这和按住 `Ctrl` 拖动、「场景与动作管理」里的「同时添加到…」一样，都是增加入口而不是复制内容。
 
diff --git a/docs/v2/xaction/concepts/xaction-editor.md b/docs/v2/xaction/concepts/xaction-editor.md
index d8fb94c..2796fae 100644
--- a/docs/v2/xaction/concepts/xaction-editor.md
+++ b/docs/v2/xaction/concepts/xaction-editor.md
@@ -439,7 +439,7 @@ legacyContentUpdatedAt: "2025-10-30T03:16:55.000Z"
 
 在某个动作页里建一个名叫 `_template_` 的动作。之后在同一页新建动作时，会复制它的变量和步骤当初始内容。
 
-## 代码补全服务 {#代码补全服务}
+## 代码补全服务
 
 2.2.21 起，动作设计器与表达式等代码编辑框的补全默认使用 **在线补全服务**，从而减小安装包并降低 Quicker 进程占用的内存。需要离线编写，或不希望把代码发到服务器时，可在 **设置 → 动作设计 → 代码补全服务** 中安装本地补全组件，勾选 **使用本地补全服务** 后保存。
 
diff --git a/docs/v2/xaction/modules/text/showtext.md b/docs/v2/xaction/modules/text/showtext.md
index d18370c..b2ebc73 100644
--- a/docs/v2/xaction/modules/text/showtext.md
+++ b/docs/v2/xaction/modules/text/showtext.md
@@ -165,7 +165,7 @@ legacyContentUpdatedAt: "2025-06-04T23:29:00.000Z"
   - 百分比相对桌面工作区，如 `50%,50%` 约占工作区 1/4。
   - 宽和高可分别用数字和百分比，如 `300,90%`。
 
-### 记住上次位置和大小 {#记住上次位置和大小}
+### 记住上次位置和大小
 
 2.2.21 起，显示窗口时可开启 **记住上次位置和大小**：再次运行同一动作时，会恢复上次关闭前的窗口位置和尺寸。需要固定初始布局时保持关闭，并继续用上方的「窗口位置类型」和「窗口尺寸/位置」控制。