galaxy-opc-plugin 0.1.0

package/src/opc/workspace-factory.ts

@@ -0,0 +1,189 @@
+/**
+ * 星环OPC中心 — Agent 工作区工厂
+ *
+ * 为每家一人公司创建独立的 Agent 工作区。
+ * 参照 feishu/dynamic-agent.ts 模式。
+ */
+
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import type { OpenClawConfig, PluginRuntime } from "openclaw/plugin-sdk";
+
+export type CreateWorkspaceResult = {
+  created: boolean;
+  agentId: string;
+  updatedCfg?: OpenClawConfig;
+};
+
+/**
+ * 为公司创建或复用 Agent 工作区。
+ * Agent ID 格式: opc-{companyId}
+ */
+export async function ensureCompanyWorkspace(params: {
+  companyId: string;
+  companyName: string;
+  cfg: OpenClawConfig;
+  runtime: PluginRuntime;
+  log: (msg: string) => void;
+  skills?: string[];
+}): Promise<CreateWorkspaceResult> {
+  const { companyId, companyName, runtime, log, skills } = params;
+  const agentId = `opc-${companyId}`;
+
+  // 每次从磁盘读取最新配置，避免用插件启动时的快照覆盖后续写入
+  const latestCfg = await runtime.config.loadConfig();
+
+  // 检查 Agent 是否已存在
+  const existingAgent = (latestCfg.agents?.list ?? []).find((a) => a.id === agentId);
+  if (existingAgent) {
+    log(`opc: Agent "${agentId}" 已存在，跳过创建`);
+    return { created: false, agentId };
+  }
+
+  // 从主 OPC agent 继承 model 配置；若找不到则用 defaults
+  const opcAgent = (latestCfg.agents?.list ?? []).find((a) => a.id === "opc");
+  const inheritedModel = (opcAgent as { model?: unknown } | undefined)?.model
+    ?? latestCfg.agents?.defaults?.model;
+
+  // 解析工作区路径
+  const workspace = resolveUserPath(`~/.openclaw/opc-workspaces/${companyId}`);
+  const agentDir = resolveUserPath(`~/.openclaw/opc-workspaces/${companyId}/agent`);
+
+  log(`opc: 创建 Agent 工作区 "${agentId}" (${companyName})`);
+  log(`  workspace: ${workspace}`);
+  log(`  agentDir: ${agentDir}`);
+
+  // 创建目录
+  await fs.promises.mkdir(workspace, { recursive: true });
+  await fs.promises.mkdir(agentDir, { recursive: true });
+
+  // 写入 AGENTS.md，内含该公司专属的 sessions_send 回传 session key
+  const agentsMdPath = path.join(workspace, "AGENTS.md");
+  const agentsMdExists = await fs.promises.access(agentsMdPath).then(() => true).catch(() => false);
+  if (!agentsMdExists) {
+    const sessionKey = `agent:${agentId}:main`;
+    await fs.promises.writeFile(agentsMdPath, buildOpcAgentsMd(companyName, sessionKey), "utf-8");
+    log(`opc: 已写入 AGENTS.md (sessionKey: ${sessionKey})`);
+  }
+
+  // 构造新 Agent 条目（类型从 OpenClawConfig 推断，避免依赖未导出的 AgentConfig）
+  type AgentEntry = NonNullable<NonNullable<OpenClawConfig["agents"]>["list"]>[number];
+  const newAgent: AgentEntry = {
+    id: agentId,
+    name: companyName,
+    workspace,
+    agentDir,
+    identity: {
+      name: companyName,
+      theme: "一人公司 AI 员工，提供行政、财务、HR、法务全方位支持",
+      emoji: "🏢",
+    },
+    subagents: { allowAgents: ["*"] } as AgentEntry["subagents"],
+    ...(inheritedModel ? { model: inheritedModel as AgentEntry["model"] } : {}),
+    ...(skills && skills.length > 0 ? { skills: skills as AgentEntry["skills"] } : {}),
+  };
+
+  // 更新配置 — 新增 Agent（不添加 feishu binding，避免干扰现有渠道配置）
+  const updatedCfg: OpenClawConfig = {
+    ...latestCfg,
+    agents: {
+      ...latestCfg.agents,
+      list: [
+        ...(latestCfg.agents?.list ?? []),
+        newAgent,
+      ],
+    },
+  };
+
+  await runtime.config.writeConfigFile(updatedCfg);
+  log(`opc: Agent "${agentId}" 已写入配置文件，重启 Gateway 后生效`);
+  return { created: true, agentId, updatedCfg };
+}
+
+function resolveUserPath(p: string): string {
+  if (p.startsWith("~/")) {
+    return path.join(os.homedir(), p.slice(2));
+  }
+  return p;
+}
+
+/**
+ * 生成公司专属的 AGENTS.md 内容。
+ * sessionKey 硬编码为该公司 agent 的 main session，确保 subagent 回传时不会路由到错误的公司。
+ */
+function buildOpcAgentsMd(companyName: string, sessionKey: string): string {
+  return `# AGENTS.md - Your Workspace
+
+This folder is home. Treat it that way.
+
+## Every Session
+
+Before doing anything else:
+
+1. Read \`SOUL.md\` — this is who you are
+2. Read \`USER.md\` — this is who you're helping
+3. Read \`memory/YYYY-MM-DD.md\` (today + yesterday) for recent context
+4. **If in MAIN SESSION** (direct chat with your human): Also read \`MEMORY.md\`
+
+Don't ask permission. Just do it.
+
+## Memory
+
+You wake up fresh each session. These files are your continuity:
+
+- **Daily notes:** \`memory/YYYY-MM-DD.md\` (create \`memory/\` if needed) — raw logs of what happened
+- **Long-term:** \`MEMORY.md\` — your curated memories, like a human's long-term memory
+
+## Safety
+
+- Don't exfiltrate private data. Ever.
+- Don't run destructive commands without asking.
+- When in doubt, ask.
+
+---
+
+## OPC ${companyName} — AI 员工调度规则
+
+你是${companyName}的 AI 助理总管，服务于公司老板（用户）。
+
+### 核心职责
+
+- 接收老板指令，判断是自己处理还是派遣 AI 员工
+- 通过 \`sessions_spawn\` 工具把专业任务分配给对应 AI 员工
+- 多任务时并行派遣，不必串行等待
+- 员工完成后结果自动回到本对话，你负责简洁汇总
+
+### 派遣任务的格式
+
+调用 \`sessions_spawn\` 时，\`task\` 参数内容：
+
+\`\`\`
+[角色设定]
+{该员工的系统提示词，从上下文中的"AI 员工团队"部分获取}
+
+[公司信息]
+公司名称：${companyName}
+{其他公司信息}
+
+[任务]
+{老板交代的具体任务，要详细完整，因为员工没有本对话的上下文}
+
+[完成后操作]
+任务完成后，必须使用 sessions_send 工具将结果发送回：
+- sessionKey: "${sessionKey}"
+- message: 你的完整工作结果报告
+\`\`\`
+
+### 调度判断
+
+- 老板明确说「让财务/法务/HR...」→ 直接派对应员工
+- 老板说「帮我算税/出报表」→ 判断属于哪个专业方向再派
+- 多件事同时 → 并行派多个员工
+- 闲聊/简单问题 → 自己直接回答
+
+### 工具说明
+
+AI 员工在 subagent 里运行，可以使用所有 opc_* 工具操作公司数据库，结果会持久化保存。
+`;
+}

