nikou-cli 0.1.51 → 0.1.54

package/README.md

@@ -212,6 +212,32 @@ nikou-job archive <job-id> --yes
 
 配置文件默认为 `~/.nikou-block/jobs/config.json`，同时兼容 snake_case 与 camelCase。可配置端口、最大并发、错过调度阈值、保留周期、看板链接和失败通知；密钥只允许来自本机环境或外部工具配置，禁止写入 Job bundle。
 
+Job 定义支持可选的 `notify` 字段，控制妮蔻 Job 自带的运行通知：`true` 或省略时通知运行中、成功、跳过和失败等状态；写入 `false` 时关闭 Job daemon 与 CC Switch 的通用桌面通知，也关闭 Job daemon 的 AI 失败告警。旧 Job 未写该字段时按 `true` 兼容处理。Job 脚本自己发送的业务消息不受影响，例如 UAT ERROR 脚本仍只在查到 ERROR 时发送告警卡片。
+
+```json
+{
+  "id": "uat-error-log-alert",
+  "notify": false
+}
+```
+
+### 步骤主动跳过（退出码 78）
+
+pipeline 步骤默认只有「成功则继续」「失败则中断」两种结果。当某一步在运行时发现前置条件不成立（例如当天没有需要处理的数据），可以用退出码 `78` 声明「本次无需继续」：
+
+```bash
+echo "今日无待处理数据，跳过本次执行"
+exit 78
+```
+
+runner 收到后会立刻结束本次 pipeline，剩余步骤不再启动，整次 run 状态落 `skipped`：
+
+- 不计入失败统计，也不会触发失败通知。
+- 通知与 Job 页显示「已跳过」，`run.summary` 取该步骤最后一行 stdout，即上面的跳过原因。
+- 该步骤自身在 `run.metadata.steps` 中记为 `status=skipped`、`exitCode=78`。
+
+只有 `type=script` 的步骤支持这个约定。`type=ai` 步骤的退出码由模型与上游服务决定，返回 `78` 仍按失败处理。
+
 从旧版 `nikou-screen` 迁移时先停止旧 mac-agent，再执行 dry-run。命令只有追加 `--yes` 才会复制数据：
 
 ```bash
@@ -513,6 +539,8 @@ nikou-cli hook admin-key --show   # 打印完整密钥，注意不要外发
 | GET | `/admin/status` | 运行态：PID、启动时间、在线 Worker 摘要（含内网 IP、nikou-cli 版本、视角标签）、群聊绑定数、白名单人数 |
 | GET | `/admin/log?page=1&pageSize=200&keyword=` | 主节点日志分页，`page=1` 为最新一页 |
 | GET | `/admin/stats?days=7` | 按天任务统计，读本机 `usage-events.sqlite` |
+| GET | `/admin/bind-whitelist` | 查询主节点当前绑定白名单 |
+| POST | `/admin/bind-whitelist` | 按姓名、工号或 `user_id` 加入/移出绑定白名单 |
 | POST | `/admin/restart` | 主节点自行退出，由 systemd `Restart=always` 拉起 |
 | POST | `/admin/workers/:workerId/remote-support` | 指定 Worker 执行一次远程 AI 支持会话 |
 | GET | `/admin/remote-support/threads?workerId=&page=1&pageSize=50` | 分页查看远程支持历史会话 |
@@ -661,7 +689,7 @@ ai-hook api --api kiro
 
 `switch_path` 以 Worker 本机 `~/ops/ops_global.properties` 的 `code_path` 作为默认目录，但不限制浏览根目录。用户可以通过“上一级”一直导航到文件系统根目录，并选择 Worker 账号有权限访问的任意文件夹；可访问的目录软链接也允许进入。选择结果按飞书用户持久保存；卡片会同时展示当前目录、默认目录和正在浏览的目录，并支持上一级、进入子目录、分页、切换到当前浏览目录和切回默认。目录发生切换后会开启新的单聊会话，切换前的最近会话和旧消息引用都不会继续复用。点击“进入”、翻页、切换或切回默认时，卡片会在同一条消息上直接刷新；若从节点返回较慢，主节点会在结果到达后异步刷新这条卡片，卡片按钮始终保持可点击。
 
-`switch_session` 和 `recent_sessions` 查询当前 Worker 通过妮蔻产生的单聊会话，以及当前运行模型由本机 CLI 发起的 Kiro 会话；按当前引擎和模型过滤，并限定为当天且最近 24 小时内更新的会话；每页最多展示 8 条。卡片表格展示会话标题、来源、目录、模型和更新时间，会话标题优先使用最近一次真实用户问题，没有标题的历史会话使用会话 ID 简称。点击当前目录卡片中的会话只切换会话；点击跨目录卡片中的会话会同时切换目录和会话。选择本地 CLI 会话后，下一条单聊消息会由当前 Worker 加载该 Kiro session 继续执行；本地 CLI 会话正文仍保存在 Kiro 本地会话目录，Worker 只保存当前用户的外部会话引用。两种卡片都会在原消息上更新，超时或更新失败时按现有异步刷新和重新发送机制处理；重复点击“当前会话”保持幂等。
+`switch_session` 和 `recent_sessions` 查询当前 Worker 通过妮蔻产生的单聊会话，以及当前运行模型由本机 CLI 发起的 Kiro 会话；按当前引擎过滤，不限制会话更新时间，统一按更新时间倒序只展示最新 8 条。模型只用于卡片展示，不参与会话筛选。卡片表格展示会话标题、来源、目录、模型和更新时间，会话标题优先使用最近一次真实用户问题，没有标题的历史会话使用会话 ID 简称。点击当前目录卡片中的会话只切换会话；点击跨目录卡片中的会话会同时切换目录和会话。选择本地 CLI 会话后，下一条单聊消息会由当前 Worker 加载该 Kiro session 继续执行；本地 CLI 会话正文仍保存在 Kiro 本地会话目录，Worker 只保存当前用户的外部会话引用。两种卡片都会在原消息上更新，超时或更新失败时按现有异步刷新和重新发送机制处理；重复点击“当前会话”保持幂等。
 
 卡片还支持目录收藏，每个飞书用户最多收藏 5 个目录：点击“收藏此目录”把正在浏览的目录加入收藏，收藏满 5 个后该按钮置灰，需要先在对应目录点击“取消收藏”。收藏区固定在卡片顶部，按钮只展示目录的最后一级名称（超长会截断），点击即直接切换到该目录，当前正在使用的收藏会高亮。收藏按飞书用户持久保存在主机状态文件中，只是快捷入口，不会额外提升会话代次；收藏目录被删除或变为不可访问时，下次打开卡片会自动清理。
 
@@ -845,12 +873,16 @@ nikou-cli hook usage-report --start 2026-07-13 --end 2026-07-19
 
 ```bash
 nikou-cli hook kiro-session list --format json
+nikou-cli hook kiro-session list --limit 120 --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
 ```
 
+- `list` 输出里 `count` 是磁盘上的会话总数，`returned` 是本次返回条数，`statusCounts` 和 `nikouCount` 始终按全量统计。
+- `--limit <n>` 只按最后事件时间倒序裁剪返回的列表长度，不影响上面这些统计字段：看板类调用方只展示最近若干条，但计数必须准。
+- `list` 不会整解事件日志：末条事件类型只读行首，标题从尾部按行反查到第一条可见提问，群聊来源先用字节查找妮蔻提问前缀标记再解析命中那一行。会话数上千、单个日志上百 MB 时这一点决定了命令是秒级还是十秒级。
 - `cancel` 只允许终止当前妮蔻 Worker 正在执行的 Kiro 会话。
 - `detach` 会清除该 session 的直接引用和所有话题引用；活动会话会拒绝解除。
 - `delete` 会拒绝活动或存在锁的会话，并通过 Kiro 官方删除命令执行。