北极星 (Polaris)
以 find-skills 为起点，定位为通用能力聚合与择优进化层：在 DeepSeek Harness 插件、第三方 MCP/Skills 与桌面新锐工具之上，持续嗅探、归一、竞技、验证、签名、索引与路由，让开发者面对单一意图接口，底层透明调度到当前最优实现。
- 中文名：北极星
- 发布仓库：https://github.com/existyay/Polaris
- 特化方向：理工科（数学/物理/化学/工程/科研/数值/仿真）与代码优化（性能/重构/静态分析/测试质量/基准/调试）
流水线
异构嗅探 sniff
├─ dsh-plugin / MCP / Skills / CLI / desktop
└─ 提取核心契约 → 归一化为 Polaris IR（剥离冗余依赖与权限）
↓
双轨竞技场 arena
├─ 热启动极简轨道：冒烟 + 自洽性 → 挂载到上下文辅助开发
└─ 冷发布生产轨道：全量契约 + 模糊 + 性能基准 + SBOM 审计 + 对抗性回放
↓
判定门禁：效用增量必须显著优于现存最优实现
├─ 达标 → 可信服务签发 SLSA 出处 → GitOps PR → 不可变索引 → 语义调度器
└─ 未达标 → 自动关闭 PR，输出差异化对比报告
↓
统一语义调度器 route：按意图透明路由到原生/自造/外源最优实现
当前实现
| 组件 | 命令 | 状态 |
|---|---|---|
| 异构嗅探 | dsh-polaris sniff / find-skills |
✅ 检测 DSH bundle、SKILL.md、MCP 配置、CLI bin |
| Polaris IR | lib/ir.js |
✅ 统一契约 + 校验 + 内容寻址摘要 |
| 双轨竞技场 | dsh-polaris arena |
✅ 热启动冒烟/自洽 + 冷发布契约/模糊/基准/SBOM/对抗性回放 |
| SLSA 出处 | dsh-polaris seal |
✅ Ed25519 签名；生产需可信签名服务托管私钥 |
| 不可变索引 + GitOps | dsh-polaris promote |
✅ 内容寻址条目 + index.json + git commit；远程 PR 由部署端触发 |
| 语义调度 | dsh-polaris route |
✅ 确定性意图路由；生产可替换为动态调度器 |
自动调用（安装后无需人工命令）
每个原子插件除 /polaris-* 命令外，还向 DSH 注册了同名模型工具。安装并重启 profile 后，开发 agent 在项目开发过程中会自动看到并调用这些工具：
| 工具名 | 自动触发场景 |
|---|---|
polaris_discover |
寻找现成 DSH 能力，避免重复造轮子 |
polaris_audit |
改动依赖、认证、动态执行等代码后自动扫描 |
polaris_exec |
需要一次有界冒烟执行并监控退出/超时/输出 |
polaris_verify |
任务完成前自动跑测试并执行覆盖率门槛 |
polaris_retrieve |
查找函数/类/文档概念时自动检索 |
polaris_license |
新增依赖或发布前自动检查许可证 |
polaris_rules |
注入中文理工科术语映射与代码优化规则 |
工具描述即触发策略，模型无需人工输入命令即可在开发流程中自动调用；slash 命令保留给人类显式操作。
DSH 原子原语
北极星在 DSH 内保持原子插件形态，每个原语独立可启停：
| id | 命令 | 职责 |
|---|---|---|
polaris-discovery |
/polaris-discover |
GitHub topic: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 |
声明式注入中文理工科术语映射 + 代码优化规则 |
每个原语在 cordis.patch.yml 中是一个独立行，可单独禁用：
- id: polaris-exec
disabled: true
安装
dsh plugin --profile web add github:existyay/Polaris
dsh web
CLI
dsh-polaris discover --scope code --top 10
dsh-polaris install --profile web --scope code --max 10 --dry-run
dsh-polaris sniff --root /path/to/project
dsh-polaris arena --root /path/to/arena-root
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
dsh-polaris route "code review" --indexRoot /path/to/index
竞技场配置 .polaris-arena.json
{
"candidate": {
"schemaVersion": "1.0",
"name": "demo-node",
"version": "1.0.0",
"origin": { "type": "cli" },
"source": "node",
"description": "Node.js runtime as a candidate",
"entry": "node",
"capabilities": ["demo", "runtime"],
"permissions": [],
"dependencies": [],
"tests": {
"smoke": ["cli-help:--help"],
"contract": [],
"fuzz": [],
"benchmark": []
}
},
"champion": { "name": "champion", "entry": "python3", "capabilities": ["demo"] },
"goldenTasks": [
{ "name": "hello", "command": "{entry} -e \"console.log('hi')\"", "expect": "hi", "timeoutMs": 30000 }
],
"utilityThreshold": 0.1
}
插件结构
Polaris/
├── package.json # dsh.bundle manifest + exports（原子插件 subpath）
├── cordis.patch.yml # 七个独立原子插件行
├── index.js # 兼容旧入口：等价于 dsh-polaris/discovery
├── plugins/ # DSH 原子插件
├── lib/ # 核心实现（零依赖、有界）
│ ├── ir.js # Polaris IR
│ ├── sniff.js # 异构嗅探
│ ├── arena.js # 双轨竞技场
│ ├── seal.js # SLSA 签名
│ ├── registry.js # 不可变索引 + GitOps
│ └── scheduler.js # 语义调度
├── bin/dsh-polaris.js # 独立 CLI
└── skills/polaris/ # 默认规则与发现原语技能
设计约束
- 无状态：每个原子原语只读输入并产生确定性输出；流水线状态只存在于不可变索引中。
- 单一职责：一个插件只做一件事；组合由 profile patch 层与流水线配置完成。
- 可组合：DSH Loader 行、IR、索引三层均可独立替换。
- 可验证：验证原语 + 双轨竞技场 + SLSA 出处共同构成证据链。
- 成本有界：所有原语和流水线阶段都声明文件数、文件大小、超时与输出上限。
