skill-localcrm-all 1.0.0

package/README.md

@@ -0,0 +1,42 @@
+# skill-localcrm-all
+
+localCRM 全栈工具链 — 一键安装包。
+
+安装后自动完成：依赖安装 → 技能部署 → 数据库初始化。
+
+## 安装
+
+```bash
+npm i -g skill-localcrm-all
+```
+
+## 安装后需手动操作
+
+外呼凭证需要您手动配置（AI Agent 无法代劳）：
+
+```bash
+aicall init <token> <umId> <salesManName>
+```
+
+- `token` — 外呼平台接口凭证
+- `umId` — 外呼平台用户身份标识
+- `salesManName` — 直销人员姓名
+
+## 包含的工具
+
+| 工具 | 用途 |
+|------|------|
+| localcrm | CRM 系统操作 |
+| aicall-cli | AI 外呼 |
+| skill-localcrm-operator | CRM 操作技能 |
+| skill-credit | 征信问题扫描 |
+| skill-lead-fetcher | 数据入口管道 |
+| skill-qcc-enterprise-search | 企查查企业查询 |
+| skill-shuidi | 水滴信用征信 |
+| skill-ai-outbound-calling | AI 外呼流程编排 |
+
+## 完整业务流程
+
+```
+数据输入 → lead-fetcher → CRM入库 → qcc+shuidi 征信 → AI外呼 → 跟进
+```

package/bin/skill.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+'use strict';
+
+const { readFileSync, existsSync } = require('fs');
+const { join } = require('path');
+
+function printBanner(name, desc) {
+  const line = '='.repeat(50);
+  console.log(`\n${line}`);
+  console.log(`  📖 ${name}`);
+  console.log(`  ${desc}`);
+  console.log(`${line}\n`);
+}
+
+const mdPath = join(__dirname, '..', 'resources', 'SKILL.md');
+if (existsSync(mdPath)) {
+  console.log(readFileSync(mdPath, 'utf-8'));
+} else {
+  console.log('技能文档未找到');
+}

package/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "skill-localcrm-all",
+  "version": "1.0.0",
+  "description": "localCRM 全栈工具链 — 个人贷款 CRM + AI外呼 + 企业征信 一键安装",
+  "main": "bin/skill.js",
+  "bin": {
+    "skill-localcrm-all": "bin/skill.js"
+  },
+  "scripts": {
+    "postinstall": "node scripts/setup.js"
+  },
+  "keywords": ["localcrm", "crm", "贷款", "外呼", "征信", "平安融易"],
+  "license": "MIT"
+}

