@shendu-sdt/platform-patrol

Platform Patrol

@shendu-sdt/platform-patrol 是供内部同事在 macOS 和 Windows 本机运行的平台巡检 CLI。它访问承接、兑接、承载三个 ERP Web，保存截图，并生成 Markdown 和内嵌截图的 DOCX 报告。

第一步：安装

需要 Node.js 20 或更高版本，并提前安装 Google Chrome。

npm install -g @shendu-sdt/platform-patrol

第二步：setup

platform-patrol setup

setup 会逐项解释配置用途，并完成以下操作：

1. 选择直接粘贴凭证 JSON，或输入 JSON 文件路径；
2. 校验承接、兑接、承载三个平台的账号和密码；
3. 配置本机输出根目录；
4. 检查输出目录可写且 Google Chrome 可用；
5. 将配置保存到 ~/.platform-patrol/config.json。Windows 对应 %USERPROFILE%\.platform-patrol\config.json。

内部文档提供的凭证 JSON 使用以下结构：

{
  "version": 1,
  "credentials": {
    "chengjie": {
      "accounts": ["手机号1", "手机号2"],
      "primaryPassword": "主密码",
      "backupPassword": "备用密码"
    },
    "duijie": {
      "accounts": ["手机号1", "手机号2"],
      "primaryPassword": "主密码",
      "backupPassword": "备用密码"
    },
    "chengzai": {
      "accounts": ["手机号"],
      "primaryPassword": "密码"
    }
  }
}

也可以直接指定文件和输出目录：

platform-patrol setup --config "/path/to/credentials.json" --output "/path/to/results"

本地 AI 接收到 JSON 文本时，可通过标准输入配置，不需要创建中间文件：

platform-patrol setup --stdin --output "/path/to/results"

第三步：执行

platform-patrol all

单个平台补跑：

platform-patrol cj  # 承接
platform-patrol dj  # 兑接
platform-patrol cz  # 承载

每天的产物写入 setup 配置的输出根目录：

YYYYMMDD-platform-patrol/
├── YYYYMMDD-platform-patrol.md
├── YYYYMMDD-platform-patrol.docx
├── images/
└── manifests/

如果当天 DOCX 正被 Word、WPS 或文件预览占用，CLI 会短暂重试，并在仍无法覆盖时另存为带时间后缀的 DOCX，保留本次巡检结果。

目录、报告、截图和清单文件名只使用 ASCII 字符，报告正文保留中文。重新执行 platform-patrol setup 可以整体更新凭证或输出目录。

源码开发

源码仓库仍支持 .env.local，用于兼容原有开发方式；全局 CLI 优先读取用户目录配置。仓库内可运行：

pnpm patrol:cj
pnpm patrol:dj
pnpm patrol:cz
pnpm patrol:all

这些巡检命令会访问真实线上站点并发送真实短信，不要为了调试自动重复执行。