xai-tty-utils

01

固定源码基线

公开仓库提交 8adf9013

查看快照 ↗

交互呈现

xai-tty-utils

封装 TTY 安全的子进程派生、pager 抑制和进程组回收。

Cargo description: Lightweight process-spawning utilities for TTY safety — detach from controlling terminal, suppress interactive pagers, process-group lifecycle

2生产文件

2Rust 文件总数

1,247生产代码行

30收录公开符号

职责与架构位置

xai-tty-utils 位于“交互呈现”层。它的首要职责是：封装 TTY 安全的子进程派生、pager 抑制和进程组回收。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

成员路径为 crates/codegen/xai-tty-utils，清单位于 Cargo.toml。

关键入口

SOURCEdetach_from_ttycrates/codegen/xai-tty-utils/src/lib.rs:63–73939 行 · 公开符号入口↗SOURCEProcessScopecrates/codegen/xai-tty-utils/src/process_scope.rs:29–39308 行 · 公开符号入口↗

入口文件优先按 lib.rs/main.rs、公开符号密度和文件规模选择。这是一条面向阅读的路径，不表示其他文件不重要；下方完整文件索引覆盖该 crate 的全部 Rust 源码、测试、示例、基准与 Fuzz 文件。

依赖与调用者

直接依赖

无一方 crate 依赖

直接调用者

xai-fast-worktreexai-grok-configxai-grok-mermaidxai-grok-pagerxai-grok-pager-binxai-grok-pager-pty-harnessxai-grok-pager-renderxai-grok-plugin-marketplacexai-grok-sharedxai-grok-shellxai-grok-shell-basexai-grok-toolsxai-grok-workspace

依赖边来自固定提交中的 Cargo manifest，只表示编译期直接依赖。运行时控制流还需结合 trait 实现、构造位置和消息通道判断；反向依赖为空也不代表 crate 没有入口，它可能直接生成二进制或由外部协议调用。

关键公开符号

类型	符号	文件与行号
fn	detach_from_tty	crates/codegen/xai-tty-utils/src/lib.rs:65
fn	detach_from_tty	crates/codegen/xai-tty-utils/src/lib.rs:82
fn	detach_command	crates/codegen/xai-tty-utils/src/lib.rs:95
fn	detach_std_command	crates/codegen/xai-tty-utils/src/lib.rs:123
fn	new_process_group	crates/codegen/xai-tty-utils/src/lib.rs:147
struct	ProcessGroupId	crates/codegen/xai-tty-utils/src/lib.rs:170
fn	new	crates/codegen/xai-tty-utils/src/lib.rs:181
fn	get	crates/codegen/xai-tty-utils/src/lib.rs:207
struct	ProcessGroup	crates/codegen/xai-tty-utils/src/lib.rs:221
fn	new	crates/codegen/xai-tty-utils/src/lib.rs:239
fn	attach	crates/codegen/xai-tty-utils/src/lib.rs:278
fn	attach_std	crates/codegen/xai-tty-utils/src/lib.rs:287
fn	attach_pid	crates/codegen/xai-tty-utils/src/lib.rs:295
fn	terminate	crates/codegen/xai-tty-utils/src/lib.rs:321
fn	kill	crates/codegen/xai-tty-utils/src/lib.rs:332
fn	pager_env	crates/codegen/xai-tty-utils/src/lib.rs:377
const	GIT_AUTH_SUPPRESSION_ENVS	crates/codegen/xai-tty-utils/src/lib.rs:394
fn	git_command	crates/codegen/xai-tty-utils/src/lib.rs:404
fn	redirect_native_stderr	crates/codegen/xai-tty-utils/src/lib.rs:485
fn	dup_tui_stderr	crates/codegen/xai-tty-utils/src/lib.rs:527
fn	restore_native_stderr	crates/codegen/xai-tty-utils/src/lib.rs:572
fn	is_wsl	crates/codegen/xai-tty-utils/src/lib.rs:589
struct	ProcessScope	crates/codegen/xai-tty-utils/src/process_scope.rs:31
fn	new	crates/codegen/xai-tty-utils/src/process_scope.rs:52
fn	prepare	crates/codegen/xai-tty-utils/src/process_scope.rs:67
fn	register	crates/codegen/xai-tty-utils/src/process_scope.rs:83
fn	enroll	crates/codegen/xai-tty-utils/src/process_scope.rs:106
fn	spawn	crates/codegen/xai-tty-utils/src/process_scope.rs:121
fn	kill_all	crates/codegen/xai-tty-utils/src/process_scope.rs:137
fn	live_count	crates/codegen/xai-tty-utils/src/process_scope.rs:169

公开符号用于快速判断 crate 对外暴露的数据、trait 和执行入口。私有实现仍会出现在完整文件索引中；本文不会仅凭 pub 推断某个符号就是长期稳定 API。

关联深度文章

启动入口与运行模式追踪 TUI、headless、stdio 与 serve 如何汇合到共享进程基础设施。

Event Loop 与副作用调度追踪终端事件、网络事件、计时器和后台结果如何进入统一循环。

PTY、TTY 与 Minimal Client说明无头 PTY 控制、TTY 安全进程和最小客户端如何支持测试与降级。

Shell、Process、PTY 与后台命令解释命令构造、进程组、PTY 会话、输出流和后台生命周期。

完整 Rust 文件索引

共 2 个 Rust 文件，其中 2 个被覆盖校验认定为生产源码。测试、示例、基准和 Fuzz 文件不会从图谱删除，而是使用不同标签展示。

生产源码crates/codegen/xai-tty-utils/src/lib.rs939 行 · 12 个公开符号生产源码crates/codegen/xai-tty-utils/src/process_scope.rs308 行 · 9 个公开符号

覆盖说明

该页面由固定源码基线生成。CI 会重新扫描 crates/codegen/xai-tty-utils，验证文件数量、行数、公开符号、依赖和入口是否与提交到站点的数据一致。若上游基线升级而图谱没有重新生成，构建会失败，避免页面显示已经不存在的路径。