Skip to content

Releases: tczyliu/china-travel-kit

华行志 Huaxingzhi v0.5.0 Alpha · 官方签名预发布

Choose a tag to compare

@tczyliu tczyliu released this 25 Aug 15:28

华行志 v0.5.0 Alpha|首个官方数字签名预发布

华行志(Huaxingzhi)是一个面向首次来华自由行游客的中英双语 Agent Skill 与中国旅行知识库。本版本首次加入官方数字签名验证,让用户能够确认下载的文件是否完整、是否来自华行志官方发布密钥。

当前为 Alpha 数据集和开发者预览版,不是订票、实时导航或紧急救援服务。

本版亮点

  • 覆盖北京、上海、广州、深圳、成都、西安、杭州、丽江 8 个城市,共 56 个地点。
  • 支持按人数、日期、目的地、兴趣、节奏、预算与无障碍需求进行行程匹配。
  • 提供景点查询、住宿区域、交通提示、文化背景、特色饮食、季节准备和紧急求助信息。
  • 收录城市文旅官网及气象、景区等官方复核入口。
  • 提供网页查询界面、Python CLI、HTTP API、MCP Server 与可安装 Agent Skill。
  • 采用 SHA-256 完整性清单与 Ed25519 数字签名验证官方版本。

下载与使用

可以下载本页底部 GitHub 自动生成的 Source code (zip) 或 Source code (tar.gz),解压后进入项目目录。

需要 Python 3.10 或更高版本;使用内置数据时不需要 API Key,也不需要安装运行时依赖。

启动网页查询界面:

python3 -m china_travel_kit serve

随后打开:http://127.0.0.1:8765/

验证是否为官方版本

在解压后的项目目录运行:

python3 -m china_travel_kit integrity

只有以下两个字段同时为 true,才表示清单签名可信且受保护文件完整:

{
  "valid": true,
  "signature_valid": true
}

本版本共验证 58 个受保护文件。

官方 Ed25519 公钥指纹:

SHA256:BxRBwLOMjmWiZEXGr443RJqRAyOXL4bUJ/KzsK2o7bA

本页提供三个验证附件:

  • huaxingzhi-release-key.pub:官方公钥
  • integrity-manifest.json:文件哈希清单
  • integrity-manifest.json.sig:清单的官方数字签名

发布私钥只保存在作者本地,从未上传到 GitHub。数字签名可以识别文件缺失、修改或伪造清单,但不能阻止 MIT 与 CC BY-SA 4.0 许可证允许的复制和再分发。

当前限制

  • 目前只覆盖上述 8 个城市,不代表完整的中国城市或景点名录。
  • 季节建议不是实时天气预报。
  • 不提供实时票务库存、酒店排名、逐向导航、签证资格判断或紧急救援调度。
  • 出发前请通过当地文旅、气象、交通、景区运营方及政府官方渠道复核开放时间、预约政策、价格、天气预警与交通安排。

许可与联系

  • 代码:MIT License
  • data/ 旅行数据:CC BY-SA 4.0
  • 项目合作、数据纠错与建议:微信 Changzhanzhang

Huaxingzhi v0.5.0 Alpha | First Officially Signed Prerelease

Huaxingzhi is a bilingual Agent Skill and source-aware China travel knowledge base designed primarily for first-time independent visitors to China.

This Alpha covers 56 places across eight cities: Beijing, Shanghai, Guangzhou, Shenzhen, Chengdu, Xi'an, Hangzhou, and Lijiang. It includes explainable trip matching, attraction and stay-area discovery, itinerary drafts, local transport context, cultural and food guidance, seasonal preparation, emergency context, official live-check links, a visual web interface, CLI, HTTP API, and MCP server.

To authenticate the downloaded release, run:

python3 -m china_travel_kit integrity

Trust the package only when both valid and signature_valid are true. The signing private key remains local to the maintainer and is not included in this repository.

This is an Alpha dataset and developer preview, not a booking service, live navigation system, visa authority, medical service, or emergency dispatcher. Always recheck time-sensitive travel facts with the relevant official authority or operator before departure.