chore: 整理仓库结构，新增文档系统，bump 版本测试 webhook 同步

- 删除 ASMR/ 历史遗留文件夹
- 修复 autoclick/bilibili-block meta.ts 中的 downloadURL/updateURL（改为构建自动注入）
- 修正 bilibili-block greasyforkId: 467384 → 497929
- 新增 scripts/docs.ts 文档构建（README + changelog 拼接）
- 新增 CONTRIBUTING.md 开发指南
- 重写 readme.md（脚本列表 + 安装链接）
- 为每个脚本添加 README.md（基于 GreasyFork 现有描述）
- 所有脚本 version bump +0.0.1（测试 GreasyFork webhook 同步）

Author: XiaoLinXiaoZhu

ASMR/批量打开网站/openUrl.bat

@@ -0,0 +1,120 @@
+# 开发指南
+
+## 项目结构
+
+```
+├── src/                    # 脚本源码
+│   ├── {script-name}/      # 每个脚本一个文件夹
+│   │   ├── meta.ts         # 脚本配置（构建模式、UserScript header）
+│   │   ├── index.ts        # 入口文件
+│   │   ├── README.md       # 脚本说明（同步到 GreasyFork）
+│   │   └── changelog/      # 版本更新日志
+│   │       └── v1.0.md
+│   └── shared/             # 共享代码和类型定义
+├── scripts/                # 构建工具
+│   ├── build.ts            # 主构建脚本
+│   ├── docs.ts             # 文档生成
+│   └── manifest.ts         # 同步清单生成
+├── .github/workflows/      # CI/CD
+│   └── publish.yml         # 自动构建 + 部署到 GitHub Pages
+├── readme.md               # 项目说明（面向用户）
+└── CONTRIBUTING.md         # 本文件
+```
+
+## 添加新脚本
+
+1. 在 `src/` 下创建新文件夹（使用 kebab-case 命名）
+2. 创建 `meta.ts`，定义脚本配置：
+
+```ts
+import { defineConfig } from '../shared/define';
+
+export default defineConfig({
+  meta: {
+    name: '脚本名称',
+    namespace: 'https://github.com/XiaoLinXiaoZhu/JavaScriptTools',
+    version: '0.1',
+    description: '脚本描述',
+    author: 'XLXZ',
+    match: 'https://example.com/*',
+    grant: 'none',
+    license: 'MIT',
+  },
+  category: 'tools', // 决定 dist/{category}/ 输出路径
+});
+```
+
+3. 创建 `index.ts` 作为入口文件
+4. （可选）创建 `README.md` 和 `changelog/` 用于文档同步
+
+### 构建模式
+
+- `userscript`（默认）：油猴脚本，IIFE 格式 + UserScript header
+- `plain`：纯 JS 输出，无 header（适用于 Obsidian 等）
+- `node`：Node.js 模块，支持 external dependencies
+
+## 文档约定
+
+每个脚本可以有自己的文档，会在构建时生成并部署到 GitHub Pages，用于 GreasyFork 同步。
+
+### README.md
+
+脚本目录下的 `README.md` 支持 `{{changelog}}` 占位符，构建时会自动替换为 changelog 内容。
+
+### changelog/
+
+更新日志以独立 markdown 文件存放在 `changelog/` 文件夹下：
+
+```
+src/my-script/changelog/
+├── v1.2.md
+├── v1.1.md
+└── v1.0.md
+```
+
+每个文件内容格式：
+
+```markdown
+### v1.2
+
+- 新增了某功能
+- 修复了某 bug
+```
+
+构建时按版本号降序拼接，替换 README.md 中的 `{{changelog}}`。
+
+也支持使用单文件 `CHANGELOG.md` 替代文件夹方式。
+
+## 常用命令
+
+```bash
+npm run build          # 构建所有脚本到 dist/
+npm run build:watch    # 监听模式，修改后自动重建
+npm run typecheck      # TypeScript 类型检查
+npm run manifest       # 生成 sync-manifest.json
+npm run clean          # 清理 dist/
+```
+
+## 发布流程
+
+1. 修改脚本代码
+2. 在 `meta.ts` 中 bump `version` 字段
+3. 在 `changelog/` 下添加新版本的 `.md` 文件
+4. Push 到 `main` 分支
+5. CI 自动执行：typecheck → build → 部署到 gh-pages
+6. GitHub webhook 通知 GreasyFork → 自动同步更新
+
+### GreasyFork 同步配置
+
+每个发布到 GreasyFork 的脚本需要在 GreasyFork 后台设置：
+
+- **Sync URL**：`https://raw.githubusercontent.com/XiaoLinXiaoZhu/JavaScriptTools/gh-pages/{category}/{script-name}.user.js`
+- **附加信息 URL**：`https://raw.githubusercontent.com/XiaoLinXiaoZhu/JavaScriptTools/gh-pages/{category}/{script-name}.md`
+
+Webhook 已配置，push 到仓库后 GreasyFork 会即时同步。
+
+## URL 规则
+
+- **GitHub Pages**（用户安装）：`https://xiaolinxiaozhu.github.io/JavaScriptTools/{category}/{script-name}.user.js`
+- **Raw GitHub**（GreasyFork 同步）：`https://raw.githubusercontent.com/XiaoLinXiaoZhu/JavaScriptTools/gh-pages/{category}/{script-name}.user.js`
+- 构建系统会自动将 GitHub Pages URL 注入为 `@downloadURL` 和 `@updateURL`（无需手写）

ASMR/批量打开网站/urls.txt

