material-studio

name	material-studio
description	Render a pharma sales rep's marketing material into a self-contained mobile-portrait HTML page (digital business card + content) with a one-click export-as-long-image button. Use when generating festival greetings, industry news, latest research, or product/disease education materials to forward to a doctor's WeChat. Reads the rep profile from ~/.workbuddy/med-rep-profile.json and a content JSON.
agent_created	true

Material Studio — 医药代表物料渲染 Skill

把"代表名片信息 + 一份内容"渲染成一个自包含的手机竖版 HTML 单页，页面内置「一键导出长图」按钮。无后端依赖，浏览器打开即用。

文件结构

• templates/material_template.html — 简报版式模板（news/research/education 用：名片头 + 简报刊头 + 分板块内容 + 导出按钮）
• templates/greeting_template.html — 节日贺卡模板（type=greeting 专用）：节日氛围主视觉（月夜/红金等按节日配色）+ 祝福语 + 精简名片条 + 导出按钮
• scripts/render_material.py — 渲染脚本：读 profile + content JSON → 图片转 base64 → 输出 HTML；type=greeting 自动走贺卡模板并按节日匹配氛围配色（中秋月夜蓝金/春节国庆红金/端午青绿/医师节品牌蓝等）
• references/content-examples.md — 四种物料类型的 content.json 范例
• references/source-whitelist.md — 内容来源范围与合规口径（已审核，取材前必读）

取材边界（强制）

生成 news / research / education 内容前，必须先读 references/source-whitelist.md，只在批准来源内取材。research/education 白名单制；预印本/厂商内部数据/自媒体禁用；第三方咨询不具名；研究类来源（期刊/会议+年份）必标。节日问候不涉及外部来源。

使用流程

1. 确保代表名片信息已存在

路径：~/.workbuddy/med-rep-profile.json。不存在则先向代表索要并创建，字段：

{
  "name": "李慧",
  "company": "XX医药集团",
  "title": "医药经理",
  "filingNo": "京械备20260408号",
  "phone": "151-011-12345",
  "email": "[e-mail]",
  "qrcodePath": "/绝对路径/wechat_qr.png",
  "avatarPath": "",
  "brandColor": "#2668EB"
}

qrcodePath / avatarPath 为本地图片绝对路径；脚本会自动转成 base64 内嵌，导出长图不丢图。avatarPath 留空则用姓名首字渲染圆形头像。

2. 写内容 JSON（简报版式）

根据物料类型构造 content.json（四种类型完整范例见 references/content-examples.md）。字段：

• type：card | greeting | news | research | education
  • card 电子名片：只渲染代表本人名片（无内容板块），content 仅需 {"type":"card"}，信息全取自 profile。一次生成两张：竖版（card_template.html 独立精致卡，文件名 _竖版）+ 横版（card_h_template.html 简报名片头样式，文件名 _横版），供代表按场景挑用、单独导出。
• column：刊头栏目名（缺省按类型默认）
• issue：期号（可选，如 第 12 期）
• headline：大标题
• gen_date：生成日期 YYYY-MM-DD，体现新鲜度；缺省自动取今天
• fresh_tag：新鲜度标签（缺省按类型取，如 报告研读/热点速递），与 gen_date 一起显示在刊头徽标
• recipient：发送对象 {dept, name}（可选），刊头显示"致：肿瘤科 张三大夫"，内容应据此定向
• lead：开场导语（可选，代表口吻，勿用"编者按"）
• sections[]：板块数组，每个 {name, items[]}；item = {title, rows[]?, text?, src?}，row = {lbl, val}（结构化多行，如 研究/发现/临床意义）
• summary：本期小结（可选）
• greeting：（仅 type=greeting）{festival, lines[]}
• occasion：（仅 type=greeting）设 "birthday" 触发生日贺卡子类型（暖色玫瑰粉调）；festival 含"生日"亦自动识别。注：贺卡顶部不放具体图标（月亮/蛋糕已移除），仅渐变背景+光晕氛围

追求"简报级"信息密度：开场导语 → 分板块 → 本期小结，条目用 rows 多行展开并带具体数据（PFS/OS/HR/ORR/P值/样本量）。research 类每条 item 的 src 必填。避免给医生复述其本人领衔的研究。

3. 渲染

python3 scripts/render_material.py \
  --content /tmp/content.json \
  --out "物料_最新研究_20260628.html"

--profile 默认 ~/.workbuddy/med-rep-profile.json，一般无需指定。输出 HTML 写到 --out 指定路径（建议当前工作目录）。

4. 交付

用 present_files 展示输出的 HTML。告诉代表：浏览器打开 → 点右下角「📥 导出长图」→ 下载竖版长图 → 转发给医生。

合规要点（渲染前由 Agent 把关）

