ptyctl

01

固定源码基线

公开仓库提交 8adf9013

查看快照 ↗

交互呈现

ptyctl

控制无头伪终端、屏幕状态和子进程生命周期。

Cargo description: Headless PTY controller built on alacritty_terminal

8生产文件

8Rust 文件总数

2,357生产代码行

30收录公开符号

职责与架构位置

ptyctl 位于“交互呈现”层。它的首要职责是：控制无头伪终端、屏幕状态和子进程生命周期。。源码图谱把 crate 看成一个编译和所有权边界，而不是文件夹标签：直接依赖表示它可以调用的下层能力，反向依赖表示哪些上层模块把它当作稳定接缝。

成员路径为 crates/codegen/ptyctl，清单位于 Cargo.toml。

关键入口

SOURCElib.rscrates/codegen/ptyctl/src/lib.rs:1–1114 行 · 模块入口↗SOURCESessionConfigcrates/codegen/ptyctl/src/session.rs:23–33607 行 · 公开符号入口↗SOURCEScreenParamscrates/codegen/ptyctl/src/server.rs:21–31496 行 · 公开符号入口↗SOURCESessionListenercrates/codegen/ptyctl/src/term.rs:22–32359 行 · 公开符号入口↗SOURCEStyledRuncrates/codegen/ptyctl/src/styled.rs:13–23317 行 · 公开符号入口↗SOURCERAW_TAIL_CAPcrates/codegen/ptyctl/src/wait.rs:14–24214 行 · 公开符号入口↗

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

依赖与调用者

直接依赖

无一方 crate 依赖

直接调用者

ptyctl-clixai-grok-pager-pty-harness

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

关键公开符号

类型	符号	文件与行号
fn	parse_keys	crates/codegen/ptyctl/src/keys.rs:19
struct	PtyConfig	crates/codegen/ptyctl/src/pty.rs:12
struct	PtyHandle	crates/codegen/ptyctl/src/pty.rs:26
struct	PtyMaster	crates/codegen/ptyctl/src/pty.rs:37
fn	resize	crates/codegen/ptyctl/src/pty.rs:43
struct	PtyChild	crates/codegen/ptyctl/src/pty.rs:58
fn	is_alive	crates/codegen/ptyctl/src/pty.rs:64
fn	pid	crates/codegen/ptyctl/src/pty.rs:69
fn	wait	crates/codegen/ptyctl/src/pty.rs:74
fn	kill	crates/codegen/ptyctl/src/pty.rs:80
fn	spawn	crates/codegen/ptyctl/src/pty.rs:87
fn	into_parts	crates/codegen/ptyctl/src/pty.rs:138
struct	ScreenParams	crates/codegen/ptyctl/src/server.rs:23
struct	SendRequest	crates/codegen/ptyctl/src/server.rs:38
struct	ResizeRequest	crates/codegen/ptyctl/src/server.rs:44
struct	ScrollbackParams	crates/codegen/ptyctl/src/server.rs:51
struct	WaitParams	crates/codegen/ptyctl/src/server.rs:63
fn	build_router	crates/codegen/ptyctl/src/server.rs:92
struct	SessionConfig	crates/codegen/ptyctl/src/session.rs:25
struct	SessionStatus	crates/codegen/ptyctl/src/session.rs:35
struct	PtySession	crates/codegen/ptyctl/src/session.rs:45
fn	start	crates/codegen/ptyctl/src/session.rs:67
fn	send_keys	crates/codegen/ptyctl/src/session.rs:210
fn	send_bytes	crates/codegen/ptyctl/src/session.rs:216
fn	screen	crates/codegen/ptyctl/src/session.rs:223
fn	screen_styled	crates/codegen/ptyctl/src/session.rs:229
fn	screen_html	crates/codegen/ptyctl/src/session.rs:235
fn	cursor	crates/codegen/ptyctl/src/session.rs:241
fn	status_basic	crates/codegen/ptyctl/src/session.rs:247
fn	status	crates/codegen/ptyctl/src/session.rs:256

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

关联深度文章

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

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

完整 Rust 文件索引

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

生产源码crates/codegen/ptyctl/src/keys.rs194 行 · 1 个公开符号生产源码crates/codegen/ptyctl/src/lib.rs14 行 · 0 个公开符号生产源码crates/codegen/ptyctl/src/pty.rs156 行 · 11 个公开符号生产源码crates/codegen/ptyctl/src/server.rs496 行 · 6 个公开符号生产源码crates/codegen/ptyctl/src/session.rs607 行 · 12 个公开符号生产源码crates/codegen/ptyctl/src/styled.rs317 行 · 4 个公开符号生产源码crates/codegen/ptyctl/src/term.rs359 行 · 12 个公开符号生产源码crates/codegen/ptyctl/src/wait.rs214 行 · 7 个公开符号

覆盖说明

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