zhu1090093659/dsh-web

中文 | English

dsh-web 是面向 DeepSeek Harness（DSH）Web GUI 与官方桌面客户端的模块化插件生态与 AI 智能体开发工作台。它为深度用户与开发者提供任务自动化看板（Cron 定时调度）、手机与跨设备远程控制、SSH 远程终端与集群运维、Git 提交历史图谱与多 Agent Worktree 隔离、全量会话归档管理、Token 用量与成本统计，以及一站式主题皮肤与桌面宠物工坊。用户既可以通过官方 profile 机制将插件全家桶一键挂载至已有的 dsh web 实例，也可以直接在官方 DeepSeek Harness 桌面客户端中开箱即用。

DeepSeek Harness（DSH）Web 插件生态 · 模块化智能体工作台
创意工坊 · 任务看板 · 移动端远程 · SSH 运维 · Git 图谱 · 使用统计 · 会话归档

原生 DeepSeek Harness Web 提供了核心的对话交互与工具调用能力，但在多任务并发调度、长程后台执行、移动端协同以及工程化开发运维方面仍有扩展空间。

dsh-web 通过官方 profile 机制挂载到 dsh web，零修改侵入官方源码，为用户提供完整的模块化扩展体系：

• 工程运维与协同插件：涵盖长程定时任务看板、移动端与跨设备远程控制、SSH 终端传输、Git 图谱与 worktree 隔离、全量会话归档管理以及模型能力声明编辑器；
• 视觉主题与资产解耦：功能插件与样式资产完全分离。皮肤插件负责底层渲染，多样化的主题皮肤（含样式、贴图与动态特效）以及桌面宠物可通过 DSH 创意工坊自由安装；
• 全家桶聚合与按需组合：既支持通过 @linxin666/dsh-web-all 聚合包一键安装完整功能，也支持按需单独安装特定插件。聚合包预集成家族全部功能插件，详见插件全家桶使用指南。

对于希望直接使用独立桌面应用的用户，推荐下载并使用官方发布的 DeepSeek Harness 桌面客户端（DeepSeek Harness Desktop）。

官方桌面客户端与 dsh web 共用 ~/.dsh 数据目录，其 profile 为 desktop。由于官方桌面客户端对 desktop profile 实行应用内专管（外部 CLI 会限制对 desktop profile 的修改），安装本插件全家桶时请直接在桌面客户端内进行：

1. 打开官方桌面客户端，进入“设置”中的“插件”页面（或左侧导航栏的插件入口）；
2. 在插件管理界面的安装输入框中，输入插件全家桶包名 @linxin666/dsh-web-all（或 @linxin666/dsh-web-all@latest），点击安装；
3. 安装完成后重启客户端，即可在客户端中使用任务看板、主题皮肤、远程控制等全套插件能力。

创意工坊 是 DSH 生态的一站式资产分发平台，统一提供主题皮肤、桌面宠物、功能插件与社区 Agent 预设。所有项目按照真实设备点赞热度排序，皮肤支持即时试穿预览，插件提供一键安装命令。经典的 Blue Fantasy 蓝色幻想随皮肤插件内置，其余主题皮肤与宠物资产均可在工坊浏览、查看源代码并按需安装。在 Web GUI 的“创意工坊”设置卡中可直接浏览线上清单，皮肤与宠物可一键下载至 DSH 主目录并在对应设置页选用；社区预设下载至本地预设库，启用后即可在“设置 → Agent 预设”中用于新建会话。

创意工坊站点为本仓库的组成部分：前端为纯静态构建，由构建脚本 scripts/market-build 依据 skin.json、pet.json 与 community.json 等数据源自动生成；点赞等动态能力由 Cloudflare Workers 边缘函数与 D1 数据库提供支持（遵循单设备单票限制），代码合入 main 分支后自动触发持续集成部署。

创意工坊旨在建立开放透明的社区生态，方便开发者分享作品并让用户自由选择所需扩展。

