dsh-dock 0.9.9 → 0.10.0

package/README.md

@@ -19,7 +19,9 @@
 | **用量记录** | 记录全部 LLM API 调用：秒级时间筛选、Token/费用统计（峰谷计价 + 官网价目自动同步）、分组汇总、明细检索与 CSV 导出 |
 | **模型设置** | 编辑各 Provider 模型目录：输入类型（文本/图片 + 标注）与思考强度档位；图片能力可由你手动声明，新增 Provider 自动刷新加载，写回官方配置热生效 |
 | **模型余额** | 展示所有模型 Provider 账户余额（5 分钟自动刷新） |
-| **任务动画** | 19 种任务运行动画（含星际远征、星云潮汐、曲速航道、量子雷达、星座网络、深海脉动、神经电路等）与完成/需确认通知（通知音、浏览器系统通知、钉钉/飞书群机器人推送），动画速度随任务活动联动，两组开关独立，配置全部持久化 |
+| **任务动画** | 19 种任务运行动画（含星际远征、星云潮汐、曲速航道、量子雷达、星座网络、深海脉动、神经电路等），速度随任务活动联动，配置全部持久化 |
+| **任务通知** | 任务完成 / 异常 / 需确认通知：页内卡片、6 种提示音、浏览器系统通知、钉钉/飞书群机器人推送（宿主直发，浏览器关着也能推）；与动画互相独立、各自启停 |
+| **运行状态** | 任务运行状态一览：进行中任务的阶段 / 耗时 / 回合 / 步骤 / 工具 / Token、等待确认提醒（等待的工具与说明）与最近完成记录（只读，与动画/通知共用同一份宿主侧追踪） |
 
 | **图片理解代理** | 图片识别等（visionproxy）；原图候选默认折叠展示，图片能力以你的声明为准 |
 | **手机接力** | 手机扫码安全接入同一 DSH（反向代理 + 任务/备注同步）；**局域网电脑直连（0.0.0.0）**——另起一个 0.0.0.0 绑定的完整 DSH 子实例，局域网电脑访问到的功能、交互与 127.0.0.1 完全一致（会话记录、工作区文件夹选择等） |
@@ -112,23 +114,33 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 
 ![任务动画设置页：19 种氛围模式、新版双工位桌面伙伴与大小控制](screenshots/dock-animation.png)
 
-1. 打开功能坞 → 任务动画，两组开关完全独立、按需组合：
-   - **运行动画**：任务进行中才出现，8 种氛围模式任选（默认「流光细线」），**速度随任务吞吐自动加快**（Token 速率驱动）：
-     - 流光细线：顶部细线流光往返
-     - 呼吸光点：状态徽标圆点呼吸
-     - 轨道光环：细环绕圆点旋转
-     - 环屏巡航：一颗光点沿屏幕边缘巡航整圈
+1. 打开功能坞 → 任务动画（与「任务通知」「运行状态」互相独立，可只开其一）：
+   - **运行动画**：任务进行中才出现，19 种氛围模式任选（默认「流光细线」），**速度随任务吞吐自动加快**（Token 速率驱动）：
+     - 流光细线 / 呼吸光点 / 轨道光环 / 环屏巡航 / 代码雨 / 星野 / 极光：顶部流光、徽标呼吸、轨道光环、边缘巡航、字符缓落、星点闪烁、柔光带等克制动效
      - 桌面伙伴：**CSS 3D 立体**的具象人物坐在紧凑双工位前，任务活动越密集动作越快；**流级实时同步任务阶段**——模型思考时微抬头、单手托下巴，正文输出/写代码时低头键入右侧工位，查资料时转头扫视左侧屏幕；整卡可拖到屏幕任意位置（位置持久化），右下角手柄 / 面板滑块可缩放大小（85%~220%，自动保存）
