DeepSeek Harness 插件

Ycet/dsh-awesome-hud

Star 数 ★ 5 下载量(近 30 天) 1,156 分类 UI 增强 收录于 2026-11-16 npm dsh-awesome-hud

聊天页右上角的悬浮 HUD 面板:会话状态、上下文占用与一键压缩、git 分支与变更(提交 / 回滚 / graph)、子代理任务、待办与计划清单、MCP 全局启停、按工作区共享的便笺,以及按 profile 持久化模块可见性的 HUD 设置。

安装

# npm 包(预构建)

dsh plugin --profile web add dsh-awesome-hud

# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)

dsh plugin --profile web add github:Ycet/dsh-awesome-hud

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。

README

为 DeepSeek Harness Web / 桌面端聊天页打造的悬浮 HUD 面板:会话状态、上下文占用与一键压缩、git 变更、子代理、任务与 MCP 启停,一目了然。

HUD在dsh中的效果(浅色主题)

alt text

HUD在dsh中的效果(深色主题)

alt text


[!NOTE] 一个 DSH Web 插件(dsh.bundle.patch 通道安装)。浏览页面右上角新增「HUD面板」按钮,点击开合悬浮面板;面板与官方右侧栏及 dsh-better-sidebar 右侧栏互斥协作,互不遮挡、不额外挤占正文。

📑 目录


✨ 功能列表

