yaohao 1.0.0

package/src/source/beijing/service.js

@@ -0,0 +1,190 @@
+// 北京摇号公告抓取 + 形势数据汇总
+import { fetchHtml } from './crawl.js';
+import { parseListPage, parseDetailPage } from './parse.js';
+import { extractPdfMetrics } from './pdfExtract.js';
+import { URLS } from './constants.js';
+
+// market 命令：抓最近一期 config_notice + 两个 result PDF，输出形势数据
+export async function extractMarketMetrics(opts = {}) {
+  const useCache = opts.cache !== false;
+  const withPdf = opts.pdf !== false;
+
+  const listPage = await fetchHtml(URLS.announceList, {
+    useCache,
+    maxCacheAgeMs: 5 * 60 * 1000,
+  });
+  const items = parseListPage(listPage.html, URLS.announceList);
+
+  const cfg = items.find((i) => i.kind === 'config_notice');
+  if (!cfg) {
+    return {
+      ok: false,
+      error: '未找到"申请审核结果和配置工作"通告',
+      lines: ['错误：未找到"申请审核结果和配置工作"通告'],
+    };
+  }
+
+  const cfgDetail = parseDetailPage(
+    (await fetchHtml(cfg.url, { useCache })).html,
+    cfg.url,
+  );
+  const cfgM = cfgDetail.metrics;
+
+  const periodLabel = cfg.period?.label;
+  const results = items.filter(
+    (i) => i.kind === 'result' && i.period?.label === periodLabel,
+  );
+  const familyPersonResult = results.find((r) => /家庭和个人/.test(r.title));
+  const unitResult = results.find((r) => /单位/.test(r.title));
+
+  let familyPersonPdf = null;
+  let unitPdf = null;
+  let familyPersonPdfM = {};
+  let unitPdfM = {};
+
+  if (familyPersonResult) {
+    const d = parseDetailPage(
+      (await fetchHtml(familyPersonResult.url, { useCache })).html,
+      familyPersonResult.url,
+    );
+    familyPersonPdf = d.attachments.find((a) => /\.pdf$/i.test(a.url))?.url ?? null;
+  }
+  if (unitResult) {
+    const d = parseDetailPage(
+      (await fetchHtml(unitResult.url, { useCache })).html,
+      unitResult.url,
+    );
+    unitPdf = d.attachments.find((a) => /\.pdf$/i.test(a.url))?.url ?? null;
+  }
+
+  if (withPdf) {
+    if (familyPersonPdf) {
+      try { familyPersonPdfM = await extractPdfMetrics(familyPersonPdf); }
+      catch (err) { familyPersonPdfM = { _error: err.message }; }
+    }
+    if (unitPdf) {
+      try { unitPdfM = await extractPdfMetrics(unitPdf); }
+      catch (err) { unitPdfM = { _error: err.message }; }
+    }
+  }
+
+  const unitAlloc = unitPdfM.allocTotal ?? cfgM.unitAlloc ?? null;
+  const unitValid = unitPdfM.validEncodeCount ?? null;
+  const unitRate = unitAlloc != null && unitValid
+    ? `${(unitAlloc / unitValid * 100).toFixed(3)}% (${unitAlloc.toLocaleString()}/${unitValid.toLocaleString()})`
+    : null;
+
+  const fpAlloc = familyPersonPdfM.allocTotal ?? cfgM.familyPersonAlloc ?? null;
+  const fpApply = (cfgM.familyApplyCount ?? 0) + (cfgM.personalApplyCount ?? 0);
+  const fpRate = fpAlloc != null && fpApply > 0
+    ? `${(fpAlloc / fpApply * 100).toFixed(3)}% (${fpAlloc.toLocaleString()}/${fpApply.toLocaleString()}) 理论值，实际家庭按积分确定中签`
+    : null;
+
+  const data = {
+    period: periodLabel,
+    source: cfg.url,
+    publishDate: cfgDetail.dateIso,
+    apply: {
+      family: cfgM.familyApplyCount ?? null,
+      personal: cfgM.personalApplyCount ?? null,
+      unit: cfgM.unitApplyCount ?? null,
+    },
+    alloc: {
+      familyAndPersonal: fpAlloc,
+      unit: unitAlloc,
+    },
+    rate: {
+      familyAndPersonal: fpRate,
+      unit: unitRate,
+    },
+    pdfMetrics: { familyPerson: familyPersonPdfM, unit: unitPdfM },
+    attachments: { familyPerson: familyPersonPdf, unit: unitPdf },
+    familyMinScore: 'N/A (官方未在结构化字段中公布)',
+    nev: { waitYears: cfgM.nevWaitYears ?? null },
+    blackListCount: cfgM.blackListCount ?? null,
+  };
+
+  const lines = [];
+  lines.push(`北京小客车摇号 ${data.period || '当期'} 形势播报`);
+  lines.push(`公告: ${data.source}`);
+  lines.push(`发布: ${data.publishDate || '未知'}`);
+  lines.push('');
+  lines.push('【有效申请编码】（来源：HTML 通告）');
+  lines.push(`  家庭: ${fmt(data.apply.family)}`);
+  lines.push(`  个人: ${fmt(data.apply.personal)}`);
+  lines.push(`  单位: ${fmt(data.apply.unit)} 家`);
+  if (unitValid) {
+    lines.push(`  单位（PDF 有效编码总数，按企业规模/纳税倍率）: ${fmt(unitValid)}`);
+  }
+  lines.push('');
+  lines.push('【本期配置指标】');
+  lines.push(`  家庭+个人（同池）: ${fmt(data.alloc.familyAndPersonal)}`);
+  lines.push(`  单位: ${fmt(data.alloc.unit)}`);
+  lines.push('');
+  lines.push('【中签率】');
+  lines.push(`  家庭+个人: ${data.rate.familyAndPersonal || 'N/A'}`);
+  lines.push(`  单位:      ${data.rate.unit || 'N/A'}`);
+  lines.push('');
+  lines.push('【家庭摇号最低中签积分】');
+  lines.push(`  ${data.familyMinScore}`);
+  if (data.nev.waitYears != null) {
+    lines.push('');
+    lines.push(`【新能源轮候】预计 ${data.nev.waitYears} 年`);
+  }
+  if (data.blackListCount != null) {
+    lines.push('');
+    lines.push(`【失信限制】${fmt(data.blackListCount)} 人`);
+  }
+  if (!withPdf) {
+    lines.push('');
+    lines.push('(已跳过 PDF 解析，中签率使用 HTML 字段近似)');
+  }
+  return { ok: true, data, lines };
+}
+
+// watch 命令：fetch 候选 items 列表
+export const watchTargets = {
+  result: {
+    desc: '开奖结果',
+    async fetch(opts = {}) {
+      const useCache = opts.cache !== false;
+      const page = await fetchHtml(URLS.announceList, {
+        useCache,
+        maxCacheAgeMs: 5 * 60 * 1000,
+      });
+      const items = parseListPage(page.html, URLS.announceList);
+      return items.filter((i) => i.kind === 'result' || i.kind === 'config_notice');
+    },
+  },
+  policy: {
+    desc: '政策变化',
+    async fetch(opts = {}) {
+      const useCache = opts.cache !== false;
+      const page = await fetchHtml(URLS.policyList, {
+        useCache,
+        maxCacheAgeMs: 5 * 60 * 1000,
+      });
+      return parseListPage(page.html, URLS.policyList);
+    },
+  },
+  window: {
+    desc: '申请窗口开放',
+    async fetch(opts = {}) {
+      const useCache = opts.cache !== false;
+      const [a, b] = await Promise.all([
+        fetchHtml(URLS.announceList, { useCache, maxCacheAgeMs: 5 * 60 * 1000 }),
+        fetchHtml(URLS.guideList, { useCache, maxCacheAgeMs: 5 * 60 * 1000 }),
+      ]);
+      const aItems = parseListPage(a.html, URLS.announceList)
+        .filter((i) => i.kind === 'quota' || i.kind === 'qualify_review');
+      const bItems = parseListPage(b.html, URLS.guideList);
+      return [...aItems, ...bItems];
+    },
+  },
+};
+
+function fmt(n) {
+  if (n == null) return '未知';
+  if (typeof n === 'number') return n.toLocaleString('zh-CN');
+  return String(n);
+}

