dsh-dock 0.9.9 → 0.10.1

package/README.md

@@ -19,10 +19,13 @@
 | **用量记录** | 记录全部 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 完全一致（会话记录、工作区文件夹选择等） |
+| **远程访问** | 账号密码登录的远程入口：网关监听 `0.0.0.0` 独立端口，手机/平板/局域网电脑访问同一实例，会话与任务进度实时一致（**局域网电脑直连**：另起一个 0.0.0.0 绑定的完整 DSH 子实例，功能与 127.0.0.1 完全一致） |
 | **心跳监视 / 主题信息** | 示例功能（纯 Client） |
 
 **会话区随身小控件**：启用后，在会话输入区工具行（模型选择器左侧）显示——
@@ -85,6 +88,8 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 
 停用某功能后，其菜单项、首页卡片、会话区小控件一并隐藏。
 
+![设置 → 功能坞：每个模块一张卡片，卡片开关与面板页脚开关等效](screenshots/dock-settings.png)
+
 ### 会话区随身小控件
 
 启用「模型余额」「用量记录」后，会话输入区工具行（模型选择器左侧）会出现两个小芯片：
@@ -97,6 +102,9 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 ### 各功能使用
 
 **用量记录**
+
+![用量记录页：秒级时间筛选、9 张 KPI 卡、分组汇总与 15 列明细（支持 CSV 导出）](screenshots/dock-tokenlog.png)
+
 1. 打开功能坞 → 用量记录
 2. 使用顶部筛选：时间范围（秒级）、会话、提供商、模型（与提供商联动）、状态、推理强度
 3. 查看 9 张 KPI 卡（调用次数 / Token / 输入 / 缓存命中 / 命中率 / 输出 / 金额 USD / 金额 CNY / 累计耗时）
@@ -105,6 +113,9 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 6. 「CSV 导出」下载当前筛选结果
 
 **模型余额**
+
+![模型余额：全部已配置 Provider 的余额/配额一屏查看（可查余额的排前面）](screenshots/dock-balance.png)
+
 1. 打开功能坞 → 模型余额
 2. 列表展示全部已配置 Provider 的余额/配额状态（每 5 分钟自动刷新，可手动「刷新」）
 
@@ -112,23 +123,37 @@ 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 后自动恢复
+
+**任务通知**（从「任务动画」拆出，独立菜单项与开关）
+
+![任务通知：通知事件 / 提醒方式 / 提示音试听 / 钉钉与飞书群机器人推送（Webhook 已脱敏）](screenshots/dock-notify.png)
 
-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 持久化，重启后恢复；升级会自动把旧版存在「任务动画」里的通知配置迁移过来
+
+**运行状态**（从「任务动画」拆出，独立菜单项与开关；只读）
+
+![运行状态：进行中任务的阶段/耗时/回合/步骤/工具/Token、等待确认与最近完成（只读）](screenshots/dock-runstate.png)
+
+1. 打开功能坞 → 运行状态：
+   - **进行中任务**：任务标题 + 阶段标签（思考中 / 输出中 / 编写代码 / 查资料）、模型（Provider）、已运行时长、回合 / 步骤 / 工具次数、输入↧输出↥ Token
+   - **等待确认**：顶部横幅提示「N 项等待确认」，对应任务打「等待确认」标签并列出等待的工具与说明（工具等待你批准时任务会停在原地）
+   - **最近完成**：最多 10 条，含结束原因（完成 / 出错 / 已中止 / 受阻 / 达输出上限 / 中断）、耗时、Token 与结束时间
+2. 面板打开时自动刷新（有任务 2 秒、空闲 8 秒、出错 15 秒），也可手动「刷新」；本模块没有常驻浮层，关掉面板即零开销
+3. 本页只读、**不写任何配置**：数据来自宿主侧会话级任务追踪（与动画 / 通知共用一份）；动效在「任务动画」，结束 / 需确认提醒在「任务通知」
 
 **模型设置**
 
@@ -142,7 +167,7 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 **图片理解代理（visionproxy）**
 - 用于图片内容识别等场景。原图直发候选默认折叠，模型设置中勾选「图片」输入类型的模型即可走该通道；请按实际 Provider 能力选择，端点不支持时取消该标记即可恢复代理识别。
 
-**手机接力**
+**远程访问**
 
 主 DSH 默认只监听 `127.0.0.1`（官方 CLI 拒绝 `--host 0.0.0.0`，因为浏览器表层没有登录认证）。「远程访问」在**不改主实例绑定**的前提下提供带登录的远程入口：
 
