China Travel Kit (Huaxingzhi)

一个开源的、双语的智能体技能和旅行知识库，包含可解释的需求匹配器、视觉中国旅行查找器、零运行时依赖的Python查询引擎、CLI、HTTP API和MCP服务器。该数据集关注国际游客难以验证的中国旅行部分：游客区域、预约、护照特定说明、季节性风险、无障碍设施、紧急情况、交通、官方城市旅游门户和数据新鲜度。目前覆盖北京、上海、广州、深圳、成都、西安、杭州和丽江的56个地点。An open-source, bilingual AI Agent skill and travel knowledge base dataset that includes an interpretable demand matcher, Visual China Travel Finder, Python query engine with zero runtime dependencies, CLI, HTTP API, and MCP server. This dataset focuses on the parts of travel in China that are difficult for international tourists to verify: tourist areas, reservations, passport-specific instructions, seasonal risks, accessibility facilities, emergencies, transportation, official city tourism portals, and data freshness. It currently covers 56 locations across Beijing, Shanghai, Guangzhou, Shenzhen, Chengdu, Xi'an, Hangzhou, and Lijiang.

原始信息汇总

华行志（China Travel Kit）数据集概述

基本信息

• 版本：v0.5.0 Alpha
• 语言：中英双语
• 性质：开源、可溯源的中国旅游规划Agent Skill与旅游知识库
• 覆盖范围：当前覆盖北京、上海、广州、深圳、成都、西安、杭州、丽江等8个城市的56个地点
• 开发状态：Alpha数据集与开发者预览版，非预订服务或实时导航系统

核心功能

• 可解释的需求匹配器：根据用户需求推荐城市并解释匹配逻辑
• 可视化中文旅游查找工具：提供响应式中文界面，可搜索景点并生成行程卡片
• 零运行时依赖的Python查询引擎：支持CLI搜索、行程草稿生成
• 本地HTTP API：提供9个端点（/health、/cities、/recommend、/search、/areas、/plan、/prepare、/emergency、/freshness）
• MCP服务器：通过stdio暴露8个只读工具（recommend_trip、search_spots、discover_areas、get_city_guide、plan_itinerary、get_trip_preparation、get_emergency_help、check_data_freshness），支持MCP协议版本2025-11-25

数据特点

• 溯源优先：每条景点记录包含sources和last_verified字段
• 诚实处理未知值：价格和预订规则无法验证时设为null
• 安全上下文：海拔、天气、无障碍设施、许可、紧急情况等需明确标注来源
• 游客区域聚焦：覆盖住宿区和景点周边，不涉及居民或家庭数据
• 无商业平台数据：不复制携程、大众点评、马蜂窝或创作者内容

使用方式

• 快速体验：需Python 3.10+，无运行时依赖，克隆后可直接使用CLI命令
• Agent Skill集成：可将仓库作为Skill安装到兼容客户端
• 数据验证：支持运行validate和单元测试，并提供integrity完整性校验（含Ed25519签名）

数据原则

1. 来源优先于主张
2. 新鲜度即数据（需设置实际验证日期）
3. 未知优于编造
4. 禁止抓取商业指南
5. 安全需上下文支撑
6. 游客区域非私人地址

许可与声明

• 代码：MIT License
• 数据：CC BY-SA 4.0
• 第三方来源：遵循各自所有者条款
• 完整性：官方发布包含integrity-manifest.json及Ed25519签名
• 非目标：不提供实时天气、实时票务库存、签证资格判定、酒店排名、逐向导航或紧急调度服务

免责声明

旅行规则、入境政策、开放时间、价格、天气和交通可能随时变化，出行前需向相关机构或运营商核实关键信息。本项目不提供法律、医疗、移民、预订或紧急服务。

搜集汇总

数据集介绍

构建方式

华行志（China Travel Kit）是一个面向人类、应用及AI代理的开源双语旅行知识与规划技能库。其构建遵循一系列严谨的数据原则：优先采用官方运营商、政府公开数据、Wikidata、OpenStreetMap及原创贡献者的研究作为信源，每条景点记录均包含来源链接和最后核验日期，确保可追溯性；对于无法确证的票价或预约规则，刻意采用空值而非臆测，以避免误导；并明确禁止复制携程、大众点评等商业指南内容。数据以JSON格式存储，覆盖北京、上海、广州、深圳、成都、西安、杭州、丽江等主要门户城市的56个地点，聚焦国际游客难以核实的信息，如访客区域、预约要求、护照特别说明、季节性风险等，并计划优先扩展官方认定的5A/4A级景区。

特点

