qq-bot-roost 1.0.1 → 1.0.3

package/README.md

@@ -10,7 +10,7 @@
 <img src="https://img.shields.io/badge/dependencies-0-brightgreen" alt="零依赖">
 <img src="https://img.shields.io/badge/tests-771%20passed-brightgreen" alt="测试 771 项">
 <img src="https://img.shields.io/badge/plugins-JS%20%7C%20Python%20%7C%20Go%20%7C%20any-blue" alt="多语言插件">
-<img src="https://img.shields.io/badge/version-1.0.1-blueviolet" alt="版本 1.0.1">
+<img src="https://img.shields.io/badge/version-1.0.3-blueviolet" alt="版本 1.0.3">
 <img src="https://img.shields.io/badge/license-Non--Commercial-red" alt="禁止商用">
 <a href="https://github.com/tdcq9594/qq-bot-roost/actions"><img src="https://img.shields.io/github/actions/workflow/status/tdcq9594/qq-bot-roost/ci.yml?branch=master" alt="CI"></a>
 
@@ -80,6 +80,8 @@
 - **消息带四个字段**：`uin` / `groupUin` / `userAliases` / `groupAliases`。插件用 `ctx.identity` 只读视图查，绑定表由框架维护
 - 配套升级：`dsh-roost` 1.0.0（别名合并读取 + 账号迁移页）、`ai-chat` 4.4.1（透传字段）。**三个一起升**，少一个号码就传不到 DSH
 
+> **绑定完全自愿、非必需**：QQ 官方接口不提供 QQ号 / 群号，本项目不会以任何方式获取、推算或抓取；绑定表里的号码只来自用户本人主动提供，或由管理员依据本人提供的号码代为登记（应事先取得本人同意）。不绑定不影响机器人的任何功能，未绑定时行为与绑定能力上线前完全一致；绑定信息仅保存在本机 `identity.json`，可在面板「身份」页随时解绑或停用，不上传、不共享，也不用于「认人认群、找回旧记忆」以外的用途。请勿把提供号码设为加群、发言或使用机器人的条件，也不要替他人报号。
+
 **连接与容错**
 
 - **两种收事件方式**：WebSocket 长连接（本地默认）或 **Webhook 回调**（公网 / Serverless / 容器）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qq-bot-roost",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "type": "module",
   "description": "栖 Roost：零依赖的 QQ 官方机器人框架，填 AppID/AppSecret 即连，插件可写任意语言",
   "license": "SEE LICENSE IN LICENSE",

package/src/updater.js

