pawaca/dsh-edge

dsh-edge——你的 DeepSeek Harness，随处可用。一条命令部署到 Cloudflare。

npm
CI
License: MIT

dsh-edge 把已发布的 DeepSeek Harness Web 体验运行在 Cloudflare Workers 上，让你的个人 coding agent 在任何有浏览器的地方都能使用。无需维护服务器、绑定 GitHub 仓库或配置构建流水线。

它保留上游 UI、agent loop、模型选择和 Web Search，同时新增 goal 跟踪、文件操作、上下文压缩、运行时可配置设置和持久多工作区管理——全部运行在 Cloudflare Workers 上。

独立社区项目： dsh-edge 由 pawaca 维护，与 DeepSeek 没有关联，也未获得其背书。DeepSeek Harness 是上游项目。

一条命令开始

你需要 Node.js 22.14 或更高版本，以及自己的 DeepSeek API key：

npx dsh-edge install

安装器会引导你完成所有选择并部署 Worker。你可以在没有现成 Cloudflare 登录的情况下先试用，也可以永久安装到自己的 Cloudflare 账户；不需要 checkout 源码。

安装 dsh-edge、解锁部署、选择 Vision Exp 并识别图片

你会得到什么

- Agent 能力 — GoalBar UI 的 goal 跟踪、文件工具（read、write、edit、read_image）、长对话自动上下文压缩、自动生成 session 标题。
- 工作区 — 多持久工作区，支持创建、重命名、归档和排序；基于 Durable Object SQLite 的 /workspace 文件系统；可配置超时的 bash 工具。
- 模型 — 通过上游选择器使用 DeepSeek V4 Flash、V4 Pro 和 Vision Exp；运行时可配置设置（模型、API key、推理强度），无需重新部署；Web Search 与 PNG/JPEG 图片输入。
- 对话 — session fork 分支对话、queue/steer 消息编辑、任意浏览器的持久历史记录。
- 部署 — 属于你自己的 Cloudflare Worker、凭据和数据；无需绑定仓库或构建流水线即可原地升级。

选择部署方式

| 路径 | 需要什么 | 适合场景 |
| --- | --- | --- |
| 立即试用 | 不要求已有 Cloudflare 登录；需要在 60 分钟内认领才能长期保留 | 以最低门槛体验完整产品 |
| 长期使用 | 已有或新建的 Cloudflare 账户，并启用 R2 | 长期运行的个人部署 |

默认的 Free — Direct Shell runtime 可在 Cloudflare Workers Free 上运行。可选的 Isolated — Dynamic Worker 会在独立 Worker 中执行命令，需要 Workers Paid。两种模式使用相同的产品 UI、对话、工作区、图片和工具；Direct Shell 是沙箱化 shell runtime，不是 Linux 容器。

升级

npx dsh-edge upgrade

安装器会找到已有 Worker 并原地升级，同时保留持久数据。特定版本的注意事项见 release notes。

重要边界

- dsh-edge 面向单一 owner，不提供注册、多用户、角色或租户路由。
- DeepSeek key 在部署时以 Worker secret 保存，或通过运行时设置 UI 配置时存入 Durable Object storage。部署的持久数据留在你的 Cloudflare 账户内。
- 部分上游能力（子进程、PTY）需要 Cloudflare Containers，尚未适配。MCP 的 Streamable HTTP 传输在免费 plan 上可行但尚未安装。Vision Exp 是实验模型，是否可用取决于 DeepSeek 账户。详细状态见兼容矩阵和 wiki。

基于 DeepSeek Harness

dsh-edge 依赖精确发布的 DeepSeek Harness package，而不是复制其 monorepo。上游继续负责 Web UI、插件组合、agent loop 与会话协议；本仓库只实现让它们运行在 Edge 所需的 Cloudflare runtime 与 storage adapter。

上游架构与插件 API 请参阅 DeepSeek Harness 仓库和参考文档。

文档

- 架构与子系统 wiki
- Runtime reference、兼容性、安全与限制
- Release notes
- DeepSeek Harness 上游文档

本地开发

只有开发 dsh-edge 时才需要源码 checkout。仓库工具链要求 Node.js ^22.19.0 或 >=24.0.0：

git clone https://github.com/pawaca/dsh-edge.git
cd dsh-edge
pnpm install
pnpm --dir apps/dsh-edge/standalone install --frozen-lockfile
pnpm run check

如何在本机启动 Worker，请查看本地 Edge 设置。

贡献与支持

- 请在 Issues 中报告 dsh-edge bug 和安装问题。
- 漏洞请通过私密安全流程报告，不要使用公开 Issue。
- 修改仓库前请阅读 CONTRIBUTING.zh.md 与 AGENTS.md。

许可证

MIT。第三方组件及其许可证列在 THIRD_PARTY_NOTICES.md 中。