galaxy-opc-plugin 0.1.0

package/skills/media-ops/SKILL.md

@@ -0,0 +1,101 @@
+---
+name: media-ops
+description: |
+  新媒体运营技能。当用户提到公众号、小红书、抖音、微博、知乎、B站、内容发布、自媒体、内容日历时激活。
+---
+
+# 新媒体运营技能
+
+使用 `opc_media` 工具进行内容管理、发布日历和平台运营指导。
+
+## 内容管理
+
+### 创建内容
+
+```json
+{
+  "action": "create_content",
+  "company_id": "公司ID",
+  "title": "一人公司如何高效管理时间",
+  "platform": "微信公众号",
+  "content_type": "article",
+  "content": "文章正文或脚本内容...",
+  "scheduled_date": "2025-04-15",
+  "tags": "[\"时间管理\", \"一人公司\", \"效率\"]"
+}
+```
+
+支持平台: `微信公众号` / `小红书` / `抖音` / `微博` / `知乎` / `B站` / `其他`
+
+内容类型: `article`(图文) / `short_video`(短视频) / `image`(图片) / `live`(直播) / `other`
+
+### 查看内容列表
+
+```json
+{
+  "action": "list_content",
+  "company_id": "公司ID",
+  "platform": "小红书",
+  "status": "draft"
+}
+```
+
+内容状态: `draft`(草稿) → `scheduled`(已排期) → `published`(已发布) → `archived`(归档)
+
+### 更新内容
+
+```json
+{
+  "action": "update_content",
+  "content_id": "内容ID",
+  "status": "published",
+  "published_date": "2025-04-15",
+  "metrics": "{\"views\": 5200, \"likes\": 180, \"comments\": 32, \"shares\": 15}"
+}
+```
+
+发布后可记录数据指标（阅读量、点赞、评论、转发）。
+
+## 发布日历
+
+```json
+{
+  "action": "content_calendar",
+  "company_id": "公司ID",
+  "month": "2025-04"
+}
+```
+
+返回该月已排期和已发布的所有内容，方便规划发布节奏。
+
+## 平台指南
+
+```json
+{
+  "action": "platform_guide",
+  "platform": "小红书"
+}
+```
+
+返回该平台的内容格式建议、最佳发布时间和运营技巧。
+
+可用平台指南: `微信公众号` / `小红书` / `抖音` / `微博` / `知乎` / `B站`
+
+## 各平台要点速查
+
+| 平台 | 内容格式 | 最佳时间 |
+|---|---|---|
+| 微信公众号 | 图文 800-2000字 | 早7-9/中12-13/晚20-22 |
+| 小红书 | 图文笔记 300-800字 | 中12-14/晚19-22 |
+| 抖音 | 竖屏短视频 15-60秒 | 中12-13/晚18-22 |
+| 微博 | 140字+配图/视频 | 工作日10-12/20-23 |
+| 知乎 | 长文 1000-3000字 | 工作日10-12/20-22 |
+| B站 | 横屏中长视频 3-15分钟 | 周末全天/工作日18-23 |
+
+## 使用建议
+
+1. 帮用户规划每周 2-3 篇内容，保持稳定输出
+2. 同一内容可适配多个平台（改标题/格式/长度）
+3. 发布后提醒用户回填 `metrics` 数据，追踪效果
+4. 根据平台特点调整内容风格（知乎专业深度、小红书轻松实用）
+5. 使用 `content_calendar` 确保发布节奏均匀，避免断更

