@rongyan/wxpost-server 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rongyan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,390 @@
+# @rongyan/wxpost-server
+
+微信公众号内容发布服务，支持多账号，提供图片上传、草稿管理和发布等 HTTP 接口。
+
+## 要求
+
+- Node.js >= 18
+- 微信公众号开发者账号（AppID + AppSecret）
+- 服务器 IP 已加入微信公众平台 **IP 白名单**
+
+## 安装
+
+```bash
+npm install -g @rongyan/wxpost-server
+```
+
+或直接通过 npx 运行（无需安装）：
+
+```bash
+npx @rongyan/wxpost-server
+```
+
+## 配置
+
+首次启动时，程序会自动在 `~/.@rongyan/env.json` 创建配置模板并退出。编辑该文件填入真实值后重启即可。
+
+```json
+{
+  "port": 3000,
+  "api_key": "your-api-key",
+  "upload_dir": "/Users/yourname/.@rongyan/upload_dir",
+  "defaultAccount": "wx_appid",
+  "accounts": {
+    "wx_appid": {
+      "appSecret": "your-app-secret"
+    },
+    "wx_another_appid": {
+      "appSecret": "another-app-secret"
+    }
+  }
+}
+```
+
+| 字段 | 说明 |
+|------|------|
+| `port` | 配置文件中的默认监听端口，默认 `3000`；可被 `--port` 参数或 `PORT` 环境变量覆盖 |
+| `api_key` | HTTP 接口鉴权密钥 |
+| `upload_dir` | 图片上传临时目录，默认 `~/.@rongyan/upload_dir/` |
+| `defaultAccount` | 不传 `appid` 参数时使用的默认账号（填 AppID） |
+| `accounts` | 多账号配置，以 AppID 为 key，每个账号填写 `appSecret` |
+
+## 启动
+
+```bash
+# 使用配置文件中的端口
+wxpost-server
+
+# 指定端口（优先级最高）
+wxpost-server --port 8080
+
+# 通过环境变量指定端口
+PORT=8080 wxpost-server
+
+# 开发模式（文件变更自动重启）
+npm run dev
+```
+
+端口优先级：`--port 参数` > `PORT 环境变量` > `配置文件 port` > `默认 3000`
+
+## IP 白名单
+
+微信接口要求服务器 IP 在白名单内。配置路径：
+
+**微信公众平台** → 设置与开发 → 基本配置 → IP 白名单
+
+## token 缓存
+
+access_token 自动缓存至 `~/.@rongyan/tokens.json`，有效期 7200 秒，提前 5 分钟自动刷新，多进程共享同一缓存文件。
+
+---
+
+## API
+
+所有接口均需鉴权，支持以下两种方式（二选一）：
+
+```
+Authorization: Bearer <api_key>
+X-Api-Key: <api_key>
+```
+
+所有请求和响应均为 JSON（上传图片除外）。响应体统一包含 `ok` 字段，`true` 表示成功，`false` 表示失败（同时包含 `error` 字段）。
+
+多账号场景可通过 `?appid=` 查询参数指定账号，不传则使用 `defaultAccount`。
+
+---
+
+### POST /upload-image
+
+上传图片到微信服务器，返回微信 CDN 图片地址。
+
+**请求格式：** `multipart/form-data`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `media` | file | 图片文件，仅支持 JPG/PNG（按文件内容识别），大小须严格小于 1MB |
+
+**查询参数：**
+
+| 参数 | 说明 |
+|------|------|
+| `appid` | 可选，指定使用的公众号 AppID，不传使用默认账号 |
+
+**请求示例：**
+
+```bash
+curl -X POST http://localhost:3000/upload-image \
+  -H "Authorization: Bearer your-api-key" \
+  -F "media=@/path/to/image.jpg"
+```
+
+**成功响应：**
+
+```json
+{
+  "ok": true,
+  "url": "https://mmbiz.qpic.cn/..."
+}
+```
+
+**错误响应：**
+
+| 状态码 | 说明 |
+|--------|------|
+| 401 | 鉴权失败 |
+| 400 | 格式不支持（非 JPG/PNG） |
+| 413 | 图片超过 1MB，请压缩后重试 |
+| 502 | 微信接口调用失败 |
+
+---
+
+### POST /upload-material
+
+上传图片为**永久素材**，返回 `media_id` 和微信 CDN 地址。永久素材可用于草稿封面图（`thumb_media_id`）等需要持久化的场景。
+
+**请求格式：** `multipart/form-data`
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `media` | file | 图片文件，支持 JPG/PNG/GIF/BMP（按文件内容识别），大小须严格小于 10MB |
+
+**查询参数：**
+
+| 参数 | 说明 |
+|------|------|
+| `appid` | 可选，指定使用的公众号 AppID，不传使用默认账号 |
+
+**请求示例：**
+
+```bash
+curl -X POST http://localhost:3000/upload-material \
+  -H "Authorization: Bearer your-api-key" \
+  -F "media=@/path/to/cover.jpg"
+```
+
+**成功响应：**
+
+```json
+{
+  "ok": true,
+  "media_id": "xxx",
+  "url": "https://mmbiz.qpic.cn/..."
+}
+```
+
+> `url` 仅在微信/腾讯域名下有效，不可在外部网页直接引用。
+
+**错误响应：**
+
+| 状态码 | 说明 |
+|--------|------|
+| 401 | 鉴权失败 |
+| 400 | 格式不支持（非 JPG/PNG/GIF/BMP） |
+| 413 | 图片超过 10MB，请压缩后重试 |
+| 502 | 微信接口调用失败 |
+
+---
+
+### POST /draft/add
+
+新增草稿，返回草稿的 `media_id`。
+
+**请求格式：** `application/json`
+
+**请求体：**
+
+```json
+{
+  "articles": [
+    {
+      "article_type": "news",
+      "title": "文章标题",
+      "author": "作者",
+      "digest": "摘要",
+      "content": "<p>正文 HTML</p>",
+      "content_source_url": "https://example.com",
+      "thumb_media_id": "封面图素材ID",
+      "need_open_comment": 0,
+      "only_fans_can_comment": 0,
+      "pic_crop_235_1": "0,0,1,0.4985",
+      "pic_crop_1_1": "0,0,1,1",
+      "cover_info": {},
+      "product_info": {}
+    }
+  ]
+}
+```
+
+**articles 字段说明：**
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `article_type` | string | 否 | `"news"`（图文，默认）或 `"newspic"`（图片） |
+| `title` | string | 是 | 超过 64 字自动截断 |
+| `author` | string | 否 | 最多 16 字 |
+| `digest` | string | 否 | 摘要，最多 128 字；不填则从正文自动截取 |
+| `content` | string | 是 | 正文 HTML，最多 2 万字 |
+| `content_source_url` | string | 否 | 点击"阅读原文"跳转的 URL |
+| `thumb_media_id` | string | news 类型必填 | 封面图的永久素材 MediaID |
+| `image_info` | object | newspic 类型必填 | 图片列表，`{ "list": [...] }`，最多 20 张 |
+| `need_open_comment` | number | 否 | 是否开启评论：`0` 关闭，`1` 开启 |
+| `only_fans_can_comment` | number | 否 | 仅粉丝可评论：`0` 所有人，`1` 仅粉丝 |
+| `pic_crop_235_1` | string | 否 | 封面裁剪坐标（2.35:1） |
+| `pic_crop_1_1` | string | 否 | 封面裁剪坐标（1:1） |
+| `cover_info` | object | 否 | 封面裁剪信息对象 |
+| `product_info` | object | 否 | 商品信息对象 |
+
+**成功响应：**
+
+```json
+{
+  "ok": true,
+  "media_id": "草稿的media_id"
+}
+```
+
+**错误响应：**
+
+| 状态码 | 说明 |
+|--------|------|
+| 401 | 鉴权失败 |
+| 400 | 参数校验失败或微信接口返回错误 |
+| 413 | 请求体超过 2MB |
+| 502 | 获取 access_token 失败 |
+
+---
+
+### POST /draft/list
+
+获取草稿列表（分页）。
+
+**请求格式：** `application/json`（请求体可省略，使用默认值）
+
+**请求体：**
+
+```json
+{
+  "offset": 0,
+  "count": 20,
+  "no_content": 0
+}
+```
+
+| 字段 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `offset` | number | `0` | 起始偏移，从 0 开始 |
+| `count` | number | `20` | 返回数量，1–20 |
+| `no_content` | number | `0` | `1` 表示不返回正文内容，`0` 返回 |
+
+**成功响应：**
+
+```json
+{
+  "ok": true,
+  "total_count": 100,
+  "item_count": 20,
+  "item": [
+    {
+      "media_id": "草稿ID",
+      "update_time": 1234567890,
+      "content": {
+        "news_item": [
+          {
+            "title": "文章标题",
+            "author": "作者",
+            "digest": "摘要",
+            "content": "<p>正文</p>",
+            "thumb_media_id": "封面素材ID",
+            "url": "草稿预览链接",
+            "article_type": "news"
+          }
+        ]
+      }
+    }
+  ]
+}
+```
+
+**错误响应：**
+
+| 状态码 | 说明 |
+|--------|------|
+| 401 | 鉴权失败 |
+| 400 | 参数错误或微信接口返回错误 |
+| 502 | 获取 access_token 失败 |
+
+---
+
+### POST /draft/publish
+
+发布草稿为正式图文，返回发布任务 ID。
+
+**请求格式：** `application/json`
+
+**请求体：**
+
+```json
+{
+  "media_id": "草稿的media_id"
+}
+```
+
+| 字段 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `media_id` | string | 是 | 要发布的草稿 ID |
+
+**成功响应：**
+
+```json
+{
+  "ok": true,
+  "publish_id": "发布任务ID",
+  "msg_data_id": "消息数据ID"
+}
+```
+
+**错误响应：**
+
+| 状态码 | 说明 |
+|--------|------|
+| 401 | 鉴权失败 |
+| 400 | 缺少 `media_id`、草稿未通过检查或其他微信错误（含错误码） |
+| 502 | 获取 access_token 失败 |
+
+**微信错误码：**
+
+| 错误码 | 说明 |
+|--------|------|
+| 48001 | 接口未授权，确认公众号已开通该能力 |
+| 53503 | 草稿未通过发布检查，检查草稿内容 |
+| 53504 | 需前往公众平台官网操作 |
+| 53505 | 请手动保存成功后再发布 |
+
+---
+
+## 典型工作流
+
+```bash
+# 1. 上传文章封面图，获取永久素材 media_id
+curl -X POST http://localhost:3000/upload-material \
+  -H "Authorization: Bearer your-api-key" \
+  -F "media=@cover.jpg"
+
+# 2. 新增草稿
+curl -X POST http://localhost:3000/draft/add \
+  -H "Authorization: Bearer your-api-key" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "articles": [{
+      "title": "文章标题",
+      "content": "<p>正文内容</p>",
+      "thumb_media_id": "上一步返回的media_id"
+    }]
+  }'
+
+# 3. 发布草稿
+curl -X POST http://localhost:3000/draft/publish \
+  -H "Authorization: Bearer your-api-key" \
+  -H "Content-Type: application/json" \
+  -d '{ "media_id": "上一步返回的media_id" }'
+```