@@ -1,47 +1,40 @@
-# 项目名称
-
-## 简介
-
-这是一个用于存放自己写的一些脚本的仓库，主要是用于存放自己写的一些油猴脚本，以及一些其他的脚本。主要语言为JavaScript。
-
-
-## 使用方法
-
-### 油猴脚本
-
-1. 首先，确保你的浏览器已经安装了油猴插件。你可以在浏览器的插件商店中搜索"油猴"，然后点击安装。
-
-2. 打开你想要安装油猴脚本的网页。
-
-3. 在浏览器的工具栏中，点击油猴插件的图标，打开油猴脚本管理界面。
-
-4. 在油猴脚本管理界面中，点击"新建脚本"按钮。
-
-5. 在弹出的编辑器中，粘贴你想要安装的油猴脚本代码。
-
-6. 点击保存按钮，保存脚本。
-
-7. 刷新你想要应用脚本的网页，脚本将会自动生效。
-
-现在，你已经成功安装了油猴脚本！享受它带来的便利吧！
-
-我的大部分油猴脚本都同时发布在了Greasy Fork上，你可以在这里找到它们，使用这个安装和更新会方便很多：[Greasy Fork](https://greasyfork.org/zh-CN/users/1211126-xiaolinxiaozhu)
-
-### npm 包
-
-这些工具是针对于 hexo 博客的图片重定向的，很抱歉，我不知道该如何将其发布到npm，所以不能直接使用npm安装，你可以直接下载源码，然后使用`npm install`安装依赖，然后使用`npm run build`构建，最后使用`npm link`将其链接到全局，这样你就可以在任何地方使用这些工具了。
-
-
-
-## 功能列表
-- HUST华中科技大学军理线上作业简易自动填充助手.user.js 用于华中科技大学军理线上作业的自动填充
-- AutoTool_DownloadASMR.user.js 用于下载ASMR网站的音频
-- 屏蔽B站营销视频和推广视频.js 用于屏蔽B站营销视频和推广视频
-- hexo-image-redirect 用于hexo博客的图片重定向(因为我不知到该如何将其发布到npm，所以只能放在这里了)
-
-
-## 许可证
-MIT许可证
-
-
-
+# JavaScriptTools
+
+个人脚本集合，主要是油猴脚本（UserScript），也包含一些 Obsidian 插件和 Node.js 工具。
+
+## 脚本列表
+
+### 油猴脚本
+
+| 脚本 | 说明 | 安装 |
+|------|------|------|
+| [屏蔽B站营销视频](src/bilibili-block/) | 屏蔽 B 站主页推荐的营销/推广视频卡片 | [GreasyFork](https://greasyfork.org/scripts/467384) \| [GitHub](https://xiaolinxiaozhu.github.io/JavaScriptTools/bilibili/bilibili-block.user.js) |
+| [ASMR 自动下载](src/asmr-download/) | 自动下载 ASMR 网站音频 | [GitHub](https://xiaolinxiaozhu.github.io/JavaScriptTools/tools/asmr-download.user.js) |
+| [AutoTool Download](src/autoclick/) | 匹配特殊内容并模拟点击下载 | [GitHub](https://xiaolinxiaozhu.github.io/JavaScriptTools/tools/autoclick.user.js) |
+| [动画疯自动脚本](src/bahamut-auto/) | 自动跳过广告、同意年龄确认 | [GitHub](https://xiaolinxiaozhu.github.io/JavaScriptTools/entertainment/bahamut-auto.user.js) |
+| [Better Iwara](src/better-iwara/) | Iwara 样式优化 | [GitHub](https://xiaolinxiaozhu.github.io/JavaScriptTools/entertainment/better-iwara.user.js) |
+| [评价表自动选择](src/evaluation-auto/) | 自动选择教学评价 | [GitHub](https://xiaolinxiaozhu.github.io/JavaScriptTools/campus/evaluation-auto.user.js) |
+| [HUST 军理自动填充](src/hust-autofill/) | 华科军理线上作业自动填充 | [GitHub](https://xiaolinxiaozhu.github.io/JavaScriptTools/campus/hust-autofill.user.js) |
+
+### 其他工具
+
+| 项目 | 说明 | 类型 |
+|------|------|------|
+| [Obsidian CardView](src/obsidian-cardview/) | Obsidian 卡片视图样式 | Plain JS |
+| [Hexo Image Redirect](src/hexo-image-redirect/) | Hexo 博客图片重定向 | Node.js 模块 |
+
+## 安装方式
+
+1. 安装浏览器扩展 [Tampermonkey](https://www.tampermonkey.net/)
+2. 点击上方表格中的安装链接，Tampermonkey 会自动弹出安装确认
+3. 脚本会通过 `@updateURL` 自动检查更新
+
+部分脚本同时发布在 [GreasyFork](https://greasyfork.org/zh-CN/users/1211126-xiaolinxiaozhu) 上。
+
+## 开发
+
+参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
+
+## 许可证
+
+MIT

ASMR/文件夹处理/combineFolder.bat

@@ -2,6 +2,7 @@ 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,
@@ -347,6 +348,17 @@ async function buildAll(entries: ScriptEntry[]): Promise<void> {
   }
 
   console.log(`\n✨ 全部构建完成！\n`);
+
+  // 生成脚本文档
+  console.log('📄 生成脚本文档...\n');
+  await processAllDocs(entries);
+}
+
+async function processAllDocs(entries: ScriptEntry[]): Promise<void> {
+  const { processScriptDocs } = await import('./docs');
+  for (const entry of entries) {
+    await processScriptDocs(entry.name, entry.dir, entry.config);
+  }
 }
 
 async function main(): Promise<void> {