finalize

README.zh-CN.md

@@ -153,7 +153,10 @@
 * `RA3 Mod XML: Find unreferenced assets…`（查找未引用的资产…）
 * `RA3 Mod XML: Find unreferenced assets of this type`（查找此类型的未引用资产）
 * `RA3 Mod XML: Enable AI Agent access…`（启用 AI Agent 访问…）
+* `RA3 Mod XML: Disable AI Agent access`（禁用 AI Agent 访问）
 * `RA3 Mod XML: Install Agent Skill…`（安装 Agent Skill…）
+* `RA3 Mod XML: Uninstall Agent Skill…`（卸载 Agent Skill…）
+* `RA3 Mod XML: Uninstall AI Agent integration…`（卸载 AI Agent 集成…）
 * `RA3 Mod XML: Export AI Agent index snapshot`（导出 AI Agent 索引快照）
 
 ## AI Agent 访问
@@ -184,6 +187,17 @@ Endpoint 按项目存放（`~/.ra3modxml/endpoints/<project>.json`），因此
 
 MCP Server 本质上就是 stdio 上的 JSON-RPC，因此 agent 也可以完全不做 MCP 配置，直接把请求管道给 launcher。另有一个配套 CLI（`cli.js`，与 `mcpServer.js` 同在 `dist/agent/`）：VS Code 运行时走实时索引，否则读导出的快照；需要元素上下文的命令会明确说明，而不是返回空结果。
 
+### 安装与移除
+
+* `RA3 Mod XML: Install Agent Skill…` 不要求项目已建立索引。默认安装到跨 agent 的 `~/.agents/skills/ra3-mod-xml/`，也可选择 Claude Code（`~/.claude/skills/`）、项目级 `.agents/skills/` 与 `.claude/skills/`，或任意自定义文件夹。
+* `RA3 Mod XML: Uninstall Agent Skill…` 列出已记录的安装位置，只删除仍带有本扩展标记的目录；被用户替换或手工创建的目录不会被删除。
+* `RA3 Mod XML: Disable AI Agent access` 停止当前工作区的实时查询服务并清理本窗口的发现文件；已安装的 Skill 与 MCP 客户端配置会保留。
+* `RA3 Mod XML: Uninstall AI Agent integration…` 是清理向导：可停止实时访问、移除已安装的 Agent Skill、删除本扩展写入的 MCP 配置项（来自记录文件与常规的 Claude Desktop / Cursor 路径，不会动其他 server），以及删除稳定 launcher。确认之前不会删除任何内容。
+
+扩展升级后，记录中的 Skill 副本会自动重写到新版本；不带本扩展标记的目录不会被改写。
+
+当 AI Agent 功能首次可用时（全新安装，或从旧版本升级），扩展会在第一次索引完成后询问是否启用。它不会反复打扰：选择"不再提示"——或者干脆忽略——都会被记住，之后的升级保持静默。
+
 完整设计与进度见 `docs/ai-agent-integration-plan.md`。
 
 ## 环境要求