galaxy-opc-plugin 0.1.0

package/README.md

@@ -0,0 +1,166 @@
+# 星环OPC中心 — OpenClaw 插件
+
+> 一人公司(OPC)孵化与赋能平台，基于 [OpenClaw](https://github.com/openclaw/openclaw) 构建的 AI 员工全套解决方案。
+
+![版本](https://img.shields.io/badge/version-0.1.0-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![OpenClaw](https://img.shields.io/badge/OpenClaw-2026.x-orange)
+
+---
+
+## ✨ 功能概览
+
+| 模块 | 工具名 | 功能 |
+|------|--------|------|
+| 核心管理 | `opc_core` | 公司注册、客户管理、收支记录 |
+| AI 员工 | `opc_staff` | 行政/财务/HR/法务/市场/运营岗位配置 |
+| 财税管理 | `opc_finance` | 发票、增值税、所得税、纳税申报 |
+| 法务合同 | `opc_legal` | 合同管理、风险评估、到期提醒 |
+| 人力资源 | `opc_hr` | 员工档案、薪资、社保、公积金 |
+| 新媒体运营 | `opc_media` | 内容创建、发布排期、数据分析 |
+| 项目管理 | `opc_project` | 项目、任务、进度、预算跟踪 |
+| 投融资 | `opc_investment` | 融资轮次、投资人、股权结构 |
+| 服务采购 | `opc_procurement` | 服务项目、采购订单、费用统计 |
+| 生命周期 | `opc_lifecycle` | 里程碑、大事记、时间线报告 |
+| 运营监控 | `opc_monitoring` | 指标记录、告警管理、KPI 看板 |
+
+**自动提醒服务**（后台每小时扫描）：
+- 税务申报到期提醒（7天内）
+- 合同到期提醒（30天内）
+- 现金流预警（净流出超 5000 元）
+- 融资轮次截止跟进
+
+**管理后台** `http://localhost:18789/opc/admin`：
+- 公司仪表盘、财务总览、监控中心
+- 一键进入公司 AI 助手对话
+- SOP 使用指南
+
+---
+
+## 📦 安装
+
+### 前提条件
+
+- 已安装并运行 [OpenClaw](https://github.com/openclaw/openclaw) Gateway
+- Node.js 20+
+
+### 方式一：直接克隆到插件目录（推荐）
+
+```bash
+# 进入你的 OpenClaw 插件目录
+cd <your-openclaw-dir>/extensions
+
+# 克隆插件
+git clone https://github.com/P3ngSaM/opc.git opc-platform
+
+# 安装依赖
+cd opc-platform
+npm install
+```
+
+### 方式二：手动下载
+
+下载 Release 压缩包，解压到 `<openclaw>/extensions/opc-platform/`，然后 `npm install`。
+
+---
+
+## ⚙️ 配置
+
+在 OpenClaw 配置文件 `~/.openclaw/openclaw.json` 中启用插件：
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "opc-platform": {
+        "enabled": true,
+        "config": {
+          "dbPath": "~/.openclaw/opc-platform/opc.db"
+        }
+      }
+    }
+  }
+}
+```
+
+`dbPath` 可选，默认为 `~/.openclaw/opc-platform/opc.db`，支持 `~/` 路径前缀。
+
+---
+
+## 🚀 快速开始
+
+重启 OpenClaw Gateway 后，对 AI 说：
+
+```
+注册一家公司，名称"极光科技有限公司"，行业"软件开发"，注册资金50万
+```
+
+然后访问管理后台：`http://localhost:18789/opc/admin`
+
+### 典型 SOP 流程
+
+```
+1. 注册公司        → opc_core: register_company
+2. 激活公司        → opc_core: activate_company
+3. 配置 AI 员工    → opc_staff: init_default_staff
+4. 日常运营        → 告诉 AI 助手记录收支、合同、员工等
+5. 融资管理        → opc_investment: create_round
+6. 生命周期报告    → opc_lifecycle: generate_report
+```
+
+---
+
+## 📁 项目结构
+
+```
+opc-platform/
+├── index.ts                 # 插件入口
+├── openclaw.plugin.json     # 插件元数据
+├── package.json
+├── src/
+│   ├── api/                 # HTTP API 路由
+│   ├── db/                  # SQLite 数据库适配器 & Schema
+│   ├── opc/                 # 上下文注入、提醒服务、工作区工厂
+│   ├── tools/               # 11 个 AI 工具模块
+│   └── web/                 # 管理后台 UI (config-ui) & Landing Page
+└── skills/                  # OpenClaw Skills 配置
+    ├── basic-crm/
+    ├── basic-finance/
+    ├── company-registration/
+    └── ...（共 11 个技能包）
+```
+
+---
+
+## 🗄️ 数据库
+
+使用 SQLite（WAL 模式），自动迁移，无需手动建表。主要数据表：
+
+- `opc_companies` — 公司档案
+- `opc_transactions` — 收支流水
+- `opc_contracts` — 合同管理
+- `opc_tax_filings` — 税务申报
+- `opc_employees` / `opc_hr_records` — HR 档案
+- `opc_investment_rounds` — 融资轮次
+- `opc_alerts` — 告警记录
+- `opc_staff_config` — AI 员工角色配置
+- ...共 19 张表
+
+---
+
+## 🛠️ 开发
+
+```bash
+# 类型检查
+npx tsc -p tsconfig.json --noEmit
+
+# 构建管理后台 UI（如修改了 UI）
+# 在 openclaw 根目录执行：
+node scripts/ui.js build
+```
+
+---
+
+## 📄 License
+
+MIT © 2026 星河数科 (StarRiver Digital Technology)

