# EQUAXIS · 衡枢
**被治理的 Agent 运行时 · The governed agent runtime**
> 🇨🇳 **衡枢 Equaxis** — 不重写 Pi:通过 Extension API 在 Pi 内核之上,加确定性护栏、受治理的记忆、代码知识图谱与诚实的评估闭环。
>
> 🇬🇧 **Equaxis** — doesn't rewrite [Pi](https://pi.dev/). It rides on `@earendil-works/pi-coding-agent` via the extension API, adding deterministic guardrails, governed memory, a code knowledge graph, and an honest evaluation loop.
```text
┌──────────────────────────────────────────────────────────────┐
│ Pi Kernel 0.83 │
│ models · sessions · TUI · tools │
└──────────────────────────────┬───────────────────────────────┘
│ extension events
┌──────────────────────────────▼───────────────────────────────┐
│ Equaxis Harness │
│ policy · audit · approvals · trace · validation │
└───┬───────┬─────────┬──────────┬─────────┬────────┬──────────┘
▼ ▼ ▼ ▼ ▼ ▼
Memory CodeGraph Subagents Eval Skills GoalState Pi-Web
Chroma symbols DAG holdout SKILL.md quota dashboards
+ KG / calls no-replay gates + refine + wake + traces
```
## 能力矩阵
| 领域 | 亮点 |
|---|---|
| 🛡️ **治理** | 确定性风险分级、敏感路径保护、人工审批、L1 审计轨迹、双审门禁 |
| 🧠 **记忆** | 记忆宫殿抽屉、Dream 整合、带**溯源 + 防篡改校验**的知识图谱事实、多跳图检索、Wiki 文档索引 |
| 🗺️ **CodeGraph** | TS 编译器构建符号/导入/调用索引——调用者、影响面、死代码、编辑覆盖 |
| 🤖 **子代理** | DAG 调度、按模型并发分桶、机器可检查证据、**no-replay 重试**策略 |
| 🎯 **评估** | holdout 双集接受门、能力×版本交叉矩阵、**决策溯源链** |
| 📚 **技能** | SKILL.md 生命周期、负空间路由、GitHub 远程安装、可回滚 refine 账本 |
| 🎯 **长任务** | 持久目标状态、token 配额、门控、租约、交接、定时自动唤醒 |
| 📡 **可观测** | JSONL trace、provider 前缀缓存稳定性、pi-web 实时仪表盘 |
## 快速开始
```powershell
git clone https://github.com/6Riemann9/equaxis-agent.git
cd equaxis-agent
npm run setup # 工具链检查 + 安装 + doctor
$env:OPENAI_API_KEY = "