@@ -151,6 +176,14 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 3. **异地组网**：Tailscale/ZeroTier 等虚拟组网内直接用组网 IP 访问同一入口，效果与局域网相同。
 4. **安全机制**：密码只存加盐哈希；登录失败按来源 IP 限速（10 分钟 10 次）；修改密码后所有设备立即下线；关闭远程访问即停止网关并注销所有会话。工作区目录选择自动为浏览器浏览模式（可跨盘输入路径）；远程页面的兼容兜底（`crypto.randomUUID`）由网关注入。
 
+**趣味游戏**
+
+![趣味游戏：十款小游戏在浮动窗口里运行（棋盘对战 / 经典机台 / 街机动作），不占满屏、不遮挡会话](screenshots/dock-games.png)
+
+- 任务在后台继续执行时，游戏在局部浮动窗口里运行（可拖动、可调大小、可最大化/最小化、不遮挡会话内容）。
+- 屏幕侧边的「趣味游戏」磁吸入口贴在左边栏右缘（不挡工作区目录），可换上下部位、左右换边，位置会被记住。
+- 十款小游戏：五子棋、中国象棋（你 vs AI）、俄罗斯方块、推箱子、贪吃蛇、打砖块、极速赛车、坦克大战、星际躲避、反应堆解谜；都支持键盘（配套的也配了按钮）操作。
+
 **心跳监视 / 主题信息** | 示例功能（纯 Client） |
 
 **会话区随身小控件**：启用后，在会话输入区工具行（模型选择器左侧）显示——
@@ -213,6 +246,8 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 
 停用某功能后，其菜单项、首页卡片、会话区小控件一并隐藏。
 
+![设置 → 功能坞：每个模块一张卡片，卡片开关与面板页脚开关等效](screenshots/dock-settings.png)
+
 ### 会话区随身小控件
 
 启用「模型余额」「用量记录」后，会话输入区工具行（模型选择器左侧）会出现两个小芯片：
@@ -225,6 +260,9 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 ### 各功能使用
 
 **用量记录**
+
+![用量记录页：秒级时间筛选、9 张 KPI 卡、分组汇总与 15 列明细（支持 CSV 导出）](screenshots/dock-tokenlog.png)
+
 1. 打开功能坞 → 用量记录
 2. 使用顶部筛选：时间范围（秒级）、会话、提供商、模型（与提供商联动）、状态、推理强度
 3. 查看 9 张 KPI 卡（调用次数 / Token / 输入 / 缓存命中 / 命中率 / 输出 / 金额 USD / 金额 CNY / 累计耗时）
@@ -233,6 +271,9 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 6. 「CSV 导出」下载当前筛选结果
 
 **模型余额**
+
+![模型余额：全部已配置 Provider 的余额/配额一屏查看（可查余额的排前面）](screenshots/dock-balance.png)
+
 1. 打开功能坞 → 模型余额
 2. 列表展示全部已配置 Provider 的余额/配额状态（每 5 分钟自动刷新，可手动「刷新」）
 
@@ -240,23 +281,37 @@ 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 后自动恢复
+
+**任务通知**（从「任务动画」拆出，独立菜单项与开关）
+
+![任务通知：通知事件 / 提醒方式 / 提示音试听 / 钉钉与飞书群机器人推送（Webhook 已脱敏）](screenshots/dock-notify.png)
+
+1. 打开功能坞 → 任务通知：
+   - **通知事件**：完成通知 / 异常通知 / **需确认提醒**（工具等待你批准，如沙箱越界执行命令时弹常驻卡片 + 确认音）各自独立开关
+   - **提醒方式**：卡片停留时长（4 / 8 / 15 / 30 秒或常驻）、浏览器系统通知（仅页面后台时推送，首次开启会请求授权）、**提示音** 6 种 WebAudio 合成音效可选（完成 / 异常 / 确认各配一音，可单独试听）
+   - **钉钉推送**（可选）：任务结束由宿主直发 markdown 消息到钉钉群机器人（浏览器关着也能推）——填入 Webhook 地址保存，「发送测试消息」验证连通；机器人安全设置选「自定义关键词」填「任务」或「dsh」
+   - **飞书推送**（可选）：与钉钉同款消息以卡片形式推送到飞书群机器人——填入 Webhook 地址（`https://open.feishu.cn/open-apis/bot/v2/hook/…`）保存，「发送测试消息」验证连通；可与钉钉同时开启
+2. 通知与动画**互不依赖**：停用「任务动画」后通知照常工作，反之亦然（动画 / 通知 / 运行状态共用同一份宿主侧任务追踪，只有一份开销）
+3. 群机器人推送的事件筛选跟随「完成 / 异常通知」开关；通知配置经宿主 settings 持久化，重启后恢复；升级会自动把旧版存在「任务动画」里的通知配置迁移过来
 
