aidevo 1.0.0-beta.1

package/dist/utils/tokens.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Token usage collection from AI tool session files.
+ *
+ * Currently supports: Claude Code
+ * Data source: ~/.claude/projects/{project-hash}/{session}.jsonl
+ */
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    totalTokens: number;
+}
+/**
+ * Collect token usage from Claude Code for the current project.
+ *
+ * @param projectRoot - Project root directory
+ * @param sinceTimestamp - Only count tokens after this ISO timestamp
+ * @returns Token usage, or null if Claude Code data not found
+ */
+export declare function collectClaudeTokens(projectRoot: string, sinceTimestamp?: string): TokenUsage | null;
+/**
+ * Collect token usage between two timestamps (for a specific task).
+ */
+export declare function collectClaudeTokensBetween(projectRoot: string, startTime: string, endTime: string): TokenUsage | null;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/utils/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB;AAsGD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,UAAU,GAAG,IAAI,CAQnB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,UAAU,GAAG,IAAI,CAuDnB"}

package/dist/utils/tokens.js

@@ -0,0 +1,173 @@
+/**
+ * Token usage collection from AI tool session files.
+ *
+ * Currently supports: Claude Code
+ * Data source: ~/.claude/projects/{project-hash}/{session}.jsonl
+ */
+import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { readFileSync, readdirSync, statSync, existsSync } from 'node:fs';
+/**
+ * Convert a project root path to Claude Code's project directory name.
+ * /Users/foo/my-project → -Users-foo-my-project
+ */
+function projectPathToClaudeDir(projectRoot) {
+    return projectRoot.replace(/\//g, '-');
+}
+/**
+ * Find the Claude Code project session directory.
+ */
+function getClaudeProjectDir(projectRoot) {
+    const claudeDir = resolve(homedir(), '.claude', 'projects');
+    if (!existsSync(claudeDir))
+        return null;
+    const dirName = projectPathToClaudeDir(projectRoot);
+    const fullPath = resolve(claudeDir, dirName);
+    if (!existsSync(fullPath))
+        return null;
+    return fullPath;
+}
+/**
+ * Find the most recently modified .jsonl session file in a Claude project dir.
+ */
+function findLatestSessionFile(projectDir) {
+    const files = readdirSync(projectDir)
+        .filter(f => f.endsWith('.jsonl'))
+        .map(f => ({
+        name: f,
+        path: resolve(projectDir, f),
+        mtime: statSync(resolve(projectDir, f)).mtimeMs,
+    }))
+        .sort((a, b) => b.mtime - a.mtime);
+    return files.length > 0 ? files[0].path : null;
+}
+/**
+ * Parse token usage from a Claude Code session .jsonl file.
+ *
+ * @param sessionFile - Path to the .jsonl file
+ * @param sinceTimestamp - Only count messages after this ISO timestamp (optional)
+ * @returns Accumulated token usage
+ */
+function parseSessionTokens(sessionFile, sinceTimestamp) {
+    const usage = {
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheCreationTokens: 0,
+        cacheReadTokens: 0,
+        totalTokens: 0,
+    };
+    const sinceMs = sinceTimestamp ? new Date(sinceTimestamp).getTime() : 0;
+    // Read file in chunks from the end if we have a timestamp filter
+    // For simplicity, read the whole file (session files are typically < 50MB)
+    let content;
+    try {
+        content = readFileSync(sessionFile, 'utf-8');
+    }
+    catch {
+        return usage;
+    }
+    const lines = content.split('\n');
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        // Only process assistant messages (they contain usage data)
+        if (entry.type !== 'assistant')
+            continue;
+        // Filter by timestamp if specified
+        if (sinceMs > 0 && entry.timestamp) {
+            const msgMs = new Date(entry.timestamp).getTime();
+            if (msgMs < sinceMs)
+                continue;
+        }
+        const msgUsage = entry.message?.usage;
+        if (!msgUsage)
+            continue;
+        usage.inputTokens += msgUsage.input_tokens || 0;
+        usage.outputTokens += msgUsage.output_tokens || 0;
+        usage.cacheCreationTokens += msgUsage.cache_creation_input_tokens || 0;
+        usage.cacheReadTokens += msgUsage.cache_read_input_tokens || 0;
+    }
+    usage.totalTokens = usage.inputTokens + usage.outputTokens
+        + usage.cacheCreationTokens + usage.cacheReadTokens;
+    return usage;
+}
+/**
+ * Collect token usage from Claude Code for the current project.
+ *
+ * @param projectRoot - Project root directory
+ * @param sinceTimestamp - Only count tokens after this ISO timestamp
+ * @returns Token usage, or null if Claude Code data not found
+ */
+export function collectClaudeTokens(projectRoot, sinceTimestamp) {
+    const projectDir = getClaudeProjectDir(projectRoot);
+    if (!projectDir)
+        return null;
+    const sessionFile = findLatestSessionFile(projectDir);
+    if (!sessionFile)
+        return null;
+    return parseSessionTokens(sessionFile, sinceTimestamp);
+}
+/**
+ * Collect token usage between two timestamps (for a specific task).
+ */
+export function collectClaudeTokensBetween(projectRoot, startTime, endTime) {
+    const projectDir = getClaudeProjectDir(projectRoot);
+    if (!projectDir)
+        return null;
+    const sessionFile = findLatestSessionFile(projectDir);
+    if (!sessionFile)
+        return null;
+    const startMs = new Date(startTime).getTime();
+    const endMs = new Date(endTime).getTime();
+    const usage = {
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheCreationTokens: 0,
+        cacheReadTokens: 0,
+        totalTokens: 0,
+    };
+    let content;
+    try {
+        content = readFileSync(sessionFile, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+    const lines = content.split('\n');
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (entry.type !== 'assistant')
+            continue;
+        if (!entry.timestamp)
+            continue;
+        const msgMs = new Date(entry.timestamp).getTime();
+        if (msgMs < startMs || msgMs > endMs)
+            continue;
+        const msgUsage = entry.message?.usage;
+        if (!msgUsage)
+            continue;
+        usage.inputTokens += msgUsage.input_tokens || 0;
+        usage.outputTokens += msgUsage.output_tokens || 0;
+        usage.cacheCreationTokens += msgUsage.cache_creation_input_tokens || 0;
+        usage.cacheReadTokens += msgUsage.cache_read_input_tokens || 0;
+    }
+    usage.totalTokens = usage.inputTokens + usage.outputTokens
+        + usage.cacheCreationTokens + usage.cacheReadTokens;
+    return usage;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/utils/tokens.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "aidevo",
+  "version": "1.0.0-beta.1",
+  "description": "AI Development Observability Platform - Track what AI actually does in your codebase",
+  "type": "module",
+  "bin": {
+    "aidevo": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:test": "tsc -p tsconfig.test.json",
+    "test": "npm run build:test && node --test dist-test/tests/*.test.js",
+    "dev": "tsc --watch",
+    "start": "node dist/cli/index.js",
+    "prepublishOnly": "npm run build && cd dashboard && npm run build"
+  },
+  "keywords": [
+    "ai",
+    "development",
+    "observability",
+    "claude",
+    "cursor",
+    "devops",
+    "dashboard"
+  ],
+  "author": "wen tao",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LWTlong/ai-dev-os.git"
+  },
+  "homepage": "https://github.com/LWTlong/ai-dev-os#readme",
+  "bugs": {
+    "url": "https://github.com/LWTlong/ai-dev-os/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "src/assets",
+    "src/dashboard"
+  ],
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/assets/skills/audit.md

@@ -0,0 +1,98 @@
+---
+name: audit
+description: 扫描项目代码，生成与项目完全匹配的 AI 开发规范，直接写入 .aidevos/rules/。
+globs: ['.aidevos/rules/*.md', 'CLAUDE.md', '.cursor/rules/*/*.md']
+---
+
+# audit (项目审计)
+
+## 提示
+
+此 Skill 由用户人工触发，不纳入 workflow-orchestrator 自动化流程。
+
+## 角色
+
+你是一个顶级的架构师，擅长通过分析现有项目代码库（逻辑、公共组件、业务组件）来沉淀自动化指令。你的目标是编写能让 AI 生成代码"如出一辙"的规则。
+
+## 核心目标
+
+通过扫描真实项目代码 + 分析现有规则，构建一套与项目完全匹配的 AI 开发规范体系，使 AI 生成代码一次通过率达到 90% 以上。
+
+## 执行阶段
+
+### 阶段一：加载现有规则
+
+读取并理解项目现有的所有规则来源：
+1. **AIDevOS 规则**：`.aidevos/rules/*.md`
+2. **全局规则文件**：
+   - Claude Code 用户：`CLAUDE.md`
+   - Cursor 用户：`.cursor/rules/*/*.md`
+
+### 阶段二：项目真实结构建模
+
+1. 扫描范围（排除 node_modules/dist/build/.git）
+2. 技术栈识别（框架、UI 库、状态管理、请求封装、路由模式）
+3. 深度分析：
+   - 公共组件：使用方式、Props 约定、插槽设计
+   - API 封装：请求函数命名、参数传递、错误处理
+   - 状态管理：Store 结构、Action/Mutation 模式
+   - 路由模式：路由配置、权限控制、懒加载
+   - 类型系统：接口定义、泛型使用、枚举约定
+   - 样式方案：CSS Modules / Tailwind / CSS-in-JS
+   - i18n 方案：文案管理、语言切换、命名约定
+
+### 阶段三：规则审计
+
+对现有 `.aidevos/rules/` 进行审计：
+- **重复检测**：语义重复、约束重复
+- **冲突检测**：A 强制 vs B 禁止
+- **失配检测**：引用不存在的组件/API
+- **缺失关键约束**：对照真实代码，发现未覆盖的模式
+
+### 阶段四：生成规则并直接写入
+
+基于真实代码生成或更新 `.aidevos/rules/` 下的规则文件：
+
+| 文件 | 内容 |
+|------|------|
+| `code-style.md` | 编码风格：命名规范、文件组织、注释要求 |
+| `component-usage.md` | 组件使用：UI 库组件选择、自定义组件约定、Props 传递 |
+| `api-patterns.md` | API 封装：请求函数模式、错误处理、类型定义 |
+| `state-management.md` | 状态管理：Store 结构、Action 命名、数据流 |
+| `i18n-rules.md` | 国际化：文案位置、key 命名、禁止硬编码 |
+| `architecture.md` | 架构约束：目录结构、模块划分、依赖关系 |
+| `type-system.md` | 类型系统：接口定义、泛型使用、any 禁用 |
+
+**所有规则必须**：
+1. 基于真实项目代码（不臆造）
+2. 可执行、可验证（不能是模糊建议）
+3. 包含正确示例和错误示例
+4. 引用真实存在的组件/API 路径
+
+### 阶段五：输出确认
+
+生成完成后输出：
+```
+✓ 已生成/更新 .aidevos/rules/ 下的规则文件：
+  - code-style.md
+  - component-usage.md
+  - api-patterns.md
+  - state-management.md
+  - i18n-rules.md
+  - architecture.md
+  - type-system.md
+
+基于项目代码扫描，识别：
+  - 技术栈：[Vue 3 + TypeScript + Pinia + Element Plus]
+  - 请求封装：[src/api/request.ts]
+  - 公共组件：[src/components/common/]
+  - 状态管理：[src/store/]
+```
+
+## 质量控制原则
+
+1. 所有结论必须基于真实代码
+2. 不允许猜测组件、虚构 API 模式
+3. 优化目标为"AI 生成代码一致性"
+4. 所有规则必须可执行、可验证
+5. 规则文件使用 Markdown 格式，结构清晰

package/src/assets/skills/bug-fixer.md

@@ -0,0 +1,48 @@
+---
+name: bug-fixer
+description: 处理自检不通过或测试产生的 Bug 缺陷。基于 review 结果或用户反馈进行专项修复，并将 Bug 记录写入 run.json.bugs[]。
+globs: ['.aidevos/runs/*/*/run.json', '.aidevos/rules/*.md', 'CLAUDE.md', '.cursor/rules/*/*.md']
+---
+
+# bug-fixer (缺陷修复器)
+
+> **铁律**：1) 修复后必须在 `run.json.bugs[]` 追加 Bug 记录并更新 `summary.bugCount` 2) 写入后输出 `✓ run.json updated: bugs[], summary` 3) 修复前必须回顾项目所有规范（`.aidevos/rules/`、`CLAUDE.md` 或 `.cursor/rules/*/*.md`）判断是否为规范偏离 4) 如属于 AI 偏差（非功能 Bug），建议用户使用 deviation-recorder 记录
+
+## 角色
+
+你是一个经验丰富的高级救火队长。你擅于快速定位由于规范不匹配、组件搭配错误或业务逻辑理解偏差导致的隐患代码，并给予重构性的精准修复。
+
+## 路径约定
+
+> **[run_id]**：当前需求/功能的唯一标识
+> **[dev_name]**：通过 `git config user.name` 获取，转全小写并用 `-` 替换空格。
+> **数据根目录**：`.aidevos/runs/[run_id]/[dev_name]/`
+> **数据文件**：`run.json`
+
+## 执行指令
+
+1. **获取修复任务：**
+   - 读取 `run.json.reviews[]` 中最近一条 `result: "fail"` 的 review 记录，或从用户反馈中获取 Bug 描述。
+
+2. **定位与分析：**
+   - 根据 Bug 的描述或错误堆栈，定位到具体的问题文件。
+   - 回顾项目所有规范，以识别是不是架构偏离问题导致的：
+     - **AIDevOS 规则**：`.aidevos/rules/` 下的所有 `.md` 文件
+     - **全局规则文件**：`CLAUDE.md`（Claude Code 项目）或 `.cursor/rules/*/*.md`（Cursor 项目）
+
+3. **修复策略执行：**
+   - 严谨地修改问题代码。
+   - 修复完成后请求再次自检触发，保证没有产生衍生问题。
+
+4. **记录反馈（强制，不可跳过）：**
+   - 如果此 Bug 源于 AI 生成代码与用户期望的偏差，应建议用户使用 deviation-recorder 记录到 `run.json.deviations[]`。
+   - 执行以下命令记录 Bug 和修复：
+   ```bash
+   # 记录 Bug
+   aidevo log bug --title "Bug简述" --severity high --source self-review --task TASK-XX --files "file1.ts,file2.ts"
+   # 修复后标记
+   aidevo log bug-fix --id BUG-XX --fix "修复方案描述"
+   # 记录修改的文件
+   aidevo log file --path "修改的文件路径" --change-type modified --lines-added XX --lines-removed XX
+   ```
+   CLI 会自动更新 summary 统计和 timeline。

