dsh-awesome-hud 0.18.6 → 0.19.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -4,6 +4,7 @@
4
4
  [![English](https://img.shields.io/badge/English-blue?style=for-the-badge)](README_en.md)
5
5
 
6
6
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](LICENSE)
7
+ [![npm](https://img.shields.io/npm/v/dsh-awesome-hud?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/dsh-awesome-hud)
7
8
 
8
9
  <p align="center">
9
10
  <img src="icon.png" width="96" height="96" alt="dsh-awesome-hud 图标">
@@ -32,7 +33,7 @@ HUD在dsh中的效果(深色主题)
32
33
  - [🖼️ 界面截图](#️-界面截图)
33
34
  - [⚙️ 兼容性](#️-兼容性)
34
35
  - [🔧 技术栈](#-技术栈)
35
- - [⬆️ 升级说明(v0.11.x → v0.18.6)](#️-升级说明v011x--v0186)
36
+ - [⬆️ 升级说明(v0.11.x → v0.19.1)](#️-升级说明v011x--v0191)
36
37
  - [📄 许可证](#-许可证)
37
38
 
38
39
  ---
@@ -45,11 +46,12 @@ HUD在dsh中的效果(深色主题)
45
46
  | 上下文 | 上下文占用进度条(默认单色:0–40% 绿 / 40–90% 黄 / >90% 红;悬浮时切换为分段样式并显示 breakdown 提示:System prompt / Tool definitions / Messages,分别使用石青/紫/蓝);标题右侧展示「当前占用 / 最大上下文(占用率)」(如 `199K / 1M(19.9%)`),底部两行分别展示会话统计(轮/步 · tok/s)与 Token 用量(总量 · 缓存命中),悬浮两行显示完整统计/用量提示;一键「压缩」当前会话上下文;进度条常显分段、两行信息的显隐可在 HUD 设置中调整 |
46
47
  | 用量 | DeepSeek 余额、OpenCode Go 三个窗口用量百分比(oc-go 5h/1w/1m)与 Codex 剩余额度百分比(已订阅账号展示 5 小时/周两行;未订阅账号展示 `codex 免费额度` 单行,两类行互斥;`dsh-codex-subscription` 返回 gpt-reserve 额度时,追加展示同等样式的 `codex gpt-reserve额度` 行);行首带对应图标并缩进;「用量」模块恒定展示(可在 HUD 设置中关闭),模块头部的「跳转」按钮可在「用量」模块设置中关闭,DeepSeek 余额行始终展示(无数据时显示 `—`,点击仍打开对应设置页),OpenCode Go 与 Codex 行按各自安装/登录状态独立展示(无数据时整组不渲染,数值可点击打开对应设置页) |
47
48
  | git | 常驻展示(新建会话页与会话页均默认展示;工作区不是 git 仓库时标题栏右侧提供「初始化仓库」,点击即在该工作区执行 `git init`,建仓后按钮自动换成分支按钮);当前分支(标题栏右侧分支按钮:下拉列表可切换已有分支、创建新分支并自动切换)、变更文件数量;变更文件按暂存区(staged)与未暂存区(changes)分组展示(组名带灰色计数,无文件的分组自动隐藏);文件行左键打开右侧栏 diff、右键打开暂存/撤销菜单(悬停 0.5 秒显示完整路径);「commit」提交暂存区(手动输入或 AI 生成提交信息——按内置本地 git 提交规范 [YYMMDD] 项目名 vX.Y.Z:内容),「revert」撤销全部未暂存变更(已跟踪文件还原内容、未跟踪新建文件与 intent-to-add 预登记文件一并删除;暂存区文件不受影响,无法删除的嵌套仓库/子模块目录会明确提示;破坏性操作均有二次确认与受影响文件清单);「git graph」弹窗(全部引用提交分页展示:每页最多 80 条,滑到底部出现「加载更多」按钮逐页追加,直至全部历史;当前分支标签为蓝底白字,其他分支为灰底黑字;提交行悬停 0.5 秒显示完整提交信息,并在提交标题下方展示该提交的分支/标签;提交行右键菜单可复制短哈希/全哈希/提交标题、从此处创建分支、合并至当前分支,或执行 soft / mixed / hard reset;创建分支为原位输入 + 图标按钮,合并与 reset 为行内二次确认) |
49
+ | 产物 | 列出**当前会话所有轮次**改动过的指定格式文件(`html` / `md` / `pdf` / `docx` / `csv` / `xlsx` / `pptx` / `cd` / `clark` / `jpg` / `jpeg` / `png` / `gif` / `webp` / `svg`,共 16 种、大小写不敏感):只列**工作区内且仍存在**的文件,按最后一次改动倒序,**最多展示 24 个**(超出时列表底部提示「仅展示最近改动的 24 个文件」);每行显示文件名与目录,点击在**官方右侧栏**打开该文件内容(同一文件不会重复开 tab);数据来自 DSH 官方 `workspaceChanges` 的每轮摘要,**只在本 Host 进程内有效**(重启 DSH 后旧轮次为空),纯 shell 命令产生的改动不在记录内;默认位于「git」下方,可在 HUD 设置中关停或拖动排序;新建会话页不展示(设置卡片里显示为只读),旧 profile 的模块顺序会自动把新模块插到「git」之后 |
48
50
  | 子代理任务 | 当前会话全部后代子代理(按层级缩进)、执行中(黄)/已完成(绿)状态,点击在官方右侧栏打开子代理会话,保留主会话;仅在有子代理时展示 |
49
51
  | 任务 | 当前会话待办任务列表、已完成/待完成状态与计数(如`1/3`),随任务列表实时刷新;进行中任务显示旋转动画图标,底部展示「已完成/进行中/待处理」三态计数(含 0 恒显);仅在有任务时展示 |
50
52
  | 计划清单 | 当前会话通过 plan 模式(`exit_plan_mode`)产出的全部计划:待审批(黄)/已执行(绿)/已废弃(灰、划线淡色)三态标签,标题栏展示计划总数,点击行弹出计划全文弹窗,模块底部展示「已执行/待审批/已废弃」三态计数(含 0 恒显);仅在有计划记录时展示 |
51
53
  | MCP | 接入的全部 MCP 服务及 dsh 全局启用状态;开关经 DSH 插件管理器直接启停 dsh 全局的 MCP 服务(按行写入 profile `cordis.patch.yml` 并完成热重载,即时生效、无需刷新页面、不影响其它服务) |
52
- | 便笺 | 按**工作区共享**的便笺(同一工作区目录下所有会话共用一份内容,本地持久化);输入框底部拖拽手柄可调整高度(实时持久化),5000 字上限与字符计数,右侧圆点指示内容存在;可一键添加便笺全文至对话输入框;输入框为空时「清空」按钮置灰,有内容时需二次确认后清空;折叠/展开状态持久化 |
54
+ | 便笺 | 按**工作区共享**的便笺(同一工作区目录下所有会话共用一份内容与图片,本地持久化,重启 DSH 后仍在);输入框底部拖拽手柄可调整高度(实时持久化);**不限制字数**,底部也不再显示字数;可直接**粘贴图片**(最多 20 张,缩略图在输入框上方横滑、点击看大图、悬浮移除);「从聊天导入」先清空便笺里的文字与图片,再写入会话输入框的内容(便笺非空时先确认,非图片附件跳过并提示;输入框里没有文字或图片时按钮置灰);「添加至聊天」先清空会话输入框里的文字与图片,再写入便笺内容(输入框非空时先确认,图片按便笺顺序一起加入);有文字或图片时「清空」需二次确认,一次清掉文字与图片;折叠/展开状态持久化 |
53
55
  | 待办 | 按**工作区共享**的待办清单(同一工作区目录下所有会话共用一份清单与顺序,本地持久化);勾选完成/恢复、添加/删除、整行拖拽排序(拖动手柄位于行最左侧;拖动时其余条目实时让位,直观预览松手后的顺序)、一键清空已完成(二次确认,空列表置灰);底部展示完成计数;折叠/展开状态持久化 |
54
56
 
55
57
  **互斥协作**:HUD 面板与官方右侧栏、[dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 右侧栏互斥协作。右侧栏展开期间,HUD 面板**派生隐藏**——只是临时不可见,**不改写**该会话的展开记忆,正文也不会被额外推挤留白;关闭右侧栏后,面板按展开记忆自动恢复(除非此前手动收起过 HUD)。点击「HUD面板」按钮时若右侧栏已打开,则先自动收起侧栏再展示 HUD(若版本兼容性导致自动收起失败,面板保持隐藏,待右侧栏关闭后自动出现);新建会话页在右侧栏展开期间不显示该悬浮入口。面板配置为**左侧**时(见「HUD面板通用设置」),窄窗口下左侧会话列表的遮罩抽屉展开期间面板同样临时隐藏,关闭抽屉后自动恢复(仍不改写展开记忆)。
@@ -60,7 +62,7 @@ HUD在dsh中的效果(深色主题)
60
62
 
61
63
  ```bash
62
64
  # 1. 安装(无需 git;本机需有 pnpm,dsh plugin 会调用它)
63
- dsh plugin --profile web add dsh-awesome-hud@0.18.6
65
+ dsh plugin --profile web add dsh-awesome-hud@0.19.1
64
66
 
65
67
  # 2. 重启 DSH Web 服务并刷新页面
66
68
  ```
@@ -72,7 +74,7 @@ dsh plugin --profile web add dsh-awesome-hud@0.18.6
72
74
 
73
75
  ```bash
74
76
  # 1. 安装(锁定版本 tag,要求本机 git 可访问 GitHub)
75
- dsh plugin --profile web add "github:Ycet/dsh-awesome-hud#v0.18.6"
77
+ dsh plugin --profile web add "github:Ycet/dsh-awesome-hud#v0.19.1"
76
78
 
77
79
  # 2. 重启 DSH Web 服务并刷新页面
78
80
  ```
@@ -90,7 +92,7 @@ dsh plugin --profile web add "dsh-awesome-hud@link:<absolute-path-to-plugin>"
90
92
 
91
93
  ```bash
92
94
  # 1. 安装(可直接用 Release 资产 URL,也可先下载 .tgz 再传本地路径)
93
- dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/download/v0.18.6/dsh-awesome-hud-0.18.6.tgz"
95
+ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/download/v0.19.1/dsh-awesome-hud-0.19.1.tgz"
94
96
 
95
97
  # 2. 重启 DSH Web 服务并刷新页面
96
98
  ```
@@ -102,11 +104,11 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
102
104
 
103
105
  ### 桌面端安装(macOS)
104
106
 
105
- 当前版本:**0.18.6**。先完全退出 DeepSeek Harness,再使用桌面应用自带的 CLI 安装;不要用旧 Web CLI 管理 `desktop` profile。优先从 npm 安装(可在插件页一键更新),本地开发时再改用源码目录:
107
+ 当前版本:**0.19.1**。先完全退出 DeepSeek Harness,再使用桌面应用自带的 CLI 安装;不要用旧 Web CLI 管理 `desktop` profile。优先从 npm 安装(可在插件页一键更新),本地开发时再改用源码目录:
106
108
 
107
109
  ```bash
108
110
  # 从 npm 安装(推荐)
109
- "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-awesome-hud@0.18.6
111
+ "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-awesome-hud@0.19.1
110
112
 
111
113
  # 从本地源码安装(开发)
112
114
  "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add "dsh-awesome-hud@link:<absolute-path-to-plugin>"
@@ -115,18 +117,18 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
115
117
  重新打开应用后,在会话右上角点击「HUD面板」。Codex 额度需要另行安装并登录支持当前 DSH 版本的 `dsh-codex-subscription`;DeepSeek 余额优先来自 `dsh-account-usage`,未安装/未启用时回退 DSH 官方账户服务(需登录 DeepSeek 账号);OpenCode Go 用量与设置页页签来自 `dsh-account-usage`。
116
118
 
117
119
  > [!NOTE]
118
- > 便笺、待办、折叠和面板开合记忆保存在当前浏览器或桌面应用的 `localStorage`。安装插件不会自动搬运 Web 浏览器中的这些数据;模型与登录凭据由 DSH 管理。
120
+ > 便笺文字、待办、折叠、面板设置和面板开合记忆保存在当前浏览器或桌面应用的 `localStorage`;**便笺图片**以原图存在同一来源的 **IndexedDB**(同样随重启保留、按工作区共享)。安装插件不会自动搬运 Web 浏览器中的这些数据;模型与登录凭据由 DSH 管理。
119
121
 
120
122
  ## 🧭 使用说明
121
123
 
122
- - **HUD 面板**:宽度 300px,高度上限为输入框底部(留 8px 底距),内容超出时面板内部滚动(**不展示滚动条**)。展开位置由「HUD面板通用设置 → HUD 面板展开位置」决定:**右侧**(默认)贴在窗口右侧,聊天内容与输入框自动向左让位;**左侧**时贴在会话区左缘(会话列表右侧,8px 间距),正文与输入框向右让位;两种侧位下页面滚动条都停在窗口最右缘,会话页右缘的「轮次导航」指示条仍停在正文右缘,面板都不会与正文重叠。右侧栏展开期间面板隐藏且不推挤正文,关闭后恢复。
124
+ - **HUD 面板**:宽度 300px,高度上限为输入框底部(留 8px 底距),内容超出时面板内部滚动(**不展示滚动条**)。面板为**常驻固定展示**(正文与输入框按侧位让位)。展开位置由「HUD面板通用设置 → HUD 面板展开位置」决定:**右侧**(默认)贴在窗口右侧,聊天内容与输入框自动向左让位;**左侧**时贴在会话区左缘(会话列表右侧,8px 间距),正文与输入框向右让位;两种侧位下页面滚动条都停在窗口最右缘,会话页右缘的「轮次导航」指示条仍停在正文右缘,面板都不会与正文重叠。右侧栏展开期间面板隐藏且不推挤正文,关闭后恢复。
123
125
  - **设置弹窗**:「会话」模块右上角齿轮打开设置弹窗,顶部是**「HUD 设置」/「使用说明」两个标签**(选中项带品牌色下划线,可随时切换);设置页为**左右分栏**:中间一条分割线,左栏是模块启停与排序,右栏是模块的具体设置。
124
126
  - **左栏**:勾选控制「上下文 / 用量 / git / 子代理任务 / 任务 / 计划清单 / MCP / 便笺 / 待办」的显隐(「会话」模块恒展示),每张卡片左侧有**拖动排序手柄**(按住拖动调整该模块在 HUD 面板中的顺序,全局生效;拖动时其余卡片实时让位预览,松手才落盘)。左栏不随右栏滚动;弹窗高度随窗口自适应并压缩卡片间距,保证 9 张模块卡片始终全部露出。**新建会话页不渲染的模块(上下文 / 子代理任务 / 任务 / 计划清单)在该页的设置里按真实状态展示、置灰不可点击**(悬浮显示原因),其开关请在会话页调整。
125
- - **右栏**:三个**卡片式分区**(内容过多时只滚动这一栏)。① **「HUD面板通用设置」**:HUD 面板展开位置(左侧 / 右侧)、新建会话页默认展示、聊天会话页默认展示(后两项只影响还没有开合记忆的页面/会话)。② **「「上下文」模块设置」**:始终显示分段进度条(默认关闭,关闭时只在悬浮进度条时显示分段)、显示「会话统计」、显示「Token 用量」。③ **「「用量」模块设置」**:DeepSeek 余额、OpenCode Go 用量、codex额度三行恒列出,未安装或未配置/未登录的项置灰并给出行内原因(DeepSeek 走内置官方余额源,恒可切换),另有**展示「跳转」按钮**开关(默认启用,关闭后「用量」模块不再渲染该按钮及其菜单)。
127
+ - **右栏**:三个**卡片式分区**(内容过多时只滚动这一栏)。① **「HUD面板通用设置」**:HUD 面板展开位置(左侧 / 右侧)、新建会话页默认展示、聊天会话页默认展示(后两项只影响还没有开合记忆的页面/会话)。② **「「上下文」模块设置」**:始终显示分段进度条(默认关闭,关闭时只在悬浮进度条时显示分段)、显示「会话统计」、显示「Token 用量」、**上下文模块位置固定**(默认关闭;开启后 HUD 面板上下滚动时该模块与会话模块一样停住,仅当上下文排在模块排序首位时可开启,否则置灰并说明原因)。③ **「「用量」模块设置」**:DeepSeek 余额、OpenCode Go 用量、codex额度三行恒列出,未安装或未配置/未登录的项置灰并给出行内原因(DeepSeek 走内置官方余额源,恒可切换),另有**展示「跳转」按钮**开关(默认启用,关闭后「用量」模块不再渲染该按钮及其菜单)。
126
128
  - **控件与页脚**:右栏启停项使用 DSH 官方 `Switch` 样式(`@deepseek-ai/dsh-client-ui-primitives`,不可用时回退等价本地样式),「左侧/右侧」使用官方分段控件。底部左侧的**「恢复默认」**在当前设置与默认不同时激活,可把勾选、用量行、上下文设置、面板设置与排序一并恢复默认(仍需点「确认」落盘)。弹窗支持点击遮罩、右上角「关闭」、「取消」或 `Esc` 关闭(关闭等同取消,不保存改动);确认后写入并关闭。打开时焦点进入弹窗,Tab 在弹窗内循环,关闭后回到齿轮按钮。
127
- - **使用说明页**:第二个标签是内置帮助页(「HUD 设置」标签用 `assets/icons/settings-outline.svg` 的描边齿轮,「使用说明」标签用 `assets/icons/hint.svg` 的提示图标)——左侧 240px 目录(与设置页左栏同宽,两个标签切换时分割线不跳位;点击跳到对应小节,右侧滚动时目录自动高亮),右侧 11 个模块分节卡片(目录项与小节标题只用文字,不再配图标):HUD 面板、会话、上下文、用量、git、子代理任务、任务、计划清单、MCP、便笺、待办;每节按「展示 / 功能」分组列出简短要点——模块展示哪些信息、有哪些可操作功能(分功能点),「HUD 面板」一节另含「设置」分组讲设置弹窗内容。底部「恢复默认 / 取消 / 确认」在说明页同样常驻(无改动时「恢复默认」置灰);切换标签不会丢失设置页未确认的改动,**弹窗高度也保持不变**——设置页在说明页下方保持挂载并提供高度基准,说明页以绝对定位覆盖在同一区域。
128
- - **会话模块**:工作区名称与会话名称都是悬浮变灰的可点击按钮,点击后在**鼠标位置**打开菜单(菜单宽度 200px,贴近视口边缘时自动夹取到视口内;面板内部滚动或窗口缩放时菜单保持原位不跳动,点击外部、按 `Esc` 或再次点击标题即可关闭)。
129
- - **工作区菜单**(左上角工作区名):**重命名工作区**(原位输入框,写入 DSH 工作区注册表,官方侧栏/选择器同步更新;与其它工作区同名时给出明确提示并退回原名)、**在 Finder 中显示**(macOS 为「在 Finder 中显示」,Windows 为「在资源管理器中显示」,其余平台为「在文件夹中显示」;原生打开由宿主执行,宿主不支持时该项置灰并提示原因)、**复制工作区路径**。
129
+ - **使用说明页**:第二个标签是内置帮助页(「HUD 设置」标签用 `assets/icons/settings-outline.svg` 的描边齿轮,「使用说明」标签用 `assets/icons/hint.svg` 的提示图标)——左侧 240px 目录(与设置页左栏同宽,两个标签切换时分割线不跳位;点击跳到对应小节,右侧滚动时目录自动高亮),右侧 11 个模块分节卡片(目录项与小节标题只用文字,不再配图标):HUD 面板、会话、上下文、用量、git、子代理任务、任务、计划清单、MCP、便笺、待办;每节按「展示 / 功能」分组列出简短要点——模块展示哪些信息、有哪些可操作功能(分功能点),「HUD 面板」一节另含「设置」分组讲设置弹窗内容;便笺一节含**图片 / 从聊天导入**要点。底部「恢复默认 / 取消 / 确认」在说明页同样常驻(无改动时「恢复默认」置灰);切换标签不会丢失设置页未确认的改动,**弹窗高度也保持不变**——设置页在说明页下方保持挂载并提供高度基准,说明页以绝对定位覆盖在同一区域。
130
+ - **会话模块**:工作区名称与会话名称都是悬浮变灰的可点击按钮(两者的**悬浮 / 点击热区都是整行宽度**,只让出右侧的状态胶囊与齿轮按钮),点击后在**鼠标位置**打开菜单(菜单宽度 200px,贴近视口边缘时自动夹取到视口内;面板内部滚动或窗口缩放时菜单保持原位不跳动,点击外部、按 `Esc` 或再次点击标题即可关闭)。
131
+ - **工作区菜单**(左上角工作区名):**重命名工作区**(原位输入框,写入 DSH 工作区注册表,官方侧栏/选择器同步更新;与其它工作区同名时给出明确提示并退回原名)、**在 Finder 中显示**(macOS 为「在 Finder 中显示」,Windows 为「在资源管理器中显示」,其余平台为「在文件夹中显示」;原生打开由宿主执行,宿主不支持时该项置灰并提示原因)、**复制工作区路径**(复制项前有分割线,与上面两项分组)。
130
132
  - **会话菜单**(会话名称):**置顶会话 / 取消置顶**(按当前状态切换文案与图标,置顶后名称右侧显示小图钉,效果与官方侧栏一致)、**重命名**、**分支会话**(与官方一致:创建后不跳转当前页,成功以 toast 提示;需要迁移源会话时提示先打开该会话)、**复制会话 ID**、**复制会话名称**。
131
133
  - **内联改名**:点击「重命名」后名称原位变为输入框并自动全选,**点击其他区域即提交**(也支持 Enter 提交、Esc 取消);内容空白或未改动时不发请求,失败时退回原名并 toast 报错。新建会话页不展示会话标题与状态徽标,工作区菜单在该页同样可用(作用于推导出的目标工作区)。
132
134
  - **上下文**:标题右侧按「当前占用 / 最大上下文(占用率)」展示,例如 `199K / 1M(19.9%)`;进度条默认单色(0–40% 绿 / 40–90% 黄 / >90% 红),鼠标悬浮时切换为三段式并弹出 breakdown 提示(System prompt 石青色、Tool definitions 紫色、Messages 蓝色,数值为估算 token);底部两行分别是会话统计(轮数/步数 · tok/s)与 Token 用量(总量 · 缓存命中),悬浮时分别显示完整统计(模型用时、工具调用用时、首 token 平均、输出速度)和完整用量(缓存命中、未缓存输入、缓存读取、缓存写入、输出)。「压缩」在会话空闲时可用,运行中按钮禁用并提示原因;进度条常显分段、两行统计/用量的显隐可在 HUD 设置的「上下文」卡片中调整。
@@ -156,8 +158,8 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
156
158
  - **已废弃**(灰色标签、文字划线变淡):审查未通过——包括拒审/要求修改/打断审查(错误结果)、在计划审查卡片上点「要求修改」(关闭审查、回到输入框;DSH 0.2.1-rc.5 起该操作以**成功结果** `{ approved: false }` 返回且计划模式仍生效,HUD 立即判为已废弃),以及计划无审批结论但 plan 模式随后退出(如 `/plan off`)。兼容新版消息级错误标记、旧结果块、结果文案与 plan 模式退出信号;
157
159
  - 行主文字取计划首个 Markdown 标题,无标题时截取正文;点击任一行弹出计划全文弹窗(标题、状态、产出时间与正文,正文按轻量 Markdown 渲染,支持标题/列表/代码块/链接/引用与 GFM 表格);模块底部展示「x 已执行 · x 待审批 · x 已废弃」三态计数(含 0 恒显);模块可折叠,默认展开。
158
160
  - **MCP 模块**:开关控制 dsh 全局的 MCP 服务启停——经 DSH 官方插件管理器 `pluginManager.setPluginEnabled` 按行写入 profile `cordis.patch.yml` 并等待热重载完成,开关即时生效、无需刷新页面,只改目标服务、不改动其它插件配置;未启用 HMR 的 profile 会提示「重启后生效」;模块默认展开,无任何 MCP 服务时仍展示空状态。
159
- - **便笺模块**:按**工作区共享**的便笺——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用一份内容,含输入框高度),本地持久化;删除或归档其中任一/全部会话都不影响该工作区其它会话的内容,下次在同一工作区新建会话时内容依旧存在;输入框底部拖拽手柄可拖拽调整高度(实时持久化),5000 字上限与字符计数显示;右侧圆点指示便笺内容存在;可一键添加便笺全文至对话输入框(新建会话页会打开该工作区最近的会话并追加草稿);输入框为空时「清空」按钮置灰,有内容时首次点击进入红色确认态,二次点击后清空(点击其他区域、Escape 或 2 秒超时会取消);模块可折叠/展开(状态持久化)。未归属工作区(无 cwd)的会话降级为会话级隔离,不与其它会话共享。
160
- - **待办模块**:按**工作区共享**的待办清单——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用同一份清单与顺序,本地持久化);每条待办为**卡片式**(1px 描边 + 浅底 + 10px 圆角,与「HUD 设置」里的模块卡片同款,行距 6px),**编辑 / 删除按钮默认隐藏,鼠标悬浮该行时才出现,键盘聚焦(`:focus-visible`)也会显示**(隐藏时仍占位,文字不会因悬浮而重新换行;触屏等无 hover 环境始终显示;鼠标拖动后不会再滞留);勾选完成/恢复、添加/删除项、整行拖拽排序(拖动手柄位于行最左侧勾选框之前,**手柄热区覆盖整行高度**,多行条目也能整列拖起;拖动时其余条目按真实行高实时让位,松手才保存顺序)、一键清空已完成(二次确认弹窗,无已完成项时按钮置灰);底部展示完成计数;模块可折叠/展开(状态持久化)。同一工作区多会话/多标签页同时编辑时按条目 id 归并,不会互相清空。
161
+ - **便笺模块**:按**工作区共享**的便笺——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用一份内容与图片,含输入框高度),文字存 `localStorage`、图片以原图存 IndexedDB,重启 DSH 后依旧存在;删除或归档其中任一/全部会话都不影响该工作区其它会话的内容,下次在同一工作区新建会话时内容与图片依旧存在。输入框底部拖拽手柄可拖拽调整高度(实时持久化);**不限制字数**,底部也不再显示字数与图片张数。**图片**:直接在输入框里粘贴(`image/*`,最多 20 张;字节上限沿用宿主的会话内附件校验),缩略图在输入框上方横向滚动,点击看大图(Esc / 遮罩 / 关闭按钮退出),鼠标悬浮缩略图右上角出现移除按钮(触屏常显);「清空」或移除都会释放对应原图。**从聊天导入**(位于「添加至聊天」左侧):先清空便笺里的文字与图片(旧原图一并释放并删除 IndexedDB 记录),再写入当前会话/新建会话页输入框里的文字与图片,便笺非空时先弹确认,非图片附件会跳过并提示;输入框内容不清除,输入框为空时按钮置灰、只提示且不清空便笺。**添加至聊天**:先清空会话输入框里的文字与图片(逐个移除并释放旧附件),再写入便笺文字并按便笺顺序加入图片;输入框非空时先确认,为空则直接写入,成功后焦点回到输入框;便笺内容保留;清空后写入失败不回滚(保持已清空 + 已写入部分并提示)。有文字或图片时「清空」可用:首次点击进入红色确认态,二次点击后同时清掉文字与图片(点击其他区域、Escape 或 2 秒超时会取消)。模块可折叠/展开(状态持久化)。未归属工作区(无 cwd)的会话降级为会话级隔离,不与其它会话共享。
162
+ - **待办模块**:按**工作区共享**的待办清单——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用同一份清单与顺序,本地持久化);每条待办为**卡片式**(1px 描边 + 浅底 + 10px 圆角,与「HUD 设置」里的模块卡片同款,行距 6px),**编辑 / 删除按钮默认隐藏,鼠标悬浮该行时才出现,键盘聚焦(`:focus-visible`)也会显示**(两者改为**绝对定位浮层**:文字独占整行宽度,悬浮时浮层以行底色实底铺在行右端、左侧 16px 渐隐把文字淡出,既不会被挤窄、也不会重新换行;触屏等无 hover 环境按钮常显并给文字留出右侧避让;鼠标拖动后不会再滞留);勾选完成/恢复、添加/删除项、整行拖拽排序(拖动手柄位于行最左侧勾选框之前,**手柄热区覆盖整行高度**,多行条目也能整列拖起;拖动时其余条目按真实行高实时让位,松手才保存顺序)、一键清空已完成(二次确认弹窗,无已完成项时按钮置灰);底部展示完成计数;模块可折叠/展开(状态持久化)。同一工作区多会话/多标签页同时编辑时按条目 id 归并,不会互相清空。
161
163
  - **折叠状态**:各模块折叠/展开状态刷新页面后保持(localStorage);「会话」模块图标使用 DSH favicon。
162
164
  - **新建会话页**:右上角提供独立悬浮「HUD面板」按钮(该页没有会话页眉;Windows 普通窗口中入口位于原生标题栏下方,全屏时取消该偏移)。该入口与聊天会话页保持同一顺序:始终排在右侧工具按钮簇左侧(装有 better-sidebar 时,其「底部面板」切换按钮排在入口右侧、两个页面的间距一致)——这让两个页面的入口位置看起来完全相同。**图片大图预览打开时该按钮隐藏**——预览是铺满视口的模态浮层(`role="dialog"` + `aria-modal`,如 `dsh-codex-subscription` 的图片查看器),而 HUD 入口的层级远高于它,不隐藏就会浮在大图与右上角预览关闭按钮之上;预览关闭后按钮自动恢复,面板开合状态不受影响(判定只看浮层语义与视口覆盖率,不绑定第三方类名)。该页每次进入都从收起状态开始,点击按钮后展开;面板固定贴右侧、宽 300px,输入框与正文左移让位,按钮保持原位。官方右侧栏(含 better-sidebar)展开期间,该悬浮入口与面板一并隐藏——入口不再移到侧栏左侧,也不再把展开态面板的位置写进定位;关闭侧栏后入口**立即出现在打开侧栏前的位置**,不会先闪到侧栏边缘,并回到该页此前的开合状态(除非已手动收起 HUD)。新建页的 Git、便笺、待办和便笺发送目标使用同一最近工作区;MCP 作为全局模块独立刷新,无会话或工作区时也可查看和启停。该页展示会话 / 用量 / git / 便笺 / 待办 / MCP 模块(git 常驻,目标工作区不是仓库时提供「初始化仓库」;「用量」模块恒定展示,DeepSeek 余额无数据时显示 `—`);尚无会话记录时不展示会话标题与状态徽标(工作区标题菜单照常可用)。进入真实会话后加载该会话自己的开合记忆,标题栏原按钮接管入口。
163
165
 
@@ -249,7 +251,12 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
249
251
  | 数据来源 | 客户端会话投影(`ctx.sessions.list` / `workspaces` / `modelDirectories`)+ 自有 host API(git / MCP / 子代理 / 计划清单 / 压缩)+ dsh-account-usage 余额/用量路由(复用,缺失时回退官方 `deepseekAccount`) |
250
252
  | 测试 | `node --test`(git 解析、MCP 解析、状态推导、计划清单推导、设置收敛、信任围栏、git 文件动作;位于 `test/`) |
251
253
 
252
- ## ⬆️ 升级说明(v0.11.x → v0.18.6)
254
+ ## ⬆️ 升级说明(v0.11.x → v0.19.1)
255
+
256
+ **v0.19.1:新增「产物 / Outputs」模块**:① 面板新增第 10 个模块「产物」(英文 `Outputs`),**默认位于「git」下方**:汇总当前会话**所有轮次**改动过的文件(数据来自 DSH 官方 `workspaceChanges` 的每轮摘要),只保留**工作区内、仍存在、扩展名在白名单内**的条目——`html` / `md` / `pdf` / `docx` / `csv` / `xlsx` / `pptx` / `cd` / `clark` / `jpg` / `jpeg` / `png` / `gif` / `webp` / `svg`(大小写不敏感,共 16 种)。② 排序按**最后一次改动**倒序、同轮按路径字母序;**最多展示 24 个**,超出时列表底部提示「仅展示最近改动的 24 个文件」。③ 每行显示**文件名(主)+ 目录(灰字小字)**;点击在**官方右侧栏**打开该文件内容(地址按 DSH 的 `dsh-resource://file/session/<id>/<路径>` 语法逐段编码,因此同一文件不会重复开 tab)。④ 降级明确:旧 DSH 缺少 `workspaceChanges` 或 `sidebarRight` 时,模块显示「当前 DSH 不支持读取本会话改动」而不是报错;点击打开失败给 toast;「无改动记录」与「能力不可用」是**两种不同空态**。⑤ 刷新与其它模块一致:面板打开期间每 5 秒轮询、切会话立即重拉;折叠状态随 `localStorage` 持久化;新建会话页不展示该模块(设置卡片显示为只读)。⑥ 旧 profile 的顺序在归一化时会把新模块**插到 `git` 之后**,其它缺失键仍按原规则追加,不必手动重排。⑦ 新增 `test/outputs-module.test.mjs` 十条回归(白名单与大小写、跨轮次并集与去重、24 条截断与排序、存在性检查与次数上限、坏事件容错、地址编码、宿主 schema/命令白名单/图标资产、客户端接线与说明页第 12 节、组件渲染与两种空态、点击打开的成功与失败分支),并更新 `module-order`、`workspace-scope`、`settings-guide`、`settings-refresh`。中英文 README 与内置「使用说明」页同步更新。测试基线:497 tests / 494 pass / 0 fail / 3 skipped。
257
+
258
+ **v0.19.0:便笺模块支持图片与从聊天导入、取消字数上限,按钮固定两行**:① **便笺取消 5000 字上限**,底部也不再显示字数;输入框可直接**粘贴图片**(`image/*`,最多 20 张,字节上限沿用宿主的会话内附件校验):缩略图在输入框上方横向滚动、点击看大图(Esc / 遮罩 / 关闭按钮退出)、悬浮右上角出现移除按钮;图片以**原图**写入 IndexedDB(按工作区键一条记录),文字仍存 `localStorage`,因此同一工作区共享、重启 DSH 后仍在;IndexedDB 不可用时降级为内存并提示。② 新增**「从聊天导入」**按钮(位于「添加至聊天」左侧):**先清空便笺**里的文字与图片(旧原图一并释放并删除 IndexedDB 记录),**再写入**当前会话/新建会话页输入框里的文字与图片;便笺非空时先确认,非图片附件跳过并提示,输入框内容不清除;输入框里没有文字或图片时该按钮置灰,源为空时只提示、不清空便笺。③ **「添加至聊天」同为两段式**:**先清空会话输入框**(文字与全部旧图片,逐个 `removeAttachment` 并 `releaseDraftAttachments`,释放预览 URL 与上传),**再写入**便笺文字并按便笺顺序加入图片;输入框非空时先弹确认,为空则直接写入,成功后焦点回到输入框,便笺内容保留;清空后写入失败不回滚(保持已清空 + 已写入部分并提示)。④ 便笺按钮固定两行——「清空」独占上一行,「从聊天导入 / 添加至聊天」下一行各占一半宽度(中英文界面布局一致);输入框里没有文字或图片时「从聊天导入」置灰。⑤ 便笺图片与便笺文字都会随 profile / 浏览器来源持久化。⑥ 新增 `test/note-images.test.mjs`、`test/note-transfer.test.mjs`、`test/note-overwrite.test.mjs`、`test/note-input-plain.test.mjs` 四组回归(便笺图片粘贴/上限/IndexedDB/降级/清空/灯箱、双向搬运「先清空再写入」的调用顺序与失败降级、便笺覆盖的两段式与存储失败分支、便笺输入框只收纯文本与图片),并更新 `panel-settings`、`settings-dialog-layout`、`settings-guide`、`settings-persistence`、`settings-refresh`、`note-clear`、`turn-navigation-layout`、`desktop-compat` 等相关用例。中英文 README 与「使用说明」页同步更新。测试基线:484 tests / 481 pass / 0 fail / 3 skipped。
259
+ **v0.18.7:待办文字铺满整行、标题热区、菜单细节与「上下文模块位置固定」**:① 待办条目的编辑 / 删除按钮此前即使隐藏也**保留约 60px 占位**(约占整行 1/4),多字待办被迫提前换行。现在两个按钮改为**绝对定位浮层**:文字独占整行宽度,悬浮 / 键盘聚焦时浮层出现在行右端,并以行底色实底铺满按钮区(底色抽成 `--hud-todo-bg` 变量,卡片与浮层严格同色),左侧再挂 16px 渐隐伪元素、让文字在按钮之前就淡出——先前只给容器一条 14px 渐变,淡出区正好落在第一个图标下方,看起来像文字压着按钮;文字不会被硬切、也不会因为悬浮而重新换行;拖动中的行不显示浮层;触屏等无 hover 环境按钮常显,同时给文字加 60px 右侧避让,避免常显按钮盖字。② **会话名称**的悬浮 / 点击热区从「只有文字宽」改为**整行宽度**(右侧 Running 状态胶囊、置顶图钉与工作区行的右侧齿轮仍占位,高度不变,超长标题照旧省略);工作区名称本就是整行热区,补回归断言防止被改回。③ 英文界面会话菜单的「复制名称」项改为 **`Copy Session Name`**,与上一项 `Copy Session ID` 的大小写一致(中文「复制会话名称」不变,其余菜单项不动)。④ 工作区菜单在「在 Finder 中显示」与「复制工作区路径」之间补一条**分割线**(复用会话菜单同款 `.hud-git-menu-divider`:1px、12% 灰、左右内缩 4px),复制类操作自成一组的观感与英文会话菜单一致。⑤ 「HUD 设置 →「上下文」模块设置」新增**「上下文模块位置固定」**开关(默认关闭):开启后在 HUD 面板上下滚动时,上下文模块与会话模块一样固定住——面板把上下文模块移出滚动容器、渲染在会话模块正下方(与会话模块同属固定头区,不依赖 sticky),滚动区只承载其余模块;固定区 `flex:none` 不参与收缩(否则面板内容撑满时会被压扁、统计行被裁掉),仅用 `max-height:55vh` + 内部滚动兜住矮窗口,矮窗口下不会把下方滚动区压没。为避免「开了没反应」,该开关**只在上下文是模块排序首位时可开启**(按设置弹窗里的排序与模块开关草稿实时判定:排在前面的模块被隐藏时会跳过;上下文自身被隐藏时给出「已隐藏,无需固定」),否则置灰并在行内说明原因;已存的值不会被改写,把排序拖回首位后自动生效。⑥ 「HUD 设置」左栏拖动排序:把模块拖到首位 / 末位时,若松手前指针已经滑出列表(甚至滑出弹窗),旧实现收不到 `drop`、模块会弹回原位;现在拖动期间在 document 捕获阶段接管 `dragover` / `drop`,落点按指针相对列表的位置钳制(列表上方 → 首位、下方 → 末位),并在 `dragend` 时用最后一次预览兜底提交;「恢复默认」改走独立的 `cancelDrag`,不会把拖动的半成品顺序写进草稿。⑦ 设置结构:`context.pinned` 写入既有 `context` 段(host schema、收敛函数与写侧白名单同步扩充),旧数据缺字段按 `false` 处理,升级后面板观感不变;`pinned` 关闭时面板 DOM 与 0.18.6 完全一致。新增 `test/context-pin.test.mjs` 十条回归(设置模型与 host schema、`contextPinState` 三种判定、弹窗置灰与草稿接线、固定区位置与滚动区去重、限高内滚样式、中英文案齐全、新建会话页不固定),并更新 `test/todo-item-card.test.mjs`(浮层 + 遮罩 + 触屏避让)、`test/session-title-menu.test.mjs`(整行热区与英文文案)、`test/workspace-title-menu.test.mjs`(复制项前分割线)、`test/status-settings.test.mjs`/`test/settings-persistence.test.mjs`/`test/settings-dialog-layout.test.mjs`(`pinned` 默认值与开关数量)。中英文 README 同步更新。测试基线:452 tests / 449 pass / 0 fail / 3 skipped。
253
260
 
254
261
  **v0.18.6:待办悬浮按钮拖动后滞留、拖动手柄热区过小**:① 待办条目的编辑 / 删除按钮此前用 `:focus-within` 控制显隐——用鼠标抓住最左侧手柄拖动时,手柄在拖动期间获得了焦点,松手后焦点仍留在该行,于是鼠标已经移开按钮也不会消失(要等下一次点击别处才隐藏,看起来像「延迟一段时间」)。现在改为 `:has(:focus-visible)`:只有**键盘聚焦**才触发显示,鼠标拖动 / 点击完全交给悬浮样式,松手移开即刻隐藏;悬浮显示与无 hover 环境常显的规则不变。② 拖动手柄的可拖动热区从固定 24px 高扩展到**整行高度**(`align-self:stretch` + 上下等量负外边距与内边距,视觉不变),多行文本的待办也能在手柄这一列的任意高度直接拖起。③ 说明页「待办模块」的拖动要点同步注明热区覆盖整行;`test/todo-item-card.test.mjs` 增加热区断言并改为校验新选择器(同时反向断言不再出现 `:focus-within`)。中英文 README 同步更新。测试基线:438 tests / 435 pass / 0 fail / 3 skipped。
255
262
 
@@ -0,0 +1 @@
1
+ <?xml version="1.0" standalone="no"?><!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd"><svg t="1794644509002" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="7598" xmlns:xlink="http://www.w3.org/1999/xlink" width="200" height="200"><path d="M544 128h-288c-19.2 0-32 12.8-32 32v704c0 19.2 12.8 32 32 32h512c19.2 0 32-12.8 32-32v-480h-192c-35.2 0-64-28.8-64-64v-192z m64 12.8v179.2h179.2l-179.2-179.2z m-352-76.8h352c9.6 0 16 3.2 22.4 9.6l224 224c6.4 6.4 9.6 12.8 9.6 22.4v544c0 54.4-41.6 96-96 96h-512c-54.4 0-96-41.6-96-96v-704c0-54.4 41.6-96 96-96z m64 352h160c19.2 0 32 12.8 32 32s-12.8 32-32 32h-160c-19.2 0-32-12.8-32-32s12.8-32 32-32z m0 128h384c19.2 0 32 12.8 32 32s-12.8 32-32 32h-384c-19.2 0-32-12.8-32-32s12.8-32 32-32z m0 128h384c19.2 0 32 12.8 32 32s-12.8 32-32 32h-384c-19.2 0-32-12.8-32-32s12.8-32 32-32z" fill="#000000" p-id="7599"></path></svg>