phase 4 is finished

Author: Charliechen114514

CMakeLists.txt

@@ -42,11 +42,15 @@ if(CFBOX_ENABLE_INIT)
     file(GLOB_RECURSE INIT_SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/src/applets/init/*.cpp)
     list(APPEND CFBOX_APPLET_SOURCES ${INIT_SOURCES})
 endif()
+if(CFBOX_ENABLE_TOP)
+    file(GLOB_RECURSE TOP_SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/src/applets/top/*.cpp)
+    list(APPEND CFBOX_APPLET_SOURCES ${TOP_SOURCES})
+endif()
 
 # Single-file applets
 foreach(applet IN LISTS CFBOX_APPLETS)
     string(TOUPPER "${applet}" APPLET_UPPER)
-    if(NOT applet STREQUAL "sh" AND NOT applet STREQUAL "awk" AND NOT applet STREQUAL "init" AND CFBOX_ENABLE_${APPLET_UPPER})
+    if(NOT applet STREQUAL "sh" AND NOT applet STREQUAL "awk" AND NOT applet STREQUAL "init" AND NOT applet STREQUAL "top" AND CFBOX_ENABLE_${APPLET_UPPER})
         list(APPEND CFBOX_APPLET_SOURCES ${CMAKE_CURRENT_SOURCE_DIR}/src/applets/${applet}.cpp)
     endif()
 endforeach()

Roadmap.md

@@ -18,12 +18,12 @@ CFBox 是一个 C++23 BusyBox 替代品，当前版本有 78 个 applet。项目
 | 1 | POSIX Shell + Coreutils I ✅ | ~17 | Shell 引擎、进程管理、信号处理 | ~34 |
 | 2 | Coreutils II + findutils ✅ | ~44 | 流处理管线、校验和框架 | ~78 |
 | 3 | 归档 + 压缩 + 文本处理 ✅ | ~15 | 终端抽象、压缩框架 | ~93 |
-| 4 | 进程/Init + util-linux 🔧 | ~8/38 | /proc 解析器、init 系统 | ~100 |
+| 4 | 进程/Init + util-linux 🔧 | ~21/38 | /proc 解析器、init 系统、TUI 框架 | ~114 |
 | 5 | vi 可视化编辑器 | 1 | TUI 框架、屏幕渲染、键盘映射 | ~133 |
 | 6 | 网络 + 登录 + 日志 | ~35 | Socket 抽象、HTTP 解析、shadow 密码 | ~168 |
 | 7 | 剩余组件 + 集成验证 | ~40+ | POSIX 验证、容器替换测试 | ~200+ |
 
-**当前状态**：Phase 0-3 已完成，Phase 4 进行中。100 个 applet，288 单元测试全部通过。CFBox 已可在 QEMU 中作为 PID 1 运行完整 init 系统。
+**当前状态**：Phase 0-3 已完成，Phase 4 进行中。114 个 applet，318 单元测试全部通过。CFBox 已可在 QEMU 中作为 PID 1 运行完整 init 系统。TUI 框架已就绪，为 Phase 5 vi 编辑器奠定基础。
 
 ---
 
@@ -160,7 +160,7 @@ Shell 已实现为第一个多文件 applet（`src/applets/sh/`，8 个模块，
 
 ### 基础设施 ✅
 - **`/proc` 解析器** `include/cfbox/proc.hpp` ✅：集中解析 /proc/meminfo, /proc/stat, /proc/[pid]/stat, /proc/[pid]/cmdline, /proc/[pid]/status, /proc/loadavg, /proc/uptime, /proc/mounts, /proc/diskstats, /proc/partitions
-- **TUI 框架** `include/cfbox/tui.hpp`：全屏终端应用抽象（top、后续的 vi/less 共用）— 待实现
+- **TUI 框架** `include/cfbox/tui.hpp` ✅：全屏终端应用抽象（ScreenBuffer、Key 解析、TuiApp 虚基类、SIGWINCH 处理），top 和后续 vi/less 共用
 
 ### Init 系统 ✅
 - **inittab 解析器** ✅：解析 `/etc/inittab`，支持运行级别、respawn、once 条目
@@ -170,21 +170,27 @@ Shell 已实现为第一个多文件 applet（`src/applets/sh/`，8 个模块，
 - **QEMU 兼容** ✅：无 inittab 时自动回退 smoke test 模式，保持 CI 兼容
 - **getty 集成**：在 TTY 上生成登录提示 — 待 Phase 6
 
-### procps ✅（已完成 8/16）
-`ps` ✅, `kill` ✅, `free` ✅, `uptime` ✅, `pgrep`/`pkill` ✅, `pidof` ✅, `sysctl` ✅
+### procps（已完成 15/16）
+`ps` ✅, `kill` ✅, `free` ✅, `uptime` ✅, `pgrep`/`pkill` ✅, `pidof` ✅, `sysctl` ✅, `pwdx` ✅, `pstree` ✅, `pmap` ✅, `fuser` ✅, `iostat` ✅, `watch` ✅, `top` ✅
 
-`top`, `pmap`, `iostat`, `lsof`, `watch`, `pstree`, `fuser`, `pwdx` — 待实现
+`lsof` — 待实现
 
-### util-linux（待实现）
-**存储/块设备**：`mount`/`umount`, `blkid`, `blockdev`, `dmesg`, `fdisk`, `mkfs`, `fsck`, `losetup`, `pivot_root`, `switch_root`, `swapon`/`swapoff`
+### util-linux（已完成 6/30）
+`dmesg` ✅, `hexdump` ✅, `more` ✅, `rev` ✅, `cal` ✅, `renice` ✅
 
-**系统工具**：`hexdump`, `more`, `flock`, `getopt`, `cal`, `rev`, `setsid`, `nsenter`, `unshare`, `mdev`, `lspci`, `lsusb`, `hwclock`, `rtcwake`, `taskset`, `chrt`, `ionice`, `renice`, `last`, `mesg`, `wall`, `script`
+**存储/块设备**（待实现）：`mount`/`umount`, `blkid`, `blockdev`, `fdisk`, `mkfs`, `fsck`, `losetup`, `pivot_root`, `switch_root`, `swapon`/`swapoff`
+
+**系统工具**（待实现）：`flock`, `getopt`, `setsid`, `nsenter`, `unshare`, `mdev`, `lspci`, `lsusb`, `hwclock`, `rtcwake`, `taskset`, `chrt`, `ionice`, `last`, `mesg`, `wall`, `script`
 
 ### 验证 ✅（已通过）
 - CFBox 作为 PID 1 在 QEMU aarch64 中启动，运行 inittab，执行 sysinit 命令，spawn shell（respawn），处理关机 ✅
 - `ps aux` 输出与 procps 格式匹配 ✅
 - `free -h`、`uptime`、`kill -l`、`pidof`、`sysctl` 在 QEMU 中正常工作 ✅
 - 288 单元测试全部通过 ✅
+- `top -b -n 1` 在批处理模式下输出进程表 ✅
+- `pstree -p` 显示进程树和 PID ✅
+- `hexdump -C /dev/null`、`cal`、`rev` 功能正确 ✅
+- 318 单元测试全部通过 ✅
 - 容器测试：CFBox 替换 Alpine 容器中的 BusyBox — 待实现
 
 ---
@@ -206,7 +212,7 @@ Shell 已实现为第一个多文件 applet（`src/applets/sh/`，8 个模块，
 - **滚动**：半页/整页滚动（Ctrl-D/Ctrl-U/Ctrl-F/Ctrl-B），长行折行显示
 
 ### 基础设施
-- TUI 框架已在 Phase 4 实现，vi 直接复用
+- TUI 框架已在 Phase 4 实现 ✅，vi 直接复用
   - 屏幕缓冲区管理、增量渲染
   - 键盘事件映射（普通键 + 转义序列解析）
   - 信号处理（SIGWINCH 终端大小变化）

cmake/Config.cmake

@@ -24,6 +24,9 @@ set(CFBOX_APPLETS
     gzip gunzip diff cmp patch ed tar cpio ar unzip
     awk
     free uptime kill pidof ps pgrep sysctl
+    pwdx pstree pmap fuser iostat
+    watch top
+    dmesg hexdump more rev cal renice
 )
 
 foreach(applet IN LISTS CFBOX_APPLETS)

include/cfbox/applet_config.hpp.in

@@ -100,3 +100,16 @@
 #cmakedefine01 CFBOX_ENABLE_PS
 #cmakedefine01 CFBOX_ENABLE_PGREP
 #cmakedefine01 CFBOX_ENABLE_SYSCTL
+#cmakedefine01 CFBOX_ENABLE_PWDX
+#cmakedefine01 CFBOX_ENABLE_PSTREE
+#cmakedefine01 CFBOX_ENABLE_PMAP
+#cmakedefine01 CFBOX_ENABLE_FUSER
+#cmakedefine01 CFBOX_ENABLE_IOSTAT
+#cmakedefine01 CFBOX_ENABLE_WATCH
+#cmakedefine01 CFBOX_ENABLE_TOP
+#cmakedefine01 CFBOX_ENABLE_DMESG
+#cmakedefine01 CFBOX_ENABLE_HEXDUMP
+#cmakedefine01 CFBOX_ENABLE_MORE
+#cmakedefine01 CFBOX_ENABLE_REV
+#cmakedefine01 CFBOX_ENABLE_CAL
+#cmakedefine01 CFBOX_ENABLE_RENICE

include/cfbox/applets.hpp

@@ -292,6 +292,45 @@ extern auto pgrep_main(int argc, char* argv[]) -> int;
 #if CFBOX_ENABLE_SYSCTL
 extern auto sysctl_main(int argc, char* argv[]) -> int;
 #endif
+#if CFBOX_ENABLE_PWDX
+extern auto pwdx_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_PSTREE
+extern auto pstree_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_PMAP
+extern auto pmap_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_FUSER
+extern auto fuser_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_IOSTAT
+extern auto iostat_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_WATCH
+extern auto watch_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_TOP
+extern auto top_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_DMESG
+extern auto dmesg_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_HEXDUMP
+extern auto hexdump_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_MORE
+extern auto more_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_REV
+extern auto rev_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_CAL
+extern auto cal_main(int argc, char* argv[]) -> int;
+#endif
+#if CFBOX_ENABLE_RENICE
+extern auto renice_main(int argc, char* argv[]) -> int;
+#endif
 
 // registry — one line per applet, conditionally compiled
 constexpr auto APPLET_REGISTRY = std::to_array<cfbox::applet::AppEntry>({
@@ -585,4 +624,43 @@ constexpr auto APPLET_REGISTRY = std::to_array<cfbox::applet::AppEntry>({
 #if CFBOX_ENABLE_SYSCTL
     {"sysctl",   sysctl_main,   "configure kernel parameters at runtime"},
 #endif
+#if CFBOX_ENABLE_PWDX
+    {"pwdx",     pwdx_main,     "print working directory of a process"},
+#endif
+#if CFBOX_ENABLE_PSTREE
+    {"pstree",   pstree_main,   "display a tree of processes"},
+#endif
+#if CFBOX_ENABLE_PMAP
+    {"pmap",     pmap_main,     "display memory map of a process"},
+#endif
+#if CFBOX_ENABLE_FUSER
+    {"fuser",    fuser_main,    "identify processes using files or sockets"},
+#endif
+#if CFBOX_ENABLE_IOSTAT
+    {"iostat",   iostat_main,   "report CPU and I/O statistics"},
+#endif
+#if CFBOX_ENABLE_WATCH
+    {"watch",    watch_main,    "execute a program periodically"},
+#endif
+#if CFBOX_ENABLE_TOP
+    {"top",      top_main,      "display Linux processes"},
+#endif
+#if CFBOX_ENABLE_DMESG
+    {"dmesg",    dmesg_main,    "print kernel ring buffer"},
+#endif
+#if CFBOX_ENABLE_HEXDUMP
+    {"hexdump",  hexdump_main,  "display file contents in hexadecimal"},
+#endif
+#if CFBOX_ENABLE_MORE
+    {"more",     more_main,     "file perusal filter for crt viewing"},
+#endif
+#if CFBOX_ENABLE_REV
+    {"rev",      rev_main,      "reverse lines characterwise"},
+#endif
+#if CFBOX_ENABLE_CAL
+    {"cal",      cal_main,      "display a calendar"},
+#endif
+#if CFBOX_ENABLE_RENICE
+    {"renice",   renice_main,   "alter priority of running processes"},
+#endif
 });