DSH 插件开发踩坑与做法档案（skill + 文档）：cordis 双副本、tsconfig 三件套、Windows junction、多帧 zstd 等实测记录
Install Dsh Plugin Dev
No package.json found — installability could not be checked.
Not checked — and that is not the same as fine
package.json for this repository, so none of the publish spec rules could be applied. We do not know whether dsh plugin add activates anything here.Best-effort git install — unverified, may activate nothing
# 1. add the bundle to a profile — --profile my-profile points at $DSH_HOME/profiles/my-profile
dsh plugin --profile my-profile add github:omdsh-dev/dsh-plugin-dev
# 2. verify: the bundle should show up as a layer in the resolved config
dsh --profile my-profile --dump-config
# 3. boot the profile
dsh --profile my-profileStep 2 is the one that matters here: if --dump-config shows no new layer after the install, this repository is not a bundle and there is nothing to activate.
Before you run it
- A plugin runs with your permissions once loaded: it can read your files, use your credentials and reach the network. Tool approvals do not sandbox it.
- Installing from git resolves a moving branch. Pin a commit —
github:omdsh-dev/dsh-plugin-dev#<commit-sha>— so the code you reviewed is the code you install.
Prerequisites
- API key
- Not required.
- Network access
- Not required at runtime.
Install check
Every field the verdict was derived from, so you can re-derive it yourself
| Field checked | Result | Weight | What the spec says about it |
|---|---|---|---|
| package.json | missing | fatal | no package.json found in the repository |
- Verdict reason
- cannot audit without a package.json
- Rules applied from
- docs/user/develop/basic/publish.md
- Checked at
- 2026-08-15
From the README
Excerpt as published by the author, plain text, unedited
记录自 DSH 公测期间（dsh-external 组织）的插件开发实践：vendor cordis 双副本、tsconfig 三件套、Windows junction、多帧 zstd API……每个坑都有发生时的现象、确认的根因与最终修法。公测结束后相关仓库已迁移至 [omdsh-dev](https://github.com/omdsh-dev) 组织并公开。 一份**经验档案**（skill + 文档）：记录插件开发流程、踩过的坑、验证过能用的做法。 1. 把 `skills/dsh-plugin-dev` 放进 skills 目录（或在 agent 会话中引用）； 2. 从 [SKILL.md](skills/dsh-plugin-dev/SKILL.md) 的流程与踩坑速查表入手； 3. 构建前看 [references/build-pitfalls.md](skills/dsh-plugin-dev/references/build-pitfalls.md)——第一条就是 cordis 双副本。 | 文档 | 记录内容 | |------|------| | [SKILL.md](skills/dsh-plugin-dev/SKILL.md) | 开发流程 + 踩坑速查表 + 交付前验证闭环 | | [overview.md](skills/dsh-plugin-dev/references/overview.md) | 形态选择（bundle）+ 扫描过的生态地图 | | [tool-plugin.md](skills/dsh-plugin-dev/references/tool-plugin.md) | defineTool 契约、参数 schema、输出模式 | | [build-pitfalls.md](skills/dsh-plugin-dev/re
Topics
GitHub topics on this repository
More in Skill Cordis Best Practices
Ranked by similarity inside the cluster, not alphabetically
