@windaka-erp/erp-cli 0.3.2 → 0.4.1

package/README.md

@@ -1,93 +1,119 @@
 # @windaka-erp/erp-cli
 
-物达通（WindaKa）物业管理 ERP 系统命令行工具，为人类和 AI Agent 设计。
+> 物达通（WindaKa）物业管理 ERP 的命令行工具，为人类和 AI Agent 设计。
+> 一句话：**用户说自然语言，AI Agent 通过本工具操作 ERP + 检索知识库**。
 
-## 安装
+## 它能做什么
 
-以下两种方式**任选其一**：
+- **知识库问答**：对接 RAGFlow，问"消防巡检怎么处理""报修流程""物业费标准"等问题，先检索知识库拿到原文，再结合上下文回答。
+- **ERP 操作**：查/建工单、分派、接单、确认、回访等工单全流程；查看项目、通讯录、费用（逐步完善中）。
+- **AI Agent 友好**：统一 JSON 输出、`--dry-run` 预览、危险操作确认、意图路由文档，AI 装上 Skill 即用。
 
-**方式一 — 从 npm 安装（推荐）：**
+## 安装
 
 ```bash
-# 安装 CLI
 npm install -g @windaka-erp/erp-cli
-
-# 安装 Skills（必需，让 AI Agent 知道如何使用 CLI）
-npx skills add windaka-erp/erp-cli -y -g
 ```
 
-**方式二 — 从源码安装：**
+> 二进制已打包进 npm 包（含 Windows/macOS/Linux 的 x64/arm64 六个平台），安装即用，无需联网下载。
+
+国内用户用淘宝镜像加速：
 
 ```bash
-git clone https://github.com/windaka-erp/erp-cli.git
-cd erp-cli
-go build -o erp-cli .
+npm install -g @windaka-erp/erp-cli --registry=https://registry.npmmirror.com
+```
 
-# 安装 Skills（必需）
-npx skills add windaka-erp/erp-cli -y -g
+验证：
+
+```bash
+erp-cli --version
 ```
 
 ## 快速开始
 
-### 人类用户
+### 1. 配置 ERP 地址
+
+```bash
+erp-cli config init
+# 默认连生产环境，也可指定：
+erp-cli config init --base-url https://your-erp-server.com/prod-api
+```
+
+### 2. 登录（Device Flow，扫码/账号授权）
 
 ```bash
-# 1. 初始化配置
-erp-cli --as me config init
+erp-cli auth login
+# 输出登录链接 → 浏览器打开授权 → 自动保存 token
+```
 
-# 2. 登录
-erp-cli --as me auth login
+### 3. 开始用
 
-# 3. 开始使用
-erp-cli --as me workorder +list
+```bash
+erp-cli workorder +list            # 我的待办工单
+erp-cli workorder +info --id 123 --dept-id 456   # 工单详情
+erp-cli knowledge +search --question "报修流程"  # 检索知识库
 ```
 
-### AI Agent
+## 配置知识库（RAGFlow）
 
-> 以下步骤面向 AI Agent。详细步骤见 [INSTALL.md](./INSTALL.md)。
+知识库检索走独立的 RAGFlow 服务，首次用要配地址、API Key、知识库 ID：
 
 ```bash
-# 安装 CLI
-npm install -g @windaka-erp/erp-cli
+erp-cli config ragflow
+# 交互式引导：输入 RAGFlow 地址、API Key，自动列出知识库让你选
+```
 
-# 安装 Skills（必需）
-npx skills add windaka-erp/erp-cli -y -g
+验证：
 
-# 验证
-erp-cli --help
+```bash
+erp-cli knowledge +check           # 检查 RAGFlow 连通性
+erp-cli knowledge +list-datasets   # 列出知识库
 ```
 
-安装完成即可使用。知识库检索无需登录；需要登录的操作（如工单查询）会在调用时自动引导。
+> 知识库检索不需要 ERP 登录，走 RAGFlow 自己的 API Key。
 
