@skylandnpm/octopus-proxy 0.1.71 → 0.1.72

package/README.md

@@ -1,5 +1,7 @@
 # Octopus Proxy
 
+**Embodied Dots** 意为**具身智能体节点**，是连接远程主机与智能体工作空间的节点。Taskhub 和 Claw 的菜单和列表使用复数 Dots，单个节点及其设置使用单数 Dot；接口字段 `botId`、CLI 参数 `--bot-id` 和数据库表 `hub_bots` 保持不变，已有节点和凭据可继续使用。
+
 Octopus Proxy 是运行在 macOS 或 Linux 主机上的 Octopus 代理，提供 `octopus-proxy` 命令来初始化配置、安装系统服务和检查运行状态。需要 Node.js 22 或更高版本。
 
 ## 安装
@@ -14,9 +16,9 @@ octopus-proxy identity
 
 向导默认安装服务；使用 `--no-install-service` 时，之后运行 `octopus-proxy install`。安装和重装会保留原主机密钥。`--prefer-online` 会让 npm 在安装时重新校验 registry 中的包元数据，避免本地缓存使 `@latest` 仍指向旧版本，不再需要先运行 `npm view @skylandnpm/octopus-proxy versions`。如果升级后 `octopus-proxy version` 仍显示旧版本，运行 `command -v npm`、`npm prefix -g` 和 `command -v octopus-proxy`，确认 npm 的全局安装目录与实际执行的命令属于同一套 Node.js 环境；使用 NVM 与 Homebrew 时尤其要检查这一点。
 
-向导默认使用 `https://octopus.wuyehao.com` 作为 Hub 地址；按需可输入其他地址，或用 `--hub-url` 指定。再次运行向导时会读取现有配置，直接回车即可保留各项设置；机器人 Secret 只提示已配置，不在终端显示原值。macOS 上选择编码工具时，向导优先显示已配置或探测到的命令路径，否则给出该工具的 macOS 路径示例；回车后会检查文件可执行性并运行版本命令，失败时要求重新输入。无交互环境可使用 `octopus-proxy onboard --non-interactive`，未提供 `--hub-url` 时也使用该默认地址；完整选项见 `octopus-proxy help`。安装服务后可运行 `octopus-proxy status` 和 `octopus-proxy doctor` 检查状态。
+向导默认使用 `https://octopus.wuyehao.com` 作为 Hub 地址；按需可输入其他地址，或用 `--hub-url` 指定。再次运行向导时会读取现有配置，直接回车即可保留各项设置；Dot Secret 只提示已配置，不在终端显示原值。macOS 上选择编码工具时，向导优先显示已配置或探测到的命令路径，否则给出该工具的 macOS 路径示例；回车后会检查文件可执行性并运行版本命令，失败时要求重新输入。无交互环境可使用 `octopus-proxy onboard --non-interactive`，未提供 `--hub-url` 时也使用该默认地址；完整选项见 `octopus-proxy help`。安装服务后可运行 `octopus-proxy status` 和 `octopus-proxy doctor` 检查状态。
 
