@puyinkai/xiaobao-cli 0.1.8 → 0.1.9

package/dist/{api-client-zDBFgk0y.mjs → api-client-CDNjkArS.mjs}

@@ -13,7 +13,7 @@ import { a as isAccessTokenValid, l as writeToken, s as readToken } from "./toke
 */
 var NotAuthenticatedError = class extends Error {
 	code = "NOT_AUTHENTICATED";
-	hint = "运行 `xiaobao-cli auth login` 完成 OAuth device flow 登录。";
+	hint = "运行 `xiaobao-cli auth login --no-wait` 发起登录，授权后运行 `xiaobao-cli auth login --resume` 完成。";
 	constructor() {
 		super("当前未登录或 token 已过期");
 		this.name = "NotAuthenticatedError";

package/dist/{api-CX99_4K7.mjs → api-fsHHWWa3.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
-import { t as xbApiFetch } from "./api-client-zDBFgk0y.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { t as loadActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
 import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";

package/dist/{audio-ShfvRomP.mjs → audio-CRSMqaKo.mjs}

@@ -6,8 +6,8 @@ var audio_default = defineCommand({
 		description: "录音元数据分页 / 单条文本查询"
 	},
 	subCommands: {
-		list: () => import("./list-DCcCS6LM.mjs").then((m) => m.default),
-		text: () => import("./text-C3jhdPoe.mjs").then((m) => m.default)
+		list: () => import("./list-CnlQdzPp.mjs").then((m) => m.default),
+		text: () => import("./text-C3Ap6L5n.mjs").then((m) => m.default)
 	}
 });
 //#endregion

package/dist/{auth-DpK81Vp5.mjs → auth-_3hBh87U.mjs}

@@ -7,7 +7,7 @@ var auth_default = defineCommand({
 	},
 	subCommands: {
 		login: () => import("./login-CUUcjWPd.mjs").then((m) => m.default),
-		whoami: () => import("./whoami-CZVez-rm.mjs").then((m) => m.default),
+		whoami: () => import("./whoami-z-76WaCP.mjs").then((m) => m.default),
 		logout: () => import("./logout-DP7REhCd.mjs").then((m) => m.default)
 	}
 });

package/dist/cli.mjs

@@ -18,16 +18,16 @@ runMain(defineCommand({
 		description: "旺小宝 CLI — host-agnostic 14 tools (openclaw-xiaobao plugin 的 CLI 等价物)"
 	},
 	subCommands: {
-		auth: () => import("./auth-DpK81Vp5.mjs").then((m) => m.default),
-		project: () => import("./project-BuQQewOs.mjs").then((m) => m.default),
-		consultant: () => import("./consultant-CS9B42d3.mjs").then((m) => m.default),
-		audio: () => import("./audio-ShfvRomP.mjs").then((m) => m.default),
-		customer: () => import("./customer-B1cxRbJ9.mjs").then((m) => m.default),
-		visit: () => import("./visit-CX0Mc1n6.mjs").then((m) => m.default),
-		focus: () => import("./focus-DfNPPhm5.mjs").then((m) => m.default),
-		resistance: () => import("./resistance-DsE-Ha6Y.mjs").then((m) => m.default),
-		qa: () => import("./qa-CKsKiQIm.mjs").then((m) => m.default),
-		api: () => import("./api-CX99_4K7.mjs").then((m) => m.default)
+		auth: () => import("./auth-_3hBh87U.mjs").then((m) => m.default),
+		project: () => import("./project-BD0g4oAW.mjs").then((m) => m.default),
+		consultant: () => import("./consultant-E33hTGUO.mjs").then((m) => m.default),
+		audio: () => import("./audio-CRSMqaKo.mjs").then((m) => m.default),
+		customer: () => import("./customer-DcQ83oKD.mjs").then((m) => m.default),
+		visit: () => import("./visit-DoeECi8w.mjs").then((m) => m.default),
+		focus: () => import("./focus-XMRxnHPw.mjs").then((m) => m.default),
+		resistance: () => import("./resistance-6_V6At3T.mjs").then((m) => m.default),
+		qa: () => import("./qa-CdMcxCE_.mjs").then((m) => m.default),
+		api: () => import("./api-fsHHWWa3.mjs").then((m) => m.default)
 	}
 }));
 //#endregion

package/dist/{consultant-CS9B42d3.mjs → consultant-E33hTGUO.mjs}

@@ -5,7 +5,7 @@ var consultant_default = defineCommand({
 		name: "consultant",
 		description: "查询有权限的置业顾问列表"
 	},
-	subCommands: { list: () => import("./list-Cu6WzPpA.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-dm9YaCG1.mjs").then((m) => m.default) }
 });
 //#endregion
 export { consultant_default as default };