package/src/source/guangzhou/calendar.js

@@ -0,0 +1,54 @@
+// 广州摇号关键日历：月度循环。
+// 申请窗口截至每月 12 日 24 时；摇号日为每月 25 日（遇非工作日顺延）
+
+import { MONTHLY_RHYTHM } from './constants.js';
+
+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 pad(n) { return String(n).padStart(2, '0'); }
+
+function statusOf(today, dateStr) {
+  const days = daysBetween(today, dateStr);
+  if (days > 0) return `还有 ${days} 天`;
+  if (days === 0) return '就在今天';
+  return `已过 ${-days} 天`;
+}
+
+function buildMonthSchedule(year) {
+  const months = [];
+  for (let m = 1; m <= 12; m++) {
+    const deadline = `${year}-${pad(m)}-${pad(MONTHLY_RHYTHM.applyDeadlineDay)}`;
+    const lottery = `${year}-${pad(m)}-${pad(MONTHLY_RHYTHM.lotteryDay)}`;
+    months.push({ month: m, deadline, lottery });
+  }
+  return months;
+}
+
+export function getCalendar(year) {
+  const y = year || new Date().getFullYear();
+  const today = new Date();
+  const todayStr = `${today.getFullYear()}-${String(today.getMonth()+1).padStart(2,'0')}-${String(today.getDate()).padStart(2,'0')}`;
+  const months = buildMonthSchedule(y);
+
+  // 只显示当前及未来 4 个月（避免冗余）
+  const currentMonth = today.getFullYear() === y ? today.getMonth() + 1 : 1;
+  const upcoming = months.filter((m) => m.month >= currentMonth).slice(0, 4);
+
+  const items = upcoming.flatMap((m) => [
+    { event: `${m.month} 月申请截止`, date: m.deadline, status: statusOf(today, m.deadline) },
+    { event: `${m.month} 月摇号日`,   date: m.lottery,  status: statusOf(today, m.lottery) },
+  ]);
+
+  const lines = [`广州中小客车摇号 ${y} 年关键日历（今天 ${todayStr}）:`, ''];
+  for (const it of items) {
+    lines.push(`  ${it.date.padEnd(28)}  ${it.event}  [${it.status}]`);
+  }
+  lines.push('');
+  lines.push('规则：申请窗口截至每月 12 日 24 时，摇号日为每月 25 日（遇非工作日顺延，以官方公告为准）');
+  lines.push('提示：累计参加摇号 72 次以上的个人可直接申领普通车增量指标，不占配置额度');
+  return { year: y, today: todayStr, schedule: items, lines };
+}

