DSH它不是代码大模型，是一套「可插拔、开源、本地优先」的代码 Agent 执行框架（Harness 智能体底座），主打「一切皆插件」，给大模型装上读写文件、跑 Shell、自主迭代调试的手脚。
核心优势（最关键 4 点）
1. 架构：真正「一切皆插件」，自由度极高（最大特色）
模型、工具、技能、沙箱、会话存储、任务调度、UI 界面全部都是插件，不用改源码，改配置就能替换：
- 模型插件：不止 DeepSeek，可接 OpenAI、Claude、Kimi、Ollama 本地模型
- 沙箱插件：可切换本地 workspace 沙箱 / 远程隔离沙箱，自定义权限策略
- 子 Agent、循环策略、日志、检索都能插拔重组
- 和 Aider、Claude Code 这类「成品工具」最大区别：它们是固定工作流；DSH 是让你自己组装 AgentDeepSeek
2. 开源 + 本地可控、国内友好，无强制翻墙
- 完全开源，可本地部署、私有化，代码不出本机 workspace（安全隔离）
- 原生支持国内模型，不用依赖海外闭源服务；可对接本地 Ollama 离线模型
- 两种启动方式：npx一键体验 /git clone 二次开发，门槛分层
3. 完整工程 Agent 闭环，不止 “结对改文件”
不只是简单改代码片段，自带完整智能体循环：
- 读项目结构、依赖分析、自动跑 Shell、执行测试、定位报错、迭代修复
- 会话全链路可追溯：所有思考、工具调用、子 Agent 调度都有只读日志，方便排查长任务
- 内置子 Agent 编排，适合大型项目拆分多任务协同（大工程重构、全仓改造）
4. 上手双形态：WebUI 可视化 + CLI 自动化
- WebUI：可视化 Workspace 选择、会话管理、人工审批高危命令，新手友好（就是你刚才打开的页面）
- CLI：dsh run直接脚本化跑任务，适合 CI/CD、批量自动化，适合工程流水线集成保姆级攻略
保姆级攻略
一、DeepSeek Harness 是什么 二、安装前准备(检查环境) 三、国内加速:切换 npm 镜像源(强烈建议) 四、方式一:一行命令快速体验(npx) 五、方式二:D盘专用版(推荐,自带独立 Node,不污染系统) 六、关键坑位:postinstall 脚本崩溃(import.meta.resolve) 七、首次启动与配置(API Key / 模型选择) 八、桌面快捷方式(一键启动) 九、日常使用:常用命令与开关服务 十、常见问题排查 FAQ 十一、进阶:给 DeepSeek Harness 安装 dot-skill 十二、附录:文件目录结构说明
================================================================================ 一、DeepSeek Harness 是什么 ================================================================================ DeepSeek Harness(命令行工具名 dsh,即 DeepSeek Harness 的缩写)是 DeepSeek 官方开源的一个 AI 智能体(Agent)框架,采用「一切皆插件」的架构,由 Cordis 驱动。你可以把它理解成类似 Claude Code 的本地 AI 助手环境。
它提供两种使用形态: 1) dsh web —— 网页版(浏览器里操作,默认地址 http://127.0.0.1:3080) 2) dsh headless —— 命令行版(在终端里对话)
注意:dsh 只是「框架/壳子」,真正对话要调用 DeepSeek 的大模型 API,所以需要 你有一个 DeepSeek 开放平台的 API Key(在 https://platform.deepseek.com 申请)。
================================================================================ 二、安装前准备(检查环境) ================================================================================ dsh 官方要求 Node.js。注意!!!它的依赖对 Node 版本要求很新: – 大部分依赖要求 Node >= 20 – 一部分核心依赖甚至要求 Node >= 22 所以强烈建议使用 Node 22 及以上版本。如果系统里是老版本(比如 16),直接跑 会报一堆错(见第十章 FAQ)。
第一步:检查当前 Node 版本。打开终端(Cmd / PowerShell / Git Bash)输入:
node –version npm –version
判断: – 版本是 v20.x / v22.x 及以上 → 恭喜,可以直接用「方式一」 – 版本是 v18 或更低 → 建议用「方式二」(D盘专用版,自带新版 Node) – 提示\”node 不是内部或外部命令\”→ 说明没装 Node,先去 https://nodejs.org 下载 LTS 版(建议 v22)安装,装完重启终端再继续
【重要】如果你的系统 Node 版本太老,又不方便升级(怕影响其他项目), 强烈建议直接跳到「方式二」:我们把一套全新的 Node 22 放到 D 盘单独用, 完全不碰系统里的老 Node。
================================================================================ 三、国内加速:切换 npm 镜像源(强烈建议) =====================
