Documentation
¶
Overview ¶
sanitize.go 复刻官方 terminal/terminal-bash 的清洗逻辑:把 PTY 原始输出中的 ANSI CSI/OSC 转义序列剥离,并归一化回车换行,得到可安全展示的纯文本。
Package terminal 提供持久终端会话抽象(任务 S10:Terminal PTY)。
对齐上游:packages/shell/terminal
说明:在 Windows 上无原生 PTY,本包提供跨平台「终端会话」抽象:以子进程+管道承载, 提供 spawn / send / read / signal / close 生命周期、有界回滚(bounded scrollback)、 wait reason,以及单 agent 独占活动(同一时刻仅一个活跃 session)。在 *nix 上可替换为 真正的 PTY 后端(接口不变)。
Index ¶
- func NormalizeText(s string) string
- func Sanitize(s string) string
- func ShellCommand(script string) (name string, args []string)
- func StripANSI(s string) string
- type Session
- func (s *Session) Close() error
- func (s *Session) Contains(sub string) bool
- func (s *Session) Read() []string
- func (s *Session) ReadString() string
- func (s *Session) Send(data string) error
- func (s *Session) SendLine(line string) error
- func (s *Session) Signal() error
- func (s *Session) Wait() WaitReason
- type TerminalBackend
- type TerminalConfig
- type WaitReason
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func NormalizeText ¶
NormalizeText 归一化终端文本:CRLF 与孤立 CR 转为 LF,并移除 BEL。
func ShellCommand ¶
ShellCommand 返回当前平台默认 shell 与退出只需一条命令的包装。 用于测试:`echo ...` 在 Windows cmd / Unix sh 上均可运行。
Types ¶
type Session ¶
type Session struct {
// contains filtered or unexported fields
}
Session 是一次持久终端会话(子进程 + 管道 + 有界回滚)。
type TerminalBackend ¶
type TerminalBackend struct {
// contains filtered or unexported fields
}
TerminalBackend 生成并持有终端会话;保证单 agent 独占活动(同一时刻一个活跃 session)。
func (*TerminalBackend) Active ¶
func (b *TerminalBackend) Active() *Session
Active 返回当前活跃会话(无则 nil)。
type TerminalConfig ¶
type TerminalConfig struct {
Command string // 可执行名(如 bash / cmd / sh)
Args []string // 参数
MaxLines int // 有界回滚行数(<=0 用默认 1000)
ReadLineMax int // 单行最大字节(防超行)
}
TerminalConfig 是生成终端的配置。
type WaitReason ¶
type WaitReason string
WaitReason 是会话结束原因。
const ( WaitExited WaitReason = "exited" // 进程正常退出 WaitSignalled WaitReason = "signalled" // 被信号终止 WaitClosed WaitReason = "closed" // 被显式 close WaitError WaitReason = "error" // 启动/运行错误 )
结束原因枚举。