Ramag Platform

基于 Ramag 演进的可扩展、本地优先开发者桌面平台。

An independent Ramag-based extensible desktop platform for local-first developer workflows.

MySQL · PostgreSQL · SQLite · Redis · MongoDB · Git · SSH / SFTP · COS / OSS · Clipboard

Database · Git · SSH · Object Storage · Clipboard · Rust + GPUI Kit

本项目 Releases · 上游 Ramag · 快速开始 · 功能 · 主线开发计划 · 性能 · 贡献 · 安全

---

项目状态 / Project status

本仓库 bruceblink/ramag-platform 是基于 tools-rs/ramag 演进的独立下游项目。当前代码保留数据库、Git、SSH、对象存储、容器管理、剪贴板、系统监控和其他既有工具；2026-10-24 起仅移除本机协作和 JSON Path 提取器，后续只做现有功能维护和打磨。it-tools-template 继续独立提供自己的 Web/PWA、Electron 和通用工具工作台。

This repository, bruceblink/ramag-platform, is an independent downstream project based on tools-rs/ramag. It keeps the existing native workspaces and GPUI client, removes only local collaboration and the JSON Path extractor, and now focuses on maintenance. it-tools-template independently develops its Web/PWA, Electron, and general-purpose tool workspaces.

可验证交付	当前状态
项目身份	bruceblink/ramag-platform，独立下游项目；不代表 tools-rs/ramag 官方主线
代码基线	沿用 Ramag 0.0.5 workspace 基线，并包含本仓库后续的 UI 修复与平台设计记录
独立发布	本项目提供三平台安装包、更新清单和 SHA-256 清单；最新版本见本项目 Releases
插件平台	系统监控试点和九批保留工具已完成编译期静态插件装配；接口见静态插件接口与开发手册，当前任务统一见主线开发计划；动态加载和插件市场未进入实现范围
上游协作	通用修复可整理后向 tools-rs/ramag 提交独立 PR；平台化架构和专属功能在本仓库继续演进
支持平台	Linux x86_64、macOS 12+（Apple Silicon / Intel）、Windows 10/11 x64；三平台安装包见本项目 Releases
数据边界	连接配置、凭据与剪贴历史保存于本机；Ramag 不提供托管服务，也不主动上传这些数据

Ramag Platform is under active independent development. Contributions, reproducible feedback, and security reports are welcome; see CONTRIBUTING.md and SECURITY.md.

项目关系 / Project relationship

tools-rs/ramag                         上游项目：通用修复和兼容性协作
        ↑ 独立 PR
bruceblink/ramag-platform              当前项目：平台化设计、内置插件和独立演进

本项目不是上游仓库的镜像，也不会把平台化设计等待上游合并后才继续。提交上游的变更应保持单一职责、可独立验证，并从上游基线单独整理。平台核心、原生能力协议和 GPUI 客户端留在本仓库；通用工具和 Electron 工作台由 it-tools-template 负责。

This is not a mirror of the upstream repository. General fixes may be prepared as focused upstream pull requests, while the platform core, plugin API, and downstream product direction remain independently maintained here.

为什么选择 Ramag

Ramag 的价值来自 Rust/GPUI 原生工作区、远程连接、本地安全边界和已有工具的稳定维护。数据库、Git、对象存储和其他工作台继续保留在 Ramag，同时由 it-tools-template 独立提供自己的 Web/Electron 实现。两个项目只在应用场景上互补，不共享进程、代码包或接口协议。

一个工作台	本地优先	面向真实数据量	原生交互
数据库、Git、SSH、云存储和剪贴板共享统一窗口与交互体系	数据库、SSH 和云存储凭据、剪贴历史加密后落本地，主密钥进入系统凭据库	百万级历史、十万文件与十万级数据库种子均有压力验证	Rust + GPUI，耗时任务与 UI 线程隔离