通过侧边栏“任务看板”进入。任务看板按待规划、待办、进行中、已完成、已失败五列呈现。点击卡片上的“执行”即可调用真实 DSH 智能体会话运行任务，执行完成后状态自动回写看板；点击卡片可随时跳转至对应会话回溯完整交互轨迹。

任务支持后端定时调度：在任务详情中配置 cron 表达式（例如每日 23:00 自动检查升级 DSH、每周一 09:00 生成周报），关闭浏览器后宿主进程仍会按计划触发执行并保存结果。任务看板提供可选的防休眠电源管理设置，支持 Windows、macOS 与带有 systemd-logind 的 Linux 系统，允许显示器息屏的同时防止整机因闲置进入睡眠状态（该设置默认处于关闭状态）。

任务默认可选「任务验收」：以 goal 形式执行的任务在 agent 标记完成前，必须由看板调用裁判模型验收（默认继承宿主模型，也可在「设置 → Web 插件 → 任务看板 → 任务验收」中自选模型与思考档位）。验收沿用三项 coding 判据、0.65 阈值与每项两轮交换 A/B 位置，同一执行最多两次：第一次不通过会把分数与问题反馈给 agent 修复，第二次仍不通过即判该执行失败。验收配置在每次执行启动时固定，之后的设置变更只影响新执行；普通聊天与显式关闭 goal 模式的任务不受影响。每次验收都会真实消耗裁判模型的额度。

任务支持会话复用模式：开启后若前一轮执行生成的会话仍存活且处于空闲状态，宿主将复用该会话继续运行后续任务（重新应用该任务指定的权限与模型，保留上下文历史）；若会话已关闭则自动新建会话，保证定时调度持续运转。

多列看板	定时执行

通过侧边栏底部的手机图标打开设备配对面板。使用手机扫码或复制链接配对后，手机浏览器将直接载入官方 Web GUI，并自动激活移动端触控交互层：轻触鲸鱼图标唤出侧边栏、支持手势左滑收起与右滑展开、长按会话项目呼出操作菜单、软键盘 Enter 键仅用于换行、输入框采用 16px 字体防止页面聚焦缩放。适合桌面屏幕的扩展面板（如 SSH 终端、任务看板、Git 图谱等）在手机端自动隐藏，聚焦于会话管理、模型切换、思考强度调整与消息收发，多端实时共享完整上下文状态。

同一配对通道同样支持另一台 PC 浏览器接入：在远程电脑访问配对链接即可运行完整的桌面版 Web GUI。所有远程通信均受配对门控保护（走 /remote/api 路径），未经验证的访问将被拦截并仅显示提示横幅。配对令牌具备单次使用与超时失效机制，点击“停止”可立即吊销所有已连接设备。二维码默认基于局域网通信，搭配 cloudflared 等隧道工具可实现安全的公网跨网络访问。为确保安全性，使用隧道时建议走配对通道，不建议为隧道域名配置 --trusted-host 参数，避免绕过设备验证门控（详见远程控制插件说明）。

实时消息与隧道：移动端的流式输出走官方 WebSocket 通道（配对后经门控的 /remote 代理转发），Cloudflare 快速隧道、命名隧道与 dsh-market 固定域名中继都能转发该连接。远程访问把广域网往返延迟叠加到每次更新上，固定域名中继比裸隧道多一跳；对延迟敏感时可在设置卡片关闭该中继。

移动端主页（鲸鱼入口）	会话列表
聊天（思考与工具调用）	模型选择（底部弹层）

通过侧边栏“SSH”入口打开远程运维面板。支持密钥与密码认证，可一键导入本地 ~/.ssh/config 主机列表；配置数据安全保存在 ~/.dsh/dsh-ssh.json 中。面板提供以下操作能力：

• Web 终端：基于 xterm.js 的完整远程交互终端，支持实时输出与窗口自适应；
• 文件传输：集成 SFTP 上传与下载功能，提供进度提示并支持可视化浏览远程目录；
• 端口转发：支持建立本地到远程内部服务的加密隧道（如内网数据库、后端 API），默认仅监听 127.0.0.1 安全地址；
• 集群并发执行：支持多主机批量命令执行，并可通过别名、运行环境或标签进行过滤；
• Agent 直连调用：智能体与面板共享主机配置，在会话中发出指令即可委派 Agent 执行远程巡检与运维命令。