package/index.ts

@@ -0,0 +1,145 @@
+/**
+ * 星环OPC中心 — OpenClaw 插件入口
+ *
+ * 一人公司(OPC)孵化与赋能平台。
+ * 零核心代码修改，全部通过 Plugin API 扩展。
+ */
+
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { Type } from "@sinclair/typebox";
+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 { registerAcquisitionTool } from "./src/tools/acquisition-tool.js";
+import { registerAssetPackageTool } from "./src/tools/asset-package-tool.js";
+import { registerFinanceTool } from "./src/tools/finance-tool.js";
+import { registerHrTool } from "./src/tools/hr-tool.js";
+import { registerInvestmentTool } from "./src/tools/investment-tool.js";
+import { registerLegalTool } from "./src/tools/legal-tool.js";
+import { registerLifecycleTool } from "./src/tools/lifecycle-tool.js";
+import { registerMediaTool } from "./src/tools/media-tool.js";
+import { registerMonitoringTool } from "./src/tools/monitoring-tool.js";
+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 { registerStaffTool } from "./src/tools/staff-tool.js";
+import { registerConfigUi } from "./src/web/config-ui.js";
+import { registerLandingPage } from "./src/web/landing-page.js";
+
+/** 解析数据库路径，支持 ~ 前缀 */
+function resolveDbPath(configured?: string): string {
+  const defaultPath = path.join(os.homedir(), ".openclaw", "opc-platform", "opc.db");
+  const dbPath = configured ?? defaultPath;
+  if (dbPath.startsWith("~/")) {
+    return path.join(os.homedir(), dbPath.slice(2));
+  }
+  return dbPath;
+}
+
+let db: OpcDatabase | null = null;
+
+const plugin = {
+  id: "opc-platform",
+  name: "OPC Platform",
+  description: "星环OPC中心 — 一人公司孵化与赋能平台",
+  configSchema: Type.Object({
+    dbPath: Type.Optional(Type.String({ description: "SQLite 数据库文件路径，默认 ~/.openclaw/opc-platform/opc.db" })),
+  }, { additionalProperties: false }),
+
+  register(api: OpenClawPluginApi) {
+    // 解析数据库路径
+    const dbPath = resolveDbPath(
+      (api.pluginConfig as Record<string, unknown> | undefined)?.dbPath as string | undefined,
+    );
+
+    // 确保目录存在
+    const dbDir = path.dirname(dbPath);
+    fs.mkdirSync(dbDir, { recursive: true });
+
+    // 初始化数据库
+    db = new SqliteAdapter(dbPath);
+    api.logger.info(`opc: 数据库已初始化 (${dbPath})`);
+
+    // 读取工具启用配置（启动时一次性读取，修改后需重启生效）
+    const isEnabled = (key: string): boolean => {
+      const row = db!.queryOne(
+        "SELECT value FROM opc_tool_config WHERE key = ?", key,
+      ) as { value: string } | null;
+      return row?.value !== "disabled";
+    };
+
+    // 注册核心工具（始终启用）
+    registerOpcTool(api, db);
+    registerStaffTool(api, db);
+    registerOpbTool(api, db);
+
+    // 注册 Phase 2 专业工具（可通过管理后台禁用）
+    if (isEnabled("opc_finance"))  registerFinanceTool(api, db);
+    if (isEnabled("opc_legal"))    registerLegalTool(api, db);
+    if (isEnabled("opc_hr"))       registerHrTool(api, db);
+    if (isEnabled("opc_media"))    registerMediaTool(api, db);
+    if (isEnabled("opc_project"))  registerProjectTool(api, db);
+
+    // 注册 Phase 3 业务闭环工具（可通过管理后台禁用）
+    if (isEnabled("opc_investment"))  registerInvestmentTool(api, db);
+    if (isEnabled("opc_procurement")) registerProcurementTool(api, db);
+    if (isEnabled("opc_lifecycle"))   registerLifecycleTool(api, db);
+    if (isEnabled("opc_monitoring"))  registerMonitoringTool(api, db);
+
+    // 资金闭环工具（始终启用，核心商业模式）
+    registerAcquisitionTool(api, db);
+    registerAssetPackageTool(api, db);
+
+    api.logger.info("opc: 工具已按配置注册完毕（重启后生效）");
+
+    // 注册上下文注入钩子
+    registerContextInjector(api, db);
+
+    // 注册 HTTP API
+    registerHttpRoutes(api, db);
+
+    // 注册 Web UI
+    registerConfigUi(api, db);
+    registerLandingPage(api);
+
+    // 注册后台服务（数据库生命周期 + 自动提醒）
+    let stopReminder: (() => void) | null = null;
+    api.registerService({
+      id: "opc-db-lifecycle",
+      start() {
+        api.logger.info("opc: OPC 平台服务已启动");
+        // 读取 Webhook 配置
+        const webhookRow = db!.queryOne(
+          "SELECT value FROM opc_tool_config WHERE key = ?", "webhook_url",
+        ) as { value: string } | null;
+        const webhookUrl = webhookRow?.value?.trim() || undefined;
+        // 启动自动提醒服务（每小时扫描一次）
+        stopReminder = startReminderService(
+          db!,
+          (msg) => api.logger.info(msg),
+          webhookUrl,
+        );
+        api.logger.info(`opc: 自动提醒服务已启动（每小时扫描${webhookUrl ? "，Webhook 已配置" : ""}）`);
+      },
+      stop() {
+        stopReminder?.();
+        stopReminder = null;
+        if (db) {
+          db.close();
+          db = null;
+          api.logger.info("opc: 数据库连接已关闭");
+        }
+      },
+    });
+
+    api.logger.info("opc: 星环OPC中心插件注册完毕");
+  },
+};
+
+export default plugin;

