灵犀跨境

灵犀跨境是面向跨境业务团队的 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. 启动：

docker compose --env-file .env up -d --build

默认访问地址：http://127.0.0.1:8088。

健康检查：

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 服务凭据。

开发检查

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 白名单。