为 DSH Web GUI 复刻 AionUi 右侧面板：Explorer 文件树与 Git 变更、Preview 多格式预览、按项目隔离的面板宽度持久化。
ⓘ 此插件是大仓库 ningbainb/deepseek-harness-desktop 的子包，星数与活跃度统计的是整个仓库。
- 语言
- TypeScript
- License
- BSD-3-Clause
- 分支
- main
安装
$ dsh plugin --profile web add github:ningbainb/deepseek-harness-desktop/packages/dsh-aionui-panel在终端中运行以上命令，通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh？看这篇新手教程
对话式安装
帮我安装 DeepSeek Harness 插件 ningbainb/deepseek-harness-desktop/packages/dsh-aionui-panel：先查看仓库 https://github.com/ningbainb/deepseek-harness-desktop.git 确认安全性，然后执行安装命令并验证插件加载成功。
把这段指令粘贴给 DSH Web GUI 里的助手，由它代你完成安装与验证。
一句话定位
dsh-aionui-panel 是 DSH Web GUI 聊天区右侧的两块面板：Explorer 提供文件树、按文件名搜索、Git 变更的 stage / unstage / discard；Preview 提供 markdown / 代码 / 文档 / 图片 / PDF 等 10+ 格式的多 tab 预览，并支持面板宽度按项目隔离持久化。它把 AionUi 的右侧面板（Apache-2.0 参考实现）按官方 SDK 重新实现，数据源走宿主进程托管的真实文件系统与真实 git 仓库。
核心能力
- Explorer 文件树：点击文件在 Preview 打开，整行点击展开/折叠文件夹，顶部按文件名搜索（150ms 防抖、跳过 .git 与 node_modules、命中上限 200 条、扫描上限 20,000 项）。
- 拖拽文件到聊天输入框：文件树行可拖到输入框松手，相对路径插入当前草稿光标处；拖拽过程中输入框上方出现高亮提示条。
- Git 变更面板：读取真实 git status（porcelain v1 -z）并支持 stage / unstage / discard；untracked 走删除、tracked 走 restore、批量放弃弹确认。
- Preview 多 tab 预览：markdown / html / code / diff / csv / pdf / word / excel / ppt / 图片 / 文本 / url；支持源码/预览切换、分屏编辑（比例持久化）、保存（mtime 冲突检测）、下载、刷新、dirty 点、中键关闭、右键批量关闭（dirty 确认）、tab 溢出渐变指示器。
- 面板宽度可拖拽调整（rAF 帧合并）：Explorer 默认 260px / 范围 220
500px；Preview 默认 480px / 范围 3401200px；双击把手复位默认宽度；两级钳位保证聊天区 >= 360px；折叠 = 宽度缩 0 但组件保持挂载，树展开态与预览 tab 不丢失。 - 偏好按项目隔离持久化：localStorage 键名沿用 AionUi（
chat-workspace-width-px、chat-preview-width-px、preview-panel-split-ratio、project-panel-collapse:<root>、explorer-ui:<root>、scm-ui:<root>、preview-ui:<root>），LRU 上限 12 个 scope，非法值范围校验后回退默认。
技术实现
- 语言: TypeScript（ESM；host 与 browser 半区分层编译）
- 关键依赖:
@deepseek-ai/cordis（host 半区插件运行时）、@deepseek-ai/dsh-client-runtime/@deepseek-ai/dsh-client-locale/@deepseek-ai/dsh-client-ui-conversation（browser 半区注入）、@linxin666/dsh-desktop-client（仅在 Desktop 运行时提供"在系统应用中打开"动作，可选依赖）、react ^18.2.0（UI 渲染） - 架构模式: Cordis 双半区插件 —
src/index.ts是 host 半区（Node 进程：fs/git 服务 + /aionui-panel/* 路由 + systemPrompt 公告），src/client/index.ts是 browser 半区（Web GUI 侧：状态核心 + 拖拽引擎 + DOM 布局控制器 + React 组件），src/core/types.ts是两侧共享的纯类型；cordis.patch.yml把插件行插入 web profile 名单，package.json#dsh.client声明浏览器注入与platform: "web" - 入口文件:
src/index.ts（host 半区入口）、src/client/index.ts（browser 半区入口）、src/host/routes.ts（/aionui-panel/* 路由层，含 loopback fence 与 SSE）、src/host/gate.ts（workspace gate）、src/host/fs-service.ts/src/host/git-service.ts（fs / git 数据服务）
适用场景
在 DSH Web GUI 里开项目会话、想让 LLM 直接看到/改真实仓库文件的用户：聊天时让 agent 读 .ts 看 .yaml，或人工点开几个文件对照草稿。如果你已经在 dsh web 上跑 DSH、但觉得"只能打字给 agent"不够直观、希望有 VS Code 那种右侧项目浏览器感，这一插件就是补这一块的。
前置依赖与兼容性
| 依赖 | 最低版本 | 说明 |
|---|---|---|
| DSH 运行时 | >=0.1.0-rc.7 <0.2.0 | package.json#dsh.compatibility.runtime.range 显式声明（packages/dsh-aionui-panel/package.json:29-31） |
| DSH Desktop | >=2.7.0 <3.0.0 | package.json#dsh.compatibility.desktop.range；"在系统应用中打开"动作依赖 Desktop 运行时（packages/dsh-aionui-panel/package.json:24-28） |
| Node.js | ^22.19 || >=24 | 包级 package.json 未独立声明 engines；根 package.json#engines 全仓统一为 ^22.19 || >=24（仓库根 package.json） |
| 平台 | 跨平台（macOS / Windows / Linux） | browser 半区 + loopback-only HTTP 路由，浏览器加载使用 platform: "web"；host 半区 path 处理在 win32 上做大小写无关、分隔符无关的规范化（packages/dsh-aionui-panel/package.json:46-53、src/host/gate.ts:28-46） |
| 原生模块 | 无 | 仅依赖 Node 标准库（node:fs、node:http、node:path、node:fs/promises）与官方 SDK；没有 koffi / node-pty / node:sqlite 等原生绑定 |
安装方式
dsh plugin --profile web add github:ningbainb/deepseek-harness-desktop/packages/dsh-aionui-panel
安装后重启 dsh web，打开一个有工作目录的项目会话即可看到聊天区右侧的"预览"与"文件/变更"面板。
配置项
本插件无需 DSH 侧配置（无 cordis Schema 或 ctx.config 暴露项）。浏览器侧的"用户偏好"——面板宽度、折叠态、Preview 分屏比例、tab 顺序——由本插件自己写到 localStorage，按 project root 隔离，无需用户手工配置。
常见问题
Q: 这个插件装上后能看到什么？
A: 在 dsh web 打开的项目会话中，聊天区右侧会多出两块面板：Explorer（文件树 + Git 变更 tab）与 Preview（多 tab 文件预览）。文件树拖到聊天输入框即可把相对路径插入草稿光标处，无需手敲路径。
Q: 文件预览支持哪些格式？
A: markdown / html / code / diff / csv / pdf / word / excel / ppt / 图片 / 文本 / url 共 10+ 种格式，支持源码/预览切换、分屏编辑、保存（含 mtime 冲突检测）、下载、刷新、dirty 点、中键关闭、右键批量关闭。
Q: 必须用 DSH Web GUI（profile=web）才能看到这个插件吗？
A: 是。cordis.patch.yml 把插件行插入 web profile 名单，package.json#dsh.client.platform 字段也是 web；CLI 模式（headless profile）下浏览器半区不会加载。
Q: 数据是真的文件系统还是 mock？
A: 真实。宿主进程经 /aionui-panel/* HTTP 路由提供目录列举、文件读、写、文件名搜索、git status / diff / stage / unstage / discard；递归 fs.watch + 每 30s 一次的 git 轮询组成 SSE 变更流。
Q: 我能在另一台机器上访问 dsh web 来用这个插件吗？
A: 不能。所有 /aionui-panel 路由都强制仅 loopback：非 127.0.0.1/::1 客户端立刻收到 403 forbidden: loopback-only，与 dsh-ssh 同款 fence。LAN 暴露的 dsh web 不会向未配对设备泄露任何 fs/git 操作。
Q: 工作区路径不在已注册 workspace 里会被怎么处理？
A: 直接拒绝。所有请求的 project root 都过 workspace gate：realpath 规范化后必须落在 ctx.workspaceRegistry.list() 返回的某个 workspace 内或其子目录；越界返回 workspace-unknown，路径穿越返回 path-outside-root。
Q: 我没装 git 二进制能用吗？
A: 文件树和预览完全可用。git 轮询探测一次后判定不可用即打日志并下发 gitUnavailable 事件，SCM tab 进入友好的"未安装 git"状态而不再每 2 秒重试 spawn。
Q: 面板宽度、折叠状态会保存吗？
A: 按项目隔离保存到 localStorage，键名沿用 AionUi 命名；LRU 上限 12 个 scope，超出最久未用被淘汰；读取一律范围校验，非法值回退默认。
上手难度
入门 — 安装 + 重启 dsh web + 打开项目会话即用；面板宽度、折叠、Preview 行为都是所见即所得，无需阅读文档。
已知问题与限制
- 所有 /aionui-panel/* 路由（含 JSON 操作、raw 读取与 SSE 事件流）都强制仅 loopback，LAN 客户端会被立刻拒绝（src/host/routes.ts:70-96）。
- 工作区 gate 要求请求路径必须在 ctx.workspaceRegistry 注册的 workspace 内；未注册或路径穿越一律拒绝（src/host/gate.ts:55-74、src/host/fs-service.ts:51-80）。
- 文本读取上限 80k 字符、图片读取上限 8MB（src/host/fs-service.ts:29-33）；文件名搜索命中上限 200 条、扫描上限 20,000 项，跳过
.git与node_modules（src/host/fs-service.ts:35-38）。 - Preview 拖文件到输入框仅作用于文件行；目录行不可拖（README.md:30）。
- localStorage 偏好持久化 LRU 上限 12 个 project root scope，超出最久未用被淘汰（README.md:39）。
- git 轮询探测一次后判定机器无 git 二进制即标记不可用，后续仅 fs.watch 触发刷新；SCM tab 进入友好态但不再每 30s 重试（src/host/routes.ts:172-185）。
- 仅当宿主为 DSH Desktop 时，Preview 工具栏"在系统应用中打开"按钮才可用；普通
dsh web浏览器侧点击该按钮会提示"无法在系统应用中打开此文件"（src/client/preview/open-external.ts:14-31）。 - package.json#dsh.compatibility.runtime 锁在
>=0.1.0-rc.7 <0.2.0，与上游@deepseek-ai/*SDK 的 rc 版本强绑定；DSH 升级到非兼容版本时需等待插件同步发版（packages/dsh-aionui-panel/package.json:29-31）。
中文 | English
DeepSeek Harness Desktop 是社区维护的开源 Windows AI 编程桌面客户端：它把完整的 DeepSeek Harness Web Surface、官方 DSH 本地主机、插件、Skills、主题和自动更新打包进一个 Windows x64 安装器。支持 Windows 10/11，免费采用 BSD-3-Clause 许可证，安装后无需另配 Node.js。
社区用户交流群
QQ 群：1105158177 · 点击一键加入 QQ 群
Windows 桌面版
DeepSeek Harness Desktop 将原版 DSH Web 界面完整装进 Windows EXE：不是重写页面，而是用安全的 Electron 窗口启动官方 @deepseek-ai/dsh 本地主机，再原样加载本仓库的全部插件与皮肤。
浏览产品介绍 · 下载 Windows x64 安装器 · 桌面版技术说明 · Task Board v3 说明 · 发布与交接工作流 · 更新日志
如果这个项目对你有帮助，欢迎在 GitHub 仓库 点 Star，帮助更多桌面版用户发现它。
最新版：2.7.0
desktop-v2.7.0 是当前稳定版：查看完整发布说明 · 直接下载安装包 · 下载 SHA-256 校验文件
| 版本 | 主要更新 |
|---|---|
| 2.7.0 | 修复 Windows 8% Runtime 启动故障并升级到 DSH rc.7；新增托盘后台自动化、Host 持久任务调度、插件兼容声明/锁、browser-safe Desktop SDK、安全工作区外部打开和 Candidate Matrix。 |
| 2.6.0 | Task Board v3 引入 Project、Task Run、Evidence 与 Git Worktree 审核流；Runtime Provider 缺少可选能力时显式回退 shared-workspace，并加入 Candidate 执行兼容夹具与有界匿名产品统计。 |
| 2.5.0 | 新增 Runtime Adapter 与上游兼容防线、安全 .dshpreset 和 Web Profile 迁移、原子插件批量事务、严格 Deep Link/文件关联与结构化通知。 |
| 2.4.0 | 新增可靠更新关停回执 v2、主界面/扩展坞权限拆分、Desktop Contract v1，以及 Task Board Host 文件存储 v2。 |
| 2.3.0 | 新增只出现一次的 GitHub Star 动画引导与“加入社群”反馈入口；安装预检可识别外部 PowerShell/CMD/Node 宿主、EncodedCommand 与 Windows 短路径，兼容 0.1.9 直接升级，并通过独立 profile 与端口回退和官方 Web 端共存。 |
| 2.2.0 | 隐藏 Windows 终端及其后代窗口；升级时自动清理旧应用和插件后台、迁移可识别旧依赖与旧安全模式误判；重启复用端口，安全模式支持可见提示与一键恢复。 |
| 2.1.0 | 新增国内更新镜像自动测速与回退、插件快照/自动隔离/安全模式三层容灾；统一皮肤持久化，修复升级文件占用、隐藏命令框、中文工作区重启循环，并从工具菜单直接打开扩展坞。 |
| 2.0.0 | 修复取消后排队消息滞留与运行时损坏循环；新增 Skills 菜单、模型 API 有界重试、思考区吸顶和 SSH 实时监控；统一 Harness 原生视觉并完善粒子鲸鱼启动页。 |
| 0.1.9 | 修复对话气泡与整段内容复制；更新改为后台下载并加入毛玻璃更新面板与粒子鲸鱼启动页；新增社区插件适配检测、离线切换、失败回滚与性能保护。 |
| 0.1.8 | 内置 ChatGPT OAuth 与 OpenAI Codex 模型、模型推理强度滑块、帮助菜单社群与建议入口；默认只保留 dshmarket，并修复空补丁、旧市场和皮肤链接迁移。 |
| 0.1.7 | 全新深海启动界面与状态驱动进度；32px macOS 风格磨砂玻璃窗口栏；收紧大文件预览内存、Git 轮询和 SSH 传输边界，并提升首次安装后的冷启动容错与发布门禁。 |
| 0.1.6 | 内置腾讯官方 QQ Bot 与扫码 Connector；在扩展坞完成二维码绑定、刷新、取消、重新绑定和解绑，QQ 私聊与群聊可直接接入桌面版 Harness。AppSecret 使用 Windows 凭据保护加密，只注入 DSH 子进程。 |
| 0.1.5 | 原生标题栏跟随亮色/暗色主题；全屏弹窗避开标题栏安全区；修复安装版皮肤发现与切换，并内置 dshmarket 和 dsh-plugin-hub。 |
| 0.1.4 | 桌宠迁移到全局 Shell Overlay，首页和设置页均可见；恢复五张 Web UI 插件配置卡；皮肤中心完整展示安装版随附的九套皮肤。 |
| 0.1.3 | 加入稳定版 GitHub Release 更新检查、双语更新说明、用户确认下载、任务栏进度和二次确认安装。 |
2.7.0 功能亮点
- 可靠 Windows 启动：移除 PowerShell 5.1
-WindowStyle Hidden与 Electron Node 模式的冲突，隐藏窗口仍由spawn的windowsHide处理；空旧补丁、状态订阅竞态和 IPC 错误不会再把启动页永久留在 8%。 - 验证过的 Runtime 组合：内置
@deepseek-ai/dsh0.1.0-rc.7、dshmarket1.15.0、Web UI 聚合0.2.3、兼容 rc.7 的 Codex Connect 与dsh-live-stats0.1.20，Stable 继续精确锁定而非追随latest。 - 托盘与后台自动化需显式选择：默认关闭仍会退出。选择“最小化到托盘并启用后台自动化”后，关闭主窗口才保留 Runtime 和到期任务；显式退出、更新、安全模式和崩溃路径一律完整停止。
- Host 持久任务调度：Task Board 保存时区、cron 槽位、租约、misfire/running 策略和确定性运行键；启用后台自动化时通过真实 DSH Session 执行并回写 Task Run，Host 不可用时仍回退浏览器调度。
- 可审计的扩展边界：扩展坞校验
dsh.compatibility的版本、Desktop API、能力、Surface 与运行时证据，并在 profile 写入desktop-plugins.lock.json。browser-safe SDK 不导入 Electron 或私有 DSH 模块；预览的外部打开仅传工作区根和相对路径，Host 验证后才交给系统。 - Candidate Matrix：候选 DSH 在临时 worktree 中收集矩阵、Stable 支持和离线社区插件质量证据；候选永远不能自动改写 Stable 依赖、lockfile、更新元数据或发布。
2.6.0 功能亮点
- Task Board v3：任务可关联 Project，明确选择 shared-workspace 或 Git Worktree；旧账本复制迁移到 Host-owned v3，原 v2 文件保留为备份。
- 可审阅执行结果：每次执行生成紧凑 Task Run 与派生 Evidence，展示文件、增删统计、有限 diff 预览、Session/运行入口和 Provider 能力证据，不保存完整会话或 Secret。
- 受控 Git Worktree：Host 只接受不透明 id，固定 Worktree 根目录、分支命名、realpath、clean/conflict/operation 预检；Commit、Merge、Keep、Discard 都是明确审核动作，Discard 需要二次确认。
- 安全兼容回退：Stable Provider 仍可只提供生命周期和 Profile 能力；缺少 Worktree 所需能力时记录原因并使用现有 shared-workspace 执行，不伪造隔离状态。
- Candidate 执行门禁：真实临时 Git 仓库夹具验证 Session CWD、生命周期事件、取消与重启恢复，失败只阻断 Candidate，不改 Stable 图或发布元数据。
- 匿名统计边界：官方正式版默认启用仅用于产品改进的有界匿名统计，不提供应用内关闭开关；不收集身份、对话、文件、路径、凭据或日志，不保留原始事件，源码与 Fork 构建不包含官方统计端点。完整范围见 隐私政策。
2.5.0 功能亮点
- Runtime 兼容防线：Adapter v1、直接 import 边界、Known Good、patch registry 与耦合审计共同保护稳定 DSH 图；Candidate Lite 只生成报告，不自动升级 Stable。
- 安全 Desktop Preset：
.dshpresetv1 在主进程检查完整性、路径、压缩比、脚本、Secret、Git URL 与精确版本，Renderer 只获得审阅计划。 - 全环境原子回滚：批量插件、设置、Skills 与任务模板使用一次 Runtime 停止/启动事务；任何包或健康检查失败都会恢复旧环境。
- Web Profile 选择性迁移：迁移前显示可安装、更新、缺失、不兼容、未声明、已满足和 Desktop 管理项；所选插件与可归属的非敏感 Profile 配置在同一事务中应用或回滚。
- 明确后续动作：插件变更后突出显示“刷新”；改变 bundle 图时同时提供“Restart DeepSeek Harness”，Preset 进度完整显示提交或恢复状态。
- 严格系统入口：
dsh://仅允许固定导航路由和安全 ID；.dshpreset双击只打开预览，不把文件路径交给 Renderer，也不会静默安装。 - 结构化通知：Desktop Contract 1.1 校验通知分类、ID、文本与 Deep Link，支持去重、限频、前台抑制和白名单点击路由。
- 稳定版不追 latest：当前 Runtime 继续精确锁定验证版本；Candidate 失败不会影响主分支、lockfile、发布说明或 updater 元数据。
2.5.0 体验与更新改进
- 全页粒子主题：粒子鲸鱼从启动页延伸到主界面，并按普通浏览、输入聚焦、弹窗、减少动态效果和后台状态自动调低密度、透明度与速度；可在「设置 > 插件配置 > 粒子主题」中开关和调整。
- 可调设置窗口：设置面板可拖动、从八个边/角缩放并记住上次位置和尺寸；最小尺寸、响应式布局和屏幕约束可避免内容重叠、溢出或移出可见区域。
- 明确的更新下载路径：GitHub Releases 是唯一默认下载源；更新窗口提供「前往 GitHub 下载」「加入用户群」「稍后更新」。若 GitHub 下载较慢，可加入 QQ 用户群获取同步安装包。
- 覆盖更新不再依赖旧卸载器：安装器会在严格进程与文件锁检查后迁移旧程序并清理精确注册项；即使旧 2.5.0 已带修复标记，也不会再次进入有缺陷的卸载流程。
完整桌面能力
- 排队消息可靠续传：智能体工作时发送的消息继续按 FIFO 顺序排队；取消当前执行后，队列会自动恢复，不丢失、不重复、不乱序。
- 对话栏 Skills 技能库：输入框左下角直接搜索已安装技能，支持最近使用、来源与描述展示、方向键导航、Enter 插入和 Esc 关闭。
- 模型 API 自动恢复：对限流、超时、断网和可恢复服务端错误执行有界退避重试；恢复后继续当前请求，手动取消仍会立即生效。
- SSH 实时监控与安全操作：每三秒刷新 CPU、内存、磁盘、负载、进程与失败服务；经过确认后可终止进程或重启 systemd 服务。
- 长思考随时折叠：思考区展开后，折叠控制会吸附在会话顶部，不必滚回长内容起点。
- 运行时完整性预检：启动前检查关键文件，安装不完整时停止重启循环并给出明确的重新安装提示。
- 更新与安装更可靠：GitHub 官方源优先，发现新版后后台下载，完成后再确认重启安装；GitHub 下载较慢时可从用户群获取同步安装包，退出时完整回收 DSH 子进程。
- Harness 原生视觉统一：标题栏、扩展坞、启动页和主界面使用一致的系统视觉；全页粒子鲸鱼会按交互场景自动安静下来，并尊重减少动态效果设置。
Harness 主界面
2.3.0 桌面界面
| 粒子鲸鱼启动界面 | 插件与技能扩展坞 |
|---|---|
 |  |
- 内置 dsh-web-ui 0.1.18 套件，保留任务看板、Git 图谱、右侧面板、SSH、移动端远程、实时统计、宠物，并加入独立的全页粒子主题、图像描述与量身 Agent；
- 内置腾讯官方 QQ Bot，可在扩展坞扫码绑定 QQ 私聊与群聊，无需编辑 YAML 或打开后台终端；
- 内置 ChatGPT OAuth、OpenAI Codex 模型与推理强度滑块，登录使用系统浏览器，凭据保存在本机；
- 独立
desktopprofile，不覆盖既有 DSH 配置，运行时仅监听回环地址； - 内置崩溃恢复、日志脱敏与轮转、窗口状态恢复、严格导航与权限策略；
- 内置 GitHub Release 更新检查，发现新版后在后台下载，完成后再由用户阅读说明并确认重启安装；
- 扩展坞支持社区 DSH bundle 安装/回滚、内置插件市场，以及项目、DSH、Agents 技能发现与安全导入；
- 安装包自带官方 DSH、pnpm 与原生依赖，无需另外安装 Node.js。
桌面版已预装任务看板、Git 图谱、右侧面板、移动端远程、远程连接、鲸鱼娘宠物、全页粒子主题、实时令牌统计、Codex Connect、推理强度滑块、插件市场和皮肤中心。下载安装 EXE 即可使用，不需要另外安装 DSH、Node.js 或执行插件命令。
功能插件
QQ 机器人扫码接入（桌面版 0.1.6）
桌面版内置腾讯官方 @tencent-connect/dsh-qqbot 0.3.0 和 @tencent-connect/qqbot-connector 1.2.0。在扩展坞打开 QQ Bot 卡片即可获取自动刷新的二维码，使用手机 QQ 扫码后，QQ 私聊与群聊便可连接到本机 Harness；同时支持取消、重新绑定和彻底解绑。
未绑定时插件保持禁用，不会让隐藏的后台进程等待终端扫码，也不会拖慢 Web UI 启动。绑定成功后桌面端会自动启用插件并重启 DSH。AppSecret 由 Electron safeStorage 结合 Windows 系统凭据保护加密保存，不会发送到渲染页面、写入日志或明文进入 cordis.patch.yml；运行时只通过子进程环境注入。
Codex 模型与推理强度（桌面版 0.1.8）
桌面版内置 dsh-codex-connect 0.1.0-alpha.4.5，可在设置页通过系统浏览器完成 ChatGPT OAuth，并启用 OpenAI Codex 模型。它不会默认替换当前模型、接管全局搜索或启用远程图片工具；检测到已有 Codex Provider 时会保留现有配置，OAuth 凭据只保存在本机 DSH home。
内置 reasoning-slider 0.0.2，在模型选择器中只展示模型实际支持的推理强度，切换模型时会自动回退到有效档位。顶部帮助菜单同时提供 QQ 群二维码、一键加群与 GitHub 建议入口，所有外链均交由系统浏览器打开。
任务看板
在侧边栏点击「任务看板」进入。任务按五列状态组织：待规划、待办、进行中、已完成、已失败。点击卡片上的「执行」，任务将由真实的 DSH 智能体会话执行，完成后状态自动回写；需要复盘时，可直接跳转到执行会话查看完整过程。
任务支持定时执行：在详情中配置 cron 表达式（如每天 23:00 自动升级 DSH、每周一 09:00 生成周报），页面保持打开时会在到点后自动开工。任务台账存于当前 DSH profile 的 Host 文件，浏览器旧数据在校验迁移后继续保留用于降级。
| 多列看板 | 定时执行 |
|---|---|
 |  |
Git 图谱
输入框上方的分支选择器，支持切换分支与查看提交历史；Git 图谱将分支泳道与提交历史可视化，仓库再大也能顺着时间线快速定位变更。
右侧面板
项目会话打开时，聊天区右侧出现「预览」与「文件/变更」两块面板：
- 文件树：浏览工作目录，点击文件即在预览面板打开，整行点击展开文件夹，支持按文件名搜索定位；
- 预览：多标签预览 markdown、HTML、代码、diff、CSV、PDF、Office、图片与文本等格式，支持源码 / 预览切换、分屏编辑与保存；
- 变更（SCM）：真实 git 变更面板，支持 stage / unstage / discard；
- 面板宽度可拖拽调整，双击把手复位默认宽度，折叠状态与宽度按项目持久化；
- 11 款皮肤全部适配右侧面板，换肤后面板随之融入主题。
鲸鱼娘宠物
一只常驻界面的鲸鱼娘宠物，会跟随智能体的状态切换动画：思考、等待、工作、庆祝。点击可互动（摸头），投喂小鱼干可提升亲密度，陪伴度从幼鲸一路成长至「深海羁绊」。支持自定义名称、自由拖动位置，也可随时隐藏。
| 陪伴工作 | 互动面板 |
|---|---|
 |  |
实时令牌统计
在输入框下方实时显示生成速度（TPS）、LLM 耗时、上下文占用、缓存命中率以及输入 / 输出 token 数，每次生成的用量一目了然。
移动端远程
侧边栏底部的手机图标打开配对面板：扫码配对（或复制链接）后，手机进入独立的移动端界面，远程控制当前 dsh web 工作区——查看与新建会话、收发消息、切换模型与思考强度、调整权限预设，全部与桌面端同步。配对令牌一次性且限时，「停止」可随时吊销所有设备；二维码默认走局域网，也可开启 cloudflared 公网隧道，让手机在任意网络配对。
| 工作区列表 | 会话列表与新建会话 |
|---|---|
 |  |
| 聊天（折叠的深度思考与工具调用） | 模型与思考强度选择 |
 |  |
远程连接
侧边栏「SSH」入口打开远程运维面板。主机支持密钥 / 密码认证，可从 ~/.ssh/config 一键导入；配置统一存于 ~/.dsh/dsh-ssh.json。对已配置主机可执行真实操作：
- Web 终端：xterm.js 远程终端，实时输出、随窗口自适应；
- 文件传输：SFTP 上传 / 下载，带进度条与远程目录浏览；
- 端口转发：本地隧道直达远程内网服务（数据库、API、管理后台），仅监听 127.0.0.1；
- 集群执行：一条命令并发跑多台主机，按别名 / 环境 / 标签过滤；
- Agent 直连：Agent 与面板共享同一份主机配置，对话中直接说「连一下 xxx 看看状态」即可由智能体执行远程命令。
设置中心
全部插件的开关与参数统一收纳于「设置 > 插件配置」，修改即时生效。桌面版会明确开放移动端远程控制、皮肤中心、实时令牌估算、任务看板、宠物和粒子主题六张配置卡，不会因 DSH Host 的设置命名空间过滤而缺项。设置窗口本身可拖动、从边缘或角落缩放，并会记住上次位置和尺寸；小窗口与高 DPI 下会自动重排和滚动，避免内容重叠或移出屏幕。
插件市场与扩展坞
桌面 profile 只内置 dshmarket 1.3.0 作为默认插件市场。市场安装目标固定为隔离的 desktop profile，支持社区 DSH bundle 的发现、安装、事务回滚和保留升级；运行时重启由桌面宿主统一管理，避免市场自行启动第二个 DSH 进程。项目技能、DSH 技能与 Agents 技能也可在扩展坞中发现并经过安全检查后导入。
皮肤
皮肤中心提供 11 款可选皮肤（含 Harbor 与 QQ2006），均支持先试穿再应用：试穿即时生效、退出完全还原，确认满意后一键应用。
Windows XP（Luna）
还原 Luna 经典界面：蓝色渐变窗口条、绿色「开始」按钮、Bliss 蓝天桌面，全局直角风格。
Minecraft 方块世界
以《我的世界》主界面为灵感：像素全景天空盒在界面后方缓慢旋转，按钮为灰石板样式，输入框为木告示牌样式。
Blue Fantasy 蓝色幻想
鲸鱼插画铺于半透明面板之下，靛蓝色调色板贯穿全局，暗色主题下效果尤为突出。
鲸吟（Whale Song）
深海鲸语女神主题：无文字纯氛围背景画（蓝发女神与鲸群居左、冰蓝星座网格与金色细线点缀、右侧大量留白）垫在半透明面板之下，冰蓝 / 浅青 / 深海军蓝 / 钴蓝冷色体系贯穿全局，暗色变体为深海夜航调。
· 
初音未来（Miku）
电子歌姬主题以青蓝音符、声波状态栏与半透明舞台面板重塑完整界面，同时保持亮色、暗色模式和功能插件可读性。
交易终端（Trading Terminal）
带实时行情的炒股皮肤：顶栏滚动跑马灯（A股 / 港股 / 美股 / 指数 / 加密 / 外汇，红涨绿跌），标题栏行情快签，状态栏展示 A股 / 港股 / 美股交易时段与港美股指数。已安装 dsh-fun-ticker 时跑马灯跟随你的自选列表（同源代理取数），已安装 dsh-longbridge 时指数格渲染长桥券商快照；两个插件都没装也能直接走公共行情源（腾讯 / 币安 / Frankfurter）独立工作，所有路径失败都安全降级为 --。
· 
其余三款：QQ2008 怀旧版（水晶蓝配色与企鹅元素）、同花顺风格（行情元素融入界面）、龙的传人（朱砂龙印主题）。
下载、校验与升级
- 从 GitHub Releases 下载最新的 Windows x64 安装包。
- 运行
DeepSeek-Harness-Desktop-Setup-<版本号>-x64.exe完成安装；DSH、插件、皮肤、pnpm 和原生依赖均已随安装包提供。 - 如需核验文件完整性，请下载同一 Release 中的
SHA256SUMS.txt并比对安装包 SHA-256。
GitHub Releases 是应用内置且默认使用的唯一下载源。如果 GitHub 下载速度较慢，可点击更新窗口的「加入用户群」，通过 QQ 群 1105158177 获取同步提供的最新安装包；应用不会默认启用或宣传第三方镜像为“更快”线路。
应用会检查稳定版 GitHub Release，展示中英双语更新说明，并提供「前往 GitHub 下载」「加入用户群」「稍后更新」。安装仍需明确确认，覆盖升级不会删除既有 DSH_HOME、桌面 profile、社区 bundle、桌宠状态、皮肤配置或已加密的 QQ Bot 凭据。
当前安装包没有商业代码签名，Windows SmartScreen 可能显示“未知发布者”。请只使用本项目 Release 页面提供的安装包；推荐采用默认安装路径，避免过长路径触发传统 Win32 限制。
来源与版权
| 包 | 来源 | 版权 |
|---|---|---|
| dsh-task-board / dsh-git-graph / dsh-aionui-panel / dsh-pet / dsh-particle-theme / dsh-remote-web-ui / dsh-live-stats / dsh-web-ui-settings / dsh-skins / dsh-web-ui-all / skins | 作者 zhu1090093659 个人开发 | BSD-3-Clause（zhu1090093659） |
迁入第三方代码必须保留 LICENSE 与署名；活跃且有上游的第三方优先 fork 或依赖引用，不搬代码。
友情链接
- 本项目积极参与并认可 LINUX DO 社区。
收录徽章
[](https://deepseek-plugin.org/plugins/ningbainb/deepseek-harness-desktop/packages/dsh-aionui-panel)把这段 markdown 粘贴到你的 GitHub README，链接回本插件详情页。徽章只声明已被本站收录，不代表安全认证。