package/bin/wxpost-server.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const { startServer } = require('../src/index.js');
+
+// 解析 --port <n> 或 --port=<n>
+function parsePort(args) {
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--port' && args[i + 1]) return parseInt(args[i + 1], 10);
+    const m = args[i].match(/^--port=(\d+)$/);
+    if (m) return parseInt(m[1], 10);
+  }
+  return null;
+}
+
+const cliPort = parsePort(process.argv.slice(2));
+startServer({ port: cliPort });

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@rongyan/wxpost-server",
+  "version": "0.1.0",
+  "description": "微信公众号内容发布服务，支持多账号，提供图片上传、草稿管理和发布等 HTTP 接口",
+  "main": "src/index.js",
+  "bin": {
+    "wxpost-server": "./bin/wxpost-server.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "start": "node bin/wxpost-server.js",
+    "dev": "node --watch bin/wxpost-server.js"
+  },
+  "keywords": [
+    "wechat",
+    "weixin",
+    "wxpost",
+    "mp",
+    "server",
+    "draft",
+    "publish"
+  ],
+  "author": "rongyan",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rongyan6/wepost-server.git"
+  },
+  "homepage": "https://github.com/rongyan6/wepost-server#readme",
+  "bugs": {
+    "url": "https://github.com/rongyan6/wepost-server/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "busboy": "^1.6.0"
+  }
+}

package/src/auth.js

@@ -0,0 +1,47 @@
+'use strict';
+
+const crypto = require('crypto');
+const { loadConfig } = require('./config');
+
+/**
+ * 校验请求中的 API Key。
+ * 支持两种方式：
+ *   Authorization: Bearer <api_key>
+ *   X-Api-Key: <api_key>
+ *
+ * 使用 timingSafeEqual 防止时序攻击。
+ * @returns {string|null} 错误描述，null 表示通过
+ */
+function checkApiKey(req) {
+  const config = loadConfig();
+  const expected = config.api_key;
+
+  if (!expected || expected === '__YOUR_API_KEY__') {
+    return 'api_key 未配置，请在 env.json 中设置 api_key';
+  }
+
+  const authHeader = req.headers['authorization'];
+  const xApiKey = req.headers['x-api-key'];
+
+  let provided = null;
+  if (authHeader && authHeader.startsWith('Bearer ')) {
+    provided = authHeader.slice(7).trim();
+  } else if (xApiKey) {
+    provided = xApiKey.trim();
+  }
+
+  if (!provided) {
+    return '缺少 API Key（Authorization: Bearer <key> 或 X-Api-Key: <key>）';
+  }
+
+  const bufExpected = Buffer.from(expected);
+  const bufProvided = Buffer.from(provided);
+  if (bufProvided.length !== bufExpected.length ||
+      !crypto.timingSafeEqual(bufProvided, bufExpected)) {
+    return 'API Key 无效';
+  }
+
+  return null;
+}
+
+module.exports = { checkApiKey };

package/src/config.js

@@ -0,0 +1,100 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CONFIG_DIR = path.join(os.homedir(), '.@rongyan');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'env.json');
+
+const DEFAULT_UPLOAD_DIR = path.join(os.homedir(), '.@rongyan', 'upload_dir');
+const DEFAULT_LOG_DIR = path.join(os.homedir(), '.@rongyan', 'log');
+
+const TEMPLATE = {
+  port: 3000,
+  api_key: '__YOUR_API_KEY__',
+  upload_dir: DEFAULT_UPLOAD_DIR,
+  log_dir: DEFAULT_LOG_DIR,
+  defaultAccount: 'wx__YOUR_APP_ID__',
+  accounts: {
+    'wx__YOUR_APP_ID__': {
+      appSecret: '__YOUR_APP_SECRET__',
+    },
+  },
+};
+
+function ensureConfig() {
+  if (fs.existsSync(CONFIG_PATH)) return false;
+
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_PATH, JSON.stringify(TEMPLATE, null, 2) + '\n', { mode: 0o600, encoding: 'utf-8' });
+  return true;
+}
+
+let _cache = null;
+
+function loadConfig() {
+  if (_cache) return _cache;
+
+  const created = ensureConfig();
+  if (created) {
+    console.error([
+      '',
+      '  配置文件已创建：' + CONFIG_PATH,
+      '  请编辑该文件，填入你的公众号 AppID 和 AppSecret，然后重新启动。',
+      '',
+      '  格式说明：',
+      '    port            — 监听端口（也可用 --port 参数或 PORT 环境变量覆盖）',
+      '    api_key         — HTTP 接口鉴权密钥',
+      '    upload_dir      — 本地图片存储目录（默认 ~/.@rongyan/upload_dir/）',
+      '    log_dir         — 日志目录（默认 ~/.@rongyan/log/）',
+      '    defaultAccount  — 默认使用的 AppID',
+      '    accounts        — 以 AppID 为 key，每个账号填写对应的 appSecret',
+      '',
+    ].join('\n'));
+    process.exit(1);
+  }
+
+  const raw = fs.readFileSync(CONFIG_PATH, 'utf-8');
+  try {
+    _cache = JSON.parse(raw);
+  } catch (e) {
+    throw new Error(`配置文件 JSON 格式错误 (${CONFIG_PATH}): ${e.message}`);
+  }
+
+  return _cache;
+}
+
+function getAccount(appId) {
+  const config = loadConfig();
+  const id = appId || config.defaultAccount;
+  if (!id) {
+    throw new Error('未指定 appId，且配置中没有 defaultAccount。');
+  }
+  const account = config.accounts?.[id];
+  if (!account) {
+    const available = Object.keys(config.accounts || {}).join(', ') || '(空)';
+    throw new Error(`账号 "${id}" 不存在。可用账号：${available}`);
+  }
+  if (!account.appSecret) {
+    throw new Error(`账号 "${id}" 缺少 appSecret。`);
+  }
+  return { appId: id, appSecret: account.appSecret };
+}
+
+function listAccounts() {
+  const config = loadConfig();
+  return Object.keys(config.accounts || {});
+}
+
+function getUploadDir() {
+  const config = loadConfig();
+  return config.upload_dir || DEFAULT_UPLOAD_DIR;
+}
+
+function getLogDir() {
+  const config = loadConfig();
+  return config.log_dir || DEFAULT_LOG_DIR;
+}
+
+module.exports = { loadConfig, getAccount, listAccounts, getUploadDir, getLogDir, CONFIG_PATH };