在“设置 > 使用统计”中集中查看 token 消耗数据、供应商余额以及编程套餐额度，支持自动定时刷新与手动即时查询。

• 用量明细：查看每日输入、输出与缓存用量，按不同供应商与模型细分展示，并提供最近 30 天消费趋势；支持的供应商提供账户余额查询，针对 DeepSeek 官方路由还提供峰谷分时计费与账单估算。
• 个人套餐追踪：实时展示 Kimi、GLM、MiniMax、OpenCode Go、Codex / ChatGPT 等平台编程套餐的使用比例与重置周期。
• Token 银行：DeepSeek 官方通道每消耗 1 token 自动积累 1 鲸元，以“鲸元券”形式展示台账周期内的累计调用指标，支持保存票券卡片与系统级分享。
• 桌面宠物联动：安装宠物插件后，可通过桌面悬浮挂件的气泡提示直接查看当前会话供应商的额度、余额或今日消耗。

统计自插件首次启用起计，不回填历史数据；鲸元券仅统计台账窗口内的 DeepSeek 官方消耗。支持的供应商列表与配置细节见 dsh-usage README。

自定义供应商的模型特性配置直接集成于“设置 > 模型”页面。针对官方界面未开放编辑的模型能力字段，本插件提供了可视化的配置编辑器：

• 图片输入能力声明：在自定义供应商卡片内展开“模型能力”面板，可逐个模型明确声明是否支持图片输入（["text","image"] 或 ["text"]），界面直观展示生效状态；
• 推理与思考档位配置：支持声明为非推理模型（界面将隐藏思考强度滑块）、继承全局配置，或为模型定制具体的推理强度档位及底层请求参数；
• 即时生效与冲突保护：配置复用官方存储通道，未编辑的字段保持原样，修改保存后即刻生效且无需重启服务；每次写入附带配置版本校验，避免多端并发修改引发覆盖；
• 供应商一键停用与启用：支持临时禁用某供应商路由并自动归档配置，模型选择器将即时下线该供应商，保存的 API 密钥与凭据全程不受影响，后续可随时一键恢复。

技术提示：该配置属于客户端向网关发送的协议声明，系统不执行自动化远端探测。若模型声明支持图片但供应商网关接口不支持多模态，请求阶段仍会由网关返回错误。详见 dsh-model-capabilities README。

在对话输入框上方集成 Git 操作栏与可视化提交历史图谱：

• 分支与提交图谱：直观展示分支分叉与合并泳道，便于在大中型项目中快速追溯代码演进与切换分支。
• Git Worktree 隔离会话：多 Agent 并发处理任务时，直接在主分支修改容易导致文件冲突与分支污染。插件支持在 $DSH_HOME/worktrees/ 目录下为新会话建立完全独立的 worktree 检出与隔离分支（命名形如 wt/<名称>），主检出文件保持干净；通过“管理 worktree”面板可集中查看与清理临时检出。
• 自动化策略与 Agent 集成：提供“自动隔离”选项，为进入 Git 仓库的新会话自动分配专属 worktree；同时向智能体暴露 git_worktree 工具，允许 Agent 自主创建与管理隔离开发环境。

Git 图谱	Git worktree 并行会话

会话归档管理（dsh-session-archive）是专为解决大量长短期会话堆积而设计的集中管理模块，随全家桶安装生效：

• 集中检索与状态筛选：统一呈现活跃会话、已归档会话、空白会话、子代理派生会话以及无工作区会话，支持按标题、工作区、状态及会话 ID 进行关键词搜索与多维排序；
• 安全批量操作：支持跨筛选结果的多选批量归档、批量恢复以及级联物理删除。执行物理删除时系统将明确提示受影响的后代会话数与预计释放空间，大批量删除需二次确认；当前处于运行中或带有运行中子代理的会话受到严格保护，防止误删；
• 自动化生命周期策略：提供两个默认关闭的自动化策略：根据最后活跃时间自动归档、根据归档时间自动清理超期数据，支持在启用前进行结果预览与单次手动执行。

删除操作不可逆，所有管理路由严格限制本机回环访问。详细机制见 dsh-session-archive README。

• Skill 中心（dsh-client-ui-skill-explorer）：按来源集中查看与管理已加载的 agent skills，支持按名称与功能描述实时搜索过滤，多工作区独立呈现，支持一键启停与删除。
• 插件管理器（dsh-client-ui-plugin-manager）：基于官方 host 接口从 npm 或 git 仓库直接安装插件，可视化管理插件运行状态与自定义配置。

经典的 Blue Fantasy 蓝色幻想是随皮肤插件内置的默认主题：深邃的靛蓝色调贯穿全局，搭配半透明毛玻璃面板与定制鲸鱼插画，在暗色模式下具有优秀的视觉沉浸感。其他精美皮肤与 Wallpaper Engine 动态壁纸由皮肤插件统一管理，可直接在创意工坊在线预览、试穿与一键安装。

• 已安装 DeepSeek Harness 且 dsh web 可正常启动。
• npm 安装方式无需额外环境；若从源码仓库构建，需要 Node.js >= 22 与 pnpm 环境。

• DSH Web CLI（现有浏览器服务）：
  1. 安装聚合包：dsh plugin --profile web add @linxin666/dsh-web-all@latest
  2. 重启 dsh web 服务，侧边栏将自动呈现各插件入口
  3. 打开“设置 > 插件配置”按需开关插件，或在皮肤面板选用主题
• 官方桌面客户端（DeepSeek Harness Desktop）：
  1. 打开官方桌面客户端，进入“设置 → 插件”页面
  2. 在插件安装框中输入 @linxin666/dsh-web-all 并确认安装
  3. 重启客户端，即可在侧边栏与“设置”中使用各插件功能

若仅需要皮肤功能，可单独安装 @linxin666/dsh-client-ui-skin-center。若因包管理器门禁安装到旧版本，请参阅后文“安装排障”。

仓库根目录声明了标准 dsh.bundle 装配清单，支持直接通过仓库地址安装，无需手动克隆代码与构建：

dsh plugin --profile web add github:zhu1090093659/dsh-web
# 或使用完整 git 地址：dsh plugin --profile web add git+https://github.com/zhu1090093659/dsh-web.git

该方式与直接从 npm 安装聚合包效果等价，二者择其一即可。请勿同时通过两种方式安装，以免出现 entry id 冲突。

如需二次开发或调试插件，可按以下步骤从源码构建（要求 Node.js >= 22 与 pnpm）：

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

# 2. 安装项目依赖并构建全包
pnpm install
pnpm -r build

# 3. 将本地包软链挂载至 web profile（建议先链接所有子包再注册聚合包）
node scripts/link-profile.mjs
dsh plugin --profile web add link:$(pwd)/packages/dsh-web-all

# 4. 重新启动 dsh web 服务
dsh web

提示：profile 目录未配置为 pnpm workspace，聚合包内部的 workspace:* 依赖在解析时会尝试回退拉取 npm 线上版本。若线上包存在版本差异，请先运行 node scripts/link-profile.mjs 确保全部子包均指向本地构建产物。

如果不需要安装全家桶，可根据实际需求单独安装各个功能模块：

dsh plugin --profile web add @linxin666/dsh-client-ui-task-board@latest              # 任务看板
dsh plugin --profile web add @linxin666/dsh-client-ui-task-board-github@latest      # 任务看板 GitHub Issues 同步扩展
dsh plugin --profile web add @linxin666/dsh-ssh@latest                             # 远程连接（SSH）
dsh plugin --profile web add @linxin666/dsh-usage@latest                           # 使用统计
dsh plugin --profile web add @linxin666/dsh-client-ui-model-capabilities@latest    # 模型能力声明
dsh plugin --profile web add @linxin666/dsh-pet@latest                             # 桌面悬浮宠物
dsh plugin --profile web add @linxin666/dsh-session-archive@latest                 # 会话归档管理

