DSH 傻瓜式启动
这是什么（一句话版）
DeepSeek Harness（命令行叫 dsh）是 DeepSeek 开源的 AI Agent 运行框架。 用一个公式记：
Agent = 模型（大脑） + Harness（手脚 / 工作台 / 安全带）
模型只会聊天，Harness 负责读文件、跑命令、拆任务、管会话、走权限审批——让 AI 真正把活干完。本地优先，一条命令起 Web 界面，数据全在本地。
- 开源协议：MIT（免费、可改、可商用，无订阅）
- 官方仓库：https://github.com/deepseek-ai/deepseek-harness
- npm 包：
@deepseek-ai/dsh - 当前状态：v0.1 开发者预览版（接口可能变动，不建议直接当生产依赖）
触发与适用
| 用户说法 | 处理 |
|---|---|
| DSH / dsh 是什么、DeepSeek Harness 怎么用 | 先讲「这是什么」，再进入启动流程 |
| 帮我装 dsh、本地跑 DeepSeek Agent、傻瓜式启动 | 直接走启动流程 |
| 只问概念不装 | 仅科普，不执行安装 |
傻瓜式启动流程（Agent 运行时执行）
核心约束：本 SKILL 不携带任何运行脚本文件。所有安装命令与启动脚本，都由你（Agent）在用户机器上按检测到的系统环境实时生成并执行。 执行原则：先检测现有环境，能复用就复用；每步只做必要动作。
0. 检测系统（第一步先确定 OS）
用 Bash 判断系统，决定走哪条分支：
- macOS：
uname -s返回Darwin - Linux：
uname -s返回Linux - Windows：
uname -s不可用或返回MINGW*/CYGWIN*/MSYS*，或检测到powershell/cmd
1. 讲清楚 DSH 是什么
用「这是什么」一节的话术，1–2 句说明，不展开论文式长篇。
2. 拿 DeepSeek API Key
引导用户到 https://platform.deepseek.com → 「API keys」→ 创建密钥（以 sk- 开头）。
两种用法，告诉用户二选一：
- Web UI 填（推荐，最直观）：启动后
Settings → Models粘贴保存 - 环境变量（启动前）：
export DEEPSEEK_API_KEY="sk-..."（Windows 用set）
安全：Key 仅留在本地配置或环境变量，绝不写进文档 / 日志 / 对外回复。
3. 装运行环境（按 OS 分支执行）
先用 command -v node 检测 Node；已装且版本 ≥ v22.19（或 ≥ v24）则跳过安装，仅做镜像与 dsh 安装。
macOS：
# 无 Node 时
brew install node # 无 brew 则引导去 https://nodejs.cn 下 LTS
npm config set registry https://registry.npmmirror.com
npm install -g @deepseek-ai/dsh
dsh --version
Linux：
# 无 Node 时（按发行版二选一）
sudo apt update && sudo apt install -y nodejs npm # Debian/Ubuntu
# sudo dnf install -y nodejs npm # Fedora
npm config set registry https://registry.npmmirror.com
npm install -g @deepseek-ai/dsh
dsh --version
Windows（PowerShell）：
# 无 Node 时
winget install OpenJS.NodeJS.LTS # 无 winget 则引导去 https://nodejs.cn 下 LTS
npm config set registry https://registry.npmmirror.com
npm install -g @deepseek-ai/dsh
dsh --version
不想全局装可改用
npx -y @deepseek-ai/dsh web（无需 install）。
4. 生成启动脚本 + 桌面快捷方式（用 Write 工具实时写出）
按 OS 用你的 Write 工具把下列文件写到用户桌面；随后用 Bash 赋可执行权限（Windows 无需）。
macOS — 写 ~/Desktop/DeepSeek Harness.command：
#!/usr/bin/env bash
export PATH="$HOME/.npm-global/bin:/usr/local/bin:/opt/homebrew/bin:$PATH"
dsh web &
sleep 4
open http://localhost:3080
wait
写完后执行：chmod +x ~/Desktop/DeepSeek\ Harness.command
Linux — 写 ~/Desktop/DeepSeekHarness.desktop：
[Desktop Entry]
Type=Application
Name=DeepSeek Harness
Comment=启动 dsh web 并打开 http://localhost:3080
Exec=bash -c 'dsh web & sleep 4; xdg-open http://localhost:3080; wait'
Terminal=true
Categories=Development;
写完后执行：chmod +x ~/Desktop/DeepSeekHarness.desktop
Windows — 写 桌面\DeepSeek Harness.bat：
@echo off
start "" http://localhost:3080
dsh web
再在 PowerShell 中创建 .lnk 快捷方式（用 Write 写一段临时 ps1 并运行，或用 -Command 内联）：
$WshShell = New-Object -ComObject WScript.Shell
$desktop = [Environment]::GetFolderPath("Desktop")
$lnk = $WshShell.CreateShortcut("$desktop\DeepSeek Harness.lnk")
$lnk.TargetPath = "$desktop\DeepSeek Harness.bat"
$lnk.WorkingDirectory = $desktop
$lnk.Description = "启动 DeepSeek Harness 并打开 http://localhost:3080"
$lnk.Save()
快捷方式行为统一为：**启动
dsh web服务 → 等待 → 打开 http://localhost:3080**。
5. 收尾提示
完成后告知用户：双击桌面快捷方式即可启动；首次打开 Web UI 需
Settings → Models填入 API Key- 选择工作区目录
- 直接派活，敏感操作会弹审批
常用命令
| 命令 | 作用 |
|---|---|
dsh web |
启动 Web UI（默认 http://127.0.0.1:3080） |
npx -y @deepseek-ai/dsh web |
免安装直接体验 |
dsh web --port 8080 |
指定端口 |
dsh --version |
查看版本 |
dsh --profile web --dump-config |
打印当前插件树（排错用） |
注意事项（事实）
- 仅本地回环
127.0.0.1，不对外暴露。 - 预览版，后续可能有破坏性变更；生产请等稳定版。
- 工作区外访问需逐次确认，无「总是允许」；本机勿存密钥文件（官方提示「谨慎，不叫边界」）。
- 费用：框架免费，成本来自模型 API 调用（按 token，普通任务几分钱）。
- 运行脚本与快捷方式均在你（Agent）执行本流程时实时生成于用户桌面，SKILL 包本身不含可执行文件，可安全发布到任意 SKILL 平台。
引用来源
- GitHub: deepseek-ai/deepseek-harness
- npm: @deepseek-ai/dsh
- 开放平台: https://platform.deepseek.com
- 教程实测：阿里云 / 腾讯云开发者社区相关文章（2026-08）