dsh-neartoken 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/README.md +149 -132
  2. package/lib/client.js +61 -61
  3. package/lib/index.js +1289 -36
  4. package/lib/types/host/adapter.d.ts +18 -1
  5. package/lib/types/host/model-caps.d.ts +53 -4
  6. package/lib/types/host/model-caps.generated.d.ts +7 -4
  7. package/lib/types/host/pricing.d.ts +19 -4
  8. package/lib/types/host/provider-mount.d.ts +5 -0
  9. package/lib/types/index.d.ts +49 -0
  10. package/package.json +1 -1
package/README.md CHANGED
@@ -1,132 +1,149 @@
1
- <p align="center">
2
- <a href="https://dshfind.com/zh/plugins/huanlinoto/dsh-neartoken"><img src="https://dshfind.com/api/card/huanlinoto/dsh-neartoken?lang=zh" alt="dsh-neartoken card"></a>
3
- </p>
4
- # dsh-neartoken
5
-
6
- 把 New API 站点（NearToken，`https://llm.pko.svcfusion.com`）变成 DSH 的模型供应商：**在设置页发起设备授权 → 用户在自己浏览器里登录站点并确认 → 插件自动接入 `neartoken` provider**。插件全程不接触密码。模型选择器再把这批模型按 New API 的渠道分组折成 **模型 → 分组 → 推理等级** 三级。
7
-
8
- ## 架构
9
-
10
- ```
11
- ┌─ host 半边（src/index.ts + src/host/）────────────────────────────┐
12
- │ NearTokenAccount（account.ts）+ DeviceAuthorizationClient │
13
- │ · POST /api/dsh/device/authorize → 拿 device_code + user_code │
14
- │ · 后台按 interval 轮询 POST /api/dsh/device/token │
15
- │ authorization_pending / slow_down(+2s 退避) / access_denied / │
16
- │ expired_token / granted │
17
- │ · granted → 写 credentials 的 NEARTOKEN_API_KEY → 挂 provider │
18
- │ routes.ts：webServer 同源路由（设置页调用） │
19
- │ GET /neartoken/status POST /neartoken/authorize │
20
- │ POST /neartoken/cancel POST /neartoken/logout │
21
- │ GET /neartoken/models POST /neartoken/models（模型白名单） │
22
- │ whitelist.ts：白名单读/写 │
23
- │ · 存插件自身 Config 的 enabledModels（volatile），经 settings.update │
24
- │ 写入 profile patch；volatile 使改动热提交、不重挂插件 │
25
- │ · 空数组 = 没设白名单 = 全部显示 │
26
- │ NearTokenProvider（provider-mount.ts） │
27
- │ · 有 key → registerAdapter + registerConfigurableProviders │
28
- │ · 没 key → 撤掉路由（列表里不会出现调不通的模型） │
29
- │ NearTokenAdapter（adapter.ts） │
30
- │ · listModels: GET /api/pricing → (group, model) 笛卡尔展开 │
31
- │ catalog id = "<group>::<model>"，name = "<model> @ <group>" │
32
- │ 再按「模型过滤」与白名单（裸模型名）过滤；stream 用同批路由找分组│
33
- │ · stream: 按模型自动选协议（protocol-router.ts） │
34
- │ claude*→/v1/messages gemini*→/v1beta/models/*:streamGenerate- │
35
- │ Content gpt*/o1·o3·o4*→/v1/responses 其余→/v1/chat/completions│
36
- │ body.model = 裸模型名 │
37
- │ header x-neartoken-group = 分组的 ref "#<id>"（不是分组名） │
38
- └────────────────────────────────────────────────────────────────────┘
39
- ┌─ client 半边（src/client/）────────────────────────────────────────┐
40
- │ settings.section（order -5，账号与余额 ↔ 通用设置之间） │
41
- │ NearTokenSection：连接按钮 / 确认码 + 打开浏览器 / 账号卡片 / 断开 │
42
- │ + 模型白名单（搜索、全选、清空、全部显示、保存） │
43
- │ · 行内：模型名 + 分组数 + 最低倍率胶囊；分组明细 hover 出浮层 │
44
- │ · 分组名按站点规则渲染成彩色 tag 胶囊（低价=绿、反重力=青…） │
45
- │ · 只列出可提供的模型（见下「模型过滤」） │
46
- │ conversation.input.model（priority -1 覆盖内置模型座） │
47
- │ · name 按 " @ " 拆回 (模型, 分组)，同模型折叠成一行 │
48
- │ · 触发器显示 "Claude Opus 5 C @ NearToken"，不渲染分组 │
49
- │ · 列表项按 displayModelName 美化（- → 空格，词首大写、品牌名） │
50
- │ · 分组只在「分组」那一级里出现（"[低价][反重力] Claude" → tag 胶囊）│
51
- │ · 倍率从 catalog description（"分组倍率 0.4x"）解析显示 │
52
- │ · 数据仍走 ctx.modelDirectories（与 /model 弹窗同一份状态） │
53
- └────────────────────────────────────────────────────────────────────┘
54
- ```
55
-
56
- ## 使用
57
-
58
- 1. 装插件、重启 `dsh web`、硬刷新。
59
- 2. 打开 **设置 → NearToken**，点「连接 NearToken」。
60
- 3. 设置页显示一个确认码；点「打开浏览器确认」，在站点自己的页面里登录（密码、2FA、passkey 都走站点原生流程）并批准。
61
- 4. 插件轮询到批准后自动完成：把站点为该插件铸造的 API key 写进 credentials 的 `NEARTOKEN_API_KEY`，并挂上 `neartoken` provider —— 模型选择器里立刻出现按分组折叠的模型。
62
- 5. 「断开连接」删掉本地凭据、撤掉 provider，并调用站点的撤销端点。
63
- 6. 卡片下方的「模型白名单」勾选即自动保存（无需点保存）——未勾选的不再出现在模型选择器里，且**当场生效、不用刷新页面**：保存后 Host 用 `AdapterRegistrationHandle.replace()` 重新声明同一条路由，它会同步发布 `llm/adapters-updated`，浏览器收到后重拉模型目录。没设置过白名单时默认全部显示；「全部显示」清空白名单。
64
-
65
- 备用路径：直接让 credentials 服务存 `NEARTOKEN_API_KEY`（Web 端 Models 页写入），或启动环境导出同名变量——provider 会在启动时按凭据现状挂载。
66
-
67
- > 这依赖 new-api 侧实现设备授权流端点，契约见 [HANDOFF-new-api.md](HANDOFF-new-api.md) 第一部分。站点尚未实现时，第 2 步会直接报「站点拒绝发起设备授权」。
68
-
69
- 分组路由按同一文档第二部分：请求头 `x-neartoken-group` 的值是 `/api/pricing` 的 `group_refs` 给出的 **`#<id>`**（纯 ASCII），分组名只用于展示；某分组没有 ref 时不发该头，按令牌自身分组路由。
70
-
71
- ## 配置
72
-
73
- | 字段 | 默认 | 说明 |
74
- |---|---|---|
75
- | `baseURL` | `https://llm.pko.svcfusion.com` | 站点根地址，不带尾斜杠 |
76
- | `apiKeyEnv` | `NEARTOKEN_API_KEY` | 授权写入、adapter 读取的凭据引用名 |
77
- | `catalogTtlMs` | `300000` | `/api/pricing` 目录缓存时长 |
78
- | `enabledModels` | `[]` | 模型白名单（裸模型名）；空数组 = 全部显示。唯一 volatile 字段，设置页直接写它 |
79
-
80
- ## 原型阶段的硬编码
81
-
82
- | 位置 | 内容 |
83
- |---|---|
84
- | `src/client/groups.ts` `GROUPED_PROVIDERS` | 哪些 provider 的模型名带分组后缀（当前 `['neartoken']`） |
85
- | `src/host/adapter.ts` `REASONING` | 所有路由统一通告 low/medium/high（演示值） |
86
- | `src/client/groups.ts` `badgeOf` | badge 颜色规则：含「低价」→绿，「满血」→黄，其余→蓝 |
87
- | `src/host/account.ts` `CLIENT_NAME` | 确认页上显示的客户端名 |
88
-
89
- 改完 `pnpm run build` + 浏览器硬刷新即可（profile 是 `link:` 引用）。
90
-
91
- ## 模型过滤与推理等级
92
-
93
- 站点 `/api/pricing` 会列出它知道的所有模型，插件只提供能描述的那个子集（`src/host/model-caps.ts`）：
94
-
95
- | 隐藏条件 | 例子 |
96
- |---|---|
97
- | 名字以 `-c` 结尾 | `claude-opus-5-c`（站点总有一个同名无后缀的孪生） |
98
- | 名字含 image / tts / transcribe / asr | `gpt-image-2.5-flare`、`gemini-3.8-flash-tts` |
99
- | 不在模型能力表里 | `glm-5.0`、`grok-4.5量`、`qwen3-coder-plus` |
100
-
101
- 推理档位来自 `@earendil-works/pi-ai` 的模型目录（DSH 的 `llm-pi-ai` 用的同一份数据）。插件不在运行时依赖它：`scripts/gen-model-caps.mjs` 把目录生成成 `src/host/model-caps.generated.ts`（1101 个 chat 模型 / 486 个带档位），升级依赖后跑 `pnpm run gen:model-caps` 重建。表里没有档位的模型照常提供，只是不显示「推理等级」这一级，请求也不带 `reasoning_effort`。
102
-
103
- 同一模型 id 在不同 provider 下可能给出不同档位（网关常只列两档，厂商列六档），生成时取**最完整**的那份。
104
-
105
- 按生产快照：104 个模型 → 保留 49 个，其中 40 个有真实档位。
106
-
107
- ## 已知限制（原型）
108
-
109
- - 四套 wire（chat / anthropic / genai / responses）各自解析 SSE；图片与文件仍以占位文本发送；`/model` 弹窗仍是内置平铺列表；箭头键盘导航未接。
110
- - 四套 wire 的 SSE 解析都有「帧样本 → 期望 chunk 序列」回归测试（`src/host/wire-parse.spec.ts`），帧样本取自生产网关的真实响应。网关在内容帧上发 `"usage": null`，只有末帧带真值：任何一处把 `usage` 当对象直接读都会让整条流中途崩掉（曾导致 claude 模型全不可用）。
111
- - 推理等级按各协议自己的词汇发送：**anthropic 发 `thinking.type=adaptive` + `output_config.effort`**（不能再用 `thinking.type=enabled` + `budget_tokens`：Claude 5 代直接 400 `requires adaptive thinking`，而 adaptive 在老代际上同样可用，所以统一用它；`minimal` 收敛成 `low`）；genai 发 `thinkingConfig` 且带 `includeThoughts`（不带你拿不到思维链）；chat 与 responses 发 `reasoning_effort` / `reasoning.effort`。
112
- - 文本与思维块由**第一个非空 delta** 打开，思维块为空时不产生空块；工具调用块在 `content_block_start` 打开，因为 id 与函数名只在那里出现。
113
- - **Gemini 4 换成 `thinkingLevel`**：这一代不再接受 token 预算（发 budget 会 400 `Use thinking level instead`），按 `gemini-<主版本>` ≥ 4 自动切换字段，等级名直接用 `low` / `medium` / `high` / `max`。
114
- - 站点会先上架 pi-ai 目录还没收录的模型。这类名字默认隐藏（不猜能力），`src/host/model-caps.ts` 的 `UNCALLED_MODELS` 是显式放行表，值为实测出来的推理等级（`gemini-4-argon` 就是一条）。目录收录后删掉对应条目即可。
115
- - 思考历史**不回传**：harness 的 reasoning 块没有 signature 槽位，anthropic 的 `signature_delta` 与 gemini 的 `thoughtSignature` 都被丢弃。当前网关的转换层本身也会丢弃 thinking 块，所以多轮不会因此报错；接真正的 Anthropic / Gemini 直连渠道时这一条会变成硬限制。
116
- - anthropic 线不再硬编码 `max_tokens`：只在调用方给了上限、或开了 thinking 需要给它留出余量时才发。给死值会截断长回答。
117
- - pricing 加载失败时沿用上一次成功的结果，从未成功过则目录为空（失败不写缓存，下次调用会重试）。
118
- - 账号卡片不自动刷新：数字只来自授权那一刻 grant 里的 `user`（站点的 dashboard 接口认浏览器会话，不认本插件持有的 relay key），落盘到 profile 下的 `neartoken-account.json`，重启后从文件恢复。之后余额变化不会反映，需要重新连接一次。
119
- - 供应商是授权态驱动的：断开连接后，正在使用 NearToken 模型的会话需要重新选模型。
120
- - 设备授权流依赖 new-api 侧实现，未实现前插件只能走「外部导出 key」的备用路径。
121
- - 白名单按裸模型名过滤：勾掉某模型会把它的所有分组一起隐藏。某个正在使用的模型被勾掉后，会话里已选中的 id 仍在，但选择器里不再列出它。
122
- - 「-c 后缀」是站点自己的约定：带该后缀的模型工具调用不可靠，插件只在界面上标注（设置页与模型选择器），不拦截选择。
123
- - 白名单写入走 DSH 的 Settings：profile 里该行只保留 volatile 字段，所以别把 `baseURL` 等非 volatile 字段写进**同一个 profile 行**（会在此后第一次保存白名单时被 Settings 的 strip 规则清掉）。
124
-
125
- ## 开发
126
-
127
- ```sh
128
- pnpm install
129
- pnpm run typecheck
130
- pnpm run test # vitest：account（含设备授权轮询）/ pricing / adapter / groups / whitelist / routes / config
131
- pnpm run build # lib/index.js (host) + lib/client.js (client) + lib/types
132
- ```
1
+ <p align="center">
2
+ <a href="https://dshfind.com/zh/plugins/huanlinoto/dsh-neartoken"><img src="https://dshfind.com/api/card/huanlinoto/dsh-neartoken?lang=zh" alt="dsh-neartoken card"></a>
3
+ </p>
4
+ # dsh-neartoken
5
+
6
+ 把 New API 站点（NearToken，`https://llm.pko.svcfusion.com`）变成 DSH 的模型供应商：**在设置页发起设备授权 → 用户在自己浏览器里登录站点并确认 → 插件自动接入 `neartoken` provider**。插件全程不接触密码。模型选择器再把这批模型按 New API 的渠道分组折成 **模型 → 分组 → 推理等级** 三级。
7
+
8
+ ## 架构
9
+
10
+ ```mermaid
11
+ flowchart LR
12
+ subgraph site["New API 站点"]
13
+ pricing["/api/pricing<br/>模型 · 分组 · 倍率 · 容量 · 端点类型"]
14
+ device["/api/dsh/device/*<br/>设备授权"]
15
+ relay["/v1/messages · /v1beta · /v1/responses · /v1/chat/completions"]
16
+ end
17
+
18
+ subgraph client["Client 半边 src/client"]
19
+ settings["设置页 NearTokenSection<br/>连接 / 账号卡片 / 模型白名单"]
20
+ picker["模型选择器 ModelGroupSelect<br/>模型 → 分组 → 推理等级"]
21
+ end
22
+
23
+ subgraph host["Host 半边 src/host"]
24
+ routes["routes.ts<br/>GET/POST /neartoken/*"]
25
+ account["NearTokenAccount<br/>轮询设备授权"]
26
+ creds[("credentials<br/>NEARTOKEN_API_KEY")]
27
+ provider["NearTokenProvider<br/>注册 / 撤下路由"]
28
+ adapter["NearTokenAdapter<br/>listModels · resolveModel · stream"]
29
+ catalog["PricingDirectory<br/>TTL 缓存 + 可见性过滤"]
30
+ wire["wire 层<br/>openai · anthropic · genai · responses"]
31
+ caps["model-caps.ts<br/>可见性 · 容量 · 推理等级"]
32
+ end
33
+
34
+ settings --> routes
35
+ routes --> account
36
+ routes --> provider
37
+ account -->|"POST /api/dsh/device/token"| device
38
+ account -->|"授权成功写入"| creds
39
+ creds -->|"有 key 才挂路由"| provider
40
+ provider --> adapter
41
+ catalog -->|"GET /api/pricing"| pricing
42
+ catalog --> adapter
43
+ caps --> catalog
44
+ caps --> adapter
45
+ adapter --> wire
46
+ wire --> relay
47
+ adapter -.->|"经 ctx.llm 发布目录"| picker
48
+ ```
49
+
50
+ | 文件 | 职责 |
51
+ |---|---|
52
+ | `src/index.ts` | 配置 schema、按凭据现状挂载 provider、装配其余模块 |
53
+ | `src/host/account.ts` | RFC 8628 形状的设备授权：发起、按 interval 轮询、把 key 写进 credentials |
54
+ | `src/host/routes.ts` | 设置页调用的同源路由（状态 / 授权 / 取消 / 断开 / 模型白名单） |
55
+ | `src/host/whitelist.ts` | 白名单读写在插件自身 Config 的 `enabledModels`（volatile），存 profile patch |
56
+ | `src/host/pricing.ts` | 拉 `/api/pricing`，展开成 `"<组>::<模型>"` 路由，过滤出能聊的模型 |
57
+ | `src/host/model-caps.ts` | 一个模型能不能聊、上下文窗口多大、可选的推理等级 |
58
+ | `src/host/adapter.ts` | 目录、元数据、按模型选协议并流式解析 |
59
+ | `src/host/*-wire.ts` | 四条上游协议各自的请求体与 SSE 解析 |
60
+ | `src/client/` | 设置页、模型选择器、分组胶囊渲染 |
61
+
62
+ ## 使用
63
+
64
+ 1. 装插件、重启 `dsh web`、硬刷新。
65
+ 2. 打开 **设置 → NearToken**，点「连接 NearToken」。
66
+ 3. 设置页显示确认码；点「打开浏览器确认」，在站点自己的页面登录（密码、2FA、passkey 都走站点原生流程）并批准。
67
+ 4. 插件轮询到批准后自动完成：把站点为该插件铸造的 API key 写进 credentials 的 `NEARTOKEN_API_KEY`，并挂上 `neartoken` provider。
68
+ 5. 「断开连接」删掉本地凭据、撤掉 provider，并调用站点的撤销端点。
69
+ 6. 卡片下方的「模型白名单」勾选即自动保存 —— 未勾选的不再出现在模型选择器里，且当场生效（Host 用 `AdapterRegistrationHandle.replace()` 重新声明同一条路由，同步发布 `llm/adapters-updated`，浏览器重拉目录）。没设置过白名单时默认全部显示，「全部显示」清空白名单。
70
+
71
+ 备用路径：直接让 credentials 服务存 `NEARTOKEN_API_KEY`，或启动环境导出同名变量 —— provider 会在启动时按凭据现状挂载。
72
+
73
+ > 设备授权流需要 new-api 侧实现对应端点，契约见 [HANDOFF-new-api.md](HANDOFF-new-api.md) 第一部分。站点尚未实现时会直接报「站点拒绝发起设备授权」。
74
+
75
+ 分组路由按同一文档：请求头 `x-neartoken-group` 的值是 `/api/pricing` 的 `group_refs` 给出的 **`#<id>`**（纯 ASCII），分组名只用于展示；某分组没有 ref 时不发该头，按令牌自身分组路由。
76
+
77
+ ## 配置
78
+
79
+ | 字段 | 默认 | 说明 |
80
+ |---|---|---|
81
+ | `baseURL` | `https://llm.pko.svcfusion.com` | 站点根地址，不带尾斜杠 |
82
+ | `apiKeyEnv` | `NEARTOKEN_API_KEY` | 授权写入、adapter 读取的凭据引用名 |
83
+ | `catalogTtlMs` | `300000` | `/api/pricing` 目录缓存时长 |
84
+ | `defaultContextWindow` | `200000` | 没有任何来源能说明某模型上下文窗口时上报的值 |
85
+ | `modelOverrides` | `{}` | 按裸模型名逐条修正容量与推理等级，见下 |
86
+ | `enabledModels` | `[]` | 模型白名单（裸模型名）；空数组 = 全部显示。唯一 volatile 字段，设置页直接写它 |
87
+
88
+ `modelOverrides` 是「站点没声明、目录还没收录」时的兜底手段，改完重启即生效，**不需要发新版本**：
89
+
90
+ ```yaml
91
+ - id: dsh-neartoken
92
+ config:
93
+ defaultContextWindow: 200000
94
+ modelOverrides:
95
+ gemini-4-argon:
96
+ contextWindow: 1048576
97
+ reasoning: [low, medium, high, max]
98
+ ```
99
+
100
+ ## 模型可见性
101
+
102
+ 站点 `/api/pricing` 会列出它知道的所有模型，插件只提供会响应聊天请求的那部分：
103
+
104
+ 1. **站点自己声明的 `supported_endpoint_types` 优先**：含 `openai` / `openai-response` / `anthropic` / `gemini` 任一即可见。这是站点上新增模型当天就能出现在选择器里的原因 —— 不需要等插件发版。
105
+ 2. 无论站点声明什么，`-c` 后缀与媒体名（image / tts / transcribe / asr）都不提供 —— 定价接口把这些路由也挂在 `openai` 这个 surface 下，只看声明会把生图和语音模型塞进聊天选择器。
106
+ 3. **站点没声明时**回退到名字规则：pi-ai 目录里没有的名字不提供。
107
+
108
+ ## 容量与推理等级
109
+
110
+ 上下文窗口（`contextWindow`）决定两件事：对话里的占用率显示，以及自动压缩的阈值。**它缺失时自动压缩会直接放弃**（compaction 后端拒绝为无界模型计算摘要预算），所以插件永远会给出一个值。优先级：
111
+
112
+ | 优先级 | 来源 | 维护方式 |
113
+ |---|---|---|
114
+ | 1 | `modelOverrides` | 改 profile 配置，重启 |
115
+ | 2 | 站点 `/api/pricing` 的 `context_window` | 在 New API 管理后台维护，见下 |
116
+ | 3 | pi-ai 生成表（`src/host/model-caps.generated.ts`） | `pnpm run gen:model-caps` |
117
+ | 4 | `defaultContextWindow` | 改 profile 配置 |
118
+
119
+ **推荐在站点侧维护**：New API 管理后台可以给每个模型填上下文窗口与最大输出，`/api/pricing` 会把它们作为 `context_window` / `max_tokens` 发出来。这样一台站点的容量对**所有客户端一致生效**，插件不需要跟着站点上新模型发版。维护步骤见 new-api 仓库 `AGENTS.md` 的「模型容量清单」一节。
120
+
121
+ 最大输出（`max_tokens`）只在**站点或配置明确给出**时才写进请求；生成表里的 `maxTokens` 是厂商口径，站点可能把同一个名字路由到上限更低的渠道，照发会把「回答被截断」换成「请求被拒」，所以不用它。不给出该字段时由上游默认值决定。
122
+
123
+ 推理等级来自 `@earendil-works/pi-ai` 的模型目录（DSH 的 `llm-pi-ai` 用的同一份数据）。插件不在运行时依赖它：`scripts/gen-model-caps.mjs` 把目录生成成 `src/host/model-caps.generated.ts`（1101 个 chat 模型、486 个带推理档位、1101 个带上下文窗口），升级依赖后跑 `pnpm run gen:model-caps` 重建。同一模型 id 在不同 provider 下可能给出不同档位（网关常只列两档，厂商列六档），生成时取**最完整**的那份；上下文窗口取**最小**的那份。
124
+
125
+ ## 已知限制
126
+
127
+ - 四套 wire（chat / anthropic / genai / responses）各自解析 SSE；图片与文件仍以占位文本发送；`/model` 弹窗仍是内置平铺列表；箭头键盘导航未接。
128
+ - 四套 wire 的 SSE 解析都有「帧样本 → 期望 chunk 序列」回归测试（`src/host/wire-parse.spec.ts`），帧样本取自生产网关的真实响应。网关在内容帧上发 `"usage": null`，只有末帧带真值：任何一处把 `usage` 当对象直接读都会让整条流中途崩掉（曾导致 claude 模型全不可用）。
129
+ - 推理等级按各协议自己的词汇发送：**anthropic 发 `thinking.type=adaptive` + `output_config.effort`**（不能再用 `thinking.type=enabled` + `budget_tokens`：Claude 5 代直接 400 `requires adaptive thinking`，而 adaptive 在老代际上同样可用，所以统一用它；`minimal` 收敛成 `low`）；genai 发 `thinkingConfig` 且带 `includeThoughts`（不带你拿不到思维链）；chat 与 responses 发 `reasoning_effort` / `reasoning.effort`。
130
+ - **Gemini 4 换成 `thinkingLevel`**：这一代不再接受 token 预算（发 budget 会 400 `Use thinking level instead`），按 `gemini-<主版本>` ≥ 4 自动切换字段，等级名用 `low` / `medium` / `high` / `max`。
131
+ - 思考历史**不回传**：harness 的 reasoning 块没有 signature 槽位，anthropic 的 `signature_delta` 与 gemini 的 `thoughtSignature` 都被丢弃。当前网关的转换层本身也会丢弃 thinking 块，所以多轮不会因此报错；接真正的 Anthropic / Gemini 直连渠道时这一条会变成硬限制。
132
+ - 文本与思维块由**第一个非空 delta** 打开，思维块为空时不产生空块；工具调用块在 `content_block_start` 打开，因为 id 与函数名只在那里出现。
133
+ - anthropic 线不硬编码 `max_tokens`：只在调用方给了上限、或开了 thinking 需要余量时才发。给死值会截断长回答。
134
+ - `-c` 后缀是站点自己的约定（带该后缀的模型工具调用不可靠）：站点声明了端点类型时插件按声明提供，声明里没有它就不会出现；没有声明时按名字隐藏它的无后缀孪生之外的变体。
135
+ - 站点上新、pi-ai 目录还没收录的模型：只要站点声明了端点类型就会提供，容量走 `defaultContextWindow`，推理等级为空（除非在 `modelOverrides` 里写明）。
136
+ - pricing 加载失败时沿用上一次成功的结果，从未成功过则目录为空（失败不写缓存，下次调用会重试）。
137
+ - 账号卡片不自动刷新：数字只来自授权那一刻 grant 里的 `user`（站点的 dashboard 接口认浏览器会话，不认本插件持有的 relay key），落盘到 profile 下的 `neartoken-account.json`，重启后从文件恢复。之后余额变化不会反映，需要重新连接一次。
138
+ - 白名单按裸模型名过滤：勾掉某模型会把它的所有分组一起隐藏；某个正在使用的模型被勾掉后，会话里已选中的 id 仍在，但选择器里不再列出它。
139
+ - 白名单写入走 DSH 的 Settings：profile 里该行只保留 volatile 字段，所以别把 `baseURL` 等非 volatile 字段写进**同一个 profile 行**（会在此后第一次保存白名单时被 Settings 的 strip 规则清掉）。
140
+
141
+ ## 开发
142
+
143
+ ```sh
144
+ pnpm install
145
+ pnpm run typecheck
146
+ pnpm run test # vitest：account / pricing / adapter / model-caps / groups / whitelist / routes / config / wire-parse
147
+ pnpm run gen:model-caps # 升级 @earendil-works/pi-ai 后重建能力表
148
+ pnpm run build # lib/index.js (host) + lib/client.js (client) + lib/types
149
+ ```
package/lib/client.js CHANGED
@@ -305,23 +305,23 @@ window.__ModuleLoader__.load({
305
305
  document.head.appendChild(tag);
306
306
  }
307
307
  var group_tags_module_css_default = {
308
- "ratioBase": "FotuUq_ratioBase",
308
+ "toneFuchsia": "FotuUq_toneFuchsia",
309
+ "ratioCheap": "FotuUq_ratioCheap",
310
+ "toneSky": "FotuUq_toneSky",
311
+ "toneIndigo": "FotuUq_toneIndigo",
312
+ "toneViolet": "FotuUq_toneViolet",
309
313
  "toneLime": "FotuUq_toneLime",
310
- "toneTeal": "FotuUq_toneTeal",
311
314
  "ratioChip": "FotuUq_ratioChip",
312
- "tonePink": "FotuUq_tonePink",
315
+ "toneTeal": "FotuUq_toneTeal",
313
316
  "tag": "FotuUq_tag",
314
- "toneSky": "FotuUq_toneSky",
315
- "toneEmerald": "FotuUq_toneEmerald",
316
- "toneCyan": "FotuUq_toneCyan",
317
317
  "toneRose": "FotuUq_toneRose",
318
+ "toneOrange": "FotuUq_toneOrange",
319
+ "ratioBase": "FotuUq_ratioBase",
320
+ "toneEmerald": "FotuUq_toneEmerald",
318
321
  "ratioPricey": "FotuUq_ratioPricey",
319
- "toneViolet": "FotuUq_toneViolet",
320
- "ratioCheap": "FotuUq_ratioCheap",
321
322
  "toneAmber": "FotuUq_toneAmber",
322
- "toneOrange": "FotuUq_toneOrange",
323
- "toneIndigo": "FotuUq_toneIndigo",
324
- "toneFuchsia": "FotuUq_toneFuchsia"
323
+ "toneCyan": "FotuUq_toneCyan",
324
+ "tonePink": "FotuUq_tonePink"
325
325
  };
326
326
  //#endregion
327
327
  //#region src/client/group-tags.tsx
@@ -376,39 +376,39 @@ window.__ModuleLoader__.load({
376
376
  document.head.appendChild(tag);
377
377
  }
378
378
  var ModelGroupSelect_module_css_default = {
379
- "searchClear": "_2pt-bW_searchClear",
380
- "empty": "_2pt-bW_empty",
381
- "triggerEffort": "_2pt-bW_triggerEffort",
382
- "cellLabel": "_2pt-bW_cellLabel",
379
+ "error": "_2pt-bW_error",
380
+ "variantCount": "_2pt-bW_variantCount",
381
+ "searchRow": "_2pt-bW_searchRow",
382
+ "status": "_2pt-bW_status",
383
+ "optionActive": "_2pt-bW_optionActive",
383
384
  "triggerLabel": "_2pt-bW_triggerLabel",
384
- "groupInline": "_2pt-bW_groupInline",
385
385
  "menu": "_2pt-bW_menu",
386
- "cellValue": "_2pt-bW_cellValue",
387
- "optionCopy": "_2pt-bW_optionCopy",
388
- "modelOption": "_2pt-bW_modelOption",
389
- "modelName": "_2pt-bW_modelName",
390
- "variantCount": "_2pt-bW_variantCount",
391
- "retry": "_2pt-bW_retry",
392
- "selected": "_2pt-bW_selected",
386
+ "cellLabel": "_2pt-bW_cellLabel",
387
+ "groupInline": "_2pt-bW_groupInline",
388
+ "empty": "_2pt-bW_empty",
389
+ "trigger": "_2pt-bW_trigger",
390
+ "searchClear": "_2pt-bW_searchClear",
393
391
  "check": "_2pt-bW_check",
394
- "groupOptionLabel": "_2pt-bW_groupOptionLabel",
395
- "status": "_2pt-bW_status",
396
- "searchRow": "_2pt-bW_searchRow",
392
+ "modelName": "_2pt-bW_modelName",
393
+ "cellValue": "_2pt-bW_cellValue",
394
+ "warning": "_2pt-bW_warning",
395
+ "triggerIcon": "_2pt-bW_triggerIcon",
396
+ "option": "_2pt-bW_option",
397
397
  "groups": "_2pt-bW_groups",
398
398
  "cellChevron": "_2pt-bW_cellChevron",
399
+ "cell": "_2pt-bW_cell",
400
+ "optionCopy": "_2pt-bW_optionCopy",
399
401
  "optionTrailing": "_2pt-bW_optionTrailing",
400
- "trigger": "_2pt-bW_trigger",
401
- "root": "_2pt-bW_root",
402
- "toast": "_2pt-bW_toast",
402
+ "triggerEffort": "_2pt-bW_triggerEffort",
403
+ "groupOptionLabel": "_2pt-bW_groupOptionLabel",
403
404
  "groupName": "_2pt-bW_groupName",
405
+ "root": "_2pt-bW_root",
406
+ "selected": "_2pt-bW_selected",
407
+ "modelOption": "_2pt-bW_modelOption",
408
+ "search": "_2pt-bW_search",
404
409
  "chevron": "_2pt-bW_chevron",
405
- "error": "_2pt-bW_error",
406
- "cell": "_2pt-bW_cell",
407
- "triggerIcon": "_2pt-bW_triggerIcon",
408
- "option": "_2pt-bW_option",
409
- "optionActive": "_2pt-bW_optionActive",
410
- "warning": "_2pt-bW_warning",
411
- "search": "_2pt-bW_search"
410
+ "retry": "_2pt-bW_retry",
411
+ "toast": "_2pt-bW_toast"
412
412
  };
413
413
  //#endregion
414
414
  //#region src/client/ModelGroupSelect.tsx
@@ -974,41 +974,41 @@ window.__ModuleLoader__.load({
974
974
  document.head.appendChild(tag);
975
975
  }
976
976
  var NearTokenSection_module_css_default = {
977
- "hint": "_02HI2q_hint",
978
- "toolbar": "_02HI2q_toolbar",
979
- "list": "_02HI2q_list",
980
- "section": "_02HI2q_section",
981
977
  "button": "_02HI2q_button",
982
- "tipGroup": "_02HI2q_tipGroup",
983
- "tip": "_02HI2q_tip",
978
+ "rowMeta": "_02HI2q_rowMeta",
979
+ "fact": "_02HI2q_fact",
984
980
  "notice": "_02HI2q_notice",
985
- "title": "_02HI2q_title",
986
981
  "form": "_02HI2q_form",
987
- "rowRatio": "_02HI2q_rowRatio",
988
- "row": "_02HI2q_row",
989
- "fact": "_02HI2q_fact",
990
- "facts": "_02HI2q_facts",
991
- "tipRow": "_02HI2q_tipRow",
982
+ "codeRow": "_02HI2q_codeRow",
983
+ "section": "_02HI2q_section",
992
984
  "badgeOn": "_02HI2q_badgeOn",
993
- "rowMeta": "_02HI2q_rowMeta",
994
- "search": "_02HI2q_search",
995
- "intro": "_02HI2q_intro",
996
- "autosave": "_02HI2q_autosave",
997
- "name": "_02HI2q_name",
998
- "handle": "_02HI2q_handle",
999
- "tipTitle": "_02HI2q_tipTitle",
1000
985
  "buttonPrimary": "_02HI2q_buttonPrimary",
1001
- "factValue": "_02HI2q_factValue",
1002
986
  "rowName": "_02HI2q_rowName",
987
+ "intro": "_02HI2q_intro",
988
+ "list": "_02HI2q_list",
989
+ "name": "_02HI2q_name",
990
+ "actions": "_02HI2q_actions",
991
+ "facts": "_02HI2q_facts",
992
+ "autosave": "_02HI2q_autosave",
1003
993
  "label": "_02HI2q_label",
1004
- "factLabel": "_02HI2q_factLabel",
1005
994
  "tipGroupName": "_02HI2q_tipGroupName",
995
+ "hint": "_02HI2q_hint",
996
+ "factValue": "_02HI2q_factValue",
997
+ "tipTitle": "_02HI2q_tipTitle",
998
+ "tipRow": "_02HI2q_tipRow",
999
+ "row": "_02HI2q_row",
1006
1000
  "badge": "_02HI2q_badge",
1007
- "cardHead": "_02HI2q_cardHead",
1008
- "actions": "_02HI2q_actions",
1009
- "codeRow": "_02HI2q_codeRow",
1001
+ "code": "_02HI2q_code",
1002
+ "tip": "_02HI2q_tip",
1003
+ "factLabel": "_02HI2q_factLabel",
1004
+ "search": "_02HI2q_search",
1005
+ "toolbar": "_02HI2q_toolbar",
1006
+ "title": "_02HI2q_title",
1007
+ "rowRatio": "_02HI2q_rowRatio",
1010
1008
  "card": "_02HI2q_card",
1011
- "code": "_02HI2q_code"
1009
+ "handle": "_02HI2q_handle",
1010
+ "cardHead": "_02HI2q_cardHead",
1011
+ "tipGroup": "_02HI2q_tipGroup"
1012
1012
  };
1013
1013
  //#endregion
1014
1014
  //#region src/client/NearTokenSection.tsx