版本历史(归档区)
⚠️ 这里的东西是「我们是怎么走到今天的」的记录,不是设计参考。 判断当前该怎么写、某个东西该不该留,不要拿本目录的材料当依据 —— 它们描述的是当时的状态与当时的判断,其中一部分已经被后来的决定推翻 (比如「两个宿主不砍」「只做 Python 前端」这类结论都改判过)。 要判断「现在」,看这几处: | 想知道 | 看哪 | |---|---| | 现在能做什么 / 怎么装 |
README.md| | 往哪走、下一步 | 「内部路线图(未公开)」(docs/路线图.md) | | 为什么这么定(有效决策) |docs/设计决策.md| | 硬约束、AI 协作规矩 |AGENTS.md| | 语言语法与标准库 |docs/语言规格.md| | 逐版本改了什么 |CHANGELOG.md|
为什么有这一块
2026-10-08:架构变革(前后端分层、前端换 Rust、单二进制、wasm)把项目整个换了一遍, 旧的文档里有一大批已经不再适合当参考了:
- 有些是已被抛弃的路径(0.1.x 时期的规划、当时准备砍/留的评估);
- 有些是决策已经落地、只剩余味(评估类文档——结论已经写进代码和设计决策里);
- 有些是流水账(每一步交付的明细)。
把它们留在主线文档里有两个坏处:读的人被历史淹没(README 的「当前进度」曾 占 600 多行),以及拿过时结论去判断现在。所以集中到这里,留个地方给这些材料, 既不假装它们不存在(这是这个语言的历史),也不让它们影响当下的判断。
目录
| 文件 | 是什么 | 时期 |
|---|---|---|
里程碑.md | 逐里程碑明细(M0–M45):每一版做了什么、踩了什么坑 | 0.1.x |
里程碑-0.2.md | 逐轮明细(M46–M56 + R 线):原文取自原 README.md「当前进度」节,反向时间序 | 0.2.x |
R线交付记录.md | R0–R8.5 每一步的交付记录(原文取自内部路线图 §11.x;R8.3 起的原文仍在该路线图 §11.5–§11.10) | 0.2.x |
AGENTS当前任务与状态-历史明细.md | 原文取自 AGENTS.md §3(那份流水涨到近 1000 行,已搬出) | 全期 |
路线图-归档-0.1.md(内部文档,未公开) | 0.1.x 时期的路线图规划原文(M36–M45) | 0.1.x |
架构评估.md(内部文档,未公开) | 「三执行器 / 五引擎是不是维持代价太大」的实测评估(结论:不砍,但实现数目要收敛) | 2026-09-25 |
架构迁移评估.md(内部文档,未公开) | 「前端换 Rust」的可行性 / 收益 / 代价实测(R 线就是按它执行的) | 2026-09-30 |
几条使用须知
- 别在本目录里改内容。「历史不改写」是这个项目的规矩 —— 发现原文有误,
在当前文档里更正,并在这里保留原文。
- 原文里的内部链接可能已经失效(文件被搬过、章节被裁过)。需要追溯时按
文件名在仓库里搜。
- ⚠️ 本目录里有几份不上传到公开仓库(含自建分发服务器的实例信息 / 未定稿决策)
—— 名单以 tools/publish_github.py 的 INTERNAL_DOCS 为准。 🔴 移动 / 改名本目录里的文件时要同步改那里的排除规则:它是按路径匹配的, 2026-10-08 才从「非递归」改成递归 —— 漏了这条就是把服务器信息推到公开仓库。