linke-sdufe 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linke-sdufe",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "山东财经大学强智教务（jw.sdufe.edu.cn）适配器共享包：登录、教务查询与页面解析。linke-cli 与 Linke App 同源引用；教务请求一律从用户设备直发。",
   "type": "module",
   "main": "./src/index.js",

package/src/adapter.js

@@ -45,10 +45,52 @@ const REQUEST_TIMEOUT_MS = 20000
  * 翻页：listPath=栏目首页，page N → pagePath/{N-1}.htm。
  * 学工部通知栏目实测=info/1093（数据源地图旧记 1090 实测 404）。
  */
+/**
+ * 校园官网公开通知源注册表（T46 起 36 源；数据源地图 v4 全站探测 +
+ * 2026-09-04 执行者逐站实勘：列表/栏目/翻页/详情容器逐站 curl 实证）。
+ * 翻页：listPath 去掉 .htm 即 pagerPath（page N → {pagerPath}/{N-1}.htm）；
+ * pagePath 为空=该源翻页形态特殊未实证（如 jinrong），page>1 明确报错。
+ * infoPaths：列表条目栏目过滤（防导航混入）；详情白名单按 origin（不限栏目）。
+ * 不接：zgjjyjy（无通知栏目）、xcb（内容发新闻网）、tuanwei/grads 等
+ * 防护壳与登录系统（数据源地图标注排除）。
+ */
 export const PORTAL_NOTICE_SOURCES = {
-  jwc: { name: '教务处官网', origin: 'https://jwc.sdufe.edu.cn', listPath: '/zxdt/tzgg.htm', pagePath: '/zxdt/tzgg', infoPath: '/info/1043/' },
-  main: { name: '学校主站', origin: 'https://www.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPath: '/info/1068/' },
-  xgb: { name: '学工部官网', origin: 'https://student.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPath: '/info/1093/' },
+  jwc: { name: '教务处官网', origin: 'https://jwc.sdufe.edu.cn', listPath: '/zxdt/tzgg.htm', pagePath: '/zxdt/tzgg', infoPaths: ['1043'] },
+  main: { name: '学校主站', origin: 'https://www.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1068'] },
+  xgb: { name: '学工部官网', origin: 'https://student.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1093'] },
+  archives: { name: '档案馆', origin: 'https://archives.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1053'] },
+  bcf: { name: '区块链金融实验室', origin: 'https://bcf.sdufe.edu.cn', listPath: '/xwzx/zhxw.htm', pagePath: '/xwzx/zhxw', infoPaths: ['1072'] },
+  cs: { name: '计算机学院', origin: 'https://cs.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1014'] },
+  gkgc: { name: '管科学院', origin: 'https://gkgc.sdufe.edu.cn', listPath: '/tzgg.htm', pagePath: '/tzgg', infoPaths: ['1099'] },
+  gonghui: { name: '工会', origin: 'https://gonghui.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1061'] },
+  gsglxy: { name: '工商管理学院', origin: 'https://gsglxy.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1193'] },
+  hf: { name: '合作发展', origin: 'https://hf.sdufe.edu.cn', listPath: '/fxljy1/tzgg.htm', pagePath: '/fxljy1/tzgg', infoPaths: ['1194'] },
+  insurance: { name: '保险学院', origin: 'https://insurance.sdufe.edu.cn', listPath: '/tzgg.htm', pagePath: '/tzgg', infoPaths: ['1059', '1152'] },
+  jinrong: { name: '金融学院', origin: 'https://jinrong.sdufe.edu.cn', listPath: '/tzgg.htm', pagePath: '', infoPaths: ['1043', '1160'] },
+  jiwei: { name: '纪委', origin: 'https://jiwei.sdufe.edu.cn', listPath: '/tzgg.htm', pagePath: '/tzgg', infoPaths: ['1080'] },
+  jrfzyjy: { name: '金融发展研究院', origin: 'https://jrfzyjy.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1013'] },
+  jsgzb: { name: '教师工作部', origin: 'https://jsgzb.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1127'] },
+  kyc: { name: '科研处', origin: 'https://kyc.sdufe.edu.cn', listPath: '/tzgg.htm', pagePath: '/tzgg', infoPaths: ['1077'] },
+  law: { name: '法学院', origin: 'https://law.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1287'] },
+  lib: { name: '图书馆', origin: 'https://lib.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1094'] },
+  mba: { name: 'MBA学院', origin: 'https://mba.sdufe.edu.cn', listPath: '/tzgg.htm', pagePath: '/tzgg', infoPaths: ['1372', '1376'] },
+  mpa: { name: 'MPA中心', origin: 'https://mpa.sdufe.edu.cn', listPath: '/xwtz/tzgg.htm', pagePath: '/xwtz/tzgg', infoPaths: ['1027'] },
+  news: { name: '新闻网', origin: 'https://news.sdufe.edu.cn', listPath: '/cdyw.htm', pagePath: '/cdyw', infoPaths: ['1071'] },
+  rcb: { name: '人才办', origin: 'https://rcb.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1023'] },
+  rsc: { name: '人事处', origin: 'https://rsc.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1047'] },
+  sam: { name: '统数学院', origin: 'https://sam.sdufe.edu.cn', listPath: '/tzgg.htm', pagePath: '/tzgg', infoPaths: ['1012', '1051'] },
+  sce: { name: '继续教育学院', origin: 'https://sce.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1124', '1125', '1164', '1282', '2241'] },
+  sie: { name: '国际教育学院', origin: 'https://sie.sdufe.edu.cn', listPath: '/index/tzgg2.htm', pagePath: '/index/tzgg2', infoPaths: ['1063'] },
+  site: { name: '国贸学院', origin: 'https://site.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1009', '1063', '1064'] },
+  spft: { name: '财税学院', origin: 'https://spft.sdufe.edu.cn', listPath: '/tzgg1.htm', pagePath: '/tzgg1', infoPaths: ['1010'] },
+  spm: { name: '公共管理学院', origin: 'https://spm.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1324'] },
+  tzb: { name: '统战部', origin: 'https://tzb.sdufe.edu.cn', listPath: '/tzgg.htm', pagePath: '/tzgg', infoPaths: ['1031'] },
+  xkjsbgs: { name: '学科办', origin: 'https://xkjsbgs.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1106'] },
+  xxgk: { name: '信息公开', origin: 'https://xxgk.sdufe.edu.cn', listPath: '/ejlm/xwyxk/xwsybfhsyjd.htm', pagePath: '/ejlm/xwyxk/xwsybfhsyjd', infoPaths: ['1115'] },
+  yjsy: { name: '研究生院', origin: 'https://yjsy.sdufe.edu.cn', listPath: '/index/tzgg1.htm', pagePath: '/index/tzgg1', infoPaths: ['1027', '1030', '1031', '1032', '1043', '1058'] },
+  ys: { name: '燕山学院', origin: 'https://ys.sdufe.edu.cn', listPath: '/xwtz/zhxw.htm', pagePath: '/xwtz/zhxw', infoPaths: ['1018', '1053'] },
+  zfjxpj: { name: '政府绩效评价', origin: 'https://zfjxpj.sdufe.edu.cn', listPath: '/zxdt/tzgg.htm', pagePath: '/zxdt/tzgg', infoPaths: ['1010', '1015', '1018', '1037'] },
+  zzb: { name: '组织部', origin: 'https://zzb.sdufe.edu.cn', listPath: '/index/tzgg.htm', pagePath: '/index/tzgg', infoPaths: ['1046', '1076'] },
 }
 
 /** 课程属性中文名 → zzdKcSX 表单码（强智 kbxx_kc_ifr 口径） */