连接数据库处理数据  ↔  在 Git 中检查改动  ↔  通过 SSH 操作远程主机  ↔  管理云端对象  ↔  找回剪贴上下文

核心工作台

工作台	解决的问题	核心能力
数据库	在多种数据库间查询、编辑、迁移和同步	MySQL、PostgreSQL、SQLite、Redis、MongoDB；生产只读保护；SQL 数据库支持 JSONL，MySQL / PostgreSQL 支持 SQL 导入导出
Git	在不离开上下文的情况下检查和完成版本控制操作	Diff、暂存、提交、分支、冲突处理、Rebase、Cherry-pick 与文件编辑
SSH / SFTP	连接远程主机并安全处理远程文件	系统 OpenSSH、内嵌终端、SFTP、传输队列、JumpServer 导入与生产写保护
云存储	面向指定 Bucket 管理对象，而非要求宽泛账号权限	腾讯云 COS、阿里云 OSS、上传下载、预览、收藏、传输进度与只读模式
剪贴板（可选）	找回跨应用的短期上下文	本地加密历史、全局快捷键、隐私标记、来源应用黑名单与自动清理

快速开始

直接安装

本项目的 Releases 页面 提供三平台安装包。Windows x64 提供安装程序，macOS 提供 Apple Silicon 和 Intel DMG，Linux x86_64 提供 Debian 安装包与 AppImage。上游 Ramag 安装包不代表本项目的发布物。

各平台安装包命名如下：

系统	安装包	最低版本
Apple Silicon Mac	Ramag-*-macos-arm64.dmg	macOS 12
Intel Mac	Ramag-*-macos-x86_64.dmg	macOS 12
Windows x64	Ramag-*-windows-x64-setup.exe	Windows 10
Linux x86_64	Ramag-*-linux-amd64.deb / Ramag-*-linux-x86_64.AppImage	Ubuntu 24.04 或兼容发行版

当前 workspace 版本为 0.9.2。Windows 安装包尚未做 Authenticode 签名，macOS 安装包尚未做 Developer ID 签名与 Apple 公证；完整状态见桌面端构建与发布。

Git 功能需要系统已安装 git；SSH 管理、内嵌终端和数据库 SSH 隧道需要系统 OpenSSH。数据库、Git 仓库、SSH 凭据和剪贴板内容不会上传到 Ramag 服务。

当前源码的正式构建会自动检测本项目的最新稳定 Release。可在“设置 → 关于”关闭自动检测， 或手动检查、下载和取消。没有新版本时显示“当前已是最新版本”。 下载完成并通过 SHA-256 校验后，可点击“安装安装包”继续安装；安装步骤由用户确认。 v0.9.2 已包含数据库选择复制、MongoDB 工具栏和 SQLite 稳定性修复；v0.9.1 包含前一版本的页面反馈修复。 当同平台旧安装包已缓存且 Release 提供更小的差分包时，客户端优先下载差分包并重建安装器； 缺少旧包、补丁不可用或校验失败时改为完整包。具体条件见更新检测与下载。

Windows CPU 温度监测需要单个物理 CPU 包、受支持的型号及单独安装的官方签名 PawnIO 驱动。当前支持 Intel Alder Lake 型号 0x9a（具备 package DTS）和 AMD Zen 3 系列 0x19 / 型号 0x21（包括 Ryzen 9 5900X）。在系统监控 Thermals 页点击 Enable CPU temperatures…，由用户确认 Windows 授权；Ramag 主窗口保持原权限。缺少驱动、授权被拒或采集失败时显示具体原因，不填充虚假的零温度。Ramag 不自动安装驱动；禁用或退出后需要重新启用温度采集。

从源码运行

准备 Git、rustup 和平台构建工具。仓库已通过 rust-toolchain.toml 统一使用 Rust stable channel；Windows 激活脚本固定使用 Visual Studio 18 2026 的 MSVC host/target，Linux 和 macOS 继续使用本机 host，不需要手动切换 Rust 版本。

