指南 · 第 6 章

进程与系统

运行命令、消费输出并检查系统状态。

run 与 shell 的安全边界

run(["git", "log", "--oneline"], { timeout: 5s })
    |> stdout_lines
    |> take(10)
    |> print

run(argv, options?) 直接把 List<String> 交给操作系统，不经过 Shell，因此空格、通配符、$、重定向和管道不会被二次解释。只有确实需要 Shell 语法时才使用 shell(command, options?)；Checker 会对 shell 给出安全提示。

run 与 shell 默认等待结束并返回 CommandResult，而不是把非零退出码自动当作 HHY Error。脚本应读取 exit_code 决定业务成功。

非零 exit_code 不会自动变成 HHY Error。脚本需要根据命令约定判断成功。stdout_lines(result) 可把已捕获输出作为行 Stream 继续处理。

processes() 返回当前时刻的 Stream<Process> 快照。Process 不是 Map，提供 pid、name、cpu、memory、status、command 只读字段；转 JSON 前必须显式映射成普通 Map。

if length(args) != 1 {
    print_error("usage: script.hhy <input>")
    exit(3)
}

let input = path(args[0])