package/openclaw.plugin.json

@@ -0,0 +1,17 @@
+{
+  "id": "opc-platform",
+  "name": "OPC Platform",
+  "description": "星环OPC中心 — 一人公司孵化与赋能平台",
+  "version": "0.1.0",
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "dbPath": {
+        "type": "string",
+        "description": "SQLite 数据库文件路径，默认 ~/.openclaw/opc-platform/opc.db"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "galaxy-opc-plugin",
+  "version": "0.1.0",
+  "description": "星环 Galaxy OPC — 一人公司孵化与赋能平台 OpenClaw 插件",
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "opc",
+    "one-person-company",
+    "ai",
+    "business",
+    "startup"
+  ],
+  "homepage": "https://github.com/P3ngSaM/galaxy-opc",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/P3ngSaM/galaxy-opc.git"
+  },
+  "bugs": {
+    "url": "https://github.com/P3ngSaM/galaxy-opc/issues"
+  },
+  "license": "MIT",
+  "author": "p3ngsam",
+  "type": "module",
+  "files": [
+    "index.ts",
+    "src/",
+    "skills/",
+    "openclaw.plugin.json"
+  ],
+  "dependencies": {
+    "@sinclair/typebox": "0.34.48",
+    "better-sqlite3": "^11.8.1"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12"
+  },
+  "openclaw": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "npmSpec": "galaxy-opc-plugin",
+      "defaultChoice": "npm"
+    }
+  }
+}

