Merge pull request #8 from Arylo/feat/cloud-storage

feat(cloud-storage): add Cloudflare Worker-based cloud storage app

Author: Arylo

.claude/skills/commit/SKILL.md

@@ -21,9 +21,10 @@ user-invocable: true
 4. 检查当前 staged 变更。
 5. 如果没有 staged 变更，先将当前工作区改动加入暂存区。
 6. 如果 staged 或当前工作区改动中包含 `package.json` 或 `package-lock.json`，需要检查变更内容：
-   - 如果 `package-lock.json` 有修改 **或者** `package.json` 的 `dependencies` 或 `devDependencies` 部分有修改，必须先执行 `/linux-native-binding-repair`，确认不存在 Linux native binding、optionalDependencies 或 lockfile 跨平台漂移问题。
-   - 如果只有 `package.json` 的其他部分（如 scripts、workspaces 等）修改，且 `package-lock.json` 没有修改，则不需要执行 `/linux-native-binding-repair`。
+  - 如果 `package-lock.json` 有修改 **或者** `package.json` 的 `dependencies` 或 `devDependencies` 部分有修改，必须先执行 `/install-native-binding`。
+  - 如果只有 `package.json` 的其他部分（如 scripts、workspaces 等）修改，且 `package-lock.json` 没有修改，则不需要执行 `/install-native-binding`。
 7. 基于暂存区差异生成 commit message，格式必须是 `<type>(<scope>): <subject>`。
+  - 如果 staged 文件数量 **> 8**，在 subject 行之后追加 commit message body，列出各核心改动摘要（每行一条，格式 `- <summary>`）。
 8. 如果用户传入参数，将其作为 subject，仍需自动补全 type 和 scope。
 9. 执行 git 提交。
 10. 返回以下结果：

.claude/skills/install-native-binding/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: install-native-binding
+description: '安装 npm 依赖并确保 Linux native binding 正确生成。在非 Linux 系统上通过 docker/podman 以 linux/amd64 容器执行安装，保证 lockfile 中包含跨平台 native binding。Use when installing dependencies, fixing missing native bindings, or syncing package-lock.json for Linux environments.'
+user-invocable: true
+---
+
+# Install Native Binding Skill
+
+## 适用场景
+
+- 安装/更新 npm 依赖后需要确保 Linux native binding 正确写入 lockfile
+- 在 macOS / Windows 开发机上需要为 Linux 生产环境生成正确的 lockfile
+- CI 报告缺少 native binding 或 optionalDependencies 平台条目
+
+## 执行步骤
+
+### 1. 检测当前操作系统
+
+运行 `uname -s` 获取系统类型。
+
+- 若输出为 `Linux`，进入**步骤 2（Linux 路径）**。
+- 否则（macOS、Windows 等），进入**步骤 3（非 Linux 路径）**。
+
+### 2. Linux 路径
+
+直接在当前环境运行：
+
+```bash
+npm i --include-workspace-root --workspaces
+```
+
+完成后跳至**步骤 5**。
+
+### 3. 非 Linux 路径 —— 检测容器运行时
+
+依次检查以下命令是否可用：
+
+```bash
+command -v docker
+command -v podman
+```
+
+- 若两者均不可用，**停止执行**，告知用户需要安装 Docker 或 Podman 后重试。
+- 优先使用 `docker`；若 `docker` 不可用则使用 `podman`（以下统称 `<runtime>`）。
+
+### 4. 非 Linux 路径 —— 读取 Node 版本并在容器中安装
+
+#### 4a. 读取 Node 版本
+
+读取仓库根目录的 `.nvmrc` 文件，获取版本号（去掉前缀 `v`），作为镜像 tag。
+
+例如 `.nvmrc` 内容为 `v24.12.0`，则镜像为 `node:24.12.0`。
+
+#### 4b. 在容器中执行安装
+
+```bash
+<runtime> run --rm --platform linux/amd64 \
+  -v "$PWD":/src \
+  --tmpfs /src/node_modules:exec \
+  node:<version> \
+  bash -lc 'cd /src && npm i --include-workspace-root --workspaces'
+```
+
+- 挂载当前工作目录为 `/src`（读写，不加 `:ro`），使安装结果（`node_modules`、`package-lock.json`）直接写回宿主机。
+- `--tmpfs /src/node_modules:exec` 将容器内的根 `node_modules` 挂载为内存文件系统，避免宿主机的 `node_modules` 被覆盖，同时加速安装；`:exec` 允许 postinstall 脚本执行二进制文件（Docker tmpfs 默认带 `noexec`）。
+- `--platform linux/amd64` 确保 native binding 以 Linux x64 平台编译/下载。
+
+## 约束
+
+- 容器挂载目录为当前工作区根目录（即含 `package.json` 和 `package-lock.json` 的目录）
+- 不要在容器内部 `cp` 文件；直接挂载读写以避免权限问题
+- Node 镜像版本必须严格来自 `.nvmrc`，不得硬编码或猜测

