dsh-plugin-check¶
⭐ 27 · ✅ active · plugin · ⬆️ +3 recently
| Type | plugin | Category | Developer tools |
| Stars | ⭐ 27 | Status | ✅ active |
| Author | omdsh-dev | Updated | 2026-08-21 |
| Subcategory | 🛡️ Security & ops | Capabilities | observability |
One-liner¶
Plugin health checks: manifest protocol, patch format, build pitfalls and hub listing status, zero-dependency read-only.
About¶
English DSH 插件健康检查工具 —— 扫描插件仓库,诊断清单协议 / patch 格式 / 构建陷阱 / hub 收录状态,输出合规报告与修复建议。只读,不修改、不构建被检查仓库。
✨ Key Features¶
- 只读:仅
readdir/stat/readFile,绝不修改或构建被检查仓库 - 零业务依赖:仅 node 内置模块(fs/path/child_process)
- hub 检查离线优先:先读本地 hub catalog(
DSH_HUB_SOURCE或 cwd/hub/ 下),再通过gh读取公开omdsh-dev/dsh-hub-workshop/catalog.json;兼容dsh-hub-index/v0.4与旧repos[].name - 不执行 tsc:构建陷阱全部静态文本扫描(快、无副作用)
📦 Install¶
# 交互式(web)profile
dsh plugin --profile web add github:omdsh-dev/dsh-plugin-check
# 一次性任务(headless)profile —— dsh run 默认使用 headless
dsh plugin --profile headless add github:omdsh-dev/dsh-plugin-check
🚀 Quick Start¶
# tarball 方式(web 为例;headless 同)
npm pack
dsh plugin --profile web add <npm pack 产物 tarball 路径>
📚 Learn more¶
示例
plugin_check { action: "check", path: "C:/Users/admin/Desktop/dshext/dsh-tool-csv" } → {"repo":"dsh-tool-csv","kind":"tool-bundle","verdict":"pass","checks":{"total":24,"passed":24,...}} plugin_check { action: "scan", path: "C:/Users/admin/Desktop/dshext" } → {"root":"...","scanned":11,"reports":[...]} # dsh-my-rsi 等不合规仓库会带 error+suggestions
一次性任务(headless)profile —— dsh run 默认使用 headless
dsh plugin --profile headless add github:omdsh-dev/dsh-plugin-check 包内 dsh.bundle.patch 会在安装后自动把插件加入 profile 的 layer stack(row id:tool-plugin-check)。插件缺失的 peer 依赖(cordis、@deepseek-ai/dsh-tools)由 profile 的 healed profiles/node_modules 回退安装提供。 > ⚠️ web 与 headless 是不同 profile:web 安装不会自动覆盖 headless;dsh run 默认使用 headless profile。Windows 路径使用正斜杠(C:/...)。
手动安装与旧版本兼容
旧场景(monorepo 集成、不支持 Profile Bundle 的旧快照或插件开发调试环境——本地 junction/symlink、手动编辑 profile 层)。