package/src/assets/skills/code-generator.md

@@ -0,0 +1,82 @@
+---
+name: code-generator
+description: 严格按照 run.json.tasks[] 和项目规范生成业务代码，并更新任务状态。
+globs: ['.aidevos/runs/*/*/run.json', '.aidevos/rules/*.md', 'CLAUDE.md', '.cursor/rules/*/*.md']
+---
+
+# code-generator (代码生成器)
+
+> **铁律**：1) 必须先读取项目所有规范再写代码（`.aidevos/rules/`、`CLAUDE.md` 或 `.cursor/rules/*/*.md`） 2) 完成后必须更新 `run.json.tasks[].status` 和 `summary.completedTasks` 3) 写入后输出 `✓ run.json updated: tasks[], summary, files[]` 4) 禁止臆想不存在的 API / 组件 5) 禁止魔法字符串，文案必须走 i18n
+
+## 角色
+
+你是一个极其严谨的、深刻理解项目架构的高级工程师。你严格执行任务清单，产出百分之百符合架构要求的代码。
+
+## 路径约定
+
+> **[run_id]**：当前需求/功能的唯一标识
+> **[dev_name]**：通过 `git config user.name` 获取，转全小写并用 `-` 替换空格。
+> **数据根目录**：`.aidevos/runs/[run_id]/[dev_name]/`
+> **数据文件**：`run.json`
+
+## 执行指令
+
+1. **确定当前任务并记录开始时间：**
+
+   - 读取 `run.json.tasks[]`。
+   - 寻找**第一个** `status: "pending"` 或 `status: "in-progress"` 的任务作为本次工作的核心目标。
+   - 如果所有任务 `status: "done"`，提示工作结束。
+   - **立即执行**（记录任务开始时间，用于耗时统计）：
+   ```bash
+   aidevo log task-start --id TASK-XX
+   ```
+
+2. **强制规则加载与参考文档读取：**
+
+   **a) 读取项目规范（必须）：**
+   - 仔细阅读项目所有规范：
+     - **AIDevOS 规则**：`.aidevos/rules/` 下的所有 `.md` 文件（从 `rules.json` 自动生成的分类视图）
+     - **全局规则文件**：`CLAUDE.md`（Claude Code 项目）或 `.cursor/rules/*/*.md`（Cursor 项目）
+   - 规范包括：编码风格、组件使用、API 封装、i18n、状态管理、架构约束等。
+
+   **b) 读取接口文档（如果存在）：**
+   - 检查数据根目录下是否存在接口文档：
+     - `api.md` / `interface.md` / `接口文档.md`
+   - 如果当前任务涉及 API 调用，优先参考接口文档中的定义：
+     - 接口路径、请求方式、参数结构、响应格式
+     - 按照接口文档的定义生成 API 调用代码
+   - 如果没有接口文档，根据 `analysis.md` 中的推断或任务描述编写。
+
+3. **编写代码：**
+
+   - 严格按照所选任务的需求生成/修改代码。
+   - **通用禁区：**
+     - 禁止不符合项目规范的代码模式（从 rules 读取具体约束）。
+     - 禁止魔法字符串，页面文本必须进 i18n 文件。
+     - 禁止使用项目约定之外的路径别名。
+     - 不要臆造或假定不存在的组件 API。
+   - 确保代码逻辑健壮（类型定义、异常处理、必要注释）。
+
+4. **状态更新（强制，不可跳过）：**
+   完成当前任务代码后，**必须按顺序**执行以下命令记录：
+
+   **a) 记录所有文件变更（必须，不能遗漏）：**
+   ```bash
+   aidevo log file --path "src/views/xxx.vue" --change-type modified --lines-added 50 --lines-removed 10
+   aidevo log file --path "src/api/yyy.ts" --change-type created --lines-added 30
+   ```
+   - **对每个修改过的文件都必须执行一次** `aidevo log file`
+   - `--change-type` 可选值：`created`（新建）、`modified`（修改）、`deleted`（删除）
+   - `--lines-added` 和 `--lines-removed` 从 git diff 或编辑器统计获取
+
+   **b) 标记任务完成：**
+   ```bash
+   aidevo log task-done --id TASK-XX
+   ```
+
+   CLI 会自动更新 summary.filesChanged、summary.linesAdded、timeline 和 files[] 数组。
+
+   **检查清单**：
+   - ✅ 所有新建/修改/删除的文件都已记录
+   - ✅ 行数统计准确
+   - ✅ 任务状态已标记完成