-3. **钉钉推送**（可选）：任务结束由宿主直发 markdown 消息到钉钉群机器人（浏览器关着也能推）——填入 Webhook 地址保存，「发送测试消息」验证连通；机器人安全设置选「自定义关键词」填「任务」或「dsh」；推送哪些事件跟随上方「完成 / 异常通知」开关
-4. **飞书推送**（可选）：与钉钉同款消息以卡片形式推送到飞书群机器人——填入 Webhook 地址（`https://open.feishu.cn/open-apis/bot/v2/hook/…`）保存，「发送测试消息」验证连通；可与钉钉同时开启
-5. 所有配置（动画开关 / 动画模式 / 桌面伙伴大小 / 通知各项 / 提示音 / 钉钉、飞书 Webhook）经宿主 settings 持久化，重启 dsh 后自动恢复
+**运行状态**（从「任务动画」拆出，独立菜单项与开关；只读）
+
+![运行状态：进行中任务的阶段/耗时/回合/步骤/工具/Token、等待确认与最近完成（只读）](screenshots/dock-runstate.png)
+
+1. 打开功能坞 → 运行状态：
+   - **进行中任务**：任务标题 + 阶段标签（思考中 / 输出中 / 编写代码 / 查资料）、模型（Provider）、已运行时长、回合 / 步骤 / 工具次数、输入↧输出↥ Token
+   - **等待确认**：顶部横幅提示「N 项等待确认」，对应任务打「等待确认」标签并列出等待的工具与说明（工具等待你批准时任务会停在原地）
+   - **最近完成**：最多 10 条，含结束原因（完成 / 出错 / 已中止 / 受阻 / 达输出上限 / 中断）、耗时、Token 与结束时间
+2. 面板打开时自动刷新（有任务 2 秒、空闲 8 秒、出错 15 秒），也可手动「刷新」；本模块没有常驻浮层，关掉面板即零开销
+3. 本页只读、**不写任何配置**：数据来自宿主侧会话级任务追踪（与动画 / 通知共用一份）；动效在「任务动画」，结束 / 需确认提醒在「任务通知」
 
 **模型设置**
 
@@ -270,7 +325,7 @@ dsh plugin --profile web remove dsh-dock  # 卸载
 **图片理解代理（visionproxy）**
 - 用于图片内容识别等场景。原图直发候选默认折叠，模型设置中勾选「图片」输入类型的模型即可走该通道；请按实际 Provider 能力选择，端点不支持时取消该标记即可恢复代理识别。
 
-**手机接力**
+**远程访问**
 
 主 DSH 默认只监听 `127.0.0.1`（官方 CLI 拒绝 `--host 0.0.0.0`，因为浏览器表层没有登录认证）。「远程访问」提供**账号密码登录的网关**作为唯一远程入口，主实例保持仅本机：
 
@@ -278,19 +333,30 @@ dsh plugin --profile web remove dsh-dock  # 卸载
    - 密码只存加盐哈希；登录失败按来源 IP 限速（10 分钟 10 次）；修改密码后所有设备立即下线；关闭远程访问即停止网关并注销所有会话。
    - 旧版「服务器模式（0.0.0.0）」与「扫码令牌接力」已被此方案取代：前者把无认证的 DSH 裸露给局域网，后者双实例任务状态不同步。开启远程访问时会自动清理旧的 0.0.0.0 webserver 补丁行（提示重启后回到仅本机）。
 
+**趣味游戏**
+
+![趣味游戏：十款小游戏在浮动窗口里运行（棋盘对战 / 经典机台 / 街机动作），不占满屏、不遮挡会话](screenshots/dock-games.png)
+
+- 任务在后台继续执行时，游戏在局部浮动窗口里运行（可拖动、可调大小、可最大化/最小化、不遮挡会话内容）。
+- 屏幕侧边的「趣味游戏」磁吸入口贴在左边栏右缘（不挡工作区目录），可换上下部位、左右换边，位置会被记住。
+- 十款小游戏：五子棋、中国象棋（你 vs AI）、俄罗斯方块、推箱子、贪吃蛇、打砖块、极速赛车、坦克大战、星际躲避、反应堆解谜；都支持键盘（配套的也配了按钮）操作。
+
 **心跳监视 / 主题信息**
 - 示例功能，展示纯 Client 功能模块的写法
 
 ### 常见问题
 
-- **插件会消耗 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>/` 目录，由两部分组成：
 
 ```