[intent:O1.7] feat: 添加 GitHub Actions CI + GitHub Pages 自动发布

XiaoLinXiaoZhu · XiaoLinXiaoZhu · commit bf9bc10e90cf · 2026-02-17T22:16:47.000+08:00
- 新增 .github/workflows/publish.yml：push 到 main 时自动构建并部署到 gh-pages
- 新增 scripts/manifest.ts：生成 sync-manifest.json 到 dist/
- ScriptConfigBase 新增 greasyforkId 字段
- build.ts 自动注入 downloadURL/updateURL（指向 GitHub Pages）
- bilibili-block 添加 greasyforkId: 467384
- package.json 新增 manifest 命令
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -0,0 +1,45 @@
+name: Build & Publish UserScripts
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'src/**'
+      - 'scripts/**'
+      - 'package.json'
+      - 'tsconfig.json'
+
+  # 允许手动触发
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - run: npm ci
+
+      - run: npm run typecheck
+
+      - run: npm run build
+
+      # 生成同步清单（供调试和 Webhook 使用）
+      - name: Generate sync manifest
+        run: npm run manifest
+
+      # 部署 dist/ 到 gh-pages 分支
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./dist
+          # 不保留历史，每次全量替换
+          keep_files: false
diff --git a/.roo/intent-tree.json b/.roo/intent-tree.json
@@ -14,7 +14,8 @@
 				"58d75c26-af08-4171-bce4-f2a2da01765c",
 				"44570a55-355b-45dd-90e8-2e4b92ad9246",
 				"94fde7ec-d937-44f9-9176-3327b82f874f",
-				"a401200a-d3d3-4609-97fe-e7ce0af87404"
+				"a401200a-d3d3-4609-97fe-e7ce0af87404",
+				"8a02e705-67eb-4539-8790-8a35d03bd5e7"
 			],
 			"codeBindings": [],
 			"createdBy": {
@@ -24,7 +25,7 @@
 			},
 			"modifiedBy": [],
 			"assumption": "用户明确要求统一仓库模式：每个脚本一个文件夹，TS 源码，构建输出单一 JS 文件。这是一个全新的目标。",
-			"maxChildIndex": 6
+			"maxChildIndex": 7
 		},
 		"d4dc577a-4604-4dbb-b024-27342f8c09e2": {
 			"id": "d4dc577a-4604-4dbb-b024-27342f8c09e2",
@@ -268,7 +269,9 @@
 			"content": "清理旧版根目录 JS 文件，扩展构建系统支持 plain/node 模式，迁移 Obsidian 和 hexo 项目",
 			"status": "in_progress",
 			"parentId": "9fcfb892-37ae-477e-a133-530b729caefd",
-			"childrenIds": [],
+			"childrenIds": [
+				"4a8fae30-29df-4b2f-b5d0-d76954b9ecce"
+			],
 			"codeBindings": [],
 			"createdBy": {
 				"taskId": "019c6bba-5c99-727e-937e-1531e1cf673e",
@@ -282,7 +285,88 @@
 					"action": "updated: content, status→in_progress"
 				}
 			],
