@chaobinchen/mes-cli 1.0.0

package/README.md

@@ -0,0 +1,225 @@
+# mes-cli
+
+MES 数据库查询 CLI — 连接 SQL Server，快速查询 MES 业务数据。
+
+## 安装
+
+```bash
+npm install -g @chaobinchen/mes-cli
+# 或本地开发
+git clone ...
+cd mes-cli
+npm install
+node bin/mes.js --help
+```
+
+## 快速开始
+
+### 1. 初始化连接配置
+
+```bash
+mes init           # 当前目录（项目级）
+mes init --global  # HOME 目录（全局）
+```
+
+向导会创建 `.mes.json`，并自动将其加入 `.gitignore`。
+
+```json
+{
+  "server": "172.29.x.x",
+  "port": 1433,
+  "user": "sa",
+  "password": "YOUR_PASSWORD",
+  "database": "mes_master"
+}
+```
+
+### 2. 也可用环境变量连接
+
+```bash
+MES_DB_SERVER=172.29.x.x MES_DB_USER=sa MES_DB_PASSWORD=xxx mes progress MO6303A035
+```
+
+Windows PowerShell：
+```powershell
+$env:MES_DB_SERVER='172.29.x.x'; $env:MES_DB_USER='sa'; $env:MES_DB_PASSWORD='xxx'
+mes progress MO6303A035
+```
+
+优先级：CLI 参数 > 环境变量 > `.mes.json`
+
+---
+
+## 全局连接参数
+
+所有命令均支持以下参数（可覆盖配置文件 / 环境变量）：
+
+```
+-S, --server    <server>    数据库服务器地址
+-P, --port      <port>      端口（默认 1433）
+-u, --user      <user>      用户名
+-p, --password  <password>  密码
+-d, --database  <database>  数据库名
+```
+
+---
+
+## 命令列表
+
+### 工单类
+
+| 命令 | 别名 | 说明 |
+|------|------|------|
+| `mes progress <orderNum>` | `pg` | 工单进度（称量 + 生产状态） |
+| `mes risk-orders` | `ro` | 延期风险工单清单 |
+| `mes order-info <orderNum>` | `oi` | 工单基础信息 |
+| `mes active-orders` | `ao` | 生产中工单清单（需指定日期） |
+| `mes pending-discharge` | `pdc` | 待出锅工单清单 |
+| `mes daily-plan` | `dp` | 某天计划生产工单（需指定日期） |
+| `mes qc-result <orderNum>` | `qcr` | 工单质检结果 |
+| `mes exec-overview <orderNum>` | `eo` | 半成品生产执行概览 |
+
+### 称量类
+
+| 命令 | 别名 | 说明 |
+|------|------|------|
+| `mes weighing-overview <orderNum>` | `wov` | 称量工单执行概览 |
+| `mes weighing-tasks <orderNum>` | `wt` | 称量任务清单 |
+| `mes pending-weighing <orderNum>` | `pw` | 未完成称量项 |
+| `mes weighing-detail <orderNum>` | `wdt` | 称量执行明细 |
+| `mes operator-records <operator>` | `orec` | 操作员称量记录 |
+| `mes review-status <orderNum>` | `rvs` | 称量复核状态 |
+| `mes accounting-status <orderNum>` | `acs` | 称量账务状态 |
+| `mes weighing-exceptions <orderNum>` | `wex` | 称量异常 / 作废记录 |
+| `mes weighing-duration <orderNum>` | `wdur` | 称量耗时分析 |
+
+### 物料类
+
+| 命令 | 别名 | 说明 |
+|------|------|------|
+| `mes stock-records <materialCode>` | `sr` | 物料出入库记录 |
+| `mes stock-inventory <materialCode>` | `si` | 物料库存查询 |
+| `mes trace-forward` | `tf` | 半成品批次追溯原料 |
+| `mes trace-backward` | `tb` | 原料批次反向追踪半成品 |
+| `mes material-usage <materialCode>` | `mu` | 近期原料使用明细 |
+| `mes stock-coverage <materialCode>` | `sc` | 库存与用量对比（预计可用天数） |
+
+### 报告类
+
+| 命令 | 别名 | 说明 |
+|------|------|------|
+| `mes weighing-report <orderNum>` | `wr` | 称量批记录报告（表头 + 明细） |
+| `mes bulk-report <orderNum>` | `br` | 半成品生产报告（表头 + 明细） |
+
+---
+
+## 常用示例
+
+```bash
+# 工单进度
+mes progress MO6303A035
+mes pg MO6303A035
+
+# 延期风险工单（可选车间 / 日期过滤）
+mes risk-orders
+mes ro --workshop 车间A
+mes ro -d 2026-04-10
+
+# 生产中工单（必填日期）
+mes active-orders --date 2026-04-14
+mes ao -d 2026-04-14 --workshop 车间A
+
+# 今日计划工单
+mes daily-plan --date 2026-04-14
+mes dp -d 2026-04-14
+
+# 称量任务 / 未完成项
+mes weighing-tasks MO6303A035
+mes pending-weighing MO6303A035
+
+# 称量明细（可追加物料编码过滤）
+mes weighing-detail MO6303A035 --material C160
+mes wdt MO6303A035 -m C160
+
+# 操作员记录（必填起止日期）
+mes operator-records 陈金波 --start 2026-04-01 --end 2026-04-14
+
+# 物料追溯
+mes trace-forward --code 215B654 --batch 2026033101
+mes trace-backward --code C160 --batch P122632
+
+# 库存与用量（默认 180 天）
+mes stock-coverage C160
+mes sc C160 --days 30
+
+# 生产报告
+mes weighing-report MO6318A001
+mes bulk-report MO6205A045
+```
+
+---
+
+## 参数说明（常用选项）
+
+| 命令 | 必填选项 | 可选选项 |
+|------|---------|---------|
+| `risk-orders` | — | `-w/--workshop`, `-d/--date` |
+| `active-orders` | `-d/--date <YYYY-MM-DD>` | `-w/--workshop` |
+| `daily-plan` | `-d/--date <YYYY-MM-DD>` | — |
+| `weighing-detail` | `<orderNum>` | `-m/--material <code>` |
+| `operator-records` | `<operator>`, `--start`, `--end` | — |
+| `trace-forward` | `--code <半成品编码>`, `-b/--batch <批次>` | — |
+| `trace-backward` | `--code <原料编码>`, `-b/--batch <批次>` | — |
+| `stock-records` | `<materialCode>` | `-b/--batch` |
+| `stock-inventory` | `<materialCode>` | `-b/--batch` |
+| `material-usage` | `<materialCode>` | `-n/--days`（默认 180）, `-b/--batch` |
+| `stock-coverage` | `<materialCode>` | `-n/--days`（默认 180）, `-b/--batch` |
+
+---
+
+## 项目结构
+
+```
+mes-cli/
+├── bin/
+│   └── mes.js                    # CLI 入口，注册所有命令
+├── src/
+│   ├── config.js                 # 连接配置解析
+│   ├── db.js                     # mssql 查询封装
+│   ├── display.js                # cli-table3 表格输出
+│   ├── encoding.js               # Windows 编码处理
+│   └── commands/
+│       ├── init.js               # init 命令
+│       ├── progress.js           # progress 命令
+│       ├── work-order.js         # 工单类（8 个命令）
+│       ├── weighing.js           # 称量类（9 个命令）
+│       ├── material.js           # 物料类（6 个命令）
+│       └── reports.js            # 报告类（2 个命令）
+├── skills/
+│   └── mes-cli/
+│       ├── SKILL.md              # Codex 技能说明
+│       ├── agents/
+│       │   └── openai.yaml       # OpenAI agent 配置
+│       └── scripts/
+│           └── mes-query.ps1     # PowerShell 查询封装脚本
+├── package.json
+└── README.md
+```
+
+---
+
+## 依赖
+
+- Node.js >= 14
+- [commander](https://www.npmjs.com/package/commander) ^12.1.0
+- [mssql](https://www.npmjs.com/package/mssql) ^11.0.1
+- [cli-table3](https://www.npmjs.com/package/cli-table3)
+- [chalk](https://www.npmjs.com/package/chalk)
+- [iconv-lite](https://www.npmjs.com/package/iconv-lite)
+- [inquirer](https://www.npmjs.com/package/inquirer)
+
+---
+
+## License
+
+ISC

package/bin/mes.js

@@ -0,0 +1,263 @@
+#!/usr/bin/env node
+'use strict';
+
+// ─── Windows 终端 UTF-8 强制设置 ──────────────────────────────────────────────
+if (process.platform === 'win32') {
+  try {
+    require('child_process').execSync('chcp 65001', { stdio: 'ignore' });
+  } catch (_) {}
+  if (process.stdout.isTTY) process.stdout.setDefaultEncoding('utf8');
+  if (process.stderr.isTTY) process.stderr.setDefaultEncoding('utf8');
+}
+
+const { Command } = require('commander');
+const { progressCommand } = require('../src/commands/progress');
+const { initCommand }     = require('../src/commands/init');
+const {
+  riskOrdersCommand,
+  orderInfoCommand,
+  activeOrdersCommand,
+  pendingDischargeCommand,
+  dailyPlanCommand,
+  qcResultCommand,
+  execOverviewCommand,
+} = require('../src/commands/work-order');
+const {
+  weighingOverviewCommand,
+  weighingTasksCommand,
+  pendingWeighingCommand,
+  weighingDetailCommand,
+  operatorRecordsCommand,
+  reviewStatusCommand,
+  accountingStatusCommand,
+  weighingExceptionsCommand,
+  weighingDurationCommand,
+} = require('../src/commands/weighing');
+const {
+  stockRecordsCommand,
+  stockInventoryCommand,
+  traceForwardCommand,
+  traceBackwardCommand,
+  materialUsageCommand,
+  stockCoverageCommand,
+} = require('../src/commands/material');
+const { weighingReportCommand, bulkReportCommand } = require('../src/commands/reports');
+const { findConfigFilePath } = require('../src/config');
+const chalk = require('chalk');
+const { version } = require('../package.json');
+
+const program = new Command();
+
+program
+  .name('mes')
+  .description(
+    chalk.bold('MES 数据库查询 CLI') +
+      '\n连接 SQL Server，快速查看 MES 业务数据\n\n' +
+      chalk.dim('连接参数优先级：CLI 选项 > 环境变量 > 配置文件 (.mes.json)')
+  )
+  .version(version, '-v, --version', '显示版本号')
+  // ─── 全局数据库连接选项 ────────────────────────────────────────────────────
+  .option('--server <host>',    '数据库服务器地址        [env: MES_DB_SERVER]')
+  .option('--port <port>',      '数据库端口（默认 1433） [env: MES_DB_PORT]')
+  .option('--user <user>',      '数据库用户名            [env: MES_DB_USER]')
+  .option('--password <pass>',  '数据库密码              [env: MES_DB_PASSWORD]')
+  .option('--database <db>',    '数据库名称              [env: MES_DB_DATABASE]');
+
+// ─── 命令 1：工单进度 ─────────────────────────────────────────────────────────
+program
+  .command('progress <orderNum>')
+  .alias('pg')
+  .description('查询半成品工单的总体进度（称量状态 + 生产状态）')
+  .action(progressCommand);
+
+// ─── 命令 N：初始化配置 ───────────────────────────────────────────────────────
+program
+  .command('init')
+  .description('交互式创建 .mes.json 数据库连接配置文件')
+  .option('-g, --global', '写入 HOME 目录（对所有项目生效），默认写入当前目录')
+  .action(initCommand);
+
+// ─── 工单类命令 ───────────────────────────────────────────────────────────────
+program
+  .command('risk-orders')
+  .alias('ro')
+  .description('延期风险工单清单')
+  .option('-w, --workshop <name>', '过滤车间名称')
+  .option('-d, --date <YYYY-MM-DD>', '截止检查日期（默认今天）')
+  .action(riskOrdersCommand);
+
+program
+  .command('order-info <orderNum>')
+  .alias('oi')
+  .description('工单基础信息查询')
+  .action(orderInfoCommand);
+
+program
+  .command('active-orders')
+  .alias('ao')
+  .description('生产中工单清单')
+  .requiredOption('-d, --date <YYYY-MM-DD>', '计划日期')
+  .option('-w, --workshop <name>', '过滤车间名称')
+  .action(activeOrdersCommand);
+
+program
+  .command('pending-discharge')
+  .alias('pdc')
+  .description('待出锅工单清单（投料完成状态）')
+  .option('-w, --workshop <name>', '过滤车间名称')
+  .action(pendingDischargeCommand);
+
+program
+  .command('daily-plan')
+  .alias('dp')
+  .description('某天计划生产工单清单')
+  .requiredOption('-d, --date <YYYY-MM-DD>', '计划日期')
+  .action(dailyPlanCommand);
+
+program
+  .command('qc-result <orderNum>')
+  .alias('qcr')
+  .description('工单质检结果查询')
+  .action(qcResultCommand);
+
+program
+  .command('exec-overview <orderNum>')
+  .alias('eo')
+  .description('半成品生产执行概览（称量+生产+质检+扣账+报工）')
+  .action(execOverviewCommand);
+
+// ─── 称量类命令 ───────────────────────────────────────────────────────────────
+program
+  .command('weighing-overview <orderNum>')
+  .alias('wov')
+  .description('称量工单执行概览')
+  .action(weighingOverviewCommand);
+
+program
+  .command('weighing-tasks <orderNum>')
+  .alias('wt')
+  .description('称量任务清单')
+  .action(weighingTasksCommand);
+
+program
+  .command('pending-weighing <orderNum>')
+  .alias('pw')
+  .description('未完成称量项')
+  .action(pendingWeighingCommand);
+
+program
+  .command('weighing-detail <orderNum>')
+  .alias('wdt')
+  .description('称量执行明细')
+  .option('-m, --material <code>', '过滤物料编码')
+  .action(weighingDetailCommand);
+
+program
+  .command('operator-records <operator>')
+  .alias('orec')
+  .description('操作员称量记录')
+  .requiredOption('--start <YYYY-MM-DD>', '开始日期')
+  .requiredOption('--end <YYYY-MM-DD>', '结束日期')
+  .action(operatorRecordsCommand);
+
+program
+  .command('review-status <orderNum>')
+  .alias('rvs')
+  .description('称量复核状态')
+  .action(reviewStatusCommand);
+
+program
+  .command('accounting-status <orderNum>')
+  .alias('acs')
+  .description('称量账务状态')
+  .action(accountingStatusCommand);
+
+program
+  .command('weighing-exceptions <orderNum>')
+  .alias('wex')
+  .description('称量异常或作废记录')
+  .action(weighingExceptionsCommand);
+
+program
+  .command('weighing-duration <orderNum>')
+  .alias('wdur')
+  .description('称量耗时分析')
+  .action(weighingDurationCommand);
+
+// ─── 物料类命令 ───────────────────────────────────────────────────────────────
+program
+  .command('stock-records <materialCode>')
+  .alias('sr')
+  .description('物料批次出入库记录')
+  .option('-b, --batch <batch>', '过滤批次')
+  .action(stockRecordsCommand);
+
+program
+  .command('stock-inventory <materialCode>')
+  .alias('si')
+  .description('物料库存查询')
+  .option('-b, --batch <batch>', '过滤批次')
+  .action(stockInventoryCommand);
+
+program
+  .command('trace-forward')
+  .alias('tf')
+  .description('半成品编码+批次追溯原料')
+  .requiredOption('--code <code>', '半成品编码')
+  .requiredOption('-b, --batch <batch>', '半成品批次')
+  .action(traceForwardCommand);
+
+program
+  .command('trace-backward')
+  .alias('tb')
+  .description('原料编码+批次反向跟踪半成品')
+  .requiredOption('--code <code>', '原料编码')
+  .requiredOption('-b, --batch <batch>', '原料批次')
+  .action(traceBackwardCommand);
+
+program
+  .command('material-usage <materialCode>')
+  .alias('mu')
+  .description('近几天原料使用明细（默认 180 天）')
+  .option('-n, --days <days>', '查询天数', '180')
+  .option('-b, --batch <batch>', '过滤原料批次')
+  .action(materialUsageCommand);
+
+program
+  .command('stock-coverage <materialCode>')
+  .alias('sc')
+  .description('原料当前库存与近几天使用量对比（默认 180 天）')
+  .option('-n, --days <days>', '查询天数', '180')
+  .option('-b, --batch <batch>', '过滤原料批次')
+  .action(stockCoverageCommand);
+
+// ─── 报告类命令 ───────────────────────────────────────────────────────────────
+program
+  .command('weighing-report <orderNum>')
+  .alias('wr')
+  .description('称量报告（表头 + 明细）')
+  .action(weighingReportCommand);
+
+program
+  .command('bulk-report <orderNum>')
+  .alias('br')
+  .description('半成品报告（表头 + 明细）')
+  .action(bulkReportCommand);
+
+// ─── 无子命令时显示帮助 + 提示配置文件 ──────────────────────────────────────
+if (process.argv.length === 2) {
+  program.outputHelp();
+  const cfgPath = findConfigFilePath();
+  if (cfgPath) {
+    console.log(chalk.green(`\n✔  检测到配置文件: ${cfgPath}`));
+  } else {
+    console.log(chalk.dim('\n提示: 可在当前目录或 HOME 目录新建 .mes.json 保存连接信息'));
+    console.log(chalk.dim('      或运行 mes init 进行交互式初始化'));
+  }
+  process.exit(0);
+}
+
+program.parseAsync(process.argv).catch((err) => {
+  console.error(chalk.red('✖  CLI 内部错误:'), err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@chaobinchen/mes-cli",
+  "version": "1.0.0",
+  "description": "MES 数据库查询 CLI — 快速查询工单进度等业务数据",
+  "main": "src/index.js",
+  "bin": {
+    "mes": "bin/mes.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node bin/mes.js",
+    "test": "node bin/mes.js --help"
+  },
+  "keywords": [
+    "mes",
+    "mssql",
+    "cli",
+    "database",
+    "query"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5",
+    "commander": "^12.1.0",
+    "iconv-lite": "^0.7.2",
+    "mssql": "^11.0.1"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/commands/init.js

@@ -0,0 +1,77 @@
+/**
+ * 命令：init —— 交互式创建 .mes.json 数据库连接配置文件
+ */
+
+'use strict';
+
+const fs       = require('fs');
+const path     = require('path');
+const readline = require('readline');
+const chalk    = require('chalk');
+const { CONFIG_FILENAME } = require('../config');
+
+function ask(rl, prompt, def, secret = false) {
+  const hint = def !== undefined ? chalk.dim(` [${def}]`) : '';
+  return new Promise((resolve) => {
+    if (secret) {
+      process.stdout.write(prompt + hint + ': ');
+      rl.once('line', line => resolve(line.trim() || def || ''));
+    } else {
+      rl.question(prompt + hint + ': ', ans => resolve(ans.trim() || def || ''));
+    }
+  });
+}
+
+async function initCommand(options, command) {
+  const targetDir  = options.global ? require('os').homedir() : process.cwd();
+  const targetFile = path.join(targetDir, CONFIG_FILENAME);
+
+  console.log(chalk.bold('\n🛠️  MES DB CLI —— 数据库连接初始化向导'));
+  console.log(chalk.dim(`   配置将写入 ${targetFile}\n`));
+
+  let existing = {};
+  if (fs.existsSync(targetFile)) {
+    try {
+      existing = JSON.parse(fs.readFileSync(targetFile, 'utf8'));
+      console.log(chalk.yellow(`⚠️  发现已有配置文件，按回车保留原值：\n`));
+    } catch (_) {}
+  }
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+
+  try {
+    const server   = await ask(rl, '  服务器地址 (host)',     existing.server   || '');
+    const port     = await ask(rl, '  端口       (port)',     String(existing.port || 1433));
+    const database = await ask(rl, '  数据库名   (database)', existing.database || '');
+    const user     = await ask(rl, '  用户名     (user)',     existing.user     || 'sa');
+    const password = await ask(rl, '  密码       (password)', existing.password,  true);
+
+    const config = {
+      server,
+      port:     parseInt(port, 10) || 1433,
+      database,
+      user,
+      password,
+    };
+
+    rl.close();
+
+    fs.writeFileSync(targetFile, JSON.stringify(config, null, 2) + '\n', 'utf8');
+
+    console.log(chalk.green(`\n✅ 配置已写入 ${targetFile}`));
+    console.log(chalk.dim('\n   现在可以直接运行命令，无需每次传连接参数：'));
+    console.log(chalk.cyan('   mes progress MO6303A035'));
+    console.log(
+      chalk.yellow('\n   ⚠️  提示: ') +
+      chalk.dim(`${CONFIG_FILENAME} 包含数据库密码，请勿提交到 Git 仓库。\n`) +
+      chalk.dim('         建议将其加入 .gitignore：') +
+      chalk.cyan(` echo "${CONFIG_FILENAME}" >> .gitignore\n`)
+    );
+  } catch (err) {
+    rl.close();
+    console.error(chalk.red('❌ 初始化失败'), err.message);
+    process.exitCode = 1;
+  }
+}
+
+module.exports = { initCommand };