dsh-awesome-hud 0.19.2 → 0.20.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 +32 -25
- package/assets/icons/changelog.svg +1 -0
- package/docs/git-commit.png +0 -0
- package/docs/git-graph.png +0 -0
- package/docs/module-notes_01.png +0 -0
- package/docs/module-notes_02.png +0 -0
- package/lib/client.js +2167 -549
- package/lib/index.js +336 -103
- package/lib/settings.js +122 -12
- package/package.json +2 -2
- package/docs/module-notes.png +0 -0
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.20.1)](#️-升级说明v011x--v0201)
|
|
37
37
|
- [📄 许可证](#-许可证)
|
|
38
38
|
|
|
39
39
|
---
|
|
@@ -42,19 +42,19 @@ HUD在dsh中的效果(深色主题)
|
|
|
42
42
|
|
|
43
43
|
| 模块 | 说明 |
|
|
44
44
|
| ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
45
|
-
| 会话 | 当前工作区名称、会话名称、会话状态(任务中/待审批/空闲中/待回答/等待子任务)、模型提供商/模型名/推理等级;工作区名称与会话名称均为悬浮变灰的可点击按钮——点击在鼠标位置打开操作菜单(工作区:重命名 / 在 Finder·资源管理器中显示 / 复制路径;会话:置顶或取消置顶 / 重命名 / 分支会话 / 复制会话 ID / 复制会话名称 / 归档会话;复制类操作之前与「归档会话」之前各有一条分割线),选择重命名后名称原位变为输入框、失焦即提交(Enter 提交、Esc 取消,不再有取消/确认按钮),会话置顶后名称右侧显示小图钉;新建会话页不展示会话标题与状态;右上角「HUD 设置」打开左右分栏的设置弹窗(左栏模块启停与拖动排序,右栏「HUD
|
|
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
|
-
| 用量 | DeepSeek 余额、OpenCode Go 三个窗口用量百分比(oc-go 5h/1w/1m)与 Codex 剩余额度百分比(已订阅账号展示 5 小时/周两行;未订阅账号展示 `codex 免费额度` 单行,两类行互斥;`dsh-codex-subscription` 返回 gpt-reserve 额度时,追加展示同等样式的 `codex gpt-reserve额度` 行);行首带对应图标并缩进;「用量」模块恒定展示(可在 HUD
|
|
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
|
|
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)分组展示(组名带灰色计数,无文件的分组自动隐藏);变更文件行与「产物」一致:最左是变更状态字母,随后是**文件名**与灰色**相对目录**小字,最右保留 `+新增 / -删除` 行数;文件行左键打开右侧栏 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
|
-
| 便笺 |
|
|
55
|
-
| 待办 |
|
|
54
|
+
| 便笺 | 按**工作区共享**的**多条便笺**(同一工作区目录下所有会话共用同一组便笺,本地持久化,重启 DSH 后仍在;旧单便笺升级后自动迁移为「便笺1」)。**便笺条列表**:每条是圆角便笺条,左侧拖动条可按住上下拖动排序,右侧悬停显示删除按钮(键盘聚焦同样显示,触屏常显);点击便笺标题即可进入编辑视图;空列表显示空文案。**功能按钮**:两行——第一行「从聊天创建」「添加便笺」各占一半宽,第二行「删除全部便笺」铺满;便笺数量达到上限(HUD 设置「便笺」卡片可调,5–20,默认 5)时新建只 toast 提示;「从聊天创建」用会话输入框的文字与图片新建便笺(只复制、不清空输入框,创建后直接进入编辑视图;输入框无内容时置灰);「添加便笺」直接进入空白便笺的编辑视图;删除单条时行内把删除按钮换成取消与确认按钮(确认图标为红色对勾),点击确认后才删除;删除全部仍弹窗二次确认。**便笺内容编辑视图**:返回按钮回列表、标题可改(为空时自动生成「便笺n」,编号取当前列表最大「便笺n / Note n」编号 +1,删除最大编号后会复用该编号)、图片区(最多 20 张,可粘贴、点击看大图、悬浮移除,按住缩略图左右拖动可排序)、文字输入框(**不限制字数**,保留底部拖拽手柄且**所有便笺共用同一高度**)、「清空」二次确认(一次清掉文字与图片)、「从聊天导入」先清空当前便笺再写入输入框内容(便笺非空先确认,非图片附件跳过)与「添加至聊天」先清空输入框再写入便笺内容(输入框非空先确认,图片按便笺顺序加入);折叠/展开状态持久化;设置保存时允许把上限调到低于部分工作区现有便笺条数(照常保存);这类工作区已有便笺保留不变,但不能再新建便笺 |
|
|
55
|
+
| 待办 | 按**工作区共享**的待办清单(同一工作区目录下所有会话共用一份清单与顺序,本地持久化);勾选完成/恢复、点击文字即可编辑、添加/删除(删除时行内二次确认)、整行拖拽排序(拖动手柄位于行最左侧;拖动时其余条目实时让位,直观预览松手后的顺序)、一键清空已完成(二次确认,空列表置灰);底部展示完成计数;**已完成的待办统一移到列表最下方并默认折叠**(组内保持原有先后),点「展开已完成待办」查看,展开后末行下方给「收起」,拖动只在未完成区段内重排;折叠/展开状态持久化 |
|
|
56
56
|
|
|
57
|
-
**互斥协作**:HUD 面板与官方右侧栏、[dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 右侧栏互斥协作。右侧栏展开期间,HUD 面板**派生隐藏**——只是临时不可见,**不改写**该会话的展开记忆,正文也不会被额外推挤留白;关闭右侧栏后,面板按展开记忆自动恢复(除非此前手动收起过 HUD)。点击「HUD面板」按钮时若右侧栏已打开,则先自动收起侧栏再展示 HUD(若版本兼容性导致自动收起失败,面板保持隐藏,待右侧栏关闭后自动出现);新建会话页在右侧栏展开期间不显示该悬浮入口。面板配置为**左侧**时(见「HUD
|
|
57
|
+
**互斥协作**:HUD 面板与官方右侧栏、[dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 右侧栏互斥协作。右侧栏展开期间,HUD 面板**派生隐藏**——只是临时不可见,**不改写**该会话的展开记忆,正文也不会被额外推挤留白;关闭右侧栏后,面板按展开记忆自动恢复(除非此前手动收起过 HUD)。点击「HUD面板」按钮时若右侧栏已打开,则先自动收起侧栏再展示 HUD(若版本兼容性导致自动收起失败,面板保持隐藏,待右侧栏关闭后自动出现);新建会话页在右侧栏展开期间不显示该悬浮入口。面板配置为**左侧**时(见「HUD面板通用设置」),窄窗口下左侧会话列表的遮罩抽屉展开期间面板同样临时隐藏,关闭抽屉后自动恢复(仍不改写展开记忆)。面板外观可在「HUD面板通用设置 → HUD 面板样式」中切换:**卡片样式**(默认)保持圆角悬浮卡片;**边栏样式**下 HUD 面板通高贴边、透明无圆角,与内容区之间只留一条分隔线,模块之间的分隔线左右各缩进 14px,滚动条停在内容区右缘。
|
|
58
58
|
|
|
59
59
|
## 🚀 快速开始
|
|
60
60
|
|
|
@@ -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.20.1
|
|
66
66
|
|
|
67
67
|
# 2. 重启 DSH Web 服务并刷新页面
|
|
68
68
|
```
|
|
@@ -74,7 +74,7 @@ dsh plugin --profile web add dsh-awesome-hud@0.19.2
|
|
|
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.20.1"
|
|
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.20.1/dsh-awesome-hud-0.20.1.tgz"
|
|
96
96
|
|
|
97
97
|
# 2. 重启 DSH Web 服务并刷新页面
|
|
98
98
|
```
|
|
@@ -100,15 +100,15 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
|
|
|
100
100
|
安装完成后,聊天页右上角(「打开工作区」按钮左侧)出现「HUD面板」按钮,点击即可开合。
|
|
101
101
|
|
|
102
102
|
> [!NOTE]
|
|
103
|
-
> HUD 面板默认展开;**每个会话各自记住自己的开合状态**(按会话 id 存于 localStorage),在 A 会话收起不会影响 B 会话。**新建会话页(尚未开始的空白会话)例外**:该页每次进入都从收起状态开始(只改内存态、不写 localStorage,因此不影响任何会话的记忆),并在右上角提供独立的悬浮「HUD
|
|
103
|
+
> HUD 面板默认展开;**每个会话各自记住自己的开合状态**(按会话 id 存于 localStorage),在 A 会话收起不会影响 B 会话。**新建会话页(尚未开始的空白会话)例外**:该页每次进入都从收起状态开始(只改内存态、不写 localStorage,因此不影响任何会话的记忆),并在右上角提供独立的悬浮「HUD面板」按钮用于在该页展开(图片**大图预览**打开期间该按钮隐藏,避免浮在大图与预览关闭按钮之上)。面板样式、展开位置与模块可见性保存于 DSH profile 设置中,跨浏览器/设备随 profile 同步。
|
|
104
104
|
|
|
105
105
|
### 桌面端安装(macOS)
|
|
106
106
|
|
|
107
|
-
当前版本:**0.
|
|
107
|
+
当前版本:**0.20.1**。先完全退出 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.20.1
|
|
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>"
|
|
@@ -121,23 +121,24 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
|
|
|
121
121
|
|
|
122
122
|
## 🧭 使用说明
|
|
123
123
|
|
|
124
|
-
- **HUD 面板**:宽度 300px
|
|
125
|
-
- **设置弹窗**:「会话」模块右上角齿轮打开设置弹窗,顶部是**「HUD
|
|
124
|
+
- **HUD 面板**:宽度 300px,内容超出时面板内部滚动(**不展示滚动条**),面板为**常驻固定展示**(正文与输入框按侧位让位)。外观由「HUD面板通用设置 → HUD 面板样式」决定:**卡片样式**(默认)为圆角悬浮卡片,高度上限为输入框底部(留 8px 底距),与窗口边缘留 8px 间距;**边栏样式**改为通高贴边(顶部自会话页眉下沿起、底部到窗口底部、外侧不留边距;新建会话页没有页眉,顶部从右上角按钮那一行的下沿起,不留空隙),面板透明无圆角,与内容区之间只保留一条 1px 分隔线,模块之间的分隔线左右各缩进 14px(模块内容与交互不变)。展开位置由「HUD面板通用设置 → HUD 面板展开位置」决定:**右侧**(默认)贴在窗口右侧,聊天内容与输入框自动向左让位;**左侧**时贴在会话区左缘(会话列表右侧,卡片样式留 8px 间距),正文与输入框向右让位;卡片样式下页面滚动条停在窗口最右缘,边栏样式下滚动条停在内容区右缘、紧贴分隔线;会话页右缘的「轮次导航」指示条仍停在正文右缘,面板都不会与正文重叠。右侧栏展开期间面板隐藏且不推挤正文,关闭后恢复。
|
|
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`
|
|
127
|
+
- **右栏**:四个**卡片式分区**(内容过多时只滚动这一栏)。① **「HUD面板通用设置」**:**HUD 面板样式**(卡片样式 / 边栏样式,默认卡片样式;边栏样式用一条分隔线与内容区区分)、HUD 面板展开位置(左侧 / 右侧)、新建会话页默认展示、聊天会话页默认展示(后两项只影响还没有开合记忆的页面/会话)。② **「「上下文」模块设置」**:始终显示分段进度条(默认关闭,关闭时只在悬浮进度条时显示分段)、显示「会话统计」、显示「Token 用量」、**上下文模块位置固定**(默认关闭;开启后 HUD 面板上下滚动时该模块与会话模块一样停住,仅当上下文排在模块排序首位时可开启,否则置灰并说明原因)。③ **「「用量」模块设置」**:DeepSeek 余额、OpenCode Go 用量、codex额度三行恒列出,未安装或未配置/未登录的项置灰并给出行内原因(DeepSeek 走内置官方余额源,恒可切换),另有**用量模块折叠后展示信息**下拉菜单(无 / DeepSeek余额 / opencode go 5小时·周·月额度 / codex 5小时·周额度;对应数据不可用时选项置灰,Codex 未订阅时降级展示免费额度)。④ **「便笺」模块设置**:便笺条数上限(5–20,默认 5,数字步进器)。任何不可用的设置项都**整体置灰且不可点击**,名称下方的说明小字改为**红字**并写明原因(例如「需安装并启用 dsh-account-usage」「上下文模块不在模块排序首位」)。
|
|
128
|
+
- **控件与页脚**:右栏启停项使用 DSH 官方 `Switch` 样式(`@deepseek-ai/dsh-client-ui-primitives`,不可用时回退等价本地样式),「卡片样式/边栏样式」与「左侧/右侧」都使用官方分段控件。底部左侧的**「恢复默认」**在当前设置与默认不同时激活,可把勾选、用量行、上下文设置、面板设置与排序一并恢复默认(仍需点「保存设置」落盘)。弹窗支持点击遮罩、右上角「关闭」、「取消」或 `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.20.1 与 v0.20.0 两条,**每次升版在页面顶部追加一条**(新版本必须与 `package.json` 的 `version` 一致,测试会拦漏补)。底部「恢复默认 / 保存设置」同样常驻,切换标签时弹窗高度不变;页面纯展示,不发请求、不写设置。
|
|
130
131
|
- **会话模块**:工作区名称与会话名称都是悬浮变灰的可点击按钮(两者的**悬浮 / 点击热区都是整行宽度**,只让出右侧的状态胶囊与齿轮按钮),点击后在**鼠标位置**打开菜单(菜单宽度 200px,贴近视口边缘时自动夹取到视口内;面板内部滚动或窗口缩放时菜单保持原位不跳动,点击外部、按 `Esc` 或再次点击标题即可关闭)。
|
|
131
132
|
- **工作区菜单**(左上角工作区名):**重命名工作区**(原位输入框,写入 DSH 工作区注册表,官方侧栏/选择器同步更新;与其它工作区同名时给出明确提示并退回原名)、**在 Finder 中显示**(macOS 为「在 Finder 中显示」,Windows 为「在资源管理器中显示」,其余平台为「在文件夹中显示」;原生打开由宿主执行,宿主不支持时该项置灰并提示原因)、**复制工作区路径**(复制项前有分割线,与上面两项分组)。
|
|
132
133
|
- **会话菜单**(会话名称):**置顶会话 / 取消置顶**(按当前状态切换文案与图标,置顶后名称右侧显示小图钉,效果与官方侧栏一致)、**重命名**、**分支会话**(与官方一致:创建后不跳转当前页,成功以 toast 提示;需要迁移源会话时提示先打开该会话)、**复制会话 ID**、**复制会话名称**。
|
|
133
134
|
- **内联改名**:点击「重命名」后名称原位变为输入框并自动全选,**点击其他区域即提交**(也支持 Enter 提交、Esc 取消);内容空白或未改动时不发请求,失败时退回原名并 toast 报错。新建会话页不展示会话标题与状态徽标,工作区菜单在该页同样可用(作用于推导出的目标工作区)。
|
|
134
135
|
- **上下文**:标题右侧按「当前占用 / 最大上下文(占用率)」展示,例如 `199K / 1M(19.9%)`;进度条默认单色(0–40% 绿 / 40–90% 黄 / >90% 红),鼠标悬浮时切换为三段式并弹出 breakdown 提示(System prompt 石青色、Tool definitions 紫色、Messages 蓝色,数值为估算 token);底部两行分别是会话统计(轮数/步数 · tok/s)与 Token 用量(总量 · 缓存命中),悬浮时分别显示完整统计(模型用时、工具调用用时、首 token 平均、输出速度)和完整用量(缓存命中、未缓存输入、缓存读取、缓存写入、输出)。「压缩」在会话空闲时可用,运行中按钮禁用并提示原因;进度条常显分段、两行统计/用量的显隐可在 HUD 设置的「上下文」卡片中调整。
|
|
135
136
|
- **用量模块**:位于「上下文」模块下方,**恒定展示**(仍可在 HUD 设置中关闭)。DeepSeek 余额优先复用 dsh-account-usage 插件路由、未安装/未启用时回退 DSH 官方账户服务;Codex 复用 dsh-codex-subscription 的浏览器 RPC;面板打开时立即加载、之后每 60 秒轮询;数据均缩进展示并带对应图标;模块支持折叠,默认展开(折叠状态经 localStorage 持久化)。
|
|
136
|
-
- **DeepSeek 余额**:展示余额合计(充值 +
|
|
137
|
+
- **DeepSeek 余额**:展示余额合计(充值 + 赠送),**点击具体余额数值**可直接打开设置面板并进入「账号与余额」页(官方页不可用(未登录/旧版)时回退到「账户」分区),有 dsh-account-usage 页签时切换到 deepseek 页签、没有页签时静默停留在官方账户页。该行**始终展示**:优先使用 dsh-account-usage(需配置 `DEEPSEEK_PLATFORM_TOKEN`),未安装/未启用时回退 DSH 官方账户服务(需登录 DeepSeek 账号);无数据时数值显示 `—`,点击行为不变。
|
|
137
138
|
- **OpenCode Go 用量**:三行分别展示 oc-go 5h / 1w / 1m 窗口用量**百分比**,**点击具体百分比数值**可直接打开设置面板并进入「账号与余额」页,切换到 opencode go 页签;仅当已配置 OpenCode Go Key 且订阅有效(`/api/account-usage/opencode` 返回 `ok + keySource`)时展示,无数据时整组不渲染(不可点击)。
|
|
138
139
|
- **Codex 额度**:订阅账号展示 `codex 5h额度` 与 `codex 周额度` 两条**剩余额度整数百分比**;未订阅(免费)账号的 codex 额度只返回一个约 30 天的月度窗口,此时改为展示一条 `codex 免费额度` 行(取该窗口剩余百分比),**不再展示 5h / 周额度**——两类行互斥。订阅状态按**额度窗口形状**判定(出现 5h 或周窗口即视为已订阅),因为订阅插件的 RPC 不暴露套餐字段;月度窗口时长与预期不符时回退该额度首个可用窗口,保证有数据就不显示 `—`。三行均使用 ChatGPT 图标,**点击百分比数值**打开「设置:Codex 订阅」页面。仅当安装并登录 `dsh-codex-subscription` 时展示;已登录但额度请求暂时失败时**按上一次的展示模式**保留行并显示 `—`(订阅账号不会因此误显示为免费额度行),无法确认安装/登录状态时隐藏。
|
|
139
140
|
- **gpt-reserve 额度**:`dsh-codex-subscription` 返回 `gpt-reserve` 额度(`/wham/usage` 的 `additional_rate_limits` → `rateLimits` 中 `id` 为 `base_model_inference`、`limit_name`/`name` 为 `gpt-reserve`;插件按 **id 或 name** 归一化匹配,忽略大小写、下划线、连字符与空格)时,在 5h / 周额度(未订阅时为免费额度)下方追加 `codex gpt-reserve额度` 行,样式、图标与交互与既有额度行完全一致(取其主窗口剩余百分比;额度带名称时显示为「codex gpt-reserve额度(名称)」)。该额度不存在时**不展示该行**;存在但窗口数据异常时保留行并显示 `—`。
|
|
140
|
-
- **模块可见性与可配置内容**:模块恒定展示;DeepSeek 余额行始终展示(数据来自 dsh-account-usage 或官方账户兜底,无数据时显示 `—`),OpenCode Go 与 Codex
|
|
141
|
+
- **模块可见性与可配置内容**:模块恒定展示;DeepSeek 余额行始终展示(数据来自 dsh-account-usage 或官方账户兜底,无数据时显示 `—`),OpenCode Go 与 Codex 仅在其数据源可用时渲染对应行——**没有启用 `dsh-account-usage` 就不展示 OpenCode Go 额度,没有启用 `dsh-codex-subscription` 就不展示 codex 额度**;这两项的开关在设置页里同时置灰、不可点击,原因以红字写在名称下方(区分「需安装并启用插件」与「已启用但未配置/未登录」)。全部无数据时模块内显示一行接入提示。展示内容与折叠后展示信息可在「「用量」模块设置」卡片中配置(host settings 持久化,随 profile 同步)。
|
|
141
142
|
- **git 模块**:常驻展示——新建会话页与会话页都默认展示,工作区不是 git 仓库时也展示(标题栏右侧提供「初始化仓库」按钮,位置与分支按钮相同;点击后在该工作区执行 `git init`,成功后模块切换为仓库态:按钮变为分支按钮,正文出现动作区与变更统计,并由随后的轮询保持刷新;已是仓库时该按钮不出现)。每 5 秒随面板打开自动刷新(写操作后立即刷新);标题栏右侧分支按钮点击弹出下拉列表——可切换已有分支(当前分支高亮带勾标记;点击当前分支会提示「当前已在分支」而非静默关闭),或在输入框中输入新分支名点击「添加」创建并自动切换;「git graph」弹窗按每页最多 80 条分页展示当前仓库(全部引用)提交图(滑到列表底部出现「加载更多」按钮点击追加下一页,全部加载完后底部显示「已显示全部提交」提示);分支标签中,当前分支为蓝底白字,其他分支为灰底黑字;HEAD 指向版本以放大的白色填充圆点 + 蓝色描边标记。提交行右键菜单可复制短哈希(前 7 位)/全哈希(40 位)/提交标题,并提供以下受保护操作:
|
|
142
143
|
- **从此处创建分支**:点击后**原菜单项位置**展开为输入框 + 「取消」/「确认」图标按钮(输入框为空时确认按钮置灰)。输入合法分支名并点击确认后,以该提交为起点执行 `git checkout -b <名称> <提交>` 并切换到新分支:成功提示后菜单关闭、git 快照与提交图刷新,新分支标签随即显示为蓝底当前分支。分支名重复、或本地修改会阻止切换时给出提示(后者列出受影响文件)并**保留输入内容**,便于改名重试;不自动 stash、不强制切换。输入框内按 Enter 不触发创建,按 Escape 取消输入并恢复为原菜单项(再按一次关闭菜单);Git 操作(merge / rebase / cherry-pick / revert)进行中时该项置灰。
|
|
143
144
|
- **合并至当前分支**:先在原菜单项位置显示行内「确认?/取消」,确认后执行 `git merge --no-edit`;已包含提示「无需合并」、本地修改阻塞提示受影响文件、合并冲突自动 `git merge --abort` 回滚并列出冲突文件清单。
|
|
@@ -159,7 +160,7 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
|
|
|
159
160
|
- 行主文字取计划首个 Markdown 标题,无标题时截取正文;点击任一行弹出计划全文弹窗(标题、状态、产出时间与正文,正文按轻量 Markdown 渲染,支持标题/列表/代码块/链接/引用与 GFM 表格);模块底部展示「x 已执行 · x 待审批 · x 已废弃」三态计数(含 0 恒显);模块可折叠,默认展开。
|
|
160
161
|
- **MCP 模块**:开关控制 dsh 全局的 MCP 服务启停——经 DSH 官方插件管理器 `pluginManager.setPluginEnabled` 按行写入 profile `cordis.patch.yml` 并等待热重载完成,开关即时生效、无需刷新页面,只改目标服务、不改动其它插件配置;未启用 HMR 的 profile 会提示「重启后生效」;模块默认展开,无任何 MCP 服务时仍展示空状态。
|
|
161
162
|
- **便笺模块**:按**工作区共享**的便笺——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用一份内容与图片,含输入框高度),文字存 `localStorage`、图片以原图存 IndexedDB,重启 DSH 后依旧存在;删除或归档其中任一/全部会话都不影响该工作区其它会话的内容,下次在同一工作区新建会话时内容与图片依旧存在。输入框底部拖拽手柄可拖拽调整高度(实时持久化);**不限制字数**,底部也不再显示字数与图片张数。**图片**:直接在输入框里粘贴(`image/*`,最多 20 张;字节上限沿用宿主的会话内附件校验),缩略图在输入框上方横向滚动,点击看大图(Esc / 遮罩 / 关闭按钮退出),鼠标悬浮缩略图右上角出现移除按钮(触屏常显);「清空」或移除都会释放对应原图。**从聊天导入**(位于「添加至聊天」左侧):先清空便笺里的文字与图片(旧原图一并释放并删除 IndexedDB 记录),再写入当前会话/新建会话页输入框里的文字与图片,便笺非空时先弹确认,非图片附件会跳过并提示;输入框内容不清除,输入框为空时按钮置灰、只提示且不清空便笺。**添加至聊天**:先清空会话输入框里的文字与图片(逐个移除并释放旧附件),再写入便笺文字并按便笺顺序加入图片;输入框非空时先确认,为空则直接写入,成功后焦点回到输入框;便笺内容保留;清空后写入失败不回滚(保持已清空 + 已写入部分并提示)。有文字或图片时「清空」可用:首次点击进入红色确认态,二次点击后同时清掉文字与图片(点击其他区域、Escape 或 2 秒超时会取消)。模块可折叠/展开(状态持久化)。未归属工作区(无 cwd)的会话降级为会话级隔离,不与其它会话共享。
|
|
162
|
-
- **待办模块**:按**工作区共享**的待办清单——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用同一份清单与顺序,本地持久化);每条待办为**卡片式**(1px 描边 + 浅底 + 10px 圆角,与「HUD 设置」里的模块卡片同款,行距 6px
|
|
163
|
+
- **待办模块**:按**工作区共享**的待办清单——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用同一份清单与顺序,本地持久化);每条待办为**卡片式**(1px 描边 + 浅底 + 10px 圆角,与「HUD 设置」里的模块卡片同款,行距 6px),**删除按钮默认隐藏,鼠标悬浮该行时才出现,键盘聚焦(`:focus-visible`)也会显示;点击条目文字即可编辑,删除时行内二次确认**(两者改为**绝对定位浮层**:文字独占整行宽度,悬浮时浮层以行底色实底铺在行右端、左侧 16px 渐隐把文字淡出,既不会被挤窄、也不会重新换行;触屏等无 hover 环境按钮常显并给文字留出右侧避让;鼠标拖动后不会再滞留);勾选完成/恢复、添加/删除项、整行拖拽排序(拖动手柄位于行最左侧勾选框之前,**手柄热区覆盖整行高度**,多行条目也能整列拖起;拖动时其余条目按真实行高实时让位,松手才保存顺序)、一键清空已完成(二次确认弹窗,无已完成项时按钮置灰);底部展示完成计数;模块可折叠/展开(状态持久化)。同一工作区多会话/多标签页同时编辑时按条目 id 归并,不会互相清空。
|
|
163
164
|
- **折叠状态**:各模块折叠/展开状态刷新页面后保持(localStorage);「会话」模块图标使用 DSH favicon。
|
|
164
165
|
- **新建会话页**:右上角提供独立悬浮「HUD面板」按钮(该页没有会话页眉;Windows 普通窗口中入口位于原生标题栏下方,全屏时取消该偏移)。该入口与聊天会话页保持同一顺序:始终排在右侧工具按钮簇左侧(装有 better-sidebar 时,其「底部面板」切换按钮排在入口右侧、两个页面的间距一致)——这让两个页面的入口位置看起来完全相同。**图片大图预览打开时该按钮隐藏**——预览是铺满视口的模态浮层(`role="dialog"` + `aria-modal`,如 `dsh-codex-subscription` 的图片查看器),而 HUD 入口的层级远高于它,不隐藏就会浮在大图与右上角预览关闭按钮之上;预览关闭后按钮自动恢复,面板开合状态不受影响(判定只看浮层语义与视口覆盖率,不绑定第三方类名)。该页每次进入都从收起状态开始,点击按钮后展开;面板固定贴右侧、宽 300px,输入框与正文左移让位,按钮保持原位。官方右侧栏(含 better-sidebar)展开期间,该悬浮入口与面板一并隐藏——入口不再移到侧栏左侧,也不再把展开态面板的位置写进定位;关闭侧栏后入口**立即出现在打开侧栏前的位置**,不会先闪到侧栏边缘,并回到该页此前的开合状态(除非已手动收起 HUD)。新建页的 Git、便笺、待办和便笺发送目标使用同一最近工作区;MCP 作为全局模块独立刷新,无会话或工作区时也可查看和启停。该页展示会话 / 用量 / git / 便笺 / 待办 / MCP 模块(git 常驻,目标工作区不是仓库时提供「初始化仓库」;「用量」模块恒定展示,DeepSeek 余额无数据时显示 `—`);尚无会话记录时不展示会话标题与状态徽标(工作区标题菜单照常可用)。进入真实会话后加载该会话自己的开合记忆,标题栏原按钮接管入口。
|
|
165
166
|
|
|
@@ -205,7 +206,9 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
|
|
|
205
206
|
|
|
206
207
|
#### 「便笺」模块
|
|
207
208
|
|
|
208
|
-

|
|
210
|
+
|
|
211
|
+

|
|
209
212
|
|
|
210
213
|
#### 「待办」模块
|
|
211
214
|
|
|
@@ -255,7 +258,11 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
|
|
|
255
258
|
| 数据来源 | 客户端会话投影(`ctx.sessions.list` / `workspaces` / `modelDirectories`)+ 自有 host API(git / MCP / 子代理 / 计划清单 / 压缩)+ dsh-account-usage 余额/用量路由(复用,缺失时回退官方 `deepseekAccount`) |
|
|
256
259
|
| 测试 | `node --test`(git 解析、MCP 解析、状态推导、计划清单推导、设置收敛、信任围栏、git 文件动作;位于 `test/`) |
|
|
257
260
|
|
|
258
|
-
## ⬆️ 升级说明(v0.11.x → v0.
|
|
261
|
+
## ⬆️ 升级说明(v0.11.x → v0.20.1)
|
|
262
|
+
|
|
263
|
+
**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
|
+
|
|
265
|
+
**v0.20.0:新增「HUD 面板样式」(卡片样式 / 边栏样式,默认卡片样式)**:① 「HUD 设置 → HUD面板通用设置」在「HUD 面板展开位置」**上方**新增「HUD 面板样式」一行,用官方分段控件在**卡片样式 / 边栏样式**之间切换;默认**卡片样式**,升级后外观与 0.19.2 完全一致(不需要迁移任何 profile)。② **卡片样式**沿用原设计:圆角悬浮卡片、与窗口边缘 8px 间距、高度上限为输入框底部、页面滚动条停在窗口最右缘。③ **边栏样式**不再用圆角卡片与页面区分:面板转为**通高贴边**(顶部自会话页眉下沿起、底部到窗口底部、外侧不留边距;新建会话页从右上角按钮那一行下沿起,不会在面板上方留空隙),透明底、无圆角、无外描边,只在朝向会话正文的一侧画一条 1px 分隔线(`--dsw-alias-border-l2`,深浅主题自适应);面板内部各模块之间的分隔线保持原有浅色,但左右各**缩进 14px**,不再从头切到尾;模块内容、交互与宽度(300px)完全不变。④ 边栏样式下正文与输入框仍让位 300px,但不再把滚动容器补回窗口右缘——页面滚动条改停在内容区右缘、紧贴分隔线,避免面板贴边后压住滚动条;切回卡片样式即恢复原行为。⑤ 样式随「确认」立即生效并写入 profile 设置(`panel.style`),跨刷新/重启保持;旧宿主(响应无 `style` 字段)沿用浏览器镜像,不会把用户选择打回默认。⑥ 「使用说明」页「HUD 面板」一节新增面板样式要点并同步修正相关句子;中英 README 同步更新(不新增截图)。⑦ 新增 `test/panel-style.test.mjs` 覆盖 schema 默认值、收敛/白名单、镜像与旧宿主兼容、两种样式的几何与顶部起算(含新建会话页)、滚动条补偿、CSS 变体、设置行顺序与说明页文案。⑧ 修正新建会话页边栏样式的顶部起点:该页没有会话页眉,原先沿用卡片样式的 52px 基线,会在面板上方留下一条空隙;现在改为从右上角按钮那一行(悬浮「HUD面板」入口所在行)的下沿起算,既无空隙也不遮挡入口。⑨ 「产物」模块的文件行改为向右缩进(与模块标题文字对齐),并在鼠标于文件行上停留 0.5 秒后,在鼠标位置显示该文件的完整相对路径(与 git 变更文件行共用同一套路径提示样式)。⑩ git 模块的变更文件行改为与「产物」一致的两段式展示:最左保留变更状态字母,文件名在前、右侧是灰色相对目录小字,最右保留 `+新增 / -删除` 行数(目录为空时仍保留弹性占位,加减行数继续靠右)。⑪ Git commit 弹窗顶部新增默认折叠的「AI 生成提示词」区域:展开后展示内置默认提示词,可编辑并保存,保存后「generate」按新提示词生成;支持恢复默认;模板占位符 `{{spec}}`、`{{today}}`、`{{project}}`、`{{sessionContext}}` 由宿主注入,暂存区 diff 仍自动附加;**自定义提示词会完整接管生成指令并跳过默认的日期前缀与版本号校验**(默认提示词保留原有保障),生成指令已全部移入可编辑模板、用户消息只携带 diff;提示词保存在 profile 设置(`commitPrompt`),跨重启有效,旧宿主则仅本次运行有效;新增 `test/commit-prompt.test.mjs` 覆盖模板渲染、收敛、schema 默认值、生成链路接线、自定义/默认两条生成路径与弹窗交互(折叠/回填/保存/恢复/失败提示)。⑫ 便笺模块改为**多条便笺**:便笺条列表(拖动排序 / 悬停编辑与删除 / 空态)、两行功能按钮(从聊天创建 / 添加便笺 / 删除全部便笺)、便笺内容编辑视图(返回 / 可改标题 / 图片拖动排序 / 共用高度 / 清空 / 导入 / 添加至聊天);旧单便笺自动迁移为「便笺1」;HUD 设置新增「便笺」卡片(条数上限 5–20,默认 5,数字步进器),超限新建只 toast,调低上限导致工作区超限时整次保存被拒绝并指出工作区。⑬ 「产物」模块数据源扩展:在 DSH 每轮 `workspaceChanges` 摘要之外,**扫描工作区**按最后修改时间收录 16 种扩展名的文件,因此**终端命令**(python / npm / 编译器…)产生的改动也会出现;筛选基准是会话创建时间,**重启 DSH 后列表仍保留**(不再依赖 Host 进程内缓存)。同时修复 HUD 设置页「确认」按钮的保存问题:底部按钮改为**「保存设置」**,本次打开设置页后**未改动时置灰**;便笺上限校验只在本次真的调整了上限时执行(之前任何保存都会被已有便笺条数误拦截,导致既不能保存也不能关闭弹窗)。「上下文」「用量」两组设置行补充简短说明文案;便笺拖动时被拖动项移动到落点展示「站位」,图片拖动结束后不再误触大图预览;便笺覆盖确认(添加至聊天 / 从聊天导入)改用红色危险按钮。基线:562 tests / 559 pass / 0 fail / 3 skipped。
|
|
259
266
|
|
|
260
267
|
**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。
|
|
261
268
|
|
|
@@ -272,7 +279,7 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
|
|
|
272
279
|
|
|
273
280
|
**v0.18.3:修复面板重新挂载后设置回退**:① 面板在切页面(会话页 ↔ 新建会话页)、手动关开面板、开合官方右侧栏时都会**重新挂载**;旧实现把「页面加载时读到的那份设置」整页缓存并复用,重挂后会把这期间的改动回退掉——表现为「刚关掉的『跳转』按钮又出现」「面板位置从左侧回到右侧」。现在重挂时**每次都重新读取宿主设置**,只用「最近一次成功读/写」的快照渲染首帧(既不闪旧值,也不会回退)。② 同一份首帧种子也让模块勾选、上下文设置、模块顺序在重挂后立即保持最新,不再出现一帧旧状态。③ 对旧宿主(`usage` 里没有 `showJump`)做缺键兼容:重启宿主前也会保留本次运行内对「跳转」按钮的选择。④ 读取设置失败时不再把已确认的设置重置为默认值(保留最近一次成功快照)。新增 `test/settings-refresh.test.mjs` 五条回归(重挂后重新读取、写入后首帧即新值、宿主权威值覆盖、旧宿主缺键兼容、写入失败不污染快照),在旧实现上其中四条必失败。中英文 README 同步更新。测试基线:418 tests / 415 pass / 0 fail / 3 skipped。
|
|
274
281
|
|
|
275
|
-
**v0.18.2:HUD 设置左右分栏、面板可放左侧与用量跳转开关**:① 「HUD 设置」改为**左右分栏**——左栏是模块启停与拖动排序(列宽固定、不跟随滚动),右栏是模块的具体设置,中间以 1px 分割线分开;弹窗宽度放宽到 760px,高度随窗口自适应并压缩卡片间距,保证 9 张模块卡片全部露出,内容过多时只滚动右栏。② 右栏改为三个**卡片式分区**:「HUD面板通用设置」、「「上下文」模块设置」、「「用量」模块设置」,启停项统一改用 DSH 官方 `Switch` 样式(`@deepseek-ai/dsh-client-ui-primitives
|
|
282
|
+
**v0.18.2:HUD 设置左右分栏、面板可放左侧与用量跳转开关**:① 「HUD 设置」改为**左右分栏**——左栏是模块启停与拖动排序(列宽固定、不跟随滚动),右栏是模块的具体设置,中间以 1px 分割线分开;弹窗宽度放宽到 760px,高度随窗口自适应并压缩卡片间距,保证 9 张模块卡片全部露出,内容过多时只滚动右栏。② 右栏改为三个**卡片式分区**:「HUD面板通用设置」、「「上下文」模块设置」、「「用量」模块设置」,启停项统一改用 DSH 官方 `Switch` 样式(`@deepseek-ai/dsh-client-ui-primitives`,缺失时回退等价本地样式),「卡片样式/边栏样式」与「左侧/右侧」都使用官方分段控件。③ 新增**HUD 面板展开位置**设置(单一全局项,默认右侧):选左侧时面板贴会话区左缘 8px,正文与输入框**镜像向右让位**,滚动条仍在窗口最右缘,窄窗口下左侧会话列表的遮罩抽屉展开期间面板临时隐藏。④ 新增「新建会话页默认展示」「聊天会话页默认展示」两项,只影响还没有开合记忆的页面/会话,已有记忆永不覆盖。⑤ 「用量」设置新增**展示「跳转」按钮**(默认启用),并让三项用量数据恒列出——未安装 dsh-account-usage / dsh-codex-subscription 或未配置、未登录时对应项置灰并给出行内原因。⑥ 面板位置与默认开合在 localStorage 保留首帧镜像,宿主设置为权威值;旧宿主(无 `panel` 设置)时面板项仍可用但提示重启 DSH 后再持久化。中英文 README 同步更新。测试基线:413 tests / 410 pass / 0 fail / 3 skipped。
|
|
276
283
|
|
|
277
284
|
**v0.18.1:工作区/会话标题悬浮菜单与内联改名**:① 「会话」模块的**工作区名称**改为可交互区域:鼠标悬浮显示灰色背景,点击在鼠标位置打开菜单(重命名工作区、在 Finder/资源管理器中显示、复制工作区路径),菜单在面板滚动或窗口缩放时保持原位,点击外部或按 `Esc` 关闭。② **会话名称**同样改为悬浮可点击:菜单包含置顶/取消置顶(按当前状态切换文案与图标)、重命名、分支会话、复制会话 ID、复制会话名称;置顶后名称右侧显示小图钉,分支会话与官方一致不跳转当前页并以 toast 提示。③ 两处**重命名改为原位内联输入**:点击「重命名」后名称位置变为输入框并全选文本,**失焦即提交**(Enter 提交、Esc 取消,空白或未改动不发请求),不再展示取消/确认按钮;改名失败退回原名并提示,工作区改名会同步到官方侧栏(同名冲突给出明确提示)。④ 新建会话页**不再展示会话标题与状态徽标**,工作区标题菜单在该页照常可用。⑤ 图标使用 DSH 官方图标(`@deepseek-ai/dsh-client-ui-primitives`),不新增资产;能力缺失(未注册工作区、宿主不支持原生打开、客户端服务缺失)时菜单照常开、对应项置灰并给出原因。中英文 README 同步更新。测试基线:387 tests / 384 pass / 0 fail / 3 skipped。
|
|
278
285
|
|
|
@@ -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 class="icon" viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><path d="M829.952 65.536H196.608c-60.928 0-116.224 51.2-116.224 112.128v668.672c0 58.88 49.152 112.128 116.224 112.128h633.344c62.976 0 116.224-49.152 116.224-112.128V177.664c0-55.296-65.024-112.128-116.224-112.128z m58.88 780.8c0 31.232-25.6 55.296-56.832 55.296H204.288c-31.232 0-56.832-25.6-56.832-55.296V183.296c0-31.232 25.6-56.832 56.832-56.832H312.32v391.68l116.224-112.128 116.224 112.128V126.464h289.28c31.232 0 56.832 25.6 56.832 55.296v665.088h-2.048z" fill="currentColor"></path></svg>
|
package/docs/git-commit.png
CHANGED
|
Binary file
|
package/docs/git-graph.png
CHANGED
|
Binary file
|
|
Binary file
|
|
Binary file
|