-     - 代码雨：字符列沿屏幕缓落如数据流
-     - 星野：细碎星点飘移闪烁，带弯月与流星
-     - 极光：屏幕顶部柔光带缓慢呼吸流动
-   - **完成通知**：任务结束时右上角弹出通知卡片（标题 / 模型 / 耗时 / 回合步骤 / Token / 结果摘要 / 结束原因），可分别开关「完成 / 异常」通知、选择停留时长、开启浏览器系统通知（仅页面后台时推送）；**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常 / 确认各配一音，可单独试听）
-   - **需确认提醒**：工具等待用户批准（如沙箱越界执行命令）时弹常驻通知卡片 + 确认音（页面后台时同步系统通知），人不在屏幕前任务也不会干等；等待 / 卡住状态卡片只对当前正在看的会话出现，停靠屏幕右上不挡正文
+     - 星际远征 / 星云潮汐 / 曲速航道 / 量子雷达 / 星座网络 / 数据萤火 / 深海脉动 / 棱镜光谱 / 神经电路 / 引力涟漪 / 灵感天灯：从星系远征到电路脉冲的十一种氛围场景（星际远征完成时货运舰会归航停泊在输入框上方）
 2. 任务结束动效自动消失，完成瞬间一缕流光掠过；功能坞面板打开时环境动效自动隐藏避免重叠
+3. 任务运行状态（进行中 / 等待确认 / 最近完成）见左侧「运行状态」菜单，结束与需确认提醒见「任务通知」
+4. 配置（动画开关 / 动画模式 / 桌面伙伴大小）经宿主 settings 持久化，重启 dsh 后自动恢复
 
-3. **钉钉推送**（可选）：任务结束由宿主直发 markdown 消息到钉钉群机器人（浏览器关着也能推）——填入 Webhook 地址保存，「发送测试消息」验证连通；机器人安全设置选「自定义关键词」填「任务」或「dsh」；推送哪些事件跟随上方「完成 / 异常通知」开关
-4. **飞书推送**（可选）：与钉钉同款消息以卡片形式推送到飞书群机器人——填入 Webhook 地址（`https://open.feishu.cn/open-apis/bot/v2/hook/…`）保存，「发送测试消息」验证连通；可与钉钉同时开启
-5. 所有配置（动画开关 / 动画模式 / 桌面伙伴大小 / 通知各项 / 提示音 / 钉钉、飞书 Webhook）经宿主 settings 持久化，重启 dsh 后自动恢复
+**任务通知**（从「任务动画」拆出，独立菜单项与开关）
+
+1. 打开功能坞 → 任务通知：
+   - **通知事件**：完成通知 / 异常通知 / **需确认提醒**（工具等待你批准，如沙箱越界执行命令时弹常驻卡片 + 确认音）各自独立开关
+   - **提醒方式**：卡片停留时长（4 / 8 / 15 / 30 秒或常驻）、浏览器系统通知（仅页面后台时推送，首次开启会请求授权）、**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常 / 确认各配一音，可单独试听）
+   - **钉钉推送**（可选）：任务结束由宿主直发 markdown 消息到钉钉群机器人（浏览器关着也能推）——填入 Webhook 地址保存，「发送测试消息」验证连通；机器人安全设置选「自定义关键词」填「任务」或「dsh」
+   - **飞书推送**（可选）：与钉钉同款消息以卡片形式推送到飞书群机器人——填入 Webhook 地址（`https://open.feishu.cn/open-apis/bot/v2/hook/…`）保存，「发送测试消息」验证连通；可与钉钉同时开启
+2. 通知与动画**互不依赖**：停用「任务动画」后通知照常工作，反之亦然（动画 / 通知 / 运行状态共用同一份宿主侧任务追踪，只有一份开销）
+3. 群机器人推送的事件筛选跟随「完成 / 异常通知」开关；通知配置经宿主 settings 持久化，重启后恢复；升级会自动把旧版存在「任务动画」里的通知配置迁移过来
+
+**运行状态**（从「任务动画」拆出，独立菜单项与开关；只读）
+
+1. 打开功能坞 → 运行状态：
+   - **进行中任务**：任务标题 + 阶段标签（思考中 / 输出中 / 编写代码 / 查资料）、模型（Provider）、已运行时长、回合 / 步骤 / 工具次数、输入↧输出↥ Token
+   - **等待确认**：顶部横幅提示「N 项等待确认」，对应任务打「等待确认」标签并列出等待的工具与说明（工具等待你批准时任务会停在原地）
+   - **最近完成**：最多 10 条，含结束原因（完成 / 出错 / 已中止 / 受阻 / 达输出上限 / 中断）、耗时、Token 与结束时间
+2. 面板打开时自动刷新（有任务 2 秒、空闲 8 秒、出错 15 秒），也可手动「刷新」；本模块没有常驻浮层，关掉面板即零开销
+3. 本页只读、**不写任何配置**：数据来自宿主侧会话级任务追踪（与动画 / 通知共用一份）；动效在「任务动画」，结束 / 需确认提醒在「任务通知」
 
 **模型设置**
 
