dsh-awesome-hud 0.19.1 → 0.19.2

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
@@ -33,7 +33,7 @@ HUD在dsh中的效果(深色主题)
33
33
  - [🖼️ 界面截图](#️-界面截图)
34
34
  - [⚙️ 兼容性](#️-兼容性)
35
35
  - [🔧 技术栈](#-技术栈)
36
- - [⬆️ 升级说明(v0.11.x → v0.19.1)](#️-升级说明v011x--v0191)
36
+ - [⬆️ 升级说明(v0.11.x → v0.19.2)](#️-升级说明v011x--v0192)
37
37
  - [📄 许可证](#-许可证)
38
38
 
39
39
  ---
@@ -42,17 +42,17 @@ HUD在dsh中的效果(深色主题)
42
42
 
43
43
  | 模块 | 说明 |
44
44
  | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
45
- | 会话 | 当前工作区名称、会话名称、会话状态(任务中/待审批/空闲中/待回答/等待子任务)、模型提供商/模型名/推理等级;工作区名称与会话名称均为悬浮变灰的可点击按钮——点击在鼠标位置打开操作菜单(工作区:重命名 / 在 Finder·资源管理器中显示 / 复制路径;会话:置顶或取消置顶 / 重命名 / 分支会话 / 复制会话 ID / 复制会话名称),选择重命名后名称原位变为输入框、失焦即提交(Enter 提交、Esc 取消,不再有取消/确认按钮),会话置顶后名称右侧显示小图钉;新建会话页不展示会话标题与状态;右上角「HUD 设置」打开左右分栏的设置弹窗(左栏模块启停与拖动排序,右栏「HUD面板通用设置 / 「上下文」模块设置 / 「用量」模块设置」卡片,顶部「使用说明」标签页提供内置上手指引) |
46
- | 上下文 | 上下文占用进度条(默认单色:0–40% 绿 / 40–90% 黄 / >90% 红;悬浮时切换为分段样式并显示 breakdown 提示:System prompt / Tool definitions / Messages,分别使用石青/紫/蓝);标题右侧展示「当前占用 / 最大上下文(占用率)」(如 `199K / 1M(19.9%)`),底部两行分别展示会话统计(轮/步 · tok/s)与 Token 用量(总量 · 缓存命中),悬浮两行显示完整统计/用量提示;一键「压缩」当前会话上下文;进度条常显分段、两行信息的显隐可在 HUD 设置中调整 |
45
+ | 会话 | 当前工作区名称、会话名称、会话状态(任务中/待审批/空闲中/待回答/等待子任务)、模型提供商/模型名/推理等级;工作区名称与会话名称均为悬浮变灰的可点击按钮——点击在鼠标位置打开操作菜单(工作区:重命名 / 在 Finder·资源管理器中显示 / 复制路径;会话:置顶或取消置顶 / 重命名 / 分支会话 / 复制会话 ID / 复制会话名称 / 归档会话;复制类操作之前与「归档会话」之前各有一条分割线),选择重命名后名称原位变为输入框、失焦即提交(Enter 提交、Esc 取消,不再有取消/确认按钮),会话置顶后名称右侧显示小图钉;新建会话页不展示会话标题与状态;右上角「HUD 设置」打开左右分栏的设置弹窗(左栏模块启停与拖动排序,右栏「HUD面板通用设置 / 「上下文」模块设置 / 「用量」模块设置」卡片,顶部「使用说明」标签页提供内置上手指引) |
46
+ | 上下文 | 上下文占用进度条(默认单色:0–40% 绿 / 40–90% 黄 / >90% 红;悬浮时切换为分段样式并显示 breakdown 提示:System prompt / Tool definitions / Messages,分别使用石青/紫/蓝);标题右侧展示「当前占用 / 最大上下文(占用率)」(如 `199K / 1M(19.9%)`),底部两行分别展示会话统计(轮/步 · tok/s)与 Token 用量(总量 · 缓存命中),悬浮两行显示完整统计/用量提示;一键「压缩」当前会话上下文;进度条常显分段、两行信息的显隐可在 HUD 设置中调整;**标题行与右侧箭头可折叠该模块**(折叠后只保留标题与占用率,折叠状态持久化,位置固定模式下同样生效) |
47
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 行按各自安装/登录状态独立展示(无数据时整组不渲染,数值可点击打开对应设置页) |
48
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」之后 |
50
- | 子代理任务 | 当前会话全部后代子代理(按层级缩进)、执行中(黄)/已完成(绿)状态,点击在官方右侧栏打开子代理会话,保留主会话;仅在有子代理时展示 |
51
- | 任务 | 当前会话待办任务列表、已完成/待完成状态与计数(如`1/3`),随任务列表实时刷新;进行中任务显示旋转动画图标,底部展示「已完成/进行中/待处理」三态计数(含 0 恒显);仅在有任务时展示 |
52
- | 计划清单 | 当前会话通过 plan 模式(`exit_plan_mode`)产出的全部计划:待审批(黄)/已执行(绿)/已废弃(灰、划线淡色)三态标签,标题栏展示计划总数,点击行弹出计划全文弹窗,模块底部展示「已执行/待审批/已废弃」三态计数(含 0 恒显);仅在有计划记录时展示 |
49
+ | 产物 | 列出**当前会话所有轮次**改动过的指定格式文件(`html` / `md` / `pdf` / `docx` / `csv` / `xlsx` / `pptx` / `cd` / `clark` / `jpg` / `jpeg` / `png` / `gif` / `webp` / `svg`,共 16 种、大小写不敏感):只列**工作区内且仍存在**的文件,按最后一次改动倒序,**最多展示 10 个**(超出时列表底部提示「仅展示最近改动的 10 个文件」);**默认先显示前 3 个**,超过 3 个时在第 3 个文件下方出现「展开其余 n 个文件」,展开后最后一个文件下方出现「收起」,点击回到 3 个(不超过 3 个时不出现该入口);每行显示文件名与目录,点击在**官方右侧栏**打开该文件内容(同一文件不会重复开 tab);数据来自 DSH 官方 `workspaceChanges` 的每轮摘要,**只在本 Host 进程内有效**(重启 DSH 后旧轮次为空),纯 shell 命令产生的改动不在记录内;默认位于「git」**上方**,可在 HUD 设置中关停或拖动排序;**没有符合格式的产物时整个模块不展示**(与子代理 / 任务 / 计划清单一致),有文件后才出现在面板里;新建会话页不展示(设置卡片里显示为只读),旧 profile 的模块顺序会自动把新模块插到「git」之前 |
50
+ | 子代理任务 | 当前会话全部后代子代理(按层级缩进)、执行中(黄)/已完成(绿)状态,点击在官方右侧栏打开子代理会话,保留主会话;仅在有子代理时展示;超过 3 个时默认只显示 3 个,第 3 个下方给出「展开其余 n 个子代理」,展开后末行下方给出「收起」 |
51
+ | 任务 | 当前会话待办任务列表、已完成/待完成状态与计数(如`1/3`),随任务列表实时刷新;进行中任务显示旋转动画图标,底部展示「已完成/进行中/待处理」三态计数(含 0 恒显);仅在有任务时展示;**已完成的任务统一移到列表最下方并默认折叠**(组内先完成的在上、后完成的在下),点「展开已完成任务」查看,展开后末行下方给「收起」 |
52
+ | 计划清单 | 当前会话通过 plan 模式(`exit_plan_mode`)产出的全部计划:待审批(黄)/已执行(绿)/已废弃(灰、划线淡色)三态标签,标题栏展示计划总数,点击行弹出计划全文弹窗,模块底部展示「已执行/待审批/已废弃」三态计数(含 0 恒显);仅在有计划记录时展示;超过 3 条时默认只显示 3 条,第 3 条下方给出「展开其余 n 条计划」,展开后末行下方给出「收起」 |
53
53
  | MCP | 接入的全部 MCP 服务及 dsh 全局启用状态;开关经 DSH 插件管理器直接启停 dsh 全局的 MCP 服务(按行写入 profile `cordis.patch.yml` 并完成热重载,即时生效、无需刷新页面、不影响其它服务) |
54
54
  | 便笺 | 按**工作区共享**的便笺(同一工作区目录下所有会话共用一份内容与图片,本地持久化,重启 DSH 后仍在);输入框底部拖拽手柄可调整高度(实时持久化);**不限制字数**,底部也不再显示字数;可直接**粘贴图片**(最多 20 张,缩略图在输入框上方横滑、点击看大图、悬浮移除);「从聊天导入」先清空便笺里的文字与图片,再写入会话输入框的内容(便笺非空时先确认,非图片附件跳过并提示;输入框里没有文字或图片时按钮置灰);「添加至聊天」先清空会话输入框里的文字与图片,再写入便笺内容(输入框非空时先确认,图片按便笺顺序一起加入);有文字或图片时「清空」需二次确认,一次清掉文字与图片;折叠/展开状态持久化 |
55
- | 待办 | 按**工作区共享**的待办清单(同一工作区目录下所有会话共用一份清单与顺序,本地持久化);勾选完成/恢复、添加/删除、整行拖拽排序(拖动手柄位于行最左侧;拖动时其余条目实时让位,直观预览松手后的顺序)、一键清空已完成(二次确认,空列表置灰);底部展示完成计数;折叠/展开状态持久化 |
55
+ | 待办 | 按**工作区共享**的待办清单(同一工作区目录下所有会话共用一份清单与顺序,本地持久化);勾选完成/恢复、添加/删除、整行拖拽排序(拖动手柄位于行最左侧;拖动时其余条目实时让位,直观预览松手后的顺序)、一键清空已完成(二次确认,空列表置灰);底部展示完成计数;**已完成的待办统一移到列表最下方并默认折叠**(组内保持原有先后),点「展开已完成待办」查看,展开后末行下方给「收起」,拖动只在未完成区段内重排;折叠/展开状态持久化 |
56
56
 
57
57
  **互斥协作**:HUD 面板与官方右侧栏、[dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 右侧栏互斥协作。右侧栏展开期间,HUD 面板**派生隐藏**——只是临时不可见,**不改写**该会话的展开记忆,正文也不会被额外推挤留白;关闭右侧栏后,面板按展开记忆自动恢复(除非此前手动收起过 HUD)。点击「HUD面板」按钮时若右侧栏已打开,则先自动收起侧栏再展示 HUD(若版本兼容性导致自动收起失败,面板保持隐藏,待右侧栏关闭后自动出现);新建会话页在右侧栏展开期间不显示该悬浮入口。面板配置为**左侧**时(见「HUD面板通用设置」),窄窗口下左侧会话列表的遮罩抽屉展开期间面板同样临时隐藏,关闭抽屉后自动恢复(仍不改写展开记忆)。
58
58
 
@@ -62,7 +62,7 @@ HUD在dsh中的效果(深色主题)
62
62
 
63
63
  ```bash
64
64
  # 1. 安装(无需 git;本机需有 pnpm,dsh plugin 会调用它)
65
- dsh plugin --profile web add dsh-awesome-hud@0.19.1
65
+ dsh plugin --profile web add dsh-awesome-hud@0.19.2
66
66
 
67
67
  # 2. 重启 DSH Web 服务并刷新页面
68
68
  ```
@@ -74,7 +74,7 @@ dsh plugin --profile web add dsh-awesome-hud@0.19.1
74
74
 
75
75
  ```bash
76
76
  # 1. 安装(锁定版本 tag,要求本机 git 可访问 GitHub)
77
- dsh plugin --profile web add "github:Ycet/dsh-awesome-hud#v0.19.1"
77
+ dsh plugin --profile web add "github:Ycet/dsh-awesome-hud#v0.19.2"
78
78
 
79
79
  # 2. 重启 DSH Web 服务并刷新页面
80
80
  ```
@@ -92,7 +92,7 @@ dsh plugin --profile web add "dsh-awesome-hud@link:<absolute-path-to-plugin>"
92
92
 
93
93
  ```bash
94
94
  # 1. 安装(可直接用 Release 资产 URL,也可先下载 .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"
95
+ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/download/v0.19.2/dsh-awesome-hud-0.19.2.tgz"
96
96
 
97
97
  # 2. 重启 DSH Web 服务并刷新页面
98
98
  ```
@@ -104,11 +104,11 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
104
104
 
105
105
  ### 桌面端安装(macOS)
106
106
 
107
- 当前版本:**0.19.1**。先完全退出 DeepSeek Harness,再使用桌面应用自带的 CLI 安装;不要用旧 Web CLI 管理 `desktop` profile。优先从 npm 安装(可在插件页一键更新),本地开发时再改用源码目录:
107
+ 当前版本:**0.19.2**。先完全退出 DeepSeek Harness,再使用桌面应用自带的 CLI 安装;不要用旧 Web CLI 管理 `desktop` profile。优先从 npm 安装(可在插件页一键更新),本地开发时再改用源码目录:
108
108
 
109
109
  ```bash
110
110
  # 从 npm 安装(推荐)
111
- "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-awesome-hud@0.19.1
111
+ "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-awesome-hud@0.19.2
112
112
 
113
113
  # 从本地源码安装(开发)
114
114
  "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add "dsh-awesome-hud@link:<absolute-path-to-plugin>"
@@ -179,6 +179,10 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
179
179
 
180
180
  ![alt text](docs/module-usage.png)
181
181
 
182
+ #### 「产物」模块
183
+
184
+ ![alt text](docs/module-outputs.png)
185
+
182
186
  #### 「git变更」模块
183
187
 
184
188
  ![alt text](docs/module-git.png)
@@ -251,7 +255,9 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
251
255
  | 数据来源 | 客户端会话投影(`ctx.sessions.list` / `workspaces` / `modelDirectories`)+ 自有 host API(git / MCP / 子代理 / 计划清单 / 压缩)+ dsh-account-usage 余额/用量路由(复用,缺失时回退官方 `deepseekAccount`) |
252
256
  | 测试 | `node --test`(git 解析、MCP 解析、状态推导、计划清单推导、设置收敛、信任围栏、git 文件动作;位于 `test/`) |
253
257
 
254
- ## ⬆️ 升级说明(v0.11.x → v0.19.1)
258
+ ## ⬆️ 升级说明(v0.11.x → v0.19.2)
259
+
260
+ **v0.19.2:修复「产物」模块排序不生效、无产物时隐藏并默认移到「git」上方,提交信息确认提示改为红字**:① 现象:在「HUD 设置」左栏把「产物」拖到 `git` 以外的位置,点「确认」后弹窗里的草稿顺序是对的,但 HUD 面板里的「产物」仍停在 `git` 下方,排序看起来完全没生效。② 原因:v0.19.1 为避免旧 profile 把新模块排到末尾,在宿主与客户端的 `normalizeModuleOrder` 末尾都执行了一次「按锚点落位」(`outputs` 紧跟 `git`);这段逻辑对**每次**读写都生效,于是用户手动拖走的位置在写侧、读侧与渲染时被连续拉回。③ 修复:把锚点语义收窄为「只补齐旧配置里缺失的键」——遍历缺失键时直接插到锚点之后,**已经出现在保存顺序里的键一律保持原位**;宿主 `lib/settings.js` 的 `applyModuleAnchors` 改为内部函数 `insertAtAnchor`(不再导出),客户端同名函数同步修改。④ 兼容性:旧 profile(顺序里还没有 `outputs`)仍然插在 `git` 之后,无需手动重排;把「产物」拖到首位、中间或末尾都不会再被改写,归一化保持幂等。⑤ 另外,Git commit 页点击「生成」后的确认提示(将调用官方 Flash 模型、不使用当前会话模型)由灰色次要文字改为红色(`--dsw-alias-state-error-primary`,浅色与深色主题均自适应),与右侧红色「确认?」按钮一致。⑥ 新增 `test/module-order.test.mjs` 回归(三个位置的原样保留、写侧 `sanitizeOrderPatch`、读侧 `normalizeSettings`、旧配置迁移仍按锚点、客户端与宿主同规则),并在 `test/git-client-flow.test.mjs` 补上红字断言。⑦ 「产物」模块改为**空列表时整体隐藏**(与子代理 / 任务 / 计划清单一致),有符合格式的文件后才出现在面板里;默认位置从「git」下方移到「git」**上方**,旧 profile 的顺序迁移同样插在 `git` 之前,之后仍可在 HUD 设置里把它拖到任意位置(已经保存过顺序的 profile 会保留原位置,点设置里的「恢复默认」即可采用新的默认顺序)。⑧ 「产物」「计划清单」「子代理任务」三个列表共用一套折叠交互:默认只显示前 3 条,超过时在第 3 条下方给出「展开其余 n 个…」(分别对应文件 / 计划 / 子代理),展开后最后一条下方给出「收起」,点击即可收起;⑨ 单次最多展示的数量由 24 个下调为 **10 个**(宿主 `OUTPUT_LIMIT` 与客户端默认值同步),截断提示同步显示「仅展示最近改动的 10 个文件」。⑩ 「任务」与「待办」两个模块把已完成的条目统一移到列表最下方并默认折叠:点「展开已完成任务 / 展开已完成待办」查看,展开后末行下方给「收起」;任务组内保持原有先后(先完成的在上、后完成的在下),待办的拖动只在未完成区段内重排、已完成条目固定组在末尾。⑪ 「HUD 设置 →「上下文」模块设置」里「始终显示分段进度条」移到「上下文模块位置固定」上方,卡片内顺序变为会话统计 → Token 用量 → 分段进度条 → 位置固定。⑫ 会话名称菜单最下方新增「归档会话」(走官方 `uiWorkspace.archiveSession`),与上面的复制类操作之间加一条分割线;已归档的会话或缺少该能力时该项置灰并给出原因。⑬ 上下文模块支持折叠:点标题行任意处或右侧箭头折叠,折叠后只保留标题与占用率,再点一次展开;折叠状态与其它模块共用一份 `localStorage` 记录,「上下文模块位置固定」生效时同样可折叠。测试基线:499 tests / 496 pass / 0 fail / 3 skipped。
255
261
 
256
262
  **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
263
 
Binary file