# SuperUser 文档 - LLM 可读版本
# 生成时间: 2026-02-28T12:48:41.997Z
# 文件数量: 25

---

# 文件: en-US/index.md

<div class="home-section">

## 告别繁琐配置

<div class="section-content">
模块化设计，实现真正开箱即用。内置 TMS、CRM、工单系统等丰富模块，满足不同业务场景需求。
</div>

</div>

<div class="home-section">

## 打破技术限制

<div class="section-content">
无代码核心，支持灵活自定义。让您无需编写代码即可完成复杂的业务配置。
</div>

<ul class="section-list">
  <li>支持修改字段、业务模型等</li>
  <li>支持配置插件、业务流程等</li>
  <li>支持配置权限、页面视图等</li>
</ul>

</div>

<div class="home-section">

## 告别办公束缚

<div class="section-content">
移动端友好，让您随时随地办公。任意模块都可以在移动端操作，并且交互友好操作便捷。
</div>

<ul class="section-list">
  <li>任意模块都可以在移动端操作，并且交互友好操作便捷</li>
  <li>支持移动端通知等，让办公协作更便捷</li>
</ul>

</div>

<div class="home-section">

## 捍卫数据主权

<div class="section-content">
多种部署方式，让数据存管无忧。无论您选择私有化部署还是云服务，都能保障数据安全。
</div>

<ul class="section-list">
  <li>支持私有化部署，无忧数据隐私</li>
  <li>支持云服务，注册即可使用，方便便捷</li>
</ul>

</div>

<div class="home-section">

## 探索 AI 效能

<div class="section-content">
深度集成 AI 工具，让您工作更高效。让 AI 成为您工作中的得力助手。
</div>

<ul class="section-list">
  <li>支持 Streamable MCP，接入您的 AI 工具，让 AI 为您工作</li>
  <li>内置 AI 助手，无聊的工作交给 AI，我们干点有趣的事儿（即将推出）</li>
</ul>

</div>

---

# 文件: index.md

[CompareCard 组件 - 详见站点页面]

<FinalCTA 
  title="想先了解一下？"
  subtitle="先了解 SuperUser，或直接在线试用，看看适不适合你的业务"
  primary-text="免费体验"
  primary-link="http://app.opt.ltd:8080"
  secondary-text="快速开始"
  secondary-link="/guide/"
/>

---

# 文件: zh-CN/deploy/backup.md

# 备份与恢复

## MongoDB 备份

```bash
# 备份
docker exec mongodb mongodump \
  --db superuser \
  --out /backup/$(date +%Y%m%d)

# 恢复
docker exec mongodb mongorestore \
  --db superuser \
  /backup/20240101/superuser
```

## 文件存储备份

如使用本地存储，备份 `uploads_data` 卷：

```bash
docker run --rm \
  -v uploads_data:/data \
  -v /your/backup/path:/backup \
  alpine tar czf /backup/uploads-$(date +%Y%m%d).tar.gz /data
```

## 自动备份建议

建议使用 cron 定时任务每日备份，并将备份文件同步到对象存储（OSS/S3）异地保存。

---

# 文件: zh-CN/deploy/environment.md

# 环境变量说明

SuperUser 通过环境变量进行系统配置，以下是完整的环境变量列表。

## 数据库配置

| 变量名 | 默认值 | 说明 |
|--------|--------|------|
| `DB_TYPE` | `mongodb` | 数据库类型：`mongodb` / `mysql` / `elasticsearch` |
| `DB_HOST` | `localhost` | 数据库主机地址 |
| `DB_PORT` | `27017` | 数据库端口 |
| `DB_NAME` | `superuser` | 数据库名称 |
| `DB_USER` | - | 数据库用户名（MySQL 必填） |
| `DB_PASSWORD` | - | 数据库密码 |
| `DB_AUTH_SOURCE` | `admin` | MongoDB 认证数据库 |

## 服务配置

| 变量名 | 默认值 | 说明 |
|--------|--------|------|
| `PORT` | `8080` | 服务监听端口 |
| `BASE_URL` | `http://localhost:8080` | 对外访问地址（影响邮件链接等） |
| `JWT_SECRET` | 随机生成 | JWT 签名密钥（生产环境必须手动设置） |
| `JWT_EXPIRE` | `7d` | JWT 过期时间 |

