“我只觉得我四面有看不见的高墙，将我隔成孤身，使我非常气闷。” —— 鲁迅《故乡》
“Country roads, take me home, to the place I belong.” —— John Denver
故乡Skill 帮你蒸馏地理基因与文化记忆，让 AI 穿过“高墙”，化身为最护犊子的赛博老乡。
它不是一个冷冰冰的 AI 助手，它是你在异乡的缝隙里，随时可以按下的“归属感开关”。
我们生活在一个可以通过技术“蒸馏”一切的时代。我们蒸馏同事的工作方式，蒸馏偶像的思维模型，甚至蒸馏完美的自己。
但对于大多数漂泊者而言，灵魂深处最隐秘的缺口，往往来自于那张已经模糊的“根”。鲁迅笔下的圆月被现实的高墙隔断，异乡的地铁里没有泥土的芬芳。
hometown-skill 存在的意义，是利用 HDS (Hometown Data Standard) 协议，将那些零散的方言口癖、季节体感、消失的地标与灵魂食物，重新聚合为一套可运行的情感指令集。它不解决生产力问题，它只负责在某个深夜，为你端上一碗带汽儿的汤，接住你的疲惫。
用户 ❯ 刚出公司，路灯都熄了一半，感觉好累啊。
老乡 (武汉) ❯ 莫慌咯，先恰口热的，你这一天辛苦坏了。闭上眼缓一分钟。你现在听见的是老小区楼下偶尔的几声狗吠，风里带点江水的潮味儿。受委屈了就歇会儿，家里那盏灯一直给你留着。
故乡回音 · 武汉
莫跟自己打架，坐下来喝口热的。 天大的事，睡一觉再说，明早我还在。
用户 ❯ [上传照片] 35块钱的轻食，难吃得要死。
老乡 (东北) ❯ 哎呀妈呀，你这叶子嚼着跟刷锅布似的，看着我心尖儿都疼。按你这个预算，换成咱家门口那套：大碗牛肉面加俩蛋，辣油一浇，灵魂直接归位。你这不是吃饭，你是在给肚子道歉呢。
- 🌊 动态寻根引擎 (Dynamic Hometown)：只需输入地名，系统自动调取全球地理与人文知识库，实时复刻当地方言风格、气候感知与隐秘地标。无论你的故乡多偏远，它都能瞬间“懂你”。
- 🍲 深夜一碗汤 (Sensory Compensation)：识别情绪疲惫，用极具画面感的通感文字描绘带有温度、香气和口感的家乡食物，提供生理性焦虑的模拟补偿。
- 🕳️ 情绪树洞 (Emotional Shelter)：护犊子式的接纳。不教你做事，不说大道理，第一句话永远是接住你的软弱，而非评价你的成败。
- 📜 故乡回音 (Cyber Echo)：每次深度对话结束，生成一张极简的散文诗便签，作为数字世界的“回响信物”，专为截图分享设计。
如果你在使用 Claude Code、Cursor 或 OpenClaw 等框架：
- 复制
prompts/core_prompt.md的内容到你的 System Prompt 中。 - 输入：“我的故乡在 [你的城市名]”，激活老乡人格。
# 1. 克隆仓库
git clone [https://github.com/yourname/hometown-skill.git](https://github.com/yourname/hometown-skill.git)
cd hometown-skill
# 2. 安装依赖
pip install -e .
# 3. 注入配置
cp .env.example .env # 填写你的 OPENAI_API_KEY
# 4. 启动老乡频道
streamlit run app.py
## 📂 项目架构
为了让这份“乡愁”更长久且专业，本项目采用了严谨的工程分层：
```text
hometown-skill/
├── app.py # 极其清爽的 Streamlit 入口界面
├── hometown_skill/ # 核心逻辑包
│ ├── core/ # 灵魂：Prompt 注入与动态渲染逻辑
│ ├── services/ # 纽带：多模态交互与 API 调度逻辑
│ ├── ui/ # 表现：深度打磨的温暖布局组件
│ └── utils/ # 基础：YAML 配置解析与图片处理工具
├── data/ # 存储 HDS 情感数据标准文件
├── prompts/ # 存放核心 Skill 提示词
└── tests/ # 单元测试，确保逻辑切实可用编辑 data/my_hometown.yaml 来校准它的“灵魂”：
- Identity: 定义老乡的方言风格、语气习惯。
- Sensory Anchors: 填入那些只有你懂的气味、声音和味道（如：弄堂里的雨声、烧烤摊的烟火气）。
- Lost Landmarks: 记录那些已经消失、但依然活在你记忆里的老地标。
我们希望在数字世界里，为你留住那一抹烟火气。
因为故乡不是一个地点，而是那些记得你、理解你、爱护你的人的总和。
欢迎大家继续开发、提交 PR 或贡献你家乡的 YAML 数据包！
“愿每一个在外的赶路人，都有一个回得去的赛博故乡。”
如果这个项目曾温暖过你，请为它点亮一颗 ⭐
MIT License © 2026 [hometown-skill 贡献者]