dsh-awesome-hud 0.20.1 → 0.21.0
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 +19 -17
- package/assets/icons/at.svg +1 -0
- package/assets/icons/minus.svg +3 -0
- package/lib/client.js +1205 -238
- package/lib/index.js +169 -24
- package/lib/settings.js +70 -12
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -33,7 +33,7 @@ HUD在dsh中的效果(深色主题)
|
|
|
33
33
|
- [🖼️ 界面截图](#️-界面截图)
|
|
34
34
|
- [⚙️ 兼容性](#️-兼容性)
|
|
35
35
|
- [🔧 技术栈](#-技术栈)
|
|
36
|
-
- [⬆️ 升级说明(v0.11.x → v0.
|
|
36
|
+
- [⬆️ 升级说明(v0.11.x → v0.21.0)](#️-升级说明v011x--v0210)
|
|
37
37
|
- [📄 许可证](#-许可证)
|
|
38
38
|
|
|
39
39
|
---
|
|
@@ -42,16 +42,16 @@ HUD在dsh中的效果(深色主题)
|
|
|
42
42
|
|
|
43
43
|
| 模块 | 说明 |
|
|
44
44
|
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
45
|
-
| 会话 | 当前工作区名称、会话名称、会话状态(任务中/待审批/空闲中/待回答/等待子任务)、模型提供商/模型名/推理等级;工作区名称与会话名称均为悬浮变灰的可点击按钮——点击在鼠标位置打开操作菜单(工作区:重命名 / 在 Finder·资源管理器中显示 / 复制路径;会话:置顶或取消置顶 / 重命名 / 分支会话 / 复制会话 ID / 复制会话名称 / 归档会话;复制类操作之前与「归档会话」之前各有一条分割线),选择重命名后名称原位变为输入框、失焦即提交(Enter 提交、Esc 取消,不再有取消/确认按钮),会话置顶后名称右侧显示小图钉;新建会话页不展示会话标题与状态;右上角「HUD 设置」打开左右分栏的设置弹窗(左栏模块启停与拖动排序,右栏「HUD面板通用设置(HUD 面板样式:卡片样式/边栏样式,默认卡片样式;HUD 面板展开位置;两处默认开合)/ 「上下文」模块设置 / 「用量」模块设置 / 「便笺」模块设置(便笺条数上限,5–20,默认 5
|
|
45
|
+
| 会话 | 当前工作区名称、会话名称、会话状态(任务中/待审批/空闲中/待回答/等待子任务)、模型提供商/模型名/推理等级;工作区名称与会话名称均为悬浮变灰的可点击按钮——点击在鼠标位置打开操作菜单(工作区:重命名 / 在 Finder·资源管理器中显示 / 复制路径;会话:置顶或取消置顶 / 重命名 / 分支会话 / 复制会话 ID / 复制会话名称 / 归档会话;复制类操作之前与「归档会话」之前各有一条分割线),选择重命名后名称原位变为输入框、失焦即提交(Enter 提交、Esc 取消,不再有取消/确认按钮),会话置顶后名称右侧显示小图钉;新建会话页不展示会话标题与状态;右上角「HUD 设置」打开左右分栏的设置弹窗(左栏模块启停与拖动排序,右栏「HUD面板通用设置(HUD 面板样式:卡片样式/边栏样式,默认卡片样式;HUD 面板展开位置;两处默认开合)/ 「上下文」模块设置 / 「用量」模块设置 / 「便笺」模块设置(便笺条数上限,5–20,默认 5;在弹窗页面中进行便笺内容编辑,默认关闭))」卡片,顶部「使用说明」/「更新日志」标签页分别提供内置上手指引与按版本分组的更新记录) |
|
|
46
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 5h·1w·1m / Codex 5h·周,Codex 未订阅时降级为免费额度,括号内数值加粗;对应数据不可用时设置选项置灰),DeepSeek 余额行始终展示(无数据时显示 `—`,点击仍打开对应设置页),OpenCode Go 与 Codex 行按各自安装/登录状态独立展示(无数据时整组不渲染,数值可点击打开对应设置页) |
|
|
48
|
-
| git | 常驻展示(新建会话页与会话页均默认展示;工作区不是 git 仓库时标题栏右侧提供「初始化仓库」,点击即在该工作区执行 `git init`,建仓后按钮自动换成分支按钮);当前分支(标题栏右侧分支按钮:下拉列表可切换已有分支、创建新分支并自动切换)、变更文件数量;变更文件按暂存区(staged)与未暂存区(changes
|
|
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
|
|
48
|
+
| git | 常驻展示(新建会话页与会话页均默认展示;工作区不是 git 仓库时标题栏右侧提供「初始化仓库」,点击即在该工作区执行 `git init`,建仓后按钮自动换成分支按钮);当前分支(标题栏右侧分支按钮:下拉列表可切换已有分支、创建新分支并自动切换)、变更文件数量;变更文件按暂存区(staged)与未暂存区(changes)分组展示(组名带灰色计数,无文件的分组自动隐藏;支持列表模式与文件树模式,文件树按文件夹嵌套分组、可展开折叠,设置随 profile 保存、重开面板或重启后仍保持);悬停文件行时右侧「+ / -」行数会换成操作按钮(暂存区显示「移出暂存区」,变更区显示「撤销更改」与「添加至暂存区」;按钮下方有渐变蒙层,不压住文件名与目录);文件夹行悬浮时对文件夹下全部变更文件执行同样的批量操作;变更文件行与「产物」一致:最左是变更状态字母,随后是**文件名**与灰色**相对目录**小字,最右保留 `+新增 / -删除` 行数;文件行左键打开右侧栏 diff、右键打开暂存/撤销菜单(悬停 0.5 秒显示完整路径);「commit」提交暂存区(手动输入或 AI 生成提交信息——按内置本地 git 提交规范 [YYMMDD] 项目名 vX.Y.Z:内容;生成依据为「提示词 + 暂存区变更 + 当前会话最近轮次的上下文」,前两者优先、会话上下文仅用于理解意图;用户明确指定的备注仍须符合日期/项目/版本规范;commit 弹窗顶部有**默认折叠**的「AI 生成提示词」区域,展开后可编辑并保存 generate 使用的提示词,也可一键恢复默认;**自定义提示词会完整接管生成指令**(暂存区 diff 仍自动附加),并**跳过默认的日期前缀与版本号校验**;`{{spec}}` / `{{today}}` / `{{project}}` / `{{sessionContext}}` 占位符由插件注入;提示词保存在 profile 设置里、跨重启有效),「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 种、大小写不敏感):只列**工作区内且仍存在**的文件,按最后一次改动倒序,**最多展示 10 个**(超出时列表底部提示「仅展示最近改动的 10 个文件」);**默认先显示前 3 个**,超过 3 个时在第 3 个文件下方出现「展开其余 n 个文件」,展开后最后一个文件下方出现「收起」,点击回到 3 个(不超过 3 个时不出现该入口);文件行向右缩进并与模块标题文字对齐,每行左侧显示蓝色后缀名标签(固定尺寸,后缀越长字号越小),随后是文件名与目录;右键文件行可「添加至聊天」「在文件夹显示」或复制文件名 / 相对路径 / 绝对路径(前两项与复制组之间以分割线分隔);鼠标在文件行上停留 0.5 秒,会在鼠标位置显示该文件的完整相对路径(与 git 变更文件行的悬停提示同一套样式);点击在**官方右侧栏**打开该文件内容(同一文件不会重复开 tab);数据由两部分合并:DSH 官方 `workspaceChanges` 的每轮摘要(带轮次信息),以及**工作区扫描**(按文件最后修改时间筛选,**终端命令产生的改动同样纳入**);筛选基准是会话创建时间,不依赖 Host 进程内缓存,**重启 DSH 后列表仍保留**;默认位于「git」**上方**,可在 HUD 设置中关停或拖动排序;**没有符合格式的产物时整个模块不展示**(与子代理 / 任务 / 计划清单一致),有文件后才出现在面板里;新建会话页不展示(设置卡片里显示为只读),旧 profile 的模块顺序会自动把新模块插到「git」之前 |
|
|
50
50
|
| 子代理任务 | 当前会话全部后代子代理(按层级缩进)、执行中(黄)/已完成(绿)状态,点击在官方右侧栏打开子代理会话,保留主会话;仅在有子代理时展示;超过 3 个时默认只显示 3 个,第 3 个下方给出「展开其余 n 个子代理」,展开后末行下方给出「收起」 |
|
|
51
51
|
| 任务 | 当前会话待办任务列表、已完成/待完成状态与计数(如`1/3`),随任务列表实时刷新;进行中任务显示旋转动画图标,底部展示「已完成/进行中/待处理」三态计数(含 0 恒显);仅在有任务时展示;**已完成的任务统一移到列表最下方并默认折叠**(组内先完成的在上、后完成的在下),点「展开已完成任务」查看,展开后末行下方给「收起」 |
|
|
52
52
|
| 计划清单 | 当前会话通过 plan 模式(`exit_plan_mode`)产出的全部计划:待审批(黄)/已执行(绿)/已废弃(灰、划线淡色)三态标签,标题栏展示计划总数,点击行弹出计划全文弹窗,模块底部展示「已执行/待审批/已废弃」三态计数(含 0 恒显);仅在有计划记录时展示;超过 3 条时默认只显示 3 条,第 3 条下方给出「展开其余 n 条计划」,展开后末行下方给出「收起」 |
|
|
53
53
|
| MCP | 接入的全部 MCP 服务及 dsh 全局启用状态;开关经 DSH 插件管理器直接启停 dsh 全局的 MCP 服务(按行写入 profile `cordis.patch.yml` 并完成热重载,即时生效、无需刷新页面、不影响其它服务) |
|
|
54
|
-
| 便笺 | 按**工作区共享**的**多条便笺**(同一工作区目录下所有会话共用同一组便笺,本地持久化,重启 DSH 后仍在;旧单便笺升级后自动迁移为「便笺1
|
|
54
|
+
| 便笺 | 按**工作区共享**的**多条便笺**(同一工作区目录下所有会话共用同一组便笺,本地持久化,重启 DSH 后仍在;旧单便笺升级后自动迁移为「便笺1」)。**便笺条列表**:每条是圆角便笺条,左侧拖动条可按住上下拖动排序,右侧悬停显示删除按钮(键盘聚焦同样显示,触屏常显);点击便笺条即可进入编辑(默认在模块内打开编辑视图;开启「在弹窗页面中进行便笺内容编辑」后改为弹窗编辑,便笺模块始终停留在列表视图);空列表显示空文案。**功能按钮**:两行——第一行「从聊天创建」「添加便笺」各占一半宽,第二行「删除全部便笺」铺满;便笺数量达到上限(HUD 设置「便笺」卡片可调,5–20,默认 5)时新建只 toast 提示;「从聊天创建」用会话输入框的文字与图片新建便笺(只复制、不清空输入框,创建后直接进入编辑视图;输入框无内容时置灰);「添加便笺」直接进入空白便笺的编辑视图;删除单条时行内把删除按钮换成取消与确认按钮(确认图标为红色对勾),点击确认后才删除;删除全部仍弹窗二次确认。**便笺内容编辑视图**:默认在模块内展开(返回按钮回列表);开启「在弹窗页面中进行便笺内容编辑」后改为弹窗编辑——右上角关闭按钮或点击弹窗外侧关闭,改动即时保存,弹窗布局与内联视图一致(标题、图片区、固定高度的内容输入框、清空 / 从聊天导入 / 添加至聊天),「添加便笺」与「从聊天创建」新建后也直接打开弹窗;标题可改(为空时自动生成「便笺n」,编号取当前列表最大「便笺n / Note n」编号 +1,删除最大编号后会复用该编号)、图片区(最多 20 张,可粘贴、点击看大图、悬浮移除,按住缩略图左右拖动可排序)、文字输入框(**不限制字数**,保留底部拖拽手柄且**所有便笺共用同一高度**)、「清空」二次确认(一次清掉文字与图片)、「从聊天导入」先清空当前便笺再写入输入框内容(便笺非空先确认,非图片附件跳过)与「添加至聊天」先清空输入框再写入便笺内容(输入框非空先确认,图片按便笺顺序加入);折叠/展开状态持久化;设置保存时允许把上限调到低于部分工作区现有便笺条数(照常保存);这类工作区已有便笺保留不变,但不能再新建便笺 |
|
|
55
55
|
| 待办 | 按**工作区共享**的待办清单(同一工作区目录下所有会话共用一份清单与顺序,本地持久化);勾选完成/恢复、点击文字即可编辑、添加/删除(删除时行内二次确认)、整行拖拽排序(拖动手柄位于行最左侧;拖动时其余条目实时让位,直观预览松手后的顺序)、一键清空已完成(二次确认,空列表置灰);底部展示完成计数;**已完成的待办统一移到列表最下方并默认折叠**(组内保持原有先后),点「展开已完成待办」查看,展开后末行下方给「收起」,拖动只在未完成区段内重排;折叠/展开状态持久化 |
|
|
56
56
|
|
|
57
57
|
**互斥协作**:HUD 面板与官方右侧栏、[dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 右侧栏互斥协作。右侧栏展开期间,HUD 面板**派生隐藏**——只是临时不可见,**不改写**该会话的展开记忆,正文也不会被额外推挤留白;关闭右侧栏后,面板按展开记忆自动恢复(除非此前手动收起过 HUD)。点击「HUD面板」按钮时若右侧栏已打开,则先自动收起侧栏再展示 HUD(若版本兼容性导致自动收起失败,面板保持隐藏,待右侧栏关闭后自动出现);新建会话页在右侧栏展开期间不显示该悬浮入口。面板配置为**左侧**时(见「HUD面板通用设置」),窄窗口下左侧会话列表的遮罩抽屉展开期间面板同样临时隐藏,关闭抽屉后自动恢复(仍不改写展开记忆)。面板外观可在「HUD面板通用设置 → HUD 面板样式」中切换:**卡片样式**(默认)保持圆角悬浮卡片;**边栏样式**下 HUD 面板通高贴边、透明无圆角,与内容区之间只留一条分隔线,模块之间的分隔线左右各缩进 14px,滚动条停在内容区右缘。
|
|
@@ -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.
|
|
65
|
+
dsh plugin --profile web add dsh-awesome-hud@0.21.0
|
|
66
66
|
|
|
67
67
|
# 2. 重启 DSH Web 服务并刷新页面
|
|
68
68
|
```
|
|
@@ -74,7 +74,7 @@ dsh plugin --profile web add dsh-awesome-hud@0.20.1
|
|
|
74
74
|
|
|
75
75
|
```bash
|
|
76
76
|
# 1. 安装(锁定版本 tag,要求本机 git 可访问 GitHub)
|
|
77
|
-
dsh plugin --profile web add "github:Ycet/dsh-awesome-hud#v0.
|
|
77
|
+
dsh plugin --profile web add "github:Ycet/dsh-awesome-hud#v0.21.0"
|
|
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.
|
|
95
|
+
dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/download/v0.21.0/dsh-awesome-hud-0.21.0.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.
|
|
107
|
+
当前版本:**0.21.0**。先完全退出 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.
|
|
111
|
+
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-awesome-hud@0.21.0
|
|
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>"
|
|
@@ -124,10 +124,10 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
|
|
|
124
124
|
- **HUD 面板**:宽度 300px,内容超出时面板内部滚动(**不展示滚动条**),面板为**常驻固定展示**(正文与输入框按侧位让位)。外观由「HUD面板通用设置 → HUD 面板样式」决定:**卡片样式**(默认)为圆角悬浮卡片,高度上限为输入框底部(留 8px 底距),与窗口边缘留 8px 间距;**边栏样式**改为通高贴边(顶部自会话页眉下沿起、底部到窗口底部、外侧不留边距;新建会话页没有页眉,顶部从右上角按钮那一行的下沿起,不留空隙),面板透明无圆角,与内容区之间只保留一条 1px 分隔线,模块之间的分隔线左右各缩进 14px(模块内容与交互不变)。展开位置由「HUD面板通用设置 → HUD 面板展开位置」决定:**右侧**(默认)贴在窗口右侧,聊天内容与输入框自动向左让位;**左侧**时贴在会话区左缘(会话列表右侧,卡片样式留 8px 间距),正文与输入框向右让位;卡片样式下页面滚动条停在窗口最右缘,边栏样式下滚动条停在内容区右缘、紧贴分隔线;会话页右缘的「轮次导航」指示条仍停在正文右缘,面板都不会与正文重叠。右侧栏展开期间面板隐藏且不推挤正文,关闭后恢复。
|
|
125
125
|
- **设置弹窗**:「会话」模块右上角齿轮打开设置弹窗,顶部是**「HUD 设置」/「使用说明」/「更新日志」三个标签**(选中项带品牌色下划线,可随时切换);设置页为**左右分栏**:中间一条分割线,左栏是模块启停与排序,右栏是模块的具体设置。
|
|
126
126
|
- **左栏**:勾选控制「上下文 / 用量 / git / 子代理任务 / 任务 / 计划清单 / MCP / 便笺 / 待办」的显隐(「会话」模块恒展示),每张卡片左侧有**拖动排序手柄**(按住拖动调整该模块在 HUD 面板中的顺序,全局生效;拖动时其余卡片实时让位预览,松手才落盘)。左栏不随右栏滚动;弹窗高度随窗口自适应并压缩卡片间距,保证 9 张模块卡片始终全部露出。**新建会话页不渲染的模块(上下文 / 子代理任务 / 任务 / 计划清单)在该页的设置里按真实状态展示、置灰不可点击**(悬浮显示原因),其开关请在会话页调整。
|
|
127
|
-
-
|
|
128
|
-
- **控件与页脚**:右栏启停项使用 DSH 官方 `Switch` 样式(`@deepseek-ai/dsh-client-ui-primitives
|
|
129
|
-
- **使用说明页**:第二个标签是内置帮助页(「HUD 设置」标签用 `assets/icons/settings-outline.svg` 的描边齿轮,「使用说明」标签用 `assets/icons/hint.svg` 的提示图标,「更新日志」标签用 `assets/icons/changelog.svg` 的更新记录图标)——左侧 240px 目录(与设置页左栏同宽,两个标签切换时分割线不跳位;点击跳到对应小节,右侧滚动时目录自动高亮),右侧 12 个分节卡片(目录项与小节标题只用文字,不再配图标):HUD 面板、会话、上下文、用量、git、产物、子代理任务、任务、计划清单、MCP、便笺、待办;每节按「展示 / 功能」分组列出简短要点——模块展示哪些信息、有哪些可操作功能(分功能点),「HUD 面板」一节另含**面板样式(卡片样式 / 边栏样式,默认卡片样式)**要点与「设置」分组讲设置弹窗内容;便笺一节含**便笺条列表 / 编辑视图 / 图片拖动排序 / 从聊天创建与导入**要点,另有「设置」分组讲**便笺条数上限(5–20,默认 5
|
|
130
|
-
- **更新日志页**:第三个标签是版本记录页,版式与说明页一致——左侧 240px 版本号目录(最新版本在最上面,点击跳到对应版本,右侧滚动时目录自动高亮),右侧每个版本一张卡片,卡片内按主题分组列出要点(如「用量:折叠与插件依赖」「便笺与待办:拖动与删除」);最新版本的标题右侧带「最新」徽标。当前收录 v0.20.1 与 v0.20.0
|
|
127
|
+
- **右栏**:五个**卡片式分区**(内容过多时只滚动这一栏)。① **「HUD面板通用设置」**:**HUD 面板样式**(卡片样式 / 边栏样式,默认卡片样式;边栏样式用一条分隔线与内容区区分)、HUD 面板展开位置(左侧 / 右侧)、新建会话页默认展示、聊天会话页默认展示(后两项只影响还没有开合记忆的页面/会话)。② **「「上下文」模块设置」**:始终显示分段进度条(默认关闭,关闭时只在悬浮进度条时显示分段)、显示「会话统计」、显示「Token 用量」、**上下文模块位置固定**(默认关闭;开启后 HUD 面板上下滚动时该模块与会话模块一样停住,仅当上下文排在模块排序首位时可开启,否则置灰并说明原因)。③ **「「用量」模块设置」**:DeepSeek 余额、OpenCode Go 用量、codex额度三行恒列出,未安装或未配置/未登录的项置灰并给出行内原因(DeepSeek 走内置官方余额源,恒可切换),另有**用量模块折叠后展示信息**下拉菜单(无 / DeepSeek余额 / opencode go 5小时·周·月额度 / codex 5小时·周额度;对应数据不可用时选项置灰,Codex 未订阅时降级展示免费额度);下拉菜单采用与 DSH 官方一致的外观(触发器 36px 高、官方材质浮层、条目 34px、选中项右侧对勾;浮层为本插件实现,层级高于设置弹窗,避免被弹窗遮挡)。④ **「git变更」模块设置**:**变更文件查看方式**(列表模式 / 文件树模式,默认列表;使用与「HUD 面板样式」相同的分段控件)。⑤ **「便笺」模块设置**:便笺条数上限(5–20,默认 5,数字步进器)、**在弹窗页面中进行便笺内容编辑**(默认关闭;开启后点击便笺条在弹窗中编辑,模块保持列表视图)。任何不可用的设置项都**整体置灰且不可点击**,名称下方的说明小字改为**红字**并写明原因(例如「需安装并启用 dsh-account-usage」「上下文模块不在模块排序首位」)。
|
|
128
|
+
- **控件与页脚**:右栏启停项使用 DSH 官方 `Switch` 样式(`@deepseek-ai/dsh-client-ui-primitives`,不可用时回退等价本地样式),「卡片样式/边栏样式」与「左侧/右侧」都使用官方分段控件。底部左侧的**「恢复默认设置」**在当前设置与默认不同时激活,点击后在**鼠标位置**弹出三项菜单:**恢复所有设置**、**恢复 hud 模块启用状态、排序**(只复位左栏)、**恢复 hud 模块功能设置**(只复位右栏:HUD 面板通用设置、上下文 / 用量 / git 变更 / 便笺模块设置);范围已是默认的菜单项置灰,选中后只改草稿,仍需点「保存设置」落盘。弹窗支持点击遮罩、右上角「关闭」或 `Esc` 关闭(关闭等同取消,不保存改动);点「保存设置」后写入并关闭(未改动时按钮置灰)。打开时焦点进入弹窗,Tab 在弹窗内循环,关闭后回到齿轮按钮。
|
|
129
|
+
- **使用说明页**:第二个标签是内置帮助页(「HUD 设置」标签用 `assets/icons/settings-outline.svg` 的描边齿轮,「使用说明」标签用 `assets/icons/hint.svg` 的提示图标,「更新日志」标签用 `assets/icons/changelog.svg` 的更新记录图标)——左侧 240px 目录(与设置页左栏同宽,两个标签切换时分割线不跳位;点击跳到对应小节,右侧滚动时目录自动高亮),右侧 12 个分节卡片(目录项与小节标题只用文字,不再配图标):HUD 面板、会话、上下文、用量、git、产物、子代理任务、任务、计划清单、MCP、便笺、待办;每节按「展示 / 功能」分组列出简短要点——模块展示哪些信息、有哪些可操作功能(分功能点),「HUD 面板」一节另含**面板样式(卡片样式 / 边栏样式,默认卡片样式)**要点与「设置」分组讲设置弹窗内容;便笺一节含**便笺条列表 / 编辑视图 / 图片拖动排序 / 从聊天创建与导入**要点,另有「设置」分组讲**便笺条数上限(5–20,默认 5)**与**在弹窗页面中进行便笺内容编辑(默认关闭)**。底部「恢复默认 / 保存设置」在说明页同样常驻(「保存设置」在本次未改动时置灰且样式与可保存态明显不同,「恢复默认」在无改动时置灰);切换标签不会丢失设置页未确认的改动,**弹窗高度也保持不变**——设置页在说明页下方保持挂载并提供高度基准,说明页以绝对定位覆盖在同一区域。
|
|
130
|
+
- **更新日志页**:第三个标签是版本记录页,版式与说明页一致——左侧 240px 版本号目录(最新版本在最上面,点击跳到对应版本,右侧滚动时目录自动高亮),右侧每个版本一张卡片,卡片内按主题分组列出要点(如「用量:折叠与插件依赖」「便笺与待办:拖动与删除」);最新版本的标题右侧带「最新」徽标。当前收录 v0.21.0、v0.20.1 与 v0.20.0 三条;**页面最多展示最新 20 个版本,更旧的版本记录会被清除**,**每次升版在页面顶部追加一条并删除第 21 条及更旧记录**(新版本必须与 `package.json` 的 `version` 一致,测试会拦漏补并校验数量上限)。底部「恢复默认 / 保存设置」同样常驻,切换标签时弹窗高度不变;页面纯展示,不发请求、不写设置。
|
|
131
131
|
- **会话模块**:工作区名称与会话名称都是悬浮变灰的可点击按钮(两者的**悬浮 / 点击热区都是整行宽度**,只让出右侧的状态胶囊与齿轮按钮),点击后在**鼠标位置**打开菜单(菜单宽度 200px,贴近视口边缘时自动夹取到视口内;面板内部滚动或窗口缩放时菜单保持原位不跳动,点击外部、按 `Esc` 或再次点击标题即可关闭)。
|
|
132
132
|
- **工作区菜单**(左上角工作区名):**重命名工作区**(原位输入框,写入 DSH 工作区注册表,官方侧栏/选择器同步更新;与其它工作区同名时给出明确提示并退回原名)、**在 Finder 中显示**(macOS 为「在 Finder 中显示」,Windows 为「在资源管理器中显示」,其余平台为「在文件夹中显示」;原生打开由宿主执行,宿主不支持时该项置灰并提示原因)、**复制工作区路径**(复制项前有分割线,与上面两项分组)。
|
|
133
133
|
- **会话菜单**(会话名称):**置顶会话 / 取消置顶**(按当前状态切换文案与图标,置顶后名称右侧显示小图钉,效果与官方侧栏一致)、**重命名**、**分支会话**(与官方一致:创建后不跳转当前页,成功以 toast 提示;需要迁移源会话时提示先打开该会话)、**复制会话 ID**、**复制会话名称**。
|
|
@@ -147,10 +147,10 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
|
|
|
147
147
|
- **reset(hard)-撤回更改**:二次确认后以 `git reset --hard` 回退并丢弃所选提交之后的提交内容,以及已跟踪文件的未提交修改;未跟踪文件不会被删除。
|
|
148
148
|
- reset 在未检出本地分支、Git 操作进行中、所选提交不在当前分支历史中或所选提交即为 HEAD 时不可用。变更文件按分组展示(状态字母按类型着色——修改 `M` 黄色、新增 `A` 蓝色、删除 `D` 红色、未跟踪 `?` 灰色,重命名 `R` / 复制 `C` 蓝色):
|
|
149
149
|
- **分组**:staged(暂存区)与 changes(未暂存区,含未跟踪)两组,组名右侧灰色数字为组内文件数,并提供一键按钮:changes 组「+」暂存全部未暂存文件、staged 组「-」取消暂存全部暂存文件;某组无文件时该组不展示
|
|
150
|
-
- **文件行操作**:**左键**点击任一文件行在右侧栏打开该文件的 diff(优先官方「第 N 轮改动」review 页;该文件不在最新一轮、官方 review 不可用或右侧栏缺失时回退 better-sidebar 的工作树 diff tab);**右键**(或键盘 Shift+F10 / 菜单键)弹出选项菜单——staged 组文件提供「remove from stage」(移出暂存区);changes 组文件提供「add to stage」(暂存该文件)与「revert」(撤销该文件变更;未跟踪新建文件与 intent-to-add 预登记文件撤销 = 删除该文件,均带二次确认与受影响文件清单)。文件行悬停 0.5
|
|
150
|
+
- **文件行操作**:**左键**点击任一文件行在右侧栏打开该文件的 diff(优先官方「第 N 轮改动」review 页;该文件不在最新一轮、官方 review 不可用或右侧栏缺失时回退 better-sidebar 的工作树 diff tab);**右键**(或键盘 Shift+F10 / 菜单键)弹出选项菜单——staged 组文件提供「remove from stage」(移出暂存区);changes 组文件提供「add to stage」(暂存该文件)与「revert」(撤销该文件变更;未跟踪新建文件与 intent-to-add 预登记文件撤销 = 删除该文件,均带二次确认与受影响文件清单)。文件行悬停 0.5 秒后在鼠标位置显示完整路径提示;悬停时行右侧的加减行数会换成图标按钮——暂存区文件显示「移出暂存区」(减号),变更区文件显示「撤销更改」(撤销图标)与「添加至暂存区」(加号),按钮下方有渐变蒙层避免压住文件名/目录;文件树模式按文件夹嵌套展示,文件夹行悬浮时对子文件批量执行同样的操作
|
|
151
151
|
- **commit**:按钮在暂存区无文件时置灰;点击弹出提交弹窗(展示待提交暂存文件数量 + 多行输入框 + AI generate + commit),输入为空时 commit 置灰;Enter 仅换行,需点击 commit 才会提交;提交范围仅为暂存区
|
|
152
152
|
- **AI generate**:固定调用 DeepSeek 官方 DeepSeek Flash 系列模型(`deepseek-account` 路由的 `deepseek-flash`,`reasoningEffort: low`),不再使用当前会话所选模型;首次点击只进入「确认?」并在按钮左侧显示说明,第二次点击才生成(3 秒内未确认自动复位,点击按钮外或按 Escape 取消),生成时按钮禁用。生成时结合暂存区全部 diff(超 16KB 截断)与当前会话最近对话上下文(用户直接消息与助手消息,供理解改动意图;若对话中用户明确指定了提交备注则直接采用),按内置本地 git 提交规范生成提交信息并填入输入框——格式 [YYMMDD] 开发项目名称 vX.Y.Z:修改内容(日期取系统当前时间;版本号依规范自动判断:破坏性变更→主版本、向后兼容新功能→次版本、修复/文档→修订号;项目名与当前版本取自工作区向上最近的 package.json);生成后自动校验版本号是否已按规范递增,不达标时自动重试一次(附上一次输出与原因反馈),仍不达标则照常填入并提示核对
|
|
153
|
-
- **revert**:按钮在无任何未暂存变更(含未跟踪)时置灰;点击后二次确认弹窗列出全部受影响文件(未跟踪文件带 `?` 前缀标识),确认后还原已跟踪文件的未暂存变更并删除未跟踪新建文件与 intent-to-add
|
|
153
|
+
- **revert**:按钮在无任何未暂存变更(含未跟踪)时置灰;点击后二次确认弹窗列出全部受影响文件(未跟踪文件带 `?` 前缀标识),确认后还原已跟踪文件的未暂存变更并删除未跟踪新建文件与 intent-to-add 预登记文件;若存在无法删除的目录条目(嵌套仓库/子模块),会明确提示并跳过,不再静默当作成功
|
|
154
154
|
- **子代理任务模块**:按层级缩进展示全部后代子代理;执行中状态徽章为**黄色**,已完成为绿色;点击条目在官方右侧栏打开对应子代理会话,保留当前主会话;嵌套子代理携带其直接父会话与会话模式。缺少侧栏接口时显示打开失败提示。
|
|
155
155
|
- **任务模块**:列表展示当前会话待办任务;进行中(in progress)任务行首为旋转动画图标(DeepSeek 官方同款,1s/圈,品牌蓝),已完成/待处理保持勾选与待办图标;模块底部展示「x 已完成 · x 进行中 · x 待处理」三态计数(含 0 恒显),标题栏保留「已完成/总数」计数。
|
|
156
156
|
- **计划清单模块**:位于「任务」模块下方,展示当前会话通过 plan 模式产出的全部计划清单(新→旧),仅在存在计划记录时展示;每 5 秒随面板打开自动刷新,状态由会话日志自动推导:
|
|
@@ -258,7 +258,9 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
|
|
|
258
258
|
| 数据来源 | 客户端会话投影(`ctx.sessions.list` / `workspaces` / `modelDirectories`)+ 自有 host API(git / MCP / 子代理 / 计划清单 / 压缩)+ dsh-account-usage 余额/用量路由(复用,缺失时回退官方 `deepseekAccount`) |
|
|
259
259
|
| 测试 | `node --test`(git 解析、MCP 解析、状态推导、计划清单推导、设置收敛、信任围栏、git 文件动作;位于 `test/`) |
|
|
260
260
|
|
|
261
|
-
## ⬆️ 升级说明(v0.11.x → v0.
|
|
261
|
+
## ⬆️ 升级说明(v0.11.x → v0.21.0)
|
|
262
|
+
|
|
263
|
+
**v0.21.0:便笺弹窗编辑、分范围恢复默认、更新日志上限与官方下拉样式**:① 新增「HUD 设置 → 便笺」的「在弹窗页面中进行便笺内容编辑」开关(默认关闭);开启后点击便笺条(整条可点,拖动条与删除按钮除外)在弹窗中编辑,便笺模块保持便笺条列表视图,「添加便笺」「从聊天创建」新建后同样直接打开弹窗;弹窗布局与内联编辑视图一致(可编辑标题、图片区、固定高度内容输入框、清空 / 从聊天导入 / 添加至聊天),点右上角关闭按钮或弹窗外侧关闭,改动照常即时保存;弹窗随 HUD 面板关闭或切换工作区一并关闭。② 「恢复默认设置」不再一键复位:点击后在鼠标位置弹出三项菜单——恢复所有设置 / 恢复 hud 模块启用状态、排序(左栏)/ 恢复 hud 模块功能设置(右栏:HUD 面板通用设置与上下文、用量、git 变更、便笺模块设置);范围已是默认的项置灰,三项都只改草稿,仍需点「保存设置」落盘(便笺与待办内容、Git commit 的 AI 生成提示词不受影响)。③ 更新日志页最多展示最新 20 个版本,更旧的版本记录从数据源删除,测试强制数量上限与首条版本号。④ 「用量模块折叠后展示信息」由原生下拉框改为与 DSH 官方一致的下拉菜单:触发器 36px 高、官方材质浮层与圆角、条目 34px、选中项右侧对勾、不可用选项置灰不可选,浮层改为本插件实现(层级高于设置弹窗,避免被弹窗遮挡),外观按官方 token 与尺寸复刻。⑤ 设置结构与兼容:`note` 段新增 `popupEdit`(默认 false,白名单收敛、坏数据回 false,旧 profile 无需迁移),旧宿主未重启时以「重启 DSH 后生效」提示。新增 `test/note-popup.test.mjs`、`test/settings-reset-menu.test.mjs`、`test/settings-dropdown.test.mjs`,并更新设置、便笺、更新日志与说明页相关用例。⑥ Git 变更文件支持悬浮操作(暂存区移出、变更区撤销/暂存,带蒙层),右键菜单图标同步改为减号/加号;新增「git变更」设置卡片与文件树查看方式(设置随 profile 持久化,重开面板/重启后仍保持),文件夹行可批量操作;移除暂存区的撤销说明文案。⑦ 产物文件行新增蓝色后缀名标签;右键菜单支持添加至聊天、在文件夹显示、复制文件名/相对路径/绝对路径。⑧ HUD 面板滚动时模块标题吸附在会话/上下文固定区下方,完全滑出后消失;卡片与边栏样式都保留模块分隔线。⑨ 更新日志的版本目录与卡片标题显示该版本更新时间。⑩ 设置 `git` 段新增 `view`(默认 list);旧宿主未重启时以「重启 DSH 后生效」提示。新增 `test/git-tree.test.mjs`、`test/git-batch.test.mjs`、`test/outputs-host.test.mjs`、`test/settings-git.test.mjs`,并扩充产物、更新日志与设置用例。修复:① 「用量模块折叠后展示信息」下拉改为本地浮层,不再被设置弹窗遮挡;② 「从聊天创建」在弹窗与内联编辑视图中都不再丢失输入框里的图片。基线:640 tests / 637 pass / 0 fail / 3 skipped。
|
|
262
264
|
|
|
263
265
|
**v0.20.1:交互精简、用量折叠展示与设置页优化**:① 待办拖动改为「松手即按最后预览提交」——拖到首位/末位后指针移出待办模块(甚至移到聊天正文)再松手也能生效;按住拖动到列表外时按指针位置继续更新落点;按 Esc 取消拖动则恢复原位。② 同样的「松手提交最后预览 + Esc 取消」语义统一到便笺条拖动与设置弹窗的模块排序。③ 修复边栏样式下会话页切到「轨迹 / 统计」时输入框被二次收窄:边栏样式不再给输入框浮层座位额外写 300px margin(座位本身已停在分隔线处),左右侧面板一致,间距与卡片样式对齐。④ 便笺模块标题右侧新增「当前条数/上限」计数(如 3/5),空列表不显示,增删后实时更新。⑤ 待办与便笺移除编辑按钮:点击待办文字 / 便笺标题即进入编辑。⑥ 待办与便笺的单条删除改为行内二次确认:删除按钮换成取消(叉号)与确认(红色对勾)按钮,点击确认后才删除;点击行外或按 Esc 取消。⑦ 便笺自动编号改为「当前列表里便笺n / Note n 的最大编号 + 1」,删除最大编号后会复用该编号(例如列表有便笺8时新建为便笺9;删掉便笺8后新建为便笺3)。⑧ 便笺上限允许调到低于部分工作区现有条数:保存照常生效,超限工作区已有便笺保留,但不能再新建便笺。⑨ 用量模块彻底移除「跳转」按钮及其设置项;新增「用量模块折叠后展示信息」下拉菜单(无(默认) / DeepSeek余额 / opencode go 5小时额度 / opencode go 周额度 / opencode go 月额度 / codex 5小时额度 / codex 周额度),折叠后在标题右侧展示「图标 + 标签 + 括号数值」,数值加粗;对应数据不可用时选项置灰,Codex 未订阅时降级展示免费额度。⑩ 设置页移除「取消」按钮;「保存设置」的置灰态与可保存态样式明显区分。⑪ Git commit 的 AI 生成逻辑调整:上下文依据为「提示词 + 暂存区变更 + 当前会话最近轮次」,按「提示词 = 暂存区变更 > 会话上下文」加权;会话上下文改为按轮次(最近 3 轮)提取,只用于理解意图,不再声明优先于 diff;用户明确指定的备注仍会作为修改内容采纳,但不再豁免日期前缀与版本号校验。⑫ 新增「更新日志」页(见上文「使用说明 → 更新日志页」):客户端常量 + 中英字典键,纯展示、不发请求;图标新增宿主资产 `assets/icons/changelog.svg` 并加入资产白名单,旧宿主未重启时以客户端内联同一 SVG 兜底,刷新即可看到图标。⑬ HUD 设置里所有**置灰设置项**的原因小字改为红字(错误色),未置灰行保持次要灰;「用量」两行的原因区分「需安装并启用插件」与「已启用但未配置/未登录」,codex 侧新增 `missing` 判定。⑭ 未启用 `dsh-account-usage` 时不展示 OpenCode Go 额度行、未启用 `dsh-codex-subscription` 时不展示 codex 额度行,对应设置项置灰且不可点击。⑮ 说明页「HUD 面板」的「设置」分组补充更新日志入口与红字原因两条要点,并修正卡片数量(四张)。新增 `test/changelog-page.test.mjs`、`test/changelog-ste.test.mjs`,更新 `settings-guide`、`settings-dialog-layout`、`usage-visibility`、`codex-transport` 等用例。基线:580 tests / 577 pass / 0 fail / 3 skipped。
|
|
264
266
|
|
|
@@ -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="1794728968172" class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" p-id="9877" xmlns:xlink="http://www.w3.org/1999/xlink" width="200" height="200"><path d="M907.6 814.2c-47.8 50.6-104.6 87.6-170.4 110.8C671.4 948.4 602 960 529 960c-69.8 0-133.4-11-190.6-33.2-57.2-22-106.2-52.8-146.6-92.2-40.6-39.4-72-86.6-94.4-141.6-22.4-55-33.4-115-33.4-180 0-64.2 12.2-123.6 36.6-178.2 24.4-54.6 57.6-102 99.8-142.2 42.2-40.2 91.4-71.6 148-94.6C404.6 75.4 465 64 529 64c55.2 0 108.8 8 160.6 24 52 16 98 40.2 138.2 72.2 40.2 32.2 72.2 72.2 96.2 120.4 24 48.2 36 104.8 36 169.8 0 48.2-6.6 90.8-20 127.6-13.4 37-31.2 67.8-53.6 92.8-22.4 25-47.8 43.6-76.6 56-28.8 12.4-59 18.6-90.6 18.6-32.4 0-58.4-7.6-78-22.8-19.4-15.2-29.2-34.6-29.2-57.8l-6 0c-12.2 19.2-30.8 37.6-56 54.8-25.2 17.2-56 26-92.6 26-55.2 0-97.8-18-127.8-54.2-30-36.2-45-83-45-141 0-33.8 5.6-67 17-100 11.4-33 27.6-62.2 48.6-88 21-25.6 46.2-46.4 75.4-62 29.2-15.6 61.6-23.4 97.4-23.4 30.8 0 56.8 6.4 78 19.2 21 12.8 34.8 28.6 41.4 47l1.2 0 9.8-48.2 108.4 0L714 522.8c-1.6 11.2-3.8 23.6-6.6 37.4-2.8 13.6-4.2 26.4-4.2 38.6 0 13.6 2.6 25 8 34.4 5.2 9.2 15.6 13.8 31 13.8 31.6 0 57.8-16.8 78.6-50.6 20.6-33.8 31-79 31-136 0-48.2-8.2-91-24.4-128.2-16.2-37.4-38.8-68.6-67.6-94-28.8-25.2-63.2-44.4-102.8-57.2-39.8-12.8-83.2-19.2-130.2-19.2-51.2 0-98 9-140.6 27s-79 43-109 74.6c-30 31.8-53.4 69-70 112C190.4 418.2 182 464.6 182 514.4c0 53 8.8 100.8 26.2 143.4 17.4 42.6 42 78.8 73.6 109 31.6 30.2 69.4 53.2 113.2 69.2 43.8 16 92.2 24 144.8 24 65.8 0 122.4-10.4 169.8-31.4 47.4-20.8 91-49.8 130.8-86.8L907.6 814.2zM526.6 376c-19.4 0-36.6 5.6-51.2 16.8-14.6 11.2-27 25.4-37.2 42.8-10.2 17.2-17.8 36.4-23.2 57.2-5.2 20.8-8 41-8 60.2 0 9.6 1 19.8 3 30.8 2 10.8 6 20.8 12.2 30.2 6 9.2 14 16.8 23.8 22.8 9.8 6 22.8 9 39 9 22 0 40.6-5.4 56-16.2 15.4-10.8 28-24.4 37.8-41 9.8-16.4 16.8-34.4 21.4-53.6 4.4-19.2 6.6-37 6.6-53 0-12.8-1.2-25.4-3.6-38-2.4-12.4-6.6-23.6-12.8-33.8-6-10-14.4-18.2-25-24.6C555 379.2 542 376 526.6 376z" p-id="9878" fill="#000000"></path></svg>
|