旅行报价生成器

本公开 Hub 版本为团队旅行报价生成两份 Word 文档：

默认配置文件：config.json 采用 Spring Tour 品牌标识。其他团队可在不修改代码的前提下，通过配置文件替换公司名称、配色、Logo、图片源顺序、基准成本及措辞。

成本配置状态

每次启动报价任务前，请检查本地成本文件是否存在：

node -e "const { hasLocalCost, getLocalCostPath } = require('./assets/cost_store'); console.log(hasLocalCost(), getLocalCostPath())"

本地成本路径默认为 ~/.travel-quote/cost.json。该路径位于技能目录之外，因此包更新不会覆盖部门级设置。

每轮新对话均应在报价前简要说明当前配置状态；且该状态需在初始化后持续可见，因为各部门将持续迭代车辆、门票及酒店价格。

• 若本地成本文件不存在：显示配置引导，并说明报价仍可基于公开基准估算值继续进行。
• 若本地成本文件存在：说明正在使用本地部门成本，并提供如下选项：“补充常用景点票价 / 调整地区用车 / 维护常用酒店 / 调整车导餐保险水 / 重设成本”。
• 若用户在报价过程中提供了新的门票或成本信息，应在当前报价完成后，主动询问是否将该信息保存回本地成本文件。

若本地成本文件不存在，提供以下三种选择：

1. 快速表单配置：通过紧凑式表单一次性采集上海 37 座车、上海 49 座车、杭州或其他常用目的地用车价格、导游费、餐标、保险、瓶装水、常用景点门票及常用酒店等信息。
2. Excel 配置：运行 node assets/init_cost.js template 生成模板，由用户填写后，再执行 node assets/init_cost.js import 导入。
3. 暂跳过：继续使用公开基准值，并提示这些仅为估算值。

若用户提出“重设成本”、“更新成本”、“补充门票”或“reset costs”，则重新生成、导入或补丁更新本地成本文件。

Excel 配置模板包含以下工作表：

• 固定成本：导游费、餐标、保险、瓶装水、利润倍率，以及默认的上海车辆基准价。
• 常用景点门票：经部门确认的景点或活动门票价格。
• 地区用车：提供上海与杭州等地示例，便于配置人员理解不同城市车辆价格存在差异。仅导入含数值的价格行。
• 常用酒店：酒店名称、所在区域、房型、默认每间夜价格，以及可选的日期-价格 JSON 字段。每种房型单独占一行；样例行若未填价格，则不被导入。对于多日期价格，仅填写已确认的特殊日期，例如 {"2026-06-15":520,"2026-06-16":560,"2026-06-17":520}；其余日期自动回落至默认价格。如业务用户不熟悉 JSON 编写，可先将多日期价格填入备注栏，后续统一整理后再导入或于报价确认前完成结构化处理。本表用于存储酒店引用，以支持后续房间日历定价；但每份最终报价仍须单独确认住宿价格。
• 酒店填写说明：非导入用辅助工作表，含常见酒店填写示例，包括常规价格、周末/旺季价格、临时报价价格及多种房型组合。

成本数据优先级

针对上海标准成本，按以下顺序解析取值：

1. 当前报价输入
2. 本地 ~/.travel-quote/cost.json
3. 配置文件 config.json 中的公开基准值

车辆成本依据 carType 选择 carTotal37 或 carTotal49，除非报价输入中已明确指定 fixedCosts.carTotal。

针对非上海城市，车辆价格按以下顺序解析：

1. 当前报价输入中的 fixedCosts.carTotal
2. 本地 cost.json 中 地区用车 表格所定义的 regionalCarCosts，按城市与车型匹配
3. 参考文档 references/car-cost-policy.md 中公布的车辆成本区间

若本地地区车辆价格已标记为“已确认”，则直接采用，无需添加调度预警备注；若未确认，或仅有公开区间可用，则面向客户的表述中应注明“当地车辆资源以最终调度确认为准”，而内部成本表中则需展示估算区间。

门票规则

公开版 assets/spot_catalog.json 中不得包含门票价格、图片路径或私有源 URL。

常用景点门票价格来自本地 cost.json 中的 spotTickets 字段。备注可包含工作日/周末、儿童票、季节性、团体规模等适用规则。当备注表明存在多个可能价格时，须在最终报价前向业务用户确认适用档位。