-Proxy 主动连接 Hub 的 `/ws/proxy-chat`，无需开放入站端口或安装 sshd。Claw 经 `/ws/claw-chat` 建立到 Proxy 的内层 TLS 1.3 会话；Hub 只转发加密字节。首次打开工作区显示主机公钥指纹；核对后点击 Trust，未授权设备还需输入主机终端生成的配对码。Proxy 校验设备签名、配对码及主机密码并持久化设备授权，Claw 在认证成功后按 Hub 地址和机器人 ID 固定指纹；之后指纹变化会拒绝连接。每次连接都要输入运行 Proxy 服务账号的主机密码，由主机上的 PAM（Linux）或 Open Directory（macOS）验证。断线或连续 60 分钟没有用户操作后需要重新认证。服务安装时生成主机身份，`octopus-proxy identity` 显示指纹并生成 3 天内有效、最多可成功配对 10 次的配对码。安装主机需提供 OpenSSL 和 C 编译器；Linux 还需 PAM 开发头文件。机器人 Secret 仅用于 Hub 路由，不能单独授权工作区。
+Proxy 主动连接 Hub 的 `/ws/proxy-chat`，无需开放入站端口或安装 sshd。Claw 经 `/ws/claw-chat` 建立到 Proxy 的内层 TLS 1.3 会话；Hub 只转发加密字节。首次打开工作区显示主机公钥指纹；核对后点击 Trust，未授权设备还需输入主机终端生成的配对码。Proxy 校验设备签名、配对码及主机密码并持久化设备授权，Claw 在认证成功后按 Hub 地址和 Dot ID 固定指纹；之后指纹变化会拒绝连接。每次连接都要输入运行 Proxy 服务账号的主机密码，由主机上的 PAM（Linux）或 Open Directory（macOS）验证。断线或连续 60 分钟没有用户操作后需要重新认证。服务安装时生成主机身份，`octopus-proxy identity` 显示指纹并生成 3 天内有效、最多可成功配对 10 次的配对码。安装主机需提供 OpenSSL 和 C 编译器；Linux 还需 PAM 开发头文件。Dot Secret 仅用于 Hub 路由，不能单独授权工作区。
 
 macOS 12.3 及以上运行 `octopus-proxy onboard` 时，配置保存后、服务启动前会准备截屏辅助程序并申请系统屏幕录制权限；已授权时不会重复弹窗。交互模式和 `--non-interactive` 均执行此步骤，`--no-install-service` 也会申请。请在系统弹窗中允许访问；拒绝、超时或辅助程序编译失败时，向导提示原因与授权路径，并继续初始化。在“系统设置 → 隐私与安全性 → 屏幕录制（或屏幕与系统音频录制）”中应授权弹窗显示的实际程序，可能是 Terminal、iTerm、编辑器或 node，不保证出现 `octopus-desktop-capture`。onboard 和 doctor 会显示辅助程序路径，文件名不等于系统授权名称。终端授权不代表后台服务已授权，需在 Claw 点击截屏，让实际服务申请权限，按实际名称授权后重启 Proxy。Linux 没有通用的截屏授权弹窗，需使用桌面用户的图形会话环境；平台依赖与设置见[桌面快照说明](../../docs/claw-desktop-snapshots.md)。
 
@@ -58,9 +60,9 @@ NODE
 octopus-proxy restart
 ```
 
-Claw 完成主机信任和账号认证后，通过端到端会话向 Proxy 发送只读 `runtime.snapshot` 命令。响应包含当前运行状态、Hub 和工具设置、授权项目路径，以及工具可提供的模型信息；机器人 Secret、工具密码和提供商凭据不会返回。工作区的“Proxy 信息”按钮可查看这些内容。
+Claw 完成主机信任和账号认证后，通过端到端会话向 Proxy 发送只读 `runtime.snapshot` 命令。响应包含当前运行状态、Hub 和工具设置、授权项目路径，以及工具可提供的模型信息；Dot Secret、工具密码和提供商凭据不会返回。工作区的“Proxy 信息”按钮可查看这些内容。
 
-Codex 和 ZCode 由 Proxy 按授权项目启动各自的 app-server，默认随 Proxy 自动启动；服务未就绪时也可在 Claw 点击“启动服务”。若命令不可执行或某个项目启动失败，工作区会显示失败项目及原因。通过 `onboard` 或配置文件修改授权项目后，Claw 打开、切换或刷新工作区项目时会读取最新项目配置；目录变化会释放该项目的旧运行资源和终端，并刷新文件面板。Proxy 不轮询配置文件，也不因主机配置变化主动推送刷新通知。Claw 也可在授权项目菜单中点击“修改项目”，修改“Proxy 主机上的目录”并保存；Proxy 校验目录存在且未重复授权后写入主机配置，Claw 随即刷新工作区，无需重启 Proxy。修改工具命令、机器人凭据等其他设置后，仍需运行 `octopus-proxy restart`。
+Codex 和 ZCode 由 Proxy 按授权项目启动各自的 app-server，默认随 Proxy 自动启动；服务未就绪时也可在 Claw 点击“启动服务”。若命令不可执行或某个项目启动失败，工作区会显示失败项目及原因。通过 `onboard` 或配置文件修改授权项目后，Claw 打开、切换或刷新工作区项目时会读取最新项目配置；目录变化会释放该项目的旧运行资源和终端，并刷新文件面板。Proxy 不轮询配置文件，也不因主机配置变化主动推送刷新通知。Claw 也可在授权项目菜单中点击“修改项目”，修改“Proxy 主机上的目录”并保存；Proxy 校验目录存在且未重复授权后写入主机配置，Claw 随即刷新工作区，无需重启 Proxy。修改工具命令、Dot 凭据等其他设置后，仍需运行 `octopus-proxy restart`。
 
 ## Claw 设备配对与撤销
 
@@ -72,7 +74,7 @@ octopus-proxy identity
 
 命令显示主机完整公钥指纹、6 位数字配对码及到期时间。请核对 Claw 显示的主机指纹，再输入配对码及服务账号密码。配对码 3 天内有效，最多可成功配对 10 次，次数用尽后失效。已授权设备重连不消耗配对次数，失败的配对不消耗成功次数；最多允许 5 次失败配对提交，跨设备和连接累计，达到上限会提前关闭配对窗口。每次运行 `identity` 都废止旧码并重置次数和有效期。`octopus-proxy identity --cancel` 可立即关闭窗口。Proxy 服务未运行时，命令显示指纹并报错，不生成不可使用的配对码。
 
-一个 Proxy 支持多台 Claw 同时在线，最多 32 条并发隧道。添加下一台设备时可复用有效且仍有剩余次数的配对码，或重新运行 `identity` 生成新码；已有授权和连接不受影响。已授权设备重连、Claw 重开、Proxy 重启或更新均无需再次配对，但每条新连接仍需主机密码认证。配对码只保存在服务内存中，重启即失效；设备授权单独保存在状态目录的 `authorized-devices.json`（权限 `0600`），按 Hub origin、机器人 ID 和设备公钥隔离。
+一个 Proxy 支持多台 Claw 同时在线，最多 32 条并发隧道。添加下一台设备时可复用有效且仍有剩余次数的配对码，或重新运行 `identity` 生成新码；已有授权和连接不受影响。已授权设备重连、Claw 重开、Proxy 重启或更新均无需再次配对，但每条新连接仍需主机密码认证。配对码只保存在服务内存中，重启即失效；设备授权单独保存在状态目录的 `authorized-devices.json`（权限 `0600`），按 Hub origin、Dot ID 和设备公钥隔离。
 
 ```bash
 octopus-proxy devices