@@ -240,23 +252,33 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 
 ![任务动画设置页：19 种氛围模式、新版双工位桌面伙伴与大小控制](screenshots/dock-animation.png)
 
-1. 打开功能坞 → 任务动画，两组开关完全独立、按需组合：
-   - **运行动画**：任务进行中才出现，8 种氛围模式任选（默认「流光细线」），**速度随任务吞吐自动加快**（Token 速率驱动）：
-     - 流光细线：顶部细线流光往返
-     - 呼吸光点：状态徽标圆点呼吸
-     - 轨道光环：细环绕圆点旋转
-     - 环屏巡航：一颗光点沿屏幕边缘巡航整圈
+1. 打开功能坞 → 任务动画（与「任务通知」「运行状态」互相独立，可只开其一）：
+   - **运行动画**：任务进行中才出现，19 种氛围模式任选（默认「流光细线」），**速度随任务吞吐自动加快**（Token 速率驱动）：
+     - 流光细线 / 呼吸光点 / 轨道光环 / 环屏巡航 / 代码雨 / 星野 / 极光：顶部流光、徽标呼吸、轨道光环、边缘巡航、字符缓落、星点闪烁、柔光带等克制动效
      - 桌面伙伴：**CSS 3D 立体**的具象人物坐在紧凑双工位前，任务活动越密集动作越快；**流级实时同步任务阶段**——模型思考时微抬头、单手托下巴，正文输出/写代码时低头键入右侧工位，查资料时转头扫视左侧屏幕；整卡可拖到屏幕任意位置（位置持久化），右下角手柄 / 面板滑块可缩放大小（85%~220%，自动保存）
-     - 代码雨：字符列沿屏幕缓落如数据流
-     - 星野：细碎星点飘移闪烁，带弯月与流星
-     - 极光：屏幕顶部柔光带缓慢呼吸流动
-   - **完成通知**：任务结束时右上角弹出通知卡片（标题 / 模型 / 耗时 / 回合步骤 / Token / 结果摘要 / 结束原因），可分别开关「完成 / 异常」通知、选择停留时长、开启浏览器系统通知（仅页面后台时推送）；**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常 / 确认各配一音，可单独试听）
-   - **需确认提醒**：工具等待用户批准（如沙箱越界执行命令）时弹常驻通知卡片 + 确认音（页面后台时同步系统通知），人不在屏幕前任务也不会干等；等待 / 卡住状态卡片只对当前正在看的会话出现，停靠屏幕右上不挡正文
+     - 星际远征 / 星云潮汐 / 曲速航道 / 量子雷达 / 星座网络 / 数据萤火 / 深海脉动 / 棱镜光谱 / 神经电路 / 引力涟漪 / 灵感天灯：从星系远征到电路脉冲的十一种氛围场景（星际远征完成时货运舰会归航停泊在输入框上方）
 2. 任务结束动效自动消失，完成瞬间一缕流光掠过；功能坞面板打开时环境动效自动隐藏避免重叠
+3. 任务运行状态（进行中 / 等待确认 / 最近完成）见左侧「运行状态」菜单，结束与需确认提醒见「任务通知」
+4. 配置（动画开关 / 动画模式 / 桌面伙伴大小）经宿主 settings 持久化，重启 dsh 后自动恢复
+
+**任务通知**（从「任务动画」拆出，独立菜单项与开关）
 
