dsh-dock 0.18.0 → 0.19.0

package/README.md

@@ -21,7 +21,7 @@
 | **模型提供商** | 管理自定义模型 Provider 本身：新增 / 编辑 / 删除（OpenAI 兼容、Anthropic Messages 等）、API Key 写入本机凭据库、拉取上游 `{baseURL}/models` 列表；排版同官方模型管理页。**独立功能，可单独停用**——停用后写配置与出站拉取的路由一并关闭 |
 | **模型余额** | 展示所有模型 Provider 账户余额（5 分钟自动刷新）；内置「DeepSeek 账号」官网余额（走宿主登录态，充值/赠送分列，不是 API Key 余额接口） |
 | **任务动画** | 19 种任务运行动画（含星际远征、星云潮汐、曲速航道、量子雷达、星座网络、深海脉动、神经电路等），速度随任务活动联动，配置全部持久化 |
-| **任务通知** | 任务完成 / 异常 / 需确认通知：页内卡片、6 种提示音、浏览器系统通知、语音播报（完成/停止/需授权/卡住 × 简洁/详细 × 音色可选）、钉钉/飞书群机器人推送（宿主直发，浏览器关着也能推）；与动画互相独立、各自启停 |
+| **任务通知** | 任务完成 / 异常 / 需确认 / 卡住通知：页内卡片（总开关 + 完成/异常/需确认/卡住各自独立开关 + 卡片口径简洁/适中/详细三挡；卡住卡写明主/子任务、停滞时长与最后动作，恢复自动收、主任务在等子任务时不误报）、6 种提示音、浏览器系统通知、语音播报（完成/停止/需授权/卡住 × 简洁/适中/详细三挡 × 音色可选）、钉钉/飞书群机器人推送（宿主直发，浏览器关着也能推）；与动画互相独立、各自启停 |
 | **运行状态** | 任务运行状态一览：进行中任务的阶段 / 耗时 / 回合 / 步骤 / 工具 / Token、等待确认提醒（等待的工具与说明）与最近完成记录（只读，与动画/通知共用同一份宿主侧追踪） |
 | **语音朗读** | 把会话回复读出来（浏览器 Web Speech API 语音合成，不消耗 token、不经过服务器）：每条已完成回复下方一个 🔊 喇叭——点一下读这条、播放中再点暂停、继续就地续读（不重头），另有重新朗读/停止；也可开「自动朗读」，任务结束时直接读最后一条回复。音色/语速/音调/音量可调，Markdown 自动清洗（代码块、表格、思考过程不念），支持「只读前 N 句 / 字数上限」 |
 
@@ -190,11 +190,11 @@ dsh plugin --profile web add dsh-dock     # 换回 npm 版
 ![任务通知：通知事件 / 提醒方式 / 提示音试听 / 钉钉与飞书群机器人推送（Webhook 已脱敏）](screenshots/dock-notify.png)
 
 1. 打开功能坞 → 任务通知：