macOS 还需要 Xcode Command Line Tools：

xcode-select --install

克隆并运行。Windows、Linux 和 macOS 使用同一条命令：

git clone https://github.com/bruceblink/ramag-platform.git
cd ramag-platform
cargo run -p ramag-bin

日常开发命令由 Cargo 配置统一提供：

cargo dev           # 运行 Debug 桌面应用
cargo dev-release   # 运行 Release 桌面应用
cargo build         # 构建 workspace 并生成 ramag 可执行文件
cargo run -p ramag-bin # 运行桌面应用
cargo fmt-check     # 检查格式
cargo check-all     # 检查 workspace 所有 target
cargo clippy-all    # 运行 Clippy，警告视为错误
cargo test-all      # 运行 workspace 测试

Linux 上 Ramag 使用 Secret Service 保存本地数据加密主密钥。Ubuntu/WSL 运行源码前需安装 gnome-keyring；WSL 通常没有桌面登录自动创建的 D-Bus 会话，可在会话中启动应用：

sudo apt install gnome-keyring
dbus-run-session -- ./target/release/ramag

若运行 Debug 版本，把最后一行替换为 dbus-run-session -- cargo run -p ramag-bin。已有 redb 数据库但原系统凭据不可用时，Ramag 会停止启动以免覆盖数据；请先恢复创建该数据库时保存的主密钥，不要删除数据库或凭据条目。

三个平台仍需要各自的原生开发组件：Windows 使用 Visual Studio 18 2026 Build Tools 的 C++ workload、Windows 10/11 SDK 和 CMake；Release 还需要 FXC 与 Inno Setup。macOS 需要 Xcode Command Line Tools；Linux 需要桌面开发库，完整列表见桌面端构建与发布。Rust stable channel、Cargo.lock 和日常命令由仓库统一管理。首次构建需要下载 GPUI 等依赖，耗时会明显长于后续增量构建。

Windows 日常开发先在当前 PowerShell 激活 MSVC 环境；脚本通过 vswhere.exe 和 vcvarsall.bat 载入 Visual Studio 18 2026 的 x64 编译器、链接器、Windows SDK 和 CMake，并固定使用 Visual Studio 18 2026 的 x64 CMake 生成器。脚本只修改当前 PowerShell 进程，不替代 Cargo 命令，也不修改用户级环境变量：

. .\scripts\windows\enable-msvc-toolchain.ps1
cargo build
cargo run -p ramag-bin
cargo check-all
cargo clippy-all
cargo test-all

Linux 和 macOS 直接执行同样的 Cargo 命令；Windows 原生构建和打包脚本会在内部加载同一套 MSVC host/target，不需要用户手动配置 GNU 或 MinGW 环境。

功能细节

数据库工作台

从连接、结构浏览、查询，到结果编辑和完整迁移，多类数据库共用一套清晰的工作流。

MySQL、PostgreSQL 与 SQLite

• Schema、表、视图、列、索引与 DDL 浏览。
• SQL 补全、高亮、多语句执行、光标语句执行、格式化与 EXPLAIN。
• 查询取消、结果分页、排序、筛选和单元格编辑。
• MySQL、PostgreSQL 与 SQLite 图形化表设计器：创建或修改表名、字段结构，预览 DDL 后再执行。
• 大整数、高精度数值、JSON/JSONB、二进制、时间以及 PostgreSQL 原生类型保真展示。
• SQL 数据库支持表级 JSONL 导出，MySQL / PostgreSQL / SQLite 支持表级 JSONL 导入；MySQL / PostgreSQL 支持 Schema / 数据库级 SQL 导入导出。主键表使用 keyset 分页，深页不会反复跳过前置数据。

SQLite 以本地数据库文件为连接目标，支持 :memory:、相对路径和 Windows 绝对路径；连接配置不会伪造端口、认证、TLS 或 SSH 参数。SQLite 查询使用单连接池，支持显式事务、保存点、回滚、表结构元数据、外键、索引、触发器和视图读取。