package/skills/procurement-management/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: procurement-management
+description: |
+  服务采购管理技能。当用户提到采购、服务商、供应商、订单、外包、SaaS订阅、服务续费时激活。
+---
+
+# 服务采购管理技能
+
+使用 `opc_procurement` 工具进行服务项目管理、采购订单管理和费用汇总。
+
+## 服务项目管理
+
+### 添加服务项目
+
+```json
+{
+  "action": "create_service",
+  "company_id": "公司ID",
+  "name": "阿里云 ECS",
+  "category": "saas",
+  "provider": "阿里云",
+  "unit_price": 500,
+  "billing_cycle": "monthly",
+  "description": "云服务器 2核4G"
+}
+```
+
+服务类别: saas, outsource(外包), subscription(订阅), consulting(咨询), other
+
+计费周期: monthly(月付), quarterly(季付), yearly(年付), one_time(一次性)
+
+### 查看服务列表
+
+```json
+{
+  "action": "list_services",
+  "company_id": "公司ID",
+  "category": "saas",
+  "status": "active"
+}
+```
+
+## 采购订单管理
+
+### 创建采购订单
+
+```json
+{
+  "action": "create_order",
+  "company_id": "公司ID",
+  "service_id": "服务ID",
+  "title": "2025年Q2云服务器续费",
+  "amount": 1500,
+  "order_date": "2025-04-01",
+  "delivery_date": "2025-04-01",
+  "notes": "季度预付"
+}
+```
+
+### 查看订单列表
+
+```json
+{
+  "action": "list_orders",
+  "company_id": "公司ID",
+  "status": "pending"
+}
+```
+
+订单状态: `pending` → `approved` → `paid`，或 `cancelled`
+
+## 采购汇总
+
+### 查看采购统计
+
+```json
+{
+  "action": "order_summary",
+  "company_id": "公司ID"
+}
+```
+
+返回: 总订单数、总金额、按状态/类别分组统计、活跃服务月度成本。
+
+## 使用建议
+
+1. 先 `create_service` 建立服务项目清单（如云服务、设计外包、法律顾问）
+2. 每次采购时 `create_order` 关联对应服务
+3. 定期 `order_summary` 查看采购支出分布
+4. 注意 `billing_cycle` 字段，方便预算规划
+5. 对比采购支出和收入，及时调整成本结构

package/skills/project-management/SKILL.md

@@ -0,0 +1,125 @@
+---
+name: project-management
+description: |
+  项目管理技能。当用户提到项目、任务、看板、排期、工时、里程碑、项目进度、任务分配时激活。
+---
+
+# 项目管理技能
+
+使用 `opc_project` 工具进行项目创建、任务管理和进度追踪。
+
+## 项目管理
+
+### 创建项目
+
+```json
+{
+  "action": "create_project",
+  "company_id": "公司ID",
+  "name": "XX客户官网重构",
+  "description": "响应式重构，含前后端和部署",
+  "start_date": "2025-04-01",
+  "end_date": "2025-06-30",
+  "budget": 150000
+}
+```
+
+### 查看项目列表
+
+```json
+{
+  "action": "list_projects",
+  "company_id": "公司ID",
+  "status": "active"
+}
+```
+
+项目状态: `planning`(规划中) → `active`(进行中) → `completed`(已完成)，或 `paused`(暂停) / `cancelled`(取消)
+
+### 更新项目
+
+```json
+{
+  "action": "update_project",
+  "project_id": "项目ID",
+  "status": "active",
+  "spent": 50000,
+  "description": "新增移动端适配需求"
+}
+```
+
+## 任务管理
+
+### 添加任务
+
+```json
+{
+  "action": "add_task",
+  "project_id": "项目ID",
+  "company_id": "公司ID",
+  "title": "完成首页UI设计",
+  "description": "参照竞品分析结果，设计3版方案",
+  "assignee": "张三",
+  "priority": "high",
+  "due_date": "2025-04-15",
+  "hours_estimated": 16
+}
+```
+
+优先级: `urgent`(紧急) / `high`(高) / `medium`(中) / `low`(低)
+
+### 查看任务列表
+
+```json
+{
+  "action": "list_tasks",
+  "project_id": "项目ID",
+  "status": "in_progress"
+}
+```
+
+任务按优先级和截止日期排序。
+
+任务状态: `todo`(待办) → `in_progress`(进行中) → `review`(审核) → `done`(完成)
+
+### 更新任务
+
+```json
+{
+  "action": "update_task",
+  "task_id": "任务ID",
+  "status": "done",
+  "hours_actual": 20
+}
+```
+
+## 项目概况
+
+```json
+{
+  "action": "project_summary",
+  "project_id": "项目ID"
+}
+```
+
+返回: 项目基本信息、各状态任务统计（数量/预估工时/实际工时）、逾期任务列表。
+
+## 看板视图
+
+```json
+{
+  "action": "kanban",
+  "project_id": "项目ID"
+}
+```
+
+返回四列看板: `todo` / `in_progress` / `review` / `done`
+
+## 使用建议
+
+1. 每个项目创建后先拆解为 5-10 个具体任务
+2. 任务粒度建议 2-8 小时，太大需再拆分
+3. 完成任务时填写 `hours_actual`，便于后续项目报价参考
+4. 定期使用 `project_summary` 查看进度和逾期风险
+5. 一人公司项目 `assignee` 可填自己名字或留空
+6. 预算管理: 通过 `update_project` 更新 `spent` 字段追踪支出

