job-pro 0.7.0 → 0.7.2

package/dist/iflytek.js

@@ -1,97 +1,339 @@
-// 科大讯飞 (iFlytek) — stub adapter for `job-pro`.
-//
-// STATUS: stub-only. The public careers portal exists but the underlying
-// recruitment API is gated behind a 301 redirect chain into Beisen's iTalent
-// ATS (italent.cn), which requires a logged-in candidate session before any
-// position JSON is returned.
+// 科大讯飞 (iFlytek) careers adapter for `job-pro`.
 //
 // ============================================================
-// RECONNAISSANCE RESULTS (probed 2026-05):
+// API DISCOVERY (probed 2026-05-16)
 //
-//   www.iflytek.com/careers          — corporate page only, no listings JSON
-//   campus.iflytek.com               — 301 redirect to Tengine origin which
-//                                      issues a second 301 to the italent
-//                                      candidate-portal sign-in form (the
-//                                      favicon path is /italent.ico, which
-//                                      confirms the Beisen / 北森 backend).
-//   career.iflytek.com               — 301 chain into the same iTalent portal
-//   hr.iflytek.com                   — 301 chain, gated
+// campus.iflytek.com / career.iflytek.com / hr.iflytek.com all 301-chain into
+// Beisen iTalent's candidate-portal sign-in form (favicon /italent.ico is the
+// dead giveaway for Beisen / 北森). That portal is candidate-session-only.
 //
-//   Feishu ATSX tenants probed:
-//     iflytek.jobs.feishu.cn          — HTTP 400 empty body (no tenant)
+// The *public* careers site is a sibling Beisen tenant hosted at
+// https://iflytek.zhiye.com/ — the same SaaS stack we already use for vivo
+// (see cli/src/vivo.ts). The paginated list endpoint is anonymous: no
+// session cookie, no signed header, no CSRF token. Same response envelope
+// as vivo and other zhiye.com tenants:
 //
-//   Moka:
-//     app.mokahr.com/social-recruitment/iflytek  — page shell renders but
-//       the per-slug job feed returns the Moka SPA error page.
+//   POST /api/Jobad/GetJobAdPageList
+//     payload: { PageIndex (0-based), PageSize, KeyWords, SpecialType,
+//                PortalId: "", DisplayFields: [...], Category?: [...] }
+//     headers: standard browser UA + Content-Type=application/json +
+//              Referer=https://iflytek.zhiye.com/jobs +
+//              x-requested-with=xmlhttprequest + langtype=zh_CN
+//     envelope: { Code:200, Data:[RawJobAd[]], Count:<int>, Total:<int> }
 //
-// Conclusion: iFlytek publishes positions through the Beisen iTalent portal,
-// whose JSON endpoints require an authenticated candidate session. There is
-// no unauthenticated public REST surface as of probe date. When upstream
-// exposes one, this adapter can be upgraded to a thin client.
+// Probed 2026-05-16: 744 positions across campus / social / intern channels.
+// Category labels seen: "校园招聘", "员工社招", "员工校招", "实习生".
 //
+// Endpoint inventory (all anon, all on iflytek.zhiye.com):
+//   POST /api/Jobad/GetJobAdPageList            → paginated job list
+//   POST /api/Jobad/GetJobAdSearchConditions    → filter taxonomy
+//   GET  /api/Jobad/GetSpecialJobAdList         → hot/special jobs
+//   GET  /api/Jobad/SearchAreasTreeConditions   → city tree
+//   GET  /api/Common/GetPortalAIRobot           → portal config
 // ============================================================
-// PositionSummary field mapping (canonical):
-//   post_id, title, project, recruit_label, bgs, work_cities, apply_url
 import { extractResumeSignals, scoreOverlap, checkResume } from "./tencent.js";
 export { checkResume };
