nikou-cli 0.1.46 → 0.1.48

package/README.md

@@ -286,7 +286,7 @@ node -e 'const s=require("/root/.nikou-block/state/worker.json"); console.log({p
 
 绑定成功后会返回绿色状态卡片，展示本次绑定、当前群的全部普通目录绑定、完整路径、对应 Agent，以及知识库固定绑定（如有）。卡片底部同时给出省略盘符路径、完整路径和无路径选择三种解绑方式，便于确认当前真实绑定状态。
 
-群聊内任何成员都可以发送解绑指令。路径既支持完整路径，也支持省略盘符后的末两级路径；不带路径时会显示卡片供用户选择。Agent 选择卡片会展示省略盘符路径、在线状态：在线 Agent 带绿色状态标识且可选择，离线 Agent 会置灰禁用；卡片会倒计时 10 秒，超时自动使用当前群最近一次成功选择且仍在线的 Agent；没有可用默认 Agent 时，才会发送置灰的超时状态卡片。卡片底部同时提示解绑方式。
+群聊内任何成员都可以发送解绑指令。路径既支持完整路径，也支持省略盘符后的末两级路径；不带路径时会显示卡片供用户选择。Agent 选择卡片会展示省略盘符路径、在线状态：在线 Agent 带绿色状态标识且可选择，离线 Agent 会置灰禁用；同一个话题首次选择 Agent 后，后续消息会继续定向到该 Agent，不再重复弹出选择卡片；不同话题仍然独立选择。卡片会倒计时 10 秒，超时自动使用当前群最近一次成功选择且仍在线的 Agent；没有可用默认 Agent 时，才会发送置灰的超时状态卡片。卡片底部同时提示解绑方式。
 
 ```text
 @妮蔻 解绑 D:\project\hst\report
@@ -312,35 +312,20 @@ nikou-cli hook binding remove \
 
 群聊发送 `绑定知识库` 后，任务会定向到配置的知识库 Worker 和固定目录，并返回不暴露知识库目录、IP 或宿主的红色绑定状态卡片。卡片同时展示当前群其他 Agent 目录绑定和解绑指令。发送 `解绑知识库` 可移除当前群的知识库固定绑定。知识库绑定只作用于群聊；单聊仍按发送人的飞书 `user_id` 选择其归属 Worker，同一用户多台 Worker 在线时优先使用最近接入的一台。
 
-专用知识库 Worker 建议在从节点配置中关闭单聊，并设置可区分的启动通知名称：
+`knowledge` 引擎默认关闭单聊，仍可承接群聊知识库固定路由，但不会成为宿主的单聊候选。启动通知由主节点根据 Worker 上下线状态发送，展示运行引擎、当前模型、服务范围和 `nikou-cli` 版本，并检查 npm 是否有更新；网络暂时不可用时只标记“无法检测更新”，不阻塞节点启动。
 
-```json
-{
-  "hook": {
-    "p2p_enabled": false,
-    "worker_name": "公司知识库妮蔻"
-  }
-}
-```
-
-关闭后，该 Worker 仍可承接群聊知识库固定路由，但不会成为宿主的单聊候选。启动通知使用交互卡片展示从节点名称、运行引擎、当前模型、服务范围和 `nikou-cli` 版本，并检查 npm 是否有更新；知识库固定 Worker 也使用同一张卡片。网络暂时不可用时只标记“无法检测更新”，不阻塞节点启动。未配置时 `p2p_enabled` 默认为 `true`，保持旧 Worker 行为。
-
-Worker 启动时会用 `ops_user` 解析飞书宿主身份和职务。可在私有配置的 `hook.owner_email_domain`（或环境变量 `NIKOU_OWNER_EMAIL_DOMAIN`）配置邮箱域，例如 `example.com`；首次启动会以 `ops_user@example.com` 查询飞书并写入本地身份缓存。`~/ops/vops_user.json` 仅作为缓存加速，缺失时不会阻止身份解析。管理状态中的 `perspectiveStatus` 可区分 `identity_unresolved`（身份未补齐）和 `job_title_unmatched`（已获取职务但未命中视角）。
+主节点会根据 Worker 上报的 `ops_user` 统一解析飞书宿主身份、职务和视角，并在连接握手中返回给 Worker。邮箱域统一配置在主节点的 `hook.owner_email_domain`（或主节点环境变量 `NIKOU_OWNER_EMAIL_DOMAIN`）。飞书 App ID 和 App Secret 只保存在主节点；Worker 获取用户、群聊、消息历史、图片和附件时，通过已认证的主从通道调用受限飞书网关，不保存或接收飞书凭证。管理状态中的 `perspectiveStatus` 可区分 `identity_unresolved`（身份未补齐）和 `job_title_unmatched`（已获取职务但未命中视角）。
 
 知识库 Worker 可以使用 `knowledge` 引擎直接连接 FastGPT 应用。此模式不会启动 Claude，也不会在 Worker 内重复连接知识库或代码 MCP；FastGPT 应用负责完成知识检索、内部工具调用和回答生成，Worker 只负责会话、流式事件与飞书卡片适配：
 
 ```json
 {
-  "hook": {
-    "p2p_enabled": false,
-    "worker_name": "公司知识库妮蔻",
-    "knowledge": {
-      "provider": "fastgpt",
-      "base_url": "http://127.0.0.1:3000/api",
-      "api_key_env": "NIKOU_FASTGPT_APP_KEY",
-      "request_timeout_ms": 600000,
-      "retain_dataset_cite": true
-    }
+  "knowledge": {
+    "provider": "fastgpt",
+    "base_url": "http://127.0.0.1:3000/api",
+    "api_key_env": "NIKOU_FASTGPT_APP_KEY",
+    "request_timeout_ms": 600000,
+    "retain_dataset_cite": true
   }
 }
 ```
@@ -353,26 +338,38 @@ API Key 必须来自 `api_key_env` 指定的环境变量，不支持把真实 Ke
 nikou-cli hook init
 ```
 
-初始化只需要以上一条命令，不需要预先创建 JSON。命令按从节点模式初始化，并提示主节点地址和首次安装缺少的飞书信息；所有 Secret 输入均不会回显。运行凭据写入 npm 包之外的本机私有目录，配置文件和备份权限固定为 `0600`，初始化摘要不会展示任何 Secret。默认主节点地址为 `127.0.0.1`；如果旧配置里已有非本机主节点地址，则沿用该地址。
+初始化只需要以上一条命令，不需要预先创建 JSON。命令按从节点模式初始化，只提示主节点地址和主从接入密钥，不再要求飞书 App ID 或 App Secret；所有 Secret 输入均不会回显。运行凭据写入 npm 包之外的本机私有目录，配置文件和备份权限固定为 `0600`，初始化摘要不会展示任何 Secret。默认主节点地址为 `127.0.0.1`；如果旧配置里已有非本机主节点地址，则沿用该地址。
 
 内部批量安装可使用参数完成非交互初始化。推荐由安装系统注入 Secret 环境变量，避免密钥出现在 Shell 历史和进程参数中：
 
 ```bash
-FEISHU_APP_SECRET="$YOUR_FEISHU_APP_SECRET" \
 NIKOU_HOOK_SHARED_SECRET="$YOUR_HOOK_SHARED_SECRET" \
 nikou-cli hook init \
-  --app-id cli_xxx \
   --master-ip 203.0.113.10 \
   --deployment slave \
   --yes
 ```
 
-也兼容 `--app-secret`、`--shared-secret` 明文参数，但只建议在受控安装环境使用。参数同时支持 `--app_id`、`--app_secret` 和 `--masterip` 别名。
+也兼容 `--shared-secret` 明文参数，但只建议在受控安装环境使用。主节点或本机一体模式仍可使用 `--app-id`、`--app-secret` 配置飞书凭证；从节点模式会忽略并移除本地飞书凭证。
 
 单独从节点连接已有主节点时，不要求配置主节点专用的 `hook.bind_allowed_user_ids`。本机一体或单独启动主节点时，仍必须至少配置一个允许绑定的飞书 `user_id`。
 从节点模式只写入 `~/.nikou-block/worker/config.json`，不再生成或覆盖主节点配置；
 检测到历史 `~/.nikou-block/master/config.json` 时只告警，不会未经确认自动删除。
 
+从节点生成的 Hook 配置保持最小化：
+
+```json
+{
+  "hook": {
+    "master_host": "203.0.113.10",
+    "master_port": 19732,
+    "shared_secret": "CHANGE_ME"
+  }
+}
+```
+
+AI 引擎、模型、本地目录以及 FastGPT 等引擎专用密钥仍属于本机运行配置，不会从主节点下发。升级时应先部署主节点，再逐个升级 Worker；新主节点兼容仍持有本地飞书凭证的旧 Worker，新 Worker 连接不支持飞书网关的旧主节点时会明确提示先升级主节点。
+
 `ai-hook` 裸命令仅为个人节点兼容旧习惯，仍默认等价于 `nikou-cli hook worker codex`；如需在个人节点启动 Claude Worker：
 
 ```bash