dsh-ui-tweaks

dsh plugin --profile web add dsh-ui-tweaks

dsh-ui-tweaks

English | 中文

依赖版本：当前依赖 DSH v0.2.0-rc.2。

DeepSeek Harness（DSH）插件：在设置面板里实时调整对话界面——主题皮肤（默认 / 柔光 · 8 色可选）、时间线切换（原生回合导航轨 / 经典网页时间线）、GitBar（会话头部的分支胶囊 + 右侧边栏里的代码差异标签页）、缓存命中率两位小数，以及四个可开关的独立模块：归档管理、MCP 管理、网络搜索、任务提醒，外加 /init 斜杠命令。

所有改动即时生效，无需刷新页面。

代码字号不在这里——DSH 自带的「外观」设置已经提供了（ui-theme 的 codeFontSize，10–16px）。本插件从 v0.22 起不再重复该功能，也不再向 body 写入任何代码字体 token，两个设置不会互相打架。

功能

外观与布局

• 主题：两个选项，随时可切回。
• 默认 —— 完全保留 DSH 原生外观，不注入任何样式。
• 柔光 —— 一种静态皮肤：中性浅/深双色主题 + 从顶部、底部向中间辐射的柔和光晕，无动画，运行时几乎零开销；发光色可在 薄荷青 / 电光蓝 / 紫罗兰 / 天空青 / 琥珀 / 珊瑚橙 / 玫瑰 / 月光银 八色间切换（默认薄荷青）。行内代码、代码块、表格表头、链接与列表标记都走该强调色。
• 皮肤只作用于主界面与插件自己的设置页，宿主设置弹窗保持 DSH 原生配色；切换遵循系统「减少动效」。
• 缓存命中率两位小数（默认关闭）：DSH 原生统计条只显示整数百分比（「缓存命中 96%」）。开启后改写为两位小数（「缓存命中 96.35%」），且直接用原始 token 数计算——缓存读取 ÷ 计费输入（未缓存输入 + 缓存读取 + 缓存写入），与原生数字同源、但不再取整。完全命中显示 100.00%；无计费输入时该组本就不显示。关闭即恢复原样。

交互与工具

• 时间线：一个开关两档。
• 原生（默认）：DSH 自带的回合导航轨（消息右侧的小圆点条），即官方默认行为。
• 网页（经典）：找回 v0.11 的经典右侧导航轨——消息区右缘垂直居中，收起时是一列细线，悬停展开为 240px 面板（消息预览 + 高亮当前位），悬停单项弹出带时间戳的详情气泡，点击跳转到对应消息（深历史会自动连续翻页加载后落点，带落点自校验）；滚轮可在轨上直接翻阅被裁剪的条目。数据来自服务端 dshChatTimeline 会话投影（全量用户消息，与浏览器已加载窗口无关），少于两条用户消息的会话自动隐藏。切到网页档时，原生回合导航轨由一条主题无关的 CSS 规则按结构隐藏，两个不会同时出现。
• GitBar（默认关闭）：git 仓库会话的标配两件套——会话头部的分支胶囊，加上右侧边栏（文件旁）的代码差异标签页。有未提交改动时，分支胶囊与代码差异页签上都带小黄点。
• 分支胶囊：位于会话标题旁，显示当前分支名。点击向下弹出分支面板——本地 / 远程分支列表（点击即 git switch），底部可新建分支（git switch -c 并自动切换），支持分支重命名与删除。头部当前分支右侧是拉取按钮（git pull --ff-only：只快进，分叉时中止并显示 git 自己的报错而不悄悄合并；无 upstream 的分支不显示该按钮）。
• 提交图谱：面板里的「图谱」打开对话框——最近 150 条提交（git log --date-order --all）按拓扑自动分 lane，渲染成彩色 SVG 分叉图：圆点是提交、曲线是 fork/merge，各分支线独立着色，合并弧线汇入目标分支并采用其颜色；行悬停高亮，右上角可刷新。旁边的 Tag 管理支持新建 / 推送 / 删除（删除需二次确认）。
• 代码差异：文件列表 + 逐文件 diff（默认只显示有差异的 hunk，右上可切「完整文件」视图）。文件列表 / diff 内容 / 提交区三段之间的分隔线可上下拖动调整高度（双击复位；提交说明框随提交区高度拉伸，可写多行，Shift+Enter 换行）。提交区保留在视图底部：逐文件勾选决定本次提交范围（未勾选的排除在外），可打 Tag，提交 / 提交并推送（提交说明必须自行填写）。非 git 仓库时该页显示提示而不隐藏。
• 在外部应用中打开项目走 DSH 自带的「在本地打开」按钮；所有 git 操作走服务端 execFile('git', …)——无 shell、cwd 固定、带超时、支持中止。
• 归档管理（默认关闭）：设置面板中的「归档管理」页面，列出所有已归档会话（标题 / 所在工作区 / 相对时间），支持恢复与彻底删除：
• 恢复：把会话移出归档——日志与工作区槽位原样保留，会话回到侧边栏列表。
• 删除：彻底删除该会话——服务端将其 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 内置补丁监视器热重载加载器——被改动的那个服务器实时启动/停止/重启，不影响其它服务器；重启单独运行时生效、不改配置。
• 新增后请确认服务器能成功连接（状态为「运行中」并注册了工具）；启动失败的实例显示「错误」并可重启重试。
• 网络搜索（默认关闭）：开启后用本插件的多引擎 provider 接管 DSH 内置的 web_search 工具，并新增「网络搜索」设置页：
• 引擎：Bing / DuckDuckGo（免费，无需 key）、Exa / Tavily / Keenable（无 key 时走匿名免费额度）、Perplexity / DeepSeek（必须配 key）。任一引擎失败（限流、key 失效、网络）都会自动回退到下一个，搜索不会因为单个引擎硬失败。Bing 另可指定市场代码（如 zh-CN / en-US）。
• API key：按平台填写，保存在凭据中心 ~/.dsh/.credentials.yaml（EXA_API_KEY / TAVILY_API_KEY / KEENABLE_API_KEY / PERPLEXITY_API_KEY / DEEPSEEK_API_KEY），不写进设置文档；解析优先级为凭据中心 → 环境变量。密钥可显示 / 复制 / 清除，页面还有「测试引擎」按钮做实时连通性检查。
• 开关会同步到 profile 的 cordis.patch.yml（web 条目的 searchProvider），关掉即恢复官方搜索后端。
• /init 斜杠命令（默认关闭）：在输入框键入 /init（斜杠菜单中可见「分析当前项目并生成 AGENTS.md」），回车或点击后弹出语言选择——中文提示词 / 英文提示词，选中即向当前会话提交一段完整的 AGENTS.md 引导提示词：代理会自行探索项目（README、清单文件、构建脚本、关键目录），然后在仓库根目录生成或改进一份面向未来 AI 编码代理的 AGENTS.md（项目简介、常用命令、代码风格约定、目录导览、注意事项；已存在时原地改进不丢内容）。纯客户端实现。

