Repository navigation
Releases
NearToken 1.3.0 · 接上 neartoken:relist 自愈钩子
1.3.0 接上宿主的供应商自愈钩子 neartoken:relist
接了什么
magpie 2.3.2(v0.1.3240+fish.27)新增 neartoken:relist:宿主把「被 setAside 的供应商记录」放回并触发重列,用户不必再手动点「加回来」。用户显式移除的不会恢复,由宿主保证。
插件页在已连接时调一次;失败静默隔 3 秒再试一次,每会话最多两次。老宿主没有这条通道时直接跳过,不影响其它功能。
这补上了「插件重载窗口里 provider 被判成移除」之后的恢复路径。
magpie.min → 2.3.2
fish.27 起才有 relist 与五类分区。
kind 核对:值仍是 audio,不是 speech
宿主要求文档把语音分区写作 kind: speech,那是分区名。pluginKind 认的字段值仍是:
case "audio": c.Serves = speechKindOf(m.ID)
case "embedding": c.Serves = embedKindOf(m.ID)插件 1.1.8 起发的就是 audio / embedding / image / video,与 2.3.2 一致,不用改。
实测:语音模型走不了标准音频端点
拿宿主凭据直连站点探测:
| 端点 | 结果 |
|---|---|
/v1/audio/speech(带分组头) |
500 convert_request_failed / not implemented |
/v1/audio/transcriptions |
503 No available channel for model whisper-1 |
/v1/music/generations |
404 Invalid URL |
站点声明的端点类型全集里也没有 audio:
anthropic, gemini, image-generation, openai, openai-response, openai-video
NearToken 的 TTS / 转写 / 音乐模型在站点上只挂 gemini 与 openai 端点,/audio/* 路由存在但没有渠道能接。
所以分类照旧标 audio(产出确实是音频,语义没错),但 magpie 的 generate_audio 现在会在这条路上失败——需要宿主支持「gemini 原生 TTS」或站点开放 audio 渠道才真正可用,这不在插件能改的范围。
音乐模型(suno_*)同样走 ["openai"] 端点,没有独立 /music/generations,不涉及「独立 API 分流」。
验证
- 单元测试 98 项全部通过,新增
tests/relist-channel.test.mjs4 条:通道已声明、已连接才调用、失败静默、重试上限、min 值。 - 包内 34 个文件,sha256
7f28ef8fadd234f4d1cbf371a3c30572e710caa35f60200a8d9d5c6795475197。
NearToken 1.2.0 · 修掉日志模型名被硬裁
1.2.0 修掉日志里模型名被硬裁
现象
日志表格的「模型」列,同一个模型有时完整、有时被切掉尾巴:
gpt-6.1-sol high ← 有思考强度,正常
gpt-6.1-sc ← 没有思考强度,被裁
奇怪的是没有思考强度反而更短,却更早被裁。
根因:不是宽度不够,是胶囊不参与收缩
.lg-pill 的基础样式里有 width: fit-content。它在 flex 容器里会被当成内容宽度,不参与收缩,于是按完整模型名的宽度撑开,溢出 grid 列后被外层直接裁掉——因为溢出发生在胶囊之外,连 text-overflow: ellipsis 都没机会生效。
带思考强度的那行之所以正常,是因为多了一个兄弟元素,flex 反而进入了收缩路径。
改法
/* 容器撑满整列,胶囊才有收缩空间 */
.logs .lg-model-inline { width: 100%; min-width: 0; }
/* 覆盖 .lg-pill 的 width: fit-content */
.logs .lg-model-pill { width: auto; flex: 0 1 auto; min-width: 0; overflow: hidden; }
/* 文字自己省略,图标不参与收缩 */
.logs .lg-model-pill > span { min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.logs .lg-model-pill > svg, .logs .lg-model-pill > img, .logs .lg-model-pill > i { flex: none; }同时把 9 列全部套上 minmax(0, …):fr 的默认下限是内容最小宽度,nowrap 的内容会把列撑开、让整行溢出容器。套上之后列可以真正收缩,内部的 overflow: hidden 才会生效。
验证
无头 Chrome 实测(1700px 宽、2x 像素比):
deepseek-flash High 有强度
gpt-6.1-sol 无强度,现在完整显示
gemini-3.1-pro-preview Low
grok-4.6-xhigh High
第二行正是原本被截成 gpt-6.1-sc 的那个模型。
- 单元测试 94 项全部通过;
- 包内 34 个文件,sha256
2a9c0ccc2bd8d1125ea3818cde440730c7388d7d7e2473e7692ad12c85d56008。
NearToken 1.1.9 · 抬 magpie.min 到 2.3.1
1.1.9 抬 magpie.min 到 2.3.1
宿主 2.3.1(v0.1.3207+fish.26)落地了 FISH-DOCK-Plugins#42 的插件 kind 接入,package.json 的 magpie.min 相应从 2.2.2 抬到 2.3.1。
一个需要说清的实测结论
宿主当前的插件清单解析不读 min 这个字段。internal/plugin/page.go 解 magpie 段时只认:
Magpie struct {
Page *part `json:"page"`
Panels []part `json:"panels"`
Actions []part `json:"actions"`
Permissions []string `json:"permissions"`
Calls []string `json:"calls"`
}没有 min。所以它不影响能不能装上,作用只是把「分类需要 2.3.1+」写进清单给人看。
真正决定行为的是宿主版本:2.3.1 起 plugin.Model.Kind 生效;老宿主上这些模型仍按对话模型显示(kindOutput 保留 text: true 就是为此)。
核对过的落位
拿包内快照的 109 个真实模型,按宿主 pluginKind 的规则逐条推演:
| 落点 | 数量 |
|---|---|
Draws(图像) |
20 |
Films(视频) |
5 |
Serves=speech |
10 |
Serves=transcription |
1(gemini-3.5-transcribe) |
Serves=embedding |
3 |
| 对话 | 70 |
sd2.0 / sd2.5 会进视频分区,看着像误解,其实是站点自己的标注:它们的 supported_endpoint_types 是 ["openai-video"]、分组是「[低价] Seedance」——Seedance 视频模型被站点命名为 sd2.x。
验证
- 单元测试 94 项全部通过;
- 包内 34 个文件,sha256
e0134f09b21c063366e8c778507f39b772c860f7e622c8396f5a55d9f90fc8eb。
NearToken 1.1.8 · 收紧模型分类,适配宿主 fish.25 的 kind 接入
1.1.8 收紧模型分类,适配宿主 fish.25 的 kind 接入
宿主 v0.1.3140+fish.25 起会把插件声明的 kind 接进分类(对应 FISH-DOCK-Plugins#42):
插件给的 kind |
宿主认成 | 落点 |
|---|---|---|
image |
Draws |
供应商编辑器「图像模型」、设置 → 图像 |
video |
Films |
「视频模型」、设置里的视频行 |
audio |
Serves = speech |
「语音模型」、设置 → 语音模型 |
embedding |
Serves = embedding |
「向量模型」、设置 → 向量模型 |
chat / 不给 |
Serves = "" |
对话模型 |
插件侧的取值本来就是这五个,这次只收紧判定,不动取值。
语音:只看输出侧
以前把模型名、分组名、描述一起丢进正则,gpt-4o-audio-preview 这类「能听音频、输出仍是文本」的对话模型会被卷进语音分区。现在端点类型或分组名说了算,模型名不参与:
if (ends.some((e) => /^(audio|tts|asr|transcription|speech)$/i.test(e))) return 'audio'
if (/tts|asr|text-to-speech|speech|suno|语音|转文字/i.test(groups)) return 'audio'向量:只认完整的 embedding 词
去掉裸 embed 匹配——embedded-agent-v2、embed-sandbox 这类不再误判。判据是 embedding / jina-rerank 端点、分组名含向量 / embedding,或模型名含完整的 embedding。
不是改判,是收紧
用包内快照的 109 个真实模型逐一对比改动前后:
改前: audio=11 chat=70 embedding=3 image=20 video=5
改后: audio=11 chat=70 embedding=3 image=20 video=5
发生变化的模型 0 个
老宿主兼容
kindOutput('audio') 与 kindOutput('embedding') 仍带 text: true。在不认 kind 的老宿主上,这些模型至少还能当对话模型看到,不会被彻底丢掉;等 fish.25 铺开再考虑收紧。
验证
- 单元测试 94 项全部通过,新增
tests/model-kind.test.mjs7 条:- 五个取值合法;
- 端点判据(image-generation / openai-video / audio / tts / embedding / jina-rerank);
- 分组判据(TTS / ASR / Suno / 语音 / 向量);
- 能听音频但输出文本的对话模型仍是
chat(issue 点名的回归点); - 裸
embed不再误判; kind与capabilities.output一致;chat不写kind字段。
- 包内 34 个文件,sha256
65eccdc36e5ee2f6083b37b5a5feac817d2212ed21e68d3832b4e0511ce56c1b。
待办
package.json 的 magpie.min 仍是 2.2.2:含 fish.25 的宿主版本还没发布,抬上去会让当前宿主拒装。等它上线后改成该版本号,老宿主上这些模型才会从对话列表里让出去。
NearToken 1.1.7 · 删掉自动检查更新与热重载
1.1.7 删掉自动检查更新与热重载
插件以前会每分钟向 npm registry 问一次最新版本,写进 page/latest.js,页面再比对并自动重载。这套东西有两个问题:
- 多余的网络请求:插件运行时每隔一分钟打一次
registry.npmjs.org,与「少去打扰外部服务」的方向相反; - 重复了宿主的职责:magpie 自己就有插件更新检查(
plugin-updates.json),版本号显示也由page/version.js提供,插件不需要再造一份。
删除清单
| 位置 | 删掉的东西 |
|---|---|
index.mjs |
stampLatest()、latestAskedAt、两处调用(usage 与 models 钩子里) |
page/app.js |
整块「检查更新」:cmpVersion、loadLatest、autoHotReload、startHotReload 及其调用 |
page/latest.js |
整个文件(包内文件数 35 → 34) |
page/index.html |
#update-note 提示元素 |
page/style.css |
.update-note 三条样式 |
保留
头部版本号胶囊 #version 与 page/version.js 原样保留,boot() 里填充版本号的逻辑不动——只是不再去 npm 问有没有新版本,也不再自动重载页面。
这条改动与「供应商掉出」无关
掉出是宿主在插件重载窗口里把 provider 判成「用户已移除」,与版本检查是两件事。已开专用 issue 跟踪:
FISH-DOCK-Plugins#41 — 需求:插件不可用期间保留其供应商与模型,除非用户显式移除(provider sticky)。
issue 里给了三条实现路径,推荐「provider 级 sticky」:plugin.Providers() 与 plugin.Cached() 做并集,plugins.json 仍装着 spec 的 provider 按 stale 保留,并复用现有 FellBack 分支跳过 pick 对比。这样插件进程崩溃或重载时,供应商与模型都不会从列表消失。
验证
- 单元测试 87 项全部通过;
- 全仓无
latest.js/NEARTOKEN_LATEST/update-note/stampLatest/startHotReload残留; - 包内 34 个文件,sha256
aa70a42263fe6c113a3a6011a03a6de2b9db671769111c1df3f6f9bac2f5eb8a。
NearToken 1.1.6 · 止住五分钟掉一次供应商
1.1.6 五分钟掉一次供应商的成因与防护
宿主那 5 分钟是怎么来的
宿主 internal/provider/plugin_relist.go:
relistEvery = time.Hour // 正常每小时重列
relistFirst = time.Minute // 启动 1 分钟后首次
relistSoon = 5 * time.Minute // 有模型「离开列表」时,5 分钟后立刻再列一次KeepPluginsListed 每次重列都对比前后两份列表:只要有模型这次没出现,就调用 dropGonePluginPicks 把用户对这个模型的选择移出,并把下次重列提前到 5 分钟。
所以「过几分钟掉一次」不是插件崩了,而是某次重列给出的模型表比上一次少。
插件为什么会给少
catalog() 有三级兜底:站点实时表 → 包内快照 → 空。包内快照是打包那一刻的站点状态,站点后来新增的模型它没有。只要某次走到快照,列表就比上次少,宿主立刻按「模型下架」处理。
两道防护
防护 1:列表单调不减
mergeModelsWithLastGood(table, lastGood)保留上一次「站点实时」拿到的表,本次缺哪个就补哪个。站点偶发少给几个模型时,用户的选择不会被误删。
防护 2:非实时数据打标记
本次数据不是站点实时(用了包内快照或彻底失败)时,在返回表上写:
safe[Symbol.for('magpie.fellBack')] = true宿主 host.js 认这个标记:
out.fellBack = ... || next?.[Symbol.for("magpie.fellBack")] === trueGo 侧 pluginListedIDs 与 keptListed 都会跳过 FellBack 的 provider——打了标记的列表不参与「谁不见了」的判断,也就不会丢 pick。
宿主支持性已实测
在本机安装的 magpie.exe(61 MB)里搜到了这些字符串:
✓ magpie.fellBack
✓ pluginListedIDs
✓ KeepPluginsListed
✓ left its plugin's list
宿主确实支持这条通道,不依赖未发布的宿主改动。
验证
- 单元测试 87 项全部通过,新增
tests/relist-guard.test.mjs:- 站点少给模型时必须补齐(单调不减);
- 站点多给模型时不受影响(新模型照常进入);
- 首列来自包内快照时必须打
magpie.fellBack; models()永不向宿主抛异常。
page/health.js增加source(live / snapshot / empty)与restored(本次补回几个),可在插件目录直接核对这次列表的来源。
包
fish-under-sea-magpie-neartoken-1.1.6.tgz,35 个文件。- sha256
77522703d2f210de373308512ca0dedb4ee72135190aa427de9f053e4f845ccb。
NearToken 1.1.5 · 日志凭据走 models 钩子,详情按站点真实计费
1.1.5 日志靠重建模型表拿凭据 · 类型与计费详情按站点真实数据
日志凭据
宿主 host.js 调插件的 models 钩子时会带第二个参数:
ph.models(given, { auth: authCopy(k), signal })auth 是 plugin-auth.json 里该账号凭据的副本。也就是说重列模型这个动作本身就会把令牌送到插件手上——启动首列、每小时重列、手动「获取模型」都算。
插件现在在 models(_given, ctx) 里收下 ctx.auth.access 并立即抓一次逐条日志,不再依赖 reconnect,也不再依赖宿主调 auth.usage。
类型按站点真实值映射
实测 /api/log/token 的 type 是数字(当前账号全是 2),不是字符串,之前写死的「消耗」是错的。现在按站点编码映射:1 充值 / 2 消费 / 3 管理 / 4 系统 / 5 错误 / 6 退款,未知值原样回显。
详情列还原真实单价
之前把 model_ratio 当成了「元/百万 token」,这是错的。真实还原有两条路:
表达式计费(billing_mode: tiered_expr)——解码 expr_b64,取该档位里 p 与 c 的系数:
tier("0_272k", p * 2 + cr * 0.1 + cc * 2.5 + c * 10)| 模型 | 实测显示 | 官网显示 |
|---|---|---|
| gpt-6.1-sol | 0_272k · ¥2 / ¥10/M |
一致 |
| gpt-6-astra | 0_272k · ¥10 / ¥50/M |
一致 |
倍率计费——输入 model_ratio × 2、输出 model_ratio × completion_ratio × 2:
| 模型 | 字段 | 实测显示 | 官网显示 |
|---|---|---|---|
| gpt-6.1-terra | 0.5 / 5 |
标准 · ¥1 / ¥5/M |
一致 |
时段档位显示中文:off_peak → 谷时、peak → 峰时。0_272k 这类长度分层保留站点原写法。两条路都不成立时退回显示额度,不编造单价。
缓存读写系数是
cr/cc,变量名同样含字母c,正则加了(?<![a-z])负向断言,否则会把缓存系数误读成输出单价。
页面
- 列序:
时间(含消耗 + 令牌)→ 分组 → 模型 → 费用 → 请求体大小 → 流 → Token → 耗时 → 详情; - 令牌胶囊挪到「消耗」标签后面,不再单独占一列;分组恢复为独立列;详情列加回末尾;
- 列宽改为比例分配,容器变宽时等比铺开、右侧不留空白;
- 耗时竖条按秒数分档:< 5s 绿 / 5–15s 橙黄 / ≥ 15s 红,首字与耗时各自按自己的秒数取色;
- 模型胶囊改为液态玻璃:半透明渐变底 + 背景模糊 + 内高光与落影;
- 代金券去掉左侧竖条与虚线票根,改胶囊样式,并修掉组名重复(
Grok Grok)。
验证
- 单元测试 82 项全部通过,其中新增:
tests/logs-detail.test.mjs:用实测的三条真实数据锁定计费还原;tests/logs-latency-style.test.mjs:锁定耗时分档与「不许用 lg-bar 类名」;tests/voucher-style.test.mjs:锁定代金券无竖条、无重复组名。
- 包内 35 个文件;
logs.js/logs-meta.js/health.js均为占位。 - 包 sha256
4ef6b862acea460e1ad26b38e95f78a359ea5f0194e1d7749b0c7744a590214a。
已知边界
- 插件进程重启后,要等宿主下一次列举模型(≤1 分钟)日志才会有数据;也可手动点「获取模型」立即触发。
- 耗时分档阈值 5s / 15s 是按可见设计定的:原站日志组件是懒加载 chunk,匿名抓不到阈值常量,需要实机对照再校准。
NearToken 1.1.4 · 日志凭据由宿主重列送来
1.1.4 日志凭据改由宿主重列送来 · 空态说人话
之前为什么一直 no-auth
1.1.3 只从 auth.usage / auth.loader 取令牌,实测这两条在普通使用路径上都不触发,所以 logs-meta 长期停在:
{"stage":"no-auth","error":"还没拿到站点凭据(宿主尚未调用余额或请求钩子)"}真正的通道在宿主的 models 钩子
internal/plugin/host.js:2060:
ph.models(given, { auth: authCopy(k), signal: ctl.signal })authCopy(k) 是 plugin-auth.json 里该账号凭据的副本。宿主每次列举模型都会把令牌递给插件——启动首列、每小时重列、手动「获取模型」全都算。
插件现在在 models(_given, ctx) 里先收下 ctx.auth.access,再抓一次逐条日志。所以:
- 在 magpie 供应商页点一次「获取模型 / 刷新」→ 日志立刻补齐;
- 或等插件进程启动后一分钟内的首次重列;
- 不需要 reconnect,也不需要宿主另开通道。
空态文案
不再说「读取失败」,改成说清差哪一步,并给出可执行动作。
验证
- 单元测试 69 项全部通过;新增回归:模拟宿主传
auth,断言logs.js写出逐条流水。 - 包内 35 个文件;
logs.js/logs-meta.js/health.js均为占位。 - 包 sha256
740c02cd3db0a34214f1de00c738dcee9debeae79b52c4bc35e28782d5e9fe5b。
已知边界
- 插件进程重启后要等宿主下一次列举(≤1 分钟才会重新列一次;也可手动刷新),日志才会重新有数据。
- 若希望日志完全不依赖插件进程,需要宿主代取
/api/log/token并填进usage.rows(FISH-DOCK-Plugins#37)。
NearToken 1.1.3 · 页面不再每分钟敲宿主,日志凭据自备
1.1.3 页面刷新不再每分钟敲一次宿主 · 日志凭据自备
「页面隔一会刷新一下」的真身
tick() 以前每 60 秒调一次 load(),而 load() 第一行就是 neartoken:state。宿主的 state() 第一行又是 settle()——命中时 handOver() → dropHostProvider() 会删掉宿主侧的 provider 条目。
也就是说:插件页每开一分钟,就给宿主一次删 provider 的机会。这正是「隔一会刷新一下」与「供应商反复掉出」能被连起来的那条链。
现在:
- 每 60 秒只刷用量(
neartoken:usage),不再碰 state; neartoken:state降到启动时 + 显式动作 + 每 10 分钟一次;- 从后台切回页面时同样只刷用量,超过 10 分钟才重新问 state。
日志为什么一直空
page/logs-meta.js(1.1.2 新增)实测给出:
{"ok":false,"stage":"no-auth","trigger":"catalog","rows":0,"error":"还没拿到站点凭据"}宿主 neartoken:state 只回 configured 与令牌名,不回令牌;逐条日志要 getAuth,而它只在「宿主要余额」或「发请求」时才递进来。这些路径都没发生时,logs.js 永远是占位。
现在:连接成功那一刻令牌本来就在手上,留一份在进程内(只放内存、不落盘),并立即抓一次日志;fetchLogs 的钥匙来源改为「宿主递的 → 连接时的 → 都没有才报 no-auth」。页面空态会直接写「在插件页重新连接一次即可补齐」。
验证
- 单元测试 68 项全部通过。
- 包内 35 个文件;
logs.js/logs-meta.js/health.js均为占位。 - 包 sha256
affccc7d27b3e2c9d9c4b8b37f407534b11ef88ecee635f7c423ba82f74d910b。
已知边界
- 插件进程重启后,若宿主还没把
getAuth递进来,逐条日志会回到no-auth,重新连接一次即可。 - 要彻底免掉这一步,需要宿主侧代取
/api/log/token并填进usage.rows——已提FISH-DOCK-Plugins#37。
NearToken 1.1.2 · 停用只由宿主过滤,清掉旧 options
1.1.2 单一真相:停用只由宿主过滤 · 清掉旧 options
这一版把「谁来决定模型出现」收敛成一个答案,并让日志缺失时能自证原因。
之前为什么会互相打架
停用状态曾经有两份:宿主 pluginCatalog 按 neartoken-prefs.json 剔一次,插件 provider.models() 又按 page/prefs.json 剔一次。两边不同步时:
- 宿主剔光、插件还留着 → 供应商「有卡片、无模型」;
- 插件剔光、宿主不知道 → 空表 → 供应商掉出。
现在
provider.models()一律返回站点全量,不再读任何偏好文件;停用完全交给宿主modelFilter。- 插件彻底不再读插件 options(
disabledModels/disabledGroups/enabledByGroup/disabledByGroup),页面启动也不再bridge.options.get()。其中options.disabledGroups是隐患:它曾能静默过滤整组模型,是「模型数忽多忽少」的现成来源。 - 旧版写进宿主
plugins.json的那几个键变成纯历史,插件侧不再受其影响。
日志可自证
- 新增
page/logs-meta.js:记录每次逐条日志抓取走到哪一步(no-auth/no-key/no-list/ok/error)。 - 页面据此说清「为什么没有日志」,不再笼统说没数据。
- 抓取触发点:拿到凭据即刻、宿主列举模型时(60 秒节流)、后台每分钟。
打包卫生
prepack增加scripts/reset-generated.mjs:把logs.js/logs-meta.js/health.js复位为占位,避免本地测试写下的运行时数据进包(1.1.1 的logs.js就是这样被写脏的)。
提交给宿主的两条 issue
- #36:重列钩子(
neartoken:refresh顺带plugin.Providers)、handOver删除防抖、PrefModel.Groups参与隐藏判定、旧 options 迁移清理。 - #37:逐条日志来源(
/api/dsh/device/usage无 rows,/api/log/token有)+ 宿主日志落盘位置。
已知边界
- 宿主没有
neartoken:prefs时,停用只在本页生效,不影响 magpie 的模型列表。 - 分组粒度明细只存本页(
localStorage);宿主只表达「整模型停用」。
验证
- 单元测试 68 项全部通过(含新增:停用不被插件二次过滤、全选清空、全不选两侧一致、宿主写入上限保护)。
- 包内 35 个文件;
logs.js/logs-meta.js/health.js均为占位。 - 包 sha256
2c27f940113587841ddcda09e831c089fba1aa13e52fe883ee6796d2dce535d3。