-   - **通知事件**：完成通知 / 异常通知 / **需确认提醒**（工具等待你批准，如沙箱越界执行命令时弹卡片 + 确认音；审批处理完卡片自动收起，没处理完就一直显示，点卡片直达该会话）各自独立开关
-   - **提醒方式**：结束卡片（完成/异常）**常驻到「看过」**——没有任何超时自毁，后台跑完的任务切回来一定还在；**点卡片直达对应会话**（跳转成功即收起），点进那个会话看结果也会自动收起，手动 ✕ 照旧；跳转与「看过」判定都按**会话 id** 走（优先宿主官方 `uiWorkspace.openSession`，回退侧栏行的 `data-row-key`），窄窗口/宽侧栏下同样可靠。卡片 ≥3 张自动**叠放**成标题条，鼠标移上去整体展开。浏览器系统通知（仅页面后台时推送，首次开启会请求授权）、**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常 / 确认各配一音，可单独试听）
+   - **通知事件**：**页内卡片**总开关（关闭后右侧所有类型的通知卡片一律不弹，已挂着的一并收起；语音播报、提示音、系统通知、群推送各自独立、不受影响）+ 完成通知 / 异常通知 / **需确认提醒**（工具等待你批准，如沙箱越界执行命令时弹卡片 + 确认音；审批处理完卡片自动收起，没处理完就一直显示，点卡片直达该会话）/ **卡住提醒**（编程阶段 18 秒没有动静时弹卡，写明是**主任务还是子任务**、停滞了多久、最后在执行什么；恢复活动或任务结束自动收起，同一停点只弹一次；主任务有子任务在跑时不算卡住，交由子任务自己判定）——四类各自独立开关
+   - **提醒方式**：**卡片口径**三挡（**简洁 / 适中 / 详细**，`cardMode`，默认详细＝原有内容）决定右侧卡片正文写多少——简洁＝任务与耗时、谁卡住；适中＝加模型、起止时间、停滞时长；详细＝全部（回合步骤、Token、摘要或错误、最后动作），与各类型开关、语音播报互不影响。结束卡片（完成/异常）**常驻到「看过」**——没有任何超时自毁，后台跑完的任务切回来一定还在；**点卡片直达对应会话**（跳转成功即收起），点进那个会话看结果也会自动收起，手动 ✕ 照旧；跳转与「看过」判定都按**会话 id** 走（优先宿主官方 `uiWorkspace.openSession`，回退侧栏行的 `data-row-key`），窄窗口/宽侧栏下同样可靠。卡片 ≥3 张自动**叠放**成标题条，鼠标移上去整体展开。浏览器系统通知（仅页面后台时推送，首次开启会请求授权）、**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常 / 确认各配一音，可单独试听）
    - **钉钉推送**（可选）：任务结束由宿主直发 markdown 消息到钉钉群机器人（浏览器关着也能推）——填入 Webhook 地址保存，「发送测试消息」验证连通；机器人安全设置选「自定义关键词」填「任务」或「dsh」
    - **飞书推送**（可选）：与钉钉同款消息以卡片形式推送到飞书群机器人——填入 Webhook 地址（`https://open.feishu.cn/open-apis/bot/v2/hook/…`）保存，「发送测试消息」验证连通；可与钉钉同时开启
-   - **语音播报**（可选，默认关）：任务**完成 / 停止 / 需要授权 / 卡住**时用浏览器语音（Web Speech API）说一句话——四个时刻各自独立开关；**简洁**口径一句「任务完成」，**详细**口径带任务标题、耗时、回合统计与原因；可调语速/音量/音色/语言并试听（音色下拉与【语音朗读】同款：读本机音色表、中文在前分组，换设备选中的音色不存在时自动按语言回落）。与【语音朗读】共用本机声音但两套开关互不依赖；播报是打断式的（正在朗读正文时任务信先来）；「卡住」= 编程阶段 18 秒没有任何动静时报一次（恢复后再卡可再报；等批准的会话不算卡住，由「需要授权」负责）
+   - **语音播报**（可选，默认关）：任务**完成 / 停止 / 需要授权 / 卡住**时用浏览器语音（Web Speech API）说一句话——四个时刻各自独立开关，口径**三挡**（**简洁 / 适中 / 详细**）：**简洁**＝一句话（「任务完成」；卡住则报「主任务（或子任务）·标题 卡住了」，一听就知道卡在哪），**适中**＝点名任务（结束带原因与耗时、需授权带要批准的场景、卡住带停滞时长），**详细**＝全量（结束带回合统计与回复摘要、需授权带工具名、卡住带最后动作）；可调语速/音量/音色/语言并试听（音色下拉与【语音朗读】同款：读本机音色表、中文在前分组，换设备选中的音色不存在时自动按语言回落）。与【语音朗读】共用本机声音但两套开关互不依赖；播报是打断式的（正在朗读正文时任务信先来）；「卡住」= 编程阶段 18 秒没有任何动静时报一次，**主任务与子任务会话分别判定、分别播报**（会话头 `origin`/`delegationDepth` 判归属；恢复后再卡可再报；等批准的会话不算卡住，由「需要授权」负责；主任务有子任务在跑时不算卡住，交给子任务判定）
 2. 通知与动画**互不依赖**：停用「任务动画」后通知照常工作，反之亦然（动画 / 通知 / 运行状态共用同一份宿主侧任务追踪，只有一份开销）
 3. 群机器人推送的事件筛选跟随「完成 / 异常通知」开关；通知配置经宿主 settings 持久化，重启后恢复；升级会自动把旧版存在「任务动画」里的通知配置迁移过来