DeepSeek Harness · 使用者实战复盘

DSH 深度实战
与经验分享

给大模型套上一个能做事的外壳 —— 背景、插件生态与四个真实项目

  • 2026-08-29
  • doc.kinaze.cn · 技术分享
  • 16 页 · 约 10 分钟
  • 数据来自本机真实使用记录

使用 空格 翻页,右下角可打开目录

01 · 背景介绍

DSH 是什么:Agent = Model + Harness

DSH(DeepSeek Harness)是 DeepSeek 开源的 Agent 运行框架。模型只负责思考与决策,Harness 负责"动手"——读写文件、执行命令、联网检索、定时任务、持久会话,把语言模型的输出变成真实世界里发生的事。

Agent = Model+Harness
  • 2026-08-13 随 DeepSeek V4 Pro 开源
  • MIT License
  • TypeScript
  • 开发者预览版
  • Cordis 微内核 · 北大 × DeepSeek 联合研发

"Everything is a Plugin."

内核只保留事件总线与生命周期管理,其余一切能力都是插件:文件系统、终端、浏览器、定时器、API 网关……随装随用、随卸随走。

Cordis 内核带来三个工程性质:插件即事件订阅、进程级隔离、支持热插拔。能力坏了不影响外壳,外壳升级不打扰能力。

资料:GitHub README(中文) · DataCamp 教程 · 掘金 · aicoding

02 · 核心理念

给 LLM 套上能做事的外壳

裸模型:

只能输出文本,每次对话从头开始,碰不到你的文件和系统;人是"人肉执行器",把 AI 的答案复制粘贴到真实世界。

套上 DSH:

  • 直接读写文件、执行命令、联网检索、设定时任务
  • 会话持久、记忆可积累,越用越懂你的上下文
  • 权限分级可控:Read Only / Workspace Write / Full access
  • 模型只管思考,脏活累活外壳全包
DSH 主界面:探索未至之境预览版,右侧为权限菜单,左侧为会话历史列表
DSH 主界面「探索未至之境(预览版)」:右上角权限三级开关(Read Only / Workspace Write / Full access),左侧是跨项目的会话历史——包括两天前"帮我做一款类似我的世界的安卓游戏"这样的真实任务。

03 · 核心能力

四种运行模式,按需切换工作形态

Standard

标准模式

全套工具栈:文件、命令、浏览器、插件全开,日常任务的默认形态。

日常主力

PTC

程序化模式

让模型生成 TypeScript 脚本串联复杂任务,逻辑固化、结果可复跑,不靠"临场发挥"。

批量处理 · 数据管道

Minimal

极简模式

只保留 Shell 与编辑器的最小权限形态,适合受限环境与基准测试。

最小权限 · 基准测试

Creative

创造模式

运行时调试插件、加载 Agent 预设模板——一边干活一边给自己造新工具。

边用边造

模式定义综合自官方资料:GitHub README · AiTop100 工具页

04 · 插件体系

一切皆插件:159 个插件同时在线

这是我的 DSH 实例此刻的插件列表——从文件读写、定时器、热重载到 API 网关、多 Agent 调度,全部以插件形式运行在 Cordis 内核上。

159
我的实例已启用插件
4120+
插件市场收录数量

插件彼此隔离、按需加载:装错了卸掉即可,能力坏了不拖累外壳。这套架构正是 DSH"方便扩展"的底座。

插件市场:DSH 插件站(1024Store 收录 4120 个)

DSH 插件列表界面,显示 include、timer、hmr、llm、session、api-gateway、agent、jobs-local 等已启用插件
我的插件列表:include / timer / hmr / llm / session / typert-loader / api-gateway / agent / jobs-local……共 159 个处于启用状态。

05 · 方便扩展

三步接入新能力:装、选、写

  1. :一条命令即装即用,无需重启工作流。
  2. :逛市场——社区插件站已收录 4120+ 个插件,浏览器控制、记忆系统、多智能体协作应有尽有。
  3. :会 TypeScript 就会写插件——订阅 Cordis 事件即可注入能力,配合 hmr 热重载,保存即生效。
$ dsh plugin --profile web add <plugin-name>

我的实践:部署两周内通过以上方式装入了 ModLens、dsh-browser、Agent Teams 三个插件,全程未改动内核,也未重启已有会话——扩展不应该是一场手术。

来源:DSH 插件站 · GitHub README

06 · 容易切换模型

20+ 模型热切换,工作流不绑定任何一家

DSH 设置页的模型列表:DeepSeek 官方、Ollama 本地自定义、Dots API 自定义端点
我的模型设置页:DeepSeek 官方(绿点在线)、Ollama 本地自定义、Dots API 自定义端点——三路模型并存,界面里点一下即完成切换。
  • 开箱支持 20+ 模型:DeepSeek、OpenAI、Claude、Kimi 等,设置页即时切换
  • 任意 OpenAI 兼容端点:自定义 base URL + Key,中转、私有化部署全接
  • 本地模型:Ollama 拉起即连,敏感数据不出本机
  • 换模型不换心智:会话、插件、定时任务原样保留——模型是零件,外壳才是资产

来源:GitHub README · DataCamp

07 · 部署实录

