zhu1090093659/dsh-web

DeepSeek Harness（DSH）Web 插件聚合生态包 · 一切皆插件，创意工坊分发

什么是 dsh‑web？

dsh‑web 是 DeepSeek Harness (DSH) Web 的 插件生态系统，这是一个基于浏览器的 UI，可让您与 DeepSeek 的 AI 代理进行交互。该仓库提供一个 “一站式”包（@linxin666/dsh-web-all），捆绑了数十个可选的 UI 扩展功能——任务看板、移动端远程控制、SSH 控制台、图像理解工具、Git 可视化、皮肤、宠物和市场——并使其即插即用，无需修改核心 DSH 代码。

核心理念

理念	如何实现
一切皆为插件	每个功能都以独立的 npm 包形式存在于 `@linxin666/dsh‑*` 命名空间下。聚合包仅列出所有插件，您只需安装一个依赖项即可获得完整的开发工作站。
可插拔皮肤	视觉主题也是插件。皮肤包包含 `skin.json` 清单、CSS、图片和可选的特效脚本。UI 在运行时加载皮肤，与核心代码完全解耦，因此无需发布即可添加新外观。
市场（dsh‑market.com）	由相同的皮肤/宠物/插件清单生成的静态网站。用户可以浏览、预览并一键安装社区制作的资源。
远程-移动端配对	扫描二维码（或复制链接）即可与手机或其他浏览器配对。配对设备将看到相同的 DSH 工作区，可发送消息、切换模型、运行命令。通信使用 SSE；当 SSE 不支持时，插件会回退到轮询。
SSH 与文件传输	内置 xterm.js 终端、SFTP 上传/下载、端口转发和多主机批量执行功能，均以 UI 面板形式提供。
图像理解	在聊天输入框中添加按钮；选中的图像通过 `describe_image` 工具发送至可配置的 OpenAI 兼容视觉端点（如 GPT‑4o、Qwen‑VL、Ollama），仅生成的文本会保存在对话中。

主要插件（包含在“一站式”捆绑包中）

插件	功能
`dsh-client-ui-task-board`	五列的看板，支持 DSH 代理的实时执行和 cron 风格调度。
`dsh-remote-web-ui`	用于移动端或辅助浏览器的二维码配对；实时同步会话、模型和权限。
`dsh-ssh`	包含终端、SFTP、仅限本地端口转发和集群命令执行的 SSH 面板。
`dsh-tool-describe-image`	视觉工具（`describe_image`），将图像转发至可配置的视觉模型并返回文本描述。
`dsh-client-ui-git-graph`	分支选择器和可视化提交历史图。
`dsh-client-ui-skin-center`	所有皮肤资源的加载器；皮肤按需从市场获取。
`dsh-client-ui-market`	打开 DSH Web 内部市场的 UI 卡片。
`dsh-client-ui-plugin-manager`	直接在 UI 中安装/启用/禁用其他 `@linxin666/*` 插件。
`dsh-better-sidebar`（外部）	右侧侧边栏，可托管文件浏览器、编辑器、终端、Git 视图和浏览器。
…以及许多可选工具，如技能探索器、聊天恢复、桌面启动器和“医生”救援模式。

快速入门

前提条件 – DeepSeek Harness 已安装且 dsh web 可运行。仅构建源码需要 Node ≥ 22 和 pnpm。

安装捆绑包

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

重启 dsh web。左侧侧边栏将出现新条目。
通过 设置 → 插件配置 启用/禁用插件或尝试皮肤。

若希望本地开发，请克隆仓库，运行 pnpm install && pnpm -r build，然后使用 node scripts/link-profile.mjs 链接已构建的包，再重启 UI。

适合谁使用？

希望拥有更丰富 UI 来构建、测试和监控 DSH 代理的 AI 代理开发者。
需要远程 SSH 访问、定时任务或可视化 Git 历史记录但又不想离开浏览器的 高级用户。
希望将皮肤、宠物或插件发布到 DSH 市场的 社区创作者。

限制与注意事项

定时任务在 DSH 主机进程中运行；浏览器关闭后仍存活，但若主机停止或机器休眠则会被跳过。
SSH 凭据以明文存储（~/.dsh/dsh-ssh.json，权限 0600）。
实时移动端更新依赖 Server-Sent Events；部分隧道服务（如 Cloudflare Quick Tunnel、Tailscale）会降级为轮询，导致几秒延迟。
从源码构建需要 Node ≥ 22 和 pnpm；普通用户可直接安装预发布 npm 包。

社区与贡献

通过 README 中的二维码加入 QQ 群，或加入 Discord 服务器获取帮助和讨论。
贡献遵循标准的 CONTRIBUTING.md 流程，使用 Conventional Commits，PR 合并前必须通过 pnpm typecheck && pnpm test && pnpm docs:check。
新插件或皮肤可通过 node scripts/dsh-plugin-new <name> 或 node scripts/dsh-skin-new 生成模板。

简而言之：dsh‑web 是一个模块化、社区驱动的扩展层，将 DeepSeek Harness Web UI 转变为一个功能齐全的开发工作站，支持插件式任务看板、远程移动端控制、SSH、视觉工具、皮肤和社区贡献市场。