@puyinkai/xiaobao-cli 0.1.6 → 0.1.9

package/skills/wangxiaobao-html-to-pdf/SKILL.md

@@ -0,0 +1,116 @@
+---
+name: wangxiaobao-html-to-pdf
+description: 将HTML文件转换为高质量PDF。当用户需要将HTML文件（本地文件或URL）转为PDF时触发此技能。触发词包括：HTML转PDF、生成PDF、导出PDF、convert HTML to PDF、HTML to PDF、把HTML生成PDF、PDF导出。支持完整保留CSS样式、渐变、Grid/Flex布局、背景色等。
+agent_created: true
+---
+
+# HTML to PDF
+
+## Overview
+
+将HTML文件（本地文件或HTTP URL）转换为高质量PDF，使用Playwright无头Chromium渲染引擎，完整保留CSS渐变、Grid/Flex布局、背景色、字体等样式。适用于包含复杂样式的HTML报告、海报、数据可视化页面等场景。
+
+## Prerequisites
+
+运行此技能需要：
+- Python 3.8+
+- Playwright + Chromium
+
+如未安装，先执行：
+```bash
+pip install playwright
+python3 -m playwright install chromium
+```
+
+## CLI 参数
+
+```bash
+python3 scripts/html2pdf.py <source> [output] [options]
+```
+
+| 参数 | 说明 |
+|------|------|
+| `source` | HTML文件路径或HTTP/HTTPS URL（必填） |
+| `output` | 输出PDF路径（可选，默认与HTML同名.pdf） |
+| `--width` | 页面宽度（如 `210mm`、`1200px`） |
+| `--height` | 页面高度（如 `297mm`、`1697px`） |
+| `--format` | 标准纸张：`A4`（默认）、`A3`、`Letter` 等 |
+| `--landscape` | 横向模式（A4横向 = 297×210mm） |
+
+**页面尺寸优先级**：`--width/--height` > `--landscape` > `--format`
+
+## Workflow
+
+### Step 1: 确认输入
+
+确认用户提供的HTML文件路径或URL：
+- 本地文件：使用文件路径（如 `/path/to/report.html` 或 `report.html`）
+- URL：完整的HTTP/HTTPS地址（如 `https://example.com/page.html`）
+
+### Step 2: 选择页面尺寸
+
+根据HTML设计宽度选择合适的PDF页面尺寸：
+
+| 场景 | 参数 | 说明 |
+|------|------|------|
+| 标准报告/A4纵向 | （默认） | A4 210×297mm |
+| 宽屏报告/A4横向 | `--landscape` | A4 横向，适合宽屏HTML |
+| 与HTML设计宽完全匹配 | `--width 1200px --height 1697px` | 自定义尺寸，1:1无缩放 |
+| 其他标准纸张 | `--format A3` | 支持 A3/A2/Letter 等 |
+
+### Step 3: 执行转换
+
+```bash
+# 基本用法（A4纵向）
+python3 scripts/html2pdf.py report.html
+
+# 指定输出路径
+python3 scripts/html2pdf.py report.html ./output.pdf
+
+# A4 横向（适合宽屏报告）
+python3 scripts/html2pdf.py report.html --landscape
+
+# 自定义页面尺寸（与HTML设计宽完全匹配）
+python3 scripts/html2pdf.py report.html --width 1200px --height 1697px
+
+# 其他标准纸张
+python3 scripts/html2pdf.py report.html --format A3
+```
+
+### Step 4: 验证并交付
+
+1. 确认PDF文件已生成（检查文件大小 > 0）
+2. 使用 `deliver_attachments` 工具交付PDF给用户
+3. 在回复中说明文件名、大小、保存位置
+
+## PDF参数
+
+默认配置：
+- **纸张格式**：A4（可通过 `--format` / `--landscape` / `--width+--height` 修改）
+- **边距**：上15mm / 下15mm / 左10mm / 右10mm
+- **打印背景**：是（完整保留CSS背景色、渐变）
+- **页眉页脚**：关闭
+
+## 排版一致性建议
+
+为确保PDF与HTML排版完全一致：
+1. **使用自定义尺寸**：`--width 1200px --height 1697px`（匹配HTML设计宽度）
+2. **或在HTML中添加打印CSS**：
+   ```css
+   @page { size: 1200px 1697px; margin: 0; }
+   @media print {
+     body { margin: 0; -webkit-print-color-adjust: exact; }
+     .card { break-inside: avoid; }
+   }
+   ```
+3. **A4横向**：`--landscape` 适合大多数宽屏报告
+
+## Troubleshooting
+
+| 问题 | 原因 | 解决方案 |
+|------|------|----------|
+| 报错 `playwright` 未找到 | Python环境未安装playwright | 运行 `pip install playwright && python3 -m playwright install chromium` |
+| PDF内容不全 | 页面JS未加载完成 | 增大 `wait_for_timeout` 的等待时间（默认5秒） |
+| 中文字体缺失 | 系统未安装中文字体 | HTML中使用系统字体栈（PingFang SC / Microsoft YaHei） |
+| 文件路径含中文报错 | 路径编码问题 | 使用绝对路径，确保路径格式正确 |
+| PDF排版与HTML不一致 | 页面尺寸不匹配 | 使用 `--width/--height` 指定与HTML设计宽一致的尺寸 |

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

