【免费下载链接】obsidian-terminalIntegrate consoles, shells, and terminals.项目地址https://gitcode.com/gh_mirrors/ob/obsidian-terminal点击查看免费下载obsidian-terminal 是一个 Obsidian 终端插件它把真正的 shell 集成进笔记软件在 macOS、Linux 与 Windows 上它通过Python PTY 代理和ConPTY 控制主机在浏览器沙箱外托管伪终端Pseudoterminal再经 xterm.js 渲染出可交互的跨平台伪终端。本文拆解这套前端—TS 中间层—Python 宿主三层架构的核心机制帮你理解浏览器类应用如何安全、可靠地驱动终端。为什么浏览器里的终端需要一个 Python 代理Obsidian 基于 Electron插件代码运行在浏览器渲染进程里无法直接调用fork()、CreatePseudoConsole这类系统接口。终端的灵魂——伪终端设备Unix PTY / Windows ConPTY——必须由一个真正的操作系统进程持有。obsidian-terminal 的解法非常直接把 Python 源码直接打进插件 bundle作为虚拟模块导入用python -c 源码 shell 命令启动一个PTY 宿主进程它创建伪终端并跑起目标 shell宿主进程的 stdin/stdout 就是数据通道另开一条控制通道传调整窗口大小这类指令TypeScript 中间层负责把宿主的输出接到 xterm.js把键盘输入写回宿主。这个统一抽象定义在Pseudoterminal接口pseudoterminal.ts只暴露shell、kill、onExit、pipe、resize五个概念Unix 与 Windows 各自实现对上层完全透明。Unix 侧一个约 460 行的 Python PTY 代理Unix 平台的宿主是 unix_pseudoterminal.py逻辑精炼到可以通读全文。pty.fork() 与非阻塞 mastermain()调用pty.fork()一分为二子进程execvp执行目标 shell父进程成为代理持有 pty master 描述符并立即设为非阻塞unix_pseudoterminal.py。关键设计在文件头注释里说得明白代理从不等待写入 pty。因为如果 shell 正在等自己读输出代理又阻塞在写 pty 上两边就永久死锁。所以pty 输出 → 代理 stdout始终可读就走代理 stdin → pty 的输入放进一个有界缓冲区_INPUT_BUFFER_LIMIT 65536字节unix_pseudoterminal.py写不进去就停下读 stdin让背压自然传导回浏览器端。selector 事件循环读写复用一套回调代理用DefaultSelector监听三个描述符unix_pseudoterminal.py描述符处理器职责pty master_PipePty读出 shell 输出转发到 stdout在有排队输入时才注册EVENT_WRITEPTY 有空闲就_flush()stdin (fd 0)_PipeStdin读宿主写来的键盘输入喂给 pty缓冲区满时自动停看控制通道 (fd 3)_ProcessCmdIO解析列数x行数指令调整窗口尺寸一个细节macOS 上子进程丢弃输入队列或改变终端模式时PTY 可能变空但 selector 不会上报可写所以每轮循环都会强制retry()一次unix_pseudoterminal.py。窗口大小调整fd 3 上的 TIOCSWINSZ控制通道是第 4 个 stdio 管道fd 3。TS 侧每次 resize 只写一行120x30\n这样的文本pseudoterminal.tsPython 侧解析后执行ioctl(TIOCSWINSZ)内核随即通知 shell 终端尺寸变化触发SIGWINCH和重排unix_pseudoterminal.py。优雅终止按进程组发三档信号宿主退出时先关掉 pty master内核挂断会话再对整个进程组按SIGHUP → SIGTERM → SIGKILL逐级施压每档给 1~2 秒宽限并用/proc或killpg(pgid, 0)轮询确认组内已无活进程unix_pseudoterminal.py。这样即使用户只杀了 shell它的子孙进程比如top也不会变成孤儿。Windows 侧ConPTY 主机的握手、认证与进程收容Windows 没有 POSIX PTYobsidian-terminal 用ConPTYWindows 10 1899 的伪控制台 API实现同等能力。宿主 win32_conpty.py 约 3000 行几乎全靠ctypes调用 Win32 API亮点不少。纯 ctypes 实现 CreatePseudoConsole宿主用 ctypes 绑定conpty.dll的CreatePseudoConsole、ResizePseudoConsolewin32_conpty.py并按微软winconpty.cpp的移植逻辑构造PSEUDOCONSOLE结构让CreateProcessW把 shell 挂到控制台宿主上。它还会优先使用 Windows Terminal 1.22 自带的控制台宿主OpenConsole.exe响应更多终端回复序列找不到或启动失败就自动回退到系统内置 conhost并允许 ConPTY 整体失败时降级为纯 ConHost 后端win32_conpty.py。NDJSON 控制管道 token 认证握手与 Unix 的fd 3 写一行文本不同ConPTY 宿主使用命名管道\\.\pipe\obsidian-terminal-conpty-随机承载 NDJSON 控制消息pseudoterminal.ts。为什么需要管道和认证因为命名管道是全局可见的任何本地进程都能连上来发kill指令。握手流程win32_conpty.py宿主发送hello或预热的idle携带 token 与hostPid、childPid插件核对 token 后回发op: authenticate响应宿主限定 5 秒内必须收到否则拒绝服务win32_conpty.py之后宿主才发ready事件并附上一句宣誓式认证字符串create-pseudoconsoleauthenticated-control-channeljob-object-assigned—— 明确宣告已创建伪终端 控制通道已认证 已分配 Job 对象win32_conpty.py。token 本身只经环境变量OBSIDIAN_TERMINAL_CONPTY_TOKEN传递绝不进命令行避免被进程列表窥探pseudoterminal.ts。挂起启动 Job 对象让杀进程永远可靠宿主用CREATE_SUSPENDED创建 shell进程先被冻住分配进一个带JOB_OBJECT_LIMIT_KILL_ON_JOB_CLOSE的 Job 对象然后才发送hello报出子进程 PID最后ResumeThread放行win32_conpty.py。好处很实际冻结窗口内完成 Job 分配杜绝进程跑了但没管住的竞态关闭 Job 即连带杀掉 shell 的全部后代无需逐个TerminateProcessready事件里报的 PID 就是真实运行的子进程TS 侧可据此校验宿主身份pseudoterminal.ts。数据泵与 resize会话建立后三个后台线程各司其职conpty-output把伪终端输出泵到宿主 stdoutconpty-input把宿主 stdin 写进伪终端输入管道conpty-control循环处理resize/kill等操作win32_conpty.py。值得注意的是输出泵直接用裸描述符os.write写盘注释解释了原因线程在解释器收尾阶段持有sys.stdout.buffer的锁会直接让 CPython 崩溃——这类细节正是Python 当系统级宿主的必修课。resize 则通过控制管道的resize操作执行ResizePseudoConsole若运行在 OpenConsole 宿主上改发信号管数据包包给它win32_conpty.py。TypeScript 中间层xterm.js 接入与背压控制宿主输出只是字节流真正像终端的是 xterm.js 渲染与输入回传核心函数是pipeShellToTerminalpseudoterminal.ts它做了三件关键的事切片写入writeTerminalSliced把大输出切成小块写 xterm因为 xterm 每次Terminal.write是不可打断的任务切片才能让渲染帧穿插其间防止cat big.log时界面卡死高/低水位背压createTerminalOutputBackpressure统计已写入但未解析的字节数超过高水位就暂停来源流低于低水位再恢复避免浏览器内存被输出洪水冲爆pseudoterminal.ts;输入回传terminal.onData把 xterm 解析后的按键数据写回shell.stdinshell 退出时自动解绑。此外终端外观选项、多标签、历史保存等功能都建立在这套管道之上配置入口在 settings-data.ts可定制的终端行为详见 emulator.ts。动手跑起来环境要求与排错要点想亲自验证这套跨平台伪终端实现环境要求如下平台要求说明macOS / LinuxPython ≥ 3.9按 profile 配置解释器点Check校验WindowsPython 可选默认 ConPTY 后端无需 pip 包ConHost 后端的 resizer 需要psutil、pywinctlwin32_resizer.pyWindows 上若 Python 不可用、宿主握手超时或 ConPTY 启动失败插件会自动以 ConHost 模式打开并提示错误装好 Python 后在插件设置里点Recheck Python即可重试 ConPTYREADME.md。相关行为还有专门的自愈脚本 win32-doctor.ts以及测试用例 test_unix_pseudoterminal.py、test_win32_conpty.py 可对照阅读。小结obsidian-terminal 用两个小而全的 Python 宿主解决了浏览器应用驱动终端的三个核心难题能力边界PTY/ConPTY 系统调用交给 OS 子进程浏览器端只传字节背压与死锁Unix 侧用非阻塞 master 有界输入缓冲Windows 侧用管道泵 TS 端高低水位双向流控安全与可靠性命名管道 token 认证、挂起启动 Job 收容、三级信号终止让跨进程杀终端和防本地伪造指令都有确定答案。这套前端渲染、TS 编排、Python 托管的分工对任何想在 Web 容器里做终端的项目都是可直接借鉴的完整范式。赞分享【免费下载链接】obsidian-terminalIntegrate consoles, shells, and terminals.项目地址https://gitcode.com/gh_mirrors/ob/obsidian-terminal点击查看免费下载相关推荐集成终端是如何工作的obsidian-terminal的xterm.js渲染与伪终端PTY架构完整解析集成终端是如何工作的obsidian terminal的xterm.js渲染与伪终端PTY架构完整解析 obsidian terminal 是一款 ObsMiniTerm 深度解析在 Windows Terminal 仓库中用 ConPTY 伪控制台 API 构建 C 迷你终端MiniTerm 深度解析在 Windows Terminal 仓库中用 ConPTY 伪控制台 API 构建 C 迷你终端 本文基于 Windows Ter桌面应用CLIPty4J - Java实现的伪终端(PTY)库Pty4J Java实现的伪终端 PTY 库 简介 Pty4J是一个官方JetBrains支持的开源项目它为Java提供了一个功能强大的伪终端 PTY 实现。开发工具上一篇终极指南如何用Nuclei自包含模板彻底告别依赖地狱下一篇Lightweight Charts Pretty Histogram Series 插件圆角直方图自定义序列实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