## 存储配置

| 变量名 | 默认值 | 说明 |
|--------|--------|------|
| `STORAGE_TYPE` | `local` | 文件存储类型：`local` / `s3` / `oss` |
| `STORAGE_PATH` | `/data/uploads` | 本地存储路径 |
| `S3_BUCKET` | - | S3 Bucket 名称（STORAGE_TYPE=s3 时必填） |
| `S3_REGION` | - | S3 区域 |
| `S3_ACCESS_KEY` | - | S3 Access Key |
| `S3_SECRET_KEY` | - | S3 Secret Key |

## 邮件配置（可选）

| 变量名 | 默认值 | 说明 |
|--------|--------|------|
| `SMTP_HOST` | - | SMTP 服务器地址 |
| `SMTP_PORT` | `465` | SMTP 端口 |
| `SMTP_USER` | - | SMTP 用户名 |
| `SMTP_PASS` | - | SMTP 密码 |
| `SMTP_FROM` | - | 发件人地址 |

## 示例：完整 docker-compose.yml

```yaml
version: '3'
services:
  superuser:
    image: superuser/superuser:latest
    ports:
      - "8080:8080"
    environment:
      - DB_TYPE=mongodb
      - DB_HOST=mongodb
      - DB_PORT=27017
      - DB_NAME=superuser
      - JWT_SECRET=your-very-secret-key-change-this
      - BASE_URL=https://your-domain.com
      - STORAGE_TYPE=local
      - STORAGE_PATH=/data/uploads
    volumes:
      - uploads_data:/data/uploads
    depends_on:
      - mongodb
  mongodb:
    image: mongo:6
    volumes:
      - mongo_data:/data/db

volumes:
  mongo_data:
  uploads_data:
```

---

# 文件: zh-CN/deploy/index.md

# 部署与运维

本章介绍 SuperUser 的部署、配置与日常运维。

## 快速导航

- [环境变量说明](/deploy/environment) — 数据库、服务、存储、邮件等完整配置
- [版本升级](/deploy/upgrade) — 升级步骤与回滚说明
- [备份与恢复](/deploy/backup) — MongoDB 与文件存储备份

---

# 文件: zh-CN/deploy/upgrade.md

# 版本升级指南

## 升级前准备

1. **备份数据库**（参见 [备份与恢复](/deploy/backup)）
2. 查看 [更新日志](/guide/changelog) 了解版本变更和 Breaking Changes
3. 在测试环境验证新版本

## 升级步骤（Docker）

```bash
# 1. 拉取新镜像
docker pull superuser/superuser:latest

# 2. 停止当前容器
docker stop superuser

# 3. 删除旧容器（数据卷保留）
docker rm superuser

# 4. 启动新容器（与原命令一致，镜像已更新）
docker run -d -p 8080:8080 \
  -e JWT_SECRET=your-secret \
  --name superuser \
  superuser/superuser:latest
```

## 升级步骤（Docker Compose）

```bash
docker-compose pull
docker-compose up -d
```

## 回滚

如果新版本出现问题，可以指定旧版本镜像回滚：

```bash
docker run -d -p 8080:8080 superuser/superuser:1.2.3
```

---

# 文件: zh-CN/developer/addon-auth.md

# 扩展鉴权

SuperUser 在调用扩展接口时，会在请求头中携带身份令牌，后端可据此验证请求合法性。

## 请求头说明

```
X-SuperUser-Token: <token>
X-SuperUser-Tenant: <tenant_id>
```

## 验证流程

1. SuperUser 在每次调用扩展接口时，在请求头中附带 `X-SuperUser-Token`
2. 扩展后端可通过 SuperUser 提供的 `/api/auth/verify` 接口验证令牌有效性
3. 验证通过后，可从令牌中解析出当前用户信息和租户信息

## 验证示例（Node.js）

