伏羲工程 · 完整设计文档

版本：5.0
最后更新：2026-06-10
核心理念：让技术为文化服务，而不是让文化被技术异化。
设计哲学：以宪法为底线，以用户为主导，以中庸为魂，以中文为基。
核心机制：维度（原子认知范式）的有限派生与动态组合，走出堆参数的怪圈。
工程目标：为智能体建立可治理、可进化、可解释、可落地的认知框架。

目录

1. 核心理念
2. 总体架构
3. 宪法治理体系
4. 维度能力系统（基于易经之道）
5. 中庸协调器
6. 动态执行器
7. 文书系统（档案库）
8. 知识库系统
9. 跨智能体通信协议
10. 个人使用版
11. 组织部署版
12. 部署环境与要求
13. 测试与降级策略
14. 评估与总结
    附录

一、核心理念

1.1 文化定魂，技术为器：伏羲不是纯技术项目，而是中华文化在智能时代的延续。技术手段可以多元，文化内核必须自主。
1.2 治理而非控制：大模型是不可测的河，伏羲是治理河道的工程。不预设步骤，只设立安全航道。
1.3 维度是“道”的延伸：智能体的根本认知范式是有限的、正交的、可组合的，而非海量参数的无序涌现。
1.4 走出堆参数的怪圈：用结构化的认知单元替代无限扩大的参数规模，让智能体学会有组织、有计划的学习。
1.5 经验驱动而非硬编码：基于文书档案和用户反馈持续学习。
1.6 人机协同，用户主导：关键决策由用户确认，智能体提供建议。
1.7 中庸协调：和而不同，随语境应变，以用户需求为优先级。
1.8 全中文设计：维度定义、宪法条文、元词、注释、文档均使用简体中文；代码标识符可使用英文或拼音，以兼容工具链。

二、总体架构（渐进式治理）

个人版冲突处理：直接输出所有维度结果（不协调），或按预设顺序合并。

三、宪法治理体系

3.1 宪法内容

• 安全底线：禁止删除系统文件、禁止访问敏感路径。
• 伦理规范：不得生成违法内容、不得助长暴力。
• 人在回路：危险操作必须用户确认。
• 可审计：所有操作记入审计日志。
• 透明性：不得伪造输出。

3.2 宪法形式

• 自然语言文档：宪法.md（软约束，注入提示词）。
• 硬编码代码：宪法.py（强制检查点，不可绕过）。

3.3 强制检查点

• 工具调用前置校验（路径白名单、命令黑名单）。
• 用户确认强制。
• 输出后置过滤。
• 审计日志写入（不可篡改）。

3.4 修宪权梯度授权（仅组织版）

修宪规则：仅用户主动请求或测试模式；每次提案 ≤3 条；不可修改硬编码核心条款。

3.5 宪法豁免机制（仅组织版）

• 任务可申请临时豁免非核心条款（须明确操作、路径、条件、风险等级、缓解措施）。
• 审批通过后，执行器在严格范围内绕过检查。
• 豁免请求若24小时内未审批，默认拒绝并记录原因。
• 所有豁免请求/响应记入高安全审计日志。

四、维度能力系统（基于易经之道）

4.1 维度的本质

维度是“道”的延伸，是智能体认知世界和解决问题的根本视角。每个维度代表一种不可再分的、独特的认知范式，彼此正交（无重叠）。
维度的生成遵循易经之道：太极 → 两仪 → 四象 → 八卦 → 六十四卦。从“道”衍生出有限的、有结构的基本范畴，通过组合派生新范畴，而非无限细分。

4.2 基础维度（伏羲八维）

伏羲预设八个基础维度（对应八经卦），以单字或双字词命名，用现代汉语解释其内涵：

4.3 维度的存储格式（YAML）

每个维度一个 YAML 文件，放在 dimensions/ 目录。示例 dimensions/开.yaml：

name: 开
title: 创生
description: 开辟、创造、从无到有。生成新想法、新方案、新内容。
category: base      # base | derived
parents: []         # 派生自哪些维度（基础为空）
metaprompts:
  - "请发挥创造力："
  - "从新的角度思考："
  - "生成几个不同的方案："
conflicts: []       # 运行时自动发现
weight: 1.0

4.4 维度的有限进化：组合派生

八个基础维度通过“相生相克”关系组合派生新维度。例如：

• 开 + 止 → 创制（创新治理）
• 照 + 通 → 明达（深度沟通）
• 析 + 起 → 决行（精准行动）

派生规则：

