omdsh-dev/dsh-toolkit 预览 preview

omdsh-dev/dsh-toolkit

DSH零依赖工具包集合——时间、编码、JSON、计算器、CSV、正则表达式、Markdown、差异比较、统计、模式,十个确定性工具,统一入口,一键安装。

Project Overview项目介绍

This repository is a native DSH plugin collection that bundles 10 zero-dependency deterministic tools for common development and documentation workflows. The tools cover time zone and calendar operations, data encoding/decoding, JSON querying, safe math evaluation, CSV parsing, regex processing, Markdown conversion, structured diff comparison, descriptive statistics, and JSON Schema validation. All tools are vendored and frozen as pack artifact snapshots here, with their original source repositories hosted independently under the omdsh-dev GitHub organization. This repo unifies their build, test, and release workflows to simplify bulk installation for end users.

This repository acts as an official collection and installation helper for the DSH Profile Bundle ecosystem. Each individual tool sub-package can be added, removed, enabled, or disabled independently using the standard DSH command line interface. The main collection includes a public catalog of all tools, a machine-readable manifest file, and multiple helper scripts for batch installation to both default web and headless DSH profiles. There is also an optional root meta package that allows users to mount all 10 tools at once in a single atomic operation.

The entire project is released under the open source MIT license, and includes a total of 723 test cases across all 10 tools to confirm expected functionality and stability. It supports two main installation modes: the recommended independent bundle mode that lets users pick and install only the tools they need, and the optional meta bundle mode for bulk atomic installation. Bulk installation can be completed in one step via the provided shell scripts, and pre-built entry files mean no extra local build step is required when installing directly from Git.

omdsh-dev/dsh-toolkit 是面向 DSH 的零依赖工具合集,整合了时间处理、编解码、JSON 查询、数学计算、CSV 处理、正则表达式、Markdown 转换、结构化对比、统计分析、JSON Schema 验证共 10 个确定性工具。本仓库将这 10 个工具统一工程化管理、统一测试、统一维护,每个工具都以 vendored 冻结的方式保存为包产物快照,各工具的源码独立演进,源仓库都位于 omdsh-dev 组织下。

本仓库是 DSH 官方 Profile Bundle 生态方向的集合与安装辅助仓库。每个子工具包都可以通过 DSH 命令行独立安装、启用、禁用和卸载,集合本身提供工具目录、清单文件和批量安装脚本。同时根目录还提供了一个可选的元包,支持一次性原子挂载全部 10 个工具,满足不同的安装场景需求。

项目提供两种安装模式,独立包模式推荐用户按需单独安装每个工具,元包模式适合一次性挂载全部工具,批量安装可以通过仓库提供的脚本一键完成。整个工具包是零依赖的,根目录预构建了可运行的 JS 入口文件,从 Git 安装不需要额外构建流程。项目基于 MIT 许可开源,总计包含 723 个测试用例保证稳定性。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 28 stars - an early-stage project星标 28,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:omdsh-dev/dsh-toolkit

把 omdsh-dev/dsh-toolkit 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

🧰 dsh-toolkit

English

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

License

为什么

DSH 生态仓库持续增长,单插件在 hub 中容易被淹没;collection 分类是辨识度最高的形态。本仓库把 10 个工具插件 vendored 冻结为 pack artifact 快照(各子仓库独立演进,当前源位于 omdsh-dev 组织下),统一工程、统一测试、统一维护。

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

分发边界:根 meta 包保持 private: true,用于 Git/collection 分发,不代表会发布到 npm registry。根目录已提交由当前 src 构建出的 lib/index.js 与 lib/types/index.d.ts,因此从 Git 安装时不依赖消费端 lifecycle;prepack 仍会在生成 pack artifact 前执行完整构建。

工具一览

工具 能力 用例数
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 子包(pack artifact 快照,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    # 共享编译配置(固化踩坑经验)

与实施文档方案 A 的工程化适配:子包为私有 Git/collection 包,peer 名解析在 profile 内不可行, 故 meta 包采用相对路径动态导入(零解析魔法、打包自足);子包 runtime 依赖 (@deepseek-ai/dsh-tools)在 npm 独立模式(默认)下不依赖 DSH monorepo,monorepo 模式经子包构建期 junction 解析。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-toolbox 下一个 Next dsh_theme_terraria →