-const SOURCE = "campus.iflytek.com";
-const STUB_MESSAGE = "iFlytek (科大讯飞): careers portal is fronted by Beisen iTalent (italent.cn) " +
-    "which gates all job-list JSON behind an authenticated candidate session. " +
-    "No unauthenticated public API available. Visit https://campus.iflytek.com/ for the portal.";
-export async function searchPositions(_opts = {}) {
+const SOURCE = "iflytek.zhiye.com";
+const API_ROOT = "https://iflytek.zhiye.com";
+const SITE_ROOT = "https://iflytek.zhiye.com/jobs";
+const DETAIL_PAGE = (id) => `https://iflytek.zhiye.com/jobs?jobAdId=${encodeURIComponent(id)}`;
+const DEFAULT_HEADERS = {
+    "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36",
+    Accept: "application/json",
+    "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+    Referer: SITE_ROOT,
+    Origin: API_ROOT,
+    "x-requested-with": "xmlhttprequest",
+    langtype: "zh_CN",
+};
+async function post(path, body) {
+    let response;
+    try {
+        response = await fetch(`${API_ROOT}${path}`, {
+            method: "POST",
+            headers: { ...DEFAULT_HEADERS, "Content-Type": "application/json" },
+            body: JSON.stringify(body),
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            message: `network error: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (!response.ok) {
+        return { ok: false, message: `HTTP ${response.status}: ${response.statusText}` };
+    }
+    let payload;
+    try {
+        payload = (await response.json());
+    }
+    catch (err) {
+        return { ok: false, message: `bad JSON: ${err instanceof Error ? err.message : err}` };
+    }
     return {
-        ok: false,
+        ok: payload.Code === 200,
+        data: payload.Data,
+        count: payload.Count ?? payload.Total,
+        message: payload.Message || (payload.Code === 200 ? "ok" : "upstream error"),
+    };
+}
+async function get(path) {
+    let response;
+    try {
+        response = await fetch(`${API_ROOT}${path}`, { method: "GET", headers: DEFAULT_HEADERS });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            message: `network error: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (!response.ok) {
+        return { ok: false, message: `HTTP ${response.status}: ${response.statusText}` };
+    }
+    let payload;
+    try {
+        payload = (await response.json());
+    }
+    catch (err) {
+        return { ok: false, message: `bad JSON: ${err instanceof Error ? err.message : err}` };
+    }
+    return {
+        ok: payload.Code === 200,
+        data: payload.Data,
+        message: payload.Message || (payload.Code === 200 ? "ok" : "upstream error"),
+    };
+}
+function summarize(item) {
+    const id = String(item.JobAdId ?? item.Id ?? "");
+    const cities = Array.isArray(item.LocNames) ? item.LocNames.join(", ") : "";
+    return {
+        post_id: id,
+        title: (item.JobAdName ?? "").trim(),
+        project: (item.Org ?? "").trim(),
+        recruit_label: (item.Category ?? "").trim(),
+        bgs: "",
+        work_cities: cities,
+        apply_url: id ? DETAIL_PAGE(id) : SITE_ROOT,
+    };
+}
+// Beisen tenants encode recruit type via numeric Category IDs that vary by
+// tenant. We don't know iFlytek's exact mapping without probing the
+// taxonomy endpoint, so we leave it open and let CLI users filter by the
+// returned `recruit_label` string client-side. When the mapping is known,
+// add the numeric codes here (vivo uses "3"=intern, "4"=social, "5"=campus).
+function categoryFromRecruitType(_t) {
+    return undefined;
+}
+// ---------- searchPositions ----------
+export async function searchPositions(opts = {}) {
+    const pageSize = Math.max(1, Math.min(50, opts.pageSize ?? 20));
+    const page = Math.max(1, opts.page ?? 1);
+    // Beisen pageIndex is zero-based.
+    const body = {
+        PageIndex: page - 1,
+        PageSize: pageSize,
+        KeyWords: (opts.keyword ?? "").trim().slice(0, 60),
+        SpecialType: 0,
+        PortalId: "",
+        DisplayFields: ["Category", "Kind", "LocId", "Org", "HeadCount", "PostDate", "Salary"],
+    };
+    const category = categoryFromRecruitType(opts.recruitType);
+    if (category)
+        body.Category = category;
+    const r = await post("/api/Jobad/GetJobAdPageList", body);
+    if (!r.ok) {
+        return {
+            ok: false,
+            source: SOURCE,
+            message: r.message,
+            query: body,
+            positions: [],
+        };
+    }
+    const rows = r.data ?? [];
+    return {
+        ok: true,
         source: SOURCE,
-        message: STUB_MESSAGE,
-        query: {},
-        positions: [],
+        query: body,
+        page,
+        page_size: pageSize,
+        total: r.count ?? rows.length,
+        positions: rows.map(summarize),
     };
 }
-export async function fetchAllPositions(_opts = {}) {
+// ---------- fetchAllPositions ----------
+export async function fetchAllPositions(opts = {}) {
+    const pageSize = Math.max(1, Math.min(50, opts.pageSize ?? 30));
+    const maxPages = Math.max(1, opts.maxPages ?? 30);
+    const bucket = [];
+    let total;
+    for (let page = 1; page <= maxPages; page++) {
+        const r = await searchPositions({
+            keyword: opts.keyword,
+            page,
+            pageSize,
+            recruitType: opts.recruitType,
+        });
+        if (!r.ok) {
+            return { ok: false, source: SOURCE, message: r.message, total: 0, fetched: bucket.length, positions: bucket };
+        }
+        if (total === undefined)
+            total = r.total;
+        if (!r.positions.length)
+            break;
+        bucket.push(...r.positions);
+        if (total !== undefined && bucket.length >= total)
+            break;
+    }
     return {
-        ok: false,
+        ok: true,
         source: SOURCE,
-        message: STUB_MESSAGE,
-        total: 0,
-        fetched: 0,
-        positions: [],
+        total: total ?? bucket.length,
+        fetched: bucket.length,
+        positions: bucket,
     };
 }
+// ---------- fetchPositionDetail ----------
+// Beisen serves the detail page from the same paginated list; there is no
+// per-id REST endpoint that returns plain JSON. We page through and filter.
 export async function fetchPositionDetail(postId) {
+    const id = (postId ?? "").trim();
+    if (!id)
+        return { ok: false, source: SOURCE, message: "post_id is required" };
+    const pageSize = 50;
+    const maxPages = 20;
+    for (let page = 1; page <= maxPages; page++) {
+        const body = {
+            PageIndex: page - 1,
+            PageSize: pageSize,
+            KeyWords: "",
+            SpecialType: 0,
+            PortalId: "",
+            DisplayFields: ["Category", "Org", "LocId", "Kind", "Duty", "Require"],
+        };
+        const r = await post("/api/Jobad/GetJobAdPageList", body);
+        if (!r.ok) {
+            return { ok: false, source: SOURCE, post_id: id, message: r.message };
+        }
+        const posts = r.data ?? [];
+        const found = posts.find((p) => String(p.JobAdId ?? p.Id) === id);
+        if (found) {
+            const summary = summarize(found);
+            return {
+                ok: true,
+                source: SOURCE,
+                post_id: id,
+                title: found.JobAdName ?? "",
+                project: summary.project,
+                recruit_label: summary.recruit_label,
+                description: found.Duty ?? "",
+                requirements: found.Require ?? "",
+                head_count: found.HeadCount ?? 0,
+                post_date: found.PostDate ?? "",
+                work_cities: found.LocNames ?? [],
+                apply_url: summary.apply_url,
+            };
+        }
+        if (posts.length < pageSize)
+            break;
+    }
     return {
         ok: false,
         source: SOURCE,
-        message: STUB_MESSAGE,
-        post_id: postId,
+        post_id: id,
+        message: `post ${id} not found in public search results (scanned up to ${maxPages * pageSize} posts)`,
     };
 }
+let _filterCache = null;
 export async function fetchDictionaries() {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE };
+    if (_filterCache !== null)
+        return _filterCache;
+    const r = await post("/api/Jobad/GetJobAdSearchConditions", { PortalId: "", SpecialType: 0 });
+    if (!r.ok || !r.data) {
+        const result = { ok: false, source: SOURCE, message: r.message };
+        _filterCache = result;
+        return result;
+    }
+    const conditions = r.data.map((c) => ({
+        field: c.Field ?? "",
+        name: c.Name ?? "",
+        options: (c.Options ?? []).map((o) => ({
+            id: o.Id ?? o.Code ?? "",
+            name: o.Name ?? "",
+        })),
+    }));
+    const result = { ok: true, source: SOURCE, conditions };
+    _filterCache = result;
+    return result;
 }
+// ---------- notices (stub — Beisen tenants have no public notices feed) ----------
+const NOTICES_STUB = {
+    ok: false,
+    source: SOURCE,
+    message: "iFlytek: no public notices endpoint on Beisen tenant",
+};
 export async function listNotices() {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notices: [] };
+    return { ...NOTICES_STUB, notices: [] };
 }
 export async function getNotice(noticeId) {
-    return { ok: false, source: SOURCE, message: STUB_MESSAGE, notice_id: noticeId };
+    return { ...NOTICES_STUB, notice_id: noticeId };
 }
 export async function findNoticesByQuestion(question, _opts = {}) {
-    return {
-        ok: false,
-        source: SOURCE,
-        question,
-        message: STUB_MESSAGE,
-        matches: [],
-    };
+    return { ...NOTICES_STUB, question, matches: [] };
 }
-export async function matchResume(text, _opts = {}) {
+// ---------- matchResume ----------
+export async function matchResume(text, opts = {}) {
+    const topN = Math.max(1, opts.topN ?? 5);
+    const candidates = Math.max(topN, opts.candidates ?? 20);
     const { terms, cities } = extractResumeSignals(text ?? "");
+    if (!terms.length) {
+        return {
+            ok: false,
+            source: SOURCE,
+            message: "could not extract any technical signals from the text",
+            preview: (text ?? "").slice(0, 120),
+        };
+    }
+    const keyword = terms.slice(0, 3).join(" ");
+    const list = await searchPositions({ keyword, page: 1, pageSize: 50 });
+    if (!list.ok) {
+        return { ok: false, source: SOURCE, message: list.message, positions: [] };
+    }
+    const scored = [];
+    for (const p of list.positions) {
+        const blob = [p.title, p.project, p.recruit_label, p.work_cities].join(" ");
+        const { score, reasons } = scoreOverlap(blob, terms, cities);
+        if (score > 0)
+            scored.push({ score, position: p, reasons });
+    }
+    scored.sort((a, b) => b.score - a.score);
+    let shortlist = scored.slice(0, Math.max(topN, candidates));
+    if (!shortlist.length) {
+        shortlist = list.positions.slice(0, candidates).map((position) => ({
+            score: 0,
+            position,
+            reasons: [],
+        }));
+    }
+    const matches = shortlist.slice(0, topN).map((s) => {
+        const mr = s.reasons.length > 0
+            ? s.reasons.slice(0, 5)
+            : ["no specific keyword overlap — surfaced from initial keyword search"];
+        return { ...s.position, match_reasons: mr };
+    });
     return {
-        ok: false,
+        ok: true,
         source: SOURCE,
         extracted_terms: terms,
         city_preferences: cities,
-        matches: [],
-        message: STUB_MESSAGE,
+        matches,
+        note: "match_reasons surfaces overlapping keywords, not a probability of getting an interview. " +
+            "The only authority on selection is HR.",
     };
 }
 export { extractResumeSignals, scoreOverlap };
+// Silence unused warning for the GET helper — kept for future taxonomy/city
+// endpoints that return BeisenEnvelope JSON via GET.
+void get;

package/dist/index.js

@@ -51,7 +51,7 @@ import * as webank from "./webank.js";
 import * as horizonrobotics from "./horizonrobotics.js";
 import * as cambricon from "./cambricon.js";
 import { memoryList, memoryGet, memorySet, memoryEvent, memoryClear, } from "./memory.js";
-const VERSION = "0.7.0";
+const VERSION = "0.7.2";
 const HELP = `
 job-pro — query Chinese big-tech campus recruiting from your terminal
             (job.ha7ch.com)
@@ -250,57 +250,62 @@ function readResumeArg(arg) {
         return arg;
     }
 }
+// Every company adapter exposes the same set of functions, so one dispatcher
+// can route verbs against any of them. New companies plug in by adding an
+// `import * as <name>` and a line in `ADAPTERS`. The `satisfies` clause
+// makes any contract drift (missing verb, wrong signature) a compile error
+// instead of a silent runtime hazard.
 const ADAPTERS = {
     tencent,
-    bytedance: bytedance,
-    alibaba: alibaba,
-    meituan: meituan,
-    xiaohongshu: xiaohongshu,
-    jd: jd,
-    kuaishou: kuaishou,
-    xiaomi: xiaomi,
-    baidu: baidu,
-    netease: netease,
-    didi: didi,
-    bilibili: bilibili,
-    pdd: pdd,
-    nio: nio,
-    minimax: minimax,
-    huawei: huawei,
-    weibo: weibo,
-    mihoyo: mihoyo,
-    pingan: pingan,
-    sensetime: sensetime,
-    trip: trip,
-    unitree: unitree,
-    byd: byd,
-    antgroup: antgroup,
-    liauto: liauto,
-    moonshot: moonshot,
-    zhipu: zhipu,
-    hikvision: hikvision,
-    iqiyi: iqiyi,
-    megvii: megvii,
-    lilith: lilith,
-    agibot: agibot,
-    deepseek: deepseek,
-    zerooneai: zerooneai,
-    galaxyuniversal: galaxyuniversal,
-    stepfun: stepfun,
-    cicc: cicc,
-    baichuan: baichuan,
-    xpeng: xpeng,
-    weride: weride,
-    hoyoverse: hoyoverse,
-    iflytek: iflytek,
-    oppo: oppo,
-    vivo: vivo,
-    sf: sf,
-    cainiao: cainiao,
-    geely: geely,
-    webank: webank,
-    horizonrobotics: horizonrobotics,
-    cambricon: cambricon,
+    bytedance,
+    alibaba,
+    meituan,
+    xiaohongshu,
+    jd,
+    kuaishou,
+    xiaomi,
+    baidu,
+    netease,
+    didi,
+    bilibili,
+    pdd,
+    nio,
+    minimax,
+    huawei,
+    weibo,
+    mihoyo,
+    pingan,
+    sensetime,
+    trip,
+    unitree,
+    byd,
+    antgroup,
+    liauto,
+    moonshot,
+    zhipu,
+    hikvision,
+    iqiyi,
+    megvii,
+    lilith,
+    agibot,
+    deepseek,
+    zerooneai,
+    galaxyuniversal,
+    stepfun,
+    cicc,
+    baichuan,
+    xpeng,
+    weride,
+    hoyoverse,
+    iflytek,
+    oppo,
+    vivo,
+    sf,
+    cainiao,
+    geely,
+    webank,
+    horizonrobotics,
+    cambricon,
 };
 async function runCompany(adapter, company, rawArgs) {
     const [verb, ...rest] = rawArgs;