在 DeepSeek Harness（DSH）生态中，开发者通常需要对接多种插件、MCP Skills 与外部工具，管理成本随之增加。北极星作为通用能力聚合与择优进化层，位于 DSH 插件、第三方 MCP/Skills 与桌面新锐工具之上，负责持续嗅探、归一、竞技、验证、签名、索引与路由。它旨在让开发者面对单一意图接口时，底层能透明调度到当前最优实现。
核心功能¶
北极星由一系列原子原语组成，通过流水线实现从发现到调用的闭环。
- 异构嗅探：检测 DSH bundle、SKILL.md、MCP 配置、CLI bin 等异构资源，提取核心契约并归一化为 Polaris IR（剥离冗余依赖与权限）。
- 双轨竞技场：
- 热启动极简轨道：执行冒烟测试与自洽性检查，挂载到上下文辅助开发。
- 冷发布生产轨道：执行全量契约测试、模糊测试、性能基准、SBOM 审计与对抗性回放。
- SLSA 出处与不可变索引：通过 Ed25519 签名验证服务证据，结合 GitOps 维护不可变索引，确保生产环境调用的可信度。
- 语义调度：提供确定性意图路由，根据索引内容按意图透明路由到原生、自造或外源的最优实现。
- 自动模型工具注册：安装并重启 profile 后，开发 agent 会自动注册并调用
polaris_*模型工具，无需人工输入命令。
安装与启用¶
在 DSH 环境中安装北极星插件：
dsh plugin --profile web add github:existyay/Polaris
dsh web
安装完成后，插件会向 DSH 注册同名模型工具，同时提供独立的 CLI 命令。
原子原语与工具¶
北极星在 DSH 内部以原子插件形态存在，每个原语职责单一，可通过 cordis.patch.yml 单独配置。
模型工具（自动触发）¶
开发 agent 在项目开发过程中会自动看到并调用以下工具：
| 工具名 | 触发场景 |
|---|---|
polaris_discover |
寻找现成 DSH 能力，避免重复造轮子 |
polaris_audit |
代码改动后自动扫描依赖、认证等风险 |
polaris_exec |
需要一次有界冒烟执行并监控退出/超时/输出 |
polaris_verify |
任务完成前自动跑测试并执行覆盖率门槛 |
polaris_retrieve |
查找函数/类/文档概念时自动检索 |
polaris_license |
新增依赖或发布前自动检查许可证合规 |
polaris_rules |
注入中文理工科术语映射与代码优化规则 |
命令行原语¶
对应的独立 CLI 原语如下：
polaris-discovery(/polaris-discover)：GitHubtopic:dsh-plugin实时发现与极简评分。polaris-audit(/polaris-audit)：静态代码扫描与依赖漏洞审计。polaris-exec(/polaris-exec)：有界子进程执行与运行时行为监控。polaris-verify(/polaris-verify)：schema 驱动确定性功能测试。polaris-retrieve(/polaris-retrieve)：代码符号与文档混合检索。polaris-license(/polaris-license)：许可证合规查询。polaris-rules(/polaris-rules)：声明式注入规则。
使用示例¶
1. 异构嗅探¶
对指定项目目录进行异构资源嗅探，提取核心契约。
dsh-polaris sniff --root /path/to/project
2. 双轨竞技场¶
在竞技场目录中运行双轨测试，验证候选服务的效用增量是否显著优于现存最优实现。
dsh-polaris arena --root /path/to/arena-root
3. 语义调度¶
根据意图从不可变索引中路由到最优实现。
dsh-polaris route "code review" --indexRoot /path/to/index
4. 不可变索引与 GitOps¶
将候选服务签发为 SLSA 出处并写入不可变索引。
dsh-polaris seal --name demo --entry node --capabilities demo,cli --persist
dsh-polaris promote --name demo --entry node --capabilities demo,cli --indexRoot /path/to/index
设计约束¶
- 无状态：每个原子原语只读输入并产生确定性输出；流水线状态只存在于不可变索引中。
- 单一职责：一个插件只做一件事；组合由 profile patch 层与流水线配置完成。
- 成本有界：所有原语和流水线阶段都声明文件数、文件大小、超时与输出上限。
适用场景与注意¶
北极星特别适用于理工科（数学/物理/化学/工程/科研/数值/仿真）与代码优化（性能/重构/静态分析/测试质量/基准/调试）场景。
注意：插件以当前 DSH 进程权限运行，安装前应检查源码与许可证。插件不包含后台服务，所有状态变更通过 GitOps 方式写入不可变索引。
总结¶
北极星通过提供异构嗅探、双轨竞技场、SLSA 出处、不可变索引与语义调度等能力，为 DSH 插件体系构建了从发现、验证到调用的完整闭环。更多详情可参考项目仓库。
