dsh-llm-governor
DeepSeek Harness 的多模型治理、路由、回退、配额和用量
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:young-tim/dsh-llm-governor#cdad11875b1736eb995d3caf5533610a7b04850cLlm Governor 以 dsh-llm-governor 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-llm-governor 是 DeepSeek Harness 的多模型治理插件。它在 DSH 现有模型调用链上
提供模型画像、用户访问控制、月度 Credits、Manual / Quality First / Credit First /
Auto Routing、失败重路由和 Usage 审计；它不代理模型请求，也不管理 Provider 凭证。
pnpm install
pnpm build
pnpm pack --pack-destination <临时目录>
dsh plugin --profile <profile> add <临时目录>/dsh-llm-governor-<version>.tgz
真实安装链路（add → --dump-config → remove）已在临时 DSH_HOME 中通过真实 dsh
CLI 验证，见 test/package/install-real.test.ts。
Governor 只负责选路、额度、Fallback 和审计，模型调用及凭证读取仍由 DSH 负责：
Governor → DSH ctx.llm → DSH Provider Adapter → DSH Credentials Service → Provider
DEEPSEEK_API_KEY。deepseek-official，且 DSH 中没有可用的已保存凭证时，
DEEPSEEK_API_KEY 才可能成为 DSH Provider Adapter 的配置项。选择其他 Provider
时，应配置该 Provider 自己所需的凭证。DSH_HOME 验收不会复制真实 Profile 的凭证。真实启动已经验证 Governor
被 DSH 加载、严格配置生效、SQLite 数据库完成初始化，并进入 DSH Provider
调用阶段；随后出现 MISSING_CREDENTIAL 表示测试环境缺少 DSH Provider 凭证，
不表示 Governor 依赖 DeepSeek API Key，也不代表已完成真实付费模型调用。LlmRuntime 配合
FakeLlmAdapter，覆盖选路、流式输出、Fallback、Usage 和 Credits。dsh plugin --profile headless add https://github.com/young-tim/dsh-llm-governor
dsh plugin --profile web add https://github.com/young-tim/dsh-llm-governor
pnpm install # 安装依赖
pnpm build # tsc 编译 + 复制 UI 页面到 dist/ui/pages
pnpm typecheck # 类型检查
pnpm lint # ESLint（--max-warnings 0）
pnpm format:check # Prettier 检查
pnpm test # 全量测试
pnpm test:contracts # rc.7 / rc.8 合同测试
pnpm test:unit # 单元测试
pnpm test:integration # 集成测试（Fallback / 加固 / 运行时接线）
pnpm test:ui # Playwright UI 测试
pnpm test:eval # Eval 数据集（Quality Retention / Credit Saving）
pnpm test:coverage # 覆盖率
pnpm test:package # tarball / 安装 smoke / 真实安装
^22.19.0 || >=24.0.0peerDependencies 为准；
兼容策略（npm latest 最低版本 + next 合同测试）见
docs/DEPENDENCIES.mdsrc/
├── access/ # 访问控制与能力过滤
├── classifier/ # Hint/Rule/LLM 分类器与缓存
├── config/ # 严格 Schema 校验与规范化
├── credits/ # Credits 计算与月度额度
├── dsh-adapter/ # DSH 类型与事件隔离层（含 FakeLlmAdapter）
├── extensions/ # 扩展点注册表
├── fallback/ # 失败重试与重路由状态机
├── identity/ # Local/Header/JWT 身份绑定
├── model/ # Canonical 路由与模型目录合并
├── plugin/ # Cordis 插件入口与 GovernorService
├── routing/ # Manual/Quality First/Credit First 策略
├── storage/ # SQLite Repository（WAL、迁移、幂等）
├── ui/ # Models/Users/Usage 页面与 host API
└── usage/ # Usage 计量与聚合
test/
├── contracts/ # rc.7 / rc.8 合同测试
├── eval/ # 七类任务 Eval 数据集
├── integration/ # 运行时接线 / 加固 / Fallback
├── package/ # tarball、安装 smoke、真实安装
├── ui/ # Playwright 页面测试
└── unit/ # 领域单元测试
ctx.llm 和 Provider Adapter 完成。