galaxy-opc-plugin 0.2.0 → 0.2.2

package/index.ts

@@ -14,7 +14,16 @@ import { registerHttpRoutes } from "./src/api/routes.js";
 import type { OpcDatabase } from "./src/db/index.js";
 import { SqliteAdapter } from "./src/db/sqlite-adapter.js";
 import { registerContextInjector } from "./src/opc/context-injector.js";
-import { startReminderService } from "./src/opc/reminder-service.js";
+import { startProactiveService } from "./src/opc/proactive-service.js";
+import { runIntelligenceScanForCompany } from "./src/opc/intelligence-engine.js";
+import { detectMilestones } from "./src/opc/milestone-detector.js";
+import { updateCompanyStage } from "./src/opc/stage-detector.js";
+import {
+  registerSpawnedSession,
+  getSessionTaskMapping,
+  removeSessionTaskMapping,
+  clearAllSessionMappings,
+} from "./src/opc/session-task-tracker.js";
 import { registerAcquisitionTool } from "./src/tools/acquisition-tool.js";
 import { registerAssetPackageTool } from "./src/tools/asset-package-tool.js";
 import { registerFinanceTool } from "./src/tools/finance-tool.js";
@@ -28,7 +37,11 @@ import { registerOpcTool } from "./src/tools/opc-tool.js";
 import { registerOpbTool } from "./src/tools/opb-tool.js";
 import { registerProcurementTool } from "./src/tools/procurement-tool.js";
 import { registerProjectTool } from "./src/tools/project-tool.js";
+import { registerSearchTool } from "./src/tools/search-tool.js";
 import { registerStaffTool } from "./src/tools/staff-tool.js";
+import { registerDocumentTool } from "./src/tools/document-tool.js";
+import { registerOpcCommand } from "./src/commands/opc-command.js";
+import { triggerEventRules } from "./src/opc/event-triggers.js";
 import { registerConfigUi } from "./src/web/config-ui.js";
 import { registerLandingPage } from "./src/web/landing-page.js";
 
@@ -42,6 +55,12 @@ function resolveDbPath(configured?: string): string {
   return dbPath;
 }
 