该数据集具备显著的独特优势。其‘源感知’特性使得每项事实都可溯源、可审查、可更新，通过拉取请求即可维护数据新鲜度。解释性需求匹配器、可视化中国旅行发现器、零运行时依赖的Python查询引擎以及CLI、HTTP API和MCP服务器，共同构筑了多渠道访问的灵活架构。尤为突出的是其数据持有原则：将‘新鲜度’本身视为数据属性，通过last_verified字段标注核验时间，确保信息的时效性；同时强调‘未知优于虚构’，避免提供自信但过时的信息。此外，数据集专注于安全相关的上下文，如海拔、气候、可达性、许可和紧急情况，并为开发者和AI代理设计了只读工具集，支持版本完整性和签名验证，保障了数据发布的可靠性与品牌一致性。

使用方法

该数据集的使用简洁而多元。基础查询可通过命令行实现，例如使用`python3 -m china_travel_kit search museum --city Beijing`搜索景点，或使用`recommend`命令根据需求推荐行程。启动可视化服务`python3 -m china_travel_kit serve`后，可在浏览器中通过响应式中文界面浏览景点和生成行程卡片。对于开发者，提供了本地HTTP API和MCP服务器，后者通过stdio暴露8个只读工具（如`recommend_trip`、`search_spots`、`plan_itinerary`等），便于集成到AI客户端。数据校验与完整性验证可通过`validate`和`integrity`命令执行，确保数据经过官方签名认证。所有操作无需API密钥，直接克隆仓库即可运行，体现了零门槛的便捷性。

背景与挑战

背景概述

华行志（China Travel Kit）数据集诞生于2025年，由研究者Changzhanzhang发起，旨在填补中国旅行数据在可验证性与可复用性方面的空白。该数据集以开放知识库的形态，为人类用户及AI代理提供覆盖北京、上海、广州等八大城市的56处景点信息，涵盖预约规则、护照要求、季节性风险及无障碍设施等国际游客难以核实的维度。其核心理念在于‘来源优先’与‘数据新鲜度’，通过关联官方信源与记录验证日期，构建了一个可审计、可更新的旅行知识体系。项目采用Agent Skill架构，集成Python查询引擎、CLI、HTTP API及MCP服务器，实现了从数据层到多接口的无缝衔接，为智能旅行规划提供了新范式。该数据集以其开放性与可解释性，为旅行信息领域注入了数据治理与透明度的新标准，对相关领域产生了深远影响。

当前挑战

华行志数据集面临多重挑战。领域层面，中国旅行信息高度动态且分散，涉及景区预约、季节性风险及无障碍设施等复杂维度，现有开放数据源稀缺且格式不一，整合与验证成为难题。构建过程中，团队坚持‘未知优于虚构’原则，对变动频繁的价格与预约规则采用可空值处理，但此举可能导致数据不完整，影响用户体验。同时，维护多城市数据的时效性要求持续投入人力，而数据来源的多样性（官方运营商、政府开放数据、维基数据等）增加了一致性校验的复杂度。此外，项目尚处Alpha阶段，覆盖范围有限（仅56处景点），难以满足全域旅行需求；且需在开放许可与品牌完整性保护间取得平衡，防止数据被篡改或未经授权使用，这要求实现如Ed25519签名等强化的完整性验证机制，进一步提升了技术实现门槛。

常用场景

经典使用场景

China Travel Kit (Huaxingzhi) 作为一个开源的、双语的中国旅行知识库，其经典使用场景在于为国际旅客、应用程序及AI代理提供可验证、来源清晰的旅行信息查询与行程规划服务。该数据集覆盖北京、上海、广州、深圳、成都、西安、杭州和丽江等主要旅游城市，通过CLI、HTTP API和MCP服务器等多种接口，支持用户进行景点搜索、需求匹配推荐、区域探索、行程草拟及应急信息获取，尤其聚焦于预订规则、护照要求、季节性风险等国际旅客难以核实的细节。

实际应用

在实际应用中，China Travel Kit 可作为旅行规划工具的核心数据层，服务于自助旅行者的行程定制，也可嵌入到旅游类App或聊天机器人中，提供即时的景点推荐与行程卡片生成。其MCP服务器设计使得兼容Agent Skills的AI客户端能够无缝调用八个只读工具，实现自然语言驱动的旅行咨询。此外，该数据集强调数据新鲜度与安全检查，可用于辅助旅行前的风险预警与应急准备，提升旅行者在陌生环境中的安全性与决策效率。

衍生相关工作

China Travel Kit 的发布衍生了多项相关经典工作，包括构建了可校验的数据完整性机制（如Ed25519签名和SHA-256哈希验证），用于检测数据篡改与伪造，为开源数据集的供应链安全树立了范例。其'来源优先'的数据采集策略和社区驱动的PR更新模式，激励了后续关于众包数据质量评估和分布式知识库维护的研究。基于该数据集，研究者还探索了多接口（CLI/API/MCP）统一数据层在跨平台应用中的架构设计，以及面向AI代理的可解释旅行推荐算法，推动了智能旅行助手领域的实践进展。