@blod-nm/1kuan-act-01-cli 0.0.0-stage → 0.1.1

package/src/main.js

@@ -0,0 +1,506 @@
+/**
+ * act-01 CLI 入口与分发。退出码:0 成功 / 1 失败 / 2 用法错误 / 130 取消。
+ */
+
+import { parseArgs } from 'node:util'
+import { configPath, loadConfig, saveConfig, decodeConfigString, encryptConfig } from './store.js'
+import { ACCOUNT_SQL, execPgsql, resolveApikey, gatewayBase } from './tcb.js'
+import { buildCreateSql, confirmSummary, normalizeCreateRedpacket } from './redpacket.js'
+import { startMcp } from './mcp.js'
+
+const VERSION = '0.1.0'
+
+const USAGE = `act-01 —— operations CLI(invoke preset database functions)
+
+用法: act-01 <command> [options]
+
+命令:
+  config show                    查看配置(apiKey 打码)
+  config set envId <环境ID>       写入环境 ID
+  config set apiKey              写入 API Key(值走 stdin;不放命令行)
+  config test                    连接测试(SELECT 1,验证 envId/apiKey)
+  config export                  导出加密配置串(口令交互输入或 ACT01_EXPORT_PASS)
+  config import <串|--stdin>      导入配置串(自动识别 加密/明文/网页格式)
+  mcp                            启动 MCP 服务(stdio;接入 Claude 等 AI 客户端)
+  balance                        account balance
+  redpacket create               create a record(pre-flight balance check, atomic deduct)
+  redpacket check                validate params(side-effect free)
+      --mode random|equal          随机 / 均分
+      --total <积分>                总金额(正整数,不换算)
+      --count <份数>
+      --per-user <次数>             每人限领(≤ 份数)
+      --min <积分> --max <积分>     随机模式单份区间(均分自动计算)
+      --share-title --share-cover --note   可选
+      --require-group               群专属
+      --dry-run                     只打印库函数调用,不执行
+      --yes                         跳过确认
+
+apiKey 等同数据库管理员:支持 ACT01_API_KEY 环境变量,永远不要放在命令行参数里。
+
+退出码: 0 成功 / 1 失败 / 2 用法错误 / 130 取消
+`
+
+function str(values, key) {
+  return typeof values[key] === 'string' ? values[key] : undefined
+}
+
+function num(values, key) {
+  const s = str(values, key)
+  if (s === undefined) return undefined
+  const n = Number(s)
+  if (!Number.isFinite(n)) {
+    const err = new Error(`--${key} 必须是数字`)
+    err.exitCode = 2
+    throw err
+  }
+  return n
+}
+
+async function readStdinText() {
+  const chunks = []
+  for await (const chunk of process.stdin) chunks.push(chunk)
+  return Buffer.concat(chunks).toString('utf8').trim()
+}
+
+function printJson(value) {
+  console.log(JSON.stringify(value, null, process.stdout.isTTY ? 2 : undefined))
+}
+
+function printTable(headers, rows) {
+  const widths = headers.map((h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? '').length)))
+  const line = (cells) => cells.map((c, i) => (c ?? '').padEnd(widths[i] ?? 0)).join('  ').trimEnd()
+  console.log(line(headers))
+  for (const row of rows) console.log(line(row))
+}
+
+/* ---------- config ---------- */
+
+async function cmdConfig(argv) {
+  const { values, positionals } = parseArgs({
+    strict: false,
+    allowPositionals: true,
+    args: argv,
+    options: {
+      stdin: { type: 'boolean' },
+      json: { type: 'boolean', short: 'j' },
+    },
+  })
+  const sub = positionals[0] ?? 'show'
+
+  if (sub === 'show') {
+    const config = loadConfig()
+    if (values.json === true) {
+      printJson({ envId: config.envId ?? null, apiKeySet: !!config.apiKey })
+    } else {
+      printTable(
+        ['KEY', 'VALUE'],
+        [
+          ['envId', config.envId ?? '(未设置)'],
+          ['apiKey', config.apiKey ? `${config.apiKey.slice(0, 6)}…(打码)` : '(未设置)'],
+          ['configPath', configPath()],
+        ],
+      )
+    }
+    return 0
+  }
+
+  if (sub === 'set') {
+    const key = positionals[1]
+    const config = loadConfig()
+
+    if (key === 'envId') {
+      const value = positionals[2]
+      if (!value) {
+        const err = new Error('config set envId 需要 <环境ID>')
+        err.exitCode = 2
+        throw err
+      }
+      config.envId = value
+      saveConfig(config)
+      console.log(`envId 已写入: ${value}`)
+      return 0
+    }
+
+    if (key === 'apiKey') {
+      let secret = str(values, 'value') ?? positionals[2]
+      if (values.stdin === true || !secret) {
+        if (process.stdin.isTTY) {
+          const err = new Error('apiKey 是敏感信息:用 --stdin 通过管道传入,或设置 ACT01_API_KEY 环境变量')
+          err.exitCode = 2
+          throw err
+        }
+        secret = await readStdinText()
+      }
+      if (!secret) {
+        const err = new Error('apiKey 为空')
+        err.exitCode = 2
+        throw err
+      }
+      config.apiKey = secret
+      saveConfig(config)
+      console.log('apiKey 已写入(0600,打码保存)')
+      return 0
+    }
+
+    const err = new Error(`未知 config 键: ${key}(支持: envId / apiKey)`)
+    err.exitCode = 2
+    throw err
+  }
+
+  if (sub === 'export') {
+    const config = loadConfig()
+    if (!config.envId || !config.apiKey) {
+      const err = new Error('配置不完整:先 set envId 和 apiKey')
+      err.exitCode = 2
+      throw err
+    }
+    let passphrase = process.env.ACT01_EXPORT_PASS
+    if (!passphrase) {
+      if (!process.stdin.isTTY) {
+        const err = new Error('口令缺失:交互终端下会提示输入,脚本里用 --pass-stdin')
+        err.exitCode = 2
+        throw err
+      }
+      const readline = await import('node:readline')
+      const rl = readline.createInterface({ input: process.stdin, output: process.stderr, terminal: false })
+      passphrase = await new Promise((resolve) => rl.question('口令(用于加密,导出端与导入端一致): ', (a) => resolve(a.trim())))
+      rl.close()
+      if (!passphrase) {
+        const err = new Error('口令为空')
+        err.exitCode = 2
+        throw err
+      }
+    } else {
+      passphrase = passphrase.trim()
+    }
+    const str = encryptConfig(config, passphrase)
+    if (values.json === true) printJson({ configString: str })
+    else console.log(str)
+    return 0
+  }
+
+  if (sub === 'import') {
+    let body = positionals[1]
+    if (!body && !process.stdin.isTTY) body = await readStdinText()
+    if (!body) {
+      const err = new Error('config import 需要 <配置串>(位置参数或 stdin)')
+      err.exitCode = 2
+      throw err
+    }
+    const decoded = decodeConfigString(body)
+    let cfg = decoded.config
+    if (decoded.encrypted) {
+      let passphrase = process.env.ACT01_EXPORT_PASS
+      if (!passphrase) {
+        if (!process.stdin.isTTY) {
+          const err = new Error('加密串需要口令:脚本里用 ACT01_EXPORT_PASS 传入')
+          err.exitCode = 2
+          throw err
+        }
+        const readline = await import('node:readline')
+        const rl = readline.createInterface({ input: process.stdin, output: process.stderr, terminal: false })
+        passphrase = await new Promise((resolve) => rl.question('口令: ', (a) => resolve(a.trim())))
+        rl.close()
+      }
+      cfg = decoded.decode(passphrase)
+    }
+    if (!cfg.envId || !cfg.apiKey) {
+      const err = new Error('配置串内容不完整(缺 envId 或 apiKey)')
+      err.exitCode = 2
+      throw err
+    }
+    saveConfig({ envId: cfg.envId, apiKey: cfg.apiKey })
+    if (values.json === true) {
+      printJson({ imported: true, envId: cfg.envId, apiKeySet: true })
+    } else {
+      printTable(['导入', 'ENVID'], [['成功', cfg.envId]])
+      console.error('hint: apiKey 已打码写入 0600 配置文件')
+    }
+    return 0
+  }
+
+  const err = new Error(`未知 config 子命令: ${sub}`)
+  err.exitCode = 2
+  throw err
+}
+
+/* ---------- redpacket create ---------- */
+
+const CREATE_FLAGS = {
+  mode: { type: 'string' },
+  total: { type: 'string' },
+  count: { type: 'string' },
+  'per-user': { type: 'string' },
+  min: { type: 'string' },
+  max: { type: 'string' },
+  'share-title': { type: 'string' },
+  'share-cover': { type: 'string' },
+  note: { type: 'string' },
+  'require-group': { type: 'boolean' },
+}
+
+function parseCreateValues(argv) {
+  return parseArgs({ strict: false, allowPositionals: true, args: argv, options: CREATE_FLAGS }).values
+}
+
+function findMissing(values) {
+  const missing = []
+  if (!str(values, 'mode')) missing.push('--mode random|equal')
+  if (num(values, 'total') === undefined) missing.push('--total <积分>')
+  if (num(values, 'count') === undefined) missing.push('--count <份数>')
+  if (num(values, 'per-user') === undefined) missing.push('--per-user <次数>')
+  if (str(values, 'mode') === 'random' && (num(values, 'min') === undefined || num(values, 'max') === undefined))
+    missing.push('--min <积分> --max <积分>')
+  return missing
+}
+
+async function wizardFill(values, missing) {
+  const readline = await import('node:readline')
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
+  const ask = (q) => new Promise((resolve) => rl.question(q, (a) => resolve(a.trim())))
+  for (const item of missing) {
+    if (item.startsWith('--mode')) {
+      const v = await ask('type random|equal: ')
+      if (v) values.mode = v
+    } else if (item.startsWith('--total')) {
+      const v = await ask('总金额(整数积分): ')
+      if (v) values.total = v
+    } else if (item.startsWith('--count')) {
+      const v = await ask('份数: ')
+      if (v) values.count = v
+    } else if (item.startsWith('--per-user')) {
+      const v = await ask('每人限领次数: ')
+      if (v) values['per-user'] = v
+    } else if (item.startsWith('--min') || item.startsWith('--max')) {
+      if (values.min === undefined) {
+        const v = await ask('单份最小金额: ')
+        if (v) values.min = v
+      }
+      if (values.max === undefined) {
+        const v = await ask('单份最大金额: ')
+        if (v) values.max = v
+      }
+    }
+  }
+  rl.close()
+}
+
+function normalizeFromValues(values) {
+  const missing = findMissing(values)
+  if (missing.length) {
+    const err = new Error(`缺少必填参数: ${missing.join(', ')}`)
+    err.exitCode = 2
+    throw err
+  }
+  return normalizeCreateRedpacket({
+    mode: str(values, 'mode'),
+    total_points: num(values, 'total'),
+    count: num(values, 'count'),
+    per_user_limit: num(values, 'per-user'),
+    min_points: num(values, 'min'),
+    max_points: num(values, 'max'),
+    share_title: str(values, 'share-title'),
+    share_cover: str(values, 'share-cover'),
+    note: str(values, 'note'),
+    require_group: values['require-group'] === true,
+  })
+}
+
+/* ---------- redpacket check(零副作用参数校验) ---------- */
+
+async function cmdCheck(argv) {
+  const values = parseCreateValues(argv)
+  let input
+  try {
+    input = normalizeFromValues(values)
+  } catch (err) {
+    console.error(`error: ${err.message}`)
+    console.error('hint: 本命令只校验参数,不执行、不扣账;修正后重跑即可')
+    return 1
+  }
+  if (values.json === true) {
+    printJson({ valid: true, input })
+  } else {
+    console.log('参数校验通过(未执行、不扣账):')
+    for (const line of confirmSummary(input)) console.log(`  ${line}`)
+  }
+  return 0
+}
+
+async function cmdCreate(argv) {
+  const values = parseCreateValues(argv)
+  const interactive = process.stdin.isTTY === true
+
+  // 向导补齐仅限"真命令行直跑"(bin 入口打 ACT01_CLI_INVOKED 标记);
+  // 测试/程序内调用缺参一律确定性报错,防止向导抢 stdin
+  const missing = findMissing(values)
+  if (missing.length) {
+    if (!interactive || process.env.ACT01_CLI_INVOKED !== '1') {
+      const err = new Error(`缺少必填参数: ${missing.join(', ')}`)
+      err.exitCode = 2
+      throw err
+    }
+    await wizardFill(values, missing)
+  }
+
+  const input = normalizeFromValues(values)
+  const sql = buildCreateSql(input)
+
+  // --dry-run 无需任何配置(不碰网络)
+  if (values['dry-run'] === true) {
+    printJson({ dryRun: true, function: 'public.manage_act_01_redpacket_create($1..$11)', sql })
+    return 0
+  }
+
+  const config = loadConfig()
+  if (!config.envId) {
+    const err = new Error('缺少 envId')
+    err.exitCode = 2
+    err.hint = 'act-01 config set envId <环境ID>'
+    throw err
+  }
+
+  // 发之前先查总账余额:不足直接拦下,不等库函数报错
+  const apikey = resolveApikey(config, undefined)
+  if (!apikey) {
+    const err = new Error('缺少 apiKey')
+    err.exitCode = 2
+    err.hint = 'act-01 config set apiKey --stdin 或设置 ACT01_API_KEY'
+    throw err
+  }
+
+  console.error('checking account balance…')
+  const account = await execPgsql(config, apikey, ACCOUNT_SQL)
+  if (!account.ok) {
+    console.error(`error: balance query failed (${account.message})`)
+    console.error('hint: 确认 envId/apiKey 正确;或用 --yes 跳过预检(库函数仍会原子校验)')
+    return 1
+  }
+  const wallet =
+    account.rows?.[0]?.data?.wallet && typeof account.rows[0].data.wallet === 'object'
+      ? account.rows[0].data.wallet
+      : {}
+  const balance = Number(wallet.points || 0)
+  const label = String(wallet.label || 'account')
+  if (balance < input.totalPoints) {
+    console.error(`error: insufficient account balance (current ${balance} < required ${input.totalPoints})`)
+    console.error(`hint: 先到运营台充值(总账「${label}」),或调低 --total`)
+    return 1
+  }
+  console.error(`balance ${balance}, will deduct ${input.totalPoints}, remaining ${balance - input.totalPoints}`)
+
+  // 确认卡(总账扣减是真金白银)
+  if (values.yes !== true && interactive) {
+    console.log('about to deduct from account and create:')
+    for (const line of confirmSummary(input)) console.log(`  ${line}`)
+    process.stdout.write('确认执行? [y/N] ')
+    const chunks = []
+    for await (const chunk of process.stdin) chunks.push(chunk)
+    const answer = Buffer.concat(chunks).toString('utf8').trim().toLowerCase()
+    if (answer !== 'y' && answer !== 'yes') {
+      console.log('已取消')
+      return 130
+    }
+  } else if (values.yes !== true) {
+    const err = new Error('this will deduct from the account; confirm interactively or pass --yes')
+    err.exitCode = 2
+    throw err
+  }
+
+  console.error('执行中…(库函数原子扣减总账)')
+  const r = await execPgsql(config, apikey, sql)
+
+  if (!r.ok) {
+    console.error(`error: create failed (HTTP ${r.status})`)
+    if (r.message) console.error(r.message)
+    return 1
+  }
+
+  const result = r.rows?.[0]?.result
+  if (values.json === true) {
+    printJson({ ok: true, result, balanceBefore: balance, balanceAfter: balance - input.totalPoints })
+  } else {
+    printTable(
+      ['RESULT', '余额变化'],
+      [[
+        typeof result === 'string' ? result : JSON.stringify(result),
+        `${balance} → ${balance - input.totalPoints}`,
+      ]],
+    )
+    console.error('hint: deducted; recall is not supported — lifecycle is TTL-driven')
+  }
+  return 0
+}
+
+/* ---------- balance ---------- */
+
+async function cmdBalance(argv) {
+  const { values } = parseArgs({
+    strict: false,
+    allowPositionals: true,
+    args: argv,
+    options: { json: { type: 'boolean', short: 'j' } },
+  })
+  const config = loadConfig()
+  const apikey = resolveApikey(config, undefined)
+  if (!apikey) {
+    const err = new Error('缺少 apiKey')
+    err.exitCode = 2
+    err.hint = 'act-01 config set apiKey --stdin 或设置 ACT01_API_KEY'
+    throw err
+  }
+  const account = await execPgsql(config, apikey, ACCOUNT_SQL)
+  if (!account.ok) {
+    console.error(`error: balance query failed (${account.message})`)
+    return 1
+  }
+  const wallet =
+    account.rows?.[0]?.data?.wallet && typeof account.rows[0].data.wallet === 'object'
+      ? account.rows[0].data.wallet
+      : {}
+  const points = Number(wallet.points || 0)
+  const label = String(wallet.label || 'account')
+  if (values.json === true) {
+    printJson({ label, points, updatedAt: String(account.rows?.[0]?.updated_at ?? '') })
+  } else {
+    printTable(['ACCOUNT', 'BALANCE', 'UPDATED'], [[label, String(points), String(account.rows?.[0]?.updated_at ?? '')]])
+  }
+  return 0
+}
+
+/* ---------- 分发 ---------- */
+
+export async function main(argv) {
+  const cmd = argv[0]
+
+  if (cmd === undefined || cmd === '-h' || cmd === '--help' || cmd === 'help') {
+    process.stdout.write(USAGE)
+    return cmd === undefined ? 2 : 0
+  }
+  if (cmd === '--version' || cmd === '-V' || cmd === 'version') {
+    process.stdout.write(`act-01 ${VERSION}\n`)
+    return 0
+  }
+
+  try {
+    if (cmd === 'config') return await cmdConfig(argv.slice(1))
+    if (cmd === 'balance') return await cmdBalance(argv.slice(1))
+    if (cmd === 'mcp') return await startMcp()
+    if (cmd === 'redpacket') {
+      const sub = argv[1]
+      if (sub === 'create') return await cmdCreate(argv.slice(2))
+      if (sub === 'check') return await cmdCheck(argv.slice(2))
+      const err = new Error(`未知 redpacket 子命令: ${sub ?? '(空)'}(支持: create / check)`)
+      err.exitCode = 2
+      throw err
+    }
+    const err = new Error(`未知命令: ${cmd}`)
+    err.exitCode = 2
+    err.hint = 'act-01 --help 查看命令列表'
+    throw err
+  } catch (err) {
+    console.error(`error: ${err.message}`)
+    if (err.hint) console.error(`hint: ${err.hint}`)
+    return err.exitCode ?? 1
+  }
+}

