@rongyan/wxpost-server 0.1.0 → 0.1.2

package/README.md

@@ -11,18 +11,20 @@
 ## 安装
 
 ```bash
-npm install -g @rongyan/wxpost-server
+npm install -g @rongyan/wxpost-server@latest
 ```
 
-或直接通过 npx 运行（无需安装）：
+## 初始化配置
+
+首次运行以下命令，程序会自动在 `~/.@rongyan/env.json` 创建配置模板：
 
 ```bash
-npx @rongyan/wxpost-server
+wxpost-server --help
 ```
 
-## 配置
+![初始化配置](images/init.png)
 
-首次启动时，程序会自动在 `~/.@rongyan/env.json` 创建配置模板并退出。编辑该文件填入真实值后重启即可。
+编辑 `~/.@rongyan/env.json`，填入真实值：
 
 ```json
 {
@@ -52,21 +54,26 @@ npx @rongyan/wxpost-server
 ## 启动
 
 ```bash
-# 使用配置文件中的端口
+# 直接启动
 wxpost-server
 
-# 指定端口（优先级最高）
+# 指定端口
 wxpost-server --port 8080
 
 # 通过环境变量指定端口
 PORT=8080 wxpost-server
-
-# 开发模式（文件变更自动重启）
-npm run dev
 ```
 
 端口优先级：`--port 参数` > `PORT 环境变量` > `配置文件 port` > `默认 3000`
 
+### 使用 PM2（推荐生产环境）
+
+```bash
+pm2 start wxpost-server --name wxpost-server -- --port 3000
+pm2 save       # 保存进程列表
+pm2 startup    # 设置开机自启（按提示执行输出的命令）
+```
+
 ## IP 白名单
 
 微信接口要求服务器 IP 在白名单内。配置路径：
@@ -223,7 +230,7 @@ curl -X POST http://localhost:3000/upload-material \
 | `title` | string | 是 | 超过 64 字自动截断 |
 | `author` | string | 否 | 最多 16 字 |
 | `digest` | string | 否 | 摘要，最多 128 字；不填则从正文自动截取 |
-| `content` | string | 是 | 正文 HTML，最多 2 万字 |
+| `content` | string | 是 | 正文 HTML |
 | `content_source_url` | string | 否 | 点击"阅读原文"跳转的 URL |
 | `thumb_media_id` | string | news 类型必填 | 封面图的永久素材 MediaID |
 | `image_info` | object | newspic 类型必填 | 图片列表，`{ "list": [...] }`，最多 20 张 |

package/bin/wxpost-server.js

@@ -2,6 +2,22 @@
 
 'use strict';
 
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(`
+Usage: wxpost-server [--port <n>]
+
+Options:
+  --port <n>   监听端口（优先级高于配置文件和 PORT 环境变量）
+  --help, -h   显示帮助
+
+首次运行会自动在 ~/.@rongyan/env.json 创建配置模板。
+配置文件路径：~/.@rongyan/env.json
+`);
+  process.exit(0);
+}
+
 const { startServer } = require('../src/index.js');
 
 // 解析 --port <n> 或 --port=<n>
@@ -14,5 +30,5 @@ function parsePort(args) {
   return null;
 }
 
-const cliPort = parsePort(process.argv.slice(2));
+const cliPort = parsePort(args);
 startServer({ port: cliPort });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rongyan/wxpost-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "微信公众号内容发布服务，支持多账号，提供图片上传、草稿管理和发布等 HTTP 接口",
   "main": "src/index.js",
   "bin": {
@@ -9,6 +9,7 @@
   "files": [
     "bin",
     "src",
+    "images",
     "README.md"
   ],
   "scripts": {

package/src/draft.js

@@ -36,10 +36,9 @@ function validateArticle(a, idx) {
     if (a.digest.length > 128) return `${p}.digest 最多 128 字，当前 ${a.digest.length} 字`;
   }
 
-  // content：必填，最多 2 万字
+  // content：必填
   if (!a.content) return `${p}.content 必填`;
   if (typeof a.content !== 'string') return `${p}.content 须为字符串`;
-  if (a.content.length > 20000) return `${p}.content 最多 2 万字，当前 ${a.content.length} 字`;
 
   // content_source_url：选填
   if (a.content_source_url !== undefined && typeof a.content_source_url !== 'string') {

package/src/index.js

@@ -14,7 +14,7 @@ const { addImageMaterial, MAX_SIZE: MATERIAL_MAX_SIZE } = require('./material');
 const { checkApiKey } = require('./auth');
 const logger = require('./logger');
 
-const BODY_LIMIT = 2 * 1024 * 1024; // 2MB
+const BODY_LIMIT = 20 * 1024 * 1024; // 20MB，正文富文本可能较大，具体长度由微信 API 判定
 
 function sendJSON(res, statusCode, data) {
   if (statusCode >= 400 && data.error) res._logError = data.error;
@@ -80,7 +80,8 @@ function receiveFile(req, res, account, sizeLimit, processor, sizeLimitLabel) {
   let settled = false;
 
   bb.on('file', (_fieldname, stream, info) => {
-    const { filename } = info;
+    // busboy 以 binary 解析 multipart filename，需还原为 UTF-8
+    const filename = Buffer.from(info.filename, 'binary').toString('utf-8');
     const chunks = [];
 
     stream.on('data', (chunk) => chunks.push(chunk));

package/src/logger.js

@@ -32,7 +32,7 @@ function getStream() {
   }
 
   const logFile = path.join(_logDir, `${today}.log`);
-  _stream = fs.createWriteStream(logFile, { flags: 'a', encoding: 'utf-8' });
+  _stream = fs.createWriteStream(logFile, { flags: 'a' });
   _stream.on('error', () => {
     // 写文件出错（如磁盘满）时重置 stream，下次重试创建；不崩进程
     _stream = null;
@@ -62,14 +62,19 @@ function pruneOldLogs(logDir) {
   }
 }
 
+function formatLocalTime(d) {
+  const pad2 = (n) => String(n).padStart(2, '0');
+  const pad3 = (n) => String(n).padStart(3, '0');
+  return `${d.getFullYear()}-${pad2(d.getMonth() + 1)}-${pad2(d.getDate())} ` +
+         `${pad2(d.getHours())}:${pad2(d.getMinutes())}:${pad2(d.getSeconds())}.${pad3(d.getMilliseconds())}`;
+}
+
 function write(level, message) {
-  const now = new Date();
-  const ts = now.toISOString().replace('T', ' ').slice(0, 23);
-  const line = `[${ts}] [${level}] ${message}\n`;
-  process.stdout.write(line);
+  const line = `[${formatLocalTime(new Date())}] [${level}] ${message}\n`;
+  process.stdout.write(Buffer.from(line, 'utf-8'));
   try {
     const stream = getStream();
-    if (stream) stream.write(line);
+    if (stream) stream.write(Buffer.from(line, 'utf-8'));
   } catch {
     // 写文件失败不影响主流程
   }