magicrew-auth 0.3.29 → 0.3.30

package/AGENTS.md

@@ -73,6 +73,8 @@ curl -s "https://usemagpie.ai/api/latest?channel=stable" | grep -o '"version":"[
 | 20 | 邮箱验证码登录报「phone 字段是必须的」或「captcha 字段是必须的」 | 邮箱和手机是**两套端点**：发信 `/v4/user/send-email` vs `/send-sms`，换登录态 `/v4/user/login-email` vs `/login`；邮箱那条验证码字段叫 **`captcha`**（不是 `code`）。判据：往 `/v4/user/login` 发任何 type 都回「phone 字段是必须的」 | `src/captcha.mjs` 头 · CHANGELOG 0.3.28 |
 | 21 | 无头登录「旋转验证连试 4 张图都没过」，而这号本来就是自己的 | 先分清两件事：① **已注册的号服务端根本不出图**（`/captcha/generate` 对已注册账号直接回 `business_token`）—— 所以必须**先取图、再判识图模型**，一上来就 `if (!vision) throw` 会把这条免费通道堵死；② 识图模型 `max_tokens` 太小会把推理答案饿死（`workbuddy/deepseek-v4.1-flash` 给 400 → `content:null`，判官抓空串） | CHANGELOG 0.3.28 · `src/vision.mjs` |
 | 22 | 同一账号有的请求 200、有的 403 `token无效`（`retryable=false`），换个时间又好了 | key 有两条签发路径时 store 与 magpie 各存一把，**静态挑一把必有一半踩空**。0.3.29 起 `keyCandidates()` 把 store 两槽 + `auth.access` 逐把打 chat，命中的写回 store；全被拒才交 402 让 magpie 换号。判据：`GET /v1/models` 对死 key **放行**，逐把探活必须用 `/v1/chat/completions` | CHANGELOG 0.3.29 · `tests/key-failover.mjs` |
+| 23 | 插件列表里别人有「已自动更新」徽章，magicrew 没有 | magpie 只自动更新包名以 `@magpie-community/` 开头的包（`internal/plugin/updates.go` 的 `Official()` 硬编码前缀）；第三方 npm / git 源永远只提示。本插件用 `src/auto-maintenance.mjs` 复刻：读 `plugin-updates.json` 的 `waiting` → 调 `magpie plugin update` → 成功后补 `updated[]`（徽章读它）。判据：`plugin-updates.json` 的 waiting 有 `package:"Magicrew", git:true`；`findMagpieExe()` 能解析到 magpie 可执行文件。⚠ 更新后要重启 magpie 才加载新代码 | CHANGELOG 0.3.30 · `tests/auto-maintenance.mjs` |
+| 24 | 新装插件后没有任何签到记录，`plugin-checkin.json` 里没有 magicrew | magpie 的 `PluginCheckinOn()`：`pluginCheckins` 没有显式值时默认 **false**（只有 WorkBuddy / Trae / MiniMax / Qoder 有内置开关）。插件只能在加载时把 `settings.json` 的 `pluginCheckins[provider]` 补成 true —— **只在键不存在时补**，用户显式 false 不覆盖。判据：`settings.json` 的 `pluginCheckins` 有 `magicrew` / `magicrew-intl` 键 | CHANGELOG 0.3.30 · `src/auto-maintenance.mjs` |
 
 **坑 14 的两个附带判据**（都实测过）：
 

package/CHANGELOG.md

@@ -1,5 +1,64 @@
 # 更新记录
 
