@wangqq/q-agent 0.1.0

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@wangqq/q-agent",
+  "version": "0.1.0",
+  "description": "OpenCode intelligent agent for requirement risk assessment and code review",
+  "type": "module",
+  "module": "src/plugin.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "^1.18.23"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.1",
+    "typescript": "^5.7.0"
+  },
+  "files": ["src"],
+  "opencode": {
+    "plugin": true
+  }
+}

package/src/commands/cr.ts

@@ -0,0 +1,61 @@
+import { tool } from "@opencode-ai/plugin";
+import { parseCRResult, CR_SYSTEM_PROMPT } from "../core/analyzer.js";
+import type { CRReport } from "../types/index.js";
+
+const severityIcon: Record<string, string> = {
+  info: "ℹ️",
+  warning: "⚠️",
+  error: "❌",
+};
+
+function formatCROutput(report: CRReport): string {
+  let output = `\n## 代码审查报告\n\n`;
+  output += `**评分**: ${report.score}/100\n`;
+  output += `**审查时间**: ${report.timestamp}\n`;
+  output += `**报告ID**: ${report.id}\n\n`;
+
+  if (report.summary) {
+    output += `### 摘要\n\n${report.summary}\n\n`;
+  }
+
+  if (report.issues.length > 0) {
+    output += `### 发现问题 (${report.issues.length})\n\n`;
+    for (const issue of report.issues) {
+      const loc = issue.file ? ` \`${issue.file}${issue.line ? `:${issue.line}` : ""}\`` : "";
+      output += `${severityIcon[issue.severity] || ""} **[${issue.severity.toUpperCase()}]** ${issue.title}${loc}\n`;
+      output += `  ${issue.description}\n`;
+      if (issue.suggestion) {
+        output += `  💡 建议: ${issue.suggestion}\n`;
+      }
+      output += `\n`;
+    }
+  }
+
+  output += `---\n报告已保存至 \`.q/cr/${report.id}.json\`\n`;
+  return output;
+}
+
+export const qCrTool = tool({
+  description: "代码审查 - 对代码进行质量、安全、性能等多维度审查，将结果保存到 .q/cr/ 目录",
+  args: {
+    code: tool.schema.string().describe("待审查的代码内容"),
+    language: tool.schema.string().optional().describe("编程语言（可选，用于更精准的审查）"),
+    file_path: tool.schema.string().optional().describe("文件路径（可选，用于定位问题）"),
+    llm_output: tool.schema.string().optional().describe("LLM 已生成的审查结果（可选，若提供则直接解析保存）"),
+  },
+  async execute(args, _ctx) {
+    const llmOutput = args.llm_output || "";
+    const report = parseCRResult(llmOutput || args.code, args.code);
+
+    return {
+      title: `代码审查 - ${report.score}/100`,
+      output: formatCROutput(report),
+      metadata: {
+        reportId: report.id,
+        score: report.score,
+        issueCount: report.issues.length,
+        type: "cr",
+      },
+    };
+  },
+});

package/src/commands/dashboard.ts

