配置仓库管家 prgrmrwy/ohmydsh

ohmydsh

一个仓库，聚合、审查并持续迭代管理你的 DeepSeek Harness（DSH）全部配置——从加入插件到移除插件。

English · 简体中文 · 快速开始 · 插件索引 · 贡献 · 安全 · 更新日志

它做什么

ohmydsh 把一个人的 DSH 配置收敛成一个可审查、可复现的仓库，并管理它的完整生命周期：加入插件、审查其信任面、固定精确版本、物化到位、之后升级、需要时禁用（而不丢失）、最终移除。

- 仓库是唯一真相源。 定义你这套环境的一切都在这里：manifest、自研 package、skill、preset、patch 与环境级 Agent 指令。
- ~/.dsh 是生成的产物。 dsh build 把仓库幂等地物化进去；不要手改它，改仓库再 build。
- dsh.yaml 是唯一开关面。 DSH 版本、自动更新策略和每一项定制都在这里声明；enabled: false 只禁用、不删除。

两类读者，两个入口：

- 想管理自己 DSH 的人或 AI——从快速开始和架构读起。
- 想知道自研插件解决什么问题的人或 AI——直接看插件索引。

快速开始

初始化要求 Node.js 22+、npm 10+；.nvmrc 是推荐版本，不要求精确相等。启动器在 Windows、macOS、Linux 共用一套 Node 实现，Windows 不要求 Git Bash。三端隔离的构建与 Host 命令流程已验收，真实终端关闭和桌面 UI 仍待验证，详见三端验收记录；这不等于全部第三方插件的 Windows 功能认证。三条路径任选其一。

原生 Windows 含中文路径时请使用已验证的 Node.js 24.20.0（当前 .nvmrc 推荐版本）。24.12.0 存在同步删除静默失败的问题，可能导致 pnpm 替换插件目录时报 EPERM。本轮验收使用 pnpm 11.7.0；首次构建若提示依赖构建脚本策略未决，需逐项明确允许或拒绝，再重跑 dsh build。

路径一：照抄我的完整配置

git clone https://github.com/prgrmrwy/ohmydsh.git
cd ohmydsh
node scripts/bootstrap.mjs # 检查最低版本，必要时执行根 lock 的 npm ci
npm link # 注册仓库 bin；不代替依赖初始化
dsh build # 物化配置
dsh # 启动 DSH

Windows 的 cmd 和 PowerShell 都可逐行执行上述相同命令。npm link 在 npm 全局 prefix 生成 dsh.cmd / dsh.ps1，须把该 prefix 加到 PATH；若执行策略阻止 ps1，使用 npm.cmd link、dsh.cmd build 和 dsh.cmd，不要降低全机器执行策略。POSIX 全局 bin 在 <prefix>/bin。用 npm prefix -g 与 where.exe dsh / command -v dsh 排查官方同名命令冲突，不用 --force 覆盖无关 bin；npm unlink --global ohmydsh 撤销当前 link。旧 POSIX install/bootstrap 只保留薄兼容入口。

POSIX start/stop/restart 要求 lsof、ps（用系统包管理器安装 lsof），缺探测工具时在启动/停止前拒绝；Windows 使用系统 PowerShell TCP/CIM 查询，仅强制停止再次核验归属的进程树，不保证优雅刷盘。显式 DSH_BIN 是单个可执行路径：Windows 支持 JS 入口或原生 .exe，拒绝 .cmd/.bat/.ps1 shim 与命令字符串，应指向真实 JS CLI。

路径二：挑选部分

先走路径一，再裁剪 dsh.yaml：不想要的条目设 enabled: false（仓库里保留，随时可重新启用），或者直接删除该条目。add-dsh-plugin 与 remove-dsh-plugin 两个 skill 会替你改 manifest、执行 dsh build，并在重启前询问你。每次改动后再跑一次 dsh build。

路径三：从零开始

把 dsh.yaml 替换为下面的最小 manifest，然后执行 dsh build。不引入任何新命令、脚本或模板文件。

dshVersion: 0.2.0-rc.2
autoUpdate:
enabled: false
customizations: []