@@ -0,0 +1,132 @@
+"""Convert HTML file to PDF using Playwright (headless Chromium).
+
+Supports both local HTML files and HTTP URLs.
+Usage:
+    python3 html2pdf.py <html_path_or_url> [output_pdf_path] [options]
+
+Options:
+    --width <size>    Page width (e.g., "210mm", "1200px")
+    --height <size>   Page height (e.g., "297mm", "1697px")
+    --format <fmt>    Page format: A4, A3, Letter, etc. (default: A4)
+    --landscape        Use landscape orientation (297mm x 210mm)
+
+Examples:
+    python3 html2pdf.py report.html                        # A4 portrait
+    python3 html2pdf.py report.html --landscape            # A4 landscape
+    python3 html2pdf.py report.html --width 1200px --height 1697px  # custom size
+"""
+
+import sys
+import os
+import argparse
+from pathlib import Path
+from playwright.sync_api import sync_playwright
+
+
+def html_to_pdf(source: str, pdf_path: str = None, width: str = None, height: str = None, page_format: str = "A4", landscape: bool = False) -> str:
+    """
+    Convert an HTML file or URL to PDF.
+
+    Args:
+        source: Absolute path to an HTML file, or an HTTP/HTTPS URL.
+        pdf_path: Optional output PDF path. Defaults to same name as source with .pdf extension.
+        width: Optional page width (e.g., "210mm", "1200px"). Overrides format if set.
+        height: Optional page height (e.g., "297mm", "1697px"). Overrides format if set.
+        page_format: Page format (A4, A3, Letter, etc.). Ignored if width/height set.
+        landscape: If True, use landscape orientation (swaps width/height of format).
+
+    Returns:
+        The absolute path to the generated PDF file.
+    """
+    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)
+        page = browser.new_page()
+        
+        # 设置 viewport 尺寸，与 PDF 页面尺寸匹配，避免缩放
+        if width and height:
+            w_px = int(width.replace("px", "")) if "px" in width else 800
+            h_px = int(height.replace("px", "")) if "px" in height else 1100
+            page.set_viewport_size({"width": w_px, "height": h_px})
+        elif landscape:
+            page.set_viewport_size({"width": 1123, "height": 795})  # A4 横向 96dpi
+        else:
+            page.set_viewport_size({"width": 794, "height": 1123})  # A4 纵向 96dpi
+        
+        # 强制使用 screen 媒体模式渲染（确保 Chart.js 等按屏幕 CSS 渲染）
+        page.emulate_media(media="screen")
+        
+        page.goto(file_url, wait_until="networkidle")
+        page.wait_for_timeout(8000)  # 等待 Chart.js 图表充分渲染（8秒）
+
+        # Build pdf parameters
+        pdf_params = {
+            "path": pdf_path,
+            "print_background": True,
+            "margin": {"top": "15mm", "bottom": "15mm", "left": "10mm", "right": "10mm"},
+            "display_header_footer": False,
+        }
+        
+        if width and height:
+            pdf_params["width"] = width
+            pdf_params["height"] = height
+        elif landscape:
+            pdf_params["width"] = "297mm"
+            pdf_params["height"] = "210mm"
+        else:
+            pdf_params["format"] = page_format
+
+        page.pdf(**pdf_params)
+        browser.close()
+
+    return pdf_path
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(
+        description="Convert HTML file or URL to PDF using Playwright (headless Chromium).",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+Examples:
+  python3 html2pdf.py report.html                          # A4 portrait
+  python3 html2pdf.py report.html --landscape              # A4 landscape
+  python3 html2pdf.py report.html --width 1200px --height 1697px  # custom size
+  python3 html2pdf.py report.html output.pdf --format A3  # A3 format
+"""
+    )
+    parser.add_argument("source", help="HTML file path or HTTP/HTTPS URL")
+    parser.add_argument("output", nargs="?", default=None, help="Output PDF path (default: same name as source)")
+    parser.add_argument("--width", help="Page width (e.g., '210mm', '1200px')")
+    parser.add_argument("--height", help="Page height (e.g., '297mm', '1697px')")
+    parser.add_argument("--format", default="A4", help="Page format: A4, A3, Letter, etc. (default: A4)")
+    parser.add_argument("--landscape", action="store_true", help="Use landscape orientation")
+
+    args = parser.parse_args()
+
+    result = html_to_pdf(
+        source=args.source,
+        pdf_path=args.output,
+        width=args.width,
+        height=args.height,
+        page_format=args.format,
+        landscape=args.landscape,
+    )
+    print(f"PDF generated: {result}")

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"
+}