```javascript
const express = require('express');
const app = express();

app.post('/api/my-extension', async (req, res) => {
  const token = req.headers['x-superuser-token'];
  
  // 验证 token
  const verifyRes = await fetch('https://your-superuser/api/auth/verify', {
    headers: { 'Authorization': `Bearer ${token}` }
  });
  
  if (!verifyRes.ok) {
    return res.status(401).json({ success: false, message: '未授权' });
  }

  const user = await verifyRes.json();
  // user.id, user.name, user.roles 可用
  
  // 处理业务逻辑...
  res.json({ success: true, message: '操作成功' });
});
```

---

# 文件: zh-CN/developer/addon-error-handling.md

# 扩展错误处理

## 响应格式规范

所有扩展接口应返回统一的 JSON 格式：

```json
{
  "success": true,
  "message": "操作成功",
  "data": {}
}
```

失败时：

```json
{
  "success": false,
  "message": "操作失败：原因描述",
  "code": "ERROR_CODE"
}
```

## HTTP 状态码规范

| 状态码 | 含义 | SuperUser 行为 |
|--------|------|----------------|
| 200 | 成功 | 显示 `message` 提示用户 |
| 400 | 请求参数错误 | 显示错误信息 |
| 401 | 未授权 | 提示登录过期 |
| 500 | 服务器错误 | 提示"操作失败" |
| 超时（默认 10s） | - | 提示"请求超时" |

## 超时配置

在扩展配置中可设置自定义超时时间：

```json
{
  "label": "生成报告",
  "handle": "http://mysite.app/api/report/generate",
  "timeout": 30000
}
```

---

# 文件: zh-CN/developer/addon-examples.md

# 扩展示例库

## 示例一：发送企业微信通知

当用户点击按钮时，向企业微信推送消息。

**扩展配置：**
```json
{
  "name": "wecom-notify",
  "clicks": [
    {
      "label": "通知客户",
      "handle": "http://mysite.app/api/wecom/notify",
      "confirm": "确定要向客户发送微信通知吗？"
    }
  ]
}
```

**后端实现（Node.js）：**
```javascript
app.post('/api/wecom/notify', async (req, res) => {
  const record = req.body; // 当前行数据
  
  await fetch('https://qyapi.weixin.qq.com/cgi-bin/message/send', {
    method: 'POST',
    body: JSON.stringify({
      touser: record.owner_wecom_id,
      msgtype: 'text',
      text: { content: `订单 ${record.order_no} 已处理完成` }
    })
  });

  res.json({ success: true, message: '通知已发送' });
});
```

---

## 示例二：嵌入自定义图表

在详情页中展示该客户的销售趋势图表。

**扩展配置：**
```json
{
  "name": "sales-chart",
  "views": [
    {
      "label": "销售趋势",
      "type": "embed",
      "handle": "http://mysite.app/api/chart/sales",
      "target": "detail"
    }
  ]
}
```

**后端返回 HTML：**
```javascript
app.post('/api/chart/sales', async (req, res) => {
  const { _id } = req.body;
  const data = await getSalesData(_id);
  
  res.json({
    success: true,
    html: `<canvas id="chart"></canvas>
           
`
  });
});
```

---

# 文件: zh-CN/developer/addon.md

# 扩展开发

SuperUser 支持通过 HTTP 接口扩展视图和操作能力。

## 快速导航

- [扩展鉴权](/developer/addon-auth) — 请求头与令牌验证
- [错误处理](/developer/addon-error-handling) — 响应格式与 HTTP 状态码规范
- [完整示例](/developer/addon-examples) — 企业微信通知、自定义图表等示例

---

# 文件: zh-CN/developer/ai-mcp.md

# Streamable MCP 接入指南

SuperUser 支持 Streamable MCP（Model Context Protocol），让您的 AI 工具能够直接操作 SuperUser 中的数据。

## 什么是 MCP？

MCP 是 Anthropic 提出的开放协议，允许 AI 模型安全地与外部工具和数据源交互。通过 SuperUser 的 MCP 接口，AI 助手（如 Claude Desktop、Cursor 等支持 MCP 的工具）可以：

- 查询和更新业务数据
- 创建工单、客户、运单等记录
- 触发业务流程

## 配置步骤

### 1. 获取 MCP 端点

