前言¶
DeepSeek Harness(DSH)把智能体能力拆成可组合的插件,并附带一套保守的参考配置。对日常写代码的人来说,这意味着你还要自己选 profile、接 MCP、配 LSP、处理网页抓取的安全边界,以及决定哪些上游能力该默认打开。
oh-my-dsh(OMD)由 amplifthq 维护,定位是 DSH 的精选发行版:在保留上游「一切皆插件」架构的前提下,用 overlay 方式叠加一组经过验证的默认选择与扩展能力,而不是 fork 上游仓库。DeepSeek Harness 目前仍处于 developer preview;OMD 会锁定经过测试的上游版本,避免静默追随破坏性变更。
这是什么¶
一句话:oh-my-dsh 是 DeepSeek Harness 的开箱即用精选发行版,Overlay,不是 fork。
- 维护者:amplifthq
- 分类:模型推理
- 许可证:MIT
- 当前版本:v0.1.7(SkillHub 目录页记录)
- GitHub 星标:11,fork:1
它解决的核心问题是:把 DSH 的插件框架和参考组合,装配成可直接工作的 coding 环境——含正式 profile、惰性 MCP 复用、LSP 导航、安全编辑、默认开启的 SSRF 加固网页抓取,以及经审批的技能蒸馏等能力。用户状态存放在 ~/.dsh/,上游架构和每项默认选择仍可被 profile 或 cordis.patch.yml 覆盖。
核心功能¶
下面按已公开文档归纳主要能力,均来自项目 README 与 package.json 导出项。
开箱即用的 coding profile¶
setup 后会在 ~/.dsh/profiles/ 安装两个隔离 profile:
omd:交互式 Web UIomd-headless:一次性终端任务
默认采用 workspace-write + ask 权限模型,不会静默获得完整主机权限。网页抓取默认开启,走 SSRF 加固 provider;启动目录自动注册为 workspace。
代码智能与编辑¶
内置 TypeScript/JavaScript、Python、JSON、HTML、CSS/SCSS/Less、YAML 的 language server;PATH 中存在时还会自动接入 rust-analyzer、gopls、clangd、sourcekit-lsp。
相关扩展包括:
- 上游
@file发现,以及带 anchor 的行范围快照(如@path:12-40) hash_edit:逐行 anchor 与文件版本守卫的安全多行替换semantic_refactor:可预览、可恢复的多文件 LSP 语义改名
复用已有 agent 配置¶
OMD 原地读取兼容配置,不复制或改写原文件,例如 AGENTS.md、CLAUDE.md、.cursorrules、各工具目录下的 skills,以及 Claude/Cursor/Codex 中的 MCP server 定义。MCP 在发现阶段保持惰性,只有 session 显式激活后才启动。
项目级 MCP、hooks 和导入 skills 需先信任 Git 根目录:
cd path/to/repository
omd trust add .
审批门控与能力分层¶
OMD 将能力分为 Core、Bundled optional、Curated integrations、User growth 四层。MCP 激活、插件装载、技能保存、调试启动等操作统一走 prepare → inspect → approve → commit → verify 流程,由 proposal_control 审批后才落地。
plugin_control 可按 id 装载随包审查过的插件(当前精选库含 dsh-skill-badge、dsh-pkg-info)。plugin_forge 允许 Agent 编写小型 dsh 插件,源码经审批后持久化到 forged-plugins/ 再挂载。skill_control prepare_save 可把验证过的流程蒸馏为持久 SKILL.md。
其他扩展¶
kernel:session 级持久 JavaScript/Python 状态web-guard:默认开启的 SSRF 加固网页抓取- 可选 DAP 调试(
OMD_ENABLE_DEBUG=1) eval_control、opt_control:评测与优化提议工作流capability_search:只读能力发现平面
安装与启用¶
SkillHub 目录页标注该插件「可安装」,版本 v0.1.7。官方推荐通过便携版安装脚本完成,无需系统 Node.js、npm 或 root 权限。支持 macOS arm64 与 Linux x64(glibc);原生 Windows 不支持,需在 WSL2 中使用 linux-x64 便携包。
便携版安装(推荐)¶
安装脚本始终跟随最新非预发布 GitHub Release:
curl -fsSL https://github.com/amplifthq/oh-my-dsh/releases/latest/download/install.sh | sh
omd setup
omd
若要固定已发布版本,在同一安装器 URL 上设置 OMD_VERSION:
OMD_VERSION=v0.1.7 curl -fsSL https://github.com/amplifthq/oh-my-dsh/releases/latest/download/install.sh | sh
引导脚本安装到 ~/.local/share/oh-my-dsh/,并在 ~/.local/bin/omd 创建命令链接。首次 omd setup 可能需要数分钟。
npm 安装(开发者)¶
需要本机 Node.js ^22.19.0 或 >=24.0.0:
npm install --global oh-my-dsh
omd setup
omd
不想全局安装时:
npx oh-my-dsh@latest setup
npx oh-my-dsh@latest
便携版与 npm 渠道共享 ~/.dsh/ 用户状态,但每个 profile 的 node_modules 同时只归一个渠道所有。
典型用法¶
安装并完成 setup 后,常用入口如下:
omd # 启动 Web UI
omd headless "修复失败的测试" # 运行一个任务后退出
omd setup # 安装或升级两个 profiles
omd update # 便携版:检查 stable 渠道并安装新版本
omd rollback # 便携版:切回保留的上一版本
omd doctor --verify # 校验当前版本文件 digest(便携版)
omd config # 输出最终 Cordis 组合
omd usage # 汇总已保存会话的 token usage
omd preset list # 查看精选 MCP 预设
omd preset enable context7 # 将预设加入惰性 MCP 目录
omd trust add . # 信任当前仓库的项目集成
omd dsh --help # 直接调用底层 dsh CLI
模型可在 Web Models 页面配置 DeepSeek 或上游多 provider adapter。网页抓取相关环境变量示例:
OMD_DISABLE_WEB_FETCH=1 omd # 彻底关闭 fetch 工具
OMD_WEB_FETCH_ALLOW_PRIVATE=1 omd # 允许访问私有/内网地址(仅限可信网络)
便携版支持前台更新与回滚,不触碰 ~/.dsh/ 中的用户数据:
omd update
omd rollback
omd doctor --verify
适用场景与注意¶
适合谁¶
- 想直接使用 DSH,但不愿从零拼装 profile、MCP 和安全默认值的用户
- 需要在保留上游插件架构的同时,获得 LSP、安全编辑、审批门控和技能蒸馏等增强能力的开发者
- 已有 Claude/Cursor/Codex 配置,希望惰性复用而非迁移的用户
使用前须知¶
-
权限模型:OMD 以当前 dsh 进程权限运行。插件激活后与 harness 同进程,拥有完整环境变量、文件系统和网络访问能力。安装前应阅读源码与 MIT 许可证,并理解
proposal_control审批即是信任决策。 -
平台限制:无原生 Windows 便携包;请在 WSL2 的 glibc 发行版(如 Ubuntu)中安装 linux-x64 版本,项目路径放在 Linux 文件系统(
~/...),避免/mnt/c/带来的性能与符号链接问题。 -
上游预览状态:DeepSeek Harness 处于 developer preview。v0.1.7 精确锁定上游
@deepseek-ai/dsh*0.1.0-rc.7;OMD 不会静默追随破坏性升级。 -
生态关系:DSH 社区目录 SkillHub 是独立站点,与 DeepSeek / 幻方无官方从属关系;
oh-my-dsh同样与 DeepSeek 无隶属或背书关系。 -
卸载:便携版卸载需手动删除
~/.local/share/oh-my-dsh和~/.local/bin/omd;~/.dsh/中的 profile、session、skills 不会被自动清除。
结尾¶
oh-my-dsh 把 DeepSeek Harness 的插件框架落成一套可直接工作的 coding 环境:overlay 而非 fork,默认选择与审批门控兼顾效率与安全,并支持更新、回滚与文件校验。若你正在评估 DSH 生态中的开箱即用方案,可从目录页和 GitHub 仓库入手核对版本与安装步骤。
- SkillHub 目录页:https://www.skillhub.cn/plugins/amplifthq/oh-my-dsh
- GitHub 仓库:https://github.com/amplifthq/oh-my-dsh