CFBox 发展规划与下一步路线

[Charliechen114514]

CFBox 发展规划与下一步路线

状态：v0.1.0 发布后规划
更新日期：2026-05-25

前提

非常感谢知乎和公众号各位大佬的意见，甚至是指导。笔者这里汇总以下单独正式的回复

0. Q: 你这段时间干嘛了？没见你更新这个项目

A：笔者再仔细考虑规划方向，此外还有B班上，imx-forge和C++项目，很多东西还在积极维护，当时没看好CFBox会引来很多人，直到看到自己的公众号和知乎被轰炸了。。。好了含泪好好规划下吧。。。

1. Q: 是否考虑兼容老旧工具链？

A: 暂时不考虑，真的暂时不考虑. BusyBox足够了，他已经用C做到了极限，我看到C++更加先进的特性可能可以维护一个更好维护的，没有历史负担的coreutils才考虑做的。所以下一代能不能选CFBox而不是BusyBox呢？也许可以，但是很遗憾当时牛逼吹大了（寻思没人看吧应该，结果直接被喷到地里去了，教训啊）。发展到一定阶段（比如说起码我实际imx-forge耍内核的时候能用起来吧。。。），会考虑吗？那就会考虑了！要给更多人使用，兼容老旧工具链是迈不过去的砍！会拉单独的分支的！

2. Q: Binary 咋不能直接下载？

A: 目前不考虑，一方面是功能真的不行，真没想到吸引了一大堆大佬评价，很多功能没有跟上，但是再马上下来的第一个迭代，项目的基建，如文档网站，CI门关会进一步优化后，Release Download就会端上来！。把项目的根梳理好了，项目才能持久的发展，这是我考虑和规划项目耗时最久的项目了。。。

3. Q：编辑器考虑哪一个？

A: 有朋友建议我nano，但是实际上我的想法还是先跑通，用还是更多人熟悉的vi。多后端是跑通之后的事情。要不然最后编辑器没做好，项目也废了。会支持吗将来，会！

4. Q：项目会活跃开发吗？

A: 本来纯玩的项目现在都还在有人问我情况，真吓哭了。肯定要准备转真正的常青藤项目了。这没的说了。总不能辜负大伙的期待吧。

项目现状

CFBox v0.1.0 已发布，包含 109 个 applet，单一可执行文件仅 446 KB。采用现代 C++23 架构，零运行时依赖，配备 331 个 GTest 单元测试和 56 个集成测试。项目已具备作为嵌入式 BusyBox 替代品的坚实基础。

已有能力

• 109 个 Unix 工具：覆盖文本处理、文件操作、归档压缩、Shell、系统信息、进程管理、init 系统
• 446 KB 二进制体积（size-opt + LTO + strip，每 applet 仅 ~4.1 KB）
• 零运行时依赖：自研 DEFLATE 实现，无需 zlib
• 现代 C++23：std::expected、constexpr、string_view、ranges、RAII 封装
• 质量基础设施：GTest 单元测试 + Shell 集成测试 + CI/CD（x86_64/aarch64/armhf QEMU 测试）
• 可配置构建：per-applet CMake 开关 + profile 系统（minimal/embedded/desktop/full）

关键差距（来自竞品分析）

领域	当前	BusyBox	差距
命令数量	109	~430	覆盖率 25%（别喷了，我真以为没啥人看，结果一堆人，必须好好扛起来这个项目了！）
功能深度	~30% 选项	完整	大部分命令缺少常用选项
网络工具	0 个	58 个	完全缺失
系统管理	基础	69 个	缺少 chmod/chown/mount/dd/stty
用户管理	0 个	14 个	完全缺失

---

路线图总览

核心策略：先横向补全（P0 系统命令）→ 再纵向深化（选项完整性）→ 然后领域扩展（网络、多用户）。

策略调整

与原始路线图相比，我们做了以下关键调整：

• Phase 0 轻量化 — 不再作为硬门禁阻塞新功能开发，文档修复和 differential test 骨架与 Phase 1 并行推进
• 新增 Phase 1.5（代码质量审查） — 核心系统命令到位后、深化开始前的专用质量审查阶段
• Phase 2 独立化 — 命令深化作为独立阶段，按运维频率排序
• 分阶段里程碑 — v0.2.0（P0 命令到位）、v0.3.0（深化完成）作为中间版本

---

阶段时间线

Phase 1 ──→ Phase 1.5 ──→ Phase 2 ──→ Phase 3 ──→ Phase 4 ──→ Phase 5 ──→ Phase 6
(P0 命令)   (质量审查)    (核心深化)   (网络)      (生产质量)   (多用户)    (长尾)

---

Phase 1：核心系统命令补齐

目标：新增 24 个 applet，让 CFBox 具备基本系统管理能力。

Wave 1 — 简单命令

从 clear 开始，验证完整的 applet 注册流程（CMake → applets.hpp → 测试）。