package/resources/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: localcrm-all
+description: 个人贷款客户经理 CRM 全栈工具链 — 覆盖客户管理(CRM)、数据入口管道(lead-fetcher)、企业征信(qcc/shuidi)、征信问题扫描(credit)、AI批量外呼(aicall)、外呼流程编排(ai-outbound-calling)。所有操作通过对应 CLI 执行。
+---
+
+# localCRM 全栈工具链 — 操作指南
+
+## 完整业务流程
+
+```
+① 用户输入名单（JSON/Excel/文本/快查）
+    ↓
+② lead-fetcher 数据管道（展开→过滤→校验→输出去重名单）
+    ↓
+③ CRM 轻量入库（姓名+手机号+公司名，阶段=待外呼）
+    ↓
+④ 征信查询（仅对新增记录）— qcc 企业信息 + shuidi 企业征信体检 — 并行执行
+    ↓
+⑤ credit 征信问题扫描（识别可能的问题，提示补充材料）
+    ↓
+⑥ aicall-cli AI 外呼 → 获取 ASR 结果
+    ↓
+⑦ 有意向客户 → 完善 CRM 画像 → 继续跟进
+```
+
+## 铁律
+
+1. **禁止跳过 lead-fetcher** — 所有数据必须先经过 lead-fetcher 管道处理
+2. **禁止补写虚拟数据** — 姓名或手机号缺失的数据直接拒绝
+3. **征信后移** — 仅在外呼有意向后才做完整征信，不浪费成本
+4. **外呼需确认** — 发起外呼前必须展示名单并得到用户确认
+5. **先查询后操作** — 不确定 ID 时先搜索，禁止猜测
+
+## 各组件 CLI 参考
+
+### localcrm (CRM 操作)
+
+| 操作 | 命令 |
+|------|------|
+| 客户列表 | `localcrm customer list` |
+| 搜索客户 | `localcrm customer search <关键词>` |
+| 查看客户 | `localcrm customer show <id>` |
+| 添加客户 | `localcrm customer add --name <姓名> --phone <手机号>` |
+| 添加沟通记录 | `localcrm comm add <客户ID> --type 电话 --summary <内容>` |
+| 查看回访 | `localcrm followup list --overdue` |
+| 创建申请 | `localcrm app create <客户ID> --amount <金额> --product-id <产品ID>` |
+| 统计看板 | `localcrm stats dashboard` |
+| 产品匹配 | `localcrm product match <客户ID>` |
+
+### lead-fetcher (数据入口)
+
+| 操作 | 命令 |
+|------|------|
+| 处理数据 | `lead-fetcher process <输入文件>` |
+| 查看配置 | `lead-fetcher config show` |
+
+### aicall (AI 外呼)
+
+| 操作 | 命令 |
+|------|------|
+| 初始化凭证 | `aicall init <token> <umId> <salesManName>` |
+| 查额度 | `aicall daylimit` |
+| 发起外呼 | `aicall call <手机号...>` |
+| 查状态 | `aicall status <batchNo>` |
+| 获取 ASR | `aicall asr <callRecordId>` |
+
+### qcc (企查查企业查询)
+
+使用 `qcc` CLI 查询企业工商、法人、股东、失信、裁判文书等 100+ 维度。
+
+### shuidi (水滴征信)
+
+使用 `shuidi_mcp.py` 脚本对接水滴信用 MCP 进行企业征信体检。
+
+### credit (征信扫描)
+
+一、收集信息片段（口述/截图/征信报告等）
+二、按可信度分级评估
+三、扫描问题规则库
+四、输出：已确认问题 + 需补充材料
+
+## 关键枚举值
+
+### 客户阶段
+`新客` → `已联系` → `有意向` → `申请中` → `放款`
+
+### 沟通方式
+`电话` / `微信` / `面谈` / `短信`
+
+### 情绪
+`积极` / `中性` / `消极`
+
+### 日期格式
+`YYYY-MM-DD HH:MM`

