在 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 插件體系構建了從發現、驗證到調用的完整閉環。更多詳情可參考項目倉庫。