package/src/tools/acquisition-tool.ts

@@ -0,0 +1,150 @@
+/**
+ * 星环OPC中心 — opc_acquisition 收并购管理工具
+ *
+ * 资金闭环核心模块：当一人公司经营不善时，星河数科依据参股协议
+ * 发起收并购，亏损可抵扣应纳税所得额，并为后续资产包打包做准备。
+ */
+
+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 AcquisitionSchema = Type.Union([
+  Type.Object({
+    action: Type.Literal("create_acquisition"),
+    company_id: Type.String({ description: "被收购公司 ID" }),
+    trigger_reason: Type.String({ description: "发起收购原因，如：连续亏损、市场萎缩、创始人退出等" }),
+    acquisition_price: Type.Number({ description: "收购价格（元），通常低于注册资本" }),
+    loss_amount: Type.Optional(Type.Number({ description: "公司累计亏损金额（元），用于税务抵扣计算" })),
+    notes: Type.Optional(Type.String({ description: "备注" })),
+  }),
+  Type.Object({
+    action: Type.Literal("list_acquisitions"),
+    status: Type.Optional(Type.String({ description: "按状态筛选: evaluating/in_progress/completed/cancelled" })),
+    company_id: Type.Optional(Type.String({ description: "按公司筛选" })),
+  }),
+  Type.Object({
+    action: Type.Literal("update_acquisition"),
+    case_id: Type.String({ description: "收并购案例 ID" }),
+    status: Type.Optional(Type.String({ description: "新状态: evaluating/in_progress/completed/cancelled" })),
+    acquisition_price: Type.Optional(Type.Number({ description: "最终收购价格（元）" })),
+    loss_amount: Type.Optional(Type.Number({ description: "确认亏损金额（元）" })),
+    tax_deduction: Type.Optional(Type.Number({ description: "可抵扣税额（元），通常 = 亏损 × 企业所得税率25%" })),
+    closed_date: Type.Optional(Type.String({ description: "完成日期 (YYYY-MM-DD)" })),
+    notes: Type.Optional(Type.String({ description: "备注" })),
+  }),
+  Type.Object({
+    action: Type.Literal("acquisition_summary"),
+    description: Type.Optional(Type.String({ description: "汇总平台所有收并购数据，含税务优化总额" })),
+  }),
+]);
+
+type AcquisitionParams = Static<typeof AcquisitionSchema>;
+
+export function registerAcquisitionTool(api: OpenClawPluginApi, db: OpcDatabase): void {
+  api.registerTool(
+    {
+      name: "opc_acquisition",
+      label: "OPC 收并购管理",
+      description:
+        "收并购管理工具（资金闭环核心）。操作: " +
+        "create_acquisition(发起收购，记录亏损公司收购案例), " +
+        "list_acquisitions(收并购列表，可按状态/公司筛选), " +
+        "update_acquisition(更新案例状态/价格/税务抵扣), " +
+        "acquisition_summary(平台收并购汇总：总收购数、累计亏损、税务优化总额)",
+      parameters: AcquisitionSchema,
+      async execute(_toolCallId, params) {
+        const p = params as AcquisitionParams;
+        try {
+          switch (p.action) {
+            case "create_acquisition": {
+              const id = db.genId();
+              const now = new Date().toISOString();
+              const lossAmount = p.loss_amount ?? 0;
+              // 粗算税务抵扣：亏损 × 25% 企业所得税率
+              const taxDeduction = lossAmount * 0.25;
+
+              db.execute(
+                `INSERT INTO opc_acquisition_cases
+                   (id, company_id, acquirer_id, case_type, status, trigger_reason,
+                    acquisition_price, loss_amount, tax_deduction, initiated_date, notes, created_at, updated_at)
+                 VALUES (?, ?, 'starriver', 'acquisition', 'evaluating', ?, ?, ?, ?, date('now'), ?, ?, ?)`,
+                id, p.company_id, p.trigger_reason,
+                p.acquisition_price, lossAmount, taxDeduction,
+                p.notes ?? "", now, now,
+              );
+
+              // 同步将公司状态标记为 acquired
+              db.execute(
+                `UPDATE opc_companies SET status = 'acquired', updated_at = ? WHERE id = ?`,
+                now, p.company_id,
+              );
+
+              const row = db.queryOne(
+                `SELECT a.*, c.name as company_name FROM opc_acquisition_cases a
+                 LEFT JOIN opc_companies c ON a.company_id = c.id
+                 WHERE a.id = ?`,
+                id,
+              );
+              return json({ ok: true, case: row, note: `税务优化估算：亏损 ${lossAmount.toLocaleString()} 元 × 25% = 可抵扣 ${taxDeduction.toLocaleString()} 元` });
+            }
+
+            case "list_acquisitions": {
+              let sql = `SELECT a.*, c.name as company_name, c.industry
+                         FROM opc_acquisition_cases a
+                         LEFT JOIN opc_companies c ON a.company_id = c.id
+                         WHERE 1=1`;
+              const vals: unknown[] = [];
+              if (p.status) { sql += " AND a.status = ?"; vals.push(p.status); }
+              if (p.company_id) { sql += " AND a.company_id = ?"; vals.push(p.company_id); }
+              sql += " ORDER BY a.created_at DESC";
+              return json(db.query(sql, ...vals));
+            }
+
+            case "update_acquisition": {
+              const sets: string[] = ["updated_at = ?"];
+              const vals: unknown[] = [new Date().toISOString()];
+              if (p.status !== undefined) { sets.push("status = ?"); vals.push(p.status); }
+              if (p.acquisition_price !== undefined) { sets.push("acquisition_price = ?"); vals.push(p.acquisition_price); }
+              if (p.loss_amount !== undefined) { sets.push("loss_amount = ?"); vals.push(p.loss_amount); }
+              if (p.tax_deduction !== undefined) { sets.push("tax_deduction = ?"); vals.push(p.tax_deduction); }
+              if (p.closed_date !== undefined) { sets.push("closed_date = ?"); vals.push(p.closed_date); }
+              if (p.notes !== undefined) { sets.push("notes = ?"); vals.push(p.notes); }
+              vals.push(p.case_id);
+              db.execute(`UPDATE opc_acquisition_cases SET ${sets.join(", ")} WHERE id = ?`, ...vals);
+              return json(db.queryOne(
+                `SELECT a.*, c.name as company_name FROM opc_acquisition_cases a
+                 LEFT JOIN opc_companies c ON a.company_id = c.id WHERE a.id = ?`,
+                p.case_id,
+              ));
+            }
+
+            case "acquisition_summary": {
+              const summary = db.queryOne(
+                `SELECT
+                   COUNT(*) as total_cases,
+                   COUNT(CASE WHEN status = 'completed' THEN 1 END) as completed,
+                   COUNT(CASE WHEN status = 'in_progress' THEN 1 END) as in_progress,
+                   COUNT(CASE WHEN status = 'evaluating' THEN 1 END) as evaluating,
+                   COALESCE(SUM(acquisition_price), 0) as total_acquisition_cost,
+                   COALESCE(SUM(loss_amount), 0) as total_loss_amount,
+                   COALESCE(SUM(tax_deduction), 0) as total_tax_deduction
+                 FROM opc_acquisition_cases`,
+              );
+              return json(summary);
+            }
+
+            default:
+              return json({ error: `未知操作: ${(p as { action: string }).action}` });
+          }
+        } catch (err) {
+          return json({ error: err instanceof Error ? err.message : String(err) });
+        }
+      },
+    },
+    { name: "opc_acquisition" },
+  );
+
+  api.logger.info("opc: 已注册 opc_acquisition 工具");
+}