模块 说明
会话 当前工作区名称、会话名称、会话状态(任务中/待审批/空闲中/待回答/等待子任务)、模型提供商/模型名/推理等级;工作区名称与会话名称均为悬浮变灰的可点击按钮——点击在鼠标位置打开操作菜单(工作区:重命名 / 在 Finder·资源管理器中显示 / 复制路径;会话:置顶或取消置顶 / 重命名 / 分支会话 / 复制会话 ID / 复制会话名称 / 归档会话;复制类操作之前与「归档会话」之前各有一条分割线),选择重命名后名称原位变为输入框、失焦即提交(Enter 提交、Esc 取消,不再有取消/确认按钮),会话置顶后名称右侧显示小图钉;新建会话页不展示会话标题与状态;右上角「HUD 设置」打开左右分栏的设置弹窗(左栏模块启停与拖动排序,右栏「HUD面板通用设置(HUD 面板样式:卡片样式/边栏样式,默认卡片样式;HUD 面板展开位置;两处默认开合)/ 「上下文」模块设置 / 「用量」模块设置 / 「便笺」模块设置(便笺条数上限,5–20,默认 5;在弹窗页面中进行便笺内容编辑,默认关闭))」卡片,顶部「使用说明」/「更新日志」标签页分别提供内置上手指引与按版本分组的更新记录)
上下文 上下文占用进度条(默认单色:0–40% 绿 / 40–90% 黄 / >90% 红;悬浮时切换为分段样式并显示 breakdown 提示:System prompt / Tool definitions / Messages,分别使用石青/紫/蓝);标题右侧展示「当前占用 / 最大上下文(占用率)」(如 199K / 1M(19.9%)),底部两行分别展示会话统计(轮/步 · tok/s)与 Token 用量(总量 · 缓存命中),悬浮两行显示完整统计/用量提示;一键「压缩」当前会话上下文;进度条常显分段、两行信息的显隐可在 HUD 设置中调整;标题行与右侧箭头可折叠该模块(折叠后只保留标题与占用率,折叠状态持久化,位置固定模式下同样生效)
用量 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 行按各自安装/登录状态独立展示(无数据时整组不渲染,数值可点击打开对应设置页)
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 为行内二次确认)
产物 列出当前会话所有轮次改动过的指定格式文件(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」之前
子代理任务 当前会话全部后代子代理(按层级缩进)、执行中(黄)/已完成(绿)状态,点击在官方右侧栏打开子代理会话,保留主会话;仅在有子代理时展示;超过 3 个时默认只显示 3 个,第 3 个下方给出「展开其余 n 个子代理」,展开后末行下方给出「收起」
任务 当前会话待办任务列表、已完成/待完成状态与计数(如1/3),随任务列表实时刷新;进行中任务显示旋转动画图标,底部展示「已完成/进行中/待处理」三态计数(含 0 恒显);仅在有任务时展示;已完成的任务统一移到列表最下方并默认折叠(组内先完成的在上、后完成的在下),点「展开已完成任务」查看,展开后末行下方给「收起」
计划清单 当前会话通过 plan 模式(exit_plan_mode)产出的全部计划:待审批(黄)/已执行(绿)/已废弃(灰、划线淡色)三态标签,标题栏展示计划总数,点击行弹出计划全文弹窗,模块底部展示「已执行/待审批/已废弃」三态计数(含 0 恒显);仅在有计划记录时展示;超过 3 条时默认只显示 3 条,第 3 条下方给出「展开其余 n 条计划」,展开后末行下方给出「收起」
MCP 接入的全部 MCP 服务及 dsh 全局启用状态;开关经 DSH 插件管理器直接启停 dsh 全局的 MCP 服务(按行写入 profile cordis.patch.yml 并完成热重载,即时生效、无需刷新页面、不影响其它服务)
便笺 按工作区共享的多条便笺(同一工作区目录下所有会话共用同一组便笺,本地持久化,重启 DSH 后仍在;旧单便笺升级后自动迁移为「便笺1」)。便笺条列表:每条是圆角便笺条,左侧拖动条可按住上下拖动排序,右侧悬停显示删除按钮(键盘聚焦同样显示,触屏常显);点击便笺条即可进入编辑(默认在模块内打开编辑视图;开启「在弹窗页面中进行便笺内容编辑」后改为弹窗编辑,便笺模块始终停留在列表视图);空列表显示空文案。功能按钮:两行——第一行「从聊天创建」「添加便笺」各占一半宽,第二行「删除全部便笺」铺满;便笺数量达到上限(HUD 设置「便笺」卡片可调,5–20,默认 5)时新建只 toast 提示;「从聊天创建」用会话输入框的文字与图片新建便笺(只复制、不清空输入框,创建后直接进入编辑视图;输入框无内容时置灰);「添加便笺」直接进入空白便笺的编辑视图;删除单条时行内把删除按钮换成取消与确认按钮(确认图标为红色对勾),点击确认后才删除;删除全部仍弹窗二次确认。便笺内容编辑视图:默认在模块内展开(返回按钮回列表);开启「在弹窗页面中进行便笺内容编辑」后改为弹窗编辑——右上角关闭按钮或点击弹窗外侧关闭(需在遮罩上按下并松开,拖选文字不会被误关),改动即时保存,弹窗布局与内联视图一致(标题、图片区、固定高度的内容输入框、清空 / 从聊天导入 / 添加至聊天),「添加便笺」与「从聊天创建」新建后也直接打开弹窗;标题可改(为空时自动生成「便笺n」,编号取当前列表最大「便笺n / Note n」编号 +1,删除最大编号后会复用该编号)、图片区(最多 20 张,可粘贴、点击看大图、悬浮移除,按住缩略图左右拖动可排序(松手后直接落位,不再左右抽动))、文字输入框(不限制字数,保留底部拖拽手柄且所有便笺共用同一高度)、「清空」二次确认(一次清掉文字与图片)、「从聊天导入」先清空当前便笺再写入输入框内容(便笺非空先确认,非图片附件跳过)与「添加至聊天」先清空输入框再写入便笺内容(输入框非空先确认,图片按便笺顺序加入);折叠/展开状态持久化;设置保存时允许把上限调到低于部分工作区现有便笺条数(照常保存);这类工作区已有便笺保留不变,但不能再新建便笺
待办 按工作区共享的待办清单(同一工作区目录下所有会话共用一份清单与顺序,本地持久化);勾选完成/恢复、点击文字即可编辑、添加/删除(删除时行内二次确认)、整行拖拽排序(拖动手柄位于行最左侧;拖动时其余条目实时让位,直观预览松手后的顺序)、一键清空已完成(二次确认,空列表置灰);底部展示完成计数;已完成的待办统一移到列表最下方并默认折叠(组内保持原有先后),点「展开已完成待办」查看,展开后末行下方给「收起」,拖动只在未完成区段内重排;折叠/展开状态持久化

互斥协作:HUD 面板与官方右侧栏、dsh-better-sidebar 右侧栏互斥协作。右侧栏展开期间,HUD 面板派生隐藏——只是临时不可见,不改写该会话的展开记忆,正文也不会被额外推挤留白;关闭右侧栏后,面板按展开记忆自动恢复(除非此前手动收起过 HUD)。点击「HUD面板」按钮时若右侧栏已打开,则先自动收起侧栏再展示 HUD(若版本兼容性导致自动收起失败,面板保持隐藏,待右侧栏关闭后自动出现);新建会话页在右侧栏展开期间不显示该悬浮入口。面板配置为左侧时(见「HUD面板通用设置」),窄窗口下左侧会话列表的遮罩抽屉展开期间面板同样临时隐藏,关闭抽屉后自动恢复(仍不改写展开记忆)。面板外观可在「HUD面板通用设置 → HUD 面板样式」中切换:卡片样式(默认)保持圆角悬浮卡片;边栏样式下 HUD 面板通高贴边、透明无圆角,与内容区之间只留一条分隔线,模块之间的分隔线左右各缩进 14px,滚动条停在内容区右缘。

🚀 快速开始

方式一:从 npm 安装(推荐,支持插件页一键更新)

# 1. 安装(无需 git;本机需有 pnpm,dsh plugin 会调用它)
dsh plugin --profile web add dsh-awesome-hud@0.21.1

# 2. 重启 DSH Web 服务并刷新页面

[!NOTE] 从 npm 安装的副本可以在插件页直接升级:打开「插件 → 已安装」,有新版本时卡片显示「可更新」,详情页提供「更新到」。从 GitHub tag 或 Release 压缩包安装的副本不支持页内更新,需要先卸载再重新安装。

方式二:从 GitHub 远程安装(tag 固定;无 npm 账号时可用,不支持页内一键更新)

# 1. 安装(锁定版本 tag,要求本机 git 可访问 GitHub)
dsh plugin --profile web add "github:Ycet/dsh-awesome-hud#v0.21.1"

# 2. 重启 DSH Web 服务并刷新页面

方式三:从本地源码安装(开发)

# 1. 安装(将 <absolute-path-to-plugin> 替换为本地源码目录绝对路径)
dsh plugin --profile web add "dsh-awesome-hud@link:<absolute-path-to-plugin>"

# 2. 重启 DSH Web 服务并刷新页面

方式四:从 Release 资产安装(tarball,无需 git、无需 npm 账号)

# 1. 安装(可直接用 Release 资产 URL,也可先下载 .tgz 再传本地路径)
dsh plugin --profile web add "https://github.com/Ycet/dsh-awesome-hud/releases/download/v0.21.1/dsh-awesome-hud-0.21.1.tgz"

# 2. 重启 DSH Web 服务并刷新页面

安装完成后,聊天页右上角(「打开工作区」按钮左侧)出现「HUD面板」按钮,点击即可开合。

[!NOTE] HUD 面板默认展开;每个会话各自记住自己的开合状态(按会话 id 存于 localStorage),在 A 会话收起不会影响 B 会话。新建会话页(尚未开始的空白会话)例外:该页每次进入都从收起状态开始(只改内存态、不写 localStorage,因此不影响任何会话的记忆),并在右上角提供独立的悬浮「HUD面板」按钮用于在该页展开(图片大图预览打开期间该按钮隐藏,避免浮在大图与预览关闭按钮之上)。面板样式、展开位置与模块可见性保存于 DSH profile 设置中,跨浏览器/设备随 profile 同步。

桌面端安装(macOS)

当前版本:0.21.1。先完全退出 DeepSeek Harness,再使用桌面应用自带的 CLI 安装;不要用旧 Web CLI 管理 desktop profile。优先从 npm 安装(可在插件页一键更新),本地开发时再改用源码目录:

# 从 npm 安装(推荐)
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add dsh-awesome-hud@0.21.1

# 从本地源码安装(开发)
"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" plugin --profile desktop add "dsh-awesome-hud@link:<absolute-path-to-plugin>"

重新打开应用后,在会话右上角点击「HUD面板」。Codex 额度需要另行安装并登录支持当前 DSH 版本的 dsh-codex-subscription;DeepSeek 余额优先来自 dsh-account-usage,未安装/未启用时回退 DSH 官方账户服务(需登录 DeepSeek 账号);OpenCode Go 用量与设置页页签来自 dsh-account-usage。

[!NOTE] 便笺文字、待办、折叠、面板设置和面板开合记忆保存在当前浏览器或桌面应用的 localStorage;便笺图片以原图存在同一来源的 IndexedDB(同样随重启保留、按工作区共享)。安装插件不会自动搬运 Web 浏览器中的这些数据;模型与登录凭据由 DSH 管理。

🧭 使用说明

  • HUD 面板:宽度 300px,内容超出时面板内部滚动(不展示滚动条),面板为常驻固定展示(正文与输入框按侧位让位)。外观由「HUD面板通用设置 → HUD 面板样式」决定:卡片样式(默认)为圆角悬浮卡片,高度上限为输入框底部(留 8px 底距),与窗口边缘留 8px 间距;边栏样式改为通高贴边(顶部自会话页眉下沿起、底部到窗口底部、外侧不留边距;新建会话页没有页眉,顶部从右上角按钮那一行的下沿起,不留空隙),面板透明无圆角,与内容区之间只保留一条 1px 分隔线,模块之间的分隔线左右各缩进 14px(模块内容与交互不变)。展开位置由「HUD面板通用设置 → HUD 面板展开位置」决定:右侧(默认)贴在窗口右侧,聊天内容与输入框自动向左让位;左侧时贴在会话区左缘(会话列表右侧,卡片样式留 8px 间距),正文与输入框向右让位;卡片样式下页面滚动条停在窗口最右缘,边栏样式下滚动条停在内容区右缘、紧贴分隔线;会话页右缘的「轮次导航」指示条仍停在正文右缘,面板都不会与正文重叠。右侧栏展开期间面板隐藏且不推挤正文,关闭后恢复。
  • 设置弹窗:「会话」模块右上角齿轮打开设置弹窗,顶部是**「HUD 设置」/「使用说明」/「更新日志」三个标签**(选中项带品牌色下划线,可随时切换);设置页为左右分栏:中间一条分割线,左栏是模块启停与排序,右栏是模块的具体设置。
    • 左栏:勾选控制「上下文 / 用量 / git / 子代理任务 / 任务 / 计划清单 / MCP / 便笺 / 待办」的显隐(「会话」模块恒展示),每张卡片左侧有拖动排序手柄(按住拖动调整该模块在 HUD 面板中的顺序,全局生效;拖动时其余卡片实时让位预览,松手才落盘)。左栏不随右栏滚动;弹窗高度随窗口自适应并压缩卡片间距,保证 9 张模块卡片始终全部露出。新建会话页不渲染的模块(上下文 / 子代理任务 / 任务 / 计划清单)在该页的设置里按真实状态展示、置灰不可点击(悬浮显示原因),其开关请在会话页调整。
    • 右栏:五个卡片式分区(内容过多时只滚动这一栏)。① 「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」「上下文模块不在模块排序首位」)。
    • 控件与页脚:右栏启停项使用 DSH 官方 Switch 样式(@deepseek-ai/dsh-client-ui-primitives,不可用时回退等价本地样式),「卡片样式/边栏样式」与「左侧/右侧」都使用官方分段控件。底部左侧的**「恢复默认设置」在当前设置与默认不同时激活,点击后在鼠标位置**弹出三项菜单:恢复所有设置、恢复 hud 模块启用状态、排序(只复位左栏)、恢复 hud 模块功能设置(只复位右栏:HUD 面板通用设置、上下文 / 用量 / git 变更 / 便笺模块设置);范围已是默认的菜单项置灰,选中后只改草稿,仍需点「保存设置」落盘。弹窗支持点击遮罩、右上角「关闭」或 Esc 关闭(关闭等同取消,不保存改动);点「保存设置」后写入并关闭(未改动时按钮置灰)。打开时焦点进入弹窗,Tab 在弹窗内循环,关闭后回到齿轮按钮。
    • 使用说明页:第二个标签是内置帮助页(「HUD 设置」标签用 assets/icons/settings-outline.svg 的描边齿轮,「使用说明」标签用 assets/icons/hint.svg 的提示图标,「更新日志」标签用 assets/icons/changelog.svg 的更新记录图标)——左侧 240px 目录(与设置页左栏同宽,两个标签切换时分割线不跳位;点击跳到对应小节,右侧滚动时目录自动高亮),右侧 12 个分节卡片(目录项与小节标题只用文字,不再配图标):HUD 面板、会话、上下文、用量、git、产物、子代理任务、任务、计划清单、MCP、便笺、待办;每节按「展示 / 功能」分组列出简短要点——模块展示哪些信息、有哪些可操作功能(分功能点),「HUD 面板」一节另含面板样式(卡片样式 / 边栏样式,默认卡片样式)要点与「设置」分组讲设置弹窗内容;便笺一节含便笺条列表 / 编辑视图 / 图片拖动排序 / 从聊天创建与导入要点,另有「设置」分组讲便笺条数上限(5–20,默认 5)与在弹窗页面中进行便笺内容编辑(默认关闭)。底部「恢复默认 / 保存设置」在说明页同样常驻(「保存设置」在本次未改动时置灰且样式与可保存态明显不同,「恢复默认」在无改动时置灰);切换标签不会丢失设置页未确认的改动,弹窗高度也保持不变——设置页在说明页下方保持挂载并提供高度基准,说明页以绝对定位覆盖在同一区域。
    • 更新日志页:第三个标签是版本记录页,版式与说明页一致——左侧 240px 版本号目录(最新版本在最上面,点击跳到对应版本,右侧滚动时目录自动高亮),右侧每个版本一张卡片,卡片内按主题分组列出要点(如「用量:折叠与插件依赖」「便笺与待办:拖动与删除」);最新版本的标题右侧带「最新」徽标。当前收录 v0.21.1、v0.21.0、v0.20.1 与 v0.20.0 四条;页面最多展示最新 20 个版本,更旧的版本记录会被清除,每次升版在页面顶部追加一条并删除第 21 条及更旧记录(新版本必须与 package.json 的 version 一致,测试会拦漏补并校验数量上限)。底部「恢复默认 / 保存设置」同样常驻,切换标签时弹窗高度不变;页面纯展示,不发请求、不写设置。
  • 会话模块:工作区名称与会话名称都是悬浮变灰的可点击按钮(两者的悬浮 / 点击热区都是整行宽度,只让出右侧的状态胶囊与齿轮按钮),点击后在鼠标位置打开菜单(菜单宽度 200px,贴近视口边缘时自动夹取到视口内;面板内部滚动或窗口缩放时菜单保持原位不跳动,点击外部、按 Esc 或再次点击标题即可关闭)。
    • 工作区菜单(左上角工作区名):重命名工作区(原位输入框,写入 DSH 工作区注册表,官方侧栏/选择器同步更新;与其它工作区同名时给出明确提示并退回原名)、在 Finder 中显示(macOS 为「在 Finder 中显示」,Windows 为「在资源管理器中显示」,其余平台为「在文件夹中显示」;原生打开由宿主执行,宿主不支持时该项置灰并提示原因)、复制工作区路径(复制项前有分割线,与上面两项分组)。
    • 会话菜单(会话名称):置顶会话 / 取消置顶(按当前状态切换文案与图标,置顶后名称右侧显示小图钉,效果与官方侧栏一致)、重命名、分支会话(与官方一致:创建后不跳转当前页,成功以 toast 提示;需要迁移源会话时提示先打开该会话)、复制会话 ID、复制会话名称。
    • 内联改名:点击「重命名」后名称原位变为输入框并自动全选,点击其他区域即提交(也支持 Enter 提交、Esc 取消);内容空白或未改动时不发请求,失败时退回原名并 toast 报错。新建会话页不展示会话标题与状态徽标,工作区菜单在该页同样可用(作用于推导出的目标工作区)。
  • 上下文:标题右侧按「当前占用 / 最大上下文(占用率)」展示,例如 199K / 1M(19.9%);进度条默认单色(0–40% 绿 / 40–90% 黄 / >90% 红),鼠标悬浮时切换为三段式并弹出 breakdown 提示(System prompt 石青色、Tool definitions 紫色、Messages 蓝色,数值为估算 token);底部两行分别是会话统计(轮数/步数 · tok/s)与 Token 用量(总量 · 缓存命中),悬浮时分别显示完整统计(模型用时、工具调用用时、首 token 平均、输出速度)和完整用量(缓存命中、未缓存输入、缓存读取、缓存写入、输出)。「压缩」在会话空闲时可用,运行中按钮禁用并提示原因;进度条常显分段、两行统计/用量的显隐可在 HUD 设置的「上下文」卡片中调整。
  • 用量模块:位于「上下文」模块下方,恒定展示(仍可在 HUD 设置中关闭)。DeepSeek 余额优先复用 dsh-account-usage 插件路由、未安装/未启用时回退 DSH 官方账户服务;Codex 复用 dsh-codex-subscription 的浏览器 RPC;面板打开时立即加载、之后每 60 秒轮询;数据均缩进展示并带对应图标;模块支持折叠,默认展开(折叠状态经 localStorage 持久化)。
    • DeepSeek 余额:展示余额合计(充值 + 赠送),点击具体余额数值可直接打开设置面板并进入「账号与余额」页(官方页不可用(未登录/旧版)时回退到「账户」分区),有 dsh-account-usage 页签时切换到 deepseek 页签、没有页签时静默停留在官方账户页。该行始终展示:优先使用 dsh-account-usage(需配置 DEEPSEEK_PLATFORM_TOKEN),未安装/未启用时回退 DSH 官方账户服务(需登录 DeepSeek 账号);无数据时数值显示 —,点击行为不变。
    • OpenCode Go 用量:三行分别展示 oc-go 5h / 1w / 1m 窗口用量百分比,点击具体百分比数值可直接打开设置面板并进入「账号与余额」页,切换到 opencode go 页签;仅当已配置 OpenCode Go Key 且订阅有效(/api/account-usage/opencode 返回 ok + keySource)时展示,无数据时整组不渲染(不可点击)。
    • Codex 额度:订阅账号展示 codex 5h额度 与 codex 周额度 两条剩余额度整数百分比;未订阅(免费)账号的 codex 额度只返回一个约 30 天的月度窗口,此时改为展示一条 codex 免费额度 行(取该窗口剩余百分比),不再展示 5h / 周额度——两类行互斥。订阅状态按额度窗口形状判定(出现 5h 或周窗口即视为已订阅),因为订阅插件的 RPC 不暴露套餐字段;月度窗口时长与预期不符时回退该额度首个可用窗口,保证有数据就不显示 —。三行均使用 ChatGPT 图标,点击百分比数值打开「设置:Codex 订阅」页面。仅当安装并登录 dsh-codex-subscription 时展示;已登录但额度请求暂时失败时按上一次的展示模式保留行并显示 —(订阅账号不会因此误显示为免费额度行),无法确认安装/登录状态时隐藏。
    • 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额度(名称)」)。该额度不存在时不展示该行;存在但窗口数据异常时保留行并显示 —。
    • 模块可见性与可配置内容:模块恒定展示;DeepSeek 余额行始终展示(数据来自 dsh-account-usage 或官方账户兜底,无数据时显示 —),OpenCode Go 与 Codex 仅在其数据源可用时渲染对应行——没有启用 dsh-account-usage 就不展示 OpenCode Go 额度,没有启用 dsh-codex-subscription 就不展示 codex 额度;这两项的开关在设置页里同时置灰、不可点击,原因以红字写在名称下方(区分「需安装并启用插件」与「已启用但未配置/未登录」)。全部无数据时模块内显示一行接入提示。展示内容与折叠后展示信息可在「「用量」模块设置」卡片中配置(host settings 持久化,随 profile 同步)。
  • git 模块:常驻展示——新建会话页与会话页都默认展示,工作区不是 git 仓库时也展示(标题栏右侧提供「初始化仓库」按钮,位置与分支按钮相同;点击后在该工作区执行 git init,成功后模块切换为仓库态:按钮变为分支按钮,正文出现动作区与变更统计,并由随后的轮询保持刷新;已是仓库时该按钮不出现)。每 5 秒随面板打开自动刷新(写操作后立即刷新);标题栏右侧分支按钮宽度固定(88px,分支名过长以省略号截断,鼠标悬停可看完整分支名),点击弹出下拉列表——可切换已有分支(当前分支高亮带勾标记;点击当前分支会提示「当前已在分支」而非静默关闭),或在输入框中输入新分支名点击「添加」创建并自动切换;「git graph」弹窗按每页最多 80 条分页展示当前仓库(全部引用)提交图(滑到列表底部出现「加载更多」按钮点击追加下一页,全部加载完后底部显示「已显示全部提交」提示);分支标签中,当前分支为蓝底白字,其他分支为灰底黑字;HEAD 指向版本以放大的白色填充圆点 + 蓝色描边标记。提交行右键菜单可复制短哈希(前 7 位)/全哈希(40 位)/提交标题,并提供以下受保护操作:
    • 从此处创建分支:点击后原菜单项位置展开为输入框 + 「取消」/「确认」图标按钮(输入框为空时确认按钮置灰)。输入合法分支名并点击确认后,以该提交为起点执行 git checkout -b <名称> <提交> 并切换到新分支:成功提示后菜单关闭、git 快照与提交图刷新,新分支标签随即显示为蓝底当前分支。分支名重复、或本地修改会阻止切换时给出提示(后者列出受影响文件)并保留输入内容,便于改名重试;不自动 stash、不强制切换。输入框内按 Enter 不触发创建,按 Escape 取消输入并恢复为原菜单项(再按一次关闭菜单);Git 操作(merge / rebase / cherry-pick / revert)进行中时该项置灰。
    • 合并至当前分支:先在原菜单项位置显示行内「确认?/取消」,确认后执行 git merge --no-edit;已包含提示「无需合并」、本地修改阻塞提示受影响文件、合并冲突自动 git merge --abort 回滚并列出冲突文件清单。
    • reset(soft)-保留暂存:仅可选择当前本地分支历史中、早于 HEAD 的提交;二次确认后以 git reset --soft 回退,所选提交之后的提交内容保留在暂存区。
    • reset(mix)-取消暂存:同样仅可回退至当前本地分支历史中的较早提交;二次确认后以 git reset --mixed 回退,所选提交之后的提交内容保留在工作区且不在暂存区。
    • reset(hard)-撤回更改:二次确认后以 git reset --hard 回退并丢弃所选提交之后的提交内容,以及已跟踪文件的未提交修改;未跟踪文件不会被删除。
    • reset 在未检出本地分支、Git 操作进行中、所选提交不在当前分支历史中或所选提交即为 HEAD 时不可用。变更文件按分组展示(状态字母按类型着色——修改 M 黄色、新增 A 蓝色、删除 D 红色、未跟踪 U 灰色,重命名 R / 复制 C 蓝色;未跟踪文件用 U 标识,与其它状态同为带描边的胶囊徽章):
    • 分组:staged(暂存区)与 changes(未暂存区,含未跟踪)两组,组名右侧灰色数字为组内文件数,并提供一键按钮:changes 组「+」暂存全部未暂存文件、staged 组「-」取消暂存全部暂存文件;某组无文件时该组不展示
    • 文件行操作:左键点击任一文件行在右侧栏打开该文件的 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」(写入 /目录/ 规则忽略整个目录)
    • commit:按钮始终可点——暂存区没有文件时也能打开提交弹窗查看或修改 AI 生成提示词,此时弹窗把暂存数量换成「暂存区没有可提交的变更」,并把 AI generate 与 commit 置灰;点击弹出提交弹窗(展示待提交暂存文件数量 + 多行输入框 + AI generate + commit),输入为空时 commit 置灰;Enter 仅换行,需点击 commit 才会提交;提交范围仅为暂存区
    • AI generate:固定调用 DeepSeek 官方 DeepSeek Flash 系列模型(deepseek-account 路由的 deepseek-flash,reasoningEffort: low),不再使用当前会话所选模型;首次点击只进入「确认?」并在按钮左侧显示说明,第二次点击才生成(3 秒内未确认自动复位,点击按钮外或按 Escape 取消),生成时按钮禁用。生成时结合暂存区全部 diff(超 16KB 截断)与当前会话最近对话上下文(用户直接消息与助手消息,供理解改动意图;若对话中用户明确指定了提交备注则直接采用),按内置本地 git 提交规范生成提交信息并填入输入框——格式 [YYMMDD] 开发项目名称 vX.Y.Z:修改内容(日期取系统当前时间;版本号沿用项目版本文件里记录的当前版本号,不做递增;项目名与当前版本取自工作区向上最近的 package.json);生成后宿主会把日期前缀同步为当天、并把版本号校正为项目当前版本,不会出现自作主张升版。默认提示词把日期与版本号规范写在正文里,可直接改写:未改动时按内置规范执行上述校正,编辑保存后完全按提示词生成(不再补前缀、也不再校正版本号),恢复默认即回到内置规范;自定义提示词时宿主只注入项目事实(项目名与当前版本号),不再向 system 里塞「版本号必须递增」之类的内置规则,并在末尾追加「本提示词是唯一规则来源,内部冲突时以靠后的说明为准」
    • revert:按钮在无任何未暂存变更(含未跟踪)时置灰;点击后二次确认弹窗列出全部受影响文件(未跟踪文件带 ? 前缀标识),确认后还原已跟踪文件的未暂存变更并删除未跟踪新建文件与 intent-to-add 预登记文件;若存在无法删除的目录条目(嵌套仓库/子模块),会明确提示并跳过,不再静默当作成功
  • 子代理任务模块:按层级缩进展示全部后代子代理;执行中状态徽章为黄色,已完成为绿色;点击条目在官方右侧栏打开对应子代理会话,保留当前主会话;嵌套子代理携带其直接父会话与会话模式。缺少侧栏接口时显示打开失败提示。
  • 任务模块:列表展示当前会话待办任务;进行中(in progress)任务行首为旋转动画图标(DeepSeek 官方同款,1s/圈,品牌蓝),已完成/待处理保持勾选与待办图标;模块底部展示「x 已完成 · x 进行中 · x 待处理」三态计数(含 0 恒显),标题栏保留「已完成/总数」计数。
  • 计划清单模块:位于「任务」模块下方,展示当前会话通过 plan 模式产出的全部计划清单(新→旧),仅在存在计划记录时展示;每 5 秒随面板打开自动刷新,状态由会话日志自动推导:
    • 待审批(黄色标签):计划刚产出、用户尚未审批;
    • 已执行(绿色标签):用户在计划审查中审批通过(exit_plan_mode 返回批准结论),进入执行阶段;后续退出 plan 模式不会改为废弃。此标签不代表所有步骤已经完成;
    • 已废弃(灰色标签、文字划线变淡):审查未通过——包括拒审/要求修改/打断审查(错误结果)、在计划审查卡片上点「要求修改」(关闭审查、回到输入框;DSH 0.2.1-rc.5 起该操作以成功结果 { approved: false } 返回且计划模式仍生效,HUD 立即判为已废弃),以及计划无审批结论但 plan 模式随后退出(如 /plan off)。兼容新版消息级错误标记、旧结果块、结果文案与 plan 模式退出信号;
    • 行主文字取计划首个 Markdown 标题,无标题时截取正文;点击任一行弹出计划全文弹窗(标题、状态、产出时间与正文,正文按轻量 Markdown 渲染,支持标题/列表/代码块/链接/引用与 GFM 表格);模块底部展示「x 已执行 · x 待审批 · x 已废弃」三态计数(含 0 恒显);模块可折叠,默认展开。
  • MCP 模块:开关控制 dsh 全局的 MCP 服务启停——经 DSH 官方插件管理器 pluginManager.setPluginEnabled 按行写入 profile cordis.patch.yml 并等待热重载完成,开关即时生效、无需刷新页面,只改目标服务、不改动其它插件配置;未启用 HMR 的 profile 会提示「重启后生效」;模块默认展开,无任何 MCP 服务时仍展示空状态。
  • 便笺模块:按工作区共享的便笺——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用一份内容与图片,含输入框高度),文字存 localStorage、图片以原图存 IndexedDB,重启 DSH 后依旧存在;删除或归档其中任一/全部会话都不影响该工作区其它会话的内容,下次在同一工作区新建会话时内容与图片依旧存在。输入框底部拖拽手柄可拖拽调整高度(实时持久化);不限制字数,底部也不再显示字数与图片张数。图片:直接在输入框里粘贴(image/*,最多 20 张;字节上限沿用宿主的会话内附件校验),缩略图在输入框上方横向滚动,点击看大图(Esc / 遮罩 / 关闭按钮退出),鼠标悬浮缩略图右上角出现移除按钮(触屏常显);「清空」或移除都会释放对应原图。从聊天导入(位于「添加至聊天」左侧):先清空便笺里的文字与图片(旧原图一并释放并删除 IndexedDB 记录),再写入当前会话/新建会话页输入框里的文字与图片,便笺非空时先弹确认,非图片附件会跳过并提示;输入框内容不清除,输入框为空时按钮置灰、只提示且不清空便笺。添加至聊天:先清空会话输入框里的文字与图片(逐个移除并释放旧附件),再写入便笺文字并按便笺顺序加入图片;输入框非空时先确认,为空则直接写入,成功后焦点回到输入框;便笺内容保留;清空后写入失败不回滚(保持已清空 + 已写入部分并提示)。有文字或图片时「清空」可用:首次点击进入红色确认态,二次点击后同时清掉文字与图片(点击其他区域、Escape 或 2 秒超时会取消)。模块可折叠/展开(状态持久化)。未归属工作区(无 cwd)的会话降级为会话级隔离,不与其它会话共享。便笺内容编辑弹窗与设置弹窗、git graph 弹窗一样,只有在遮罩上按下并在遮罩上松开才会关闭——在标题或正文输入框里拖选文字后移出弹窗外松手不会再误关弹窗;图片缩略图左右拖动排序松手后直接落位在拖动预览的位置,不再左右抽动。
  • 待办模块:按工作区共享的待办清单——以会话所在工作区目录为键保存(同一工作区目录下的所有会话共用同一份清单与顺序,本地持久化);每条待办为卡片式(1px 描边 + 浅底 + 10px 圆角,与「HUD 设置」里的模块卡片同款,行距 6px),删除按钮默认隐藏,鼠标悬浮该行时才出现,键盘聚焦(:focus-visible)也会显示;点击条目文字即可编辑,删除时行内二次确认(两者改为绝对定位浮层:文字独占整行宽度,悬浮时浮层以行底色实底铺在行右端、左侧 16px 渐隐把文字淡出,既不会被挤窄、也不会重新换行;触屏等无 hover 环境按钮常显并给文字留出右侧避让;鼠标拖动后不会再滞留);勾选完成/恢复、添加/删除项、整行拖拽排序(拖动手柄位于行最左侧勾选框之前,手柄热区覆盖整行高度,多行条目也能整列拖起;拖动时其余条目按真实行高实时让位,松手才保存顺序)、一键清空已完成(二次确认弹窗,无已完成项时按钮置灰);底部展示完成计数;模块可折叠/展开(状态持久化)。同一工作区多会话/多标签页同时编辑时按条目 id 归并,不会互相清空。
  • 折叠状态:各模块折叠/展开状态刷新页面后保持(localStorage);「会话」模块图标使用 DSH favicon。
  • 新建会话页:右上角提供独立悬浮「HUD面板」按钮(该页没有会话页眉;Windows 普通窗口中入口位于原生标题栏下方,全屏时取消该偏移)。该入口与聊天会话页保持同一顺序:始终排在右侧工具按钮簇左侧(装有 better-sidebar 时,其「底部面板」切换按钮排在入口右侧、两个页面的间距一致)——这让两个页面的入口位置看起来完全相同。图片大图预览打开时该按钮隐藏——预览是铺满视口的模态浮层(role="dialog" + aria-modal,如 dsh-codex-subscription 的图片查看器),而 HUD 入口的层级远高于它,不隐藏就会浮在大图与右上角预览关闭按钮之上;预览关闭后按钮自动恢复,面板开合状态不受影响(判定只看浮层语义与视口覆盖率,不绑定第三方类名)。该页每次进入都从收起状态开始,点击按钮后展开;面板固定贴右侧、宽 300px,输入框与正文左移让位,按钮保持原位。官方右侧栏(含 better-sidebar)展开期间,该悬浮入口与面板一并隐藏——入口不再移到侧栏左侧,也不再把展开态面板的位置写进定位;关闭侧栏后入口立即出现在打开侧栏前的位置,不会先闪到侧栏边缘,并回到该页此前的开合状态(除非已手动收起 HUD)。新建页的 Git、便笺、待办和便笺发送目标使用同一最近工作区;MCP 作为全局模块独立刷新,无会话或工作区时也可查看和启停。该页展示会话 / 用量 / git / 便笺 / 待办 / MCP 模块(git 常驻,目标工作区不是仓库时提供「初始化仓库」;「用量」模块恒定展示,DeepSeek 余额无数据时显示 —);尚无会话记录时不展示会话标题与状态徽标(工作区标题菜单照常可用)。进入真实会话后加载该会话自己的开合记忆,标题栏原按钮接管入口。

🖼️ 界面截图

各模块预览

「会话」模块

alt text

「上下文」模块

alt text

「用量」模块

alt text

「产物」模块

alt text

「git变更」模块

alt text

「子代理任务」模块

alt text

「任务」模块

alt text

「计划清单」模块

alt text

「MCP」模块

alt text

「便笺」模块

alt text

alt text

「待办」模块

alt text

其他界面

hud设置界面

alt text

「git graph」界面

alt text

「git commit」界面

alt text

「计划清单」界面

alt text

⚙️ 兼容性

桌面端测试环境、功能覆盖范围与复验方法见 v0.14.7 桌面兼容性验收记录。

项目 版本/说明
DeepSeek Harness macOS 桌面端 0.2.2-rc.2 实测通过(engines.dsh: >=0.2.1-rc.2);保留旧 Web 接口兜底,其他版本仍需验证
dsh-client-ui-subagent 子代理会话使用官方 subagentchat 资源在右侧栏打开;旧版不具备该接口时显示失败提示,不替换主会话
dsh-plan-mode 计划清单数据源:会话日志exit_plan_mode 工具调用(tool/call/tool/result/plan/mode 事件);上游审批语义变更时需复查状态推导
dsh-better-sidebar 0.32.0(通过公开服务 ctx.betterSidebar 监听面板状态,与官方右侧栏共同参与 HUD 派生可见性;点击 HUD 按钮时依赖其折叠按钮 DOM 特征自动收起,失败时面板保持隐藏、待侧栏关闭后恢复,不影响 HUD 独立使用;v0.17.0 起左键点击 git 变更文件优先打开官方「第 N 轮改动」review,官方 review 不可用时回退到 ctx.betterSidebar.openTab 的工作树 diff tab)
平台 macOS 已验证;Windows/Linux 仅理论兼容(git 命令行为一致)
主题 跟随深浅主题(使用--dsw-alias-* 主题 token)
语言 简体中文 / English,跟随 DSH locale
图标 package.json 顶层 icon(包内相对路径 icon.png,448×448 PNG,原始字节 ≤256 KiB);需 DSH 支持 manifest 图标,更旧版本回落默认图标
数据作用域 「便笺」「待办」按工作区目录共享(localStorage);无 cwd 的会话降级为会话级隔离
面板开合状态 按会话 id 独立持久化(dsh-awesome-hud:open,值为 `{ "会话 id": "1"

🔧 技术栈

类别 内容
Host 侧 Node.js ESM、ctx.webServer 前缀路由、ctx.settings、ctx.subagents、ctx.agents / ctx.commands(压缩命令)、ctx.subprocess、ctx.llm(AI 生成提交信息)
Client 侧 原生 JavaScript ModuleLoader bundle、React(react.createElement)、Cordis Slots(conversation.session.header.utilities / shell.overlay)、CSS 主题变量;不新增 slot,新建会话页入口复用 shell.overlay
数据来源 客户端会话投影(ctx.sessions.list / workspaces / modelDirectories)+ 自有 host API(git / MCP / 子代理 / 计划清单 / 压缩)+ dsh-account-usage 余额/用量路由(复用,缺失时回退官方 deepseekAccount)
测试 node --test(git 解析、MCP 解析、状态推导、计划清单推导、设置收敛、信任围栏、git 文件动作;位于 test/)

⬆️ 升级说明(v0.11.x → v0.21.1)

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。

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。

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。

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。

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。

v0.19.1:新增「产物 / Outputs」模块:① 面板新增第 10 个模块「产物」(英文 Outputs),默认位于「git」下方:汇总当前会话所有轮次改动过的文件(数据来自 DSH 官方 workspaceChanges 的每轮摘要),只保留工作区内、仍存在、扩展名在白名单内的条目——html / md / pdf / docx / csv / xlsx / pptx / cd / clark / jpg / jpeg / png / gif / webp / svg(大小写不敏感,共 16 种)。② 排序按最后一次改动倒序、同轮按路径字母序;最多展示 24 个,超出时列表底部提示「仅展示最近改动的 24 个文件」。③ 每行显示文件名(主)+ 目录(灰字小字);点击在官方右侧栏打开该文件内容(地址按 DSH 的 dsh-resource://file/session/<id>/<路径> 语法逐段编码,因此同一文件不会重复开 tab)。④ 降级明确:旧 DSH 缺少 workspaceChanges 或 sidebarRight 时,模块显示「当前 DSH 不支持读取本会话改动」而不是报错;点击打开失败给 toast;「无改动记录」与「能力不可用」是两种不同空态。⑤ 刷新与其它模块一致:面板打开期间每 5 秒轮询、切会话立即重拉;折叠状态随 localStorage 持久化;新建会话页不展示该模块(设置卡片显示为只读)。⑥ 旧 profile 的顺序在归一化时会把新模块插到 git 之后,其它缺失键仍按原规则追加,不必手动重排。⑦ 新增 test/outputs-module.test.mjs 十条回归(白名单与大小写、跨轮次并集与去重、24 条截断与排序、存在性检查与次数上限、坏事件容错、地址编码、宿主 schema/命令白名单/图标资产、客户端接线与说明页第 12 节、组件渲染与两种空态、点击打开的成功与失败分支),并更新 module-order、workspace-scope、settings-guide、settings-refresh。中英文 README 与内置「使用说明」页同步更新。测试基线:497 tests / 494 pass / 0 fail / 3 skipped。

v0.19.0:便笺模块支持图片与从聊天导入、取消字数上限,按钮固定两行:① 便笺取消 5000 字上限,底部也不再显示字数;输入框可直接粘贴图片(image/*,最多 20 张,字节上限沿用宿主的会话内附件校验):缩略图在输入框上方横向滚动、点击看大图(Esc / 遮罩 / 关闭按钮退出)、悬浮右上角出现移除按钮;图片以原图写入 IndexedDB(按工作区键一条记录),文字仍存 localStorage,因此同一工作区共享、重启 DSH 后仍在;IndexedDB 不可用时降级为内存并提示。② 新增**「从聊天导入」按钮(位于「添加至聊天」左侧):先清空便笺里的文字与图片(旧原图一并释放并删除 IndexedDB 记录),再写入当前会话/新建会话页输入框里的文字与图片;便笺非空时先确认,非图片附件跳过并提示,输入框内容不清除;输入框里没有文字或图片时该按钮置灰,源为空时只提示、不清空便笺。③ 「添加至聊天」同为两段式:先清空会话输入框(文字与全部旧图片,逐个 removeAttachment 并 releaseDraftAttachments,释放预览 URL 与上传),再写入便笺文字并按便笺顺序加入图片;输入框非空时先弹确认,为空则直接写入,成功后焦点回到输入框,便笺内容保留;清空后写入失败不回滚(保持已清空 + 已写入部分并提示)。④ 便笺按钮固定两行——「清空」独占上一行,「从聊天导入 / 添加至聊天」下一行各占一半宽度(中英文界面布局一致);输入框里没有文字或图片时「从聊天导入」置灰。⑤ 便笺图片与便笺文字都会随 profile / 浏览器来源持久化。⑥ 新增 test/note-images.test.mjs、test/note-transfer.test.mjs、test/note-overwrite.test.mjs、test/note-input-plain.test.mjs 四组回归(便笺图片粘贴/上限/IndexedDB/降级/清空/灯箱、双向搬运「先清空再写入」的调用顺序与失败降级、便笺覆盖的两段式与存储失败分支、便笺输入框只收纯文本与图片),并更新 panel-settings、settings-dialog-layout、settings-guide、settings-persistence、settings-refresh、note-clear、turn-navigation-layout、desktop-compat 等相关用例。中英文 README 与「使用说明」页同步更新。测试基线:484 tests / 481 pass / 0 fail / 3 skipped。 v0.18.7:待办文字铺满整行、标题热区、菜单细节与「上下文模块位置固定」:① 待办条目的编辑 / 删除按钮此前即使隐藏也保留约 60px 占位**(约占整行 1/4),多字待办被迫提前换行。现在两个按钮改为绝对定位浮层:文字独占整行宽度,悬浮 / 键盘聚焦时浮层出现在行右端,并以行底色实底铺满按钮区(底色抽成 --hud-todo-bg 变量,卡片与浮层严格同色),左侧再挂 16px 渐隐伪元素、让文字在按钮之前就淡出——先前只给容器一条 14px 渐变,淡出区正好落在第一个图标下方,看起来像文字压着按钮;文字不会被硬切、也不会因为悬浮而重新换行;拖动中的行不显示浮层;触屏等无 hover 环境按钮常显,同时给文字加 60px 右侧避让,避免常显按钮盖字。② 会话名称的悬浮 / 点击热区从「只有文字宽」改为整行宽度(右侧 Running 状态胶囊、置顶图钉与工作区行的右侧齿轮仍占位,高度不变,超长标题照旧省略);工作区名称本就是整行热区,补回归断言防止被改回。③ 英文界面会话菜单的「复制名称」项改为 Copy Session Name,与上一项 Copy Session ID 的大小写一致(中文「复制会话名称」不变,其余菜单项不动)。④ 工作区菜单在「在 Finder 中显示」与「复制工作区路径」之间补一条分割线(复用会话菜单同款 .hud-git-menu-divider:1px、12% 灰、左右内缩 4px),复制类操作自成一组的观感与英文会话菜单一致。⑤ 「HUD 设置 →「上下文」模块设置」新增**「上下文模块位置固定」开关(默认关闭):开启后在 HUD 面板上下滚动时,上下文模块与会话模块一样固定住——面板把上下文模块移出滚动容器、渲染在会话模块正下方(与会话模块同属固定头区,不依赖 sticky),滚动区只承载其余模块;固定区 flex:none 不参与收缩(否则面板内容撑满时会被压扁、统计行被裁掉),仅用 max-height:55vh + 内部滚动兜住矮窗口,矮窗口下不会把下方滚动区压没。为避免「开了没反应」,该开关只在上下文是模块排序首位时可开启**(按设置弹窗里的排序与模块开关草稿实时判定:排在前面的模块被隐藏时会跳过;上下文自身被隐藏时给出「已隐藏,无需固定」),否则置灰并在行内说明原因;已存的值不会被改写,把排序拖回首位后自动生效。⑥ 「HUD 设置」左栏拖动排序:把模块拖到首位 / 末位时,若松手前指针已经滑出列表(甚至滑出弹窗),旧实现收不到 drop、模块会弹回原位;现在拖动期间在 document 捕获阶段接管 dragover / drop,落点按指针相对列表的位置钳制(列表上方 → 首位、下方 → 末位),并在 dragend 时用最后一次预览兜底提交;「恢复默认」改走独立的 cancelDrag,不会把拖动的半成品顺序写进草稿。⑦ 设置结构:context.pinned 写入既有 context 段(host schema、收敛函数与写侧白名单同步扩充),旧数据缺字段按 false 处理,升级后面板观感不变;pinned 关闭时面板 DOM 与 0.18.6 完全一致。新增 test/context-pin.test.mjs 十条回归(设置模型与 host schema、contextPinState 三种判定、弹窗置灰与草稿接线、固定区位置与滚动区去重、限高内滚样式、中英文案齐全、新建会话页不固定),并更新 test/todo-item-card.test.mjs(浮层 + 遮罩 + 触屏避让)、test/session-title-menu.test.mjs(整行热区与英文文案)、test/workspace-title-menu.test.mjs(复制项前分割线)、test/status-settings.test.mjs/test/settings-persistence.test.mjs/test/settings-dialog-layout.test.mjs(pinned 默认值与开关数量)。中英文 README 同步更新。测试基线:452 tests / 449 pass / 0 fail / 3 skipped。

v0.18.6:待办悬浮按钮拖动后滞留、拖动手柄热区过小:① 待办条目的编辑 / 删除按钮此前用 :focus-within 控制显隐——用鼠标抓住最左侧手柄拖动时,手柄在拖动期间获得了焦点,松手后焦点仍留在该行,于是鼠标已经移开按钮也不会消失(要等下一次点击别处才隐藏,看起来像「延迟一段时间」)。现在改为 :has(:focus-visible):只有键盘聚焦才触发显示,鼠标拖动 / 点击完全交给悬浮样式,松手移开即刻隐藏;悬浮显示与无 hover 环境常显的规则不变。② 拖动手柄的可拖动热区从固定 24px 高扩展到整行高度(align-self:stretch + 上下等量负外边距与内边距,视觉不变),多行文本的待办也能在手柄这一列的任意高度直接拖起。③ 说明页「待办模块」的拖动要点同步注明热区覆盖整行;test/todo-item-card.test.mjs 增加热区断言并改为校验新选择器(同时反向断言不再出现 :focus-within)。中英文 README 同步更新。测试基线:438 tests / 435 pass / 0 fail / 3 skipped。

v0.18.5:HUD 设置弹窗新增「使用说明」标签页:① 弹窗顶部改为两个标签——「HUD 设置」与「使用说明」(选中项品牌色下划线,右上角「关闭」按钮不变;两个标签各带图标——「HUD 设置」用 assets/icons/settings-outline.svg 的描边齿轮、「使用说明」用 assets/icons/hint.svg 的提示图标,宿主资产白名单同步放行,升级后需重启 DSH 才会加载),两者随时可切换;每次打开都默认停在「HUD 设置」,未确认的设置草稿在切换标签后不会丢失,弹窗高度也不会因为切到说明页而变化。② 说明页采用左目录 + 右内容(左侧目录与右侧小节标题只用文字、不配图标):左侧 240px 目录与设置页左栏同宽(切标签时分割线不跳位),点击跳到对应小节、右侧滚动时目录自动高亮;说明页按模块分节,共 11 节:HUD 面板、会话、上下文、用量、git、子代理任务、任务、计划清单、MCP、便笺、待办,每节内部按「展示 / 功能」分组(「HUD 面板」一节另含「设置」分组)、每个要点只写一两句:面板一节覆盖打开/关闭、左右位置、新建会话页差异与设置弹窗的三个卡片;其余每节先列模块展示的信息,再分功能点列出可操作项(含依赖与限制,例如用量行需要对应插件、工作区不是 git 仓库时提供「初始化仓库」、便笺与待办按工作区共享);说明页与设置页共用同一个高度容器,切换标签时弹窗高度不变(窗口缩放时也与设置页同步)。③ 说明页是纯客户端增量,不改宿主、不改设置结构,也不发任何请求;底部「恢复默认 / 取消 / 确认」在说明页同样常驻(无改动时「恢复默认」置灰),点击遮罩、Esc、「关闭」与「取消」的关闭语义不变。④ 文案中英双语,与设置页共用同一份 i18n 字典,英文环境自动显示英文。新增 test/settings-guide.test.mjs 十二条回归(标签行与默认页、随时切换、11 节/分组与大纲一致,且只有面板一节带设置分组、说明页不渲染图标而标签带提示图标、草稿保留、切换标签弹窗高度不变、底部栏常驻、目录高亮纯函数边界、中英字典齐全、样式与接线、宿主资产白名单),并更新 test/settings-dialog-layout.test.mjs 的运行时与 test/module-order.test.mjs 的弹窗可达名断言。⑤ 待办条目改为卡片式(描边 + 浅底 + 10px 圆角,与 HUD 设置里的模块卡片同款,行距 6px),编辑 / 删除按钮默认隐藏,悬浮或键盘聚焦该行时才出现(隐藏时保留占位,避免文字在悬浮时重新换行;无 hover 环境始终显示),拖动兜底间距同步改为 6px 并新增 test/todo-item-card.test.mjs 三条回归。⑥ 顺带把「上下文」模块三行的垂直间距调匀:进度条行底部留白由 8px 收到 2px、两行统计/用量的行距由 1px 提到 3px,进度条、会话统计、Token 用量三行视觉间距都约 11px(原先「上大下小」),并在 test/context-cache.test.mjs 增加一条间距回归。中英文 README 同步更新。测试基线:437 tests / 434 pass / 0 fail / 3 skipped。

v0.18.4:修复新建会话页的 HUD 设置把模块误显示为关闭:① 「HUD 设置」左栏此前读取的是按当前页面过滤后的模块状态,而新建会话页本就不渲染「上下文 / 子代理任务 / 任务 / 计划清单」——于是这四项在该页的设置里显示成未勾选,此时点「确认」还会把它们的全局开关真的写成关闭(会话页里这些模块就消失了)。现在设置弹窗一律读取真实保存的模块开关,与所在页面无关。② 同时按你的要求:新建会话页不展示的那几个模块在左栏保持真实状态(通常为启用)、置灰并不可点击,悬浮显示原因「新建会话页不展示该模块,开关在会话页修改」,避免把「本页看不到」误当成「已关闭」,也不会在本页误改全局开关。③ 已确认过的真实关闭状态照原样显示(只置灰,不改值),模块顺序仍可拖动。新增回归:test/settings-refresh.test.mjs 断言新建会话页也会拿到完整模块开关并标明只读项、会话页无只读项;test/settings-dialog-layout.test.mjs 断言锁定卡片置灰不可点、保持启用状态、确认时原样提交。中英文 README 同步更新。测试基线:421 tests / 418 pass / 0 fail / 3 skipped。

v0.18.3:修复面板重新挂载后设置回退:① 面板在切页面(会话页 ↔ 新建会话页)、手动关开面板、开合官方右侧栏时都会重新挂载;旧实现把「页面加载时读到的那份设置」整页缓存并复用,重挂后会把这期间的改动回退掉——表现为「刚关掉的『跳转』按钮又出现」「面板位置从左侧回到右侧」。现在重挂时每次都重新读取宿主设置,只用「最近一次成功读/写」的快照渲染首帧(既不闪旧值,也不会回退)。② 同一份首帧种子也让模块勾选、上下文设置、模块顺序在重挂后立即保持最新,不再出现一帧旧状态。③ 对旧宿主(usage 里没有 showJump)做缺键兼容:重启宿主前也会保留本次运行内对「跳转」按钮的选择。④ 读取设置失败时不再把已确认的设置重置为默认值(保留最近一次成功快照)。新增 test/settings-refresh.test.mjs 五条回归(重挂后重新读取、写入后首帧即新值、宿主权威值覆盖、旧宿主缺键兼容、写入失败不污染快照),在旧实现上其中四条必失败。中英文 README 同步更新。测试基线:418 tests / 415 pass / 0 fail / 3 skipped。

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。

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。

v0.18.0:上下文模块重做与上下文设置:① 模块名改为「上下文」,标题右侧按「当前占用 / 最大上下文(占用率)」展示(如 199K / 1M(19.9%))。② 进度条默认单色,悬浮时切换为 System prompt / Tool definitions / Messages 三段式并弹出 breakdown 提示(石青/紫/蓝);进度条外层悬停判定区扩大到 18px,视觉仍为 8px。③ 底部改为「会话统计」「Token 用量」两行,使用 DSH 官方 gauge/database 图标(内联 SVG,不依赖新增 host 资产路由),悬浮分别显示完整统计/用量提示。④ HUD 设置新增「上下文设置」卡片:始终显示分段进度条、显示会话统计、显示 Token 用量;设置随 profile 持久化。中英文 README 同步更新。测试基线:364 tests / 361 pass / 0 fail / 3 skipped。

v0.17.2:交互细节修复(提交信息确认、拖动预览与会话重命名):① git commit 弹窗的「确认?」按钮图标现在与文字一起变红:此前 Icon 组件把颜色写在内联样式里,覆盖了 .hud-btn-ai-confirm .hud-icon{color:inherit},导致文字红、图标仍为默认色;现在给该图标传 color: "inherit",确认态整体呈红色。② HUD 设置弹窗与「待办」模块拖动时不再出现两个重叠的拖动项:此前 setDragImage 把整张卡片/整行作为浏览器原生拖拽幽灵,幽灵跟随鼠标并与列表内的虚线占位叠加;现在用 1x1 透明 GIF 替换原生快照,只保留列表内的占位与让位动画,拖动语义不变。③ 「会话」模块重命名改为点击名称本身:移除名称右侧铅笔按钮;鼠标悬浮名称时显示灰色背景,点击进入编辑态(输入框 + 取消/确认),Enter 提交、Esc 取消;空白页无会话时名称按钮禁用。中英文 README 同步更新。测试基线:357 tests / 354 pass / 0 fail / 3 skipped。

v0.17.1:修复 OpenCode 路由下 AI 生成提交信息失败:HUD git 模块的「generate」直接调用 ctx.llm.stream,但未传当前会话 sessionId;OpenCode 适配器依赖该字段注入 x-opencode-session 请求头,缺失时网关返回 400 MissingSessionID(普通对话请求由 agent loop 自动携带,故只有 HUD 的自定义生成调用受影响)。现在生成请求会携带会话 id,并新增回归断言校验 llm.stream 收到 sessionId。测试基线不变:351 tests / 348 pass / 0 fail / 3 skipped。

v0.17.0:git 变更文件交互、HUD 滚动条与设置弹窗:① HUD 面板内部上下滑动时不再展示滚动条:移除「滚动时显示、停止后渐隐」的 data-scrolling / data-fading 逻辑,面板 body 固定 scrollbar-width:none,WebKit 滚动条宽度与高度均为 0。② 文件行悬停 0.5 秒后在鼠标位置显示该文件完整路径的 HUD 提示:自定义固定定位提示,不依赖原生 title 的不可控延时,也不会被 5 秒一次的 git 轮询重渲染打断;靠近视口底/右缘时自动翻转到上方、收窄宽度。git graph 提交记录的悬停提示也统一为 0.5 秒,并且在提交标题下方额外展示该提交的分支/标签(与提交行上的标签同一套数据与配色)。③ 左键点击变更文件改为在右侧栏打开 diff:优先官方「第 N 轮改动」review 页(与交付物卡片同一页面),Host 新增 git/changes-review 路由从最新一条 workspace/changes 事件和 workspaceChanges.summary 中解析序号、轮号与文件下标,客户端用 ctx.sidebarRight.openResource 选中该文件;该文件不在最新一轮摘要、官方 review 不可用或右侧栏缺失时,回退到 better-sidebar 的工作树 diff tab(staged 组看暂存侧、changes 组看未暂存侧,未跟踪/预登记文件走全文件新增兜底)。右键(或键盘 Shift+F10 / 菜单键)仍打开原来的 add to stage / revert 选项菜单。回退需要安装并启用 dsh-better-sidebar;两条路径都不可用时给出中英文 toast。新增 test/git-file-actions.test.mjs 七项回归(滚动条、左右键、0.5 秒悬停提示、diff seed、缺失侧栏、失败提示、官方 review 坐标)。④ 「HUD 设置」由菜单改为弹窗:会话模块右上角齿轮不再展开设置菜单,而是打开居中弹窗;选项与旧菜单完全一致(模块显隐、拖动排序、用量模块内容),但改为每个模块一张卡片的单列列表(从上到下即 HUD 面板顺序),「用量模块内容」单独一张卡片,底部「恢复默认 / 取消 / 确认」固定在弹窗外壳;拖动时通过 transform 实时预览排序结果(其余卡片让位滑动),松手后才写入草稿、拖到列表外则保持原顺序;弹窗经 portal 挂到 body,不受 HUD 面板滚动容器裁剪,支持遮罩点击、右上角「关闭」、「取消」与 Esc 关闭(均等同取消),打开时焦点进入弹窗、Tab 在弹窗内循环、关闭后焦点回到齿轮。test/module-order.test.mjs 的设置相关用例同步改为弹窗结构断言,并新增关闭方式、焦点循环与拖动预览落点/插入顺序断言。⑤ 「待办」拖动排序加入同样的排斥预览:拖动手柄时其余待办条目按真实行高实时让位滑动,被拖动条目以半透明虚线占位显示在目标位置,松手前即可看到最终顺序;落盘当帧临时关闭过渡,避免二次回跳;拖到列表外松手保持原顺序,顺序未变化时不写入存储。新增 test/todo-drag.test.mjs 三项回归(可变行高落点、预览位移、客户端接线),git graph 悬停提示增加分支/标签的回归并入 test/git-file-actions.test.mjs。测试基线:351 tests / 348 pass / 0 fail / 3 skipped。

v0.16.1:修复 DSH 0.2.2-rc.2 升级后的两处回归:① 面板展开后正文/输入框不再左移、与面板重叠。DSH 0.2.2-rc.2 在 [data-conversation-scroll] 与正文容器之间插入了新的包装层(实测为 div.QwyHXq_layer + `div[data-slot=

…

内容来自项目 README(GitHub)↗

链接

同类插件

查看整个分类 →

社区评论

评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。