+/** 从 sessionKey 中提取公司 ID（格式: agent:opc-{companyId}:subagent:...） */
+function extractCompanyIdFromSession(sessionKey: string): string | null {
+  const match = sessionKey.match(/agent:opc-([^:]+):/);
+  return match ? match[1] : null;
+}
+
 let db: OpcDatabase | null = null;
 
 const plugin = {
@@ -78,6 +97,7 @@ const plugin = {
     registerOpcTool(api, db);
     registerStaffTool(api, db);
     registerOpbTool(api, db);
+    registerSearchTool(api);
 
     // 注册 Phase 2 专业工具（可通过管理后台禁用）
     if (isEnabled("opc_finance"))  registerFinanceTool(api, db);
@@ -92,6 +112,9 @@ const plugin = {
     if (isEnabled("opc_lifecycle"))   registerLifecycleTool(api, db);
     if (isEnabled("opc_monitoring"))  registerMonitoringTool(api, db);
 
+    // 文档生成工具（始终启用）
+    registerDocumentTool(api, db);
+
     // 资金闭环工具（始终启用，核心商业模式）
     registerAcquisitionTool(api, db);
     registerAssetPackageTool(api, db);
@@ -101,6 +124,9 @@ const plugin = {
     // 注册上下文注入钩子
     registerContextInjector(api, db);
 
+    // 注册 /opc 快捷命令（毫秒级仪表盘，不经 LLM）
+    registerOpcCommand(api, db);
+
     // 读取 gateway token 用于 API 认证
     const gatewayToken = (() => {
       try {
@@ -118,8 +144,213 @@ const plugin = {
     registerConfigUi(api, db, gatewayToken);
     registerLandingPage(api);
 
-    // 注册后台服务（数据库生命周期 + 自动提醒）
-    let stopReminder: (() => void) | null = null;
+    // ── 智能刷新器（共享函数，after_tool_call + subagent_ended 共用） ──
+    const refreshTimers = new Map<string, ReturnType<typeof setTimeout>>();
+    function triggerIntelligenceRefresh(companyId: string): void {
+      const existing = refreshTimers.get(companyId);
+      if (existing) clearTimeout(existing);
+      refreshTimers.set(companyId, setTimeout(() => {
+        refreshTimers.delete(companyId);
+        const l = (msg: string) => api.logger.info(msg);
+        db!.execute(
+          "DELETE FROM opc_insights WHERE company_id = ? AND insight_type = 'data_gap'",
+          companyId,
+        );
+        updateCompanyStage(db!, companyId);
+        runIntelligenceScanForCompany(db!, companyId, l);
+        detectMilestones(db!, companyId, l);
+      }, 5000));
+    }
+
+    // 注册 after_tool_call 钩子 — 工具调用后即时刷新洞察（5秒防抖）+ 拦截 sessions_spawn
+    api.on("after_tool_call", (event, ctx) => {
+      const aid = ctx.agentId;
+      if (!aid?.startsWith("opc-")) return;
+      const companyId = aid.slice(4);
+
+      // ── 拦截 sessions_spawn：提取 taskId + childSessionKey 建立映射 ──
+      const toolName = String((event as Record<string, unknown>).toolName ?? "");
+      if (toolName === "sessions_spawn") {
+        try {
+          const taskParam = (event.params as Record<string, unknown>)?.task as string;
+          const match = taskParam?.match(/## 任务 ID\n([a-z0-9-]+)/);
+          if (match) {
+            const taskId = match[1];
+            const result = event.result as Record<string, unknown> | undefined;
+            const childSessionKey = (result?.childSessionKey || result?.sessionKey) as string | undefined;
+            if (childSessionKey) {
+              // 从任务记录获取 staffRole 和 title
+              const taskRow = db!.queryOne(
+                "SELECT staff_role, title FROM opc_staff_tasks WHERE id = ?", taskId,
+              ) as { staff_role: string; title: string } | null;
+
+              registerSpawnedSession(childSessionKey, {
+                taskId,
+                companyId,
+                staffRole: taskRow?.staff_role ?? "",
+                title: taskRow?.title ?? "",
+                runId: result?.runId as string | undefined,
+                spawnedAt: new Date().toISOString(),
+              });
+
+              // 持久化 session_key 到数据库
+              db!.execute(
+                "UPDATE opc_staff_tasks SET session_key = ? WHERE id = ?",
+                childSessionKey, taskId,
+              );
+
+              api.logger.info(
+                `opc: 已追踪子会话 ${childSessionKey} → 任务 ${taskId} (${taskRow?.title ?? "?"})`,
+              );
+            }
+          }
+        } catch (err) {
+          api.logger.info(`opc: sessions_spawn 追踪失败: ${err instanceof Error ? err.message : String(err)}`);
+        }
+      }
+
+      // ── 事件驱动触发引擎：OPC 工具写入数据后自动检查业务规则 ──
+      if (toolName.startsWith("opc_")) {
+        triggerEventRules(
+          db!, companyId, toolName,
+          event.params as Record<string, unknown> | undefined,
+          event.result as Record<string, unknown> | undefined,
+          (msg) => api.logger.info(msg),
+        );
+      }
+
+      // ── 通用：刷新洞察 ──
+      triggerIntelligenceRefresh(companyId);
+    });
+
+    // ── subagent_ended 钩子 — 子会话结束时自动更新任务状态 ──
+    api.on("subagent_ended", (event) => {
+      try {
+        const ev = event as Record<string, unknown>;
+        // 优先使用 targetSessionKey（SDK 标准字段），fallback 到 context 中的 childSessionKey
+        const sessionKey = ev.targetSessionKey as string
+          ?? (ev as Record<string, unknown>).childSessionKey as string
+          ?? ev.sessionKey as string;
+        if (!sessionKey) return;
+
+        const mapping = getSessionTaskMapping(sessionKey);
+        if (!mapping) {
+          // 非 OPC 任务，也尝试从数据库查找（服务重启后内存映射丢失的情况）
+          const dbTask = db!.queryOne(
+            "SELECT id, company_id, staff_role, title, status FROM opc_staff_tasks WHERE session_key = ?",
+            sessionKey,
+          ) as { id: string; company_id: string; staff_role: string; title: string; status: string } | null;
+          if (!dbTask) return;
+
+          // 从数据库恢复映射并处理
+          handleSubagentEnd(dbTask.id, dbTask.company_id, dbTask.status, event);
+          return;
+        }
+
+        const task = db!.queryOne(
+          "SELECT status FROM opc_staff_tasks WHERE id = ?", mapping.taskId,
+        ) as { status: string } | null;
+        if (!task) {
+          removeSessionTaskMapping(sessionKey);
+          return;
+        }
+
+        handleSubagentEnd(mapping.taskId, mapping.companyId, task.status, event);
+        removeSessionTaskMapping(sessionKey);
+      } catch (err) {
+        api.logger.info(`opc: subagent_ended 处理失败: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    });
+
+    function handleSubagentEnd(
+      taskId: string,
+      companyId: string,
+      currentStatus: string,
+      event: Record<string, unknown>,
+    ): void {
+      const now = new Date().toISOString();
+      const outcome = event.outcome as string | undefined;
+
+      if (outcome === "ok" || outcome === "completed") {
+        // 员工正常结束 — 如果任务仍 in_progress，说明员工忘了调 update_task
+        if (currentStatus === "in_progress") {
+          db!.execute(
+            `UPDATE opc_staff_tasks SET status = 'completed', completed_at = ?,
+             result_summary = CASE WHEN result_summary = '' THEN ? ELSE result_summary END
+             WHERE id = ? AND status = 'in_progress'`,
+            now,
+            "[系统] 员工会话已正常结束但未提交工作报告",
+            taskId,
+          );
+          api.logger.info(`opc: 子会话正常结束，自动标记任务 ${taskId} 为 completed`);
+        }
+      } else {
+        // error/timeout/killed → 自动取消
+        const errorDetail = event.error as string || "";
+        db!.execute(
+          `UPDATE opc_staff_tasks SET status = 'cancelled', completed_at = ?,
+           result_summary = ? WHERE id = ? AND status IN ('in_progress', 'pending')`,
+          now,
+          `[系统] 员工会话异常终止（${outcome || "unknown"}: ${errorDetail})`,
+          taskId,
+        );
+        api.logger.info(`opc: 子会话异常终止(${outcome})，自动取消任务 ${taskId}`);
+      }
+
+      triggerIntelligenceRefresh(companyId);
+    }
+
+    // ── before_tool_call 权限控制 + switch_company 注入 ──
+    api.on("before_tool_call", (event, ctx) => {
+      // ── switch_company 自动注入 channel/peer 信息 ──
+      const btToolName0 = String((event as Record<string, unknown>).toolName ?? "");
+      if (btToolName0 === "opc_manage") {
+        const action = (event.params as Record<string, unknown>)?.action;
+        if (action === "switch_company" && ctx.sessionKey) {
+          const sessionKey = ctx.sessionKey;
+          api.logger.info(`opc: switch_company sessionKey = "${sessionKey}"`);
+          api.logger.info(`opc: switch_company agentId = "${ctx.agentId}", params = ${JSON.stringify(event.params)}`);
+          // 提取 channel: ":direct:" 前面的标识（如 feishu）
+          const channelMatch = sessionKey.match(/:([a-z_]+):direct:/);
+          const peerMatch = sessionKey.match(/:direct:([^:]+)/);
+          const channel = channelMatch?.[1] ?? "";
+          const peerId = peerMatch?.[1] ?? "";
+          api.logger.info(`opc: switch_company parsed channel="${channel}", peerId="${peerId}"`);
+          if (channel && peerId) {
+            return {
+              params: {
+                ...(event.params as Record<string, unknown> || {}),
+                _channel: channel,
+                _peer_id: peerId,
+              },
+            };
+          }
+        }
+      }
+
+      // ── 子会话权限控制 ──
+      // 非子会话不拦截
+      if (!ctx.sessionKey?.includes("subagent")) return;
+
+      const btToolName = String((event as Record<string, unknown>).toolName ?? "");
+      if (!btToolName.startsWith("opc_")) return; // 非 OPC 工具不拦截
+
+      // 从 params 中提取 company_id
+      const paramCompanyId = (event.params as Record<string, unknown>)?.company_id as string | undefined;
+      if (!paramCompanyId) return;
+
+      // 从父会话 agentId 或 sessionKey 提取公司 ID
+      const parentCompanyId = extractCompanyIdFromSession(ctx.sessionKey);
+      if (parentCompanyId && paramCompanyId !== parentCompanyId) {
+        return {
+          block: true,
+          blockReason: `权限拒绝：你只能操作公司 ${parentCompanyId} 的数据，不能操作 ${paramCompanyId}`,
+        };
+      }
+    });
+
+    // 注册后台服务（数据库生命周期 + 主动智能）
+    let stopProactive: (() => void) | null = null;
     api.registerService({
       id: "opc-db-lifecycle",
       start() {
@@ -129,17 +360,22 @@ const plugin = {
           "SELECT value FROM opc_tool_config WHERE key = ?", "webhook_url",
         ) as { value: string } | null;
         const webhookUrl = webhookRow?.value?.trim() || undefined;
-        // 启动自动提醒服务（每小时扫描一次）
-        stopReminder = startReminderService(
+        // 启动主动智能服务（每小时全量扫描）
+        stopProactive = startProactiveService(
           db!,
           (msg) => api.logger.info(msg),
           webhookUrl,
         );
-        api.logger.info(`opc: 自动提醒服务已启动（每小时扫描${webhookUrl ? "，Webhook 已配置" : ""}）`);
+        api.logger.info(`opc: 主动智能服务已启动（每小时扫描${webhookUrl ? "，Webhook 已配置" : ""}）`);
       },
       stop() {
-        stopReminder?.();
-        stopReminder = null;
+        stopProactive?.();
+        stopProactive = null;
+        // 清理防抖定时器
+        for (const timer of refreshTimers.values()) clearTimeout(timer);
+        refreshTimers.clear();
+        // 清理会话映射
+        clearAllSessionMappings();
         if (db) {
           db.close();
           db = null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "galaxy-opc-plugin",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "星环 Galaxy OPC — 一人公司孵化与赋能平台 OpenClaw 插件",
   "keywords": [
     "openclaw",
@@ -30,10 +30,24 @@
   ],
   "dependencies": {
     "@sinclair/typebox": "0.34.48",
-    "better-sqlite3": "^11.8.1"
+    "@types/pdfkit": "^0.17.5",
+    "better-sqlite3": "^11.8.1",
+    "docx": "^9.6.0",
+    "exceljs": "^4.4.0",
+    "pdfkit": "^0.17.2"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.12"
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/node": "^20.19.35",
+    "@vitest/coverage-v8": "^2.1.9",
+    "@vitest/ui": "^2.1.9",
+    "vitest": "^2.1.9"
+  },
+  "scripts": {
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage"
   },
   "openclaw": {
     "extensions": [

package/skills/acquisition-management/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: acquisition-management
+description: |
+  收并购管理技能。当用户提到收购、并购、收购亏损公司、税务优化、亏损抵扣、收并购时激活。
+---
+
+# 收并购管理技能
+
+使用 `opc_acquisition` 工具管理一人公司收并购流程。当 OPC 经营不善时，星河数科依据参股协议发起收购，亏损可抵扣企业所得税，并为后续资产打包做准备。
+
+## 收并购流程
+
+### 第一步：发起收购
+
+确认目标公司经营状况后，创建收购案例：
+
+```json
+{
+  "action": "create_acquisition",
+  "company_id": "目标公司ID",
+  "trigger_reason": "连续亏损，营收不达预期",
+  "acquisition_price": 50000,
+  "loss_amount": 200000,
+  "notes": "依据参股协议第8条发起收购"
+}
+```
+
+系统自动完成：
+- 创建收购案例（状态: evaluating）
+- 将公司状态变更为 `acquired`（通过状态机校验）
+- 计算税务抵扣估算：亏损 x 25% 企业所得税率
+
+### 第二步：跟踪收购进度
+
+查看所有收购案例：
+
+```json
+{
+  "action": "list_acquisitions",
+  "status": "evaluating"
+}
+```
+
+案例状态流转: `evaluating`(评估中) → `approved`(已批准) → `closed`(已完成)，或 `rejected`(已拒绝)
+
+### 第三步：更新收购信息
+
+```json
+{
+  "action": "update_acquisition",
+  "case_id": "案例ID",
+  "status": "approved",
+  "acquisition_price": 60000,
+  "loss_amount": 180000
+}
+```
+
+更新价格或亏损金额时，税务抵扣会自动重新计算。
+
+### 第四步：平台汇总
+
+查看全平台收并购概况：
+
+```json
+{
+  "action": "acquisition_summary"
+}
+```
+
+返回: 总收购数、累计亏损、累计税务抵扣优化总额。
+
+## 税务优化说明
+
+- 亏损抵扣公式: 亏损金额 x 25%（企业所得税率）
+- 小微企业优惠税率下实际可抵扣更多
+- 收购完成后可进入资产打包流程（使用 `opc_asset_package` 工具）
+
+## 使用建议
+
+1. 收购前先通过 `opc_manage` 查看公司财务状况
+2. 确认亏损金额后发起收购
+3. 收购完成后，将公司加入资产包（`opc_asset_package.add_company_to_package`）
+4. 定期查看 `acquisition_summary` 了解平台整体税务优化效果

package/skills/ai-staff/SKILL.md

@@ -0,0 +1,89 @@
+---
+name: ai-staff
+description: |
+  AI 员工配置技能。当用户提到AI员工、AI团队、虚拟员工、配置员工、一人团队、AI助手角色时激活。
+---
+
+# AI 员工配置技能
+
+使用 `opc_staff` 工具为一人公司配置 AI 员工团队，实现"一人 = AI 团队"的核心理念。每个 AI 员工拥有独立的角色定位和专业提示词。
+
+## 快速上手
+
+### 一键初始化默认团队
+
+为公司快速创建 6 个标准 AI 岗位：
+
+```json
+{
+  "action": "init_default_staff",
+  "company_id": "公司ID"
+}
+```
+
+默认团队包含：
+- **行政助理** — 日程管理、文件归档、会议安排
+- **HR 专员** — 招聘、入职、薪酬核算、社保公积金
+- **财务顾问** — 账务、发票、税务申报、现金流分析
+- **法务顾问** — 合同审查、知识产权、劳动法务
+- **营销专员** — 内容创作、社交媒体运营、品牌推广
+- **运营经理** — 项目管理、供应链协调、数据分析
+
+## 自定义员工
+
+### 配置/更新 AI 员工
+
+```json
+{
+  "action": "configure_staff",
+  "company_id": "公司ID",
+  "role_id": "product_manager",
+  "name": "产品经理",
+  "system_prompt": "你是公司产品经理，负责需求分析、产品规划、用户体验优化和竞品调研。善于用数据驱动产品决策。",
+  "skills": "requirement-analysis,user-research,roadmap"
+}
+```
+
+### 查看内置角色模板
+
+```json
+{
+  "action": "list_builtin_roles"
+}
+```
+
+可用内置角色: admin(行政), hr(HR), finance(财务), legal(法务), marketing(营销), operations(运营)
+
+### 查看已配置的员工
+
+```json
+{
+  "action": "list_staff",
+  "company_id": "公司ID"
+}
+```
+
+### 启用/禁用员工
+
+```json
+{
+  "action": "toggle_staff",
+  "company_id": "公司ID",
+  "role_id": "marketing",
+  "enabled": false
+}
+```
+
+## 工作原理
+
+配置 AI 员工后，当用户进入公司 Agent 对话时：
+1. 系统自动注入所有已启用员工的角色信息
+2. AI 可根据问题类型自动"调度"对应岗位的专业知识
+3. 每个员工的 system_prompt 定义了其专业能力边界
+
+## 使用建议
+
+1. 新公司注册后，先运行 `init_default_staff` 一键配置
+2. 根据公司实际业务，添加自定义岗位（如产品经理、技术总监）
+3. 暂时不需要的岗位可以 `toggle_staff` 禁用，无需删除
+4. 定期更新员工的 system_prompt 以匹配公司最新业务方向

package/skills/asset-package/SKILL.md

@@ -0,0 +1,142 @@
+---
+name: asset-package
+description: |
+  资产打包与城投转让技能。当用户提到资产包、资产打包、城投、城投转让、科技贷、融资服务费、资金闭环时激活。
+---
+
+# 资产打包与城投转让技能
+
+使用 `opc_asset_package` 工具完成资金闭环的后半段：将收购的公司打包为科技资产包，转让给城投公司，申请科技贷款，收取融资服务费。
+
+## 资金闭环全流程
+
+```
+孵化 OPC → 经营不善 → 收购(opc_acquisition) → 资产打包 → 城投转让 → 科技贷 → 服务费
+```
+
+## 资产包管理
+
+### 创建资产包
+
+```json
+{
+  "action": "create_asset_package",
+  "name": "2025年第一批科技资产包",
+  "description": "含3家AI领域一人公司"
+}
+```
+
+资产包状态: `assembling`(组装中) → `submitted`(已提交) → `approved`(已审批) → `transferred`(已转让)
+
+### 添加公司到资产包
+
+将已收购的公司加入资产包：
+
+```json
+{
+  "action": "add_company_to_package",
+  "package_id": "资产包ID",
+  "company_id": "已收购的公司ID",
+  "valuation": 500000
+}
+```
+
+系统自动更新资产包总估值和公司数量。
+
+### 查看资产包详情
+
+```json
+{
+  "action": "get_package_detail",
+  "package_id": "资产包ID"
+}
+```
+
+返回: 资产包信息 + 包含的公司列表 + 关联的城投转让记录。
+
+## 城投转让
+
+### 发起城投转让
+
+```json
+{
+  "action": "create_ct_transfer",
+  "package_id": "资产包ID",
+  "ct_company_name": "仁和区城市建设投资有限公司",
+  "target_loan_amount": 10000000,
+  "interest_rate": 3.5,
+  "loan_term_months": 36,
+  "notes": "科技贷款申请"
+}
+```
+
+转让状态: `negotiating`(洽谈中) → `signed`(已签约) → `loan_approved`(贷款已批) → `completed`(已完成)
+
+### 更新转让进度
+
+```json
+{
+  "action": "update_ct_transfer",
+  "transfer_id": "转让ID",
+  "status": "loan_approved",
+  "actual_loan_amount": 8000000
+}
+```
+
+### 查看转让列表
+
+```json
+{
+  "action": "list_ct_transfers",
+  "status": "completed"
+}
+```
+
+## 融资服务费
+
+### 记录服务费
+
+贷款完成后，按比例收取融资服务费：
+
+```json
+{
+  "action": "record_financing_fee",
+  "transfer_id": "转让ID",
+  "fee_base": 8000000,
+  "fee_rate": 2.5
+}
+```
+
+系统自动计算: 8,000,000 x 2.5% = 200,000 元服务费。
+
+### 更新服务费状态
+
+```json
+{
+  "action": "update_financing_fee",
+  "fee_id": "服务费ID",
+  "invoice_status": "invoiced",
+  "payment_status": "paid"
+}
+```
+
+## 闭环总览
+
+查看全平台资金闭环汇总：
+
+```json
+{
+  "action": "closure_summary"
+}
+```
+
+返回: 所有资产包 + 城投转让 + 服务费的完整闭环数据。
+
+## 使用建议
+
+1. 先通过 `opc_acquisition` 完成收购，确保公司状态为 `acquired`
+2. 创建资产包，将多家已收购公司打包
+3. 资产包提交审批后，申请科技资产认定
+4. 与城投公司洽谈转让，发起科技贷申请
+5. 贷款到账后记录融资服务费
+6. 定期查看 `closure_summary` 掌握整体闭环进度