临时新增景点须逐单确认。即使某景点免费，仍需向业务用户确认，并设置 ticketPriceConfirmed: true。

当门票数据不完整时，应批量汇总确认项，而非逐个询问。请以紧凑表格形式呈现：

请业务用户填写或确认最后一列。若需开展公开调研，请注明该价格仅为市场参考，不代表供应商承诺。

交互顺序

优先采用前置式表单收集业务用户信息。一次性提问，后续仅就缺失项或高风险项进行跟进。

起始采用如下紧凑式报价信息采集表单：

请一次性补充/确认这些信息，已确定的填具体值，不确定可写“待定”：
1. 客户/团队名：
2. 出行日期、人数、城市：
3. 天数/晚数：
4. 已选景点或希望推荐的区域/主题：
5. 是否有临时景点、门票/体验费是否已确认：
6. 餐标：
7. 多日住宿：酒店名/双人间/单间人数和价格：
8. 用车：车型/是否已有确认车价：
9. 预算、竞品价、目标报价或价格敏感度：
10. 是否需要把本次确认的成本/门票保存为常用配置：

收到表单后执行以下步骤：

1. 仅使用纯文本问题确认出行日期与人数。
2. 从 cost.json 自动填充已知的本地成本与门票价格。
3. 对缺失的门票、车辆价格、闭园信息或预订规则，汇总市场/公开参考信息，并以单张表格形式请求最终确认。
4. 对于多日行程，须在最终餐标与价格审核前先行确认住宿安排。
5. 呈现成本估算、市场参考价及建议报价区间。
6. 请业务用户确认最终的 salePricePerPerson。

对于多日行程，须基于总成本重新计算报价，不可复用单日默认价格。

价格确认规则

切勿将 pricing.profitMultiplier 视为最终报价。它仅作为首轮估算的建议参考价。

在正式生成 Word 文件前，业务用户必须确认最终销售价格。脚本通过强制要求如下字段来确保该流程：

{
  "salePricePerPerson": 300,
  "salePriceConfirmed": true
}

若无已确认的销售价格，则运行 build_plan.js --dry-run 展示成本估算与建议参考价，再请用户确认具有竞争力的最终报价。

客户安全边界

面向客户的报价文件中严禁出现任何内部成本相关表述：利润率、利润、亏损、成本、内部核算、供应商底价、团队用车成本、团队导游成本、人均保险成本、人均瓶装水成本等。

内部成本表可包含上述细节，但必须明确标注为“内部专用”。

文件输出

禁止硬编码个人用户名或机器特定路径。

默认输出路径应为当前用户桌面下的单一会话文件夹，或用户指定的工作区文件夹。文件夹命名格式如下：

{route}_{people}_{MMDD}

同一会话的客户报价单与内部成本表必须保存在同一文件夹内。

图片来源

为兼容 Skill Hub 上传要求，二进制图片未打包进发布包。默认品牌 Logo 以文本形式嵌入于 assets/brand/logo_embedded.js，并在文档生成时动态还原。景点图片于运行时实时获取，并缓存至 assets/cache/spot_images/ 目录下。

运行时图片源顺序配置于 config.json 中，切勿依赖打包的本地风景图片。

["springtour", "wiki"]

Spring Tour 图片源默认启用，仅作为示例/默认配置，可在配置中禁用或替换。

脚本使用方法

安装依赖：

cd assets
npm install

生成试运行方案（dry-run）：

node build_plan.js --dry-run '{"people":20,"route":"上海精选一日游","selectedSpotIds":["fengxian-museum"]}'

生成两份 Word 文件：

node build_plan.js '{"people":20,"route":"上海精选一日游","selectedSpotIds":["fengxian-museum"],"salePricePerPerson":300,"salePriceConfirmed":true,"outputDir":"../outputs/example"}'

公开包红线条款

发布前请务必验证以下事项：

• 不含真实客户姓名。
• 不含内部成本表格或线路毛利相关引用。
• 不含打包的第三方风景图片。
• 不含 node_modules、outputs、.DS_Store 或图片缓存文件。
• assets/spot_catalog.json 中不含门票价格、图片路径或私有源 URL。