本文首发于 栏轩·阁欢迎访问阅读原文获取更好的阅读体验。引言不只是又一个 Agent 框架如果你已经玩过各类 AI Agent 工具一定体会过那种功能很强但想改点什么却无从下手的感觉。DeepSeek Harness简称dsh想要解决的正是这个问题。它由 DeepSeek AI 开发并开源是一个agent harness智能体框架。与开箱即用的传统 Agent 产品不同它的核心理念只有一句话一切皆插件Everything is a Plugin。整个框架由 Cordis 驱动——一个轻量、模块化的插件容器。这意味着你看到的界面、模型接入、工具调用、甚至是官方 UI 本身统统都是插件。想要什么功能装一个插件想改什么行为换一个插件想造一个新能力写一个插件。对开发者而言这是一块高度可定制、可插拔、可学习的试验田。⚠️用前提示DeepSeek Harness 目前处于开发者预览阶段正在快速迭代。未来将出现破坏兼容性的变更breaking changes请关注版本更新。 项目地址deepseek-ai/deepseek-harness: DeepSeek Harness: Everything is a Plugin.安装与启动环境要求在开始之前请确保本机满足以下工具版本工具版本要求Node.jsv22.19.0或更高npm 9方式一通过 npm 快速体验推荐如果你只是想先跑起来看看一条命令即可npx deepseek-ai/dsh webnpx会临时拉取并执行 dsh无需全局安装。方式二通过源码运行适合深入学习如果你想阅读源码、参与开发推荐克隆仓库gitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harnesspnpminstallpnpmrun buildpnpmdsh web源码方式依赖pnpm这也是后续插件开发的基础环境建议提前装好。启动端口启动后dsh 默认监听3080端口自动打开 Web 界面如果 3080 被占用或者你希望换个端口可以用--port参数npx deepseek-ai/dsh web--port8080当然也可以全局安装后直接使用dsh命令体验更顺滑npminstall-gdeepseek-ai/dsh dsh web--port8080进入网页浏览器访问对应端口如http://localhost:8080即可看到 dsh 的主界面到这一步它已经和普通的 Agent 软件一样可以直接使用了新建对话、提问、让 AI 帮你干活都能正常工作。选一个工作区启动后第一步是点击选择工作区把dsh启动时所在的目录添加进来并选中。选中工作区之前会话输入框是不可用的——这也是 dsh 的安全设计让 Agent 明确知道自己能碰哪些文件。权限与安全模型dsh 在权限上做了分层设计新会话默认使用workspace-write权限预设读写受限Bash 和文件系统修改仅限会话工作区与平台临时目录读取放开文件读取、网络访问、进程可见性不受限制需要审批的操作当某个操作超出当前权限策略时Web UI 会先询问你而不是直接执行如果你有特殊需求可以通过环境变量DSH_PERMISSION_MODE调整进程级的权限预设。这套模型让让 AI 干活和不担心 AI 乱动得以兼得。四种内置模式dsh 针对不同使用场景内置了四种 Agent 模式。理解它们的差异能帮你选对起跑姿势模式定位特点standard标准模式日常通用当前默认使用的模式覆盖日常对话与通用任务code编码模式编程开发内置功能完整的编码 Agent支持文件编辑具备标准模式的全部能力并通过 Code Shell、文件与网页检索、Skills、计划、目标、子代理和工作流完成复杂开发任务minimal极简模式轻量环境仅提供持久bash与str_replace_editor两种工具的极简编码 Agent适合资源受限或需要纯净环境的场景cordis创造模式自定义开发用于创建自定义 Agent preset具备标准模式的全部能力并提供运行时检查、插件实验与 preset 创作指导是插件开发者的主战场 此外dsh 还提供ModeSDK它把各类能力呈现为工具让模型可以用一个 TypeScript 程序组合多步操作——如果你有让 Agent 按脚本流程执行的需求ModeSDK 正是为此设计的。常用操作上手之后这几个高频操作值得第一时间掌握导出对话每个对话右上角都有Session log按钮可以将当前工作目录的完整交互过程及对话内容导出。这对复盘调试、沉淀案例、撰写文档都非常有用。对话归档归档Archive不会删除数据只是给对话打上标记。归档后的数据统一存储在用户名\.dsh\目录下随时可以找回。在新对话中分支就像 Git 分支一样你可以基于某个对话在新对话中继续分支——非常适合同一个问题尝试多种解决思路的场景。自定义 AI 模型提供商在设置 → 模型中除了 DeepSeek 官方模型还可以配置其他模型提供商目录提供方选择 Anthropic、OpenAI 等已内置目录的提供方填入 API 密钥即可自定义提供方公司网关或自建服务器填写 Provider ID、基础 URL、API 协议、凭据和至少一个模型模型发现支持获取可用模型自动查询端点不提供该端点时手动录入即可几个细节值得注意密钥是只写的保存后页面只显示脱敏描述符明文存在$DSH_HOME/.credentials.yaml模型配置即时生效不需要重启服务器视觉模型需要声明图片模态input: [text, image]否则发送图片会在请求前被拒绝选择过的模型会成为新会话的默认值这让 dsh 可以对接你已有的模型 API灵活组合使用。插件dsh 的灵魂插件是什么在 dsh 的世界里一切皆是插件。安装一个插件本质上就是往$DSH_HOME/profiles/web/node_modules里pnpm add一个包——就这么朴素。插件管理命令# 安装插件本质是 pnpm add装到 $DSH_HOME/profiles/web/node_modulesdsh plugin--profilewebadd包名# 卸载插件dsh plugin--profileweb remove包名# 更新插件dsh plugin--profileweb update# 查看已安装的依赖dsh plugin--profileweb list注意插件管理依赖pnpm环境请提前安装。通过插件可以做什么定制 Web UI包括官方 UI 在内界面的每一部分都是通过插件注入的——想改界面改插件即可实现类似其他 Agent 软件的 Skill 效果让模型在对话时自动调用你定义的工具扩展 Agent 的能力边界开发小技巧把官方插件当教科书遇到奇怪的报错或不清楚某功能如何实现时直接去读官方插件的源码。dsh 的理念是一切皆插件这意味着绝大多数官方功能本身就是插件实现的——它们就摆在仓库里是现成的、高质量的学习资料。与其瞎猜不如让 AI 帮你分析官方插件的实现方式往往能快速定位问题、找到标准做法。 插件的开发细节如何写一个插件、发布与安装流程等会单独写一篇介绍这里不展开。Headless 模式没有界面的 Agent除了 Web UIdsh 还提供了headless无头模式——不需要浏览器一条命令跑完一个任务dsh--profileheadlessrun the tests它适合脚本化调用在 CI/CD 或定时任务里跑 Agent批量任务把任务文本作为参数传入结果输出到 stdout轻量验证不想开浏览器时的快速尝试更进一步的玩法是Python SDK官方提供了deepseek-harness-sdk可以在自己的 Python 程序里调用同一套 API程序化地创建会话、运行任务、读取结果。这对想要把 dsh 集成进自己系统的开发者非常友好。配置与调试dsh 的配置体系是分层的 patch 叠加不过日常使用只需记住几个有用的命令# 查看完整配置树含 profile 层和自定义 overlaydsh--profileweb --dump-config# 只看内置默认配置dsh--profileweb --dump-default-config# 用自定义配置文件叠加启动dsh web--patch./extra.cordis.yml几个实用细节AGENTS.md 支持dsh 会加载工作区里的AGENTS.md或CLAUDE.md指令文件让 Agent 自动了解项目的约定——这在多 Agent 协作时尤其有用环境变量DSH_PERMISSION_MODE权限预设、DSH_TOOLS_MODE工具模式、DSH_MODEL默认模型等都可以在启动时调整优雅关闭收到CtrlCSIGINT会先优雅排空再退出不用担心任务跑到一半数据丢失dsh 常用命令速查命令作用dsh web启动 Web 模式--port指定端口dsh --profile headless 任务无头模式跑任务适合脚本/CIdsh --profile web --dump-config查看完整配置树dsh web --patch ./extra.yml用自定义配置层叠加启动dsh plugin --profile web add 包名安装插件dsh plugin --profile web remove 包名卸载插件dsh plugin --profile web update更新插件dsh plugin --profile web list查看已安装插件社区与支持GitHub Discussions提交反馈、报告 bug 的首选渠道dsh-plugin话题在 GitHub 上给你的插件仓库打上dsh-plugin话题标签便于被社区发现官方社群DeepSeek Harness 官方提供企微群与微信公众号扫码添加小助手并填写问卷即可入群第一时间获取版本动态与社区交流结语DeepSeek Harness 的独特之处不在于它又多了一个 Agent 工具而在于它把可定制性做到了极致一切皆插件意味着框架的每一层都向你开放。对于想深入 Agent 开发的你来说它既是开箱即用的工具也是绝佳的源码教材——装上插件、跑通流程、再打开官方插件源码读一读一条从使用者到开发者的路径就自然展开了。如果你也在折腾 dsh欢迎交流你的插件想法或踩坑经验。