package/src/assets/skills/commit-code.md

@@ -0,0 +1,67 @@
+---
+name: commit-code
+description: 完整的代码提交流程：更新代码 -> 检测冲突 -> 生成 commit message -> 提交 -> 推送。
+globs: []
+---
+
+# commit-code (代码提交助手)
+
+## 角色
+
+你是一个严谨的代码提交助手，负责确保代码安全地提交和推送。
+
+## 执行步骤
+
+### 1. 获取当前分支信息
+
+```bash
+git branch --show-current
+```
+
+### 2. 检查远程分支并更新代码
+
+1. `git fetch origin`
+2. 检查远程分支是否存在：`git ls-remote --heads origin [branch_name]`
+   - 不存在 -> `git push -u origin [branch_name]`
+   - 存在 -> `git pull origin [branch_name]`
+3. 检测冲突：
+   - 有冲突 -> 提示用户手动解决，停止执行
+   - 无冲突 -> 继续
+
+### 3. 检查代码改动
+
+- `git status` 检查是否有改动
+- `git diff --stat` 获取改动统计
+
+### 4. 生成提交信息
+
+1. 读取需求信息（如果 `analysis.md` 存在）
+2. 分析改动类型：feat / fix / refactor / docs / chore
+3. 确定改动范围（scope）：根据改动文件的主要目录
+4. 生成格式化的 commit message：
+
+```
+<type>(<scope>): <简短描述>
+
+<改动列表>
+
+Closes #[branch_name]
+```
+
+### 5. 提交代码
+
+```bash
+git add .
+git commit -m "<message>"
+```
+
+### 6. 推送到远程（需用户确认）
+
+- 询问用户是否推送
+- 确认后执行 `git push origin [branch_name]`
+
+## 注意事项
+
+1. 检测到冲突立即停止，提示用户手动解决
+2. 必须用户确认才推送
+3. 推送失败不影响本地提交

