pebrel/CHANGELOG.md

Changelog / 更新日志

Every release entry is provided in English and Simplified Chinese.

每个版本条目均同时提供英文和简体中文说明。

0.3.0 - 2026-07-12

Highlights / 亮点

• Complete UI redesign — the top bar and left sidebar now form a continuous L-shaped chrome shell, with a unified visual language across settings, the command palette, confirmation dialogs, and drawers. 中文： 全面重设计窗口 UI：顶部栏与左侧栏组成连续 L 形 chrome，并统一设置、命令面板、确认框和抽屉的视觉语言。
• Windows Terminal-style tab interaction — tabs support animated reordering, dragging into the active terminal to create a split, edge docking previews, and matching pointer feedback. 中文： 深度还原 Windows Terminal 标签交互：支持动画排序、拖入当前终端形成分屏、边缘停靠预览和对应的鼠标反馈。
• Files and Git drawer — adds a right-side directory tree and Git workspace with filtering, expansion, path dragging, file status, commit/push actions, and new full-color file-type icons. 中文： 新增右侧目录树与 Git 工作区，支持筛选、展开、路径拖拽、文件状态、提交/推送操作以及新的彩色文件类型图标。
• Markdown/GFM viewer — adds read-only rendering for headings, lists, tables, task lists, code blocks, block quotes, links, and scrollable documents. 中文： 新增 Markdown/GFM 只读查看器，支持标题、列表、表格、任务列表、代码块、引用、链接和滚动浏览。
• Detected shells with brand icons — discovers PowerShell, CMD, Git Bash, Nushell, WSL, and common Linux distributions and renders their full-color icons. 中文： 新增 Shell 探测和品牌彩色图标，覆盖 PowerShell、CMD、Git Bash、Nushell、WSL 及常见 Linux 发行版。

Terminal And Profiles / 终端与配置

• New-tab shell menu — the chevron beside + launches a detected shell or configured profile directly. 中文： 标签栏 + 旁新增 Shell 菜单，可直接使用检测到的执行器或配置 Profile 创建标签页。
• Inline default-shell picker — the settings row expands in place, displays every detected shell with its color icon, persists the selected item, and collapses after selection. 中文： 设置页“默认 Shell”改为原地展开列表，显示全部检测到的 Shell 及彩色图标；选择后立即持久化并收起。
• Rich shell identifiers — default-shell persistence supports cmd, pwsh, nu, and wsl:<distribution> while retaining Nebula prompt bootstrap support for PowerShell and Git Bash. 中文： 默认 Shell 持久化支持 cmd、pwsh、nu 和 wsl:<distribution>，同时继续兼容 PowerShell/Git Bash 的 Nebula prompt bootstrap。
• Appearance controls — adds runtime window opacity, background image, background-image opacity, and independently scrollable settings sections. 中文： 新增窗口透明度、背景图片、背景图片透明度控制，以及可独立滚动的设置分区。

SSH

• Native Rust SSH transport — saved hosts now connect directly to a remote PTY channel without a wrapper shell, injected command, or external ssh.exe console window. 中文： 保存的 SSH host 现在通过 Rust SSH 传输直接连接远端 PTY，不再依赖包装 Shell、命令注入或外部 ssh.exe 黑窗口。
• Complete authentication chain — resolves aliases, users, ports and identity files from ~/.ssh/config, then supports private keys, OpenSSH certificates, encrypted-key passphrases, Windows OpenSSH Agent, Pageant, saved or prompted passwords, and keyboard-interactive/MFA. 中文： 从 ~/.ssh/config 解析别名、用户、端口和 IdentityFile，并支持私钥、OpenSSH 证书、加密密钥口令、Windows OpenSSH Agent、Pageant、已保存/现场输入密码以及 keyboard-interactive/MFA。
• Connection reuse — authenticated sessions are pooled by user@host:port, so additional SSH tabs open a new shell channel without repeating transport setup and authentication. 中文： 已认证连接按 user@host:port 复用；后续 SSH 标签页直接创建新 Shell channel，无需重复传输握手和认证。
• Standard host-key verification — verifies and learns host keys through the standard known_hosts store, prompts on first connection, and rejects changed keys with a security warning. 中文： 使用标准 known_hosts 校验和保存主机密钥；首次连接会确认，密钥变化时会拒绝连接并显示安全警告。
• Authenticated remote Hook bridge — remote AI lifecycle envelopes can travel through a private OSC protected by a random per-channel token; pane identity is always assigned locally before notifications are dispatched. 中文： 远端 AI 生命周期信封可通过每通道随机令牌保护的私有 OSC 返回；通知分发前始终由本地分配 Pane 身份。
• Built-in host editor — the SSH HOSTS header has an add button and an internal form for user@host, optional non-default ports, and passwords. 中文： SSH HOSTS 标题新增添加按钮和内部编辑面板，可输入 user@host、非默认端口和密码。
• Secure credential persistence — passwords are saved only with explicit consent and are stored in Windows Credential Manager, never in Nebula settings, command arguments, shell history, or logs. 中文： 密码仅在用户明确选择保存时写入 Windows Credential Manager，绝不会进入 Nebula 设置、命令参数、Shell 历史或日志。
• Host deletion and cleaner right-click behavior — SSH rows keep their tab-style delete button and credential cleanup, while right-click no longer silently pins or reorders a host. 中文： SSH host 行保留标签页式删除按钮和凭据清理；右键不再静默置顶或改变主机顺序。

