galaxy-opc-plugin 0.1.0

package/src/db/sqlite-adapter.ts

@@ -0,0 +1,366 @@
+/**
+ * 星环OPC中心 — SQLite 数据库适配器
+ */
+
+import Database from "better-sqlite3";
+import type {
+  OpcCompany,
+  OpcCompanyStatus,
+  OpcContact,
+  OpcEmployee,
+  OpcTransaction,
+} from "../opc/types.js";
+import type { OpcDatabase } from "./index.js";
+import { runMigrations } from "./migrations.js";
+import { OPC_INDEXES, OPC_TABLES } from "./schema.js";
+
+function generateId(): string {
+  return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+
+export class SqliteAdapter implements OpcDatabase {
+  private db: Database.Database;
+
+  constructor(dbPath: string) {
+    this.db = new Database(dbPath);
+    this.db.pragma("journal_mode = WAL");
+    this.db.pragma("foreign_keys = ON");
+    this.initialize();
+  }
+
+  private initialize(): void {
+    for (const sql of Object.values(OPC_TABLES)) {
+      this.db.exec(sql);
+    }
+    for (const idx of OPC_INDEXES) {
+      this.db.exec(idx);
+    }
+    runMigrations(this.db);
+  }
+
+  /** 通用查询方法，供 Phase 2 工具使用 */
+  query(sql: string, ...params: unknown[]): unknown[] {
+    return this.db.prepare(sql).all(...params);
+  }
+
+  /** 通用单行查询 */
+  queryOne(sql: string, ...params: unknown[]): unknown | null {
+    return this.db.prepare(sql).get(...params) ?? null;
+  }
+
+  /** 通用执行 */
+  execute(sql: string, ...params: unknown[]): { changes: number } {
+    const result = this.db.prepare(sql).run(...params);
+    return { changes: result.changes };
+  }
+
+  /** 生成 ID（公开版本供工具使用） */
+  genId(): string {
+    return generateId();
+  }
+
+  close(): void {
+    this.db.close();
+  }
+
+  // ── Companies ──────────────────────────────────────────────
+
+  createCompany(data: Omit<OpcCompany, "id" | "created_at" | "updated_at">): OpcCompany {
+    const id = generateId();
+    const now = new Date().toISOString();
+    this.db
+      .prepare(
+        `INSERT INTO opc_companies (id, name, industry, owner_name, owner_contact, status, registered_capital, description, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      )
+      .run(
+        id,
+        data.name,
+        data.industry,
+        data.owner_name,
+        data.owner_contact,
+        data.status,
+        data.registered_capital,
+        data.description,
+        now,
+        now,
+      );
+    return this.getCompany(id)!;
+  }
+
+  getCompany(id: string): OpcCompany | null {
+    return (this.db.prepare("SELECT * FROM opc_companies WHERE id = ?").get(id) as OpcCompany) ?? null;
+  }
+
+  listCompanies(status?: OpcCompanyStatus): OpcCompany[] {
+    if (status) {
+      return this.db
+        .prepare("SELECT * FROM opc_companies WHERE status = ? ORDER BY created_at DESC")
+        .all(status) as OpcCompany[];
+    }
+    return this.db
+      .prepare("SELECT * FROM opc_companies ORDER BY created_at DESC")
+      .all() as OpcCompany[];
+  }
+
+  updateCompany(id: string, data: Partial<OpcCompany>): OpcCompany | null {
+    const existing = this.getCompany(id);
+    if (!existing) return null;
+
+    const ALLOWED = new Set(["name", "industry", "owner_name", "owner_contact",
+      "status", "registered_capital", "description"]);
+
+    const fields: string[] = [];
+    const values: unknown[] = [];
+
+    for (const [key, val] of Object.entries(data)) {
+      if (!ALLOWED.has(key)) continue;
+      fields.push(`${key} = ?`);
+      values.push(val);
+    }
+    fields.push("updated_at = ?");
+    values.push(new Date().toISOString());
+    values.push(id);
+
+    this.db.prepare(`UPDATE opc_companies SET ${fields.join(", ")} WHERE id = ?`).run(...values);
+    return this.getCompany(id);
+  }
+
+  deleteCompany(id: string): boolean {
+    const result = this.db.prepare("DELETE FROM opc_companies WHERE id = ?").run(id);
+    return result.changes > 0;
+  }
+
+  // ── Employees ──────────────────────────────────────────────
+
+  createEmployee(data: Omit<OpcEmployee, "id" | "created_at">): OpcEmployee {
+    const id = generateId();
+    const now = new Date().toISOString();
+    this.db
+      .prepare(
+        `INSERT INTO opc_employees (id, company_id, name, role, skills, status, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`,
+      )
+      .run(id, data.company_id, data.name, data.role, data.skills, data.status, now);
+    return this.getEmployee(id)!;
+  }
+
+  getEmployee(id: string): OpcEmployee | null {
+    return (this.db.prepare("SELECT * FROM opc_employees WHERE id = ?").get(id) as OpcEmployee) ?? null;
+  }
+
+  listEmployees(companyId: string): OpcEmployee[] {
+    return this.db
+      .prepare("SELECT * FROM opc_employees WHERE company_id = ? ORDER BY created_at DESC")
+      .all(companyId) as OpcEmployee[];
+  }
+
+  // ── Transactions ───────────────────────────────────────────
+
+  createTransaction(data: Omit<OpcTransaction, "id" | "created_at">): OpcTransaction {
+    const id = generateId();
+    const now = new Date().toISOString();
+    this.db
+      .prepare(
+        `INSERT INTO opc_transactions (id, company_id, type, category, amount, description, counterparty, transaction_date, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      )
+      .run(
+        id,
+        data.company_id,
+        data.type,
+        data.category,
+        data.amount,
+        data.description,
+        data.counterparty,
+        data.transaction_date,
+        now,
+      );
+    return this.getTransaction(id)!;
+  }
+
+  getTransaction(id: string): OpcTransaction | null {
+    return (
+      (this.db.prepare("SELECT * FROM opc_transactions WHERE id = ?").get(id) as OpcTransaction) ?? null
+    );
+  }
+
+  listTransactions(
+    companyId: string,
+    opts?: { type?: string; startDate?: string; endDate?: string; limit?: number },
+  ): OpcTransaction[] {
+    let sql = "SELECT * FROM opc_transactions WHERE company_id = ?";
+    const params: unknown[] = [companyId];
+
+    if (opts?.type) {
+      sql += " AND type = ?";
+      params.push(opts.type);
+    }
+    if (opts?.startDate) {
+      sql += " AND transaction_date >= ?";
+      params.push(opts.startDate);
+    }
+    if (opts?.endDate) {
+      sql += " AND transaction_date <= ?";
+      params.push(opts.endDate);
+    }
+    sql += " ORDER BY transaction_date DESC";
+    if (opts?.limit) {
+      sql += " LIMIT ?";
+      params.push(opts.limit);
+    }
+
+    return this.db.prepare(sql).all(...params) as OpcTransaction[];
+  }
+
+  getFinanceSummary(
+    companyId: string,
+    startDate?: string,
+    endDate?: string,
+  ): { total_income: number; total_expense: number; net: number; count: number } {
+    let sql = `
+      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,
+        COUNT(*) as count
+      FROM opc_transactions
+      WHERE company_id = ?
+    `;
+    const params: unknown[] = [companyId];
+
+    if (startDate) {
+      sql += " AND transaction_date >= ?";
+      params.push(startDate);
+    }
+    if (endDate) {
+      sql += " AND transaction_date <= ?";
+      params.push(endDate);
+    }
+
+    const row = this.db.prepare(sql).get(...params) as {
+      total_income: number;
+      total_expense: number;
+      count: number;
+    };
+    return {
+      total_income: row.total_income,
+      total_expense: row.total_expense,
+      net: row.total_income - row.total_expense,
+      count: row.count,
+    };
+  }
+
+  // ── Contacts ───────────────────────────────────────────────
+
+  createContact(data: Omit<OpcContact, "id" | "created_at" | "updated_at">): OpcContact {
+    const id = generateId();
+    const now = new Date().toISOString();
+    this.db
+      .prepare(
+        `INSERT INTO opc_contacts (id, company_id, name, phone, email, company_name, tags, notes, last_contact_date, created_at, updated_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      )
+      .run(
+        id,
+        data.company_id,
+        data.name,
+        data.phone,
+        data.email,
+        data.company_name,
+        data.tags,
+        data.notes,
+        data.last_contact_date,
+        now,
+        now,
+      );
+    return this.getContact(id)!;
+  }
+
+  getContact(id: string): OpcContact | null {
+    return (this.db.prepare("SELECT * FROM opc_contacts WHERE id = ?").get(id) as OpcContact) ?? null;
+  }
+
+  listContacts(companyId: string, tag?: string): OpcContact[] {
+    if (tag) {
+      return this.db
+        .prepare(
+          "SELECT * FROM opc_contacts WHERE company_id = ? AND tags LIKE ? ORDER BY updated_at DESC",
+        )
+        .all(companyId, `%${tag}%`) as OpcContact[];
+    }
+    return this.db
+      .prepare("SELECT * FROM opc_contacts WHERE company_id = ? ORDER BY updated_at DESC")
+      .all(companyId) as OpcContact[];
+  }
+
+  updateContact(id: string, data: Partial<OpcContact>): OpcContact | null {
+    const existing = this.getContact(id);
+    if (!existing) return null;
+
+    const ALLOWED = new Set(["name", "phone", "email", "company_name",
+      "tags", "notes", "last_contact_date"]);
+
+    const fields: string[] = [];
+    const values: unknown[] = [];
+
+    for (const [key, val] of Object.entries(data)) {
+      if (!ALLOWED.has(key)) continue;
+      fields.push(`${key} = ?`);
+      values.push(val);
+    }
+    fields.push("updated_at = ?");
+    values.push(new Date().toISOString());
+    values.push(id);
+
+    this.db.prepare(`UPDATE opc_contacts SET ${fields.join(", ")} WHERE id = ?`).run(...values);
+    return this.getContact(id);
+  }
+
+  deleteContact(id: string): boolean {
+    const result = this.db.prepare("DELETE FROM opc_contacts WHERE id = ?").run(id);
+    return result.changes > 0;
+  }
+
+  // ── Dashboard ──────────────────────────────────────────────
+
+  getDashboardStats(): {
+    total_companies: number;
+    active_companies: number;
+    total_transactions: number;
+    total_contacts: number;
+    total_revenue: number;
+    total_expense: number;
+  } {
+    const companies = this.db
+      .prepare(
+        `SELECT
+          COUNT(*) as total,
+          SUM(CASE WHEN status='active' THEN 1 ELSE 0 END) as active
+        FROM opc_companies`,
+      )
+      .get() as { total: number; active: number };
+
+    const transactions = this.db
+      .prepare(
+        `SELECT
+          COUNT(*) as total,
+          COALESCE(SUM(CASE WHEN type='income' THEN amount ELSE 0 END), 0) as revenue,
+          COALESCE(SUM(CASE WHEN type='expense' THEN amount ELSE 0 END), 0) as expense
+        FROM opc_transactions`,
+      )
+      .get() as { total: number; revenue: number; expense: number };
+
+    const contacts = this.db
+      .prepare("SELECT COUNT(*) as total FROM opc_contacts")
+      .get() as { total: number };
+
+    return {
+      total_companies: companies.total,
+      active_companies: companies.active,
+      total_transactions: transactions.total,
+      total_contacts: contacts.total,
+      total_revenue: transactions.revenue,
+      total_expense: transactions.expense,
+    };
+  }
+}

package/src/opc/company-manager.ts

@@ -0,0 +1,82 @@
+/**
+ * 星环OPC中心 — 公司管理器
+ *
+ * 负责公司 CRUD、状态流转和后台服务。
+ */
+
+import type { OpcDatabase } from "../db/index.js";
+import type { OpcCompany, OpcCompanyStatus } from "./types.js";
+
+/** 合法的状态流转规则 */
+const VALID_TRANSITIONS: Record<OpcCompanyStatus, OpcCompanyStatus[]> = {
+  pending: ["active", "terminated"],
+  active: ["suspended", "acquired", "packaged", "terminated"],
+  suspended: ["active", "terminated"],
+  acquired: ["terminated"],
+  packaged: ["terminated"],
+  terminated: [],
+};
+
+export class CompanyManager {
+  constructor(private db: OpcDatabase) {}
+
+  /** 注册新公司（状态为 pending） */
+  registerCompany(data: {
+    name: string;
+    industry: string;
+    owner_name: string;
+    owner_contact?: string;
+    registered_capital?: number;
+    description?: string;
+  }): OpcCompany {
+    return this.db.createCompany({
+      name: data.name,
+      industry: data.industry,
+      owner_name: data.owner_name,
+      owner_contact: data.owner_contact ?? "",
+      status: "pending",
+      registered_capital: data.registered_capital ?? 0,
+      description: data.description ?? "",
+    });
+  }
+
+  /** 激活公司 */
+  activateCompany(companyId: string): OpcCompany | null {
+    return this.transitionStatus(companyId, "active");
+  }
+
+  /** 变更公司状态（校验合法流转） */
+  transitionStatus(companyId: string, newStatus: OpcCompanyStatus): OpcCompany | null {
+    const company = this.db.getCompany(companyId);
+    if (!company) return null;
+
+    const allowed = VALID_TRANSITIONS[company.status];
+    if (!allowed.includes(newStatus)) {
+      throw new Error(
+        `不允许从 "${company.status}" 变更为 "${newStatus}"。` +
+          `允许的目标状态: ${allowed.join(", ") || "无（终态）"}`,
+      );
+    }
+
+    return this.db.updateCompany(companyId, { status: newStatus });
+  }
+
+  getCompany(id: string): OpcCompany | null {
+    return this.db.getCompany(id);
+  }
+
+  listCompanies(status?: OpcCompanyStatus): OpcCompany[] {
+    return this.db.listCompanies(status);
+  }
+
+  updateCompany(
+    id: string,
+    data: { name?: string; industry?: string; description?: string; owner_contact?: string },
+  ): OpcCompany | null {
+    return this.db.updateCompany(id, data);
+  }
+
+  deleteCompany(id: string): boolean {
+    return this.db.deleteCompany(id);
+  }
+}

package/src/opc/context-injector.ts

@@ -0,0 +1,186 @@
+/**
+ * 星环OPC中心 — 上下文注入钩子
+ *
+ * 通过 before_prompt_build 钩子，在每次 Agent 会话中
+ * 自动注入公司信息 + AI 员工岗位配置，让 AI 员工了解自己
+ * 服务的公司和自己承担的角色职责。
+ *
+ * 同时提供新手引导：
+ * - 数据库无公司时：注入完整的首次使用引导，主动带领用户走 SOP 第一步
+ * - 数据库有公司但在普通对话（非 opc-xxx agent）时：注入简短功能菜单提示
+ */
+
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { OpcDatabase } from "../db/index.js";
+
+type StaffRow = { role: string; role_name: string; system_prompt: string };
+
+/**
+ * 注册上下文注入钩子。
+ * 当 agentId 以 "opc-" 开头时，自动注入公司上下文 + 启用的 AI 员工岗位提示词。
+ * 当 agentId 不以 "opc-" 开头时，注入新手引导或功能菜单。
+ */
+export function registerContextInjector(api: OpenClawPluginApi, db: OpcDatabase): void {
+  api.on("before_prompt_build", (_event, ctx) => {
+    const agentId = ctx.agentId;
+
+    // ── 公司专属 Agent：注入公司上下文 ─────────────────────────
+    if (agentId && agentId.startsWith("opc-")) {
+      const companyId = agentId.slice(4);
+      const company = db.getCompany(companyId);
+      if (!company) return;
+
+      const finance = db.getFinanceSummary(companyId);
+      const staffRows = db.query(
+        `SELECT role, role_name, system_prompt FROM opc_staff_config
+         WHERE company_id = ? AND enabled = 1 AND system_prompt != ''
+         ORDER BY role`,
+        companyId,
+      ) as StaffRow[];
+
+      const lines = [
+        "## 当前服务的公司信息",
+        "",
+        `- **公司名称**: ${company.name}`,
+        `- **所属行业**: ${company.industry}`,
+        `- **公司状态**: ${company.status}`,
+        `- **创办人**: ${company.owner_name}`,
+        `- **注册资本**: ${company.registered_capital.toLocaleString()} 元`,
+        `- **简介**: ${company.description || "暂无"}`,
+        "",
+        "## 财务概况",
+        "",
+        `- **总收入**: ${finance.total_income.toLocaleString()} 元`,
+        `- **总支出**: ${finance.total_expense.toLocaleString()} 元`,
+        `- **净收支**: ${finance.net.toLocaleString()} 元`,
+        `- **交易笔数**: ${finance.count}`,
+      ];
+
+      if (staffRows.length > 0) {
+        lines.push("", "## AI 员工团队", "");
+        lines.push("你是这家公司的 AI 助理总管，负责接收老板指令并调度 AI 员工完成任务。");
+        lines.push("");
+        lines.push("**调度方式**：当老板要你安排某个员工去处理某件事时，使用 `sessions_spawn` 工具：");
+        lines.push("- `task` 字段：先写员工的角色设定（system prompt），再写具体任务，格式如下：");
+        lines.push("  ```");
+        lines.push("  [角色设定]");
+        lines.push("  {员工的系统提示词}");
+        lines.push("");
+        lines.push("  [公司信息]");
+        lines.push("  {公司名称、行业等基本信息}");
+        lines.push("");
+        lines.push("  [任务]");
+        lines.push("  {老板交代的具体任务}");
+        lines.push("");
+        lines.push("  [完成后操作]");
+        lines.push(`  任务完成后，必须使用 sessions_send 工具将结果发送回请求者：`);
+        lines.push(`  - sessionKey: "agent:${agentId}:main"`);
+        lines.push("  - message: 你的完整工作结果");
+        lines.push("  ```");
+        lines.push("- 多个员工可以同时派遣，并行工作");
+        lines.push("");
+        lines.push("**当前公司 AI 员工列表**：");
+        lines.push("");
+        for (const staff of staffRows) {
+          lines.push(`### ${staff.role_name}（岗位代号：${staff.role}）`);
+          lines.push("**系统提示词**：");
+          lines.push(staff.system_prompt);
+          lines.push("");
+        }
+        lines.push("**使用示例**：");
+        lines.push("- 老板说「让财务帮我查一下本月收支」→ 你调用 sessions_spawn，task 里先写财务顾问的角色设定，再写查询任务");
+        lines.push("- 老板说「让法务和HR同时处理...」→ 你同时发起两个 sessions_spawn，两个员工并行工作");
+        lines.push("- 老板直接问你问题（不涉及具体员工）→ 你直接回答，不需要派遣");
+      } else {
+        lines.push("", "你是这家一人公司的 AI 员工。请基于以上信息为创业者提供专业服务。");
+        lines.push("提示：可在管理后台的 AI员工 Tab 点「一键初始化默认岗位」来配置专业 AI 员工团队。");
+      }
+
+      lines.push("使用中文回复。");
+      return { prependContext: lines.join("\n") };
+    }
+
+    // ── 普通对话：检测是否需要新手引导 ─────────────────────────
+    const companyCount = (db.query("SELECT COUNT(*) as cnt FROM opc_companies") as { cnt: number }[])[0]?.cnt ?? 0;
+
+    if (companyCount === 0) {
+      // 全新安装，没有任何公司 → OPB 方法论新手引导
+      return {
+        prependContext: [
+          "## 你是星环OPC中心的 AI 助手兼一人企业方法论顾问",
+          "",
+          "用户刚刚安装了「星环OPC中心」插件，这是第一次使用。",
+          "",
+          "**你的任务：主动引导用户用 OPB 方法论规划他的一人企业，然后帮他注册第一家公司。**",
+          "",
+          "请按以下步骤引导用户：",
+          "",
+          "### 第一步：热情介绍",
+          "用一段话介绍星环OPC能做什么：",
+          "- 帮助规划和运营一人企业（基于《一人企业方法论2.0》框架）",
+          "- 提供公司管理、财税、合同、HR、项目等全套工具",
+          "- 有 AI 员工团队，可以派遣财务顾问、法务助手、HR专员等",
+          "",
+          "### 第二步：了解用户现状",
+          "询问用户：",
+          "- 目前是否已经有业务方向/想法？",
+          "- 是否还在职（side project 阶段）还是已经全职创业？",
+          "- 主要的专业技能或资源优势是什么？",
+          "",
+          "### 第三步：根据用户回答给出建议",
+          "- 如果有想法 → 用赛道选择框架分析（小众强需求 vs 大众刚需，建议聚焦小众强需求）",
+          "- 如果没想法 → 引导发现副产品优势（工作副产品、生活副产品、兴趣副产品）",
+          "- 提示：一人企业核心是「以小博大」，找到结构性优势",
+          "",
+          "### 第四步：引导填写 OPB Canvas（简化版）",
+          "告诉用户，在注册公司之前，先用几个问题帮他梳理商业模式：",
+          "1. **价值主张**：你能为客户解决什么核心问题？",
+          "2. **目标客群**：谁是你最精准的客户（越具体越好）？",
+          "3. **竞争策略**：你打算用什么方式避开直接竞争（加入生态/差异化/创造新品类）？",
+          "4. **收入来源**：初期通过什么方式变现？",
+          "",
+          "### 第五步：注册公司",
+          "Canvas 梳理完后，帮用户注册第一家公司，调用 opc_manage 工具，action 为 register_company。",
+          "",
+          "语气要热情、专业、像一位懂创业的朋友。使用中文回复。",
+        ].join("\n"),
+      };
+    }
+
+    // 已有公司 → 注入简短功能提示，让 AI 知道自己有哪些能力
+    const companies = db.query(
+      "SELECT id, name, status FROM opc_companies ORDER BY created_at DESC LIMIT 5",
+    ) as { id: string; name: string; status: string }[];
+
+    const companyList = companies.map(c => `- ${c.name}（${c.status}）`).join("\n");
+
+    return {
+      prependContext: [
+        "## 星环OPC中心 AI 助手",
+        "",
+        "你是星环OPC中心的 AI 助手兼一人企业方法论顾问，可以帮用户管理旗下的一人公司。",
+        "",
+        `当前平台共有 ${companyCount} 家公司：`,
+        companyList,
+        "",
+        "**本月 OPB 月报**：建议每月初回顾 MRR（月经常性收入）、资产变化、用户池数据。需要我帮你生成月报吗？",
+        "",
+        "你能做的事情包括（用户直接用自然语言告诉你即可）：",
+        "- **公司管理**：注册公司、激活公司、查询公司信息",
+        "- **收支记录**：记录收入/支出、查看财务概况",
+        "- **合同管理**：创建合同、查询合同、到期提醒",
+        "- **AI 员工**：为公司初始化 AI 员工团队（财务/HR/法务/市场等岗位）",
+        "- **税务管理**：创建税务申报记录、查询纳税情况",
+        "- **投融资**：创建融资轮次、记录投资人",
+        "- **项目管理**：创建项目、跟踪任务进度",
+        "- **监控告警**：查看系统自动生成的风险告警",
+        "- **OPB方法论咨询**：赛道选择、竞争策略、基础设施规划、月报生成",
+        "",
+        "管理后台：http://localhost:18789/opc/admin",
+        "",
+        "请用中文回复，根据用户的需求调用合适的工具。",
+      ].join("\n"),
+    };
+  });
+}
+