@@ -0,0 +1,78 @@
+import { tool } from "@opencode-ai/plugin";
+import { startDashboardServer, stopDashboardServer, getActiveServer } from "../dashboard/server.js";
+
+export const qDashboardTool = tool({
+  description: "启动 Q Dashboard 本地服务器，可视化展示 .q/ 目录下的历史分析结果（RA 和 CR 报告）",
+  args: {
+    port: tool.schema.number().optional().describe("服务器端口号（默认 3210）"),
+    host: tool.schema.string().optional().describe("服务器主机地址（默认 localhost）"),
+    action: tool.schema.enum(["start", "stop", "restart"]).optional().describe("操作类型：start/stop/restart（默认 start）"),
+  },
+  async execute(args, _ctx) {
+    const action = args.action || "start";
+    const port = args.port || 3210;
+    const host = args.host || "localhost";
+
+    if (action === "stop") {
+      const server = getActiveServer();
+      if (server) {
+        await stopDashboardServer(server);
+        return {
+          title: "Q Dashboard 已停止",
+          output: "Dashboard 服务器已停止",
+        };
+      }
+      return {
+        title: "Q Dashboard",
+        output: "没有正在运行的 Dashboard 服务器",
+      };
+    }
+
+    if (action === "restart") {
+      const server = getActiveServer();
+      if (server) {
+        await stopDashboardServer(server);
+      }
+    }
+
+    if (action === "start" || action === "restart") {
+      const existing = getActiveServer();
+      if (existing && action === "start") {
+        return {
+          title: "Q Dashboard 已在运行",
+          output: "Dashboard 服务器已在运行，使用 action: restart 重启，或 action: stop 停止",
+        };
+      }
+
+      try {
+        await startDashboardServer(port, host);
+        const url = `http://${host}:${port}`;
+        return {
+          title: `Q Dashboard 已启动 - ${url}`,
+          output: [
+            `## Q Dashboard\n`,
+            `服务器已启动: ${url}\n`,
+            `- 首页: ${url}/`,
+            `- RA 报告 API: ${url}/api/ra`,
+            `- CR 报告 API: ${url}/api/cr\n`,
+            `使用 q_dashboard(action: "stop") 停止服务器`,
+          ].join("\n"),
+          metadata: { url, port, host },
+        };
+      } catch (err: any) {
+        if (err.code === "EADDRINUSE") {
+          return {
+            title: "启动失败",
+            output: `端口 ${port} 已被占用，请使用其他端口`,
+          };
+        }
+        return {
+          title: "启动失败",
+          output: `启动服务器失败: ${err.message}`,
+        };
+      }
+    }
+
+    return { output: "未知操作" };
+  },
+});

package/src/commands/ra.ts

@@ -0,0 +1,66 @@
+import { tool } from "@opencode-ai/plugin";
+import { parseRAResult, RA_SYSTEM_PROMPT } from "../core/analyzer.js";
+import type { RAReport } from "../types/index.js";
+
+const riskEmoji: Record<string, string> = {
+  low: "🟢",
+  medium: "🟡",
+  high: "🟠",
+  critical: "🔴",
+};
+
+function formatRAOutput(report: RAReport): string {
+  let output = `\n## 需求风险评估报告\n\n`;
+  output += `**风险等级**: ${riskEmoji[report.riskLevel] || ""} ${report.riskLevel.toUpperCase()}\n`;
+  output += `**评估时间**: ${report.timestamp}\n`;
+  output += `**报告ID**: ${report.id}\n\n`;
+
+  if (report.categories.length > 0) {
+    output += `### 各维度评估\n\n`;
+    for (const cat of report.categories) {
+      output += `- **${cat.name}** ${riskEmoji[cat.riskLevel] || ""} ${cat.riskLevel}\n`;
+      output += `  ${cat.description}\n`;
+      if (cat.suggestions.length > 0) {
+        output += `  建议:\n`;
+        for (const s of cat.suggestions) {
+          output += `  - ${s}\n`;
+        }
+      }
+      output += `\n`;
+    }
+  }
+
+  if (report.output) {
+    output += `### 摘要\n\n${report.output}\n`;
+  }
+
+  output += `\n---\n报告已保存至 \`.q/ra/${report.id}.json\`\n`;
+  return output;
+}
+
+export const qRaTool = tool({
+  description: "需求风险评估 - 分析需求的技术可行性、安全、兼容性等风险维度，将结果保存到 .q/ra/ 目录",
+  args: {
+    requirement: tool.schema.string().describe("需求描述文本"),
+    context: tool.schema.string().optional().describe("附加上下文信息（可选）"),
+    llm_output: tool.schema.string().optional().describe("LLM 已生成的分析结果（可选，若提供则直接解析保存）"),
+  },
+  async execute(args, _ctx) {
+    const llmOutput = args.llm_output || "";
+    const requirementText = args.context
+      ? `${args.requirement}\n\n附加上下文:\n${args.context}`
+      : args.requirement;
+
+    const report = parseRAResult(llmOutput || requirementText, requirementText);
+
+    return {
+      title: `需求风险评估 - ${report.riskLevel.toUpperCase()}`,
+      output: formatRAOutput(report),
+      metadata: {
+        reportId: report.id,
+        riskLevel: report.riskLevel,
+        type: "ra",
+      },
+    };
+  },
+});