安装后重启 dsh web 服务，侧边栏出现对应功能图标即代表加载成功；亦可通过执行 dsh --profile web --dump-config 检查配置层挂载状态。若侧边栏未刷新出入口，请确认服务进程已彻底重启。

卸载聚合包：dsh plugin --profile web remove @linxin666/dsh-web-all，完成后重启 dsh web 即可恢复纯净状态。

技术实现细节与挂载原理解析见 docs/plugins.md。

dsh-web 针对主流操作系统、现代化浏览器及网络拓扑进行了深度工程调优与兼容性保障：

• 任务看板由后端 Host 进程统一调度，关闭前端标签页不影响任务执行；但若宿主进程停止或操作系统关机睡眠，处于离线期间的触发点将直接跳过不补跑。可选的电源保护仅阻止系统闲置睡眠，无法阻止用户主动合盖、手动休眠或电源切断，技术细节见 dsh-task-board README。
• SSH 凭据（密码与私钥口令）保存在本地 ~/.dsh/dsh-ssh.json 文件中（文件权限为 0600）；在网络中断重连时可能重新发送非幂等命令，终端输出保持原样返回不执行脱敏，安全规范见 dsh-ssh README。
• 移动端流式输出经隧道或固定域名中继转发，广域网往返延迟叠加在每次更新上；固定域名中继比裸快速隧道多一跳，两者都可用。
• 从源码构建全仓需要 Node.js >= 22 与 pnpm 工具链，直接从 npm 安装不受此限制。

欢迎加入社区交流群，与开发者及其他用户探讨使用技巧、反馈使用问题或提出新功能建议。

扫描下方二维码加入“DSH Web 交流群”：

也可以通过 Discord 社区 进行交流，或前往 GitHub Issues 提交缺陷报告与功能需求。

DeepSeek · DeepSeek Harness · DSH · DeepSeek Web · DeepSeek 网页版 · DeepSeek 桌面客户端 · DeepSeek 插件 · DeepSeek 任务看板 · DeepSeek 定时任务 · DeepSeek 自动化 · DeepSeek 手机版 · DeepSeek 远程控制 · DeepSeek 移动端 · DeepSeek SSH 终端 · DeepSeek 服务器运维 · DeepSeek Token 统计 · DeepSeek 余额查询 · DeepSeek API 费用 · DeepSeek 主题 · DeepSeek 皮肤 · DeepSeek 动态壁纸 · DeepSeek 桌面宠物 · DeepSeek Git 图谱 · DeepSeek Worktree 隔离 · DeepSeek 会话归档 · AI Agent 工作台 · AI 编程助手

• LINUX DO —— 有理想的新社区。
• dshfind —— 面向 DeepSeek Harness 的学习与分享社区，聚合论文精读、插件超市与用户排名。

欢迎各类技术交流、生态集成、定制开发与商业合作。如有合作意向，欢迎通过邮件联系我们：chunlinzhu666@gmail.com。

• 提交代码前请查阅 CONTRIBUTING.md；涉及用户界面的修改请附带测试用例或验证截图；
• 提交信息严格遵循 Conventional Commits 规范（例如 fix(task-board): 修复状态同步问题），代码、文档与 commit 信息全程杜绝使用 emoji；
• 新建插件请使用标准脚手架生成：node scripts/dsh-plugin-new <name>；新建皮肤请在 dsh-skins 仓用 node scripts/dsh-skin-new.cjs <id> 生成；
• 提交前请确保通过本地质量门禁：pnpm typecheck && pnpm test && pnpm docs:check；完整开发流程见 docs/development.md。

本仓库采用 Apache-2.0 许可证授权。引入第三方代码必须严格保留原始 LICENSE 与作者署名；具有活跃上游的第三方项目优先以 npm 依赖或 fork 方式引入，避免直接复制代码。

_{查看全部贡献者}