package/src/draft-list.js

@@ -0,0 +1,65 @@
+'use strict';
+
+const https = require('https');
+
+const DRAFT_BATCHGET_URL = 'https://api.weixin.qq.com/cgi-bin/draft/batchget';
+const REQUEST_TIMEOUT_MS = 10 * 1000;
+
+/**
+ * 获取草稿列表。
+ * @param {string} accessToken
+ * @param {object} opts
+ * @param {number} opts.offset     起始位置，从 0 开始
+ * @param {number} opts.count      返回数量，1-20
+ * @param {number} [opts.no_content=0]  1=不返回 content 字段，0=返回
+ */
+function getDraftList(accessToken, { offset, count, no_content = 0 }) {
+  if (typeof offset !== 'number' || offset < 0 || !Number.isInteger(offset)) {
+    return Promise.reject(new Error('offset 须为非负整数'));
+  }
+  if (typeof count !== 'number' || count < 1 || count > 20 || !Number.isInteger(count)) {
+    return Promise.reject(new Error('count 须为 1-20 的整数'));
+  }
+  if (no_content !== 0 && no_content !== 1) {
+    return Promise.reject(new Error('no_content 须为 0 或 1'));
+  }
+
+  const body = JSON.stringify({ offset, count, no_content });
+
+  return new Promise((resolve, reject) => {
+    const req = https.request(
+      `${DRAFT_BATCHGET_URL}?access_token=${accessToken}`,
+      {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json; charset=utf-8',
+          'Content-Length': Buffer.byteLength(body),
+        },
+      },
+      (res) => {
+        let raw = '';
+        res.on('data', (chunk) => { raw += chunk; });
+        res.on('end', () => {
+          let result;
+          try {
+            result = JSON.parse(raw);
+          } catch {
+            return reject(new Error(`微信接口响应解析失败: ${raw}`));
+          }
+          if (result.errcode) {
+            return reject(new Error(`获取草稿列表失败 [${result.errcode}]: ${result.errmsg}`));
+          }
+          // 过滤微信内部字段，只返回业务数据
+          const { errcode, errmsg, ...data } = result;
+          resolve(data);
+        });
+      }
+    );
+    req.setTimeout(REQUEST_TIMEOUT_MS, () => req.destroy(new Error('获取草稿列表请求超时')));
+    req.on('error', reject);
+    req.write(body);
+    req.end();
+  });
+}
+
+module.exports = { getDraftList };