-			"assumption": "用户要求清理旧脚本和扩展构建系统支持非 Greasyfork 模式，属于 G1 的延续。"
+			"assumption": "用户要求清理旧脚本和扩展构建系统支持非 Greasyfork 模式，属于 G1 的延续。",
+			"maxChildIndex": 1
+		},
+		"4a8fae30-29df-4b2f-b5d0-d76954b9ecce": {
+			"id": "4a8fae30-29df-4b2f-b5d0-d76954b9ecce",
+			"shortId": "I1.6.1",
+			"type": "impl",
+			"content": "feat: 清理旧文件，扩展构建系统支持 plain/node 模式，迁移 Obsidian 和 hexo 项目\n\n- 删除已迁移的旧版根目录 JS 文件和 betterIwara/\n- 删除旧版 Obsidian/ 和 hexo-image-redirect/ 目录\n- ScriptConfig 扩展为 discriminated union：userscript | plain | node\n- build.ts 按 mode 分发到不同构建函数\n- 新增 src/obsidian-cardview/（mode: plain，IIFE 无 header）\n- 新增 src/hexo-image-redirect/（mode: node，CJS + external cheerio）\n- 现有 7 个油猴脚本无需任何修改（向后兼容）",
+			"status": "done",
+			"parentId": "a401200a-d3d3-4609-97fe-e7ce0af87404",
+			"childrenIds": [],
+			"codeBindings": [
+				{
+					"commitHash": "aeff5111a436314c4c9b0edcc556be65e5b10649",
+					"commitMessage": "[intent:O1.6] feat: 清理旧文件，扩展构建系统支持 plain/node 模式，迁移 Obsidian 和 hexo 项目\n\n- 删除已迁移的旧版根目录 JS 文件和 betterIwara/\n- 删除旧版 Obsidian/ 和 hexo-image-redirect/ 目录\n- ScriptConfig 扩展为 discriminated union：userscript | plain | node\n- build.ts 按 mode 分发到不同构建函数\n- 新增 src/obsidian-cardview/（mode: plain，IIFE 无 header）\n- 新增 src/hexo-image-redirect/（mode: node，CJS + external cheerio）\n- 现有 7 个油猴脚本无需任何修改（向后兼容）",
+					"files": [
+						".gitignore",
+						".roo/intent-tree.json",
+						"AutoTool_DownloadASMR.user.js",
+						"\"HUST\\345\\215\\216\\344\\270\\255\\347\\247\\221\\346\\212\\200\\345\\244\\247\\345\\255\\246\\345\\206\\233\\347\\220\\206\\347\\272\\277\\344\\270\\212\\344\\275\\234\\344\\270\\232\\347\\256\\200\\346\\230\\223\\350\\207\\252\\345\\212\\250\\345\\241\\253\\345\\205\\205\\345\\212\\251\\346\\211\\213.user.js\"",
+						"Obsidian/old-cardview.js",
+						"autoclick.js",
+						"betterIwara/betterIwara.js",
+						"hexo-image-redirect/LICENSE",
+						"hexo-image-redirect/README.md",
+						"hexo-image-redirect/index.js",
+						"hexo-image-redirect/package.json",
+						"scripts/build.ts",
+						"src/hexo-image-redirect/index.ts",
+						"src/hexo-image-redirect/meta.ts",
+						"src/hexo-image-redirect/package.json",
+						"Obsidian/cardview.js => src/obsidian-cardview/index.ts",
+						"src/obsidian-cardview/meta.ts",
+						"src/shared/types.ts",
+						"\"\\345\\212\\250\\347\\224\\273\\347\\226\\257\\350\\207\\252\\345\\212\\250\\350\\204\\232\\346\\234\\254.js\"",
+						"\"\\345\\261\\217\\350\\224\\275B\\347\\253\\231\\350\\220\\245\\351\\224\\200\\350\\247\\206\\351\\242\\221\\345\\222\\214\\346\\216\\250\\345\\271\\277\\350\\247\\206\\351\\242\\221.js\"",
+						"\"\\350\\257\\204\\344\\273\\267\\350\\241\\250\\350\\207\\252\\345\\212\\250\\351\\200\\211\\346\\213\\251.user.js\""
+					],
+					"diffSummary": "21 file(s), +553 -1913",
+					"timestamp": "2026-02-17T13:58:44.119Z"
+				}
+			],
+			"createdBy": {
+				"taskId": "019c6bba-5c99-727e-937e-1531e1cf673e",
+				"timestamp": "2026-02-17T13:58:44.119Z",
+				"action": "created"
+			},
+			"modifiedBy": [
+				{
+					"taskId": "019c6bba-5c99-727e-937e-1531e1cf673e",
+					"timestamp": "2026-02-17T13:58:44.119Z",
+					"action": "bound commit aeff511"
+				},
+				{
+					"taskId": "019c6bba-5c99-727e-937e-1531e1cf673e",
+					"timestamp": "2026-02-17T13:58:44.119Z",
+					"action": "updated: status→done"
+				}
+			]
+		},
+		"8a02e705-67eb-4539-8790-8a35d03bd5e7": {
+			"id": "8a02e705-67eb-4539-8790-8a35d03bd5e7",
+			"shortId": "O1.7",
+			"type": "objective",
+			"content": "配置 GitHub Actions + GitHub Pages 实现油猴脚本自动发布到 Greasyfork",
+			"status": "in_progress",
+			"parentId": "9fcfb892-37ae-477e-a133-530b729caefd",
+			"childrenIds": [],
+			"codeBindings": [],
+			"createdBy": {
+				"taskId": "019c6bba-5c99-727e-937e-1531e1cf673e",
+				"timestamp": "2026-02-17T14:11:32.703Z",
+				"action": "created"
+			},
+			"modifiedBy": [
+				{
+					"taskId": "019c6bba-5c99-727e-937e-1531e1cf673e",
+					"timestamp": "2026-02-17T14:11:40.082Z",
+					"action": "updated: content, status→in_progress"
+				}
+			],
+			"assumption": "用户希望自动发布到 Greasyfork，这是 G1 的延伸目标。"
 		}
 	},
 	"rootIds": [
@@ -296,7 +380,9 @@
 		"I1.3": "58d75c26-af08-4171-bce4-f2a2da01765c",
 		"I1.4": "44570a55-355b-45dd-90e8-2e4b92ad9246",
 		"I1.5": "94fde7ec-d937-44f9-9176-3327b82f874f",
-		"O1.6": "a401200a-d3d3-4609-97fe-e7ce0af87404"
+		"O1.6": "a401200a-d3d3-4609-97fe-e7ce0af87404",
+		"I1.6.1": "4a8fae30-29df-4b2f-b5d0-d76954b9ecce",
+		"O1.7": "8a02e705-67eb-4539-8790-8a35d03bd5e7"
 	},
 	"rootMaxChildIndex": 1
 }