@@ -188,7 +190,7 @@ npm run publish
 
 ## 编码工具账号与 OpenCode 服务
 
-Claw 机器人设置可通过已解锁的端到端会话查询和切换当前机器人连接的 Proxy 智能体。`runtime.models` 接收 `{ "kind": "codex" }`（也支持 `opencode`、`zcode`、`pi`），临时查询所选工具原生模型目录，不修改当前 `tool`。`runtime.switchTool` 使用相同参数，先启动新工具并验证原生连接，成功后以 0600 权限原子保存配置，再关闭旧工具的 Proxy 管理进程；外部 OpenCode 服务继续由主机管理。
+Claw Dot 设置可通过已解锁的端到端会话查询和切换当前 Dot 连接的 Proxy 智能体。`runtime.models` 接收 `{ "kind": "codex" }`（也支持 `opencode`、`zcode`、`pi`），临时查询所选工具原生模型目录，不修改当前 `tool`。`runtime.switchTool` 使用相同参数，先启动新工具并验证原生连接，成功后以 0600 权限原子保存配置，再关闭旧工具的 Proxy 管理进程；外部 OpenCode 服务继续由主机管理。
 
 各工具的命令、OpenCode 地址和服务密码保存在配置文件的 `toolProfiles` 中，切回时恢复。首次选择工具会在此 Proxy 主机探测命令；自定义安装位置可预先设置 `toolProfiles.<kind>`，格式与 `tool` 相同，且其中 `kind` 必须匹配。智能体未安装、启动或连接失败时保留当前工具和配置。已打开工作区会通过 `octopus.resync` 更新能力、会话和模型。
 

package/dist/{chunk-GOPKVIVH.js → chunk-CGHUM2TC.js}