+## 0.3.30 — 2026-10-29
+
+**默认开启自动签到 · 插件自身自动更新**
+
+### 一、默认开启自动签到
+
+magpie 的插件签到开关 `pluginCheckins` 默认是**关**的：`PluginCheckinOn()`
+在没有显式值时只跟随厂商内置开关（WorkBuddy / Trae / MiniMax / Qoder），
+magicrew 没有内置开关，于是新装插件不会自动签到。
+
+插件加载时读 `~/.config/magpie/settings.json`：**只有这个 provider 从未被
+用户设置过**，才补一个 `pluginCheckins[provider] = true`。用户显式关掉的
+（false）绝不覆盖；settings.json 读不出来也不覆盖。config 钩子先补一次，
+usage 钩子再兜一次（防止 magpie 启动时把内存里的旧 settings 写回）。
+
+### 二、插件自身自动更新
+
+magpie 的自动更新只认 `@magpie-community/*`（源码 `internal/plugin/updates.go`
+的 `Official()` 硬编码这个前缀）—— 第三方插件无论 npm 源还是 git 源，都只会
+在插件列表里提示「有新提交」，等用户点更新。这就是为什么社区包（Qoder、
+CodeArts、商汤小浣熊、OpenCode Zen Free）有「已自动更新」徽章，而本插件没有。
+
+插件没法改 magpie 的判断，只能在插件侧复刻同一套机制：
+
+1. `config` 加载 15 秒后、以及每次签到成功后，读 magpie 写好的
+   `~/.config/magpie/plugin-updates.json`，看 `waiting` 里有没有
+   `package === "Magicrew" && git === true` 的自己；
+2. 有就调本机 magpie 的 CLI：`magpie plugin update`（进程树里找 magpie，
+   也可以用环境变量 `MAGPIE_EXE` 明示；找不到就记 `no-magpie-exe` 并放弃，
+   不伪造徽章）；
+3. CLI 成功退出（code 0）后，在 `plugin-updates.json` 的 `updated[]` 里补一条
+   `{package:"Magicrew", from, to, at}` —— magpie 的「已自动更新」徽章
+   （`plugin.LastUpdated()`）读的就是这个记录。
+
+节流：同一版本 6 小时内最多试一次；成功后按 `to` 版本记住不再重复。所有失败
+都只写状态文件，不影响签到/额度/登录。
+
+### 边界（必须知道）
+
+- `magpie plugin update` 是 CLI 进程内的 `plugin.Update()`，会重装**所有**
+  非路径插件；它不会重启正在运行的 magpie —— 更新文件后，下次启动 magpie
+  才会加载新代码。插件列表的「已自动更新」徽章会立即出现（读的是文件记录）。
+- 找不到 magpie 可执行文件时不会自动更新，也不会显示徽章；设 `MAGPIE_EXE`
+  可指定。
+- 这一步是插件对 magpie 的两个配置文件（settings.json / plugin-updates.json）
+  的读写 —— magpie 没有给插件提供这两个能力的 API（GUI API 只服务于它自己的
+  WebView，不是 TCP 端口）。写 settings 只在「该键不存在」时发生，且先备份为
+  `settings.json.bak-magicrew-auto`。
+
+### 验证
+
+- `tests/auto-maintenance.mjs` 20 条断言 0 失败：默认签到只补缺失、显式 false
+  不覆盖、坏 JSON 不覆盖；`pickSelfUpdate` 只认自己且只认 git；`noteUpdated`
+  去重/截断；`kick` 的 no-update / no-exe / throttled / done / dryRun / 成功
+- 本机真实 `plugin-updates.json` 的 dryRun：命中 `Magicrew 272b812 → 050b0f4`，
+  解析到 `E:\Downloads\magpie-windows-amd64.exe`；`ensureCheckinDefault` 对
+  `magicrew` / `magicrew-intl` 均返回 explicit:true（已是用户开着的，不改）
+- `magpie plugin list` CLI 正常（只读）
+
 ## 0.3.29 — 2026-10-29
 
 **同一账号多把 key 逐把试 · 全部被拒改 402 · 续期收敛到 key-store**

package/README.md

