0 Fork 0

Files

T

Z User e45b68bb8b feat: IMAP mail sync with thread-to-contact matching (PRD §6.1)

Real IMAP connection via imapflow library:
- Connects to IMAP server (IMAPFlow, TLS on port 993)
- Fetches recent messages (configurable limit, default 20)
- Extracts: from, fromEmail, subject, date, snippet (200 chars)
- Thread-to-contact matching (PRD §6.1):
  1. Match sender email against persons table
  2. If no person match, extract domain and match against company.website
  3. Returns matchedCompany + matchedPerson for each email
- Audit-logged (action: crm.mailsync:imap)
- Zod validated (host, port, user, password, folder, limit)
- 502 on IMAP connection failure with detail
- 400 on validation failure

Tested: invalid creds → 502 'IMAP connection failed', missing host → 400

2026-10-27 22:50:50 +00:00

2.0 KiB

Executable File

Raw Blame History

name, description

name	description
gaokao-generate-report	合并考生信息、志愿列表、专业推荐与院校推荐，生成融合分析与冲稳保志愿列表的 HTML 志愿填报报告。适用于高考志愿报告生成、志愿填报方案输出、志愿表可视化。

生成志愿填报报告

本 Skill 是流水线的第五步：合并前序 JSON，渲染 HTML 报告。

上下游

上游：
- parsed.json（志愿列表）
- major_recommendation.json（专业推荐）
- school_recommendation.json（院校推荐）
输出：volunteer_report.html

环境准备

cd gaokao-generate-report
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

执行步骤

1. 合并为 analysis.json

python3 scripts/merge_analysis.py \
  --majors output/major_recommendation.json \
  --schools output/school_recommendation.json \
  -o output/analysis.json

merge_analysis.py 将专业推荐与院校推荐合并为 generate_html.py 所需的 analysis.json 结构。

2. 生成 HTML

python3 scripts/generate_html.py \
  -i output/parsed.json \
  -a output/analysis.json \
  -o output/volunteer_report.html

3. 交付用户

提供 volunteer_report.html 的绝对路径，并简要说明报告结构：

综合测评与建议（专业方向 + 院校策略）
志愿推荐列表（冲/稳/保，⭐ 推荐学校 / 🔥 推荐专业可点击查看详情）

合并前检查

检查项	说明
专业字段一致	`recommended_majors` 的 name/code 与 `parsed.json` 一致
院校字段一致	`recommended_schools` 的 name/code 与 `parsed.json` 一致
文案完整	`intro`、`strategy`、`school_strategy` 非空

若合并前发现推荐字段不匹配，应回到对应 Skill 修正 JSON。

附加资源

examples/analysis_merged_example.json — 合并后的完整结构示例

2.0 KiB Executable File Raw Blame History Unescape Escape