@@ -7763,7 +7763,7 @@ async function startDeviceControl(directory, devices, connections) {
       void (async () => {
         try {
           const message = JSON.parse(input.split("\n")[0]);
-          if (message.scope && !devices.matchesScope(message.scope.hubOrigin, message.scope.botId)) throw new Error("\u914D\u7F6E\u7684 Hub \u6216\u673A\u5668\u4EBA\u4E0E\u8FD0\u884C\u4E2D\u7684 Proxy \u4E0D\u4E00\u81F4\uFF0C\u8BF7\u786E\u8BA4 --config");
+          if (message.scope && !devices.matchesScope(message.scope.hubOrigin, message.scope.botId)) throw new Error("\u914D\u7F6E\u7684 Hub \u6216 Dot \u4E0E\u8FD0\u884C\u4E2D\u7684 Proxy \u4E0D\u4E00\u81F4\uFF0C\u8BF7\u786E\u8BA4 --config");
           let data;
           switch (message.action) {
             case "pair":

package/dist/cli.js

@@ -35,7 +35,7 @@ import {
   supportedPlatform,
   systemdUnitPath,
   toolSearchDirs
-} from "./chunk-GOPKVIVH.js";
+} from "./chunk-CGHUM2TC.js";
 import {
   DESKTOP_PERMISSION_GUIDANCE,
   PlatformDesktop,
@@ -535,7 +535,7 @@ var validUrl = (value) => {
 };
 var validId = (value) => !value ? "\u9879\u76EE ID \u4E0D\u80FD\u4E3A\u7A7A" : /^[a-zA-Z0-9_-]+$/.test(value) ? void 0 : "\u4EC5\u9650\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u4E0B\u5212\u7EBF\u548C\u8FDE\u5B57\u7B26";
 var validateProjectId = (value, previousProjects) => validId(value) ?? (previousProjects.some((project) => project.id === value) ? `\u9879\u76EE ID\u300C${value}\u300D\u5DF2\u5B58\u5728\uFF0C\u8BF7\u8F93\u5165\u5176\u4ED6 ID` : void 0);
-var validBotId = (value) => /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value) ? void 0 : "\u8BF7\u8F93\u5165\u673A\u5668\u4EBA UUID";
+var validBotId = (value) => /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value) ? void 0 : "\u8BF7\u8F93\u5165 Dot UUID";
 var run4 = promisify4(execFile4);
 var MACOS_TOOL_EXAMPLES = {
   opencode: "/Users/luhuili/.opencode/bin/opencode",
@@ -573,11 +573,11 @@ async function runOnboard(opts) {
   if (opts.interactive) {
     const rl = createInterface({ input: stdin, output: stdout });
     console.log("Octopus Proxy \u521D\u59CB\u5316\u5411\u5BFC");
-    console.log(`\u914D\u7F6E\u5C06\u5199\u5165 ${opts.configPath}\uFF1B\u6587\u4EF6\u5305\u542B\u673A\u5668\u4EBA Secret\uFF0C\u4F1A\u4EE5 0600 \u6743\u9650\u4FDD\u5B58\u3002
+    console.log(`\u914D\u7F6E\u5C06\u5199\u5165 ${opts.configPath}\uFF1B\u6587\u4EF6\u5305\u542B Dot Secret\uFF0C\u4F1A\u4EE5 0600 \u6743\u9650\u4FDD\u5B58\u3002
 `);
     hubUrl = await ask(rl, `Hub \u5730\u5740\uFF08${hubUrl} , \u56DE\u8F66\u76F4\u63A5\u786E\u8BA4\uFF09`, { default: hubUrl, showDefault: false, validate: validUrl });
-    botId = await ask(rl, "\u673A\u5668\u4EBA ID\uFF08\u5728 Claw \u6216 Taskhub \u4E2D\u521B\u5EFA\u5E76\u590D\u5236\uFF09", { default: botId || void 0, validate: validBotId });
-    secretKey = await ask(rl, "\u673A\u5668\u4EBA Secret\uFF08\u5728 Claw \u6216 Taskhub \u521B\u5EFA\uFF1B\u8F93\u5165\u4F1A\u56DE\u663E\u5728\u7EC8\u7AEF\uFF09", { default: secretKey || void 0, defaultDisplay: existing?.secretKey ? "\u5DF2\u914D\u7F6E\uFF0C\u56DE\u8F66\u4FDD\u7559" : "\u5DF2\u63D0\u4F9B\uFF0C\u56DE\u8F66\u4F7F\u7528", validate: (value) => value.length >= 20 ? void 0 : "\u8BF7\u8F93\u5165\u5B8C\u6574\u7684\u673A\u5668\u4EBA Secret" });
+    botId = await ask(rl, "Dot ID\uFF08\u5728 Claw \u6216 Taskhub \u4E2D\u521B\u5EFA\u5E76\u590D\u5236\uFF09", { default: botId || void 0, validate: validBotId });
+    secretKey = await ask(rl, "Dot Secret\uFF08\u5728 Claw \u6216 Taskhub \u521B\u5EFA\uFF1B\u8F93\u5165\u4F1A\u56DE\u663E\u5728\u7EC8\u7AEF\uFF09", { default: secretKey || void 0, defaultDisplay: existing?.secretKey ? "\u5DF2\u914D\u7F6E\uFF0C\u56DE\u8F66\u4FDD\u7559" : "\u5DF2\u63D0\u4F9B\uFF0C\u56DE\u8F66\u4F7F\u7528", validate: (value) => value.length >= 20 ? void 0 : "\u8BF7\u8F93\u5165\u5B8C\u6574\u7684 Dot Secret" });
     stateDirectory = expandHome(await ask(rl, "\u72B6\u6001\u76EE\u5F55", { default: stateDirectory, validate: (value) => isAbsolute4(expandHome(value)) ? void 0 : "\u5FC5\u987B\u662F\u7EDD\u5BF9\u8DEF\u5F84" }));
     const previousToolKind = toolKind;
     toolKind = await ask(rl, `\u7F16\u7801\u5DE5\u5177\uFF08${TOOL_KINDS.join("/")}\uFF09`, { default: toolKind, validate: (value) => TOOL_KINDS.includes(value) ? void 0 : `\u8F93\u5165 ${TOOL_KINDS.join(" \u6216 ")}` });
@@ -635,7 +635,7 @@ async function runOnboard(opts) {
     if (missing.length) throw new Error(`\u975E\u4EA4\u4E92\u6A21\u5F0F\u7F3A\u5C11\u5FC5\u586B\u53C2\u6570\uFF1A${missing.join("\u3001")}`);
     const urlProblem = validUrl(hubUrl);
     if (urlProblem) throw new Error(`${urlProblem}\uFF08--hub-url\uFF09`);
-    if (validBotId(botId) || secretKey.length < 20) throw new Error("\u673A\u5668\u4EBA ID \u6216 Secret \u683C\u5F0F\u65E0\u6548");
+    if (validBotId(botId) || secretKey.length < 20) throw new Error("Dot ID \u6216 Secret \u683C\u5F0F\u65E0\u6548");
     projects = projects.map((project) => ({ ...project, id: project.id ?? slug(project.name) }));
     const invalid = projects.find((project) => validId(project.id ?? "") !== void 0);
     if (invalid) throw new Error(`\u9879\u76EE\u300C${invalid.name}\u300D\u65E0\u6CD5\u63A8\u5BFC\u51FA\u5408\u6CD5 ID\uFF08\u4EC5\u9650\u5B57\u6BCD\u3001\u6570\u5B57\u3001\u4E0B\u5212\u7EBF\u548C\u8FDE\u5B57\u7B26\uFF09\uFF0C\u8BF7\u8C03\u6574\u540D\u79F0\u6216\u624B\u5DE5\u6307\u5B9A ID`);
@@ -893,10 +893,10 @@ var USAGE = `octopus-proxy \u2014 Octopus \u4E3B\u673A\u4EE3\u7406
   --config <path>      \u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84\uFF08\u9ED8\u8BA4 $OCTOPUS_PROXY_CONFIG \u6216 ~/.config/octopus/proxy.json\uFF09
 
 onboard \u9009\u9879:
-  --non-interactive        \u975E\u4EA4\u4E92\u6A21\u5F0F\uFF1B\u9700\u63D0\u4F9B\u673A\u5668\u4EBA ID\u3001Secret \u548C\u9879\u76EE
+  --non-interactive        \u975E\u4EA4\u4E92\u6A21\u5F0F\uFF1B\u9700\u63D0\u4F9B Dot ID\u3001Secret \u548C\u9879\u76EE
   --hub-url <url>          Hub \u5730\u5740\uFF08\u9ED8\u8BA4 https://octopus.wuyehao.com\uFF09
-  --bot-id <uuid>          Claw \u6216 Taskhub \u4E2D\u521B\u5EFA\u7684\u673A\u5668\u4EBA ID
-  --secret-key <key>       \u673A\u5668\u4EBA Secret\uFF08\u5728 Claw \u6216 Taskhub \u521B\u5EFA\uFF09
+  --bot-id <uuid>          Claw \u6216 Taskhub \u4E2D\u521B\u5EFA\u7684 Dot ID
+  --secret-key <key>       Dot Secret\uFF08\u5728 Claw \u6216 Taskhub \u521B\u5EFA\uFF09
   --state-dir <path>       \u72B6\u6001\u76EE\u5F55\uFF08\u9ED8\u8BA4 ~/.local/state/octopus\uFF09
   --project <name=path>    \u6388\u6743\u9879\u76EE\uFF0C\u53EF\u91CD\u590D\u591A\u6B21
   --tool <kind>            \u7F16\u7801\u5DE5\u5177\uFF1Aopencode\uFF08\u9ED8\u8BA4\uFF09\u3001codex\u3001zcode \u6216 pi

package/dist/main.js

@@ -2,7 +2,7 @@
 import {
   ConfigError,
   runDaemon
-} from "./chunk-GOPKVIVH.js";
+} from "./chunk-CGHUM2TC.js";
 import "./chunk-OTKNRBZ7.js";
 
 // src/main.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skylandnpm/octopus-proxy",
-  "version": "0.1.71",
+  "version": "0.1.72",
   "type": "module",
   "description": "Octopus host proxy: OpenCode, Codex, ZCode and Pi adapters with service installer CLI",
   "bin": {