skill-localcrm-all 1.0.0 → 1.0.1

package/README.md

@@ -1,42 +1,19 @@
 # skill-localcrm-all
 
-localCRM 全栈工具链 — 一键安装包。
-
-安装后自动完成：依赖安装 → 技能部署 → 数据库初始化。
-
-## 安装
+localCRM 全栈工具链 — 一键安装。
 
 ```bash
 npm i -g skill-localcrm-all
 ```
 
-## 安装后需手动操作
-
-外呼凭证需要您手动配置（AI Agent 无法代劳）：
+安装后运行以下命令触发安装（如果 postinstall 被跳过）：
 
 ```bash
-aicall init <token> <umId> <salesManName>
+skill-localcrm-all
 ```
 
-- `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外呼 → 跟进
+```bash
+aicall init <token> <umId> <salesManName>
 ```

package/bin/skill.js

@@ -1,20 +1,24 @@
 #!/usr/bin/env node
 'use strict';
 
-const { readFileSync, existsSync } = require('fs');
+const { execSync } = require('child_process');
+const { existsSync, readFileSync } = 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`);
+// ── 无论是否已安装，都先确保所有依赖到位 ──
+console.log('\n[skill-localcrm-all] 检查并完成安装...\n');
+
+const setupScript = join(__dirname, '..', 'scripts', 'setup.js');
+if (existsSync(setupScript)) {
+  try {
+    execSync(`node "${setupScript}"`, { stdio: 'inherit', timeout: 300000 });
+  } catch (e) {
+    // setup 报错是正常的（比如某些包已安装），继续输出技能文档
+  }
 }
 
