dsh-awesome-hud 0.21.1 → 0.21.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
@@ -1,60 +1,213 @@
1
- # dsh-awesome-hud
2
-
3
- [![简体中文](https://img.shields.io/badge/简体中文-red?style=for-the-badge)](README.md)
4
- [![English](https://img.shields.io/badge/English-blue?style=for-the-badge)](README_en.md)
5
-
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)
8
-
9
1
  <p align="center">
10
- <img src="icon.png" width="96" height="96" alt="dsh-awesome-hud 图标">
2
+ <img src="icon.png" width="96" height="96" alt="dsh-awesome-hud 插件图标">
11
3
  </p>
12
4
 
13
- 为 DeepSeek Harness Web / 桌面端聊天页打造的悬浮 HUD 面板:会话状态、上下文占用与一键压缩、git 变更、子代理、任务与 MCP 启停,一目了然。
5
+ <p align="center">
6
+ <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge" alt="License: MIT"></a>
7
+ <a href="https://www.npmjs.com/package/dsh-awesome-hud"><img src="https://img.shields.io/npm/v/dsh-awesome-hud?style=for-the-badge&amp;logo=npm" alt="npm version"></a>
8
+ <a href="https://www.npmjs.com/package/dsh-awesome-hud"><img src="https://img.shields.io/badge/DSH-%E2%89%A5%200.2.1--rc.2-4d6bfe?style=for-the-badge" alt="DeepSeek Harness"></a>
9
+ </p>
14
10
 
15
- HUD在dsh中的效果(浅色主题)
11
+ <p align="center">
12
+ <a href="README.md"><img src="https://img.shields.io/badge/简体中文-red?style=for-the-badge" alt="简体中文"></a>
13
+ <a href="README_en.md"><img src="https://img.shields.io/badge/English-blue?style=for-the-badge" alt="English"></a>
14
+ </p>
16
15
 
17
- ![alt text](docs/hud-light.png)
16
+ # dsh-awesome-hud
18
17
 
19
- HUD在dsh中的效果(深色主题)
18
+ 为 DeepSeek Harness Web / 桌面端的聊天页加一块悬浮 HUD 面板:会话状态、上下文占用与一键压缩、Git 变更、子代理、任务与 MCP 启停,一屏看全。
20
19
 
21
- ![alt text](docs/hud-dark.png)
20
+ > 点击会话页右上角的「HUD面板」开合面板。面板与官方右侧栏、[dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 右侧栏互斥协作:侧栏展开时面板临时让位,不遮挡也不额外挤压正文。
22
21
 
23
22
  ---
24
23
 
25
- > [!NOTE]
26
- > 一个 DSH Web 插件(`dsh.bundle.patch` 通道安装)。浏览页面右上角新增「HUD面板」按钮,点击开合悬浮面板;面板与官方右侧栏及 [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 右侧栏互斥协作,互不遮挡、不额外挤占正文。
27
-
28
24
  ## 📑 目录
29
25
 
30
- - [✨ 功能列表](#-功能列表)
26
+ 点击跳转到对应章节。
27
+
28
+ - [🖼️ 界面效果](#️-界面效果)
29
+ - [✨ 功能总览](#-功能总览)
30
+ - [🧩 模块与页面](#-模块与页面)
31
+ - [⚙️ HUD 设置与面板行为](#️-hud-设置与面板行为)
31
32
  - [🚀 快速开始](#-快速开始)
32
- - [🧭 使用说明](#-使用说明)
33
- - [🖼️ 界面截图](#️-界面截图)
34
33
  - [⚙️ 兼容性](#️-兼容性)
35
34
  - [🔧 技术栈](#-技术栈)
36
- - [⬆️ 升级说明(v0.11.x → v0.21.1)](#️-升级说明v011x--v0211)
35
+ - [🧪 开发与测试](#-开发与测试)
36
+ - [🔗 关联插件](#-关联插件)
37
+ - [⬆️ 升级说明(v0.11.x → v0.21.2)](#️-升级说明v011x--v0212)
37
38
  - [📄 许可证](#-许可证)
38
39
 
39
40
  ---
40
41
 
41
- ## ✨ 功能列表
42
+ ## 🖼️ 界面效果
43
+
44
+ **浅色主题**
45
+
46
+ ![HUD 面板在浅色主题下的效果](docs/hud-light.png)
47
+
48
+ **深色主题**
49
+
50
+ ![HUD 面板在深色主题下的效果](docs/hud-dark.png)
51
+
52
+ ---
53
+
54
+ ## ✨ 功能总览
55
+
56
+ | 模块 | 你能看到 / 能做什么 |
57
+ | --- | --- |
58
+ | 会话 | 工作区与会话名称、运行状态、模型与思考等级标签;菜单里重命名、置顶、分支、归档、复制。 |
59
+ | 上下文 | 占用率与进度条、会话统计与 Token 用量;一键压缩,或派子代理写交接文档。 |
60
+ | 用量 | DeepSeek 余额、OpenCode Go 额度、Codex 额度;折叠后在标题展示其中一项。 |
61
+ | 产物 | 本会话改动过的文档 / 表格 / 演示 / 图片;点击预览,右键加入聊天或复制路径。 |
62
+ | Git | 分支与变更数量、暂存与未暂存分组、diff、commit(含 AI 生成提交信息)、git graph。 |
63
+ | 任务 | 会话任务清单与完成状态,随任务变化实时刷新。 |
64
+ | 子代理任务 | 当前会话的子代理层级与状态,点击在右侧栏打开该子代理会话。 |
65
+ | 计划清单 | plan 模式产出的计划与三种状态,点击查看计划全文。 |
66
+ | 便笺 | 按工作区共享的多条便笺,支持图片、拖动排序、导入与发送到聊天输入框。 |
67
+ | 待办 | 按工作区共享的待办清单,勾选、编辑、拖动排序、清空已完成。 |
68
+ | MCP | 已接入的 MCP 服务与全局启停开关。 |
69
+
70
+ 面板另提供:**模块折叠与置顶**、**卡片 / 边栏两种面板样式**、**左 / 右两种展开位置**、**内置使用说明页与更新日志页**。
71
+
72
+ ---
73
+
74
+ ## 🧩 模块与页面
75
+
76
+ ### 会话模块
77
+
78
+ 显示工作区名称、会话名称、会话状态,以及合并成一个标签的模型名与思考等级(按等级着色)。两个名称都可以点击,在鼠标位置打开操作菜单:
79
+
80
+ - **工作区菜单**:重命名、在文件管理器中显示、复制路径;
81
+ - **会话菜单**:置顶 / 取消置顶、重命名、分支会话、复制会话 ID、复制会话名称、归档会话;
82
+ - **重命名**:名称原位变为输入框,Enter 保存、Esc 取消、点其他位置也会保存。
83
+
84
+ ![会话模块](docs/module-session.png)
85
+
86
+ ### 上下文模块
87
+
88
+ 标题右侧是「当前占用 / 最大上下文(占用率)」,进度条用颜色表示占用率;底部两行分别是会话统计(轮数、步数、tok/s)与 Token 用量(总量、缓存命中)。鼠标悬浮在进度条上会切换成分段样式,分段表示 System prompt、Tool definitions 与 Messages;悬浮两行可看完整明细。
89
+
90
+ - **压缩**:会话空闲时可点,任务进行中置灰;
91
+ - **交接**:点「压缩」右侧的下拉菜单,子代理会把交接文档写进工作区的 `docs/handoff/` 目录,进度在「子代理任务」模块里可见。
92
+
93
+ ![上下文模块](docs/module-context.png)
94
+
95
+ ### 用量模块
96
+
97
+ - **DeepSeek 余额**:始终展示,没有数据时显示 `—`;
98
+ - **OpenCode 用量**:OpenCode Go 三个窗口的用量百分比;
99
+ - **Codex 额度**:已订阅时显示 5 小时与每周额度,未订阅时显示免费额度;
100
+ - **点击跳转**:点余额或百分比打开对应的设置页;
101
+ - **折叠后信息**:折叠后可在标题右侧展示余额或其中一项额度,展示内容随设置切换。
102
+
103
+ 前三项由两个关联插件提供:[dsh-account-usage](https://github.com/Ycet/dsh-account-usage)(余额与 OpenCode 用量)、[dsh-codex-subscription](https://github.com/WSL043/dsh-codex-subscription)(Codex 额度);未安装或未启用时对应行不展示,设置项置灰并给出原因。
104
+
105
+ ![用量模块](docs/module-usage.png)
106
+
107
+ ### 产物模块
108
+
109
+ 列出本会话改动过的文档、表格、演示与图片(终端命令产生的改动同样收录),按最后一次改动排序,最多 10 个文件,默认先显示 3 个、可展开查看全部;没有产物时模块整体不展示。
110
+
111
+ - **悬停路径**:鼠标在文件行上停留 0.5 秒显示完整相对路径;
112
+ - **点击打开**:在右侧栏打开文件内容;
113
+ - **右键菜单**:添加至聊天(以 `@` 引用加入聊天输入框)、在文件夹显示、复制文件名称 / 相对路径 / 绝对路径。
114
+
115
+ ![产物模块](docs/module-outputs.png)
116
+
117
+ ### Git 模块
118
+
119
+ 标题右侧是当前分支与变更文件数量;变更文件分「已暂存」与「未暂存」两组,组名右侧是文件数量,支持列表与文件树两种查看方式,文件行最左是状态字母、随后是文件名与灰色相对目录,最右是 `+新增 / -删除` 行数。
120
+
121
+ - **分支按钮**:切换已有分支或新建分支并自动切换;
122
+ - **初始化仓库**:工作区不是仓库时按钮变成这一项,点击即可建仓,并同时写入 `.gitignore`;
123
+ - **悬停操作**:暂存区文件可移出暂存区,变更区文件可撤销或添加至暂存区(文件夹行对整棵子树批量执行);
124
+ - **右键菜单**:暂存 / 撤销 / 加入仓库根的 `.gitignore`;
125
+ - **diff**:左键点击文件在右侧栏打开 diff;
126
+ - **revert**:撤销全部未暂存变更(未跟踪文件一并删除),操作前需要二次确认。
127
+
128
+ ![Git 模块](docs/module-git.png)
129
+
130
+ #### graph 页面
131
+
132
+ 点模块里的「git graph」打开提交列表,分页加载(每页最多 80 条,滚动到底部继续加载);当前分支为蓝底白字,其他分支为灰底黑字。右键点击提交可复制短哈希 / 全哈希 / 提交标题,或从此处创建分支、合并至当前分支,以及 soft / mixed / hard reset。
133
+
134
+ ![git graph 页面](docs/git-graph.png)
135
+
136
+ #### commit 页面
137
+
138
+ 点「commit」提交暂存区;「AI generate」按提交规范生成提交信息,生成依据是「提示词 + 暂存区变更」,默认提示词里含日期与版本规范,可在弹窗顶部展开后修改并保存。没有暂存文件时按钮仍可打开弹窗,此时 commit 与 AI generate 置灰。
139
+
140
+ ![commit 页面](docs/git-commit.png)
141
+
142
+ ### 任务模块
143
+
144
+ 显示会话的任务清单与完成状态,进行中的任务带旋转图标,已完成的任务收在列表下方、可展开查看;底部给出已完成、进行中与待处理的数量,任务变化时列表自动刷新。没有任务时模块不展示。
145
+
146
+ ![任务模块](docs/module-tasks.png)
147
+
148
+ ### 子代理任务模块
149
+
150
+ 显示当前会话的全部子代理,按层级缩进,执行中为黄色、已完成为绿色;超过 3 个时先显示 3 个。点击条目在右侧栏打开该子代理会话,主会话保持打开。没有子代理时模块不展示。
151
+
152
+ ![子代理任务模块](docs/module-subagents.png)
153
+
154
+ ### 计划清单模块
155
+
156
+ 显示 plan 模式产出的计划:待审批为黄色、已执行为绿色、已废弃为灰色并带删除线,底部是三种状态的数量,超过 3 个时先显示 3 个。点任意一行查看计划全文(按 Markdown 渲染)。
157
+
158
+ ![计划清单模块](docs/module-plan-list.png)
159
+
160
+ ![计划全文页面](docs/plan-content.png)
42
161
 
43
- | 模块 | 说明 |
44
- | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
45
- | 会话 | 当前工作区名称、会话名称、会话状态(任务中/待审批/空闲中/待回答/等待子任务)、模型提供商/模型名/推理等级;工作区名称与会话名称均为悬浮变灰的可点击按钮——点击在鼠标位置打开操作菜单(工作区:重命名 / 在 Finder·资源管理器中显示 / 复制路径;会话:置顶或取消置顶 / 重命名 / 分支会话 / 复制会话 ID / 复制会话名称 / 归档会话;复制类操作之前与「归档会话」之前各有一条分割线),选择重命名后名称原位变为输入框、失焦即提交(Enter 提交、Esc 取消,不再有取消/确认按钮),会话置顶后名称右侧显示小图钉;新建会话页不展示会话标题与状态;右上角「HUD 设置」打开左右分栏的设置弹窗(左栏模块启停与拖动排序,右栏「HUD面板通用设置(HUD 面板样式:卡片样式/边栏样式,默认卡片样式;HUD 面板展开位置;两处默认开合)/ 「上下文」模块设置 / 「用量」模块设置 / 「便笺」模块设置(便笺条数上限,5–20,默认 5;在弹窗页面中进行便笺内容编辑,默认关闭))」卡片,顶部「使用说明」/「更新日志」标签页分别提供内置上手指引与按版本分组的更新记录) |
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 设置中关闭);模块折叠后可在标题右侧展示所选额度(DeepSeek 余额 / OpenCode Go 5h·1w·1m / Codex 5h·周,Codex 未订阅时降级为免费额度,括号内数值加粗;对应数据不可用时设置选项置灰),DeepSeek 余额行始终展示(无数据时显示 `—`,点击仍打开对应设置页),OpenCode Go 与 Codex 行按各自安装/登录状态独立展示(无数据时整组不渲染,数值可点击打开对应设置页) |
48
- | git | 常驻展示(新建会话页与会话页均默认展示;工作区不是 git 仓库时标题栏右侧提供「初始化仓库」,点击即在该工作区执行 `git init`,建仓后按钮自动换成分支按钮);当前分支(标题栏右侧分支按钮:下拉列表可切换已有分支、创建新分支并自动切换)、变更文件数量;变更文件按暂存区(staged)与未暂存区(changes)分组展示(组名带灰色计数,无文件的分组自动隐藏;支持列表模式与文件树模式,文件树按文件夹嵌套分组、可展开折叠,设置随 profile 保存、重开面板或重启后仍保持);悬停文件行时右侧「+ / -」行数会换成操作按钮(暂存区显示「移出暂存区」,变更区显示「撤销更改」与「添加至暂存区」;按钮下方有渐变蒙层,不压住文件名与目录);文件夹行悬浮时对文件夹下全部变更文件执行同样的批量操作;变更文件行与「产物」一致:最左是变更状态字母,随后是**文件名**与灰色**相对目录**小字,最右保留 `+新增 / -删除` 行数;文件行左键打开右侧栏 diff、右键打开暂存/撤销/加入 .gitignore 菜单(文件夹行同构,可批量暂存、移出暂存、撤销或忽略整个目录;悬停 0.5 秒显示完整路径);未跟踪文件的状态徽章为「U」胶囊;三按钮(git graph / commit / revert)等宽三等分铺满模块宽度,分支按钮固定 88px 且超长分支名以省略号截断;「commit」提交暂存区(暂无暂存文件也可点开弹窗查看或修改提示词,AI generate 与 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
- | 子代理任务 | 当前会话全部后代子代理(按层级缩进)、执行中(黄)/已完成(绿)状态,点击在官方右侧栏打开子代理会话,保留主会话;仅在有子代理时展示;超过 3 个时默认只显示 3 个,第 3 个下方给出「展开其余 n 个子代理」,展开后末行下方给出「收起」 |
51
- | 任务 | 当前会话待办任务列表、已完成/待完成状态与计数(如`1/3`),随任务列表实时刷新;进行中任务显示旋转动画图标,底部展示「已完成/进行中/待处理」三态计数(含 0 恒显);仅在有任务时展示;**已完成的任务统一移到列表最下方并默认折叠**(组内先完成的在上、后完成的在下),点「展开已完成任务」查看,展开后末行下方给「收起」 |
52
- | 计划清单 | 当前会话通过 plan 模式(`exit_plan_mode`)产出的全部计划:待审批(黄)/已执行(绿)/已废弃(灰、划线淡色)三态标签,标题栏展示计划总数,点击行弹出计划全文弹窗,模块底部展示「已执行/待审批/已废弃」三态计数(含 0 恒显);仅在有计划记录时展示;超过 3 条时默认只显示 3 条,第 3 条下方给出「展开其余 n 条计划」,展开后末行下方给出「收起」 |
53
- | MCP | 接入的全部 MCP 服务及 dsh 全局启用状态;开关经 DSH 插件管理器直接启停 dsh 全局的 MCP 服务(按行写入 profile `cordis.patch.yml` 并完成热重载,即时生效、无需刷新页面、不影响其它服务) |
54
- | 便笺 | 按**工作区共享**的**多条便笺**(同一工作区目录下所有会话共用同一组便笺,本地持久化,重启 DSH 后仍在;旧单便笺升级后自动迁移为「便笺1」)。**便笺条列表**:每条是圆角便笺条,左侧拖动条可按住上下拖动排序,右侧悬停显示删除按钮(键盘聚焦同样显示,触屏常显);点击便笺条即可进入编辑(默认在模块内打开编辑视图;开启「在弹窗页面中进行便笺内容编辑」后改为弹窗编辑,便笺模块始终停留在列表视图);空列表显示空文案。**功能按钮**:两行——第一行「从聊天创建」「添加便笺」各占一半宽,第二行「删除全部便笺」铺满;便笺数量达到上限(HUD 设置「便笺」卡片可调,5–20,默认 5)时新建只 toast 提示;「从聊天创建」用会话输入框的文字与图片新建便笺(只复制、不清空输入框,创建后直接进入编辑视图;输入框无内容时置灰);「添加便笺」直接进入空白便笺的编辑视图;删除单条时行内把删除按钮换成取消与确认按钮(确认图标为红色对勾),点击确认后才删除;删除全部仍弹窗二次确认。**便笺内容编辑视图**:默认在模块内展开(返回按钮回列表);开启「在弹窗页面中进行便笺内容编辑」后改为弹窗编辑——右上角关闭按钮或点击弹窗外侧关闭(需在遮罩上按下并松开,拖选文字不会被误关),改动即时保存,弹窗布局与内联视图一致(标题、图片区、固定高度的内容输入框、清空 / 从聊天导入 / 添加至聊天),「添加便笺」与「从聊天创建」新建后也直接打开弹窗;标题可改(为空时自动生成「便笺n」,编号取当前列表最大「便笺n / Note n」编号 +1,删除最大编号后会复用该编号)、图片区(最多 20 张,可粘贴、点击看大图、悬浮移除,按住缩略图左右拖动可排序(松手后直接落位,不再左右抽动))、文字输入框(**不限制字数**,保留底部拖拽手柄且**所有便笺共用同一高度**)、「清空」二次确认(一次清掉文字与图片)、「从聊天导入」先清空当前便笺再写入输入框内容(便笺非空先确认,非图片附件跳过)与「添加至聊天」先清空输入框再写入便笺内容(输入框非空先确认,图片按便笺顺序加入);折叠/展开状态持久化;设置保存时允许把上限调到低于部分工作区现有便笺条数(照常保存);这类工作区已有便笺保留不变,但不能再新建便笺 |
55
- | 待办 | 按**工作区共享**的待办清单(同一工作区目录下所有会话共用一份清单与顺序,本地持久化);勾选完成/恢复、点击文字即可编辑、添加/删除(删除时行内二次确认)、整行拖拽排序(拖动手柄位于行最左侧;拖动时其余条目实时让位,直观预览松手后的顺序)、一键清空已完成(二次确认,空列表置灰);底部展示完成计数;**已完成的待办统一移到列表最下方并默认折叠**(组内保持原有先后),点「展开已完成待办」查看,展开后末行下方给「收起」,拖动只在未完成区段内重排;折叠/展开状态持久化 |
162
+ ### 便笺模块
56
163
 
57
- **互斥协作**:HUD 面板与官方右侧栏、[dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) 右侧栏互斥协作。右侧栏展开期间,HUD 面板**派生隐藏**——只是临时不可见,**不改写**该会话的展开记忆,正文也不会被额外推挤留白;关闭右侧栏后,面板按展开记忆自动恢复(除非此前手动收起过 HUD)。点击「HUD面板」按钮时若右侧栏已打开,则先自动收起侧栏再展示 HUD(若版本兼容性导致自动收起失败,面板保持隐藏,待右侧栏关闭后自动出现);新建会话页在右侧栏展开期间不显示该悬浮入口。面板配置为**左侧**时(见「HUD面板通用设置」),窄窗口下左侧会话列表的遮罩抽屉展开期间面板同样临时隐藏,关闭抽屉后自动恢复(仍不改写展开记忆)。面板外观可在「HUD面板通用设置 → HUD 面板样式」中切换:**卡片样式**(默认)保持圆角悬浮卡片;**边栏样式**下 HUD 面板通高贴边、透明无圆角,与内容区之间只留一条分隔线,模块之间的分隔线左右各缩进 14px,滚动条停在内容区右缘。
164
+ 多条便笺按工作区共享(同一工作区目录下的会话共用同一组),每条单独保存标题与文字,字数不限、图片最多 20 张。
165
+
166
+ - **列表**:便笺条列表展示全部便笺,点击进入编辑,鼠标悬停显示删除按钮;
167
+ - **拖动排序**:按住便笺条左侧的拖动条调整顺序;
168
+ - **新建**:「添加便笺」新建空白便笺并进入编辑;「从聊天创建」用输入框的文字与图片新建便笺;
169
+ - **删除**:删除时按钮换成取消与确认,点确认才删除;「删除全部便笺」同样需要确认;
170
+ - **编辑视图**:默认在模块内展开,点返回按钮回到列表;可改标题(为空时自动编号)、粘贴图片并按缩略图拖动排序、拖动底部手柄调整高度(所有便笺共用同一高度);
171
+ - **与聊天互通**:「从聊天导入」先清空便笺再写入输入框内容;「添加至聊天」先清空输入框再写入便笺内容(图片按便笺顺序加入);「清空」需要二次确认;
172
+ - **弹窗编辑**:在设置里开启后,点便笺条在弹窗中编辑,模块保持列表视图。
173
+
174
+ ![便笺模块](docs/module-notes_01.png)
175
+
176
+ ![便笺编辑视图](docs/module-notes_02.png)
177
+
178
+ ### 待办模块
179
+
180
+ 按工作区共享的待办清单:勾选条目即标记完成、取消勾选即恢复;在输入框输入内容按 Enter 新增,点条目文字可编辑,删除时需要确认;拖动行左侧手柄调整顺序;「清空已完成」需要二次确认。标题显示已完成数量,已完成的待办收在下方、可展开查看。
181
+
182
+ ![待办模块](docs/module-todo.png)
183
+
184
+ ### MCP 模块
185
+
186
+ 列出已接入的 MCP 服务与全局启停状态,点开关立即启停、不需要刷新页面;改动只影响目标服务,部分环境需要重启 DSH 后才生效。
187
+
188
+ ![MCP 模块](docs/module-mcp.png)
189
+
190
+ ---
191
+
192
+ ## ⚙️ HUD 设置与面板行为
193
+
194
+ 点会话模块右上角的齿轮打开设置,弹窗顶部是三个标签:**「HUD 设置」/「使用说明」/「更新日志」**(「使用说明」是内置上手指南,按模块分节、每节给小标题与逐条说明;「更新日志」按版本分组记录改动)。
195
+
196
+ - **左栏**:勾选模块控制显隐、拖动手柄排序(从上到下就是面板顺序)、卡片的图钉可置顶该模块(同时只允许一个);
197
+ - **右栏**:五张卡片——HUD 面板通用设置(面板样式:卡片 / 边栏,默认卡片;展开位置:左 / 右;两处默认开合)、上下文、用量、git 变更、便笺;
198
+ - **保存**:有改动时「保存设置」可点,关闭与 Esc 都不保存;左下角「恢复默认」在鼠标位置弹出重置选项;
199
+ - **置灰原因**:设置项不可用时置灰,说明文字用红色写明原因。
200
+
201
+ ![HUD 设置弹窗](docs/hud-settings.png)
202
+
203
+ 面板行为:
204
+
205
+ - **开合记忆**:开合状态按会话保存,新建会话页默认收起,默认值可在设置里修改;
206
+ - **折叠**:点模块标题折叠或展开,会话与上下文模块不能折叠,折叠状态按会话保存;
207
+ - **置顶**:置顶模块固定在「会话」下方,最高 40vh、超出在固定区内滚动、标题行照常吸附;
208
+ - **侧栏协作**:右侧栏展开期间面板临时隐藏,侧栏关闭后自动恢复。
209
+
210
+ ---
58
211
 
59
212
  ## 🚀 快速开始
60
213
 
@@ -62,7 +215,7 @@ HUD在dsh中的效果(深色主题)
62
215
 
63
216
  ```bash
64
217
  # 1. 安装(无需 git;本机需有 pnpm,dsh plugin 会调用它)
65
- dsh plugin --profile web add dsh-awesome-hud@0.21.1
218
+ dsh plugin --profile web add dsh-awesome-hud@0.21.2
66
219
 
67
220
  # 2. 重启 DSH Web 服务并刷新页面
68
221
  ```
@@ -74,7 +227,7 @@ dsh plugin --profile web add dsh-awesome-hud@0.21.1
74
227
 
75
228
  ```bash
76
229
  # 1. 安装(锁定版本 tag,要求本机 git 可访问 GitHub)
77
- dsh plugin --profile web add "github:Ycet/dsh-awesome-hud#v0.21.1"
230
+ dsh plugin --profile web add "github:Ycet/dsh-awesome-hud#v0.21.2"
78
231
 
79
232
  # 2. 重启 DSH Web 服务并刷新页面
80
233
  ```
@@ -92,173 +245,100 @@ dsh plugin --profile web add "dsh-awesome-hud@link:<absolute-path-to-plugin>"
92
245
 
93
246
  ```bash
94
247
  # 1. 安装(可直接用 Release 资产 URL,也可先下载 .tgz 再传本地路径)
95
- dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/download/v0.21.1/dsh-awesome-hud-0.21.1.tgz"
248
+ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/download/v0.21.2/dsh-awesome-hud-0.21.2.tgz"
96
249
 
97
250
  # 2. 重启 DSH Web 服务并刷新页面
98
251
  ```
99
252
 
100
- 安装完成后,聊天页右上角(「打开工作区」按钮左侧)出现「HUD面板」按钮,点击即可开合。
101
-
102
- > [!NOTE]
103
- > HUD 面板默认展开;**每个会话各自记住自己的开合状态**(按会话 id 存于 localStorage),在 A 会话收起不会影响 B 会话。**新建会话页(尚未开始的空白会话)例外**:该页每次进入都从收起状态开始(只改内存态、不写 localStorage,因此不影响任何会话的记忆),并在右上角提供独立的悬浮「HUD面板」按钮用于在该页展开(图片**大图预览**打开期间该按钮隐藏,避免浮在大图与预览关闭按钮之上)。面板样式、展开位置与模块可见性保存于 DSH profile 设置中,跨浏览器/设备随 profile 同步。
253
+ 安装完成后,聊天页右上角(「打开工作区」按钮左侧)出现「HUD面板」按钮,点击即可开合。**每个会话各自记住自己的开合状态**;新建会话页例外,每次进入都从收起状态开始,并在右上角提供独立的悬浮按钮。
104
254
 
105
255
  ### 桌面端安装(macOS)
106
256
 
107
- 当前版本:**0.21.1**。先完全退出 DeepSeek Harness,再使用桌面应用自带的 CLI 安装;不要用旧 Web CLI 管理 `desktop` profile。优先从 npm 安装(可在插件页一键更新),本地开发时再改用源码目录:
257
+ 先完全退出 DeepSeek Harness,再用桌面应用自带的 CLI 安装;不要用旧 Web CLI 管理 `desktop` profile:
108
258
 
109
259
  ```bash
110
260
  # 从 npm 安装(推荐)
111
- "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-awesome-hud@0.21.1
261
+ "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-awesome-hud@0.21.2
112
262
 
113
263
  # 从本地源码安装(开发)
114
264
  "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add "dsh-awesome-hud@link:<absolute-path-to-plugin>"
115
265
  ```
116
266
 
117
- 重新打开应用后,在会话右上角点击「HUD面板」。Codex 额度需要另行安装并登录支持当前 DSH 版本的 `dsh-codex-subscription`;DeepSeek 余额优先来自 `dsh-account-usage`,未安装/未启用时回退 DSH 官方账户服务(需登录 DeepSeek 账号);OpenCode Go 用量与设置页页签来自 `dsh-account-usage`。
118
-
119
- > [!NOTE]
120
- > 便笺文字、待办、折叠、面板设置和面板开合记忆保存在当前浏览器或桌面应用的 `localStorage`;**便笺图片**以原图存在同一来源的 **IndexedDB**(同样随重启保留、按工作区共享)。安装插件不会自动搬运 Web 浏览器中的这些数据;模型与登录凭据由 DSH 管理。
121
-
122
- ## 🧭 使用说明
123
-
124
- - **HUD 面板**:宽度 300px,内容超出时面板内部滚动(**不展示滚动条**),面板为**常驻固定展示**(正文与输入框按侧位让位)。外观由「HUD面板通用设置 → HUD 面板样式」决定:**卡片样式**(默认)为圆角悬浮卡片,高度上限为输入框底部(留 8px 底距),与窗口边缘留 8px 间距;**边栏样式**改为通高贴边(顶部自会话页眉下沿起、底部到窗口底部、外侧不留边距;新建会话页没有页眉,顶部从右上角按钮那一行的下沿起,不留空隙),面板透明无圆角,与内容区之间只保留一条 1px 分隔线,模块之间的分隔线左右各缩进 14px(模块内容与交互不变)。展开位置由「HUD面板通用设置 → HUD 面板展开位置」决定:**右侧**(默认)贴在窗口右侧,聊天内容与输入框自动向左让位;**左侧**时贴在会话区左缘(会话列表右侧,卡片样式留 8px 间距),正文与输入框向右让位;卡片样式下页面滚动条停在窗口最右缘,边栏样式下滚动条停在内容区右缘、紧贴分隔线;会话页右缘的「轮次导航」指示条仍停在正文右缘,面板都不会与正文重叠。右侧栏展开期间面板隐藏且不推挤正文,关闭后恢复。
125
- - **设置弹窗**:「会话」模块右上角齿轮打开设置弹窗,顶部是**「HUD 设置」/「使用说明」/「更新日志」三个标签**(选中项带品牌色下划线,可随时切换);设置页为**左右分栏**:中间一条分割线,左栏是模块启停与排序,右栏是模块的具体设置。
126
- - **左栏**:勾选控制「上下文 / 用量 / git / 子代理任务 / 任务 / 计划清单 / MCP / 便笺 / 待办」的显隐(「会话」模块恒展示),每张卡片左侧有**拖动排序手柄**(按住拖动调整该模块在 HUD 面板中的顺序,全局生效;拖动时其余卡片实时让位预览,松手才落盘)。左栏不随右栏滚动;弹窗高度随窗口自适应并压缩卡片间距,保证 9 张模块卡片始终全部露出。**新建会话页不渲染的模块(上下文 / 子代理任务 / 任务 / 计划清单)在该页的设置里按真实状态展示、置灰不可点击**(悬浮显示原因),其开关请在会话页调整。
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.1、v0.21.0、v0.20.1 与 v0.20.0 四条;**页面最多展示最新 20 个版本,更旧的版本记录会被清除**,**每次升版在页面顶部追加一条并删除第 21 条及更旧记录**(新版本必须与 `package.json` 的 `version` 一致,测试会拦漏补并校验数量上限)。底部「恢复默认 / 保存设置」同样常驻,切换标签时弹窗高度不变;页面纯展示,不发请求、不写设置。
131
- - **会话模块**:工作区名称与会话名称都是悬浮变灰的可点击按钮(两者的**悬浮 / 点击热区都是整行宽度**,只让出右侧的状态胶囊与齿轮按钮),点击后在**鼠标位置**打开菜单(菜单宽度 200px,贴近视口边缘时自动夹取到视口内;面板内部滚动或窗口缩放时菜单保持原位不跳动,点击外部、按 `Esc` 或再次点击标题即可关闭)。
132
- - **工作区菜单**(左上角工作区名):**重命名工作区**(原位输入框,写入 DSH 工作区注册表,官方侧栏/选择器同步更新;与其它工作区同名时给出明确提示并退回原名)、**在 Finder 中显示**(macOS 为「在 Finder 中显示」,Windows 为「在资源管理器中显示」,其余平台为「在文件夹中显示」;原生打开由宿主执行,宿主不支持时该项置灰并提示原因)、**复制工作区路径**(复制项前有分割线,与上面两项分组)。
133
- - **会话菜单**(会话名称):**置顶会话 / 取消置顶**(按当前状态切换文案与图标,置顶后名称右侧显示小图钉,效果与官方侧栏一致)、**重命名**、**分支会话**(与官方一致:创建后不跳转当前页,成功以 toast 提示;需要迁移源会话时提示先打开该会话)、**复制会话 ID**、**复制会话名称**。
134
- - **内联改名**:点击「重命名」后名称原位变为输入框并自动全选,**点击其他区域即提交**(也支持 Enter 提交、Esc 取消);内容空白或未改动时不发请求,失败时退回原名并 toast 报错。新建会话页不展示会话标题与状态徽标,工作区菜单在该页同样可用(作用于推导出的目标工作区)。
135
- - **上下文**:标题右侧按「当前占用 / 最大上下文(占用率)」展示,例如 `199K / 1M(19.9%)`;进度条默认单色(0–40% 绿 / 40–90% 黄 / >90% 红),鼠标悬浮时切换为三段式并弹出 breakdown 提示(System prompt 石青色、Tool definitions 紫色、Messages 蓝色,数值为估算 token);底部两行分别是会话统计(轮数/步数 · tok/s)与 Token 用量(总量 · 缓存命中),悬浮时分别显示完整统计(模型用时、工具调用用时、首 token 平均、输出速度)和完整用量(缓存命中、未缓存输入、缓存读取、缓存写入、输出)。「压缩」在会话空闲时可用,运行中按钮禁用并提示原因;进度条常显分段、两行统计/用量的显隐可在 HUD 设置的「上下文」卡片中调整。
136
- - **用量模块**:位于「上下文」模块下方,**恒定展示**(仍可在 HUD 设置中关闭)。DeepSeek 余额优先复用 dsh-account-usage 插件路由、未安装/未启用时回退 DSH 官方账户服务;Codex 复用 dsh-codex-subscription 的浏览器 RPC;面板打开时立即加载、之后每 60 秒轮询;数据均缩进展示并带对应图标;模块支持折叠,默认展开(折叠状态经 localStorage 持久化)。
137
- - **DeepSeek 余额**:展示余额合计(充值 + 赠送),**点击具体余额数值**可直接打开设置面板并进入「账号与余额」页(官方页不可用(未登录/旧版)时回退到「账户」分区),有 dsh-account-usage 页签时切换到 deepseek 页签、没有页签时静默停留在官方账户页。该行**始终展示**:优先使用 dsh-account-usage(需配置 `DEEPSEEK_PLATFORM_TOKEN`),未安装/未启用时回退 DSH 官方账户服务(需登录 DeepSeek 账号);无数据时数值显示 `—`,点击行为不变。
138
- - **OpenCode Go 用量**:三行分别展示 oc-go 5h / 1w / 1m 窗口用量**百分比**,**点击具体百分比数值**可直接打开设置面板并进入「账号与余额」页,切换到 opencode go 页签;仅当已配置 OpenCode Go Key 且订阅有效(`/api/account-usage/opencode` 返回 `ok + keySource`)时展示,无数据时整组不渲染(不可点击)。
139
- - **Codex 额度**:订阅账号展示 `codex 5h额度` 与 `codex 周额度` 两条**剩余额度整数百分比**;未订阅(免费)账号的 codex 额度只返回一个约 30 天的月度窗口,此时改为展示一条 `codex 免费额度` 行(取该窗口剩余百分比),**不再展示 5h / 周额度**——两类行互斥。订阅状态按**额度窗口形状**判定(出现 5h 或周窗口即视为已订阅),因为订阅插件的 RPC 不暴露套餐字段;月度窗口时长与预期不符时回退该额度首个可用窗口,保证有数据就不显示 `—`。三行均使用 ChatGPT 图标,**点击百分比数值**打开「设置:Codex 订阅」页面。仅当安装并登录 `dsh-codex-subscription` 时展示;已登录但额度请求暂时失败时**按上一次的展示模式**保留行并显示 `—`(订阅账号不会因此误显示为免费额度行),无法确认安装/登录状态时隐藏。
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额度(名称)」)。该额度不存在时**不展示该行**;存在但窗口数据异常时保留行并显示 `—`。
141
- - **模块可见性与可配置内容**:模块恒定展示;DeepSeek 余额行始终展示(数据来自 dsh-account-usage 或官方账户兜底,无数据时显示 `—`),OpenCode Go 与 Codex 仅在其数据源可用时渲染对应行——**没有启用 `dsh-account-usage` 就不展示 OpenCode Go 额度,没有启用 `dsh-codex-subscription` 就不展示 codex 额度**;这两项的开关在设置页里同时置灰、不可点击,原因以红字写在名称下方(区分「需安装并启用插件」与「已启用但未配置/未登录」)。全部无数据时模块内显示一行接入提示。展示内容与折叠后展示信息可在「「用量」模块设置」卡片中配置(host settings 持久化,随 profile 同步)。
142
- - **git 模块**:常驻展示——新建会话页与会话页都默认展示,工作区不是 git 仓库时也展示(标题栏右侧提供「初始化仓库」按钮,位置与分支按钮相同;点击后在该工作区执行 `git init`,成功后模块切换为仓库态:按钮变为分支按钮,正文出现动作区与变更统计,并由随后的轮询保持刷新;已是仓库时该按钮不出现)。每 5 秒随面板打开自动刷新(写操作后立即刷新);标题栏右侧分支按钮宽度固定(88px,分支名过长以省略号截断,鼠标悬停可看完整分支名),点击弹出下拉列表——可切换已有分支(当前分支高亮带勾标记;点击当前分支会提示「当前已在分支」而非静默关闭),或在输入框中输入新分支名点击「添加」创建并自动切换;「git graph」弹窗按每页最多 80 条分页展示当前仓库(全部引用)提交图(滑到列表底部出现「加载更多」按钮点击追加下一页,全部加载完后底部显示「已显示全部提交」提示);分支标签中,当前分支为蓝底白字,其他分支为灰底黑字;HEAD 指向版本以放大的白色填充圆点 + 蓝色描边标记。提交行右键菜单可复制短哈希(前 7 位)/全哈希(40 位)/提交标题,并提供以下受保护操作:
143
- - **从此处创建分支**:点击后**原菜单项位置**展开为输入框 + 「取消」/「确认」图标按钮(输入框为空时确认按钮置灰)。输入合法分支名并点击确认后,以该提交为起点执行 `git checkout -b <名称> <提交>` 并切换到新分支:成功提示后菜单关闭、git 快照与提交图刷新,新分支标签随即显示为蓝底当前分支。分支名重复、或本地修改会阻止切换时给出提示(后者列出受影响文件)并**保留输入内容**,便于改名重试;不自动 stash、不强制切换。输入框内按 Enter 不触发创建,按 Escape 取消输入并恢复为原菜单项(再按一次关闭菜单);Git 操作(merge / rebase / cherry-pick / revert)进行中时该项置灰。
144
- - **合并至当前分支**:先在原菜单项位置显示行内「确认?/取消」,确认后执行 `git merge --no-edit`;已包含提示「无需合并」、本地修改阻塞提示受影响文件、合并冲突自动 `git merge --abort` 回滚并列出冲突文件清单。
145
- - **reset(soft)-保留暂存**:仅可选择当前本地分支历史中、早于 HEAD 的提交;二次确认后以 `git reset --soft` 回退,所选提交之后的提交内容保留在暂存区。
146
- - **reset(mix)-取消暂存**:同样仅可回退至当前本地分支历史中的较早提交;二次确认后以 `git reset --mixed` 回退,所选提交之后的提交内容保留在工作区且不在暂存区。
147
- - **reset(hard)-撤回更改**:二次确认后以 `git reset --hard` 回退并丢弃所选提交之后的提交内容,以及已跟踪文件的未提交修改;未跟踪文件不会被删除。
148
- - reset 在未检出本地分支、Git 操作进行中、所选提交不在当前分支历史中或所选提交即为 HEAD 时不可用。变更文件按分组展示(状态字母按类型着色——修改 `M` 黄色、新增 `A` 蓝色、删除 `D` 红色、未跟踪 `U` 灰色,重命名 `R` / 复制 `C` 蓝色;未跟踪文件用 U 标识,与其它状态同为带描边的胶囊徽章):
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 预登记文件撤销 = 删除该文件,均带二次确认与受影响文件清单)与「add to .gitignore」(把该文件加入仓库根的 `.gitignore`)。文件行悬停 0.5 秒后在鼠标位置显示完整路径提示;悬停时行右侧的加减行数会换成图标按钮——暂存区文件显示「移出暂存区」(减号),变更区文件显示「撤销更改」(撤销图标)与「添加至暂存区」(加号),按钮下方有渐变蒙层避免压住文件名/目录;文件树模式按文件夹嵌套展示,文件夹行悬浮时对子文件批量执行同样的操作;文件夹行右键(或 Shift+F10 / 菜单键)弹出与文件行同构的菜单,对该文件夹下当前分组的文件批量执行添加至暂存区 / 撤销更改 / 移出暂存区,并提供「add to .gitignore」(写入 `/目录/` 规则忽略整个目录)
151
- - **commit**:按钮始终可点——暂存区没有文件时也能打开提交弹窗查看或修改 AI 生成提示词,此时弹窗把暂存数量换成「暂存区没有可提交的变更」,并把 AI generate 与 commit 置灰;点击弹出提交弹窗(展示待提交暂存文件数量 + 多行输入框 + AI generate + commit),输入为空时 commit 置灰;Enter 仅换行,需点击 commit 才会提交;提交范围仅为暂存区
152
- - **AI generate**:固定调用 DeepSeek 官方 DeepSeek Flash 系列模型(`deepseek-account` 路由的 `deepseek-flash`,`reasoningEffort: low`),不再使用当前会话所选模型;首次点击只进入「确认?」并在按钮左侧显示说明,第二次点击才生成(3 秒内未确认自动复位,点击按钮外或按 Escape 取消),生成时按钮禁用。生成时结合暂存区全部 diff(超 16KB 截断)与当前会话最近对话上下文(用户直接消息与助手消息,供理解改动意图;若对话中用户明确指定了提交备注则直接采用),按内置本地 git 提交规范生成提交信息并填入输入框——格式 [YYMMDD] 开发项目名称 vX.Y.Z:修改内容(日期取系统当前时间;版本号沿用项目版本文件里记录的**当前**版本号,不做递增;项目名与当前版本取自工作区向上最近的 package.json);生成后宿主会把日期前缀同步为当天、并把版本号校正为项目当前版本,不会出现自作主张升版。默认提示词把日期与版本号规范写在正文里,可直接改写:未改动时按内置规范执行上述校正,编辑保存后完全按提示词生成(不再补前缀、也不再校正版本号),恢复默认即回到内置规范;自定义提示词时宿主只注入项目事实(项目名与当前版本号),不再向 system 里塞「版本号必须递增」之类的内置规则,并在末尾追加「本提示词是唯一规则来源,内部冲突时以靠后的说明为准」
153
- - **revert**:按钮在无任何未暂存变更(含未跟踪)时置灰;点击后二次确认弹窗列出全部受影响文件(未跟踪文件带 `?` 前缀标识),确认后还原已跟踪文件的未暂存变更并删除未跟踪新建文件与 intent-to-add 预登记文件;若存在无法删除的目录条目(嵌套仓库/子模块),会明确提示并跳过,不再静默当作成功
154
- - **子代理任务模块**:按层级缩进展示全部后代子代理;执行中状态徽章为**黄色**,已完成为绿色;点击条目在官方右侧栏打开对应子代理会话,保留当前主会话;嵌套子代理携带其直接父会话与会话模式。缺少侧栏接口时显示打开失败提示。
155
- - **任务模块**:列表展示当前会话待办任务;进行中(in progress)任务行首为旋转动画图标(DeepSeek 官方同款,1s/圈,品牌蓝),已完成/待处理保持勾选与待办图标;模块底部展示「x 已完成 · x 进行中 · x 待处理」三态计数(含 0 恒显),标题栏保留「已完成/总数」计数。
156
- - **计划清单模块**:位于「任务」模块下方,展示当前会话通过 plan 模式产出的全部计划清单(新→旧),仅在存在计划记录时展示;每 5 秒随面板打开自动刷新,状态由会话日志自动推导:
157
- - **待审批**(黄色标签):计划刚产出、用户尚未审批;
158
- - **已执行**(绿色标签):用户在计划审查中审批通过(`exit_plan_mode` 返回批准结论),进入执行阶段;后续退出 plan 模式不会改为废弃。此标签不代表所有步骤已经完成;
159
- - **已废弃**(灰色标签、文字划线变淡):审查未通过——包括拒审/要求修改/打断审查(错误结果)、在计划审查卡片上点「要求修改」(关闭审查、回到输入框;DSH 0.2.1-rc.5 起该操作以**成功结果** `{ approved: false }` 返回且计划模式仍生效,HUD 立即判为已废弃),以及计划无审批结论但 plan 模式随后退出(如 `/plan off`)。兼容新版消息级错误标记、旧结果块、结果文案与 plan 模式退出信号;
160
- - 行主文字取计划首个 Markdown 标题,无标题时截取正文;点击任一行弹出计划全文弹窗(标题、状态、产出时间与正文,正文按轻量 Markdown 渲染,支持标题/列表/代码块/链接/引用与 GFM 表格);模块底部展示「x 已执行 · x 待审批 · x 已废弃」三态计数(含 0 恒显);模块可折叠,默认展开。
161
- - **MCP 模块**:开关控制 dsh 全局的 MCP 服务启停——经 DSH 官方插件管理器 `pluginManager.setPluginEnabled` 按行写入 profile `cordis.patch.yml` 并等待热重载完成,开关即时生效、无需刷新页面,只改目标服务、不改动其它插件配置;未启用 HMR 的 profile 会提示「重启后生效」;模块默认展开,无任何 MCP 服务时仍展示空状态。
162
- - **便笺模块**:按**工作区共享**的便笺——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用一份内容与图片,含输入框高度),文字存 `localStorage`、图片以原图存 IndexedDB,重启 DSH 后依旧存在;删除或归档其中任一/全部会话都不影响该工作区其它会话的内容,下次在同一工作区新建会话时内容与图片依旧存在。输入框底部拖拽手柄可拖拽调整高度(实时持久化);**不限制字数**,底部也不再显示字数与图片张数。**图片**:直接在输入框里粘贴(`image/*`,最多 20 张;字节上限沿用宿主的会话内附件校验),缩略图在输入框上方横向滚动,点击看大图(Esc / 遮罩 / 关闭按钮退出),鼠标悬浮缩略图右上角出现移除按钮(触屏常显);「清空」或移除都会释放对应原图。**从聊天导入**(位于「添加至聊天」左侧):先清空便笺里的文字与图片(旧原图一并释放并删除 IndexedDB 记录),再写入当前会话/新建会话页输入框里的文字与图片,便笺非空时先弹确认,非图片附件会跳过并提示;输入框内容不清除,输入框为空时按钮置灰、只提示且不清空便笺。**添加至聊天**:先清空会话输入框里的文字与图片(逐个移除并释放旧附件),再写入便笺文字并按便笺顺序加入图片;输入框非空时先确认,为空则直接写入,成功后焦点回到输入框;便笺内容保留;清空后写入失败不回滚(保持已清空 + 已写入部分并提示)。有文字或图片时「清空」可用:首次点击进入红色确认态,二次点击后同时清掉文字与图片(点击其他区域、Escape 或 2 秒超时会取消)。模块可折叠/展开(状态持久化)。未归属工作区(无 cwd)的会话降级为会话级隔离,不与其它会话共享。便笺内容编辑弹窗与设置弹窗、git graph 弹窗一样,只有在遮罩上按下并在遮罩上松开才会关闭——在标题或正文输入框里拖选文字后移出弹窗外松手不会再误关弹窗;图片缩略图左右拖动排序松手后直接落位在拖动预览的位置,不再左右抽动。
163
- - **待办模块**:按**工作区共享**的待办清单——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用同一份清单与顺序,本地持久化);每条待办为**卡片式**(1px 描边 + 浅底 + 10px 圆角,与「HUD 设置」里的模块卡片同款,行距 6px),**删除按钮默认隐藏,鼠标悬浮该行时才出现,键盘聚焦(`:focus-visible`)也会显示;点击条目文字即可编辑,删除时行内二次确认**(两者改为**绝对定位浮层**:文字独占整行宽度,悬浮时浮层以行底色实底铺在行右端、左侧 16px 渐隐把文字淡出,既不会被挤窄、也不会重新换行;触屏等无 hover 环境按钮常显并给文字留出右侧避让;鼠标拖动后不会再滞留);勾选完成/恢复、添加/删除项、整行拖拽排序(拖动手柄位于行最左侧勾选框之前,**手柄热区覆盖整行高度**,多行条目也能整列拖起;拖动时其余条目按真实行高实时让位,松手才保存顺序)、一键清空已完成(二次确认弹窗,无已完成项时按钮置灰);底部展示完成计数;模块可折叠/展开(状态持久化)。同一工作区多会话/多标签页同时编辑时按条目 id 归并,不会互相清空。
164
- - **折叠状态**:各模块折叠/展开状态刷新页面后保持(localStorage);「会话」模块图标使用 DSH favicon。
165
- - **新建会话页**:右上角提供独立悬浮「HUD面板」按钮(该页没有会话页眉;Windows 普通窗口中入口位于原生标题栏下方,全屏时取消该偏移)。该入口与聊天会话页保持同一顺序:始终排在右侧工具按钮簇左侧(装有 better-sidebar 时,其「底部面板」切换按钮排在入口右侧、两个页面的间距一致)——这让两个页面的入口位置看起来完全相同。**图片大图预览打开时该按钮隐藏**——预览是铺满视口的模态浮层(`role="dialog"` + `aria-modal`,如 `dsh-codex-subscription` 的图片查看器),而 HUD 入口的层级远高于它,不隐藏就会浮在大图与右上角预览关闭按钮之上;预览关闭后按钮自动恢复,面板开合状态不受影响(判定只看浮层语义与视口覆盖率,不绑定第三方类名)。该页每次进入都从收起状态开始,点击按钮后展开;面板固定贴右侧、宽 300px,输入框与正文左移让位,按钮保持原位。官方右侧栏(含 better-sidebar)展开期间,该悬浮入口与面板一并隐藏——入口不再移到侧栏左侧,也不再把展开态面板的位置写进定位;关闭侧栏后入口**立即出现在打开侧栏前的位置**,不会先闪到侧栏边缘,并回到该页此前的开合状态(除非已手动收起 HUD)。新建页的 Git、便笺、待办和便笺发送目标使用同一最近工作区;MCP 作为全局模块独立刷新,无会话或工作区时也可查看和启停。该页展示会话 / 用量 / git / 便笺 / 待办 / MCP 模块(git 常驻,目标工作区不是仓库时提供「初始化仓库」;「用量」模块恒定展示,DeepSeek 余额无数据时显示 `—`);尚无会话记录时不展示会话标题与状态徽标(工作区标题菜单照常可用)。进入真实会话后加载该会话自己的开合记忆,标题栏原按钮接管入口。
166
-
167
- ## 🖼️ 界面截图
168
-
169
- ### 各模块预览
170
-
171
- #### 「会话」模块
172
-
173
- ![alt text](docs/module-session.png)
174
-
175
- #### 「上下文」模块
267
+ ### 数据存放
176
268
 
177
- ![alt text](docs/module-context.png)
269
+ 便笺文字、待办、折叠、面板设置与开合记忆保存在当前浏览器或桌面应用的 `localStorage`;**便笺图片**以原图存在同一来源的 **IndexedDB**。安装插件不会自动搬运 Web 浏览器中的这些数据;模型与登录凭据由 DSH 管理。
178
270
 
179
- #### 「用量」模块
180
-
181
- ![alt text](docs/module-usage.png)
182
-
183
- #### 「产物」模块
184
-
185
- ![alt text](docs/module-outputs.png)
186
-
187
- #### 「git变更」模块
188
-
189
- ![alt text](docs/module-git.png)
190
-
191
- #### 「子代理任务」模块
192
-
193
- ![alt text](docs/module-subagents.png)
194
-
195
- #### 「任务」模块
196
-
197
- ![alt text](docs/module-tasks.png)
198
-
199
- #### 「计划清单」模块
200
-
201
- ![alt text](docs/module-plan-list.png)
202
-
203
- #### 「MCP」模块
204
-
205
- ![alt text](docs/module-mcp.png)
271
+ ---
206
272
 
207
- #### 「便笺」模块
273
+ ## ⚙️ 兼容性
208
274
 
209
- ![alt text](docs/module-notes_01.png)
275
+ | 项目 | 版本 / 说明 |
276
+ | --- | --- |
277
+ | DeepSeek Harness | `engines.dsh: >=0.2.1-rc.2`;macOS 桌面端 `0.2.2-rc.2` 及以上实测通过,保留旧 Web 接口兜底 |
278
+ | 平台 | macOS 已验证;Windows / Linux 依赖相同的 git 命令行为,理论兼容 |
279
+ | 主题 | 跟随深浅主题(使用 `--dsw-alias-*` 主题 token) |
280
+ | 语言 | 简体中文 / English,跟随 DSH locale |
281
+ | 图标 | `package.json` 顶层 `icon`(包内 `icon.png`,448×448,≤256 KiB) |
282
+ | 数据作用域 | 「便笺」「待办」按工作区目录共享;无 `cwd` 的会话降级为会话级隔离;折叠与开合记忆按会话保存 |
283
+ | 子代理会话 | 使用官方 `subagentchat` 资源在右侧栏打开;旧版没有该接口时给出失败提示,不替换主会话 |
284
+ | 计划清单数据源 | 会话日志里的 `exit_plan_mode`(`tool/call` / `tool/result` / `plan/mode`);上游审批语义变化时需复查状态推导 |
285
+ | 关联插件 | [dsh-account-usage](https://github.com/Ycet/dsh-account-usage)、[dsh-codex-subscription](https://github.com/WSL043/dsh-codex-subscription)、[dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar)(`0.32.0` 起协同) |
210
286
 
211
- ![alt text](docs/module-notes_02.png)
287
+ 桌面端兼容性验收记录见 [docs/desktop-compatibility-0.14.7.md](docs/desktop-compatibility-0.14.7.md)。
212
288
 
213
- #### 「待办」模块
289
+ ---
214
290
 
215
- ![alt text](docs/module-todo.png)
291
+ ## 🔧 技术栈
216
292
 
217
- ### 其他界面
293
+ | 类别 | 内容 |
294
+ | --- | --- |
295
+ | Host 侧 | Node.js ESM、`ctx.webServer` 前缀路由、`ctx.settings`、`ctx.subagents` / `ctx.agents`、`ctx.commands`(压缩)、`ctx.subprocess`、`ctx.llm`(AI 生成提交信息) |
296
+ | Client 侧 | ModuleLoader bundle、React(`react.createElement`)、Cordis Slots(`conversation.session.header.utilities` / `shell.overlay`)、CSS 主题变量;不新增 slot |
297
+ | 数据来源 | 会话投影(`sessions` / `workspaces` / `modelDirectories`)+ 自有 host API(git / MCP / 子代理 / 计划 / 压缩 / 交接)+ dsh-account-usage 路由(缺失时回退官方账户服务) |
298
+ | 测试 | `node --test`(git 解析、MCP、状态推导、计划推导、设置收敛、信任围栏、界面接线等,位于 `test/`) |
218
299
 
219
- #### hud设置界面
300
+ ---
220
301
 
221
- ![alt text](docs/hud-settings.png)
302
+ ## 🧪 开发与测试
222
303
 
223
- #### 「git graph」界面
304
+ ```bash
305
+ # 语法检查
306
+ node --check lib/index.js && node --check lib/client.js
224
307
 
225
- ![alt text](docs/git-graph.png)
308
+ # 全量用例
309
+ npm test
310
+ ```
226
311
 
227
- #### 「git commit」界面
312
+ 当前基线:**727 tests / 724 pass / 0 fail / 3 skipped**。
228
313
 
229
- ![alt text](docs/git-commit.png)
314
+ ```
315
+ dsh-awesome-hud/
316
+ ├── lib/index.js # Host:路由、git / MCP / 子代理 / 压缩 / 交接 / 设置读写
317
+ ├── lib/settings.js # 设置模型与收敛(序号、置顶、面板、便笺、git)
318
+ ├── lib/client.js # Client:面板、模块、设置弹窗、说明页、更新日志页
319
+ ├── assets/icons/ # 面板与菜单图标(宿主资产路由)
320
+ ├── cordis.patch.yml # 插件声明与默认配置
321
+ └── test/ # node --test 回归
322
+ ```
230
323
 
231
- #### 「计划清单」界面
324
+ ---
232
325
 
233
- ![alt text](docs/plan-content.png)
326
+ ## 🔗 关联插件
234
327
 
235
- ## ⚙️ 兼容性
328
+ | 插件 | 作用 |
329
+ | --- | --- |
330
+ | [dsh-account-usage](https://github.com/Ycet/dsh-account-usage) | 提供 DeepSeek 余额与 OpenCode Go 用量(缺失时回退 DSH 官方账户服务) |
331
+ | [dsh-codex-subscription](https://github.com/WSL043/dsh-codex-subscription) | 提供 Codex 额度(5 小时 / 每周 / 免费额度) |
332
+ | [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) | 右侧栏协同:面板与侧栏互斥,git 变更文件的 diff 可回退到其工作树标签页 |
236
333
 
237
- 桌面端测试环境、功能覆盖范围与复验方法见 [v0.14.7 桌面兼容性验收记录](docs/desktop-compatibility-0.14.7.md)。
238
-
239
- | 项目 | 版本/说明 |
240
- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- |
241
- | DeepSeek Harness | macOS 桌面端 `0.2.2-rc.2` 实测通过(`engines.dsh: >=0.2.1-rc.2`);保留旧 Web 接口兜底,其他版本仍需验证 |
242
- | dsh-client-ui-subagent | 子代理会话使用官方 `subagentchat` 资源在右侧栏打开;旧版不具备该接口时显示失败提示,不替换主会话 |
243
- | dsh-plan-mode | 计划清单数据源:会话日志`exit_plan_mode` 工具调用(`tool/call`/`tool/result`/`plan/mode` 事件);上游审批语义变更时需复查状态推导 |
244
- | dsh-better-sidebar | `0.32.0`(通过公开服务 `ctx.betterSidebar` 监听面板状态,与官方右侧栏共同参与 HUD 派生可见性;点击 HUD 按钮时依赖其折叠按钮 DOM 特征自动收起,失败时面板保持隐藏、待侧栏关闭后恢复,不影响 HUD 独立使用;v0.17.0 起左键点击 git 变更文件优先打开官方「第 N 轮改动」review,官方 review 不可用时回退到 `ctx.betterSidebar.openTab` 的工作树 diff tab) |
245
- | 平台 | macOS 已验证;Windows/Linux 仅理论兼容(git 命令行为一致) |
246
- | 主题 | 跟随深浅主题(使用`--dsw-alias-*` 主题 token) |
247
- | 语言 | 简体中文 / English,跟随 DSH locale |
248
- | 图标 | `package.json` 顶层 `icon`(包内相对路径 `icon.png`,448×448 PNG,原始字节 ≤256 KiB);需 DSH 支持 manifest 图标,更旧版本回落默认图标 |
249
- | 数据作用域 | 「便笺」「待办」按工作区目录共享(`localStorage`);无 `cwd` 的会话降级为会话级隔离 |
250
- | 面板开合状态 | 按会话 id 独立持久化(`dsh-awesome-hud:open`,值为 `{ "会话 id": "1"|"0" }`);新建会话页不持久化;可见性 = 展开记忆 ∩ 官方/better-sidebar 右侧栏均收起 |
334
+ ---
251
335
 
252
- ## 🔧 技术栈
336
+ ## ⬆️ 升级说明(v0.11.x → v0.21.2)
253
337
 
254
- | 类别 | 内容 |
255
- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
256
- | Host 侧 | Node.js ESM、`ctx.webServer` 前缀路由、`ctx.settings`、`ctx.subagents`、`ctx.agents` / `ctx.commands`(压缩命令)、`ctx.subprocess`、`ctx.llm`(AI 生成提交信息) |
257
- | Client 侧 | 原生 JavaScript ModuleLoader bundle、React(`react.createElement`)、Cordis Slots(`conversation.session.header.utilities` / `shell.overlay`)、CSS 主题变量;不新增 slot,新建会话页入口复用 `shell.overlay` |
258
- | 数据来源 | 客户端会话投影(`ctx.sessions.list` / `workspaces` / `modelDirectories`)+ 自有 host API(git / MCP / 子代理 / 计划清单 / 压缩)+ dsh-account-usage 余额/用量路由(复用,缺失时回退官方 `deepseekAccount`) |
259
- | 测试 | `node --test`(git 解析、MCP 解析、状态推导、计划清单推导、设置收敛、信任围栏、git 文件动作;位于 `test/`) |
338
+ <details>
339
+ <summary>按版本查看各版本改动要点</summary>
260
340
 
261
- ## ⬆️ 升级说明(v0.11.x → v0.21.1)
341
+ **v0.21.2:思考等级合并标签、按会话折叠、子代理与产物归属修复**:① 会话模块的模型名与思考等级合并为**一个标签**(如 `deepseek-v4.1-flash:Max`):最低启用档灰色、最高档紫色、其余档位与默认档蓝色,未设置等级显示 `Default`,关闭思考或模型没有思考档位时只显示灰色模型名(旧的灰底等级胶囊与 `resolveEffortLabel` 已移除)。② HUD 各模块的折叠/展开状态改为**按会话保存**(localStorage 新键 `dsh-awesome-hud:folds:v2`,最多保留最近 200 个会话,旧全局键读取时清理、不迁移):新建会话页与刚创建的会话默认展开上下文、任务、子代理任务、计划清单与产物,默认折叠用量、git、便笺、待办与 MCP;新建会话页上的手动改动用内存态保存、由在该页创建的会话继承,重新进入新建会话页时恢复默认。③ 修复 git 变更树点击目录/文件后行内按钮不隐藏:可见性从 `:focus-within` 改为鼠标悬浮或键盘可见焦点(`:has(:focus-visible)`),鼠标点击不再触发,Tab 聚焦时按钮仍可用。④ 子代理任务改为在右侧栏**当前分栏**以标签页打开(移除 `preferNewPane: true`),不再多开一列;同一子代理已打开时切到已有标签。⑤ 「产物」改为严格会话级:只取 DSH 每轮改动摘要与本会话 `write` / `edit` 写出的路径(durable 事件,重启 DSH 后仍可重建),不再扫描工作区——同工作区其它会话的产物、以及你自己编辑过的文件都不会混入;终端命令生成的文件不再自动收录。⑥ 说明页「HUD 面板」「上下文」「git」三节文案同步;新增 `test/session-model-badge`、`test/git-hover-actions`、`test/subagent-open`、`test/folds-session` 四组用例,并把产物用例改写为会话可归因口径。⑦ **初始化仓库时创建或补全 `.gitignore`**:工作区没有该文件就按通用模板新建(与右键「add to .gitignore」同一份模板),已有文件只追加缺失的通用项、原有规则与换行风格保持不动,且**写入失败不影响建仓成功**(接口回 `gitignore.mode=failed` 并在界面给一条红色提示);已是仓库的幂等分支不碰该文件;同时 Git 模块改为**进入会话页立即占位**——快照未到时标题行不摆分支/初始化按钮、正文提示「正在加载 git 状态…」,数据到达后自动切换,切换会话不再整块迟到。⑧ **上下文模块新增「交接」**:「压缩」改为拆分按钮(文字区 │ 1px 分割线 │ 下拉图标),点文字区仍是压缩,点下拉图标在按钮下方弹出圆角菜单,选「交接」即在当前会话派一个 **fork 子代理**(沿用当前会话模型、继承会话已完成轮次的日志)把交接文档写到工作区 `docs/handoff/`,提示词内置(用户给定原文 + 末尾一句「用会话主要语言书写」),子代理以 `delivery=caller` **静默结束、不向主会话投递消息**,进度在「子代理任务」模块可见;无存活 agent / 无 fork 提供者 / 并发或深度超限分别返回 404 / 503 / 409 并给可读提示,会话运行中「压缩」与「交接」一起置灰。⑨ **任一模块都可置顶**:HUD 设置左栏每张卡片的名称与复选框之间新增图钉按钮(DSH 官方置顶 / 取消置顶图标),置顶即把该模块移到排序首位并在面板里固定显示在「会话」模块下方——最高 **40vh**、超出在固定区内滚动、标题行照常吸附;同时只允许一个模块置顶(其它图钉置灰),置顶卡锁定首位不可拖;未保存取消置顶回原位、保存后取消留在首位可继续手动排序、取消勾选被置顶模块自动取消置顶、「恢复默认设置」一并清空置顶;旧设置项「上下文模块位置固定」已移除,升级前开启过的用户读侧迁移为「上下文置顶」。新增 `test/module-pin`、`test/handoff`、`test/git-init-gitignore` 三组用例,并把原 `test/context-pin` 改写为通用的模块置顶用例。⑩ **AI 生成提交信息不再读取当前会话上下文**:生成输入只有 commit 弹窗里的提示词与暂存区 diff,项目名与版本仍取自 `package.json`;默认提示词删掉会话上下文段落,「对话里指定的备注」也不再作为依据,`{{sessionContext}}` 从可用占位符列表移除(旧自定义提示词里残留的该占位符仍替换为空串,不会漏进提示词正文),弹窗的占位符说明、提示词说明、二次确认提示与说明页 git 一节同步改写;`sessionId` 仍作为路由元数据随请求发出,但宿主不再读取会话事件。新增用例把关「生成函数内不出现 sessions 与上下文提取」以及「旧提示词的占位符被清空」。基线:727 tests / 724 pass / 0 fail / 3 skipped。
262
342
 
263
343
  **v0.21.1:便笺弹窗与图片拖动修复、git 提交与忽略优化**:① 便笺内容编辑弹窗(以及便笺确认弹窗、HUD 设置弹窗、git graph 弹窗)改为「在遮罩上按下并在遮罩上松开」才关闭:在便笺标题或正文输入框里按下拖动选中文字、指针移到弹窗外再松手,不再误关弹窗(旧实现只看 click 的 target,而浏览器会把这种点击派发到按下与松开目标的共同祖先=遮罩)。② 便笺图片拖动排序松手后直接落位——落位那一帧给缩略图栏加 `data-settling` 临时关闭 transform 过渡,被拖图片与其余让位图片都停在拖动预览的位置,不再左右抽动;拖动过程中的让位动画保持不变。③ 工作区没有变更文件时「commit」按钮不再置灰,仍可点击打开 commit 弹窗:弹窗内的「AI generate」与「commit」按钮按暂存状态置灰,统计行换成「暂存区没有可提交的变更」,用户可以照常查看、修改与保存 AI 生成提示词(提示词区域仍默认折叠)。④ AI 生成提交信息改为**沿用项目当前版本号**:默认提示词把日期(YYMMDD)与「版本号取项目版本文件里记录的当前版本号、不要递增」直接写进正文,可在弹窗里直接改写;生成后宿主把日期前缀同步为当天、把版本号校正为项目当前版本(模型自作主张升版会被拉回,不再有「版本未递增」重试与告警);编辑保存自定义提示词后完全按用户提示词生成(不再补日期前缀、不再校正版本号);`{{today}}`、`{{project}}`、`{{spec}}`、`{{sessionContext}}` 四个占位符继续由宿主注入,但自定义提示词下 `{{project}}`/`{{sessionContext}}` 只提供事实与上下文(旧版会注入「版本号必须严格大于当前版本」「备注仍须符合严格递增规则」等内置规则,导致用户的版本规则被盖掉),并在 system 末尾追加「本提示词是唯一规则来源,提示词内部冲突时以靠后的说明为准」,让末尾追加的规则真正生效;默认模板路径的注入文本保持原样。另外 commit 弹窗也支持点遮罩关闭——与其它弹窗同一套安全判定,在输入框里拖选文字后移出弹窗松手不会误关。⑤ git 模块的「git graph / commit / revert」三个按钮改为等宽三等分、共同铺满模块内容宽(与便笺按钮行对齐);分支按钮改为固定 88px,分支名过长以省略号截断,不再随分支名伸缩。⑥ 变更文件与文件树文件夹的右键菜单新增「添加至 .gitignore」(图标为 `assets/icons/ignore.svg`):写入当前仓库根的 `.gitignore`(没有则按通用模板新建:`.DS_Store`、`Thumbs.db`、`desktop.ini`、`.codegraph`、`node_modules/` 与 npm/yarn 调试日志),规则以 `/路径` 锚定仓库根、目录以 `/路径/` 忽略整棵子树,重复规则不重复写盘;只追加规则、不改动暂存区(不执行 `git rm --cached`),被跟踪或已暂存的文件只写规则并额外提示需要手动取消跟踪。文件夹右键菜单同时补齐「添加至暂存区 / 撤销更改 / 移出暂存区」。⑦ 未跟踪文件的状态徽章由没有边框的裸「?」改为与其它状态同款的「U」胶囊——原来的 `data-kind="?"` 属性选择器在 CSS 里非法,样式一直没生效。⑧ 说明页「git」一节补充未跟踪状态字母 U、右键加入 .gitignore、无暂存文件也能打开 commit 弹窗三条要点,并改写提示词一节;更新日志页新增本版本条目。新增 `test/note-dialog-dismiss.test.mjs`、`test/note-image-settle.test.mjs`、`test/git-commit-empty.test.mjs`、`test/git-layout.test.mjs`、`test/gitignore.test.mjs` 与 `test/git-ignore-ui.test.mjs`,并更新 git 菜单、状态徽章、设置弹窗关闭、说明页与更新日志相关用例。基线:673 tests / 670 pass / 0 fail / 3 skipped。
264
344
 
@@ -369,6 +449,10 @@ dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/d
369
449
 
370
450
  如介意旧键占用的空间,可在确认迁移完成后于浏览器控制台执行 `localStorage.removeItem("dsh-awesome-hud:workspace-migrated")`,再删除 `dsh-awesome-hud:notes` / `dsh-awesome-hud:todos` 中「非工作区路径」的旧键(删除后无法再回滚迁移)。
371
451
 
452
+ </details>
453
+
454
+ ---
455
+
372
456
  ## 📄 许可证
373
457
 
374
458
  [MIT](LICENSE)
Binary file
Binary file