[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-1839":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":12,"openIssues":13,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":13,"stars7d":12,"stars30d":12,"stars90d":13,"forks30d":13,"starsTrendScore":13,"compositeScore":14,"rankGlobal":9,"rankLanguage":9,"license":15,"archived":16,"fork":16,"defaultBranch":17,"hasWiki":18,"hasPages":16,"topics":19,"createdAt":9,"pushedAt":9,"updatedAt":20,"readmeContent":21,"aiSummary":22,"trendingCount":13,"starSnapshotCount":13,"syncStatus":23,"lastSyncTime":24,"discoverSource":25},1839,"Polaris","dainsiahtill-dev\u002FPolaris","dainsiahtill-dev","Polaris 是一个事务驱动的 AI 软件工厂内核。它不是聊天式编程助手——而是将 LLM 降级为受限决策组件，由系统内核统一接管执行、审计、预算与回滚，实现企业级的无人值守、可追责、可回滚软件交付流水线。内置 PM \u002F Architect \u002F Director \u002F QA 角色的三省六部权力分离架构，以及 KernelOne 底座、ContextOS 三层记忆、EDA 任务集市等核心能力。",null,"Python",103,1,0,0.9,"MIT License",false,"main",true,[],"2026-06-12 02:00:33","\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Flogo.png\" alt=\"Polaris Logo\" width=\"600\">\n\u003C\u002Fp>\n\n# Polaris\n\nPolaris 是一个面向复杂软件交付场景的 AI Agent 治理与运行时平台。  \n它的目标不是再做一个“会聊天、会调工具”的 Agent 壳，而是把 Agent 执行变成 **可事务化、可审计、可回滚、可验证** 的工程系统。\n\n英文版说明见 [README.en.md](.\u002FREADME.en.md)。\n\n从架构上看：\n\n- `KernelOne` 是底层运行时基座，负责上下文、执行、副作用、存储布局与事件等通用能力\n- `Cells` 是业务能力边界，负责把复杂系统拆成可治理的能力单元\n- `TransactionKernel` 和 `ContextOS` 是最关键的运行时真相链\n\n## 项目简介\n\nPolaris 是一个面向复杂软件交付场景的 AI Agent 治理与运行时平台。  \n它想解决的不是“模型能不能再多调几个工具”，而是更底层的问题：\n\n- Agent 的一次执行如何具备明确边界\n- 上下文如何从消息堆积升级为运行时系统\n- 工具调用和状态修改如何进入可审计链路\n- 多角色、多阶段、长链路任务如何形成可验证闭环\n\n可以把 Polaris 理解成两层：\n\n1. `KernelOne`\n   面向 AI Agent 的底层运行时基座，负责上下文、执行、副作用、存储布局、事件和运行时契约等平台无关能力。\n2. `Polaris`\n   建立在 `KernelOne` 之上的治理与交付系统，负责多角色协作、任务编排、执行调度、审计验收、质量门禁与桌面工作台。\n\n这意味着 Polaris 更接近 **Agent Runtime + Governance Platform**，而不是单纯的 Prompt 模板集合或聊天式编码助手。\n\n### 当前状态\n\n当前仓库状态应被理解为：\n\n- **Alpha**\n- **主干架构明确，但收敛仍在进行中**\n- **`src\u002Fbackend\u002Fpolaris\u002F` 是后端 canonical 根目录**\n- **旧入口和兼容层仍存在，但不应继续承载新主实现**\n\n如果你在评估项目，请把它看成一个“方向明确、工程量巨大、仍在持续收敛的运行时平台”，而不是一个已经完全稳定封板的产品。\n\n## 核心架构\n\n### 架构总览图\n\n![Polaris 架构总览](docs\u002Fassets\u002Fdiagrams\u002Fpolaris-architecture-overview.svg)\n\n这张图可以先帮助你建立一个最简模型：\n\n- `Frontend \u002F Electron` 负责 UI 与桌面壳层\n- `delivery` 负责 HTTP \u002F WebSocket \u002F CLI 等传输入口\n- `application` 负责用例编排和事务边界\n- `domain` 负责业务规则\n- `kernelone` 负责 Agent Runtime Substrate\n- `cells` 负责业务能力边界\n- `infrastructure` 负责数据库、消息、遥测和外部适配\n\n底部两条横向平面代表 Polaris 真正关心的两个问题：\n\n- `Governance Plane`：graph、manifest、packs、ADR、release gate、CI blocker\n- `Runtime Truth Plane`：TransactionKernel、ContextOS、TruthLog、WorkingState、ReceiptStore、ProjectionEngine\n\n### 分层结构\n\nPolaris 当前后端 canonical 主干围绕以下分层展开：\n\n- `bootstrap\u002F`：启动装配与生命周期管理\n- `delivery\u002F`：HTTP \u002F WebSocket \u002F CLI 入口\n- `application\u002F`：用例编排与事务边界\n- `domain\u002F`：业务规则与领域模型\n- `kernelone\u002F`：Agent Runtime 底座\n- `infrastructure\u002F`：数据库、消息、遥测与外部适配器\n- `cells\u002F`：能力边界与治理单元\n\n这套结构的目标不是把目录整理得更“好看”，而是把传输协议、用例编排、运行时能力、业务规则和外部依赖真正拆开，让系统在复杂度增长后仍然可维护、可测试、可审计。\n\n### 核心概念\n\n### 1. KernelOne\n\n`KernelOne` 是 Polaris 的通用运行时基座，代码位于 [src\u002Fbackend\u002Fpolaris\u002Fkernelone](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fkernelone)。  \n它负责承载平台无关的技术能力，包括：\n\n- Context runtime\n- execution substrate\n- storage layout \u002F KFS\n- event and audit primitives\n- provider\u002Ftool\u002Fruntime contracts\n\n### 2. TransactionKernel\n\n`TransactionKernel` 是 turn 级执行内核，核心目标是让 Agent 的一次执行具备明确的提交边界，而不是无限 continuation。  \n相关代码和治理资产主要位于：\n\n- [src\u002Fbackend\u002Fpolaris\u002Fcells\u002Froles\u002Fkernel](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Froles\u002Fkernel)\n- [adr-0071](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002Fgovernance\u002Fdecisions\u002Fadr-0071-transaction-kernel-single-commit-and-context-plane-isolation.md)\n\n### 3. ContextOS\n\n`ContextOS` 是上下文运行时，目标是把“事实日志、工作状态、大对象引用、只读投影”分层管理，而不是把所有内容直接塞进 prompt。  \n相关代码位于 [src\u002Fbackend\u002Fpolaris\u002Fkernelone\u002Fcontext](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fkernelone\u002Fcontext)。\n\n### 4. Cells\n\n`Cells` 是 Polaris 的能力边界模型。  \n每个 Cell 应该有明确的职责、依赖、公开契约和治理资产，而不是靠目录约定和隐式依赖维持系统。  \n图谱真相位于 [src\u002Fbackend\u002Fdocs\u002Fgraph\u002Fcatalog\u002Fcells.yaml](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002Fgraph\u002Fcatalog\u002Fcells.yaml)。\n\n### 5. 角色协作\n\n当前系统围绕以下工程角色组织协作：\n\n- `PM`\n- `Architect`\n- `Chief Engineer`\n- `Director`\n- `QA`\n\n历史文档里可能还能看到官职隐喻；对外理解和实际开发请优先使用工程术语。统一术语表见 [docs\u002FTERMINOLOGY.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fdocs\u002FTERMINOLOGY.md)。\n\n### 运行时主线\n\nPolaris 真正的心脏不是 UI，而是这条运行时真相链：\n\n1. 启动与装配：由 [backend_bootstrap.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fbootstrap\u002Fbackend_bootstrap.py:45) 统一负责环境、配置、端口、FastAPI app 和 server 生命周期。\n2. 传输入口：HTTP 入口通过 [app_factory.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fdelivery\u002Fhttp\u002Fapp_factory.py:91) 组装，实时事件通过 [websocket_core.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fdelivery\u002Fws\u002Fendpoints\u002Fwebsocket_core.py:57) 推送。\n3. 会话编排：多回合角色执行由 [session_orchestrator.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Froles\u002Fruntime\u002Finternal\u002Fsession_orchestrator.py:448) 负责状态机、handoff 和 continuation policy。\n4. 单 turn 事务：一次执行的真正事务内核是 [turn_transaction_controller.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Froles\u002Fkernel\u002Finternal\u002Fturn_transaction_controller.py:136)，核心目标是杀掉隐式 continuation loop。\n5. 上下文入口：所有上下文构建统一经过 [gateway.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Froles\u002Fkernel\u002Finternal\u002Fcontext_gateway\u002Fgateway.py:77)，再落到 `StateFirstContextOS`。\n6. 上下文四层：`TruthLog`、`WorkingState`、`ReceiptStore`、`ProjectionEngine` 分别位于 [truth_log_service.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fkernelone\u002Fcontext\u002Ftruth_log_service.py:321)、[working_state_manager.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fkernelone\u002Fcontext\u002Fworking_state_manager.py:11)、[receipt_store.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fkernelone\u002Fcontext\u002Freceipt_store.py:13)、[projection_engine.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fkernelone\u002Fcontext\u002Fprojection_engine.py:86)。\n\n这条主线决定了 Polaris 不只是“能调模型”，而是在尝试建立一个真正可治理的 Agent Runtime。\n\n## 核心优势\n\n### 1. Agent 执行是事务化设计，而不是无限 while-loop\n\nPolaris 的一个核心优势，是它把 Agent 执行当成“有提交边界的运行时过程”来设计，而不是把模型、工具和状态全部塞进一个隐式循环里。  \n这条主线主要落在：\n\n- [src\u002Fbackend\u002Fpolaris\u002Fcells\u002Froles\u002Fkernel](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Froles\u002Fkernel)\n- [adr-0071](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002Fgovernance\u002Fdecisions\u002Fadr-0071-transaction-kernel-single-commit-and-context-plane-isolation.md)\n\n这件事的意义在于：\n\n- turn 级决策、工具批次和 handoff 可以被约束\n- 执行过程可以被审计、验证和逐步标准化\n- 系统有机会摆脱 hidden continuation 和 transport-dependent commit\n\n这不是“多一个概念名”，而是把 Agent 从脚本化行为推进到运行时纪律。\n\n### 2. ContextOS 把上下文问题从 prompt 技巧提升为系统设计\n\n很多 Agent 工程在上下文上依赖经验：消息太长了就裁、太乱了就摘要。  \nPolaris 的方向不是这样。`ContextOS` 试图把上下文拆成不同层级的职责：\n\n- 事实日志\n- 工作状态\n- 大对象引用\n- 只读投影\n\n核心代码在：\n\n- [src\u002Fbackend\u002Fpolaris\u002Fkernelone\u002Fcontext](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fkernelone\u002Fcontext)\n\n它的价值是：\n\n- prompt 组装可以逐步脱离原始消息堆积\n- 审计、压缩、回放和隔离具备更清楚的结构\n- 运行时事实和控制面信息有机会真正分层\n\n当前这条链路还在继续硬化，但它已经是 Polaris 与普通聊天式 Agent 项目最本质的差异之一。\n\n### 3. 系统不是靠目录习惯维持，而是靠边界和治理资产维持\n\nPolaris 的另一个优势，是它不满足于“约定大家别乱 import”。  \n仓库里已经形成了比较完整的治理方向：\n\n- 规范根目录分层\n- Cell 边界\n- public\u002Finternal fence\n- graph truth\n- descriptor\u002Fcontext\u002Fverify pack\n- architecture\u002Frelease gates\n\n关键真相源：\n\n- [src\u002Fbackend\u002Fdocs\u002FAGENT_ARCHITECTURE_STANDARD.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002FAGENT_ARCHITECTURE_STANDARD.md)\n- [src\u002Fbackend\u002Fdocs\u002Fgraph\u002Fcatalog\u002Fcells.yaml](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002Fgraph\u002Fcatalog\u002Fcells.yaml)\n- [src\u002Fbackend\u002Fpolaris\u002Fcells](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells)\n\n这条路线真正有价值的地方在于：  \n随着仓库变大，系统还能继续讨论“谁拥有状态、谁暴露契约、谁可以产生副作用”，而不是退化成全仓搜索替换。\n\n### 4. KernelOne 的目标是可沉淀的 Agent Runtime Substrate\n\n`KernelOne` 不是简单的工具目录，它的目标是承载平台无关、可复用的 Agent 运行时能力：\n\n- context runtime\n- execution substrate\n- storage layout \u002F KFS\n- events and audit primitives\n- provider\u002Ftool\u002Fruntime contracts\n\n相关代码与规范：\n\n- [src\u002Fbackend\u002Fpolaris\u002Fkernelone](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fkernelone)\n- [src\u002Fbackend\u002Fdocs\u002FKERNELONE_ARCHITECTURE_SPEC.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002FKERNELONE_ARCHITECTURE_SPEC.md)\n\n这意味着 Polaris 的 ambition 不是只做“一个桌面 Agent 产品”，而是在往“Agent 基础软件层”推进。\n\n### 5. 审计、门禁和副作用治理从一开始就是主线\n\nPolaris 很强调一个问题：  \n系统做了什么，能不能在事后说清楚，能不能在运行中阻断，能不能在变更时验证。\n\n这种思路已经体现在当前仓库里：\n\n- 架构与发布门禁：\n  - [tests\u002Farchitecture\u002Ftest_kernelone_release_gates.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Ftests\u002Farchitecture\u002Ftest_kernelone_release_gates.py)\n  - [quality-gates.yml](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002F.github\u002Fworkflows\u002Fquality-gates.yml)\n- 治理资产：\n  - [src\u002Fbackend\u002Fdocs\u002Fgovernance](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002Fgovernance)\n- 运行时证据路径：\n  - [runtime](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fruntime)\n  - [src\u002Fbackend\u002Fworkspace\u002Fmeta](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fworkspace\u002Fmeta)\n\n这条路线说明 Polaris 想做的不是“更聪明一点的 Agent”，而是“更可治理一点的 Agent 系统”。\n\n### 6. Polaris 关注的是长链路协作，而不是单轮回答\n\n从代码结构就能看出来，Polaris 不是围绕一次性问答设计的。  \n它显式建模了：\n\n- 多角色协作\n- 任务市场\n- 执行 broker\n- evidence \u002F archive \u002F audit \u002F runtime state\n\n对应路径包括：\n\n- [src\u002Fbackend\u002Fpolaris\u002Fcells\u002Fruntime\u002Ftask_market](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Fruntime\u002Ftask_market)\n- [src\u002Fbackend\u002Fpolaris\u002Fcells\u002Fruntime\u002Ftask_runtime](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Fruntime\u002Ftask_runtime)\n- [src\u002Fbackend\u002Fpolaris\u002Fcells\u002Fruntime\u002Fexecution_broker](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Fruntime\u002Fexecution_broker)\n- [src\u002Fbackend\u002Fpolaris\u002Fcells\u002Ffactory\u002Fpipeline](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Ffactory\u002Fpipeline)\n\n这让 Polaris 更像一个 Agent 工程平台，而不是“套了工具调用的聊天窗口”。\n\n## 仓库结构\n\n### 关键目录\n\n| 路径 | 作用 |\n|---|---|\n| [src\u002Fbackend\u002Fpolaris](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris) | 后端主实现 |\n| [src\u002Fbackend\u002Fpolaris\u002Fkernelone](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fkernelone) | Agent 运行时基座 |\n| [src\u002Fbackend\u002Fpolaris\u002Fcells](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells) | 业务能力边界 |\n| [src\u002Ffrontend](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Ffrontend) | React 前端 |\n| [src\u002Felectron](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Felectron) | Electron 壳层 |\n| [src\u002Fbackend\u002Fdocs](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs) | 后端架构、治理与图谱文档 |\n| [docs](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fdocs) | 项目级文档与蓝图 |\n| [tests](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Ftests) | 仓库级测试 |\n| [src\u002Fbackend\u002Ftests](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Ftests) | 后端治理\u002F架构\u002F集成测试 |\n\n### 后端规范根目录\n\n后端当前的 canonical 分层是：\n\n- `bootstrap\u002F`\n- `delivery\u002F`\n- `application\u002F`\n- `domain\u002F`\n- `kernelone\u002F`\n- `infrastructure\u002F`\n- `cells\u002F`\n- `tests\u002F`\n\n这些目录都位于 [src\u002Fbackend\u002Fpolaris](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris) 下。  \n具体规则见 [src\u002Fbackend\u002Fdocs\u002FAGENT_ARCHITECTURE_STANDARD.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002FAGENT_ARCHITECTURE_STANDARD.md) 和 [src\u002Fbackend\u002Fdocs\u002FKERNELONE_ARCHITECTURE_SPEC.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002FKERNELONE_ARCHITECTURE_SPEC.md)。\n\n## 快速开始\n\n### 环境要求\n\n- Python `3.10+`，推荐 `3.11+`\n- Node.js `20+`\n- Windows\u002FmacOS\u002FLinux 均可开发，当前仓库内含 Electron、FastAPI、Playwright、Vitest、Pytest 工作流\n\n### 1. 一键准备开发环境\n\n```bash\nnpm run setup:dev\n```\n\n该脚本会准备前端和本地开发所需的基础环境。  \n如果你只需要 Python 侧，也可以直接使用：\n\n```bash\npip install -e .[dev]\n```\n\n### 2. 启动桌面端开发环境\n\n```bash\nnpm run dev\n```\n\n这会启动前端开发服务器并拉起 Electron。\n\n### 3. 仅启动后端\n\n推荐使用安装后的 canonical CLI：\n\n```bash\npolaris --host 127.0.0.1 --port 49977\n```\n\n兼容方式仍然可用，但属于旧入口 shim：\n\n```bash\npython src\u002Fbackend\u002Fserver.py --host 127.0.0.1 --port 49977\n```\n\ncanonical 实现位于 [src\u002Fbackend\u002Fpolaris\u002Fdelivery\u002Fserver.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fdelivery\u002Fserver.py)，兼容 shim 位于 [src\u002Fbackend\u002Fserver.py](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fserver.py)。\n\n### 4. 单独运行角色 CLI\n\n```bash\npm --workspace . --start-from pm\ndirector --workspace . --iterations 1\npython -m polaris.cells.architect.design.internal.architect_cli --mode interactive --workspace .\npython -m polaris.cells.chief_engineer.blueprint.internal.chief_engineer_cli --mode interactive --workspace .\n```\n\n### 5. 前端测试\n\n```bash\nnpm test\nnpm run test:e2e\n```\n\n## 30 分钟上手路线\n\n### 0-5 分钟：先看骨架文档\n\n按顺序阅读：\n\n1. [src\u002Fbackend\u002FAGENTS.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002FAGENTS.md)\n2. [src\u002Fbackend\u002Fdocs\u002FAGENT_ARCHITECTURE_STANDARD.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002FAGENT_ARCHITECTURE_STANDARD.md)\n3. [src\u002Fbackend\u002Fdocs\u002FKERNELONE_ARCHITECTURE_SPEC.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002FKERNELONE_ARCHITECTURE_SPEC.md)\n\n### 5-10 分钟：把桌面端跑起来\n\n```bash\nnpm run setup:dev\nnpm run dev\n```\n\n### 10-15 分钟：单独把后端跑起来\n\n```bash\npolaris --host 127.0.0.1 --port 49977\n```\n\n### 15-20 分钟：看三条关键代码主线\n\n优先浏览：\n\n1. [src\u002Fbackend\u002Fpolaris\u002Fkernelone](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fkernelone)\n2. [src\u002Fbackend\u002Fpolaris\u002Fcells\u002Froles\u002Fkernel](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Froles\u002Fkernel)\n3. [src\u002Fbackend\u002Fpolaris\u002Fcells\u002Fruntime](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fpolaris\u002Fcells\u002Fruntime)\n\n### 20-25 分钟：跑最小测试集合\n\n```bash\nnpm test\npython -m pytest -q tests\u002Farchitecture\u002Ftest_kernelone_release_gates.py\n```\n\n### 25-30 分钟：验证 E2E 与发布门禁\n\n```bash\nnpm run test:e2e\npython src\u002Fbackend\u002Fdocs\u002Fgovernance\u002Fci\u002Fscripts\u002Frun_kernelone_release_gate.py --mode all\n```\n\n## 测试与质量门禁\n\n### Python 侧最小门禁\n\n```bash\nruff check src\u002Fbackend\u002Fpolaris --fix\nruff format src\u002Fbackend\u002Fpolaris\nmypy src\u002Fbackend\u002Fpolaris\npytest src\u002Fbackend\u002Ftests -q\n```\n\n### 架构\u002F发布关键门禁\n\n```bash\npython -m pytest -q tests\u002Farchitecture\u002Ftest_kernelone_release_gates.py\npython src\u002Fbackend\u002Fdocs\u002Fgovernance\u002Fci\u002Fscripts\u002Frun_kernelone_release_gate.py --mode all\npython src\u002Fbackend\u002Fdocs\u002Fgovernance\u002Fci\u002Fscripts\u002Frun_catalog_governance_gate.py --workspace . --mode audit-only\n```\n\n### CI 工作流\n\n当前与质量最相关的工作流位于：\n\n- [quality-gates.yml](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002F.github\u002Fworkflows\u002Fquality-gates.yml)\n- [kernel_quality.yml](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002F.github\u002Fworkflows\u002Fkernel_quality.yml)\n- [ci.yml](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002F.github\u002Fworkflows\u002Fci.yml)\n\n## 未来方向\n\n### 1. 让 KernelOne 真正变成纯底座\n\n未来的关键方向之一，不是往 `KernelOne` 里继续堆业务语义，而是反过来做纯化：\n\n- 清理反向依赖\n- 清理角色语义泄漏\n- 清理绕过 `storage.layout` \u002F KFS 的旁路写盘\n\n目标是让 `KernelOne` 真正成为稳定、可复用、平台无关的 Agent Runtime Substrate。\n\n### 2. 把规范主干真正落成代码主干\n\n当前规范要求的主干是：\n\n- `delivery -> application -> domain\u002Fkernelone`\n\n未来最重要的架构收敛方向之一，就是让这条链路在真实代码里成立：\n\n- `delivery` 只做 transport\n- `application` 真正承担编排和事务边界\n- `domain` 真正承载业务规则\n- `cells` 通过 public contract 协作\n\n这一步做成以后，Polaris 的可维护性和可验证性会明显上一个台阶。\n\n### 3. 完成 TransactionKernel + ContextOS 的单一真相链\n\n未来真正决定 Polaris 上限的，不是增加多少工具，而是把以下链路彻底闭合：\n\n- `TransactionKernel` 成为唯一 durable commit authority\n- `ContextOS` 成为唯一上下文真相链\n- `run` 和 `stream` 不再形成第二提交通道\n- handoff 不再依赖 transport 差异\n\n这一点决定 Polaris 能不能从“能跑起来”走向“能长期稳定运行”。\n\n### 4. 让 graph、manifest 和治理 pack 变成可执行真相\n\nPolaris 已经有了 graph、cell manifest、packs、verification card、ADR、release gate 这些治理资产。  \n未来方向不是再增加更多文档，而是让它们真正成为系统边界和变更门禁的一部分：\n\n- `catalog\u002Fcells.yaml`\n- `cell.yaml`\n- `descriptor\u002Fcontext\u002Fverify pack`\n- release gate \u002F catalog gate \u002F ADR \u002F verification card\n\n一旦这条治理链完全打通，系统演进会更像工程系统，而不是“靠核心成员脑内记忆”的项目。\n\n### 5. 把可观测性做成 operator-grade\n\n未来方向不仅是“日志更多”，而是：\n\n- 统一事件事实\n- 统一 receipt \u002F evidence \u002F archive\n- 统一 runtime 状态与 UI 展示\n- 让 PM \u002F Director \u002F QA 的链路具备可回溯、可解释、可归因的观测能力\n\n这会直接决定 Polaris 能否支撑真正的长任务和无人值守场景。\n\n## 当前你最应该先读什么\n\n如果你要理解项目而不是只跑起来，建议按这个顺序读：\n\n1. [src\u002Fbackend\u002FAGENTS.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002FAGENTS.md)\n2. [src\u002Fbackend\u002Fdocs\u002FAGENT_ARCHITECTURE_STANDARD.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002FAGENT_ARCHITECTURE_STANDARD.md)\n3. [src\u002Fbackend\u002Fdocs\u002FKERNELONE_ARCHITECTURE_SPEC.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002FKERNELONE_ARCHITECTURE_SPEC.md)\n4. [docs\u002FTERMINOLOGY.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fdocs\u002FTERMINOLOGY.md)\n5. [src\u002Fbackend\u002Fdocs\u002Fgraph\u002Fcatalog\u002Fcells.yaml](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fsrc\u002Fbackend\u002Fdocs\u002Fgraph\u002Fcatalog\u002Fcells.yaml)\n\n如果你想看这次 README 重构背后的信息架构设计，见 [README_INFORMATION_ARCHITECTURE_BLUEPRINT_20260425.md](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002Fdocs\u002Fblueprints\u002FREADME_INFORMATION_ARCHITECTURE_BLUEPRINT_20260425.md)。\n\n## 支持与许可\n\n如果你想支持项目，请给作者买10杯咖啡吧。\n\n| 支付宝 | 微信支付 |\n|---|---|\n| ![支付宝赞助二维码](docs\u002Fassets\u002Fimages\u002Fcoffee\u002Falipay.jpg) | ![微信赞助二维码](docs\u002Fassets\u002Fimages\u002Fcoffee\u002Fwechat.jpg) |\n\n\n许可证：MIT，见 [LICENSE](\u002FC:\u002FUsers\u002Fdains\u002FDocuments\u002FGitLab\u002Fpolaris\u002FLICENSE)。\n","Polaris 是一个面向复杂软件交付场景的 AI Agent 治理与运行时平台。它将大型语言模型（LLM）降级为受限决策组件，由系统内核统一管理执行、审计、预算和回滚，从而实现企业级无人值守、可追责、可回滚的软件交付流水线。项目的核心功能包括内置 PM\u002FArchitect\u002FDirector\u002FQA 角色的三省六部权力分离架构、KernelOne 底座、ContextOS 三层记忆以及 EDA 任务集市等。Polaris 适用于需要高度自动化、可追溯性和可靠性的软件开发与交付环境，特别是在多角色协作、长链路任务管理和质量控制方面有严格要求的企业级应用场景。",2,"2026-06-11 02:46:20","CREATED_QUERY"]