# book

**Repository Path**: huyu-project/book

## Basic Information

- **Project Name**: book
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-09
- **Last Updated**: 2026-10-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

---
repo: book
type: docs
doc_version: v3.0
last_updated: 2026-09-16
---

# Huyu 语言书稿（Book）

> ★ **工作区入口**：`meta/README.md`（跨仓总入口）· 各仓职能见 `meta/ORGANIZATION.md`。★ 工作区根 `/Volumes/Data/huyunew` **不是 git 仓**（它只是 15 个独立仓的容器目录，2026-10-08 起）。

> **一句话**：Huyu = 一门自研系统编程语言 `.hyu` + 一个用乐高方式拼起来的操作系统 HuyuOS + 一条
> 「用 Huyu 自己编译自己」的自举链。本书稿是这三者**面向人**的入口。
>
> **读法**：赶时间 → 只看本页「三十秒版」+ 按身份进 `audiences/`；要系统学 → 按学习路径 1→6 走。
>
> **纪律**：本书所有数字与路径**必须可复跑验证**。凡给出计数一律附判据命令，快照日期写在各页文首。
> **文档不得超前于代码**（reality-check 铁律）—— 与磁盘不符的，以磁盘为准并回来改本页。

---

## 三十秒版

| 问题 | 答案 |
|------|------|
| Huyu 是什么 | 自研系统编程语言（`.hyu`）+ 操作系统 HuyuOS（x86-64）+ 自举工具链，三位一体 |
| 现在能干什么 | C++ 写的 `hyc` 编译 `.hyu`；9 个后端工具（汇编/链接/符号/反汇编/剖析…）；内核按「砖」装配、可在 QEMU 跑 |
| **还不能**干什么（诚实列出） | **只支持 x86-64**（ARM64/RISC-V 后端是 39 行空壳）；32 位内核 `make ARCH=32` 是**显式失败**；GC / 协程运行时**只有 `.gitkeep` 占位**；自举链 8 个工具**尚无已编译二进制**；RFC **0 篇** |
| 代码在哪 | 15 个 git 根，三域：`huyu-core/*`（7）、`huyu-os/*`（3）、`huyu-infra/*`（3）+ `docs` + `meta` |
| 从哪开始 | 新会话先读工作区根的 `meta/WORK_DISCIPLINE_AND_SKILLS.md`（操作协议），再回本书按身份导航 |

> 仓清单**当场实测**，勿抄上表：
> `find /Volumes/Data/huyunew -name .git -maxdepth 6 -not -path "*/node_modules/*"`

---

## 学习路径（六个分域）

| # | 分域 | 主题 | 读完你能 |
|:-:|------|------|---------|
| 1 | [`intro/`](intro/README.md) | 是什么、为什么、怎么装、第一个程序 | 跑通第一个 `.hyu` 程序 |
| 2 | [`language/`](language/README.md) | 语法、类型系统、标准库、ABI 映射 | 写出正确的 Huyu 代码 |
| 3 | [`compiler/`](compiler/README.md) | 前后端架构、工具链、自举链 | 改编译器 / 加后端 |
| 4 | [`os/`](os/README.md) | 内核、引导、驱动、SDK | 改内核 / 加一块「砖」 |
| 5 | [`guide/`](guide/README.md) | 构建、CI、QEMU、排错 | 把整条流水线跑起来 |
| 6 | [`governance/`](governance/README.md) | RFC、决策记录、贡献规范、路线图 | 参与治理与评审 |
| 附 | [`glossary/`](glossary/README.md) | 术语、缩写、索引 | 查词 |

---

## 按身份导航

不知道读什么 → 进 [`audiences/`](audiences/README.md)，六类读者各一份入口：
新手 / 语言使用者 / 编译器贡献者 / 内核贡献者 / 工具链集成者 / 治理者。

---

## 本书与其它文档的关系（**避免同一事实存两处**）

| 内容 | 真相源 | 本书的角色 |
|------|--------|-----------|
| 项目状态 / 路线 / 任务队列 | `meta/PROJECT_MAP.md`、`meta/TASK_LOG/` | **不复制**，只指路 |
| 操作纪律 / 踩坑知识库 | `meta/WORK_DISCIPLINE_AND_SKILLS.md` + `~/.agents/skills/` | **不复制**，只指路 |
| 架构与砖装配细节 | `docs/HUYUOS_ARCHITECTURE_LEGO.md`、`docs/BRICK_ASSEMBLY_IMPLEMENTATION.md` | 讲**概念**，细节指路 |
| 形式化验证（MCB 不变量） | `docs/MCB_FORMAL_VERIFICATION.md`、`docs/INVARIANT_IDS.md` | 讲**为什么**，编号指路 |
| 接口契约 | `huyu-core/abi`（`registry.json` + `headers/`） | 讲**怎么用**，契约指路 |
| 构建 / 工具命令速查 | [`guide/tooling.md`](guide/tooling.md) | 本书持有（人读的速查表） |

> 判据：本书若与上述真相源不一致，以**那些文件 + 实测命令**为准。
> 文档体系的机械守卫（`huyu-infra/ci/checks/`）：
> `check_doc_path_claims.py`（声明的路径必须真实存在）、`check_readme_claims.py`（README 声明必须成立）。

---

## 状态（诚实）

- **已撰写**：本页、`intro/`、`language/`、`compiler/`、`os/`、`guide/`、`governance/`、`glossary/`、`audiences/` 的**正文页**。
- **尚未撰写**：各分域 README 里**逐条标注「未撰写」**的条目。
  **不假装存在** —— 本项目出现过两种反向落差（「标待写、文件其实已存在」与「标完成、文件其实没有」），
  故每份索引的状态一律以 `ls <目录>` 实测为准。