{"id":44031728,"url":"https://github.com/setube/taoyuan","last_synced_at":"2026-03-02T10:09:15.943Z","repository":{"id":336984878,"uuid":"1151925632","full_name":"setube/taoyuan","owner":"setube","description":"桃源乡: 一款文字版田园模拟经营游戏，灵感来自星露谷物语，采用像素 + 中国风视觉设计。","archived":false,"fork":false,"pushed_at":"2026-02-14T01:43:56.000Z","size":5732,"stargazers_count":26,"open_issues_count":1,"forks_count":9,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-14T05:08:14.194Z","etag":null,"topics":["browser-game","chinese-style","farming-simulation","indie-game","pinia","pixel-art","stardew-valley","tailwindcss","text-game","typescript","vite","vue3","web-game"],"latest_commit_sha":null,"homepage":"https://taoyuan.wenzi.games/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/setube.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"lfx_crowdfunding":null,"polar":null,"buy_me_a_coffee":null,"thanks_dev":null,"custom":["https://afdian.com/a/setube"]}},"created_at":"2026-02-07T04:56:44.000Z","updated_at":"2026-02-14T01:47:41.000Z","dependencies_parsed_at":"2026-02-13T00:00:40.400Z","dependency_job_id":null,"html_url":"https://github.com/setube/taoyuan","commit_stats":null,"previous_names":["setube/taoyuan"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/setube/taoyuan","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/setube%2Ftaoyuan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/setube%2Ftaoyuan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/setube%2Ftaoyuan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/setube%2Ftaoyuan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/setube","download_url":"https://codeload.github.com/setube/taoyuan/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/setube%2Ftaoyuan/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29760291,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-23T21:02:23.375Z","status":"ssl_error","status_checked_at":"2026-02-23T20:58:31.539Z","response_time":90,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser-game","chinese-style","farming-simulation","indie-game","pinia","pixel-art","stardew-valley","tailwindcss","text-game","typescript","vite","vue3","web-game"],"created_at":"2026-02-07T19:11:43.412Z","updated_at":"2026-03-02T10:09:15.929Z","avatar_url":"https://github.com/setube.png","language":"TypeScript","funding_links":["https://afdian.com/a/setube"],"categories":["TypeScript"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"images/logo.png\" alt=\"桃源乡\" width=\"128\" style=\"image-rendering: pixelated;\" /\u003e\n\u003c/div\u003e\n\n# 桃源乡\n\n\u003e 传说在群山深处，有一处与世隔绝的村落——桃源乡。\n\u003e 这里四季分明，民风淳朴，但近年来年轻人纷纷离去，村庄日渐冷清。\n\u003e 你收到一封来自已故祖父的信，信中附有一把铜钥匙和一张泛黄的地契……\n\n一款文字版田园模拟经营游戏，灵感来自星露谷物语，采用像素 + 中国风视觉设计。纯客户端运行，无需后端服务器。\n\n## 游戏特色\n\n**角色创建** — 输入名字、选择性别，6 种田庄各有独特加成（溪流钓鱼加成、竹林采集加成、山丘挖矿加成等），NPC 根据性别使用不同称呼\n\n**四季轮回** — 春耕夏种秋收冬藏，28 天一季，昼夜时段变化（6:00-次日2:00），六种天气（晴/雨/雷雨/雪/大风/绿雨）\n\n**田庄经营** — 38 种作物四季轮作，4×4 起步扩建至 8×8；3 种洒水器自动浇水，6 种肥料提升品质；建造温室全季种植，8 种果树 28 天挂果\n\n**畜牧养殖** — 鸡舍（鸡/鸭/兔/鹅/鹌鹑/鸽/乌骨鸡/孔雀）+ 畜棚（牛/羊/山羊/水牛/牦牛/羊驼/鹿/鸵鸟/骆驼/驼鹿/驴），共 19 种动物，畜舍 3 级升级\n\n**技能成长** — 农耕、采集、钓鱼、挖矿四大技能，等级 5 和 10 可选择专精方向\n\n**乡里社交** — 34 位村民（12 位可婚 NPC），送礼、聊天、触发心事件，求婚成家、配偶助农；6 位隐藏仙灵 NPC（龙灵、桃夭、月兔、狐仙、山翁、归女），独立发现链 + 缘分系统 + 结缘奖励\n\n**钓鱼系统** — 6 大钓点（溪流/池塘/江河/暗河/瀑布/沼泽），60 种鱼类；实时小游戏：长按拉线控制钩子高度，进度达标即收杆；鱼饵、浮漂、蟹笼、雨天淘金\n\n**鱼塘养殖** — 建造鱼塘投放鱼苗，每日产出副产品，繁殖增殖\n\n**矿洞探险** — 云隐矿洞 120 层（浅层/冰霜/熔岩/水晶/暗影/深渊），每 20 层 BOSS 战，回合制战斗；通关后解锁骷髅矿穴\n\n**翰海沙漠** — 矿洞之外的高级冒险区域，更稀有的资源与更强的敌人\n\n**烹饪系统** — 113 种食谱，烹饪料理恢复体力、生命值并获得当日增益\n\n**加工制造** — 21 种加工机器（酒坊/酱缸/油坊/熔炉/织布机/制茶机/药碾等），150+ 种加工配方\n\n**仓库箱子** — 5 种材质箱子（木/铜/铁/金/虚空），分类存放物品；虚空箱支持远程存取，可指定为原料箱/成品箱实现作坊自动出入料\n\n**育种系统** — 种子制造机产出育种种子，杂交培育新品种，400 种杂交配方横跨 10 代谱系\n\n**冒险公会** — 21 种讨伐目标，击杀怪物积累声望解锁奖励\n\n**博物馆收集** — 捐赠矿物、文物与仙灵物品，集齐解锁奖励\n\n**装备系统** — 武器、帽子、鞋子、戒指，套装效果加成\n\n**任务成就** — 5 章 50 个主线剧情任务、每日委托（送货/钓鱼/采矿/采集）、20 个社区任务包；109 个成就贯穿全部玩法\n\n**程序化音乐** — Tone.js 实时合成，中国风五声音阶（宫商角徵羽）；19 首 BGM（四季+节日+小游戏+战斗+翰海），80+ 种音效；天气与时段动态修饰音色和节奏\n\n## 游戏截图\n\n![游戏截图1](images/1.png)\n\n![游戏截图2](images/2.png)\n\n## 快速开始\n\n```bash\n# 安装依赖\npnpm install\n\n# 启动开发服务器\npnpm dev\n\n# 类型检查 + 生产构建\npnpm build\n\n# 预览构建结果\npnpm preview\n\n# 构建 Electron 桌面客户端\npnpm build:electron\n```\n\n## 技术栈\n\n| 技术            | 版本  | 用途                            |\n| --------------- | ----- | ------------------------------- |\n| Vue 3           | 3.5   | 组合式 API + `\u003cscript setup\u003e`   |\n| TypeScript      | 5.9   | 严格类型检查                    |\n| Vite            | 7     | 构建与开发服务器                |\n| Pinia           | 3     | 状态管理（26 个 store）         |\n| TailwindCSS     | 3     | 原子化样式 + CSS 变量自定义主题 |\n| Vue Router      | 5     | 客户端路由（23 个游戏面板）     |\n| Tone.js         | 15    | 程序化音频合成（BGM + SFX）     |\n| Electron        | 39    | 桌面客户端打包                  |\n| lucide-vue-next | 0.563 | 图标库                          |\n| VueUse          | 14    | 组合式工具函数                  |\n| CryptoJS        | 4     | 存档 AES 加密                   |\n\n## 项目结构\n\n```\nsrc/\n├── views/              # 页面级组件\n│   ├── MainMenu.vue    # 主菜单（新游戏、存档管理、导入导出）\n│   ├── GameLayout.vue  # 游戏主布局（状态栏 + 侧栏 + 日志 + 弹窗）\n│   └── game/           # 23 个游戏面板\n│       ├── FarmView.vue        # 农场\n│       ├── AnimalView.vue      # 畜牧\n│       ├── HomeView.vue        # 家园与仓库\n│       ├── ShopView.vue        # 商店\n│       ├── NpcView.vue         # 村民社交\n│       ├── FishingView.vue     # 钓鱼\n│       ├── FishPondView.vue    # 鱼塘\n│       ├── MiningView.vue      # 矿洞\n│       ├── HanhaiView.vue      # 翰海沙漠\n│       ├── CookingView.vue     # 烹饪\n│       ├── ProcessingView.vue  # 作坊加工\n│       ├── BreedingView.vue    # 育种\n│       ├── MuseumView.vue      # 博物馆\n│       ├── GuildView.vue       # 冒险公会\n│       ├── InventoryView.vue   # 背包\n│       └── ...                 # 更多面板\n├── components/game/    # 20 个子组件（小游戏、对话框、状态栏等）\n├── stores/             # 26 个 Pinia 状态仓库\n├── composables/        # 可复用逻辑（导航、日结算、日志、音频、对话等）\n├── data/               # 40 个游戏数据模块（作物、物品、NPC、鱼类、食谱等）\n├── types/              # TypeScript 类型定义\n├── router/             # Vue Router 路由配置\n├── assets/             # 静态资源（zpix 像素字体、Logo）\n├── app.css             # 全局样式与 Tailwind 主题\n├── App.vue             # 根组件\n└── main.ts             # 应用入口\n```\n\n## 游戏系统一览\n\n| 系统     | 说明                                                                               |\n| -------- | ---------------------------------------------------------------------------------- |\n| 时间     | 年 → 季（春夏秋冬）→ 天（28天/季）→ 时段（6:00-次日2:00），六种天气                |\n| 体力     | 初始 120，所有操作消耗体力，可通过药膳提升上限至 180                               |\n| 农场     | 38 种作物，4×4→8×8 地块，3 种洒水器 + 6 种肥料，温室全季种植                       |\n| 畜牧     | 19 种动物（鸡舍 8 种 + 畜棚 11 种），畜舍 3 级升级                                 |\n| 鱼塘     | 投放鱼苗养殖，每日产出副产品，可繁殖增殖                                           |\n| 育种     | 种子制造机产出育种种子，培育高品质作物品种，400 种杂交配方横跨 10 代               |\n| 品质     | 普通/优良/精品/极品，影响售价（×1.0/×1.25/×1.5/×2.0）和送礼效果                    |\n| 背包     | 20-36 格，单格堆叠上限 99，工具栏独立                                              |\n| 仓库     | 分类箱子系统（木/铜/铁/金/虚空），虚空箱支持远程存取与作坊自动出入料               |\n| 工具     | 水壶/锄头/镐/鱼竿，三级升级（基础→铁制→精钢），降低体力消耗                        |\n| 装备     | 武器、帽子、鞋子、戒指，套装效果加成                                               |\n| 商店     | 按季节更新商品，可出售背包物品，物品品质可视化标识                                 |\n| NPC      | 34 位村民（12 位可婚）+ 6 位隐藏仙灵，好感度/缘分、心事件、节日活动，配偶/仙缘助农 |\n| 矿洞     | 云隐矿洞 120 层（6 区）+ 骷髅矿穴 + 翰海沙漠，回合制战斗，每 20 层 BOSS            |\n| 公会     | 21 种讨伐目标，击杀积累声望解锁奖励                                                |\n| 博物馆   | 捐赠矿物、文物与仙灵物品（40 件），集齐解锁奖励                                    |\n| 任务     | 5 章 50 个主线任务 + 每日委托 + 20 个社区任务包，109 个成就                        |\n| 存档     | 3 个存档槽位（localStorage + AES 加密），每日自动保存，支持导入导出、WebDAV 云同步 |\n| 音乐音效 | Tone.js 程序化合成，五声音阶 19 首 BGM + 80 余种音效，天气/时段动态修饰            |\n\n## 设计规范\n\n- **配色**：传统中国色系（墨色背景 #1a1a1a、赤金强调 #c8a45c、朱红警告 #c34043、竹青成功 #5a9e6f）\n- **字体**：zpix 像素字体，关闭字体平滑\n- **UI 风格**：扁平硬边按钮、1px 细边框、最大 2px 圆角、4px 倍数间距\n- **响应式**：移动端底部导航 + 桌面端侧边栏，768px 断点\n\n## 交流\n\n- QQ 群：920930589\n- GitHub：[https://github.com/setube/taoyuan](https://github.com/setube/taoyuan)\n\n## 许可证\n\n本项目采用 [CC BY-NC 4.0](https://creativecommons.org/licenses/by-nc/4.0/deed.zh-hans) 许可协议。\n\n允许自由共享和演绎，但 **未经作者书面授权，禁止用于任何商业目的**。详见 [LICENSE](LICENSE) 文件。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsetube%2Ftaoyuan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsetube%2Ftaoyuan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsetube%2Ftaoyuan/lists"}