autoUpdate.enabled 必须显式写成 false：缺省时自动更新默认开启，启动器会自行改写 dsh.yaml 并自动提交。

dsh reset 不是从零开始的方式。它只撤销 ~/.dsh 中的定制部署，manifest 保持不变，dsh build 即可恢复。

交给 AI agent 来做

把下面的 prompt 交给你的 agent。它会先问你选哪条路径，然后遵守这些护栏。

你要安装 ohmydsh（一个 DSH 定制仓库）。请严格按下列规则执行（规则标签保持英文）：

1. [ASK-PATH] 先问我选哪条路径：(1) 照抄完整配置，(2) 挑选部分，(3) 从零开始。我回答之前不要做任何操作。
2. [VERIFY-IDEMPOTENT] 每次改动后连续运行两次 dsh build，第二次必须报告没有变化；否则停下并向我汇报。
3. [NO-DEPLOY-EDIT] 绝不手改 ~/.dsh 下的任何内容；改 dsh.yaml 或仓库源码，然后运行 dsh build。
4. [NO-SECRETS] 绝不把凭据写进 manifest、命令参数或聊天；密钥只能放在 .env.local。
5. [STOP-ON-FAIL-CLOSED] sync 因 fail-closed 报错（例如 AGENTS.md 漂移）时，停下并原样汇报错误，绝不通过删除文件来绕过。
6. [ASK-RESTART] 重启 DSH 之前先问我。在 DSH 会话内执行 dsh restart 会断开该会话，返回 0 只表示已排程；重连后用 dsh history 验证。

命令速查

dsh build 把 dsh.yaml 物化进 ~/.dsh，不启动
dsh stop 停止正在运行的 DSH
dsh restart 停止、等端口释放、再启动（会话内：先排程，再脱离会话执行）
dsh reset 撤销定制部署（manifest 不变）
dsh history 查看历次启动及其加载的插件
dsh plugin-update 检测远端插件、确认、改 dsh.yaml、build、提交
dsh doctor 检查并补齐本机运行前提

架构

ohmydsh 架构图：仓库真相源、sync、~/.dsh、DSH 运行时

心智模型

仓库声明「应当安装什么」。scripts/sync.mjs（由 dsh build 调用）让 ~/.dsh 与之一致，遇到无法证明的状态就 fail closed，第二次运行不产生任何变化。DSH 随后像加载任何部署一样加载 ~/.dsh。

定制从哪里来

| 来源 | 声明方式 | 示例 |
| 第三方 npm 包 | source: remote，精确版本 pin | width-tiers |
| 官方可选 bundle | source: remote，与 DSH 版本同 pin | experimental-schedule |
| 本仓库自研 package | source: local，代码在 packages/<id>/ | dsh-memex |
| 独立仓库自研 package | source: remote，GitHub release 压缩包 | dsh-cockpit-bridge |
| Skill | type: skill，skills/<id>/ | ws |
| Patch | type: patch，patches/<id>.yml | connection-webserver |
| Preset | type: preset，presets/<id>/ | dsh-pet-executor |
| 第三方资源 | thirdPartyResources，带 integrity 的 pin | spec-superflow |

目录结构

dsh.yaml 唯一开关面 instructions/ 环境级 Agent 指令 packages/<id>/ 自研 DSH package skills/<id>/ 同步到 ~/.dsh/skills 的 skill presets/<id>/ Agent preset patches/<id>.yml composition patch 与覆盖 scripts/ sync、build、升级与维护脚本 openspec/ 规范与变更：行为先写清楚再实现 docs/ adr/ 决策、architecture/ 机制、assets/ 图 tests/ 仓库级测试

生命周期

ohmydsh 定制生命周期：加入、审查、固定、物化、验证、升级、禁用、移除

每项定制都走同一个循环：加入条目、审查来源与信任面、固定精确版本、物化、验证第二次 build 没有变化，升级就是重走一遍循环。最后禁用它，或删除条目再 build 以卸载。

私有 overlay

