@puyinkai/xiaobao-cli 0.1.8 → 0.1.9

package/skills/wangxiaobao-html-to-pdf/scripts/html2pdf_exact.py

@@ -0,0 +1,92 @@
+"""Convert HTML to PDF with exact same layout as browser rendering.
+
+Instead of fitting to A4, this script measures the actual rendered content size
+and creates a PDF page that exactly matches, preserving the original layout 1:1.
+
+Usage:
+    python3 html2pdf_exact.py <html_path_or_url> [output_pdf_path]
+"""
+
+import sys
+import os
+from pathlib import Path
+from playwright.sync_api import sync_playwright
+
+
+def html_to_pdf_exact(source: str, pdf_path: str = None) -> str:
+    """
+    Convert HTML to PDF preserving exact layout.
+    Measures rendered content size and uses that as PDF page size.
+    """
+    is_url = source.startswith("http://") or source.startswith("https://")
+
+    if not is_url:
+        source = os.path.abspath(source)
+        if not os.path.exists(source):
+            raise FileNotFoundError(f"HTML file not found: {source}")
+        file_url = Path(source).as_uri()
+    else:
+        file_url = source
+
+    if pdf_path is None:
+        if is_url:
+            from urllib.parse import urlparse
+            path_part = urlparse(source).path
+            base_name = Path(path_part).stem or "page"
+            pdf_path = os.path.join(os.getcwd(), base_name + ".pdf")
+        else:
+            pdf_path = source.rsplit(".", 1)[0] + ".pdf"
+
+    with sync_playwright() as p:
+        browser = p.chromium.launch(headless=True)
+        # Use a wide viewport to avoid unwanted wrapping
+        page = browser.new_page(viewport={"width": 1440, "height": 900})
+        page.goto(file_url, wait_until="networkidle")
+        page.wait_for_timeout(5000)  # Wait for Chart.js to render
+
+        # Get actual content dimensions
+        dims = page.evaluate("""() => {
+            const body = document.body;
+            const html = document.documentElement;
+            const width = Math.max(
+                body.scrollWidth, body.offsetWidth,
+                html.clientWidth, html.scrollWidth, html.offsetWidth
+            );
+            const height = Math.max(
+                body.scrollHeight, body.offsetHeight,
+                html.clientHeight, html.scrollHeight, html.offsetHeight
+            );
+            return { width: Math.ceil(width), height: Math.ceil(height) };
+        }""")
+
+        content_width = dims["width"]
+        content_height = dims["height"]
+
+        # Add small padding
+        pdf_width = content_width + 2
+        pdf_height = content_height + 2
+
+        page.pdf(
+            path=pdf_path,
+            width=f"{pdf_width}px",
+            height=f"{pdf_height}px",
+            print_background=True,
+            margin={"top": "0mm", "bottom": "0mm", "left": "0mm", "right": "0mm"},
+            display_header_footer=False,
+            prefer_css_page_size=False,
+        )
+        browser.close()
+
+    return pdf_path
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print("Usage: python3 html2pdf_exact.py <html_file_or_url> [output_pdf]")
+        sys.exit(1)
+
+    source_arg = sys.argv[1]
+    pdf_arg = sys.argv[2] if len(sys.argv) > 2 else None
+
+    result = html_to_pdf_exact(source_arg, pdf_arg)
+    print(f"PDF generated: {result}")