在【设置 → API 访问 → MCP 配置】中获取您的 MCP 端点地址：

```
https://your-domain/api/mcp/stream
```

### 2. 配置 Claude Desktop（示例）

在 `claude_desktop_config.json` 中添加：

```json
{
  "mcpServers": {
    "superuser": {
      "command": "node",
      "args": ["/path/to/superuser-mcp-client/index.js"],
      "env": {
        "SUPERUSER_URL": "https://your-domain",
        "SUPERUSER_TOKEN": "your-api-token"
      }
    }
  }
}
```

### 3. 可用工具列表

| 工具名 | 说明 |
|--------|------|
| `list_records` | 查询模型记录列表 |
| `create_record` | 创建新记录 |
| `update_record` | 更新记录字段 |
| `delete_record` | 删除记录 |
| `get_models` | 获取可用模型列表 |

---

# 文件: zh-CN/developer/ai.md

# AI 集成

SuperUser 深度集成 AI 工具，提升工作效率。

## 快速导航

- [Streamable MCP](/developer/ai-mcp) — 接入 Claude Desktop、Cursor 等 AI 工具，查询与操作业务数据

---

# 文件: zh-CN/developer/api-models.md

# 模型数据 API

## 查询记录列表

```
GET /api/v1/models/{modelName}/records
```

**查询参数：**

| 参数 | 类型 | 说明 |
|------|------|------|
| `page` | number | 页码，默认 1 |
| `pageSize` | number | 每页条数，默认 20，最大 100 |
| `filter` | JSON | 筛选条件，见下方说明 |
| `sort` | string | 排序字段，如 `-createdAt`（负号表示降序） |

**筛选条件示例：**
```json
{ "status": "active", "amount": { "$gte": 1000 } }
```

**示例请求：**
```bash
curl -H "Authorization: Bearer your-token" \
  "https://your-domain/api/v1/models/customers/records?pageSize=10"
```

## 创建记录

```
POST /api/v1/models/{modelName}/records
Content-Type: application/json

{
  "name": "新客户",
  "status": "active",
  "amount": 5000
}
```

## 更新记录

```
PATCH /api/v1/models/{modelName}/records/{id}
Content-Type: application/json

{
  "status": "closed"
}
```

## 删除记录

```
DELETE /api/v1/models/{modelName}/records/{id}
```

---

# 文件: zh-CN/developer/api-overview.md

# API 概览

SuperUser 提供 RESTful API，支持对所有模型数据进行程序化操作。

## 认证

所有 API 请求需在请求头中携带 API Token：

```
Authorization: Bearer <your-api-token>
```

API Token 可在【设置 → 个人设置 → API 访问】中生成。

## 基础 URL

```
http(s)://your-superuser-domain/api/v1
```

## 通用响应格式

```json
{
  "success": true,
  "data": { ... },
  "total": 100,
  "page": 1,
  "pageSize": 20
}
```

## 速率限制

默认每个 API Token 每分钟最多 1000 次请求。超出限制返回 `429 Too Many Requests`。

---

# 文件: zh-CN/docs/index.md

# 技术文档

按你的角色和任务找文档，少走弯路。

## 按角色找文档

**我是业务/运营，想用好系统**
- [快速开始](/guide/) — SuperUser 是什么、面向谁、解决什么问题
- [快速入门](/guide/quick-start) — 试用、用内置模块、自己搭应用
- [常见问题](/guide/faq) — 和其他产品有啥区别、能不能不用开发
- [设计器概览](/guide/designer) — 怎么加字段、调视图、设权限
- [字段类型说明](/guide/fields) — 各种字段怎么用

**我是运维，要部署和维护**
- [部署与运维](/deploy/) — 部署入口
- [环境变量](/deploy/environment) — 数据库、存储、邮件等配置
- [版本升级](/deploy/upgrade) — 升级步骤与回滚
- [备份与恢复](/deploy/backup) — 数据备份怎么做

