Web 客户端部署

Web 客户端是预编译的静态前端，不包含源码。它通过根目录的 config.json 连接服务端。

1. 获取静态包

从下载页获取 keragi-app-web.tar.gz。

解压后得到：

dist/                 # 静态前端产物
config.example.json   # 配置模板
README.md

2. 托管 dist/

把 dist/ 交给任意静态服务器。因为前端使用客户端路由，需要配置 SPA fallback：所有未匹配的路径回退到 index.html。

托管根目录应是 dist/，确保：

• /index.html
• /assets/*
• /resource/*

都可以直接访问。

3. 配置服务地址

复制模板：

cp config.example.json dist/config.json

编辑 dist/config.json：

{
  "meta": { "version": "0.1.0", "mode": "private" },
  "services": {
    "userx": "https://your-host/userx",
    "msgx": "https://your-host/msgx",
    "agix": "https://your-host/agix",
    "conn": "https://your-host/conn"
  },
  "capabilities": { "connector": true }
}

• 服务端与前端同源时，可以用相对路径：/userx、/msgx、/agix、/conn。
• 前后端不同源时，建议用反向代理把上述路径代理到 wasmx 宿主，避免跨域配置。
• 只安装了核心资源时，conn 可以设为 null；未安装 agix 时同样处理。

修改后刷新页面。

4. 验证

1. 打开 Web 客户端页面。
2. 检查浏览器控制台是否有资源加载失败或接口 404。
3. 注册 / 登录，确认能连接到 userx。
4. 发送一条消息，确认 msgx 正常。
5. 如果安装了 agix / conn，再验证对应功能。

5. 客户端平台

当前提供 Web 客户端。桌面端（Linux / Windows / macOS）与 Android 客户端敬请期待。

下一步

• 配置：服务端前缀与端口。
• WASM 资源包：按需安装资源。