DSH（DeepSeek Harness）使用指南

基于本地源码 D:\louis05292026\DEEPSEEK\deepseek-harness-master 实测整理

源码仓库

https://github.com/deepseek-ai/deepseek-harness

一、环境要求

二、首次安装与构建

# 1. 全局安装 pnpm（已装过可跳过）
npm install -g pnpm

# 2. 安装项目依赖（仓库已自带 node_modules，代码/依赖变化时才需要重跑）
cd D:\louis05292026\DEEPSEEK\deepseek-harness-master
pnpm install

# 3. 构建产物
pnpm run build

# 4. 启动 Web UI
pnpm 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 字节）

五、当前机器状态小结

• ✅ dsh CLI 可用（通过 pnpm dsh 从仓库根目录运行；未加入系统 PATH）
• ✅ Web profile 已初始化，GUI 正在 http://127.0.0.1:3080 运行
• ⬜ headless profile 未初始化（首次使用自动生成）
• ⬜ tui profile 未安装