nikou-cli 0.1.13 → 0.1.14

package/README.md

@@ -162,7 +162,33 @@ Hook 支持三种启动模式：
 
 主节点负责连接聊天平台、接收消息、维护 Worker 列表并分发任务。从节点负责连接主节点，收到任务后调用 Codex、Claude、Gemini 或 API Agent 执行。
 
-群聊发送 `@机器人 绑定: <目录>` 时，主节点会先检查当前用户是否已经绑定该目录；已有绑定会直接返回结果，未绑定则只把路径校验任务发给该用户自己的在线 Worker。一个群可以保留多个用户、多个目录的 Agent 绑定，绑定指令不会广播给其他 Worker 抢占。
+群聊发送 `@机器人 绑定: <目录>` 时，主节点会先检查当前用户是否已经绑定该目录；已有绑定会直接返回当前绑定状态卡片。当前用户已有其他目录时，会通过卡片确认“覆盖原绑定”或“新增绑定目录”；覆盖操作会在新目录校验成功后再撤销旧绑定。一个群可以保留多个用户、多个目录的 Agent 绑定，绑定指令不会广播给其他 Worker 抢占。
+
+绑定成功后会返回绿色状态卡片，展示本次绑定、当前群的全部普通目录绑定、完整路径、对应 Agent，以及知识库固定绑定（如有）。卡片底部同时给出省略盘符路径、完整路径和无路径选择三种解绑方式，便于确认当前真实绑定状态。
+
+群聊内任何成员都可以发送解绑指令。路径既支持完整路径，也支持省略盘符后的末两级路径；不带路径时会显示卡片供用户选择。Agent 选择卡片会展示省略盘符路径，并在底部提示解绑方式。
+
+```text
+@妮蔻 解绑 D:\project\hst\report
+@妮蔻 解绑 hst\report
+@妮蔻 解绑
+```
+
+省略路径同时命中多条绑定时不会直接删除，而是显示解绑选择卡片，避免误操作。解绑会持久记录撤销状态，Worker 重连不会恢复旧绑定。
+
+主节点管理员可查询或持久移除群聊 Agent。移除会记录撤销标记，Worker 重连时不会用本机旧快照恢复；该用户重新在群里发送绑定指令后，可正常解除撤销并重新绑定。
+
+```bash
+nikou-cli hook binding list --chat-name "研发协作群"
+nikou-cli hook binding list --chat-id oc_xxx
+
+nikou-cli hook binding remove \
+  --chat-name "研发协作群" \
+  --agent alice \
+  --yes
+```
+
+不传 `--dir` 时，会移除该 Agent 在群内的全部目录；如只需移除一条目录绑定，可追加 `--dir /srv/project-a`。群名匹配到多个 `chat_id` 时，命令会停止并要求改用 `--chat-id`，避免误删。
 
 群聊发送 `绑定知识库` 后，任务会定向到配置的知识库 Worker 和固定目录，执行结果卡片不展示宿主信息。知识库绑定只作用于群聊；单聊仍按发送人的飞书 `user_id` 选择其归属 Worker，同一用户多台 Worker 在线时优先使用最近接入的一台。
 
@@ -322,7 +348,7 @@ nikou-cli hook worker kiro \
   --agent-engine v2
 ```
 
-Kiro Worker 通过 ACP 管理会话并默认信任全部工具，支持正文、思考摘要、工具状态、图片和使用量流式更新。Kiro 不返回精确 input/cache/output Token，卡片改为展示当前实际模型、上下文占用、Credits、耗时和 effort；即使未传 `--model`，也会读取 ACP 会话返回的当前模型。思考内容仅在所选模型实际发送 `agent_thought_chunk` 时出现。
+Kiro Worker 通过 ACP 管理会话并默认信任全部工具，支持正文、思考摘要、工具状态、图片和使用量流式更新。飞书图片消息及富文本内嵌图片会在任务执行前下载到 Worker 临时目录，并作为图片内容传给 Kiro，执行结束后自动清理。Kiro 不返回精确 input/cache/output Token，卡片改为展示当前实际模型、上下文占用、Credits、耗时和 effort；即使未传 `--model`，也会读取 ACP 会话返回的当前模型。思考内容仅在所选模型实际发送 `agent_thought_chunk` 时出现。
 
 飞书流式卡片会完整保留各引擎输出的思考过程：不超过 5 行时直接展开，从第 6 行开始自动折叠，用户可点击“思考过程”面板查看全部内容。后续流式更新不会反复重置用户的展开状态。
 
@@ -373,6 +399,8 @@ nikou-cli hook worker claude -- --model sonnet
 
 Kiro 原生会按目录和飞书话题保存 session ID；Worker 重启或模型切换后会继续加载同一会话。Hook 不暴露 Kiro 终端中的 `/rewind`、`/compact`、会话列表和删除界面。
 
+群聊任务会按提问者的飞书职务名称加载角色提示词，当前支持开发、产品、测试和技术支持。角色提示词保存在 `~/ops/nikou-prompts/roles/`；未匹配职务时不注入角色约束。技术支持角色会优先核实线上日志、接口、数据和运行状态，再用业务可理解的语言说明是否存在问题，默认不展开源码位置。
+
 ### API 模式
 
 API 模式不依赖 Codex、Claude 或 Gemini CLI，直接调用模型反代，并在本地完成会话、MCP 和 Skills 工具循环。现支持：
@@ -524,6 +552,23 @@ nikou-cli hook log --follow
 nikou-cli hook usage-report --start 2026-07-13 --end 2026-07-19
 ```
 
+### Kiro 会话管理
+
+`nikou-cli` 会从 `KIRO_HOME/sessions/cli` 读取 Kiro 官方会话文件，并与妮蔻绑定、Worker 实时阶段和锁状态合并。只读输出不会包含隐藏思考、系统前置或工具敏感参数。
+
+```bash
+nikou-cli hook kiro-session list --format json
+nikou-cli hook kiro-session show <session-id> --format json
+nikou-cli hook kiro-session cancel <session-id> --yes
+nikou-cli hook kiro-session detach <session-id> --yes
+nikou-cli hook kiro-session delete <session-id> --yes
+```
+
+- `cancel` 只允许终止当前妮蔻 Worker 正在执行的 Kiro 会话。
+- `detach` 会清除该 session 的直接引用和所有话题引用；活动会话会拒绝解除。
+- `delete` 会拒绝活动或存在锁的会话，并通过 Kiro 官方删除命令执行。
+- Worker 控制面只监听权限为 `0600` 的本机 Unix Socket；`kiro-runtime.json` 同样为 `0600`，且不记录提示词、回答或飞书 ID。
+
 ## 开发
 
 ```bash