package/skills/wangxiaobao-project-daily-report/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: wangxiaobao-project-daily-report
+description: >
+  地产项目营销日报生成器。基于旺小宝 API 拉取来访、客户画像、成交数据，
+  生成结构化 HTML + PDF 日报。触发词：营销日报、项目日报、生成日报、daily report。
+agent_created: true
+---
+
+# 旺小宝项目日报生成技能
+
+## 概述
+
+基于旺小宝API自动拉取数据，生成 `<项目名>` 营销日报HTML+PDF文件（排版完全一致）。
+
+## 功能特性
+
+- 自动拉取旺小宝来访数据、客户画像、成交数据
+- 意向等级分析（A/B/C/D）
+- 渠道分布分析（中介/自渠/顺访等）
+- 存量客户复访分析
+- 生成专业排版HTML日报（与参考模板完全一致）
+- **同时生成同名PDF文件，排版与HTML 1:1一致**（需Chrome/Edge）
+
+## 触发词
+
+```
+营销日报
+项目日报
+生成日报
+daily report
+```
+
+## 使用方法
+
+### 方式一：直接语音/文字命令（推荐）
+
+```
+生成项目日报
+```
+
+### 方式二：指定日期
+
+```
+生成2026年5月19日的项目日报
+```
+
+### 方式三：本地执行脚本
+
+```bash
+cd <skill目录>/scripts
+python generate_report.py 2026-05-19
+```
+
+可通过环境变量或命令行参数指定项目：
+
+```bash
+python generate_report.py 2026-05-19 \
+  --tenant-id <你的租户ID> \
+  --project-id <你的项目ID> \
+  --project-name "<项目名>"
+```
+
+### 方式四：一键运行（自动用昨日日期）
+
+```bash
+python3 run.py                 # 不带日期参数，自动用昨天的日期
+python3 run.py 2026-05-19      # 也可指定日期，参数原样透传给 generate_report.py
+```
+
+## 输出文件
+
+每次生成同时产生两个文件，默认写入当前工作目录：
+
+```
+<工作目录>/<项目名>_日报_YYYYMMDD.html
+<工作目录>/<项目名>_日报_YYYYMMDD.pdf
+```
+
+- **HTML**：可直接在浏览器中打开查看、打印
+- **PDF**：由 Chrome/Edge headless 打印生成，排版与 HTML 完全一致，可直接转发
+
+## 日报内容结构
+
+| 模块 | 说明 |
+|------|------|
+| KPI概览 | 本月来访、来访进度达成、本月成交、昨日本月来访 |
+| 来访指标 | 月度客储指标、截至昨日来访、完成率、进度达成率 |
+| 来访意向等级 | A级/B级/C级/D级分布及占比 |
+| 销售指标 | 月度销售指标、截至昨日成交、完成率、进度达成率 |
+| 成交意向等级 | 成交客户的意向等级分布 |
+| 来访渠道分布 | 中介/自渠/顺访/约访等渠道统计 |
+| 存量客户汇总 | 近3月未成交客户按渠道分布 |
+| 存量客户明细 | 预计本周复访客户完整信息（10条） |
+| 昨日来访明细 | 昨日来访客户记录 |
+| 顾问来访统计 | 顾问来访排行 |
+| 数据说明 | 数据来源及状态说明 |
+
+## 数据来源
+
+| 数据类型 | 来源 | 说明 |
+|---------|------|------|
+| 来访数据 | 旺小宝 `/ai-open/visits/page` | 来访时间、顾问、次数、时长 |
+| 客户画像 | 旺小宝 `/ai-open/customers/page` | 意向等级、渠道、成交状态 |
+| 成交数据 | 旺小宝客户画像 dealStatus=1 | 成交套数 |
+| KPI指标 | 配置项（环境变量/命令行参数） | 来访目标、销售目标 |
+
+## 依赖
+
+- 旺小宝OAuth授权（首次使用需授权）
+- Python 3.x（内置urllib，无需额外依赖）
+- Google Chrome 或 Microsoft Edge（用于生成PDF，已安装可跳过）
+
+## 首次使用
+
+1. 如果没有授权旺小宝，系统会提示授权
+2. 打开授权链接，输入验证码完成授权
+3. 重新执行生成命令
+
+## 项目配置
+
+项目标识与KPI指标均可配置，优先级为：命令行参数 > 环境变量 > 默认值。
+
+### 方式一：环境变量
+
+```bash
+export XIAOBAO_TENANT_ID="你的租户ID"
+export XIAOBAO_PROJECT_ID="你的项目ID"
+export XIAOBAO_PROJECT_NAME="项目名称"
+export XIAOBAO_MONTH_VISIT_TARGET="500"     # 月度来访目标
+export XIAOBAO_MONTH_SALES_TARGET="21000"   # 月度销售目标（万元）
+```
+
+### 方式二：命令行参数
+
+```bash
+python generate_report.py 2026-05-19 \
+  --tenant-id <你的租户ID> \
+  --project-id <你的项目ID> \
+  --project-name "<项目名>" \
+  --month-visit-target 500 \
+  --month-sales-target 21000
+```
+
+## 文件结构
+
+```
+wangxiaobao-project-daily-report/
+├── SKILL.md                    # 本文档
+├── _meta.json                  # Skill元数据
+├── scripts/
+│   ├── fetch_data.py           # 数据拉取脚本
+│   ├── generate_report.py      # 主生成脚本
+│   └── run.py                  # 一键运行入口（默认昨日日期，跨平台）
+└── references/
+    └── report_template.html     # HTML模板参考
+```
+
+## 技术细节
+
+- 使用Python原生urllib调用API，彻底避免PowerShell中文编码乱码问题
+- HTML模板完全参照参考文件样式
+- PDF由Chrome/Edge headless `--print-to-pdf` 生成，排版与HTML 1:1一致
+- 数据自动关联来访记录与客户画像
+- 客户姓名自动脱敏
+- **PDF打印优化**：
+  - 使用 `--print-background` 参数强制打印背景色
+  - `@media print` CSS块中强制所有表头元素背景色+文字颜色（`print-color-adjust: exact !important`）
+  - 表头文字统一白色（`color: #fff !important`），深色背景确保可读性
+  - KPI卡片打印布局使用 `flex-wrap: nowrap`，4个卡片强制1行排列
+  - 所有 `.section-title` / `.table-header td` / `.table-header-peach` 等表头类均有独立打印样式声明

