wangka-helper 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,64 @@
-# Temporary Holding Version
+# wangka — 王卡十周年活动面板
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+## 安装运行
+
+```bash
+# 全局安装
+npm install -g wangka-helper
+wangka
+
+# 或直接跑，不装
+npx wangka-helper
+```
+
+打开 http://127.0.0.1:8765
+
+要求在 Node 18 及以上。**短信登录需要 Node 22.22+ 或 24.15+**（jsdom 30 的限制），
+低于这个版本只能用 KSESSIONID 导入。
+
+## 参数
+
+```bash
+wangka --port 9000              # 换端口
+wangka --host 0.0.0.0           # 对外监听（面板无密码，注意风险）
+wangka --data-dir ~/.wangka     # 账号与日志目录，默认当前目录
+wangka --lock-hour 10 --lock-minute 0
+wangka --lock-retry 1           # 锁定失败补发次数
+wangka --no-auto-lock           # 只保留手动锁定
+```
+
+## 数据文件
+
+都在 `--data-dir` 下：
+
+| 文件 | 内容 |
+|---|---|
+| `accounts.json` | 账号 Cookie + 每账号的锁定目标（权限 600） |
+| `logs/autolock-*.jsonl` | 每次锁定一行一个账号 |
+| `logs/lockdetail-*.json` | 同上，附带完整请求/响应，便于排查 |
+
+`accounts.json` 是明文登录凭据，等同账号密码，不要提交到仓库或共享目录。
+
+## 登录
+
+两种方式：
+
+1. **短信登录** —— 填手机号 → 发验证码 → 填验证码。发码要先过腾讯防水墙，用 jsdom 跑官方脚本取票，约 2 秒。
+2. **导入 KSESSIONID** —— 浏览器登录 txwk.10010.com 后，从 Cookie 复制 `KSESSIONID` 粘进来。
+
+## 会员锁定
+
+充值活动（充值送会员）里，`chargePre` 会把当前账号锁定到某个会员上，**锁 2 小时，期间不能更换**，也不会自动扣款充值。
+
+- **目标按账号独立设置**，选中账号后在下拉里改，立即写入 `accounts.json`
+- **自动锁定开关是全局的**
+- 定时器每天 10:00（UTC+8）执行：提前 20 秒预取各账号的 `giftCode`，准点只发 `chargePre`，不额外查询
+
+每个账号用自己配置的会员，不同账号可以锁不同会员。
+
+## 开发
+
+```bash
+npm install
+node bin/wangka.js
+```

