dsh-web-ui/packages/dsh-git-graph

一句话定位

为 dsh web GUI 空白会话加上一个工作区分支选择胶囊与 Git 图谱面板：搜索本地分支、查看当前 HEAD、创建并切换、查看泳道式提交历史，所有 git 操作在 host 进程的真实工作树上执行。

核心能力

• 在空白会话输入区右侧提供一个分支胶囊，点开是可搜索弹层：当前分支打勾、按名搜索、底部「创建并检出新分支…」与「Git 图谱」两个动作
• 切换分支作用于工作区级真实 git switch --no-guess：影响该工作区所有会话；守卫覆盖未解决冲突、进行中的 git 操作、目标分支已被其他 worktree 检出三类情况
• 新建分支走 git switch --no-guess -c，支持创建对话框：客户端先做即时校验（不允许以 - 开头、不含 .. / ~^:?*[\ 等），host 再用 git check-ref-format --branch 做权威校验
• Git 图谱面板按泳道渲染提交历史（topo-order + parents），每行带作者、时间、相对时间（刚刚 / N 分钟前 / N 小时前 / N 天前），支持加载更多
• 状态刷新三路叠加：胶囊挂载 / 弹层打开 / 切换成功各拉一次；订阅期间 host 每 30 秒轮询 workspace（仅推送变化、15 秒超时兜底）；窗口聚焦额外拉一次（5 秒节流）
• SSE 长连接经跨标签页选主中继（Web Locks + BroadcastChannel），同一 URL 全浏览器只保留一条 EventSource，避免多开标签页挤占 HTTP/1.1 同源连接池

技术实现

• 语言: TypeScript（host 半区）+ TypeScript + React 18 + CSS Modules（browser 半区）
• 关键依赖: react ^18.2.0（peer，宿主运行时注入）、@deepseek-ai/dsh-client-ui-conversation（提供 SlotMap 与输入区槽位）、@deepseek-ai/dsh-client-ui-slots（slot 注册）、@deepseek-ai/dsh-host-webserver（host 路由与 SSE 框架）
• 架构模式: 双半区 cordis bundle。src/index.ts 是 host 半区（mountOnce 单实例 guard + 注册 /git/* 路由 + 挂载 GitService）；src/client/index.ts 是 browser 半区（声明感知挂载：先等 2 秒看 shell 是否声明 conversation.input.selector.context 槽位，迟到则永久回退到 conversation.input.dock 的 hero 相位；active 会话不挂）。git 调用全部走 host 的 subprocess 服务（生产用 /git/* HTTP + SSE，测试用 plain child_process）
• 入口文件: packages/dsh-git-graph/src/index.ts（host 入口，cordis apply）、packages/dsh-git-graph/src/client/index.ts（browser 入口，cordis client apply）；cordis bundle 声明在 packages/dsh-git-graph/cordis.patch.yml:1-12（插入 id ui-git-graph），浏览器依赖在 packages/dsh-git-graph/package.json:34-46（注入 3 个官方 @deepseek-ai/dsh-client-* 模块 + platform: web）

适用场景

• 在 dsh web 上做多分支并行开发的用户：开新会话前先在空白面板点开分支胶囊，搜/切到当前想用的分支，避免每个会话都手动 git switch 一遍；
• 想可视化看自己工作区提交历史的用户：点胶囊底部「Git 图谱」打开泳道图谱面板，看一眼哪个分支走在哪条线、有没有分叉，比 git log --graph 直观；
• 习惯用对话驱动开发、希望工具栏风格与官方工作区胶囊对齐的用户：本插件的胶囊与官方 WorkspaceChip / AgentPresetSeat 走同一套 28px 透明胶囊配方与 --dsw-* 主题 token，安装后视觉风格不跳。

前置依赖与兼容性

安装方式

dsh plugin --profile web add github:zhu1090093659/dsh-web-ui/packages/dsh-git-graph

配置项

本插件无需用户配置。

host 端在源码内有几处可调常量（如轮询节奏、回退等待、请求体上限），但均无暴露给 DSH 设置面板的入口，调整需改源码后重新构建：

常见问题

Q: 安装之后分支胶囊没出现在输入区怎么办？

A: 三步排查。第一，确认 dsh web 重启过，bundle 激活是启动时一次性做的，刷新浏览器不足以触发；第二，看一眼浏览器控制台是否有 [dsh-git-graph] / 槽位声明相关的报错；第三，等大约 2 秒——本插件会等 shell 声明 conversation.input.selector.context 槽位 2 秒后才回退到 dock hero 相位，如果 shell 没声明这个洞，胶囊会自动出现在 hero 行 agent-preset 座位右侧（迟到声明会被忽略）。packages/dsh-git-graph/src/client/index.ts:184-199。

Q: 切分支时被 tracked-changes-would-be-overwritten 挡住怎么办？

A: 这是 git 自己的保护：已跟踪的本地修改会被目标分支覆盖。报错里会列出前两个阻塞文件路径 + 其余文件计数。本插件不做自动 stash（避免意外吞掉你的修改），请先 git stash 或 git commit 后再切。错误分类在 packages/dsh-git-graph/src/host/git-service.ts:87-152，文案见 packages/dsh-git-graph/src/client/locales.ts:30-35。

Q: 我工作区里有多个 Git 仓库，这个胶囊管哪个？

A: 管当前会话 cwd 所在的那个。它会读 sessions baseline 的 cwd，解析成 git rev-parse --show-toplevel 拿到的 repoRoot，所有 git switch 都作用在那个 repoRoot 上。切换工作区 = 激活目标工作区并打开它的（复用或新建的）空白会话，不会去改其他会话的 cwd。语义在 packages/dsh-git-graph/src/client/index.ts:122-132 与 packages/dsh-git-graph/README.zh.md:74。

Q: 切分支会影响已经在跑的其他会话吗？

A: 会，因为切的是工作区级磁盘树——所有会话共享同一份 checkout。如果你只是想让某个会话在另一个分支上工作，正确做法是在输入区的工作区胶囊里切到目标工作区（或新建空白会话），不是用本插件的分支胶囊。packages/dsh-git-graph/src/host/git-service.ts:204-225 / packages/dsh-git-graph/README.zh.md:74。

Q: 每次切换都能成功吗？什么情况会被拒？

A: 三类守卫挡路：未解决的合并冲突（conflicts-present）、正在进行的 git 操作（merge / rebase / cherry-pick / revert / bisect 任一标记存在 → operation-in-progress）、目标分支已被其他 worktree 检出（branch-in-other-worktree）。这三种直接拒绝并给可读报错，不会偷偷强切。守卫在 packages/dsh-git-graph/src/host/git-service.ts:323-340，错误文案见 packages/dsh-git-graph/src/client/locales.ts:27-29。

Q: 同一个 URL 开两个标签页，会不会吃光浏览器的 HTTP 连接数？

A: 不会。SSE 长连接走跨标签页选主（Web Locks + BroadcastChannel），同一 URL 全浏览器只保留一条 EventSource，其它标签页通过 BroadcastChannel 收事件，HTTP/1.1 同源连接池不被挤占。浏览器既不支持 Web Locks 也不支持 BroadcastChannel 时自动降级为每个订阅开一条（旧行为）。代码在 packages/dsh-git-graph/src/client/sse-leader.ts:45-122（对应 issue #383）。

Q: 在非 Git 目录里新建会话会怎样？

A: 胶囊直接不显示——host 端 git rev-parse --show-toplevel 失败时 RepoStatus 返回 null，前端拿 null 后不渲染控件；不会报错、不会留空块。逻辑在 packages/dsh-git-graph/src/host/git-service.ts:281-286、packages/dsh-git-graph/src/client/index.ts:134-138。

Q: 卸载插件之后 git 状态会变吗？

A: 不会。本插件不在 host 上写任何持久文件，分支切换走的就是磁盘 git switch，状态全部由 git 自己管理。卸载 dsh plugin --profile web remove @linxin666/dsh-client-ui-git-graph 不会有插件自留的状态。卸载命令见 packages/dsh-git-graph/README.zh.md:65-67。

上手难度

入门 — 一行命令安装，重启 dsh web 即可见分支胶囊；非 Git 目录自动隐藏，无需额外配置。

已知问题与限制

• 客户端等待 conversation.input.selector.context 槽位声明只有 2 秒，超时后永久回退到 conversation.input.dock 的 hero 相位；迟到声明会被忽略，host 重启前不会重试（packages/dsh-git-graph/src/client/index.ts:191-199）
• active 会话不显示分支选择控件，分支切换需要新建空白会话或重启 host（packages/dsh-git-graph/src/client/index.ts:7-9）
• 切换分支前不做自动 stash，工作树脏时会被 git 自己拒绝（packages/dsh-git-graph/src/host/git-service.ts:207-225）
• Windows 强制走 git.exe（避开 .cmd shim，避免 --format 字符串里的 % 被 cmd.exe 展开），无法在配置里覆盖（packages/dsh-git-graph/src/host/git-service.ts:41-43、60-63）
• 路径必须在 host 已注册工作区列表里，任意目录无法触发 git 操作；realpath 不存在或不在注册表里返回 workspace-unknown（packages/dsh-git-graph/src/host/git-service.ts:30-43、packages/dsh-git-graph/src/index.ts:30-43）
• /git/* 请求体超过 1 MiB 直接销毁连接，不解析（packages/dsh-git-graph/src/host/routes.ts:75、90-95）
• SSE 轮询每 30 秒一次，每个订阅者跑一次 git status；多工作区同时订阅时进程数 = 订阅者数；目前没有聚合或采样（packages/dsh-git-graph/src/host/routes.ts:49、188-206）
• 单次 git status 超时 15 秒（STATUS_TIMEOUT_MS），超时用 AbortController 杀掉子进程，UI 拿到的是 timeout 报错而非部分结果（packages/dsh-git-graph/src/host/routes.ts:58-69、171-186）
• 切换分支作用在工作区级（git switch 影响所有会话），不是 per-session 副本；想并行在多个分支上工作的用户需用「切换工作区」语义而不是分支胶囊（packages/dsh-git-graph/README.zh.md:74 / packages/dsh-git-graph/src/host/git-service.ts:196-203）

中文 | English

       
 

DeepSeek Harness（DSH）Web GUI 的插件与皮肤全家桶 · 一切皆开发，一切皆插件
梁神模式 · 任务看板 · Git 图谱 · 右侧面板 · 移动端远程 · SSH 运维 · 图像理解 · 鲸鱼娘宠物 · 皮肤中心

是什么

dsh-web-ui 继承 DeepSeek Harness（DSH）「一切皆开发、一切皆插件」的核心理念，也是这一理念在 Web GUI 上最完整的落地：它不只是一个插件包，更是一个可拓展性极强的插件生态。面向 DeepSeek V4 Pro 的「梁神模式」agent 预设，以及任务看板、Git 图谱、右侧面板、移动端远程、SSH 运维、图像理解、鲸鱼娘宠物和皮肤中心——每一样都是独立成包的模块，可插拔、可替换、可再开发；可以一次装齐全家桶，拼出完整的开发工作台，也可以只挑一两个，安静地融入原生界面。所有插件都走官方 profile 机制挂载到 dsh web，不改 DSH 源码；聚合包还能把外部插件（如 dsh-better-sidebar）拼进全家桶，详见 dsh-web-ui-all README。

「一切皆插件」还贯彻到了皮肤本身：皮肤中心 v2 重构后，一款皮肤不再是耦合官方 DSH 的 npm 包，而是一个纯资产目录——一份 skin.json 清单加上样式、贴图与可选特效脚本，交由皮肤中心这一唯一加载器即时加载。皮肤与官方彻底解耦、只与皮肤中心耦合：官方升级不再牵动任何皮肤，新增一款皮肤也只需落一个目录，无需发布、无需安装。插件负责逻辑，皮肤负责外观，边界从此清晰。

功能插件

梁神模式

DeepSeek V4 Pro 对首轮工具目录很敏感。社区评测里，官方 Standard / PTC 预设只有 91 / 92 分，Minimal 能到 99 / 96，但 Minimal 只有两个工具。梁神模式把这两步拼起来：新建会话时在预设选择器里选「梁神模式」，首轮按 Minimal 开局（只暴露持久 bash 与 str_replace_editor，只放行你自己的消息），轨迹锚定后自动切到 PTC Mode，完整工具注册表、workspace 指令和 skill 目录随后恢复。Windows 原生环境实测（DeepSeek V4 Pro）98 / 99，均值 98.5，不是抽卡，也不需要牺牲完整工具能力。

原理、稳定化控制与限制详见 dsh-liangshen README。

任务看板

侧边栏点「任务看板」进入。任务按五列摆开：待规划、待办、进行中、已完成、已失败。点卡片上的「执行」，任务交给真实的 DSH 智能体会话去跑，跑完状态自动回写；想复盘就跳回执行会话看完整过程。

任务也支持 Host 定时跑：详情里配 cron 表达式（比如每天 23:00 自动升级 DSH、每周一 09:00 生成周报），关闭浏览器后仍会到点执行和结算。可选的空闲睡眠保护支持 Windows、macOS 和带 systemd-logind 的 Linux，允许屏幕熄灭，同时阻止整机因空闲睡眠；该设置默认关闭。

Git 图谱

输入框上方有分支选择器，可以切分支、翻提交历史；Git 图谱把分支泳道和提交历史画出来，仓库再大也能顺着时间线找到变更。

移动端远程

侧边栏底部的手机图标打开配对面板。扫码（或复制链接）配对后，手机进独立移动端界面，远程操作当前的 dsh web 工作区：看会话、开新会话、收发消息、切模型和思考强度、调权限预设，都和桌面端同步。同一份配对链接也能配对 PC 浏览器（手机配对流扩展到桌面 Web GUI）：在另一台电脑打开桌面 URL 形态的链接，完整 Web GUI 便在那台设备上运行，流量走配对门控的 /remote/api 通道——未配对设备只有横幅提示、拿不到任何数据。配对令牌一次性、限时，「停止」随时吊销所有设备；二维码默认走局域网，开 cloudflared 公网隧道后手机（和 PC）在任何网络都能配对。PC 远程桌面应优先使用插件自己的设备配对通道，安全上不建议为隧道域名设置 --trusted-host；该 flag 会让 SDK 的 /api 绕过配对门控（详见插件 README）。

实时消息与隧道：移动端靠 SSE（Server-Sent Events）收实时消息。Cloudflare quick tunnel（trycloudflare.com）和 Tailscale Serve 不透传 SSE，普通 HTTP 正常、实时推送到不了；这种网络下插件自动降级轮询，收发消息正常，只是新消息可能晚几秒。要即时推送就用支持 SSE 的隧道（Cloudflare named tunnel、自定义 TCP 端口转发等）。

远程连接

侧边栏「SSH」入口打开远程运维面板。主机支持密钥 / 密码认证，可从 ~/.ssh/config 一键导入；配置都在 ~/.dsh/dsh-ssh.json。对已配置主机可执行真实操作：

• Web 终端：xterm.js 远程终端，实时输出，窗口大小自适应；
• 文件传输：SFTP 上传 / 下载，有进度条，能浏览远程目录；
• 端口转发：本地隧道直连远程内网服务（数据库、API、管理后台），只监听 127.0.0.1；
• 集群执行：一条命令并发跑多台主机，按别名 / 环境 / 标签过滤；
• Agent 直连：Agent 和面板共用同一份主机配置，对话里说一句「连一下 xxx 看看状态」，智能体就去执行远程命令。

图像理解

给纯文本模型补上视觉：对话里提到图片（本地路径、http(s) URL、会话附件）时，describe_image 把图片发给配置好的 OpenAI 兼容视觉端点（Qwen-VL、GLM-4V、GPT-4o、本地 Ollama 都行）回答，进会话的只有返回的文本，图片本身不进会话记录。纯文本模型输入框没有图片入口，插件在输入框加了个图片按钮：选图后生成附件引用插进草稿，模型就能用 describe_image 分析；工具还支持 prompt 参数传自定义指令（OCR、UI 诊断、翻译），比默认描述准。端点、模型、密钥、默认指令在「设置 > 插件配置 > Image understanding」里配，即时生效。

右侧面板

右侧面板由外部插件 dsh-better-sidebar 提供（聚合包已集成并默认启用），支持其内置功能与第三方插件注册，详见其 README。

此前的 aionui-panel 右侧面板已停止支持：默认关闭，不再维护、测试或接受修复，后续版本将从全家桶移除；设置 → Web UI 插件 → 侧边卡片 卡内嵌其常用设置。

鲸鱼娘宠物

一只常驻界面的鲸鱼娘，跟着智能体状态换动画：思考、等待、工作、庆祝。可以点她互动（摸头），喂小鱼干加亲密度，从幼鲸一路养到「深海羁绊」。名字能改，位置能拖，不想看就藏起来。

皮肤

皮肤中心有 12 款皮肤，都支持先试穿再应用：试穿即时生效、退出完全还原，满意再一键应用。

12 款皮肤一览；Maid Atelier 预览见下方：

Windows XP（Luna）

还原 Luna 经典界面：蓝色渐变窗口条、绿色「开始」按钮、Bliss 蓝天桌面，全局直角风格。

Blue Fantasy 蓝色幻想

鲸鱼插画垫在半透明面板下面，靛蓝色调贯穿全局，暗色主题下更明显。

鲸吟（Whale Song）

深海鲸语女神主题：无文字纯氛围背景画（蓝发女神与鲸群居左、冰蓝星座网格与金色细线点缀、右侧大量留白）垫在半透明面板下面，冰蓝 / 浅青 / 深海军蓝 / 钴蓝冷色体系贯穿全局，暗色变体是深海夜航调。

·

夕港（Harbor）

黄昏港口主题：动漫少女港口背景（暮光蓝天空渐入日落橙）垫在半透明面板下面，深暮蓝底与日落橙主色贯穿全局，亮色是薄暮纱、暗色是深海夜航纱。

·

深海女仆工坊（Maid Atelier）

深海蓝工坊主题，包含双角色图层与响应式侧边栏装饰。本皮肤单独采用 CC BY-NC-SA 4.0，仅限非商业使用。

·

Wallpaper Engine 壁纸

皮肤中心可直接把本机 Wallpaper Engine 壁纸库用作 GUI 背景，支持导入动态与静态壁纸：视频与网页壁纸动态渲染，场景壁纸以静态帧呈现，任意类型也能用「静态帧」模式钉成零动画开销的图片。单张壁纸可导入 skin-center/wallpapers/，脱离 Steam 库也能用，并检测创意工坊原作更新；没有 Wallpaper Engine（如 macOS）时，手动目录可把任意 .mp4/.webm 视频文件夹或壁纸项目文件夹加为壁纸库。壁纸都是本机文件，从不上传或再分发。

快速开始

系统要求

• 已安装 DeepSeek Harness，dsh web 可正常启动。
• npm 安装方式无额外要求；从仓库安装需要 Node.js >= 22 与 pnpm。

三步上手

1. 安装聚合包：dsh plugin --profile web add @linxin666/dsh-web-ui-all@latest
2. 重启 dsh web，侧边栏出现全部插件入口
3. 打开「设置 > 插件配置」按需开关插件，或在皮肤中心试穿皮肤

从 npm 安装（推荐）

插件已发布到 npm（@linxin666 scope），一条命令装齐：

dsh plugin --profile web add @linxin666/dsh-web-ui-all@latest

装完重启 dsh web，侧边栏就有全部插件入口。只要皮肤就装 @linxin666/dsh-client-ui-skin-center。

装到了旧版本？ pnpm 11+ 默认的发布年龄门禁（minimumReleaseAge，内置 24 小时）会把新发布的版本静默隔离，导致按上面命令实际装到上一个版本（如 0.1.20 而非 0.2.0）；显式写 @latest 也一样会被隔离。旧版皮肤中心缺少 "carrier 内建皮肤可解析入口" 的修复，应用皮肤后重启会以 ERR_MODULE_NOT_FOUND .../dsh-client-ui-skin-<id>/index.js 崩溃。解决办法：在 profile 的 pnpm-workspace.yaml 设置 minimumReleaseAge: 0（或把 @linxin666/* 加进 minimumReleaseAgeExclude），再执行 dsh plugin --profile web update @linxin666/dsh-web-ui-all@latest 升级到最新版。详见 issue #71。

从 GitHub 仓库安装（开发调试）

插件包已在 npm 发布，仓库安装仅供开发调试（需要 Node.js >= 22 与 pnpm）：

# 1. 克隆仓库
git clone https://github.com/zhu1090093659/dsh-web-ui.git
cd dsh-web-ui

# 2. 安装依赖并构建
pnpm install
pnpm -r build

# 3. 把全家桶链接进 web profile（推荐，先链接全部子包再注册聚合包）
node scripts/link-profile.mjs
dsh plugin --profile web add link:$(pwd)/packages/dsh-web-ui-all

# 4. 重启 dsh web，侧边栏即可看到全部插件入口
dsh web

只想用皮肤：第 3 步只执行 link-profile 后安装 packages/skins/skin-center 即可。

注意：profile 目录不是 pnpm workspace，聚合包里的 workspace:* 依赖会回退拉取 npm 已发布版本； 若 npm 版本滞后或损坏会出现「宿主已挂载但 UI 不显示」，此时先用 node scripts/link-profile.mjs 让全部子包走仓库构建产物。

单独安装某个插件

不想装全家桶时，可单独安装任意插件（npm 已发布，直接用包名）：

dsh plugin --profile web add @linxin666/dsh-liangshen@latest               # 梁神模式
dsh plugin --profile web add @linxin666/dsh-client-ui-task-board@latest    # 任务看板
dsh plugin --profile web add @linxin666/dsh-ssh@latest                     # 远程连接（SSH）
dsh plugin --profile web add @linxin666/dsh-tool-describe-image@latest     # 图像理解工具
dsh plugin --profile web add @linxin666/dsh-pet@latest                     # 鲸鱼娘宠物
dsh plugin --profile web add dsh-better-sidebar@latest                     # 右侧面板（推荐；资源管理器/编辑器/终端/Git/浏览器）
dsh plugin --profile web add @linxin666/dsh-client-ui-aionui-panel@latest  # 旧右侧面板（aionui-panel，已停止支持，仅过渡保留）

验证与卸载

装好重启 dsh web，侧边栏出现对应入口就是生效了；也可以用 dsh --profile web --dump-config 确认插件配置层已挂载。侧边栏没新入口，多半是装完没重启 dsh web。

卸载：dsh plugin --profile web remove @linxin666/dsh-web-ui-all，然后重启 dsh web。

技术细节见 docs/plugins.md。

安装排障

展开查看 pnpm 常见问题

pnpm 的严格（isolated）布局只把聚合包放在 profile 顶层，patch 行引用的 11 个子包（共 12 行 insert）会被收进嵌套目录，dsh web 会报 Cannot find package '@linxin666/dsh-...'。本包的子包已声明为 dependencies；使用严格布局时，在 profile 的 pnpm-workspace.yaml 加 nodeLinker: hoisted（或旧式 public-hoist-pattern: ['@linxin666/*']），再重新安装即可。

首次安装若提示 ERR_PNPM_IGNORED_BUILDS（pnpm 拒绝依赖的构建脚本），按提示把 cloudflared / cpu-features / ssh2 加入 profile 的 pnpm-workspace.yaml allowBuilds 后重新执行即可。

pnpm 11 release-age 门禁：新版本发布后 24 小时内（minimumReleaseAge 内置默认值），pnpm 11 会静默装回更旧的 @linxin666/* 版本（如 dsh-web-ui-all@0.1.20 配旧版皮肤中心），显式写 @latest 同样被隔离。旧版皮肤中心 Apply 皮肤时会写入独立皮肤包引用，导致 dsh web 启动崩溃（ERR_MODULE_NOT_FOUND ... dsh-client-ui-skin-*）。在 profile 的 pnpm-workspace.yaml 中排除全部 @linxin666/* 包后再安装或更新：

minimumReleaseAgeExclude:
  - '@linxin666/*'

常见问题

装完重启了，侧边栏还是没有入口？

A: 先确认插件装进了 web profile（命令里的 --profile web），再用 dsh --profile web --dump-config 确认插件配置层已挂载；还不行就看上文「安装排障」。注意页面刷新不够，要重启 dsh web 进程。

定时任务为什么没有到点执行？

A: 定时调度由 dsh web Host 完成，不要求浏览器标签页保持打开。Host 停止、系统睡眠或长暂停期间错过的触发点按「错过即跳过」处理，不排队补跑；同一任务正在运行时到点也会顺延到下一个匹配点。若需要允许息屏但阻止整机因空闲睡眠，可显式开启任务看板的电源保护设置。

手机配对后收不到实时消息？

A: Cloudflare quick tunnel 和 Tailscale Serve 不透传 SSE，这种网络下插件自动降级轮询，消息正常收发，只是新消息可能晚几秒。要即时推送就用支持 SSE 的隧道（Cloudflare named tunnel、自定义 TCP 端口转发等）。

皮肤试了不满意怎么办？

A: 皮肤支持先试穿再应用：试穿即时生效、退出完全还原，没点「应用」就不落盘，随便试。

只想用皮肤，或者只装某一个插件？

A: 只要皮肤就装 @linxin666/dsh-client-ui-skin-center；只装某一个插件就用「单独安装某个插件」里的包名，两者都走 npm 安装。

装了全家桶还能再单独装同一个插件吗？

A: 可以。聚合包的行 id 统一带 web-ui- 前缀（如 web-ui-describe-image），与独立包自己的 id（如 describe-image）不冲突，dsh web 不会再报 duplicate loader entry id；同一插件双源加载时 host 半区只注册一次，浏览器半区按包名去重。两个来源并存没有额外收益，建议只保留一个。注意：profile 里按 id 写的配置行，若插件来自聚合包要用 web-ui- 前缀的 id（如 remote-web-ui 的 autoTunnel 配置行写成 web-ui-remote-web-ui）；独立安装时仍用插件原 id。

已知限制

• 任务看板由 Host 调度，关闭浏览器后仍可运行；Host 停止或整机睡眠期间错过的触发点跳过、不补跑。可选电源保护默认关闭，只阻止空闲系统睡眠，不拦截合盖、手动睡眠、休眠或关机，详见 dsh-task-board README。
• SSH 密码与 passphrase 口令以明文保存在 ~/.dsh/dsh-ssh.json（权限 0600）；断线重连可能重放非幂等命令，远程输出原样返回、不脱敏，安全模型见 dsh-ssh README。
• 移动端靠 SSE 实时推送：Cloudflare quick tunnel 和 Tailscale Serve 不透传 SSE，插件自动降级轮询，新消息可能晚几秒。
• 仓库安装需要 Node.js >= 22 与 pnpm，仅供开发调试；npm 安装不受影响。

社区

社区交流群在这里，和开发者、其他用户一起聊用法、报问题、提想法。QQ 扫码加入「DSH Web UI 交流群」：

也可以加 Discord 社区，或直接到 GitHub Issues 报 Bug / 提需求。

友情链接

• DeepSeek Harness Desktop —— 为 DeepSeek Harness (DSH) 生态打造的现代化桌面端体验。
• LINUX DO —— 有理想的新社区。
• dshfind —— 面向 DeepSeek Harness 的学习与分享社区，聚合论文精读、插件超市与用户排名。
• deepseek-plugin-store —— DeepSeek Harness 独立社区插件商店，发现、安装并提交经过验证的插件、工具与扩展。
• dsh-data-agent —— 为 DSH 定义专用 Data Agent 预设，让 AI 帮你查询、更新、分析数据。
• dsh-TUI —— Claude Code 风格全屏交互终端插件，补位官方缺失的终端 TUI：像素鲸鱼顶栏、实时工作状态行、思考流式展开、双击 Esc 回滚、上下文进度条与 TPS 仪表。
• dsh-tianshu-tui —— 基于官方 DeepSeek Harness 的交互式终端 UI 插件，在官方基础上增加 TDD 与证据门等工作流。
• dsh-genui —— 助手回复内联渲染生成式 UI（dsh-ui fence）：布局、图表、表单、Mermaid、3D 与面板停靠，组件交互回传模型。
• dsh-annotation —— DSH Web 选中批注插件：选文字、写批注、随消息发送，模型按 Annotation N 逐条对照回复。

参与贡献

• 先读 CONTRIBUTING.md 再开 PR；用户可见变更请附截图或验证证据。
• 提交信息遵循 Conventional Commits（如 fix(task-board): 修复 xxx），代码、文档与提交信息全程禁止 emoji。
• 新插件与皮肤用脚手架生成：node scripts/dsh-plugin-new <name>、node scripts/dsh-skin-new。
• 提交前过门禁 pnpm typecheck && pnpm test && pnpm docs:check；完整开发流程见 docs/development.md。

许可证

本仓库以 Apache-2.0 授权。迁入第三方代码必须保留 LICENSE 与署名；活跃且有上游的第三方优先 fork 或依赖引用，不搬代码。

来源与版权

贡献者

_{查看全部贡献者}