酒店管家

酒店管家 Skill - 管理酒店 OTA 基础信息、房价库存及订单同步。

Hotel Manager Skill

本 Skill 为酒店管理人员提供多平台（OTA）统一管理方案，支持 API 自动化 与 浏览器自动化 双模式。

[!IMPORTANT] 本仓库目前提供的是 集成架构模板。在使用前，您需要根据特定平台的 API 文档完善 scripts/ota_client.js 中的协议细节。

安全与隐私 (Security)

为了保护您的 API 密钥，本 Skill 采用以下安全策略：

1. 环境变量优先：强烈建议通过环境变量配置凭证。
2. 浏览器沙箱：UI 自动化模式利用 Agent 已有的浏览器会话，不需本地存储明文密码。
3. 安全传输：脚本强制使用 HTTPS 请求。

配置指南

方法 A: 环境变量 (推荐 API 模式)

设置 OTA_CTRIP_API_KEY 等变量。详细列表见上方元数据。

方法 B: UI 自动化模式 (无 API 时)

无需特殊 API 配置，Agent 将直接操作浏览器。参考 scripts/browser_controller.js 了解 SOP。

核心功能

1. OTA 基础信息管理：同步酒店描述、设施等。
2. 日常价库调整：支持批量 API 更新及智能体 直接改价（浏览器模拟）。
3. 房态控制：快速开关特定房型，支持跨平台同步。
4. 自动接单同步：一键开启订单抓取并推送到内部系统。

操作模式

1. API 模式

高速执行，适用于大型酒店连锁。逻辑位于 scripts/ota_client.js。

2. 浏览器直接改价 (Visual Mode)

适用于无法获取 API 权限的小型客栈或特殊 OTA 平台。

• Agent 执行逻辑：打开对应的 OTA 后台网页 -> 自动定位改价区 -> 执行修改并截图存证。
• 详见：scripts/browser_controller.js。

权限说明

• 网络访问：访问 OTA 后台及内部 API。
• 浏览器权限：需要读写及点击操作权限。

最佳实践

• 操作留痕：UI 模式下建议 Agent 在每次改价后提供页面截图。
• 速率限制：避免过快操作导致封禁，脚本预留了休眠策略。