DeepSeek Harnessdsh上手两周本体不难装难的是喂模型起因DeepSeek 开源 dsh 那天我在加班跟风装了跑了个最简单的任务就关了。隔了两周才有空正经玩这篇把过程补记一下。安装、模式、模型配置、插件正事都在前面穿插我踩的坑。赶时间的直接跳「配模型」和「插件与 MCP」两节。背景一句话dsh 不是聊天工具是 DeepSeek 今年 8 月开源的 Agent 运行时MIT 协议仓库 deepseek-ai/deepseek-harness开源没几天星就十几万了。理解成 Claude Code 那一类的东西也行区别是它的模型、工具、界面全是插件都能换。安装四条路我走了两条半官方给的路子比想象中多按折腾程度排。最省事的是 npx 直启 Web。装好 Node.js22.19 以上或者 24 系列找个目录跑npx deepseek-ai/dsh web浏览器开 127.0.0.1:3080 就是完整界面仓库都不用 clone。我第一次就是这么起的五分钟。想看源码或者自己写插件就 clone 下来pnpm install pnpm run build pnpm dsh web。有个容易忽略的点之后 git pull 拉了新代码必须重新 build不然浏览器里一直渲染旧界面你会以为平台坏了其实是自己的锅。不想碰命令行的社区有个 DSH DesktopElectron 套壳Releases 下安装包一路下一步。我装过能用没什么惊喜算半条。我最后常驻的是 TUI。npm install -g deepseek-ai/dsh deepseek-harness-tui/dsh-tui之后在项目目录敲dsh-tui全屏终端界面Claude Code 那个感觉。恢复上次会话用dsh-tui --resume退出要连按两次 CtrlC。Windows 原生终端里 TUI 偶尔渲染花屏挪进 WSL 就好了。另外 web 模式占 3080 端口被占了记得换。这几条路共用同一套配置和 profile换来换去不冲突这点做得挺体面。四种模式别纠结标准当默认Web 界面里能切预设标准、PTC、极简、创造。标准模式是全家桶文件编辑、shell、搜索、Skills、计划、子 Agent、工作流都在。系统提示词也最长复杂任务受益简单任务偶尔多绕几步。日常放这儿不动就对了。PTC 模式有意思它把工具交给模型的方式变了模型写一段 TypeScript 程序在程序里连续调工具、统一处理结果而不是一问一答地来回。我有次要横扫工作区里几十个文件抓 TODO 再汇总切到 PTC 明显省轮次。单文件小改犯不上。极简模式只留持久 bash 和 str_replace_editor 两个工具上下文最短。社区有人吹极简才发挥模型实力我的体感是它不是让模型变强是把环境砍到只剩骨头。做受控对比测试合适日常用会缺胳膊少腿联网搜索、任务规划这些都没了。创造模式用来造自己的预设带运行时检查和引导界面成品落在 $DSH_HOME/.agent-presets/ 下面。我还没正经用抄过一次别人的预设能跑。配模型这一步的坑比安装多dsh 装好是空的没模型不干活。我从官方便宜一路试到中转三条路都趟了整条路线画成图大概是这样先用官方 API 不亏。Settings → ModelsDeepSeek 卡片是预置的把 platform.deepseek.com 申请的 key 填进去保存就能用路由即时生效不用重启。key 落在 $DSH_HOME/.credentials.yaml 里设置页只存引用不存明文这个细节好评。想接别家模型走 Add a custom providerProvider ID小写建了不能改名、Base URL、协议选 OpenAI compatible、填 key然后点 Fetch available models 自动拉模型列表勾上要用的保存。这里我踩过一个坑Provider ID 随手填了大写后来想改发现改不了会话记录和默认配置都引用它只能删了重建。我最后固定下来的是中转站。原因前面说过一家的模型不够换多家官方后台又对不动账。朋友给我推荐了 bgtoken.top一个 OpenAI 兼容的聚合网关。在 custom provider 里 Base URL 填它的 /v1 地址Fetch 一下拉出来五十多个模型deepseek-v4-pro、claude 系、GPT 系、GLM 全在一张列表里勾完就能用账单按模型分后台看得清清楚楚。同类站应该也有能打的我用顺手的就这一个利益无关。模型广场长这样左侧是分组、供应商和端点类型的筛选价格三列分开摆懒得点界面的直接写 settings.yaml效果一样llm-pi-ai:providers:mygateway:api:openai-completionsbaseURL:https://bgtoken.top/v1# 密钥用 apiKeyEnv 指到环境变量名别明文写进文件models:-id:deepseek-v4-pro-id:claude-sonnet-4-6启动前把对应的 key export 成环境变量就行。还有一个隐蔽的坑手动加的模型默认按纯文本处理你要接的模型明明支持图片得在配置里给它声明 input 支持 text 和 image不然带图的请求在发出前就被拒了报错还看不太懂。Trajectory 视图比我想象中好用这个功能宣传里说得少但我用下来是 dsh 最值钱的部分之一。会话日志是只追加的模型看到的每一样东西都记进去系统提示词、思维链、每次工具调用的出入参、子 Agent 的调度连每次上下文注入都有。Trajectory 视图里能按来源看能回放能分叉能检索。说个真事。有次任务一直报错模型自己绕了半天没找到原因我进 Trajectory 翻到那次请求的原始记录发现 model 字段里写的是 v4我手打漏了 pro。这种问题靠猜是猜不到的得看得见。Agent 调试的难点就是「模型到底看见了什么」这个视图算是把黑箱撬开了一条缝。插件与 MCP生态是真的野插件机制是 dsh 的招牌。装之前有个前置官方插件命令走 pnpm 管依赖先npm i -g pnpm。然后npx-y--packagedeepseek-ai/dshlatest dsh plugin--profilewebadd包名或Git地址npx-y--packagedeepseek-ai/dshlatest dsh plugin--profileweb list--depth0装完重启 web浏览器 CtrlShiftR 硬刷一下。找插件去 GitHub 搜 dsh-plugin 这个 topic。没有官方商店也没人审核装之前自己看一眼 README 和来源。我常驻的插件说两个。dsh-at-file输入框打 引用工作区文件提交的是路径不是全文Agent 需要时自己去读省 tokendsh-memento跨会话记忆本地 SQLite 存每次写入默认要你批准带审计记录我这种怕 AI 乱记东西的人很吃这套。另外试过 ModLens给纯文本模型外挂视觉截图先 OCR 再转述分析报错截图挺顺手。插件版本记得钉死比如 dsh-better-sidebar0.12.2 这种写法预览版插件升级快不钉哪天突然就崩。MCP 也能挂走 cordis.patch.yml 的 insert 块把 deepseek-ai/dsh-mcp-client 挂上去MCP 工具会以 mcp__ 前缀注册进模型工具列表。我配过一次 Filesystem 的 server能用具体写法仓库 discussions 里有现成例子。临走几句权限上新会话默认 workspace-write能改工作区和临时目录读文件和网络放得比较松shell 操作会弹审批。这个默认档位我建议别手动开太大。dsh 还在 developer preview官方明说了会有破坏性变更正式项目记得锁版本升级前翻 changelog。插件会接触你的文件、网络和 key来源不明的别装。这话每篇 Agent 文章都在说真到踩的时候都晚了。模型来源这事我的结论没变官方便宜省心中转统一好管按自己的情况选。我这套 dsh 加 bgtoken.top 的组合跑到现在账单没再失控过。有问题评论区聊。