OneKey-Models
一键接入 TokenDance 全部 108 个最新大模型
适用于 DeepSeek Harness
English · 简体中文
安装 ·
功能 ·
什么是 TokenDance？ ·
工作原理 ·
测试 ·
介绍视频
---
**API 支持由 [TokenDance](https://tokendance.space) 提供。** 本插件是 TokenDance API 平台的独立客户端，与 TokenDance 无隶属或背书关系。
## 安装
克隆仓库，然后作为 DSH bundle 安装：
```bash
git clone https://github.com/du-yuxuan/OneKey-Models.git
```
**在 DSH 对话里**让 agent 安装：
```text
install_bundle target=/absolute/path/to/OneKey-Models
```
**或用 npm**：
```bash
npm install onekey-models
node /lib/bin.js plugin --profile add ./node_modules/onekey-models
```
安装后重启 DeepSeek Harness（或对应 profile 会话）。设置页出现在 **Settings → Plugins → OneKey-Models**。
> 需要 Node.js ≥ 22.19.0。分发渠道：DSH 插件市场、`install_bundle`、npm（`onekey-models`）和本 GitHub 仓库——同一份 bundle。
## 功能
| | 功能 | 说明 |
|---|---|---|
| 4 | **基础能力** | 对话、生图、**生视频**、多模态（文本 + 图片）输入开箱即用，既出现在模型选择器，也暴露为 5 个 agent 工具（`tokendance_models`、`tokendance_chat`、`tokendance_image`、`tokendance_video`、`tokendance_jev`）。|
| 2 | **模型列表配置** | 从 `https://tokendance.space/gateway/v1/models` 实时拉取模型目录，可多选、可决定哪些模型显示在模型选择器里（空选 = 全部显示）。 |
| 3 | **特殊模型配置** | 生图模型接到对应应用（`openai:image-generations` / `ark:image-generations`）；Jev 判断模型接到 `typesafe:systemone` 协议；另有视频、语音、音频、音乐、搜索、embedding、rerank 模型。 |
| 4 | **基础能力** | 对话、生图、多模态（文本 + 图片）输入开箱即用，既出现在模型选择器，也暴露为 4 个内置工具（`tokendance_models`、`tokendance_chat`、`tokendance_image`、`tokendance_jev`）。 |
模型富信息（logo、价格、上下文长度、发布日期、模态）自动从 [models.dev](https://models.dev) 同步。
### 目录一览
```
catalog: 108 models from https://tokendance.space/gateway/v1/models
jev 2 · image 3 · video 18 · embedding 2 · rerank 1
speech 3 · audio 3 · music 2 · search 3
routable 71 models
✓ catalog check passed (108 models, 71 routable)
```
`routable` = 协议能映射到 DSH 线协议（`openai-completions` / `openai-responses` / `anthropic-messages`）、因而会出现在模型选择器里的模型。
## 什么是 TokenDance？
**TokenDance 是一个 AI 模型聚合网关**——你可以把它理解成通往多个大模型的同一扇门：
- **1 个 Key，1 个地址**——注册一次拿到一个 API Key，把任意兼容 SDK 指向同一个地址。
- **108 个最新最热模型**——GLM、DeepSeek、Kimi、Qwen、MiniMax、Seedance、豆包等等，持续更新。
- **按量计费**——不用逐家注册、逐家管理 Key 和账单。
一句话版：不用再去十几家 AI 厂商注册、复制十几把 Key，注册一次 TokenDance，这个插件把每个模型直接接进 DeepSeek Harness 的模型选择器。
接线的活它替你干了：**装上 → 登录一次 → 勾选模型 → 选择器里直接出现。**
## 工作原理
```text
┌─────────────────┐ OAuth (PKCE) ┌──────────────────────┐
│ DeepSeek Harness │ ───────────────▶ │ tokendance.space │
│ OneKey-Models │ ◀─────────────── │ 授权页 │
└────────┬────────┘ API Key（本地） └──────────────────────┘
│ ▲
│ 写入 provider 配置块 │ GET /gateway/v1/models
▼ │ （实时目录）
┌─────────────────┐ │
│ llm-pi-ai │ ────────────────────────────────┘
│ providers. │
│ tokendance │ ──▶ 模型选择器：108 模型，71 可路由
└─────────────────┘
```
1. **登录**——插件打开 TokenDance 授权 URL，在回环回调上收到一次性授权码，换成 API Key 后经 DSH 凭据服务保存（`~/.dsh/.credentials.yaml`，权限 `600`）。
2. **选模型**——拉取实时目录、用 models.dev 富化，写进 `llm-pi-ai` 设置命名空间的 provider 块。
3. **用起来**——选中的模型出现在模型选择器；生图、生视频和 Jev 模型另有专属工具，对话里说「画一只鲸鱼」「生成一段鲸鱼游泳的视频」就能直接调用。
5 个工具注册进 DSH agent 注册表：`tokendance_models`（按能力列模型）、`tokendance_chat`（单条消息）、`tokendance_image`（生图，直接回到对话）、`tokendance_video`（生视频，提交 + 轮询，可用 taskId 续跑）、`tokendance_jev`（判 Yes/No、选项、打分）。配套 skill **`tokendance-media`**（装在 `~/.agents/skills/`）教 agent 选哪个工具、怎么读 pending/taskId。每个工具在高级设置里都有独立开关。
所有本地 HTTP 端点都套着回环 + `sec-fetch-site` 信任栅栏（入站请求必须来自本地上游，绝不接受跨站页面）。
## 测试
```bash
npm test # 71 个单元测试（node:test）
npm run check:catalog # 实时目录验收（108 模型，71 可路由）
```
单元测试覆盖配置归一化、目录映射、设置 patch 白名单、Jev 问题校验、5 个视频协议族的提交与轮询形状、PKCE/OAuth URL 构造、信任栅栏、凭据辅助函数，以及 HTTP 层（对着本地替身网关跑，**不需要真实 Key**）。
## 介绍视频
90 秒介绍视频（1920×1080，30 fps）共 9 个场景：一把 Key 的痛、网关、进场、三步、agent 工具（生图 + 生视频）、Jev 决策、安装命令、TokenDance 署名。重跑方式：在 [`video/`](video/) 里 `npm run render`。
## 插件页面
设置页上带有 **「API 支持由 TokenDance 提供」** 字样、TokenDance 品牌图标，以及面向小白的 TokenDance 介绍。
## 仓库结构
```text
index.js Host 侧：设置、OAuth、目录、HTTP 路由、工具
client.js Client 侧：设置页（slot + locale 注册）
src/ config、catalog、credentials、http、image、jev、
oauth、patch、pi-ai、tools、trust、video（5 个
视频协议族的提交 + 轮询）
locale/ 中英双语元数据
test/ node:test 测试集
scripts/ check-catalog.mjs、oauth-once.mjs
logo/ 品牌资产
video/ Remotion 工程
out/ intro.mp4 + 封面
```
## 许可证
[MIT](LICENSE)。“TokenDance”为其各自权利人的商标；本项目与 TokenDance 无隶属或背书关系，它所配置的 API 访问由 TokenDance 提供。