package/src/api/companies.ts

@@ -0,0 +1,193 @@
+/**
+ * 星环OPC中心 — 公司 CRUD REST API
+ *
+ * 路由:
+ *   GET    /opc/api/companies          — 列出所有公司
+ *   GET    /opc/api/companies/:id      — 获取单个公司
+ *   POST   /opc/api/companies          — 创建公司
+ *   PUT    /opc/api/companies/:id      — 更新公司
+ *   DELETE /opc/api/companies/:id      — 删除公司
+ *   GET    /opc/api/companies/:id/transactions — 获取公司交易
+ *   GET    /opc/api/companies/:id/contacts     — 获取公司客户
+ *   GET    /opc/api/companies/:id/finance      — 获取公司财务摘要
+ */
+
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { OpcDatabase } from "../db/index.js";
+import { CompanyManager } from "../opc/company-manager.js";
+import type { OpcCompanyStatus } from "../opc/types.js";
+
+const OPC_API_PREFIX = "/opc/api/companies";
+
+function sendJson(res: ServerResponse, data: unknown, status = 200): void {
+  res.writeHead(status, { "Content-Type": "application/json; charset=utf-8" });
+  res.end(JSON.stringify(data));
+}
+
+function sendError(res: ServerResponse, message: string, status = 400): void {
+  sendJson(res, { error: message }, status);
+}
+
+async function readBody(req: IncomingMessage, maxBytes = 1024 * 1024): Promise<string> {
+  return new Promise((resolve, reject) => {
+    let body = "";
+    let bytes = 0;
+    req.on("data", (chunk: Buffer) => {
+      bytes += chunk.length;
+      if (bytes > maxBytes) {
+        reject(new Error("Request body too large"));
+        req.destroy();
+        return;
+      }
+      body += chunk.toString();
+    });
+    req.on("end", () => resolve(body));
+    req.on("error", reject);
+  });
+}
+
+function parseJson(body: string): Record<string, unknown> | null {
+  try {
+    return JSON.parse(body) as Record<string, unknown>;
+  } catch {
+    return null;
+  }
+}
+
+export function registerCompanyRoutes(api: OpenClawPluginApi, db: OpcDatabase): void {
+  const manager = new CompanyManager(db);
+
+  api.registerHttpHandler(async (req, res) => {
+    const rawUrl = req.url ?? "";
+    const method = req.method?.toUpperCase() ?? "GET";
+
+    // 解析 URL，分离路径和查询参数
+    const urlObj = new URL(rawUrl, "http://localhost");
+    const pathname = urlObj.pathname;
+
+    // 只处理 /opc/api/companies 开头的请求
+    if (!pathname.startsWith(OPC_API_PREFIX)) {
+      return false;
+    }
+
+    const subPath = pathname.slice(OPC_API_PREFIX.length);
+
+    try {
+      // GET/POST /opc/api/companies
+      if (subPath === "" || subPath === "/") {
+        if (method === "GET") {
+          const status = urlObj.searchParams.get("status") as OpcCompanyStatus | null;
+          sendJson(res, manager.listCompanies(status ?? undefined));
+          return true;
+        }
+        if (method === "POST") {
+          const body = parseJson(await readBody(req));
+          if (!body) {
+            sendError(res, "Invalid JSON body");
+            return true;
+          }
+          const name = body.name as string | undefined;
+          const industry = body.industry as string | undefined;
+          const owner_name = body.owner_name as string | undefined;
+          if (!name || !industry || !owner_name) {
+            sendError(res, "缺少必填字段: name, industry, owner_name");
+            return true;
+          }
+          const company = manager.registerCompany({
+            name,
+            industry,
+            owner_name,
+            owner_contact: (body.owner_contact as string) ?? undefined,
+            registered_capital: (body.registered_capital as number) ?? undefined,
+            description: (body.description as string) ?? undefined,
+          });
+          sendJson(res, company, 201);
+          return true;
+        }
+        sendError(res, "Method not allowed", 405);
+        return true;
+      }
+
+      // 提取 ID 和子路径
+      const match = subPath.match(/^\/([^/]+)(\/.*)?$/);
+      if (!match) {
+        sendError(res, "Invalid path", 404);
+        return true;
+      }
+
+      const companyId = match[1];
+      const tail = match[2] ?? "";
+
+      // GET /opc/api/companies/:id/transactions
+      if (tail === "/transactions" && method === "GET") {
+        sendJson(res, db.listTransactions(companyId, { limit: 100 }));
+        return true;
+      }
+
+      // GET /opc/api/companies/:id/contacts
+      if (tail === "/contacts" && method === "GET") {
+        sendJson(res, db.listContacts(companyId));
+        return true;
+      }
+
+      // GET /opc/api/companies/:id/finance
+      if (tail === "/finance" && method === "GET") {
+        sendJson(res, db.getFinanceSummary(companyId));
+        return true;
+      }
+
+      // 以下处理 /opc/api/companies/:id（无子路径）
+      if (tail !== "") {
+        sendError(res, "Not found", 404);
+        return true;
+      }
+
+      switch (method) {
+        // GET /opc/api/companies/:id
+        case "GET": {
+          const company = manager.getCompany(companyId);
+          if (!company) {
+            sendError(res, "公司不存在", 404);
+          } else {
+            sendJson(res, company);
+          }
+          return true;
+        }
+
+        // POST /opc/api/companies (companyId 在这种情况下是数据的一部分)
+        // 实际的 POST 创建走 subPath === "" 分支，这里不需要处理
+
+        // PUT /opc/api/companies/:id
+        case "PUT": {
+          const body = parseJson(await readBody(req));
+          if (!body) {
+            sendError(res, "Invalid JSON body");
+            return true;
+          }
+          const updated = manager.updateCompany(companyId, body as Record<string, string>);
+          if (!updated) {
+            sendError(res, "公司不存在", 404);
+          } else {
+            sendJson(res, updated);
+          }
+          return true;
+        }
+
+        // DELETE /opc/api/companies/:id
+        case "DELETE": {
+          const deleted = manager.deleteCompany(companyId);
+          sendJson(res, { deleted });
+          return true;
+        }
+
+        default:
+          sendError(res, "Method not allowed", 405);
+          return true;
+      }
+    } catch (err) {
+      sendError(res, err instanceof Error ? err.message : String(err), 500);
+      return true;
+    }
+  });
+}

