npm - nikou-cli - Versions diffs - 0.1.28 → 0.1.30 - Mend

nikou-cli 0.1.28 → 0.1.30

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.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -368,6 +368,8 @@ nikou-cli hook init \
 也兼容 `--app-secret`、`--shared-secret` 明文参数，但只建议在受控安装环境使用。参数同时支持 `--app_id`、`--app_secret` 和 `--masterip` 别名。
 单独从节点连接已有主节点时，不要求配置主节点专用的 `hook.bind_allowed_user_ids`。本机一体或单独启动主节点时，仍必须至少配置一个允许绑定的飞书 `user_id`。
+从节点模式只写入 `~/.nikou-block/worker/config.json`，不再生成或覆盖主节点配置；
+检测到历史 `~/.nikou-block/master/config.json` 时只告警，不会未经确认自动删除。
 `ai-hook` 裸命令为兼容旧习惯，仍默认等价于 `nikou-cli hook worker codex`；如需只启动 Claude Worker：
@@ -432,10 +434,36 @@ nikou-cli hook local codex
 ### 启动主节点
+主节点首次启动前，必须在唯一授权主机上设置启动密码：
+```bash
+nikou-cli hook master-password --set
+```
+命令会隐藏读取并二次确认密码。JSON 配置只保存带盐哈希；密码本身只保存在当前
+主机的 `~/.nikou-block/master/master-start-password`，文件权限为 `0600`。也可以通过
+`NIKOU_MASTER_START_PASSWORD` 注入密码。未配置、缺少本机凭据或密码不匹配时，
+`hook master` 和 `hook local` 都会在建立飞书长连接前拒绝启动。
+同一系统用户下还会持有 `~/.nikou-block/master/master.lock` 独占锁，禁止用不同端口
+重复启动第二个主节点；进程异常退出后会按锁内 PID 自动清理陈旧锁。
 ```bash
 nikou-cli hook master
 ```
+主节点完成启动并建立飞书长连接后，会向私有配置 `hook.master_notify_user_id` 指定的
+固定飞书用户发送单聊通知，不会从绑定白名单推断接收人。通知包含主节点 IP；如果能从
+本机 `~/ops/ops_global.properties` 读取到 `ops_user`，还会同时展示主节点名称。未配置
+固定接收人时跳过通知。
+```json
+{
+  "hook": {
+    "master_notify_user_id": "YOUR_FEISHU_USER_ID"
+  }
+}
+```
 覆盖监听参数：
 ```bash
@@ -445,6 +473,10 @@ nikou-cli hook master \
   --shared-secret CHANGE_ME
 ```
+怀疑存在未知旧主节点时，应在飞书后台轮换 App Secret，只把新 Secret 更新到授权主节点
+和确实需要调用飞书 API 的受控 Worker，再重启并核验；禁止分发到其他机器。启动密码不能
+替代 App Secret 轮换，因为它无法终止已经运行的旧版本进程。
 ### 主节点管理接口
 主节点可以额外开一个 HTTP 管理接口，供 CC Switch 的「妮蔻 · 主节点」模块远程

package/dist/chunk-RZ3BMXAU.js ADDED Viewed

@@ -0,0 +1 @@