package/skills/basic-crm/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: basic-crm
+description: |
+  基础客户管理技能。当用户提到客户、联系人、CRM、客户管理、跟进时激活。
+---
+
+# 基础客户管理技能
+
+使用 `opc_manage` 工具管理客户/联系人信息。
+
+## 添加客户
+
+```json
+{
+  "action": "add_contact",
+  "company_id": "公司ID",
+  "name": "李四",
+  "phone": "13900139000",
+  "email": "lisi@example.com",
+  "company_name": "客户公司名称",
+  "tags": "[\"VIP\", \"技术合作\"]",
+  "notes": "通过行业峰会认识，对AI产品感兴趣"
+}
+```
+
+## 查看客户列表
+
+全部客户：
+```json
+{
+  "action": "list_contacts",
+  "company_id": "公司ID"
+}
+```
+
+按标签筛选：
+```json
+{
+  "action": "list_contacts",
+  "company_id": "公司ID",
+  "tag": "VIP"
+}
+```
+
+## 更新客户信息
+
+```json
+{
+  "action": "update_contact",
+  "contact_id": "联系人ID",
+  "notes": "已发送产品方案，等待回复",
+  "last_contact_date": "2025-01-20"
+}
+```
+
+## 删除客户
+
+```json
+{
+  "action": "delete_contact",
+  "contact_id": "联系人ID"
+}
+```
+
+## 标签体系
+
+建议使用以下标签分类客户：
+- **客户类型**: `潜在客户`, `正式客户`, `VIP`, `合作伙伴`, `供应商`
+- **行业**: `科技`, `金融`, `教育`, `制造`, `服务`
+- **状态**: `跟进中`, `已成交`, `已流失`
+- **来源**: `转介绍`, `线上获客`, `行业活动`
+
+tags 字段使用 JSON 数组格式，例如: `["VIP", "科技", "跟进中"]`
+
+## 客户跟进建议
+
+在对话中帮助创业者：
+1. 添加客户时，主动询问标签和备注
+2. 更新跟进记录时，同步更新 `last_contact_date`
+3. 如果用户提到与某客户的互动，提醒记录
+4. 建议对长时间未联系的客户进行跟进

package/skills/basic-finance/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: basic-finance
+description: |
+  基础财务记账技能。当用户提到记账、收入、支出、报表、财务、收支、流水时激活。
+---
+
+# 基础财务技能
+
+使用 `opc_manage` 工具进行收支记录和财务统计。
+
+## 记账
+
+### 记录收入
+
+```json
+{
+  "action": "add_transaction",
+  "company_id": "公司ID",
+  "type": "income",
+  "category": "service_income",
+  "amount": 50000,
+  "description": "XX项目开发尾款",
+  "counterparty": "客户公司名",
+  "transaction_date": "2025-01-15"
+}
+```
+
+### 记录支出
+
+```json
+{
+  "action": "add_transaction",
+  "company_id": "公司ID",
+  "type": "expense",
+  "category": "rent",
+  "amount": 3000,
+  "description": "1月办公室租金",
+  "counterparty": "房东姓名",
+  "transaction_date": "2025-01-01"
+}
+```
+
+## 交易分类
+
+| 分类 | 类型 | 说明 |
+|---|---|---|
+| `service_income` | 收入 | 服务/咨询收入 |
+| `product_income` | 收入 | 产品销售收入 |
+| `investment_income` | 收入 | 投资收益 |
+| `salary` | 支出 | 工资/人力成本 |
+| `rent` | 支出 | 房租/场地费用 |
+| `utilities` | 支出 | 水电网等公用事业 |
+| `marketing` | 支出 | 营销/推广费用 |
+| `tax` | 支出 | 税费 |
+| `supplies` | 支出 | 办公用品/耗材 |
+| `other` | 通用 | 其他 |
+
+## 查询交易
+
+### 交易列表
+
+```json
+{
+  "action": "list_transactions",
+  "company_id": "公司ID",
+  "type": "income",
+  "start_date": "2025-01-01",
+  "end_date": "2025-01-31",
+  "limit": 20
+}
+```
+
+### 财务摘要
+
+```json
+{
+  "action": "finance_summary",
+  "company_id": "公司ID",
+  "start_date": "2025-01-01",
+  "end_date": "2025-03-31"
+}
+```
+
+返回: 总收入、总支出、净利润、交易笔数。
+
+## 记账建议
+
+对话中，帮助创业者：
+1. 收到收入/支出信息时，自动选择合适的分类
+2. 如果用户说"上个月"，计算出具体日期范围
+3. 定期提醒查看财务摘要
+4. 如果净利润为负，温和地提出关注
+5. 金额使用人民币（元），无需用户每次声明货币
+
+## 平台看板
+
+查看整体统计：
+```json
+{ "action": "dashboard" }
+```