package/src/api/dashboard.ts

@@ -0,0 +1,25 @@
+/**
+ * 星环OPC中心 — Dashboard 统计 API
+ *
+ * 路由:
+ *   GET /opc/api/dashboard/stats — 平台整体统计
+ */
+
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { OpcDatabase } from "../db/index.js";
+
+export function registerDashboardRoutes(api: OpenClawPluginApi, db: OpcDatabase): void {
+  api.registerHttpRoute({
+    path: "/opc/api/dashboard/stats",
+    handler: (_req, res) => {
+      try {
+        const stats = db.getDashboardStats();
+        res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+        res.end(JSON.stringify(stats));
+      } catch (err) {
+        res.writeHead(500, { "Content-Type": "application/json; charset=utf-8" });
+        res.end(JSON.stringify({ error: err instanceof Error ? err.message : String(err) }));
+      }
+    },
+  });
+}

package/src/api/routes.ts

@@ -0,0 +1,14 @@
+/**
+ * 星环OPC中心 — HTTP API 路由注册
+ */
+
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import type { OpcDatabase } from "../db/index.js";
+import { registerCompanyRoutes } from "./companies.js";
+import { registerDashboardRoutes } from "./dashboard.js";
+
+export function registerHttpRoutes(api: OpenClawPluginApi, db: OpcDatabase): void {
+  registerCompanyRoutes(api, db);
+  registerDashboardRoutes(api, db);
+  api.logger.info("opc: 已注册 HTTP API 路由");
+}

package/src/db/index.ts

