[{"Slug":"intro","Title":"产品介绍","Group":"开始使用","Text":"OpsxDB 是一款 本地优先 的桌面数据库工作台,面向运维与开发:连库、写 SQL、看结果,全在本机完成。 主交付形态是可安装的桌面应用,本地后端随应用自动启动,从 下载区获取安装包即用(公测期邮件发放)。数据全部保存在本机,不经过任何第三方服务器。 功能总览 能力 说明 18 种数据库 关系型 / NoSQL / 时序·搜索 / 国产库,全部端到端验收;常用引擎原生内置 连接选择器 搜索 / 分类 / 最近 / 图标网格;粘贴连接 URL 一键填入表单;连接颜色标记区分环境 SQL 工作台 CodeMirror 编辑器、⌘/Ctrl+Enter 执行语句或选区、多 Tab、可拖分栏、格式化、执行历史 对象树 懒加载库 / 表 / 列 / 索引 / 触发器;点表名直接看前 100 行;右键管理对象 结果处理 单元格编辑回写 / 右键复制(值·行·JSON·INSERT)/ CSV·JSON·INSERT 导出 / 过滤构建器 / 分页 Redis 工作台 单机 / Sentinel / Cluster;键树浏览(SCAN 游标)、TTL、Hash/JSON 编辑、危险命令拦截 安全通道 每连接独立配置 SSL/TLS 与 SSH 隧道;后端本机监听 + 访问令牌 AI 助手 生成 / 解释 / 优化 / 修复 / 方言转换 / 样例;OpenAI 兼容协议 + SSE 流式输出 危险操作防护 DROP / TRUNCATE / 无 WHERE 的 UPDATE·DELETE 执行前确认 桌面唯一形态 桌面 GUI,本地后端随应用自动拉起 支持的数据库 家族 覆盖 关系型 MySQL · MariaDB · TiDB · PostgreSQL · SQL Server · Oracle · SQLite NoSQL Redis · MongoDB 时序 / 搜索 Elasticsearch · ZooKeeper · InfluxDB 国产库 达梦 DM · OceanBase · GaussDB / openGauss · PolarDB · TDSQL · Kingbase 逐引擎的接入方式、默认端口与能力边界见《 》;全部 18 引擎均已实测验收。 为什么选 OpsxDB 数据主权 :连接配置与查询历史只存在本机;后端默认仅监听 127.0.0.1。 开箱即用 :桌面版双击即用,本地后端随应用自动拉起;官网与文档也由它内置提供。 为快设计 :点表即看数据、⌘Enter 即执行、结果三键取走(复制 / CSV / INSERT)。 轻量克制 :一个 Go 二进制 + 一份前端,内网可部署,无遥测无账号。 提示 :想马上动手?直接看下一章《快速开始》,30 秒连上第一个库。"},{"Slug":"quickstart","Title":"快速开始","Group":"开始使用","Text":"本章从零到出结果:获取安装包 → 建连接 → 执行第一条 SQL。 1. 获取安装包 OpsxDB 客户端唯一形态是桌面应用:双击启动,本地后端随应用自动拉起, 无需安装任何依赖、无需手动起服务 。 1. 打开官网 下载区(会自动识别系统并高亮对应卡片)。公测期点「申请安装包」发邮件领取安装包(macOS Apple Silicon / Intel · .dmg、Windows x64 · .msi、Linux · AppImage);正式版发布后同一入口提供直链下载; 2. 双击 DMG,将 OpsxDB 拖入「应用程序」; 3. 首次启动自动开始 30 天全功能试用 ——无需注册账号、无需信用卡; 4. 试用期覆盖全部连接与 AI 能力。个人非商业用途永久免费;商用授权与定价见 。 2. 新建连接 1. 打开应用,进入 连接选择器 ,选择数据库类型(如 MySQL); 2. 或者直接粘贴连接 URL,点「填入」自动拆解字段: 3. 点 测试 验证连通性,再点 保存并连接 。 连接配置保存在本机,密码混淆存储;后续查询只携带会话 ID,不再上送账密。数据库在跳板机后面?连接表单开启 SSH 隧道即可安全直达,见《新建连接》。 3. 第一次查询 1. 左侧对象树展开库, 点表名 直接查看前 100 行(展开表可看列结构); 2. 打开 SQL 编辑器,输入: 3. 按 ⌘/Ctrl + Enter 执行当前语句(或选中的片段); 4. 结果面板支持 复制 / 导出 CSV / 生成 INSERT ,双击单元格即复制。 4. 手边没有数据库? 本地还没有可连的库?用 Docker 一分钟起一个练手: 然后把 粘贴进连接表单,点「填入」即可。 各数据库的接入方式与验收状态见《 》。"},{"Slug":"interface","Title":"界面导览","Group":"开始使用","Text":"OpsxDB 的界面为「高频操作」设计:从打开应用到看到数据,路径越短越好。 连接选择器 启动后的第一个界面: 搜索 :按名称快速过滤已保存的连接; 分类 :关系型 / NoSQL / 国产库 / 时序·搜索 分组浏览; 最近 :最近使用的连接排在最前; 图标网格 :按数据库类型直选,未就绪的类型会标注「未就绪」(仅可保存配置); URL 填入 :粘贴 点「填入」,字段自动拆解。 工作台布局 连接成功后进入工作台,三栏结构: 区域 内容 左侧 连接列表 + 对象树(库 → 表 → 列,懒加载) 中部 SQL 编辑器(多 Tab)+ 结果面板,可拖动分栏 右侧 AI 面板(生成 / 解释 / 优化 / 修复 / 方言 / 样例) 对象树 点 表名 :直接打开前 100 行数据; 展开 表 :查看列结构; 右键表 :打开表 / 查看 DDL / 生成 SQL(SELECT·INSERT·UPDATE·DELETE)/ 重命名 / 克隆表结构·克隆表(含数据)/ 清空 / 截断 / 删除 —— 危险项红色并二次确认; 右键库 :新建查询 / 新建表(生成 CREATE TABLE 模板到编辑器)/ 复制 / 设为默认库 / 刷新 / 删除库; Redis:按键分隔符编文件夹,点键打开类型化详情(TTL / JSON / 增删字段); 库列表懒加载,大实例也不卡。 编辑器与结果 CodeMirror 语法高亮,⌘/Ctrl+Enter 执行 当前语句或选区 (不是整页脚本); 多 Tab 并行查询,互不阻塞; 结果面板:复制 / CSV / INSERT 三种取数方式,双击单元格复制; 超过截断阈值时结果有明确提示。 个性化 深色 / 浅色主题切换; Tab 布局与主题选择持久化,下次打开保持原样; 查询历史本地留存,可回跳重跑。"},{"Slug":"connect","Title":"新建连接","Group":"连接与驱动","Text":"本章说明各数据库类型的连接表单、URL 格式与高级选项(SSL / SSH 隧道)。 通用流程 1. 连接选择器点「新建」或选某个数据库类型; 2. 填写表单(不同驱动表单不同,见下表); 3. 测试 → 通过后 保存并连接 。 支持直接粘贴 URL 自动填表: 各驱动表单 驱动 表单 特有字段 MySQL / PostgreSQL / SQL Server standard host · port · user · password · database · ssl · ssh Oracle oracle host · port · user · password · service (如 ORCL) SQLite file database 填本地文件路径(如 ) Redis redis host · port · password · database 序号 · 模式 (单机 / 哨兵 / 集群)· 键分隔符 表单只收集服务端实际消费的字段;历史遗留的死参数不会出现在表单里。 MySQL 族与 PostgreSQL 族 协议兼容的国产库无需单独驱动,直接复用家族驱动: MySQL 族 :MariaDB(3307)、TiDB(4000)、OceanBase(2881)、PolarDB / TDSQL(3306)—— 表单里选对应类型即可; PostgreSQL 族 :GaussDB / openGauss、人大金仓 Kingbase(54321)—— 走 postgres 表单,注意默认库与用户名差异。 SSL / TLS 连接表单中开启 ssl 即可;按连接独立配置,互不影响。内网自签证书场景按需放宽校验策略。 SSH 隧道 数据库在跳板机后面时,开启 ssh 字段组,填写跳板机地址与凭据:OpsxDB 会先建 SSH 隧道,再把数据库连接走隧道转发,无需把库端口暴露到公网。 Redis 哨兵与集群 哨兵 :模式选 Sentinel,填写 Sentinel 节点列表( ,多行)和主节点名 ; 集群 :模式选 Cluster,填写至少一个种子节点。对象树只显示 DB 0(Cluster 无 ); 单机模式只填 host/port,与原先一致。 字段细节与键浏览见 。 提示 :连接保存后,后续查询仅携带 ,账密不会随每次请求上送;密码在本机混淆存储。"},{"Slug":"drivers","Title":"驱动支持","Group":"连接与驱动","Text":"OpsxDB 当前支持 18 种数据库,覆盖关系型、NoSQL、时序/搜索与国产库,全部经真实实例端到端验收(ready + verified)。常用引擎以原生 Go 驱动编译内置,开箱即用;JVM 系数据库通过 Agent 桥按需接入。 完整支持矩阵 数据库 类型 接入方式 默认端口 状态 MySQL 关系型 原生内置 3306 ✅ 已验收 MariaDB 关系型 原生内置 3307 ✅ 已验收 TiDB 关系型 原生内置 4000 ✅ 已验收 PostgreSQL 关系型 原生内置 5432 ✅ 已验收 SQL Server 关系型 原生内置 1433 ✅ 已验收 Oracle 关系型 原生内置(go ora,不引入 JVM) 1521 ✅ 已验收 SQLite 关系型 原生内置(本地文件) — ✅ 已验收 MongoDB NoSQL Agent 桥(官方驱动) 27017 ✅ 已验收 Redis NoSQL 原生内置 6379 ✅ 已验收 Elasticsearch 时序/搜索 原生内置(SQL API) 9200 ✅ 已验收 ZooKeeper 时序/搜索 Agent 桥 2181 ✅ 已验收 InfluxDB 时序/搜索 原生内置(Flux) 8086 ✅ 已验收 达梦 DM 国产库 Agent 桥(JDBC) 5236 ✅ 已验收 OceanBase 国产库 原生内置(MySQL 协议族) 2881 ✅ 已验收 GaussDB / openGauss 国产库 原生内置(PG 协议族) 5432 ✅ 已验收 PolarDB 国产库 原生内置(MySQL 协议族) 3306 ✅ 已验收 TDSQL 国产库 原生内置(MySQL 协议族) 3306 ✅ 已验收 Kingbase 国产库 原生内置(PG 协议族) 54321 ✅ 已验收 协议族复用 MySQL 族(MySQL / MariaDB / TiDB / OceanBase / PolarDB / TDSQL)共用同一原生驱动,PostgreSQL 族(PostgreSQL / GaussDB / openGauss / Kingbase)同理 —— 同族引擎的连接体验与能力完全一致,仅默认端口不同。 Agent 桥驱动(按需下载) MongoDB、ZooKeeper、达梦通过 JVM Agent 桥接入: 首次使用时在 驱动管理器 按需下载对应组件,版本固定并做 sha256 校验(Gitee 主源 + GitHub 备源); 商业数据库(如达梦官方 JDBC)不代下,需自备 jar 放入驱动目录; Agent 进程随会话池化管理,崩溃自动摘除重建,应用退出级联清理。 各引擎能力边界 引擎 浏览 执行 写入 说明 关系型全家 库/表/视图/存储过程/索引/外键/触发器 SQL ✅(含结果集编辑回写) MySQL 族附执行计划 Redis 键树(SCAN 游标)/ TTL 命令编辑器 ✅ 单机 / Sentinel / Cluster 三模式;危险命令族拦截 MongoDB 库/集合 DSL ✅(增删改单文档) 官方驱动经 Agent 桥 ZooKeeper 路径树 GET / SET ✅(写动词二次确认) 经 Agent 桥 Elasticsearch 索引浏览 SQL API 只读 官方 JDBC 付费,故走原生 SQL API InfluxDB org/bucket 浏览 Flux 脚本 只读 用户=org、密码=token 说明(Oracle) :go ora 纯 Go 驱动,无需安装 Java;Apple Silicon 容器环境起 Oracle XE 会遇到 ORA 00442 属环境限制,x86 或真实实例不受影响。"},{"Slug":"workbench","Title":"SQL 工作台","Group":"SQL 工作台","Text":"SQL 工作台是日常使用率最高的界面,所有交互围绕「快」设计。 执行模型 ⌘/Ctrl + Enter :执行光标所在的 当前语句 ;有选区时执行 选区 ; 不是「整页脚本」模式 —— 多条语句互不干扰,想跑哪句把光标放哪; Redis 连接共用同一编辑器,按 行 执行命令(见 ),不另开 CLI; 执行在会话上运行,连接断开后自动提示。 多 Tab 与分栏 每个查询一个 Tab,并行执行互不阻塞; 编辑器 / 结果区可拖动分栏,长查询时编辑器不被结果挤占; Tab 与布局持久化,重开应用保持原样。 对象树联动 左侧对象树懒加载库 / 表 / 列; 点表名 = 打开表工作台 (前 100 行 + 条件过滤 + 结构分页),并回填 SELECT; 展开表看列名与类型,写 SQL 时可对照。 查询历史 本地留存最近 200 条(不上传、不同步); 相同语句自动去重置顶 —— 历史即「最近用过的不同语句」,高频查询永远在第一条; 点击条目回填编辑器;悬停出现 ▶ 按钮,回填并直接重跑; 顶部过滤框支持按语句内容或连接名搜索; 条目显示时间、连接名、行数与耗时;失败的语句红色标出。 危险 SQL 防护 执行以下语句前会弹确认框: 类型 规则 删除对象 DROP / TRUNCATE 全表更新 无 WHERE 的 UPDATE / DELETE 注意 :确认框只拦「明确危险」的模式,不替代事务与备份习惯;生产库操作请配合审批流程。 快捷键 快捷键 动作 ⌘/Ctrl + Enter 执行当前语句 / 选区 双击结果单元格 复制单元格内容 Esc 关闭弹层 / 取消确认"},{"Slug":"results","Title":"结果与导出","Group":"SQL 工作台","Text":"查询跑完只是开始,把结果带走才算完成 —— OpsxDB 给了三条最快路径。 三种取数方式 方式 用途 复制 直接进剪贴板,贴到群聊 / 文档 / 表格 CSV 导出标准 CSV 文件,Excel / Numbers 直接打开 INSERT 把结果行生成为 INSERT 语句,直接可在别的库回放 表数据工作台(关系库) 从对象树打开表后,结果区按 DBeaver / DBX 的数据编辑器组织,而不是只有一张裸网格: 工具栏 :刷新、增行、删行、提交(有主键才写回); 条件过滤 :列 + 运算符(= ≠ \u003c 包含 空…)+ 值,可加多条 AND;应用后重查,SQL 回填编辑器; 本页搜索 :不打库,只过滤当前结果; 列头 :列名 + 类型色 + 主键标记,悬停看注释。 表结构 「结构」分页签:列 / 索引 / 外键 / 触发器 / DDL。MySQL 族、PostgreSQL 族、SQLite、SQL Server、Oracle 都拉元数据;DDL 可复制或插入编辑器。 单元格操作 双击单元格 :进入编辑(有主键时写回);长文本可展开; 列头点击排序(仅当前页)。 截断提示 为保护界面与内存,超大结果集会按阈值截断展示: 结果面板顶部显示「已截断」提示与实际行数; 需要完整数据时,缩小查询范围(加 LIMIT / WHERE)或使用导出。 提示 :默认「点表名看前 100 行」就是截断策略的一部分 —— 快速浏览用 100 行,精确取数写 WHERE。 与 AI 面板联动 写不出来的查询可以直接在 AI 面板用自然语言描述(「查最近 7 天下单但未支付的用户」),生成 SQL 后放回编辑器执行,见《AI 助手》。"},{"Slug":"redis","Title":"Redis 工作台","Group":"SQL 工作台","Text":"Redis 连接使用专用表单(redis)。连上后,对象树是键空间浏览器,编辑器是 Redis 命令行 —— 和 SQL 共用同一套输入框 ,不另开 CLI 页。 为什么命令行不单独做一套 SQL 工作台已经有:多 Tab、⌘/Ctrl+Enter、查询历史、书签、危险确认、取消。Redis 命令同样是「输入 → 执行 → 结果表」。 拆成独立 CLI(终端 REPL)会让快捷键、历史、危险确认分叉,也和 Navicat 式多引擎工作台不一致。 因此: SQL Redis 输入框 同一 CodeMirror 同一 CodeMirror(占位/补全换成命令) 切分 分号语句 按行 ( 不会被分号拆开) 执行 ⌘/Ctrl+Enter 当前语句或选区 ⌘/Ctrl+Enter 当前行或选区 结果 结果表 命令结果表;从对象树打开键则进入键详情 Another Redis Desktop Manager 的独立 CLI Tab、opsxsql 的单行命令 + 输出日志,列为后续 P1,不是现在的主路径。 键空间浏览 对象树对 Redis 显示 DB0–15(Cluster 仅 0)。展开库后: SCAN 过滤 :输入 点「应用」;生产大库请带前缀,避免扫全库。最多展示 500 个键,超出提示截断。 按分隔符编文件夹 :连接表单的「键分隔符」默认 , 显示为 。文件夹显示数量;右键可「只看此前缀」「在此新建键」。 类型色点 :string 绿 / hash 蓝 / list 橙 / set 紫 / zset 青。 点键 :打开键详情(不是假 SELECT)。 键详情 对标 Another Redis Desktop Manager 的 Hash/List/Set 视图: 类型徽章、键名(回车重命名)、TTL(回车或「保存 TTL」, 永久)、刷新、导出还原命令、删除; 结构 表:Hash 为 ID / Field / Value,JSON 值自动美化;可新增字段、编辑、删除; JSON 视图:整体格式化; 表内关键字过滤。 String 可直接改值保存。 命令执行 编辑器直接写 Redis 命令: 未点名的命令走通用 ( / / / 等不必再加白名单); / / / 仍要二段确认; 在大库上会阻塞 —— 请用 。 切换逻辑库(SELECT) 是 Redis 官方的切库命令,编辑器直接支持 —— 语义与 redis cli 一致: 切换后本 Tab 的后续命令都在目标库执行 : 没有也没有 (那是 SQL 语法)—— 输入 会得到 Redis 原生报错 ,与 redis cli 行为一致; 切库只影响当前查询 Tab(多 Tab 可各连各的库),左侧对象树点开对应库可浏览键; Cluster 模式只有 DB 0, 无效。 连接参数 字段 说明 host / port 单机默认 127.0.0.1:6379 password / user ACL / requirepass database 逻辑库序号(0–15 常见;Cluster 忽略) 键分隔符 对象树文件夹分隔,默认 ssl TLS redisMode (默认)/ / redisNodes Sentinel / Cluster 节点列表, 多行或逗号分隔 masterName Sentinel 主节点名(必填) sentinelPassword Sentinel 密码(可空) Sentinel 模式选「哨兵」,填写至少一个 Sentinel 地址和 (如 )。逻辑库序号仍可用。 Cluster 模式选「集群」,填写至少一个种子节点。Cluster 不支持 多库,对象树只暴露 DB 0。槽位路由由客户端处理,键浏览走 。 环境 :Sentinel / Cluster 表单与后端已接好;真实拓扑联调见 环境缺口。"},{"Slug":"security","Title":"安全设计","Group":"安全与 AI","Text":"连生产库的工具,安全必须是默认项。OpsxDB 的安全设计围绕一句话: 数据不出你的机器。 本地优先 连接配置、查询历史、主题偏好全部保存在本机; 无账号体系、无遥测、无云端同步; 后端默认只监听 ,对外服务需要显式配置( 或 )。 凭据保护 层面 机制 存储 连接密码在本机混淆存储,不落明文 传输 连接建立后,后续查询只携带 ,账密不再每次上送 会话 会话在服务端维护,可主动关闭(连接断开即失效) 加密通道 SSL / TLS :每个连接可独立开启;数据库支持 TLS 即可启用(MySQL、PostgreSQL、SQL Server、Redis、MongoDB 均支持)。 SSH 隧道 :数据库在跳板机后时,配置 SSH 字段组,OpsxDB 先建隧道再转发数据库连接 —— 库端口不必暴露公网。 危险操作防护 DROP / TRUNCATE 执行前确认; 无 WHERE 的 UPDATE / DELETE 执行前确认; 结果集按阈值截断,避免误操作拖垮界面。 内网部署形态 单二进制 + 内置静态页(官网 / 文档 / 工作台),无外部依赖: 任意内网主机可部署; 无外联请求,可在纯内网环境运行; 升级即替换一个二进制。"},{"Slug":"ai","Title":"AI 助手","Group":"安全与 AI","Text":"AI 面板的目标:让「写不出的 SQL」和「看不懂的 SQL」不再阻塞你。 侧栏支持 Ask Agent :Ask 只生成 SQL;Agent 调用与 MCP 同源的只读工具真查库。外部编辑器可用 接入(配置方法见 )。 六种动作 动作 用途 生成 自然语言 → SQL(「查最近 7 天下单但未支付的用户」) 解释 把一段复杂 SQL 翻译成中文说明 优化 分析慢查询,给出索引 / 改写建议 修复 报错信息 + SQL → 修正版本 方言 MySQL ↔ PostgreSQL 等跨方言转换 样例 按表结构生成示例查询 使用方式 1. 连接库后打开右侧 AI 面板; 2. 选择动作,输入需求或粘贴 SQL(可附上对象树上下文); 3. 生成结果一键放回编辑器,⌘/Ctrl + Enter 执行。 提示 :生成的 SQL 依旧走危险语句确认流程 —— AI 产出与手写 SQL 同等对待,不放宽防护。 接入真实模型 AI 面板支持任何 OpenAI 兼容协议 的服务(OpenAI / DeepSeek / 通义 / 本地 vLLM 等),回复以 SSE 流式 逐字输出,等待模型时不再面对空白。 配置入口(二选一): 1. AI 面板右上角「 配置 」:填 Base URL、API Key、模型名,保存后可一键测试; 2. 配置文件 (权限 0600),或环境变量 。 说明 :未配置 API Key 时回落本地 stub(离线占位,内容为模板演示);AI Key 保存后服务端只回显掩码( )。 数据流向承诺 默认只发送你明确提交的内容(附当前库表结构上下文,不含连接凭据); 可完全关闭 AI 功能(顶栏隐藏面板即可,无后台请求); 使用云端模型时在界面上明确标识,生成 SQL 依旧走危险语句确认流程。"},{"Slug":"mcp","Title":"MCP 接入","Group":"安全与 AI","Text":"把 Cursor、Claude Code、VS Code 等 AI 客户端接到 OpsxDB,即可用自然语言查看结构、查询白名单内的库,并与侧栏 Agent 共用同一套工具与安全策略 。 什么是 MCP? MCP(Model Context Protocol)让 AI 客户端调用本机工具。OpsxDB MCP 读取桌面已保存的连接( ),权限由 统一约束。 安装 1. Node 启动器(npm) 2. Go 二进制(必需) npm 包只是启动器,真正的 MCP 服务是 Go 二进制: 也可把该二进制放到 PATH(需排在 npm shim 之前)。 3. 桌面设置 打开 设置 → MCP : 查看 Node / npm / 包版本 / Go 二进制是否就绪 复制安装命令与各客户端配置片段 查看读写权限,并勾选允许访问的连接;新配置默认允许读写和危险 SQL 配置 AI 客户端 以 Cursor 为例( 或项目 ): Claude Code 使用项目根目录 (结构相同)。VS Code / Windsurf / Codex / Claude Desktop 的片段可在 设置 → MCP 中按 Tab 复制。 GUI 客户端不一定继承 shell 的 PATH;请使用 绝对路径,不要只写 或 。 安全策略 项 说明 默认读写 新配置使用 ;Agent 每次写入前显示确认弹框 危险 SQL 新配置默认 ,DROP/TRUNCATE/ALTER/无 WHERE 更新删除等仍须确认 旧配置 沿用已保存的权限;设置中选择「使用默认权限」可启用读写与危险 SQL 连接白名单 ; 空=拒绝全部 审计 (含 tool、connection id、run id) 外部客户端若在 下自行传 ,视为操作者授权;桌面侧栏 Agent 不会 让模型静默带确认令牌。 保存白名单或权限后,外部 MCP 进程在下一次工具调用时读取新策略,无需重启桌面或 AI 客户端;策略文件读取失败时该次调用会被拒绝。 工具列表 工具 说明 白名单内连接 库列表 表/视图 列定义 紧凑 schema 文本 SQL(写入需确认,查询有行数上限) Redis(写入需确认;FLUSH /KEYS 永拒) 侧栏 Ask Agent Ask :生成/解释/优化,不调库 Agent :多轮调用与 MCP 同源工具;支持 SSE 步骤时间线、「插入编辑器」「在结果区打开」 详见 。 开始使用 在 AI 客户端中试: 「列出我的数据库连接」 「demo 库有哪些表」 「查看 users 表结构并查前 5 行」 系统要求 Node.js 18+(若用 npm/npx 启动器) 已安装 OpsxDB 桌面端并至少保存一个连接 已构建 Go 二进制 在设置 → MCP 勾选连接白名单"},{"Slug":"faq","Title":"常见问题","Group":"参考","Text":"产品形态 Q:能在浏览器里操作数据库吗? 不能。OpsxDB 客户端唯一形态是桌面 App——连库、查询、结果处理都在桌面应用与本机完成;浏览器只用于浏览官网与文档( ),不承载任何数据库操作。 Q:官网和文档在哪? 线上地址 ( 为文档站,支持全文搜索);桌面应用的「设置 → 关于」里也有一键直达入口。 Q:怎么获取安装包? 打开官网 下载区,公测期点「申请安装包」发邮件领取对应平台安装包;正式版发布后同一入口提供直链下载。安装包内嵌本地后端,安装后双击即用,无需额外配置。 数据与安全 Q:我的连接密码存在哪? 本机,混淆存储;查询只带会话 ID,密码不会随请求重复上送,也不会同步到云端。 Q:会上传我的 SQL 或查询结果吗? 不会。没有遥测、没有账号、没有云依赖。AI 助手为可选功能:只有你主动配置了模型服务并主动提问时,才会把当次请求(含库表结构上下文,不含连接凭据)发给你指定的服务地址。 Q:能在公司内网用吗? 能。单二进制 + 内置静态页,无外部依赖;默认只监听回环地址,对外需显式配置。 驱动相关 Q:Oracle 能用吗? 已支持并验收:纯 Go 驱动 go ora,无需安装 Java。Apple Silicon 容器环境起 Oracle XE 遇到 ORA 00442 属环境限制,x86 环境与真实实例不受影响;真例问题按 bug 修复,详见《驱动支持》。 Q:达梦 / MongoDB 能用吗? 已支持:18 种数据库全部端到端验收。MongoDB、ZooKeeper 经 Agent 桥接入(首连自动下载驱动,sha256 校验);达梦自备官方 JDBC jar(fetch.sh 有指引);Elasticsearch 走原生 SQL API(只读);InfluxDB 直写 Flux。详见《驱动支持》。 Q:MySQL 族 / PG 族的国产库怎么连? 协议兼容直接复用家族驱动:TiDB / OceanBase / PolarDB / TDSQL 选对应类型(MySQL 协议);GaussDB / Kingbase 走 PostgreSQL 表单。注意各自默认端口与用户名差异。 其他 Q:和 OpsxAPI 是什么关系? 同一团队的姊妹项目:OpsxAPI 是接口工作台,OpsxDB 是数据库工作台,各自独立授权与计价。 Q:快捷键有哪些? 核心就一个:⌘/Ctrl + Enter 执行当前语句或选区;双击结果单元格复制。完整列表见《SQL 工作台》。"},{"Slug":"shortcuts","Title":"快捷键","Group":"参考","Text":"快捷键是 OpsxDB 的第一等操作方式 —— 高频动作全部可以不碰鼠标完成。 Windows / Linux 上 对应 。 全局与工作台 快捷键 动作 执行当前语句或选区(自动按语句切分) 快速跳转:模糊搜索库 / 表,Enter 直达数据 新建查询 Tab 关闭当前查询(有未保存改动会确认) 切到第 N 个查询 循环切换查询 上一条 / 下一条语句(编辑器内) 聚焦对象树过滤框 刷新对象树 显示 / 隐藏 AI 面板 快捷键帮助 结果网格 快捷键 / 操作 动作 上下移动选中行 翻页移动 跳到首行 / 末行 双击单元格 / 进入单元格编辑 清空选中格(进入编辑) (编辑中) 撤销本格改动,恢复进入编辑前的值 取消编辑 / 关闭弹层与菜单 复制选中单元格值(无列选中时复制整行 TSV) 右键单元格 编辑 / 复制单元格值 / 复制行(TSV · JSON · INSERT)/ 查看全文 多格复制粘贴 与 Excel 互通:复制区域后直接粘贴进网格批量暂存 双击分栏分隔条 结果区最大化 / 还原 对象树 操作 动作 双击表名 打开表工作台(看前 100 行) 右键库 新建查询 / 浏览对象 / 复制 / 设为默认库 / 刷新 / 删除库 右键表 / 视图 查看数据 / 查看 DDL / 复制 / 清空截断 / 删除表 键盘导航(展开 / 收起 / 进入) SQL 编辑器右键 编辑器内右键可完成:执行选中语句、执行当前语句、查看数据、查看 DDL、剪切 / 复制 / 粘贴 / 全选 —— 系统默认菜单被替换,不再跳出「Look Up / 检查元素」。"}]