package/skills/business-monitoring/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: business-monitoring
+description: |
+  运营监控技能。当用户提到指标、KPI、告警、监控、运营看板、数据统计、业务指标时激活。
+---
+
+# 运营监控技能
+
+使用 `opc_monitoring` 工具记录运营指标、管理告警和查看 KPI 汇总。
+
+## 指标记录
+
+### 记录运营指标
+
+```json
+{
+  "action": "record_metric",
+  "company_id": "公司ID",
+  "name": "月收入",
+  "value": 50000,
+  "unit": "元",
+  "category": "revenue",
+  "recorded_at": "2025-03-31",
+  "notes": "3月份总收入"
+}
+```
+
+常用指标分类: revenue(收入), user(用户), conversion(转化), cost(成本), other
+
+### 查询指标数据
+
+```json
+{
+  "action": "get_metrics",
+  "company_id": "公司ID",
+  "name": "月收入",
+  "category": "revenue",
+  "start_date": "2025-01-01",
+  "end_date": "2025-12-31"
+}
+```
+
+## 告警管理
+
+### 创建告警
+
+```json
+{
+  "action": "create_alert",
+  "company_id": "公司ID",
+  "title": "现金流预警",
+  "severity": "warning",
+  "category": "finance",
+  "message": "账户余额低于安全线，建议尽快回款"
+}
+```
+
+告警严重度: info(提示), warning(警告), critical(严重)
+
+### 查看告警列表
+
+```json
+{
+  "action": "list_alerts",
+  "company_id": "公司ID",
+  "severity": "critical",
+  "status": "active"
+}
+```
+
+### 消除告警
+
+```json
+{
+  "action": "dismiss_alert",
+  "alert_id": "告警ID"
+}
+```
+
+告警状态: `active` → `acknowledged` → `resolved`
+
+## KPI 汇总
+
+### 查看 KPI 看板
+
+```json
+{
+  "action": "kpi_summary",
+  "company_id": "公司ID"
+}
+```
+
+返回跨表聚合数据:
+- **财务**: 总收入/总支出/净利润
+- **团队**: 活跃员工数
+- **项目**: 总数/进行中/已完成
+- **合同**: 总数/活跃数/活跃合同价值
+- **客户**: 联系人总数
+- **告警**: 活跃告警（按严重度分组）
+- **最新指标**: 最近20条指标记录
+
+## 常用指标参考
+
+| 指标 | 单位 | 类别 | 建议记录频率 |
+|------|------|------|-------------|
+| 月收入 | 元 | revenue | 每月 |
+| 月支出 | 元 | cost | 每月 |
+| 注册用户数 | 人 | user | 每月 |
+| 活跃用户数 | 人 | user | 每月 |
+| 转化率 | % | conversion | 每月 |
+| 客单价 | 元 | revenue | 每月 |
+| 客户留存率 | % | user | 每月 |
+
+## 使用建议
+
+1. 每月固定日期 `record_metric` 记录核心指标
+2. 发现异常数据时主动 `create_alert` 提醒用户
+3. 每周查看 `kpi_summary` 了解公司整体状况
+4. 对 critical 级别告警立即处理，warning 级别限期处理
+5. 利用 `get_metrics` 对比历史数据，分析趋势