Skip to content

Releases

NearToken 1.3.0 · 接上 neartoken:relist 自愈钩子

Choose a tag to compare

@Fish-under-sea Fish-under-sea released this 07 Nov 12:28

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.mjs 4 条:通道已声明、已连接才调用、失败静默、重试上限、min 值。
  • 包内 34 个文件,sha256 7f28ef8fadd234f4d1cbf371a3c30572e710caa35f60200a8d9d5c6795475197。

NearToken 1.2.0 · 修掉日志模型名被硬裁

Choose a tag to compare

@Fish-under-sea Fish-under-sea released this 07 Nov 10:14

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

Choose a tag to compare

@Fish-under-sea Fish-under-sea released this 06 Nov 23:56

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 接入

Choose a tag to compare

@Fish-under-sea Fish-under-sea released this 06 Nov 22:33

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.mjs 7 条:
    • 五个取值合法;
    • 端点判据(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 · 删掉自动检查更新与热重载

Choose a tag to compare

@Fish-under-sea Fish-under-sea released this 06 Nov 21:55

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 · 止住五分钟掉一次供应商

Choose a tag to compare

@Fish-under-sea Fish-under-sea released this 06 Nov 21:13

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")] === true

Go 侧 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 钩子,详情按站点真实计费

Choose a tag to compare

@Fish-under-sea Fish-under-sea released this 06 Nov 21:07

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 · 日志凭据由宿主重列送来

Choose a tag to compare

@Fish-under-sea Fish-under-sea released this 06 Nov 19:23

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 · 页面不再每分钟敲宿主,日志凭据自备

Choose a tag to compare

@Fish-under-sea Fish-under-sea released this 06 Nov 19:11

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

Choose a tag to compare

@Fish-under-sea Fish-under-sea released this 06 Nov 18:26

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。