Redis

• 以 : 自动折叠 Key 命名空间，大型 Keyspace 使用游标 SCAN 和虚拟列表。
• String、Hash、List、Set、ZSet、Stream 六种类型统一查看与编辑。
• TTL 管理、大 String 有界加载、大集合自动分批继续加载。
• Key 树批量识别类型并展示紧凑标签；同一路径既是命名空间又是实际 Key 时，可在设置中开启“同名 Key 下沉展示”。
• 内置命令控制台；危险、阻塞和生产写命令在执行前识别。
• 整库 JSONL 迁移保留类型、TTL、顺序、分数、Stream ID 与二进制内容。

MongoDB

• Database、Collection、索引、统计信息和文档浏览。
• find、aggregate 与通用命令，支持格式化、历史记录和多查询标签。
• 嵌套文档按 dotted path 展开，ObjectId、Decimal128、DateTime、Int64 等使用 Extended JSON 保真往返。
• 文档编辑、集合级 JSONL 和数据库级导入导出；混合类型 _id 使用 keyset 连续读取。

连接与数据安全

• TLS、三档证书验证、自定义 CA 与系统 OpenSSH 隧道。
• 连接测试与颜色标签。
• 数据库连接配置统一在全局设置中导入或导出，覆盖 MySQL、PostgreSQL、SQLite、Redis 与 MongoDB；加密文件使用独立口令。
• 连接可标记为生产环境：写查询、结果编辑和导入入口统一进入只读保护。
• 结果搜索支持字符串 ID 与整数 ID 双向转换，内置 Base10、Base16、Base36、Base58 Bitcoin、Base58 Flickr 和自定义字符表，也可调用经过路径、超时与输出上限校验的外部转换器。
• SQL、Redis、MongoDB 使用独立执行 runtime，某个慢查询不会直接挤占其他数据库的任务线程。

统一操作与快捷键

• 快捷键中心可查看、修改和重置应用快捷键；各工作台也提供统一的连接或仓库快速切换入口。
• 在支持的数据区域，macOS 使用 ⌘ + 双击、Windows/Linux 使用 Ctrl + 双击 可复制当前已加载的完整值；普通双击仍用于打开、编辑或下钻。
• SQL、MongoDB、Redis、Git Diff/项目文件、SSH/SFTP、对象存储和剪贴板的复制行为与成功提示已统一。
• 所有可滚动区域保留鼠标滚轮和触控板滚动，但不显示可见滚动条，避免挤占内容空间。

四引擎数据同步

• 支持 MySQL、PostgreSQL、Redis 与 MongoDB 之间同类型连接的数据同步。
• SQLite 当前支持本地文件查询与结构管理，不参与跨连接数据同步；同步入口会明确拒绝 SQLite，避免展示不可执行的选项。
• 从真实元数据选择数据库、Schema、表或集合，执行前明确展示源、目标和覆盖范围。
• 同步前检查目标对象与依赖关系，并对写入已有库或 Schema 的操作再次确认。
• PostgreSQL 同步保留枚举与自定义类型依赖；Redis 保留类型与 TTL；MongoDB 保留 BSON 类型语义。
• 任务完成后汇总成功、跳过与失败对象，错误信息保留到具体对象和阶段。

Git 工作台

Ramag 的 Git 体验围绕“看清改动，然后安全完成操作”展开，而不是把命令行按钮化。

执行关键 Git 写操作前，建议确认工作区状态并保留可恢复点。

打开仓库 → 检查工作区 → 对照 Diff → Stage → Commit → Push / Pull