package/src/source/guangzhou/constants.js

@@ -0,0 +1,16 @@
+// 广州市中小客车指标调控管理信息系统
+export const SYSTEM_URL = 'https://jtzl.jtj.gz.gov.cn/';
+
+export const URLS = {
+  system: 'https://jtzl.jtj.gz.gov.cn/',
+  // 公告/政策由广州市交通运输局门户提供
+  noticeList: 'https://jtj.gz.gov.cn/gkmlpt/index',
+  // 调控办与摇号相关栏目（通过门户搜索的二级路径）
+  noticeIndex: 'https://jtj.gz.gov.cn/',
+};
+
+// 广州摇号节奏：申请窗口截至每月 12 日 24 时；摇号日为每月 25 日（遇非工作日顺延）
+export const MONTHLY_RHYTHM = {
+  applyDeadlineDay: 12,
+  lotteryDay: 25,
+};

package/src/source/guangzhou/eligibility.js

@@ -0,0 +1,88 @@
+import { input, select, confirm } from '@inquirer/prompts';
+
+// 广州市中小客车增量指标资格规则（参考广州本地宝 2025 摇号申请指引）
+// 简化版，复杂情况以《广州市小客车指标调控管理办法》为准
+
+const PERSON_TYPES = {
+  GZHJ: '广州市户籍人员',
+  WJZJ: '驻穗武警 / 现役军人',
+  GANG_AO_TAI: '港澳台居民 / 持外国人永久居留证 / 华侨',
+  ZZZ: '持有效《广东省居住证》（连续居住 + 连续社保）',
+};
+
+export async function checkEligibility() {
+  try {
+    const personType = await select({
+      message: '户籍/居住类型？',
+      choices: [
+        ...Object.entries(PERSON_TYPES).map(([k, v]) => ({ name: v, value: k })),
+        { name: '以上都不是', value: 'NONE' },
+      ],
+    });
+    if (personType === 'NONE') {
+      return result(false, '不符合广州摇号户籍/居住要求', { reason: 'huji_not_match' });
+    }
+
+    const age = Number(await input({
+      message: '年龄？',
+      default: '30',
+      validate: (v) => /^\d+$/.test(v) && Number(v) > 0 || '请输入正整数',
+    }));
+    if (age < 18) return result(false, '需年满 18 周岁', { age });
+
+    const hasLicense = await confirm({ message: '是否持有有效机动车驾驶证？', default: true });
+    if (!hasLicense) return result(false, '需持有有效机动车驾驶证');
+
+    const hasYueAPlate = await confirm({ message: '名下是否已有粤 A 牌小客车？', default: false });
+    if (hasYueAPlate) return result(false, '名下已有粤 A 牌小客车');
+
+    const hasIndicator = await confirm({ message: '是否已持有有效的增量指标或指标确认通知书？', default: false });
+    if (hasIndicator) return result(false, '已持有有效指标，不能重复申请');
+
+    // 非穗籍走居住证 + 社保
+    if (personType === 'ZZZ') {
+      const sbYears = Number(await input({
+        message: '在穗连续缴纳社保的月数（断缴会清零，需中等社保险种）？',
+        default: '0',
+        validate: (v) => /^\d+(\.\d+)?$/.test(v) || '请输入数字',
+      }));
+      if (sbYears < 24) {
+        return result(false, `非穗籍连续社保需满 24 个月，差 ${(24 - sbYears).toFixed(0)} 个月`, { sbYears });
+      }
+    }
+
+    const lines = ['符合广州摇号申请条件：'];
+    lines.push('  ✓ 个人普通车增量指标（摇号或竞价）');
+    lines.push('  ✓ 个人节能车增量指标（无额度限制）');
+    lines.push('  ✓ 个人新能源车增量指标（无额度限制）');
+    lines.push('');
+    lines.push('下一步：在每月 12 日 24 时前登录 jtzl.jtj.gz.gov.cn 提交申请。');
+    lines.push('提示：本判定为简化版，复杂情况以《广州市小客车指标调控管理办法》为准。');
+
+    return result(true, lines.join('\n'), {
+      personType,
+      personTypeLabel: PERSON_TYPES[personType],
+      age,
+      eligibility: {
+        regular_lottery: true,
+        regular_bidding: true,
+        energy_saving: true,
+        new_energy: true,
+      },
+    });
+  } catch (err) {
+    if (err && err.name === 'ExitPromptError') {
+      return { pass: null, cancelled: true, lines: ['已取消'] };
+    }
+    throw err;
+  }
+}
+
+function result(pass, message, extra = {}) {
+  return {
+    pass,
+    message,
+    ...extra,
+    lines: [pass ? message : `不符合：${message}`],
+  };
+}