命令	说明	复杂度
clear	清屏	极简（~10 行）
which	在 PATH 中定位命令	简单
chgrp	修改文件所属组	简单（chown 的薄包装）
chmod	修改文件权限（符号模式 + 八进制模式）	中等
chown	修改文件属主/组	中等
mountpoint	检查路径是否为挂载点	简单

Wave 2 — 系统控制

需要先从 kill.cpp 中提取 include/cfbox/signal.hpp。

命令	说明	复杂度
killall	按名称杀进程	中等
halt / reboot / poweroff	系统关机/重启命令	中等（单文件三个入口）
setsid	创建新会话	简单
flock	文件锁（排他/共享/非阻塞/超时）	中等

Wave 3 — 核心阻断项

最关键的一波。没有这些命令，CFBox 无法用于真实的系统管理。

命令	说明	新增基础设施
chroot	切换根目录	无
dd	块设备拷贝 + 进度显示	无（使用 POSIX I/O）
stty	终端设置	include/cfbox/tty.hpp
mount	挂载文件系统	include/cfbox/mount.hpp
umount	卸载文件系统	include/cfbox/mount.hpp

Wave 4 — 校验和与编码

命令	说明	新增基础设施
sha1sum / sha256sum / sha384sum / sha512sum	SHA 摘要校验	include/cfbox/digest.hpp（FIPS 180-4）
base64 / base32	Base 编码/解码	include/cfbox/base64.hpp（RFC 4648）
zcat	解压 gzip 到 stdout	复用 compress.hpp

里程碑：v0.2.0 发布 — 133 个 applet，500+ 测试，体积 ≤550 KB。

---

Phase 1.5：代码质量审查

触发条件：Phase 1 Wave 3 完成（核心系统命令功能到位）。

在深化现有命令之前进行一次全面质量审查：

1. 错误处理一致性 — 所有 applet 使用 std::expected + CFBOX_TRY，统一错误信息格式
2. 代码风格 — clang-format 全量检查，命名一致性
3. 测试覆盖快照 — 每个 P0 applet 确认有 ≥1 GTest + ≥1 集成测试
4. 体积检查 — full profile ≤550 KB，Top symbols 分析
5. 兼容性矩阵 — 记录每个 P0 applet 与 BusyBox 的差异

---

Phase 2：核心命令深化

目标：将现有命令功能深度从 ~30% 提升到 ~70%。

第一批：运维刚需

命令	关键补充
tail	-f follow 模式（poll/inotify）— 运维第一刚需
cp	-a 归档、-f 强制、-i 交互、-v 详细
test	全面 POSIX test 审计（所有操作符）
ls	-R 递归、-S/-t 排序、--color

第二批：文本处理增强

命令	关键补充
grep	-A/-B/-C 上下文行、-F 固定字符串、-w 单词匹配
tar	-z gzip、-v 详细、--exclude
sed	-i 原地编辑、hold space、y 字符转换
sort	-k 字段排序、-h 人类数字、-u 去重

第三批：高级功能

命令	关键补充
find	-mtime/-perm、布尔表达式树、-print0
sh	case/esac、here-doc、函数、$((expr))、local、trap
ps / df / du	-o 自定义列、-T/-i、-d 深度

里程碑：v0.3.0 发布 — 核心命令深度达到 ~70%。

---

Phase 3：网络最小闭环

没有网络能力，CFBox 无法成为真正的 BusyBox 替代品。

类别	命令
配置	ip、ifconfig、route
诊断	ping、traceroute、nslookup
状态	netstat
传输	wget、nc、tftp

新增基础设施：include/cfbox/socket.hpp（TCP/UDP/Unix RAII 封装）、include/cfbox/http.hpp（最小 HTTP/1.1 客户端）。

---

Phase 4：生产质量深化

• Benchmark 框架（CFBox vs BusyBox vs GNU/Toybox 性能对比）
• Fuzzing（libFuzzer + ASan/UBSan，覆盖 parser、归档、压缩格式）
• 静态分析（clang-tidy、cppcheck）
• POSIX 子集验证
• Release 工程化（artifact 矩阵、checksum、SBOM、可复现构建）

---

Phase 5：多用户与嵌入式运行时

• 登录管理：login、su、passwd、getty
• 用户管理：adduser、deluser、addgroup、delgroup
• 系统日志：syslogd、klogd、logger、logread
• 设备管理：mdev
• 存储管理：blkid、lsblk、losetup、mkswap、swapon、swapoff
• Root 切换：pivot_root、switch_root

---

Phase 6：长尾完备性

• vi — 可视化编辑器
• 额外压缩格式：bzip2、xz、lzma 系列
• 定时任务：crond、crontab
• 模块管理：insmod、rmmod、lsmod、modprobe
• 硬件工具：lspci、lsusb、I2C 工具
• 便利工具：less、tree、strings、reset