yaohao 1.0.0

package/src/lib/notifier.js

@@ -0,0 +1,190 @@
+import { createHmac } from 'crypto';
+
+/**
+ * Parse a notify URL into scheme and path.
+ * @param {string} url
+ * @returns {{ scheme: string, path: string } | null}
+ */
+function parseNotifyUrl(url) {
+  const m = url.match(/^(\w+):\/\/(.+)$/);
+  if (!m) return null;
+  return { scheme: m[1], path: m[2] };
+}
+
+// ── Channel handlers ────────────────────────────────────────────────
+
+async function sendBark(path, title, body) {
+  // bark://<key> (default server) or bark://<server>/<key>
+  const parts = path.split('/');
+  let server, key;
+  if (parts.length === 1) {
+    server = 'api.day.app';
+    key = parts[0];
+  } else {
+    server = parts[0];
+    key = parts.slice(1).join('/');
+  }
+  const url = `https://${server}/${key}/${encodeURIComponent(title)}/${encodeURIComponent(body)}`;
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`Bark HTTP ${res.status}`);
+}
+
+async function sendTelegram(path, title, body) {
+  // tgram://<bot_token>/<chat_id>
+  const idx = path.lastIndexOf('/');
+  if (idx === -1) throw new Error('Invalid Telegram URL: missing chat_id');
+  const token = path.slice(0, idx);
+  const chatId = path.slice(idx + 1);
+  const url = `https://api.telegram.org/bot${token}/sendMessage`;
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      chat_id: chatId,
+      text: `*${title}*\n${body}`,
+      parse_mode: 'Markdown',
+    }),
+  });
+  if (!res.ok) throw new Error(`Telegram HTTP ${res.status}`);
+}
+
+async function sendDingTalk(path, title, body) {
+  // dingtalk://<access_token>[/<secret>]
+  const parts = path.split('/');
+  const token = parts[0];
+  const secret = parts[1];
+  let url = `https://oapi.dingtalk.com/robot/send?access_token=${token}`;
+  if (secret) {
+    const ts = Date.now();
+    const stringToSign = `${ts}\n${secret}`;
+    const sign = encodeURIComponent(
+      createHmac('sha256', secret).update(stringToSign).digest('base64'),
+    );
+    url += `&timestamp=${ts}&sign=${sign}`;
+  }
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ msgtype: 'text', text: { content: `${title}\n${body}` } }),
+  });
+  if (!res.ok) throw new Error(`DingTalk HTTP ${res.status}`);
+}
+
+async function sendWeCom(path, title, body) {
+  // wecom://<key>
+  const key = path;
+  const url = `https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=${key}`;
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ msgtype: 'text', text: { content: `${title}\n${body}` } }),
+  });
+  if (!res.ok) throw new Error(`WeCom HTTP ${res.status}`);
+}
+
+async function sendFeishu(path, title, body) {
+  // feishu://<hook_id>[/<secret>]
+  const parts = path.split('/');
+  const hookId = parts[0];
+  const secret = parts[1];
+  const url = `https://open.feishu.cn/open-apis/bot/v2/hook/${hookId}`;
+  const payload = {
+    msg_type: 'text',
+    content: { text: `${title}\n${body}` },
+  };
+  if (secret) {
+    const timestamp = Math.floor(Date.now() / 1000).toString();
+    const stringToSign = `${timestamp}\n${secret}`;
+    const sign = createHmac('sha256', stringToSign).update(Buffer.alloc(0)).digest('base64');
+    payload.timestamp = timestamp;
+    payload.sign = sign;
+  }
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify(payload),
+  });
+  if (!res.ok) throw new Error(`Feishu HTTP ${res.status}`);
+}
+
+async function sendSlack(path, title, body) {
+  // slack://<T>/<B>/<token>
+  const url = `https://hooks.slack.com/services/${path}`;
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ text: `*${title}*\n${body}` }),
+  });
+  if (!res.ok) throw new Error(`Slack HTTP ${res.status}`);
+}
+
+async function sendJson(path, title, body) {
+  // json://<host>/<path>
+  const idx = path.indexOf('/');
+  const host = idx === -1 ? path : path.slice(0, idx);
+  const urlPath = idx === -1 ? '' : path.slice(idx);
+  const url = `https://${host}${urlPath}`;
+  const res = await fetch(url, {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({ title, body }),
+  });
+  if (!res.ok) throw new Error(`Webhook HTTP ${res.status}`);
+}
+
+// ── Dispatcher ──────────────────────────────────────────────────────
+
+const handlers = {
+  bark: sendBark,
+  barks: sendBark,       // apprise 兼容：barks:// = bark:// over HTTPS
+  tgram: sendTelegram,
+  dingtalk: sendDingTalk,
+  wecom: sendWeCom,
+  feishu: sendFeishu,
+  slack: sendSlack,
+  json: sendJson,
+};
+
+/**
+ * Send a notification to all configured URLs.
+ * Best-effort: errors are logged but never thrown.
+ *
+ * @param {string[]} urls  Notification URLs (e.g. ["bark://key", "tgram://token/chatid"])
+ * @param {string}   title Notification title
+ * @param {string}   body  Notification body
+ * @returns {Promise<PromiseSettledResult[]>}
+ */
+export async function notify(urls, title, body) {
+  if (!urls || urls.length === 0) return [];
+
+  const tasks = urls.map(async (url) => {
+    const parsed = parseNotifyUrl(url);
+    if (!parsed) {
+      console.error(`[notifier] invalid URL: ${url}`);
+      throw new Error(`Invalid notify URL: ${url}`);
+    }
+    const handler = handlers[parsed.scheme];
+    if (!handler) {
+      console.error(`[notifier] unsupported scheme: ${parsed.scheme}`);
+      throw new Error(`Unsupported notify scheme: ${parsed.scheme}`);
+    }
+    try {
+      await handler(parsed.path, title, body);
+    } catch (err) {
+      console.error(`[notifier] ${parsed.scheme} failed:`, err.message);
+      throw err;
+    }
+  });
+
+  return Promise.allSettled(tasks);
+}
+
+/**
+ * Send a test notification to all configured URLs.
+ *
+ * @param {string[]} urls  Notification URLs
+ * @returns {Promise<PromiseSettledResult[]>}
+ */
+export async function testNotify(urls) {
+  return notify(urls, '测试通知 / Test Notification', '如果你看到这条消息，说明通知配置正确。');
+}