• Changes、Project Files、Stash、历史日志、Commit 详情、Blame 与 Reflog；文件树统一文件夹展开/收起和文件图标。
• Unified / Split Diff、整文件上下文、35 种语法高亮和超大 Diff 虚拟化。
• Stage / Unstage、Amend、Branch、Tag、Stash、Merge、Rebase、Cherry-pick。
• 冲突三栏处理，可继续或中止 Merge / Rebase / Cherry-pick 流程。
• 提交图、分支与远端状态、文件编辑和自动保存。
• Markdown 文件默认渲染为预览，可随时切换回原文；分支、远端、Tag 和 Stash 的操作集中在侧栏行菜单与右键菜单中。
• 支持从远程 URL 克隆到本地目录；各仓库分栏宽度在当前会话内相互隔离，重新启动后恢复默认布局。
• 文件监听按路径增量刷新；普通保存不重扫整个仓库。

写操作与网络认证直接复用系统 Git、SSH Agent 和用户已有配置，不在应用中再造一套不兼容的凭据体系。

SSH 管理

SSH 管理把连接配置、内嵌终端和远程文件浏览放在同一个工作区中，并继续复用系统 OpenSSH 的配置、主机校验和认证能力。

选择连接 → 打开终端与 SFTP → 在远程目录间浏览、预览和传输文件

• 新建或编辑连接时可解析 ssh user@host -p 22 -i /path/to/key，支持密码、系统 SSH 配置和密钥认证；连接参数与密码使用本机主密钥加密保存。
• 原生内嵌终端支持多个标签、ANSI 样式和常用键盘输入；每个连接始终保留至少一个终端。
• SSH 命令中的 -L、-R、-D 端口转发会随 profile 解析、保存并传给交互终端；终端标签显示会话状态，已退出的标签可以单独重连。
• SFTP 支持目录浏览、面包屑、名称搜索、文本预览与编辑、日志跟随、上传下载、目录传输和任务进度。
• 可将当前路径、目录或文件拖到终端区域，按对应目录创建一个新终端，不影响已有终端。
• JumpServer 导入支持保存多个加密登录、读取组织与资产树、选择授权账号，并生成可继续编辑和测试的 SSH 连接。
• 生产连接会禁止 SFTP 上传、编辑、重命名和删除；内嵌终端仍可使用，命令权限由远端账号和服务器策略负责。

云存储工作台

云存储工作台面向用户明确配置的 Bucket，不要求账号具备列出全部 Bucket 的权限。

• 支持腾讯云 COS 与阿里云 OSS，凭据和工作区状态使用本机主密钥加密保存。
• 每个账号至少配置一个 Bucket、Region 和可选 Root Prefix；Endpoint 由服务商与 Region 自动生成。
• 支持目录面包屑与直接路径输入、名称模糊筛选、目录优先排序和路径收藏。
• 支持对象元数据、常见文本与 JSON 格式化查看，SFTP 与对象存储预览上限均为 50 MiB。
• 上传、下载、覆盖确认、取消和进度统一进入传输面板；重复任务只保留一条记录。
• 生产模式默认关闭；开启后隐藏上传、删除等写操作，只保留浏览、查看与下载。

剪贴板工作台

⌘⇧V / Ctrl+Shift+V → 输入关键词或筛选类型 → Enter → 粘贴回原窗口

• 应用运行期间后台采集，无需保持剪贴板页面打开。
• 支持纯文本、富文本、链接、颜色、图片和文件路径。
• 记录来源应用，可加入黑名单；macOS 下遵循 Concealed / Transient 隐私标记。
• 复制、纯文本复制、自动切回来源应用并粘贴。
• 最近历史常驻有界缓存，完整历史与图片媒体在本地加密保存。
• 按数量和时间自动清理；图片使用缩略图、并发加载上限和内存预算。
• Windows 关闭主窗口后可驻留系统托盘，采集与全局快捷抽屉继续工作。
• 启用、采集、全局热键和清空全部历史统一放在全局设置中；关闭剪贴板后不显示工具入口，也不注册热键。

Windows 系统设置

