Logan.Li
bf377f3b55
- 官网源码归拢到 homepage/（index/pricing/license + docs.html + content/ + assets/ + docs-assets/），
删除程序内 go:embed 的 server/internal/{site,docs}，后端只静态托管 homepage/dist 做本地预览
（dist 缺失时打 warn 日志，不再内置兜底；/home 别名保留供 GUI openExternal 使用）
- 文档 manifest 按现网口径重建：MCP 页标记 hidden（不再进侧栏与搜索）、补 快捷键 页、校正 updated 日期
- 新增独立静态页 /license：交付与激活四步（邮件交付授权码）、LIC- 在线 与 LICOFF- 离线 对比、
授权服务器 licence.rlwj.cn 通信范围说明、授权类型与价格、10 条授权 FAQ
- tools/homepage-build 支持 hidden 页与可选单页，产出 <name>.html 与 <name>/index.html
- 导航/页脚接入 /license，跨页锚点补 / 前缀，页脚底栏文案同步为静态站口径
- 产物零漂移：12 页文档与现网逐字节一致（仅 mcp 隐藏页自身侧栏/上下页行为随之收敛）
1.9 KiB
1.9 KiB
本章从零到出结果：起服务 → 建连接 → 执行第一条 SQL。
1. 启动
桌面版（主交付形态）双击 OpsxDB 应用即可，本地后端随应用自动拉起。
从源码运行（开发）：
git clone <repo> opsxdb && cd opsxdb
npm install
./run.sh gui # 桌面形态（开发）：Tauri 窗口 + 本地后端
./run.sh web # 仅启动官网与文档 → http://127.0.0.1:8788/
./run.sh package # 打桌面安装包（DMG，内嵌后端）
注意：客户端只在桌面 App 里运行。
./run.sh gui起的:5174是桌面 devUrl 的资产服务，不是浏览器客户端；浏览器只用于官网/与文档/docs（后端:8788直接提供）。
2. 新建连接
-
打开应用，进入连接选择器，选择数据库类型（如 MySQL）；
-
或者直接粘贴连接 URL，点「填入」自动拆解字段：
mysql://root:pass@127.0.0.1:3306/shop -
点 测试 验证连通性，再点 保存并连接。
连接配置保存在本机，密码混淆存储；后续查询只携带会话 ID，不再上送账密。
3. 第一次查询
-
左侧对象树展开库，点表名直接查看前 100 行（展开表可看列结构）；
-
打开 SQL 编辑器，输入：
SELECT * FROM orders ORDER BY id DESC LIMIT 100; -
按 ⌘/Ctrl + Enter 执行当前语句（或选中的片段）；
-
结果面板支持复制 / 导出 CSV / 生成 INSERT，双击单元格即复制。
4. 验证服务
curl -s http://127.0.0.1:8788/health
# {"ok":true,"service":"opsxdb"}
5. 手边没有数据库？
本地还没有可连的库？用仓库自带的辅助脚本一键起一个（需要 Docker，一次只起一个）：
./tests/dbctl.sh up a # MySQL
./tests/dbctl.sh up c # PostgreSQL（用户 opsx）
./tests/dbctl.sh up f # Redis
各驱动的验收状态见《驱动支持》。