@@ -407,17 +449,24 @@ export function createSdufeAdapter(env) {
     },
 
     /**
-     * 校园官网公开通知三大主源列表（T46；博达 CMS 同构一套解析）。
-     * site ∈ PORTAL_NOTICE_SOURCES：jwc 教务处 / main 主站 / xgb 学工部。
-     * 翻页口径（逐源实证）：page 1=栏目首页 tzgg.htm，page N= tzgg/{N-1}.htm。
+     * 校园官网公开通知源列表（T46 三源起步，T46 扩展 36 源；博达 CMS 同构
+     * 一套解析，逐站实勘配置见 PORTAL_NOTICE_SOURCES）。
+     * 翻页口径：page 1=listPath，page N={pagePath}/{N-1}.htm；
+     * pagePath 为空=该源翻页未实证（page>1 明确报错，不静默回首页）。
      * 礼貌纪律：只抓请求的页，不做归档批量预取。
      */
     async fetchPortalNotices(site, page = 1) {
       const src = PORTAL_NOTICE_SOURCES[site]
       if (!src) {
-        throw new LinkeError('BAD_SOURCE', `未知通知源：${site}（限 ${Object.keys(PORTAL_NOTICE_SOURCES).join('/')}）`, {
+        throw new LinkeError('BAD_SOURCE', `未知通知源：${site}`, {
+          exitCode: EXIT.GENERAL,
+          hint: 'source 取源注册表 key（jwc=教务处 / main=主站 / xgb=学工部 / lib=图书馆 / yjsy=研究生院 / news=新闻网 / 各学院与职能部门拼音缩写）',
+        })
+      }
+      if (page > 1 && !src.pagePath) {
+        throw new LinkeError('NO_PAGER', `${src.name}暂不支持翻页（该站翻页形态特殊未实证）`, {
           exitCode: EXIT.GENERAL,
-          hint: 'source 取 jwc=教务处 / main=学校主站 / xgb=学工部',
+          hint: '本源仅可查第一页（page=1）',
         })
       }
       const path = page <= 1 ? src.listPath : `${src.pagePath}/${page - 1}.htm`
@@ -437,11 +486,11 @@ export function createSdufeAdapter(env) {
       // 栏目过滤：列表页含导航/侧栏的 info 链接（如主站「学校概况」），
       // 只保留本源通知栏目条目
       return parsePortalNotices(await response.text(), src.origin)
-        .filter((x) => !src.infoPath || x.url.includes(src.infoPath))
+        .filter((x) => !src.infoPaths || !src.infoPaths.length || src.infoPaths.some((c) => x.url.includes(`/info/${c}/`)))
     },
 
     /**
-     * 校园官网公开通知详情全文（T46）。url 限三源域名（白名单防抓任意站）；
+     * 校园官网公开通知详情全文（T46）。url 限源注册表内域名（白名单防抓任意站）；
      * 礼貌纪律：只抓用户点名的这一篇，不做批量预取。
      */
     async fetchPortalNoticeDetail(url) {
@@ -456,9 +505,9 @@ export function createSdufeAdapter(env) {
       }
       const src = Object.values(PORTAL_NOTICE_SOURCES).find((s) => s.origin === parsed.origin)
       if (!src || !/^\/info\/\d+\/\d+\.htm$/.test(parsed.pathname)) {
-        throw new LinkeError('BAD_URL', `URL 不在校内通知三源范围：${url}`, {
+        throw new LinkeError('BAD_URL', `URL 不在校内通知源范围：${url}`, {
           exitCode: EXIT.GENERAL,
-          hint: `仅支持 ${Object.values(PORTAL_NOTICE_SOURCES).map((s) => s.origin).join(' / ')} 的 info/{栏目}/{id}.htm 详情页`,
+          hint: `仅支持通知源注册表内各站（jwc/main/xgb/lib/yjsy/news/各学院等）的 info/{栏目}/{id}.htm 详情页`,
         })
       }
       let response

package/src/parsers.js

@@ -876,25 +876,38 @@ function htmlToText(html) {
 export function parsePortalNotices(html, baseUrl = '') {
   const list = []
   const seen = new Set()
-  const linkRe = /<a\s+href="([^"]*\/info\/\d+\/\d+\.htm)"[^>]*>([^<]+)<\/a>/g
+  // 兼容条目形态（逐站实勘判例）：
+  // - href 属性位不定（news/xxgk：<a target="_blank" href="info/…">）
+  // - href 三种相对形态：../info/{栏}/{id}.htm、/info/…、info/…（无前导斜杠）
+  // - a 内可嵌日期 span（lib/yjsy/news/cs 等新模板：<a>标题<span class="spans">日期</span></a>）
+  const linkRe = /<a\s[^>]*?href="((?:[^"]*?\/)?info\/\d+\/\d+\.htm)"[^>]*>([\s\S]*?)<\/a>/g
   let m
   while ((m = linkRe.exec(html))) {
     let url = m[1]
     if (!/^https?:/i.test(url)) {
-      // "../info/x" 相对列表页目录 → 站点根 /info/x（博达栏目均为根级 info/）
-      url = baseUrl.replace(/\/$/, '') + '/' + url.replace(/^(\.\.\/)+/, '')
+      // 相对列表页目录 → 站点根 /info/x（博达栏目均为根级 info/）
+      url = baseUrl.replace(/\/$/, '') + '/' + url.replace(/^(\.\.\/)+/, '').replace(/^\//, '')
     }
     if (seen.has(url)) continue
     seen.add(url)
+    const inner = decodeEntities(m[2].replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim())
+    // yjsy/cs 等新模板把日期放 a 内文本开头 → 剥前缀日期当 date
+    let title = inner
+    let date = ''
+    const inline = inner.match(/^(\d{4}-\d{2}-\d{2})\s*(.*)$/)
+    const inlineCn = inner.match(/^(\d{4}年\d{1,2}月\d{1,2}日)\s*(.*)$/)
+    if (inline) { date = inline[1]; title = inline[2] || inner }
+    else if (inlineCn) { date = inlineCn[1]; title = inlineCn[2] || inner }
     const after = html.slice(m.index + m[0].length, m.index + m[0].length + 600)
     const before = html.slice(Math.max(0, m.index - 600), m.index)
-    let date = (after.match(/\d{4}-\d{2}-\d{2}/) || [])[0] || ''
+    // 日期其余形态：a 内 span 徽章 → a 后窗口 → a 前 day+month 分元素（学工部）
+    if (!date) date = (m[2].match(/\d{4}-\d{2}-\d{2}/) || [])[0] || ''
+    if (!date) date = (after.match(/\d{4}-\d{2}-\d{2}/) || [])[0] || ''
     if (!date) {
-      // 学工部形态：<p class="day">13</p><p class="month">2026-07</p>
       const dm = before.match(/class="day">\s*(\d{1,2})\s*<\/p>\s*<p class="month">\s*(\d{4}-\d{2})/)
       if (dm) date = `${dm[2]}-${dm[1].padStart(2, '0')}`
     }
-    list.push({ title: decodeEntities(m[2].trim()), url, date })
+    list.push({ title, url, date })
   }
   return list
 }