Windows 用户可打开“设置 → 系统设置”，启用“关闭时最小化到任务栏托盘”。启用后关闭主窗口只会隐藏窗口，Ramag 会继续在后台运行；点击托盘图标可重新打开窗口，使用托盘菜单中的“退出 Ramag”才会结束进程。关闭此开关后恢复默认的关闭行为。

剪贴历史与类型筛选	采集、自动粘贴与应用黑名单设置

剪贴板采集默认关闭，需要在设置中主动启用。常用快捷键：

操作	macOS	Windows
打开剪贴板抽屉	⌘⇧V	Ctrl+Shift+V
执行 SQL / MongoDB 查询	⌘Enter	Ctrl+Enter
执行光标所在 SQL	⌘⇧Enter	Ctrl+Shift+Enter
新建查询标签	⌘T	Ctrl+T
格式化 SQL / MongoDB JSON	⌘⇧F	Ctrl+Shift+F
在数据库、Git、SSH、云存储间切换	⌘1 / ⌘2 / ⌘3 / ⌘4	Ctrl+1 / Ctrl+2 / Ctrl+3 / Ctrl+4

经得起数据量放大的性能设计

以下为 Apple M1 Max、Release 构建的代表性结果；数据库运行在本机 Docker 回环网络。

场景	实测结果
当前仓库完整 VCS 刷新	16.217 ms 中位数
当前仓库单路径状态	11.779 ms 中位数
100,000 条 VCS 状态补丁合并	91.917 μs
100,000 次提交图布局	2.553 ms
MySQL 100,005 行全库导出	871 ms，约 11.48 万行/s
PostgreSQL 100,004 行导出	884 ms，约 11.31 万行/s
MongoDB 125,102 文档导出 / 导入	1.761 s / 2.371 s
Redis 45,014 Key 完整保真导出 / 导入复核	1.569 s / 13.794 s
1,000,000 条剪贴历史读取最近 500 条	5.513 ms 中位数
1,000,000 条剪贴历史完全无命中搜索	219.915 ms 中位数
剪贴板 500 × 4 KiB 即时过滤最坏样本	1.918 ms 中位数
4K 剪贴图片缩略图	58.603 ms，后台执行

这些数字背后是几条明确原则：能增量就不全量，能分页就不整库驻留，能虚拟化就不一次构造所有行，CPU 与 IO 重活不占用 UI 线程。

历史测试环境、P95、数据库吞吐、优化前后对照和复核方式见性能报告。当次百万条加密历史的常规深度搜索从约 12.5 秒降到约 0.2 秒；结果不代表当前版本或其他环境的性能保证。

本地优先，不等于只做“能跑”

• 数据库密码与敏感配置经 AES-256-GCM 加密后写入 redb。
• 主密钥保存在 macOS Keychain 或 Windows Credential Manager。
• 剪贴板正文、来源信息、原图和缩略图均以密文持久化。
• 导出文件采用临时文件、完整写入后原子替换，失败不会覆盖原文件。
• 查询结果、元数据、图片、剪贴历史、Redis 集合和导入行都有显式数量与字节预算。
• 外部命令、路径、连接标识和导入内容在进入执行层前校验，不静默吞掉错误。

应用数据写入操作系统标准用户数据目录，核心数据库文件名为 ramag.redb，日志位于同一数据目录的 logs/ramag.log。卸载应用不会自动删除用户数据库、凭据、剪贴板媒体或日志；需要清理时请先确认数据不再需要。

项目结构

Ramag Platform 是一个 Rust 2024 Cargo workspace，采用务实的 Clean Architecture。数据库、Git、云存储、剪贴板和其他现有工具继续保留，并通过编译期静态第一方插件装配。平台核心负责通用宿主能力，业务工具保留独立 crate；维护范围和执行顺序统一见主线开发计划。

下图列出组合入口装配的组件，不表示完整的 crate 依赖图：

