# 贡献指南

感谢你愿意为 dsh-session-slm-router 贡献！本仓库是一个独立单库（2026-09 从 dsh-plugins monorepo 迁出），仓库根即插件目录。

## 开发环境

```sh
npm install --legacy-peer-deps   # peer 由宿主 dsh 在运行时提供，本仓库装 devDeps 供构建/测试
npm run build                    # tsc → lib/
npm run typecheck                # 严格类型检查
npm test                         # node --test：判定表/health/tierOf/utterance/超时（零依赖）
npm run mount                    # 挂载冒烟测试：apply 运行 + 影子管线端到端（stub 宿主服务）
```

测试套件不触网、不用凭据、不依赖真实 vertical-small-model CLI（predict 路径指向不存在的命令以验证优雅降级）。

## 提交规范

- 提交信息用中文写清楚「改了什么 + 为什么」（仓库 AGENTS.md / DEVELOPMENT.md 有完整纪律）。
- 涉及 `src/`、`scripts/`、`tests/` 改动会触发 pre-commit 部署纪律自检（`git config core.hooksPath .githooks` 启用）；确属未部署的中间态用 `--no-verify` 并在说明中注明。
- **本机私有信息不入库**：本机绝对路径、个人邮箱、token、部署实况快照一律不写入入库文件。

## 发版流程

见 [PUBLISHING.md](PUBLISHING.md)（npm version → tag → CI 验证 → OIDC trusted publishing 发布）。

## 行为准则

简单说：尊重、建设性、对事不对人。本仓库维护者会驳回不友善或与主题无关的 issue / PR。