@@ -31,6 +31,8 @@
 - **积分耗尽自动换号** —— 上游用 HTTP 400 报「可用积分已不足」时，插件把它改写为语义正确的 **402 Payment Required**，magpie 会 rest 这个账号并继续问同 provider 的下一个账号 / 路由组的下一个成员
 - **登录一次管 30 天** —— 网页 JWT 顶 30 天，`mgw_` api_key 每 2 小时自续，refresh_token 每次续期时自滚
 - **新手奖励 8 项全自动** —— 国内站 8 项 500 积分全部拿得到；第 8 项（完成第一次 AI 工作）由插件替你发一条消息，花掉约 2 积分
+- **默认开启自动签到** —— 安装后自动把本 provider 的插件签到设为开（`pluginCheckins` 缺省时补 true；你手动关掉的不会被改回）
+- **自动更新** —— 复用 magpie 的插件更新机制：发现自己的新版本后调 `magpie plugin update`，并在成功后写「已自动更新」记录；更新完要重启一次 magpie 才会加载新代码
 - **邀请码自动滚** —— 第一次注册带作者的码，之后每次登录都记住「上一个登录账号」的码，拿到新的就覆盖旧的
 
 ---

package/docs/internals.md

@@ -852,6 +852,19 @@ store  槽 a    expires 2026-10-28T14:41:03.000Z   → 200
 已经推翻过：同账号相隔 67 秒签的两把同时有效；12 把逐把探活，403 全部对应
 `expiresAt` 已过。真正失效的是**手里那把过期了**，不是后来签的把它顶掉了。
 
+### 自动维护（0.3.30 起）
+
+插件有两个 magpie 没替它做的事，都在 `src/auto-maintenance.mjs`：
+
+| 能力 | magpie 的现状 | 插件怎么补 |
+|---|---|---|
+| 默认开启签到 | `PluginCheckinOn()`：`pluginCheckins` 无显式值时默认 **false**（只有 WorkBuddy / Trae / MiniMax / Qoder 有内置开关） | 插件加载时读 `~/.config/magpie/settings.json`，只在键不存在时补 true；用户显式 false 不覆盖 |
+| 插件自身自动更新 | `Official()` 只认 `@magpie-community/*`；第三方 git / npm 源只提示、不自动装 | 读 `plugin-updates.json` 的 `waiting`；有自己就调 `magpie plugin update`；成功后补 `updated[]`（「已自动更新」徽章读它） |
+
+⚠ GUI 的 `/api/...` 不在 gateway 端口 3425 上（那里是 `/v1`，`/api/plugins/updates`
+会回 `/v1` 的 404 文案）；插件拿不到桌面 WebView 的 API，所以只能走文件 + CLI。
+⚠ `magpie plugin update` 不重启运行中的 magpie：更新文件后要下次启动才加载新代码。
+
 ### checkin 现在做四件事（0.3.11 起）
 
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "magicrew-auth",
-  "version": "0.3.29",
+  "version": "0.3.30",
   "description": "超级麦吉 / MagiCrew for magpie and OpenCode — one package, two providers: letsmagic.cn (国内) and magicrew.ai (international). Password or web-JWT sign-in, the account's own live model list, points balance, newcomer rewards, invite codes.",
   "type": "module",
   "main": "./index.mjs",

package/src/auto-maintenance.mjs

