一、功能说明
DSH 是 DeepSeek 开源的 AI Agent 运行框架，本身不提供模型，而是作为"执行底座"，连接本地文件与大模型 API，让 AI 能真正动手干活。
核心能力：
- 安全沙箱执行：限制文件读写与命令权限
- 任务自动拆解：复杂需求分步执行
- 多模型兼容：支持 OpenAI 协议接口
- 插件化扩展：模型、工具、UI 均可替换
- 双入口：Web 界面 + dsh 命令行
适用场景： 本地项目代码处理、批量文件分析、多步骤任务编排、模型工具调用对比。
当前为开发者预览版，可能有破坏性变更，不建议用于生产核心业务。
二、安装
1. 安装 Node.js
DSH 依赖 Node.js，要求 v22.19.0 及以上，推荐 v24。
- 访问 Node.js 官网，下载 LTS 版 Windows 安装包。
- 双击安装，务必勾选 Add to PATH。
- 安装完成后，重新打开 PowerShell，验证：
- -v
npm -v
npx -v
如果 PowerShell 提示禁止运行脚本：
以管理员身份打开 PowerShell，执行：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
输入 Y 确认，然后重开终端。
国内网络加速（可选）：
npm config set registry https://registry.npmmirror.com
2. 一行启动 DSH
npx @deepseek-ai/dsh web
首次运行会自动下载。启动后默认打开浏览器，地址为：
如不想自动打开浏览器：
npx @deepseek-ai/dsh web --no-open
端口冲突时可指定端口：
npx @deepseek-ai/dsh web --port 8080
三、使用
1. 配置模型 API Key
打开 Web UI → Settings → Models → 找到 DeepSeek 卡片 → 填入以 sk- 开头的 API Key → 保存。无需重启。
也可用环境变量：
$env:DEEPSEEK_API_KEY="sk-你的密钥"
npx @deepseek-ai/dsh web
2. 选择工作区
工作区是 Agent 的文件边界，Agent 只能在该目录内读写。在界面中添加或选择你的项目目录。
3. 发出任务
在对话框输入需求，Agent 会自动拆解、调用工具、分步执行。每一步操作都会以时间线展示。
4. 四种运行模式
|--------|------------------------|----------|
| 模式 | 特点 | 适用 |
| 标准模式 | 功能最全 | 日常首选 |
| PTC 模式 | 支持 TypeScript 编排多步工具调用 | 工具调用密集任务 |
| 极简模式 | 仅 Bash + 文件编辑 | 测试、教学 |
| 创造模式 | 插件实验、预设创作 | 扩展开发 |
5. 权限级别
- Read Only：只读
- Workspace Write：仅工作区内可写
- Full Access：最高风险，慎用
6. 推荐插件
- dsh-market：可视化插件市场
- DSH-better-sidebar：文件预览与编辑
- dsh-plan-execute：规划与执行双模型路由
四、常见问题
|-----------|-----------------------------------|
| 问题 | 解决 |
| npx 不是命令 | 未安装 Node.js，或未勾选 Add to PATH |
| 启动后无法访问 | 检查 3080 端口，或换端口 --port 8080 |
| 终端关闭后服务停止 | Web UI 依赖终端进程，保持终端开启 |
| 下载慢 | 设置 npm 国内镜像 |
| 版本兼容问题 | 锁定版本：npx @deepseek-ai/dsh@版本号 web |
一句话总结： 先装 Node.js，验证 node/npm/npx，然后 npx @deepseek-ai/dsh web 一行启动，配置 API Key，选工作区，输入任务即可。