Oh-My-DSH

English | 简体中文

Oh-My-DSH 是一个面向 DeepSeek Harness（DSH）的个人插件综合包——灵感来自 Oh-My-Zsh：把自研的、经过实战验证的 DSH 插件集中在一个仓库，随取随用。

当前包含 4 个插件，覆盖 agent 编排、会话记忆、Web 界面三个维度：

快速开始（Quick Start）

前提：已安装 DeepSeek Harness，dsh CLI 可用。

# 1. 克隆本仓库
git clone https://github.com/nightBrise/Oh-My-DSH.git
cd Oh-My-DSH

# 2. 按需安装插件（见下方安装索引）

安装索引

四个插件采用不同的挂载方式，请按各自 README 操作：

各插件均以本地路径方式挂载即可；若个别插件后续单独发布到 GitHub，其 README 中也提供了 GitHub 安装方式。

插件详情（Plugins）

🐝 dsh-agent-swarm — 星型团队子代理编排

• 唯一委派入口：dispatch(type, prompt, options?)，type 为封闭白名单（explore / code / write / review），未知类型硬失败；同轮 fan-out 可并行（isConcurrencySafe）
• 档位路由：lite / standard / pro / ultra → 不同模型；provider/model 创建时钉死，零运行时漂移
• 工具边界：explore/write/review 白名单 fail-closed；review 另含只读 bash（git 检视 git diff HEAD）；code 全工具；全类型 deny 五类委派工具（防递归 + 星型团队）
• 人设库：10 个内置 persona 全文注入（或自由文本），目录 section 仅 root 可见
• 协议注入：委派入口 + 委托决策指南 + 档位决策规则 + 并行与复用纪律 + 验收闭环（maker/checker 分离）+ EARS 验收标准 + 失败处理 + 团队协议骨架，仅注入 root
• 稳定性：并发双上限 + 深度上限（maxActive / maxTeam / maxDepth）、熔断冷却、结构化输出、超时级联、摘要续写、标签与追溯审计
• 审计：dispatch.log 结构化审计行（派发 / result / error）
• 常驻成员：run_in_background=true 创建可续接子代理，send_message 续接、list_agents 枚举

📄 文档：docs/DESIGN.md（设计终稿）、docs/ARCHITECTURE-REVIEW.md、docs/COMPARISON-REVIEW.md 等

🧠 dsh-memory — 项目级跨会话记忆

• 会话 checkpoint：事件捕获 → 自适应阈值阶梯自动触发 → 模型增量更新 11 节快照（KEEP 协议）
• 压缩联动：compaction/end 后注入记忆 dump，压缩失败自动跳过
• Dream 整合：/dream 或 dream_now 工具 → 窗口化 checkpoint 收集 → LLM 整合 → 原子写回 MEMORY.md
• 历史检索：history_search（sessionQuery 索引，禁用时回退日志扫描）+ history_around（seq 锚定上下文）
• 项目级配置：.dsh-memory/settings.json（memory_config 工具 / /dshmem-config 命令）

🖥️ dsh-webui-enhance — Web GUI 增强

• Token 用量：供应商/模型双环形图、明细表、余额卡片（DeepSeek 实时查询）、近 30 天堆叠图
• 产物预览：点击产物 chip → 浏览器式标签卡片面板，支持图片 / Markdown / HTML（iframe 沙箱）/ 代码日志
• 详情栏分段：产物 / 团队两个分段（配合 badgeboard 渲染子代理团队），开合状态暴露给配套插件
• 图片自动识别：文字模型对话中用户图片自动调用视觉模型结构化识别并以文本注入（模型列表由用户自配，支持多模型 + 默认选择，未配置时关闭），同图缓存 10 分钟
• Deep 文案池：60 条生成状态文案随机换词，渐变 shimmer 动画
• @文件提及：输入框 @ 触发工作区文件模糊搜索，插入路径后模型自行读取
• 会话删除：两段确认，物理清理 ~/.dsh 下会话日志
• 宽度自适应：消息列、输入框、用户气泡随窗口自适应（上限 1280px）

🏷️ dsh-badgeboard — 子代理工牌板

• 中栏右缘悬浮胶囊：在线头像栈（工作中排前、空闲压暗、呼吸状态点、职级色环），hover 弹出信息卡
• details 栏「团队」分段：成员列表 + 展开工牌大图（A/B/C 三风格切换）+ 档案字段 + 「在目录中打开」
• 点击成员跳转子代理视图：快照推导直接父地址，键盘可达
• 指派后自动弹右侧栏：检测到新增子代理 → 刷新目录 + 打开详情栏（幂等，seatReady 前置，仅本会话内新增派发触发）
• 重启自愈：目录缺失或未就绪时主动 refreshSubagents 恢复成员（重启后胶囊不消失）；成员数据目录 entries 优先 + 会话层补充
• 随机线稿头像：FNV-1a 种子哈希（subagent_id）→ 6 要素池确定性生成（14,336 组合），同人同脸、零资产管道
• 跨包契约：依赖 webui-enhance 更新版的 details 栏分段；Host 档案 RPC POST /dsh-badgeboard/badge-team/*

📄 完整设计：dsh-agent-swarm/docs/BADGE-BOARD-SPEC.md（v0.2.13）

仓库结构（Repository Layout）

Oh-My-DSH/
├── README.md               # 本文档（中文）
├── README.en.md            # English README
├── LICENSE                 # MIT © 2026 nightBrise
├── dsh-agent-swarm/        # 插件 1：星型团队子代理编排
│   ├── lib/index.js        #   插件主体（ESM）
│   ├── config.yaml         #   上传模板配置（模型档位 / 人设池 / 上限）
│   ├── model-router.local.yaml  # 本地私有配置（.gitignore 排除，不提交）
│   └── docs/               #   设计 / 架构审查 / 对比 / 维护路线图
├── dsh-memory/             # 插件 2：项目级跨会话记忆
│   ├── lib/index.js
│   ├── cordis.patch.yml    #   bundle patch：自动插入插件行
│   └── DESIGN.md
├── dsh-webui-enhance/      # 插件 3：Web GUI 增强
│   ├── lib/index.js        #   host 半：用量采集 / RPC 路由
│   ├── lib/client.js       #   client 半：React 组件 / fetch RPC
│   └── cordis.patch.yml
└── dsh-badgeboard/         # 插件 4：子代理工牌板
    ├── lib/index.js        #   host 半：dispatch 档案捕获 / RPC 路由
    ├── lib/client.js       #   client 半：悬浮胶囊 + 团队面板（内联头像生成器）
    ├── lib/avatar-gen.js   #   随机线稿头像生成器（规范模块）
    └── cordis.patch.yml

开发（Development）

各插件均为手写 ESM / 浏览器代码，无需构建，修改后重启 dsh 生效：

# 语法检查
node --check dsh-agent-swarm/lib/index.js
node --check dsh-memory/lib/index.js
node --check dsh-webui-enhance/lib/index.js
node --check dsh-webui-enhance/lib/client.js
node --check dsh-badgeboard/lib/index.js
node --check dsh-badgeboard/lib/client.js

• dsh-agent-swarm：配置热加载（每次 dispatch 现读），改 config.yaml 无需重启
• dsh-memory：本地联调需完成 profile bundle 三步安装（依赖链接），不要与旧动态插件版本同时保留
• dsh-webui-enhance：本地联调可用 dsh plugin --profile web add /path/to/dsh-webui-enhance
• dsh-badgeboard：依赖 webui-enhance 更新版（details 栏分段）；头像生成器为内联副本，改 lib/avatar-gen.js 后需同步 client.js 内联代码

License

MIT © 2026 nightBrise