**我是开发者，要做集成或扩展**
- [扩展开发](/developer/addon) — 扩展机制总览
- [扩展鉴权](/developer/addon-auth) — 请求怎么鉴权
- [错误处理](/developer/addon-error-handling) — 返回格式和错误码
- [完整示例](/developer/addon-examples) — 企业微信、自定义图表等示例
- [API 概览](/developer/api-overview) — REST API 认证与使用
- [模型 CRUD](/developer/api-models) — 记录的增删改查
- [Streamable MCP](/developer/ai-mcp) — AI 工具接入

---

## 按主题浏览

| 主题 | 文档 |
|------|------|
| 入门 | [快速入门](/guide/quick-start)、[常见问题](/guide/faq)、[设计器](/guide/designer)、[字段类型](/guide/fields) |
| 部署 | [部署与运维](/deploy/)、[环境变量](/deploy/environment)、[升级](/deploy/upgrade)、[备份](/deploy/backup) |
| 开发 | [扩展](/developer/addon)、[鉴权](/developer/addon-auth)、[错误处理](/developer/addon-error-handling)、[示例](/developer/addon-examples)、[API](/developer/api-overview)、[模型 CRUD](/developer/api-models)、[MCP](/developer/ai-mcp) |

---

# 文件: zh-CN/guide/about.md

# 关于我们

SuperUser 致力于让数据管理更简单、更高效、更智能。

## 联系我们

- **官网**：https://superuser.im

## 快速导航

- [平台介绍](/guide/platform)
- [产品价格](/guide/prices)
- [更新日志](/guide/changelog)

---

# 文件: zh-CN/guide/changelog.md

# 更新日志

## v1.x.x（最新）

> 具体版本号和发布时间请以实际发布为准

### 新功能
- Streamable MCP 支持，接入 AI 工具
- 支持 ElasticSearch 数据库
- 移动端通知功能

### 改进
- 表格视图性能优化，支持万行数据流畅操作
- 扩展接口超时时间支持自定义配置
- Docker 镜像体积缩减 30%

### 修复
- 修复多选字段在 Excel 粘贴时的解析问题
- 修复角色权限在多租户场景下的边界问题

---

# 文件: zh-CN/guide/designer.md

# 应用设计器

应用设计器用于配置数据模型、字段、视图、权限和流程。

## 快速导航

- [字段类型说明](/guide/fields) — 基础类型、日期时间、选择、关联及系统字段

---

# 文件: zh-CN/guide/faq.md

# 常见问题（FAQ）

## 产品与定位

**Q：SuperUser 和多维表格（如飞书多维表格、Airtable）有什么区别？**
SuperUser 更接近轻量级 ERP/业务系统构建器，而非电子表格。它提供角色化视图、流程审批、扩展插件、私有化部署等企业特性，多维表格通常不具备这些能力。

**Q：SuperUser 和钉钉宜搭、明道云等低代码平台有什么区别？**
SuperUser 的核心差异在于：(1) 内置丰富行业模型开箱即用；(2) 扩展机制基于标准 HTTP 接口，对开发者极其友好；(3) 类 Excel 的交互体验降低了最终用户的学习成本。

**Q：没有开发人员，能用 SuperUser 吗？**
大部分功能（字段配置、视图设计、角色权限、流程配置）均无需编码。扩展（Addon）功能需要开发者介入，适合有技术团队的企业。

---

## 部署相关

**Q：私有化部署的数据存在哪里？**
数据存储在您自己的服务器上，SuperUser 不会回传任何业务数据。

**Q：云服务版和私有化版本功能是否一致？**
核心功能完全一致。私有化版本需要自行维护服务器和数据库。

**Q：支持 ARM 架构（如 Apple M 系列芯片、ARM 服务器）吗？**
Docker 镜像支持 amd64 和 arm64，可在 ARM 服务器和本地 Mac 上运行。

---

## 数据与安全

**Q：如何备份数据？**
请参考 [备份与恢复](/deploy/backup) 文档，建议定期对数据库做快照备份。

**Q：支持单点登录（SSO）吗？**
目前暂不支持 LDAP/SAML 集成。

---

# 文件: zh-CN/guide/fields.md

# 字段类型说明

模型字段是数据的基础单元，SuperUser 支持以下字段类型：

## 基础类型

