@dsh-external/dsh-skill-vault
DSH 技能保险库：统筹你蒸馏的 skill，按场景/开关按需启用，agent 工具 + Web 可视化面板。
单仓库既承载插件，也承载开源 skill/语料（远程：https://github.com/dargonburn337845818/skill-group.git）。
这个模块解决什么
- 蒸馏出的 skill 越来越多后不再臃肿难查：统一放入
vault/，按使用场景组织。
- 开关粒度：场景级开关 + 单 skill 开关，默认可选目录，按需加载，不抢上下文。
- 启用状态持久化在本地数据目录，不进入公开仓库。
- 新增蒸馏产物通过
skill_vault_add 准备入库，git 推送必须手动（见 scripts/push.sh）。
架构（深模块）
DSH 官方技能注册表 ctx.skills
▲
│ register / dispose（只注册“已启用”的 skill）
│
dsh-skill-vault 插件
├── src/catalog.ts # 扫描 vault/skills/<场景>/<skill>/manifest.json+SKILL.md
├── src/manager.ts # 开关状态（全局持久 + 会话临时）、注册/注销
├── src/tools.ts # skill_vault_list / enable / disable / add
├── src/api.ts # /skill-vault/api（Web 面板数据接口）
└── src/client/ # 可视化开关面板（settings.section 设置页 + conversation.view 快捷面板）
▲
│ 读取
│
vault/ （本仓库数据）
├── skills/<场景>/<skill>/{SKILL.md, manifest.json, ...}
├── corpus/ # 开源语料/产物
└── meta/ # 入库手册等
目录
dsh-skill-vault/
├── src/ # 插件 TS 源码
├── vault/ # 开源 skill 仓库（可单独浏览）
│ ├── skills/base/ # 常驻底座：搜索/工作共识/DSH 运维底线
│ ├── skills/core-iteration/ # 核心迭代元能力 / 价值递归提升
│ ├── skills/dev/ # 开发模块：模块壳 + 九个子技能
│ ├── skills/distill/ # 蒸馏模块：模块缺口 → 新 Skill/专家 → 回填
│ ├── skills/teacher/ # 教师模块：人名专家团 + 回合式讨论
│ ├── skills/research/ # 科研模块：论文/组会/PPT/导师审查
│ ├── skills/writing/ # 文稿模块：提示词/文案/文档/报告
│ ├── skills/distillation/ # 内容蒸馏（已并入 core-iteration 唯一入口）
│ ├── skills/dsh-ops/
│ ├── skills/github/
│ ├── corpus/
│ └── manifest.schema.json
├── scripts/
│ └── push.sh # 手动提交/推送（需要凭据，不自动跑）
└── package.json # DSH 插件包
插件工具
| 工具 | 作用 |
|---|
skill_vault_list | 按场景/专家/来源/启用状态查询 |
skill_vault_enable <target> [scope=global|session] | 开关一个 skill 或一个场景 |
skill_vault_disable <target> [scope=global|session] | 关闭一个 skill 或一个场景 |
skill_vault_add | 把含 SKILL.md 的蒸馏目录拷贝进 vault 并生成 manifest（不 git） |
启用语义
- 默认：所有 skill 处于关闭状态，只出现在插件自己的目录（由工具/面板看到）。
- 打开后：插件调用
ctx.skills.register()，skill 进入 DSH 全局技能目录；agent 在遇到对应任务时按需用 skill 工具加载正文。
scope=global 写入 ~/.dsh/skill-vault/enabled.json（跨重启）。scope=session 只改当前进程内存，重启恢复全局。
开发与构建
# 需要 DSH source checkout（含 packages），或用 dev_build_plugin
bash scripts/build.sh
npm run build:client
遵循 ~/.dsh/dsh-optimization-consensus.md：
- 不自动热装到运行中的 agent；先在隔离
DSH_HOME 做 dump-config + 冒烟。
- 回滚恢复实际文件，不只改 package.json pin。
- 插件不自动 push；推送前先人工 review。
Release / 快速启动
QUICKSTART.md：安装、加载、开启 skill、发布新版本的完整引导。.github/workflows/release-plugin.yml：推送 v* tag 后自动校验 vault、npm pack、创建 Release 并上传 dsh-external-dsh-skill-vault-<version>.tgz。- 仓库已包含预构建
lib/，因此 CI 无需 DSH 私有依赖即可打包。
手动推送
cd $PROJECT_ROOT
bash scripts/push.sh
脚本会提示并执行 git add -A && git commit && git push；由于需要输入 HTTPS 凭据，它只该在外部终端人工运行。
Manifest 扩展（v0.1.0+）
routing: base | core | domain —— 主卡/底座/领域分类。qualityCriteria: { high, reject, minIndependentSources } —— 场景化筛选标准。boundary / notWhenToUse：卡片展开时的边界与不适用说明。activation: internal / hidden: true：内部实现，不进入目录。- 新增
/skill-vault/api/route 与 /skill-vault/api/reset-base，供 dsh-skill-router 调用。
贡献与安全
- 贡献流程见
CONTRIBUTING.md；漏洞上报见 SECURITY.md；社区行为见 CODE_OF_CONDUCT.md。
.github/workflows/ci.yml 在 push/PR 上运行 vault 校验、tag 校验与插件测试。- 公开仓库不发布内部开发产物：
assignments/（任务分派）与顶层 evals/（A/B 结果）已通过 .gitignore 排除；技能包内的可复现 eval 证据仍保留在各自 evals/ 目录。
