Registration Workbench Local

本目录是独立的 Node.js 本地工具包，可作为公开 npm CLI 包发布。

推荐使用方式：

npx @bbqin/registration-workbench-local

或全局安装：

npm install -g @bbqin/registration-workbench-local
registration-workbench-local

CLI 命令：

registration-workbench-local          # 启动本地服务并打开页面
registration-workbench-local start    # 后台启动服务
registration-workbench-local status   # 查看状态
registration-workbench-local logs 20  # 查看最近日志
registration-workbench-local stop     # 停止服务
registration-workbench-local config   # 生成并显示本地配置路径

脚本分层：

• 仓库根 scripts/registration-workbench-local-*.{cmd,ps1,sh} 是项目级入口，供 AI 和仓库协作脚本统一调用。
• 包内 scripts/*.js 是实际实现层。
• 包内 bootstrap.cmd/.ps1/.command 是面向人工双击启动的便捷入口，不作为 AI 默认入口；如需非交互执行，可设置 WORKBENCH_LOCAL_SKIP_OPEN=1 跳过自动打开浏览器，并设置 WORKBENCH_LOCAL_NO_PAUSE=1 跳过窗口暂停。

最小使用方式：

npm install
npm run setup
npm start

默认行为：

• 远程地址默认使用 https://assistant.lqjqc.com，模板写在 config.example.json 中。
• config.json 是本机运行配置，首次运行或执行 registration-workbench-local config 会自动生成；后续 install/start/open 也会自动按最新模板补齐新增字段与空值默认项，不提交到仓库。
• GoPay 自动支付页位于 http://127.0.0.1:<port>/tools/gopay-auto-pay，也是当前唯一页面入口。
• 配置、日志、pid 和 runtime 文件存放在用户数据目录，避免写入 npm 包安装目录。
  • Windows：%APPDATA%\registration-workbench-local
  • macOS：~/Library/Application Support/registration-workbench-local
  • Linux：~/.config/registration-workbench-local
• daemon 实际运行的是用户目录下的 runtime/app 快照，不依赖 npx 临时安装目录；同版本源码有变化时也会自动刷新快照。
• 如果 config.json 中未配置 remote.basicAuth.user/password，首次访问页面时浏览器会弹出原生 Basic Auth 输入框；输入一次后，本地服务会把这组凭据写回同一个 config.json，后续直接复用。
• 端口同样写在 config.json 的 server.port 中，默认 17810。

生命周期命令：

npm run setup
npm run daemon-start
npm run status
npm run logs -- 20
npm run stop

默认行为：

• GoPay 自动支付任务采用混合链路：checkout、checkout approve、midtrans linking 固定走本机 Chrome，其余 Stripe/GoPay API 步骤继续走本地服务端请求。
• 本地 Chrome 与服务端请求都会读取 config.json 里的 gopay.localProxyUrl；支持 http:// 和 socks5:// 代理。
• 如果未找到 Chrome，会返回 未找到本机 Chrome，请安装 Chrome 后重试。
• 邮箱、TG 等接口由本地服务转发到 config.json 中的 remote.baseUrl。
• GoPay 自动支付任务默认复用远端 Telegram 配置和消息查询接口，本地只保存 PIN、代理和 GoPay 相关 endpoint/cookie。
• 配置优先级为：环境变量 > config.json > 模板默认值；环境变量空值会被忽略，不回写到文件。

核心配置模板：

{
  "server": {
    "port": 17810
  },
  "remote": {
    "baseUrl": "https://assistant.lqjqc.com",
    "basicAuth": {
      "user": "",
      "password": ""
    }
  },
  "gopay": {
    "pin": "789789",
    "localProxyUrl": "http://127.0.0.1:10808",
    "checkoutEndpoint": "https://chatgpt.com/backend-api/payments/checkout",
    "checkoutApproveEndpoint": "https://chatgpt.com/backend-api/payments/checkout/approve",
    "midtransBaseUrl": "https://app.midtrans.com",
    "gopayGwaBaseUrl": "https://gwa.gopayapi.com",
    "gopayCustomerBaseUrl": "https://customer.gopayapi.com",
    "midtransLinkingAuthorization": "",
    "midtransLinkingCookie": "",
    "midtransChargeCookie": "",
    "otp": {
      "pollIntervalMs": 5000,
      "timeoutMs": 120000
    },
    "verify": {
      "pollIntervalMs": 2000,
      "timeoutMs": 120000
    }
  }
}