package/src/mcp.js

@@ -0,0 +1,197 @@
+/**
+ * act-01 MCP 服务(stdio,换行分隔 JSON-RPC 2.0,零依赖)。
+ *
+ * 启动: act-01 mcp(或 node bin/act-01.js mcp)
+ * 接入: claude mcp add act-01 -- node /path/to/bin/act-01.js mcp
+ *
+ * 工具: redpacket_create(有副作用:总账扣减,审批由客户端负责)
+ *       redpacket_check(零副作用参数校验)
+ *       balance(总账余额)
+ *
+ * 纪律: MCP 模式下 stdout 只输出 JSON-RPC 报文,任何日志走 stderr。
+ */
+
+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 SUPPORTED = ['2025-11-25', '2025-06-18', '2025-03-26', '2024-11-05', '2024-10-07']
+const LATEST = '2025-11-25'
+
+const TOOLS = [
+  {
+    name: 'redpacket_create',
+    description:
+      'create a record with atomic balance deduct (side effect; client should confirm with the user first).' +
+      'mode=random 时需 min/max 单份区间且总额能被份数整除;mode=equal 时自动均分。' +
+      'returns packet summary.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        mode: { type: 'string', enum: ['random', 'equal'], description: 'random / equal' },
+        total_points: { type: 'integer', description: 'total amount (integer units, no conversion)' },
+        count: { type: 'integer', description: 'count' },
+        per_user_limit: { type: 'integer', description: '每人限领次数,≤ 份数' },
+        min_points: { type: 'integer', description: '随机模式:单份最小金额' },
+        max_points: { type: 'integer', description: '随机模式:单份最大金额' },
+        share_title: { type: 'string', description: '可选分享标题,≤60 字' },
+        note: { type: 'string', description: '可选备注,≤20 字' },
+        require_group: { type: 'boolean' },
+      },
+      required: ['mode', 'total_points', 'count', 'per_user_limit'],
+    },
+  },
+  {
+    name: 'redpacket_check',
+    description: 'validate create params (side-effect free). Recommended before create.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        mode: { type: 'string', enum: ['random', 'equal'] },
+        total_points: { type: 'integer' },
+        count: { type: 'integer' },
+        per_user_limit: { type: 'integer' },
+        min_points: { type: 'integer' },
+        max_points: { type: 'integer' },
+        share_title: { type: 'string' },
+        note: { type: 'string' },
+        require_group: { type: 'boolean' },
+      },
+      required: ['mode', 'total_points', 'count', 'per_user_limit'],
+    },
+  },
+  {
+    name: 'balance',
+    description: 'query account balance.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+]
+
+function needConfig() {
+  const config = loadConfig()
+  const apikey = resolveApikey(config, undefined)
+  if (!config.envId || !apikey) {
+    const err = new Error('云开发配置不完整:先在终端执行 act-01 config set envId / apiKey(不进对话上下文)')
+    err.code = 'no-config'
+    throw err
+  }
+  return { config, apikey }
+}
+
+async function callTool(name, args) {
+  if (name === 'redpacket_create' || name === 'redpacket_check') {
+    const checkOnly = name === 'redpacket_check'
+    const input = normalizeCreateRedpacket(args) // 校验失败抛 ValidationError
+    const sql = buildCreateSql(input)
+    if (checkOnly) {
+      return {
+        valid: true,
+        summary: input,
+        sql,
+        note: '参数校验通过;这是校验结果,未执行任何写操作',
+      }
+    }
+    const { config, apikey } = needConfig()
+    const r = await execPgsql(config, apikey, sql)
+    if (!r.ok) {
+      const err = new Error(r.message || `HTTP ${r.status}`)
+      err.gateway = true
+      throw err
+    }
+    return r.rows?.[0]?.result ?? r.raw
+  }
+
+  if (name === 'balance') {
+    const { config, apikey } = needConfig()
+    const r = await execPgsql(config, apikey, ACCOUNT_SQL)
+    if (!r.ok) {
+      const err = new Error(r.message || `HTTP ${r.status}`)
+      err.gateway = true
+      throw err
+    }
+    const wallet =
+      r.rows?.[0]?.data?.wallet && typeof r.rows[0].data.wallet === 'object'
+        ? r.rows[0].data.wallet
+        : {}
+    return {
+      label: String(wallet.label || 'account'),
+      points: Number(wallet.points || 0),
+      updatedAt: String(r.rows?.[0]?.updated_at ?? ''),
+    }
+  }
+
+  const err = new Error(`未知工具: ${name}`)
+  err.code = 'unknown-tool'
+  throw err
+}
+
+function toolResult(payload) {
+  return { content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }] }
+}
+
+function toolError(message) {
+  return { content: [{ type: 'text', text: message }], isError: true }
+}
+
+export async function startMcp() {
+  const readline = await import('node:readline')
+  const rl = readline.createInterface({ input: process.stdin, terminal: false })
+
+  const reply = (msg) => process.stdout.write(`${JSON.stringify(msg)}\n`)
+
+  rl.on('line', async (line) => {
+    const text = line.trim()
+    if (!text) return
+    let msg
+    try {
+      msg = JSON.parse(text)
+    } catch {
+      reply({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } })
+      return
+    }
+    if (msg.id === undefined || msg.id === null) return // 通知:不回复
+
+    try {
+      if (msg.method === 'initialize') {
+        const requested = String(msg.params?.protocolVersion ?? '')
+        const version = SUPPORTED.includes(requested) ? requested : LATEST
+        reply({
+          jsonrpc: '2.0',
+          id: msg.id,
+          result: { protocolVersion: version, capabilities: { tools: {} }, serverInfo: SERVER_INFO },
+        })
+      } else if (msg.method === 'ping') {
+        reply({ jsonrpc: '2.0', id: msg.id, result: {} })
+      } else if (msg.method === 'tools/list') {
+        reply({ jsonrpc: '2.0', id: msg.id, result: { tools: TOOLS } })
+      } else if (msg.method === 'tools/call') {
+        const name = String(msg.params?.name ?? '')
+        const args = msg.params?.arguments ?? {}
+        try {
+          const payload = await callTool(name, args)
+          reply({ jsonrpc: '2.0', id: msg.id, result: toolResult(payload) })
+        } catch (err) {
+          reply({ jsonrpc: '2.0', id: msg.id, result: toolError(err.message) })
+        }
+      } else {
+        reply({
+          jsonrpc: '2.0',
+          id: msg.id,
+          error: { code: -32601, message: `Method not found: ${msg.method}` },
+        })
+      }
+    } catch (err) {
+      reply({
+        jsonrpc: '2.0',
+        id: msg.id,
+        error: { code: -32603, message: err instanceof Error ? err.message : String(err) },
+      })
+    }
+  })
+
+  rl.on('close', () => process.exit(0))
+  // MCP 模式下 stderr 才是日志通道
+  console.error(`act-01 MCP 服务已启动(${SERVER_INFO.version},stdio)`)
+  return new Promise(() => {/* 保持运行直到 stdin 关闭 */})
+}