• 相生：一个维度激活另一个（如开需要照来理解需求）
• 相克：维度之间存在制约（如开与止需平衡）

派生出的新维度数量有限（如从八卦派生出六十四别卦），维度库总规模保持在几十个以内。

4.5 何时增加新维度？

当出现现有维度无法独立或组合解决的新类型任务，且该任务模式反复出现时，系统自动生成维度扩展提案：

• 新维度的名称、描述、元词示例
• 它由哪些基础维度通过何种关系派生而来
• 它在实际任务中的潜在作用

用户审核通过后，新维度被添加，并记录其“生成族谱”。用户也可主动提出新维度，由系统辅助生成定义。

4.6 维度质量评估与进化

• 每个维度有独立的评估任务集，定期抽测。
• 用户反馈（点赞/踩）影响维度权重。
• 离线分析模块定期分析失败案例，提出元词优化建议或派生新维度提案，用户确认后更新。

五、中庸协调器（仅组织版）

5.1 设计原则

• 和而不同：承认不同维度的输出可能存在矛盾，不强求统一。
• 用户主导：最终决策权在用户，智能体提供选项。
• 语境感知：根据用户情绪、紧迫度、专业水平动态调整。
• 宪法优先：任何协调不得突破宪法安全边界。

5.2 冲突检测

由大模型在步骤序列中输出 conflict: true 字段显式标记冲突，或执行器根据维度输出语义相似度辅助判断。

5.3 协调流程

1. 收集各维度输出、用户原始任务、用户历史偏好、宪法约束。
2. 调用大模型生成2-3种融合方案（例如理性优先、感性优先、并列呈现）。
3. 若用户历史偏好置信度高（>80%）且任务不紧急，自动按偏好执行（仍记录日志）；否则将选项呈现给用户选择。
4. 按决策输出答案，并将冲突场景、用户选择记入文书。

5.4 语境感知

调用“语境分析”内置维度评估用户情绪、任务紧迫度、专业水平。无明确偏好且不紧急时优先询问用户；紧急时按历史偏好自动选择（记录日志）。

5.5 学习用户偏好

每次协调结果存入文书。每周分析统计用户在不同任务类型下的选择倾向，生成个人偏好配置（可手动覆盖）。

六、动态执行器

6.1 核心循环

1. 接收用户输入。
2. 构造元提示词（宪法摘要 + 可用维度列表 + 用户任务）。
3. 调用大模型生成步骤序列（JSON）。
4. 验证序列格式，若错误则请求修正（最多2次），仍失败则降级为直接回答。
5. 执行步骤：
   • 维度调用：激活对应维度，动态生成元词，调用大模型执行。
   • 工具调用：执行确定性工具（受宪法校验）。
   • 用户确认：暂停，等待用户输入。
   • 多维度冲突：调用中庸协调器。
6. 收集结果，合成最终回答。
7. 生成文书归档。

6.2 工具集

提供 读文件、写文件、执行命令、网络搜索（可选）等工具，均受路径白名单、命令黑名单控制。

6.3 超时与熔断

熔断：连续失败3步或死循环 → 暂停，请求用户干预。

七、文书系统（档案库）

7.1 文书定义

每次任务生成一份结构化记录（JSONL），包含：

• 任务编号、时间戳、用户输入。
• 生成的步骤序列及执行结果。
• 宪法检查记录、用户确认记录、豁免请求/响应。
• 中庸协调器调用记录（冲突内容、用户选择）。
• 消耗的令牌数、执行状态。

7.2 档案库分层

7.3 索引与检索

提供 查档案 工具，支持关键词、时间范围、标签查询。

7.4 用途

审计追溯、学习循环、断点续传。

八、知识库系统（仅组织版）

8.1 内容

静态领域知识、操作手册、代码片段、成功惯例。

8.2 存储

知识库/ 目录，Markdown/YAML，版本控制。

8.3 访问

提供 查知识 工具，按需检索（不自动注入上下文）。

8.4 进化

自动提炼：从成功文书中生成知识草案 → 用户确认 → 入库。

九、跨智能体通信协议

9.1 语法

[主体] 激活 [维度组合] [用引导 "元词"] 任务：<描述>

主体：我、智能体：标识、任意、所有。

9.2 能力发现与维度注册

智能体启动时向能力注册表上报支持的维度列表（含维度名称、描述、语义示例、inference_profile可选）。发送方可通过 any WITH 维度:开 请求具有该维度的智能体。

9.3 印信机制

SEAL（长期密钥） + DYNAMIC（HMAC签名 + 时间窗口），防重放。

