# intellink-智通

**Repository Path**: aifedcloud/intellink

## Basic Information

- **Project Name**: intellink-智通
- **Description**: intellink-智通
- **Primary Language**: Rust
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-15
- **Last Updated**: 2026-09-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Intellink

Intellink 是 Rust 编写的 AI API 网关，支持 OpenAI 兼容的 Chat Completions、无状态 Responses 和 Embeddings，包括流式响应、有限重试、模型路由、用户与密钥限额、内部积分计费及调用记录。

网关采用单实例 SQLite。用户通过统一身份 JWT 管理自己的密钥，管理员通过独立的中文管理界面管理用户组、积分、用量与配置。只有启用的“管理员”组成员可以进入后台；默认同时提供“普通用户”组。示例模型价格为零，不涉及支付。

## 本地运行

需要 Rust 1.98+、Node.js 24、pnpm 10、SQLite、curl 和 jq。在仓库根目录运行：

```sh
cargo build --locked --bins
pnpm --dir ui/admin install --frozen-lockfile
```

创建管理员，密码通过标准输入传入：

```sh
IFS= read -rs -p '管理员密码（至少 12 字节）：' INTELLINK_ADMIN_PASSWORD
printf '%s' "$INTELLINK_ADMIN_PASSWORD" | cargo run --bin intellink -- bootstrap-admin --username admin
unset INTELLINK_ADMIN_PASSWORD
```

分别在三个终端启动：

```sh
cargo run --bin intellink-mock
cargo run --bin intellink
pnpm --dir ui/admin dev
```

访问 **http://localhost:3000**。API 位于 8080，测试身份与上游服务位于 9001，指标接口位于 **19090**。项目不使用 9090。

仓库提供 direnv/devenv 配置：`direnv allow` 后执行 `devenv up`，可统一启动上述应用及 Prometheus（9091）、Grafana（3001）。进入目录本身不会启动服务。

[开发指南](docs/development.md)包含创建密钥、调用模型、监控和检查命令。

## 容器运行

```sh
export INTELLINK_GIT_COMMIT=$(git rev-parse HEAD)
docker compose up --build -d --wait
IFS= read -rs -p '管理员密码（至少 12 字节）：' INTELLINK_ADMIN_PASSWORD
printf '%s' "$INTELLINK_ADMIN_PASSWORD" | docker compose exec -T gateway intellink --config /app/assets/config/compose.toml bootstrap-admin --username admin
unset INTELLINK_ADMIN_PASSWORD
```

Compose 是使用公开测试身份密钥的演示环境。实际部署前请按[部署说明](docs/deployment.md)替换身份及上游配置，并配置 HTTPS。

## 文档

- [架构](docs/architecture.md)
- [配置与资源归属](docs/configuration.md)及[完整配置示例](assets/config/all-options.toml)
- [API](docs/api.md)、[身份认证与用户组](docs/authentication.md)
- [积分与用量结算](docs/accounting.md)
- [开发与版本规则](docs/development.md)、[验证记录](docs/verification.md)
- [部署与可观测性](docs/deployment.md)
- [后续改进](docs/improvements.md)、[参考项目](docs/references.md)
- [管理界面设计规范](DESIGN.md)

`references/` 下是固定版本的参考子模块，按需执行 `git submodule update --init`。构建 Intellink 不需要构建参考项目。