diff --git a/package.json b/package.json
@@ -7,6 +7,7 @@
   "scripts": {
     "build": "tsx scripts/build.ts",
     "build:watch": "tsx scripts/build.ts --watch",
+    "manifest": "tsx scripts/manifest.ts",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist"
   },
diff --git a/scripts/build.ts b/scripts/build.ts
@@ -14,6 +14,10 @@ const SRC_DIR = path.resolve(import.meta.dirname, '..', 'src');
 const DIST_DIR = path.resolve(import.meta.dirname, '..', 'dist');
 const SKIP_DIRS = new Set(['shared']);
 
+// GitHub Pages base URL，用于自动注入 downloadURL/updateURL
+const PAGES_BASE_URL =
+  'https://xiaolinxiaozhu.github.io/JavaScriptTools';
+
 // ─── UserScript Header 生成 ───────────────────────────────────
 
 function generateHeader(meta: UserScriptMeta): string {
@@ -177,6 +181,11 @@ async function buildUserScript(entry: ScriptEntry): Promise<void> {
     return;
   }
 
+  // 自动注入 downloadURL/updateURL（如果未手动指定）
+  const fileUrl = `${PAGES_BASE_URL}/${config.category}/${outputName}.user.js`;
+  config.meta.downloadURL ??= fileUrl;
+  config.meta.updateURL ??= fileUrl;
+
   const header = generateHeader(config.meta);
 
   await esbuild.build({
diff --git a/scripts/manifest.ts b/scripts/manifest.ts
@@ -0,0 +1,123 @@
+/**
+ * 生成 sync-manifest.json 到 dist/ 目录
+ * 包含所有脚本的发布信息，供 CI 和调试使用
+ */
+import * as esbuild from 'esbuild';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import type { ScriptConfig, UserScriptConfig } from '../src/shared/types';
+
+const SRC_DIR = path.resolve(import.meta.dirname, '..', 'src');
+const DIST_DIR = path.resolve(import.meta.dirname, '..', 'dist');
+const SKIP_DIRS = new Set(['shared']);
+
+// GitHub Pages base URL（需要根据实际仓库名调整）
+const PAGES_BASE_URL =
+  'https://xiaolinxiaozhu.github.io/JavaScriptTools';
+
+interface ManifestEntry {
+  name: string;
+  mode: string;
+  category: string;
+  distPath: string;
+  pagesUrl: string;
+  version?: string;
+  greasyforkId?: number;
+  greasyforkUrl?: string;
+}
+
+async function loadMetaConfig(metaFile: string): Promise<ScriptConfig> {
+  const result = await esbuild.build({
+    entryPoints: [metaFile],
+    bundle: true,
+    format: 'esm',
+    platform: 'node',
+    write: false,
+    outdir: 'out',
+  });
+
+  const code = result.outputFiles[0].text;
+  const tmpFile = metaFile.replace(/\.ts$/, '.meta.tmp.mjs');
+  fs.writeFileSync(tmpFile, code);
+  try {
+    const mod = await import(pathToFileURL(tmpFile).href);
+    return mod.default as ScriptConfig;
+  } finally {
+    fs.unlinkSync(tmpFile);
+  }
+}
+
+async function main(): Promise<void> {
+  const manifest: ManifestEntry[] = [];
+  const dirs = fs.readdirSync(SRC_DIR, { withFileTypes: true });
+
+  for (const dirent of dirs) {
+    if (!dirent.isDirectory()) continue;
+    if (SKIP_DIRS.has(dirent.name)) continue;
+
+    const metaFile = path.join(SRC_DIR, dirent.name, 'meta.ts');
+    if (!fs.existsSync(metaFile)) continue;
+
+    const config = await loadMetaConfig(metaFile);
+    const mode = config.mode ?? 'userscript';
+    const outputName = config.outputName ?? dirent.name;
+
+    let distFile: string;
+    if (mode === 'userscript') {
+      distFile = `${config.category}/${outputName}.user.js`;
+    } else if (mode === 'node') {
+      const fmt = (config as { format?: string }).format ?? 'cjs';
+      const ext = fmt === 'esm' ? '.mjs' : '.js';
+      distFile = `${config.category}/${outputName}${ext}`;
+    } else {
+      const fmt = (config as { format?: string }).format ?? 'iife';
+      const ext = fmt === 'esm' ? '.mjs' : '.js';
+      distFile = `${config.category}/${outputName}${ext}`;
+    }
+
+    const entry: ManifestEntry = {
+      name: dirent.name,
+      mode,
+      category: config.category,
+      distPath: distFile,
+      pagesUrl: `${PAGES_BASE_URL}/${distFile}`,
+    };
+
+    if (mode === 'userscript') {
+      const usc = config as UserScriptConfig;
+      const meta = usc.meta;
+      entry.version =
+        typeof meta.version === 'string' ? meta.version : undefined;
+    }
+
+    if (config.greasyforkId) {
+      entry.greasyforkId = config.greasyforkId;
+      entry.greasyforkUrl = `https://greasyfork.org/scripts/${config.greasyforkId}`;
+    }
+
+    manifest.push(entry);
+  }
+
+  // 确保 dist 目录存在
+  if (!fs.existsSync(DIST_DIR)) {
+    fs.mkdirSync(DIST_DIR, { recursive: true });
+  }
+
+  const outputPath = path.join(DIST_DIR, 'sync-manifest.json');
+  fs.writeFileSync(outputPath, JSON.stringify(manifest, null, 2));
+  console.log(`📋 生成 sync-manifest.json（${manifest.length} 个脚本）`);
+
+  // 打印摘要
+  for (const entry of manifest) {
+    const gf = entry.greasyforkId
+      ? ` → GF#${entry.greasyforkId}`
+      : '';
+    console.log(`  ${entry.name} [${entry.mode}] ${entry.pagesUrl}${gf}`);
+  }
+}
+
+main().catch((err) => {
+  console.error('生成 manifest 失败:', err);
+  process.exit(1);
+});
diff --git a/src/bilibili-block/meta.ts b/src/bilibili-block/meta.ts
@@ -32,4 +32,5 @@ export default defineConfig({
       'https://update.greasyfork.org/scripts/467384/%F0%9F%9B%A0%EF%B8%8F%E5%B1%8F%E8%94%BDB%E7%AB%99%E8%90%A5%E9%94%80%E8%A7%86%E9%A2%91.meta.js',
   },
   category: 'bilibili',
+  greasyforkId: 467384,
 });
diff --git a/src/shared/types.ts b/src/shared/types.ts
@@ -39,6 +39,8 @@ interface ScriptConfigBase {
   outputName?: string;
   /** 入口文件路径（相对于脚本文件夹），默认 index.ts */
   entry?: string;
+  /** Greasyfork 脚本 ID，用于自动同步触发（仅 userscript 模式需要） */
+  greasyforkId?: number;
 }
 
 // ─── 油猴脚本模式（默认） ──────────────────────

Original file line number	Diff line number	Diff line change
`@@ -39,6 +39,8 @@ interface ScriptConfigBase {`
`39`	`39`	`outputName?: string;`
`40`	`40`	`/** 入口文件路径（相对于脚本文件夹），默认 index.ts */`
`41`	`41`	`entry?: string;`
	`42`	`+ /** Greasyfork 脚本 ID，用于自动同步触发（仅 userscript 模式需要） */`
	`43`	`+ greasyforkId?: number;`
`42`	`44`	`}`
`43`	`45`
`44`	`46`	`// ─── 油猴脚本模式（默认） ──────────────────────`