nikou-cli 0.1.32 → 0.1.34

package/README.md

@@ -263,7 +263,7 @@ Kiro 的 `--model` / `--effort` 是「新建会话时」生效的初始值，当
 | 角色 | 运行内容 | 部署边界 |
 | --- | --- | --- |
 | 知识库宿主机主节点 | 飞书接入、任务路由、Worker 注册 | 与知识库 Worker 部署在同一台知识库宿主机，不按树莓派处理 |
-| 知识库宿主机 Worker | Claude Worker、知识库群聊任务 | 唯一的知识库 Claude Worker，关闭单聊路由 |
+| 知识库宿主机 Worker | FastGPT knowledge Worker、知识库群聊任务 | 唯一的知识库 Worker，关闭单聊路由 |
 | 个人节点 | Kiro/Codex 等个人 Worker | 仅处理对应宿主的单聊和绑定任务 |
 
 当前知识库宿主机同时托管主节点和唯一的知识库 Worker，两个 systemd 服务均配置为开机自启。发布新版本后，在同一台知识库宿主机安装对应版本，并按顺序重启两个服务：
@@ -272,13 +272,13 @@ Kiro 的 `--model` / `--effort` 是「新建会话时」生效的初始值，当
 npm install -g nikou-cli@<version> --force --registry=https://registry.npmjs.org/
 nikou-cli --version
 systemctl restart com.vangelis.agent-block.hook.master.service
-systemctl restart ai-hook-claude.service
-systemctl is-enabled com.vangelis.agent-block.hook.master.service ai-hook-claude.service
-systemctl is-active com.vangelis.agent-block.hook.master.service ai-hook-claude.service
+systemctl restart ai-hook-knowledge.service
+systemctl is-enabled com.vangelis.agent-block.hook.master.service ai-hook-knowledge.service
+systemctl is-active com.vangelis.agent-block.hook.master.service ai-hook-knowledge.service
 node -e 'const s=require("/root/.nikou-block/state/worker.json"); console.log({pid:s.pid,status:s.status,engine:s.engine,slaveConnectionStatus:s.slaveConnectionStatus})'
 ```
 
-验收时应确认两个服务均为 `enabled/active`，主节点监听端口和状态文件正常，Worker 使用目标版本、`engine=claude`、`slaveConnectionStatus=online`，并在主节点日志中确认该 Worker 的 `p2p_enabled=false`。同时确认不存在旧的 `ai-hook-knowledge.service`，以及主节点上只有这一个知识库 Claude Worker。FastGPT/知识库平台容器按各自仓库与服务说明单独部署。
+验收时应确认两个服务均为 `enabled/active`，知识库 unit 的 `ExecStart` 精确为 `nikou-cli hook worker knowledge`，主节点监听端口和状态文件正常，Worker 使用目标版本、`engine=knowledge`、`slaveConnectionStatus=online`，并在主节点日志中确认该 Worker 的 `p2p_enabled=false`。同时确认主节点上只有这一个知识库 Worker，没有其他引擎的 Worker unit 或进程。FastGPT/知识库平台容器按各自仓库与服务说明单独部署。
 
 群聊发送 `@机器人 绑定: <目录>` 时，主节点会先检查当前用户是否已经绑定该目录；已有绑定会直接返回当前绑定状态卡片。当前用户已有其他目录时，会通过卡片确认“覆盖原绑定”或“新增绑定目录”；覆盖操作会在新目录校验成功后再撤销旧绑定。一个群可以保留多个用户、多个目录的 Agent 绑定，绑定指令不会广播给其他 Worker 抢占。
 
@@ -321,7 +321,7 @@ nikou-cli hook binding remove \
 }
 ```
 
-关闭后，该 Worker 仍可承接群聊知识库固定路由，但不会成为宿主的单聊候选。启动通知使用交互卡片展示从节点名称、运行引擎、当前模型和服务范围。未配置时 `p2p_enabled` 默认为 `true`，保持旧 Worker 行为。
+关闭后，该 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`（已获取职务但未命中视角）。
 
@@ -371,7 +371,7 @@ nikou-cli hook init \
 从节点模式只写入 `~/.nikou-block/worker/config.json`，不再生成或覆盖主节点配置；
 检测到历史 `~/.nikou-block/master/config.json` 时只告警，不会未经确认自动删除。
 
-`ai-hook` 裸命令为兼容旧习惯，仍默认等价于 `nikou-cli hook worker codex`；如需只启动 Claude Worker：
+`ai-hook` 裸命令仅为个人节点兼容旧习惯，仍默认等价于 `nikou-cli hook worker codex`；如需在个人节点启动 Claude Worker：
 
 ```bash
 ai-hook claude --model claude-opus-4-8
@@ -452,9 +452,10 @@ nikou-cli hook master
 ```
 
 主节点完成启动并建立飞书长连接后，会向私有配置 `hook.master_notify_user_id` 指定的
-固定飞书用户发送单聊通知，不会从绑定白名单推断接收人。通知包含主节点 IP；如果能从
-本机 `~/ops/ops_global.properties` 读取到 `ops_user`，还会同时展示主节点名称。未配置
-固定接收人时跳过通知。
+固定飞书用户发送单聊启动卡片，不会从绑定白名单推断接收人。卡片包含主节点 IP、主节点
+名称、当前 `nikou-cli` 版本、npm 最新版本和更新状态；如果能从本机
+`~/ops/ops_global.properties` 读取到 `ops_user`，还会展示主节点名称。未配置固定接收人
+时跳过通知。主节点、普通从节点和知识库固定从节点的启动通知统一使用卡片。
 
 ```json
 {
@@ -568,8 +569,6 @@ nikou-cli hook worker api --api kiro
 FastGPT 知识库客户端：
 
 ```bash
-ai-hook knowledge
-# 完整入口
 nikou-cli hook worker knowledge
 ```
 
@@ -603,9 +602,10 @@ ai-hook claude --model claude-sonnet-4-6
 ai-hook gemini
 ai-hook kiro
 ai-hook api --api kiro
-ai-hook knowledge
 ```
 
+知识库宿主机不使用 `ai-hook` 兼容入口，必须使用唯一的 `nikou-cli hook worker knowledge` 启动方式。
+
 从节点连接主节点成功后，会向宿主发送启动卡片。卡片包含当前运行引擎、实际启动模型和单聊/群聊可用范围；通过飞书菜单切换模型并重启后，新卡片同时作为切换成功确认。
 
 ### 飞书机器人菜单事件