weaver-work-cli 0.1.42 → 0.1.44

package/skills/weaver-e10-reception-flow/scripts/render.py

@@ -0,0 +1,724 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+render.py — 一次把接待信息渲染成两份产物（对外 docx + 内部 md）
+
+为什么要有它：原流程每次都让模型现场写 python-docx 代码，既慢又容易踩
+「模板 444 只读 -> shutil.copy 复制权限位 -> d.save() 抛 PermissionError」这个坑。
+本脚本把踩过的坑固化成代码：
+
+  1) 复制模板一律用 copyfile（不复制权限位）+ 落盘后 chmod 644
+  2) 表格行数按实际行程自动增删（克隆末行以保留版式）
+  3) 段落按文本前缀定位，模板微调不会错位
+  4) 对外件自动剔除内部口径（分工/待办/金额/审批）
+
+用法：
+  python3 scripts/render.py --data recv.json --out-dir /workspace/files
+  python3 scripts/render.py --data recv.json --out-dir ./recv --only docx|md
+
+输入 JSON（字段均可缺省，缺省即不写）：
+{
+  "customer": "某某集团有限公司",
+  "headcount": 5,
+  "visitDate": "2026-10-22",
+  "visitType": "参观上海总部",
+  "contact": "张三（泛微网络 XX中心 XX组）",
+  "companions": [{"name": "张三", "mobile": "13800138000"}],
+  "demand": "商务洽谈 + 技术交流",
+  "pickup": "", "meal": "食堂用餐", "mealHeadcount": 6,
+  "hotel": "无需住宿", "gift": "不需要伴手礼", "agendaStart": "09:30",
+  "venue": "泛微网络 上海总部", "meetingRoom": "总部129会议室",
+  "schedule": [["上午","抵达泛微上海总部，签到与欢迎","泛微上海总部"]],
+  "todo": ["客户性质", "项目金额（万元）"]
+}
+"""
+import argparse, json, os, re, shutil, sys, datetime, hashlib
+
+try:
+    import docx
+    from docx.shared import Pt
+except ImportError:
+    docx = None
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+TPL = os.path.join(HERE, '..', 'assets', '行程单模板-泛微.docx')
+WEEK = '一二三四五六日'
+
+# v2.8：对外件内部口径清洗（原版只剔段落级内部字段，表格与地点里的
+# 「（具体单位待确认）」「待确认」会原样漏到客户版，属产物质量缺陷）
+INTERNAL_MARKS = ('待确认', '待补', '待定', '待办', '内部', '未定', 'TBD', 'tbd')
+EXTERNAL_FALLBACK = '以现场安排为准'
+_PAREN = re.compile(r'[（(][^（()）]*[)）]')
+
+
+def has_mark(v):
+    return any(k in str(v or '') for k in INTERNAL_MARKS)
+
+
+def ext(v, fallback=EXTERNAL_FALLBACK):
+    """对外件取值：先剥掉含内部口径的括注，整串仍带内部口径则用兜底语。"""
+    s = str(v or '').strip()
+    if not s:
+        return ''
+    for _ in range(3):
+        s2 = _PAREN.sub(lambda m: '' if has_mark(m.group(0)) else m.group(0), s).strip()
+        if s2 == s:
+            break
+        s = s2
+    if not s or has_mark(s):
+        return fallback
+    return s
+
+
+_RE_NUM = re.compile(r'\d+(?:\.\d+)?')
+
+
+def num(v, default=0):
+    """人数类字段取数：兼容 8 / "8" / "6~10人" 等写法。
+    区间取上界：用餐与场地按人数上限预留更安全；无法解析时返回 default。"""
+    if v is None or isinstance(v, bool) or v == '':
+        return default
+    if isinstance(v, (int, float)):
+        return int(v)
+    nums = _RE_NUM.findall(str(v))
+    if not nums:
+        return default
+    try:
+        return max(int(float(n)) for n in nums)
+    except (TypeError, ValueError):
+        return default
+
+
+def ppl(v):
+    """人数展示：剥掉「左右/上下/余人」等模糊尾巴与「人/位/名」量词，避免「约8人左右 人」。"""
+    if v is None or v == '':
+        return ''
+    s = re.sub(r'(左右|上下|多人|余人|以上|以下|人|位|名)\s*$', '', str(v).strip()).strip()
+    return re.sub(r'[\s人位名]+$', '', s).strip()
+
+
+def scan_docx(path):
+    """自检：对外件里是否还残留内部口径（有残留就是质量缺陷，要报出来）。"""
+    try:
+        dd = docx.Document(path)
+    except Exception:
+        return {'externalLeaks': 0, 'leakSamples': []}
+    lines = []
+    for p in dd.paragraphs:
+        if p.text.strip():
+            lines.append(p.text)
+    para = len(lines)
+    for t in dd.tables:
+        for row in t.rows:
+            for c in row.cells:
+                if c.text.strip():
+                    lines.append(c.text)
+    leaks = [ln for ln in lines if has_mark(ln)]
+    return {'externalLeaks': len(leaks), 'leakSamples': leaks[:3], 'paragraphs': para}
+
+
+def sha8(path):
+    """产物指纹前 8 位：给上层 verify 用，让模型不必 cat 全文就能确认文件是刚生成的那份。"""
+    try:
+        with open(path, 'rb') as f:
+            return hashlib.sha256(f.read()).hexdigest()[:8]
+    except Exception:
+        return ''
+
+
+def prepare_target(path):
+    """目标已存在且为只读时先放开权限，否则 copyfile/open('w') 会直接 PermissionError。"""
+    if os.path.exists(path):
+        try:
+            os.chmod(path, 0o644)
+        except OSError:
+            pass
+
+
+def safe_write(path):
+    """落盘后统一放开权限，避免只读模板把后续步骤卡死。"""
+    try:
+        os.chmod(path, 0o644)
+    except OSError:
+        pass
+
+
+def cn_date(s):
+    try:
+        d = datetime.date.fromisoformat(s)
+        return f'{d.year}年{d.month}月{d.day}日（星期{WEEK[d.weekday()]}）'
+    except Exception:
+        return s or ''
+
+
+def set_para(p, text):
+    if p.runs:
+        p.runs[0].text = text
+        for r in p.runs[1:]:
+            r.text = ''
+    else:
+        p.add_run(text)
+
+
+def fill_para(doc, prefix, text):
+    """按前缀定位段落并改写；前缀不中时退化为包含匹配（模板里有「1月2日参观行程安排：」这类前缀不固定的行）；仍不中则追加。"""
+    for p in doc.paragraphs:
+        if p.text.strip().startswith(prefix):
+            set_para(p, text)
+            return True
+    for p in doc.paragraphs:
+        if prefix in p.text:
+            set_para(p, text)
+            return True
+    doc.add_paragraph(text)
+    return False
+
+
+def resize_table(table, need_rows):
+    """need_rows = 数据行数（不含表头）。克隆末行以保留边框与字体。"""
+    import copy
+    have = len(table.rows) - 1
+    if need_rows > have:
+        for _ in range(need_rows - have):
+            tr = copy.deepcopy(table.rows[-1]._tr)
+            table.rows[-1]._tr.addnext(tr)
+    elif need_rows < have:
+        for _ in range(have - need_rows):
+            tr = table.rows[-1]._tr
+            tr.getparent().remove(tr)
+
+
+SCHED_KEYS = {
+    'date': ('date', '日期', 'rq'),
+    'time': ('time', '时间', '时段', 'sj'),
+    'item': ('item', '接待事项', '事项', 'jdsx'),
+    'place': ('place', '地点', 'venue', 'dd'),
+    'person': ('person', '接待人员', '人员', 'jdry'),
+    'activity': ('activity', '活动安排', '安排', 'hdap'),
+    'remark': ('remark', '备注', 'bz'),
+}
+SCHED_ORDER = ['date', 'time', 'item', 'place', 'person', 'activity', 'remark']
+
+
+def _pick(row, key):
+    for alias in SCHED_KEYS[key]:
+        if alias in row and row.get(alias) not in (None, ''):
+            return row.get(alias)
+    return ''
+
+
+def norm_schedule(d):
+    """把 schedule 归一成 7 字段行（date/time/item/place/person/activity/remark）。
+
+    v4.7：既兼容旧的三元组 [时段, 安排, 地点]，也接受 7 字段对象（中英文键均可），
+    产出的结构同时用于对外行程单、内部方案与流程【日程明细】子表。
+    """
+    rows = []
+    for raw in (d.get('schedule') or []):
+        if isinstance(raw, dict):
+            rows.append({k: _pick(raw, k) for k in SCHED_ORDER})
+        elif isinstance(raw, (list, tuple)):
+            vals = list(raw) + [''] * 7
+            rows.append({
+                'date': vals[0] if len(raw) >= 7 else '',
+                'time': vals[0] if len(raw) < 7 else vals[1],
+                'item': vals[1] if len(raw) < 7 else vals[2],
+                'place': vals[2] if len(raw) < 7 else vals[3],
+                'person': '' if len(raw) < 7 else vals[4],
+                'activity': '' if len(raw) < 7 else vals[5],
+                'remark': '' if len(raw) < 7 else vals[6],
+            })
+    return rows
+
+
+# ==================== v4.9：标准议程 + 陪同人员联系方式 ====================
+# 对外行程单只呈现「公司参观 → 方案介绍 → 讨论交流」这类议程环节。
+# 用餐、接送、住宿、返程等后勤动作一律不进时间表（它们写在行程单抬头
+# 与内部方案的「食宿与用车」章节），这是接待口径不是报错。
+AGENDA_EXCLUDE = (
+    '用餐', '午餐', '晚餐', '早餐', '午宴', '晚宴', '宴请', '食堂', '餐厅', '饭',
+    '接机', '接站', '送机', '送站', '接送', '用车', '车辆', '商务车', '大巴',
+    '住宿', '入住', '离店', '酒店', '返程', '接返', '出发去机场',
+)
+# (展示名, 起始偏移分钟, 时长分钟, 活动说明缺省值)
+STANDARD_AGENDA = (
+    ('公司参观', 0, 45, '参观泛微上海总部展厅与办公区，了解公司发展历程与产品能力'),
+    ('方案介绍', 45, 75, ''),
+    ('讨论交流', 120, 30, '双方围绕关注点交流答疑，明确后续推进节奏'),
+)
+DEFAULT_START = '09:30'
+
+
+def _hm(minutes):
+    return f'{minutes // 60:02d}:{minutes % 60:02d}'
+
+
+def _parse_hm(s):
+    m = re.match(r'^\s*(\d{1,2})[:：](\d{2})\s*$', str(s or ''))
+    if not m:
+        return None
+    h, mi = int(m.group(1)), int(m.group(2))
+    return h * 60 + mi if (0 <= h <= 23 and 0 <= mi <= 59) else None
+
+
+def is_logistics(text):
+    """判断一行是否属于用餐/接送/住宿类后勤动作（不进议程时间表）。"""
+    s = str(text or '')
+    return any(k in s for k in AGENDA_EXCLUDE)
+
+
+def _agenda_row(start, end, item, activity='', place='', person='', remark=''):
+    return {
+        'start': start, 'end': end,
+        'time': f'{start}-{end}' if (start and end) else (start or end),
+        'item': item, 'activity': activity, 'place': place,
+        'person': person, 'remark': remark,
+    }
+
+
+def norm_agenda(d):
+    """行程归一为「议程行」，自动剔除用餐/接送/住宿等后勤动作。
+
+    取值优先级：
+      1) data.agenda 显式议程（逐行 time/start+end/item/activity/place/person）
+      2) data.schedule 中剔除后勤动作后的行（保留客户真实时间）
+      3) 标准议程：公司参观 → 方案介绍 → 讨论交流（起点 data.agendaStart，缺省 09:30）
+    """
+    venue = str(d.get('venue') or '泛微上海总部').strip()
+    room = str(d.get('meetingRoom') or '').strip() or venue
+
+    explicit = [r for r in (d.get('agenda') or []) if isinstance(r, dict)]
+    if explicit:
+        rows = []
+        for r in explicit:
+            start = str(r.get('start') or r.get('time') or '').strip()
+            end = str(r.get('end') or '').strip()
+            rows.append(_agenda_row(
+                start, end,
+                str(r.get('item') or r.get('name') or '').strip(),
+                str(r.get('activity') or '').strip(),
+                str(r.get('place') or r.get('venue') or '').strip(),
+                str(r.get('person') or '').strip(),
+                str(r.get('remark') or '').strip(),
+            ))
+        return rows
+
+    base = _parse_hm(d.get('agendaStart')) or _parse_hm(DEFAULT_START)
+    demand = str(d.get('demand') or '').strip()
+    rows = []
+    for name, off, dur, act in STANDARD_AGENDA:
+        start, end = _hm(base + off), _hm(base + off + dur)
+        if name == '方案介绍':
+            act = act or (demand or '泛微数字化运营平台整体方案介绍')
+        row = _agenda_row(start, end, name, act, venue if name == '公司参观' else room)
+        row['dur'] = dur
+        rows.append(row)
+
+    # 真实行程里已有对应环节时，用客户的实际时间/地点/人员覆盖标准环节，
+    # 保证输出恒为「公司参观—方案介绍—讨论交流」三段，但时间贴合实际。
+    alias = (
+        ('公司参观', ('参观', '展厅', '走访')),
+        ('方案介绍', ('介绍', '演示', '讲解', '汇报', 'PPT', 'ppt', '方案')),
+        ('讨论交流', ('交流', '讨论', '答疑', '座谈', '洽谈', '沟通')),
+    )
+    for r in norm_schedule(d):
+        blob = ' '.join([str(r.get('item') or ''), str(r.get('activity') or '')])
+        if is_logistics(blob):
+            continue
+        t = str(r.get('time') or '').strip()
+        parts = [p for p in re.split(r'\s*[-—~至到]+\s*', t) if p.strip()]
+        st = parts[0].strip() if parts else ''
+        en = parts[1].strip() if len(parts) >= 2 else ''
+        for idx, (nm, keys) in enumerate(alias):
+            if any(k in blob for k in keys):
+                row = rows[idx]
+                if st:
+                    if not en:
+                        _s = _parse_hm(st)
+                        en = _hm(_s + int(row.get('dur') or 45)) if _s is not None else ''
+                    row['start'], row['end'] = st, en
+                    row['time'] = f'{st}-{en}' if en else st
+                if r.get('place'):
+                    row['place'] = r.get('place')
+                if r.get('person'):
+                    row['person'] = r.get('person')
+                if r.get('activity') and not row['activity']:
+                    row['activity'] = r.get('activity')
+                break
+
+    prev_end = None
+    for row in rows:
+        st = _parse_hm(row.get('start'))
+        if prev_end is not None and st is not None and st < prev_end:
+            st = prev_end
+            row['start'] = _hm(st)
+            row['end'] = _hm(st + int(row.get('dur') or 45))
+            row['time'] = f"{row['start']}-{row['end']}"
+        en = _parse_hm(row.get('end'))
+        if en is None and st is not None:
+            en = st + int(row.get('dur') or 45)
+            row['end'] = _hm(en)
+            row['time'] = f"{row['start']}-{row['end']}"
+        if en is not None:
+            prev_end = en if prev_end is None else max(prev_end, en)
+    for row in rows:
+        row.pop('dur', None)
+    return rows
+
+
+MOBILE_RE = re.compile(r'^1[3-9]\d{9}$')
+
+
+def _mobile_of(x):
+    """v4.10：只取手机号（11 位）。座机 telephone、脱敏串一律不取、不回退。"""
+    if not isinstance(x, dict):
+        return ''
+    for k in ('mobile', 'mobile_plain', 'cellphone', 'phone_mobile', '手机号'):
+        v = str(x.get(k) or '').strip()
+        if not v or 'desensiti' in v.lower():
+            continue
+        v = re.sub(r'[\s-]', '', v)
+        if MOBILE_RE.match(v):
+            return v
+    return ''
+
+
+def norm_companions(d):
+    """陪同人员归一：[{name, phone}]。
+
+    v4.10 口径：phone 只认手机号（11 位）。座机（telephone）不再作为兜底，
+    取不到手机号就只写姓名，对外件不出现内部口径。
+    """
+    out = []
+    for x in (d.get('companions') or []):
+        if isinstance(x, dict):
+            nm = str(x.get('name') or x.get('text') or '').strip()
+            tel = _mobile_of(x)
+        else:
+            s = str(x or '').strip()
+            nm, tel = s, ''
+            m = re.search(r'[（(]([^（()）]*)[)）]', s)
+            if m:
+                inner = m.group(1).strip()
+                # 只有「11 位手机号」的括注才当电话；"张三(SH)" 这类机构后缀保留原名
+                if MOBILE_RE.match(re.sub(r'[\s-]', '', inner)):
+                    tel = re.sub(r'[\s-]', '', inner)
+                    nm = (s[:m.start()] + s[m.end():]).strip()
+        if nm:
+            out.append({'name': nm, 'phone': tel})
+    return out
+
+
+def contact_line(d):
+    """接待人员展示串：姓名（电话）；无电话只写姓名，不写「待补」。"""
+    parts = []
+    for c in norm_companions(d):
+        parts.append(f"{c['name']}（{c['phone']}）" if c['phone'] else c['name'])
+    if parts:
+        return '、'.join(parts)
+    return str(d.get('contact') or '').strip()
+
+
+def sched_cells(row):
+    """议程行 -> 对外行程单/内部方案的三列表格（时间 | 安排 | 地点）。"""
+    t = row.get('time') or ''
+    item = row.get('item') or ''
+    act = row.get('activity') or ''
+    main = item if not act else (f'{item}：{act}' if item else act)
+    return [t, main, row.get('place') or '']
+
+
+def build_docx(d, out_path):
+    os.makedirs(os.path.dirname(out_path) or '.', exist_ok=True)
+    prepare_target(out_path)
+    # 关键：copyfile 不复制 444 权限位（用 shutil.copy 会把只读位一起带过去）
+    shutil.copyfile(TPL, out_path)
+    safe_write(out_path)
+
+    doc = docx.Document(out_path)
+    customer = d.get('customer', '')
+    visit_date = d.get('visitDate', '')
+    venue = d.get('venue') or '泛微网络 上海总部'
+
+    cleaned = []
+
+    def ext_track(field, raw):
+        val = ext(raw)
+        if str(raw or '').strip() != val:
+            cleaned.append(f'{field}: {raw} -> {val or "（不写）"}')
+        return val
+
+    venue = ext_track('参观地点', venue)
+    fill_para(doc, '参观时间', f'参观时间：{cn_date(visit_date)}')
+    fill_para(doc, '参观地点', f'参观地点：{venue}')
+    fill_para(doc, '莅临领导', f'莅临领导：贵司各位来宾（共 {ppl(d.get("headcount"))} 人）' if d.get('headcount') else '莅临领导：贵司各位来宾')
+    contact_ext = ext_track('接待人员', contact_line(d) or '泛微接待团队')
+    fill_para(doc, '接待人员', f'接待人员：{contact_ext}')
+    if visit_date:
+        fill_para(doc, '参观行程安排', f'{cn_date(visit_date).split("（")[0]}参观行程安排：')
+
+    schedule = [sched_cells(r) for r in norm_agenda(d)]
+    if doc.tables and schedule:
+        t = doc.tables[0]
+        resize_table(t, len(schedule))
+        for i, row in enumerate(schedule, start=1):
+            cells = t.rows[i].cells
+            for ci, (cell, val) in enumerate(zip(cells, list(row) + ['', '', ''])):
+                ps = cell.paragraphs
+                txt = '' if val is None else str(val)
+                # 地点列（第 3 列）与任何含内部口径的单元格统一走对外口径
+                if ci == 2:
+                    txt = ext_track('行程地点', txt)
+                elif has_mark(txt):
+                    txt = ext_track('行程安排', txt)
+                set_para(ps[0], txt)
+                for extra in ps[1:]:
+                    set_para(extra, '')
+
+    doc.add_paragraph('具体时间安排以现场为准；如有调整，我们将第一时间与贵司沟通。')
+    doc.save(out_path)
+    safe_write(out_path)
+    qa = scan_docx(out_path)
+    qa['cleaned'] = cleaned
+    return out_path, qa
+
+
+def norm_cases(d):
+    """案例参考：兼容字符串 / 对象 / {items|list} 三种写法，字段名给多个别名。
+    只取能落到表格的内容；空则整段不出（不写"暂无案例"）。"""
+    raw = d.get('cases') or []
+    if isinstance(raw, dict):
+        raw = raw.get('items') or raw.get('list') or raw.get('cases') or []
+    if not isinstance(raw, list):
+        return []
+    out = []
+    for c in raw:
+        if isinstance(c, str):
+            s = c.strip()
+            if s:
+                out.append({'title': s, 'relevance': '', 'date': ''})
+        elif isinstance(c, dict):
+            title = str(c.get('title') or c.get('material') or c.get('name') or '').strip()
+            rel = str(c.get('relevance') or c.get('point') or c.get('why') or '').strip()
+            date = str(c.get('date') or c.get('time') or c.get('when') or '').strip()
+            if title or rel:
+                out.append({'title': title, 'relevance': rel, 'date': date})
+    return out
+
+
+def norm_experts(d):
+    """专家参考：兼容字符串 / 对象 / {items|list}，字段名给多个别名。
+    只取能落到表格的内容；空则整段不出。"""
+    raw = d.get('experts') or []
+    if isinstance(raw, dict):
+        raw = raw.get('items') or raw.get('list') or raw.get('experts') or []
+    if not isinstance(raw, list):
+        return []
+    out = []
+    for e in raw:
+        if isinstance(e, str):
+            s = e.strip()
+            if s:
+                out.append({'name': s, 'dept': '', 'relevance': ''})
+        elif isinstance(e, dict):
+            name = str(e.get('name') or e.get('expert') or e.get('person') or '').strip()
+            dept = str(e.get('dept') or e.get('department') or e.get('role') or e.get('title') or '').strip()
+            rel = str(e.get('relevance') or e.get('point') or e.get('match') or e.get('why') or '').strip()
+            if name or dept or rel:
+                out.append({'name': name, 'dept': dept, 'relevance': rel})
+    return out
+
+
+def _cell(s):
+    """表格单元格：竖线会截断表格，换行会断行，统一压平。"""
+    return str(s or '').replace('|', '／').replace('\n', ' ').strip() or '—'
+
+
+_CJK_NUM = ['一', '二', '三', '四', '五', '六', '七', '八', '九', '十', '十一', '十二']
+
+
+def build_md(d, out_path):
+    os.makedirs(os.path.dirname(out_path) or '.', exist_ok=True)
+    prepare_target(out_path)
+    L = []
+    A = L.append
+    _n = [0]
+
+    def sec(t):
+        """章节号自增：中间插章节时无需手改后面所有编号。"""
+        _n[0] += 1
+        return f'## {_CJK_NUM[_n[0] - 1]}、{t}\n'
+
+    A(f'# 客户接待交流参考文档（内部）\n')
+    A(f'> 编制日期：{datetime.date.today().isoformat()}　|　流程：泛微客户参观接待流程（草稿，待发起）　|　内部文件，未经许可不得外发\n')
+
+    A(sec('客户与来访信息'))
+    A('| 项目 | 内容 |')
+    A('| --- | --- |')
+    A(f'| 来访客户 | {d.get("customer", "待补")} |')
+    A(f'| 来访人数 | {ppl(d.get("headcount", "待补"))} 人 |' if d.get('headcount') else '| 来访人数 | 待补 |')
+    A(f'| 客户带队人 / 来访名单 | {d.get("visitors") or "待补"} |')
+    A(f'| 客户性质 | {d.get("nature") or "待补（流程必填项，请在界面选择）"} |')
+    A(f'| 参观日期 | {cn_date(d.get("visitDate")) or "待补"} |')
+    A(f'| 参观类型 | {d.get("visitType") or "待补"} |')
+    A(f'| 客户需求 | {d.get("demand") or "待补"} |')
+    A(f'| 主联络人 | {d.get("contact") or "待补"} |')
+    A(f'| 项目金额 | {d.get("amount") or "待补（不在本方案中估算）"} |')
+    A('')
+
+    A(sec('接待目标'))
+    A('1. 向来访客户完整展示泛微上海总部办公环境、产品与数智化能力，建立直观认知。')
+    A('2. 围绕商务合作模式与技术实现路径开展双向沟通，明确客户关注点与后续推进节奏。')
+    A('3. 通过规范、有温度的接待流程，强化客户对泛微交付能力与服务体系的信任。\n')
+
+    # 案例参考：仅当有搜索结果时成章（软依赖，取不到就整段省略）
+    cases = norm_cases(d)
+    if cases:
+        A(sec('相关案例参考'))
+        note = str(d.get('casesNote') or '').strip()
+        if note:
+            A(f'> {note}\n')
+        A('| 材料 | 与本次拜访的关联 | 时间 |')
+        A('| --- | --- | --- |')
+        for c in cases:
+            A(f'| {_cell(c["title"])} | {_cell(c["relevance"])} | {_cell(c["date"])} |')
+        A('')
+
+    # 专家参考：同样软依赖，没有就整段省略
+    experts = norm_experts(d)
+    if experts:
+        A(sec('相关专家参考'))
+        enote = str(d.get('expertsNote') or '').strip()
+        if enote:
+            A(f'> {enote}\n')
+        A('| 专家 | 部门 / 岗位 | 与本次需求的匹配点 |')
+        A('| --- | --- | --- |')
+        for e in experts:
+            A(f'| {_cell(e["name"])} | {_cell(e["dept"])} | {_cell(e["relevance"])} |')
+        A('')
+
+    A(sec(f'日程安排（{d.get("visitDate", "")}）'))
+    A('| 时段 | 安排 | 地点 |')
+    A('| --- | --- | --- |')
+    for row in [sched_cells(r) for r in norm_agenda(d)]:
+        r = list(row) + ['', '', '']
+        A(f'| {r[0]} | {r[1]} | {r[2]} |')
+    A('\n> 各环节具体起止时间待与客户最终确认；接送与用车安排未落实时需在行程确认后同步客户。\n')
+
+    A(sec('人员分工'))
+    A('| 角色 | 人员 | 职责 |')
+    A('| --- | --- | --- |')
+    A(f'| 主联络人 / 全程陪同 | {contact_line(d) or "待定"} | 接待总协调，全程陪同参观，客户沟通对接 |')
+    A('| 商务线条 | 待定 | 商务合作模式沟通、报价与合同口径 |')
+    A('| 技术线条 | 待定 | 技术方案讲解、客户技术疑问应答 |')
+    A('| 会务支持 | 待定 | 场地、餐饮、物料、字幕与签到准备 |\n')
+    A('> 是否需公司高层参与，尚未表态的，建议在客户层级明确后再定。\n')
+
+    A(sec('食宿与用车'))
+    hc = num(d.get('headcount'))
+    comp = len(d.get('companions') or [])
+    meal_hc = d.get('mealHeadcount') or ((hc + comp) if (hc or comp) else '')
+    cust_hc = ppl(d.get('headcount'))
+    A(f'- **用餐**：形式为{d.get("meal") or "待定"}；用餐人数 {ppl(meal_hc) or "待定"}（客户 {cust_hc + " 人" if cust_hc else "人数待补"} + 陪同 {comp} 人，可调整）；用餐档次需在流程界面按实际情况选择。')
+    A(f'- **住宿**：{d.get("hotel") or "待定"}。')
+    A(f'- **接送 / 用车**：{d.get("pickup") or "暂未确定，需补充接机时间、地点、车型与数量、送机安排"}。')
+    A(f'- **伴手礼**：{d.get("gift") or "待定"}。\n')
+
+    A(sec('会议与会务'))
+    A(f'- 场地：{d.get("meetingRoom") or "总部129/130/131会议室（按人数择一）"}（按实际人数预留，建议提前 1 天确认可用）。')
+    A(f'- 欢迎字幕：欢迎{d.get("customer", "")}莅临指导。')
+    A('- 会务物料：公司介绍资料、方案材料、演示环境、席位牌、签到表（待准备）。')
+    A('- 演示准备：提前调试演示环境与投屏，准备商务洽谈与技术交流对应的介绍材料。\n')
+
+    A(sec('应急预案'))
+    A('- 客户行程变更：由主联络人第一时间同步会务支持调整场地、餐饮与人员安排。')
+    A('- 关键人员临时缺席：由同线条备份人员顶替，确保商务与技术口径均有对应人负责。')
+    A('- 设备 / 演示故障：准备离线材料与备份设备，必要时改用文档讲解。')
+    A('- 用餐与场地冲突：提前确认餐厅与会议室备用方案。\n')
+
+    A(sec('待确认事项'))
+    todo = d.get('todo') or []
+    if todo:
+        for i, t in enumerate(todo, start=1):
+            A(f'{i}. {t}')
+    else:
+        A('无')
+    A('')
+
+    with open(out_path, 'w', encoding='utf-8') as f:
+        f.write('\n'.join(L))
+    safe_write(out_path)
+    return out_path
+
+
+def main():
+    ap = argparse.ArgumentParser()
+    ap.add_argument('--data', required=True, help='接待信息 JSON 文件')
+    ap.add_argument('--out-dir', default='/workspace/files')
+    ap.add_argument('--only', choices=['docx', 'md'], help='只生成其中一份')
+    ap.add_argument('--docx-name', default='客户接待行程单.docx')
+    ap.add_argument('--md-name', default='接待交流参考文档.md')
+    a = ap.parse_args()
+
+    with open(a.data, encoding='utf-8') as f:
+        d = json.load(f)
+
+    res = {'ok': True, 'files': [], 'qa': {}}
+    # v4.4：verify 统计随渲染结果一起回传，供 e10.mjs 组装「可核验证据」，
+    # 让上层不必 cat / 重读产物就能确认「文件渲染对了」（省一整批往返）
+    verify = {}
+    if a.only != 'md':
+        if docx is None:
+            res.update(ok=False, error='缺少 python-docx，请先安装：pip install python-docx')
+            print(json.dumps(res, ensure_ascii=False))
+            return 1
+        if not os.path.exists(TPL):
+            res.update(ok=False, error='内置模板缺失: assets/行程单模板-泛微.docx')
+            print(json.dumps(res, ensure_ascii=False))
+            return 1
+        p, docx_qa = build_docx(d, os.path.join(a.out_dir, a.docx_name))
+        res['files'].append({'kind': 'docx', 'path': p, 'size': os.path.getsize(p), 'audience': 'customer'})
+        res['qa']['external'] = docx_qa
+        verify['docxParagraphs'] = docx_qa.get('paragraphs', 0)
+        verify['docxSha256'] = sha8(p)
+        verify['externalLeaks'] = docx_qa.get('externalLeaks', 0)
+        if docx_qa.get('cleaned'):
+            verify['cleaned'] = docx_qa['cleaned']
+        warn = list(res['qa'].get('warnings') or [])
+        if docx_qa.get('externalLeaks'):
+            warn.append(f'对外行程单仍含内部口径 {docx_qa["externalLeaks"]} 处，请检查')
+        if warn:
+            res['qa']['warnings'] = warn
+    if a.only != 'docx':
+        p = build_md(d, os.path.join(a.out_dir, a.md_name))
+        res['files'].append({'kind': 'md', 'path': p, 'size': os.path.getsize(p), 'audience': 'internal'})
+        try:
+            with open(p, encoding='utf-8') as f:
+                secs = [ln.strip() for ln in f.read().splitlines() if ln.startswith('## ')]
+        except Exception:
+            secs = []
+        verify['mdSections'] = len(secs)
+        verify['mdHead'] = secs[0] if secs else ''
+        verify['mdTail'] = secs[-1] if secs else ''
+        verify['mdSha256'] = sha8(p)
+
+    # v4.7：把日程行结构化输出，供流程【日程明细】子表直接使用
+    agenda_rows = norm_agenda(d)
+    res['agendaRows'] = agenda_rows
+    res['scheduleRows'] = [{
+        'date': d.get('visitDate') or '',
+        'time': r.get('start') or '',
+        'item': r.get('item') or '',
+        'place': r.get('place') or '',
+        'person': r.get('person') or '',
+        'activity': r.get('activity') or '',
+        'remark': r.get('remark') or '',
+    } for r in agenda_rows]
+    verify['fileCount'] = len(res['files'])
+    res['verify'] = verify
+    print(json.dumps(res, ensure_ascii=False))
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())