• 内容已过合规自检后才渲染（不夸大、不超适应症、研究标来源、学术陈述）。
• 模板底部固定声明"仅供医疗卫生专业人士参考"，备案号自动出现在底部。

注意

• html2canvas 已离线内联：模板用 {{HTML2CANVAS_INLINE}} 占位，脚本渲染时把 templates/html2canvas.min.js 源码内联进 HTML。产出的 HTML 完全自包含、零外部依赖，断网/微信内置浏览器/内网都能正常导出长图，无需部署。
• 手机端导出存相册：导出按钮在手机上不走 <a download>（手机不支持），而是弹出全屏浮层显示生成的图片并提示"长按保存到相册"；桌面端仍自动下载 PNG。靠 UA 判断分流。
• 交付方式：可直接把这个单 HTML 文件发给代表（微信/浏览器打开即用），无需任何服务器或公网链接。
• 主色取 profile 的 brandColor，浅色底色由脚本自动派生。

合图自动切图（Agent 工作流）

当代表上传的图片是合并了头像和二维码的合图（如企业微信名片截图）时，Agent 按以下工作流处理，自动切出头像和二维码并更新 profile。

工作流

1. 视觉分析：用 Agent 视觉能力分析图片，识别头像区和二维码区。
2. 输出归一化坐标（0.0~1.0），格式 x1,y1,x2,y2（左上→右下），例如：
   • 头像区：0.05,0.05,0.25,0.25
   • 二维码区：0.70,0.60,0.95,0.95
3. 裁剪保存（二选一）：
   • 方式 A（推荐）：调用 scripts/crop_card_image.py：

     python3 scripts/crop_card_image.py <图片路径> \
       --avatar 0.05,0.05,0.25,0.25 \
       --qr 0.70,0.60,0.95,0.95 \
       --out-dir ~/.workbuddy/cropped
     

   • 方式 B：Agent 直接用 Python PIL 裁剪（当前 turn 内完成）。
4. 更新 profile：将 avatarPath 和 qrcodePath 指向裁剪后的文件，写回 ~/.workbuddy/med-rep-profile.json。

坐标说明

区域	x1（左）	y1（上）	x2（右）	y2（下）
头像（通常在左上方）	~0.05	~0.05	~0.25	~0.25
二维码（通常在右下方）	~0.70	~0.60	~0.95	~0.95

实际坐标由 Agent 视觉分析确定，上表仅为典型参考。企业微信名片截图一般头像在左、二维码在右。

提示

• 若代表分别上传了头像图和二维码图，无需裁剪，直接更新 profile 对应字段。
• 裁剪后头像建议为正方形，二维码为正方形或略高长方形。
• crop_card_image.py 输出 JSON 到 stdout：{"avatar": "...", "qrcode": "..."}。
• 每次代表重新上传图片时，重复此工作流。

医生画像系统

Agent 维护一个医生画像库，记住每位医生的信息，实现"越用越聪明"。

存储

• 路径：~/.workbuddy/med-rep-doctors.json
• 管理脚本：scripts/doctor_profile.py

命令

# 添加/更新医生
python3 scripts/doctor_profile.py add --name "YY" --dept "肿瘤科" \
  --hospital "上海市胸科医院" --field "非小细胞肺癌,EGFR靶向,免疫治疗" \
  --level "kol" --birthday "1963-05-20"

# 查询医生画像
python3 scripts/doctor_profile.py get --name "YY"

# 列出所有医生
python3 scripts/doctor_profile.py list

# 记录一次触达（生成物料后自动调用）
python3 scripts/doctor_profile.py touch --name "YY" --type "research" --topic "ASCO 2026 NSCLC研究"

# 触达建议（哪些医生该联系了）
python3 scripts/doctor_profile.py suggest

# 7天内生日提醒
python3 scripts/doctor_profile.py birthday-check

Agent 工作流集成

1. 首次提及医生时：查询画像库，存在则自动填充科室/领域/历史；不存在则在物料生成后自动 add。
2. 生成物料后：自动 touch 记录本次触达类型和主题。
3. 每次会话开始时（可选）：运行 suggest 和 birthday-check，主动告知代表。
4. 内容定向：基于 fields 字段自动添加联网检索关键词。
5. 防撞车：基于 lastTopics 检查是否短期内发过类似内容。

医生 level 与语气映射

level	含义	语气建议
kol	学科带头人/KOL	学术平视，呈现信息增量，不啰嗦背景
director	科主任/副主任	专业简洁，可点到临床意义
attending	主治医师	可稍多展开背景和解释
community	社区/基层医生	偏实操性，贴近指南落地和用药建议

物料资产库

每份生成的物料自动归档索引，支持回溯、复用、去重。

存储

• 路径：~/.workbuddy/med-rep-materials-index.json
• 管理脚本：scripts/materials_index.py