package/dist/{customer-B1cxRbJ9.mjs → customer-DcQ83oKD.mjs}

@@ -5,7 +5,7 @@ var customer_default = defineCommand({
 		name: "customer",
 		description: "客户画像分页查询"
 	},
-	subCommands: { list: () => import("./list-CnlFIFiY.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-DFdDcHFq.mjs").then((m) => m.default) }
 });
 //#endregion
 export { customer_default as default };

package/dist/{focus-DfNPPhm5.mjs → focus-XMRxnHPw.mjs}

@@ -5,7 +5,7 @@ var focus_default = defineCommand({
 		name: "focus",
 		description: "客户关注点标签分页查询"
 	},
-	subCommands: { list: () => import("./list-D56gEqiB.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-CrMOrnS-.mjs").then((m) => m.default) }
 });
 //#endregion
 export { focus_default as default };

package/dist/{list-DI1OD95x.mjs → list-B3nN4pd2.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
-import { t as xbApiFetch } from "./api-client-zDBFgk0y.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";
 import { defineCommand } from "citty";
 //#region src/commands/project/list.ts

package/dist/{list-CD08BRLk.mjs → list-CXquxzex.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
-import { t as xbApiFetch } from "./api-client-zDBFgk0y.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
 import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";

package/dist/{list-CKlx8YuL.mjs → list-Cc4zcaNz.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
-import { t as xbApiFetch } from "./api-client-zDBFgk0y.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
 import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";

package/dist/{list-DCcCS6LM.mjs → list-CnlQdzPp.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
-import { t as xbApiFetch } from "./api-client-zDBFgk0y.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
 import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";

package/dist/{list-D56gEqiB.mjs → list-CrMOrnS-.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
-import { t as xbApiFetch } from "./api-client-zDBFgk0y.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
 import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";

package/dist/{list-CnlFIFiY.mjs → list-DFdDcHFq.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
-import { t as xbApiFetch } from "./api-client-zDBFgk0y.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
 import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";

package/dist/{list-Cu6WzPpA.mjs → list-dm9YaCG1.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
-import { t as xbApiFetch } from "./api-client-zDBFgk0y.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
 import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";

package/dist/{project-BuQQewOs.mjs → project-BD0g4oAW.mjs}

@@ -6,7 +6,7 @@ var project_default = defineCommand({
 		description: "查询 / 切换激活项目"
 	},
 	subCommands: {
-		list: () => import("./list-DI1OD95x.mjs").then((m) => m.default),
+		list: () => import("./list-B3nN4pd2.mjs").then((m) => m.default),
 		use: () => import("./use-BZES4FZC.mjs").then((m) => m.default),
 		current: () => import("./current-CfDExInT.mjs").then((m) => m.default)
 	}

package/dist/{qa-CKsKiQIm.mjs → qa-CdMcxCE_.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
-import { t as xbApiFetch } from "./api-client-zDBFgk0y.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
 import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";

package/dist/{resistance-DsE-Ha6Y.mjs → resistance-6_V6At3T.mjs}

@@ -5,7 +5,7 @@ var resistance_default = defineCommand({
 		name: "resistance",
 		description: "客户抗性点标签分页查询"
 	},
-	subCommands: { list: () => import("./list-CKlx8YuL.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-Cc4zcaNz.mjs").then((m) => m.default) }
 });
 //#endregion
 export { resistance_default as default };

package/dist/{text-C3jhdPoe.mjs → text-C3Ap6L5n.mjs}

@@ -1,5 +1,5 @@
 import { a as resolveConfig } from "./device-flow-D6JVcEap.mjs";
-import { t as xbApiFetch } from "./api-client-zDBFgk0y.mjs";
+import { t as xbApiFetch } from "./api-client-CDNjkArS.mjs";
 import { n as requireActiveProject } from "./project-store-CKVJa54T.mjs";
 import { t as tenantProjectHeaders } from "./headers-DSnR4sjk.mjs";
 import { n as writeResult, t as writeError } from "./format-yjmxrbNm.mjs";

package/dist/{visit-CX0Mc1n6.mjs → visit-DoeECi8w.mjs}

@@ -5,7 +5,7 @@ var visit_default = defineCommand({
 		name: "visit",
 		description: "客户来访分页查询"
 	},
-	subCommands: { list: () => import("./list-CD08BRLk.mjs").then((m) => m.default) }
+	subCommands: { list: () => import("./list-CXquxzex.mjs").then((m) => m.default) }
 });
 //#endregion
 export { visit_default as default };

package/dist/{whoami-CZVez-rm.mjs → whoami-z-76WaCP.mjs}

@@ -23,7 +23,7 @@ var whoami_default = defineCommand({
 			if (!token) {
 				writeResult({
 					logged_in: false,
-					message: "No token cached. Run `xiaobao-cli auth login` to log in."
+					message: "No token cached. Run `xiaobao-cli auth login --no-wait` then `xiaobao-cli auth login --resume` to log in."
 				}, args.format);
 				return;
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@puyinkai/xiaobao-cli",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "旺小宝 CLI — host-agnostic 14 tools (openclaw-xiaobao plugin 的 CLI 等价物)",
   "type": "module",
   "bin": {
@@ -10,6 +10,10 @@
     "dist/**/*.mjs",
     "dist/**/*.d.mts",
     "skills/**/*.md",
+    "skills/**/*.py",
+    "skills/**/*.html",
+    "skills/**/*.png",
+    "skills/**/*.json",
     "README.md"
   ],
   "engines": {

package/skills/wangxiaobao-audio-query/SKILL.md

@@ -17,7 +17,7 @@ metadata:
 
 ## 执行前必读
 
-- 必须有有效 token：先调 `xiaobao-cli auth whoami`，未登录 / 过期就调 `xiaobao-cli auth login`
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`，未登录 / 过期就走 `auth login --no-wait` split-flow（见 wangxiaobao-shared）
 - **必须有激活项目**：tenant/project 由 命令内部从
   `~/.xiaobao/active-project.json` 读，调用方不需要传任何
   tenant/project 参数。如果 命令 返回 `error: 'NO_ACTIVE_PROJECT'`，
@@ -184,7 +184,7 @@ xiaobao-cli audio list --from "2026-05-06 00:00:00" --to "2026-05-13 00:00:00" -
 
 - **`code: "400"` / `msg: "消息转换异常"`** — fromDate/toDate 格式不对。
   必须 `yyyy-MM-dd HH:mm:ss` 空格分隔，不带时区。
-- **401 / token 过期** — 调 `xiaobao-cli auth login --force` 重登，重试一次。
+- **401 / token 过期** — 走 `auth login --no-wait --force` split-flow 重登，重试一次。
 - **`total: 0`** — 时间窗口里确实没数据，或激活的租户/项目错了。
   让用户跑 `wangxiaobao-switch-project` skill 确认或重新激活项目。
 - **`error: 'NO_ACTIVE_PROJECT'`** — 还没设过激活项目。让用户跑

package/skills/wangxiaobao-audio-wiki/SKILL.md

@@ -25,7 +25,7 @@ Layer 2 知识页**。
 
 ## 执行前必读
 
-1. **登录**：先调 `xiaobao-cli auth whoami`；未登录 / 过期就调 `xiaobao-cli auth login`。
+1. **登录**：先调 `xiaobao-cli auth whoami`；未登录 / 过期就走 `auth login --no-wait` split-flow（见 wangxiaobao-shared）。
 2. **激活项目**：命令内部从 `~/.xiaobao/active-project.json`
    读 tenant/project。如果任何 命令 返回 `error: 'NO_ACTIVE_PROJECT'`，
    先走 `wangxiaobao-switch-project` skill 让用户选。
@@ -84,7 +84,7 @@ for each window [winStart, winEnd):
     否则 page += 1
 ```
 
-若 命令 返回 401 → 调 `xiaobao-cli auth login --force` 后重试当前窗口
+若 命令 返回 401 → 走 `auth login --no-wait --force` split-flow 重登后重试当前窗口
 （最多重试一次）。
 
 ### 第 3 步：逐条取文本
@@ -243,7 +243,7 @@ wiki/projects/{projectId}-{projectName}/
 ## 完整链路
 
 ```
-1. xiaobao-cli auth login             — 拿到 token
+1. xiaobao-cli auth login --no-wait → --resume   — 拿到 token
 2. wangxiaobao-switch-project    — 选好租户/项目，写 ~/.xiaobao/active-project.json
 3. 本 skill - sync 阶段          — 翻页拉 → 逐条取文本 → 按 顾问/日期 写 raw → 推进游标
 4. 本 skill - ingest 阶段         — 读 raw/ → 提炼 4 层 Layer 2 知识页 → 更新 index/log
@@ -271,7 +271,7 @@ wiki/projects/{projectId}-{projectName}/
 
 ## 常见错误与排查
 
-- **`xiaobao-cli audio list` 返回 401** — token 过期 → `xiaobao-cli auth login --force` 重登
+- **`xiaobao-cli audio list` 返回 401** — token 过期 → 走 `auth login --no-wait --force` split-flow 重登
 - **`xiaobao-cli audio text` 返回 `data: null` / `texts: []`** — 转录未就绪 / 录音异常 → 跳过该条
 - **page 翻不动 / 重复返回同一页** — 检查 page 是否从 1 开始；`total = 0` 直接结束窗口
 - **fromDate/toDate 报参数错** — 用空格分隔的 `yyyy-MM-dd HH:mm:ss`，不带时区

package/skills/wangxiaobao-customer-focus-query/SKILL.md

@@ -17,7 +17,7 @@ metadata:
 
 ## 执行前必读
 
-- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就 `xiaobao-cli auth login`
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就走 `auth login --no-wait` split-flow（见 wangxiaobao-shared）
 - **必须有激活项目**：命令内部自动读，缺失返回 `NO_ACTIVE_PROJECT`
 - **数据权限隔离**：按当前用户授权可见顾问范围过滤（普通顾问看自己 /
   团队长看团队 / 项目管理员看全项目）
@@ -156,7 +156,7 @@ xiaobao-cli focus list --audio-ids 507494047338729472 --page 1 --size 50
 ## 常见错误与排查
 
 - **`error: 'NO_ACTIVE_PROJECT'`** — 跑 `wangxiaobao-switch-project` skill
-- **401 / token 过期** — 调 `xiaobao-cli auth login --force` 重登
+- **401 / token 过期** — 走 `auth login --no-wait --force` split-flow 重登
 - **`total: 0`** — 过滤条件没匹配 / 该时段没数据 / 当前用户授权范围内没匹配的接待顾问
 - **传入的 ID 找不到对应数据** — 数据权限隔离把不属于授权顾问的 tag 过滤掉了；
   这是预期行为，不是 bug

package/skills/wangxiaobao-customer-query/SKILL.md

@@ -17,7 +17,7 @@ metadata:
 
 ## 执行前必读
 
-- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就 `xiaobao-cli auth login`
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就走 `auth login --no-wait` split-flow（见 wangxiaobao-shared）
 - **必须有激活项目**：命令内部自动读，如果返回 `NO_ACTIVE_PROJECT` 就跑
   `wangxiaobao-switch-project` skill
 - **数据权限隔离**：后端按"当前用户授权可见的顾问范围"过滤（普通顾问看自己 /
@@ -158,7 +158,7 @@ xiaobao-cli customer list --page 1 --size 1
 ## 常见错误与排查
 
 - **`error: 'NO_ACTIVE_PROJECT'`** — 跑 `wangxiaobao-switch-project` skill
-- **401 / token 过期** — 调 `xiaobao-cli auth login --force` 重登
+- **401 / token 过期** — 走 `auth login --no-wait --force` split-flow 重登
 - **`total: 0`** — 时间窗口 / 过滤条件没匹配到，**或**当前用户授权范围为空
   （新人顾问刚入职 / 团队成员被移走等）
 - **顾问名找不到** — 不在当前用户授权可见范围内；不要硬调 list_customers 试

package/skills/wangxiaobao-customer-resistance-query/SKILL.md

@@ -18,7 +18,7 @@ metadata:
 
 ## 执行前必读
 
-- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就 `xiaobao-cli auth login`
+- 必须有有效 token：先调 `xiaobao-cli auth whoami`；未登录就走 `auth login --no-wait` split-flow（见 wangxiaobao-shared）
 - **必须有激活项目**：命令内部自动读，缺失返回 `NO_ACTIVE_PROJECT`
 - **数据权限隔离**：按当前用户授权可见顾问范围过滤（普通顾问看自己 /
   团队长看团队 / 项目管理员看全项目）
@@ -150,7 +150,7 @@ xiaobao-cli resistance list --category 户型 --from "2026-05-01 00:00:00" --to
 ## 常见错误与排查
 
 - **`error: 'NO_ACTIVE_PROJECT'`** — 跑 `wangxiaobao-switch-project` skill
-- **401 / token 过期** — 调 `xiaobao-cli auth login --force` 重登
+- **401 / token 过期** — 走 `auth login --no-wait --force` split-flow 重登
 - **`total: 0`** — 过滤条件没匹配 / 该时段没数据 / 当前用户授权范围内没匹配的接待顾问
 - **抗性点 vs 关注点**：跟 LLM 强调"抗性"是负面（疑虑/反对），"关注"是中性偏正
   （主动关心）；用户说"嫌弃 / 担心 / 不满"走抗性，"在意 / 关心 / 偏好"走关注

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