nikou-cli 0.1.27 → 0.1.28

package/README.md

@@ -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
@@ -345,7 +372,7 @@ nikou-cli hook init \
 `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 +401,7 @@ ai-hook local
 Claude：
 
 ```bash
-ai-hook local claude --model sonnet
+ai-hook local claude --model claude-sonnet-4-6
 ```
 
 Gemini：
@@ -486,7 +513,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 +558,7 @@ Claude 参数透传示例：
 
 ```bash
 nikou-cli hook worker claude \
-  --model sonnet \
+  --model claude-sonnet-4-6 \
   --permission-mode acceptEdits \
   --max-budget-usd 5
 ```
@@ -540,7 +567,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 +585,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 +600,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