@volcengine/ark-cli-linux-x64 1.0.50-prerelease.12eaf65f7e06 → 1.0.50-prerelease.f3108d035217

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
1
  [diffend] Oversized file quarantined before diffing.
2
2
  name: package/bin/arkcli-linux-amd64
3
- size: 40804514 bytes
4
- sha256: 799fc5dc1933a37a279011e1b879c8b1bda2e3ae4b677c36f9d5dc1429fbe7fa
3
+ size: 41607330 bytes
4
+ sha256: 713c7867a5efa58490bb1f90c0c5348fef8711c4a38f88d5c61bbfa4c0e79cc3
package/manifest.json CHANGED
@@ -1,37 +1,37 @@
1
1
  {
2
- "version": "1.0.50-prerelease.12eaf65f7e06",
2
+ "version": "1.0.50-prerelease.f3108d035217",
3
3
  "platforms": {
4
4
  "darwin-amd64": {
5
- "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.12eaf65f7e06/arkcli-1.0.50-prerelease.12eaf65f7e06-darwin-amd64",
6
- "sha256": "53782ba3cec7152fe4c0c16bde902f2d6fb7874b354a96ab6e6ccd0d119d0100"
5
+ "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.f3108d035217/arkcli-1.0.50-prerelease.f3108d035217-darwin-amd64",
6
+ "sha256": "0a168a8509a141d8b4e16d47fcbccb246589838de0eb6d7fc545e42591b984ac"
7
7
  },
8
8
  "darwin-arm64": {
9
- "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.12eaf65f7e06/arkcli-1.0.50-prerelease.12eaf65f7e06-darwin-arm64",
10
- "sha256": "a45a297bcb499d923ae67ae026162189253a8f91d9325e1d13bb84f233e4fe16"
9
+ "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.f3108d035217/arkcli-1.0.50-prerelease.f3108d035217-darwin-arm64",
10
+ "sha256": "d6de46618b6a2fed1dd400a45c1112c05841614df03328bcba57ec976ea5f746"
11
11
  },
12
12
  "linux-amd64": {
13
- "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.12eaf65f7e06/arkcli-1.0.50-prerelease.12eaf65f7e06-linux-amd64",
14
- "sha256": "799fc5dc1933a37a279011e1b879c8b1bda2e3ae4b677c36f9d5dc1429fbe7fa"
13
+ "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.f3108d035217/arkcli-1.0.50-prerelease.f3108d035217-linux-amd64",
14
+ "sha256": "713c7867a5efa58490bb1f90c0c5348fef8711c4a38f88d5c61bbfa4c0e79cc3"
15
15
  },
16
16
  "linux-arm64": {
17
- "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.12eaf65f7e06/arkcli-1.0.50-prerelease.12eaf65f7e06-linux-arm64",
18
- "sha256": "9565e7227c81366ee1854bf8517b06c3cffee7986ae942cd7eb62d845ce978f3"
17
+ "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.f3108d035217/arkcli-1.0.50-prerelease.f3108d035217-linux-arm64",
18
+ "sha256": "96a081b57973d750f730e94932fff06de44e5ef8040a32dae025a1a18fc4b487"
19
19
  },
20
20
  "windows-amd64": {
21
- "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.12eaf65f7e06/arkcli-1.0.50-prerelease.12eaf65f7e06-windows-amd64.exe",
22
- "sha256": "c6295a885e9b5d53cf43e0f34cc67c3adcdb516a2e9f8df492ddfb7b5a1a0776"
21
+ "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.f3108d035217/arkcli-1.0.50-prerelease.f3108d035217-windows-amd64.exe",
22
+ "sha256": "b60763d680339ec1f26fdc5f1dd94a6a1bdbfe1b6c4b35b432f0bae00cc752c8"
23
23
  },
24
24
  "windows-arm64": {
25
- "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.12eaf65f7e06/arkcli-1.0.50-prerelease.12eaf65f7e06-windows-arm64.exe",
26
- "sha256": "f094a8877721d67ac791d90b19244d78fffe7f374023b9b1e80e750125b7b7dd"
25
+ "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.f3108d035217/arkcli-1.0.50-prerelease.f3108d035217-windows-arm64.exe",
26
+ "sha256": "39e225af8f7afbd4f49e94749161738815a471e82ad3e693e93e55546e7afdba"
27
27
  }
28
28
  },
29
29
  "skills": {
30
30
  "primary": {
31
- "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.12eaf65f7e06/skills.tar.gz",
32
- "sha256": "62472b7a8255211273eeb357aa3b5033e160bb4eae29ba1d8f7ae66f08a007c3",
31
+ "url": "https://lf3-static.bytednsdoc.com/obj/eden-cn/psjryh/ljhwZthlaukjlkulzlp/prerelease/1.0.50-prerelease.f3108d035217/skills.tar.gz",
32
+ "sha256": "7ce45f4e56f791b6761b82fd5696bf19d8f915ad993f4eac9fc7700736a57860",
33
33
  "kind": "cdn"
34
34
  },
35
- "tag": "v1.0.50-prerelease.12eaf65f7e06"
35
+ "tag": "v1.0.50-prerelease.f3108d035217"
36
36
  }
37
37
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@volcengine/ark-cli-linux-x64",
3
- "version": "1.0.50-prerelease.12eaf65f7e06",
3
+ "version": "1.0.50-prerelease.f3108d035217",
4
4
  "description": "ArkCLI volc binary and Skills for linux-amd64",
5
5
  "os": [
6
6
  "linux"
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  name: arkcli-helper
3
3
  version: 1.1.5
4
- description: "arkcli helper:为 Claude Code / Codex / OpenCode / OpenClaw / Hermes / ZCode 等本机 Agent 配置火山方舟 Plan 或 Platform Endpoint 的 model/provider。真人 TTY 运行 `arkcli helper` 可选择模型和 Harness 能力;`helper mcp` 默认保持整组 Agent Plan MCP 行为,传 `--capability datapro|web-search|agent-memory` 只配单项,传 `--capability cua` 只给目标 Agent 安装云电脑 Skill;连 model/provider 一起配置用 `helper configure`,查安装/配置状态用 `helper list` 或 `helper status`,移除用 `helper reset`。Agent Plan / Team 还支持专业数据集、豆包搜索、Agent 记忆、AI Native 应用开发底座、Agent 进化与 routing.v1 强制检索路由;上下文出现 ARKCLI ROUTING ENFORCEMENT / routing.v1,或用户要求在豆包搜索、DataPro、OpenViking、Supabase 之间强制分流时也使用本 Skill:调用这四类受管 Provider 前先提交 Route Plan,再调用唯一授权 Provider;原生 WebSearch/WebFetch/WebExtract 位于路由管理范围之外。Platform 只允许本人创建、Running、已验证为文本输出的 Endpoint,不配置 MCP、Supabase 或强制路由。豆包搜索配置成功后默认关闭目标客户端原生 WebSearch;传 `--keep-native-websearch` 可保留,并可用 `helper reset` 完整恢复 ArkCLI 配置。"
4
+ description: "arkcli helper:为 Claude Code / Claude Code Desktop / Codex / OpenCode / OpenClaw / Hermes / ZCode 等本机 Agent 配置火山方舟 Plan 或 Platform Endpoint 的 model/provider。真人 TTY 运行 `arkcli helper` 可选择模型和 Harness 能力;`helper mcp` 默认保持整组 Agent Plan MCP 行为,传 `--capability datapro|web-search|agent-memory` 只配单项,传 `--capability cua` 只给目标 Agent 安装云电脑 Skill;连 model/provider 一起配置用 `helper configure`,查安装/配置状态用 `helper list` 或 `helper status`,移除用 `helper reset`。Agent Plan / Team 还支持专业数据集、豆包搜索、Agent 记忆、AI Native 应用开发底座、Agent 进化与 routing.v1 强制检索路由;上下文出现 ARKCLI ROUTING ENFORCEMENT / routing.v1,或用户要求在豆包搜索、DataPro、OpenViking、Supabase 之间强制分流时也使用本 Skill:调用这四类受管 Provider 前先提交 Route Plan,再调用唯一授权 Provider;原生 WebSearch/WebFetch/WebExtract 位于路由管理范围之外。Platform 只允许本人创建、Running、已验证为文本输出的 Endpoint,不配置 MCP、Supabase 或强制路由。豆包搜索配置成功后默认关闭目标客户端原生 WebSearch;传 `--keep-native-websearch` 可保留,并可用 `helper reset` 完整恢复 ArkCLI 配置。"
5
5
  metadata:
6
6
  requires:
7
7
  bins: ["arkcli"]
@@ -18,6 +18,14 @@ metadata:
18
18
  组合,也不得把它当作写操作保护。真实 `configure/reset/mcp/supabase`
19
19
  仍必须先展示目标与路径并取得明确确认。
20
20
 
21
+ ## Claude Code Desktop
22
+
23
+ Claude Code 是单个产品 `claude-code`,用 `--claude-profile cli|desktop|all` 选择客户端;configure/status 不传默认 cli。
24
+ `all` 共用一次解析的 profile、凭证、默认模型和完整 ModelList。reset 必须显式传 `--claude-profile`,只修改所选范围。
25
+ **直接写入并选中 Desktop 原生配置,返回 `configured`;提示重启,不要求手动导入。`runtime_verified=false`,不能声称应用已加载或推理成功。**
26
+ macOS 自动管理 launchd 本地模型代理,解决 Desktop 的 Anthropic 路由校验;代理重启保持端口和 token,reset 同时停用代理。其他平台不自动安装代理。
27
+ 首次配置、重启、状态与 reset 规则见 [Desktop 专用参考](references/claude-code-desktop.md)。
28
+ Desktop 向导在写入配置后结束,不进入 Harness 能力页;reset 三方恢复受管字段和原配置选择,保留用户后续修改。
21
29
  真人每次启动 `arkcli helper` 时,向导会在选择 profile 前在线查询当前账号的 Agent Plan、Coding Plan 个人订阅和团队席位。新检测到的套餐会自动补建本地 profile,当次即可选择。套餐到期、回收或席位撤销时,向导显示原因并跳过该选项,保留本地 profile。续费或重新获得席位后即可再选原 profile。服务端未能确认状态时,条目标记为「状态待确认」,选用时再查询。
22
30
 
23
31
  ## 命令选择(先选最具体的子命令)
@@ -109,7 +117,7 @@ Platform profile 只负责配置 Agent 的 model/provider:`model` 写为用户
109
117
 
110
118
  - 只展示**当前 SSO 子用户创建**、`Running`、模型被明确验证为**文本输出**的 Endpoint;VLM(图文输入、文本输出)可用。Root 账户无子用户身份,不按创建者过滤,展示当前 project 下全部符合条件的 Endpoint。
111
119
  - 生图、生视频、生 3D、音频、Embedding、内容生成或未知模型一律不展示,也不能通过 `--model` 绕过。
112
- - Agent 配置中的 `model` 仍写 Endpoint ID;context window、max completion tokens、输入/输出模态按 Endpoint 绑定的基础模型名,复用 Agent Plan / Coding Plan 现有的 ArkModels 元数据富化规则(ArkModels 权威数据优先;查不到或字段为零时用内置 Plan 模型能力表兜底,仍未知才省略扩展字段并在 helper configure 输出中提示)。元数据查询失败同样 best-effort,不阻断已通过资格校验的 Endpoint。
120
+ - Agent 配置中的 `model` 仍写 Endpoint ID;context window、max completion tokens、输入/输出模态按 Endpoint 绑定的基础模型名,复用 Agent Plan / Coding Plan 现有的 ArkModels 元数据富化规则(ArkModels 权威数据优先;查不到或字段为零时用内置 Plan 模型能力表兜底,仍未知时按纯文本 `text` 补齐,不再省略模态字段)。元数据查询失败同样 best-effort,不阻断已通过资格校验的 Endpoint。
113
121
  - Hermes Agent 支持把 Platform Endpoint 写成 `volcengine-platform` model/provider;仍不支持 MCP 注入。
114
122
  - 该接入只为 Platform 增加元数据调用方,不修改 Plan 模型清单、默认模型、元数据查询、MCP 或 Supabase 行为。
115
123
  - 没有自己创建的 Endpoint 时,向导打开 `https://ark.volcengine.com/region:cn-beijing/endpoint/create?agentMode=close`;创建完成后选择“刷新列表”。已有但未运行的 Endpoint 需先启动再刷新。
@@ -163,7 +171,7 @@ arkcli helper configure codex \
163
171
  | `arkcli helper mcp [target] [--capability <datapro\|web-search\|agent-memory\|cua>] [--profile P] [--ov-resource <库名>] [--scope project] [--keep-native-websearch] [--codex-config-scope profile\|global] [--codex-profile <name>] [--dsh-config-scope home\|profile] [--dsh-profile <name>]` | 不传 `--capability` 保持整组 MCP 旧行为;显式选择时只配一项,**不改 model**。`web-search` 还会安装 Skill 并按原规则处理原生 WebSearch;`agent-memory` 仅个人版,多库用 `--ov-resource`;`cua` 仅个人版 Medium/Large/Max,只给 target 安装 `byted-util-ark-cua` Skill,不写任何 MCP;Codex 的 MCP 默认写 profile `~/.codex/arkcli.config.toml`;DSH 默认写 home 层,profile 层需同时指定两个 DSH flag |
164
172
  | `arkcli helper configure <harness> [--profile P] [--model M\|--endpoint ep-id] [--with-mcp] [--keep-native-websearch] [--with-supabase] [--with-routing] [--codex-config-scope profile\|global] [--codex-profile <name>]` | Plan 用 model/provider;Platform 必须用 `--endpoint` 选择文本 Endpoint。仅 Plan 可加 MCP/Supabase;强制路由仅 Agent Plan 可用。`--keep-native-websearch` 只影响豆包搜索配置,不改变路由 gate。 |
165
173
  | `arkcli helper list` | 查支持的 agent + 安装/配置状态(只读) |
166
- | `arkcli helper status <harness>` | 只读查看单个 harness 的安装态、arkcli 配置态、关键文件权限/大小与已注入 MCP server |
174
+ | `arkcli helper status <harness> [--codex-config-scope profile\|global] [--codex-profile <name>] [--dsh-config-scope home\|profile] [--dsh-profile <name>]` | 只读查看单个 harness 的安装态、arkcli 配置态、关键文件权限/大小与已注入 MCP server;显式 flag 可精确查 Codex profile/global 或 DSH profile/home |
167
175
  | `arkcli helper supabase [--profile P]` | **非 MCP**:装 byted-supabase-cli + skill + 注入火山登录态(打通 byted-supabase 数据库能力);跟 harness 无关。仅 Agent Plan(个人版全档 + 团队版全档) |
168
176
  | `arkcli helper reset <harness>` | 完整移除 arkcli 注入的 model/provider/MCP/托管路由 hook/tool/plugin,并恢复 ArkCLI 拥有且未被外部修改的原生搜索字段 |
169
177
  | `arkcli helper` | TTY 交互向导(需终端;非交互场景改用上面的);进入向导前会检查登录态,未登录/SSO 过期时按当前登录上下文拉起 SSO(火山走 volc-sso;全新用户无明确上下文时走 auth login 菜单),成功后继续向导;Agent Plan/Team 按 profile→model→Agent→能力多选→逐项配置推进,随后只基于已验真的真实 Provider 动态确认强制路由 |
@@ -228,6 +236,7 @@ arkcli helper configure codex \
228
236
  - "只给 Codex 配某一项 Harness 能力" → `arkcli helper mcp codex --capability <datapro|web-search|agent-memory>`;只配云电脑 → `arkcli helper mcp codex --capability cua`
229
237
  - "把 agent 指向我的 plan(连模型一起)" → `arkcli helper configure`
230
238
  - "看看某个 Agent 现在有没有装好 / 配置好 / 文件权限是否安全" → `arkcli helper status <harness>`
239
+ - "查 Codex 某个 profile 或 DSH 某个 profile 的状态" → `arkcli helper status codex --codex-profile <name>` 或 `arkcli helper status deepseek-harness --dsh-profile <name>`
231
240
  - "打开 helper 看 Harness 抵扣/超额开关和本地配置矩阵" → 真人 TTY 运行 `arkcli helper`;Agent 不自动驾驶该菜单
232
241
  - "把全套 harness 工具都配上 / 一次配齐 MCP + Supabase" → `arkcli helper configure <h> --with-mcp --with-supabase`
233
242
  - "启用强制受管 Provider 路由 / routing.v1 / 防止豆包搜索、DataPro、OpenViking、Supabase 串路由" → 使用本 Skill 的强制检索路由协议,执行 `arkcli helper configure <h> --with-routing`
@@ -1,5 +1,18 @@
1
1
  # arkcli helper —— 详细参考
2
2
 
3
+ Claude Code 统一使用 `claude-code --claude-profile cli|desktop|all`;configure/status 默认 cli,reset 必须显式选择客户端;原生配置、ModelList 和状态判断见 [Desktop 参考](claude-code-desktop.md)。
4
+ ## 配置归属与撤销
5
+
6
+ Claude Code、Codex、DSH 的 `configured` 表示 ArkCLI 写入记录与当前受管连接匹配,不是只检测配置文件存在、URL、Key 或 `arkcli-*` provider 名称,也不证明客户端已加载或推理成功。MCP 安装状态单独显示,不代表模型已配置。
7
+
8
+ - Claude CLI 使用现有 picker sidecar 的 `managed_by=arkcli` 和连接指纹;Desktop 使用独立准备记录。
9
+ - Codex 内置配置在所选 `config.toml` / `<profile>.config.toml` 旁写 `.arkcli.json`,记录专属标识、连接 SHA-256 和写入前后快照;核对当前选中的 provider、model、provider 字段和 catalog 路径。global 与命名 profile 分开记录和 reset。
10
+ - DSH 内置配置在 `settings.yaml.arkcli.json` 记录同样证据,核对默认模型、provider 和 `.credentials.yaml` 中实际引用的 Key。内置 model/provider 仍是 home 共享层;`--dsh-config-scope` 仅选择内置 MCP patch 的范围,不应将其描述成内置模型完全隔离。
11
+ - 无记录的旧配置仍可被客户端使用,但不会自动认领;显式重新 configure 才生成记录。改连接字段后显示未匹配;改无关主题、注释等不影响识别。读取错误显示未知,不写文件。
12
+
13
+ Codex/DSH 新内置记录使用与 custom 相同的三方撤销规则:比较写入前、写入后、当前值,恢复仍属于本次写入的字段,保留后改字段和其他 scope。reset 后留下不含凭证的空记录,阻止重复 reset 把保留的用户修改当成旧版配置删除;重新 configure 可再次使用。旧版无记录的显式 reset 保留既有迁移清理规则。完整记录含恢复所需凭证,权限为 `0600`,不能上传或作为普通日志展示。标识与摘要是本机管理证据,不是不可伪造的签名,也不用于鉴权。
14
+
15
+
3
16
  ## `--dry-run` 边界
4
17
 
5
18
  `arkcli helper` 整个命令域不注册 `--dry-run`。这些命令负责 TTY
@@ -131,7 +144,7 @@ openviking-dataplane 的 `Authorization: Bearer <key>` 绑定到具体 OpenVikin
131
144
  ```
132
145
  ✓ 已为 claude-code 注入 MCP → [mcp-server-askecho-search-infinity dataPro-search openviking-dataplane openviking-controlplane] (plan: agent-plan_cn-beijing)
133
146
  ✓ claude-code 原生 WebSearch 已关闭(项目级)→ /repo/.claude/settings.json
134
- 快捷恢复:arkcli helper reset claude-code(同时移除 ArkCLI 写入的模型/provider/MCP 配置)
147
+ 快捷恢复:arkcli helper reset claude-code --claude-profile cli(同时移除 ArkCLI 写入的模型/provider/MCP 配置)
135
148
  提示:Claude Code 需重启后才会加载新注入的 MCP。
136
149
  ```
137
150
 
@@ -141,7 +154,7 @@ openviking-dataplane 的 `Authorization: Bearer <key>` 绑定到具体 OpenVikin
141
154
  团队版 Agent Plan 不含 OpenViking,已跳过数据面/控制面两台 MCP。
142
155
  ✓ 已为 claude-code 注入 MCP → [mcp-server-askecho-search-infinity dataPro-search] (plan: agent-plan-team_cn-beijing_team)
143
156
  ✓ claude-code 原生 WebSearch 已关闭(项目级)→ /repo/.claude/settings.json
144
- 快捷恢复:arkcli helper reset claude-code(同时移除 ArkCLI 写入的模型/provider/MCP 配置)
157
+ 快捷恢复:arkcli helper reset claude-code --claude-profile cli(同时移除 ArkCLI 写入的模型/provider/MCP 配置)
145
158
  提示:Claude Code 需重启后才会加载新注入的 MCP。
146
159
  ```
147
160
 
@@ -217,6 +230,10 @@ ZCode 主进程、重新打开并新建会话;只切换模型或继续使用
217
230
 
218
231
  ```bash
219
232
  arkcli helper status <harness>
233
+ arkcli helper status codex --codex-profile arkcli
234
+ arkcli helper status codex --codex-config-scope global
235
+ arkcli helper status deepseek-harness --dsh-profile default
236
+ arkcli helper status deepseek-harness --dsh-config-scope home
220
237
  ```
221
238
 
222
239
  人类可读输出是一行表格(`HARNESS / INSTALLED / CONFIGURED / MODEL / MCP / SEARCH /
@@ -231,6 +248,7 @@ SETTINGS`)。`--format json` 返回稳定字段:
231
248
  | `configured` | 是否检测到 ArkCLI 托管的配置标记(model/provider 或 MCP) |
232
249
  | `supports_model` / `supports_mcp` | 当前**编译产品**与 harness 共同决定的能力 |
233
250
  | `native_search_supported` | harness 是否具备 ArkCLI 可管理的原生搜索关闭能力 |
251
+ | `config_scope` / `profile_name` | 仅显式选择 Codex / DSH 配置范围时返回;Codex 为 `profile|global`,DSH 为 `profile|home`。profile 名分别是 `--codex-profile` / `--dsh-profile` |
234
252
  | `settings_path` / `mcp_path` | 主配置与 MCP 配置落点;不适用时为空 |
235
253
  | `files[]` | `path` / `exists` / `mode`(四位八进制)/ `size`;始终返回数组 |
236
254
  | `mcp_servers[]` | ArkCLI 内置 MCP server 状态对象数组:`name` / `transport` / `installed` / `key_state`(`real`/`placeholder`/`absent`);`supports_mcp=false` 时为空数组 |
@@ -239,6 +257,14 @@ SETTINGS`)。`--format json` 返回稳定字段:
239
257
  边界:
240
258
 
241
259
  - `configured=false` 只表示没有 ArkCLI 托管标记,不表示 Agent 不能工作。
260
+ - Codex / DSH 不带范围 flag 时保持历史聚合状态;要查某个 profile 必须显式传
261
+ `--codex-profile` 或 `--dsh-profile`。Codex 的 `--codex-profile` 隐含
262
+ `--codex-config-scope profile`;DSH 的 `--dsh-profile` 隐含
263
+ `--dsh-config-scope profile`。不匹配 harness 的范围 flag 一律 fail-fast。
264
+ - DSH 的 model/provider 配置可能在 home 层共享,也可能由 profile 层
265
+ `cordis.patch.yml` 注入。`--dsh-config-scope profile` 会把 `mcp_path` 指向该
266
+ profile 的 patch,并在该 patch 中发现 ArkCLI 托管 provider 或 MCP 时报
267
+ `configured=true`。
242
268
  - `installed=false && installed_known=true` 才能提示“未安装”;`installed_known=false`
243
269
  时必须提示“无法自动判定”。
244
270
  - `files[].mode` 用于发现 `0644` 等过宽权限;凭证文件预期为 `0600`。
@@ -296,7 +322,7 @@ SETTINGS`)。`--format json` 返回稳定字段:
296
322
  | DSH 提示检测到旧版配置或 flat credentials | 旧版 ArkCLI 写入格式与当前 DSH provider / credentials 契约不兼容;flat key 可能单独存在,也可能残留在 version 1 文档顶层 | 先运行 `arkcli helper reset deepseek-harness`,再重新执行 `configure`;不要手工删除 `apiKeyEnv` |
297
323
  | ZCode 调用 `glm-5.2` 等模型时报 `InvalidParameter` / token 上限 400 | 旧配置把 ArkModels 的 `131072` 等二进制近似值直接作为 `limit.output` 发给十进制网关 | 升级 ArkCLI 后重跑 `helper configure zcode` 并重启 ZCode;确认 `limit.output=128000`,但保留权威 `limit.context` |
298
324
 
299
- DSH model/provider 写入还遵循以下 ownership 规则:`settings.yaml` 使用独立的 `llm-pi-ai.providers.arkcli-<planType>`,凭据使用 `.credentials.yaml` version 1 文档的 `refs.ARKCLI_<PLAN>_API_KEY`,让 DSH credentials service 能按 provider 的 `apiKeyEnv` 解析。两个文件按一个可回滚事务更新。检测到纯 flat credentials、version 1 文档顶层残留的 legacy credential key,或 `llm-deepseek` 同时具有 `apiKeyEnv: DEEPSEEK_API_KEY` 与精确 Ark 数据面 HTTPS URL 的旧 ArkCLI 指纹时,`configure` fail-fast,不做隐式迁移,并明确要求先运行 `arkcli helper reset deepseek-harness`;该 reset 兼容读取旧格式并清理旧 ArkCLI 内容。不要把自定义 `apiKeyEnv` 当成 ArkCLI ownership。`helper reset deepseek-harness` 仅移除 fingerprint 仍完整匹配的 provider、对应凭据以及仍指向该 provider 的 `agent-default-model`。
325
+ DSH model/provider 写入还遵循以下 ownership 规则:`settings.yaml` 使用独立的 `llm-pi-ai.providers.arkcli-<planType>`,凭据使用 `.credentials.yaml` version 1 文档的 `refs.ARKCLI_<PLAN>_API_KEY`,让 DSH credentials service 能按 provider 的 `apiKeyEnv` 解析。两个文件按一个可回滚事务更新。检测到纯 flat credentials、version 1 文档顶层残留的 legacy credential key,或 `llm-deepseek` 同时具有 `apiKeyEnv: DEEPSEEK_API_KEY` 与精确 Ark 数据面 HTTPS URL 的旧 ArkCLI 指纹时,`configure` fail-fast,不做隐式迁移,并明确要求先运行 `arkcli helper reset deepseek-harness`;该 reset 兼容读取旧格式并清理旧 ArkCLI 内容。不要把自定义 `apiKeyEnv` 当成 ArkCLI ownership。有新写入记录时 reset 按上述三方撤销规则处理;无记录的旧版迁移仍按保留 provider 身份及精确旧格式清理。
300
326
 
301
327
  ## Platform Endpoint 配置
302
328
 
@@ -310,7 +336,7 @@ arkcli helper configure codex \
310
336
 
311
337
  - Platform 下不能传 `--model`,也不能使用 `--with-mcp`、`--with-supabase` 或 `--with-routing`。
312
338
  - 没有自己创建的 Endpoint 时,交互向导会打开 `https://ark.volcengine.com/region:cn-beijing/endpoint/create?agentMode=close`,用户创建后选“刷新列表”。
313
- - Endpoint ID 写入 Agent 配置的 `model`;base URL 使用 `https://ark.<region>.volces.com/api/v3`。context window、max completion tokens、输入/输出模态通过 Endpoint 绑定的基础模型名,复用 Plan 当前的 ArkModels `LookupModelMeta → enrichModelMeta` 管道(ArkModels 权威数据优先;查不到或字段为零时用内置 Plan 模型能力表兜底,仍未知才省略扩展字段并在 helper configure 输出中提示)。
339
+ - Endpoint ID 写入 Agent 配置的 `model`;base URL 使用 `https://ark.<region>.volces.com/api/v3`。context window、max completion tokens、输入/输出模态通过 Endpoint 绑定的基础模型名,复用 Plan 当前的 ArkModels `LookupModelMeta → enrichModelMeta` 管道(ArkModels 权威数据优先;查不到或字段为零时用内置 Plan 模型能力表兜底,仍未知时按纯文本 `text` 补齐,不再省略模态字段)。
314
340
  - Hermes Agent 使用 `volcengine-platform` provider,把 Endpoint ID 写入 `model.default` 和 provider 模型列表,并写入上述 OpenAI-compatible base URL。Hermes 仅支持 model/provider,不支持 MCP 注入。
315
341
  - Pi 把 Endpoint ID 作为 model 写入 `~/.pi/agent/models.json` 的 plan provider(`api: openai-completions` + 上述 base URL),并把 `~/.pi/agent/settings.json` 的 `defaultProvider` / `defaultModel` 指过去。Pi 仅支持 model/provider,不支持 MCP 注入。
316
342
  - Platform 元数据接入不修改 Agent Plan / Coding Plan 的模型列表、默认模型、富化结果或失败退化语义。Chat/Responses 的具体调用方式继续由 Agent 当前 harness 行为决定。
@@ -465,3 +491,5 @@ arkcli helper reset <harness>
465
491
  ```
466
492
 
467
493
  完整移除 arkcli 注入的 provider/env/model + 内置 MCP server;Volc 还会移除 arkcli 托管的路由 hook/tool/plugin,并恢复 ArkCLI 拥有且未被外部修改的原生 WebSearch 字段(保留用户其它配置)。**该命令不是“只恢复搜索”**。Trae 项目级 MCP 注入用 `arkcli helper reset trae --scope project` 移除;原生搜索 Hook 始终按当前项目根恢复。Codex profile 注入用 `arkcli helper reset codex --codex-profile <name>` 移除;全局注入用 `arkcli helper reset codex --codex-config-scope global` 移除;原生搜索配置始终位于当前项目根 `.codex/config.toml`,与该 flag 独立。
494
+
495
+ Desktop 原生写入回归:configure 后验证原生条目、appliedId、deploymentMode 和 ArkCLI receipt;连接或选择漂移不认领;无关偏好不影响;reset 恢复旧选择、保留用户修改、两端隔离且可重复;坏元数据整事务回滚。
@@ -0,0 +1,83 @@
1
+ # Claude Code Desktop
2
+
3
+ ## 配置与共存
4
+
5
+ Claude Code 是单个 catalog 产品 `claude-code`,CLI/TUI 和 Desktop 是客户端选择。
6
+ 使用 `--claude-profile cli|desktop|all`;交互向导先选 Claude Code,再选客户端。configure/status 不传默认 cli,保留旧脚本行为。
7
+
8
+ CLI 的 `configured` 识别 ArkCLI 专属配置:内置配置在已有 `helper/claude-model-picker.json` 中记录 `managed_by=arkcli` 和连接字段指纹,并核对当前 settings;仅有 URL、Key、模型、超时或开关不算已配置。旧版没有指纹的配置不会被自动认领,仍可正常使用,用户重新 configure 后才补写标识。用户修改无关偏好不影响识别,连接字段变化则不再报告匹配。Desktop 核对原生配置旁的 ArkCLI receipt、连接摘要、appliedId 和 deploymentMode;配置完成不等于应用已加载或推理成功。
9
+ 它通过 Desktop 的应用级第三方推理设置接入;同一设置也会影响 Desktop 的其他推理功能。
10
+ `--claude-profile all` 共用一次解析的 profile、凭证、默认模型和完整 ModelList;单端配置可使用不同 profile。
11
+ Desktop 不从 CLI 的 `ANTHROPIC_BASE_URL` 获取第三方路由。
12
+
13
+ ```bash
14
+ arkcli helper configure claude-code --claude-profile desktop --profile <plan-profile> --model <direct-model-name>
15
+ arkcli helper configure claude-code --claude-profile desktop --profile <platform-profile> --endpoint <ep-id>
16
+ arkcli helper status claude-code --claude-profile desktop --format json
17
+ arkcli helper reset claude-code --claude-profile desktop
18
+ ```
19
+
20
+ 沿用产品已有的 profile、凭证导出准入和 Platform 文本 Endpoint 校验。
21
+
22
+ 不提供 `--dry-run`,不自动安装或启动 Desktop,不配置 MCP/Skills/hooks/工具集。
23
+ 需要共享 Code MCP 时,另行使用该产品支持的 `helper mcp claude-code`。
24
+
25
+ ## 文件和模型列表
26
+
27
+ `--claude-profile desktop` 直接写入 Desktop 原生配置,无需开发者模式、文件选择或手动 Import / Apply。
28
+ macOS 的文件为:
29
+
30
+ - `~/Library/Application Support/Claude-3p/configLibrary/<ArkCLI 产品专属 UUID>.json`:网关、凭证、完整模型列表。
31
+ - 同目录 `_meta.json`:保留其他条目,注册本产品配置并更新 `appliedId`。
32
+ - `Claude/claude_desktop_config.json` 和 `Claude-3p/claude_desktop_config.json`:仅合并 `deploymentMode=3p`,保留 MCP 和其他字段。
33
+ - 原生条目旁的 `.arkcli.json`:`managed_by=arkcli`、连接摘要和撤销快照;可能包含恢复所需凭证,权限 `0600`,不得输出或分享。
34
+
35
+ Windows 的普通目录为 `%APPDATA%/Claude`,第三方目录为 `%LOCALAPPDATA%/Claude-3p`;Linux 使用用户配置目录下的 `Claude` / `Claude-3p`。`CLAUDE_USER_DATA_DIR` 可指定 Desktop 自定义数据目录。不同 ArkCLI 编译产品使用不同配置 ID。
36
+ 当前产品状态目录的 `helper/claude-code-desktop/config.json` 和 ownership 文件保留用于兼容旧版及管理代理;仅有这些文件不证明原生配置已写入。macOS 受管模式下原生配置只有本地代理 token,上游 Key 留在 `gateway/gateway.json`。所有凭证文件均为 `0600`。
37
+ 不修改 Claude CLI 的 `~/.claude/settings.json`、`~/.claude.json` 或 shell rc。
38
+
39
+ `inferenceModels` 保存完整模型列表:所选默认模型第一,其余去重保留。
40
+ macOS 使用受管本地代理:`name` 是每个真实模型 ID 对应的稳定 `claude-arkcli-<hash>` 路由,`labelOverride` 保留真实模型名称。Desktop picker 发出的路由名由代理转换回准确的 Ark 模型 ID;JSON 响应和 SSE 的模型字段映射回同一路由,其余 payload 保持原义。
41
+ 设置 `modelDiscoveryEnabled=false`;不猜测 `behavesAs`、Claude tier、1M 或推理能力。代理使用所配置的 Anthropic 兼容 base URL,按照上游 bearer/x-api-key 方式认证。
42
+ 其他平台仍生成直连配置,不安装 launchd 服务;Desktop 会校验 Anthropic 路由,非 Claude 模型需要已有网关提供兼容路由。不得把直连文件生成成功说成该模型可在 Desktop 使用。
43
+
44
+ ## 使用、状态与撤销
45
+
46
+ configure 完成后重启 Claude Desktop;如果出现登录页,选择“或使用此设备上保存的 Gateway 配置”。不再要求手动导入和 Apply。它修改应用级推理配置;设备管理策略仍可能覆盖本地配置,应用加载和真实推理须分别验证。
47
+
48
+ `configure.status=configured`,`runtime_verified=false`;保留既有 `preparation` JSON 字段,原生写入成功时其 `status=configured`、`prepared=true`、`activation_known=false`,并返回 `model` / `models`。`activation_known=false` 表示未验证运行中的应用,不代表缺少手动激活操作。
49
+ `status.configured=true` 要求本产品原生 receipt 与连接字段匹配、`appliedId` 指向本产品条目、两份配置的 `deploymentMode` 为 `3p`,且没有取代本地配置的 `hybridPointer`。仅有 URL/Key/模型或相同配置 ID 不构成所有权;连接、选择或模式变化后不再报告匹配。无关偏好变化不影响识别。
50
+ `list` 仍只有一行 Claude Code,`clients[]` 分别报告 CLI/Desktop;`status --claude-profile all` 返回两端状态,`configure --claude-profile all` 返回 `status=configured` 和各端结果。`installed_known=false` 表示安装状态未知。
51
+ 旧版只有准备文件时仍返回 `pending_activation`;重新 configure 后迁移为原生配置。Connector 同时接受旧状态和新状态;新配置展示“已配置,请重启”,不显示导入路径。`activation_hint` 只作人类可读提示。
52
+
53
+ reset 必须显式指定 `--claude-profile cli|desktop|all`;省略时报错且不写文件。CLI 与 Desktop 分别撤销,all 在同一文件及受管服务事务中处理。
54
+ Desktop reset 返回 `status=reset`:比较 before/applied/current,恢复仍受管的原生字段和之前的配置选择,保留后来修改的字段、MCP、其他配置条目。若用户已切到其他条目,不改回其 deploymentMode。清理准备文件及 ArkCLI 受管代理;用户提供的网关不停止。完成后重启 Desktop。保留不含凭证的空 receipt,重复 reset 不会删除保留的用户修改。
55
+ 原生配置或撤销记录不可解析时不盲写;失败回滚文件和受管服务。旧版已经手动导入的独立条目不自动认领或删除。
56
+ Key、地址或模型列表改变后重新 configure;需要应用读取更新时重启,无需再次导入。
57
+
58
+ ## macOS 代理生命周期
59
+
60
+ `configure` 自动注册当前用户的 launchd LaunchAgent,健康检查成功才返回准备成功。关闭终端不影响代理;崩溃或被 kill 后由 launchd 节流重启,用户登录后自动启动。端口、token 和模型路由在重启和重配后保持稳定。
61
+ 服务运行当前产品状态目录内的受管二进制副本,不依赖原安装路径或临时构建目录;重新 configure 会更新副本,并在启动失败时恢复旧文件和原先运行的服务。配置/reset 的 `all` 事务同时覆盖文件和服务;CLI-only reset 不影响代理。
62
+ `preparation.gateway` 报告 `managed`、`supervisor`、`label`、`address`、`running`、`pid` 和最近上游 HTTP 状态。该健康检查只访问本机,不证明凭证仍有效或上游模型可用。错误响应不自动重试,断开的流也不重放;用户在 Desktop 重试中断请求。
63
+ 代理仅监听 IPv4 loopback,验证独立本地 token,只开放模型列表、消息、token 计数及健康检查;不转发客户端 Cookie/Authorization 到上游,不记录请求正文或密钥,也不跟随上游重定向。端口被其他进程占用时配置失败,不结束其他进程。
64
+
65
+ 官方 Gateway 面向 Claude;受管代理解决路由名校验与转发。它不改变实际模型能力,不能把“路由通过校验”或“代理健康”视为全部 Desktop 功能兼容。完整 Desktop 会话仍需实机验证。
66
+
67
+
68
+
69
+ 普通 configure、custom configure 和交互向导成功后,都会提示所选客户端的完整 reset 命令及影响范围;非交互 JSON 的 `reset_hint` 同步携带此提示。`all` 提示会说明两端影响及单端替代命令。
70
+
71
+ ## 官方依据
72
+
73
+ - [Desktop configuration format](https://claude.com/docs/third-party/claude-desktop/configuration-format)
74
+ - [In-app configuration](https://claude.com/docs/third-party/claude-desktop/in-app-configuration)
75
+ - [Model list](https://claude.com/docs/third-party/claude-desktop/configuration#inferencemodels)
76
+ - [Code third-party configuration](https://claude.com/docs/third-party/claude-desktop/code#always-applied)
77
+
78
+ ## Configuration profile contract
79
+
80
+ Use `--claude-profile cli|desktop` to select the target for configure, params, status and reset. `--profile` still selects the ArkCLI credential profile. `all` explicitly selects both Claude configurations; reset always requires an explicit target. JSON reports `config_scope: "profile"` and `profile_name`, with `profiles` for aggregate results. The old hidden `--client` flag and `client`/`clients` output fields remain compatibility aliases; conflicting flags fail before any write. Existing native files and ownership records are reused, so configurations written by earlier versions can still be inspected and reset. Custom configuration uses `custom-config.profiles.cli`/`.desktop`; the old `clients` envelope is accepted alone but cannot be combined with `profiles`.
81
+
82
+ The canonical configuration target is `target: {harness, scope, profile}` in configure/status/reset output. Use `target.profile` to identify the native configuration; `--profile` still selects the ArkCLI credential profile.
83
+
@@ -113,3 +113,27 @@ arkcli helper mcp codex --profile <agent-plan-large-or-max-profile> --capability
113
113
  - 计费写操作不绕过确认。
114
114
  - 服务端权益、本地配置、探测未知三种语义不混淆。
115
115
  - 未支持该矩阵的编译产品不得声称拥有 Agent Plan Harness 矩阵。
116
+
117
+ ## Desktop 回归
118
+
119
+ - 用户要同时用 Desktop 和 TUI:选择同一个 claude-code 产品下的 --claude-profile all,共用 profile 和完整 ModelList;desktop 单端不得覆盖 CLI 文件,任何路径都不得写 Desktop configLibrary。
120
+ - 用户要完整模型列表:configure 使用完整可用模型清单,默认模型第一;解释 macOS 受管代理将稳定路由映射回真实模型 ID,picker 显示真实名称;其他平台直连不能保证通过 Anthropic 校验。
121
+ - configure 返回 configured:核对原生条目、appliedId、deploymentMode 和 receipt;提示重启,无需导入;runtime_verified=false。旧版准备文件仍可读为 pending_activation,重配后迁移。
122
+ - reset 后问 Desktop 是否恢复:三方撤销原生受管字段和选择,保留后改字段、其他条目和用户后选配置;清理准备文件和受管代理,提示重启。
123
+
124
+ - reset claude-code 省略 --claude-profile 必须报错;分别验证 cli/desktop 单端隔离和 all 整体回滚。
125
+
126
+ - macOS configure:健康检查成功后直接写入并选中原生配置,提示重启,不要求选文件或导入。不得输出 API Key 或 receipt 内容。
127
+ - macOS 代理被 SIGKILL:launchd 拉起新 PID,端口/token/路由不变;在途流失败,不自动重放,后续请求使用真实上游模型 ID。
128
+ - macOS 重配启动失败:恢复旧文件和原先运行的服务;--claude-profile all 第二端失败时 CLI 文件一起回滚。JSON transaction.services 列出参与事务的受管服务。
129
+ - macOS reset --claude-profile desktop:卸载 LaunchAgent 并清理受管文件,等待超过重启节流时间后不再拉起;CLI 文件不变。status 只探测本地健康,不把上游 401/429 或服务停止误报成 Desktop 已验证。
130
+
131
+ ### Claude 配置归属回归
132
+
133
+ 仅有 URL/Key、模型或开关时,不宣称 ArkCLI 已配置;要求专属标识和当前连接字段匹配。旧配置没有指纹时说明仍可用,不自动重写。改主题不影响状态,改连接字段使匹配失效;Desktop 必须核对原生配置与 receipt;旧版仅有准备文件不等于 configured。
134
+
135
+ ### Codex / DSH 配置归属回归
136
+
137
+ 验证内置及 custom:真实 configure 后 list/scoped status 均匹配;只保留 provider 名称、删除记录、改 URL/Key/model/选中 provider 均不能认领,DSH 必须检查独立凭证文件。无关偏好不影响识别;MCP-only 不算模型配置。reset 保留用户后改字段,再次 reset 不删除它们;Codex global/profile 和 DSH custom home/profile 互不影响。custom reset 恢复先前内置配置后应重新匹配其原记录。禁止把本地状态验证表述成客户端推理已通过。
138
+
139
+ Desktop 原生写入回归:configure 后验证原生条目、appliedId、deploymentMode 和 ArkCLI receipt;连接或选择漂移不认领;无关偏好不影响;reset 恢复旧选择、保留用户修改、两端隔离且可重复;坏元数据整事务回滚。
@@ -55,7 +55,7 @@ metadata:
55
55
  - 看可用资源(endpoint / plan 模型 ID)走 [`../arkcli-resources/SKILL.md`](../arkcli-resources/SKILL.md)
56
56
  - 首次远端调用前,先看 [`../arkcli-auth/SKILL.md`](../arkcli-auth/SKILL.md)
57
57
  - `arkcli` 是产品 CLI,不是 OpenAPI Action 浏览器;不要从 Action 名反推命令设计
58
- - 安装: `npm i @volcengine/ark-cli -g`(公开版)
58
+ - 安装与 npm/Native 切换:读取 [`references/update.md`](references/update.md) 的“安装与默认入口”段,使用产品独立 prefix 和同一安装命令内的父 shell 激活;原始裸 npm 安装不保证立即切换。
59
59
  - 版本检查与显式升级按需读取 [`references/update.md`](references/update.md);`update.mode` 的读取、写入与 automatic gate 仍走 [`../arkcli-config/SKILL.md`](../arkcli-config/SKILL.md)
60
60
 
61
61
  ## 调用归因协议
@@ -1,6 +1,6 @@
1
1
  # 版本检查与显式升级
2
2
 
3
- 本 reference 只负责回答“当前版本是否最新”和执行用户明确要求的升级。它不访问业务账号,不需要先跑 `auth status`。
3
+ 本 reference 负责安装后的默认入口、回答“当前版本是否最新”和执行用户明确要求的升级。它不访问业务账号,不需要先跑 `auth status`。
4
4
 
5
5
  `update.mode` 的读取、写入、默认值和 automatic production gate 属于 [`../../arkcli-config/SKILL.md`](../../arkcli-config/SKILL.md)。不要因发现新版本或仅看到 postinstall enrollment 就推断 active automatic consent;新安装 pending、registry latest reconciliation、exact receipt 换发与版本锁定流程以 config Skill 为准。
6
6
 
@@ -70,3 +70,25 @@ arkcli update --yes
70
70
  - macOS/Linux 的显式更新仍是手工 npm 升级语义;不要把 automatic 原子 cutover 描述成显式命令已采用的路径。
71
71
 
72
72
  不要用 cron、系统服务或 Agent 定时任务模拟自动更新,也不要因普通更新提示中断当前业务命令或改变其退出码。
73
+
74
+
75
+ ## 安装与默认入口
76
+
77
+ 最后一次成功安装选择默认入口,包含跨产品、npm/Native 切换和主动降级。用户在目标终端执行一条安装命令,命令内完成安装、入口校验和父 shell 生效。不同产品使用 `~/.local/share/arkcli-npm/{volc,byteplus}` 的独立 npm prefix,保留 npm 自己的包与 shim;不要使用无归属验证的 `--force` 或先卸载旧产品。
78
+
79
+ Volc 的 Zsh 示例(Bash 改成 `--shell bash`):
80
+
81
+ ```bash
82
+ {
83
+ _arkcli_prefix="$HOME/.local/share/arkcli-npm/volc"
84
+ npm install -g @volcengine/ark-cli --prefix "$_arkcli_prefix" --include=optional --ignore-scripts &&
85
+ _arkcli_activation=$(node "$_arkcli_prefix/lib/node_modules/@volcengine/ark-cli/scripts/run.js" _install-entry --source npm --shell zsh) &&
86
+ eval "$_arkcli_activation"
87
+ }
88
+ ```
89
+
90
+ Native 固定安装器支持 `--activate-shell bash|zsh|sh`:先下载脚本文本,成功执行后捕获其 stdout,再由同一父 shell 求值。安装日志在 stderr,stdout 仅为已安装 CLI 的本地激活片段。PowerShell 在当前进程执行激活,传入实际 `$PROFILE`。
91
+
92
+ 受管入口位于用户 bin 的 `.arkcli-managed` 子目录,避开 npm 登记的旧 bin 文件;旧包卸载或后台更新不改变后来选择的入口。用户 alias/function 保留,遮挡时说明原因。安装退出码、实际裸命令路径、版本和编译期 product 分开核验。Agent 子进程不能修改用户已经打开的父终端;执行过一次子进程安装不能宣称用户当前终端已生效。
93
+
94
+ 原始裸 `npm install -g` 和 `curl | sh` 保留其安装能力,完整立即生效契约覆盖上述安装流程。此本地维护入口不支持 `--dry-run`,不得伪造 Client Preview 或把激活片段当作任意业务命令。