npm - nikou-cli - Versions diffs - 0.1.27 → 0.1.29 - Mend

nikou-cli 0.1.27 → 0.1.29

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

@@ -231,6 +231,31 @@ Hook 支持三种启动模式：
 主节点负责连接聊天平台、接收消息、维护 Worker 列表并分发任务。从节点负责连接主节点，收到任务后调用 Codex、Claude、Gemini、API Agent 或知识库客户端执行。
+### Worker 模型与思考深度独立固定
+Worker 的模型和思考深度由启动参数固定在当前进程上，不跟随本机原生 CLI 的后台切换。也就是说你在本机 `codex`、`claude`、`kiro-cli` 里换模型或换 effort，都不会影响正在运行的 Worker；要换就重启 Worker（CC Switch 的「妮蔻 · 运行档案」或飞书菜单会自动完成重启）。
+| 引擎 | `--model` 取值 | `--effort` 落地方式 |
+| --- | --- | --- |
+| `codex` | Codex 原生模型 ID，如 `gpt-5.6-sol` | 转换为 `-c model_reasoning_effort="<level>"`；Codex 没有 `max`，会按语义降到 `xhigh` |
+| `claude` | Claude Code 原生短横线模型 ID，如 `claude-opus-4-8`、`claude-sonnet-4-6` | 直接透传 Claude Code 的 `--effort` |
+| `kiro` | `kiro-cli chat --list-models` 中的模型 ID，如 `claude-opus-5`、`auto` | 直接透传 Kiro CLI 的 `--effort` |
+| `api` | profile 的 `models` 列表项 | 不适用，按 profile 配置 |
+`--effort` 取值为 `low|medium|high|xhigh|max`，默认 `medium`；非法值会被忽略，不会把脏值透传给底层 CLI。
+```bash
+nikou-cli hook worker codex --model gpt-5.6-sol --effort medium
+nikou-cli hook worker claude --model claude-opus-4-8 --effort high
+nikou-cli hook worker kiro --model claude-opus-5 --effort xhigh
+```
+Claude 的模型名必须用短横线原生 ID。`claude-opus-4.8` 这类小数点写法会被服务端当成不存在的模型返回 404。
+从节点启动卡片和任务结果卡片会展示实际生效的引擎、模型和 effort，可以据此确认参数是否真的固定住了。
+Kiro 的 `--model` / `--effort` 是「新建会话时」生效的初始值，当前 Kiro ACP 未提供会话级改模型的能力（`sessionCapabilities` 为空）。因此切换模型后，已有话题继续 resume 时仍会沿用该会话创建时的模型；需要立刻用新模型时，在单聊里通过菜单 `chat_new` 或群聊新话题开一个新会话。
 ### 部署角色与知识库节点
 部署前先按角色选择目标宿主机：
@@ -298,6 +323,8 @@ nikou-cli hook binding remove \
 关闭后，该 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 可以使用 `knowledge` 引擎直接连接 FastGPT 应用。此模式不会启动 Claude，也不会在 Worker 内重复连接知识库或代码 MCP；FastGPT 应用负责完成知识检索、内部工具调用和回答生成，Worker 只负责会话、流式事件与飞书卡片适配：
 ```json
@@ -341,11 +368,13 @@ 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：
 ```bash
-ai-hook claude --model opus
+ai-hook claude --model claude-opus-4-8
 ```
 配置默认写入：
@@ -374,7 +403,7 @@ ai-hook local
 Claude：
 ```bash
-ai-hook local claude --model sonnet
+ai-hook local claude --model claude-sonnet-4-6
 ```
 Gemini：
@@ -405,6 +434,19 @@ 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
 ```
@@ -418,6 +460,10 @@ nikou-cli hook master \
   --shared-secret CHANGE_ME
 ```
+怀疑存在未知旧主节点时，应在飞书后台轮换 App Secret，只把新 Secret 更新到授权主节点
+和确实需要调用飞书 API 的受控 Worker，再重启并核验；禁止分发到其他机器。启动密码不能
+替代 App Secret 轮换，因为它无法终止已经运行的旧版本进程。
 ### 主节点管理接口
 主节点可以额外开一个 HTTP 管理接口，供 CC Switch 的「妮蔻 · 主节点」模块远程
@@ -486,7 +532,7 @@ Kiro 原生（直接使用本机 Kiro CLI 与登录态，不经过 API 反代）
 nikou-cli hook worker kiro
 ```
-默认不固定模型，继承本机 Kiro 默认配置。也可以显式选择模型、Agent、思考强度和 Agent Engine：
+未传 `--model` / `--effort` 时才继承本机 Kiro 默认配置；由 CC Switch 或飞书菜单拉起时会显式固定。也可以自己指定模型、Agent、思考强度和 Agent Engine：
 ```bash
 nikou-cli hook worker kiro \
@@ -531,7 +577,7 @@ Claude 参数透传示例：
 ```bash
 nikou-cli hook worker claude \
-  --model sonnet \
+  --model claude-sonnet-4-6 \
   --permission-mode acceptEdits \
   --max-budget-usd 5
 ```
@@ -540,7 +586,7 @@ nikou-cli hook worker claude \
 ```bash
 ai-hook
-ai-hook claude --model sonnet
+ai-hook claude --model claude-sonnet-4-6
 ai-hook gemini
 ai-hook kiro
 ai-hook api --api kiro
@@ -558,10 +604,10 @@ ai-hook knowledge
 | `chat_new` | 标记下一条单聊消息强制创建新会话，不复用旧消息引用或最近会话 |
 | `switch_path` | 发送单聊目录切换卡片，可浏览、选择目录或切回默认目录 |
 | `stop_chat` | 终止当前宿主 Worker 正在执行的全部单聊和绑定群聊任务 |
-| `switch_codex` | 切换到 Codex 并重启当前宿主 Worker |
-| `switch_opus` | 切换到 Claude Opus 并重启当前宿主 Worker |
-| `switch_kiro_Opus5` | 切换到 Kiro 原生 `claude-opus-5` 并重启当前宿主 Worker |
-| `switch_kiro_auto` | 切换到 Kiro 原生 `auto` 并重启当前宿主 Worker |
+| `switch_codex` | 切换到 Codex `gpt-5.6-sol` + `medium` 并重启当前宿主 Worker |
+| `switch_opus` | 切换到 Claude `claude-opus-4-8` + `medium` 并重启当前宿主 Worker |
+| `switch_kiro_Opus5` | 切换到 Kiro 原生 `claude-opus-5` + `medium` 并重启当前宿主 Worker |
+| `switch_kiro_auto` | 切换到 Kiro 原生 `auto` + `medium` 并重启当前宿主 Worker |
 | `bind_chat` | 发送群聊名、目录简写和解绑操作组成的交互卡片 |
 `my_info` 已不再处理。`bind_chat` 卡片以主节点持久绑定表为准，并按页展示绑定，避免大量绑定超过飞书卡片元素上限；点击某行“解绑”后会持久撤销对应绑定并刷新当前页，旧 Worker 快照不能恢复已解绑记录。
@@ -573,7 +619,7 @@ ai-hook knowledge
 也可以通过 `--` 传递底层工具参数：
 ```bash
-nikou-cli hook worker claude -- --model sonnet
+nikou-cli hook worker claude -- --model claude-sonnet-4-6
 ```
 ### Kiro 原生与 API Kiro

package/dist/chunk-RZ3BMXAU.js ADDED Viewed

@@ -0,0 +1 @@