mirror of https://gh-proxy.org/https://github.com/klinsmaya/workdsh.git synced 2026-11-09 18:07:02 +08:00

Files

T

t4we fan 3cfb09fcbc docs: separate user-facing and developer documentation paths

Users following the install/use path could previously land in developer
and maintainer content: the root README documentation table mixed both
audiences, the plugin-ecosystem section named desktopProfiles/desktopPnpm
inline, the user guide ended by pointing at the package README, and
why-desktop carried contract details.

Split the root README and docs index into user vs developer tables, add a
user-level plugin intro to the user guide, remove the developer-jargon
patch wording, and soften why-desktop's developer-contract detail. The
plugin-ecosystem narrative and differentiation copy stay for a follow-up
pass.

2026-08-16 19:10:51 +08:00

3.6 KiB

Raw Blame History

为什么做 DSH Desktop

我们解决什么问题

DeepSeek Harness 的核心是一个可组合的 agent harness。它适合通过命令行和 Web UI 使用，也适合开发者把模型、工具、会话和工作流组合成自己的运行时。但对很多用户来说，第一次运行仍然要面对 Node.js、profile、依赖安装、端口和进程生命周期。

DSH Desktop 的目标不是重新实现 Harness，而是把同一个运行时放进一个容易启动、容易管理、符合操作系统习惯的应用里：

安装包负责提供 Electron、Node 运行时和固定版本的 DSH 依赖。
应用负责窗口、托盘、单实例、退出和本地服务生命周期。
用户仍然使用官方 DSH 的 profile、插件、会话和 Web UI。
上游 Harness 继续拥有 agent、模型、工具、会话和 Web 客户端的核心语义。

因此 Desktop 是一个产品入口和运行时适配层，不是上游项目的替代品，也不是把上游源码复制一份再长期分叉。

为什么坚持插件化

“一切皆插件”让 Harness 的能力可以被组合，而不是被一个固定应用绑死。Desktop 采用同一原则有三个直接好处：

上游能力保持可替换。 Desktop 可以使用官方 Web client，用户的 profile 也可以加入模型、工具、界面和工作流插件。
桌面能力保持可扩展。 profile 管理和打包环境提供的能力可以通过明确的 Host service 给插件使用，而不是让每个插件猜 Electron 的内部对象。
边界更容易维护。 上游 DSH 负责 agent 语义，Desktop 负责原生窗口和系统集成，第三方插件只依赖自己真正需要的 contract。

插件化也意味着不是所有东西都应该暴露。第三方插件只能使用明确公开的接口，不能直接控制窗口、托盘、安装器等内部实现；稳定的边界比“什么都能访问”更容易升级和排错。公开接口的细节见插件开发。

Desktop 自己提供什么

当前 Desktop 主要提供：

macOS 和 Windows 原生窗口、托盘和单实例生命周期。
兼容模式和高级模式。兼容模式保留上游默认客户端；高级模式提供 Desktop 自有的布局、窗口材质和原生拖动区域。
多 profile 选择。当前 generation 的 profile 身份由 Desktop 明确提供，切换通过有序重启生效。
内置终端和固定版本 pnpm 环境。它们只作用于 Desktop 自己创建的进程，不修改用户的全局 PATH。
面向插件开发者的一组受控扩展接口（详见插件开发）。
版本检查、用户确认后的安装包下载，以及 macOS DMG/Windows NSIS 的平台交接。

我们刻意不做什么

不把上游 Web UI 重新实现成 Electron 原生页面。
不在兼容模式中覆盖上游 layout、sidebar 或 conversation 组合。
不把记录复制到另一个“Desktop 数据库”；官方 profile 默认共享 DSH home 中的会话和设置。
不给第三方插件一个未定义的 Electron 私有 API。
不把 roadmap（插件市场、手机远程、Channels）写成当前版本已经交付的功能。

适合谁

只想安装后直接使用 Harness 的用户：从用户指南开始。
想安装或开发 DSH 插件的用户：先读插件开发，再看 Desktop service contract。
想理解启动、profile 和打包边界的维护者：阅读架构说明和包级 README。

3.6 KiB Raw Blame History