DeepSeek Harness Cloud
面向团队的 DeepSeek Harness 工作空间管理平台。
通过浏览器创建和使用工作空间,统一管理模型接入、计算资源与持久数据,并在个人工作台维护技能、记忆、知识库和 MCP 连接器。
功能特性 · 界面预览 · 快速开始 · 架构 · 文档 · 参与贡献
当前版本 V0.2 面向单组织、可信内部团队,采用 Docker 单机部署。已验证范围与待完成事项见测试验收。
功能特性
| 能力 | 说明 |
|---|---|
| 工作空间生命周期 | 按需选择 CPU、内存、存储与模型提供商,支持创建、进入、启停和删除工作空间。 |
| 统一模型接入 | 管理个人提供商账号、密钥、可用模型与默认模型,通过 Go 模型网关接入官方或兼容服务。 |
| 持久工作数据 | 保留工作目录与 DSH 数据,浏览 /data/workspace 和 /data/dsh,支持文件、Office / PDF 预览及下载。 |
| 个人技能库 | 搜索主流技能来源,编辑、导入导出 Markdown / ZIP,并通过公开链接同步技能包。 |
| 记忆与知识库 | 在工作台维护、迁移和检索个人内容,外接 OpenViking / Mem0 / Graphiti 与 Milvus / Weaviate / Qdrant。 |
| MCP 连接器 | 内置分类目录,支持自定义 MCP、OAuth 授权、工具选择及手动调用,覆盖 GitHub、Context7 等开发工具。 |
| 原生扩展 | 启停内置插件、安装第三方 DSH 组合包、保存 Agent 预设。 |
| 插件库 | 浏览默认及个人插件目录,在线/离线添加、编辑个人资料并下载原包;提供本项目维护的 Mem0 / Graphiti 记忆插件。 |
| 团队管理 | 内置登录与账号管理、角色权限、实例 / CPU / 内存 / 存储额度和操作日志。 |
停止工作空间会释放计算资源;停止或软删除后仍保留数据并计入存储额度,可在“工作数据”中永久释放已删除工作空间的数据。详见存储数据管理。
工作台管理与创建时的扩展选择分别操作;创建可选技能、连接器、记忆、知识库及兼容插件,运行接入按当前权限验证。连接器需完成相应服务配置或授权,实网验证结果见连接器实网验证边界。
创建工作空间时选择 Mem0 或 Graphiti 记忆连接并开启“完整会话同步”,平台会安装并启用对应原生插件。两者先保存原始会话,归档后提取长期记忆用于管理和召回;已有工作空间的 Profile 不自动升级。Mem0 另支持独立安装,独立模式默认关闭自动采集,与平台连接分别配置。详见插件分发总览、Mem0、Graphiti及插件库规则。
技能来源
在工作台的“技能”页面点击“导入”,可搜索以下公开来源,查看技能文件后确认导入:
| 来源 | 导入方式 |
|---|---|
| skills.sh | 搜索技能,从对应 GitHub 仓库预览并导入技能及资源文件。 |
| ClawHub | 搜索公开技能并下载技能包;部分条目需要从其 GitHub 来源导入。 |
| SkillHub | 搜索公开技能并通过 SkillHub 下载技能包。 |
| SkillsMP | 搜索技能,使用结果提供的 GitHub 链接预览并导入。 |
也可使用公开链接或本地 Markdown / ZIP 文件导入。搜索结果由各来源提供,可能受到网络、权限或来源配额限制;搜索本身不会保存技能,导入前需预览并确认。详细行为与配置见技能库说明和来源出口配置。
界面预览
管理员视角的工作空间详情展示运行状态、资源与模型配置,侧栏包含工作台和管理入口。截图使用管理员权限的演示数据。