任务提醒

挂着任务切去干别的时，让浏览器把你喊回来（默认关闭）。监听所有会话（含后台），两类事件：

• 完成提醒：running 落下，或宿主 completed 绿点升沿；并经 turn/end 事件的宿主投影区分完成 / 被中断 / 请求失败三种结局，失败通知附截断的错误摘要。
• 交互提醒：会话开始等待你的审批 / 计划确认 / 模型提问——与侧边栏黄点同一数据源 pendingInteraction。

三个独立通道：

• 标题闪烁：(2) 🔔 原标题 交替闪烁未读计数，回到页面自动恢复原标题并清零。
• 系统通知（Web Notifications API）：桌面级通知，点击直达对应会话；权限申请挂在设置开关的点击手势上（桌面端自动授予，不会弹授权框）；系统响铃与自有提示音互斥，绝不双重响。
• 提示音：WebAudio 现场合成的双音动机——上行 = 完成、下行 = 需要你处理，无音频资源文件。

防打扰：首帧快照只武装不触发（刷新页面不刷屏）；只在跳变沿触发；同会话同类事件 2 秒冷却（防重连抖动）；同一完成在 30 秒内不重复播报；子代理子会话不计（父会话承载整轮）。「仅页面不可见时」默认开启——正盯着页面时不打扰。设置里有「测试」按钮，一键预览权限与三个通道的效果。

设置与配置

设置入口：设置 → 界面调整。左侧导航里另有三个独立页面——归档管理、MCP 管理、网络搜索——各自随对应开关实时出现 / 消失。

同一份配置也可以直接手改。DSH 0.1.7 起 settings.yaml 已退役，配置写在 profile 的 cordis.patch.yml（设置页保存时写入的就是这份文件）：

# $DSH_HOME/profiles/<profile>/cordis.patch.yml
- id: ui-tweaks
  name: dsh-ui-tweaks
  config:
    timelineStyle: web            # 默认 native（DSH 自带回合导航轨），web 为经典网页时间线
    themeStyle: particles         # 默认 default（DSH 原生外观，可随时恢复），particles 为柔光皮肤
    particleColor: mint           # 光晕色：mint/electric/violet/sky/amber/coral/rose/silver（默认 mint）
    preciseCacheHitEnabled: true  # 默认 false，缓存命中率两位小数
    searchEnabled: true           # 默认 false，接管内置 web_search 并显示「网络搜索」页
    searchEngine: exa             # 默认 bing；bing/ddg/exa/tavily/keenable/perplexity/deepseek
    bingMarket: zh-CN             # 默认 zh-CN，仅对 Bing 生效
    gitBarEnabled: true           # 默认 false，开启 GitBar
    archiveManagerEnabled: true   # 默认 false，显示「归档管理」页与会话菜单删除入口
    mcpManagerEnabled: true       # 默认 false，显示「MCP 管理」页
    initCommandEnabled: true      # 默认 false，注册 /init 斜杠命令
    notificationsEnabled: true    # 默认 false，开启任务提醒（通道与事件在设置里逐项开关）
    notifyOnlyWhenHidden: true    # 默认 true，仅页面不可见时提醒
    notifyOnComplete: true        # 默认 true，完成提醒
    notifyOnInteraction: 

…(truncated)