dsh-open-ecosystem

面向 DeepSeek Harness (dsh) 的开源集成与适配集合： 桌面壳、通用工具插件、环境适配脚本与生态调研材料。

所有组件均为纯集成层：不修改 DSH 源码，只以插件 / 脚本 / 配置的方式挂载或封装， 卸载即完全还原。DSH 处于 developer preview，破坏性变更频繁，各组件标注了已验证的 @deepseek-ai/* 版本范围。

组件矩阵

组件	分类	说明	形态
dsh-desktop/	公开易复用	Electron 原生桌面壳：attach/spawn 双模式、无边框窗口、托盘、进程台账、排版注入	独立应用（Windows 已验证）
dsh-git-autoinit/	公开易复用	任意会话/工作区自动 git init + 缺省 .gitignore 回填，侧边栏 Git 面板始终可用	Cordis 插件（Host half）
skills/	公开易复用	工程纪律 skill 集（移植自 mattpocock/skills，适配 DSH）：grilling 设计树采访、tdd 红绿循环、diagnosing-bugs 六阶段调试、code-review 双轴评审、handoff 会话交接	DSH skills（SKILL.md）
opensource-plan.md	文档	全部集成操作的盘点、分类（公开/特化）与开源规划	文档
readmes/ · research_repos/ · report/	调研	dsh-plugin 生态扫描、6 类分类法、落地路线	材料

快速开始

dsh-desktop（桌面壳）

cd dsh-desktop
npm install
npm start          # 自持独立 dsh web + 无边框窗口
npm run dist       # 打包 portable + NSIS（Windows）

环境变量：DSH_DESKTOP_ATTACH=1 附着已有 :3080 服务；DSH_DESKTOP_DSH 指定 dsh 可执行文件； DSH_DESKTOP_NO_TYPO=1 关闭排版注入；DSH_DESKTOP_SMOKE=1 冒烟后自动退出。

dsh-git-autoinit（自动 git 初始化）

cd dsh-git-autoinit
npm install
# 在 web profile 挂载（本地路径）
dsh plugin --profile web add "link:$(pwd)"
# 或从 npm 安装（见下方 24 小时限制说明）
dsh plugin --profile web add dsh-git-autoinit

⚠️ npm 安装路径的 24 小时限制：pnpm 11 的供应链策略 minimumReleaseAge 会拒绝安装发布不足 24 小时的新版本。dsh-git-autoinit@0.1.1 发布于 2026-08-14 06:49 UTC，因此在 2026-08-15 06:49 UTC 之前，dsh plugin add dsh-git-autoinit 会被 pnpm 拦截（报 "minimumReleaseAge" 相关提示并回退到旧版本或失败）。 此限制自动过期，无需任何操作；到期后即可正常安装。若需立即安装，可手动把 dsh-git-autoinit@0.1.1 加入 profile 的 pnpm-workspace.yaml 的 minimumReleaseAgeExclude 列表（详见 docs/npm-publish.md）。

插件挂载后，对每个已有会话/工作区目录幂等执行 git init（已存在则跳过）， 并仅在目录无 .gitignore 时回填保守忽略规则。数据落盘见 ~/.dsh/desktop/processes.json 等。

工具脚本（skills）

各环境适配脚本位于 ~/.dsh/skills/<name>/scripts/（发布形态见 opensource-plan.md 的环境变量约定表），全部支持环境变量覆盖 个人路径，默认回退 $HOME 下通用目录。

工程纪律 skills（对齐→设计→实现→验证→评审）

本仓库 skills/ 收录 13 个工程纪律 skill（DSH 格式 SKILL.md，源自 mattpocock/skills 的设计哲学，适配本机）： 复制到 ~/.dsh/skills/<name>/SKILL.md 即可被 dsh 自动加载：

Skill	何时用	核心纪律
grilling	需求含糊 / 方案有分支 / 实现前	设计树采访：逐轮问 frontier，每个问题给推荐答案，事实自查
grill-with-docs	对齐 + 沉淀文档	grilling + 术语进 CONTEXT.md、决策进 ADR、需要时产原型
domain-modeling	构建/打磨领域模型	挑战术语、边界场景、就地更新 CONTEXT.md 与 ADR
to-spec	讨论完需求要产出规格	综合会话与代码库理解成规格，不访谈
to-tickets	拆解计划/规格为工单	曳光弹垂直切片工单 + 阻塞依赖（blocking edges）
codebase-design	设计/改进模块接口	深模块词汇（module/interface/seam/adapter/leverage/locality）
improve-codebase-architecture	架构巡检	扫描深化机会，HTML 报告呈现，逐条评审
prototype	快速验证设计问题	逻辑=单 HTML 演示 / UI=同路由多变体
tdd	复杂功能 / 修复缺陷	红灯→绿灯循环、seam 接缝预约定、垂直切片
diagnosing-bugs	硬 bug / 性能回退	先建 tight 反馈环 → 复现最小化 → 可证伪假设 → 插桩 → 回归
code-review	提交前 / 审查 PR	Standards + Spec 双轴并行子智能体，Fowler 坏味基线
research	调研 / 查证	后台子代理对照一手来源，结论落 Markdown 逐条引用
handoff	换会话 / 收尾交接	交接文档落临时目录、含建议技能、脱敏

环境变量约定

脚本	环境变量	默认回退
codex-net	NET_VPN_EXE / NET_PROBE_URLS	不自动拉起 VPN
deepseek-multi-agent	MULTI_AGENT_DIR / MULTI_AGENT_PY	$HOME\multi-agent-framework + PATH python
audio-transcribe	ASR_PYTHON / ASR_SCRIPT	PATH python + $HOME\.asr\asr.py
music-render-compose	MUSIC_DIR / MUSIC_PY / MUSIC_FS / MUSIC_SF	$HOME\music-workspace + PATH python

兼容性

• DSH：@deepseek-ai/dsh ^0.1.0-rc.6
• Cordis：@deepseek-ai/cordis ^4.0.1
• Node.js ≥ 20（dsh-desktop / git-autoinit）；脚本类需 PowerShell 5.1+（Windows）或对应引擎

生态兼容信号：装任何社区插件前建议查阅 awesome-dsh-plugins 的当日兼容矩阵。

贡献

见 CONTRIBUTING.md。

许可

MIT © dsh-open-ecosystem contributors。第三方调研材料版权归各自作者，引用时保留署名。