package/src/core/analyzer.ts

@@ -0,0 +1,82 @@
+import { saveResult, generateId } from "./storage.js";
+import { RA_SYSTEM_PROMPT, CR_SYSTEM_PROMPT } from "./prompts.js";
+import type { RAReport, CRReport, RACategory, CRIssue } from "../types/index.js";
+
+function extractJSON(text: string): string {
+  const codeBlockMatch = text.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+  if (codeBlockMatch) {
+    return codeBlockMatch[1].trim();
+  }
+  const jsonMatch = text.match(/\{[\s\S]*\}/);
+  if (jsonMatch) {
+    return jsonMatch[0];
+  }
+  return text;
+}
+
+export function parseRAResult(llmOutput: string, requirement: string): RAReport {
+  const id = generateId();
+  const timestamp = new Date().toISOString();
+
+  let riskLevel: RAReport["riskLevel"] = "medium";
+  let categories: RACategory[] = [];
+  let summary = "";
+
+  try {
+    const parsed = JSON.parse(extractJSON(llmOutput));
+    riskLevel = parsed.riskLevel || "medium";
+    categories = parsed.categories || [];
+    summary = parsed.summary || "";
+  } catch {
+    summary = llmOutput;
+  }
+
+  const report: RAReport = {
+    id,
+    type: "ra",
+    timestamp,
+    input: requirement,
+    output: summary,
+    metadata: {},
+    riskLevel,
+    categories,
+  };
+
+  saveResult(report);
+  return report;
+}
+
+export function parseCRResult(llmOutput: string, code: string): CRReport {
+  const id = generateId();
+  const timestamp = new Date().toISOString();
+
+  let score = 0;
+  let summary = "";
+  let issues: CRIssue[] = [];
+
+  try {
+    const parsed = JSON.parse(extractJSON(llmOutput));
+    score = parsed.score || 0;
+    summary = parsed.summary || "";
+    issues = parsed.issues || [];
+  } catch {
+    summary = llmOutput;
+  }
+
+  const report: CRReport = {
+    id,
+    type: "cr",
+    timestamp,
+    input: code,
+    output: summary,
+    metadata: {},
+    summary,
+    issues,
+    score,
+  };
+
+  saveResult(report);
+  return report;
+}
+
+export { RA_SYSTEM_PROMPT, CR_SYSTEM_PROMPT };

package/src/core/prompts.ts