ramag-bin（入口与依赖装配）
├── ramag-tool-*（工具界面）
├── ramag-ui（主壳与共享组件）
├── ramag-infra-*（基础设施适配器）
├── ramag-terminal（内嵌终端）
├── ramag-app（用例与工具注册）
└── ramag-domain（实体与抽象接口）

ramag-bin 还负责快捷键和平台生命周期。ramag-tool-* 包含数据库、Redis、MongoDB、Git、 SSH、云存储、容器和剪贴板工具。ramag-infra-* 提供数据库、Git、SSH/SFTP、云存储、更新、 剪贴板、隧道和本地存储适配器。ramag-domain 不依赖 GUI 或具体基础设施。

这种分层让核心逻辑可以脱离 GUI 测试，也避免 SQL、KV、文档数据库和 Git 被塞进一个含义模糊的通用接口。详细依赖方向和各 crate 职责见架构说明；插件生命周期、接口和承载限制见静态插件接口与开发手册。

开发与验证

日常编译和验证统一直接通过 Cargo 命令执行；cargo run -p、cargo build、cargo check -p、cargo clippy -p 和 cargo test -p 在 Windows、Linux、macOS 上保持相同。Windows 只需在当前 PowerShell 通过 scripts/windows/enable-msvc-toolchain.ps1 激活 Visual Studio 18 2026 MSVC 环境。该脚本默认不输出组件检查和环境清单；排查工具链问题时可追加 -ShowStatus 查看详细信息。Makefile 只保留打包和集成测试编排，不复制日常编译逻辑：

命令	用途
cargo dev	Debug 模式运行桌面应用
cargo dev-release	Release 模式在本机运行，不生成安装包
cargo build	构建 workspace 并生成 ramag 可执行文件
cargo run -p ramag-bin	运行桌面应用
cargo check -p <package>	检查指定 crate
cargo test -p <package>	测试指定 crate
cargo check-all	检查 workspace 所有 target 是否可编译
cargo fmt-check	检查 Rust 格式
cargo clippy-all	对 workspace 所有 target 执行 Clippy，警告视为错误
cargo test-all	运行整个 workspace 测试
make db-test	用 Docker 启动并填充四类数据库，执行数据库测试与相关检查

提交改动前建议依次运行：

cargo fmt-check
cargo check-all
cargo clippy-all
cargo test-all

Windows 激活 MSVC 环境后也使用同样的顺序：

cargo fmt-check
cargo check-all
cargo clippy-all
cargo test-all

外部数据库集成测试在缺少 RAMAG_TEST_* 环境变量时会自动跳过；需要完整验证时使用 make db-test，它会管理专用 Docker 容器、测试数据与本地测试凭据。make db-test-clean 会删除这些专用容器、数据卷和凭据，属于破坏性操作，请确认后再执行。

平台与文档

Ramag 支持 Linux x86_64、macOS 12+（Apple Silicon / Intel）和 Windows 10/11 x64。Linux 提供 Debian 安装包与 AppImage，并支持 X11 与 Wayland；Windows on ARM 仅计划通过系统 x64 模拟运行，尚未列为已完成人工验收的平台。

• 性能报告：VCS、数据库与剪贴板
• 开发主线与设计文档
• 主线开发计划
• WSL Docker 开发环境
• UI 验收标准
• 静态插件接口与开发手册
• 架构说明
• 桌面端构建与发布
• 版本变更记录
• 贡献指南
• 安全策略
• 社区行为准则

发现本项目的问题时，请在 Ramag Platform Issues 中附上操作系统、Ramag 版本、复现步骤和必要日志；提交前请移除连接地址、用户名、密码和业务数据。确认问题属于上游通用缺陷后，再到 tools-rs/ramag 提交聚焦的上游 Issue 或 PR。

License

GNU General Public License v3.0 only

系统采集模块吸收 System Pulse 的采集源码，保留 GPL-3.0-or-later 与 来源和修改记录。可选 Windows 温度模块的 PawnIO 组件保留其 LGPL 许可证及对应源码。