package/bin/wangka.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+// wangka —— 王卡十周年活动面板
+import path from 'node:path';
+import os from 'node:os';
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { AccountStore } from '../src/store.js';
+import { AutoLocker } from '../src/locker.js';
+import { createServer } from '../src/server.js';
+import { assertNotExpired } from '../src/license.js';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const pkgRoot = path.resolve(__dirname, '..');
+
+function parseArgs(argv) {
+  const out = { host: '127.0.0.1', port: 8765, dataDir: process.cwd(), hour: 10, minute: 0, retry: 1, autoLock: true, importVerify: true };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    const next = () => argv[++i];
+    if (a === '--host') out.host = next();
+    else if (a === '--port') out.port = Number(next());
+    else if (a === '--data-dir') out.dataDir = path.resolve(next());
+    else if (a === '--lock-hour') out.hour = Number(next());
+    else if (a === '--lock-minute') out.minute = Number(next());
+    else if (a === '--lock-retry') out.retry = Number(next());
+    else if (a === '--no-auto-lock') out.autoLock = false;
+    else if (a === '--import') out.importFile = path.resolve(next());
+    else if (a === '--import-no-verify') { out.importFile = path.resolve(next()); out.importVerify = false; }
+    else if (a === '--help' || a === '-h') out.help = true;
+    else if (a === '--version' || a === '-v') out.version = true;
+  }
+  return out;
+}
+
+const args = parseArgs(process.argv.slice(2));
+
+if (args.help) {
+  console.log(`wangka —— 王卡十周年活动面板
+
+用法: wangka [选项]
+
+  --port <n>          监听端口（默认 8765）
+  --host <ip>         监听地址（默认 127.0.0.1）
+  --data-dir <dir>    账号与日志目录（默认当前目录）
+  --lock-hour <h>     自动锁定小时（默认 10，UTC+8）
+  --lock-minute <m>   自动锁定分钟（默认 0）
+  --lock-retry <n>    失败补发次数（默认 1）
+  --no-auto-lock      只保留手动锁定
+  --import <file>     启动前导入账号文件（兼容 python 版 .accounts.json）
+  --import-no-verify  导入时不验证会话（更快，但可能带入失效账号）
+  -h, --help          显示帮助
+  -v, --version       显示版本
+`);
+  process.exit(0);
+}
+if (args.version) {
+  const pkg = JSON.parse(fs.readFileSync(path.join(pkgRoot, 'package.json'), 'utf8'));
+  console.log(pkg.version);
+  process.exit(0);
+}
+
+fs.mkdirSync(args.dataDir, { recursive: true });
+const store = new AccountStore(path.join(args.dataDir, 'accounts.json'));
+const locker = new AutoLocker({
+  store,
+  logDir: path.join(args.dataDir, 'logs'),
+  hour: args.hour,
+  minute: args.minute,
+  retry: args.retry,
+});
+locker.enabled = args.autoLock;
+
+// 账号导入：--import 显式指定，否则自动找 python 版账号文件
+const needImport = async (file, verify) => {
+  const { importAccounts } = await import('../src/import.js');
+  console.log(`导入账号：${file}`);
+  const r = await importAccounts({ fromFile: file, store, verify });
+  console.log(`  成功 ${r.imported} 个`);
+  if (r.invalid.length) {
+    console.log(`  失效 ${r.invalid.length} 个：${r.invalid.map((x) => x.display).join('、')}`);
+  }
+};
+
+let pendingImport = null;
+if (args.importFile) {
+  if (!fs.existsSync(args.importFile)) {
+    console.error(`找不到文件：${args.importFile}`);
+    process.exit(1);
+  }
+  pendingImport = [args.importFile, args.importVerify];
+} else if (!store.all().length) {
+  const candidates = [
+    path.join(args.dataDir, 'app', '.accounts.json'),
+    path.join(args.dataDir, '..', 'app', '.accounts.json'),
+    path.join(pkgRoot, '..', 'app', '.accounts.json'),
+    path.join(process.cwd(), 'app', '.accounts.json'),
+    path.join(args.dataDir, '.accounts.json'),
+  ];
+  const found = candidates.find((f) => fs.existsSync(f));
+  if (found) pendingImport = [found, true];
+}
+
+// 运行期校验：只认网络时间，不看本机时钟
+let license;
+try {
+  license = await assertNotExpired();
+} catch (e) {
+  console.error(`\n[${e.code || 'ERR'}] ${e.message}`);
+  if (e.networkTime) console.error(`网络时间：${e.networkTime}`);
+  process.exit(1);
+}
+
+const server = createServer({ baseDir: pkgRoot, store, locker });
+
+if (pendingImport) {
+  await needImport(pendingImport[0], pendingImport[1]);
+}
+
+server.listen(args.port, args.host, () => {
+  console.log(`王卡助手面板: http://${args.host}:${args.port}`);
+  console.log(`数据目录: ${args.dataDir}（已载入 ${store.all().length} 个账号）`);
+  console.log(`活动时间剩余: ${license.remainText}`);
+  if (locker.enabled) {
+    locker.start();
+    const detail = locker.status().accounts.map((a) => `${a.display}→${a.targetName}`).join('、') || '无账号';
+    console.log(`自动锁定: 每天 ${String(args.hour).padStart(2, '0')}:${String(args.minute).padStart(2, '0')} (UTC+8) | ${detail}`);
+  } else {
+    console.log('自动锁定: 已禁用（仅手动）');
+  }
+});
+
+const bye = () => { locker.stop(); server.close(() => process.exit(0)); setTimeout(() => process.exit(0), 500); };
+process.on('SIGINT', bye);
+process.on('SIGTERM', bye);

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "wangka-helper",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "王卡十周年活动面板：登录、签到、抽奖、中奖记录、10:00 定点锁定会员",
+  "type": "module",
+  "bin": {
+    "wangka": "./bin/wangka.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "jsdom": "^30.1.3"
+  },
+  "files": [
+    "bin",
+    "src",
+    "public"
+  ],
+  "scripts": {
+    "start": "node bin/wangka.js"
+  },
+  "keywords": [
+    "wangka",
+    "10010",
+    "unicom",
+    "lottery"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "local"
+  }
+}