yaohao 1.0.0

package/src/source/hangzhou/eligibility.js

@@ -0,0 +1,102 @@
+import { input, select, confirm } from '@inquirer/prompts';
+
+// 杭州小客车增量指标资格规则（参考杭州市小客车指标管理办法）
+// 简化版，复杂情况以官方说明为准
+
+const PERSON_TYPES = {
+  HZHJ: '杭州市户籍居民',
+  XLZG: '驻杭部队现役军人或现役武警',
+  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, '不符合杭州摇号户籍/居住要求');
+    }
+
+    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 hasZheAPlate = await confirm({ message: '名下是否已有浙 A 牌小客车？', default: false });
+    if (hasZheAPlate) 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 lotteryCount = Number(await input({
+      message: '累计参加杭州摇号次数（用于判断阶梯摇号资格）？没参加过填 0',
+      default: '0',
+      validate: (v) => /^\d+$/.test(v) || '请输入整数',
+    }));
+    const isTierEligible = lotteryCount >= 24;
+
+    const isMultiChild = await confirm({ message: '是否多孩家庭（2 孩及以上）？', default: false });
+    const isTalent = await confirm({ message: '是否经杭州市认定的人才（如 E 类及以上）？', default: false });
+
+    const lines = ['符合杭州摇号申请条件：'];
+    lines.push('  ✓ 个人普通小客车增量指标（每月 26 日摇号）');
+    lines.push('  ✓ 个人新能源小客车增量指标');
+    if (isTierEligible) lines.push('  ✓ 个人阶梯摇号（累计摇号已达 24 次）');
+    if (isMultiChild) lines.push('  ✓ 多孩家庭可直接申领指标（无需摇号）');
+    if (isTalent) lines.push('  ✓ 经认定的人才可直接申领指标');
+    lines.push('');
+    lines.push('下一步：在"浙里办"APP 或浙江政务服务网申报，定位选择"杭州市"');
+    lines.push('提示：杭州业务已迁移至"浙里办"，原 hzxkctk.cn 仅保留查询和公告功能');
+
+    return result(true, lines.join('\n'), {
+      personType,
+      personTypeLabel: PERSON_TYPES[personType],
+      age,
+      lotteryCount,
+      eligibility: {
+        regular_lottery: true,
+        new_energy: true,
+        tiered_lottery: isTierEligible,
+        multi_child_direct: isMultiChild,
+        talent_direct: isTalent,
+      },
+    });
+  } 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/hangzhou/index.js

@@ -0,0 +1,20 @@
+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: 'hangzhou',
+  label: '杭州',
+  systemUrl: SYSTEM_URL,
+  applyTypes: ['person', 'unit', 'tiered', 'multi_child', 'talent'],
+  regTypes: ['普通指标', '新能源', '阶梯摇号'],
+  supported: true,
+};
+
+export {
+  getCalendar,
+  checkEligibility,
+  extractMarketMetrics,
+  watchTargets,
+};

package/src/source/hangzhou/parse.js

