tabi-claw

name	tabi-claw
description	旅行的阿虾：一个持续运行的 AI 旅行仓库。按路线推进城市、生成游记与配图、维护状态和索引，并可自动提交 Git。当用户提到 TabiClaw、旅行的阿虾、阿虾游记、继续旅行、查看状态、重规划路线时使用。

TabiClaw / 旅行的阿虾

TabiClaw 不是一次性内容生成器，而是一个每天推进一天的旅行工作流项目。

阿虾会沿着 data/route.md 中的路线前进。每次执行每日工作流时，项目会：

• 读取当前状态
• 计算下一站
• 查询路线价格、景点、天气
• 生成一篇游记
• 生成一张配图
• 更新 status.json
• 更新 data/journals/index.md 顶部的当前状态面板和游记列表
• 记录 Git 提交

When to use this skill

• 用户提到“旅行的阿虾”、“TabiClaw”、“阿虾”
• 用户想“生成今天的游记”、“让阿虾继续旅行”
• 用户想生成某一段时间的阶段总结或路线海报
• 用户想查看当前状态、余额、当前城市、路线
• 用户想重新规划路线或从当前终点继续追加路线
• 用户想初始化、清理、重置这个项目

当前项目结构

TabiClaw/
├── README.md
├── README.en.md
├── config/
│   ├── city_map.json        # 城市中英文映射，已移入项目
│   ├── image_prompt.md      # 图片提示词模板
│   ├── image_style.md       # 图片风格配置
│   ├── journal_prompt.md    # 游记提示词模板
│   ├── persona.md           # 人设
│   ├── settings.yaml        # 路径 / 模型 / Git 行为等配置
│   └── style.md             # 文风配置
├── data/
│   ├── images/              # 生成图片
│   │   └── summaries/       # 阶段路线海报
│   ├── journals/
│   │   ├── index.md         # 当前状态面板 + 游记索引入口
│   │   └── YYYY-MM-DD-城市.md
│   ├── logs/
│   ├── output/              # 中间产物、prompt、JSON输出
│   ├── route.md             # 剩余路线
│   ├── summaries/           # 阶段总结
│   └── status.json          # 当前状态
├── docs/
├── scripts/
│   ├── auto_commit.sh
│   ├── check_stars.py
│   ├── clean_data.sh
│   ├── continue_route.sh
│   ├── daily_workflow.sh
│   ├── generate_period_summary.py
│   ├── generate_images.sh
│   ├── generate_landmarks.py
│   ├── init.sh
│   ├── period_summary.sh
│   ├── weekly_summary.sh
│   ├── replan_route.sh
│   └── lib/
│       ├── config.sh
│       ├── settings.py
│       └── template_renderer.py
└── skills/
    └── tabi-claw/

状态与索引约定

当前状态以两个文件为准：

• data/status.json：机器可读的运行状态
• data/journals/index.md：人可读入口，顶部包含“当前状态”面板，下面是游记列表

README 不再维护顶部状态表。查看“阿虾现在到哪了”，优先读：

1. data/journals/index.md
2. data/status.json

核心脚本

1. 初始化检查

bash scripts/init.sh

用途：

• 检查配置文件是否完整
• 检查运行时数据是否存在
• 检查外部工具路径是否可用
• 必要时初始化 status.json

2. 执行一次每日工作流

bash scripts/daily_workflow.sh
bash scripts/daily_workflow.sh 2026-03-31

这是项目最核心的入口。它会推进一天旅行，并更新：

