park-viz — 产业园区 2.5D 楼宇可视化

技能目标

将用户提供的园区数据（建筑信息 + 企业入驻 + 工作进度）生成一个可在浏览器中交互的 2.5D 白模建筑地图。

支持：

• CSV / JSON / 表格描述等多种数据输入格式
• 自定义"工作项"名称（调研 / 拜访 / 签约 / 回访 等）
• 任意楼栋数量，自动计算等轴测布局
• 点击楼宇查看企业列表和进度详情

工作流程

Step 0 — 加载技能

立即读取以下文件，获取生成器代码和示例模板：

• ~/.workbuddy/skills/park-viz/assets/generate_park.py — 主生成器
• ~/.workbuddy/skills/park-viz/assets/sample_buildings.csv — 建筑示例
• ~/.workbuddy/skills/park-viz/assets/sample_tenants.csv — 企业示例

Step 1 — 收集数据

必须收集以下信息：

1. 园区名称 — 显示在页面标题
2. "工作项"名称 — 用户自定义，例如"调研"、"拜访"、"签约"、"回访"（默认"调研"）
3. 建筑数据 — 每栋楼：名称、楼层数、区域
4. 企业数据 — 每家企业：所在楼宇、企业名称、所在楼层（可多层）、是否完成工作项

收集方式（按优先级）：

• 用户上传 / 粘贴 CSV 文件 → 解析
• 用户描述（自然语言）→ AI 提取后确认
• 用户未提供数据 → 推荐使用示例模板，发送 sample_buildings.csv + sample_tenants.csv

Step 2 — 数据解析

CSV 建筑格式（buildings.csv）：

楼宇编号,楼宇名称,楼层数,功能区域
1,A座 科技研发楼,12,研发区
2,B座 数据中心,6,数据中心区

CSV 企业格式（tenants.csv）：

楼宇编号,企业名称,所在楼层,是否完成
1,"北京华清智算科技有限公司","3,4",是
1,"武汉光谷创新科技有限公司","5",是
1,"天津武清新能源汽车研究院","8",否

• 所在楼层 支持多楼层（逗号分隔）
• 是否完成 接受：是/否、true/false、1/0、Y/N、完成/未完成

Step 3 — 生成 HTML

运行：

python ~/.workbuddy/skills/park-viz/assets/generate_park.py \
  --buildings <buildings_csv> \
  --tenants <tenants_csv> \
  --park-name "园区名称" \
  --work-label "调研" \
  --output <output_path>

参数说明：

• --buildings / --tenants：CSV 文件路径，或以 json: 开头的 JSON 字符串
• --park-name：园区名称（默认"智慧产业园区"）
• --work-label：工作项名称（默认"调研"）
• --output：输出 HTML 文件路径

Step 4 — 预览交付

• 用 preview_url 打开 HTML 文件
• 将 HTML 文件作为附件交付
• 告知用户可直接用浏览器打开，无需联网

注意事项

1. Python 检测：运行脚本前先检测 python 或 python3
2. 路径空格：Windows 路径含空格时用双引号包裹
3. 楼层数据：楼层编号从 1 开始，所在楼层不得超过该楼层数
4. 企业数量：没有上限，但建议单栋楼不超过 20 家企业（影响右侧面板可读性）
5. 楼栋数量：技能自动计算行列布局（≤4栋1行，5-8栋2行，>8栋3行+）

示例对话

用户："帮我做一个产业园区地图，我有 10 栋楼、30 家企业，工作是拜访。"

→ 询问用户提供数据，或提供 CSV 模板让用户填写。

用户："调研进度地图，楼宇和企业信息在这个 CSV 里。"（附件）

→ 直接解析并生成。

用户："帮我生成一个示例看看效果。"

→ 使用内置示例数据生成演示页面。