# dsh-ui-tweaks > **依赖版本**：当前依赖 **DSH v0.2.0-rc.2**。 [DeepSeek Harness](https://deepseek-harness.github.io/deepseek-harness/)（DSH）插件：在设置面板中实时调整对话界面——代码字号、**主题皮肤**（简约 / 荧光海报）、**时间线切换**（原生回合导航轨 / 经典网页时间线）、**GitBar**（会话头部的分支胶囊 + 右侧边栏里的代码差异标签页），可开关的**归档管理**（设置中的「归档管理」页面：查看、恢复或彻底删除已归档会话），可开关的**任务提醒**（会话完成或需要交互时，通过标签页标题闪烁 / 系统通知 / 提示音把你唤回来），以及**缓存命中率两位小数**（把输入框下方统计条的缓存命中百分比改写为精确值）。 ## 预览 | | | |---|---| | ![设置面板](assets/settings.png) | ![分支面板](assets/git.png) | | **设置面板**：代码字号 / 主题皮肤（简约 · 荧光海报）/ 缓存两位小数 / 网络搜索 / 时间线 / Git 状态栏等功能开关，左侧另有「归档管理」「MCP 管理」「网络搜索」页面 | **分支面板**：点击会话头部的分支胶囊向下弹出——本地 / 远程分支列表，点击即切换；头部右侧是拉取按钮（只快进），底部可新建分支，菜单里可打开**提交图谱**（彩色 SVG 分叉图）与 **Tag** 管理 | | ![差异面板](assets/gitdiff.png) | ![归档管理](assets/archive.png) | | **代码差异**：右侧边栏里的代码差异标签页——文件列表（逐文件勾选，可部分提交）+ 逐文件 diff（默认只显示有差异的 hunk，右上可切“完整文件”），底部提交区可写提交说明、打 Tag，提交 / 提交并推送 | **归档管理**：设置中的「归档管理」页面，列出所有已归档会话（标题 / 工作区 / 相对时间），支持恢复与彻底删除，顶部可全部恢复 / 全部删除 | | ![MCP 管理](assets/mcp.png) | | | **MCP 管理**：设置中的「MCP 管理」页面，列出所有配置的 MCP 服务器及其运行状态与工具数，支持添加 / 编辑 / 启用停用 / 删除 / 重启 | | ## 功能 - **代码字号（px）**：绝对值 8–32，默认 11（正文 14 时的 DSH 原生代码块字号）；作用于代码块，行内代码按比例跟随——旧版的百分比配置（`codeFontScale`）仍然兼容，一旦设置新的 px 值即以其为准。消息正文保持 DSH 原生字号。 - **主题（布局区单选，默认即原生外观）**：可选 `默认`、**简约** 或 **荧光海报**。**简约**完全保留 DSH 原生外观，只改一处——对话里的 Markdown 行内代码染成 Anthropic 红 `#c15f3c`（深色模式下 `#d97757`，与荧光海报同款强调色；代码块、表格、按钮等一律不动）。**荧光海报**是海报风双方案皮肤：浅色模式纸白底 + 黑粗线条，深色模式近黑底 + 浅色粗线条，都配荧光黄高亮 + Anthropic 红点缀（按钮、链接、选中态跟随主题变量自动变色，代码块与输入框卡片带硬阴影贴纸效果），输入框模型旁的**推理等级**按强度着色（绿 / 琥珀 / 蓝 / 紫，悬停选项行时同色底从左扫过）。切换即时生效，后续皮肤会以同样方式追加为新选项。 - **时间线（功能区内单选）**：一个开关两档，选一个： - **原生（默认）**：DSH 自带的回合导航轨（消息右侧的小圆点条），即官方默认行为。 - **网页（经典）**：找回 v0.11 的经典右侧导航轨——消息区右缘垂直居中，收起时是一列细线，悬停展开为 240px 面板（消息预览 + 高亮当前位），悬停单项弹出带时间戳的详情气泡，**点击跳转**到对应消息（深历史会自动连续翻页加载后落点，带落点自校验）；滚轮可在轨上直接翻阅被裁剪的条目。数据来自服务端 `dshChatTimeline` 会话投影（全量用户消息，与浏览器已加载窗口无关），少于两条用户消息的会话自动隐藏；切换到网页档时，原生回合导航轨由插件用一条主题无关的 CSS 规则（命中其 `--turn-natural-height` 内联变量）隐藏，两个不会同时出现。 - **GitBar（默认关闭，可在设置中开启）**：git 仓库会话的标配两件套——会话头部的**分支胶囊**，加上右侧边栏（文件旁）的**代码差异**标签页（在边栏指南里点开，有未提交改动时分支胶囊和代码差异页签上都带小黄点）： - **分支胶囊**：位于会话标题旁；显示当前分支名（有未提交改动时在标题提示）。点击**向下**弹出分支面板——本地 / 远程分支列表（点击即 `git switch`），底部可**新建分支**（`git switch -c` 并自动切换）。**头部当前分支右侧是拉取按钮**（`git pull --ff-only`：只快进，分叉时中止并显示 git 报错而不悄悄合并；无 upstream 的分支不显示该按钮），拉的就是头部显示的那个分支。菜单里的**图谱**打开**提交图谱**对话框：最近 150 条提交（`git log --date-order --all`）按拓扑自动分 lane，渲染成彩色 SVG 分叉图——圆点是提交、曲线是 fork/merge，各分支线独立着色，合并弧线汇入目标分支并采用其颜色；行悬停高亮，右上角可刷新。 - **代码差异**：文件列表 + 逐文件 diff（默认**只显示有差异的 hunk**，右上可切“完整文件”视图）。三段（文件列表 / diff 内容 / 提交区）之间的分隔线**可上下拖动调整高度**（双击复位；提交说明框随提交区高度拉伸，可写多行，Shift+Enter 换行）。**提交区保留在视图底部**（提交 / 提交并推送，提交说明必须自行填写）。非 git 仓库时该页显示提示而不隐藏。 - 在外部应用中打开项目走 DSH 自带的「在本地打开」按钮，本插件不再重复提供；所有 git 操作走服务端 `execFile('git', …)`（无 shell、带超时）。 - **归档管理（可开关，默认关闭）**：设置面板中的「归档管理」页面，列出所有已归档会话（标题 / 所在工作区 / 相对时间），支持**恢复**与**彻底删除**： - **恢复**：把会话移出归档——日志与工作区槽位原样保留，会话回到侧边栏列表。 - **删除**：**彻底删除**该会话——服务端将其 JSONL 日志从磁盘移除、从工作区记账与归档集合中清除、并清理投影缓存，会话永久消失（不可恢复）。只有**正在运行**（有任务在跑）的会话会被拒绝；已打开但空闲的会话也会从内存中移除，删除后实时从列表消失。侧边栏会话行「…」菜单里也有同一操作的**删除会话**入口（点两次确认，第一次点后 3 秒内不再点则自动撤销；运行中的会话会在菜单里就地提示原因）。 - 顶部另有**全部恢复 / 全部删除**批量操作（删除类操作需二次确认）。列表随 `host/archived-sessions-changed` 事件与客户端会话列表刷新实时更新，无需刷新页面。 - **MCP 管理（可开关，默认关闭）**：设置面板中的「MCP 管理」页面，展示 profile 里配置的所有 MCP 服务器（`@deepseek-ai/dsh-mcp-client` 实例）及其状态（运行中 / 错误 / 加载中 / 未运行 / 已停用）、命令、环境变量、已注册工具，并支持完整管理： - **添加 / 编辑**：编辑器支持**表单**（实例 ID / 名称 / 类型 stdio 或 HTTP / 超时时间 ms / 命令 / 参数 / 环境变量 / URL / 请求头）或直接**粘贴 YAML** 两种方式，保存前会做格式校验（名称与 ID 字符集、超时正整数、URL 协议、命令非空、未知 YAML 字段等）。 - **启用 / 停用 / 删除 / 重启**：改动直接写入 profile 的 `cordis.patch.yml`（保持注释与结构），DSH 内置补丁监视器热重载加载器——被改动的那个服务器**实时**启动/停止/重启，不影响其它服务器；重启单独运行时生效、不改配置。环境变量值仅在本机浏览器可见，用于编辑。 - 新增后请确认服务器能成功连接（状态为「运行中」并注册了工具）；启动失败的实例会显示「错误」并可重启重试。 - **`/init` 斜杠命令（可开关，默认关闭）**：在输入框键入 `/init`（斜杠菜单中可见「分析当前项目并生成 AGENTS.md」），回车或点击后弹出语言选择——**中文提示词 / 英文提示词**，选中即向当前会话提交一段完整的 AGENTS.md 引导提示词：代理会自行探索项目（README、清单文件、构建脚本、关键目录），然后在仓库根目录**生成或改进**一份面向未来 AI 编码代理的 `AGENTS.md`（项目简介、常用命令、代码风格约定、目录导览、注意事项；已存在时原地改进不丢内容）。纯客户端实现；在「界面调整」中开启后生效。 - **任务提醒（可开关，默认关闭）**：挂着任务切去干别的时，让浏览器把你喊回来。监听**所有会话**（含后台），两类事件：**完成提醒**（`running` 落下，或宿主 `completed` 绿点升沿；并经 `turn/end` 事件的宿主投影区分**完成 / 被中断 / 请求失败**三种结局，失败通知附截断的错误摘要）与**交互提醒**（会话开始等待你的审批 / 计划确认 / 模型提问——与侧边栏黄点同一数据源 `pendingInteraction`）。三个独立通道： - **标题闪烁**：`(2) 🔔 原标题` 交替闪烁未读计数，回到页面自动恢复原标题并清零； - **系统通知**（Web Notifications API）：桌面级通知，**点击直达对应会话**；权限申请挂在设置开关的点击手势上；系统响铃与自有提示音互斥，绝不双重响； - **提示音**：WebAudio 现场合成的双音动机——上行=完成、下行=需要你处理，无音频资源文件。 - 「仅页面不可见时」默认开启（正盯着页面时不打扰）；首帧快照只武装不触发（刷新页面不刷屏）；只在跳变沿触发 + 同会话同类事件 2 秒冷却（防重连抖动）；子代理子会话不计（父会话承载整轮）。设置里有「测试」按钮，一键预览权限申请与通道效果。 - **缓存命中率两位小数（可开关，默认关闭）**：DSH 原生统计条里的缓存命中只显示整数百分比（如「缓存命中 96%」）。开启后改写为两位小数（如「缓存命中 96.35%」），且**直接用原始 token 数计算**——缓存读取 ÷ 计费输入（未缓存输入 + 缓存读取 + 缓存写入），与原生数字同源、但不再取整；完全命中显示 100.00%，无计费输入时该组本就不显示。开关位于设置的「布局」区，关闭即恢复原样。 所有修改**即时生效**，无需刷新。同一份配置也可以直接手改——DSH 0.1.7 起 `settings.yaml` 已退役，配置写在 profile 的 `cordis.patch.yml`（设置页保存时写入的就是这份文件）： ```yaml # $DSH_HOME/profiles//cordis.patch.yml - id: ui-tweaks name: dsh-ui-tweaks config: timelineStyle: web # 默认 native（DSH 自带回合导航轨），web 为经典网页时间线 themeStyle: minimal # 默认 default（DSH 原生外观），minimal 只把行内代码染成 Anthropic 红（浅色 #c15f3c / 深色 #d97757），neon-lime 为荧光海报皮肤 gitBarEnabled: true # 默认 false（关闭），设为 true 开启 GitBar archiveManagerEnabled: true # 默认 false（关闭），设为 true 开启「归档管理」页面 initCommandEnabled: true # 默认 false（关闭），设为 true 开启 /init 斜杠命令 preciseCacheHitEnabled: true # 默认 false（关闭），设为 true 开启缓存命中率两位小数 notificationsEnabled: true # 默认 false（关闭），设为 true 开启任务提醒（事件过滤与三个通道在设置里逐项开关） ``` 设置入口：**设置 → 界面调整**。 ## 安装 ```bash # 方式一：从 npm 安装（推荐，预构建产物，一条命令装好） npx -y @deepseek-ai/dsh plugin --profile desktop add dsh-ui-tweaks # 方式二：从 GitHub 仓库安装（源码，安装时由 prepare 自动构建） npx -y @deepseek-ai/dsh plugin --profile desktop add github:wlj521/dsh-ui-tweaks ``` > **方式二需要放行构建脚本**：`lib/` 不在仓库里（构建产物），靠 `prepare` 在安装时生成；而 pnpm ≥ 10.26 出于供应链安全**默认不允许 git 依赖执行 `prepare`**。先在 profile 的 `pnpm-workspace.yaml` 里放行，否则装完没有 `lib/`，插件加载即失败： > > ```yaml > allowBuilds: > dsh-ui-tweaks: true > ``` > > 不想在本机构建就用方式一（npm 包内已含预构建产物）。 `add` 后面的包说明会**原样转发给 pnpm**，因此可以指定版本——npm 包用 `@版本号`，GitHub 源码用 `#tag`： ```bash npx -y @deepseek-ai/dsh plugin --profile desktop add dsh-ui-tweaks@0.19.2 # 锁定 npm 版本 npx -y @deepseek-ai/dsh plugin --profile desktop add github:wlj521/dsh-ui-tweaks#v0.19.2 # 锁定 git tag ``` ### 方式三：本地目录（在桌面端点选，无需命令行） ```bash git clone https://github.com/wlj521/dsh-ui-tweaks.git cd dsh-ui-tweaks pnpm install # prepare 会自动构建出 lib/ ``` 然后在桌面端打开 **插件 → 添加插件**，填入该目录的**绝对路径**（例如 `D:\dsh-project\dsh-ui-tweaks`）。 > **先跑 `pnpm install` 是必需的**：本地目录安装走 `link:` 软链，pnpm **不会**为它执行 `prepare`，也不会安装它自己的依赖。所以目录里必须已经存在构建产物 `lib/`（`main` 指向的文件）和 `node_modules/`（运行时依赖 `yaml`）。缺了的话安装会「成功」、命令也不报错，但启动时 DSH 会报 `ui-tweaks (dsh-ui-tweaks): failed to import`，插件不生效。 > > 路径必须是**绝对路径**——相对路径会被拒绝（宿主的当前工作目录对浏览器里输入的人没有意义）。命令行等价做法：`npx -y @deepseek-ai/dsh plugin --profile desktop add <绝对路径>`。 安装完成后**重启一次 DSH 桌面端**（bundle 插件在进程启动时扫描）。 > 若 pnpm 报符号链接/hoist 相关错误，可在 profile 的 `pnpm-workspace.yaml` 中设置 `nodeLinker: hoisted`。 ## 开发 ```bash pnpm install pnpm build # tsc（服务端）+ tsc（客户端）+ 打包 lib/client.js pnpm typecheck ``` 本地加载（覆盖层）或作为 bundle 安装： ```bash npx -y @deepseek-ai/dsh plugin --profile desktop add . # 从本目录作为 bundle 安装 # 开发覆盖层：直接编辑桌面端 profile 的 cordis.patch.yml（$DSH_HOME/profiles/desktop/cordis.patch.yml），DSH 会热重载 ``` ## 工作原理 - **服务端**（`src/index.ts`）：导出 `Config` 设置 schema——0.1.7 起设置表单由宿主从插件导出的 `Config` 自动派生（旧的 `settings.register()` 已移除），插件再以 `configure({ auto: false })` 抑制自动生成页、由客户端各分区接管展示；并挂载同源路由 `/_dsh/ui-tweaks/settings`——自 rc.6 起，Web 设置 RPC 只暴露固定白名单命名空间，因此自定义路由是插件拥有配置页的方式。 - **Git 后端**（`src/git.ts` + `src/git-web.ts`）：通过 `ctx.get('sessions')`（可选服务）解析会话 header 的 `cwd` 作为“当前项目”，用 `child_process.execFile('git', …)`（无 shell、cwd 固定、超时 + 中止传播）执行只读/写操作；同源路由 `/_dsh/ui-tweaks/git/*` 提供 status / branches / diff（hunk 或完整文件，含绝对行号）/ graph（结构化提交行，含父哈希，供前端排布分支 lane）/ commit / push / pull（仅快进）/ checkout / create / branch-delete / remote-delete。 - **浏览器端**（`src/client/index.tsx`）：读写该路由、渲染设置页，并通过运行时 `