Session And Rendering / 会话与渲染

• Smoother workspace interaction — improves split layout, navigation animations, independent sidebar scrolling, tab rename input, hover hit-testing, and the resize HUD. 中文： 改进分屏布局、导航动画、侧栏独立滚动、标签重命名输入、hover 命中和 resize HUD。
• Safe image staging — full-color shell icons, AI brand marks, and OSC 1337 images are staged into a final texture pass so inline images cannot corrupt later glyph batches. 中文： 彩色 Shell 图标、AI 品牌标识和 OSC 1337 图片统一进入帧末贴图阶段，避免内联图片破坏后续 glyph batch。
• Richer pane state — expands OSC, cwd, process-state, and pane event routing for the directory tree, SSH activity, and AI CLI status indicators. 中文： 扩展 OSC、cwd、进程状态和 pane 事件链路，为目录树、SSH 活动和 AI CLI 状态提供实时数据。

Notes / 说明

• Major update — this release spans UI chrome, tabs and splits, the file drawer, Markdown, shell profiles, SSH, and the rendering pipeline. 中文： 这是自 0.2.1 以来的大版本更新，覆盖 UI chrome、标签与分屏、文件抽屉、Markdown、Shell Profile、SSH 和渲染管线。

0.2.1 - 2026-07-11

Fixes / 修复

• Per-pane event routing — window event batches previously resolved to one target pane, allowing output from a background tab to misroute keyboard input or terminal query replies. Events now route to their source pane, user input always targets the focused pane, and events for closed panes are dropped. 中文： 修复逐 pane 事件路由：过去窗口事件批次只解析到单一 pane，后台标签输出可能导致键盘输入或终端查询回复发往错误 PTY；现在事件按来源 pane 路由，用户输入始终进入焦点 pane，已关闭 pane 的事件直接丢弃。
• CJK text in chrome rendering — removed the phantom spacer consumed after every wide glyph, which previously swallowed alternating CJK characters in ghost hints, HUD text, and link previews. 中文： 修复 chrome 中的 CJK 文本渲染：移除宽字符后的虚假 spacer，避免幽灵提示、HUD 和链接预览隔字丢失。
• History capture for wrapped prompts — prompt text is reconstructed across soft-wrapped rows and snapshotted from the grid on Enter, preventing desynchronized keystroke buffers from polluting history. 中文： 修复换行 prompt 的历史捕获：命令会跨软换行重建，并在按下 Enter 时直接从网格快照，避免失同步的按键缓冲污染历史。
• git.exe close-confirmation noise — Nebula's short-lived prompt helper is treated as stateless plumbing and no longer blocks tab closure with a busy-process dialog. 中文： 修复 git.exe 触发关闭确认的问题：Nebula prompt 的短生命周期 git 辅助进程现在视为无状态工具，不再阻止标签页关闭。
• Process lingering after window close — teardown now terminates the shell tree first and drains ConPTY output on a detached thread, preventing ClosePseudoConsole deadlocks. 中文： 修复窗口关闭后进程残留：销毁流程先终止 Shell 进程树，再由独立线程排空 ConPTY 输出，避免 ClosePseudoConsole 死锁。
• ConPTY sideload hygiene — conpty.dll is loaded only by absolute path when its matching OpenConsole.exe is present; failed resize calls now log warnings instead of aborting. 中文： 改进 ConPTY side-load：仅在配套 OpenConsole.exe 存在时通过绝对路径加载 conpty.dll；resize 失败改为记录警告而非终止进程。

Housekeeping / 工程维护

• License and fixtures — consolidated third-party attribution into THIRD-PARTY-NOTICES and renamed reference fixtures after the behavior they cover. 中文： 将第三方许可归集到 THIRD-PARTY-NOTICES，并按实际行为重新命名参考测试 fixture。

0.2.0 - 2026-07-10

Shell Experience / Shell 体验

• Ctrl+V paste — Windows and Linux users can paste with the expected shortcut while preserving bracketed paste and multi-line confirmation. 中文： Windows 和 Linux 支持使用预期的 Ctrl+V 粘贴，同时保留 bracketed paste 和多行粘贴确认。
• Safer pane spawning — new tabs and splits validate inherited cwd before spawning, avoiding os error 267 for deleted or virtual directories. 中文： 新建标签和分屏前验证继承的 cwd，避免目录已删除或为虚拟目录时出现 os error 267。
• SSH passthrough — nebula ssh user@host bootstraps Nebula integration on Linux bash/zsh remotes while preserving forwarding, query, and explicit-command forms. 中文： nebula ssh user@host 可在 Linux bash/zsh 远端引导 Nebula 集成，同时保持转发、查询和显式远程命令模式原样透传。

AI Workflow / AI 工作流

• opencode integration — adds an opencode plugin that routes turn state through the same sidebar and toast bridge as Claude Code and Codex. 中文： 新增 opencode 插件，通过与 Claude Code、Codex 相同的侧栏和通知桥接传递回合状态。
• Remote AI awareness — OSC cwd and command-state signals from bootstrapped SSH sessions update the local sidebar. 中文： 已引导的 SSH 会话可把 OSC cwd 和命令状态信号传回本地侧栏。

UI And UX / UI 与交互

• Right-side Files/Git drawer — adds filtering, persistent selection, drag-to-paste, Git staging/commit/push actions, and geometry aligned with the left tabs panel. 中文： 新增右侧 Files/Git 抽屉，支持筛选、持久选择、拖拽粘贴和 Git 暂存/提交/推送，并与左侧标签栏对齐。
• Chrome refactor — moves chrome and side-panel rendering into dedicated modules while keeping rendering and hit-testing geometry synchronized. 中文： 将 chrome 和侧面板渲染拆分到独立模块，同时保持渲染与 hit-test 几何同步。
• Default font — changes the packaged Nerd Font to MapleMonoNormal-NF-CN-Regular.ttf. 中文： 发布包默认 Nerd Font 更换为 MapleMonoNormal-NF-CN-Regular.ttf。
• Release documentation — updates README and INSTALL for the 0.2 package and GPL-3.0-only licensing. 中文： 更新 README 与 INSTALL 中的 0.2 发布包和 GPL-3.0-only 许可说明。

0.1.0 - 2026-07-07

Nebula Terminal's first public release.

Nebula Terminal 的第一个公开版本。

AI Integration / AI 集成

• Real brand marks in the sidebar — renders the Anthropic starburst for claude, the OpenAI blossom for codex, and Nerd Font icons for other common developer tools. 中文： 侧栏为 claude 显示 Anthropic 星芒、为 codex 显示 OpenAI 花结，并为其他常见开发工具显示 Nerd Font 图标。
• Live turn state — Claude Code hooks and Codex notify call the dependency-free nebula-hook.exe, forwarding prompt, completion, and input-needed events over a named pipe. 中文： Claude Code hooks 和 Codex notify 调用无依赖的 nebula-hook.exe，通过命名管道转发提交、完成和等待输入事件。
• Click-to-focus notifications — activating a toast raises the window, selects the originating tab, and focuses the originating split. 中文： 点击通知会前置窗口、选择来源标签页并聚焦来源分屏。
• Zero setup and self-healing — hook entries install automatically, recover after external configuration rewrites, remain scoped to Nebula, and can be removed with nebula setup-ai --remove. 中文： hook 条目自动安装，可在外部配置重写后自愈，仅作用于 Nebula，并可通过 nebula setup-ai --remove 移除。
• Codex chain mode — wraps an existing Codex notifier instead of replacing it. 中文： Codex chain 模式会包装已有 notifier，而不是覆盖它。
• Fallback signals — OSC 133 and BEL cover other CLIs and report long-command completion with duration. 中文： OSC 133 和 BEL 为其他 CLI 提供兜底，并在长命令结束时报告耗时。

Persistent Sessions / 会话保活

• Session residency — closing a window detaches its tabs while PTYs continue running; relaunching reattaches to the same processes and scrollback. 中文： 关闭窗口仅分离标签页，PTY 继续运行；再次启动可接回相同进程和滚屏内容。
• Cold restore — autosaved tab layout and working directories restore after reboot or crash, with crash-loop protection. 中文： 重启或崩溃后可从自动快照恢复标签布局和工作目录，并带崩溃循环保护。
• Single instance — subsequent launches hand off to the resident process. 中文： 后续启动会交给常驻进程处理，保持单实例。

Interface / 界面

• Seven-theme skin system — one token system drives seven light/dark themes across chrome, prompts, and dialogs, with persistence and hot reload. 中文： 一套设计 token 驱动七种明暗主题，覆盖 chrome、prompt 和对话框，并支持持久化与热重载。
• Sidebar tabs and splits — supports tab reordering, drag-to-dock splits, dimmed unfocused panes, zoom, and CJK-aware chrome text. 中文： 支持标签排序、拖拽停靠分屏、非焦点 pane 变暗、pane 缩放和 CJK-aware chrome 文本。
• Quick terminal — provides a global-hotkey Quake-style terminal with slide animation. 中文： 提供全局快捷键唤起的 Quake 风格终端和滑入动画。
• In-app settings — configures themes, backgrounds, opacity, shells, and completion behavior in grouped panels with true clipping. 中文： 应用内设置支持主题、背景、透明度、Shell 和补全行为，并使用真正裁剪的分组面板。
• Chrome utilities — adds the command palette, resize HUD, auto-hiding scrollbar, and visual bell. 中文： 新增命令面板、resize HUD、自动隐藏滚动条和 visual bell。
• Inline images — supports OSC 1337 images with lazy upload and scrollback anchoring. 中文： 支持 OSC 1337 内联图片、延迟上传和滚屏锚定。
• Welcome page — adds a fastfetch-style system introduction for new tabs. 中文： 新标签页提供 fastfetch 风格的系统欢迎信息。

Performance And Correctness / 性能与正确性

• Modern ConPTY host — bundles conpty.dll and OpenConsole.exe, pre-primes the DA1 handshake, improves resize behavior, and retains an in-box fallback. 中文： 随包提供 conpty.dll 和 OpenConsole.exe，预热 DA1 握手、改善 resize，并保留系统内置 ConPTY 回退。
• Coalesced resizing — interactive resizing updates the PTY once after the drag settles, while rendering remains damage-tracked. 中文： 交互式 resize 在拖动结束后一次性通知 PTY，同时继续使用 damage tracking 渲染。
• Boot instrumentation — NEBULA_BOOT_TRACE=1 reports per-stage startup timing. 中文： NEBULA_BOOT_TRACE=1 可输出逐阶段启动耗时。
• Native notifications — WinRT toasts use a registered Nebula identity, taskbar flashing, throttling, and a worker thread that cannot block rendering. 中文： WinRT 通知使用注册的 Nebula 身份、任务栏闪烁和全局限流，并在独立线程运行以避免阻塞渲染。

Shell Experience / Shell 体验

• Fish-style ghost completions — suggests commands from persistent JSONL history and filesystem paths, accepted with Right Arrow or Tab. 中文： 从持久化 JSONL 历史和文件路径提供 fish 风格幽灵补全，可使用右方向键或 Tab 接受。
• Built-in powerline prompt — provides a themed Git branch and clock prompt for PowerShell and Git Bash without plugins. 中文： 为 PowerShell 和 Git Bash 提供无需插件、包含 Git 分支和时钟的主题化 powerline prompt。
• Input quality-of-life fixes — supports unquoted paths with spaces, safely rewrites bare PowerShell environment assignments, and adds colored, clickable ls output. 中文： 支持未加引号的空格路径、安全改写裸 PowerShell 环境变量赋值，并为 ls 增加彩色可点击输出。
• OSC coverage — supports OSC 7, 8, 9, 9;9, 133, and 1337 for cwd, hyperlinks, notifications, semantic prompts, and images. 中文： 支持 OSC 7、8、9、9;9、133 和 1337，覆盖 cwd、超链接、通知、语义 prompt 和图片。