9.4 安全与认证

预共享密钥/OAuth2 + TLS，请求签名防重放。

9.5 协议网关

提供人机自然语言转换，自动填充主体、维度、元词、印信等。支持意图识别（规则/embedding/小模型），自动补全维度匹配（相似度>0.9自动添加，0.7-0.9仅填充ACTIVATE，<0.7返回候选）。

9.6 嵌入式维度引擎

基于小模型（≤7B）的智能体，直接理解 TASK: 字段，自主规划行动。包含安全沙箱（注入过滤、工具白名单、步数限制、宪法检查）。

9.7 异构适配

通过 inference_profile 字段描述推理能力，路由器根据模型家族、上下文长度等筛选，支持热插拔和版本过渡。

十、个人使用版（轻量治理）

10.1 核心组件

• 宪法 + 基础执行器 + 文书 + （可选）少数维度
• 冲突处理：直接输出所有维度结果（不协调），或按预设顺序合并。

10.2 特点

• 用户只需编辑 宪法.md，无需学习维度、知识库等。
• 大模型自主规划步骤序列。
• 支持断点续传、基础审计。

10.3 实施路线

• MVP（1周）：宪法硬编码 + 读文件 + 用户确认 + 热档归档
• 迭代（2周）：增加更多工具、超时熔断、基础文书索引

十一、组织部署版（完整治理）

11.1 核心组件（个人版基础上增加）

• 维度系统（8基础 + 有限派生）
• 元词动态生成
• 知识库
• 梯度修宪权、豁免消息机制
• 中庸协调器（完整版）
• 自优化学习循环
• 高安全审计日志
• 跨智能体通信网关、嵌入式维度引擎、异构适配

11.2 实施路线

十二、部署环境与要求

12.1 硬件要求（最低/推荐）

12.2 软件环境

• Python 3.10+（清华源）
• 本地模型服务：LM Studio / Ollama
• 可选：Chroma、Redis/RabbitMQ

12.3 配置文件 config.yaml

（包含宪法、模型服务、文书、工具白名单、维度库、知识库、学习循环、中庸协调器、跨智能体等配置）

12.4 网络要求

可完全离线运行（除在线搜索工具外）；在线搜索需配置国内API或浏览器自动化。

十三、测试与降级策略

13.1 测试模式

启动参数 --test，自动批准低风险修宪提案、豁免消息自动通过、模拟外部服务调用，写入独立日志。

13.2 降级策略

• 网关超时（>200ms）→ 降级为规则模式。
• 小模型输出解析失败 → 重试一次，仍失败返回错误并记录。
• 模型热插拔期间收到旧能力请求 → 重定向或转发。
• 宪法检查失败 → 直接拒绝操作。

十四、评估与总结

14.1 核心优势

14.2 适用场景

• 个人创作、代码辅助、数据分析
• 自动化运维、教育辅导
• 企业内部助手、合规审查
• 开源社区治理

14.3 总结

伏羲智能体框架是一套以“治理”为核心、以中华文化为底蕴、渐进式可扩展的大模型应用架构。它通过宪法划定安全边界，通过维度（有限、正交、可派生的认知范式）打破堆参数的怪圈，通过元词动态激活维度，通过执行器保障确定性，通过文书实现审计，通过中庸协调器处理冲突，通过协议网关、嵌入式引擎、异构适配实现跨智能体互联与边缘部署。

伏羲不是替代大模型，而是为混沌立文明。
让技术为文化服务，而不是让文化被技术异化。

九三无咎。不是因为完美，而是因为可治理、可进化、可掌控。

附录

A. 维度YAML模板
B. 网关配置示例
C. 嵌入式维度引擎安全沙箱代码片段
D. inference_profile JSON Schema
E. 与核心协议章节交叉引用表

附录A：维度YAML模板
yaml

dimensions/开.yaml

name: 开
title: 创生
description: 开辟、创造、从无到有。生成新想法、新方案、新内容。
category: base
parents: []
metaprompts:

• “请发挥创造力：”
• “从新的角度思考：”
• “生成几个不同的方案：”
  conflicts: [] # 运行时发现
  weight: 1.0
  其他维度（藏、起、照、转、析、止、通）同理，仅修改 name、title、description、metaprompts。

派生维度示例 dimensions/创制.yaml：
name: 创制
title: 创新治理
description: 在创造与约束之间取得平衡。
category: derived
parents: [“开”, “止”]
metaprompts:

• “请在安全边界内发挥创意：”
• “既要创新又要合规：”
  conflicts: []
  weight: 0.8