[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80621":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":13,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":14,"forks30d":14,"starsTrendScore":18,"compositeScore":19,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":8,"pushedAt":8,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":14,"starSnapshotCount":14,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},80621,"helloagents-trip-planner","nameless0120\u002Fhelloagents-trip-planner","nameless0120",null,"Python",67,7,52,1,0,6,10,15,18,55.21,false,"main",true,[],"2026-06-12 04:01:29","# HelloAgents Trip Planner\n\n一个面向真实旅行规划场景的智能旅行助手。仓库里有可运行的 Web 应用、FastAPI 后端、基于高德地图的结构化工具快照，也保留了后训练数据和评测口径。\n\n当前公开仓库聚焦稳定的 Planner 主线：后端把用户请求、人数、预算、住宿、天气、景点、酒店、餐饮和价格 hint 编译成可审计的 `PlannerContext`，Planner 模型再在这些约束内生成结构化 `TripPlan JSON`。历史实验管线、私有交流记录、模型权重、训练 checkpoint、运行日志和本地密钥不会上传。\n\n## 功能\n\n- 生成多日旅行计划：目的地、日期、同行人数、预算、交通、住宿和偏好共同约束输出。\n- 结构化工具快照：后端收集景点、酒店、餐饮、天气、价格 hint 和候选计数，减少模型自由编造。\n- 预算账本训练口径：显式区分酒店单房每晚价、景点成人票价、餐饮单人单餐价和同行人数。\n- Web 交互界面：Vue 3 + TypeScript + Ant Design Vue，支持旅行需求填写和结果展示。\n- 后训练资产：包含 SFT 数据、冻结评估集、规则评测指标、baseline 汇总和数据生成脚本。\n\n## 界面预览\n\n旅行请求填写：\n\n\u003Cimg src=\"docs\u002Fimages\u002Ftrip-request.png\" alt=\"旅行请求填写界面\" width=\"720\">\n\n旅行计划结果：\n\n\u003Cimg src=\"docs\u002Fimages\u002Ftrip-plan-result.png\" alt=\"旅行计划结果界面\" width=\"720\">\n\n## 技术栈\n\n后端：\n\n- FastAPI\n- HelloAgents `SimpleAgent`\n- 高德地图 HTTP API \u002F amap MCP 辅助接口\n- OpenAI-compatible LLM 服务\n- Pydantic schema 校验\n\n前端：\n\n- Vue 3\n- TypeScript\n- Vite\n- Ant Design Vue\n- 高德地图 Web JS API\n\n训练与评测：\n\n- LLaMA-Factory 数据格式\n- `PlannerContext` 协议\n- 规则评测脚本\n- SFT \u002F DPO 数据准备脚本\n\n## 目录结构\n\n完整目录职责和本地\u002F公开资产边界见 [PROJECT_STRUCTURE.md](PROJECT_STRUCTURE.md)。\n\n```text\nhelloagents-trip-planner\u002F\n├── backend\u002F\n│   ├── app\u002F\n│   │   ├── agents\u002F          # Planner Agent、prompt 和生成失败反馈\n│   │   ├── api\u002F             # FastAPI 路由\n│   │   ├── models\u002F          # TripRequest \u002F TripPlan schema\n│   │   ├── planner\u002F         # PlannerContext、预算、票价、路线和输出校验\n│   │   └── services\u002F        # LLM、高德、图片等服务封装\n│   ├── requirements.txt\n│   └── run.py\n├── docs\u002F\n│   └── images\u002F              # README 展示截图\n├── frontend\u002F\n│   ├── src\u002F\n│   │   ├── services\u002F\n│   │   ├── types\u002F\n│   │   └── views\u002F\n│   ├── package.json\n│   └── vite.config.ts\n├── skills\u002F               # Codex 本地工作流技能\n├── training\u002F\n│   ├── configs\u002F             # 按模型分组的训练配置\n│   ├── data\u002F                # 训练\u002F评估数据\n│   ├── docs\u002F                # 协议、指标和后训练说明\n│   ├── outputs\u002Feval\u002F        # 公开的评测汇总\n│   ├── prompts\u002F             # 数据生成 prompt\n│   └── scripts\u002F             # 训练脚本，按 shared\u002Fserving\u002Fvalidation 和当前任务分组\n├── PROJECT_STRUCTURE.md  # 项目级目录索引\n└── README.md\n```\n\n## 快速开始\n\n### 前置条件\n\n- Python 3.11\n- Node.js 22 或兼容版本\n- 高德地图 API Key\n- OpenAI-compatible LLM API Key\n- 可选：Unsplash API Key，用于景点图片\n\n### 后端\n\n```bash\ncd helloagents-trip-planner\u002Fbackend\npython -m venv .venv\nsource .venv\u002Fbin\u002Factivate\npip install -r requirements.txt\ncp .env.example .env\n```\n\n编辑 `backend\u002F.env`，至少配置：\n\n```bash\nAMAP_API_KEY=your_amap_api_key\nLLM_MODEL_ID=your_model_name\nLLM_API_KEY=your_llm_api_key\nLLM_BASE_URL=your_openai_compatible_base_url\n```\n\n启动服务：\n\n```bash\npython run.py\n```\n\n默认地址：\n\n- API: `http:\u002F\u002Flocalhost:7000`\n- Swagger: `http:\u002F\u002Flocalhost:7000\u002Fdocs`\n- Health check: `http:\u002F\u002Flocalhost:7000\u002Fhealth`\n\n### 前端\n\n```bash\ncd helloagents-trip-planner\u002Ffrontend\nnpm ci\ncp .env.example .env\n```\n\n编辑 `frontend\u002F.env`：\n\n```bash\nVITE_API_BASE_URL=http:\u002F\u002Flocalhost:7000\nVITE_AMAP_WEB_KEY=your_amap_web_key\nVITE_AMAP_WEB_JS_KEY=your_amap_web_js_key\n```\n\n启动开发服务：\n\n```bash\nnpm run dev -- --host 0.0.0.0 --port 5173\n```\n\n默认地址：\n\n- Web: `http:\u002F\u002Flocalhost:5173`\n\n## API 概览\n\n启动后端后可以访问 `http:\u002F\u002Flocalhost:7000\u002Fdocs` 查看完整 OpenAPI 文档。主要接口：\n\n- `POST \u002Fapi\u002Ftrip\u002Fplan`：生成旅行计划\n- `GET \u002Fapi\u002Ftrip\u002Fhealth`：检查 Planner 服务\n- `GET \u002Fapi\u002Fmap\u002Fpoi`：搜索 POI\n- `GET \u002Fapi\u002Fmap\u002Fweather`：查询天气\n- `POST \u002Fapi\u002Fmap\u002Froute`：规划路线\n- `GET \u002Fapi\u002Fpoi\u002Fdetail\u002F{poi_id}`：获取 POI 详情\n- `GET \u002Fapi\u002Fpoi\u002Fphoto`：获取景点图片\n\n## 后训练资产\n\n`training\u002F` 目录记录训练和评测主线。这里的做法是先由后端生成稳定、可审计的 `PlannerContext`，再让模型学习把它转换成合法的 `TripPlan JSON`。\n\n推荐入口：\n\n- [training\u002Fdocs\u002F教程\u002F旅行助手后训练实战教程.md](training\u002Fdocs\u002F教程\u002F旅行助手后训练实战教程.md)：从 PlannerContext 到 SFT、Best-of-N 和评测的实战教程\n- [training\u002FREADME.md](training\u002FREADME.md)：后训练目录说明\n- [training\u002FSTRUCTURE.md](training\u002FSTRUCTURE.md)：训练资产、数据、脚本、报告的目录边界\n- [training\u002Fdocs\u002FREADME.md](training\u002Fdocs\u002FREADME.md)：长期文档索引\n- [training\u002Foutputs\u002Feval\u002FREADME.md](training\u002Foutputs\u002Feval\u002FREADME.md)：评测输出与公开报告索引\n- [training\u002Foutputs\u002Feval\u002Freports\u002F260512_bestofn_replay_extended_w10\u002FREADME.md](training\u002Foutputs\u002Feval\u002Freports\u002F260512_bestofn_replay_extended_w10\u002FREADME.md)：2026-05-12 当前评测报告包\n\n当前仓库保留主线材料，不上传历史数据、私有交流记录、模型权重、checkpoint 和大规模运行产物。\n\n## 安全与忽略规则\n\n不要提交真实密钥。`.gitignore` 已经排除了这些内容：\n\n- `backend\u002F.env`、`frontend\u002F.env`\n- Python \u002F Node 本地环境\n- `node_modules\u002F`、构建产物、日志\n- 训练输出、模型权重、checkpoint\n- 历史管线和废弃 prompt 消融\n- 私有作者交流、会话记忆和临时文档\n\n`.env.example` 会保留在仓库中，作为配置模板。\n\n## 许可证\n\nCC BY-NC-SA 4.0\n\n## 致谢\n\n- [HelloAgents](https:\u002F\u002Fgithub.com\u002Fdatawhalechina\u002FHello-Agents)\n- [高德地图开放平台](https:\u002F\u002Flbs.amap.com\u002F)\n- [amap-mcp-server](https:\u002F\u002Fgithub.com\u002Fsugarforever\u002Famap-mcp-server)\n","HelloAgents Trip Planner 是一个智能旅行助手，旨在为用户提供基于真实场景的多日旅行规划。项目核心功能包括根据用户输入的目的地、日期、预算等信息生成详细的旅行计划，并通过结构化工具快照减少模型的信息编造，确保输出的质量与实用性。技术上采用FastAPI构建后端服务，结合高德地图API和OpenAI兼容的大语言模型进行行程规划，前端则使用Vue 3搭配TypeScript实现友好交互界面。该工具特别适合个人或团队在准备出行前快速制定合理的旅行安排，同时对研究者而言也是一个良好的实验平台，用于探索如何将自然语言处理技术应用于具体的生活服务场景中。",2,"2026-06-11 04:01:25","CREATED_QUERY"]