命令

# 索引新物料（生成后自动调用）
python3 scripts/materials_index.py add --type "research" --recipient "YY教授" \
  --dept "肿瘤科" --headline "ASCO 2026 NSCLC研究" \
  --topics "NSCLC,EGFR,ADC" --filepath "/path/to/file.html"

# 查询某医生的历史物料
python3 scripts/materials_index.py query --recipient "YY"

# 列出最近物料
python3 scripts/materials_index.py list --limit 20

# 检查是否重复（14天内同类型同主题）
python3 scripts/materials_index.py check-dup --recipient "YY" --type "research" --topic "EGFR"

Agent 工作流集成

1. 生成物料后：自动 add 索引。
2. 生成前：check-dup 检查是否短期重复，重复则提醒代表并建议换角度。
3. 复用场景："把上次给陆教授的研究更新一下" → query 找到旧文件 → 更新内容 → 重新渲染。
4. 批量生成："帮我把这条热点分别发给 3 位医生" → 循环生成个性化版本并逐一索引。

内容个性化引擎

Agent 根据医生画像自动调整内容策略和语气。

规则

1. 领域定向：基于画像 fields，联网检索时自动叠加关键词限定（如"EGFR耐药""MET扩增"）。
2. 语气匹配：按 level 字段选择语气（见上方映射表）。
3. 历史去重：读取画像 lastTopics[] + 资产库 check-dup，避免重复内容。
4. PI规避：若医生是某研究的 PI/通讯作者，不详细复述其本人研究。
5. 关联推荐：基于上次物料主题，建议本次跟进方向（如上次发 EGFR 靶向，本次建议发耐药后方案）。

多轮迭代机制

支持代表对已生成物料进行快速微调，不必从头重做。

支持的微调指令

代表说	Agent 动作
"换第二条研究"	只替换 sections[x].items[1]，重新渲染
"语气再正式一点"	调整 lead + 各 item.rows 的措辞
"加个数据/加条研究"	在对应 section 追加 item
"删掉第三板块"	移除 sections[2]，重新渲染
"出个简版"	每板块只保留 1 条核心 item
"出个朋友圈卡片"	提取 headline + 1 句 summary，生成正方形卡片

实现方式

• Agent 保存上一份 content.json（在对话上下文中）
• 微调时只修改对应字段，调用 render_material.py 重新渲染
• 不需要重新联网（除非代表要求"换一条研究"）

模板沉淀与复用

每次生成物料后自动将 content.json 保存为可复用模板。

模板存储

• 路径：~/.workbuddy/med-rep-templates/
• 文件命名：{type}_{场景关键词}.json（如 greeting_建党节.json、research_NSCLC.json）
• 内容：完整 content.json，但 recipient 留空

复用命令

# 列出所有模板
ls ~/.workbuddy/med-rep-templates/

# 复用模板（Agent 加载模板 → 替换 recipient → 渲染）
python3 scripts/render_material.py --content /tmp/reused_content.json --out "物料_XX.html"

触发场景

• "再做一张建党节贺卡" → 加载 greeting_建党节.json，替换 recipient 后直接渲染
• "用上次的模板" → 列出匹配模板，复用
• "看看我有哪些模板" → 列出已有模板

触达时机建议

Agent 可主动建议代表何时、给谁发什么。

触发场景

1. 代表说"帮我看看该给谁发了" → 运行 doctor_profile.py suggest
2. 代表说"最近有什么可以发的" → 结合时事（大会/政策）+ 画像中的 fields 推荐内容方向
3. 生日临近 → 运行 birthday-check，主动提示
4. 超过 14 天未触达 → 在 suggest 结果中标记

节奏管理原则

• 每位医生建议每月 2-3 次触达（含节日问候）
• 同一类型连续发不超过 2 次（如连续 2 次都是 research，建议下次换 news 或 greeting）
• KOL 频率可适当降低（月 1-2 次），关系维护型医生可更频繁

视觉增强

品牌模板配色

除默认腾讯健康蓝外，profile 中 brandColor 可设为药企品牌色，脚本自动派生浅色系：

药企	建议 brandColor
阿斯利康	#830051（紫红）
辉瑞	#0093D0（辉瑞蓝）
恒瑞	#E31937（恒瑞红）
默沙东	#00857C（绿松石）
罗氏	#0066CC（罗氏蓝）
诺华	#0460A9（诺华蓝）

朋友圈卡片（规划中）

正方形 1:1 比例的单条摘要卡，含 headline + 1 句核心结论 + 名片精简条。适合朋友圈分享场景。

贺卡 CSS 动效（规划中）

节日贺卡可选开启轻量动画（飘落雪花/升起光点），通过 @media (prefers-reduced-motion) 尊重用户偏好。