Skip to content

Commit c7b38ea

Browse files
committed
docs: add v1.0.0 release notes
1 parent ac76cb3 commit c7b38ea

File tree

4 files changed

+84
-0
lines changed

4 files changed

+84
-0
lines changed

CHANGELOG.en.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# Changelog
2+
3+
[中文变更日志](./CHANGELOG.md)
4+
5+
## v1.0.0
6+
7+
Release date: 2026-04-04
8+
9+
This is the first formal release of the repository. At this point the project has moved from “proved on this machine” to “versioned, verifiable, and repeatable.”
10+
11+
### Major Capabilities
12+
13+
- build the Linux 0.12 boot image and system image from `vendor/src/linux-0.12.tar.gz`, repo-owned patches, manifests, and minimal userland source
14+
- boot Linux 0.12 under QEMU, enter the shell, and run `ls` automatically
15+
- provide the minimal userland binaries `/bin/sh` and `/bin/ls`
16+
- provide shell built-ins for `cd`, `pwd`, `echo`, `cat`, `uname`, and `exit`
17+
- support macOS arm64, Ubuntu 22.04, and Windows 10 as host platforms
18+
- provide one-command terminal and visible-window launch scripts
19+
- provide one-command rebuild-and-run launch scripts
20+
- provide `verify` and `verify-userland` automated verification entrypoints
21+
22+
### Engineering Outcome
23+
24+
- the repository does not depend on third-party runtime images
25+
- committed runtime snapshots are self-built, and the hard disk image is stored in compressed form as `images/hdc-0.12.img.xz`
26+
- runtime launch automatically unpacks that snapshot into `out/repo-images/hdc-0.12.img`
27+
- GitHub Actions automatically runs unit tests, source builds, and QEMU boot verification on `ubuntu-22.04`
28+
- the CI workflow has been upgraded to official action versions compatible with Node 24
29+
30+
### Release Assets
31+
32+
- `images/bootimage-0.12-hd`
33+
- `images/hdc-0.12.img.xz`
34+
35+
### Known Boundaries
36+
37+
- the current goal is a minimal runnable Linux 0.12 system, not a full historical distribution
38+
- real host validation has been completed primarily on the current macOS host and on the GitHub Ubuntu runner
39+
- Ubuntu 22.04 and Windows 10 host entrypoints are implemented, but more real-machine regression coverage is still recommended

CHANGELOG.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
# 变更日志
2+
3+
[English CHANGELOG](./CHANGELOG.en.md)
4+
5+
## v1.0.0
6+
7+
发布日期:2026-04-04
8+
9+
这是这个仓库的第一个正式发布版本。到这个版本为止,项目已经从“在当前机器上实验性跑通”收敛成“可提交、可验证、可重复启动”的状态。
10+
11+
### 主要能力
12+
13+
-`vendor/src/linux-0.12.tar.gz` 和仓库内补丁、清单、最小用户态源码出发,构建 Linux 0.12 所需的启动镜像和系统镜像
14+
- 在 QEMU 中启动进入 shell,并自动执行 `ls`
15+
- 提供最小用户态 `/bin/sh``/bin/ls`
16+
- shell 内建支持 `cd``pwd``echo``cat``uname``exit`
17+
- 支持 macOS arm64、Ubuntu 22.04、Windows 10 作为宿主机
18+
- 提供终端版和可见窗口版的一键启动脚本
19+
- 提供从编译阶段开始的一键启动脚本
20+
- 提供 `verify``verify-userland` 自动验证入口
21+
22+
### 工程化结果
23+
24+
- 仓库不依赖第三方运行时镜像
25+
- 仓库内提交的是自编译运行快照,其中系统镜像以压缩形式保存为 `images/hdc-0.12.img.xz`
26+
- 运行时会自动解包到 `out/repo-images/hdc-0.12.img`
27+
- GitHub Actions 已在 `ubuntu-22.04` 上自动执行单元测试、源码构建和 QEMU 启动验证
28+
- CI workflow 已升级到 Node 24 兼容的官方 action 版本
29+
30+
### 发布资产
31+
32+
- `images/bootimage-0.12-hd`
33+
- `images/hdc-0.12.img.xz`
34+
35+
### 已知边界
36+
37+
- 当前目标是“最小可运行 Linux 0.12 系统”,不是完整历史发行版
38+
- 真实宿主机验证主要已在当前 macOS 主机和 GitHub Ubuntu runner 上完成
39+
- Windows 10 与 Ubuntu 22.04 的入口脚本和平台分支已经落地,但仍建议继续补真实主机回归

README.en.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# Linux 0.12 on QEMU
22

33
[中文 README](./README.md)
4+
[Changelog](./CHANGELOG.en.md)
45

56
This repository does one specific thing: on a modern host, it builds the two runtime images required to boot Linux 0.12 under QEMU from source and repo-owned manifests, enters the shell, and verifies the result by running `ls`.
67

@@ -30,6 +31,8 @@ The build and runtime flow is:
3031

3132
This is not a “download a historical image and boot it” repo. It is a “rebuild the runtime images locally and boot them” repo.
3233

34+
Current formal release: `v1.0.0`
35+
3336
## Supported Hosts
3437

3538
- macOS arm64

README.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# Linux 0.12 on QEMU
22

33
[English README](./README.en.md)
4+
[变更日志](./CHANGELOG.md)
45

56
这个仓库的目标很直接:在现代宿主机上,从源码和仓库内清单出发,构建出 Linux 0.12 运行所需的两张 QEMU 镜像,启动进入 shell,并成功执行 `ls`
67

@@ -30,6 +31,8 @@
3031

3132
这不是“导入历史镜像再启动”的项目,而是“本地重建运行镜像再启动”的项目。
3233

34+
当前正式发布版本:`v1.0.0`
35+
3336
## 支持的宿主机
3437

3538
- macOS arm64

0 commit comments

Comments
 (0)