@@ -0,0 +1,253 @@
+// 自动维护 —— 「默认开启签到」与「插件自身自动更新」
+//
+// 这两个能力本质上都踩在 magpie 的边界上，先把边界说清楚：
+//
+// ① 签到：magpie 的 `pluginCheckins`（设置 → 插件签到）**默认是关的**
+//    （`PluginCheckinOn()`：没有显式值时跟随厂商内置开关，magicrew 没有内置
+//    开关，于是 false）。插件没有官方 API 能声明的默认值，只能在插件加载时
+//    读 `~/.config/magpie/settings.json`：**只有这个 provider 从未被用户设置过**
+//    才补一个 true。用户显式关掉的，绝不覆盖。
+//
+// ② 自动更新：magpie 只对 `@magpie-community/*` 的包自动更新
+//    （`plugin.Official()` 硬编码这个前缀），git 源的第三方插件永远只提示、
+//    等用户点「更新」。我们不在那个 scope 里，所以只能由插件自己复刻这套
+//    机制：读 magpie 写好的 `plugin-updates.json`，确认「有我自己」之后调用
+//    magpie 的 CLI（`magpie plugin update`）——它会把插件目录更新到最新；
+//    成功后在 `plugin-updates.json` 的 `updated[]` 里补一条，magpie 的
+//    「已自动更新」徽章读的就是这个记录（`plugin.LastUpdated()`）。
+//
+// ⚠ 边界（都是实测/源码结论，别想当然）：
+//   · 插件进程拿不到 GUI 的 HTTP 端口 —— `MAGPIE_ADDR` 指向 3425，那是
+//     **gateway**（`/api/plugins/updates` 在那里会回 `/v1` 的 404 文案），
+//     GUI API 走的是桌面窗口自己的 WebView，不是 TCP 端口。
+//   · `magpie plugin update` 是 CLI 进程内的 `plugin.Update()`，会更新
+//     **所有** 非路径插件并重装；它不会重启正在运行的 magpie，所以更新后
+//     要等 magpie 下次启动才加载新代码。这是这个兜底能做到的极限。
+//   · 找不到 magpie 可执行文件时只记录 `no-magpie-exe`，不伪造徽章、不硬编码
+//     本机路径。可以设环境变量 `MAGPIE_EXE` 明示。
+//
+// 两个动作都是**尽力而为**：失败不抛、不拖慢签到/额度/登录。
+
+import { readFileSync, writeFileSync, renameSync, mkdirSync, existsSync, copyFileSync } from "node:fs"
+import { homedir } from "node:os"
+import { join, dirname, basename } from "node:path"
+import { execFileSync, spawn } from "node:child_process"
+
+const PKG_NAME = "Magicrew"
+const AUTO_DIR = () => join(homedir(), ".config", "magpie")
+const CACHE_DIR = () => join(homedir(), ".cache", "magpie")
+const THROTTLE_MS = 6 * 3600_000 // 同一次更新失败后，6 小时内不再试
+
+function readJson(path, fallback) {
+  try {
+    return JSON.parse(readFileSync(path, "utf8"))
+  } catch {
+    return fallback
+  }
+}
+
+/** 原子写：先写同目录临时文件再 rename，避免把 magpie 的 JSON 写半截 */
+function writeJsonAtomic(path, value, { backup = false } = {}) {
+  mkdirSync(dirname(path), { recursive: true })
+  if (backup && existsSync(path)) {
+    try {
+      writeFileSync(path + ".bak-magicrew-auto", readFileSync(path))
+    } catch {}
+  }
+  const tmp = `${path}.tmp-${process.pid}-${Date.now()}`
+  writeFileSync(tmp, JSON.stringify(value, null, 2) + "\n")
+  renameSync(tmp, path)
+}
+
+/** 这个 provider 的签到是否从未被用户设置过；是就补 true（并返回 changed） */
+export function ensureCheckinDefault(provider, { dir = AUTO_DIR() } = {}) {
+  const file = join(dir, "settings.json")
+  let s
+  if (existsSync(file)) {
+    s = readJson(file, null)
+    // 文件在但读不出来：绝不覆盖用户的设置
+    if (!s || typeof s !== "object" || Array.isArray(s)) return { changed: false, reason: "settings-unreadable" }
+  } else {
+    s = {}
+  }
+  const table = s.pluginCheckins && typeof s.pluginCheckins === "object" && !Array.isArray(s.pluginCheckins)
+    ? s.pluginCheckins
+    : {}
+  if (Object.hasOwn(table, provider)) return { changed: false, reason: "explicit", on: table[provider] === true }
+  s.pluginCheckins = { ...table, [provider]: true }
+  writeJsonAtomic(file, s, { backup: true })
+  return { changed: true, on: true }
+}
+
+/** magpie 的 waiting 里有没有「我自己」的新版本（git 源只有 commit，没有 npm version） */
+export function pickSelfUpdate(waiting, { pkg = PKG_NAME } = {}) {
+  if (!Array.isArray(waiting)) return null
+  return waiting.find((w) => w && w.package === pkg && w.git === true) || null
+}
+
+/** 补一条「自动更新记录」—— magpie 的「已自动更新」徽章读 plugin-updates.json 的 updated[] */
+export function noteUpdated(pkg, from, to, { dir = AUTO_DIR(), now = new Date() } = {}) {
+  const file = join(dir, "plugin-updates.json")
+  const u = readJson(file, null)
+  if (!u || typeof u !== "object" || Array.isArray(u)) return false
+  u.updated = Array.isArray(u.updated) ? u.updated : []
+  const last = u.updated[u.updated.length - 1]
+  // 同一次更新重复写会让徽章的计时一直刷新；24 小时内同 from/to 只记一次
+  if (last && last.package === pkg && last.from === from && last.to === to) {
+    const at = Date.parse(last.at)
+    if (Number.isFinite(at) && now.getTime() - at < 24 * 3600_000) return true
+  }
+  u.updated.push({ package: pkg, from, to, at: now.toISOString() })
+  if (u.updated.length > 20) u.updated = u.updated.slice(-20)
+  writeJsonAtomic(file, u, { backup: true })
+  return true
+}
+
+/** 自动更新的节流状态（每个站点一份） */
+export function readAutoState(site, { cacheDir = CACHE_DIR() } = {}) {
+  return readJson(join(cacheDir, `magicrew-auto-${site}.json`), {}) || {}
+}
+
+function writeAutoState(site, state, { cacheDir = CACHE_DIR() } = {}) {
+  try {
+    writeJsonAtomic(join(cacheDir, `magicrew-auto-${site}.json`), state)
+  } catch {}
+}
+
+/**
+ * 找本机 magpie 可执行文件。顺序：
+ *   1. 环境变量 MAGPIE_EXE（最可靠，给测试和自定义安装用）
+ *   2. 祖父进程：插件跑在 magpie-bun.exe 里，它的父进程就是 magpie 主程序
+ *   3. PATH 里的 magpie / magpie.exe / magpie-windows-amd64.exe
+ * 找不到返回 ""
+ */
+export function findMagpieExe({ env = process.env, ppid = process.ppid, platform = process.platform } = {}) {
+  const resolve = (p) => {
+    if (!p || !existsSync(p)) return ""
+    // magpie 的 `magpie.cmd` 只是同目录 exe 的包装（Settings 的 Command line
+    // 会生成它）；spawn 一个 .cmd 在 Windows 上还要 shell，直接解析到 exe。
+    if (/\.(cmd|bat)$/i.test(p)) {
+      for (const n of ["magpie-windows-amd64.exe", "magpie.exe"]) {
+        const q = join(dirname(p), n)
+        if (existsSync(q)) return q
+      }
+    }
+    return p
+  }
+  if (env.MAGPIE_EXE) {
+    const p = resolve(env.MAGPIE_EXE)
+    if (p) return p
+  }
+  const exists = (p) => !!resolve(p)
+  const tryExec = (cmd, args, timeout = 2500) => {
+    try {
+      return execFileSync(cmd, args, {
+        encoding: "utf8",
+        timeout,
+        windowsHide: true,
+        stdio: ["ignore", "pipe", "ignore"],
+      }).trim()
+    } catch {
+      return ""
+    }
+  }
+  if (platform === "win32") {
+    const ps = [
+      "$p = Get-CimInstance Win32_Process -Filter \"ProcessId=" + Number(ppid) + "\"",
+      "if ($p) { $q = Get-CimInstance Win32_Process -Filter \"ProcessId=$($p.ParentProcessId)\"; if ($q) { $q.ExecutablePath } }",
+    ].join("; ")
+    const out = tryExec("powershell.exe", ["-NoProfile", "-Command", ps])
+    // 只认名字里带 magpie 的进程 —— 测试/宿主不在 magpie 下时，
+    // 父进程可能是 bash / node，不能把它们的路径当 magpie
+    if (exists(out) && /magpie/i.test(basename(out))) return resolve(out)
+  } else {
+    const out = tryExec("ps", ["-p", String(ppid), "-o", "ppid="])
+    const grand = out.split(/\s+/)[0]
+    if (grand) {
+      const path = tryExec("ps", ["-p", grand, "-o", "comm="])
+      if (exists(path) && /magpie/i.test(basename(path))) return resolve(path)
+    }
+  }
+  for (const name of ["magpie-windows-amd64.exe", "magpie.exe", "magpie"]) {
+    const lines = tryExec(platform === "win32" ? "where.exe" : "which", [name], 1500).split(/\r?\n/)
+    for (const line of lines) {
+      const p = line.trim()
+      if (exists(p) && /magpie/i.test(basename(p))) return resolve(p)
+    }
+  }
+  return ""
+}
+
+/**
+ * 检查并（尽力）自动更新。
+ * @param {{id:string}} c 站点上下文（用 c.id 存节流状态）
+ * @param {{dir?:string, cacheDir?:string, pkg?:string, exe?:string, dryRun?:boolean, spawnFn?:Function}} opts
+ * @returns {Promise<object>} 结果只用于日志/测试，不抛
+ */
+export async function kick(c, opts = {}) {
+  const dir = opts.dir || AUTO_DIR()
+  const cacheDir = opts.cacheDir || CACHE_DIR()
+  const pkg = opts.pkg || PKG_NAME
+  try {
+    const updates = readJson(join(dir, "plugin-updates.json"), null)
+    const waiting = pickSelfUpdate(updates?.waiting, { pkg })
+    if (!waiting) return { skipped: "no-update" }
+
+    const state = readAutoState(c.id, { cacheDir })
+    const now = Date.now()
+    if (state.done && state.done.to === waiting.latest) return { skipped: "done" }
+    if (state.lastAttempt && state.latest === waiting.latest && now - state.lastAttempt < THROTTLE_MS) {
+      return { skipped: "throttled" }
+    }
+
+    const exe = opts.exe !== undefined ? opts.exe : findMagpieExe(opts)
+    if (!exe) {
+      writeAutoState(c.id, { ...state, lastAttempt: now, latest: waiting.latest, reason: "no-magpie-exe" }, { cacheDir })
+      return { skipped: "no-magpie-exe", waiting }
+    }
+    if (opts.dryRun) return { wouldRun: exe, waiting }
+
+    let child
+    try {
+      child = (opts.spawnFn || spawn)(exe, ["plugin", "update"], {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+        env: process.env,
+      })
+    } catch (e) {
+      writeAutoState(c.id, { ...state, lastAttempt: now, latest: waiting.latest, reason: String(e?.message ?? e) }, { cacheDir })
+      return { skipped: "spawn-failed", error: String(e?.message ?? e) }
+    }
+    child.on?.("exit", (code) => {
+      if (code === 0) {
+        noteUpdated(pkg, waiting.version, waiting.latest, { dir })
+        writeAutoState(c.id, {
+          ...state,
+          lastAttempt: now,
+          latest: waiting.latest,
+          done: { from: waiting.version, to: waiting.latest, at: new Date().toISOString() },
+        }, { cacheDir })
+      } else {
+        writeAutoState(c.id, { ...state, lastAttempt: now, latest: waiting.latest, reason: `exit-${code}` }, { cacheDir })
+      }
+    })
+    child.unref?.()
+    return { started: true, waiting }
+  } catch (e) {
+    return { skipped: "error", error: String(e?.message ?? e) }
+  }
+}
+
+/** 插件加载时的初始化：补默认签到 + 延迟检查更新（不阻塞 config） */
+export function initAutoMaintenance(c) {
+  try {
+    ensureCheckinDefault(c.PROVIDER)
+  } catch {}
+  try {
+    const t = setTimeout(() => {
+      kick(c).catch(() => {})
+    }, 15_000)
+    t.unref?.()
+  } catch {}
+}

