File size: 4,112 Bytes
3fbf491 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 | # -*- coding: utf-8 -*-
"""合并 README.zh-CN + docs/* + ALGORITHM 为一个可阅读全文的入库入口 Markdown。
版本号、发布包大小与 SHA256 均在运行时动态读取（不硬编码），避免"源码里记录的
zip SHA 反过来改变 zip"的自引用问题。流程：先 make_release.py 打包，再运行本脚本。
"""
from pathlib import Path
import hashlib
import os
import sys
ROOT = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
PARENT = os.path.dirname(ROOT)
DOC_ORDER = [
("architecture", "一、架构详解"),
("scheduler", "二、调度器（心跳）"),
("guard", "三、守卫（安全边界）"),
("memory", "四、记忆（三层存储）"),
("graph", "五、自适应协作图"),
("hypervector", "六、超向量表示（HRR）"),
("model-adapter", "七、模型适配层"),
("packs", "八、九大领域包"),
]
def read(path):
with open(path, "r", encoding="utf-8") as f:
return f.read().strip()
def main():
sys.path.insert(0, ROOT)
from holoaeon.spec import VERSION, DATE
ver = VERSION
zip_name = "holoaeon_v%s_%s.zip" % (ver, DATE.replace("-", ""))
zip_path = os.path.join(PARENT, zip_name)
if os.path.exists(zip_path):
data = Path(zip_path).read_bytes()
size_str = "{:,}".format(len(data))
sha_str = "`%s`" % hashlib.sha256(data).hexdigest().upper()
else:
size_str = "未找到"
sha_str = "（请先运行 scripts/make_release.py）"
header = """# HoloAeon 通用多智能体认知框架 · 入库入口（全文）
> 零依赖、生物启发的通用多智能体认知框架 · 版本 **v__VER__**
> 本入口文档可直接阅读全文，包含项目说明、全部机制文档与算法白皮书。
## 资产信息
| 项目 | 内容 |
|---|---|
| 版本 | v__VER__ |
| 协议 | Apache-2.0 |
| 运行环境 | Python 3.8+，纯标准库，零第三方依赖 |
| 发布包 | __ZIP__（__SIZE__ B） |
| SHA256 | __SHA__ |
| 计划仓库 | github.com/weideyouni/holoaeon |
| 规模 | 9 个领域包、25 个智能体、47 个技能、9 个工作流 |
| 自检 | 17/17 组通过；单元测试 25 个；红线扫描零违规；解压复跑 DIFF=0 |
---
# 项目说明
"""
header = (header.replace("__VER__", ver)
.replace("__ZIP__", zip_name)
.replace("__SIZE__", size_str)
.replace("__SHA__", sha_str))
parts = [header]
parts.append(read(os.path.join(ROOT, "README.zh-CN.md")))
parts.append("\n\n---\n\n# 机制与架构文档\n")
for key, title in DOC_ORDER:
p = os.path.join(ROOT, "docs", key + ".md")
if os.path.exists(p):
body = read(p)
# 去掉文档内首个一级标题，避免与分节标题重复
lines = body.splitlines()
if lines and lines[0].startswith("# "):
lines = lines[1:]
parts.append("\n\n## " + title + "\n\n" + "\n".join(lines).strip())
# 算法白皮书（ALGORITHM.md 为英文，作为第九节纳入）
algo = os.path.join(ROOT, "ALGORITHM.md")
if os.path.exists(algo):
body = read(algo)
lines = body.splitlines()
if lines and lines[0].startswith("# "):
lines = lines[1:]
parts.append("\n\n## 九、算法白皮书：认知优化与自组织搜索（ALGORITHM）\n\n"
+ "\n".join(lines).strip())
parts.append("""
---
## 免责声明
本项目中的生物与宇宙词汇均为认知架构隐喻，仅用于描述多智能体软件的同步、边界、路由、
支撑与自组织机制，不构成医学、生物学或临床建议。所有仿真回执均标记 `simulated`；
仿真不等于证明，人类判断始终是最终权威。
""")
out = os.path.join(ROOT, "HoloAeon_入库入口_全文.md")
with open(out, "w", encoding="utf-8") as f:
f.write("\n".join(parts))
print("written:", out)
print("chars:", len("\n".join(parts)))
print("zip:", zip_name, "size:", size_str, "sha:", sha_str)
if __name__ == "__main__":
main()
|