Markdown 版本
AI-translated from English; not yet reviewed by a fluent editor.
# 如何在一次性工作区中试用 DeepSeek Harness
> 这是一份基于文档的 DeepSeek Harness 首次使用指南,介绍如何在一次性工作区中设置模型、了解供应商费用和会话数据,并遵守预览版的安全限制。
By BIG CHANGE Editorial
Published: 2026-10-05T05:59:25.729Z
Updated: 2026-10-05T05:59:25.729Z
Canonical: https://bigchange.ai/blog/deepseek-harness-safe-workspace-setup-guide

AI-generated conceptual editorial illustration by BIG CHANGE.
DeepSeek Harness 可以读取项目文件、使用模型,并通过电脑上的 Web 界面运行工具。DeepSeek 将产品称为[公开预览版](https://www.deepseek.com/en/harness/);其[代码仓库](https://github.com/deepseek-ai/deepseek-harness)则称软件处于开发者预览阶段,可能引入不兼容变更。[安全说明](https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.md)指出产品尚未经过安全审计,不适合用于生产环境。首次运行应放在一次性环境中,并使用无关紧要的项目。
查看[版本列表](https://github.com/deepseek-ai/deepseek-harness/releases)时,列表中包括`v0.2.1-alpha.1`2026年10月3日发布的预发行版(检查日期为10月5日)。下方文档中的命令本身不会选择该 GitHub 预发行版,因此在按特定版本的功能说明操作前,请先检查实际安装的版本。DeepSeek 在10月5日的新闻报道让我们注意到该工具之前,已经提供桌面版本;本文步骤采用其文档说明的本地 Web 界面。`npx`重大变化
## DeepSeek 现在以公开预览版形式提供开源智能体工具框架,可通过代码启动 Web 界面,并提供适用于 Apple 芯片 Mac 和 64 位 Windows 的官方桌面下载。其插件系统可以组合模型访问、工具和其他智能体能力。评估智能体处理文件时,实用之处在于可以使用小型本地工作区并选择模型供应商,而不必从公司代码库或实时业务数据开始。不过,预览版标记和安全说明仍然适用:智能体可以运行命令,并访问其进程可用的文件、凭据和网络。选择工作区或出现审批提示都不能保证隔离。
准备环境并安排第一个任务
## 使用一次性虚拟机、容器或专用电脑账户,并只授予任务所需的最低权限,正如 DeepSeek
建议[的那样。在其中创建一个新目录,只放入可以承受丢失的简短、非敏感](https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.md)。将个人文件、公司代码库、凭据、浏览器会话和挂载驱动器保留在该环境之外。备份进程可能访问到的所有内容。单靠一个目录并不能把进程限制在该目录内;它能访问什么还取决于底层账户和环境。`README.md`文档说明的 Web 方式需要
Node.js[以及模型账户或 API 凭据。在一次性目录中打开终端,并运行 DeepSeek README 中的命令:](https://github.com/deepseek-ai/deepseek-harness#run)根据
```sh
npx @deepseek-ai/dsh web
```
README[,该命令默认会在](https://github.com/deepseek-ai/deepseek-harness#run)启动 Web UI,并在本地浏览器中打开。如果没有自动打开,请使用命令打印的 URL;通过 SSH 启动时端口转发方式不同。此练习中不要将服务暴露到公共地址。`http://127.0.0.1:3080`默认情况下会在本地浏览器中打开。如果没有自动打开,请使用命令输出的网址;通过 SSH 启动时的转发方式不同。测试期间不要通过公网地址暴露服务。[称,进程默认将启动目录作为文件系统位置,但新界面尚未选择工作区。选择工作区,添加并选中这个一次性目录;选定工作区之前,输入框不可用。](https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart)配置一个模型并检查费用
## 在
设置 → 模型**中,**官方配置指南[称可以输入 DeepSeek API 密钥并保存。指南还记录了内置的第三方供应商选项,以及用于网关或自托管端点的自定义模型 API。使用第三方供应商时,选择](https://deepseek-harness.github.io/deepseek-harness/en/guide/providers)添加模型供应商**,从已安装列表中选取供应商,输入 API 密钥并保存。然后在会话选择器中选择其模型。指南称,Codex 等 OAuth 登录供应商不支持这一路径。如果列表中没有你的供应商,自定义方式需要供应商 ID、基础 URL、匹配的 API 协议、凭据和至少一个模型 ID;这属于单独的集成工作。**保存后,模型页面会显示经过遮盖的密钥描述。DeepSeek 表示密钥保存在
,设置中仅保存引用。请保护该文件及其所在环境。代码仓库采用 MIT 许可证,但模型调用可能产生费用。DeepSeek`$DSH_HOME/.credentials.yaml`服务条款[规定,自定义供应商的令牌或订阅费用由用户承担,并提醒一次输入可能触发持续的模型调用。发送任务前,请查看供应商当前价格和用量控制。软件许可证无法说明固定价格或免费额度。](https://www.deepseek.com/en/harness/terms-of-use/)发送只读请求,再检查执行情况
## 在选定的工作区中,用一个范围明确的请求启动会话:
这个建议提示限制了要求智能体执行的工具操作;但配置的远程模型仍会与其供应商通信。提示词不是安全边界。官方
```text
Summarize the README in this workspace. Do not run commands, edit files, install plugins or make network requests through tools. Ask before taking any other action.
```
快速入门[使用了总结代码仓库的任务,并说明智能体可以读取和编辑文件、运行命令及委派工作;根据当前策略需要审批的操作会提示用户。](https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart)检查回复是否准确描述了你的小型 README,并对照任务检查工具调用。拒绝任何未经授权的命令或文件改动。如果智能体尝试访问所选目录之外的路径、遇到秘密信息、建议安装插件,或提出超出已配置模型调用范围的外部工具请求,请停止会话并检查环境后再继续。DeepSeek 的
安全说明[称,审批和沙箱控制可以降低风险,但无法保证隔离。摘要正确也不能证明更长的工作流程会可靠运行。](https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.md)预期的首次输出是模型摘要,不应修改文件。BIG CHANGE 未安装或运行此版本,也未在实际环境中检查其提示词或测量可靠性。这些步骤是依据 DeepSeek 文档设计的保守操作路径,并非实测结果。
考虑会话数据
## DeepSeek 的
隐私政策[于9月20日更新,其中描述的会话日志可能包括输入、获授权的文件、模型输出、工具信息和插件配置。对于自定义模型,政策称输入会直接发送给选定的模型供应商,并受该供应商政策约束;DeepSeek 不会在其服务器上存储这些输入和输出。请阅读模型和已启用插件的当前政策,首次测试不要使用敏感材料。](https://www.deepseek.com/en/harness/privacy/)来源与延伸阅读
## DeepSeek Harness 产品页
- [,检查于2026年10月5日。介绍公开预览版访问、官方桌面下载平台和](https://www.deepseek.com/en/harness/) Web 方式。`npx`官方代码仓库与 README
- [,检查于2026年10月5日。记录开发者预览状态、本地 Web UI 命令、默认地址和 MIT 许可证。](https://github.com/deepseek-ai/deepseek-harness)版本列表[列出10月3日的](https://github.com/deepseek-ai/deepseek-harness/releases)预发行版,但不能据此确认`v0.2.1-alpha.1`命令会安装哪个版本。`npx`Web UI 快速入门
- [和](https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart)模型配置指南[,检查于2026年10月5日。介绍工作区选择、供应商设置、凭据存储和支持的配置方式。](https://deepseek-harness.github.io/deepseek-harness/en/guide/providers)安全说明
- [,检查于2026年10月5日。DeepSeek 介绍实验状态、系统能力、审批和沙箱控制的限制,以及使用一次性环境的建议。](https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.md)隐私政策
- [和](https://www.deepseek.com/en/harness/privacy/)使用条款[,均于2026年9月20日更新、10月5日检查。政策描述会话日志和自定义供应商的数据路径;条款说明自定义模型费用由用户承担。](https://www.deepseek.com/en/harness/terms-of-use/)DeepSeek Harness 官方产品页
## Sources
- [介绍公开预览、开源状态及桌面/Web 模式。](https://www.deepseek.com/en/harness/) — DeepSeek Harness GitHub 代码仓库
- [官方仓库介绍开源工具框架、开发者预览状态和可能的不兼容变更。](https://github.com/deepseek-ai/deepseek-harness) — DeepSeek Harness 版本发布页
- [GitHub 当前可见的预发行版列表;不能确认已安装的 npx 软件包版本。](https://github.com/deepseek-ai/deepseek-harness/releases) — DeepSeek Harness 安全说明
- [实验状态、执行能力、风险、缓解措施和沙箱限制。](https://github.com/deepseek-ai/deepseek-harness/blob/master/SAFETY.md) — 配置模型
- [模型设置、凭据处理及不支持的供应商。](https://deepseek-harness.github.io/deepseek-harness/en/guide/providers) — DeepSeek Harness 隐私政策
- [会话日志和数据处理。](https://www.deepseek.com/en/harness/privacy/) — DeepSeek Harness 使用条款
- [自定义模型费用和服务条款。](https://www.deepseek.com/en/harness/terms-of-use/) — 使用 Web UI
- [介绍默认启动目录、必须选择工作区、模型密钥和首次会话能力。](https://deepseek-harness.github.io/deepseek-harness/en/guide/quickstart) — 介绍默认启动目录、必须选择工作区、模型密钥和首次会话功能。
BIG CHANGE 新闻通讯
纵览全局,按自己的节奏。
关于人工智能和机器人技术的近期报道、值得关注的变化以及可采用的实用想法。选择每日简报、每周摘要或每月视角。
下次计划发送时间(UTC): . 确认订阅后,您将在下一个计划发送时间收到第一期通讯。