不能公开的条目（内部 package、与本机相关的 patch）放进被 gitignore 的 overlay。它与公开条目走同一套校验，并且只能追加。详见私有 overlay。

更多机制：环境级 Agent 指令与 DSH 插件集成陷阱（接入宿主能力前先读）。

多机器

每台机器做同样两件事：clone 本仓库（以及你可选的私有 overlay），然后运行 dsh build。

dsh-cockpit 让你在一处管理和查看多台机器，但不分发配置；配置由本仓库负责。

你的配置

- dsh.yaml 才是真相，读它，不要读 ~/.dsh。
- node scripts/plugin-list.mjs 打印实际加载了什么。
- 私有 overlay（dsh.yaml.local，或 DSH_LOCAL_MANIFEST 指向的文件）用来追加不能公开的条目。
- .env.local（被 gitignore）仅保存字面单行 KEY=VALUE 设置和密钥，不执行 Shell。含空格/反斜杠路径需引用，以绝对路径代替 $HOME / ~；支持空行、整行注释、可选 export、空值和 CRLF。拒绝 $、反引号、多行值、裸操作符和行内注释，诊断只报脱敏行号。单引号完全字面，双引号仅解码 \\ 与 \"。文件覆盖启动器继承环境，但调用者显式 DSH_BIN 优先。裸 sync/plugin-list 共享解析器，仍保留窄白名单、调用者优先与忽略无关坏行的兼容策略，启动器刻意更严格；迁移不会改写真实文件。
- thirdPartyResources 固定那些不是插件的资产：spec-superflow 工作流 skill、Jev MCP 服务（其 TYPESAFE_API_KEY 只从 .env.local 读取，绝不进 manifest）和 Anvil OpenSpec schema。

插件索引

dsh.yaml 中所有已启用的条目，按来源分组。第三方条目链接到上游；自研条目链接到本仓库内的目录。

第三方 package

- archify-dsh — 在对话中生成可交互的架构图、时序图与数据流图。
- llm-subscriptions — 增加订阅制 provider（Codex、Claude、Grok、Copilot），可在输入框切换。
- width-tiers — 在五档之间切换对话区宽度。
- better-sidebar — 把侧边栏变成服务化的多标签工作台。
- dsh-opencode-session-header — 发送 OpenCode Go 要求的会话头，修复缺少会话 ID 的报错。
- michengai-btw — 增加 /btw 旁问：只依据当前上下文一次性作答，不执行工具，也不写回主会话。暂时从 fork 的 release 安装上游 MichengAI/dsh-btw 的 PR #16 构建。
- dsh-magpie-connect — 把 Magpie AI 网关的模型接入模型选择器，与直连 provider 并存。

官方可选

- experimental-schedule — 官方的定时自动化页面、schedule 工具与时间上下文。

第三方资源

- spec-superflow — 面向规划式、规范驱动变更的状态机工作流 skill。
- jev — 为 agent 提供语义判断工具的 MCP 服务；密钥只放在 .env.local。
- anvil — 测试先行变更流程的 OpenSpec schema。
- ponytail — 纯提示词 skill：最小改动、抑制膨胀的编码模式，以及配套的评审与审计命令。

改造自第三方的 skill

- i-have-adhd — 答案优先、短步骤的输出模式，仅在用户明确要求时使用。
- frontend-design — 避免千篇一律、默认脸界面的前端设计指引。
- eli5 — 按指定受众的理解水平解释任何主题。

自研 package

