aurora-cloudbank-symbolic

奥罗拉云银行符号 [](https://github.com/AUo959/aurora-cloudbank-symbolic/actions/workflows/aurora-ci-minimal.yml) [](https://github.com/AUo959/aurora-cloudbank-symbolic/actions/workflows/codeql-unified.yml) [](https://www.python.org/downloads/) [](LICENSE) 一个FastAPI平台，用于在长时间内保持机器生成的知识的一致性：分层内存、溯源跟踪状态、几何伦理执行、漂移检测和生产可观察性。 它也是奥罗拉（Aurora）的代码和正典仓库，奥罗拉是奥里恩站（Orion Station）机构模拟的模拟总监。 这并不是装饰性的工程——它才是工程的真正目的。 在长时间内保持大型、LLM生成的语料库在会话、模型更改和贡献者之间的一致性，是该系统存在的目的，而模拟则是它所解决的语料库：足够大以至于冲突是非 trivial 的，生命周期足够长以至于漂移是真实的，而不是假设的，并且没有外部真实性，这迫使真正的内部一致性机制，而不是对照别人的答案密钥。 所以模块列表包含`src/middleware/`和`modules/crew_agents/`，两者都是承载负载的。 > **新工程师？** 从[`GETTING_STARTED_ENGINEER.md`](./GETTING_STARTED_ENGINEER.md)开始，然后运行`python scripts/aurora_onboard.py`进行存储库基础的首次交互。 > > **查看架构？** 从[`ARCHITECTURE_QUICKMAP.md`](./ARCHITECTURE_QUICKMAP.md)开始，快速了解层结构、运行时流程和代码映射。 > > **想知道为什么要这样构建？** 阅读[`docs/archive/philosophy/`](./docs/archive/philosophy/PHILOSOPHY.md)——七份文件，从一个关于可审计推理的原则导出架构。 基础设计意图，而不是当前运行时正典。 > > **想看看它的工作原理？** [`docs/WALKTHROUGH.md`](./docs/WALKTHROUGH.md)跟踪一个请求从头到尾的过程——十个中间件、两个CSRF检查、内存层和可观察性记录。 其中每个响应都是通过运行命令生成的。 > > **怀疑？** [`docs/VERIFIED_CLAIMS.md`](./docs/VERIFIED_CLAIMS.md)将本README中的每个声明与证明或证伪它的命令配对，以及该命令产生的结果。 > > **寻找特定文档？** [`docs/index.md`](./docs/index.md)映射每个文档目录，并说明每个目录的权威性。 > > **新AI代理或Copilot会话？** 从[`AGENTS.md`](./AGENTS.md)（引导协议和规则）和[`AURORA_CONTEXT.json`](./AURORA_CONTEXT.json)（机器可读的概念图）开始。 --- ## 目录 - [快速入门](#快速入门) - [架构](#架构) - [模块](#模块) - [API](#api) - [配置](#配置) - [测试](#测试) - [开发](#开发) - [贡献](#贡献) --- ##入门 **要求：** Python 3.11+，pip ```bash git clone https://github.com/AUo959/aurora-cloudbank-symbolic.git cd aurora-cloudbank-symbolic # 推荐：引导式 onboarding + 方向 + 服务器启动） make onboard ``` 或手动： ```bash # 创建虚拟环境并安装依赖 python -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate pip install -r requirements.txt # 配置环境 cp .env.example .env # 编辑 .env — 设置 AURORA_SECRET_KEY, JWT_SECRET_KEY, CSRF_SECRET_KEY, WS_AUTH_SECRET # （使用以下命令生成：openssl rand -hex 32） # 启动服务器 python api/aurora_api.py ``` 服务器运行在`http://localhost:8000`。交互式API文档在`http://localhost:8000/docs`。 **可选依赖** （量子计算后端、数据分析）： ```bash pip install -r requirements-optional.txt ``` --- ## 架构 ``` aurora-cloudbank-symbolic/ ├── api/ # FastAPI 应用（aurora_api路由注册） ├── modules/ # 功能模块（30+ 模块） ├── src/ # 跨领域关注点 │ ├── middleware/ # CSRF，速率限制，JWT，PII 过滤，主体大小 │ ├── monitoring/ # 漂移检测，伦理引擎，审计日志 │ ├── observability/ # R2 遥测，分布式跟踪，Prometheus 指标 │ ├── synergy/ # 组件注册和依赖图 │ ├── integrations/ # ChatGPT 和 Gemini 代理集成 │ └── core/ # DLP 跟踪，请求信封，时间工具 ├── tests/ # 293 个测试文件（pytest） ├── docs/ # 参考文档 ├── scripts/ # 开发和维护自动化 └── cli/ # 命令行工具 ``` 所有模块都遵循一致的布局：`__init__.py`，`core.py`，`api.py`，`models.py`。主服务器（`api/aurora_api.py`）在启动时注册每个模块的路由器，优雅地跳过任何可选依赖不可用的模块。 ### 关键设计决策 - **优雅降级**：可选模块（量子云后端、Qiskit、scipy）降级为备用方案，而不是在启动时崩溃。 功能可用性在启动时记录。 - **Pyd2**：所有请求/响应模型都使用 Pydantic V2（`model_config`，`ConfigDict`）。 不使用 V模式（`class Config`，`max_items`）。 - **DLP 跟踪**：每个持久操作都带有 `context_tag` 并为审计跟踪连续性生成 SHA-256 符号哈希。 - **异步贯穿始终**：所有 I/O 绑定操作都使用 `async def`。 阻塞调用是隔离的。 --- ## 模块 ### 核心平台 | 模块 | 位置 | 描述 | |---|---|---| | AuMemManager | `modules/aumemmanager/` | 分层内存：活动（1K），压缩（5K），存档（50K）层。 SHA-256 内存密封。 | | 量子锻造 | `modules/quantum_forge/` | 量子符号代理生成（v3.0）。 纠缠网络，快乐驱动的演化，伦理感知门。 | | 量子模拟器 | `modules/quantum_simulator/` | 种模拟场景（供应链，能量网格，风险分析，分子，投资组合，加密，一般）。 4 个云后端：AWS Braket，Azure Quantum，IBM Quantum，Google Cirq。 | | AI 核心 | `modules/ai_core/` | 克劳德（Sonnet/Op GPT（4o/4.1）上的统一 AI 接口。 自动模型选择。 | | 符号核心 | `modules/symbolic_core/` | 几何代数（Clifford，10K 维度），量子符号向量架构。 | | 向量生成 | `modules/vector_gen/` | 符号向量链管理。 5 种拓扑，6 种注入模式。 | ### 伦理和安全 | 模块 | 位置 | 描述 | |---|---|---| | 伦理领域 | `modules/ethics_field/` | 几何伦理曲率。 五维加权场（Picard_Delta_3，thermax_continuity，层完整性，集体福利，透明度）具有硬零否决和阻力级别。 | | GUMAS | `modules/gumas/` | 伦理治理，漂移阈值强制执行，对齐干预。 | | 数据守护者 | `modules/data_guardian/` | PII 检测和日志净化。 | | 见解账本 | `modules/insight_ledger/` | 不变审计轨迹，DLP 合规性。 | | 弹性哨兵 | `modules/resilience_sentinel/` | 健康监测和异常遏制。 | | 反射自主性 | `modules/reflective_autonomy/` | 具有自我监测的自主推理。 | ### 基础设施 | 模块 | 位置 | 描述 | |---|---|---| | 奈克萨斯 | `modules/nexus/` | 中央集成中心（58 个组件依赖）。 | | 奥帕尔2 | `modules/opal2/` | 具有可插拔子系统的模块化系统。 | | 检查点保险库 | `modules/checkpoint_vault/` | 状态检查点和恢复。 | | 连续性 | `modules/continuity/` | 线程连续性和 T1/SRB 锚点管理。 | | 人力资源系统 | `modules/hr_system/` | 人力资源操作。 | | CASK | `modules/cask/` | 文化意识和敏感性评分。 | | QGIA | `modules/qgia/` | QGIA 代理框架。 | | 乘员代理 | `modules/crew_agents/` | 多代理乘员协调。 | ### 跨领域服务（src/） | 组件 | 位置 | 描述 | |---|---|---| | 监控 | `src/monitoring/` | 漂移检测器（z-score），伦理引擎（基于规则），行为监视器，审计日志与哈希链验证。 | | 可观察性 | `src/observability/` | R2 代理遥测：分布式跟踪，Prometheus ，P50/P95/P99 延迟，PII 过滤。 | | 协同作用 | `srcergy/` | 组件注册表，依赖图，，瓶颈检测。 | | 中间件 | `src/middleware/` | CSRF 保护，速率限制（SlowAPI），JWT 身份验证，PII件，主体大小限制，幂等性。 | --- ## API 服务器282 个路径30 个标签公开 个操作；核心四个所需密钥已设置； 302 个操作294 个路径公开，完整的 `.env` 和可选功能已安装。注册会跳过可选的模块，因此根据您的配置而有所不同。 所有路由都返回 JSON。 **访问交互式文档：** - Swagger UI：`http://localhost:8000/docs` - ReDoc：`http://localhost:8000/redoc` - OpenAPI 架构：`http://localhost:8000/openapi.json` **端点组（精选）：** | 组 | 前 描述 | |---|---|---| | AuMemManager | `/memory/` | CRUD，语义检索，量子向量创建，指标 | | 器 | `/ | 场景执行，后端选择，结果检索，| 协同作用synergy/` | 组件注册表，依赖图，健康状态 | | `/monitoring/` | 漂移警报，基线，行为检查 | | 见解账本 | `/ledger/` | 审计，链验证，导出 | | R2 遥测 | `/r2-telemetry/` | 跟踪导出，Prometheus 指标 GUMAS |umas/` | 伦理对齐强制执行 传感器 | `/api/sensors/` | 系统列 | | 子 `/subroutines 注册和沙盒执行 | **更改状态的请求需要 CSRF 令牌 从 `GET /api/csrf-token` 获取一个，并将其作为 `X-CSRF-Token`回去： ```bash TOKEN=$(curl -:8000/api/csrf-token | jq -csrf_token) curl POST localhost:8000/memory/create \ -H "Content-Type: application/json" \ -H "X-CSRF-Token: $TOKEN" -H: Bearer $TOKEN -d '{"content":"hello","memory_type","owner":"you"}' ``` `/api/auth由仅在配置了身份验证用户时注册AURORA_AUTH_USERS 或 `AURORA_AUTH_USERS_FILE`）；运行启动时不会注册它，并记录原因。 **CloudHub GUI 路由- `/` 和 `/simulation-console` — 奥控制台 -ergy-dashboard` —作用仪表盘 UI `/legacy/vsa 退休量子 VSA乐场通知docs/reference/API_CATALOG.md`](/API_CATALOG 以获取完整的路由### MCP 连接器拉的实时状态也通过 [模型上下文协议](https://modelcontext) 公开，因此任何支持 MCP 的主机（Claude Desktop、Claude Code 等）都可以直接读取它。 五种只读工具：`aurora_get_state`、`aurora_get_agents`、`aurora_get_drift`、`aurora_get_ethics_log`、`aurora_get_capsules`。 ``` install -r requirements-optional.txt # 提供 mcp SDK python -m connector.server # stdio 传输 ``` 提升操作在 HMAC 签名、过期飞行员密封后面。 设置、传输选项和现成的 `claude_desktop_config.json`在 [`connector/READMEconnector/README.md) 中。 --- ## 配置 复制 `.env.example` 到 `.env` 并设置： | 必需 | 描述---| | `AURORA_SECRET_KEY` | 64-十六进制加密签名密钥 | JWT_SECRET_KEY` | 是 | 64- JWT 签名| `CSRF` | 是 |-十六进制 CSRF HMAC 密钥 | | `WS_AUTH_SECRET` | 是 | 64-十六进制 WebSocket HMAC 密钥 | | `ALLOWED_C` | 否 | 逗号分隔的（默认：localhost| `RATE_LIMIT_ENABLED` | 否 |速率限制（默认true`） | | `REDIS_URL` | 分布式速率限制的 Redis URL | | `ACCESS_TOKEN_EXPIRE_MINUTES` | 否 | JWT 访问令牌生命周期（默认：30） | 生成密钥：`openssl rand -hex 32` 对于可选的 AI 集成： | 变量 | 描述 | |---|---| | `ANTHROPIC` | 克劳德 API 访问 | | `OPENAI_API_KEY` | 访问 | |_QUANTUM_TOKEN` | IBM 量子后端 | | `AZURE_QU_*` | Azure 量子工作区凭证 `AWS_*` | AWS Braket 凭证## 测试 ```bash # 完整件 pytest # 仅限快速单元pytest -m# 集成测试 pytest -m integration pytest -m quantum pytest -m pytest - # 跳过慢速测试 pytest -m "not slow" # 特定文件 pytest tests/test_quantum_forge_v3.py -v ``` **测试标记：** `unit`，`integration`，`slow`，`smoke`，`critical`，`quantum`，`aurora`，`security`，`api`，`observability`ai`，`simulation`，`resilience`，`benchmark`，`regression` **覆盖率：** pytest --cov=modules --cov=src-report=html--- ## 开发 **Makefile 目标：** make onboard # [开始这里] 引导式设置 + 方向 + 服务器启动 # 创建虚拟环境，安装依赖，验证make serve # 启动 API 服务器（uv，端口 8000） make test # 运行套件 # 检查模块/reflective_autonomy（作用域） make lint-all 检查 src/，modules/，tests// make check -tools + 完整快速稳定性检查 # 运行安全 + bandit 扫描 deps-check # 依赖冲突检测 make health-check # 仓库健康报告 make quicksave DESC="..." #开发状态 ``` **提交格式** （约定提交）： ``` feat: 添加量子内存压缩 fix: 解决漂竞争条件 docs API 参考 refactor: 整合伦理字段评估器 test进化引擎率 ``` **：** `feature` 或 `escription` **代码** - 黑色，120 字符行- isort（黑色兼容配置文件） - flake8 带有标准忽略（E203，W503） - 公共函数提示 - 不允许注释解释代码的作用 — 只有非显而易见的原因 --- 贡献 1. 分叉仓库并创建。 2. 遵循模块结构模式（`core.py`，`api.py`，`models.py`，`tests/`）。 3. 添加具有适当标记的测试。 目标是新代码覆盖率 >90%。 4. 在推送前运行 `make check`。 5. 对 `main` 分支打开拉取请求，并附上约定提交标题。 参见 [CONTRIBUTING.md](CONTRIBUTING.md) 以获取完整的贡献指南。 --- ## 许可证 MIT — 参见 [LICENSE](LICENSE)。