+// ── 输出技能文档供 AI 学习 ──
 const mdPath = join(__dirname, '..', 'resources', 'SKILL.md');
 if (existsSync(mdPath)) {
   console.log(readFileSync(mdPath, 'utf-8'));
-} else {
-  console.log('技能文档未找到');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-localcrm-all",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "localCRM 全栈工具链 — 个人贷款 CRM + AI外呼 + 企业征信 一键安装",
   "main": "bin/skill.js",
   "bin": {

package/resources/SKILL.md

@@ -3,7 +3,7 @@ name: localcrm-all
 description: 个人贷款客户经理 CRM 全栈工具链 — 覆盖客户管理(CRM)、数据入口管道(lead-fetcher)、企业征信(qcc/shuidi)、征信问题扫描(credit)、AI批量外呼(aicall)、外呼流程编排(ai-outbound-calling)。所有操作通过对应 CLI 执行。
 ---
 
-# localCRM 全栈工具链 — 操作指南
+# localCRM 全栈工具链
 
 ## 完整业务流程
 
@@ -14,7 +14,7 @@ description: 个人贷款客户经理 CRM 全栈工具链 — 覆盖客户管理
     ↓
 ③ CRM 轻量入库（姓名+手机号+公司名，阶段=待外呼）
     ↓
-④ 征信查询（仅对新增记录）— qcc 企业信息 + shuidi 企业征信体检 — 并行执行
+④ 征信查询（仅对新增记录）— qcc 企业信息 + shuidi 企业征信体检
     ↓
 ⑤ credit 征信问题扫描（识别可能的问题，提示补充材料）
     ↓
@@ -25,70 +25,43 @@ description: 个人贷款客户经理 CRM 全栈工具链 — 覆盖客户管理
 
 ## 铁律
 
-1. **禁止跳过 lead-fetcher** — 所有数据必须先经过 lead-fetcher 管道处理
+1. **禁止跳过 lead-fetcher** — 所有数据必须先经过 lead-fetcher 管道
 2. **禁止补写虚拟数据** — 姓名或手机号缺失的数据直接拒绝
-3. **征信后移** — 仅在外呼有意向后才做完整征信，不浪费成本
+3. **征信后移** — 仅在外呼有意向后才做完整征信
 4. **外呼需确认** — 发起外呼前必须展示名单并得到用户确认
 5. **先查询后操作** — 不确定 ID 时先搜索，禁止猜测
 
-## 各组件 CLI 参考
-
-### localcrm (CRM 操作)
+## 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 comm add <客户ID> --type 电话 --summary <内容>` |
+| 回访列表 | `localcrm followup list` |
 | 创建申请 | `localcrm app create <客户ID> --amount <金额> --product-id <产品ID>` |
 | 统计看板 | `localcrm stats dashboard` |
 | 产品匹配 | `localcrm product match <客户ID>` |
 
 ### lead-fetcher (数据入口)
+`lead-fetcher process <输入文件>`
 
+### aicall (外呼)
 | 操作 | 命令 |
 |------|------|
-| 处理数据 | `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 (征信扫描)
-
-一、收集信息片段（口述/截图/征信报告等）
-二、按可信度分级评估
-三、扫描问题规则库
-四、输出：已确认问题 + 需补充材料
+### qcc / shuidi / credit
+通过对应 CLI 或 Python 脚本查询企业征信。
 
 ## 关键枚举值
 
-### 客户阶段
-`新客` → `已联系` → `有意向` → `申请中` → `放款`
-
-### 沟通方式
-`电话` / `微信` / `面谈` / `短信`
-
-### 情绪
-`积极` / `中性` / `消极`
-
-### 日期格式
-`YYYY-MM-DD HH:MM`
+- **客户阶段**: `新客` → `已联系` → `有意向` → `申请中` → `放款`
+- **沟通方式**: `电话` / `微信` / `面谈` / `短信`
+- **情绪**: `积极` / `中性` / `消极`
+- **日期格式**: `YYYY-MM-DD HH:MM`

package/scripts/setup.js

@@ -3,16 +3,17 @@
 
 const { execSync } = require('child_process');
 const { existsSync, mkdirSync, copyFileSync, readFileSync } = require('fs');
-const { join, dirname } = require('path');
+const { join } = require('path');
 const os = require('os');
 
 const HOME = os.homedir();
-// 全局 node_modules 目录（所有子包的同级目录）
 const GLOBAL_NM = join(__dirname, '..', '..');
 
-// ---------- utils ----------
+function already(label) {
+  console.log(`[setup] ○ ${label} — 已存在，跳过`);
+}
 function run(cmd, label) {
-  console.log(`\n[setup] >>> ${label}`);
+  console.log(`[setup] >>> ${label}`);
   try {
     execSync(cmd, { stdio: 'inherit', timeout: 300000 });
     console.log(`[setup] ✓ ${label}`);
@@ -23,39 +24,41 @@ function run(cmd, label) {
   }
 }
 
-// ---------- main ----------
 function main() {
-  console.log('');
-  console.log('╔══════════════════════════════════════════╗');
+  console.log('\n╔══════════════════════════════════════════╗');
   console.log('║  localCRM 全栈工具链 — 自动化部署        ║');
   console.log('╚══════════════════════════════════════════╝');
-  console.log('');
 
-  // ── 1. 安装 Python 包 ──
-  run('pip install localcrm', '安装 localcrm (Python)');
+  // ── 1. localcrm ──
+  try {
+    execSync('localcrm --version', { stdio: 'ignore' });
+    already('localcrm (Python)');
+  } catch {
+    run('pip install localcrm', '安装 localcrm (Python)');
+  }
 
-  // ── 2. 安装 NPM 全局包 ──
+  // ── 2. NPM 子包 ──
   const npmPkgs = [
-    'aicall-cli',
-    'skill-credit',
-    'skill-lead-fetcher',
-    'skill-qcc-enterprise-search',
-    'skill-shuidi',
-    'skill-ai-outbound-calling',
-    'skill-localcrm-operator',
+    '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 读取学习
+    try {
+      execSync(`npm list -g "${pkg}" --depth=0`, { stdio: 'ignore' });
+      already(`${pkg} (npm)`);
+    } catch {
+      run(`npm i -g "${pkg}"`, `安装 ${pkg}`);
+    }
   }
 
-  // ── 3. 智能部署技能文件 ──
+  // ── 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
+    join(HOME, '.qclaw', 'skills'),
+    join(HOME, '.codex', 'skills'),
+    join(HOME, '.cursor', 'skills'),
+    join(HOME, '.windsurf', 'skills'),
+    join(HOME, '.github', 'copilot', 'skills'),
   ];
 
   const skillPackages = {
@@ -73,7 +76,7 @@ function main() {
     for (const base of targetDirs) {
       console.log(`  → ${base}`);
       for (const [folder, src] of Object.entries(skillPackages)) {
-        if (!existsSync(src)) continue;
+        if (!existsSync(src)) { console.log(`  ⚠ ${folder} 的 SKILL.md 未找到`); continue; }
         const dstDir = join(base, folder);
         if (!existsSync(dstDir)) mkdirSync(dstDir, { recursive: true });
         copyFileSync(src, join(dstDir, 'SKILL.md'));
@@ -82,52 +85,36 @@ function main() {
     }
   } else {
     console.log('\n[setup] >>> 未检测到已知 Agent 技能目录');
-    console.log('          技能信息将通过以下输出供 AI 学习（等效）');
+    console.log('          技能信息将通过输出供 AI 学习（等效）');
   }
 
-  // ── 4. 初始化数据库（自动，无需参数）──
-  console.log('\n[setup] >>> 初始化 CRM 数据库');
+  // ── 4. 初始化数据库 ──
   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'));
+    execSync('localcrm customer list --limit 1', { stdio: 'ignore' });
+    already('CRM 数据库');
+  } catch {
+    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）');
     }
   }
 
-  // ── 6. 完成 ──
+  // ── 5. 输出技能文档 ──
+  console.log('\n── 全栈技能文档 ──\n');
+  const selfMd = join(__dirname, '..', 'resources', 'SKILL.md');
+  if (existsSync(selfMd)) console.log(readFileSync(selfMd, 'utf-8'));
+
+  // ── 完成 ──
   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('╔════════════════════════════════════════════╗');
+  console.log('║  ✅ localCRM 全栈工具链安装完成！        ║');
+  console.log('║                                            ║');
+  console.log('║  📌 如果外呼凭证未配置，请手动执行：      ║');
+  console.log('║     aicall init <token> <umId> <name>     ║');
+  console.log('╚════════════════════════════════════════════╝');
   console.log('');
 }