@@ -0,0 +1,80 @@
+export const RA_SYSTEM_PROMPT = `你是一位资深的需求风险评估专家。你的任务是分析给定的需求描述，从以下维度进行全面风险评估：
+
+## 评估维度
+
+1. **技术可行性风险** - 需求在技术上是否可行，是否存在技术难点或依赖风险
+2. **范围蔓延风险** - 需求边界是否清晰，是否容易扩展超出原始范围
+3. **兼容性风险** - 是否与现有系统、API、数据结构兼容
+4. **性能风险** - 实现后是否可能影响系统性能、响应时间、资源消耗
+5. **安全风险** - 是否涉及敏感数据、权限变更、潜在安全漏洞
+6. **时间进度风险** - 实现复杂度评估，是否可能延期
+7. **依赖风险** - 是否依赖外部服务、第三方库、其他团队交付
+
+## 输出格式
+
+请以 JSON 格式输出评估结果，结构如下：
+
+\`\`\`json
+{
+  "riskLevel": "low|medium|high|critical",
+  "categories": [
+    {
+      "name": "维度名称",
+      "riskLevel": "low|medium|high|critical",
+      "description": "风险描述",
+      "suggestions": ["缓解建议1", "缓解建议2"]
+    }
+  ],
+  "summary": "整体风险评估摘要"
+}
+\`\`\`
+
+请确保分析全面、客观，给出具体可操作的缓解建议。`;
+
+export const CR_SYSTEM_PROMPT = `你是一位资深的代码审查专家。你的任务是对给定的代码进行专业审查，从以下维度进行全面分析：
+
+## 审查维度
+
+1. **代码质量** - 代码可读性、命名规范、结构清晰度
+2. **潜在缺陷** - 空指针、边界条件、并发问题、资源泄漏
+3. **安全漏洞** - 注入攻击、XSS、敏感数据暴露、权限绕过
+4. **性能问题** - 不必要的计算、内存分配、N+1查询、缓存缺失
+5. **最佳实践** - 设计模式、SOLID原则、DRY原则、错误处理
+6. **可维护性** - 耦合度、测试覆盖、文档完整性
+7. **架构一致性** - 与项目架构风格、分层规范的一致性
+
+## 输出格式
+
+请以 JSON 格式输出审查结果，结构如下：
+
+\`\`\`json
+{
+  "score": 85,
+  "summary": "代码审查整体摘要",
+  "issues": [
+    {
+      "severity": "info|warning|error",
+      "file": "文件路径",
+      "line": 行号,
+      "title": "问题标题",
+      "description": "问题描述",
+      "suggestion": "修复建议"
+    }
+  ]
+}
+\`\`\`
+
+评分范围 0-100，90+ 为优秀，70-89 为良好，50-69 为需改进，50以下为严重问题。
+请确保审查专业、客观，给出具体可操作的修复建议。`;
+
+export const RA_COMMAND_TEMPLATE = `请对以下需求进行风险评估，使用 q_ra 工具完成分析并将结果保存：
+
+{{args}}
+
+请调用 q_ra 工具，将上述需求作为 requirement 参数传入。`;
+
+export const CR_COMMAND_TEMPLATE = `请对以下代码进行审查，使用 q_cr 工具完成分析并将结果保存：
+
+{{args}}
+
+请调用 q_cr 工具，将上述代码作为 code 参数传入。`;

package/src/core/storage.ts

