DSH 深度实战
与经验分享
给大模型套上一个能做事的外壳 —— 背景、插件生态与四个真实项目
- 2026-08-29
- doc.kinaze.cn · 技术分享
- 16 页 · 约 10 分钟
- 数据来自本机真实使用记录
使用 ←→ 或 空格 翻页,右下角可打开目录
01 · 背景介绍
DSH 是什么:Agent = Model + Harness
DSH(DeepSeek Harness)是 DeepSeek 开源的 Agent 运行框架。模型只负责思考与决策,Harness 负责"动手"——读写文件、执行命令、联网检索、定时任务、持久会话,把语言模型的输出变成真实世界里发生的事。
- 2026-08-13 随 DeepSeek V4 Pro 开源
- MIT License
- TypeScript
- 开发者预览版
- Cordis 微内核 · 北大 × DeepSeek 联合研发
"Everything is a Plugin."
内核只保留事件总线与生命周期管理,其余一切能力都是插件:文件系统、终端、浏览器、定时器、API 网关……随装随用、随卸随走。
Cordis 内核带来三个工程性质:插件即事件订阅、进程级隔离、支持热插拔。能力坏了不影响外壳,外壳升级不打扰能力。
02 · 核心理念
给 LLM 套上能做事的外壳
裸模型:
只能输出文本,每次对话从头开始,碰不到你的文件和系统;人是"人肉执行器",把 AI 的答案复制粘贴到真实世界。
套上 DSH:
- 直接读写文件、执行命令、联网检索、设定时任务
- 会话持久、记忆可积累,越用越懂你的上下文
- 权限分级可控:Read Only / Workspace Write / Full access
- 模型只管思考,脏活累活外壳全包
03 · 核心能力
四种运行模式,按需切换工作形态
Standard
标准模式
全套工具栈:文件、命令、浏览器、插件全开,日常任务的默认形态。
日常主力PTC
程序化模式
让模型生成 TypeScript 脚本串联复杂任务,逻辑固化、结果可复跑,不靠"临场发挥"。
批量处理 · 数据管道Minimal
极简模式
只保留 Shell 与编辑器的最小权限形态,适合受限环境与基准测试。
最小权限 · 基准测试Creative
创造模式
运行时调试插件、加载 Agent 预设模板——一边干活一边给自己造新工具。
边用边造模式定义综合自官方资料:GitHub README · AiTop100 工具页
04 · 插件体系
一切皆插件:159 个插件同时在线
这是我的 DSH 实例此刻的插件列表——从文件读写、定时器、热重载到 API 网关、多 Agent 调度,全部以插件形式运行在 Cordis 内核上。
插件彼此隔离、按需加载:装错了卸掉即可,能力坏了不拖累外壳。这套架构正是 DSH"方便扩展"的底座。
05 · 方便扩展
三步接入新能力:装、选、写
- 装:一条命令即装即用,无需重启工作流。
- 选:逛市场——社区插件站已收录 4120+ 个插件,浏览器控制、记忆系统、多智能体协作应有尽有。
- 写:会 TypeScript 就会写插件——订阅 Cordis 事件即可注入能力,配合 hmr 热重载,保存即生效。
我的实践:部署两周内通过以上方式装入了 ModLens、dsh-browser、Agent Teams 三个插件,全程未改动内核,也未重启已有会话——扩展不应该是一场手术。
来源:DSH 插件站 · GitHub README
06 · 容易切换模型
20+ 模型热切换,工作流不绑定任何一家
- 开箱支持 20+ 模型:DeepSeek、OpenAI、Claude、Kimi 等,设置页即时切换
- 任意 OpenAI 兼容端点:自定义 base URL + Key,中转、私有化部署全接
- 本地模型:Ollama 拉起即连,敏感数据不出本机
- 换模型不换心智:会话、插件、定时任务原样保留——模型是零件,外壳才是资产
来源:GitHub README · DataCamp
07 · 部署实录
Windows 部署踩坑:npm 不行就换源码
- 踩坑:npm 直装 @deepseek-ai/dsh 缺失十余个 peer 依赖(dsh-invariants / dsh-scope / dsh-fs…),dsh-logger 甚至 404。
- 换路:改为下载 GitHub 源码 zip——注意是 master 分支,不是 main。
- 构建:pnpm 11.22.0 全量构建,一次通过。
- 环境:Node v25.2.1,Windows 10,无需 WSL。
- 启动:浏览器打开本机 3080 端口即可使用。
→ http://127.0.0.1:3080
经验一句话:预览期项目的 npm 包常缺依赖,遇到安装报错别死磕,直接切源码构建更快。本实录完成于 2026-08-16,当日部署、当日投产。
08 · 知名插件盘点
社区里这些插件,值得先装为敬
ModLens
视觉桥:图片 OCR + 版面理解 + 语义分析,让 Agent"看懂"截图与文档(modlens_read_image)。
dsh-browser
Chrome 侧边栏里让 Agent 直接操控浏览器:查资料、填表单、抓页面,所见即所操作。
dsh-agent-teams
多智能体团队:队长拉群拆任务,成员之间直接互发消息,复杂工程并行推进。
dsh-web-ui5.4k★
社区皮肤与数据看板,把工作台颜值和可视化能力一次拉满。
DSH-better-sidebar2.6k★
侧边栏增强,会话导航与快捷操作效率翻倍。
MemOS10.9k★
长期记忆系统:跨会话沉淀偏好与上下文,Agent 越用越懂你。
dsh-background-agents
持久化后台子 Agent:关掉窗口也继续干活,长任务不再守夜。
来源:DSH 插件站 · 博客园 · 12lisu · DeepSeekAgent.io 指南 · CSDN
09 · 实战场景
四个真实项目:从文档库到 60FPS 游戏
以下全部为 DSH 在我的 Windows 主机上完成的真实任务,数据取自本机使用记录。
CASE 01 · 实战场景
电子书整理归类 + 蒸馏
- 六大类入库 3800+ 本:A01 文学小说 1033 本 / 5.79GB · A02 人文社科 466 本 · B01 历史传记 1269 本 / 31.8GB · B02 政治法律 238 本 · C01 经济商业 527 本 · C02 心理学 348 本
- 主题级细分:儿童文学 377 / 推理悬疑 151 / 国学 188 / 哲学 166 / 社会学 112……按内容语义而非文件名乱堆
- 「蒸馏」:批量抽取书籍结构,产出可检索的目录清单,找书从"翻文件夹"变成"查大纲"
- 重复文件、损坏文件在扫描阶段即被标记清理
CASE 02 · 实战场景
照片整理:按时间与地点重建相册
- 自动建层级:2026-08 泉州游 / 第一天 8-13 / 承天寺、元妙观……按旅行日程与地标逐级归类
- 归类依据:文件名语义 + 拍摄时间 + 原有子文件夹结构,交叉判断后批量移动
- 全程免拖拽:几千张照片一次性完成,事后逐目录抽查即可验收
- 整理结果即目录树,任何相册软件、NAS 都能直接读
CASE 03 · 实战场景
WFO 考勤 App:AI 亲手写的每日工具
- 需求一句话:"帮我做一款到岗定位打卡的安卓 App"——两天前在会话历史里输入,今天每天都在用
- 每天 5 个检测点:9:30 / 10:00 / 11:00 / 14:00 / 17:00,每点连续多次定位取稳定值,半径 999 米内判定到岗
- 完整闭环:地图选点(23.133934, 113.331832)→ 定时检测 → 日历可视化 → 日志可回溯
CASE 04 · 实战场景
方块世界游戏:会话历史里的那句"我的世界"
- 需求一句话:"帮我做一款类似我的世界的安卓游戏"——从空会话到可玩版本,全程由 DSH 在本机完成
- 体素世界:程序化地形 + 海洋生成,手机端稳定 60FPS
- 完整玩法:生命 10/10 · 任务系统(草 0/2 · 泥土 0/4)· 得分 · 方位罗盘 · 放/挖/跳触控
10 · 经验小结
两周深度使用,六条实战心得
先给外壳,再谈智能
模型从来不缺聪明,缺的是手脚。Harness 补上读写、执行、调度,聊天才变成做事。
插件生态省轮子
装 159 个插件,远比自己造 159 个功能快。先逛市场,再动手写。
模型可换,心智不变
工作流沉淀在外壳里,不绑定任何一家模型。今天 DeepSeek,明天任何兼容端点。
权限分级要当真
Read Only 起步,Workspace Write 日常,Full access 只给高价值会话——外壳越能干,越要管住它。
从真实需求出发
日历、考勤、游戏——能每天用上的才是好 Demo。实战不是炫技,是替自己干活。
验收标准说清楚
需求越具体,一次成型的概率越高。"帮我做个 App"不如"五点检测、半径一公里、日历蓝点"。
11 · 结尾
"Everything is a Plugin."
给模型一个外壳,它还你一个同事。
本页引用与延伸阅读: