galaxy-opc-plugin 0.1.0

package/src/tools/monitoring-tool.ts

@@ -0,0 +1,207 @@
+/**
+ * 星环OPC中心 — opc_monitoring 运营监控工具
+ */
+
+import { Type, type Static } from "@sinclair/typebox";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { OpcDatabase } from "../db/index.js";
+import { json } from "../utils/tool-helper.js";
+
+const MonitoringSchema = Type.Union([
+  Type.Object({
+    action: Type.Literal("record_metric"),
+    company_id: Type.String({ description: "公司 ID" }),
+    name: Type.String({ description: "指标名称（如: 月收入/用户数/转化率）" }),
+    value: Type.Number({ description: "指标值" }),
+    unit: Type.Optional(Type.String({ description: "单位（如: 元/人/%）" })),
+    category: Type.Optional(Type.String({ description: "分类: revenue/user/conversion/cost/other" })),
+    recorded_at: Type.Optional(Type.String({ description: "记录时间 (YYYY-MM-DD 或 ISO datetime)" })),
+    notes: Type.Optional(Type.String({ description: "备注" })),
+  }),
+  Type.Object({
+    action: Type.Literal("get_metrics"),
+    company_id: Type.String({ description: "公司 ID" }),
+    name: Type.Optional(Type.String({ description: "按指标名称筛选" })),
+    category: Type.Optional(Type.String({ description: "按分类筛选" })),
+    start_date: Type.Optional(Type.String({ description: "开始日期" })),
+    end_date: Type.Optional(Type.String({ description: "结束日期" })),
+  }),
+  Type.Object({
+    action: Type.Literal("create_alert"),
+    company_id: Type.String({ description: "公司 ID" }),
+    title: Type.String({ description: "告警标题" }),
+    severity: Type.Optional(Type.String({ description: "严重度: info/warning/critical" })),
+    category: Type.Optional(Type.String({ description: "分类" })),
+    message: Type.Optional(Type.String({ description: "告警详情" })),
+  }),
+  Type.Object({
+    action: Type.Literal("list_alerts"),
+    company_id: Type.String({ description: "公司 ID" }),
+    severity: Type.Optional(Type.String({ description: "按严重度筛选: info/warning/critical" })),
+    status: Type.Optional(Type.String({ description: "按状态筛选: active/acknowledged/resolved" })),
+  }),
+  Type.Object({
+    action: Type.Literal("dismiss_alert"),
+    alert_id: Type.String({ description: "告警 ID" }),
+  }),
+  Type.Object({
+    action: Type.Literal("kpi_summary"),
+    company_id: Type.String({ description: "公司 ID" }),
+  }),
+  Type.Object({
+    action: Type.Literal("delete_metric"),
+    metric_id: Type.String({ description: "指标记录 ID" }),
+  }),
+]);
+
+type MonitoringParams = Static<typeof MonitoringSchema>;
+
+export function registerMonitoringTool(api: OpenClawPluginApi, db: OpcDatabase): void {
+  api.registerTool(
+    {
+      name: "opc_monitoring",
+      label: "OPC 运营监控",
+      description:
+        "运营监控工具。操作: record_metric(记录指标), get_metrics(查询指标), " +
+        "create_alert(创建告警), list_alerts(告警列表), " +
+        "dismiss_alert(消除告警), kpi_summary(KPI 汇总), delete_metric(删除指标记录)",
+      parameters: MonitoringSchema,
+      async execute(_toolCallId, params) {
+        const p = params as MonitoringParams;
+        try {
+          switch (p.action) {
+            case "record_metric": {
+              const id = db.genId();
+              const now = new Date().toISOString();
+              db.execute(
+                `INSERT INTO opc_metrics (id, company_id, name, value, unit, category, recorded_at, notes, created_at)
+                 VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+                id, p.company_id, p.name, p.value,
+                p.unit ?? "", p.category ?? "", p.recorded_at ?? now, p.notes ?? "", now,
+              );
+              return json(db.queryOne("SELECT * FROM opc_metrics WHERE id = ?", id));
+            }
+
+            case "get_metrics": {
+              let sql = "SELECT * FROM opc_metrics WHERE company_id = ?";
+              const params2: unknown[] = [p.company_id];
+              if (p.name) { sql += " AND name = ?"; params2.push(p.name); }
+              if (p.category) { sql += " AND category = ?"; params2.push(p.category); }
+              if (p.start_date) { sql += " AND recorded_at >= ?"; params2.push(p.start_date); }
+              if (p.end_date) { sql += " AND recorded_at <= ?"; params2.push(p.end_date); }
+              sql += " ORDER BY recorded_at DESC";
+              return json(db.query(sql, ...params2));
+            }
+
+            case "create_alert": {
+              const id = db.genId();
+              const now = new Date().toISOString();
+              db.execute(
+                `INSERT INTO opc_alerts (id, company_id, title, severity, category, status, message, resolved_at, created_at)
+                 VALUES (?, ?, ?, ?, ?, 'active', ?, '', ?)`,
+                id, p.company_id, p.title,
+                p.severity ?? "info", p.category ?? "", p.message ?? "", now,
+              );
+              return json(db.queryOne("SELECT * FROM opc_alerts WHERE id = ?", id));
+            }
+
+            case "list_alerts": {
+              let sql = "SELECT * FROM opc_alerts WHERE company_id = ?";
+              const params2: unknown[] = [p.company_id];
+              if (p.severity) { sql += " AND severity = ?"; params2.push(p.severity); }
+              if (p.status) { sql += " AND status = ?"; params2.push(p.status); }
+              sql += " ORDER BY created_at DESC";
+              return json(db.query(sql, ...params2));
+            }
+
+            case "dismiss_alert": {
+              const now = new Date().toISOString();
+              db.execute(
+                "UPDATE opc_alerts SET status = 'resolved', resolved_at = ? WHERE id = ?",
+                now, p.alert_id,
+              );
+              return json(db.queryOne("SELECT * FROM opc_alerts WHERE id = ?", p.alert_id) ?? { error: "告警不存在" });
+            }
+
+            case "kpi_summary": {
+              // 跨表聚合 KPI
+              const revenue = db.queryOne(
+                `SELECT COALESCE(SUM(CASE WHEN type='income' THEN amount ELSE 0 END), 0) as total_income,
+                        COALESCE(SUM(CASE WHEN type='expense' THEN amount ELSE 0 END), 0) as total_expense
+                 FROM opc_transactions WHERE company_id = ?`,
+                p.company_id,
+              ) as { total_income: number; total_expense: number };
+
+              const employees = db.queryOne(
+                "SELECT COUNT(*) as count FROM opc_employees WHERE company_id = ? AND status = 'active'",
+                p.company_id,
+              ) as { count: number };
+
+              const projects = db.queryOne(
+                `SELECT COUNT(*) as total,
+                        SUM(CASE WHEN status='active' THEN 1 ELSE 0 END) as active,
+                        SUM(CASE WHEN status='completed' THEN 1 ELSE 0 END) as completed
+                 FROM opc_projects WHERE company_id = ?`,
+                p.company_id,
+              );
+
+              const contracts = db.queryOne(
+                `SELECT COUNT(*) as total,
+                        SUM(CASE WHEN status='active' THEN 1 ELSE 0 END) as active,
+                        COALESCE(SUM(CASE WHEN status='active' THEN amount ELSE 0 END), 0) as active_value
+                 FROM opc_contracts WHERE company_id = ?`,
+                p.company_id,
+              );
+
+              const alerts = db.query(
+                `SELECT severity, COUNT(*) as count
+                 FROM opc_alerts WHERE company_id = ? AND status = 'active'
+                 GROUP BY severity`,
+                p.company_id,
+              );
+
+              const recentMetrics = db.query(
+                `SELECT name, value, unit, category, recorded_at
+                 FROM opc_metrics WHERE company_id = ?
+                 ORDER BY recorded_at DESC LIMIT 20`,
+                p.company_id,
+              );
+
+              const contacts = db.queryOne(
+                "SELECT COUNT(*) as count FROM opc_contacts WHERE company_id = ?",
+                p.company_id,
+              ) as { count: number };
+
+              return json({
+                financial: {
+                  total_income: revenue.total_income,
+                  total_expense: revenue.total_expense,
+                  net_profit: revenue.total_income - revenue.total_expense,
+                },
+                team: { active_employees: employees.count },
+                projects,
+                contracts,
+                customers: { total_contacts: contacts.count },
+                alerts: { active: alerts },
+                recent_metrics: recentMetrics,
+              });
+            }
+
+            case "delete_metric": {
+              db.execute("DELETE FROM opc_metrics WHERE id = ?", p.metric_id);
+              return json({ ok: true });
+            }
+
+            default:
+              return json({ error: `未知操作: ${(p as { action: string }).action}` });
+          }
+        } catch (err) {
+          return json({ error: err instanceof Error ? err.message : String(err) });
+        }
+      },
+    },
+    { name: "opc_monitoring" },
+  );
+
+  api.logger.info("opc: 已注册 opc_monitoring 工具");
+}

package/src/tools/opb-tool.ts

@@ -0,0 +1,193 @@
+/**
+ * 星环OPC中心 — opc_opb 一人企业画布工具
+ *
+ * 基于《一人企业方法论2.0》的 OPB Canvas（16模块），
+ * 帮助创始人系统化设计与记录其一人公司战略蓝图。
+ */
+
+import { Type, type Static } from "@sinclair/typebox";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { OpcDatabase } from "../db/index.js";
+import { json } from "../utils/tool-helper.js";
+
+const OPB_FIELDS = [
+  "track",             // 赛道（所处行业/细分市场）
+  "target_customer",   // 目标客户
+  "pain_point",        // 核心痛点
+  "solution",          // 解决方案
+  "unique_value",      // 独特价值主张（USP）
+  "channels",          // 获客渠道
+  "revenue_model",     // 收入模式
+  "cost_structure",    // 成本结构
+  "key_resources",     // 关键资源
+  "key_activities",    // 关键活动
+  "key_partners",      // 关键合作伙伴
+  "unfair_advantage",  // 不公平优势
+  "metrics",           // 关键指标
+  "non_compete",       // 非竞争策略
+  "scaling_strategy",  // 规模化路径
+  "notes",             // 备注
+] as const;
+
+const OpbSchema = Type.Union([
+  Type.Object({
+    action: Type.Literal("canvas_init"),
+    company_id: Type.String({ description: "公司 ID" }),
+    track: Type.Optional(Type.String({ description: "赛道（所处行业/细分市场）" })),
+    target_customer: Type.Optional(Type.String({ description: "目标客户画像" })),
+    pain_point: Type.Optional(Type.String({ description: "核心痛点" })),
+    solution: Type.Optional(Type.String({ description: "解决方案" })),
+    unique_value: Type.Optional(Type.String({ description: "独特价值主张（USP）" })),
+    channels: Type.Optional(Type.String({ description: "获客渠道" })),
+    revenue_model: Type.Optional(Type.String({ description: "收入模式" })),
+    cost_structure: Type.Optional(Type.String({ description: "成本结构" })),
+    key_resources: Type.Optional(Type.String({ description: "关键资源（三个池子：内容/产品/客户）" })),
+    key_activities: Type.Optional(Type.String({ description: "关键活动" })),
+    key_partners: Type.Optional(Type.String({ description: "关键合作伙伴" })),
+    unfair_advantage: Type.Optional(Type.String({ description: "不公平优势" })),
+    metrics: Type.Optional(Type.String({ description: "关键指标（KPI）" })),
+    non_compete: Type.Optional(Type.String({ description: "非竞争策略" })),
+    scaling_strategy: Type.Optional(Type.String({ description: "规模化路径" })),
+    notes: Type.Optional(Type.String({ description: "其他备注" })),
+  }),
+  Type.Object({
+    action: Type.Literal("canvas_get"),
+    company_id: Type.String({ description: "公司 ID" }),
+  }),
+  Type.Object({
+    action: Type.Literal("canvas_update"),
+    company_id: Type.String({ description: "公司 ID" }),
+    track: Type.Optional(Type.String({ description: "赛道（所处行业/细分市场）" })),
+    target_customer: Type.Optional(Type.String({ description: "目标客户画像" })),
+    pain_point: Type.Optional(Type.String({ description: "核心痛点" })),
+    solution: Type.Optional(Type.String({ description: "解决方案" })),
+    unique_value: Type.Optional(Type.String({ description: "独特价值主张（USP）" })),
+    channels: Type.Optional(Type.String({ description: "获客渠道" })),
+    revenue_model: Type.Optional(Type.String({ description: "收入模式" })),
+    cost_structure: Type.Optional(Type.String({ description: "成本结构" })),
+    key_resources: Type.Optional(Type.String({ description: "关键资源（三个池子：内容/产品/客户）" })),
+    key_activities: Type.Optional(Type.String({ description: "关键活动" })),
+    key_partners: Type.Optional(Type.String({ description: "关键合作伙伴" })),
+    unfair_advantage: Type.Optional(Type.String({ description: "不公平优势" })),
+    metrics: Type.Optional(Type.String({ description: "关键指标（KPI）" })),
+    non_compete: Type.Optional(Type.String({ description: "非竞争策略" })),
+    scaling_strategy: Type.Optional(Type.String({ description: "规模化路径" })),
+    notes: Type.Optional(Type.String({ description: "其他备注" })),
+  }),
+]);
+
+type OpbParams = Static<typeof OpbSchema>;
+
+interface CanvasRow {
+  id: string; company_id: string;
+  track: string; target_customer: string; pain_point: string; solution: string;
+  unique_value: string; channels: string; revenue_model: string; cost_structure: string;
+  key_resources: string; key_activities: string; key_partners: string;
+  unfair_advantage: string; metrics: string; non_compete: string;
+  scaling_strategy: string; notes: string;
+  created_at: string; updated_at: string;
+}
+
+export function registerOpbTool(api: OpenClawPluginApi, db: OpcDatabase): void {
+  api.registerTool(
+    {
+      name: "opc_opb",
+      label: "OPB 一人企业画布",
+      description:
+        "一人企业方法论（OPB）画布工具。" +
+        "操作: canvas_init（初始化/填写画布）, canvas_get（查看画布）, canvas_update（更新画布字段）。" +
+        "画布涵盖 16 个模块：赛道、目标客户、痛点、解决方案、独特价值、获客渠道、" +
+        "收入模式、成本结构、关键资源、关键活动、关键合作伙伴、不公平优势、" +
+        "关键指标、非竞争策略、规模化路径、备注。",
+      parameters: OpbSchema,
+      async execute(_toolCallId, params) {
+        const p = params as OpbParams;
+        try {
+          switch (p.action) {
+            case "canvas_init": {
+              // Check if canvas already exists
+              const existing = db.queryOne(
+                "SELECT id FROM opc_opb_canvas WHERE company_id = ?", p.company_id,
+              ) as { id: string } | null;
+              if (existing) {
+                return json({ ok: false, error: "该公司画布已存在，请使用 canvas_update 更新" });
+              }
+              const id = db.genId();
+              const now = new Date().toISOString();
+              db.execute(
+                `INSERT INTO opc_opb_canvas (
+                  id, company_id, track, target_customer, pain_point, solution,
+                  unique_value, channels, revenue_model, cost_structure,
+                  key_resources, key_activities, key_partners, unfair_advantage,
+                  metrics, non_compete, scaling_strategy, notes, created_at, updated_at
+                ) VALUES (?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?,?)`,
+                id, p.company_id,
+                p.track ?? "", p.target_customer ?? "", p.pain_point ?? "", p.solution ?? "",
+                p.unique_value ?? "", p.channels ?? "", p.revenue_model ?? "", p.cost_structure ?? "",
+                p.key_resources ?? "", p.key_activities ?? "", p.key_partners ?? "",
+                p.unfair_advantage ?? "", p.metrics ?? "", p.non_compete ?? "",
+                p.scaling_strategy ?? "", p.notes ?? "", now, now,
+              );
+              const canvas = db.queryOne(
+                "SELECT * FROM opc_opb_canvas WHERE id = ?", id,
+              ) as CanvasRow;
+              return json({ ok: true, canvas, message: "OPB 画布已初始化。建议逐步填写各模块内容。" });
+            }
+
+            case "canvas_get": {
+              const canvas = db.queryOne(
+                "SELECT * FROM opc_opb_canvas WHERE company_id = ?", p.company_id,
+              ) as CanvasRow | null;
+              if (!canvas) {
+                return json({ ok: false, error: "该公司暂无 OPB 画布，请先使用 canvas_init 创建" });
+              }
+              // Calculate completion percentage
+              const filled = OPB_FIELDS.filter(f => canvas[f as keyof CanvasRow] && String(canvas[f as keyof CanvasRow]).trim() !== "").length;
+              const completion = Math.round((filled / (OPB_FIELDS.length - 1)) * 100); // exclude notes
+              return json({ canvas, completion, total_fields: OPB_FIELDS.length - 1, filled });
+            }
+
+            case "canvas_update": {
+              const existing = db.queryOne(
+                "SELECT id FROM opc_opb_canvas WHERE company_id = ?", p.company_id,
+              ) as { id: string } | null;
+              if (!existing) {
+                return json({ ok: false, error: "该公司暂无 OPB 画布，请先使用 canvas_init 创建" });
+              }
+              const now = new Date().toISOString();
+              const updates: string[] = [];
+              const vals: unknown[] = [];
+              for (const field of OPB_FIELDS) {
+                const val = (p as Record<string, unknown>)[field];
+                if (val !== undefined) {
+                  updates.push(`${field} = ?`);
+                  vals.push(val);
+                }
+              }
+              if (updates.length === 0) {
+                return json({ ok: false, error: "未提供任何更新字段" });
+              }
+              updates.push("updated_at = ?");
+              vals.push(now, existing.id);
+              db.execute(
+                `UPDATE opc_opb_canvas SET ${updates.join(", ")} WHERE id = ?`,
+                ...vals,
+              );
+              const canvas = db.queryOne(
+                "SELECT * FROM opc_opb_canvas WHERE id = ?", existing.id,
+              ) as CanvasRow;
+              return json({ ok: true, canvas, updated_fields: updates.length - 1 });
+            }
+
+            default:
+              return json({ error: "未知 action" });
+          }
+        } catch (err) {
+          return json({ error: err instanceof Error ? err.message : String(err) });
+        }
+      },
+    },
+    { name: "opc_opb" },
+  );
+  api.logger.info("opc: 已注册 opc_opb 工具");
+}

package/src/tools/opc-tool.ts

@@ -0,0 +1,206 @@
+/**
+ * 星环OPC中心 — opc_manage 统一工具
+ *
+ * 单一工具 + action 字段模式，参照 feishu_doc 实现。
+ */
+
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { OpcDatabase } from "../db/index.js";
+import { CompanyManager } from "../opc/company-manager.js";
+import type { OpcCompanyStatus, OpcTransactionCategory, OpcTransactionType } from "../opc/types.js";
+import { ensureCompanyWorkspace } from "../opc/workspace-factory.js";
+import { OpcManageSchema, type OpcManageParams } from "./schemas.js";
+import { json } from "../utils/tool-helper.js";
+
+/**
+ * 将 company_id（可能是 DB ID 或公司名称）解析为实际数据库 ID。
+ * AI 有时会传公司名称而非 ID，此函数做兜底匹配。
+ */
+function resolveCompanyId(db: OpcDatabase, input: string): string {
+  // 先精确匹配 ID
+  const byId = db.queryOne("SELECT id FROM opc_companies WHERE id = ?", input) as { id: string } | null;
+  if (byId) return byId.id;
+  // 再精确匹配名称
+  const byName = db.queryOne("SELECT id FROM opc_companies WHERE name = ?", input) as { id: string } | null;
+  if (byName) return byName.id;
+  // 最后模糊匹配名称
+  const byLike = db.queryOne("SELECT id FROM opc_companies WHERE name LIKE ?", `%${input}%`) as { id: string } | null;
+  if (byLike) return byLike.id;
+  // 找不到就原样返回，由上层报错
+  return input;
+}
+
+export function registerOpcTool(api: OpenClawPluginApi, db: OpcDatabase): void {
+  const manager = new CompanyManager(db);
+
+  api.registerTool(
+    {
+      name: "opc_manage",
+      label: "OPC 一人公司管理",
+      description: [
+        "一人公司(OPC)全生命周期管理工具。",
+        "操作: register_company(注册公司), get_company(查询公司), list_companies(公司列表),",
+        "update_company(更新公司), activate_company(激活公司), change_company_status(变更状态),",
+        "add_transaction(记账), list_transactions(交易列表), finance_summary(财务摘要),",
+        "add_contact(添加客户), list_contacts(客户列表), update_contact(更新客户),",
+        "delete_contact(删除客户), dashboard(看板统计),",
+        "set_company_skills(设置公司Agent skills), get_company_skills(查询公司Agent skills)",
+      ].join(" "),
+      parameters: OpcManageSchema,
+      async execute(_toolCallId, params) {
+        const p = params as OpcManageParams;
+        try {
+          switch (p.action) {
+            // ── 公司管理 ──
+            case "register_company": {
+              const company = manager.registerCompany({
+                name: p.name,
+                industry: p.industry,
+                owner_name: p.owner_name,
+                owner_contact: p.owner_contact,
+                registered_capital: p.registered_capital,
+                description: p.description,
+              });
+              // 自动创建公司专属 Agent 工作区
+              const skillsRow = db.queryOne("SELECT value FROM opc_tool_config WHERE key = ?", `company_skills_${company.id}`) as { value: string } | null;
+              const companySkills: string[] = skillsRow ? (JSON.parse(skillsRow.value) as string[]) : [];
+              ensureCompanyWorkspace({
+                companyId: company.id,
+                companyName: company.name,
+                cfg: api.config,
+                runtime: api.runtime,
+                log: (msg) => api.logger.info(msg),
+                skills: companySkills,
+              }).catch((err) => api.logger.warn(`opc: 创建工作区失败: ${err}`));
+              return json(company);
+            }
+
+            case "get_company":
+              return json(manager.getCompany(p.company_id) ?? { error: "公司不存在" });
+
+            case "list_companies":
+              return json(
+                manager.listCompanies(p.status as OpcCompanyStatus | undefined),
+              );
+
+            case "update_company":
+              return json(
+                manager.updateCompany(p.company_id, {
+                  name: p.name,
+                  industry: p.industry,
+                  description: p.description,
+                  owner_contact: p.owner_contact,
+                }) ?? { error: "公司不存在" },
+              );
+
+            case "activate_company":
+              return json(manager.activateCompany(p.company_id) ?? { error: "公司不存在" });
+
+            case "change_company_status":
+              return json(
+                manager.transitionStatus(
+                  p.company_id,
+                  p.new_status as OpcCompanyStatus,
+                ) ?? { error: "公司不存在" },
+              );
+
+            // ── 交易记录 ──
+            case "add_transaction":
+              return json(
+                db.createTransaction({
+                  company_id: p.company_id,
+                  type: p.type as OpcTransactionType,
+                  category: (p.category ?? "other") as OpcTransactionCategory,
+                  amount: p.amount,
+                  description: p.description ?? "",
+                  counterparty: p.counterparty ?? "",
+                  transaction_date: p.transaction_date ?? new Date().toISOString().slice(0, 10),
+                }),
+              );
+
+            case "list_transactions":
+              return json(
+                db.listTransactions(p.company_id, {
+                  type: p.type,
+                  startDate: p.start_date,
+                  endDate: p.end_date,
+                  limit: p.limit ?? 50,
+                }),
+              );
+
+            case "finance_summary":
+              return json(
+                db.getFinanceSummary(p.company_id, p.start_date, p.end_date),
+              );
+
+            // ── 客户管理 ──
+            case "add_contact":
+              return json(
+                db.createContact({
+                  company_id: p.company_id,
+                  name: p.name,
+                  phone: p.phone ?? "",
+                  email: p.email ?? "",
+                  company_name: p.company_name ?? "",
+                  tags: p.tags ?? "[]",
+                  notes: p.notes ?? "",
+                  last_contact_date: new Date().toISOString().slice(0, 10),
+                }),
+              );
+
+            case "list_contacts":
+              return json(db.listContacts(p.company_id, p.tag));
+
+            case "update_contact": {
+              const updateData: Record<string, string> = {};
+              if (p.name) updateData.name = p.name;
+              if (p.phone) updateData.phone = p.phone;
+              if (p.email) updateData.email = p.email;
+              if (p.company_name) updateData.company_name = p.company_name;
+              if (p.tags) updateData.tags = p.tags;
+              if (p.notes) updateData.notes = p.notes;
+              if (p.last_contact_date) updateData.last_contact_date = p.last_contact_date;
+              return json(db.updateContact(p.contact_id, updateData) ?? { error: "联系人不存在" });
+            }
+
+            case "delete_contact":
+              return json({ deleted: db.deleteContact(p.contact_id) });
+
+            // ── Dashboard ──
+            case "dashboard":
+              return json(db.getDashboardStats());
+
+            // ── Company Skills (OpenClaw agent-level skills) ──
+            case "set_company_skills": {
+              const resolvedId = resolveCompanyId(db, p.company_id);
+              const key = `company_skills_${resolvedId}`;
+              const value = JSON.stringify(p.skills ?? []);
+              db.execute(
+                `INSERT INTO opc_tool_config (key, value) VALUES (?, ?)
+                 ON CONFLICT(key) DO UPDATE SET value = excluded.value`,
+                key, value,
+              );
+              return json({ ok: true, company_id: resolvedId, skills: p.skills });
+            }
+
+            case "get_company_skills": {
+              const resolvedId = resolveCompanyId(db, p.company_id);
+              const key = `company_skills_${resolvedId}`;
+              const row = db.queryOne("SELECT value FROM opc_tool_config WHERE key = ?", key) as { value: string } | null;
+              const skills = row ? (JSON.parse(row.value) as string[]) : [];
+              return json({ company_id: resolvedId, skills });
+            }
+
+            default:
+              return json({ error: `未知操作: ${(p as { action: string }).action}` });
+          }
+        } catch (err) {
+          return json({ error: err instanceof Error ? err.message : String(err) });
+        }
+      },
+    },
+    { name: "opc_manage" },
+  );
+
+  api.logger.info("opc: 已注册 opc_manage 工具");
+}