AnalyseDeCircuit/oxideterm v2.2.3

OxideTerm Native 2.2.3

on GitHub

中文 | English

中文

OxideTerm 2.2.3 新增动态背景、可叠加的视觉效果和按需安装的背景素材包，允许为系统浅色与深色模式分别配置完整外观，并重新整理首次使用引导。同时明确云同步的下载、合并与上传方向，修复 SSH 会话重连、Linux 粘贴编辑、macOS 远程桌面文件剪贴板，以及更新与便携版数据保留问题。

🎨 完整亮暗外观与背景编辑

• “跟随系统外观”支持分别配置浅色和深色两套外观，每套包含应用主题、终端主题与背景。切换系统亮暗模式时，界面、现有终端和背景一起更新，无须重新连接会话。
• 背景设置将图片或视频素材、叠加特效和背景交互分区展示；可以单独使用程序生成的效果，也可以把效果叠加在图片、动图或视频上。
• 新增九点对齐，结合现有适配方式决定裁切后保留的位置；素材不透明度、模糊、阅读遮罩、作用范围和启用页面可分别调整。
• 主题预览与编辑预览同时呈现背景、透明度和裁切效果。主题编辑使用独立草稿，取消后恢复原来的外观。
• 素材卡片左上角显示文件格式，右上角保留删除按钮，并标明当前使用的素材。修复部分视频和导入图片无法显示缩略图的问题。
• 按素材和效果的实际能力显示参数，静态内容不再出现无效的播放速度等控制。修复新增滑杆点击、拖动时偏离鼠标的位置，以及切换选项后设置页滚动位置跳动的问题。

✨ 程序生成效果与背景交互

• 新增轻纹理、雾光、光潮、光潮与粒子组合、流星、景深粒子和水面折光；各效果提供适用的强度、颜色、大小、速度、方向、粗糙度、光泽或密度控制，默认颜色可取自当前主题。
• 特效强度与素材不透明度分别控制，统一有无素材时的强度表现，改善特效叠加在图片、视频和动图上过淡的问题。
• 新增“输入时暂停动效”，连续输入时暂停动态素材和效果，停止输入约一秒后恢复。此选项由用户开启。
• 新增背景视差，静态图片和效果层可随鼠标轻微移动；景深粒子的不同层使用不同位移幅度，终端文字保持固定。
• 新增静态图片的缓慢运镜，支持平移、推近和拉远，可调整幅度与速度，并在往返运动时保留画面边缘覆盖。
• 新增全天候光照，按本地时间渐变背景光线与色彩，并可预览清晨、午后、傍晚和夜间。应用与终端主题仍按各自的亮暗配置切换。
• 背景切换增加平滑过渡；窗口不活跃、不可见或最小化时暂停播放，并遵循现有减少动态效果设置。

🎬 原生视频播放与按需素材包

• 视频背景接入 macOS 系统媒体解码、Windows Media Foundation 和 Linux GStreamer；支持原生视频缓冲或纹理进入对应图形后端，在能力允许时减少 CPU 拷贝与重复上传。
• 保留软件解码和像素上传路径；自动模式按持续处理负载调整播放尺寸与帧率，用户手动设置的上限保持不变。硬件加速是否可用取决于设备、驱动和视频格式。
• 背景与预览复用同一媒体处理结果，按视频时间调度显示，限制提前解码和缓冲占用；将支持路径上的缩放、裁切与模糊交给图形后端处理。
• 修复 Windows 视频缓冲未提供行跨度时导致缩略图和背景不显示的问题；修复 4K 软件缩放后不透明视频的颜色与透明度处理。
• Linux 发行包补齐媒体解码组件及插件扫描器定位，使打包后的程序能够发现自带的解码支持。
• 新增插件市场“背景素材”分类与素材库“获取更多背景”入口。视频素材独立于主程序分发，可按需安装，主程序保留现有静态背景。
• 背景包安装后将声明的素材导入当前配置的素材库；便携版使用自己的数据目录。安装不改变当前主题和背景，卸载包后已导入素材继续保留，可在素材库单独删除。
• 已发布的 OxideTerm Backgrounds 1.0.0 提供“晨雾”和“夜流”两段原创 3840 × 2160、24 帧/秒、16 秒循环视频，适用于浅色和深色外观；需使用本次或更高的主程序版本安装。

🧭 首次使用引导与界面体验

• 首次使用引导整理为五页：欢迎与须知、外观、连接与操作、AI 与命令行、开始使用。宽窗口采用分栏，窄窗口自动调整布局，内容区随窗口尺寸变化。
• 首页使用独立应用标记与标题，保留语言选择和必要说明；主题预览集中在外观页，最后一页聚焦打开终端、新建连接和导入连接。
• 步骤导航和页数居中，复用现有切换与入场动画；按钮颜色跟随当前主题，提示与说明重新整理为更直接的引导文案。
• 新用户只显示欢迎引导，不再同时显示旧版迁移介绍；完成引导前先保存状态，避免重新启动后重复出现。保存失败时保留引导并给出提示。（Issue #666）
• 半透明面板与侧边区域新增随主题和透明度调整的柔和边缘层次，改善背景下分割线突兀的问题；背景和媒体绘制保留圆角裁切。
• 新建连接表单改用已安装插件的状态判断，避免绘制时反复探测外部程序；SSH 代理发现也减少阻塞探测，改善 Windows 打开表单和切换远程桌面页面的卡顿。
• 调整 Windows 背景与界面绘制路径，减少重复图形工作；修复依赖真实时间的弹层关闭状态，保持界面动画时钟一致。

☁️ 云同步方向与首次下载

• 新增只读“查看云端”入口，允许先检查云端配置，再决定是否应用。
• 同步预览明确提供“使用云端配置”“合并本机与云端”“用本机更新云端”三种方向，并使用对应的说明和确认按钮。
• 新设备首次发现已有云端配置时，默认预览“使用云端配置”，确认后下载应用并建立同步基线，不上传本机默认设置；首次自动同步同样需要明确确认。（Discussion #663）
• 预览中的本机更改保留在计划内，取消不会提前推进已保存的同步基线。合并时重新读取本机当前设置，纳入预览期间发生的本机更改；各方向均保留未选同步范围，云端自身存在冲突时，下载前需完成选择。
• 下载完成后记录正确的云端状态与下载历史，保留现有恢复机制和同步密码修改流程。

🔌 终端、SSH、SFTP 与远程桌面修复

• SSH 远端 Shell 退出后，可通过原窗格的重连按钮或 Enter 恢复会话，保留窗格身份和滚动历史；仍在使用的 SFTP、端口转发和其他消费者继续持有共享连接。（Issue #669）
• 远程 Shell 集成失败时显示具体原因，包括 SFTP 不可用、不支持的 Shell、读写权限和安装未完成，并明确终端本身是否仍可使用，避免把可选集成问题误认为 SSH 连接失败。（Issue #664）
• 修复 Linux 多行粘贴编辑窗口只能退格、删除却无法输入字符的问题；文字输入进入现有编辑器，编辑期间不会被转发给后台终端，确认粘贴后才发送。（Issue #677）
• 修复 SFTP 文件拖放释放鼠标时先清理拖动状态的问题，使跨窗格拖放正确进入上传、下载或冲突处理流程。
• 修复 macOS RDP 文件剪贴板同步，连接建立或切回窗口时同步本地复制的文件，使远端菜单能直接识别可粘贴文件，并避免把远端文件重复回传。（Issue #670）
• 修复 Linux 客户端标题栏关闭窗口时的工作区重入问题。

📦 更新与便携版

• 更新完成后先释放当前工作区更新，再执行保存历史和退出流程，修复 macOS 旧进程在更新退出时出现崩溃提示的问题。
• Windows 应用内更新统一由主程序启动更新辅助程序，等待旧进程结束后替换并启动新版，避免安装器重复启动辅助程序影响自动重启。
• 启用便携存储时，更新包仍匹配当前运行形式：macOS 应用包、Linux AppImage 和解压式便携版分别使用对应安装包。
• macOS 替换应用包时保留包内的便携标记、配置和数据目录；替换或数据恢复失败时回滚，避免更新后丢失便携数据。

📌 升级说明

• 背景动效、输入时暂停、视差、运镜和全天候光照均可自行选择；需要保持静态外观时可关闭这些选项。播放性能和可用加速路径随硬件、驱动及媒体格式变化，可在自动模式之外手动设置分辨率和帧率。
• 视频素材包从插件市场按需安装，不随主程序携带。背景包导入的视频会占用当前配置的数据目录空间；卸载插件不会自动删除这些已导入的素材。
• 更新退出、安装和重启修复由新版客户端执行，从旧版首次升级时，旧客户端仍使用原有更新逻辑。
• 本版更新日志范围：v2.2.2…v2.2.3。

English

OxideTerm 2.2.3 adds animated backgrounds, composable visual effects, and on-demand background packs, with complete appearance profiles for the system's light and dark modes and a redesigned first-run guide. It also makes cloud download, merge, and upload directions explicit and fixes SSH session reconnection, Linux paste editing, macOS remote desktop file clipboard synchronization, and update handling for installed and portable builds.

🎨 Complete light and dark appearances and background editing

• Follow System Appearance now supports separate light and dark profiles, each containing an application theme, terminal theme, and background. System appearance changes update the interface, existing terminals, and background together without reconnecting sessions.
• Background settings separate image or video media, overlay effects, and interactions. Generated effects can stand alone or be layered over images, animations, and videos.
• Added nine-point alignment to control which part of a background remains visible after cropping. Media opacity, blur, a readability overlay, background scope, and enabled pages can be configured separately.
• Theme and editor previews show the background, transparency, and crop together. Theme editing uses a separate draft; cancellation restores the previous appearance.
• Media cards show their file format at the top left, retain deletion at the top right, and identify the active item. Fixed missing thumbnails for some videos and imported images.
• Controls now reflect the selected media and effect, hiding irrelevant playback-speed controls for static content. Fixed pointer offsets in new sliders and settings scroll jumps after changing options.

✨ Generated effects and background interactions

• Added subtle texture, fog glow, light tides, combined tides and particles, meteors, depth particles, and water caustics. Effects expose applicable strength, color, size, speed, direction, roughness, sheen, or density controls, with default colors derived from the current theme.
• Effect strength and media opacity are independent. Strength behaves consistently with or without media, improving overlays that were too faint on images, videos, and animations.
• Added an optional Pause Effects While Typing setting. Animated media and effects pause during continuous input and resume approximately one second after typing stops.
• Added background parallax for static images and effect layers. Depth-particle layers move by different amounts while terminal text stays fixed.
• Added slow camera motion for static images, with pan, zoom-in, and zoom-out options, adjustable amount and speed, and edge coverage throughout the repeating motion.
• Added all-day lighting that gradually changes background light and color with local time, with morning, afternoon, evening, and night previews. Application and terminal themes continue to follow their configured light and dark profiles.
• Background changes now transition smoothly. Playback pauses when the window is inactive, hidden, or minimized and follows the existing reduced-motion settings.

🎬 Native video playback and on-demand background packs

• Video backgrounds use macOS system media decoding, Windows Media Foundation, and Linux GStreamer. Native video buffers or textures can enter the corresponding graphics backend to reduce CPU copies and repeated uploads where supported.
• Software decoding and pixel-upload paths remain available. Automatic mode adjusts playback dimensions and frame rate under sustained processing load while preserving manually configured limits. Hardware acceleration depends on the device, driver, and video format.
• Backgrounds and previews share media processing results, schedule presentation by video time, and bound decode-ahead work and buffering. Supported paths perform scaling, cropping, and blur in the graphics backend.
• Fixed missing Windows video thumbnails and backgrounds when decoded buffers omit their row stride. Fixed color and opacity handling for opaque videos resized at 4K through the software path.
• Linux packages now include media decoding components and locate the bundled plugin scanner so packaged applications can discover their decoder support.
• Added a Background Media marketplace category and a Get More Backgrounds entry in the media library. Videos are distributed independently as optional packs; the application retains its existing static backgrounds.
• Installing a pack imports its declared media into the current configuration's library, including the portable data directory. Installation leaves the current theme and background unchanged. Imported media remains after uninstalling the pack and can be deleted separately from the library.
• The published OxideTerm Backgrounds 1.0.0 pack provides two original 3840 × 2160, 24 fps, 16-second loops, Dawn Mist and Night Flow, for light and dark appearances. Installation requires this host release or a later version.

🧭 First-run guide and interface experience