package/src/hooks/checkin.mjs

@@ -8,6 +8,7 @@
 // 签到逻辑在独立模块里**按需加载**：它挂了，登录/模型/额度照常工作。
 
 import { rollInvite } from "../store.mjs"
+import { kick } from "../auto-maintenance.mjs"
 
 export function makeCheckin(c) {
   return async (getAuth) => {
@@ -20,7 +21,12 @@ export function makeCheckin(c) {
       // rollInvite 内部自带超时和 try/catch，失败不影响签到。
       await rollInvite(c.id, auth.jwt, auth.org, c.host)
       const { runCheckin } = await import("../tasks.mjs")
-      return await runCheckin({ ...auth, host: c.host })
+      const result = await runCheckin({ ...auth, host: c.host })
+      // 签到成功后再给自动更新一次机会（config 启动时已试过一次；
+      // 这里覆盖「magpie 长期不重启」的情况）。kick 自己有 6 小时节流，
+      // 且不阻塞签到结果。
+      kick(c).catch(() => {})
+      return result
     } catch (e) {
       return { outcome: "failed", message: String(e?.message ?? e) }
     }

package/src/hooks/config.mjs

@@ -5,13 +5,19 @@
 // ⚠ 三条不许改：
 //   · 用 ??= 不用 =，否则覆盖用户在 plugins.json 里手配的值
 //   · models 必须有内容 —— 未登录也要有，空表会让卡片显示 "0 models"
-//   · 不要在这里发网络请求：它是配置，不是钩子
+//   · 不要在这里发**业务**网络请求：它是配置，不是钩子（本地默认设置与
+//     延迟的自动维护见 src/auto-maintenance.mjs，失败不影响 config）
 
 import { SDK } from "../context.mjs"
 import { readSnapshot } from "../store.mjs"
+import { initAutoMaintenance } from "../auto-maintenance.mjs"
 
 export function makeConfig(c) {
   return async (cfg) => {
+    // 默认开启本 provider 的签到；并在后台检查插件自身更新。
+    // 两者都尽力而为，失败不影响 config（见 src/auto-maintenance.mjs 的边界说明）。
+    initAutoMaintenance(c)
+
     cfg.provider ??= {}
     cfg.provider[c.PROVIDER] ??= {
       name: c.SHORT,

package/src/hooks/usage.mjs

@@ -25,13 +25,23 @@
 // 宿主支持余额之前的临时协议，见 CHANGELOG 0.3.20。
 
 import { fetchPoints, SITES } from "../api.mjs"
+import { ensureCheckinDefault } from "../auto-maintenance.mjs"
 
 // 每日登录积分：国内 +200/天、国际 +50/天（实测，见 docs/internals.md）。
 // 今日批次的分母，只用于展示「今日还剩 / 今日额度」。
 const DAILY_LOGIN_GIFT = { cn: 200, intl: 50 }
 
 export function makeUsage(c) {
+  let ensuredCheckin = false
   return async (getAuth) => {
+    // config 已经补过默认签到；这里再兜一次 —— magpie 启动时可能先
+    // Save 了内存里的旧 settings，把 config 那次覆盖掉。只补「从未设置过」的。
+    if (!ensuredCheckin) {
+      ensuredCheckin = true
+      try {
+        ensureCheckinDefault(c.PROVIDER)
+      } catch {}
+    }
     const auth = await getAuth()
     if (!auth) return { error: "未登录", windows: [] }
     try {