package/src/source/guangzhou/index.js

@@ -0,0 +1,22 @@
+// 广州中小客车摇号 source
+import { SYSTEM_URL } from './constants.js';
+import { getCalendar } from './calendar.js';
+import { checkEligibility } from './eligibility.js';
+import { extractMarketMetrics, watchTargets } from './service.js';
+
+export const meta = {
+  name: 'guangzhou',
+  label: '广州',
+  systemUrl: SYSTEM_URL,
+  applyTypes: ['person', 'unit'],
+  regTypes: ['普通指标', '节能车', '新能源'],
+  supported: true,
+  notes: '形势播报和 watch 爬虫待补全，calendar 和 eligibility 已可用',
+};
+
+export {
+  getCalendar,
+  checkEligibility,
+  extractMarketMetrics,
+  watchTargets,
+};

package/src/source/guangzhou/parse.js

@@ -0,0 +1,61 @@
+// 广州公告页解析：jtzl.jtj.gz.gov.cn 首页含 <dl><dt><a><dd>YYYY-MM-DD</dd> 结构
+
+import {
+  stripTags,
+  extractMetricsFromText as commonMetrics,
+  cnDateToIso,
+  isoFromUrlPath,
+  absUrl,
+  extractPeriod,
+} from '../_shared/parseUtils.js';
+import { classifyTitle } from '../_shared/titleClassify.js';
+
+export function parseListPage(html, baseUrl) {
+  const items = [];
+  const dlRe = /<dl[^>]*>([\s\S]*?)<\/dl>/gi;
+  for (const m of html.matchAll(dlRe)) {
+    const block = m[1];
+    const aMatch = /<a[^>]+href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/i.exec(block);
+    const dateMatch = /<dd[^>]*>\s*(\d{4}-\d{1,2}-\d{1,2})\s*<\/dd>/i.exec(block);
+    if (!aMatch) continue;
+    const href = aMatch[1];
+    if (!/\/index\/gbl\//i.test(href)) continue; // 只要公告页
+    const title = stripTags(aMatch[2]);
+    const date = dateMatch ? dateMatch[1] : (isoFromUrlPath(href) || null);
+    items.push({
+      title,
+      date,
+      url: absUrl(href, baseUrl),
+      period: extractPeriod(title),
+      kind: classifyTitle(title),
+    });
+  }
+  return items;
+}
+
+export function parseDetailPage(html, url) {
+  // 广州详情页正文区域大致用 .article 或 .content 类名
+  let scope = html;
+  const articleMatch =
+    /<div[^>]+class="[^"]*(?:article|content|TRS_Editor)[^"]*"[^>]*>([\s\S]*?)<\/div>/i.exec(html);
+  if (articleMatch) scope = articleMatch[1];
+
+  const titleM = /<h1[^>]*>([\s\S]*?)<\/h1>|<h2[^>]*>([\s\S]*?)<\/h2>/i.exec(html);
+  const title = titleM ? stripTags(titleM[1] || titleM[2]) : null;
+
+  const dateText = (/发布(?:日期|时间)[：:]\s*([0-9-/]+|\d{4}年\d{1,2}月\d{1,2}日)/.exec(html) || [])[1] || null;
+  const dateIso = dateText
+    ? (cnDateToIso(dateText) || (/^\d{4}-\d{1,2}-\d{1,2}/.test(dateText) ? dateText.replace(/\//g, '-') : null))
+    : isoFromUrlPath(url);
+
+  const attachments = [];
+  const aRe = /<a[^>]+href="([^"]+\.(?:pdf|docx?|xlsx?|zip))"[^>]*>([\s\S]*?)<\/a>/gi;
+  for (const m of html.matchAll(aRe)) {
+    attachments.push({ url: absUrl(m[1], url), name: stripTags(m[2]).trim() });
+  }
+
+  const bodyText = stripTags(scope);
+  const metrics = commonMetrics(bodyText);
+
+  return { url, title, dateText, dateIso, bodyText, attachments, metrics };
+}

package/src/source/guangzhou/service.js

@@ -0,0 +1,126 @@
+import { fetchHtml } from '../_shared/crawl.js';
+import { parseListPage, parseDetailPage } from './parse.js';
+import { URLS, SYSTEM_URL } from './constants.js';
+
+const MAX_CACHE_AGE = 5 * 60 * 1000;
+
+async function fetchList(opts = {}) {
+  const useCache = opts.cache !== false;
+  const page = await fetchHtml(URLS.system, { useCache, maxCacheAgeMs: MAX_CACHE_AGE });
+  return parseListPage(page.html, URLS.system);
+}
+
+export async function extractMarketMetrics(opts = {}) {
+  try {
+    const useCache = opts.cache !== false;
+    const items = await fetchList(opts);
+
+    // 找最近一期"配置数量的通告"
+    const cfg = items.find((i) => i.kind === 'config_notice' && /配置数量/.test(i.title));
+    // 找最近一期"配置结果"
+    const result = items.find((i) => i.kind === 'result');
+    // 找最近一期"阶梯统计"
+    const tier = items.find((i) => i.kind === 'tier_stats');
+
+    const detailsToParse = [cfg, result, tier].filter(Boolean);
+    const detailMetrics = {};
+    for (const it of detailsToParse) {
+      try {
+        const page = await fetchHtml(it.url, { useCache });
+        const d = parseDetailPage(page.html, it.url);
+        detailMetrics[it.kind] = { ...d.metrics, title: d.title, url: it.url, date: it.date };
+      } catch {}
+    }
+
+    const cfgM = detailMetrics.config_notice || {};
+    const resM = detailMetrics.result || {};
+
+    const totalAlloc = cfgM.totalAlloc ?? resM.totalAlloc ?? null;
+    const personalAlloc = cfgM.personalAlloc ?? resM.personalAlloc ?? null;
+    const unitAlloc = cfgM.unitAllocNum ?? resM.unitAllocNum ?? null;
+    const lotteryAlloc = cfgM.lotteryAlloc ?? resM.lotteryAlloc ?? null;
+    const biddingAlloc = cfgM.biddingAlloc ?? resM.biddingAlloc ?? null;
+
+    const data = {
+      city: 'guangzhou',
+      period: cfg?.period?.label || result?.period?.label || null,
+      source: cfg?.url || result?.url || SYSTEM_URL,
+      latestConfig: cfg ? { date: cfg.date, title: cfg.title, url: cfg.url } : null,
+      latestResult: result ? { date: result.date, title: result.title, url: result.url } : null,
+      latestTier: tier ? { date: tier.date, title: tier.title, url: tier.url } : null,
+      alloc: { total: totalAlloc, personal: personalAlloc, unit: unitAlloc, lottery: lotteryAlloc, bidding: biddingAlloc },
+      details: detailMetrics,
+    };
+
+    const lines = [];
+    lines.push(`广州中小客车摇号 ${data.period || '当期'} 形势播报`);
+    lines.push(`数据来源: ${SYSTEM_URL}`);
+    lines.push('');
+    if (cfg) {
+      lines.push(`【最新配置数量通告】${cfg.date}`);
+      lines.push(`  ${cfg.title}`);
+      lines.push(`  ${cfg.url}`);
+    }
+    if (result) {
+      lines.push('');
+      lines.push(`【最新摇号配置结果】${result.date}`);
+      lines.push(`  ${result.title}`);
+      lines.push(`  ${result.url}`);
+    }
+    if (tier) {
+      lines.push('');
+      lines.push(`【最新阶梯分布统计】${tier.date}`);
+      lines.push(`  ${tier.title}`);
+      lines.push(`  ${tier.url}`);
+    }
+    if (totalAlloc || personalAlloc || unitAlloc || lotteryAlloc || biddingAlloc) {
+      lines.push('');
+      lines.push('【本期配置指标】');
+      if (totalAlloc) lines.push(`  总配置: ${fmt(totalAlloc)}`);
+      if (personalAlloc) lines.push(`  个人:   ${fmt(personalAlloc)}`);
+      if (unitAlloc) lines.push(`  单位:   ${fmt(unitAlloc)}`);
+      if (lotteryAlloc) lines.push(`  其中摇号: ${fmt(lotteryAlloc)}`);
+      if (biddingAlloc) lines.push(`  其中竞价: ${fmt(biddingAlloc)}`);
+    }
+    lines.push('');
+    lines.push('提示：广州按月配置；累计摇号 72 次以上可直接申领（不占额度）');
+    lines.push('完整中签率/具体编码需查询单篇公告全文');
+    return { ok: true, data, lines };
+  } catch (err) {
+    return {
+      ok: false,
+      error: `广州数据抓取失败: ${err.message}`,
+      lines: [`错误: ${err.message}`, '', `请直接访问 ${SYSTEM_URL}`],
+    };
+  }
+}
+
+export const watchTargets = {
+  result: {
+    desc: '广州摇号结果',
+    async fetch(opts = {}) {
+      const items = await fetchList(opts);
+      return items.filter((i) => i.kind === 'result' || i.kind === 'config_notice');
+    },
+  },
+  policy: {
+    desc: '广州政策变化',
+    async fetch(opts = {}) {
+      const items = await fetchList(opts);
+      return items.filter((i) => i.kind === 'quota' || i.kind === 'faq' || i.kind === 'penalty');
+    },
+  },
+  window: {
+    desc: '广州申请窗口/资格审核',
+    async fetch(opts = {}) {
+      const items = await fetchList(opts);
+      return items.filter((i) => i.kind === 'qualify_review' || i.kind === 'tier_stats' || i.kind === 'lottery_notice');
+    },
+  },
+};
+
+function fmt(n) {
+  if (n == null) return '未知';
+  if (typeof n === 'number') return n.toLocaleString('zh-CN');
+  return String(n);
+}

package/src/source/hangzhou/calendar.js

@@ -0,0 +1,60 @@
+// 杭州摇号关键日历：月度循环 + 阶梯摇号特殊期
+// 常规：每月 1-8 日申报、23 日审核结果、26 日摇号
+// 2026 阶梯摇号 J1 期：申请 2025-12-15 至 2026-01-14，摇号 2026-01-30
+
+import { MONTHLY_RHYTHM } from './constants.js';
+
+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 pad(n) { return String(n).padStart(2, '0'); }
+function statusOf(today, dateStr) {
+  const days = daysBetween(today, dateStr);
+  if (days > 0) return `还有 ${days} 天`;
+  if (days === 0) return '就在今天';
+  return `已过 ${-days} 天`;
+}
+
+const TIERED_LOTTERY = {
+  2026: [{ name: '2026J1 期个人阶梯摇号', applyStart: '2025-12-15', applyEnd: '2026-01-14', lottery: '2026-01-30' }],
+};
+
+export function getCalendar(year) {
+  const y = year || new Date().getFullYear();
+  const today = new Date();
+  const todayStr = `${today.getFullYear()}-${String(today.getMonth()+1).padStart(2,'0')}-${String(today.getDate()).padStart(2,'0')}`;
+  const currentMonth = today.getFullYear() === y ? today.getMonth() + 1 : 1;
+
+  const items = [];
+  // 常规月度日历
+  for (let m = currentMonth; m <= Math.min(currentMonth + 3, 12); m++) {
+    const apply = `${y}-${pad(m)}-${pad(MONTHLY_RHYTHM.applyEndDay)}`;
+    const audit = `${y}-${pad(m)}-${pad(MONTHLY_RHYTHM.auditDay)}`;
+    const lottery = `${y}-${pad(m)}-${pad(MONTHLY_RHYTHM.lotteryDay)}`;
+    items.push({ event: `${m} 月申报截止`, date: apply, status: statusOf(today, apply) });
+    items.push({ event: `${m} 月资格审核结果`, date: audit, status: statusOf(today, audit) });
+    items.push({ event: `${m} 月摇号日`, date: lottery, status: statusOf(today, lottery) });
+  }
+  // 阶梯摇号
+  const tiered = TIERED_LOTTERY[y] || [];
+  for (const t of tiered) {
+    items.push({ event: `${t.name}（申报）`, date: `${t.applyStart} 至 ${t.applyEnd}`, status: 'see below' });
+    items.push({ event: `${t.name}（摇号）`, date: t.lottery, status: statusOf(today, t.lottery) });
+  }
+
+  const lines = [`杭州小客车摇号 ${y} 年关键日历（今天 ${todayStr}）:`, ''];
+  for (const it of items) {
+    if (it.status === 'see below') {
+      lines.push(`  ${it.date.padEnd(28)}  ${it.event}`);
+    } else {
+      lines.push(`  ${String(it.date).padEnd(28)}  ${it.event}  [${it.status}]`);
+    }
+  }
+  lines.push('');
+  lines.push('规则：每月 1-8 日申报、23 日左右审核结果、26 日摇号（遇非工作日顺延）');
+  lines.push('阶梯摇号：累计摇号 24 次以上可参与，每年举办一次');
+  lines.push('业务已迁移至"浙里办"APP / 浙江政务服务网');
+  return { year: y, today: todayStr, schedule: items, lines };
+}

package/src/source/hangzhou/constants.js

@@ -0,0 +1,16 @@
+// 杭州市小客车总量调控管理信息系统
+export const SYSTEM_URL = 'https://hzxkctk.cn/';
+
+export const URLS = {
+  system: 'https://hzxkctk.cn/',
+  tzggList: 'https://hzxkctk.cn/tzgg/',
+};
+
+// 杭州摇号节奏：常规月度摇号在 26 日；申报期为每月 1-8 日（具体每月公告）；
+// 阶梯摇号每年一次（如 2026J1 期 2026-01-30，申请期 2025-12-15 至 2026-01-14）
+export const MONTHLY_RHYTHM = {
+  applyStartDay: 1,
+  applyEndDay: 8,
+  auditDay: 23,
+  lotteryDay: 26,
+};