@@ -0,0 +1,63 @@
+/**
+ * 星环OPC中心 — 数据库抽象层
+ */
+
+import type {
+  OpcCompany,
+  OpcCompanyStatus,
+  OpcContact,
+  OpcEmployee,
+  OpcTransaction,
+} from "../opc/types.js";
+
+export interface OpcDatabase {
+  close(): void;
+
+  // Companies
+  createCompany(data: Omit<OpcCompany, "id" | "created_at" | "updated_at">): OpcCompany;
+  getCompany(id: string): OpcCompany | null;
+  listCompanies(status?: OpcCompanyStatus): OpcCompany[];
+  updateCompany(id: string, data: Partial<OpcCompany>): OpcCompany | null;
+  deleteCompany(id: string): boolean;
+
+  // Employees
+  createEmployee(data: Omit<OpcEmployee, "id" | "created_at">): OpcEmployee;
+  getEmployee(id: string): OpcEmployee | null;
+  listEmployees(companyId: string): OpcEmployee[];
+
+  // Transactions
+  createTransaction(data: Omit<OpcTransaction, "id" | "created_at">): OpcTransaction;
+  getTransaction(id: string): OpcTransaction | null;
+  listTransactions(
+    companyId: string,
+    opts?: { type?: string; startDate?: string; endDate?: string; limit?: number },
+  ): OpcTransaction[];
+  getFinanceSummary(
+    companyId: string,
+    startDate?: string,
+    endDate?: string,
+  ): { total_income: number; total_expense: number; net: number; count: number };
+
+  // Contacts
+  createContact(data: Omit<OpcContact, "id" | "created_at" | "updated_at">): OpcContact;
+  getContact(id: string): OpcContact | null;
+  listContacts(companyId: string, tag?: string): OpcContact[];
+  updateContact(id: string, data: Partial<OpcContact>): OpcContact | null;
+  deleteContact(id: string): boolean;
+
+  // Dashboard
+  getDashboardStats(): {
+    total_companies: number;
+    active_companies: number;
+    total_transactions: number;
+    total_contacts: number;
+    total_revenue: number;
+    total_expense: number;
+  };
+
+  // Generic (Phase 2)
+  query(sql: string, ...params: unknown[]): unknown[];
+  queryOne(sql: string, ...params: unknown[]): unknown | null;
+  execute(sql: string, ...params: unknown[]): { changes: number };
+  genId(): string;
+}

package/src/db/migrations.ts

@@ -0,0 +1,67 @@
+/**
+ * 星环OPC中心 — 数据库版本迁移
+ */
+
+import type Database from "better-sqlite3";
+
+export type Migration = {
+  version: number;
+  description: string;
+  up: (db: Database.Database) => void;
+};
+
+export const migrations: Migration[] = [
+  {
+    version: 1,
+    description: "Initial schema — companies, employees, transactions, contacts",
+    up(_db) {
+      // Tables and indexes are created in initializeDatabase.
+      // This migration exists as the baseline version marker.
+    },
+  },
+  {
+    version: 2,
+    description: "Phase 3 — investment, procurement, lifecycle, monitoring, tool_config",
+    up(_db) {
+      // Tables and indexes are created in initializeDatabase via OPC_TABLES/OPC_INDEXES.
+      // This migration exists as the Phase 3 version marker.
+    },
+  },
+  {
+    version: 3,
+    description: "OPB Canvas — one-person business canvas table",
+    up(_db) {
+      // opc_opb_canvas table is created in initializeDatabase via OPC_TABLES/OPC_INDEXES.
+      // This migration exists as the OPB Canvas version marker.
+    },
+  },
+];
+
+/**
+ * Run pending migrations up to the latest version.
+ */
+export function runMigrations(db: Database.Database): void {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS opc_migrations (
+      version INTEGER PRIMARY KEY,
+      description TEXT NOT NULL,
+      applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+
+  const applied = new Set(
+    db
+      .prepare("SELECT version FROM opc_migrations")
+      .all()
+      .map((row) => (row as { version: number }).version),
+  );
+
+  for (const m of migrations) {
+    if (applied.has(m.version)) continue;
+    m.up(db);
+    db.prepare("INSERT INTO opc_migrations (version, description) VALUES (?, ?)").run(
+      m.version,
+      m.description,
+    );
+  }
+}