Windows 部署踩坑:npm 不行就换源码

  1. 踩坑:npm 直装 @deepseek-ai/dsh 缺失十余个 peer 依赖(dsh-invariants / dsh-scope / dsh-fs…),dsh-logger 甚至 404。
  2. 换路:改为下载 GitHub 源码 zip——注意是 master 分支,不是 main。
  3. 构建:pnpm 11.22.0 全量构建,一次通过。
  4. 环境:Node v25.2.1,Windows 10,无需 WSL。
  5. 启动:浏览器打开本机 3080 端口即可使用。
$ npx @deepseek-ai/dsh web
→ 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

CASE 01 · 实战场景

电子书整理归类 + 蒸馏

Typora 中打开的《电子书库目录清单》大纲视图,列出 A01 文学小说、A02 人文社科、B01 历史传记等分类与数量
《电子书库目录清单》的 Typora 大纲视图:由 DSH 批量扫描全盘电子书后自动生成、可持续增量维护。
一句话需求 → 全盘归档
  • 六大类入库 3800+ 本:A01 文学小说 1033 本 / 5.79GB · A02 人文社科 466 本 · B01 历史传记 1269 本 / 31.8GB · B02 政治法律 238 本 · C01 经济商业 527 本 · C02 心理学 348 本
  • 主题级细分:儿童文学 377 / 推理悬疑 151 / 国学 188 / 哲学 166 / 社会学 112……按内容语义而非文件名乱堆
  • 「蒸馏」:批量抽取书籍结构,产出可检索的目录清单,找书从"翻文件夹"变成"查大纲"
  • 重复文件、损坏文件在扫描阶段即被标记清理

CASE 02 · 实战场景

照片整理:按时间与地点重建相册

需求:把 H:\6.照片 重新归档
  • 自动建层级2026-08 泉州游 / 第一天 8-13 / 承天寺、元妙观……按旅行日程与地标逐级归类
  • 归类依据:文件名语义 + 拍摄时间 + 原有子文件夹结构,交叉判断后批量移动
  • 全程免拖拽:几千张照片一次性完成,事后逐目录抽查即可验收
  • 整理结果即目录树,任何相册软件、NAS 都能直接读
文件管理器中展示泉州游照片按第一天 8-13 与承天寺、元妙观等地标建立的子文件夹结构
整理后的目录树:泉州游 → 第一天 8-13 → 按承天寺、元妙观等地标分文件夹,行程与地点一目了然。

CASE 03 · 实战场景

WFO 考勤 App:AI 亲手写的每日工具

WFO App 出勤日历页面,2026 年 8 月的 3、4、17、18、24 日带有蓝点标记
出勤日历:到岗日蓝点标记
WFO App 检测设置页面:9:30、10:00、11:00、14:00、17:00 五个检测时间点,半径 999 米,纬度 23.133934
检测设置:五个时间点 + 判定半径
WFO App 地图选点页面,定位在广州天河太古汇附近,坐标 23.133934, 113.331832
地图选点:办公位置(广州·天河)
WFO App 运行日志页面,共 73 条记录,包含闹钟触发、定时检测、距办公室距离等信息
运行日志:73 条,含「距办公室 18221m」
  • 需求一句话:"帮我做一款到岗定位打卡的安卓 App"——两天前在会话历史里输入,今天每天都在用
  • 每天 5 个检测点:9:30 / 10:00 / 11:00 / 14:00 / 17:00,每点连续多次定位取稳定值,半径 999 米内判定到岗
  • 完整闭环:地图选点(23.133934, 113.331832)→ 定时检测 → 日历可视化 → 日志可回溯

CASE 04 · 实战场景

方块世界游戏:会话历史里的那句"我的世界"

方块世界游戏画面:体素地形、生命值 10/10、任务草 0/2 泥土 0/4 与得分显示
世界探索:体素地形 + 状态栏
方块世界游戏画面:方位罗盘与放、挖、跳触控操作按钮
操作界面:罗盘 + 放/挖/跳
方块世界游戏画面:程序化生成的地形与海洋,帧率 60FPS
地形生成:程序化地形与海洋
  • 需求一句话:"帮我做一款类似我的世界的安卓游戏"——从空会话到可玩版本,全程由 DSH 在本机完成
  • 体素世界:程序化地形 + 海洋生成,手机端稳定 60FPS
  • 完整玩法:生命 10/10 · 任务系统(草 0/2 · 泥土 0/4)· 得分 · 方位罗盘 · 放/挖/跳触控

10 · 经验小结

两周深度使用,六条实战心得

01

先给外壳,再谈智能

模型从来不缺聪明,缺的是手脚。Harness 补上读写、执行、调度,聊天才变成做事。

02

插件生态省轮子

装 159 个插件,远比自己造 159 个功能快。先逛市场,再动手写。

03

模型可换,心智不变

工作流沉淀在外壳里,不绑定任何一家模型。今天 DeepSeek,明天任何兼容端点。

04

权限分级要当真

Read Only 起步,Workspace Write 日常,Full access 只给高价值会话——外壳越能干,越要管住它。

05

从真实需求出发

日历、考勤、游戏——能每天用上的才是好 Demo。实战不是炫技,是替自己干活。

06

验收标准说清楚

需求越具体,一次成型的概率越高。"帮我做个 App"不如"五点检测、半径一公里、日历蓝点"。

11 · 结尾

"Everything is a Plugin."

给模型一个外壳,它还你一个同事。

本页引用与延伸阅读:

01 / 16