@blod-nm/1kuan-act-01-cli 0.1.2 → 0.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blod-nm/1kuan-act-01-cli",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "description": "Internal operations CLI: invoke preset database functions via a gateway. Zero dependencies, MCP (stdio) support.",
   "license": "MIT",

package/src/main.js

@@ -3,6 +3,7 @@
  */
 
 import { parseArgs } from 'node:util'
+import { VERSION } from './version.js'
 import { join } from 'node:path'
 import { configPath, expandPath, loadConfig, saveConfig, decodeConfigString, encryptConfig } from './store.js'
 import { ACCOUNT_SQL, execPgsql, resolveApikey, gatewayBase } from './tcb.js'
@@ -10,7 +11,6 @@ import { buildCreateSql, confirmSummary, normalizeCreateRedpacket } from './redp
 import { SKILL_MD, SKILL_NAME } from './skill.js'
 import { startMcp } from './mcp.js'
 
-const VERSION = '0.1.0'
 
 const USAGE = `act-01 —— operations CLI(invoke preset database functions)
 
@@ -22,7 +22,7 @@ const USAGE = `act-01 —— operations CLI(invoke preset database functions)
   config set apiKey              写入 API Key(值走 stdin;不放命令行)
   config test                    连接测试(SELECT 1,验证 envId/apiKey)
   config export                  导出加密配置串(口令交互输入或 ACT01_EXPORT_PASS)
-  config import <串|--stdin>      导入配置串(自动识别 加密/明文/网页格式)
+  config import <串|--stdin> [--pass <口令>]  导入配置串(加密串需口令;自动识别 三种格式)
   mcp                            启动 MCP 服务(stdio;接入 Claude 等 AI 客户端)
   skill                          输出 agent 技能文档(--install <dir> 写入)
   balance                        account balance
@@ -183,7 +183,13 @@ async function cmdConfig(argv) {
   }
 
   if (sub === 'import') {
-    let body = positionals[1]
+    const { values: importValues, positionals: importPositionals } = parseArgs({
+      strict: false,
+      allowPositionals: true,
+      args: argv,
+      options: { pass: { type: 'string' }, json: { type: 'boolean', short: 'j' } },
+    })
+    let body = importPositionals[1]
     if (!body && !process.stdin.isTTY) body = await readStdinText()
     if (!body) {
       const err = new Error('config import 需要 <配置串>(位置参数或 stdin)')
@@ -193,10 +199,10 @@ async function cmdConfig(argv) {
     const decoded = decodeConfigString(body)
     let cfg = decoded.config
     if (decoded.encrypted) {
-      let passphrase = process.env.ACT01_EXPORT_PASS
+      let passphrase = str(importValues, 'pass') ?? process.env.ACT01_EXPORT_PASS
       if (!passphrase) {
         if (!process.stdin.isTTY) {
-          const err = new Error('加密串需要口令:脚本里用 ACT01_EXPORT_PASS 传入')
+          const err = new Error('加密串需要口令:用 --pass <口令> 或 ACT01_EXPORT_PASS 传入')
           err.exitCode = 2
           throw err
         }

package/src/mcp.js

@@ -11,11 +11,12 @@
  * 纪律: MCP 模式下 stdout 只输出 JSON-RPC 报文,任何日志走 stderr。
  */
 
+import { VERSION } from './version.js'
 import { loadConfig } from './store.js'
 import { resolveApikey, execPgsql, gatewayBase } from './tcb.js'
 import { normalizeCreateRedpacket, buildCreateSql } from './redpacket.js'
 
-const SERVER_INFO = { name: 'act-01', version: '0.1.0' }
+const SERVER_INFO = { name: 'act-01', version: VERSION }
 const SUPPORTED = ['2025-11-25', '2025-06-18', '2025-03-26', '2024-11-05', '2024-10-07']
 const LATEST = '2025-11-25'
 

package/src/redpacket.js

@@ -23,14 +23,14 @@ function optionalText(value, label, maxLen) {
 export function normalizeCreateRedpacket(body) {
   const mode = String(body.mode ?? '')
   if (mode !== 'random' && mode !== 'equal')
-    throw new ValidationError('type must be random or equal')
+    throw new ValidationError('红包类型必须是 random 或 equal')
 
   const totalPoints = positiveInteger(body.total_points, '总金额')
   const count = positiveInteger(body.count, '份数')
   const perUserLimit = positiveInteger(body.per_user_limit, '每人领取次数')
-  if (perUserLimit > count) throw new ValidationError('per-user limit cannot exceed count')
+  if (perUserLimit > count) throw new ValidationError('每人领取次数不能超过份数')
   if (mode === 'equal' && totalPoints < count)
-    throw new ValidationError('total must be at least count')
+    throw new ValidationError('均分总额不能小于份数')
 
   const shareTitle = optionalText(body.share_title, '分享标题', 60)
   const shareCover = optionalText(body.share_cover, '分享封面', 500)
@@ -58,9 +58,9 @@ export function normalizeCreateRedpacket(body) {
   const maxPoints = positiveInteger(body.max_points, '单份最大金额')
   if (maxPoints < minPoints) throw new ValidationError('单份最大金额不能小于最小金额')
   if (totalPoints < minPoints * count || totalPoints > maxPoints * count)
-    throw new ValidationError('total is outside the min..max × count range')
+    throw new ValidationError('总额不在可分配区间内(需介于 单份最小×份数 ~ 单份最大×份数)')
   if (totalPoints % count !== 0)
-    throw new ValidationError('total must be divisible by count')
+    throw new ValidationError('总额需能被份数整除(random 模式)')
 
   return { mode, totalPoints, count, perUserLimit, minPoints, maxPoints, shareTitle, shareCover, note, requireGroup }
 }

package/src/skill.js

@@ -61,12 +61,14 @@ const BODY = [
   '',
   '## 失败速查',
   '',
-  '| 错误含 | 含义 | 修正 |',
+  '| 错误里含 | 含义 | 修正 |',
   '|---|---|---|',
-  '| 可分配区间 | total 不在 min×count ~ max×count | 调整 min/max 或 total |',
-  '| 整除 | total % count ≠ 0(random) | 调整 total 或 count |',
+  '| 必须是正整数 | 参数 ≤0 或非整数 | 传正整数(内部积分单位,不换算) |',
   '| 不能超过份数 | per_user_limit > count | 降低 per_user_limit |',
-  '| at least count | equal 模式 total < count | 提高 total |',
+  '| 不能小于份数 | equal 模式 total < count | 提高 total |',
+  '| 可分配区间 | total 不在 min×count ~ max×count | 调 min/max 或 total |',
+  '| 整除 | random 模式 total % count ≠ 0 | 调 total 或 count |',
+  '| 无法识别的配置串 | 配置串前缀/内容不对 | 用配套网页重新生成配置串 |',
   '| 余额不足 / insufficient | 账户余额 < total | 先充值或调低 total |',
   '',
   '## 配置前置',

package/src/version.js

@@ -0,0 +1,6 @@
+/**
+ * 版本号单一来源。main.js / mcp.js 共用,发布时只改这里 + package.json
+ * (test/version.test.js 会断言两者一致,防止再漏升)。
+ */
+
+export const VERSION = '0.1.3'