🧰 dsh-toolkit

English

DSH 零依赖工具包 collection —— time / encoding / json / calculator / csv / regex / markdown / diff / stat / schema 十个确定性工具，统一入口一键安装。

为什么

DSH 生态仓库持续增长，单插件在 hub 中容易被淹没；collection 分类是辨识度最高的形态。本仓库把 10 个工具插件 vendored 冻结为发布态快照（各子仓库独立演进，均位于 omdsh-dev 组织下公开），统一工程、统一测试、统一维护。

定位（官方 Profile Bundle 生态方向）：本仓库是 collection 与安装辅助仓库——每个子包都是可独立安装/启用/禁用/卸载的 bundle（dsh plugin --profile add ）；collection 提供目录、清单与批量安装脚本。meta 包 @deepseek-ai/dsh-toolkit 保留为可选的原子挂载模型（见下文两种运行模型）。

工具一览

工具	能力	用例数
time	ISO 8601 / 时区 / 日历运算 / 时长差	65
encoding	base64 / url / hex / hash / UUID	46
json	JMESPath 子集查询	66
calculator	安全数学表达式求值（无 eval）	31
csv	RFC 4180 解析 / 查询 / 统计（严格引号）	50
regex	测试 / 提取 / 替换 / 静态解释（worker 硬超时）	63
markdown	HTML↔Markdown / GFM 表格 / 目录生成（白名单安全）	71
diff	文本/JSON/CSV/Markdown 结构化比较与 unified diff（只读）	124
stat	描述统计 / 百分位数 / 频数分布 / 相关性（零依赖确定性）	82
schema	JSON Schema 验证 / 路径 / 解释 / 安全 default（零网络零动态）	125
合计		723

架构

dsh-toolkit/
├── src/index.ts          # meta 包：相对路径动态导入 10 个子包 apply()，聚合注册
├── packages/dsh-tool-*   # vendored 子包（发布态快照，name 保持 @deepseek-ai/dsh-tool-*）
├── scripts/
│   ├── link-deps.sh      # 构建期 junction（cordis → vendor/cordis，dsh-tools → packages/core/tools）
│   ├── build-all.sh      # 一键构建 10 子包 + meta 包（tsc）
│   ├── test-all.sh       # 一键跑 10 子包 vitest（合计用例数）
│   ├── install.sh        # meta / 逐包两种挂载模式（含 dry-run）
│   ├── install-web.sh    # 独立 bundle 批量安装 → web profile
│   ├── install-headless.sh # 独立 bundle 批量安装 → headless profile
│   └── install-all.sh    # web + headless 都装
├── catalog.json          # collection 清单（hub collection 分类识别依据）
└── tsconfig.base.json    # 共享编译配置（固化踩坑经验）