@@ -337,6 +337,54 @@ function buildResult(cur, tag, extra = {}) {
 
 /* ---------------- 下载与解包 ---------------- */
 
+/**
+ * 从 Gitee 拉一份**指定版本**的代码。
+ *
+ * 为什么必须锁 tag：GitHub 那条路下的是 `archive/refs/tags/v<版本>.tar.gz`，
+ * 内容被版本号钉死；Gitee 这条路以前固定拉默认分支，两条路一个锁版本、
+ * 一个跟着分支漂移。结果就是「发版后又往 master 推了个提交」时，
+ * 先更新的用户算出的指纹对得上、后更新的用户全部失败。
+ *
+ * v1.0.1 就是这么挂的（2026-11-04）：tag d76e646 的指纹是 ed2ebca6，
+ * 而 22:24 又推了一个只改 docs 的 7c35106 到 master，指纹变成 822f67f6，
+ * 版本号却没动 —— 从那一刻起所有 Gitee 源的用户都无法更新。
+ *
+ * 回退只在「这个 ref 根本不存在」时发生（列清单 404 / 树是空的）：
+ * 作者漏推 tag 时仍然得能装上，能不能过指纹那一关由 `applyUpdate` 判。
+ * 文件级失败（451 内容审查之类）换 ref 也一样，直接抛。
+ *
+ * @param {object} rel checkUpdate 的返回值（要 `tag`）
+ * @param {string} destDir 目标目录，失败重试前会被清空
+ */
+async function fetchTagFromGitee(rel, destDir) {
+  const token = currentMirror().giteeToken;
+  const tag = String(rel?.tag ?? '').trim();
+
+  const candidates = [];
+  if (tag) candidates.push(tag);
+  const branch = rel?.giteeRef || (await detectGiteeRef(REPO));
+  if (!candidates.includes(branch)) candidates.push(branch);
+
+  let lastErr = null;
+  for (const ref of candidates) {
+    try {
+      await fetchGiteeTree({ repo: REPO, ref, destDir, only: GITEE_ONLY, token });
+      if (tag && ref !== tag) {
+        log.warn(`Gitee 上找不到 ${tag}，已退回分支 ${ref}（内容可能与指纹不一致）`);
+      }
+      return;
+    } catch (e) {
+      lastErr = e;
+      if (!/文件清单失败|没有文件/.test(e.message)) throw e;
+      log.warn(`Gitee ${ref} 拉不到：${e.message}`);
+      // 半截文件不能留着，下一个 ref 要在一片空地上拉
+      await fs.rm(destDir, { recursive: true, force: true }).catch(() => {});
+      await fs.mkdir(destDir, { recursive: true });
+    }
+  }
+  throw lastErr;
+}
+
 /**
  * 下载并解包到临时目录。
  *
@@ -349,20 +397,13 @@ function buildResult(cur, tag, extra = {}) {
  * auto 模式下 GitHub 失败会自动切 Gitee——用户选 auto 时这就是承诺。
  *
  * @param {string} tmpDir
- * @param {object} rel checkUpdate 的返回值（带 tarball / giteeRef）
+ * @param {object} rel checkUpdate 的返回值（带 tarball / tag / giteeRef）
  */
 async function downloadTo(tmpDir, rel) {
   const id = currentMirror().id;
-  const token = currentMirror().giteeToken;
 
   if (id === 'gitee') {
-    await fetchGiteeTree({
-      repo: REPO,
-      ref: rel.giteeRef ?? (await detectGiteeRef(REPO)),
-      destDir: tmpDir,
-      only: GITEE_ONLY,
-      token,
-    });
+    await fetchTagFromGitee(rel, tmpDir);
     return tmpDir;
   }
 
@@ -381,13 +422,7 @@ async function downloadTo(tmpDir, rel) {
     log.warn(`GitHub 下载失败（${e.message}），改用 Gitee 镜像`);
     // 清掉可能写了一半的残留，再整树重拉
     await fs.rm(tmpDir, { recursive: true, force: true }).catch(() => {});
-    await fetchGiteeTree({
-      repo: REPO,
-      ref: await detectGiteeRef(REPO),
-      destDir: tmpDir,
-      only: GITEE_ONLY,
-      token,
-    });
+    await fetchTagFromGitee(rel, tmpDir);
   }
   return tmpDir;
 }

package/web/index.html

@@ -1103,8 +1103,8 @@
     <div id="ppDash" class="pp-body" hidden></div>
     <div id="ppGroups" class="pp-body" hidden></div>
     <div class="modal-actions">
+      <button class="btn danger act-left" id="ppReset" title="把所有配置项恢复成插件声明的默认值">恢复默认</button>
       <button class="btn" id="ppClose">关闭</button>
-      <button class="btn danger" id="ppReset" title="把所有配置项恢复成插件声明的默认值">恢复默认</button>
       <button class="btn primary" id="ppSave">保存配置</button>
     </div>
   </div>

package/web/style.css

@@ -259,6 +259,15 @@ body {
   animation: modal-fade .12s ease-out;
 }
 .modal-mask[hidden] { display: none; }
+/*
+ * 通用确认弹窗（#modalMask）永远压在最上面。
+ *
+ * 四个 .modal-mask 都是 z-index:100，同层级时「DOM 里靠后的盖住靠前的」，
+ * 而 #modalMask 写在 index.html 最前面、插件设置面板在后面 ——
+ * 于是「保存配置」弹的「已保存」整个被插件设置面板挡住，看起来像点了没反应。
+ * 确认弹窗本身是「盖在别的弹窗上回答一个问题」的层，层级必须高人一等。
+ */
+#modalMask { z-index: 200; }
 .modal {
   width: min(420px, calc(100vw - 32px));
   background: var(--panel);
@@ -279,6 +288,14 @@ body {
 .modal-actions {
   display: flex; justify-content: flex-end; gap: 8px; margin-top: 18px;
 }
+/*
+ * 破坏性操作推到最左，右边只留「关闭 / 保存配置」。
+ *
+ * 原先三个按钮挤成一排右对齐，灰色的「关闭」在最左边、离蓝色的「保存配置」
+ * 隔着一个红色的「恢复默认」，用户看完配置直接就去点主按钮，找不到退出的地方。
+ * 把「恢复默认」单独甩到左边后，两个正常出口挨在一起，也顺手拉开了误点的距离。
+ */
+.modal-actions > .act-left { margin-right: auto; }
 @keyframes modal-fade { from { opacity: 0 } to { opacity: 1 } }
 @keyframes modal-pop { from { opacity: 0; transform: translateY(6px) scale(.98) } to { opacity: 1; transform: none } }