# 星环OPC中心 — OpenClaw 插件

> 一人公司(OPC)孵化与赋能平台，基于 [OpenClaw](https://github.com/openclaw/openclaw) 构建的 AI 员工全套解决方案。

![版本](https://img.shields.io/badge/version-0.4.0-blue)
![License](https://img.shields.io/badge/license-MIT-green)
![OpenClaw](https://img.shields.io/badge/OpenClaw-2026.x-orange)
![Tests](https://img.shields.io/badge/tests-199/199-brightgreen)

---

## ✨ 功能概览

| 模块 | 工具名 | 功能 |
|------|--------|------|
| 核心管理 | `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 看板 |
| **订单中台** | `opc_order` | **报价管理、合同流转、里程碑跟踪** |
| **新功能** | **v0.3: 5大功能 + v0.4: 订单闭环** | **见下方新增功能部分** |

**自动提醒服务**（后台每小时扫描）：
- 税务申报到期提醒（7天内）
- 合同到期提醒（30天内）
- **里程碑到期提醒（7天内）** ← 新增
- **应收风险分层（normal/warning/critical）** ← 新增
- 现金流预警（净流出超 5000 元）
- 融资轮次截止跟进

**管理后台** `http://localhost:18789/opc/admin`：
- 公司仪表盘、财务总览、监控中心
- 一键进入公司 AI 助手对话
- SOP 使用指南

---

## 🎯 v0.3 新增功能

### 1. 智能新手引导 (Onboarding Flow)

首次使用时自动触发个性化引导，通过 3 个问题了解用户需求：

- **业务阶段**: 想法阶段 / 准备注册 / 已注册 / 运营中
- **业务类型**: 内容创作 / 技术服务 / 产品销售 / 其他
- **预计年收入**: <10万 / 10-50万 / >50万

根据回答自动生成个性化启动清单，支持清单项目勾选和中断后继续。

**文件**: `src/opc/briefing-builder.ts`

### 2. 每日智能简报 (Daily Brief)

每天 9:00 主动推送实时简报，包含：

- **待办提醒**: 逾期款项催收、合同到期、税务申报、客户回访
- **经营数据**: 本周/本月收入、支出、利润、现金余额
- **AI 员工汇报**: 财务顾问现金流预警、法务合规提醒、运营进度汇报
- **推送渠道**: OpenClaw 对话 + 飞书 Webhook

**文件**: `src/opc/proactive-service.ts`, `src/opc/briefing-builder.ts`

### 3. 监控中心 Dashboard

一屏看清公司运营状态，包含：

- **关键指标卡片**: 本月收入/利润、现金余额、应收账款
- **风险预警列表**: 现金流预警(<2月)、合同到期(30天内)、逾期款项、税务提醒
- **今日待办**: 按优先级(紧急/重要/一般)排序，支持快速操作
- **AI 建议**: 基于数据分析的可执行建议，包含行动按钮

**访问方式**: `http://localhost:18789/opc/admin` → Dashboard 页签

**文件**: `src/api/dashboard.ts`, `src/web/config-ui.ts`

### 4. 应收应付管理 (Payment Management)

专业的应收应付账款管理系统：

**CRUD 操作**:
- 创建应收/应付记录（含客户、金额、到期日期）
- 查询列表（按方向/状态/客户筛选）
- 更新到账金额和状态（支持部分到账）
- 删除记录和批量操作

**核心功能**:
- 自动逾期检测（超期自动标记）
- 应收应付汇总统计（待收/待付总额、逾期笔数）
- 发票和合同关联
- 催款提醒和对账

**访问方式**: OpenClaw 对话或管理后台"收付款" Tab

**文件**: `src/tools/finance-tool.ts` (扩展 5 个新 action)

### 5. 智能记账 (Smart Accounting)

自然语言记账，智能分类和提醒：

**功能**:
- **自然语言解析**: 支持"记一笔支出，今天请客户吃饭花了500块"
- **自动分类**: 业务招待费/办公费用/固定资产/生活支出等
- **智能提醒**: "记得保存发票可抵税"、"超出本月预算"、"需要开发票吗？"
- **连续记账**: 支持多笔账目连续输入和修改

**使用场景**:
```
用户: "记一笔支出，买了办公用品，150块"
AI: ✓ 已记录
   - 类型: 支出
   - 金额: ¥150
   - 分类: 办公费用 (可抵扣)
   - 提醒: 记得申报时扣除，需要保存发票吗？
```

**文件**: `src/tools/finance-tool.ts`, `src/opc/intelligence-engine.ts`

---

## 🎯 v0.4 新增功能（订单闭环）

### 6. 订单中台 (Order Management)

签单到回款的全流程管理，**每个单子有状态、有金额、有责任时间**：

**核心流程**：
```
客户咨询 → 创建报价 → 报价转合同 → 签约确认 → 里程碑跟踪 → 款项到账 → 自动记账
```

**主要功能**：
- **报价管理**: 创建报价单（自动编号 QT-YYYYMM-NNN），支持多明细行
- **报价转合同**: 一键转合同，**自动创建里程碑和应收记录**
- **里程碑跟踪**: 签约→初稿→终稿，自动流转状态
- **到期提醒**: 7天内到期的里程碑自动推送
- **进行中订单**: 查看所有活跃合同及进度

**自动化亮点**：
- ✅ 报价转合同 → 自动创建 N 个里程碑 + N 条应收
- ✅ 签约确认 → 自动启动第一个里程碑
- ✅ 里程碑完成 → 自动启动下一个里程碑
- ✅ 到账登记 → 自动创建交易记录 + 更新里程碑

**工具名**: `opc_order`

**文件**: `src/tools/order-tool.ts`

**使用指南**: 查看 [ORDER_WORKFLOW_GUIDE.md](ORDER_WORKFLOW_GUIDE.md)

### 7. 回款助手增强 (Collection Assistant)

AI 赋能的应收催款和风险管理：

**核心功能**：
- **AI 催款文案**: 自动生成礼貌/坚定/紧急三种语气的催款邮件、微信、短信
- **风险分层**: 自动分类 normal（≤7天）/ warning（8-30天）/ critical（>30天）
- **一键到账**: 登记收款，自动创建交易记录，自动完成里程碑
- **自动提醒**: 到期前 3/7 天、逾期 7/15/30 天自动推送

**风险分层规则**：
| 风险等级 | 逾期天数 | 自动操作 |
|----------|----------|----------|
| normal | ≤ 7 天 | 常规跟进 |
| warning | 8-30 天 | 电话催收 |
| critical | > 30 天 | 创建告警，建议升级催收 |

**示例对话**：
```
你: "客户A逾期15天了，帮我生成催款文案"
AI: [调用 generate_collection_notice]
    已生成礼貌催款文案：
    - 邮件：【友情提醒】XX项目款项到期提醒
    - 微信：张总好！初稿款3600已到期，麻烦核对一下~
    - 短信：【XX公司】尊敬的客户，您有一笔3600元...
```

**工具名**: `opc_finance` (扩展 4 个新 action)

**文件**: `src/tools/finance-tool.ts`

### 8. 数据闭环追溯

完整的业务数据链：

```
报价单 ID → 合同 ID → 里程碑 ID → 应收 ID → 交易 ID
```

每一笔钱都有完整的来龙去脉，支持：
- 从报价单追溯到最终收款
- 从交易记录反查对应的合同和里程碑
- 生成客户价值分析报告

---

## 📦 安装

### 前提条件

- 已安装并运行 [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 说：

```
我想创建一家一人公司，帮我注册吧
```

系统会自动触发新手引导：
1. 询问你的业务阶段、业务类型、预计年收入
2. 生成个性化启动清单
3. 引导你完成首个任务

### 典型 SOP 流程

```
1. 新手引导        → 首次使用自动触发，生成启动清单
2. 公司注册        → opc_core: register_company
3. 激活公司        → opc_core: activate_company
4. 配置 AI 员工    → opc_staff: init_default_staff
5. 日常运营        → 智能记账、应收应付管理、定期简报
6. 监控仪表盘      → 访问 Dashboard 查看关键指标和风险预警
7. 融资管理        → opc_investment: create_round
8. 生命周期报告    → opc_lifecycle: generate_report
```

### 使用新增功能

#### 查看每日简报
```
AI: 给我发送今天的经营简报
```
（系统也会在每天 9:00 自动推送）

#### 管理应收应付
```
AI: 记录一笔应收账款，客户是张三，金额5000，3月15号到期
AI: 列出所有逾期的应收款项
AI: 更新张三的应收账款状态为已到账
```

#### 智能记账
```
AI: 记一笔支出，今天请客户吃饭花了800块
AI: 记录一笔收入，某某客户付款了2万
```

#### 访问 Dashboard
```
浏览器打开: http://localhost:18789/opc/admin
点击"监控中心"查看关键指标、风险预警和今日待办
```

---

## 📁 项目结构

```
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)