| 类型 | 标识 | 说明 | 示例 |
|------|------|------|------|
| 单行文本 | `text` | 短文本，适合名称、标题 | 客户名称 |
| 多行文本 | `textarea` | 长文本，适合描述、备注 | 订单备注 |
| 富文本 | `richtext` | 支持格式化内容、图片 | 工单详情 |
| 数字 | `number` | 整数或小数，可设精度 | 金额、数量 |
| 百分比 | `percent` | 自动转换为百分比显示 | 完成率 |
| 货币 | `currency` | 带货币符号的数字 | 合同金额 |

## 日期时间类型

| 类型 | 标识 | 说明 |
|------|------|------|
| 日期 | `date` | 仅日期，格式可配置 |
| 日期时间 | `datetime` | 日期+时间 |
| 时间 | `time` | 仅时间 |

## 选择类型

| 类型 | 标识 | 说明 |
|------|------|------|
| 单选 | `select` | 从预设选项中选择一个 |
| 多选 | `multiselect` | 可选择多个选项 |
| 状态 | `status` | 带颜色标识的单选 |

## 关联类型

| 类型 | 标识 | 说明 |
|------|------|------|
| 关联记录 | `relation` | 关联同应用内其他模型的记录 |
| 关联查找 | `lookup` | 显示关联记录的某个字段值 |

## 系统字段

以下字段由系统自动维护，不可删除：

| 字段 | 说明 |
|------|------|
| `_id` | 记录唯一标识 |
| `createdAt` | 创建时间 |
| `updatedAt` | 最后更新时间 |
| `createdBy` | 创建人 |

---

# 文件: zh-CN/guide/index.md

# 快速开始

## SuperUser 是什么

SuperUser 是**模块化数据管理平台**。你可以像搭积木一样搭建业务系统：选现成模块直接用，或从零搭建自定义应用，全程无代码，不用等开发排期。

它不是电子表格，也不是传统 ERP，而是介于两者之间：比表格更适合做业务系统（流程、权限、多角色视图），比 ERP 更轻、更灵活（无代码配置、快速上线）。

## 面向谁

| 角色 | 能用 SuperUser 做什么 |
|------|------------------------|
| **业务 / 运营** | 配置字段、视图、权限、流程，用内置模块跑客户管理、运输调度、工单、财务等 |
| **外勤 / 移动** | 手机打开即用，查客户、录订单、批流程，有通知不遗漏 |
| **IT / 运维** | 私有化部署，数据在自己机房；或云服务快速开通 |
| **开发者** | 扩展基于标准 HTTP，对接外部系统或 AI 工具 |

## 解决什么问题

- **上线慢**：内置 CRM、TMS、工单、财务等模块，选一个就能用，不用从零画表
- **改不动**：字段、视图、流程、权限都能改，业务人员自己配，不用等开发
- **跑不动**：手机打开就能用，外勤也能查、录、批
- **不放心**：可私有化部署，数据在你手里；也可云服务快速试用

## 下一步

- [平台介绍](/guide/platform) — 能做什么、适合谁
- [5 分钟快速入门](/guide/quick-start) — 怎么上手
- [产品价格](/guide/prices) — 怎么收费
- [常见问题](/guide/faq) — 和其他产品有啥区别

---

# 文件: zh-CN/guide/platform.md

# 平台介绍

SuperUser 是模块化数据管理平台，让你像搭积木一样搭建业务系统，不用写代码，不用漫长实施。

## 你可以用它做什么

按业务场景选，而不是从零画表：

| 场景 | 你能做的事 | 内置模块 |
|------|-----------|----------|
| **客户管理** | 管理客户、商机、跟进记录，按销售阶段推进 | CRM |
| **运输调度** | 订单、运单、车辆、司机，运输全流程管理 | TMS |
| **工单协作** | 报修、投诉、任务分派、进度跟踪 | 工单系统 |
| **财务核算** | 应收应付、费用归集、流水管理 | 财务系统 |
| **其他业务** | 自建模型、自定义字段和流程，适配你的业务 | 设计器 |

不满足于内置模块？用设计器新建应用，或用扩展对接外部系统。

## 为什么适合你