package/src/output.js

@@ -0,0 +1,15 @@
+export function output(data) {
+  if (data.success === false) {
+    console.error(`错误: ${data.message}`);
+  } else {
+    console.log(data.message || '');
+  }
+}
+
+export function success(data, message) {
+  return { success: true, data, message };
+}
+
+export function error(message, data = null) {
+  return { success: false, data, message };
+}

package/src/source/_shared/crawl.js

@@ -0,0 +1,169 @@
+// 通用公告站抓取层：负责 HTTP 请求、编码处理、本地缓存。
+// 适配国内多个政府摇号系统，部分站点使用老版 TLS 配置，需放宽 SSL 选项。
+
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { homedir } from 'node:os';
+import { Agent, setGlobalDispatcher } from 'undici';
+
+// 政府站普遍存在的两个 SSL 问题：
+//  1) 证书链不完整（如深圳）→ rejectUnauthorized: false
+//  2) 不支持安全重协商（如杭州）→ SSL_OP_LEGACY_SERVER_CONNECT (0x4)
+//
+// 仅用于抓取公开公告页面，不影响安全性。
+setGlobalDispatcher(new Agent({
+  connect: {
+    rejectUnauthorized: false,
+    secureOptions: crypto.constants.SSL_OP_LEGACY_SERVER_CONNECT,
+  },
+}));
+
+const DEFAULT_HEADERS = {
+  'User-Agent':
+    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 ' +
+    '(KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36',
+  Accept:
+    'text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8',
+  'Accept-Language': 'zh-CN,zh;q=0.9,en;q=0.8',
+};
+
+const CACHE_DIR = path.join(homedir(), '.yaohao', 'cache');
+
+/**
+ * 抓取一个 URL，返回 { url, status, html, contentType, fromCache, elapsedMs }
+ *
+ * @param {string} url
+ * @param {object} [opts]
+ * @param {boolean} [opts.useCache=true]  本地缓存，避免反复打官网
+ * @param {number}  [opts.timeoutMs=15000]
+ * @param {number}  [opts.retries=2]
+ * @param {number}  [opts.maxCacheAgeMs] 缓存最大有效期（毫秒），默认无限
+ */
+export async function fetchHtml(url, opts = {}) {
+  const { useCache = true, timeoutMs = 15000, retries = 2, maxCacheAgeMs } = opts;
+
+  if (useCache) {
+    const cached = await readCache(url, maxCacheAgeMs);
+    if (cached) {
+      return { ...cached, fromCache: true };
+    }
+  }
+
+  let lastErr = null;
+  for (let attempt = 0; attempt <= retries; attempt++) {
+    const t0 = Date.now();
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    try {
+      const res = await fetch(url, {
+        headers: DEFAULT_HEADERS,
+        signal: ac.signal,
+        redirect: 'follow',
+      });
+      const contentType = res.headers.get('content-type') || '';
+      const buf = Buffer.from(await res.arrayBuffer());
+      const html = decode(buf, contentType);
+      const elapsedMs = Date.now() - t0;
+      const payload = {
+        url,
+        status: res.status,
+        contentType,
+        html,
+        elapsedMs,
+        fromCache: false,
+        savedAt: Date.now(),
+      };
+      if (useCache && res.status === 200) {
+        await writeCache(url, payload);
+      }
+      return payload;
+    } catch (err) {
+      lastErr = err;
+      if (attempt < retries) {
+        await sleep(500 * (attempt + 1));
+      }
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  throw new Error(`fetchHtml(${url}) failed after ${retries + 1} tries: ${lastErr?.message || lastErr}`);
+}
+
+/**
+ * 抓取一个二进制资源（PDF 等），返回 { url, status, buffer }。
+ * 走单独缓存目录 ~/.yaohao/cache/pdf/，按 url sha1 命名。
+ */
+export async function fetchBinary(url, opts = {}) {
+  const { useCache = true, timeoutMs = 30000 } = opts;
+  const pdfDir = path.join(CACHE_DIR, 'binary');
+  await fs.mkdir(pdfDir, { recursive: true });
+  const file = path.join(pdfDir, crypto.createHash('sha1').update(url).digest('hex') + path.extname(url));
+
+  if (useCache) {
+    try {
+      const buf = await fs.readFile(file);
+      return { url, status: 200, buffer: buf, fromCache: true };
+    } catch {
+      /* miss */
+    }
+  }
+
+  const ac = new AbortController();
+  const timer = setTimeout(() => ac.abort(), timeoutMs);
+  try {
+    const res = await fetch(url, { headers: DEFAULT_HEADERS, signal: ac.signal });
+    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+    const buf = Buffer.from(await res.arrayBuffer());
+    await fs.writeFile(file, buf);
+    return { url, status: res.status, buffer: buf, fromCache: false };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+function decode(buf, contentType) {
+  let charset = 'utf-8';
+  const m = /charset=([\w-]+)/i.exec(contentType);
+  if (m) charset = m[1].toLowerCase();
+  const head = buf.slice(0, 1024).toString('ascii');
+  const metaMatch = /charset=["']?([\w-]+)/i.exec(head);
+  if (metaMatch) charset = metaMatch[1].toLowerCase();
+
+  if (charset === 'utf-8' || charset === 'utf8') {
+    return buf.toString('utf8');
+  }
+  try {
+    return new TextDecoder(charset).decode(buf);
+  } catch {
+    return buf.toString('utf8');
+  }
+}
+
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+function cacheKey(url) {
+  return crypto.createHash('sha1').update(url).digest('hex') + '.json';
+}
+
+async function readCache(url, maxAgeMs) {
+  try {
+    const file = path.join(CACHE_DIR, cacheKey(url));
+    const raw = await fs.readFile(file, 'utf8');
+    const payload = JSON.parse(raw);
+    if (maxAgeMs && payload.savedAt && Date.now() - payload.savedAt > maxAgeMs) {
+      return null;
+    }
+    return payload;
+  } catch {
+    return null;
+  }
+}
+
+async function writeCache(url, payload) {
+  await fs.mkdir(CACHE_DIR, { recursive: true });
+  const file = path.join(CACHE_DIR, cacheKey(url));
+  await fs.writeFile(file, JSON.stringify(payload), 'utf8');
+}

package/src/source/_shared/parseUtils.js

@@ -0,0 +1,141 @@
+// 通用 HTML 解析工具：所有城市 source 共用
+
+export function stripTags(html) {
+  if (!html) return '';
+  let s = html.replace(/<script[\s\S]*?<\/script>/gi, '')
+              .replace(/<style[\s\S]*?<\/style>/gi, '');
+  s = s.replace(/<br\s*\/?>/gi, '\n');
+  s = s.replace(/<[^>]+>/g, '');
+  s = s.replace(/&nbsp;/g, ' ')
+       .replace(/&amp;/g, '&')
+       .replace(/&lt;/g, '<')
+       .replace(/&gt;/g, '>')
+       .replace(/&quot;/g, '"')
+       .replace(/&ldquo;|&rdquo;/g, '"')
+       .replace(/&lsquo;|&rsquo;/g, "'")
+       .replace(/&#(\d+);/g, (_, n) => String.fromCodePoint(Number(n)));
+  s = s.replace(/[ \t]+/g, ' ')
+       .replace(/\n\s*\n+/g, '\n')
+       .trim();
+  return s;
+}
+
+export function normalizeNumberLike(s) {
+  return s
+    .replace(/[０-９]/g, (c) => String.fromCharCode(c.charCodeAt(0) - 0xfee0))
+    .replace(/[，]/g, ',')
+    .replace(/[．]/g, '.')
+    .replace(/[％]/g, '%');
+}
+
+export function num(s) {
+  return Number(String(s).replace(/,/g, ''));
+}
+
+export function cnDateToIso(s) {
+  const m = /(\d{4})年(\d{1,2})月(\d{1,2})日/.exec(s);
+  if (!m) return null;
+  return `${m[1]}-${m[2].padStart(2, '0')}-${m[3].padStart(2, '0')}`;
+}
+
+export function isoFromUrlPath(url) {
+  // 从 URL 路径如 /20260511/ 或 /202657/ 抽日期
+  const m = /\/(\d{4})(\d{1,2})(\d{1,2})\//.exec(url);
+  if (!m) return null;
+  return `${m[1]}-${m[2].padStart(2, '0')}-${m[3].padStart(2, '0')}`;
+}
+
+export function absUrl(href, base) {
+  if (!href) return href;
+  if (/^https?:\/\//i.test(href)) return href;
+  try {
+    return new URL(href, base).toString();
+  } catch {
+    return href;
+  }
+}
+
+// 标题里的"YYYY 年第 N 期" / "YYYY 年 M 月" 期号
+export function extractPeriod(title) {
+  // "2025 年第 2 期" 格式
+  let m = /(20\d{2})年(?:第)?\s*([一二三四五六七八九十0-9]+)\s*期/.exec(title);
+  if (m) {
+    const cnNum = { 一: 1, 二: 2, 三: 3, 四: 4, 五: 5, 六: 6, 七: 7, 八: 8, 九: 9, 十: 10 };
+    const year = Number(m[1]);
+    const rawNo = m[2];
+    const no = /^\d+$/.test(rawNo) ? Number(rawNo) : cnNum[rawNo] ?? null;
+    if (no != null) return { year, no, label: `${year}年第${no}期`, kind: 'period' };
+  }
+  // "2026 年 5 月" 格式
+  m = /(20\d{2})年\s*([0-9]+)\s*月/.exec(title);
+  if (m) {
+    const year = Number(m[1]);
+    const month = Number(m[2]);
+    return { year, month, label: `${year}年${month}月`, kind: 'month' };
+  }
+  return null;
+}
+
+// 通用字段抽取：能识别尽量多的关键数字字段，找不到的留 undefined
+export function extractMetricsFromText(rawText) {
+  const text = normalizeNumberLike(rawText.replace(/\s+/g, ' '));
+  const r = {};
+
+  // 北京风格：申请有效编码
+  let m = /家庭普通小客车指标申请共?计?\s*([\d,]+)\s*个?有效编码/.exec(text);
+  if (m) r.familyApplyCount = num(m[1]);
+  m = /个人普通小客车指标申请共?计?\s*([\d,]+)\s*个?有效编码/.exec(text);
+  if (m) r.personalApplyCount = num(m[1]);
+  m = /单位普通小客车指标申请共?计?\s*([\d,]+)\s*家/.exec(text);
+  if (m) r.unitApplyCount = num(m[1]);
+
+  // 北京风格：配置数
+  m = /家庭(?:和|与)个人普通小客车指标共?计?\s*([\d,]+)\s*个/.exec(text);
+  if (m) r.familyPersonAlloc = num(m[1]);
+  m = /配置单位普通小客车指标\s*([\d,]+)\s*个/.exec(text);
+  if (m) r.unitAlloc = num(m[1]);
+
+  // 配置数（PDF 通用：广深杭都用这个表述）
+  m = /有效编码总数[：:]\s*([\d,]+)/.exec(text);
+  if (m) r.validEncodeCount = num(m[1]);
+  m = /基数序号总数[：:]\s*([\d,]+)/.exec(text);
+  if (m) r.baseSeedTotal = num(m[1]);
+  m = /指标配置总数[：:]\s*([\d,]+)/.exec(text);
+  if (m) r.allocTotal = num(m[1]);
+  m = /指标配置种子数[：:]\s*([\d,]+)/.exec(text);
+  if (m) r.randomSeed = num(m[1]);
+
+  // 通用：配置指标数（广深杭"普通车增量指标 / 普通小汽车增量指标 X 个"）
+  m = /配置(?:普通车|普通小汽车|增量)?指标\s*([\d,]+)\s*个/.exec(text);
+  if (m) r.totalAlloc = num(m[1]);
+  m = /(?:个人指标|个人增量指标)\s*([\d,]+)\s*个/.exec(text);
+  if (m) r.personalAlloc = num(m[1]);
+  m = /(?:单位指标|单位增量指标)\s*([\d,]+)\s*个/.exec(text);
+  if (m) r.unitAllocNum = num(m[1]);
+
+  // 通用：摇号方式 / 竞价方式
+  m = /(?:以)?摇号方式配置\s*([\d,]+)\s*个/.exec(text);
+  if (m) r.lotteryAlloc = num(m[1]);
+  m = /(?:以)?竞价方式配置\s*([\d,]+)\s*个/.exec(text);
+  if (m) r.biddingAlloc = num(m[1]);
+
+  // 中签率（明示）
+  m = /个人(?:普通(?:小客车)?指标)?中签率(?:约)?(?:为|是|:|：)?\s*([\d.]+%|1[/／]\d+)/.exec(text);
+  if (m) r.personalRate = m[1];
+  m = /单位(?:普通(?:小客车)?指标)?中签率(?:约)?(?:为|是|:|：)?\s*([\d.]+%|1[/／]\d+)/.exec(text);
+  if (m) r.unitRate = m[1];
+
+  // 家庭最低中签积分（北京）
+  m = /家庭(?:摇号)?(?:最低)?中签(?:家庭)?(?:积分|分值)(?:为|是|:|：)\s*([\d.]+)/.exec(text);
+  if (m) r.familyMinScore = Number(m[1]);
+
+  // 新能源排队
+  m = /新能源(?:小客车)?指标(?:轮候|排队)(?:.*?)(?:约|预计)?\s*([\d.]+)\s*年/.exec(text);
+  if (m) r.nevWaitYears = Number(m[1]);
+
+  // 失信被执行人
+  m = /共有\s*([\d,]+)\s*个失信被执行人/.exec(text);
+  if (m) r.blackListCount = num(m[1]);
+
+  return r;
+}

package/src/source/_shared/titleClassify.js

@@ -0,0 +1,30 @@
+// 通用标题分类：从公告标题判断类型
+// 不同城市的公告分类大同小异：摇号结果 / 配置数量 / 资格审核 / 政策处罚 / 阶梯统计 等
+
+export function classifyTitle(t) {
+  // 处罚类
+  if (/买卖|出租|承租|出借|借用/.test(t)) return 'penalty';
+  // 摇号结果
+  if (/摇号(?:配置)?结果|摇号结果公告|配置结果/.test(t)) return 'result';
+  // 配置数量通告
+  if (/配置数量|增量指标配置数量|配置工作有关事项/.test(t)) return 'config_notice';
+  // 申请审核结果
+  if (/申请审核结果和配置工作/.test(t)) return 'config_notice';
+  // 资格审核结果
+  if (/资格审核结果/.test(t)) return 'qualify_review';
+  // 摇号公告（待摇号）
+  if (/摇号公告|增量指标摇号公告/.test(t)) return 'lottery_notice';
+  // 竞价
+  if (/竞价(?:情况|公告|的通告)?/.test(t)) return 'bidding';
+  // 阶梯分布统计
+  if (/阶梯分布统计|阶梯摇号/.test(t)) return 'tier_stats';
+  // 家庭核查（北京）
+  if (/亲属关系和婚姻状况核查/.test(t)) return 'family_check';
+  // 年度配额
+  if (/指标配额|指标调控管理办法/.test(t)) return 'quota';
+  // FAQ / 解读
+  if (/十问十答|温馨提示|解读/.test(t)) return 'faq';
+  // 日历
+  if (/竞价日历|摇号日历/.test(t)) return 'calendar_notice';
+  return 'other';
+}

package/src/source/beijing/calendar.js

@@ -0,0 +1,65 @@
+// 北京小客车摇号关键日历（按往年节奏推断，年度更新由发版承担）
+// 上半年申请窗口: 1/1 - 3/8
+// 上半年资格审核结果公布: 4 月上旬
+// 上半年摇号: 4 月下旬
+// 下半年申请窗口: 8/1 - 10/8
+// 下半年资格审核结果公布: 12 月中旬
+// 下半年摇号: 12 月下旬
+
+const SCHEDULE = {
+  2026: [
+    { event: '上半年申请窗口开放', start: '2026-01-01', end: '2026-03-08' },
+    { event: '上半年资格审核结果公布', date: '2026-04-08' },
+    { event: '上半年摇号日', date: '2026-04-26' },
+    { event: '下半年申请窗口开放', start: '2026-08-01', end: '2026-10-08' },
+    { event: '下半年资格审核结果公布', date: '2026-12-08' },
+    { event: '下半年摇号日', date: '2026-12-26' },
+  ],
+};
+
+function daysBetween(from, to) {
+  const a = new Date(from); a.setHours(0, 0, 0, 0);
+  const b = new Date(to); b.setHours(0, 0, 0, 0);
+  return Math.round((b - a) / (1000 * 60 * 60 * 24));
+}
+
+function formatEvent(e, today) {
+  const range = e.date ? e.date : `${e.start} 至 ${e.end}`;
+  let status;
+  if (e.date) {
+    const days = daysBetween(today, e.date);
+    if (days > 0) status = `还有 ${days} 天`;
+    else if (days === 0) status = '就在今天';
+    else status = `已过 ${-days} 天`;
+  } else {
+    const dStart = daysBetween(today, e.start);
+    const dEnd = daysBetween(today, e.end);
+    if (dStart > 0) status = `${dStart} 天后开放`;
+    else if (dEnd >= 0) status = `进行中，剩 ${dEnd} 天`;
+    else status = `已结束 ${-dEnd} 天`;
+  }
+  return { range, event: e.event, status };
+}
+
+export function getCalendar(year) {
+  const y = year || new Date().getFullYear();
+  const schedule = SCHEDULE[y];
+  if (!schedule) {
+    return {
+      year: y,
+      available: Object.keys(SCHEDULE).map(Number),
+      schedule: [],
+      lines: [`暂无 ${y} 年日历，目前支持: ${Object.keys(SCHEDULE).join(', ')}`],
+    };
+  }
+  const today = new Date();
+  const todayStr = `${today.getFullYear()}-${String(today.getMonth()+1).padStart(2,'0')}-${String(today.getDate()).padStart(2,'0')}`;
+  const items = schedule.map((e) => formatEvent(e, today));
+  const lines = [`北京小客车摇号 ${y} 年关键日历（今天 ${todayStr}）:`, ''];
+  for (const it of items) {
+    lines.push(`  ${it.range.padEnd(28)}  ${it.event}  [${it.status}]`);
+  }
+  lines.push('');
+  lines.push('注：日期按往年节奏推断，以官方公告为准。建议配合 `yaohao watch window` 订阅窗口开放推送。');
+  return { year: y, today: todayStr, schedule: items, lines };
+}

package/src/source/beijing/constants.js

@@ -0,0 +1,8 @@
+// 北京小客车摇号系统 URL 常量
+export const SYSTEM_URL = 'https://xkczb.jtw.beijing.gov.cn/';
+
+export const URLS = {
+  announceList: 'https://xkczb.jtw.beijing.gov.cn/jggb/index.html',
+  policyList: 'https://xkczb.jtw.beijing.gov.cn/xwzz/index.html',
+  guideList: 'https://xkczb.jtw.beijing.gov.cn/bszn/index.html',
+};