- worktree-session — 会话首条消息时创建隔离的任务分支与 worktree。
- dsh-openspec — 把官方 OpenSpec 工作流以 skill 与命令形式暴露的受管适配器。
- dsh-memex — 原生持久记忆，按工作区隔离作用域，并提供记忆设置页。
- dsh-pet — 常驻的桌宠 agent，在可信快照上运行管理类 skill。
- sidebar-session-provider-icon — 在侧边栏每个会话行显示当前所选模型的品牌 logo。
- session-title-copy — 在标题旁加一个短 session id 徽标，点击复制完整 id。
- system-clock — 在设置底部显示 DSH 主机的时钟、时区与 hostname。
- sidebar-session-resources — 把当前会话的链接与产出文件汇总到侧栏面板。
- home-network-model-guard — 主机出口位于受限地区时，在输入框禁用 Claude 系列模型。
- subscriptions-sandbox-shim — 为订阅 provider 剥离 sandbox 升级字段并清理孤立的工具调用。
- dsh-magpie-connector — 把自托管 Magpie 网关按上游归属接入为多个真实 provider route（原版 DSH 即显示 Magpie (Claude)、Magpie (Codex) 等分组），支持多线路自动选线（在家 LAN、在外公网/Cloudflare Access；按线路 key/Access），用量卡片按上游 provider 分组，支持可见性、默认 effort 与会话级快速档。
- cockpit-worktree-open-shim — 把驾驶舱的远程编辑器接入 Worktree Session 的打开动作。
- cockpit-memex-browse-shim — 把驾驶舱的端口转发接入记忆卡片浏览。
- dsh-collab — 让已有的独立会话通过邀请共享协作台账，并在下一回合唤醒成员。
- auto-model-routing — AUTO 下每回合请 Jev 决策模型判档，只调整推理强度；Jev 任何失败即停用 AUTO 并提示原因。独立仓库。

自研 skill、preset 与 patch

- case-verify — 从独立 oracle 构造浏览器验收 trail，记录只追加、精确关联的证据；可信可执行 adapter 可接入外部用例和报告输出。
- ws — 查看、提升并清理 Worktree Session 绑定。
- jev-workflow-router — 流程选路 advisory：到达「直接改还是开 change」决策点时给一行可无视的建议，不阻断、不自动执行。
- memex-recall-report — 统计记忆召回情况，并列出从未被召回的卡片。
- memex-eval — 运行或读取 memex 固定虚构自检；只检查评估链路，不是有效性评估。
- weekly-insights — 类似 Claude Code /insights 的本地会话复盘：流式读取会话日志，逐会话打标签并缓存，生成带改进建议的 HTML 报告。
- publish-dsh-plugin — 内聚自研插件发布 SOP：README、自动镜像、npm 与 GitHub Release、商店验收。
- add-dsh-plugin — 把远端插件加入 manifest、build，并在重启前询问。
- remove-dsh-plugin — 从 manifest 移除插件、build，并在重启前询问。
- dsh-sandbox-notes — 关于 sandbox 权限与「not strictly wider」报错的避坑笔记。
- subagent-model-routing — 委派前调用 route_subagent 并显式传入模型与 effort；失败时暂停并询问用户。
- dsh-pet-executor — 不加载全局 skill provider 的 Pet 执行会话 preset。
- memex-eval-judge — memex 自检裁判专用的最小 preset，只含 native 呈现，不带编码工具。
- memex-eval-config — 添加固定自检目录的关闭声明，保留用户 scope 与工作区设置。
- connection-webserver — 恢复 Connection RPC 通道注册的 composition patch。
- dsh-collab-config — dsh-collab 配置补丁：邀请即授权，并声明 pet-locus 托管 channel，供 Pet Locus 以代理成员接入。
- home-network-model-guard-config — 配置补丁：按真实 provider id 逐个列出 Magpie 各归属 route（dsh-magpie-connector-<owner>），使其不受本机出口门禁约束。
- ponytail-skills — 只为 ponytail 包挂载专属 skill provider 的 composition patch。
- websocket-heartbeat — 配置补丁：把官方 gateway 的 WebSocket 心跳放宽到 5 秒，使大体量历史在短暂网络抖动时不被断开。

自研（独立仓库）

- dsh-cockpit-bridge — DSH 与 dsh-cockpit 多机器管理器之间的桥接，从 GitHub release 安装。

贡献

欢迎提 issue 与 pull request，请先读 CONTRIBUTING.md，以及 SECURITY.md 和 CODE_OF_CONDUCT.md。行为变化走 OpenSpec change。修改 README.md 时必须在同一次提交里同步修改 README.zh.md，反之亦然。

许可证

MIT。第三方插件保留各自的许可证，上游链接见插件索引。