Repository navigation
Releases
Releases · MYCF711/magpie-plugin-scaffold
v0.3.15
新增通用邀请来源选择运行时:src/invite-policy.mjs
- 从
magpie-croli与magpie-monkeycode的已验证交互回收createInvitePolicy():inviteSource下拉支持最新账号、指定稳定 uid 与手动邀请码;账号目录、首选 uid、取码函数与存储均注入,不带入厂商常量 latest/ 指定 uid /manual分别持久化:latest 不会退化成当前 uid,manual 不会丢失;关闭首选开关后强制 latest,无效 uid 才修回 latestask()按所选账号取码,prepare()给authorize()同一快照、零出站;取码失败只回退同一 uid 的旧缓存或用户预留;targetIdentity相同显式 skip 自邀- 手动预留码与账号选择分文件保存;非法 token / Key 不落盘并阻止本次继续使用旧预留码;无账号时降级文本输入,不生成空 select
- 新增
tests/invite-policy.test.mjs12 项;HOOKS 四之一新增 5b 接线示例,README/GUIDE/RECYCLING 补模块入口,AGENTS 坑表新增第 41 条 package.json:version0.3.14 → 0.3.15
v0.3.14
模板默认带上插件选项栏,并默认置顶(auth.options + placement: "top")
index.mjs:auth.options从注释示例改为真正启用的session-header开关,每条默认placement: "top";chat.headers在使用点实时读这个开关(旧版 magpie 没有magpie.option时按default: true走,不会静默失效)tests/mount.test.mjs:锁「每条placement === "top"」「key 合法且不重复 / label ≤60」「开关真的接到chat.headers」「读不到magpie.option时按默认值走」README.md:数据字段表补auth.options一行- 起因:0.3.13 只把契约写进
HOOKS.md,模板里仍是注释状态 —— 派生插件照抄出来不会有选项栏;而placement不写就落在模型列表下面,卡片一长用户滚不到
v0.3.12
修:pre-push 误拦 tag 推送(0.3.11 实装当天真卡过一次)
scripts/hooks/pre-push:这一批 ref 全是refs/tags/*时直接放行。tag 推送是发布动作,release.mjs已经跑过 check / test / pack,钩子再跑一遍既重复、又会在npm test偶发波动时把 tag 钉死- 现象:
node scripts/release.mjs --yes里tag v0.3.11 … 失败,本地 tag 有、远端没有,而脚本只打印一句"Release 交给 release.yml",看起来像已经发了 - 判据:
git ls-remote --tags <remote> | grep v<版本>—— 远端没有这个 tag 就是没发;混合推送(分支 + tag)仍按分支规则跑门禁
v0.3.11
本地钩子一条命令装好:提交前脱敏 + 推送前分级门禁
- 新增
scripts/install-hooks.mjs与scripts/hooks/:node scripts/install-hooks.mjs一次装两个钩子 ——pre-commit跑privacy-scan --staged(毫秒级),pre-push跑快档check+privacy-scan(实测 0~1 秒) pre-push按合入点分级:只有在推main、git push -u首次推一个新分支、或显式PLUGIN_FULL=1时,才加跑npm test/check-docs/pack --dry-run(实测约 3~5 秒)。WIP 分支的后续推送只过快档 —— 派生项目长大后测试会变慢,分级是让钩子不被绕过的前提- 逃生门
PLUGIN_SKIP_HOOK=1 git push只跳过这一次,不是永久关闭 scripts/create.mjs:输出的「接下来」从五件事变六件,第 5 条是git init之后跑install-hooks.mjsAGENTS.md:新增 §8.3b(钩子表 / 为什么分级 / CI 触发面的收窄办法);§8.3 的 pre-commit 一行命令保留为「只想挂脱敏」的简化路径- 起因:
ci.yml的五步(check / test / docs / privacy / pack)在本地没有任何东西兜底,漏跑任意一步就是「推上去才发现红」+ 一封 Actions 失败邮件。实测模板全套本地不到 5 秒,没有理由留到 CI 才发现
v0.3.10
新增 scripts/check-ua.mjs:出站 User-Agent 必须是官方客户端 UA
scripts/check-ua.mjs:扫index.mjs+src/,查四类 —— 自产品名形态(magpie/…、magpie-xxx/<ver>、alysis-magpie/…)、运行时默认(node/Bun/…/undici)、截断的 Mozilla 残句(缺(KHTML, like Gecko) Chrome/… Safari/537.36)、以及「打非本机上游却没设 UA」(这一类是警告)。注释里的示例不算违规;tests/与scripts/不扫(夹具与打 GitHub API 的请求是故意的)。npm run check一起卡这条- 起因是一条会静默出错的链路:上游网关按
<product>/<version>形态认出「第三方客户端」,回403 {"error_code":"TM.00000001","error_msg":"网络繁忙,请稍后重试"}—— 文案说网络繁忙,用户重试 / 换号全没用。而 magpie 给插件的请求带User-Agent: magpie/<version>,插件不显式设 UA 就把它透传上去,一样命中。实测(同一签名、同一请求体,只换 UA,交替 3 轮):<产品名>/0.2.1-rc.2带不带(+url)都 403,<产品名>(无版本号)/curl/8.7.1/ 不发 UA 都 200 src/http.mjs:baseHeaders()的默认 UA 从magpie-plugin/0.0.0换成新增的OFFICIAL_UA(完整合法 Chrome UA);src/api.mjs的headersFor()同改。模板本身就在教坏值 —— 派生仓库照抄magpie-plugin/0.0.0的已有先例(alysis / monkeycode 都中过)src/tempmail-client.mjs:两处fetch补user-agentAGENTS.md:坑表新增第 38 条(403TM.00000001查 UA);README的「3. User-Agent 常常是硬校验」扩成四个小节(为什么会静默出事 / 宿主透传那一半 / 官方 UA 三条取法 / 判据);CHECKLIST.mdA 表加第 19 条tests/check-ua.test.mjs(11 项);npm run check:ua一条命令自查
v0.3.9
新增 src/catalog-union.mjs 与 scripts/app-icon.mjs:多目录模型合并 + 从客户端安装包取官方应用图标
src/catalog-union.mjs:catalogRows(认三种目录形状、嵌套model内层优先)/isChatLike(别名、补全、输出 ≤256、text-to-image挡在聊天列表外)/mergeCatalogs(主目录优先、补集补 id 与促销表、两份都读不到要抛)。起因是厂商的「客户端配置」更新慢、「控制台」那份带完整分角色元数据 —— 只读一份的后果不是报错,是插件里的模型比网页上少几个、倍率还是旧的scripts/app-icon.mjs:从 Windows 客户端 exe 的 PE 资源RT_ICON里取官方应用图标(16~256 多档),--data-uri直接出 magpie 的icon字段值。按资源树取而不是按 PNG 签名扫 —— 安装包里的界面插图也是 PNG,扫签名取到的会是插图;实测 WorkBuddy 5.9.3 取出的 256 档 sha256 与手工提取逐字节一致AGENTS.md:坑表新增第 36 条(卡片图标是圆的 —— magpie 画在圆角方框里,官网 favicon 常是正圆)与第 37 条(两份模型目录);第三节命令加app-icon.mjs;第五节模块表加一行,规模更新为 index 569 行 /src/28 文件 5,331 行 / 28 个测试tests/catalog-union.test.mjs(9 项)、tests/app-icon.test.mjs(4 项);两套逻辑已在MYCF711/magpie-workbuddy0.1.5 与Ghandi/workbuddy-pro的 PR !1 里跑过
v0.3.8
从当前真实启用的 magpie 插件回收通用协议:HTTP / OAuth Device / 流读取 / 签到 / live models / 缓存
- 新增
RECYCLING.md:以plugins.json为真源盘点 17 个实际启用项,记录版本、来源、已覆盖模块、择优理由与明确不回收的厂商业务 - 新增
src/http.mjs:统一错误响应、异构错误摘要、保守 401/403 判定与 Retry-After;新增src/status.mjs:只读 400/422 clone 的分类与安全 Response 改写 - 新增
src/credential.mjs:凭据读取、指纹、cached → metadata → shape 的种类识别与 uid;新增src/oauth-device.mjs:RFC 8628 设备码申请、轮询与刷新 - 新增
src/checkin.mjs:前后账单差集对账;新增src/stream-reader.mjs:空闲超时不丢在飞数据块,支持 abort / done / error 重放 src/models.mjs:新增稳定 slug/code 映射与同 id 元数据合并;src/openai-sse.mjs:不再折出无名 tool_call,整轮只有无名调用时给可重试 502src/store.mjs/src/invite.mjs:独立临时名、0600/0700、原子替换与厂商时区日键;邀请存储复用同一写原语src/quota.mjs:无 zone 时间支持显式 offset;src/usage-cache.mjs:新增 stale-while-revalidate;index.mjs:签到按账号 single-flightsrc/api.mjs:不再把任意 400/422 当模型 404,也不再把所有 403 当登录失效;全部新增与修改路径都有离线语义测试- 审查加固:流终态向所有等待者广播;设备轮询 deadline 覆盖在飞请求;usage/checkin 不再用可重名 accountId 作 key;补齐中文模型 401、400/422 的 503/504、reasoning-only 无名调用、partial capabilities、SWR failTTL 与 refresh-only OAuth 回归
v0.3.6
修复 Windows 上 publish-npm 的 spawn 失败:spawnSync("npm") 找不到 npm.cmd
publish-npm.mjs改用 shell 执行npm publish,Windows / Linux 都能跑;失败时打印r.error的错误码- 0.3.5 的 CI 幂等、GitHub Template 文档、派生 CI 严格化全部包含
v0.3.5
CI 发布同版本时按成功处理:npm 的 staged 窗口不再让 release workflow 假红
publish-npm.mjs:捕获 npm 输出;CI=true且报 E409 / previously staged 时 warning + exit 0;本地仍报错提示 bumpcreate.mjs:派生项目复用脚手架这份publish-npm.mjs(只替换PUBLISH_AS),不再各自维护一份- 保留 release.mjs / release.yml 的发布前守卫与
NPM_TOKEN缺失显式失败 - 支持 GitHub Template:README/GUIDE 写明「Use this template」与本地 create.mjs 的区别;create.mjs 把派生项目 ci.yml 的 action 自测从
template: "true"改为"false",不再替占位符放行
v0.3.4
发布刚完成时 npm view 还没刷新,workflow 仍会 E409;现在发布失败后再查一次,同版本已存在就按成功处理
release.yml:publish 非 0 后 sleep 5 再npm view;同版本已在 npm 则::warning+ exit 0,避免 staged 窗口误红- 保留「发布前先查、已存在直接跳过」与「NPM_TOKEN 缺失显式失败」