• Reorganized onboarding into five pages: Welcome and Notices, Appearance, Connections and Operations, AI and Command Line, and Getting Started. Wide windows use columns; narrow windows adapt the layout, and the content area follows the window size.
• The first page uses a separate application mark and title, retaining language selection and essential information. Theme preview is concentrated on Appearance, and the final page focuses on opening a terminal, creating a connection, and importing connections.
• Centered step navigation and page numbering, reused existing entry and switching animations, made button colors follow the theme, and rewrote guidance more directly.
• New users see onboarding without the old-version migration introduction. Completion is saved before closing to avoid showing the guide again after restart; a failed save keeps the guide open with a message. (Issue #666)
• Translucent panels and sidebar regions now have softer edge definition that follows the theme and opacity, improving abrupt separators over backgrounds. Background and media rendering retain rounded clipping.
• Connection forms use installed-plugin state instead of repeatedly probing external programs during rendering. SSH agent discovery also avoids blocking probes, improving responsiveness when opening forms and switching remote desktop pages on Windows.
• Updated Windows background and interface rendering to reduce repeated graphics work. Fixed overlay dismissal states that depended on wall-clock time so they use the interface animation clock consistently.

☁️ Cloud sync direction and first-device downloads

• Added a read-only View Cloud Configuration entry to inspect remote configuration before applying it.
• Sync previews explicitly offer Use Cloud Configuration, Merge Local and Cloud, and Update Cloud from This Device, with matching explanations and confirmation buttons.
• A new device discovering existing cloud configuration defaults to previewing Use Cloud Configuration. Confirmation downloads and applies it, establishes a sync baseline, and does not upload local defaults. Initial automatic sync also requires explicit confirmation. (Discussion #663)
• Local preview edits remain in the plan; cancellation does not advance the saved sync baseline. Merging re-reads current local configuration to include edits made during the preview. All directions preserve excluded scope, and downloads require choices for conflicts already present in the cloud.
• Download completion records the correct cloud state and download history, retaining existing recovery and sync-password-change flows.

🔌 Terminal, SSH, SFTP, and remote desktop fixes

• After a remote SSH shell exits, its reconnect button or Enter restores the session in the original pane, preserving pane identity and scrollback. SFTP, forwarding, and other consumers retain their ownership of the shared connection. (Issue #669)
• Remote shell integration failures now explain the cause, including unavailable SFTP, unsupported shells, read/write permissions, and incomplete installation, and clarify whether the SSH terminal remains usable. (Issue #664)
• Fixed the Linux multiline paste editor accepting Backspace and Delete but not typed characters. Text reaches the existing editor, editing keys are not forwarded to the background terminal, and content is sent only after confirming the paste. (Issue #677)
• Fixed SFTP mouse release clearing drag state before completing a drop, restoring upload, download, and conflict handling across panes.
• Fixed macOS RDP file clipboard synchronization. Connecting or returning to the window advertises locally copied files so the remote menu can recognize available files without a preceding paste shortcut, while avoiding echoing remote-origin files. (Issue #670)
• Fixed workspace reentry when closing a Linux window through its client-side titlebar.

📦 Updates and portable builds

• Update completion releases the current workspace update before saving history and quitting, fixing the macOS old process reporting a crash during update shutdown.
• Windows in-app updates now launch the helper from the application, wait for the old process to exit, replace files, and start the new version, avoiding duplicate helper launches from the installer that interfered with automatic restart.
• Portable storage preserves the running package's update format: macOS application bundles, Linux AppImages, and extracted portable builds each select their corresponding package.
• macOS application replacement preserves bundle-local portable markers, configuration, and data directories, with rollback if replacement or data restoration fails.

📌 Upgrade notes

• Background effects, typing pauses, parallax, camera motion, and all-day lighting are optional. Disable them for a static appearance. Playback performance and acceleration depend on hardware, drivers, and media formats; resolution and frame rate can be set manually instead of using automatic mode.
• Video packs are installed on demand from the marketplace and are not bundled with the application. Imported videos occupy space in the current configuration's data directory; uninstalling a plugin does not automatically delete imported media.
• Update shutdown, installation, and restart fixes are performed by the new client. The first upgrade from an older version still uses that older client's update logic.
• Full release range: v2.2.2…v2.2.3.

📥 Download for your system

Portable archives, signatures, and sha256sums.txt remain available in the release assets below.

插件市场兼容说明

插件市场 v1 已冻结，原地址、索引内容和对应安装包持续保留。旧客户端仍可使用冻结目录中的插件，但不会看到后续的新插件和更新；请升级到支持 v2 目录的主程序版本。后续插件、新版本和版本历史仅发布到 v2。

Plugin marketplace compatibility

The v1 plugin marketplace is frozen. Its original URL, exact contents, and referenced packages remain available. Existing clients can keep using the frozen catalog but will not see subsequent plugins or updates; upgrade to a host version supporting v2 to receive them. All subsequent plugins, releases, and version histories are published only to v2.

xattr -cr ~/Downloads/OxideTerm_*.dmg
# or after install / 或安装后
xattr -cr /Applications/OxideTerm.app

# AppImage
chmod +x OxideTerm_*_linux_*.AppImage && ./OxideTerm_*_linux_*.AppImage

# Debian/Ubuntu
sudo dpkg -i OxideTerm_*_linux_*.deb && sudo apt-get install -f

# Fedora/RHEL-compatible systems
sudo dnf install ./OxideTerm_*_linux_*.rpm

🔗 Links

• Documentation: https://oxideterm.app
• GitHub Issues: https://github.com/AnalyseDeCircuit/oxideterm/issues
• Changelog: https://github.com/AnalyseDeCircuit/oxideterm/blob/main/.github/release-notes/stable-changelog.md