@@ -0,0 +1,59 @@
+// 杭州公告解析：hzxkctk.cn/tzgg/ 用 <dd><a class="text"><span class="date"> 结构（同北京）
+
+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 = [];
+  // 杭州结构与北京相同：<dd><a class="text" href>...</a><span class="date">YYYY-MM-DD</span></dd>
+  const ddRe = /<dd[^>]*>([\s\S]*?)<\/dd>/gi;
+  for (const m of html.matchAll(ddRe)) {
+    const block = m[1];
+    const aMatch = /<a\s+class="text"\s+href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/i.exec(block);
+    const dMatch = /<span\s+class="date">([\s\S]*?)<\/span>/i.exec(block);
+    if (!aMatch) continue;
+    const title = stripTags(aMatch[2]);
+    const date = dMatch ? stripTags(dMatch[1]) : (isoFromUrlPath(aMatch[1]) || null);
+    items.push({
+      title,
+      date,
+      url: absUrl(aMatch[1], baseUrl),
+      period: extractPeriod(title),
+      kind: classifyTitle(title),
+    });
+  }
+  return items;
+}
+
+export function parseDetailPage(html, url) {
+  // 杭州详情页通常用 .content / .article 类名
+  let scope = html;
+  const articleMatch =
+    /<div[^>]+class="[^"]*(?:article|content|TRS_Editor|main_content)[^"]*"[^>]*>([\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/hangzhou/service.js

@@ -0,0 +1,122 @@
+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.tzggList, { useCache, maxCacheAgeMs: MAX_CACHE_AGE });
+  return parseListPage(page.html, URLS.tzggList);
+}
+
+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 audit = items.find((i) => i.kind === 'qualify_review');
+
+    const detailsToParse = [cfg, result, audit].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: 'hangzhou',
+      period: cfg?.period?.label || result?.period?.label || null,
+      source: 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,
+      latestAudit: audit ? { date: audit.date, title: audit.title, url: audit.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 (audit) {
+      lines.push('');
+      lines.push(`【最新资格审核结果】${audit.date}`);
+      lines.push(`  ${audit.title}`);
+      lines.push(`  ${audit.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('提示：杭州业务已迁移至"浙里办"APP / 浙江政务服务网');
+    lines.push('每月 26 日摇号；阶梯摇号每年举办一次（累计摇号 24 次以上可参与）');
+    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 === 'calendar_notice');
+    },
+  },
+};
+
+function fmt(n) {
+  if (n == null) return '未知';
+  if (typeof n === 'number') return n.toLocaleString('zh-CN');
+  return String(n);
+}

package/src/source/index.js

@@ -0,0 +1,54 @@
+// source registry：注册所有支持的城市 source
+// 接口规范见 source/beijing/index.js
+
+import * as beijing from './beijing/index.js';
+import * as guangzhou from './guangzhou/index.js';
+import * as shenzhen from './shenzhen/index.js';
+import * as hangzhou from './hangzhou/index.js';
+
+const SOURCES = {
+  beijing,
+  guangzhou,
+  shenzhen,
+  hangzhou,
+};
+
+const IMPLEMENTED = ['beijing', 'guangzhou', 'shenzhen', 'hangzhou'];
+const PLANNED = [];
+
+const CITY_LABELS = {
+  beijing: '北京',
+  guangzhou: '广州',
+  shenzhen: '深圳',
+  hangzhou: '杭州',
+};
+
+export function listSources() {
+  return Object.keys(SOURCES);
+}
+
+export function listImplemented() {
+  return IMPLEMENTED;
+}
+
+export function listPlanned() {
+  return PLANNED;
+}
+
+export function getCityLabel(city) {
+  return CITY_LABELS[city] || city;
+}
+
+export function getSource(city) {
+  if (!city) {
+    throw new Error('未指定城市，请用 --city <beijing|guangzhou|shenzhen|hangzhou> 或运行 `yaohao init` 设置默认城市');
+  }
+  if (PLANNED.includes(city)) {
+    throw new Error(`${getCityLabel(city)}（${city}）source 尚未实现，敬请期待。当前可用城市: ${IMPLEMENTED.map(getCityLabel).join(', ')}`);
+  }
+  const source = SOURCES[city];
+  if (!source) {
+    throw new Error(`未知城市: ${city}。支持的城市: ${IMPLEMENTED.concat(PLANNED).join(', ')}`);
+  }
+  return source;
+}

package/src/source/shenzhen/calendar.js

@@ -0,0 +1,44 @@
+// 深圳摇号关键日历：月度循环
+// 每月 8 日前申请当月、每月 23 日左右公布资格审核结果、每月 26 日摇号
+// 2026 年阶梯摇号：4-12 月每月，24 次为 1 阶梯
+
+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} 天`;
+}
+
+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.applyDeadlineDay)}`;
+    const audit = `${y}-${pad(m)}-23`;
+    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 lines = [`深圳小汽车增量指标摇号 ${y} 年关键日历（今天 ${todayStr}）:`, ''];
+  for (const it of items) {
+    lines.push(`  ${it.date.padEnd(28)}  ${it.event}  [${it.status}]`);
+  }
+  lines.push('');
+  lines.push('规则：每月 8 日前申请当月、23 日左右公布审核结果、26 日摇号（遇周末/节假日顺延）');
+  lines.push('2026 年 4-12 月实施阶梯摇号：累计 24 次未中签升 1 个阶梯，每升 1 阶增加 1 个摇号编码');
+  return { year: y, today: todayStr, schedule: items, lines };
+}

package/src/source/shenzhen/constants.js

@@ -0,0 +1,14 @@
+// 深圳市小汽车增量调控管理信息系统
+export const SYSTEM_URL = 'https://xqctk.jtys.sz.gov.cn/';
+
+export const URLS = {
+  system: 'https://xqctk.jtys.sz.gov.cn/',
+  gblList: 'https://xqctk.jtys.sz.gov.cn/gbl/index.html',
+  applyEntry: 'https://apply.jtys.sz.gov.cn/apply/',
+};
+
+// 深圳摇号节奏：每月 8 日前申请当月、9 日及之后入下月；摇号日为每月 26 日（遇周末/节假日顺延）
+export const MONTHLY_RHYTHM = {
+  applyDeadlineDay: 8,
+  lotteryDay: 26,
+};

package/src/source/shenzhen/eligibility.js

@@ -0,0 +1,90 @@
+import { input, select, confirm } from '@inquirer/prompts';
+
+// 深圳小汽车增量指标资格规则（参考深圳市小汽车增量调控管理实施细则）
+// 简化版，复杂情况以官方说明为准
+
+const PERSON_TYPES = {
+  SZHJ: '深圳市户籍居民',
+  XLZG: '驻深现役军人或现役武警',
+  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, '不符合深圳摇号户籍/居住要求');
+    }
+
+    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 hasShenzhenPlate = await confirm({ message: '名下是否已有深圳籍小汽车？', default: false });
+    if (hasShenzhenPlate) return result(false, '名下已有深圳籍小汽车');
+
+    const hasIndicator = await confirm({ message: '是否已持有有效的增量指标？', default: false });
+    if (hasIndicator) return result(false, '已持有有效指标，不能重复申请');
+
+    // 非深户走居住证 + 社保
+    if (personType === 'ZZZ') {
+      // 2026 政策：取消非深户籍人员申请新能源小汽车增量指标的社保限制
+      // 但普通指标仍要 24 个月连续社保
+      const wantNev = await confirm({ message: '只关心新能源指标吗？（新能源已取消非深户社保限制）', default: false });
+      if (!wantNev) {
+        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('  ✓ 个人新能源小汽车增量指标');
+    if (personType !== 'ZZZ') {
+      lines.push('  ✓ 个人混合动力小汽车增量指标（条件放宽）');
+    }
+    lines.push('');
+    lines.push('下一步：每月 8 日前登录 xqctk.jtys.sz.gov.cn 提交申请。');
+    lines.push('提示：2026 年 4-12 月实施阶梯摇号，累计摇号次数越多编码越多');
+
+    return result(true, lines.join('\n'), {
+      personType,
+      personTypeLabel: PERSON_TYPES[personType],
+      age,
+      eligibility: { regular: 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/shenzhen/index.js

@@ -0,0 +1,20 @@
+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: 'shenzhen',
+  label: '深圳',
+  systemUrl: SYSTEM_URL,
+  applyTypes: ['person', 'unit'],
+  regTypes: ['普通指标', '混合动力', '新能源'],
+  supported: true,
+};
+
+export {
+  getCalendar,
+  checkEligibility,
+  extractMarketMetrics,
+  watchTargets,
+};

package/src/source/shenzhen/parse.js

@@ -0,0 +1,58 @@
+// 深圳公告解析：xqctk.jtys.sz.gov.cn/gbl/ 结构与杭州/北京一致
+// <dd><a class="text" href>...</a><span class="date">YYYY-MM-DD</span></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 ddRe = /<dd[^>]*>([\s\S]*?)<\/dd>/gi;
+  for (const m of html.matchAll(ddRe)) {
+    const block = m[1];
+    const aMatch = /<a\s+class="text"\s+href="([^"]+)"[^>]*>([\s\S]*?)<\/a>/i.exec(block);
+    const dMatch = /<span\s+class="date">([\s\S]*?)<\/span>/i.exec(block);
+    if (!aMatch) continue;
+    const title = stripTags(aMatch[2]);
+    const date = dMatch ? stripTags(dMatch[1]) : (isoFromUrlPath(aMatch[1]) || null);
+    items.push({
+      title,
+      date,
+      url: absUrl(aMatch[1], baseUrl),
+      period: extractPeriod(title),
+      kind: classifyTitle(title),
+    });
+  }
+  return items;
+}
+
+export function parseDetailPage(html, url) {
+  let scope = html;
+  const articleMatch =
+    /<div[^>]+class="[^"]*(?:article|content|TRS_Editor|main_content|subpage_article)[^"]*"[^>]*>([\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 };
+}