Skip to content

Commit a77dfc2

Browse files
feat: 增加 DeepSeek Harness 文档
1 parent e9c2d8d commit a77dfc2

6 files changed

Lines changed: 100 additions & 0 deletions

File tree

69.6 KB
Loading
274 KB
Loading
104 KB
Loading
80.8 KB
Loading
Lines changed: 99 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,99 @@
1+
# DeepSeek Harness 安装部署
2+
3+
## 产品介绍
4+
5+
!!! note ""
6+
**DeepSeek Harness(简称 DSH)** 是 DeepSeek 面向开发者推出的开源智能体运行环境。它负责向大模型提供项目文件、工具和运行环境,让模型可以完成开发任务。
7+
8+
DeepSeek Harness 采用插件化架构,可按任务组合网页检索、Skills、计划、子 Agent 和工作流等能力,并提供以下四种运行模式:
9+
10+
- **标准模式**:适合日常开发任务,建议初次使用时选择
11+
- **PTC 模式**:适合多步骤、复杂的工具调用编排
12+
- **极简模式**:仅保留基础命令和编辑工具
13+
- **创造模式**:用于创建和调试自定义 Agent 预设
14+
15+
更多产品信息,请参阅 [DeepSeek Harness 官方说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/README.zh.md)。
16+
17+
## 前提准备
18+
19+
!!! note ""
20+
部署前请先确认以下条件:
21+
22+
- 已安装并可正常访问 1Panel
23+
- 已准备 DeepSeek 或其他模型提供方的 API Key
24+
- 已在云安全组和系统防火墙中放行计划使用的 HTTPS 端口
25+
- 已准备浏览器实际访问服务器时使用的 IPv4 地址或主机名
26+
27+
## 1. 安装 DeepSeek Harness
28+
29+
!!! note ""
30+
登录 1Panel 后台,进入 **应用商店**,搜索 **DeepSeek Harness**,进入应用详情页并点击 **安装**。
31+
32+
按页面要求填写安装参数:
33+
34+
- **名称**:应用名称,默认可填写为 `deepseek-harness`
35+
- **版本**:选择需要安装的 DeepSeek Harness 版本
36+
- **HTTPS 端口**:用于访问 Web UI,例如 `10443`
37+
- **访问地址**:填写浏览器实际使用的 IPv4 地址或主机名,不包含 `https://` 和端口
38+
- **Web 用户名**:访问 Web UI 时使用的认证用户名
39+
- **Web 访问密码**:设置至少 12 位的强密码
40+
- **高级设置**:一般保持默认即可
41+
42+
![安装 DeepSeek Harness](../../img/app/deepseek-harness-install.png)
43+
44+
!!! note ""
45+
1Panel 应用商店中的 DeepSeek Harness 集成了 Caddy HTTPS 和用户名密码认证。Harness 仅监听容器回环地址,外部请求需要先经过 Caddy 鉴权和解密,再转发到 Harness 服务。
46+
47+
## 2. 访问 DeepSeek Harness
48+
49+
!!! note ""
50+
安装完成后,在浏览器中访问:
51+
52+
```text
53+
https://<访问地址>:<HTTPS 端口>
54+
```
55+
56+
浏览器会先要求输入安装时设置的 Web 用户名和密码,认证通过后即可进入 DeepSeek Harness。
57+
58+
!!! warning ""
59+
Caddy 使用内部 CA 自动签发证书,首次访问时浏览器可能提示证书不受信任。测试体验时可以确认地址无误后继续访问;正式环境建议配置受浏览器信任的证书。
60+
61+
## 3. 配置 DeepSeek 官方模型
62+
63+
!!! note ""
64+
首次进入 DeepSeek Harness 时,页面会提示添加 API Key。填写 DeepSeek 官方 API Key 后,点击 **保存并继续**。
65+
66+
也可以点击 **稍后配置**,进入页面后再打开左下角的 **设置**,在 **模型** 页面中完成配置。
67+
68+
![配置 DeepSeek API Key](../../img/app/deepseek-harness-api-key.png)
69+
70+
## 4. 配置第三方模型提供方
71+
72+
!!! note ""
73+
DeepSeek Harness 也支持配置第三方模型提供方。以 OpenCode Go 为例:
74+
75+
1. 打开左下角的 **设置**。
76+
2. 进入 **模型** 页面,选择 **添加提供方**。
77+
3. 选择 `opencode-go`,填写 API Key。
78+
4. 按需配置 API 地址和模型,确认无误后点击 **保存**。
79+
80+
![配置第三方模型提供方](../../img/app/deepseek-harness-provider.png)
81+
82+
## 5. 开始第一个任务
83+
84+
!!! note ""
85+
返回首页,在输入框左下角选择工作区,在右下角确认模型和运行模式,然后输入任务内容即可开始对话。
86+
87+
首次体验建议选择 **标准模式**,并使用不包含敏感数据的测试项目。
88+
89+
![开始 DeepSeek Harness 任务](../../img/app/deepseek-harness-task.png)
90+
91+
## 6. 安全与升级建议
92+
93+
!!! warning ""
94+
DeepSeek Harness 目前仍处于开发者预览阶段,建议仅用于测试体验,并注意以下事项:
95+
96+
- 妥善保管 API Key 和 Web 访问密码
97+
- 不要将宿主机根目录、Docker Socket 或 SSH 密钥目录挂载到工作区
98+
- 不要在工作区中放置敏感数据
99+
- 升级前备份重要数据

‎mkdocs.yml‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,7 @@ nav:
144144
- 常用软件:
145145
- OpenClaw: user_manual/appstore/openclaw.md
146146
- Hermes Agent: user_manual/appstore/hermes-agent.md
147+
- DeepSeek Harness: user_manual/appstore/deepseek-harness.md
147148
- OpenResty: user_manual/appstore/openresty.md
148149
- MySQL: user_manual/appstore/mysql.md
149150
- Redis: user_manual/appstore/redis.md

0 commit comments

Comments
 (0)