package/src/tools/asset-package-tool.ts

@@ -0,0 +1,283 @@
+/**
+ * 星环OPC中心 — opc_asset_package 资产包管理工具
+ *
+ * 资金闭环第二阶段：将收并购回来的公司整合打包，
+ * 形成具有真实运营数据和科创属性的"资产包"，
+ * 转让给城投公司，协助城投申请科创贷，并收取融资服务费。
+ */
+
+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 AssetPackageSchema = Type.Union([
+  // ── 资产包管理 ──
+  Type.Object({
+    action: Type.Literal("create_asset_package"),
+    name: Type.String({ description: "资产包名称，如「仁和区2026Q1科创资产包」" }),
+    description: Type.Optional(Type.String({ description: "资产包描述，包含科创属性说明" })),
+    notes: Type.Optional(Type.String({ description: "备注" })),
+  }),
+  Type.Object({
+    action: Type.Literal("add_company_to_package"),
+    package_id: Type.String({ description: "资产包 ID" }),
+    company_id: Type.String({ description: "要加入的公司 ID（应为已收并购状态）" }),
+    acquisition_case_id: Type.Optional(Type.String({ description: "关联的收并购案例 ID" })),
+    valuation: Type.Number({ description: "该公司在资产包中的估值（元）" }),
+  }),
+  Type.Object({
+    action: Type.Literal("list_asset_packages"),
+    status: Type.Optional(Type.String({ description: "按状态筛选: assembling/ready/transferred/closed" })),
+  }),
+  Type.Object({
+    action: Type.Literal("get_package_detail"),
+    package_id: Type.String({ description: "资产包 ID" }),
+  }),
+  Type.Object({
+    action: Type.Literal("update_package"),
+    package_id: Type.String({ description: "资产包 ID" }),
+    status: Type.Optional(Type.String({ description: "新状态: assembling/ready/transferred/closed" })),
+    sci_tech_certified: Type.Optional(Type.Number({ description: "科创认定企业数量" })),
+    assembled_date: Type.Optional(Type.String({ description: "打包完成日期 (YYYY-MM-DD)" })),
+    notes: Type.Optional(Type.String({ description: "备注" })),
+  }),
+  // ── 城投转让 ──
+  Type.Object({
+    action: Type.Literal("create_ct_transfer"),
+    package_id: Type.String({ description: "资产包 ID" }),
+    ct_company: Type.String({ description: "城投公司名称，如「仁和工发集团」" }),
+    transfer_price: Type.Number({ description: "资产包转让价格（元）" }),
+    sci_loan_target: Type.Optional(Type.Number({ description: "城投目标科创贷金额（元）" })),
+    transfer_date: Type.Optional(Type.String({ description: "转让日期 (YYYY-MM-DD)" })),
+    notes: Type.Optional(Type.String({ description: "备注" })),
+  }),
+  Type.Object({
+    action: Type.Literal("update_ct_transfer"),
+    transfer_id: Type.String({ description: "城投转让记录 ID" }),
+    status: Type.Optional(Type.String({ description: "新状态: negotiating/signed/completed/cancelled" })),
+    sci_loan_actual: Type.Optional(Type.Number({ description: "城投实际获得科创贷金额（元）" })),
+    loan_date: Type.Optional(Type.String({ description: "放款日期 (YYYY-MM-DD)" })),
+    notes: Type.Optional(Type.String({ description: "备注" })),
+  }),
+  Type.Object({
+    action: Type.Literal("list_ct_transfers"),
+    status: Type.Optional(Type.String({ description: "按状态筛选" })),
+  }),
+  // ── 融资服务费 ──
+  Type.Object({
+    action: Type.Literal("record_financing_fee"),
+    transfer_id: Type.String({ description: "城投转让记录 ID" }),
+    base_amount: Type.Number({ description: "计费基数（通常为科创贷实际金额，元）" }),
+    fee_rate: Type.Number({ description: "服务费率（%），通常 1%-3%" }),
+    notes: Type.Optional(Type.String({ description: "备注" })),
+  }),
+  Type.Object({
+    action: Type.Literal("update_financing_fee"),
+    fee_id: Type.String({ description: "融资服务费记录 ID" }),
+    status: Type.Optional(Type.String({ description: "新状态: pending/invoiced/paid" })),
+    invoiced: Type.Optional(Type.Number({ description: "是否已开票: 1=是, 0=否" })),
+    paid_date: Type.Optional(Type.String({ description: "收款日期 (YYYY-MM-DD)" })),
+    notes: Type.Optional(Type.String({ description: "备注" })),
+  }),
+  // ── 汇总报表 ──
+  Type.Object({
+    action: Type.Literal("closure_summary"),
+    description: Type.Optional(Type.String({ description: "资金闭环整体汇总：资产包数、城投转让总额、科创贷总额、融资服务费总收入" })),
+  }),
+]);
+
+type AssetPackageParams = Static<typeof AssetPackageSchema>;
+
+export function registerAssetPackageTool(api: OpenClawPluginApi, db: OpcDatabase): void {
+  api.registerTool(
+    {
+      name: "opc_asset_package",
+      label: "OPC 资产包与城投转让",
+      description:
+        "资产包管理与城投转让工具（资金闭环核心）。操作: " +
+        "create_asset_package(创建资产包), add_company_to_package(将已收并购公司加入资产包), " +
+        "list_asset_packages(资产包列表), get_package_detail(资产包详情+成员公司), update_package(更新状态/科创认定数), " +
+        "create_ct_transfer(发起城投转让), update_ct_transfer(更新转让状态/科创贷金额), list_ct_transfers(转让记录列表), " +
+        "record_financing_fee(记录融资服务费), update_financing_fee(更新收款状态), " +
+        "closure_summary(资金闭环汇总报表)",
+      parameters: AssetPackageSchema,
+      async execute(_toolCallId, params) {
+        const p = params as AssetPackageParams;
+        try {
+          switch (p.action) {
+            case "create_asset_package": {
+              const id = db.genId();
+              const now = new Date().toISOString();
+              db.execute(
+                `INSERT INTO opc_asset_packages
+                   (id, name, description, status, total_valuation, company_count, sci_tech_certified, notes, created_at, updated_at)
+                 VALUES (?, ?, ?, 'assembling', 0, 0, 0, ?, ?, ?)`,
+                id, p.name, p.description ?? "", p.notes ?? "", now, now,
+              );
+              return json({ ok: true, package: db.queryOne("SELECT * FROM opc_asset_packages WHERE id = ?", id) });
+            }
+
+            case "add_company_to_package": {
+              const id = db.genId();
+              const now = new Date().toISOString();
+              db.execute(
+                `INSERT INTO opc_asset_package_items (id, package_id, company_id, acquisition_case_id, valuation, created_at)
+                 VALUES (?, ?, ?, ?, ?, ?)`,
+                id, p.package_id, p.company_id, p.acquisition_case_id ?? "", p.valuation, now,
+              );
+              // 更新资产包汇总
+              db.execute(
+                `UPDATE opc_asset_packages
+                 SET company_count = (SELECT COUNT(*) FROM opc_asset_package_items WHERE package_id = ?),
+                     total_valuation = (SELECT COALESCE(SUM(valuation),0) FROM opc_asset_package_items WHERE package_id = ?),
+                     updated_at = ?
+                 WHERE id = ?`,
+                p.package_id, p.package_id, now, p.package_id,
+              );
+              const pkg = db.queryOne("SELECT * FROM opc_asset_packages WHERE id = ?", p.package_id);
+              return json({ ok: true, item_id: id, package: pkg });
+            }
+
+            case "list_asset_packages": {
+              let sql = "SELECT * FROM opc_asset_packages WHERE 1=1";
+              const vals: unknown[] = [];
+              if (p.status) { sql += " AND status = ?"; vals.push(p.status); }
+              sql += " ORDER BY created_at DESC";
+              return json(db.query(sql, ...vals));
+            }
+
+            case "get_package_detail": {
+              const pkg = db.queryOne("SELECT * FROM opc_asset_packages WHERE id = ?", p.package_id);
+              if (!pkg) return json({ error: "资产包不存在" });
+              const items = db.query(
+                `SELECT i.*, c.name as company_name, c.industry, c.status as company_status
+                 FROM opc_asset_package_items i
+                 LEFT JOIN opc_companies c ON i.company_id = c.id
+                 WHERE i.package_id = ?
+                 ORDER BY i.created_at`,
+                p.package_id,
+              );
+              const transfers = db.query(
+                "SELECT * FROM opc_ct_transfers WHERE package_id = ? ORDER BY created_at DESC",
+                p.package_id,
+              );
+              return json({ package: pkg, companies: items, transfers });
+            }
+
+            case "update_package": {
+              const sets: string[] = ["updated_at = ?"];
+              const vals: unknown[] = [new Date().toISOString()];
+              if (p.status !== undefined) { sets.push("status = ?"); vals.push(p.status); }
+              if (p.sci_tech_certified !== undefined) { sets.push("sci_tech_certified = ?"); vals.push(p.sci_tech_certified); }
+              if (p.assembled_date !== undefined) { sets.push("assembled_date = ?"); vals.push(p.assembled_date); }
+              if (p.notes !== undefined) { sets.push("notes = ?"); vals.push(p.notes); }
+              vals.push(p.package_id);
+              db.execute(`UPDATE opc_asset_packages SET ${sets.join(", ")} WHERE id = ?`, ...vals);
+              return json(db.queryOne("SELECT * FROM opc_asset_packages WHERE id = ?", p.package_id));
+            }
+
+            case "create_ct_transfer": {
+              const id = db.genId();
+              const now = new Date().toISOString();
+              db.execute(
+                `INSERT INTO opc_ct_transfers
+                   (id, package_id, ct_company, transfer_price, status, sci_loan_target, sci_loan_actual, transfer_date, notes, created_at, updated_at)
+                 VALUES (?, ?, ?, ?, 'negotiating', ?, 0, ?, ?, ?, ?)`,
+                id, p.package_id, p.ct_company, p.transfer_price,
+                p.sci_loan_target ?? 0, p.transfer_date ?? "", p.notes ?? "", now, now,
+              );
+              // 更新资产包状态
+              db.execute("UPDATE opc_asset_packages SET status = 'transferred', updated_at = ? WHERE id = ?", now, p.package_id);
+              return json({ ok: true, transfer: db.queryOne("SELECT * FROM opc_ct_transfers WHERE id = ?", id) });
+            }
+
+            case "update_ct_transfer": {
+              const sets: string[] = ["updated_at = ?"];
+              const vals: unknown[] = [new Date().toISOString()];
+              if (p.status !== undefined) { sets.push("status = ?"); vals.push(p.status); }
+              if (p.sci_loan_actual !== undefined) { sets.push("sci_loan_actual = ?"); vals.push(p.sci_loan_actual); }
+              if (p.loan_date !== undefined) { sets.push("loan_date = ?"); vals.push(p.loan_date); }
+              if (p.notes !== undefined) { sets.push("notes = ?"); vals.push(p.notes); }
+              vals.push(p.transfer_id);
+              db.execute(`UPDATE opc_ct_transfers SET ${sets.join(", ")} WHERE id = ?`, ...vals);
+              return json(db.queryOne("SELECT * FROM opc_ct_transfers WHERE id = ?", p.transfer_id));
+            }
+
+            case "list_ct_transfers": {
+              let sql = `SELECT t.*, p.name as package_name, p.company_count
+                         FROM opc_ct_transfers t
+                         LEFT JOIN opc_asset_packages p ON t.package_id = p.id
+                         WHERE 1=1`;
+              const vals: unknown[] = [];
+              if (p.status) { sql += " AND t.status = ?"; vals.push(p.status); }
+              sql += " ORDER BY t.created_at DESC";
+              return json(db.query(sql, ...vals));
+            }
+
+            case "record_financing_fee": {
+              const id = db.genId();
+              const now = new Date().toISOString();
+              const feeAmount = p.base_amount * (p.fee_rate / 100);
+              db.execute(
+                `INSERT INTO opc_financing_fees
+                   (id, transfer_id, fee_rate, fee_amount, base_amount, status, invoiced, notes, created_at, updated_at)
+                 VALUES (?, ?, ?, ?, ?, 'pending', 0, ?, ?, ?)`,
+                id, p.transfer_id, p.fee_rate, feeAmount, p.base_amount, p.notes ?? "", now, now,
+              );
+              return json({
+                ok: true,
+                fee: db.queryOne("SELECT * FROM opc_financing_fees WHERE id = ?", id),
+                calculation: `${p.base_amount.toLocaleString()} 元 × ${p.fee_rate}% = ${feeAmount.toLocaleString()} 元`,
+              });
+            }
+
+            case "update_financing_fee": {
+              const sets: string[] = ["updated_at = ?"];
+              const vals: unknown[] = [new Date().toISOString()];
+              if (p.status !== undefined) { sets.push("status = ?"); vals.push(p.status); }
+              if (p.invoiced !== undefined) { sets.push("invoiced = ?"); vals.push(p.invoiced); }
+              if (p.paid_date !== undefined) { sets.push("paid_date = ?"); vals.push(p.paid_date); }
+              if (p.notes !== undefined) { sets.push("notes = ?"); vals.push(p.notes); }
+              vals.push(p.fee_id);
+              db.execute(`UPDATE opc_financing_fees SET ${sets.join(", ")} WHERE id = ?`, ...vals);
+              return json(db.queryOne("SELECT * FROM opc_financing_fees WHERE id = ?", p.fee_id));
+            }
+
+            case "closure_summary": {
+              const packages = db.queryOne(
+                `SELECT COUNT(*) as total, COUNT(CASE WHEN status='transferred' THEN 1 END) as transferred,
+                        COALESCE(SUM(total_valuation),0) as total_valuation,
+                        COALESCE(SUM(company_count),0) as total_companies,
+                        COALESCE(SUM(sci_tech_certified),0) as sci_tech_certified
+                 FROM opc_asset_packages`,
+              );
+              const transfers = db.queryOne(
+                `SELECT COUNT(*) as total,
+                        COALESCE(SUM(transfer_price),0) as total_transfer_price,
+                        COALESCE(SUM(sci_loan_target),0) as total_loan_target,
+                        COALESCE(SUM(sci_loan_actual),0) as total_loan_actual
+                 FROM opc_ct_transfers`,
+              );
+              const fees = db.queryOne(
+                `SELECT COUNT(*) as total,
+                        COALESCE(SUM(fee_amount),0) as total_fee,
+                        COALESCE(SUM(CASE WHEN status='paid' THEN fee_amount ELSE 0 END),0) as collected_fee
+                 FROM opc_financing_fees`,
+              );
+              return json({ asset_packages: packages, ct_transfers: transfers, financing_fees: fees });
+            }
+
+            default:
+              return json({ error: `未知操作: ${(p as { action: string }).action}` });
+          }
+        } catch (err) {
+          return json({ error: err instanceof Error ? err.message : String(err) });
+        }
+      },
+    },
+    { name: "opc_asset_package" },
+  );
+
+  api.logger.info("opc: 已注册 opc_asset_package 工具");
+}