- **业务人员**：配置字段、视图、权限、流程，不用等开发
- **外勤/移动**：手机打开即用，查、录、批都能做，有通知不遗漏
- **IT/运维**：私有化部署，数据在你机房；也可用云服务快速开通
- **开发者**：扩展基于标准 HTTP，对接你现有的系统或 AI 工具

## 快速导航

- [5 分钟快速入门](/guide/quick-start) — 怎么上手
- [产品价格](/guide/prices) — 怎么收费
- [更新日志](/guide/changelog) — 最近更新了啥
- [关于我们](/guide/about) — 谁在做

---

# 文件: zh-CN/guide/prices.md

# 产品价格

选型时你可能关心：怎么收费、有什么区别、适不适合我们。下面是概览，具体价格和方案可联系我们获取。

## 两种方式对比

| 关心点 | 云服务版 | 私有化部署 |
|--------|----------|------------|
| **谁适合** | 想快速试用、小团队、轻量业务 | 数据必须在自己机房、有运维能力 |
| **费用模式** | 按需付费，注册即用 | 一次性授权费 |
| **数据在哪** | 云端托管 | 在你自己的服务器 |
| **功能** | 核心功能完整 | 核心功能完整 |

## 云服务版

- 注册即可使用，无需部署
- 按实际使用计费
- 适合：评估试用、快速上线、小团队

## 私有化部署

- 部署在你自己的服务器或内网
- 一次性授权，数据完全由你掌控
- 需要自行维护服务器和数据库
- 适合：对数据合规有要求、已有运维团队的企业

## 获取具体报价

更多问题或需要报价，请参见 [常见问题](/guide/faq) 或 [关于我们](/guide/about) 中的联系方式。

---

# 文件: zh-CN/guide/quick-start.md

# 快速入门

5 分钟了解 SuperUser 怎么用，按你的角色选一条路走。

## 我只想先试用

1. 打开 [在线体验](http://app.opt.ltd:8080)
2. 注册或使用演示账号登录
3. 在工作区里选一个模块（如 CRM、TMS、工单）点进去
4. 像用表格一样增删改查，试试视图切换、筛选、汇总

适合：想快速感受产品、评估是否适合自己业务的人。

## 我要用内置模块跑业务

1. **开通**：云服务版直接 [注册使用](http://app.opt.ltd:8080)；私有化版按 [部署文档](/deploy/) 部署
2. **选模块**：在工作区启用需要的模块（CRM / TMS / 工单 / 财务）
3. **看数据**：进入模块，用表格/汇总/透视视图查看和管理数据
4. **按需改**：字段不够？到 [设计器](/guide/designer) 加字段；视图不合适？自己调；要审批？配置流程

适合：业务负责人、运营，希望用现成模块快速落地业务。

## 我要从零搭一个应用

1. **新建应用**：在 [设计器](/guide/designer) 中创建新应用，起个名字
2. **建模型**：添加表（实体），如「客户」「订单」，再给每个表加字段
3. **做视图**：配置表格视图、详情视图、汇总视图，不同角色看不同视图
4. **设权限**：谁能看到哪些数据、能做什么操作，在设计器里配置

适合：想完全自定义的业务分析、产品经理。

## 我要做集成或扩展

1. 先了解 [扩展机制](/developer/addon)：基于 HTTP 接口，返回 HTML 或 JSON
2. 看 [鉴权](/developer/addon-auth) 和 [错误处理](/developer/addon-error-handling) 规范
3. 参考 [完整示例](/developer/addon-examples) 开发你的扩展
4. 需要对接外部系统？用 [API](/developer/api-overview) 做增删改查

适合：开发者、技术负责人。

## 下一步

- [常见问题](/guide/faq) — 和其他产品有啥区别、部署选型、数据安全
- [技术文档](/docs/) — 按角色和任务找你要的文档

---

# 文件: zh-CN/index.md

[CompareCard 组件 - 详见站点页面]

<FinalCTA 
  title="想先了解一下？"
  subtitle="先了解 SuperUser，或直接在线试用，看看适不适合你的业务"
  primary-text="免费体验"
  primary-link="http://app.opt.ltd:8080"
  secondary-text="快速开始"
  secondary-link="/guide/"
/>

---