https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.colink

1. 使用流程概览

Co-Link 的使用可以拆分为三个步骤：

1. 注册账号并获取 Token
2. 启动 Client（接入算力节点）
3. 调用 API（使用 AI 服务）

1.1 系统角色说明

角色	说明
Server	调度中心，负责路由请求（已部署完成）
Client	算力节点，执行推理任务
API 调用者	使用 AI 接口的程序或用户

2. 访问地址说明

控制台地址：
https://colink.${微服名称}.heiyu.space

API 地址：
https://colink.${微服名称}.heiyu.space/v1

3. 初始化账号与 Token

3.1 注册账号

访问 Web 控制台：

https://colink.${微服名称}.heiyu.space

完成注册并登录。

3.2 获取 Token

在用户面板中获取：

Token	用途
Client Token	用于节点接入
API Token	用于接口调用

4. 接入算力节点（Client）

每一台提供算力的机器都需要运行一个 Client。

4.1 创建配置文件（config.yaml）

client_token: "<你的 Client Token>"
server_url: "wss://colink.${微服名称}.heiyu.space/ws"
max_parallel: 3

providers:
  - type: "openai"
    api_key: "<你的 OpenAI 或代理 API Key>"
    base_url: "<可选：如 https://one-api.xxx/v1>"
    models:
      - local: "deepseek-chat"
        server_mapping: "pro-model"

4.2 启动 Client

CoLink Client 下载地址

🍎 macOS

Intel (amd64)
https://github.com/Jlan45/CoLinkPlan/releases/download/v1.0.1/colink-darwin-amd64.tar.gz
Apple Silicon (arm64)
https://github.com/Jlan45/CoLinkPlan/releases/download/v1.0.1/colink-darwin-arm64.tar.gz

🐧 Linux

下载完成之后解压后将文件放到到 config.yaml 同目录，然后启动客户端

Linux

./colink-client-linux-amd64
# or
./colink-client-linux-arm64

MacOS

./colink-client-darwin-amd64
# or
./colink-client-darwin-arm64

4.3 启动成功标志

出现如下日志表示连接成功：

{"time":"2026-04-07T19:15:35.661511906+08:00","level":"INFO","msg":"Starting Co-Link Client","config":"config.yaml","server":"wss://colink.${微服名称}.heiyu.space/ws","max_parallel":3}
{"time":"2026-04-07T19:15:35.662237086+08:00","level":"INFO","msg":"Dialing server","url":"wss://colink.${微服名称}.heiyu.space/ws"}
{"time":"2026-04-07T19:15:35.707830345+08:00","level":"INFO","msg":"Connected to server successfully"}

5. 验证节点是否接入成功

登录控制台后访问：

https://colink.${微服名称}.heiyu.space/nodes

如果看到节点在线，则说明接入成功。

6. 调用 AI API

Co-Link 完全兼容 OpenAI API。

统一 API 入口为：

https://colink.${微服名称}.heiyu.space/v1

6.1 Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="sk-colink-your-api-token",
    base_url="https://colink.${微服名称}.heiyu.space/v1",
)

resp = client.chat.completions.create(
    model="pro-model",
    messages=[{"role": "user", "content": "Hello!"}],
)

print(resp.choices[0].message.content)

6.2 流式调用

stream = client.chat.completions.create(
    model="pro-model",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True,
)

for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="")

6.3 curl 示例

curl -X POST https://colink.${微服名称}.heiyu.space/v1/chat/completions \
  -H "Authorization: Bearer ${API Token}" \
  -H "Content-Type: application/json" \
  -d '{
    "model":"pro-model",
    "messages":[{"role":"user","content":"Hello!"}]
  }'

运行成功

7. 核心配置说明

7.1 并发控制

max_parallel: 3

表示该节点最多同时处理 3 个请求。

7.2 模型映射

models:
  - local: "deepseek-chat"
    server_mapping: "pro-model"

说明：

local：Provider 实际模型名称
server_mapping：对外暴露的模型名称（API 调用使用）

8. 调度机制说明

Co-Link Server 会自动：

选择空闲节点处理请求
节点失败自动切换（最多 3 次）
出错节点封禁 60 秒

Co-Link：将多台设备整合为统一 AI API 的使用指南