nikou-cli 0.1.34 → 0.1.35

package/README.md

@@ -351,7 +351,7 @@ API Key 必须来自 `api_key_env` 指定的环境变量，不支持把真实 Ke
 nikou-cli hook init
 ```
 
-初始化只需要以上一条命令，不需要预先创建 JSON。命令会提示部署方式、主节点地址和首次安装缺少的飞书信息；所有 Secret 输入均不会回显。本机一体模式会自动随机生成主从共享密钥，从节点模式则安全读取已有主节点的共享密钥。运行凭据写入 npm 包之外的本机私有目录，配置文件和备份权限固定为 `0600`，初始化摘要不会展示任何 Secret。没有远端主节点配置时默认选择本机一体，并使用 `127.0.0.1`；如果旧配置里已有非本机主节点地址，默认选择从节点并沿用该地址。
+初始化只需要以上一条命令，不需要预先创建 JSON。命令按从节点模式初始化，并提示主节点地址和首次安装缺少的飞书信息；所有 Secret 输入均不会回显。运行凭据写入 npm 包之外的本机私有目录，配置文件和备份权限固定为 `0600`，初始化摘要不会展示任何 Secret。默认主节点地址为 `127.0.0.1`；如果旧配置里已有非本机主节点地址，则沿用该地址。
 
 内部批量安装可使用参数完成非交互初始化。推荐由安装系统注入 Secret 环境变量，避免密钥出现在 Shell 历史和进程参数中：
 
@@ -515,11 +515,35 @@ nikou-cli hook admin-key --show   # 打印完整密钥，注意不要外发
 | GET | `/admin/log?page=1&pageSize=200&keyword=` | 主节点日志分页，`page=1` 为最新一页 |
 | GET | `/admin/stats?days=7` | 按天任务统计，读本机 `usage-events.sqlite` |
 | POST | `/admin/restart` | 主节点自行退出，由 systemd `Restart=always` 拉起 |
+| POST | `/admin/workers/:workerId/remote-support` | 指定 Worker 执行一次远程 AI 支持会话 |
+| GET | `/admin/remote-support/:requestId` | 查询远程支持会话及实时事件 |
+| POST/DELETE | `/admin/remote-support/:requestId/cancel` | 取消远程支持会话 |
 
 安全边界：密钥只做常量时间比较，鉴权失败按来源 IP 限流（5 分钟内 8 次后返回
 429），日志不打印密钥；返回体只含运行态与脱敏 Worker 摘要，不含飞书凭据、
 `shared_secret` 或统计库账号。重启依赖 systemd 托管，未托管时接口直接拒绝。
 
+#### 远程 Worker 支持会话
+
+远程支持会话用于管理员从 CC Switch 直接联通、排查或复测指定从节点，不经过飞书
+任务路由，也不会发送飞书消息或渲染飞书卡片。请求体示例：
+
+```json
+{
+  "prompt": "test",
+  "dirPath": "/workspace/your-project",
+  "mode": "full_agent",
+  "timeoutMs": 120000
+}
+```
+
+`full_agent` 会复用目标 Worker 当前启动的引擎、模型、思考深度、执行目录权限及
+MCP/工具配置；从节点会实时回传状态、思考摘要、工具调用及结果、标准输出、错误
+和使用量，管理员页面可直接查看这些事件。`raw_probe` 只用于基础联通探测，不启动
+完整 Agent。执行目录必须是目标从节点本机存在且可访问的目录，路径不会在主节点上
+执行。新协议通过 Worker 启动握手中的可选能力字段协商，旧 Worker 不支持时会被
+主节点明确拒绝，不影响原有飞书任务。
+
 ### 启动从节点
 
 Codex：