feat: 添加贡献按钮，允许用户直接打开账号贡献上传页面，并增强相关逻辑与测试

tests/sidepanel-contribution-button.test.js

@@ -0,0 +1,127 @@
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const fs = require('node:fs');
+
+const sidepanelSource = fs.readFileSync('sidepanel/sidepanel.js', 'utf8');
+
+function extractFunction(name) {
+  const markers = [`async function ${name}(`, `function ${name}(`];
+  const start = markers
+    .map((marker) => sidepanelSource.indexOf(marker))
+    .find((index) => index >= 0);
+  if (start < 0) {
+    throw new Error(`missing function ${name}`);
+  }
+
+  let parenDepth = 0;
+  let signatureEnded = false;
+  let braceStart = -1;
+  for (let i = start; i < sidepanelSource.length; i += 1) {
+    const ch = sidepanelSource[i];
+    if (ch === '(') {
+      parenDepth += 1;
+    } else if (ch === ')') {
+      parenDepth -= 1;
+      if (parenDepth === 0) {
+        signatureEnded = true;
+      }
+    } else if (ch === '{' && signatureEnded) {
+      braceStart = i;
+      break;
+    }
+  }
+
+  let depth = 0;
+  let end = braceStart;
+  for (; end < sidepanelSource.length; end += 1) {
+    const ch = sidepanelSource[end];
+    if (ch === '{') depth += 1;
+    if (ch === '}') {
+      depth -= 1;
+      if (depth === 0) {
+        end += 1;
+        break;
+      }
+    }
+  }
+
+  return sidepanelSource.slice(start, end);
+}
+
+test('sidepanel html contains contribution button in header', () => {
+  const html = fs.readFileSync('sidepanel/sidepanel.html', 'utf8');
+  assert.match(html, /id="btn-contribution-mode"/);
+  assert.match(html, />贡献</);
+});
+
+test('openContributionUploadPage confirms then opens upload page in a new tab', async () => {
+  const bundle = [
+    extractFunction('openContributionUploadPage'),
+  ].join('\n');
+
+  const api = new Function(`
+const calls = [];
+const CONTRIBUTION_UPLOAD_URL = 'https://apikey.qzz.io/';
+function isContributionButtonLocked() {
+  return false;
+}
+async function openConfirmModal(options) {
+  calls.push({ type: 'confirm', options });
+  return true;
+}
+function openExternalUrl(url) {
+  calls.push({ type: 'open', url });
+}
+${bundle}
+return {
+  openContributionUploadPage,
+  getCalls() {
+    return calls;
+  },
+};
+`)();
+
+  const result = await api.openContributionUploadPage();
+  assert.equal(result, true);
+  assert.deepStrictEqual(api.getCalls(), [
+    {
+      type: 'confirm',
+      options: {
+        title: '账号贡献',
+        message: '确认打开账号贡献上传页面吗？',
+        confirmLabel: '前往上传',
+        confirmVariant: 'btn-primary',
+      },
+    },
+    {
+      type: 'open',
+      url: 'https://apikey.qzz.io/',
+    },
+  ]);
+});
+
+test('openContributionUploadPage blocks while flow is running', async () => {
+  const bundle = [
+    extractFunction('openContributionUploadPage'),
+  ].join('\n');
+
+  const api = new Function(`
+const CONTRIBUTION_UPLOAD_URL = 'https://apikey.qzz.io/';
+function isContributionButtonLocked() {
+  return true;
+}
+async function openConfirmModal() {
+  throw new Error('should not open modal');
+}
+function openExternalUrl() {
+  throw new Error('should not open url');
+}
+${bundle}
+return { openContributionUploadPage };
+`)();
+
+  await assert.rejects(
+    () => api.openContributionUploadPage(),
+    /当前流程运行中/
+  );
+});