.claude/skills/linux-native-binding-repair/SKILL.md

@@ -30,7 +30,7 @@ jobs:
           cache-dependency-path: package-lock.json
 
       - name: Install dependencies
-        run: npm ci -ws --include-workspace-root
+        run: npm ci --workspaces --include-workspace-root
 
       - name: Lint
         run: npm run lint

.github/workflows/caddyfile_sdk.yml

@@ -0,0 +1,48 @@
+name: Cloud Storage
+
+on:
+  push:
+    paths:
+      - apps/cf-worker/cloud-storage/**
+      - package.json
+      - package-lock.json
+      - tsconfig.json
+      - turbo.json
+  pull_request:
+    paths:
+      - apps/cf-worker/cloud-storage/**
+      - package.json
+      - package-lock.json
+      - tsconfig.json
+      - turbo.json
+
+jobs:
+  cloud-storage:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24.12.0
+          cache: npm
+          cache-dependency-path: package-lock.json
+
+      - name: Install dependencies
+        run: npm ci --workspaces --include-workspace-root
+
+      - name: Lint
+        run: npm run lint
+        env:
+          TURBO_FILTER: ./apps/cf-worker/cloud-storage
+
+      - name: Test
+        run: npm run test
+        env:
+          TURBO_FILTER: ./apps/cf-worker/cloud-storage
+
+      - name: Build
+        run: npm run build --ignore-scripts
+        env:
+          TURBO_FILTER: ./apps/cf-worker/cloud-storage

.github/workflows/cloud_storage.yml

@@ -1,11 +1,25 @@
 {
-	"servers": {
-		"git": {
-			"command": "bash",
-			"args": [
-        "-c",
-        "(nvm -h || source $HOME/.nvm/nvm.sh) && (nvm use 20 || nvm install 20) && nvm exec 20 npx -y @cyanheads/git-mcp-server"
-			]
-		}
-	}
+  "servers": {
+    "git": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@cyanheads/git-mcp-server"
+      ]
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "chrome-devtools-mcp"
+      ]
+    },
+    "shadcn": {
+      "command": "npx",
+      "args": [
+        "shadcn@latest",
+        "mcp"
+      ]
+    }
+  }
 }

.vscode/mcp.json

@@ -1,8 +1,13 @@
 {
   "cSpell.words": [
-    "arylo"
+    "arylo",
+    "qinglong",
+    "syncpack"
   ],
   "files.associations": {
 		"wrangler.json": "jsonc"
-	}
+  },
+  "chat.tools.terminal.autoApprove": {
+    "command": true
+  }
 }

.vscode/settings.json

@@ -3,6 +3,6 @@
 ## Claude Skills
 
 - `/commit`：根据当前改动生成并执行规范化 Git 提交
-- `/linux-native-binding-repair`：排查并修复 Linux 环境下缺失的 native binding、optionalDependencies 和 package-lock 跨平台漂移问题
+- `/install-native-binding`：安装 npm 依赖并确保 Linux native binding 正确生成（非 Linux 系统自动通过 docker/podman 容器执行）
 
 以上能力已迁移到 `.claude/skills/`，按 Claude skill 方式维护与发现。

CLAUDE.md

@@ -46,9 +46,9 @@
   "devDependencies": {
     "concurrently": "^8.2.2",
     "oxfmt": "^0.35.0",
-    "oxlint": "^1.24.0",
-    "rimraf": "^6.0.1",
+    "oxlint": "^1.58.0",
+    "rimraf": "^6.1.3",
     "typescript": "~5.9.3",
-    "vitest": "^4.1.0"
+    "vitest": "^4.1.4"
   }
 }

apps/caddyfile-sdk/package.json

@@ -0,0 +1,8 @@
+{
+  "singleQuote": true,
+  "semi": false,
+  "sortImports": {
+    "newlinesBetween": false
+  },
+  "ignorePatterns": ["*.md", "dist/**", ".wrangler/**", "src/react-app/Components/**"]
+}