本地开发
1. 准备环境
准备 Git、Make、Go 1.27.2、Node.js 24.x(含 npm)、Python 3.11+、Docker Engine 和 Docker Compose,并确保 Docker 服务已启动。
git clone https://github.com/jonluo94/deepseek-harness-cloud.git
cd deepseek-harness-cloud
npm ci --prefix apps
2. 初始化并启动 API
首次使用时,在仓库根目录执行:
make dev-init
make auth-init
make infra-up
make migrate
make auth-apply
make run-auth
make infra-up 启动 PostgreSQL 和 Redis;make migrate 执行数据库迁移并更新受限角色授权,make auth-apply 导入初始账号。make run-auth 在前台运行 API(包含内置身份服务),该终端需保持运行。随机密码、密钥和本机配置保存在 Git 忽略的 .local/ 中。已有环境再次启动时,执行 make infra-up 和 make run-auth;后者也会执行迁移、授权更新及本地数据初始化。
3. 启动控制台并登录
在另一终端的仓库根目录执行:
make portal
打开 控制台登录,使用下列本地账号,密码从对应文件读取:
| 角色 | 账号 | 密码文件 |
|---|---|---|
| 管理员 | admin@harness.local |
.local/auth/admin-password |
| 成员 | member@harness.local |
.local/auth/member-password |
API 默认地址为 http://127.0.0.1:18080,提供 /livez 和 /readyz 健康检查。以上步骤启动控制台所需的基础服务;Worker、访问网关和模型网关需另行配置与启动。
4. 配置工作空间运行环境
完成以上步骤后即可访问控制台。要创建和进入 DSH 工作空间,还需按部署运维指南配置运行镜像、Terraform 模板、持久存储、Worker、访问网关和模型网关。
配置域名访问入口后,重启 API 与控制台,启动访问网关,通过 portal.harness.localhost:42013 访问控制台。浏览器所在机器需信任 .local/auth/cert.pem 开发 CA,以访问工作空间的独立站点。
随后由管理员在“平台配置”设置默认资源和系统上限,成员在“模型提供商”添加账号并完成校验,即可创建工作空间。
可选:通过局域网 IP 访问
完成域名访问配置后,可增加 IP 入口。将下面的示例 IP 替换为部署主机实际可监听的局域网 IP,在仓库根目录执行:
HC_PUBLIC_IP=192.168.1.100 make ip-access-init
重启 API 和访问网关后,通过 https://192.168.1.100:42013 访问控制台;工作空间使用同一入口下的 /dsh/<实例UUID>/ 路径,静态资源和 WebSocket 也经此入口转发。客户端需信任开发 CA,并能连接该 HTTPS 端口;使用浏览器系统代理时将此 IP 设为直连。端口可通过 HC_IP_PORTAL_PORT 调整,OAuth 回调也需登记相应的 IP 入口地址,详见部署运维。
常用命令
| 命令 | 用途 |
|---|---|
make portal |
启动前端开发服务 |
make test |
运行单元测试与 Go 竞态检查 |
make build |
构建后端与控制台 |
make portal-preview |
预览已构建的控制台,需先执行 make build |
make infra-stop |
停止 PostgreSQL 与 Redis,保留数据卷 |
数据库集成测试、浏览器测试和真实运行验收见测试验收。
开发检查
在仓库根目录安装运行适配与插件测试所需的固定 DSH 依赖,再执行检查:
npm ci --prefix infrastructure/runtime
GOMODCACHE=/tmp/hc-go-mod GOCACHE=/tmp/hc-go-build go vet ./...
npm run typecheck --prefix apps
make test
make build
make test 包含 Python、Go(含竞态检查)、前端、Node 及原生插件测试;缺少外部环境的测试会按条件跳过,完整集成验收需另行执行。
当前格式检查脚本仍引用仓库中已缺失的 Prettier 配置,make format、make format-check、make check 和 make ci 尚不能作为完整可用的检查入口。现状与复验方式见工程检查现状。
常见问题
浏览器提示证书不受信任本地控制台和工作空间入口使用开发证书。将部署主机上的 .local/auth/cert.pem 开发 CA 加入浏览器所在机器的信任库,使用已配置的域名或 IP 入口访问。只接受一次证书警告可能仍导致工作空间连接失败;证书与访问入口配置见部署运维。
API / Gateway 不设置启动冷却窗口。持续失败时参照部署运维检查依赖与日志。
工程结构
控制台使用 React 19、TypeScript、Vite 和 Ant Design;后端使用 Go、PostgreSQL 和 Redis。API、Worker、访问网关和模型网关分别运行,Worker 通过 Terraform 管理 Docker 工作空间。
flowchart LR
Browser[浏览器控制台] --> API[API / 内置身份服务]
Browser --> Gateway[访问网关]
API --> DB[(PostgreSQL)]
API --> Redis[(Redis)]
Worker[Worker] --> DB
Worker --> Terraform[Terraform]
Terraform --> Workspace[Docker / DSH 工作空间]
Gateway --> Workspace
Workspace --> Models[模型网关]
Models --> Providers[模型提供商]
apps/ 浏览器控制台与前端测试
services/ API、Worker、访问网关、模型网关及 hcctl 运维工具
infrastructure/ DSH 运行适配、Terraform 模板、存储与网络执行器
db/ 数据结构与版本化迁移
api/ OpenAPI 接口规范
deploy/ 本地依赖及可选服务部署配置
docs/ 需求、架构、部署与验收文档
文档入口
文档总览提供完整阅读顺序,也可以按任务查阅:
| 我想…… | 阅读文档 |
|---|---|
| 了解产品能力与业务流程 | 功能需求 |
| 部署、升级或排查问题 | 部署运维 · 安全设计 |
| 理解架构并参与开发 | 系统设计 · 后端 · 前端 |
| 对接 API 或了解数据结构 | 接口说明 · OpenAPI · 数据设计 |
| 运行测试、了解验收进度 | 测试验收 · Graphiti DSH 专项 |
| 配置记忆与知识库服务 | 独立服务部署 |
| 接入 MCP 与 OAuth 服务 | 部署与复验 |
| 安装或维护原生记忆插件 | 分发总览 · Mem0 · Graphiti |
参与贡献
欢迎通过 Issues 反馈问题或讨论功能,通过 Pull Requests 提交改进。
- 对于较大的变更,先在 Issue 中说明使用场景与预期行为。
- Fork 仓库并创建分支,完成改动及相关文档;修复缺陷时补充能够复现问题的测试。
- 按开发检查准备工具,提交前执行其中的静态检查、测试与构建,按涉及范围补充集成或浏览器验证。在 PR 中说明变更目的、行为变化和验证结果。
请勿提交 .local/ 中的密码、密钥、令牌或本机配置。
许可证
原有代码采用 MIT License。
本项目基于 DeepSeek Harness 构建工作空间体验。
No comments yet. Be the first to write one.