-3. **钉钉推送**（可选）：任务结束由宿主直发 markdown 消息到钉钉群机器人（浏览器关着也能推）——填入 Webhook 地址保存，「发送测试消息」验证连通；机器人安全设置选「自定义关键词」填「任务」或「dsh」；推送哪些事件跟随上方「完成 / 异常通知」开关
-4. **飞书推送**（可选）：与钉钉同款消息以卡片形式推送到飞书群机器人——填入 Webhook 地址（`https://open.feishu.cn/open-apis/bot/v2/hook/…`）保存，「发送测试消息」验证连通；可与钉钉同时开启
-5. 所有配置（动画开关 / 动画模式 / 桌面伙伴大小 / 通知各项 / 提示音 / 钉钉、飞书 Webhook）经宿主 settings 持久化，重启 dsh 后自动恢复
+1. 打开功能坞 → 任务通知：
+   - **通知事件**：完成通知 / 异常通知 / **需确认提醒**（工具等待你批准，如沙箱越界执行命令时弹常驻卡片 + 确认音）各自独立开关
+   - **提醒方式**：卡片停留时长（4 / 8 / 15 / 30 秒或常驻）、浏览器系统通知（仅页面后台时推送，首次开启会请求授权）、**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常 / 确认各配一音，可单独试听）
+   - **钉钉推送**（可选）：任务结束由宿主直发 markdown 消息到钉钉群机器人（浏览器关着也能推）——填入 Webhook 地址保存，「发送测试消息」验证连通；机器人安全设置选「自定义关键词」填「任务」或「dsh」
+   - **飞书推送**（可选）：与钉钉同款消息以卡片形式推送到飞书群机器人——填入 Webhook 地址（`https://open.feishu.cn/open-apis/bot/v2/hook/…`）保存，「发送测试消息」验证连通；可与钉钉同时开启
+2. 通知与动画**互不依赖**：停用「任务动画」后通知照常工作，反之亦然（动画 / 通知 / 运行状态共用同一份宿主侧任务追踪，只有一份开销）
+3. 群机器人推送的事件筛选跟随「完成 / 异常通知」开关；通知配置经宿主 settings 持久化，重启后恢复；升级会自动把旧版存在「任务动画」里的通知配置迁移过来
+
+**运行状态**（从「任务动画」拆出，独立菜单项与开关；只读）
+
+1. 打开功能坞 → 运行状态：
+   - **进行中任务**：任务标题 + 阶段标签（思考中 / 输出中 / 编写代码 / 查资料）、模型（Provider）、已运行时长、回合 / 步骤 / 工具次数、输入↧输出↥ Token
+   - **等待确认**：顶部横幅提示「N 项等待确认」，对应任务打「等待确认」标签并列出等待的工具与说明（工具等待你批准时任务会停在原地）
+   - **最近完成**：最多 10 条，含结束原因（完成 / 出错 / 已中止 / 受阻 / 达输出上限 / 中断）、耗时、Token 与结束时间
+2. 面板打开时自动刷新（有任务 2 秒、空闲 8 秒、出错 15 秒），也可手动「刷新」；本模块没有常驻浮层，关掉面板即零开销
+3. 本页只读、**不写任何配置**：数据来自宿主侧会话级任务追踪（与动画 / 通知共用一份）；动效在「任务动画」，结束 / 需确认提醒在「任务通知」
 
 **模型设置**
 
@@ -283,14 +305,17 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 
 ### 常见问题
 
-- **插件会消耗 token 吗**：默认不会。用量记录/模型余额/任务动画/模型设置都是被动监听或本地查询，不调用 AI。唯一主动调 AI 的是「图片理解代理」（用视觉模型识图），它**默认关闭**，需你在模型设置里手动开启才生效；开启后每次识图按所选视觉模型计费。
+- **插件会消耗 token 吗**：默认不会。用量记录/模型余额/任务动画/任务通知/运行状态/模型设置都是被动监听或本地查询，不调用 AI。唯一主动调 AI 的是「图片理解代理」（用视觉模型识图），它**默认关闭**，需你在模型设置里手动开启才生效；开启后每次识图按所选视觉模型计费。
 - **功能开关刷新后重置**：v0.5.0 起功能开关已持久化（浏览器本地存储），刷新/重启后保持。
-- **任务动画/通知不生效**：动画路由与配置持久化在宿主进程内，旧宿主需重启 `dsh web` 加载（面板页会提示「宿主进程是旧版本」）。
+- **任务动画/任务通知/运行状态不生效**：三者的路由都在宿主进程内（动画/通知的配置持久化也在宿主），旧宿主需重启 `dsh web` 加载（面板页会提示「宿主进程是旧版本」）。另注意通知与运行状态已各自独立成菜单项，需在功能坞里分别开启「任务通知」「运行状态」。
 - **用量记录空白**：确认 dsh 是较新版本且插件宿主已加载（查看启动日志含 `[dsh-dock] host half loaded`）；旧宿主进程需重启 dsh web 加载新路由。
 - **余额显示「需登录 / 无密钥」**：对应 Provider 未在 dsh 凭据中配置可查询余额的密钥，属正常状态提示。
 
 ## 开发：新增一个功能模块
 
+> 开发流程、提交/推送约定与发版流程见 [`docs/workflow.md`](docs/workflow.md)（唯一真源）；
+> 配套 agent 预设为 `dsh-dock 插件开发`。改动历史见 [`docs/session-notes.md`](docs/session-notes.md)。
+
 每个功能是一个 `features/<id>/` 目录，由两部分组成：
 
 ```