OpenSquilla CLI 完全指南:安装、命令体系与自动化实战
OpenSquilla CLI 完全指南:安装、命令体系与自动化实战
opensquilla 命令行工具是 OpenSquilla 最快捷的配置、运行、巡检与自动化入口:它既能驱动完整的 Gateway(网关)服务与 Web UI,也能以单次调用的方式执行 Agent 回合、输出机器可读的结果,还能管理技能(Skills)、会话(Sessions)、记忆(Memory)、定时任务(Cron)、渠道(Channels)与卸载。读完本文,你将掌握 OpenSquilla CLI 的安装方式、全部主命令的用途与用法、agent 单回合自动化的关键参数与稳定事件流协议,以及并行子进程的正确隔离姿势,可直接用于脚本编排、CI 集成与日常运维。
安装与基本用法
独立安装 Python/uv CLI
opensquilla CLI 是独立于 OpenSquilla Desktop 的 Python/uv 安装形态。Windows Desktop 安装器不会注册全局 opensquilla 命令,Desktop 用户应通过开始菜单或任务栏启动应用。要单独安装命令行界面,使用 uv tool install 指定 Python 3.12 与 release wheel:
uv tool install --python 3.12 "opensquilla[recommended] @ https://github.com/TokenRhythm/opensquilla/releases/download/v0.5.5/opensquilla-0.5.5-py3-none-any.whl"
运行:
opensquilla --help
opensquilla <command> --help
从源码结构看,CLI 是基于 Typer 构建的多级命令应用,入口位于 src/opensquilla/cli/main.py,顶部会先完成 Unicode 标准流配置、.env 加载与 profile 预激活(通过 --profile 全局选项或 OPENSQUILLA_PROFILE 环境变量),随后才分发到各子命令模块。因此所有子命令都自动支持全局的 --profile 参数,用于切换命名 profile 主目录。
主命令一览
| 命令 | 用途 |
|---|---|
opensquilla init |
初始化工作区。 |
opensquilla doctor |
诊断就绪状态并打印恢复步骤。 |
opensquilla uninstall |
移除 OpenSquilla;默认保留数据(--purge-* 才删除)。 |
opensquilla onboard |
运行或查看首次设置。 |
opensquilla configure |
重新配置 provider、router、channels、search、image generation 或 memory embedding。 |
opensquilla gateway |
运行和管理网关服务。 |
opensquilla chat |
启动交互式终端聊天。 |
opensquilla agent |
运行一次面向自动化的 Agent 回合。 |
opensquilla sessions |
列出、查看、恢复、中止、删除或导出会话。 |
opensquilla skills |
列出、搜索、查看、安装、更新、发布与检查技能。 |
opensquilla memory |
检查与维护记忆。 |
opensquilla channels |
配置与检查消息渠道。 |
opensquilla providers |
配置与检查 LLM 提供商。 |
opensquilla search |
配置与使用 Web 搜索。 |
opensquilla sandbox |
检查或更改默认沙箱姿态。 |
opensquilla cron |
管理定时运行的 OpenSquilla 任务。 |
opensquilla cost |
检查用量与预估成本。 |
opensquilla diagnostics |
启用或禁用运行时诊断日志。 |
opensquilla replay |
从决策日志重放某个已记录的回合。 |
opensquilla migrate |
从外部 Agent 运行时导入状态。 |
opensquilla models |
检查可用模型。 |
opensquilla agents |
管理持久化 Agent。 |
opensquilla mcp-server |
运行 OpenSquilla MCP 服务器桥。 |
opensquilla dist |
生成可复现的工作区状态清单。 |
opensquilla reset |
归档 transcript 与摘要,然后重置会话。 |
除表格外,CLI 还包含若干隐藏但实用的能力:opensquilla version(支持 --check 检查 GitHub 上是否有更新的发布版本)、opensquilla bundle(打包近 N 天日志的支持包,默认 3 天,可用 --include-content 附带原始回合抓取内容)、opensquilla ensemble bench(LLM 集成基准)、opensquilla router calibrate(路由器校准)以及 recovery 系列离线恢复命令,它们分别实现在 bundle_cmd.py、ensemble_cmd.py、router_cmd.py 与 recovery_cmd.py。
三种运行面(Run Surfaces)
Web UI 与 Gateway
opensquilla gateway run
opensquilla gateway start --json
opensquilla gateway status
opensquilla gateway restart
opensquilla gateway stop
gateway run 以前台方式启动 ASGI 网关(底层为 uvicorn),start/status/restart/stop 则围绕一个生命周期管理器工作:它通过 pidfile 记录托管进程、轮询健康端点等待就绪、停止时先优雅排空再按超时兜底强杀(默认 graceful 排空后,--shutdown-timeout 默认 10 秒作为 SIGKILL 截止线),具体逻辑见 gateway_lifecycle.py。生命周期命令还支持:
--port/--bind/--listen:覆盖绑定端口与主机,--listen优先于--bind;默认端口来自配置(通常 18791),默认绑定 127.0.0.1。端口会经过 port_validation.py 校验。--gateway:status可检查远程网关 URL,restart/stop也可配合--config定位目标。--json:所有生命周期操作都支持机器可读输出。
终端聊天
opensquilla chat
opensquilla chat --model gpt-5.4-mini
opensquilla chat --session <session-key>
opensquilla chat --standalone --workspace /path/to/project
chat 还支持 --ui auto|tui|plain(默认 auto 自动选择渲染后端)、--timeout/-T(总超时秒数,0 表示不限)以及独立模式下的 --workspace-strict/--no-workspace-strict(把读侧文件工具限制在工作区内)。--standalone 会绕过 Gateway,直接以本地 Agent 运行聊天(见 chat_cmd.py 与 chat/standalone_runtime.py)。
发布安装使用稳定的 Python 原生终端后端。全屏 OpenTUI 宿主目前仅限开发环境使用,不作为 release 资产发布;可在源码检出目录中先固定 Bun 依赖再求值:
bun install --frozen-lockfile --cwd=src/opensquilla/cli/tui/opentui/package
OPENSQUILLA_TUI_DEV_SOURCE_HOST=1 uv run opensquilla chat --ui tui
如需显式选择“救援”渲染器,使用 --ui plain。终端聊天的用法见 docs/tui.md,后端架构、插件槽、Router HUD 与重放基准工作流见 docs/features/tui-frontend.md。
一次性自动化(One-Shot Agent)
opensquilla agent -m "Review the current directory"
opensquilla agent --json -m "Return a short machine-readable summary"
opensquilla agent --workspace /path/to/project --workspace-strict -m "Inspect this repo"
opensquilla agent --timeout 600 --max-iterations 30 -m "Run a bounded investigation"
自动化常用参数:
| 参数 | 用途 |
|---|---|
--workspace |
设置工作区根目录。 |
--workspace-strict |
把读侧文件工具限制在工作区内。 |
--workspace-lockdown |
把写入约束在工作区或 scratch 目录内。 |
--scratch-dir |
把临时脚本/日志/候选补丁放到已知目录。 |
--timeout |
设置 Agent 总墙钟超时。 |
--max-iterations |
限制模型/工具循环次数。 |
--max-provider-retries |
限制瞬时性 provider 重试次数。 |
--length-capped-continuations |
限制 provider 输出达到长度上限后的自动续写次数。 |
--thinking |
覆盖推理等级。 |
--permissions |
选择 restricted、bypass 或 full 权限姿态。 |
--transcript-path |
为自动化写入 JSONL transcript。 |
--usage-path |
写入用量 JSON。 |
--event-stream-stderr |
在 stderr 上流式输出稳定的 v1 进度事件 JSONL。 |
--session-db-path |
跨调用持久化会话回放。 |
实现位于 agent_cmd.py 的 run_agent_command:这些标志直接映射到 run_agent_once 的内部参数。补充几个源码中可确认的细节:
--timeout/-T的单位是秒,0 表示不限;--max-iterations最小值 0(0 表示不限)。--thinking的可选值为off|minimal|low|medium|high|xhigh|adaptive,通过_with_agent_thinking_config注入运行配置。--workspace-lockdown可配合--workspace-lockdown-deny-paths附加“工作区相对写拒绝 glob”,实现更细粒度的写入遏制。--permissions未显式给出时,依次回退到OPENSQUILLA_AGENT_PERMISSIONS环境变量与配置中的permissions.default_mode。--file/-f可重复传入本地文件作为附件(--file path1 --file path2)。--unattended/--interactive默认走 unattended(无实时审批面);--stateless(别名--clean-room)使用干净房间式提示引导,不改变 unattended 语义;--stateless-keep-project-rules可在干净房间引导下仅保留 AGENTS.md 项目规则。--request-timeout-seconds控制单次 LLM HTTP/流式请求超时;--iteration-timeout-seconds与--tool-timeout-seconds是已废弃的兼容选项,会被忽略。- 单次运行默认不写入持久化记忆,
--no-memory-capture可显式声明;--session-db-path默认:memory:。
Agent 进度事件流(v1)
--event-stream-stderr 是可选开启的:它不改变最终 stdout 载荷或退出状态。每个受支持的事件会以一条紧凑 JSON 对象的形式刷新到 stderr,信封格式如下:
{"_event":true,"schema_version":1,"kind":"thinking"}
stderr 上同时可能存在普通诊断输出,因此子进程消费者必须持续排空(drain)stderr、逐行解析,并且只接受 _event 值为 true 的对象。stderr 一旦关闭或不可写,进度事件会被禁用,但不会导致本应成功的 Agent 运行失败。
v1 事件字段刻意比引擎内部的事件 dataclass 更少、更稳定:
kind |
附加字段 |
|---|---|
router_decision |
tier, model, source |
thinking |
无 |
text_delta |
presentation |
run_heartbeat |
phase, elapsed_ms, idle_ms |
tool_use_start |
tool_use_id, tool_name, started_at |
tool_result |
tool_use_id, tool_name, is_error |
warning, error |
code, 脱敏且受限的 message |
artifact |
id, name, mime, size |
done |
无;最终结果从 stdout 读取 |
事件流不暴露:推理文本、回答文本、工具参数、工具结果、内部路由概率、会话路径,以及未来引擎事件中新增的字段。不支持的内部事件会被跳过。消费者可以依赖上述稳定的顶层字段,同时必须忽略未来兼容的 v1 生产者可能新增的附加字段。
这些约束在源码中有直接对应:project_agent_event_v1 将引擎的 RouterDecisionEvent、ThinkingEvent、TextDeltaEvent、RunHeartbeatEvent、ToolUseStartEvent、ToolResultEvent、WarningEvent、ErrorEvent、ArtifactEvent、DoneEvent 投影为上述稳定载荷(见 agent_event_stream.py)。其中 warning/error 的 code 被截断到 200 字符、message 经脱敏函数处理且总长受限(_EVENT_MESSAGE_MAX_CHARS = 4096);StderrAgentEventSink 采用“第一次失败即自我禁用”的 best-effort 策略,并打印一行诊断提示。
并发 Agent 子进程的隔离
每个具备写能力的 Agent 都持有 profile 级写者租约。因此共享同一 OPENSQUILLA_STATE_DIR 的调用会互相冲突,而不是并发写入同一个 profile。需要并行运行 Agent 的编排者,必须为每个子进程同时提供独立的 profile 主目录与独立的 gateway 状态根:
OPENSQUILLA_STATE_DIR=/tmp/agent-a \
OPENSQUILLA_GATEWAY_STATE_DIR=/tmp/agent-a/state \
opensquilla agent -m "task A" --json &
注意:单独的 OPENSQUILLA_STATE_DIR 不能覆盖来自以下来源的 state_dir:当前目录 opensquilla.toml、显式 gateway 配置、或复制过来的 profile。复制 config.toml 或 .env 时,必须删除或重写其中的 state_dir 与 OPENSQUILLA_GATEWAY_STATE_DIR。当输出文件需要隔离时,还要为每个子进程选择互不相同的 --session-db-path、workspace、scratch、transcript 与 usage 路径。在 Windows 上,应在每个子进程中分别传递这两个环境变量,而不是依赖 POSIX 的行内赋值语法。
配置命令
Provider 与 Router
opensquilla onboard
opensquilla onboard status
opensquilla configure provider --provider openrouter --api-key-env OPENROUTER_API_KEY
opensquilla configure router --router recommended
opensquilla providers list
opensquilla providers configure openrouter
opensquilla providers status
onboard是完整的一站式引导:除 provider 外还覆盖 router、channels、search、image generation、memory embedding 与可选的旧版迁移(OpenClaw/Hermes)。可用--minimal只保留核心字段,--skip-channels、--skip-search、--skip-image-generation、--skip-migration分别跳过对应环节,--if-needed仅在必需设置不完整时运行向导,--probe配合--provider时会对已保存 provider 做一次小额在线探测并(CI 友好地)失败时以非零码退出。onboard status展示各环节的就绪情况。configure通过SECTION参数定位目标:provider、router、ensemble、channels、search、image(image-generation 别名)或memory(memory-embedding 别名)。以 provider 为例,--provider指定文本 provider id,--preset可显式应用 router preset,--model/--api-key/--api-key-env/--base-url/--proxy为共享键与端点参数;router 支持--router recommended|openrouter-mix|disabled与--default-tier(默认文本层)。configure还支持 LLM ensemble(--enabled/--disabled、--selection-mode、--model-options、--min-successful-proposers)、search(--search-provider、--max-results、--use-env-proxy、--fallback-policy off|network、--diagnostics)、channels(--channel-type、--name、--token、可重复的--field key=value)、image generation(--image-provider、--image-enabled、--primary模型 id)与 memory embedding(--memory-provider、--onnx-dir本地 ONNX 目录)。providers list列出可用 provider;providers configure <provider>支持--model、--api-key/-k、--base-url、--proxy;providers status [provider]检查配置状态,--probe-models会对活动 provider 做模型列表探测。init是兼容旧脚本的“初始化工作区”命令(deprecated,官方建议改用onboard),其实现见 init_cmd.py:交互式选择 provider(tokenrhythm/openrouter/openai/anthropic/deepseek/custom),把 API key 写入~/.opensquilla/.env(如OPENROUTER_API_KEY=),把llm.provider、llm.model、state_dir写入config.toml。
搜索(Search)
opensquilla search list
opensquilla search configure duckduckgo
opensquilla search query "latest OpenSquilla release"
opensquilla configure search --search-provider duckduckgo
search configure <provider>:--api-key/-k、--api-key-env、--max-results(默认见 search_cmd.py 中DEFAULT_SEARCH_MAX_RESULTS)、--proxy、--use-env-proxy/--no-use-env-proxy(让搜索复用 Gateway 环境中的HTTP(S)_PROXY)、--fallback-policy(默认 off)、--diagnostics/--no-diagnostics(附带 provider 尝试/错误详情便于排障)。search query <query>:可直接发起搜索,支持--provider、--limit、--mode auto|news|technical|broad研究模式、--max-results、--fetch-top-k、--max-chars-per-source、可重复的--include-domain/--exclude-domain与--recency。- 另有
search status [provider]与search benchmark(离线 smoke 或--live在线基准)。
渠道(Channels)
opensquilla channels types
opensquilla channels describe telegram
opensquilla channels add telegram --name personal
opensquilla channels list
opensquilla channels status
opensquilla channels enable personal
opensquilla channels disable personal
opensquilla channels restart personal
opensquilla channels remove personal
channels add <type> --name <name> 还可携带 --token、--enabled/--disabled(默认启用)、--agent-id(默认 main)与可重复的 --field key=value;channels edit 支持 --enabled/--disabled、--token、--agent-id、--field。channels status <a href="https://link.gitcode.com/i/59d03922ca71117d8ce924bc6217c04a" target="_blank">name] 可定向查看某个渠道实例。在 [channels_cmd.py 中还提供了更深的运维命令:channels certify(对渠道做安全认证探测,可选 --send-test-message 与 --allow-side-effects)、channels pairings list/approve/revoke(管理设备配对:pairings approve --admin 可将配对者提升为渠道管理员),以及 channels logout。
原始配置读写
opensquilla config get llm.provider
opensquilla config set port 18791
config get 传空 key 时打印全部配置;config set 接受点号表示法的 key,并会把字符串值按目标字段类型解析后写入(--config 可覆盖配置路径),实现见 config_cmd.py。
更多细节见 docs/configuration.md、docs/providers-and-models.md、docs/search.md 与 docs/channels.md。
技能(Skills)管理
opensquilla skills list
opensquilla skills search pdf
opensquilla skills search pdf --json --include-diagnostics
opensquilla skills view pdf-toolkit
opensquilla skills install <install-reference> --source <clawhub|skillhub|github>
opensquilla skills install <install-reference> --source <clawhub|skillhub|github> \
--force --risk-confirmation <token>
opensquilla skills update --install-id <install-id>
opensquilla skills update --all
opensquilla skills uninstall <skill-name>
opensquilla skills uninstall --install-id <install-id>
opensquilla skills doctor [<skill-name-or-install-id>] --json
skills search --json 为兼容旧客户端保留顶层数组;需要稳定的“结果 + 来源诊断”信封时,追加 --include-diagnostics。
源码层面(skills_cmd.py)可以确认的补充细节:
skills install的--source支持clawhub、skillhub、github。SkillHub 接受 registry 别名或别名@版本;GitHub 接受owner/repo、owner/repo@ref:path或 GitHub URL。- 安装/更新若被安全扫描判定为危险,会返回
SCAN_CONFIRMATION_REQUIRED诊断并附confirmationToken,提示使用--force --risk-confirmation <token>重试(_risk_confirmation_token会从诊断 details 中提取 token)。 skills update支持按--install-id或--name更新单个技能、--all更新全部;skills uninstall支持按名称或--install-id,存在本地文件漂移时需--allow-drift确认。skills doctor [name-or-install-id] --json做单技能体检;skills reload可热加载运行中的技能目录;skills publish把技能目录提交为目标仓库的 PR;skills tap add owner/repo与tap list/remove管理技能 tap 源。
技能体系详见 docs/features/skills.md。
会话与历史
opensquilla sessions list
opensquilla sessions show <session-key>
opensquilla sessions resume <session-key>
opensquilla sessions abort <session-key>
opensquilla sessions export <session-key>
opensquilla sessions delete <session-key>
list 支持 --limit/-n(默认 50)、--agent、--status、--channel 与 --since(ISO 日期/时间或 epoch 秒/毫秒时间戳)过滤;export 支持 --output/-o 与 --format md|json(md 由 messages_to_markdown 生成);delete 支持 -y/--yes 跳过确认。这些命令通过 Gateway RPC(gateway_rpc.py 的 run_gateway_sync)与默认网关 URL 交互,详见 sessions_cmd.py。
会话模型细节见 docs/sessions.md。
记忆(Memory)
opensquilla memory status
opensquilla memory index
opensquilla memory list
opensquilla memory search "preference"
opensquilla memory show <path>
opensquilla memory dream
memory status --deep包含更详细的检索健康检查;memory index --force强制重建索引行并重扫来源。memory search <query>支持--limit/-n(默认 10)、--agent与--source memory|sessions|all。memory show <path>可查看记忆源文件,--from-line/--lines控制读取范围。memory dream是“记忆梦境”维护流程:--force重置游标并处理全部文件,--status只显示游标与待处理文件数,--reset-cursor清除游标文件。
这些子命令的入口定义在 main.py。记忆机制详见 docs/features/memory.md。
持久化 Agent 与定时调度
opensquilla agents list
opensquilla agents add research --name Research --workspace /path/to/research
opensquilla agents delete research
opensquilla cron list
opensquilla cron add --every 1h --text "Summarize important updates" --name hourly-summary
opensquilla cron status <job-id>
opensquilla cron runs <job-id>
agents add <id>支持--model(默认模型)、--workspace、--name、--description与--config;agents delete <id>支持--force跳过确认,实现在 agents_cmd.py。cron add是参数最丰富的子命令之一(cron_cmd.py):- 调度方式三选一:
--expression/--cron(cron 表达式)、--every(固定间隔,如30s、5m、1h,也接受纯数字秒)、--at(带时区的一次性 ISO-8601 时刻);--tz指定 IANA 时区(缺省为 UTC),空串可清除回 UTC 匹配。 - 任务形态:
--job-kind auto|reminder|agent_turn|system_event(auto 对非 main 目标创建静态提醒、对 main 创建系统事件);--session-target isolated|main|current|session。 - 触发细节:
--wake now|next-heartbeat(main 会话任务)、--exact(严格准点,jitter=0)与--jitter(显式抖动,可30s/5m/1h或秒数,优先级高于--exact)。 - 投递:
--channel(如 slack、feishu;last或省略则由后端依据会话最后路由推断)、--to(渠道特定接收人)、--account(多账号时的账号 id)、--announce、--no-deliver、--best-effort-deliver,以及 webhook 投递--webhook-url+ 令牌(--webhook-token会出现在 shell 历史里,优先用--webhook-token-env或--webhook-token-file)。 - 失败告警路由:
--failure-mode channel|webhook,配套--failure-channel/--failure-to/--failure-account或--failure-webhook-url与对应的--failure-webhook-token(-env|-file)。 --timeout限制运行时长;--text为必填任务提示词;--name设置显示名。
- 调度方式三选一:
cron update <job-id>可补丁式更新调度、文本、开关(--enabled/--disabled)、超时、时区、wake 模式与失败告警路由(主投递字段不可补丁,改投递需删除后重建);cron remove、cron run(立即手动触发)、cron runs --limit(默认 20)齐备。
相关文档:docs/agents.md 与 docs/scheduling.md。
成本、诊断与重放
opensquilla cost
opensquilla diagnostics status
opensquilla diagnostics on
opensquilla diagnostics off
opensquilla replay --session <session-key> --turn <turn-id>
cost支持--by-model按模型聚合用量与预估成本,--json输出机器可读结果(cost_cmd.py)。diagnostics on可追加--raw同时开启原始回合调用抓取(供后续 replay 使用);diagnostics off关闭;status查看当前状态。此外还有smoke imports(导入冒烟,默认覆盖桌面打包运行时能力集)与smoke router两条诊断冒烟命令。replay --session <key> --turn <id>从决策日志重放指定回合(replay.py),用于理解某个回合为何表现如此。
需要理解回合行为时,优先使用 diagnostics 与 replay。配套文档:docs/usage-and-cost.md、docs/diagnostics-and-replay.md。
MCP 服务器桥
MCP 支持已包含在当前源码的基础安装中。SDK 2.x 的源码安装与发布安装选项见 docs/mcp-server.md 的 “Requirements” 一节。从支持 MCP 的客户端启动 stdio 桥之前,先启动 Gateway:
opensquilla mcp-server run
opensquilla mcp-server run --gateway ws://localhost:18792/ws
--gateway 可通过 OPENSQUILLA_GATEWAY_URL 环境变量提供;缺省时使用当前所选 profile 配置的网关,未配置则回退到 ws://localhost:18791/ws(mcp_server_cmd.py)。更多细节见 docs/mcp-server.md。
卸载与数据安全
opensquilla uninstall --dry-run # 预览将被移除与保留的内容
opensquilla uninstall # 移除程序,保留数据
opensquilla uninstall --purge-state # 同时删除运行时状态(会话、日志、缓存)
opensquilla uninstall --purge-config # 同时删除配置与密钥
opensquilla uninstall --purge-all # 删除全部 OpenSquilla 数据(需输入确认短语)
opensquilla uninstall --json # 机器可读的计划/结果
数据默认保留,--purge-* 才是显式选择删除:
--purge-state:会话、调度器、记忆、日志、缓存。--purge-config:config.toml、.env等配置与密钥。--purge-all:隐式包含 state+config,交互式界面必须输入确认短语;非交互界面需--confirm-purge-all "delete everything"。源码中该短语由uninstall.safety.PURGE_ALL_CONFIRM_PHRASE定义,且任何非 TTY /--json表面在未提供--yes时拒绝执行(uninstall_cmd.py)。- 卸载动作开始前会先排空并停止正在运行的 Gateway(
_lifecycle_stop通过 GatewayLifecycleManager 处理);删除范围严格限定在 OpenSquilla 主目录内,已迁移或共享的根目录会被拒绝。 - Docker 与 Desktop 安装只打印引导式移除步骤,不删除镜像层或应用包;源码安装永远不会删除你的检出目录。
相关文档:docs/README.md(文档索引)、README.product.md(产品指南)、docs/contributing-docs.md(文档贡献规范)。
以上就是 OpenSquilla CLI 从安装、主命令到自动化的完整参考。核心要点回顾:CLI 与 Desktop 相互独立,uv tool install 是唯一安装路径;所有管理类子命令通过 Gateway RPC 工作,因此 gateway start 常常是许多命令(sessions、cron、cost、diagnostics、skills 变更类)的前置条件;面向脚本与 CI 时优先使用 --json 输出、--event-stream-stderr 的 v1 事件协议(务必持续排空并过滤 _event:true),并行自动化则严格隔离 OPENSQUILLA_STATE_DIR 与 OPENSQUILLA_GATEWAY_STATE_DIR;卸载永远默认保留数据,全量删除需显式确认短语。