DSH(DeepSeek Harness)使用指南
基于本地源码
D:\louis05292026\DEEPSEEK\deepseek-harness-master实测整理
源码仓库
https://github.com/deepseek-ai/deepseek-harness
一、环境要求
| 项目 | 版本(本机实测) |
|---|---|
| Node.js | v24.18.0 |
| pnpm | 11.7.0(根目录packageManager指定) |
二、首次安装与构建
# 1. 全局安装 pnpm(已装过可跳过)npm install-g pnpm# 2. 安装项目依赖(仓库已自带 node_modules,代码/依赖变化时才需要重跑)cd D:\louis05292026\DEEPSEEK\deepseek-harness-master pnpm install# 3. 构建产物pnpm run build# 4. 启动 Web UIpnpm dsh web以后每次使用:
cd D:\louis05292026\DEEPSEEK\deepseek-harness-master pnpm dsh web不需要重新pnpm install/pnpm run build,除非更新了代码或依赖有变化。
浏览器访问:http://127.0.0.1:3080
注:
pnpm dsh是根目录脚本node --import tsx/esm apps/cli/src/bin.ts,从源码直接跑;
安装版(npm 包@deepseek-ai/dsh)则走构建好的apps/cli/lib/bin.js。
三、API Key 与凭据存放
- Web 界面里输入的 API Key 保存在
$DSH_HOME/.credentials.yaml
(本机即C:\Users\62765\.dsh\.credentials.yaml) - 凭据解析顺序:继承的环境变量 →
$DSH_HOME/.credentials.yaml→
调用目录的.env→$DSH_HOME/.env - 搜索使用
DEEPSEEK_API_KEY,可配DEEPSEEK_SEARCH_BASE_URL - 凭据文档不会写进
process.env,两个.env文件则是普通的环境层
四、权限与沙箱(安全相关)
- 新会话默认
workspace-write权限预设 - bash 和文件修改被限制在会话工作区 + 平台临时目录内;
读操作、网络访问、进程可见性不受限 DSH_PERMISSION_MODE可修改进程级权限回退DSH_TOOLS_MODE可选native/code/both,控制工具执行方式- 会话遥测默认关闭且仅本地;
DSH_TELEMETRY_MODE=FULL才会上报 - 所有模式启动时都会加载工作区
AGENTS.md/CLAUDE.md指令(渲染上限 65,536 字节)
五、当前机器状态小结
- ✅
dshCLI 可用(通过pnpm dsh从仓库根目录运行;未加入系统 PATH) - ✅ Web profile 已初始化,GUI 正在
http://127.0.0.1:3080运行 - ⬜
headlessprofile 未初始化(首次使用自动生成) - ⬜
tuiprofile 未安装