Tsukine OS

文档 · 构建指南 · 命令参考 · 版本路线图

📖 项目概述

Tsukine OS 是一个基于 Linux 6.6 LTS 内核的个人操作系统项目，目标是为音乐创作者提供轻量、可控的创作环境。

当前处于 Infdev 阶段（底层重构），已完成持久化存储、包管理工具、网络层重构，并已启动 ARM64 移植。

🛠️ 核心命令

命令	功能	示例
`taskmgr` / `tsukine_top`	任务管理器	`taskmgr -u`（用户进程） `taskmgr -c`（内核进程）
`net` / `tsukine_net`	网络配置守护进程	`net &`
`ping` / `tsukine_ping`	ICMP 连通性测试	`ping -c 4 8.8.8.8`
`iwr` / `tsukine_iwr`	HTTP 下载	`iwr http://example.com/file -o out.txt`
`tknpkg`	包管理（安装/卸载/列表）	`tknpkg install hello-1.0.0.tkn`
`tknpkkj`	打包工具（生成 .tkn 包）	`tknpkkj build mypkg/`

📦 包管理

tknpkg 是 Tsukine OS 的包管理器，支持安装、卸载、列表查询。tknpkkj 用于从源码目录生成 .tkn 包。

.tkn 包结构：
    ── metadata          # 包信息（name, version, description）
    ── rootfs/           # 安装到系统根目录的文件
    ── post-install.sh   # 安装后执行脚本（可选）

🧬 版本路线图

Indev-0.1.0 2026-07-22 ✅ 已完成

初始发布：tsukine_top / net / net_ui

Indev-0.1.1 2026-07-22 ✅ 已完成

reboot / shutdown，net 守护进程化，top 过滤

Indev-0.1.2 2026-07-23 ✅ 已完成

ping / iwr，命令软链接

Indev-0.1.3 2026-07-23 ✅ 已完成

dash 替换 BusyBox shell，提示符 ~#

Indev-0.1.4 2026-07-23 ✅ 已完成

nano 文本编辑器移植

Indev-0.1.5 2026-07-24 ✅ 已完成

内核模块版本号修复，模块加载成功

Indev-0.1.6 2026-07-24 ✅ 已完成

用户账户系统（root / dmin）

Indev-0.1.7 2026-07-24 ✅ 已完成

自动主机名，提示符优化，[OK] / [WARNING] 状态检查

Infdev-0.2.0 2026-07-25 ✅ 已完成

持久化存储：系统从硬盘启动，/ 可读写

Infdev-0.2.1 2026-07-25 ✅ 已完成

包管理工具：tknpkg + tknpkkj

Infdev-0.2.2 2026-07-25 ✅ 已完成

文件系统规范化（FHS 目录结构）

Infdev-0.2.3 2026-07-25 ✅ 已完成

网络层重构：配置文件支持（静态 IP / DHCP / 回退）

Infdev-0.2.4 进行中 🔄 进行中

实体机适配：UEFI/BIOS 引导，硬件驱动加载

Alpha-0.3.0 计划中 ⬜ 未开始

图形界面基础（X11 / TinyX + 窗口管理器 + 护程序）

Beta-1.0.0 计划中 ⬜ 未开始

第一个稳定版本，功能冻结，仅修 Bug

正式版 2.0.0 未来 🔮 未来

音乐创作工具集成（Ardour / LMMS / OpenUTAU 等）

🖥️ 构建指南（简版）

完整构建指南请参见 Wiki。

# 1. 获取 Linux 6.6 内核源码
wget https://cdn.kernel.org/pub/linux/kernel/v6.x/linux-6.6.tar.xz

# 2. 配置并编译内核
make defconfig
make LOCALVERSION= bzImage

# 3. 构建 BusyBox（静态编译）
make menuconfig  # 开启 Build static binary
make
make CONFIG_PREFIX=/path/to/rootfs install

# 4. 构建 dash
./configure --enable-static
make
cp src/dash /path/to/rootfs/bin/

# 5. 编译自研工具
gcc -static -o tsukine_top tsukine_top.c -lncurses -ltinfo

# 6. 打包 initrd
cd rootfs && find . -print0 | cpio --null -ov --format=newc | gzip -9 > ../initrd.gz

📂 配置文件

文件	用途
`/etc/profile`	环境变量和提示符设置
`/etc/passwd`	用户账户信息
`/etc/network/interfaces`	网络配置（静态 IP / DHCP）
`/var/lib/tknpkg/db`	已安装包数据库
`/var/log/tsukine_net.log`	网络服务日志