@reconcrap/boss-recommend-mcp 1.3.10 → 1.3.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "1.3.10",
+  "version": "1.3.11",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",

package/src/test-boss-chat.js

@@ -2,6 +2,7 @@ import assert from "node:assert/strict";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
+import { mkdir } from "node:fs/promises";
 
 import {
   cancelBossChatRun,
@@ -14,6 +15,8 @@ import {
 } from "./boss-chat.js";
 import { __testables as cliTestables } from "./cli.js";
 import { __testables as indexTestables } from "./index.js";
+import { BossChatApp } from "../vendor/boss-chat-cli/src/app.js";
+import { LlmClient, parseLlmJson } from "../vendor/boss-chat-cli/src/services/llm.js";
 
 const { handleRequest } = indexTestables;
 
@@ -550,10 +553,265 @@ async function testBossChatCliShouldSupportRunAndFollowUpParsing() {
   });
 }
 
+function testBossChatLlmEvidenceGateShouldDemoteMissingEvidence() {
+  const parsed = parseLlmJson(
+    JSON.stringify({
+      passed: true,
+      reason: "命中标准",
+      summary: "命中",
+      evidence: [],
+    }),
+    {
+      evidenceCorpus: "南京大学 机器学习 项目经历",
+    },
+  );
+  assert.equal(parsed.rawPassed, true);
+  assert.equal(parsed.passed, false);
+  assert.equal(parsed.evidenceGateDemoted, true);
+  assert.equal(parsed.evidenceMatchedCount, 0);
+}
+
+function testBossChatLlmEvidenceGateShouldDemoteUnmatchedEvidence() {
+  const parsed = parseLlmJson(
+    JSON.stringify({
+      passed: true,
+      reason: "命中标准",
+      summary: "命中",
+      evidence: ["十年金融风控投研经验"],
+    }),
+    {
+      evidenceCorpus: "南京大学 机器学习 项目经历",
+    },
+  );
+  assert.equal(parsed.rawPassed, true);
+  assert.equal(parsed.passed, false);
+  assert.equal(parsed.evidenceGateDemoted, true);
+  assert.equal(parsed.evidenceRawCount, 1);
+  assert.equal(parsed.evidenceMatchedCount, 0);
+}
+
+async function testBossChatLlmTextChunkFallbackShouldWork() {
+  const originalChunkSize = process.env.BOSS_CHAT_TEXT_CHUNK_SIZE_CHARS;
+  const originalChunkOverlap = process.env.BOSS_CHAT_TEXT_CHUNK_OVERLAP_CHARS;
+  const originalMaxChunks = process.env.BOSS_CHAT_TEXT_MAX_CHUNKS;
+  process.env.BOSS_CHAT_TEXT_CHUNK_SIZE_CHARS = "1000";
+  process.env.BOSS_CHAT_TEXT_CHUNK_OVERLAP_CHARS = "120";
+  process.env.BOSS_CHAT_TEXT_MAX_CHUNKS = "6";
+  try {
+    class FakeChunkFallbackClient extends LlmClient {
+      constructor() {
+        super({
+          baseUrl: "https://api.example.com/v1",
+          apiKey: "sk-test",
+          model: "gpt-test",
+        });
+        this.calls = [];
+      }
+
+      async requestByPreference(payload) {
+        this.calls.push(payload);
+        if (payload.chunkTotal === 1 && !payload.imageDataUrl) {
+          const error = new Error("maximum context length exceeded");
+          throw error;
+        }
+        if (payload.chunkTotal > 1) {
+          if (payload.chunkIndex === 2) {
+            return {
+              passed: true,
+              rawPassed: true,
+              reason: "命中分段证据",
+              summary: "命中",
+              evidence: ["PASS_MARKER_ABC"],
+              evidenceRawCount: 1,
+              evidenceMatchedCount: 1,
+              evidenceGateDemoted: false,
+              chunkIndex: payload.chunkIndex,
+              chunkTotal: payload.chunkTotal,
+            };
+          }
+          return {
+            passed: false,
+            rawPassed: false,
+            reason: "本段证据不足",
+            summary: "不足",
+            evidence: [],
+            evidenceRawCount: 0,
+            evidenceMatchedCount: 0,
+            evidenceGateDemoted: false,
+            chunkIndex: payload.chunkIndex,
+            chunkTotal: payload.chunkTotal,
+          };
+        }
+        return {
+          passed: false,
+          rawPassed: false,
+          reason: "unexpected",
+          summary: "unexpected",
+          evidence: [],
+          evidenceRawCount: 0,
+          evidenceMatchedCount: 0,
+          evidenceGateDemoted: false,
+          chunkIndex: 1,
+          chunkTotal: 1,
+        };
+      }
+    }
+
+    const client = new FakeChunkFallbackClient();
+    const longResume = `${"A".repeat(1200)} PASS_MARKER_ABC ${"B".repeat(1200)} PASS_MARKER_DEF`;
+    const result = await client.evaluateResume({
+      screeningCriteria: "有 AI 项目经验",
+      candidate: {
+        name: "候选人A",
+        sourceJob: "算法工程师",
+        resumeText: longResume,
+        evidenceCorpus: longResume,
+      },
+      imagePath: null,
+    });
+    assert.equal(result.passed, true);
+    assert.equal(result.evaluationMode, "text");
+    assert.equal(result.chunkIndex, 2);
+    assert.equal(Number(result.chunkTotal) > 1, true);
+  } finally {
+    if (originalChunkSize === undefined) delete process.env.BOSS_CHAT_TEXT_CHUNK_SIZE_CHARS;
+    else process.env.BOSS_CHAT_TEXT_CHUNK_SIZE_CHARS = originalChunkSize;
+    if (originalChunkOverlap === undefined) delete process.env.BOSS_CHAT_TEXT_CHUNK_OVERLAP_CHARS;
+    else process.env.BOSS_CHAT_TEXT_CHUNK_OVERLAP_CHARS = originalChunkOverlap;
+    if (originalMaxChunks === undefined) delete process.env.BOSS_CHAT_TEXT_MAX_CHUNKS;
+    else process.env.BOSS_CHAT_TEXT_MAX_CHUNKS = originalMaxChunks;
+  }
+}
+
+async function testBossChatAppShouldPersistEvidenceArtifacts() {
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "boss-chat-artifacts-"));
+  await mkdir(tempDir, { recursive: true });
+  const records = [];
+  const page = {
+    async closeResumeModalDomOnce() {
+      return {
+        closed: true,
+        method: "dom",
+        finalState: { scopeCount: 0, iframeCount: 0, closeCount: 0, topScopeClass: "" },
+      };
+    },
+    async waitForConversationReady() {
+      return {
+        hasOnlineResume: true,
+        hasAskResume: true,
+        hasAttachmentResume: false,
+        attachmentResumeEnabled: false,
+      };
+    },
+    async openOnlineResume() {
+      return { clicked: true, detectedOpen: true, by: "dom" };
+    },
+    async getResumeRateLimitWarning() {
+      return { hit: false, text: "" };
+    },
+    async getResumeProfileFromDom() {
+      return {
+        ok: true,
+        primarySchool: "南京大学",
+        schools: ["南京大学"],
+        major: "计算机",
+        majors: ["计算机"],
+        company: "OpenAI",
+        position: "工程师",
+        resumeText: "南京大学 计算机 PASS_MARKER_ABC",
+        evidenceCorpus: "南京大学 计算机 PASS_MARKER_ABC",
+      };
+    },
+    async getResumeModalState() {
+      return { open: true, iframeCount: 1, scopeCount: 1, closeCount: 1 };
+    },
+  };
+  const llmClient = {
+    async evaluateResume() {
+      return {
+        passed: false,
+        rawPassed: true,
+        reason: "模型未给出可在简历原文中校验的证据，按安全策略判为不通过。",
+        summary: "降级",
+        evidence: [],
+        evidenceRawCount: 1,
+        evidenceMatchedCount: 0,
+        evidenceGateDemoted: true,
+        evaluationMode: "text",
+        chunkIndex: 1,
+        chunkTotal: 1,
+      };
+    },
+  };
+  const interaction = {
+    async sleepRange() {},
+    async clickRect() {},
+  };
+  const resumeCaptureService = {
+    async captureResume({ artifactDir }) {
+      return {
+        stitchedImage: path.join(artifactDir, "resume.png"),
+        metadataFile: path.join(artifactDir, "chunks.json"),
+        chunkDir: path.join(artifactDir, "chunks"),
+        chunkCount: 1,
+        quality: { likelyBlank: false },
+      };
+    },
+  };
+  const stateStore = {
+    async record(_key, result) {
+      records.push(result);
+    },
+  };
+  const app = new BossChatApp({
+    page,
+    llmClient,
+    interaction,
+    resumeCaptureService,
+    stateStore,
+    reportStore: { async write() { return ""; } },
+    dryRun: true,
+    artifactRootDir: tempDir,
+    resumeOpenCooldownMs: 0,
+    logger: { log() {} },
+  });
+  app.waitResumeOpenCooldown = async () => {};
+
+  const result = await app.processCustomer(
+    {
+      customerKey: "candidate-key",
+      name: "候选人A",
+      sourceJob: "算法工程师",
+      domIndex: 0,
+      customerId: "1001",
+      textSnippet: "",
+    },
+    {
+      screeningCriteria: "有 AI 项目经验",
+    },
+    "run-test",
+    { skipCardClick: true },
+  );
+
+  assert.equal(result.passed, false);
+  assert.equal(result.artifacts.rawPassed, true);
+  assert.equal(result.artifacts.finalPassed, false);
+  assert.equal(result.artifacts.evidenceRawCount, 1);
+  assert.equal(result.artifacts.evidenceMatchedCount, 0);
+  assert.equal(result.artifacts.evidenceGateDemoted, true);
+  assert.equal(result.artifacts.evaluationMode, "text");
+  assert.equal(Array.isArray(records), true);
+  assert.equal(records.length, 1);
+}
+
 async function main() {
   await testBossChatAdapterShouldResolveSharedConfigAndInvokeLocalCli();
   await testBossChatMcpToolsShouldValidateAndRoute();
   await testBossChatCliShouldSupportRunAndFollowUpParsing();
+  testBossChatLlmEvidenceGateShouldDemoteMissingEvidence();
+  testBossChatLlmEvidenceGateShouldDemoteUnmatchedEvidence();
+  await testBossChatLlmTextChunkFallbackShouldWork();
+  await testBossChatAppShouldPersistEvidenceArtifacts();
   console.log("boss-chat tests passed");
 }
 