@@ -0,0 +1,59 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import type { AnalysisResult, AnalysisType } from "../types/index.js";
+
+function ensureDir(dir: string): void {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+function getQBaseDir(): string {
+  const baseDir = join(process.cwd(), ".q");
+  ensureDir(baseDir);
+  return baseDir;
+}
+
+export function getDirForType(type: AnalysisType): string {
+  const dir = join(getQBaseDir(), type);
+  ensureDir(dir);
+  return dir;
+}
+
+export function saveResult<T extends AnalysisResult>(result: T): string {
+  const dir = getDirForType(result.type);
+  const filePath = join(dir, `${result.id}.json`);
+  writeFileSync(filePath, JSON.stringify(result, null, 2), "utf-8");
+  return filePath;
+}
+
+export function loadResult<T extends AnalysisResult>(type: AnalysisType, id: string): T | null {
+  const dir = getDirForType(type);
+  const filePath = join(dir, `${id}.json`);
+  if (!existsSync(filePath)) {
+    return null;
+  }
+  return JSON.parse(readFileSync(filePath, "utf-8")) as T;
+}
+
+export function listResults<T extends AnalysisResult>(type: AnalysisType): T[] {
+  const dir = getDirForType(type);
+  if (!existsSync(dir)) {
+    return [];
+  }
+  return readdirSync(dir)
+    .filter((f: string) => f.endsWith(".json"))
+    .sort()
+    .reverse()
+    .map((f: string) => JSON.parse(readFileSync(join(dir, f), "utf-8")) as T);
+}
+
+export function generateId(): string {
+  const d = new Date();
+  const p = (n: number) => n.toString().padStart(2, "0");
+  return `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`;
+}
+
+export function getStorageBaseDir(): string {
+  return getQBaseDir();
+}

package/src/dashboard/server.ts

@@ -0,0 +1,88 @@
+import { createServer, type Server, type IncomingMessage, type ServerResponse } from "node:http";
+import { listResults, loadResult } from "../core/storage.js";
+import { renderDashboard } from "./template.js";
+import type { RAReport, CRReport } from "../types/index.js";
+
+let activeServer: Server | null = null;
+
+export function getActiveServer(): Server | null {
+  return activeServer;
+}
+
+function parseUrl(req: IncomingMessage): { pathname: string } {
+  const url = new URL(req.url || "/", `http://${req.headers.host || "localhost"}`);
+  return { pathname: url.pathname };
+}
+
+function sendJson(res: ServerResponse, data: unknown, status = 200): void {
+  res.writeHead(status, {
+    "Content-Type": "application/json",
+    "Access-Control-Allow-Origin": "*",
+  });
+  res.end(JSON.stringify(data));
+}
+
+function sendHtml(res: ServerResponse, html: string): void {
+  res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+  res.end(html);
+}
+
+function sendNotFound(res: ServerResponse): void {
+  res.writeHead(404, { "Content-Type": "application/json" });
+  res.end(JSON.stringify({ error: "Not found" }));
+}
+
+export function startDashboardServer(port = 3210, host = "localhost"): Promise<Server> {
+  const server = createServer((req, res) => {
+    const { pathname } = parseUrl(req);
+
+    if (pathname === "/" || pathname === "/dashboard") {
+      const raReports = listResults<RAReport>("ra");
+      const crReports = listResults<CRReport>("cr");
+      sendHtml(res, renderDashboard(raReports, crReports));
+      return;
+    }
+
+    if (pathname === "/api/ra") {
+      sendJson(res, listResults<RAReport>("ra"));
+      return;
+    }
+
+    if (pathname === "/api/cr") {
+      sendJson(res, listResults<CRReport>("cr"));
+      return;
+    }
+
+    const raMatch = pathname.match(/^\/api\/ra\/(\d+)$/);
+    if (raMatch) {
+      const report = loadResult<RAReport>("ra", raMatch[1]);
+      return report ? sendJson(res, report) : sendNotFound(res);
+    }
+
+    const crMatch = pathname.match(/^\/api\/cr\/(\d+)$/);
+    if (crMatch) {
+      const report = loadResult<CRReport>("cr", crMatch[1]);
+      return report ? sendJson(res, report) : sendNotFound(res);
+    }
+
+    sendNotFound(res);
+  });
+
+  return new Promise((resolve, reject) => {
+    server.on("error", reject);
+    server.listen(port, host, () => {
+      activeServer = server;
+      resolve(server);
+    });
+  });
+}
+
+export async function stopDashboardServer(server: Server): Promise<void> {
+  activeServer = null;
+  return new Promise((resolve, reject) => {
+    server.close((err) => {
+      if (err) reject(err);
+      else resolve();
+    });
+  });
+}

package/src/dashboard/template.ts

@@ -0,0 +1,241 @@
+import type { AnalysisResult, RAReport, CRReport } from "../types/index.js";
+
+function riskBadge(level: string): string {
+  const colors: Record<string, string> = {
+    low: "#22c55e",
+    medium: "#eab308",
+    high: "#f97316",
+    critical: "#ef4444",
+  };
+  const color = colors[level] || "#6b7280";
+  return `<span style="display:inline-block;padding:2px 10px;border-radius:12px;color:#fff;background:${color};font-size:12px;font-weight:600;">${level.toUpperCase()}</span>`;
+}
+
+function severityBadge(severity: string): string {
+  const colors: Record<string, string> = {
+    info: "#3b82f6",
+    warning: "#eab308",
+    error: "#ef4444",
+  };
+  const color = colors[severity] || "#6b7280";
+  return `<span style="display:inline-block;padding:2px 10px;border-radius:12px;color:#fff;background:${color};font-size:12px;font-weight:600;">${severity.toUpperCase()}</span>`;
+}
+
+function scoreColor(score: number): string {
+  if (score >= 90) return "#22c55e";
+  if (score >= 70) return "#eab308";
+  if (score >= 50) return "#f97316";
+  return "#ef4444";
+}
+
+function formatRAReport(report: RAReport): string {
+  let html = `
+    <div class="report-card ra-card">
+      <div class="report-header">
+        <span class="report-type">RA</span>
+        ${riskBadge(report.riskLevel)}
+        <span class="report-time">${report.timestamp}</span>
+      </div>
+      <div class="report-body">
+        <h4>需求输入</h4>
+        <pre class="report-input">${escapeHtml(report.input)}</pre>`;
+
+  if (report.categories.length > 0) {
+    html += `<h4>风险评估维度</h4><div class="categories">`;
+    for (const cat of report.categories) {
+      html += `
+        <div class="category">
+          <div class="category-header">${escapeHtml(cat.name)} ${riskBadge(cat.riskLevel)}</div>
+          <p>${escapeHtml(cat.description)}</p>
+          ${cat.suggestions.length > 0 ? `<ul>${cat.suggestions.map((s) => `<li>${escapeHtml(s)}</li>`).join("")}</ul>` : ""}
+        </div>`;
+    }
+    html += `</div>`;
+  }
+
+  html += `
+      </div>
+      <div class="report-footer">
+        <span class="report-id">ID: ${report.id}</span>
+        <a href="/api/ra/${report.id}" class="download-link">下载 JSON</a>
+      </div>
+    </div>`;
+  return html;
+}
+
+function formatCRReport(report: CRReport): string {
+  let html = `
+    <div class="report-card cr-card">
+      <div class="report-header">
+        <span class="report-type">CR</span>
+        <span class="score" style="color:${scoreColor(report.score)}">${report.score}/100</span>
+        <span class="report-time">${report.timestamp}</span>
+      </div>
+      <div class="report-body">
+        <h4>审查摘要</h4>
+        <p>${escapeHtml(report.summary)}</p>`;
+
+  if (report.issues.length > 0) {
+    html += `<h4>问题列表 (${report.issues.length})</h4><div class="issues">`;
+    for (const issue of report.issues) {
+      const loc = issue.file ? ` <code>${escapeHtml(issue.file)}${issue.line ? `:${issue.line}` : ""}</code>` : "";
+      html += `
+        <div class="issue">
+          <div class="issue-header">${severityBadge(issue.severity)} ${escapeHtml(issue.title)}${loc}</div>
+          <p>${escapeHtml(issue.description)}</p>
+          ${issue.suggestion ? `<p class="suggestion">💡 ${escapeHtml(issue.suggestion)}</p>` : ""}
+        </div>`;
+    }
+    html += `</div>`;
+  }
+
+  html += `
+      </div>
+      <div class="report-footer">
+        <span class="report-id">ID: ${report.id}</span>
+        <a href="/api/cr/${report.id}" class="download-link">下载 JSON</a>
+      </div>
+    </div>`;
+  return html;
+}
+
+function escapeHtml(text: string): string {
+  return text
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&#039;");
+}
+
+export function renderDashboard(raReports: RAReport[], crReports: CRReport[]): string {
+  const raCards = raReports.map(formatRAReport).join("\n");
+  const crCards = crReports.map(formatCRReport).join("\n");
+
+  return `<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Q Agent Dashboard</title>
+  <style>
+    :root {
+      --bg: #0f172a;
+      --card-bg: #1e293b;
+      --text: #e2e8f0;
+      --text-muted: #94a3b8;
+      --border: #334155;
+      --accent: #3b82f6;
+    }
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body {
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
+      background: var(--bg);
+      color: var(--text);
+      line-height: 1.6;
+    }
+    .container { max-width: 1200px; margin: 0 auto; padding: 20px; }
+    header {
+      display: flex; justify-content: space-between; align-items: center;
+      padding: 20px 0; border-bottom: 1px solid var(--border); margin-bottom: 30px;
+    }
+    h1 { font-size: 24px; font-weight: 700; }
+    h1 span { color: var(--accent); }
+    .stats { display: flex; gap: 20px; }
+    .stat { text-align: center; }
+    .stat-value { font-size: 28px; font-weight: 700; color: var(--accent); }
+    .stat-label { font-size: 12px; color: var(--text-muted); text-transform: uppercase; }
+    .tabs { display: flex; gap: 8px; margin-bottom: 24px; }
+    .tab {
+      padding: 8px 20px; border-radius: 8px; cursor: pointer;
+      background: var(--card-bg); border: 1px solid var(--border);
+      color: var(--text-muted); font-size: 14px; font-weight: 500;
+      transition: all 0.2s;
+    }
+    .tab:hover { border-color: var(--accent); color: var(--text); }
+    .tab.active { background: var(--accent); color: #fff; border-color: var(--accent); }
+    .tab-content { display: none; }
+    .tab-content.active { display: block; }
+    .report-card {
+      background: var(--card-bg); border: 1px solid var(--border);
+      border-radius: 12px; padding: 20px; margin-bottom: 16px;
+    }
+    .report-header {
+      display: flex; align-items: center; gap: 12px;
+      margin-bottom: 16px; padding-bottom: 12px; border-bottom: 1px solid var(--border);
+    }
+    .report-type {
+      display: inline-block; padding: 2px 10px; border-radius: 6px;
+      font-size: 12px; font-weight: 700; color: #fff;
+    }
+    .ra-card .report-type { background: #8b5cf6; }
+    .cr-card .report-type { background: #06b6d4; }
+    .report-time { color: var(--text-muted); font-size: 13px; margin-left: auto; }
+    .score { font-size: 20px; font-weight: 700; }
+    .report-body h4 { color: var(--text); margin: 12px 0 8px; font-size: 14px; }
+    .report-input {
+      background: var(--bg); padding: 12px; border-radius: 8px;
+      font-size: 13px; overflow-x: auto; white-space: pre-wrap; max-height: 200px; overflow-y: auto;
+    }
+    .categories, .issues { display: flex; flex-direction: column; gap: 12px; }
+    .category, .issue {
+      background: var(--bg); padding: 12px; border-radius: 8px;
+    }
+    .category-header, .issue-header { font-weight: 600; margin-bottom: 4px; }
+    .category ul { padding-left: 20px; margin-top: 8px; }
+    .category li { font-size: 13px; color: var(--text-muted); }
+    .suggestion { color: #22c55e; font-size: 13px; }
+    .report-footer {
+      display: flex; justify-content: space-between; align-items: center;
+      margin-top: 12px; padding-top: 12px; border-top: 1px solid var(--border);
+    }
+    .report-id { color: var(--text-muted); font-size: 12px; font-family: monospace; }
+    .download-link { color: var(--accent); font-size: 13px; text-decoration: none; }
+    .download-link:hover { text-decoration: underline; }
+    .empty { text-align: center; color: var(--text-muted); padding: 40px; }
+    code { background: var(--bg); padding: 1px 6px; border-radius: 4px; font-size: 13px; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <header>
+      <h1><span>Q</span> Agent Dashboard</h1>
+      <div class="stats">
+        <div class="stat">
+          <div class="stat-value">${raReports.length}</div>
+          <div class="stat-label">RA Reports</div>
+        </div>
+        <div class="stat">
+          <div class="stat-value">${crReports.length}</div>
+          <div class="stat-label">CR Reports</div>
+        </div>
+      </div>
+    </header>
+    <div class="tabs">
+      <div class="tab active" data-tab="all">All</div>
+      <div class="tab" data-tab="ra">Risk Assessment</div>
+      <div class="tab" data-tab="cr">Code Review</div>
+    </div>
+    <div class="tab-content active" id="tab-all">
+      ${raCards || crCards ? raCards + crCards : '<div class="empty">暂无分析结果</div>'}
+    </div>
+    <div class="tab-content" id="tab-ra">
+      ${raCards || '<div class="empty">暂无风险评估报告</div>'}
+    </div>
+    <div class="tab-content" id="tab-cr">
+      ${crCards || '<div class="empty">暂无代码审查报告</div>'}
+    </div>
+  </div>
+  <script>
+    document.querySelectorAll('.tab').forEach(tab => {
+      tab.addEventListener('click', () => {
+        document.querySelectorAll('.tab').forEach(t => t.classList.remove('active'));
+        document.querySelectorAll('.tab-content').forEach(c => c.classList.remove('active'));
+        tab.classList.add('active');
+        document.getElementById('tab-' + tab.dataset.tab).classList.add('active');
+      });
+    });
+  </script>
+</body>
+</html>`;
+}

package/src/plugin.ts

@@ -0,0 +1,59 @@
+import type { Plugin, PluginInput, Hooks } from "@opencode-ai/plugin";
+import { define, type PluginContext } from "@opencode-ai/plugin/v2/promise";
+import { qRaTool } from "./commands/ra.js";
+import { qCrTool } from "./commands/cr.js";
+import { qDashboardTool } from "./commands/dashboard.js";
+import { RA_COMMAND_TEMPLATE, CR_COMMAND_TEMPLATE } from "./core/prompts.js";
+
+const QAgentPlugin: Plugin = async (_input: PluginInput): Promise<Hooks> => {
+  return {
+    tool: {
+      q_ra: qRaTool,
+      q_cr: qCrTool,
+      q_dashboard: qDashboardTool,
+    },
+
+    "experimental.chat.system.transform": async (_input, output) => {
+      output.system.push(
+        "你已加载 Q Agent 插件，可以使用以下工具：",
+        "- q_ra: 需求风险评估，分析需求的技术可行性、安全、兼容性等风险",
+        "- q_cr: 代码审查，对代码进行质量、安全、性能等多维度审查",
+        "- q_dashboard: 启动/停止 Dashboard 可视化服务器",
+      );
+    },
+  };
+};
+
+export const QAgentV2Plugin = define({
+  id: "q-agent",
+  async setup(context: PluginContext) {
+    await context.command.transform((draft) => {
+      if (!draft.get("q-ra")) {
+        draft.update("q-ra", (cmd) => {
+          cmd.name = "q-ra";
+          cmd.template = RA_COMMAND_TEMPLATE;
+          cmd.description = "需求风险评估 - 分析需求的技术可行性、安全、兼容性等风险";
+        });
+      }
+
+      if (!draft.get("q-cr")) {
+        draft.update("q-cr", (cmd) => {
+          cmd.name = "q-cr";
+          cmd.template = CR_COMMAND_TEMPLATE;
+          cmd.description = "代码审查 - 对代码进行质量、安全、性能等多维度审查";
+        });
+      }
+
+      if (!draft.get("q-dashboard")) {
+        draft.update("q-dashboard", (cmd) => {
+          cmd.name = "q-dashboard";
+          cmd.template = "请使用 q_dashboard 工具启动 Dashboard 可视化服务器，展示历史 RA 和 CR 分析结果。";
+          cmd.description = "启动 Q Dashboard 可视化面板，展示历史分析结果";
+        });
+      }
+    });
+  },
+});
+
+export default QAgentPlugin;
+export { QAgentPlugin };

package/src/test.js

@@ -0,0 +1,3 @@
+function deepclone(obj) {
+  return JSON.parse(JSON.stringify(obj));
+}

package/src/types/index.ts

@@ -0,0 +1,51 @@
+export type AnalysisType = "ra" | "cr";
+
+export interface AnalysisResult {
+  id: string;
+  type: AnalysisType;
+  timestamp: string;
+  input: string;
+  output: string;
+  metadata: {
+    model?: string;
+    duration?: number;
+    tokenUsage?: {
+      input: number;
+      output: number;
+    };
+  };
+}
+
+export interface RAReport extends AnalysisResult {
+  type: "ra";
+  riskLevel: "low" | "medium" | "high" | "critical";
+  categories: RACategory[];
+}
+
+export interface RACategory {
+  name: string;
+  riskLevel: "low" | "medium" | "high" | "critical";
+  description: string;
+  suggestions: string[];
+}
+
+export interface CRReport extends AnalysisResult {
+  type: "cr";
+  summary: string;
+  issues: CRIssue[];
+  score: number;
+}
+
+export interface CRIssue {
+  severity: "info" | "warning" | "error";
+  file?: string;
+  line?: number;
+  title: string;
+  description: string;
+  suggestion?: string;
+}
+
+export interface DashboardConfig {
+  port: number;
+  host: string;
+}