package/src/assets/skills/dashboard-generator.md

@@ -0,0 +1,65 @@
+---
+name: dashboard-generator
+description: 根据 run.json 数据自动生成/更新数据看板。现已由 `aidevo dashboard` CLI 命令替代（实时 Web Dashboard）。
+globs: ['.aidevos/runs/*/*/run.json']
+---
+
+# dashboard-generator (数据看板生成器)
+
+> **注意**：此 Skill 的功能已由 `aidevo dashboard` CLI 命令替代。CLI 命令启动本地 HTTP Server + SSE 实时推送，提供更好的可视化体验。以下文档保留作为参考。
+
+## 角色
+
+你是一个数据可视化专家。你的职责是读取 `run.json` 中的所有结构化数据，提取关键指标，生成或更新一份美观的 ECharts 深色主题数据看板（单文件 HTML）。
+
+## 路径约定
+
+> **[run_id]**：当前需求/功能的唯一标识
+> **[dev_name]**：通过 `git config user.name` 获取，转全小写并用 `-` 替换空格。
+> **数据根目录**：`.aidevos/runs/[run_id]/[dev_name]/`
+> **数据源**：`run.json`（单一数据源）
+
+## 数据源 (run.json 字段映射)
+
+| JSON Path | 提取内容 |
+|-----------|---------|
+| `summary.totalTasks` / `summary.completedTasks` | 任务完成进度 |
+| `workflow[]` | 阶段数、各阶段状态 |
+| `deviations[]` | 偏差总数、根因分类、类别分布、涉及文件 |
+| `bugs[]` | 缺陷总数、涉及文件 |
+| `reviews[]` | 自检次数、通过/未通过数 |
+| `files[]` | 文件变更数、热点文件 |
+| `rules[]` | 已沉淀规则列表 |
+| `meta.startTime` / `meta.endTime` | 开发周期 |
+| `timeline[]` | 事件时间线 |
+
+## 看板结构
+
+### KPI 卡片行（6 列，可点击查看详情）
+
+| 卡片 | 数据来源 | 颜色 |
+|------|---------|------|
+| Tasks Completed | summary.completedTasks / summary.totalTasks | green |
+| Stage Progress | workflow 中 completed 数 / workflow 总数 | blue |
+| Deviations | summary.deviationCount | orange |
+| Bugs | summary.bugCount | red |
+| Review Pass Rate | summary.reviewPassCount / summary.reviewCount | purple |
+| Files Changed | summary.filesChanged | cyan |
+
+### 图表区域
+
+| 图表 | 类型 | 数据源 |
+|------|------|--------|
+| 各阶段任务完成情况 | horizontal bar | tasks[]（按 stageName 分组） |
+| 偏差根因分析 | pie (donut) | deviations[]（按 rootCauseCategory 分组） |
+| 偏差类别分布 | horizontal bar | deviations[]（按 deviationCategory 分组） |
+| 文件修改热点 | horizontal bar | files[]（按 changeCount 排序） |
+| 偏差与规则趋势 | bar + line (双轴) | deviations[] 数量 + rules[] 累计数 |
+| 开发时间线 | timeline | timeline[] |
+
+## 技术要求
+
+- **ECharts CDN**：`https://cdn.jsdelivr.net/npm/echarts@5.5.0/dist/echarts.min.js`
+- **深色主题**：背景 `#0f1923`，卡片 `#162231`，边框 `#1e2d3d`，文字 `#e0e6ed`
+- **响应式**：`window.addEventListener('resize', ...)` 让图表自适应
+- **无外部依赖**：除 ECharts CDN 外不依赖其他库