# Emperors Aura **Repository Path**: to-doing/emperors-cc-aura ## Basic Information - **Project Name**: Emperors Aura - **Description**: 意识走出时间——从中国历代帝王将相身上萃取可迁移的思维操作系统，让普通人快速习得顶级认知模式。 不是历史数据库，是智慧直传系统。 - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2026-05-09 - **Last Updated**: 2026-07-29 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Emperor Cognition · 帝王认知体 > 意识走出时间——从中国历代帝王将相身上萃取可迁移的思维操作系统，让普通人快速习得顶级认知模式。 不是历史数据库，是**智慧直传系统**。 --- ## 这是什么 《三体》里三体人用"知识灌输"让个体瞬间获得文明积累。这个项目在做类似的事： **从中国历史中认知天花板级别的人物身上，逆向工程出可迁移的思维模型，打包成可安装的"认知操作系统模块"。** 传统知识传承是"给你信息，自己悟"。帝王认知体是"直接把思维操作系统装进你的脑子"。 ## 核心概念：意识体 **意识体 = 一个可迁移的思维模型 = 一个可安装的认知模块** 每条意识体包含： | 字段 | 含义 | 示例 | |------|------|------| | `mental_model` | 写成普通人可执行的步骤 | "批评来自信任的人时，记录但不反驳，24 小时后回应" | | `modern_parallel` | 现代生活中的平行场景 | "CEO 面对董事会质疑时的决策框架" | | `counter_example` | 这个模型失败的历史案例 | "杨广用同一套决策框架导致隋朝灭亡" | | `context_trigger` | 什么情况下该激活这个模型 | "当信息不完整但必须做决策时" | | `confidence` | 可信度评分 (0.0 ~ 1.0) | 0.85（有正史原文支撑） | **双层描述法**：每条意识体都有历史层（忠实原文）+ 抽象层（可迁移模型），确保既有史料根基又能为现代人所用。 ## 为什么是帝王将相 他们是人类认知天花板的样本： - **信息极度不对称** — 不知道大臣说的是真话还是假话 - **决策关乎生死** — 一个错误可能导致千万人死亡、王朝覆灭 - **多方博弈** — 同时处理人心揣摩、时势判断、利益平衡 - **最残酷的实战检验** — 不是理论推演，是生死博弈中活下来的思维模式 目标：让普通人也能学到、接触到、悟到这些顶级认知模式。 ## 17 种思维模块 ### 皇帝的 8 种思维操作系统 | 模块 | 本质 | 学了能干什么 | |------|------|-------------| | `decision_framework` 决策框架 | 面对两难时的判断算法 | 做重大选择时不纠结 | | `people_reading` 识人术 | 判断谁可信/可用的认知模型 | 快速看透一个人 | | `game_theory` 博弈思维 | 多方利益冲突中的平衡术 | 在复杂人际关系中不被吃掉 | | `crisis_psychology` 危机心智 | 压力下思维升级而非崩溃 | 遇到大事不慌 | | `power_cognition` 权力认知 | 权力从哪来、怎么维持、怎么交接 | 理解组织中的权力运作 | | `era_insight` 时代洞察 | 理解自己处于历史周期的哪个位置 | 看清大势，不做逆势而行的事 | | `failure_pattern` 失败模式 | 思维盲区如何导致崩盘 | 认识自己的认知缺陷 | | `growth_arc` 成长弧线 | 思维如何随人生阶段进化 | 在不同人生阶段调整思维方式 | ### 大臣的 4 种思维操作系统 | 模块 | 本质 | 学了能干什么 | |------|------|-------------| | `advisory_framework` 谏言术 | 如何让掌权者听进逆耳之言 | 向上管理，让领导听你的 | | `influence_mechanism` 影响力 | 如何让自己的想法被采纳 | 不靠权力也能推动事情 | | `survival_intelligence` 生存智慧 | 如何在政治危险中全身而退 | 在办公室政治中活下来 | | `reform_methodology` 改革方法论 | 如何在旧体制内推动变革 | 推动组织变革不被干掉 | ### 君臣碰撞的思维实验 | 模块 | 本质 | |------|------| | `cognitive_complement` 认知互补 | 两种思维如何形成 1+1>2 | | `cognitive_clash` 认知冲突 | 两种思维如何互相毁灭 | | `cognitive_transplant` 认知移植 | A 的思维操作系统放到 B 的处境中，能救 B 吗？ | ### 中国哲学独有维度 | 模块 | 哲学根源 | 说明 | |------|---------|------| | `shi_cognition` 势 | 韩非子《难势》 | 动态的、可造的、会衰减的力量场 | | `timing_wisdom` 时 | 《周易》"君子藏器于身，待时而动" | 宇宙节律，不是简单的"时机" | ## 数据管线 ``` 采集 入库 萃取 验证 图谱 输出 ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐ │爬虫从│ │原文写│ │Claude│ │5 项质│ │意识体│ │API 提│ │维基/ │───>│入 source│───>│API 逆│───>│量测试│───>│之间关│───>│供查询│ │CText/│ │_excerpts│ │向工程│ │+镜像 │ │系构建│ │+学习 │ │百度 │ │表 │ │思维 │ │测试 │ │知识 │ │路径 │ │百科 │ │ │ │模型 │ │ │ │图谱 │ │推荐 │ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ └──────┘ ``` - **采集** — scrapling 反爬框架从维基百科抓取史料原文 - **入库** — 原文写入 `source_excerpts` 表，保留出处和可信度等级 - **萃取** — Claude API 从原文中逆向工程思维模型，写入 `cognitive_patterns` - **验证** — 5 项质量测试 + 镜像测试，低于 3.0 分重新萃取 - **图谱** — 意识体之间的关系构建为知识图谱 - **输出** — API 提供意识体查询、学习路径推荐 ## 质量铁律 ### 5 项质量测试 | 测试 | 权重 | 标准 | |------|------|------| | 可迁移性 | 25% | 现代人无历史知识也能理解和应用 | | 具体性 | 20% | 不是空洞道理，是可执行的步骤 | | 可证伪性 | 15% | 有明确的失败条件和反例 | | 证据性 | 20% | 至少一个具体历史事件（时间、人物、事件） | | 反例性 | 20% | 至少一个真实的历史失败案例 | 综合评分满分 5.0，低于 3.0 的意识体必须重新萃取或标记"待改进"。 **镜像测试**：把历史人名替换成现代场景，如果模型依然成立，则通过。 ### 史料可信度分级 | 等级 | 来源 | 可信度 | |------|------|--------| | S 级 | 二十四史原文、《资治通鉴》 | 0.9 | | A 级 | 《贞观政要》等典制体 | 0.85 | | C 级 | 现代学术论文 | 0.7 | | B 级 | 笔记小说 | 0.6 | | D 级 | 维基百科 / 百度百科 | 0.4 | | E 级 | 影视剧 / 小说 | 0.1 | 铁律：`confidence > 0.7` 的意识体必须有 S 级或 A 级史料原文支撑。不同来源矛盾时，记录不裁决，标注"史料争议"。 ## 技术栈 - **后端**: Python 3.11 / FastAPI / SQLAlchemy / PostgreSQL - **数据采集**: scrapling（反爬） / httpx / BeautifulSoup4 - **AI 引擎**: LLM API（自定义端点）— 意识体萃取的核心引擎 - **知识图谱**: networkx / pyvis - **前端**: React 18 / TypeScript / Vite / Tailwind CSS v3 / react-force-graph-2d - **向量检索**: ChromaDB / sentence-transformers（bge-small-zh-v1.5） - **对象存储**: S3/MinIO（boto3） - **数据验证**: pydantic - **CLI**: rich ## 快速开始 ```bash # 克隆项目 git clone cd emperors-cc-aura # 创建并激活虚拟环境 python -m venv .venv # Windows: .venv\Scripts\activate # Linux/Mac: source .venv/bin/activate # 安装依赖 .venv/Scripts/pip install -e ".[dev]" # Windows # pip install -e ".[dev]" # Linux/Mac # 验证安装 .venv/Scripts/python -c "from src.models.schema import Figure; print('OK')" # 运行测试 .venv/Scripts/pytest tests/ ``` > 详细步骤见 [QUICKSTART.md](docs/getting-started/QUICKSTART.md) ## 项目结构 ``` emperors-cc-aura/ ├── src/ │ ├── models/ # 数据模型：7 表 / 8 枚举，项目的数据基座 │ ├── utils/ # 工具模块（雪花ID生成） │ ├── vector/ # ChromaDB 向量检索层 │ ├── scrapers/ # 数据采集：Wikipedia / Wikisource / 殆知阁爬虫 │ ├── etl/ # ETL：文本切分、清洗 │ ├── storage/ # S3/MinIO 对象存储封装 │ ├── extractors/ # AI 引擎：Claude API 意识体萃取 │ ├── db/ # 数据库：连接管理 + 种子脚本 │ ├── web/ # Web 应用：FastAPI 后端 │ ├── knowledge_graph/ # 知识图谱：关系网络构建与查询 │ └── learning/ # 学习路径引擎（path_builder, curator） ├── frontend/ # React + Vite 前端（TypeScript, Tailwind CSS） ├── scripts/ # 正式脚本（采集、迁移） ├── data/ │ ├── raw/ # 原始爬取数据 │ ├── processed/ # 处理后数据 │ └── exports/ # 导出数据 ├── plans/ # 版本规划（v0.1 ~ v2.0，含完整生命周期文档） ├── docs/ # 结构化文档 ├── tests/ │ ├── unit/ # 单元测试 │ ├── api/ # API 测试 │ └── integration/ # 集成测试 ├── .claude/ # Claude Code 配置（rules / skills） ├── CLAUDE.md # 开发规范 ├── CHANGELOG.md # 变更日志 └── VERSION # 版本号 ``` ## 版本路线图 | 阶段 | 版本 | 目标 | 状态 | |------|------|------|------| | 基座 | v0.1 | 项目骨架（数据模型、枚举、DB、爬虫基类） | **已完成** | | 数据 | v0.2 | 维基百科数据管线（56 位人物） | **已完成** | | 数据 | v0.3 | PostgreSQL + Wikisource 古籍采集 | **已完成** | | **核心** | **v0.4** | **意识体萃取引擎 + ChromaDB 向量检索 + 112条意识体** | **已完成** | | 数据 | v0.4.1 | CBDB 人物库 + 全唐诗数据扩展 | **已完成** | | 迁移 | v0.5 | 雪花ID迁移（BigInteger PK + sn_id 语义标识） | **已完成** | | **核心** | **v0.5.1** | **君臣关系动态建模（5对关系 + 信任轨迹 + 碰撞分析）** | **已完成** | | 图谱 | v0.6 | 知识图谱构建 + 图谱增强 | **已完成** | | 应用 | v0.7 | FastAPI 后端 + D3.js 图谱可视化 | **已完成** | | **扩展** | **v0.8** | **多帝破壁（3帝14臣 + 135条意识体 + 跨朝代分析API）** | **已完成** | | 应用 | v0.9 | 学习路径 + React 前端 + 分析引擎 | **已完成** | | 数据 | v0.9.1 | 技术债清理 + 数据补全（50帝82臣全覆盖 + 600意识体 + 3408图谱边） | **已完成** | | 原型 | v0.10.0 | 问古人 RAG 对话（v1.0 前置原型） | **已完成** | | **补丁** | **v0.10.1** | **用户身份持久化 + qa_records 表 + 反馈按钮（堵北极星指标数据流失）** | **新增，待执行** | | **质量门** | **v0.10.2** | **枚举重构 17→15 + 置信度审计 + QA 压测（v1.0 前置）** | **新增，待执行** | | **里程碑** | **v1.0** | **灵魂灌输引擎（四阶段感/悟/用/破 + InfusionRecord + 30 天追踪）** | **提前启动** | | 数据 | v0.11 | 势/时萃取 + 碰撞扩展 + failure_taxonomy 语义化 + 前端三层可视化 | 推迟到 v1.0 之后 | | 进化 | v1.1 | 个性化学习 + 用户画像 | 规划中 | | 进化 | v2.0 | 认知进化引擎（跨朝代元知识发现） | 规划中 | > 2026-07-29 路线调整说明：[docs/strategy/路线调整_2026-07-29.md](docs/strategy/路线调整_2026-07-29.md) > 完整规划文档见 `plans/` 目录 ## 哲学基座：意识走出时间 "修仙长生"是妄想——生物载体必然消亡。但"意识走出时间"不是妄想，路径是**文明知识传承**。 | 传承方式 | 载体 | 速度 | 损耗 | |---------|------|------|------| | 基因传承 | DNA | 极慢（代际） | 仅本能，无认知 | | 经验传承 | 个人经历 | 慢（一生） | 亲历者死去，经验消失 | | 知识传承 | 文字/符号 | 中（阅读+悟） | 读书不等于理解，理解不等于会用 | | **意识体传承** | **结构化认知模型 + LLM** | **极快（几小时）** | **低——模型可验证、可迭代** | "走出时间"的三层含义： 1. **个体层面** — 普通人花几小时习得李世民一辈子的决策框架，认知进化不再受限于个人寿命 2. **文明层面** — 每一代人不再从零开始，以上一代认知精华作为起点 3. **认知进化层面** — 当数据量足够大，人类可能第一次看到"认知本身的规律" ## 开发 - **开发规范**: [CLAUDE.md](./CLAUDE.md) - **开发计划**: `plans/` 目录（按版本组织，含 initiation / execution / closure 生命周期） - **文档索引**: [docs/INDEX.md](./docs/INDEX.md) ## License [待定]