• data/status.json
• data/route.md
• data/journals/index.md
• data/journals/*.md
• data/images/*.png
• data/output/*
• Git 提交记录

3. 重新规划完整路线

bash scripts/replan_route.sh 杭州 北京
bash scripts/replan_route.sh 杭州 北京 --reset

作用：

• 重写 data/route.md
• 使用 --reset 时重置 status.json
• 同步更新 data/journals/index.md 顶部状态

4. 从当前终点继续追加路线

bash scripts/continue_route.sh 广州

作用：

• 从 data/route.md 的最后一个城市继续规划
• 将新增路线追加到现有 route.md

5. 清空运行数据

bash scripts/clean_data.sh

作用：

• 清空图片和单篇游记
• 重建 data/journals/index.md
• 保留索引顶部说明文字
• 重置 status.json
• 清空 route.md

6. 生成阶段总结

bash scripts/period_summary.sh --start-date 2026-03-31 --end-date 2026-04-06

作用：

• 基于历史游记生成阶段总结 Markdown
• 生成一张阶段旅程主视觉海报
• 更新 data/journals/index.md 中的阶段总结入口
• 运行时在控制台直接打印阶段总结文案 prompt、阶段海报 prompt 和模型调用参数

7. 生成周总结

bash scripts/weekly_summary.sh

作用：

• 自动以今天为结束日，向前覆盖最近 7 个自然日（含今天）
• 底层转调 scripts/period_summary.sh
• 不需要手动传递日期参数

配置规则

项目当前把以下运行参数收敛到 config/settings.yaml：

• tools_path
• city_map_file
• image_gen_script
• llm_provider_default
• llm_base_url_default
• writer_model_default
• image_provider_default
• image_model_default
• summary_image_mode_default
• git_auto_push

其中：

• city_map.json 已经移入项目内，默认指向 ./config/city_map.json
• git_auto_push=false 时，自动提交后只 commit，不 push
• 阶段海报默认复用游记图片生成的 IMAGE_PROVIDER / IMAGE_MODEL
• summary_image_mode_default 当前默认值是 single_pass

外部依赖

项目仍依赖外部工具目录 tools_path 下的脚本：

• route.py
• attractions.py
• photo_spots.py
• weather.py
• route_planner.py

但 city_map.json 已不再依赖外部目录，已经内置在项目的 config/ 中。

环境变量

至少需要：

LLM_PROVIDER=minimax
LLM_API_KEY=your_key
LLM_BASE_URL=https://api.minimax.chat/v1
WRITER_MODEL=MiniMax-Text-01

图片生成常见变量：

IMAGE_PROVIDER=google
IMAGE_MODEL=gemini-3.1-flash-image-preview
GEMINI_API_KEY=your_key

或：

IMAGE_PROVIDER=dashscope
IMAGE_MODEL=qwen-image-2.0-pro
DASHSCOPE_API_KEY=your_key

可选：

TINYPNG_API_KEY=your_key

阶段总结脚本不会单独要求 SUMMARY_IMAGE_PROVIDER / SUMMARY_IMAGE_MODEL； 默认直接沿用上面这组游记图片变量。

用户请求到操作的映射

用户：帮我初始化旅行的阿虾

做法：

• 运行 bash scripts/init.sh
• 汇报缺失配置、当前状态、当前路线

用户：今天阿虾的游记 / 让阿虾继续旅行

做法：

• 运行 bash scripts/daily_workflow.sh
• 返回新城市、余额、生成的游记和图片路径

用户：阿虾现在在哪 / 余额还有多少

做法：

• 优先读取 data/journals/index.md
• 再用 data/status.json 做机器状态补充

用户：帮我总结过去一周 / 总结某一段旅程

做法：

• 如果用户明确是“过去一周”或“最近 7 天”，优先运行 bash scripts/weekly_summary.sh
• 如果用户给了明确的开始日期和结束日期，运行 bash scripts/period_summary.sh --start-date YYYY-MM-DD --end-date YYYY-MM-DD
• 返回总结文件、路线海报和索引入口

用户：重规划从杭州到北京

做法：

• 运行 bash scripts/replan_route.sh 杭州 北京
• 如果用户明确要求重置状态，则加 --reset

用户：从当前路线继续往广州走

做法：

• 运行 bash scripts/continue_route.sh 广州

用户：清空历史重新开始

做法：

• 运行 bash scripts/clean_data.sh
• 说明会清空图片、游记和路线，并重置状态

重要注意事项

• 不要再把“项目状态”写回 README；当前状态面板属于 data/journals/index.md
• 查询当前状态时，不要只读 README
• 清理数据时，要保留 index.md 顶部说明文字
• 每日工作流会产生真实文件变更，且可能自动 Git 提交
• 如果只是查看状态，不要主动执行 daily_workflow.sh