-## 命令
+## 命令一览
 
 ```
-erp-cli --as <id> config init/show/set/remove      # 配置管理
-erp-cli --as <id> auth login/login-start/login-wait # 登录
-erp-cli --as <id> auth status/logout/list           # 认证状态
-erp-cli --as <id> api GET/POST <path>               # 原始 API 调用
-erp-cli --as <id> knowledge +search/+list-datasets  # 知识库检索
-erp-cli --as <id> workorder +list/+create           # 工单操作
+config init/show/set/remove        # 配置管理（ERP 地址、RAGFlow）
+config ragflow                     # 交互式配置 RAGFlow 知识库
+auth login/login-start/login-wait  # 登录（两步登录适合 AI Agent）
+auth status/logout                 # 登录状态
+knowledge +search                  # 检索知识库（核心高频）
+knowledge +list-datasets           # 列出知识库
+knowledge +check                   # 检查 RAGFlow 连通性
+workorder +list                    # 我的待办工单
+workorder +handle-list             # 我经办的工单（含历史）
+workorder +info                    # 工单详情（含处理记录）
+workorder +search-user             # 搜索员工（分派/转单用）
+workorder +apportion               # 分派工单
+api GET/POST <path>                # 原始 API 调用（兜底）
 ```
 
-## 参数
+所有命令加 `--help` 看详细参数，加 `--dry-run` 预览请求不实际执行。
 
-- `--as <id>` — 用户标识（必填），企业微信用 Sender ID，本地用任意稳定标识（如 `me`）
+## 全局参数
+
+- `--profile <name>` — 切换环境（prod/staging），默认 default
 - `--dry-run` — 预览请求内容，不实际执行
+- `--format json|table|csv` — 输出格式，默认 json
+
+> 单用户模式：一个环境（profile）一个登录 token，命令不带任何身份参数。
 
-## Agent Skills
+## AI Agent 使用
 
-| Skill | 说明 |
-|-------|------|
-| `erp-cli` | ERP 系统总入口：知识库检索、工单管理、认证配置、意图路由 |
+本工具为 AI Agent 设计。配合 **Skills**（AI 使用文档，含意图路由、命令参数、行为规则）使用，AI 即可：
+- 听懂用户口语（"我的待办""消防巡检怎么处理"）→ 自动选对命令
+- 写操作前确认、危险操作 dry-run
+- 知识库优先：非 ERP 操作的问题默认先检索知识库
 
-安装 Skills 后，AI Agent 会自动读取 [skills/SKILL.md](./skills/SKILL.md) 获取完整的使用指南。
+Skills 由作者单独发布，安装方式见对应平台说明。
 
-## 要求
+## 环境要求
 
 - Node.js >= 14.0.0
-- 支持 Windows (x64/arm64)、macOS (x64/arm64)、Linux (x64/arm64)
+- 平台：Windows / macOS / Linux（均支持 x64 和 arm64）
 
 ## License
 
-MIT
+MIT

package/package.json

@@ -1,13 +1,10 @@
 {
   "name": "@windaka-erp/erp-cli",
-  "version": "0.3.2",
-  "description": "ERP CLI - command-line tool for Windaka ERP system",
+  "version": "0.4.1",
+  "description": "物达通(WindaKa)物业管理 ERP 命令行工具，为人类和 AI Agent 设计",
   "bin": {
     "erp-cli": "scripts/run.js"
   },
-  "scripts": {
-    "postinstall": "node scripts/install.js"
-  },
   "files": [
     "scripts/",
     "bin/",
@@ -36,8 +33,5 @@
   "cpu": [
     "x64",
     "arm64"
-  ],
-  "dependencies": {
-    "@windaka-erp/erp-cli": "^0.2.0"
-  }
+  ]
 }

package/scripts/run.js

@@ -1,218 +1,53 @@
 #!/usr/bin/env node
-const { execFileSync, execSync } = require("child_process");
+// run.js — erp-cli 启动器。二进制已打包进 npm 包的 bin/ 目录，
+// 按当前平台选择对应二进制执行。无需联网下载，不依赖 GitHub。
+const { execFileSync } = require("child_process");
 const path = require("path");
 const fs = require("fs");
-const https = require("https");
-const http = require("http");
 
-const BINARY_NAME = "erp-cli";
-const VERSION = require("../package.json").version;
-const GITHUB_REPO = "windaka-erp/erp-cli";
-const GITEE_REPO = "xing-wenkai/erp-cli";
+// Node 平台/架构 → 二进制文件名片段
+const OS_MAP = { win32: "windows", darwin: "darwin", linux: "linux" };
+const ARCH_MAP = { x64: "amd64", arm64: "arm64" };
 