package/vendor/boss-chat-cli/src/app.js

@@ -233,7 +233,11 @@ export class BossChatApp {
 
     let consecutiveErrors = 0;
     let exhaustedScrolls = 0;
-    const exhaustedScrollLimit = targetCount ? 3 : 8;
+    let noMoreMarkerHits = 0;
+    let fallbackBottomHits = 0;
+    const noMoreMarkerConfirmations = 2;
+    const exhaustedScrollLimit = targetCount ? 10 : 60;
+    const fallbackBottomLimit = targetCount ? 4 : 12;
 
     try {
       while (shouldContinue(summary, targetCount)) {
@@ -324,6 +328,9 @@ export class BossChatApp {
             stage: 'running',
             message: `已处理候选人：${result.name || '未知'}`,
           });
+          exhaustedScrolls = 0;
+          noMoreMarkerHits = 0;
+          fallbackBottomHits = 0;
           if (consecutiveErrors >= 3) {
             this.logger.log('连续 3 位候选人处理失败，提前停止本轮运行。');
             break;
@@ -340,13 +347,33 @@ export class BossChatApp {
         if (!nextCustomer) {
           const ratio = 0.52 + Math.random() * 0.34;
           const scrollResult = await this.page.scrollCustomerList(ratio);
+          const noMoreDetected =
+            Boolean(scrollResult.noMoreDetectedAfter) || Boolean(scrollResult.noMoreDetectedBefore);
           this.logger.log(
-            `列表滚动：ratio=${ratio.toFixed(2)} | didScroll=${Boolean(scrollResult.didScroll)} | top=${scrollResult.after?.top ?? 'n/a'} | scrollRetry=${exhaustedScrolls + 1}`,
+            `列表滚动：ratio=${ratio.toFixed(2)} | didScroll=${Boolean(scrollResult.didScroll)} | top=${scrollResult.after?.top ?? 'n/a'} | atBottom=${Boolean(scrollResult.atBottom)} | noMore=${noMoreDetected}${scrollResult.noMoreTextAfter ? `(${scrollResult.noMoreTextAfter})` : ''} | scrollRetry=${exhaustedScrolls + 1}`,
           );
+          if (noMoreDetected) {
+            noMoreMarkerHits += 1;
+            if (noMoreMarkerHits >= noMoreMarkerConfirmations) {
+              summary.exhausted = true;
+              this.logger.log('列表滚动终止：检测到“没有更多了”标识，判定为 exhausted。');
+              break;
+            }
+            await this.interaction.sleepRange(920, 260);
+            continue;
+          }
+
+          noMoreMarkerHits = 0;
           exhaustedScrolls = scrollResult.didScroll ? exhaustedScrolls + 1 : exhaustedScrolls + 2;
+          fallbackBottomHits = scrollResult.atBottom ? fallbackBottomHits + 1 : 0;
+          if (fallbackBottomHits >= fallbackBottomLimit && exhaustedScrolls >= Math.ceil(exhaustedScrollLimit / 2)) {
+            summary.exhausted = true;
+            this.logger.log('列表滚动终止：未发现“没有更多了”标识，但已多次触底且无可处理候选人，判定为 exhausted。');
+            break;
+          }
           if (exhaustedScrolls >= exhaustedScrollLimit) {
             summary.exhausted = true;
-            this.logger.log('列表滚动终止：连续无可处理候选人，判定为 exhausted。');
+            this.logger.log('列表滚动终止：连续无可处理候选人达到保护上限，判定为 exhausted。');
             break;
           }
           await this.interaction.sleepRange(920, 260);
@@ -354,6 +381,8 @@ export class BossChatApp {
         }
 
         exhaustedScrolls = 0;
+        noMoreMarkerHits = 0;
+        fallbackBottomHits = 0;
         this.logger.log(
           `准备处理候选人：name=${nextCustomer.name || '未知'} | key=${nextCustomer.customerKey} | job=${nextCustomer.sourceJob || '未知'} | domIndex=${nextCustomer.domIndex}`,
         );
@@ -578,6 +607,8 @@ export class BossChatApp {
               majors: Array.isArray(resumeProfile.majors) ? resumeProfile.majors : [],
               company: resumeProfile.company || '',
               position: resumeProfile.position || '',
+              resumeTextLength: String(resumeProfile.resumeText || '').length,
+              evidenceCorpusLength: String(resumeProfile.evidenceCorpus || '').length,
             };
           } else {
             this.logger.log(`简历结构化提取未命中：${resumeProfile?.error || 'unknown'}`);
@@ -638,6 +669,8 @@ export class BossChatApp {
             company: resumeProfile.company || '',
             position: resumeProfile.position || '',
           } : null,
+          resumeText: resumeProfile?.ok ? String(resumeProfile.resumeText || '') : '',
+          evidenceCorpus: resumeProfile?.ok ? String(resumeProfile.evidenceCorpus || '') : '',
         },
         imagePath: capture.stitchedImage,
       });
@@ -647,13 +680,37 @@ export class BossChatApp {
           `评估理由学校字段已按主简历纠偏：rawReason=${evaluation.reason} | finalReason=${finalReason}`,
         );
       }
+      if (evaluation.evidenceGateDemoted === true) {
+        this.logger.log(
+          `证据闸门降级：rawPassed=${Boolean(evaluation.rawPassed)} | evidenceRawCount=${Number(evaluation.evidenceRawCount || 0)} | evidenceMatchedCount=${Number(evaluation.evidenceMatchedCount || 0)} | mode=${evaluation.evaluationMode || 'unknown'}`,
+        );
+      }
       this.logger.log(
-        `LLM评估完成：passed=${evaluation.passed} | reason=${finalReason}`,
+        `LLM评估完成：passed=${evaluation.passed} | rawPassed=${Boolean(evaluation.rawPassed)} | mode=${evaluation.evaluationMode || 'unknown'} | reason=${finalReason}`,
       );
 
       baseResult.reason = finalReason;
       baseResult.passed = evaluation.passed;
       baseResult.decision = evaluation.passed ? 'passed' : 'skipped';
+      baseResult.artifacts.rawPassed = Boolean(evaluation.rawPassed);
+      baseResult.artifacts.finalPassed = Boolean(evaluation.passed);
+      baseResult.artifacts.evidenceRawCount = Number.isFinite(Number(evaluation.evidenceRawCount))
+        ? Number(evaluation.evidenceRawCount)
+        : 0;
+      baseResult.artifacts.evidenceMatchedCount = Number.isFinite(Number(evaluation.evidenceMatchedCount))
+        ? Number(evaluation.evidenceMatchedCount)
+        : 0;
+      baseResult.artifacts.evidenceGateDemoted = evaluation.evidenceGateDemoted === true;
+      baseResult.artifacts.evaluationMode = String(evaluation.evaluationMode || '');
+      baseResult.artifacts.evaluationChunkIndex = Number.isFinite(Number(evaluation.chunkIndex))
+        ? Number(evaluation.chunkIndex)
+        : null;
+      baseResult.artifacts.evaluationChunkTotal = Number.isFinite(Number(evaluation.chunkTotal))
+        ? Number(evaluation.chunkTotal)
+        : null;
+      baseResult.artifacts.evaluationEvidence = Array.isArray(evaluation.evidence)
+        ? evaluation.evidence.slice(0, 5).map((item) => String(item || '').trim()).filter(Boolean)
+        : [];
 
       await this.checkpoint();
       const closeResult =

package/vendor/boss-chat-cli/src/browser/chat-page.js

@@ -630,6 +630,16 @@ function browserActivateCandidate(options = {}) {
 function browserScrollCustomerList(options = {}) {
   const ratio = Number(options.ratio || 0.72);
   const clamp = (value, low, high) => Math.max(low, Math.min(high, value));
+  const normalize = (value) => String(value || '').replace(/\s+/g, ' ').trim();
+  const isVisible = (el) => {
+    if (!(el instanceof HTMLElement)) return false;
+    const style = getComputedStyle(el);
+    if (style.display === 'none' || style.visibility === 'hidden' || Number(style.opacity || '1') < 0.01) {
+      return false;
+    }
+    const rect = el.getBoundingClientRect();
+    return rect.width > 2 && rect.height > 2;
+  };
   const isOverflowScrollable = (el) => {
     if (!(el instanceof HTMLElement)) return false;
     const style = getComputedStyle(el);
@@ -706,6 +716,20 @@ function browserScrollCustomerList(options = {}) {
     return { ok: false, error: 'CHAT_LIST_CONTAINER_NOT_FOUND' };
   }
 
+  const findNoMoreTips = () => {
+    const host =
+      listContainer.closest('.chat-user, .user-container, .chat-container, .chat-main') || document;
+    const tips = Array.from(host.querySelectorAll('div[role="tfoot"] .load-tips, p.load-tips')).find((node) => {
+      if (!(node instanceof HTMLElement)) return false;
+      const text = normalize(node.textContent || '');
+      return text.includes('没有更多了') && isVisible(node);
+    });
+    return {
+      detected: Boolean(tips),
+      text: normalize(tips?.textContent || ''),
+    };
+  };
+
   const firstCard = listContainer.querySelector('div[role="listitem"]') || document.querySelector('div[role="listitem"]');
   if (firstCard instanceof HTMLElement) {
     const best = findBestScrollableContainer(firstCard);
@@ -714,6 +738,7 @@ function browserScrollCustomerList(options = {}) {
     }
   }
 
+  const noMoreBefore = findNoMoreTips();
   const before = {
     top: Number(listContainer.scrollTop || 0),
     height: Number(listContainer.scrollHeight || 0),
@@ -750,11 +775,18 @@ function browserScrollCustomerList(options = {}) {
     clientHeight: Number(listContainer.clientHeight || 0),
     cardCount: Number(listContainer.querySelectorAll('div[role="listitem"]').length || 0),
   };
+  const noMoreAfter = findNoMoreTips();
+  const atBottom = after.height <= after.clientHeight + 2 || after.top >= Math.max(0, after.height - after.clientHeight - 2);
 
   return {
     ok: true,
     before,
     after,
+    atBottom,
+    noMoreDetectedBefore: noMoreBefore.detected,
+    noMoreDetectedAfter: noMoreAfter.detected,
+    noMoreTextBefore: noMoreBefore.text,
+    noMoreTextAfter: noMoreAfter.text,
     didScroll:
       before.top !== after.top ||
       before.height !== after.height ||
@@ -1992,6 +2024,18 @@ function browserExtractResumeProfileFromModal() {
       normalized.includes('匿名牛人')
     );
   };
+  const stripNoiseText = (text) => {
+    let cleaned = normalize(text);
+    const noisePhrases = ['其他名企大厂经历牛人', '相似牛人', '推荐牛人', '匿名牛人'];
+    for (const phrase of noisePhrases) {
+      cleaned = cleaned.split(phrase).join(' ');
+    }
+    return normalize(cleaned);
+  };
+  const pickSectionText = (section) => {
+    if (!section) return '';
+    return stripNoiseText(section.innerText || section.textContent || '');
+  };
   const pickFirstText = (scope, selectors) => {
     for (const selector of selectors) {
       let nodes = [];
@@ -2057,6 +2101,8 @@ function browserExtractResumeProfileFromModal() {
       position: '',
       schools: [],
       majors: [],
+      resumeText: '',
+      evidenceCorpus: '',
     };
   }
 
@@ -2070,6 +2116,16 @@ function browserExtractResumeProfileFromModal() {
     root.querySelector('.geek-work-experience-wrap') ||
     root.querySelector('.resume-section[class*="work"]') ||
     root;
+  const projectSection =
+    root.querySelector('.resume-section.geek-project-experience-wrap') ||
+    root.querySelector('.geek-project-experience-wrap') ||
+    root.querySelector('.resume-section[class*="project"]') ||
+    null;
+  const skillSection =
+    root.querySelector('.resume-section.geek-skill-wrap') ||
+    root.querySelector('.geek-skill-wrap') ||
+    root.querySelector('.resume-section[class*="skill"]') ||
+    null;
   const baseSection =
     root.querySelector('.resume-section.geek-base-info-wrap') ||
     root.querySelector('.geek-base-info-wrap') ||
@@ -2102,6 +2158,21 @@ function browserExtractResumeProfileFromModal() {
     '.position span',
     '.position',
   ]);
+  const baseText = pickSectionText(baseSection);
+  const educationText = pickSectionText(educationSection);
+  const workText = pickSectionText(workSection);
+  const projectText = pickSectionText(projectSection);
+  const skillText = pickSectionText(skillSection);
+  const evidenceCorpus = stripNoiseText(root.innerText || root.textContent || '');
+  const resumeText = [
+    baseText ? `基础信息: ${baseText}` : '',
+    educationText ? `教育经历: ${educationText}` : '',
+    workText ? `工作经历: ${workText}` : '',
+    projectText ? `项目经历: ${projectText}` : '',
+    skillText ? `技能信息: ${skillText}` : '',
+  ]
+    .filter(Boolean)
+    .join('\n');
 
   return {
     ok: true,
@@ -2112,11 +2183,15 @@ function browserExtractResumeProfileFromModal() {
     position,
     schools,
     majors,
+    resumeText: resumeText || evidenceCorpus || '',
+    evidenceCorpus: evidenceCorpus || resumeText || '',
     debug: {
       rootClass: String(root.className || ''),
       educationClass: String(educationSection?.className || ''),
       workClass: String(workSection?.className || ''),
       wrapperClass: String(scope?.className || ''),
+      resumeTextLength: Number((resumeText || '').length),
+      evidenceCorpusLength: Number((evidenceCorpus || '').length),
     },
   };
 }

package/vendor/boss-chat-cli/src/cli.js

@@ -291,7 +291,7 @@ function printUsage() {
   console.log('');
   console.log('Run options:');
   console.log('  --dry-run                       Evaluate and click, but do not request resume');
-  console.log('  --no-state                      Do not persist processed candidate state');
+  console.log('  --no-state                      Disable in-run candidate deduplication');
   console.log('  --job <text|value|index>        Select job by label/value/index');
   console.log('  --criteria <text>               Screening criteria for resume evaluation');
   console.log('  --start-from <unread|all>       Start from unread or all list');