termdock 1.4.223 → 1.4.224

package/README.md

@@ -469,6 +469,36 @@ npm publish
 
 MIT
 
+### AI 关键进展提醒
+
+你只需对 Agent 说：**用 `td n` 提醒我，先运行 `td n` 看用法。**
+
+`td n` 不带参数时显示帮助和 Agent 使用提示，不会发送提醒；`td n --prompt`
+输出可直接复制的提示词。`td notify` 保留为完整名称，两者等价。
+
+AI 在 Termdock 会话内运行以下命令，即可把关键进展推送到已连接的 TD 页面：
+
+```bash
+td n "测试通过，可以开始验收" --title "关键进展"
+td notify "需要你确认数据库迁移方案"
+td notify "后台任务已完成" --session <来源会话的完整Session-ID>
+td notify --help
+```
+
+默认从当前终端或 tmux pane 识别来源 Session；脱离终端的后台进程可用
+`--session` 指定来源。提醒显示 Session 名称和正文，点击“查看 Session”返回来源，
+切换到其他服务工作区也可以看到。多条提醒排队，右上角紧凑卡片可整张点击返回；8 秒后自动收起，不会抢走终端焦点。
+鼠标悬停、键盘焦点停留或页面隐藏时暂停收起。
+左侧 Session 显示未读进展数量，折叠目录组也显示汇总数量；关闭弹出提醒不会清除未读，
+只有实际打开对应 Session 查看才会清除。当前可见 Session 收到提醒时不累积未读。
+
+可在 AI 的项目指令中加入：**完成关键里程碑、遇到阻塞或需要我决策时，调用
+`td notify "简短描述关键进展和需要我做的事"`；日常过程日志无需提醒。**
+
+这是页面内提醒，不需要系统通知权限。正文最多 4000 字符，标题最多 120 字符。
+CLI 输出 JSON；退出码 0 表示已向在线连接转发，不代表用户已阅读。没有在线页面时
+返回 `NO_CONNECTED_CLIENT` 和非零退出码。提醒不在服务端离线存储，刷新页面会清空。
+
 ### 协作 CLI 的来源身份
 
 后台工具进程无需位于 tmux pane 内，也可以显式指定自己的协作身份：