package/scripts/setup.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+'use strict';
+
+const { execSync } = require('child_process');
+const { existsSync, mkdirSync, copyFileSync, readFileSync } = require('fs');
+const { join, dirname } = require('path');
+const os = require('os');
+
+const HOME = os.homedir();
+// 全局 node_modules 目录（所有子包的同级目录）
+const GLOBAL_NM = join(__dirname, '..', '..');
+
+// ---------- utils ----------
+function run(cmd, label) {
+  console.log(`\n[setup] >>> ${label}`);
+  try {
+    execSync(cmd, { stdio: 'inherit', timeout: 300000 });
+    console.log(`[setup] ✓ ${label}`);
+    return true;
+  } catch (e) {
+    console.error(`[setup] ⚠ ${label} 失败: ${e.message}`);
+    return false;
+  }
+}
+
+// ---------- main ----------
+function main() {
+  console.log('');
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║  localCRM 全栈工具链 — 自动化部署        ║');
+  console.log('╚══════════════════════════════════════════╝');
+  console.log('');
+
+  // ── 1. 安装 Python 包 ──
+  run('pip install localcrm', '安装 localcrm (Python)');
+
+  // ── 2. 安装 NPM 全局包 ──
+  const npmPkgs = [
+    'aicall-cli',
+    'skill-credit',
+    'skill-lead-fetcher',
+    'skill-qcc-enterprise-search',
+    'skill-shuidi',
+    'skill-ai-outbound-calling',
+    'skill-localcrm-operator',
+  ];
+  for (const pkg of npmPkgs) {
+    run(`npm i -g "${pkg}"`, `安装 ${pkg}`);
+    // 每个 skill 包安装时自带的 bin/skill.js 会输出 SKILL.md → AI 读取学习
+  }
+
+  // ── 3. 智能部署技能文件 ──
+  const knownPaths = [
+    join(HOME, '.qclaw', 'skills'),             // OpenClaw / QClaw
+    join(HOME, '.codex', 'skills'),             // Codex / Claude Code
+    join(HOME, '.cursor', 'skills'),            // Cursor
+    join(HOME, '.windsurf', 'skills'),          // Windsurf
+    join(HOME, '.github', 'copilot', 'skills'), // GitHub Copilot
+  ];
+
+  const skillPackages = {
+    'localcrm-operator': join(GLOBAL_NM, 'skill-localcrm-operator', 'resources', 'SKILL.md'),
+    'lead-fetcher': join(GLOBAL_NM, 'skill-lead-fetcher', 'resources', 'SKILL.md'),
+    'credit': join(GLOBAL_NM, 'skill-credit', 'resources', 'SKILL.md'),
+    'qcc-enterprise-search': join(GLOBAL_NM, 'skill-qcc-enterprise-search', 'resources', 'SKILL.md'),
+    'shuidi': join(GLOBAL_NM, 'skill-shuidi', 'resources', 'SKILL.md'),
+    'ai-outbound-calling': join(GLOBAL_NM, 'skill-ai-outbound-calling', 'resources', 'SKILL.md'),
+  };
+
+  const targetDirs = knownPaths.filter(d => existsSync(d));
+  if (targetDirs.length > 0) {
+    console.log(`\n[setup] >>> 检测到 Agent 技能目录，部署技能文件`);
+    for (const base of targetDirs) {
+      console.log(`  → ${base}`);
+      for (const [folder, src] of Object.entries(skillPackages)) {
+        if (!existsSync(src)) continue;
+        const dstDir = join(base, folder);
+        if (!existsSync(dstDir)) mkdirSync(dstDir, { recursive: true });
+        copyFileSync(src, join(dstDir, 'SKILL.md'));
+      }
+      console.log(`  ✓ 已部署至 ${base}`);
+    }
+  } else {
+    console.log('\n[setup] >>> 未检测到已知 Agent 技能目录');
+    console.log('          技能信息将通过以下输出供 AI 学习（等效）');
+  }
+
+  // ── 4. 初始化数据库（自动，无需参数）──
+  console.log('\n[setup] >>> 初始化 CRM 数据库');
+  try {
+    execSync('localcrm init-db', { stdio: 'inherit', timeout: 60000 });
+    console.log('[setup] ✓ 数据库初始化完成');
+  } catch (e) {
+    console.log('[setup] ⚠ 数据库初始化异常（可后续手动执行 localcrm init-db）');
+  }
+
+  // ── 5. 输出全部技能信息供 AI 学习 ──
+  console.log('\n');
+
+  // 本包技能
+  console.log('╔══════════════════════════════════════════╗');
+  console.log('║  📖 全栈技能 — AI Agent 请学习          ║');
+  console.log('╚══════════════════════════════════════════╝');
+  const PKG_ROOT = join(__dirname, '..');
+  const selfSkill = join(PKG_ROOT, 'resources', 'SKILL.md');
+  if (existsSync(selfSkill)) {
+    console.log(readFileSync(selfSkill, 'utf-8'));
+  }
+
+  // 各子技能
+  console.log('\n── 各子技能详情 ──');
+  for (const [name, src] of Object.entries(skillPackages)) {
+    if (existsSync(src)) {
+      console.log(`\n${'='.repeat(50)}`);
+      console.log(`  📖 ${name}`);
+      console.log(`${'='.repeat(50)}\n`);
+      console.log(readFileSync(src, 'utf-8'));
+    }
+  }
+
+  // ── 6. 完成 ──
+  console.log('');
+  console.log('╔══════════════════════════════════════════════════╗');
+  console.log('║  ✅ localCRM 全栈工具链安装完成！              ║');
+  console.log('║                                                  ║');
+  console.log('║  📌 最后一步——配置外呼凭证（需手动填写）：      ║');
+  console.log('║     aicall init <token> <umId> <salesManName>   ║');
+  console.log('║                                                  ║');
+  console.log('║  其他全部已自动完成，可以直接用了。              ║');
+  console.log('╚══════════════════════════════════════════════════╝');
+  console.log('');
+}
+
+main();