package/skills/wangxiaobao-project-daily-report/_meta.json

@@ -0,0 +1,9 @@
+{
+  "name": "wangxiaobao-project-daily-report",
+  "displayName": "旺小宝项目日报生成器",
+  "description": "地产项目营销日报生成器，基于旺小宝API实时数据",
+  "version": "1.0.0",
+  "author": "xiaobao-cli",
+  "tags": ["地产", "日报", "旺小宝", "营销"],
+  "created": "2026-05-21"
+}

package/skills/wangxiaobao-project-daily-report/references/report_template.html

@@ -0,0 +1,308 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>{project_name} 日报 {date}</title>
+<style>
+* { box-sizing: border-box; margin: 0; padding: 0; }
+body { font-family: "Microsoft YaHei", "PingFang SC", Arial, sans-serif; font-size: 12px; color: #333; background: #fff; padding: 15px; }
+table { width: 100%; border-collapse: collapse; margin-bottom: 12px; }
+th, td { border: 1px solid #ddd; padding: 6px 8px; text-align: center; vertical-align: middle; font-size: 11px; }
+th { color: #fff; font-weight: bold; }
+
+.title-bg { background: #1F4E79; }
+.orange-bg { background: #975765; }
+.pink-bg { background: #EEE2E6; color: #333; }
+.peach-bg { background: #C59BA6; }
+.light-bg { background: #f5f5f5; }
+
+.kpi-row { display: flex; gap: 8px; margin-bottom: 12px; }
+.kpi-card { flex: 1; border: 2px solid #1F4E79; border-radius: 4px; padding: 10px; text-align: center; background: #fafafa; }
+.kpi-card .label { font-size: 10px; color: #666; margin-bottom: 3px; }
+.kpi-card .value { font-size: 22px; font-weight: bold; color: #1F4E79; line-height: 1.2; }
+.kpi-card .sub { font-size: 9px; color: #888; margin-top: 3px; }
+
+.col-2 { display: flex; gap: 12px; margin-bottom: 12px; }
+.col-2 > div { flex: 1; }
+
+.section-title { background: #1F4E79; color: #fff; font-size: 13px; font-weight: bold; padding: 8px; text-align: center; }
+.table-header { background: #975765; color: #fff; font-weight: bold; }
+.table-header-pink { background: #EEE2E6; color: #333; font-weight: bold; }
+.table-header-peach { background: #C59BA6; color: #fff; font-weight: bold; }
+
+.data-value { font-weight: bold; font-size: 14px; color: #1F4E79; }
+.data-red { color: #c00; font-weight: bold; }
+
+tr:nth-child(even) { background: #f9f9f9; }
+
+.footer { text-align: center; padding: 15px; color: #999; font-size: 10px; border-top: 1px solid #ddd; margin-top: 20px; }
+</style>
+</head>
+<body>
+
+<!-- 项目标题 -->
+<table>
+<tr>
+<td class="title-bg" style="font-size: 18px; font-weight: bold; padding: 12px; text-align: center;">
+{project_name} 营销日报
+</td>
+</tr>
+<tr>
+<td style="text-align: center; padding: 6px; color: #666; background: #f5f5f5; font-size: 11px;">
+数据日期：{yesterday}（昨日） | 统计周期：{month_start} ~ {yesterday} | 截至时间：23:59
+</td>
+</tr>
+</table>
+
+<!-- KPI概览 -->
+<div class="kpi-row">
+<div class="kpi-card">
+<div class="label">本月来访（组）</div>
+<div class="value">{month_visit_actual}</div>
+<div class="sub">目标{month_visit_target}组 | 完成率{visit_complete_rate}%</div>
+</div>
+<div class="kpi-card">
+<div class="label">来访进度达成</div>
+<div class="value">{progress_rate}%</div>
+<div class="sub">时间进度{time_progress}% | 超额{over_progress}%</div>
+</div>
+<div class="kpi-card">
+<div class="label">本月成交（组）</div>
+<div class="value">{month_deals}</div>
+<div class="sub">目标待确认 | 成交金额待填报</div>
+</div>
+<div class="kpi-card">
+<div class="label">昨日来访（组）</div>
+<div class="value">{yesterday_visits}</div>
+<div class="sub">本周来访量平稳</div>
+</div>
+</div>
+
+<!-- 来访指标 + 来访意向等级 -->
+<div class="col-2">
+<div>
+<table>
+<tr><td colspan="6" class="section-title" style="font-size:12px;">本月来访指标及达成</td></tr>
+<tr class="table-header">
+<td>月度客储指标</td>
+<td>截至昨日来访</td>
+<td>完成率</td>
+<td>进度达成率</td>
+<td>总组数</td>
+<td>转化率</td>
+</tr>
+<tr>
+<td class="data-value">{month_visit_target}</td>
+<td class="data-value">{month_visit_actual}</td>
+<td class="data-red">{visit_complete_rate}%</td>
+<td class="data-red">{progress_rate}%</td>
+<td class="data-value">{month_visit_actual}</td>
+<td>-</td>
+</tr>
+</table>
+</div>
+<div>
+<table>
+<tr><td colspan="5" class="section-title" style="font-size:12px;">本月来访客户意向等级分析</td></tr>
+<tr class="table-header">
+<td>A级（高意向）</td>
+<td>B级（中高）</td>
+<td>C级（中意向）</td>
+<td>D级（低意向）</td>
+<td>合计</td>
+</tr>
+<tr>
+<td class="data-value">{intent_A}</td>
+<td class="data-value">{intent_B}</td>
+<td class="data-value">{intent_C}</td>
+<td class="data-value">{intent_D}</td>
+<td class="data-value" style="font-size:16px;">{intent_total}</td>
+</tr>
+<tr style="background:#f5f5f5;">
+<td>{intent_A_pct}%</td>
+<td>{intent_B_pct}%</td>
+<td>{intent_C_pct}%</td>
+<td>{intent_D_pct}%</td>
+<td>100%</td>
+</tr>
+</table>
+</div>
+</div>
+
+<!-- 销售指标 + 成交意向等级 -->
+<div class="col-2">
+<div>
+<table>
+<tr><td colspan="6" class="section-title" style="font-size:12px;">本月销售指标及达成</td></tr>
+<tr class="table-header">
+<td>月度销售指标(万)</td>
+<td>截至昨日成交(万)</td>
+<td>完成率</td>
+<td>进度达成率</td>
+<td>总套数</td>
+<td>转化率</td>
+</tr>
+<tr>
+<td class="data-value">{month_sales_target:,}</td>
+<td class="data-value">待填报</td>
+<td class="data-red">-</td>
+<td class="data-red">-</td>
+<td class="data-value">{month_deals}</td>
+<td>-</td>
+</tr>
+<tr style="background:#fff3cd; font-size:9px;">
+<td colspan="6" style="text-align:left;">⚠ 成交金额待确认，建议从销售管理系统补充数据</td>
+</tr>
+</table>
+</div>
+<div>
+<table>
+<tr><td colspan="5" class="section-title" style="font-size:12px;">本月成交客户意向等级分析</td></tr>
+<tr class="table-header">
+<td>A级</td>
+<td>B级</td>
+<td>C/C+级</td>
+<td>D级</td>
+<td>合计</td>
+</tr>
+<tr>
+<td class="data-value">{deal_A}</td>
+<td>{deal_B}</td>
+<td>{deal_C}</td>
+<td>{deal_D}</td>
+<td class="data-value">{month_deals}</td>
+</tr>
+</table>
+</div>
+</div>
+
+<!-- 来访渠道分布 -->
+<table>
+<tr><td colspan="5" class="section-title" style="font-size:12px;">来访渠道分布（本月）</td></tr>
+<tr class="table-header">
+<td>渠道类型</td>
+<td>来访组数</td>
+<td>占比</td>
+<td>意向等级分布</td>
+<td>备注</td>
+</tr>
+{channel_rows}
+<tr style="background:#1F4E79; color:#fff;">
+<td><strong>合计</strong></td>
+<td class="data-value" style="color:#fff;">{channel_total}</td>
+<td>100%</td>
+<td>A:{intent_A}, B:{intent_B}, C:{intent_C}, D:{intent_D}</td>
+<td>-</td>
+</tr>
+</table>
+
+<!-- 存量客户汇总 -->
+<table>
+<tr><td colspan="7" class="section-title" style="font-size:12px;">存量客户本周复访 - 近3月未成交（{three_months_ago} ~ {yesterday}）</td></tr>
+<tr class="table-header">
+<td>渠道</td>
+<td>未成交总数</td>
+<td>A级</td>
+<td>B级</td>
+<td>C级</td>
+<td>D级</td>
+<td>占比</td>
+</tr>
+{stock_rows}
+<tr style="background:#1F4E79; color:#fff;">
+<td><strong>合计</strong></td>
+<td class="data-value" style="color:#fff;">{stock_total}</td>
+<td>{stock_A}</td>
+<td>{stock_B}</td>
+<td>{stock_C}</td>
+<td>{stock_D}</td>
+<td>100%</td>
+</tr>
+</table>
+
+<!-- 存量客户明细 -->
+<table>
+<tr><td colspan="12" class="section-title" style="font-size:12px; background:#C59BA6;">存量客户预计本周复访明细</td></tr>
+<tr class="table-header-peach">
+<td style="width:30px;">序号</td>
+<td>客户姓名</td>
+<td>来访渠道</td>
+<td>置业顾问</td>
+<td>最近来访</td>
+<td>意向等级</td>
+<td>跟进情况</td>
+<td>决策周期</td>
+<td>未成交原因</td>
+<td>复访概率</td>
+<td>成交概率</td>
+<td>跟进策略</td>
+</tr>
+{customer_rows}
+</table>
+
+<!-- 昨日来访明细 -->
+<table>
+<tr><td colspan="7" class="section-title" style="font-size:12px;">昨日来访明细（{yesterday} 共{yesterday_visits}组）</td></tr>
+<tr class="table-header">
+<td style="width:30px;">序号</td>
+<td>到访时间</td>
+<td>顾问</td>
+<td>到访次数</td>
+<td>停留时长</td>
+<td>首访/复访</td>
+<td>备注</td>
+</tr>
+{yesterday_rows}
+</table>
+
+<!-- 数据说明 -->
+<table>
+<tr><td colspan="4" class="section-title" style="font-size:12px;">数据说明</td></tr>
+<tr class="table-header-pink">
+<td>数据项</td>
+<td>数据来源</td>
+<td>数据状态</td>
+<td>备注</td>
+</tr>
+<tr>
+<td>来访数据</td>
+<td>旺小宝来访记录API</td>
+<td class="data-value" style="color:#0a0;">已获取</td>
+<td>{month_start}~{yesterday}共{month_visit_actual}组</td>
+</tr>
+<tr>
+<td>意向等级</td>
+<td>旺小宝客户画像API</td>
+<td class="data-value" style="color:#0a0;">已获取</td>
+<td>顾问评级(A/B/C/D)</td>
+</tr>
+<tr>
+<td>渠道分类</td>
+<td>旺小宝dynamicTags</td>
+<td class="data-value" style="color:#0a0;">已获取</td>
+<td>五大类来访渠道</td>
+</tr>
+<tr>
+<td>成交数据</td>
+<td>旺小宝客户画像API</td>
+<td class="data-value" style="color:#f90;">待确认</td>
+<td>本月成交{month_deals}组，金额待填报</td>
+</tr>
+<tr>
+<td>月度KPI指标</td>
+<td>IMA知识库/配置</td>
+<td class="data-value" style="color:#0a0;">已配置</td>
+<td>来访{month_visit_target}组/销售{month_sales_target}万</td>
+</tr>
+</table>
+
+<!-- 页脚 -->
+<div class="footer">
+<p>{project_name} 营销日报 | 数据日期：{yesterday} | 生成时间：{date}</p>
+<p>数据来源：旺小宝智能营销系统 | 本月来访{month_visit_actual}组 | 意向客户{intent_A}组（A级）</p>
+<p style="color:#c00; font-weight:bold;">⚠ 成交金额待从销售管理系统补充，建议每日同步</p>
+</div>
+
+</body>
+</html>