wmq
54 lines
1.7 KiB
Markdown
54 lines
1.7 KiB
Markdown
# 灵犀跨境
|
|
|
|
灵犀跨境是面向跨境业务团队的 Telegram 客户沟通与 AI 经营平台。当前版本只开放 Telegram，所有开放功能均访问真实 API、PostgreSQL、DeepSeek 和 Telegram Gateway，不包含前端 Mock 数据。
|
|
|
|
## 服务组成
|
|
|
|
- React + TypeScript 前端，由 Nginx 提供静态资源和 API 反向代理。
|
|
- Node.js API，负责独立租户、用户认证、CRM、会话、AI 和网关适配。
|
|
- PostgreSQL，持久化租户隔离的业务数据。
|
|
- 已有 Telegram Gateway，负责真实 Telegram 账号与 TDLib 操作。
|
|
- DeepSeek Anthropic-compatible API，负责翻译、情感、意图、风险、摘要和回复建议。
|
|
|
|
## Docker 启动
|
|
|
|
1. 复制 `.env.example` 为 `.env`。
|
|
2. 生成数据库、JWT、Webhook 随机密钥。
|
|
3. 设置轮换后的 `DEEPSEEK_API_KEY`。
|
|
4. 设置 Telegram Gateway 的租户令牌、租户 ID 和账号 ID。
|
|
5. 启动：
|
|
|
|
```powershell
|
|
docker compose --env-file .env up -d --build
|
|
```
|
|
|
|
默认访问地址：`http://127.0.0.1:8088`。
|
|
|
|
健康检查：
|
|
|
|
```powershell
|
|
Invoke-RestMethod http://127.0.0.1:8088/health
|
|
Invoke-RestMethod http://127.0.0.1:8088/api/dashboard/overview
|
|
```
|
|
|
|
业务 API 需要通过注册或登录取得 Bearer Token。浏览器永远不会收到 DeepSeek 或 Telegram Gateway 服务凭据。
|
|
|
|
## 开发检查
|
|
|
|
```powershell
|
|
npm install
|
|
npm run typecheck
|
|
npm run build
|
|
|
|
Set-Location server
|
|
npm install
|
|
node --check src/index.js
|
|
```
|
|
|
|
## 安全说明
|
|
|
|
- `.env` 已加入 `.gitignore`，严禁提交真实密钥。
|
|
- AI 回复只提供人工确认建议，不会自动向 Telegram 发送。
|
|
- 所有业务资源都通过 JWT 中的租户 ID 隔离。
|
|
- Webhook 必须配置独立随机密钥；生产部署应进一步使用 HTTPS、反向代理和 IP 白名单。
|