-function getBinaryPath() {
-  const binDir = path.join(__dirname, "..", "bin");
-
-  const candidates = [
-    path.join(binDir, `${BINARY_NAME}.exe`), // bin/erp-cli.exe (Windows)
-    path.join(binDir, BINARY_NAME), // bin/erp-cli (macOS/Linux)
-    path.join(__dirname, "..", `${BINARY_NAME}.exe`), // 根目录编译产物 (Windows)
-    path.join(__dirname, "..", BINARY_NAME), // 根目录编译产物 (macOS/Linux)
-  ];
-
-  for (const p of candidates) {
-    if (fs.existsSync(p)) return p;
-  }
-
-  console.error(`Error: ${BINARY_NAME} binary not found.`);
-  console.error(`Please run: npm install`);
-  process.exit(1);
-}
-
-// ── 静默自动更新 ──
-
-function getPlatformInfo() {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  const map = {
-    win32_x64: { target: "windows-amd64", ext: ".exe" },
-    win32_arm64: { target: "windows-arm64", ext: ".exe" },
-    darwin_x64: { target: "darwin-amd64", ext: "" },
-    darwin_arm64: { target: "darwin-arm64", ext: "" },
-    linux_x64: { target: "linux-amd64", ext: "" },
-    linux_arm64: { target: "linux-arm64", ext: "" },
-  };
-
-  return map[`${platform}_${arch}`] || null;
-}
-
-function getInstalledVersion(binaryPath) {
-  try {
-    const output = execSync(`"${binaryPath}" --version`, {
-      encoding: "utf8",
-      timeout: 5000,
-    });
-    const match = output.match(/version\s+v?(\S+)/i);
-    return match ? match[1].replace(/^v/, "") : null;
-  } catch {
-    return null;
+function getBinaryName() {
+  const os = OS_MAP[process.platform];
+  const arch = ARCH_MAP[process.arch];
+  if (!os || !arch) {
+    console.error(
+      `Error: unsupported platform ${process.platform}-${process.arch}.`
+    );
+    console.error(
+      `Supported: win32-x64, win32-arm64, darwin-x64, darwin-arm64, linux-x64, linux-arm64.`
+    );
+    process.exit(1);
   }
+  const ext = process.platform === "win32" ? ".exe" : "";
+  return `erp-cli-${os}-${arch}${ext}`;
 }
 
-function fetchJSON(url) {
-  return new Promise((resolve, reject) => {
-    const client = url.startsWith("https") ? https : http;
-    client
-      .get(url, { timeout: 5000 }, (res) => {
-        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-          fetchJSON(res.headers.location).then(resolve, reject);
-          return;
-        }
-        if (res.statusCode !== 200) {
-          reject(new Error(`HTTP ${res.statusCode}`));
-          return;
-        }
-        let data = "";
-        res.on("data", (chunk) => (data += chunk));
-        res.on("end", () => {
-          try {
-            resolve(JSON.parse(data));
-          } catch (e) {
-            reject(e);
-          }
-        });
-      })
-      .on("error", reject)
-      .on("timeout", function () {
-        this.destroy();
-        reject(new Error("timeout"));
-      });
-  });
-}
-
-function downloadFile(url, dest) {
-  return new Promise((resolve, reject) => {
-    const client = url.startsWith("https") ? https : http;
-    client
-      .get(url, (res) => {
-        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
-          downloadFile(res.headers.location, dest).then(resolve, reject);
-          return;
-        }
-        if (res.statusCode !== 200) {
-          reject(new Error(`HTTP ${res.statusCode}`));
-          return;
-        }
-        const stream = fs.createWriteStream(dest);
-        res.pipe(stream);
-        stream.on("finish", () => {
-          stream.close();
-          if (process.platform !== "win32") {
-            fs.chmodSync(dest, 0o755);
-          }
-          resolve();
-        });
-        stream.on("error", reject);
-      })
-      .on("error", reject);
-  });
-}
-
-async function silentAutoUpdate() {
-  try {
-    const binary = getBinaryPath();
-    const installedVer = getInstalledVersion(binary);
-
-    // 如果已安装版本和 package.json 一致，跳过
-    if (installedVer === VERSION.replace(/^v/, "")) return;
-
-    // 已安装版本比 package.json 新？跳过
-    if (installedVer && installedVer > VERSION.replace(/^v/, "")) return;
+function main() {
+  const binary = path.join(__dirname, "..", "bin", getBinaryName());
 
-    // 检查上次更新时间，每天最多检查一次
-    const updateMarker = path.join(
-      require("os").homedir(),
-      ".erp-cli",
-      ".last-update-check"
+  if (!fs.existsSync(binary)) {
+    console.error(`Error: binary not found at ${binary}.`);
+    console.error(
+      `Try reinstalling: npm install -g @windaka-erp/erp-cli`
     );
-    try {
-      const lastCheck = parseInt(fs.readFileSync(updateMarker, "utf8"), 10);
-      const ONE_DAY = 24 * 60 * 60 * 1000;
-      if (Date.now() - lastCheck < ONE_DAY) return;
-    } catch {
-      // 文件不存在或读取失败，继续检查
-    }
-    if (installedVer && installedVer > VERSION.replace(/^v/, "")) return;
-
-    // 需要更新：查询 Release 获取最新版本号（GitHub 优先，Gitee 回退）
-    let release;
-    try {
-      release = await fetchJSON(
-        `https://api.github.com/repos/${GITHUB_REPO}/releases/latest`
-      );
-    } catch {
-      // GitHub 不通，回退 Gitee API
-      release = await fetchJSON(
-        `https://gitee.com/api/v5/repos/${GITEE_REPO}/releases/latest`
-      );
-    }
-
-    const latestTag = release.tag_name; // e.g. "v0.3.0"
-    const latestVer = latestTag.replace(/^v/, "");
-
-    // 最新版和 package.json 版本不一致？等 npm update 后再说
-    if (latestVer !== VERSION.replace(/^v/, "")) return;
-
-    // 下载新版本
-    const info = getPlatformInfo();
-    if (!info) return;
-
-    const filename = `${BINARY_NAME}-${info.target}${info.ext}`;
-    const asset = release.assets.find((a) => a.name === filename);
-    if (!asset) return;
-
-    const binDir = path.join(__dirname, "..", "bin");
-    const binaryPath = path.join(binDir, `${BINARY_NAME}${info.ext}`);
-
-    // 下载到临时文件，完成后原子替换
-    const tmpPath = binaryPath + ".tmp";
-    await downloadFile(asset.browser_download_url, tmpPath);
-
-    // 替换旧二进制
-    fs.renameSync(tmpPath, binaryPath);
+    process.exit(1);
+  }
 
-    // 写入本次检查时间
+  // 非 Windows 确保可执行权限（npm 打包可能丢失）
+  if (process.platform !== "win32") {
     try {
-      const markerDir = path.join(require("os").homedir(), ".erp-cli");
-      if (!fs.existsSync(markerDir)) fs.mkdirSync(markerDir, { recursive: true });
-      fs.writeFileSync(markerDir + "/.last-update-check", String(Date.now()));
+      fs.chmodSync(binary, 0o755);
     } catch {
-      // 写入失败不影响
+      // 忽略权限错误
     }
-  } catch {
-    // 静默失败，不影响正常使用
-    // 即使失败也写入检查时间，避免频繁重试
-    try {
-      const markerDir = path.join(require("os").homedir(), ".erp-cli");
-      if (!fs.existsSync(markerDir)) fs.mkdirSync(markerDir, { recursive: true });
-      fs.writeFileSync(markerDir + "/.last-update-check", String(Date.now()));
-    } catch {}
   }
-}
 
-function main() {
-  // 后台静默更新，不阻塞主流程
-  silentAutoUpdate().catch(() => {});
-
-  const binary = getBinaryPath();
   const args = process.argv.slice(2);
-
   try {
-    execFileSync(binary, args, {
-      stdio: "inherit",
-      env: { ...process.env },
-    });
+    execFileSync(binary, args, { stdio: "inherit" });
   } catch (err) {
     process.exitCode = err.status || 1;
   }

package/scripts/install.js

@@ -1,146 +0,0 @@
-const { execSync } = require("child_process");
-const path = require("path");
-const fs = require("fs");
-
-// ── 配置 ──
-const BINARY_NAME = "erp-cli";
-const VERSION = require("../package.json").version;
-const GITHUB_REPO = "windaka-erp/erp-cli";
-const GITEE_REPO = "xing-wenkai/erp-cli";
-
-// ── 平台映射 ──
-function getPlatformInfo() {
-  const platform = process.platform;
-  const arch = process.arch;
-
-  const map = {
-    win32_x64: { target: "windows-amd64", ext: ".exe" },
-    win32_arm64: { target: "windows-arm64", ext: ".exe" },
-    darwin_x64: { target: "darwin-amd64", ext: "" },
-    darwin_arm64: { target: "darwin-arm64", ext: "" },
-    linux_x64: { target: "linux-amd64", ext: "" },
-    linux_arm64: { target: "linux-arm64", ext: "" },
-  };
-
-  const key = `${platform}_${arch}`;
-  const info = map[key];
-  if (!info) {
-    console.error(`Unsupported platform: ${platform}-${arch}`);
-    process.exit(1);
-  }
-  return info;
-}
-
-// ── 下载地址（GitHub 优先，Gitee 回退）──
-function getDownloadURLs(info) {
-  const filename = `${BINARY_NAME}-${info.target}${info.ext}`;
-  return [
-    `https://github.com/${GITHUB_REPO}/releases/download/v${VERSION}/${filename}`,
-    `https://gitee.com/${GITEE_REPO}/releases/download/v${VERSION}/${filename}`,
-  ];
-}
-
-// ── 获取已安装二进制的版本号 ──
-function getInstalledVersion(binaryPath) {
-  try {
-    const output = execSync(`"${binaryPath}" --version`, {
-      encoding: "utf8",
-      timeout: 5000,
-    });
-    // 输出格式: "erp-cli version v0.2.0" 或 "erp-cli version 0.2.0"
-    const match = output.match(/version\s+v?(\S+)/i);
-    return match ? match[1] : null;
-  } catch {
-    return null;
-  }
-}
-
-// ── 比较版本号 ──
-function isVersionOutdated(installed, expected) {
-  if (!installed) return true;
-  // 去掉 v 前缀统一比较
-  const a = installed.replace(/^v/, "");
-  const b = expected.replace(/^v/, "");
-  return a !== b;
-}
-
-// ── 下载二进制 ──
-function downloadBinary(url, binaryPath) {
-  if (process.platform === "win32") {
-    execSync(
-      `powershell -Command "Invoke-WebRequest -Uri '${url}' -OutFile '${binaryPath}'"`,
-      { stdio: "inherit" }
-    );
-  } else {
-    execSync(`curl -L -o "${binaryPath}" "${url}"`, {
-      stdio: "inherit",
-    });
-  }
-
-  // 设置可执行权限（非 Windows）
-  if (process.platform !== "win32") {
-    fs.chmodSync(binaryPath, 0o755);
-  }
-}
-
-// ── 主流程 ──
-function install() {
-  const pkgDir = path.join(__dirname, "..");
-  const binDir = path.join(pkgDir, "bin");
-  if (!fs.existsSync(binDir)) {
-    fs.mkdirSync(binDir, { recursive: true });
-  }
-
-  const info = getPlatformInfo();
-  const binaryPath = path.join(binDir, `${BINARY_NAME}${info.ext}`);
-
-  // 1. 检查 bin/ 目录是否已有对应平台的二进制
-  if (fs.existsSync(binaryPath)) {
-    const installedVer = getInstalledVersion(binaryPath);
-    if (!isVersionOutdated(installedVer, VERSION)) {
-      console.log(`Found bundled binary: ${binaryPath} (v${installedVer})`);
-      return;
-    }
-    // 版本不一致，需要更新
-    console.log(
-      `Binary version mismatch: installed v${installedVer}, expected v${VERSION}. Updating...`
-    );
-  }
-
-  // 2. 检查项目根目录是否有本地编译产物（开发模式）
-  const localBinary = path.join(pkgDir, `${BINARY_NAME}${info.ext}`);
-  if (fs.existsSync(localBinary)) {
-    console.log(`Found local binary, copying...`);
-    fs.copyFileSync(localBinary, binaryPath);
-    console.log(`Installed from local build: ${binaryPath}`);
-    return;
-  }
-
-  // 3. 从 GitHub Releases 下载，失败回退 Gitee
-  const urls = getDownloadURLs(info);
-  console.log(`Downloading ${BINARY_NAME} v${VERSION} for ${info.target}...`);
-
-  let downloaded = false;
-  for (const url of urls) {
-    console.log(`  Trying: ${url}`);
-    try {
-      downloadBinary(url, binaryPath);
-      downloaded = true;
-      console.log(`Successfully installed ${BINARY_NAME} v${VERSION}`);
-      break;
-    } catch (err) {
-      console.warn(`  Failed: ${err.message}`);
-    }
-  }
-
-  if (!downloaded) {
-    console.error(`All download sources failed.`);
-    console.error(`You can build from source:`);
-    console.error(`  git clone https://github.com/${GITHUB_REPO}.git`);
-    console.error(`  cd erp-cli && go build -o ${BINARY_NAME} .`);
-    console.error(`  Then copy the binary to: ${binaryPath}`);
-    process.exit(1);
-  }
-}
-
-install();