趣味插件玩具箱 omdsh-dev/toybox

🧸 toybox —— DSH 插件玩具箱

正经插件与玩具插件都由 DSH Hub Workshop 按同一门禁收录；toybox 专门放有趣的小工具。
一个专门收藏“有意思”的 DeepSeek Harness (DSH) 插件的仓库：有趣的技能、古怪的 MCP 服务器、能讲段子的工具。每个插件都有源码、离线打包与协议验收标准——只是比正经插件多了一点灵魂。

版权：本仓库为独立插件项目，版权归作者（mattheliu）所有；仅包含原创插件代码，不包含 DeepSeek Harness 的实现源码。

当前可用性

五个 MCP 叶子包直接采用官方 MCP 2.0 SDK、2026-07-28 协议和 server.json 2025-12-11 schema；三个 Skill 是只做静态检查的直接 Skill。
pnpm verify 会逐个验证构建、精确打包面、MCP discovery/工具调用/进程失败与
重启，以及 Skill frontmatter、路径和危险命令模式。

这些是源仓门禁结果，不是 Workshop 的最终准入。每个叶子仍须绑定一个公开完整 commit，由 Workshop 在隔离环境重跑对应 adapter，经独立人工审核后才能显示为已验证；未经 admission 不进入安装 Registry。

🏠 住户（插件目录）

| 住户 | 类型 | 简介 | 状态 |
| code-archaeologist | skill | 代码考古学家：以田野考古方法论解剖遗留代码——地层判定、出土文物登记、发掘报告、保护性迁移建议。让“这代码为什么长这样”变成一场有证据的考古发掘 🏛️ | ✅ 本地静态验证 |
| almanac-mcp | mcp | 老黄历·今日宜忌：宜忌/冲煞/幸运方向（按天干五行推算，含星期彩蛋）、抽签（seed 可复现）、每日一诗。开工前先问一句“今日宜 merge 吗” 📜 | ✅ 本地协议验证 |
| naming-master-mcp | mcp | 取名大师：古风/赛博/极简/程序员梗四种风格给变量、函数、项目、宠物起名，带出处梗，起名困难症终极解药 📛 | ✅ 本地协议验证 |
| decision-dice-mcp | mcp | 决策骰子：抛硬币/掷骰/命运抉择，选择困难时的“天意裁决”，附经典决策技巧提示 🎲 | ✅ 本地协议验证 |
| chinese-colors-mcp | mcp | 中国传统色：61 色库（名称/HEX/典故）搜索、按日期“今日色”、按色系出和谐色板，前端配色秒变文化人 🎨 | ✅ 本地协议验证 |
| time-capsule-mcp | mcp | 时间胶囊：把想法封存，N 天后才能“挖出来”回看；未到期服务器拒绝泄露内容，写给未来的自己 ⏳ | ✅ 本地协议验证 |
| bug-tamer | skill | Bug 驯兽师：诱捕（最小复现）→ 驯化（根因）→ 放归（回归测试）→ 饲养手册（防复发），bug 修复方法论 🦁 | ✅ 本地静态验证 |
| code-talent-scout | skill | 代码星探：函数选秀 S/A/B/C 评级，四维评分卡 + 证据点评 + 回炉重造方案 🕵️ | ✅ 本地静态验证 |

表中“本地验证”表示源仓 RC.6 门禁通过，不等于 Workshop 已准入。

想入住？看 入住指南 —— 写 TS 源码 → pnpm build → README 加一行，完事。

📦 固定源码身份

提交 Workshop 时必须把仓库、完整 40 位 commit 与叶子路径一起固定；下面是身份记录，不是可直接执行的安装配置：

- id: almanac-mcp
repository: https://github.com/omdsh-dev/toybox
commit:
path: plugins/almanac-mcp/.dsh-plugin

各插件发布 ref（本仓库每个 commit 都是不可变身份，更新插件 = 换 ref）：

| 插件 | 类型 | 发布 ref |
| almanac-mcp | mcp | |

装好后对模型说一句：“帮我考古一下 legacy/payment.js 这段代码”，收获一份地层剖面 + 文物清单 + 保护性发掘建议；再问一句“今天宜忌如何？抽个签”，它就会翻老黄历、给你抽一支 🎋；卡在起名或选择困难时，喊它“给这个模块起个古风名字”或“抛个硬币决定今晚吃啥” 📛🎲。

🔨 构建链

MCP 插件源码是 TypeScript（plugins//src/.mts），由 toybox 构建链编译为仓库候选静态包使用的单文件产物（.dsh-plugin/server/.mjs）：

pnpm install # 安装 TypeScript、官方 MCP 2.0 client/server 与 esbuild
pnpm build # 类型检查并将官方 SDK 固定打包进五个单文件服务器
pnpm build:one # 只编译一个
pnpm typecheck # 只做类型检查（--noEmit）
pnpm verify # 逐叶子全验：构建/包面/MCP 隔离与重启/Skill 静态检查
TOYBOX_GITHUB_REPOSITORY=omdsh-dev/toybox pnpm release:prepare
- 编译器选项启用 strict、noUncheckedIndexedAccess 和 exactOptionalPropertyTypes。
- 产物是自包含单文件：esbuild 把固定版本的官方 MCP Server SDK 打入 .mjs，运行时不读取仓库 node_modules。
- 产物随源码一起提交（.dsh-plugin/ 是交付物）；改源码后必须 pnpm build 再提交。
- pnpm verify 是源仓门禁；Workshop 仍需基于不可变公开 commit 独立重跑并人工审核。
- 语言统计：.gitattributes 把构建产物标为 generated，.mts 显式归 TypeScript。
语言统计重算时机：push 触发、异步刷新（.gitattributes 的 linguist 规则随最新 commit 生效）。

🏗️ 入住指南

新插件四步入住：

1. 写源码：MCP 用 plugins//src/.mts；Skill 用 plugins//.dsh-plugin/skills//SKILL.md。
2. 声明契约：MCP 同时提供 package.json#dshWorkshop、mcpName 与 server.json；Skill 直接指向唯一 SKILL.md，不得带安装脚本。
3. 构建 + 自证：pnpm build:one 后运行 pnpm verify -- --only 和该叶子测试。
4. 登记：README 住户表加一行。

玩具箱纪律

- 好玩是第一生产力，但验收标准不能少：每个插件必须能过仓库自有 packager，README 里写清“什么时候用”。
- 不重复造轮子：toybox 只收有趣且边界清楚的插件；统一经 Workshop 收录。
- 诚实标注：判断类技能要带证据（参考 code-archaeologist 的"证据链"纪律），段子归段子，结论归结论。

🗺️ 规划中住户（候选，未开工）

| 住户 | 类型 | 梗点 | 状态 |
| 🧘 代码瑜伽 code-yoga | skill | 重构动作瑜伽体式化，小步可验收 | 候选 |
| 🌐 代码翻译官 code-translator | skill | 老代码现代化"翻译"，原文/译文对照 | 候选 |
| 🧭 代码导游 code-tour-guide | skill | 带新人逛代码库的旅游路线 | 候选 |
| 🃏 代码塔罗 code-tarot-mcp | mcp | 编程概念牌组 22 张大阿卡纳 | 候选 |
| 🚑 乱码急救员 mojibake-medic | skill | 中文编码救援：GBK/UTF-8/转义诊断修复 | 候选（已下架待重启） |

想新增别的？看 docs/CONTRIBUTING.md。

📜 许可

本仓库的源码、插件与文档统一采用 MIT 许可，版权归作者 mattheliu 所有（见 LICENSE）。