@liangjie559567/ultrapower 5.2.4 → 5.2.6

package/dist/installer/hooks.js

@@ -82,7 +82,9 @@ export function getHooksDir() {
  * Returns the appropriate syntax for the current platform.
  */
 export function getHomeEnvVar() {
-    return isWindows() ? "%USERPROFILE%" : "$HOME";
+    // On Windows, Claude Code runs hooks via bash (Git Bash / WSL).
+    // bash does NOT expand cmd.exe-style %USERPROFILE%, but DOES expand $USERPROFILE.
+    return isWindows() ? "$USERPROFILE" : "$HOME";
 }
 /**
  * Ultrawork message - injected when ultrawork/ulw keyword detected
@@ -295,10 +297,10 @@ export const HOOKS_SETTINGS_CONFIG_NODE = {
                 hooks: [
                     {
                         type: "command",
-                        // Note: On Windows, %USERPROFILE% is expanded by cmd.exe
-                        // On Unix with node hooks, $HOME is expanded by the shell
+                        // On Windows, Claude Code runs hooks via bash (Git Bash / WSL).
+                        // bash expands $USERPROFILE but NOT cmd.exe-style %USERPROFILE%.
                         command: isWindows()
-                            ? 'node "%USERPROFILE%\\.claude\\hooks\\keyword-detector.mjs"'
+                            ? 'node "$USERPROFILE/.claude/hooks/keyword-detector.mjs"'
                             : 'node "$HOME/.claude/hooks/keyword-detector.mjs"',
                     },
                 ],
@@ -310,7 +312,7 @@ export const HOOKS_SETTINGS_CONFIG_NODE = {
                     {
                         type: "command",
                         command: isWindows()
-                            ? 'node "%USERPROFILE%\\.claude\\hooks\\session-start.mjs"'
+                            ? 'node "$USERPROFILE/.claude/hooks/session-start.mjs"'
                             : 'node "$HOME/.claude/hooks/session-start.mjs"',
                     },
                 ],
@@ -322,7 +324,7 @@ export const HOOKS_SETTINGS_CONFIG_NODE = {
                     {
                         type: "command",
                         command: isWindows()
-                            ? 'node "%USERPROFILE%\\.claude\\hooks\\pre-tool-use.mjs"'
+                            ? 'node "$USERPROFILE/.claude/hooks/pre-tool-use.mjs"'
                             : 'node "$HOME/.claude/hooks/pre-tool-use.mjs"',
                     },
                 ],
@@ -334,7 +336,7 @@ export const HOOKS_SETTINGS_CONFIG_NODE = {
                     {
                         type: "command",
                         command: isWindows()
-                            ? 'node "%USERPROFILE%\\.claude\\hooks\\post-tool-use.mjs"'
+                            ? 'node "$USERPROFILE/.claude/hooks/post-tool-use.mjs"'
                             : 'node "$HOME/.claude/hooks/post-tool-use.mjs"',
                     },
                 ],
@@ -346,7 +348,7 @@ export const HOOKS_SETTINGS_CONFIG_NODE = {
                     {
                         type: "command",
                         command: isWindows()
-                            ? 'node "%USERPROFILE%\\.claude\\hooks\\post-tool-use-failure.mjs"'
+                            ? 'node "$USERPROFILE/.claude/hooks/post-tool-use-failure.mjs"'
                             : 'node "$HOME/.claude/hooks/post-tool-use-failure.mjs"',
                     },
                 ],
@@ -358,7 +360,7 @@ export const HOOKS_SETTINGS_CONFIG_NODE = {
                     {
                         type: "command",
                         command: isWindows()
-                            ? 'node "%USERPROFILE%\\.claude\\hooks\\persistent-mode.mjs"'
+                            ? 'node "$USERPROFILE/.claude/hooks/persistent-mode.mjs"'
                             : 'node "$HOME/.claude/hooks/persistent-mode.mjs"',
                     },
                 ],

package/dist/installer/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/installer/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/installer/hooks.ts"],"names":[],"mappings":"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"}

package/dist/lib/__tests__/plugin-registry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plugin-registry.test.d.ts.map

package/dist/lib/__tests__/plugin-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.test.d.ts","sourceRoot":"","sources":["../../../src/lib/__tests__/plugin-registry.test.ts"],"names":[],"mappings":""}

package/dist/lib/__tests__/plugin-registry.test.js

@@ -0,0 +1,241 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { existsSync, readFileSync } from 'fs';
+// Mock fs module
+vi.mock('fs', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        existsSync: vi.fn(),
+        readFileSync: vi.fn(),
+    };
+});
+// Mock atomic-write
+vi.mock('../atomic-write.js', () => ({
+    atomicWriteJsonSync: vi.fn(),
+    safeReadJson: vi.fn(),
+}));
+// Mock url module for import.meta.url
+vi.mock('url', async (importOriginal) => {
+    const actual = await importOriginal();
+    return {
+        ...actual,
+        fileURLToPath: vi.fn(() => '/mock/src/lib/plugin-registry.ts'),
+    };
+});
+import { syncPluginRegistry, checkVersionConsistency } from '../plugin-registry.js';
+import { atomicWriteJsonSync } from '../atomic-write.js';
+const mockExistsSync = vi.mocked(existsSync);
+const mockReadFileSync = vi.mocked(readFileSync);
+const mockAtomicWriteJsonSync = vi.mocked(atomicWriteJsonSync);
+const REGISTRY_PATH_SUFFIX = join('.claude', 'plugins', 'installed_plugins.json');
+import { join } from 'path';
+import { homedir } from 'os';
+const REGISTRY_PATH = join(homedir(), '.claude', 'plugins', 'installed_plugins.json');
+function makeRegistry(version, installPath = '/mock/install/path') {
+    return {
+        version: 2,
+        plugins: {
+            'ultrapower@ultrapower': [
+                {
+                    scope: 'user',
+                    installPath,
+                    version,
+                    installedAt: '2026-01-01T00:00:00.000Z',
+                    lastUpdated: '2026-01-01T00:00:00.000Z',
+                },
+            ],
+        },
+    };
+}
+describe('syncPluginRegistry', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('1. 正常更新：精确匹配 ultrapower@ultrapower，更新 version 和 lastUpdated，不修改 installPath', () => {
+        const registry = makeRegistry('5.0.0');
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify(registry));
+        const result = syncPluginRegistry({ newVersion: '5.1.0' });
+        expect(result.success).toBe(true);
+        expect(result.previousVersion).toBe('5.0.0');
+        expect(result.newVersion).toBe('5.1.0');
+        expect(mockAtomicWriteJsonSync).toHaveBeenCalledTimes(1);
+        const written = mockAtomicWriteJsonSync.mock.calls[0][1];
+        const entry = written.plugins['ultrapower@ultrapower'][0];
+        expect(entry.version).toBe('5.1.0');
+        expect(entry.installPath).toBe('/mock/install/path'); // installPath 未被修改
+        expect(entry.lastUpdated).not.toBe('2026-01-01T00:00:00.000Z'); // lastUpdated 已更新
+    });
+    it('2. 文件不存在：返回 { success: true, skipped: true }，不调用 atomicWriteJsonSync', () => {
+        mockExistsSync.mockReturnValue(false);
+        const result = syncPluginRegistry({ newVersion: '5.1.0' });
+        expect(result.success).toBe(true);
+        expect(result.skipped).toBe(true);
+        expect(mockAtomicWriteJsonSync).not.toHaveBeenCalled();
+    });
+    it('3. key 不存在：返回 { success: false, errors }，不调用 atomicWriteJsonSync', () => {
+        const registry = {
+            version: 2,
+            plugins: {
+                'other-plugin@other': [{ scope: 'user', installPath: '/x', version: '1.0.0', installedAt: '', lastUpdated: '' }],
+            },
+        };
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify(registry));
+        const result = syncPluginRegistry({ newVersion: '5.1.0' });
+        expect(result.success).toBe(false);
+        expect(result.errors).toBeDefined();
+        expect(result.errors[0]).toContain('not found');
+        expect(mockAtomicWriteJsonSync).not.toHaveBeenCalled();
+    });
+    it('4. 幂等性：连续调用两次，第二次 previousVersion === newVersion，lastUpdated 更新', () => {
+        const registry = makeRegistry('5.1.0');
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify(registry));
+        const result1 = syncPluginRegistry({ newVersion: '5.1.0' });
+        const result2 = syncPluginRegistry({ newVersion: '5.1.0' });
+        expect(result1.previousVersion).toBe('5.1.0');
+        expect(result2.previousVersion).toBe('5.1.0');
+        expect(mockAtomicWriteJsonSync).toHaveBeenCalledTimes(2);
+    });
+    it('5. skipIfProjectScoped=true：返回 { success: true, skipped: true }，不读取文件', () => {
+        const result = syncPluginRegistry({ newVersion: '5.1.0', skipIfProjectScoped: true });
+        expect(result.success).toBe(true);
+        expect(result.skipped).toBe(true);
+        expect(mockReadFileSync).not.toHaveBeenCalled();
+        expect(mockAtomicWriteJsonSync).not.toHaveBeenCalled();
+    });
+    it('6. 不匹配 fork key：不更新，返回 { success: false }', () => {
+        const registry = {
+            version: 2,
+            plugins: {
+                'ultrapower-fork@someuser': [
+                    { scope: 'user', installPath: '/x', version: '5.0.0', installedAt: '', lastUpdated: '' },
+                ],
+            },
+        };
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify(registry));
+        const result = syncPluginRegistry({ newVersion: '5.1.0' });
+        expect(result.success).toBe(false);
+        expect(mockAtomicWriteJsonSync).not.toHaveBeenCalled();
+    });
+    it('7. atomicWriteJsonSync 抛出异常：返回 { success: false, errors }', () => {
+        const registry = makeRegistry('5.0.0');
+        mockExistsSync.mockReturnValue(true);
+        mockReadFileSync.mockReturnValue(JSON.stringify(registry));
+        mockAtomicWriteJsonSync.mockImplementation(() => { throw new Error('disk full'); });
+        const result = syncPluginRegistry({ newVersion: '5.1.0' });
+        expect(result.success).toBe(false);
+        expect(result.errors).toBeDefined();
+        expect(result.errors[0]).toContain('disk full');
+    });
+});
+describe('checkVersionConsistency', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    function setupMocks(opts) {
+        const { registryVersion = '5.1.0', versionMetadataVersion = '5.1.0', packageJsonVersion = '5.1.0' } = opts;
+        mockExistsSync.mockImplementation((p) => {
+            const path = String(p);
+            if (path.endsWith('installed_plugins.json'))
+                return registryVersion !== null;
+            if (path.includes('version.json'))
+                return versionMetadataVersion !== null;
+            if (path.endsWith('package.json'))
+                return true;
+            return false;
+        });
+        mockReadFileSync.mockImplementation((p) => {
+            const path = String(p);
+            if (path.endsWith('installed_plugins.json') && registryVersion !== null) {
+                return JSON.stringify(makeRegistry(registryVersion));
+            }
+            if (path.includes('version.json') && versionMetadataVersion !== null) {
+                return JSON.stringify({ version: versionMetadataVersion });
+            }
+            if (path.endsWith('package.json')) {
+                return JSON.stringify({ name: 'ultrapower', version: packageJsonVersion });
+            }
+            throw new Error(`ENOENT: ${path}`);
+        });
+    }
+    it('8. 三源一致：返回 { consistent: true, discrepancies: [] }', () => {
+        setupMocks({ registryVersion: '5.1.0', versionMetadataVersion: '5.1.0', packageJsonVersion: '5.1.0' });
+        const report = checkVersionConsistency();
+        expect(report.consistent).toBe(true);
+        expect(report.discrepancies).toHaveLength(0);
+        expect(report.fixCommand).toBeUndefined();
+    });
+    it('9. registryVersion 落后：discrepancies 非空，fixCommand 非空', () => {
+        setupMocks({ registryVersion: '5.0.0', versionMetadataVersion: '5.1.0', packageJsonVersion: '5.1.0' });
+        const report = checkVersionConsistency();
+        expect(report.consistent).toBe(false);
+        expect(report.discrepancies.length).toBeGreaterThan(0);
+        expect(report.fixCommand).toBeDefined();
+        expect(report.registryVersion).toBe('5.0.0');
+    });
+    it('10. versionMetadataVersion 为 null（文件不存在）：consistent: false', () => {
+        setupMocks({ registryVersion: '5.1.0', versionMetadataVersion: null, packageJsonVersion: '5.1.0' });
+        const report = checkVersionConsistency();
+        expect(report.consistent).toBe(false);
+        expect(report.versionMetadataVersion).toBeNull();
+    });
+    it('11. isUpdating: registryVersion 与 packageJsonVersion 不同时为 true', () => {
+        setupMocks({ registryVersion: '5.0.0', versionMetadataVersion: '5.1.0', packageJsonVersion: '5.1.0' });
+        const report = checkVersionConsistency();
+        expect(report.isUpdating).toBe(true);
+    });
+    it('12. 多条目数组：使用第 0 项', () => {
+        const multiEntryRegistry = {
+            version: 2,
+            plugins: {
+                'ultrapower@ultrapower': [
+                    { scope: 'user', installPath: '/a', version: '5.1.0', installedAt: '', lastUpdated: '' },
+                    { scope: 'user', installPath: '/b', version: '4.0.0', installedAt: '', lastUpdated: '' },
+                ],
+            },
+        };
+        mockExistsSync.mockImplementation((p) => {
+            const path = String(p);
+            if (path.endsWith('installed_plugins.json'))
+                return true;
+            if (path.endsWith('package.json'))
+                return true;
+            return false;
+        });
+        mockReadFileSync.mockImplementation((p) => {
+            const path = String(p);
+            if (path.endsWith('installed_plugins.json'))
+                return JSON.stringify(multiEntryRegistry);
+            if (path.endsWith('package.json'))
+                return JSON.stringify({ name: 'ultrapower', version: '5.1.0' });
+            throw new Error(`ENOENT: ${path}`);
+        });
+        const report = checkVersionConsistency();
+        expect(report.registryVersion).toBe('5.1.0');
+    });
+    it('13. 空数组：registryVersion 为 null', () => {
+        const emptyRegistry = { version: 2, plugins: { 'ultrapower@ultrapower': [] } };
+        mockExistsSync.mockImplementation((p) => {
+            const path = String(p);
+            if (path.endsWith('installed_plugins.json'))
+                return true;
+            if (path.endsWith('package.json'))
+                return true;
+            return false;
+        });
+        mockReadFileSync.mockImplementation((p) => {
+            const path = String(p);
+            if (path.endsWith('installed_plugins.json'))
+                return JSON.stringify(emptyRegistry);
+            if (path.endsWith('package.json'))
+                return JSON.stringify({ name: 'ultrapower', version: '5.1.0' });
+            throw new Error(`ENOENT: ${path}`);
+        });
+        const report = checkVersionConsistency();
+        expect(report.registryVersion).toBeNull();
+    });
+});
+//# sourceMappingURL=plugin-registry.test.js.map

package/dist/lib/__tests__/plugin-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.test.js","sourceRoot":"","sources":["../../../src/lib/__tests__/plugin-registry.test.ts"],"names":[],"mappings":"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"}

package/docs/CLAUDE.md

@@ -1,5 +1,5 @@
 <!-- OMC:START -->
-<!-- OMC:VERSION:5.2.4 -->
+<!-- OMC:VERSION:5.2.5 -->
 # ultrapower - Multi-Agent Orchestration 智能多 Agent 编排
 
 你正在使用 ultrapower（OMC），这是 Claude Code 的多 agent 编排层。

package/docs/plans/2026-02-27-release-cicd-pipeline-design.md

@@ -0,0 +1,265 @@
+# 插件发布 CI/CD 流水线设计
+
+**日期**：2026-02-27
+**状态**：已批准
+**方案**：C（GitHub Actions 主导 + 本地脚本备用，共享核心逻辑）
+
+---
+
+## 1. 背景与目标
+
+### 问题陈述
+
+当前 ultrapower 发布流程依赖手动执行 `skills/release/SKILL.md` 中的步骤：
+- 手动更新版本号（多个文件）
+- 手动运行 `npm publish`
+- 手动创建 GitHub Release
+- 手动更新 `marketplace.json`
+
+这导致：
+- 发布步骤容易遗漏（如 REFERENCE.md 双重数量声明 — k-047）
+- 发布者机器环境依赖（NPM_TOKEN 本地配置）
+- 无法并行执行独立步骤
+
+### 目标
+
+从 `git tag v*` 推送到完整发布，全自动化，同时保留本地执行能力用于调试和紧急发布。
+
+---
+
+## 2. 架构概览
+
+```
+发布触发
+  └── git tag v5.3.0 && git push --tags
+        │
+        ├── GitHub Actions（主路径）
+        │     .github/workflows/release.yml
+        │     └── 调用 scripts/release-steps.mjs
+        │
+        └── 本地脚本（备用路径）
+              scripts/release-local.mjs
+              └── 调用 scripts/release-steps.mjs
+
+共享核心
+  scripts/release-steps.mjs
+    ├── validateBuild()
+    ├── publishNpm()
+    ├── createGithubRelease()
+    └── syncMarketplace()
+```
+
+### 文件变更清单
+
+| 操作 | 文件 | 说明 |
+|------|------|------|
+| 新增 | `.github/workflows/release.yml` | GitHub Actions 主流程 |
+| 新增 | `scripts/release-steps.mjs` | 共享核心逻辑 |
+| 新增 | `scripts/release-local.mjs` | 本地执行入口 |
+| 修改 | `skills/release/SKILL.md` | 更新：说明 CI 接管后续步骤 |
+| 修改 | `package.json` | 新增 `release:local` / `release:dry-run` scripts |
+
+---
+
+## 3. 共享核心：`scripts/release-steps.mjs`
+
+### 接口设计
+
+```javascript
+/**
+ * 步骤 1：构建验证
+ * 执行 tsc --noEmit && npm run build && npm test
+ */
+export async function validateBuild(opts = {})
+// opts: { skipTests?: boolean }
+// 返回: { success: boolean, output: string }
+
+/**
+ * 步骤 2：npm 发布
+ * 执行 npm publish --access public
+ */
+export async function publishNpm(opts = {})
+// opts: { dryRun?: boolean, tag?: string }
+// 返回: { success: boolean, version: string }
+
+/**
+ * 步骤 3：GitHub Release 创建
+ * 执行 gh release create v{version} --generate-notes
+ */
+export async function createGithubRelease(opts = {})
+// opts: { version: string, notes?: string, dryRun?: boolean }
+// 返回: { success: boolean, url: string }
+
+/**
+ * 步骤 4：市场版本同步
+ * 更新 .claude-plugin/marketplace.json version 字段 + git commit + push
+ */
+export async function syncMarketplace(opts = {})
+// opts: { version: string, dryRun?: boolean }
+// 返回: { success: boolean }
+
+/**
+ * 完整流水线（顺序执行全部 4 步）
+ */
+export async function runReleasePipeline(opts = {})
+// opts: {
+//   dryRun?: boolean,
+//   skipTests?: boolean,
+//   startFrom?: 'validate' | 'publish' | 'release' | 'sync'
+// }
+// 任一步骤失败则停止并以非零退出码退出
+```
+
+### 错误处理原则
+
+- 每步失败输出明确错误信息（步骤名 + 错误内容 + 建议操作）
+- 支持 `--start-from` 从失败步骤重试（跳过已完成步骤）
+- dry-run 模式：打印将执行的命令，不实际执行
+
+---
+
+## 4. GitHub Actions Workflow
+
+### 触发条件
+
+```yaml
+on:
+  push:
+    tags:
+      - 'v*'
+```
+
+### Job 依赖图
+
+```
+build-test
+    │
+    └── publish
+          │
+          ├── github-release
+          └── marketplace-sync
+```
+
+- `build-test` → `publish`：串行（确保验证通过才发布）
+- `publish` → `github-release`：串行（确保 npm 包存在才创建 Release）
+- `publish` → `marketplace-sync`：并行（与 github-release 独立）
+
+### Secrets 需求
+
+| Secret | 用途 | 配置位置 |
+|--------|------|---------|
+| `NPM_TOKEN` | npm publish 权限 | GitHub repo Settings → Secrets |
+| `GITHUB_TOKEN` | GitHub Release 创建 | Actions 内置，无需手动配置 |
+
+### 关键配置
+
+```yaml
+jobs:
+  build-test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+      - run: npm ci
+      - run: node scripts/release-steps.mjs validate
+
+  publish:
+    needs: build-test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      - run: npm ci
+      - run: node scripts/release-steps.mjs publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+  github-release:
+    needs: publish
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: node scripts/release-steps.mjs release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  marketplace-sync:
+    needs: publish
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+      - run: node scripts/release-steps.mjs sync
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+```
+
+---
+
+## 5. 本地脚本
+
+### `scripts/release-local.mjs`
+
+```javascript
+// 用法:
+//   node scripts/release-local.mjs
+//   node scripts/release-local.mjs --dry-run
+//   node scripts/release-local.mjs --start-from=publish
+//   npm run release:local
+//   npm run release:dry-run
+```
+
+### `package.json` 新增 scripts
+
+```json
+{
+  "scripts": {
+    "release:local": "node scripts/release-local.mjs",
+    "release:dry-run": "node scripts/release-local.mjs --dry-run"
+  }
+}
+```
+
+---
+
+## 6. 与现有 Release Skill 的分工
+
+| 步骤 | 负责方 | 工具 |
+|------|--------|------|
+| 版本号更新（package.json、CHANGELOG、文档） | release skill（手动） | 编辑文件 |
+| git commit + tag + push | release skill（手动） | git |
+| npm publish | **GitHub Actions（自动）** | release-steps.mjs |
+| GitHub Release 创建 | **GitHub Actions（自动）** | release-steps.mjs |
+| marketplace.json 版本同步 | **GitHub Actions（自动）** | release-steps.mjs |
+
+**`skills/release/SKILL.md` 更新说明**：在"发布步骤"末尾添加：
+> 执行 `git push --tags` 后，GitHub Actions 自动接管后续步骤（npm 发布、GitHub Release、市场同步）。如需手动执行，运行 `npm run release:local`。
+
+---
+
+## 7. 测试策略
+
+| 测试类型 | 覆盖内容 |
+|---------|---------|
+| 单元测试 | `release-steps.mjs` 各函数（mock exec） |
+| dry-run 测试 | 验证 dry-run 模式不执行实际命令 |
+| 集成测试 | GitHub Actions workflow 语法验证（`actionlint`） |
+| 手动验证 | 首次发布时使用 `--dry-run` 预检 |
+
+---
+
+## 8. 风险与缓解
+
+| 风险 | 缓解措施 |
+|------|---------|
+| NPM_TOKEN 过期 | CI 失败时发邮件通知，本地脚本作为备用 |
+| marketplace-sync 提交冲突 | 使用 `git pull --rebase` 后再 push |
+| 版本号不一致 | validateBuild 步骤检查 package.json vs git tag 一致性 |
+| 网络超时 | 每步设置 timeout，失败后支持 `--start-from` 重试 |