霞客 Xiake

画一条线，把它变成值得活的旅程。

为深度旅行者打造的 AI 陪伴产品。Route-based 路线规划、在地讲解、旅行后自动织成杂志。

Stack

• Frontend: Next.js 16 (App Router) + TypeScript + Tailwind 4 + shadcn/ui
• Backend: Supabase (Postgres + PostGIS + pgvector + Auth + Storage)
• AI: Claude API (Sonnet 4.6 generation + Haiku 4.5 fast tasks, with prompt caching)
• Maps: 高德 (国内) / Mapbox (出境游 v2)
• Deploy: Vercel

Local Dev

# 1. Install deps
pnpm install

# 2. Copy env template and fill in your keys
cp .env.example .env.local

# 3. Run dev
pnpm dev

打开 http://localhost:3000

Project Structure

src/
├── app/                    # Next.js App Router pages
├── components/
│   ├── ui/                 # shadcn primitives
│   ├── layout/             # Header, MainLayout
│   ├── map/                # 高德 map components
│   ├── route/              # Route cards, timeline, stop editor
│   ├── trip/               # Trip cards, memory capture
│   └── magazine/           # Magazine layout, page renderer
├── data/
│   └── seed-routes/        # Cold-start route data (6 条硬编码路线 = 当前数据真源)
├── lib/
│   ├── supabase/           # Browser + server clients (Phase 2 脚手架，未接线)
│   ├── ai/                 # Claude client (Phase 2 脚手架，未接线)
│   ├── maps/               # 高德 SDK wrapper
│   └── themes.ts           # Per-route 主题系统 (7 themes, OKLCH light/dark)
└── types/                  # Shared TypeScript types

supabase/
└── migrations/             # SQL schema migrations (已写未 apply 消费)

交接与现状文档：AGENTS.md（约定+硬契约）+ docs/HANDOFF-2026-06.md（真实进度+backlog）

Licensing

三层拆分（详见各文件）：

• 代码 — AGPL-3.0(根目录 LICENSE)。版权归项目所有者; 官方 App Store 发行版由版权人另行以专有条款分发(双许可)。 外部贡献需签署 CLA 后方可合并——否则请以 issue 形式反馈。
• 路线叙事内容（src/data/seed-routes/ 的中文叙事文本）— CC BY-NC-ND 4.0
• 品牌（「霞客 Xiake」名称 / logo / 视觉识别）— 保留权利，见 NOTICE

Phases

• P0 地基 ✅ 完成
• P1 策划路线浏览 🟡 大半完成（6 条路线 + 主题系统 + PWA 已上线；fork + auth 未做）⭐ 当前阶段
• P2 AI 路线生成：route generation + stop narration + drag edit
• P3 在地陪伴：PWA 优化 + 位置感知 + 翻译+文化解释
• P4 杂志：旅行后 AI 织出可分享的"杂志"
• P5 商业化：订阅 + Trip Guides marketplace