[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-82766":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":14,"subscribersCount":14,"size":14,"stars1d":14,"stars7d":15,"stars30d":16,"stars90d":14,"forks30d":14,"starsTrendScore":14,"compositeScore":17,"rankGlobal":9,"rankLanguage":9,"license":9,"archived":18,"fork":18,"defaultBranch":19,"hasWiki":20,"hasPages":20,"topics":21,"createdAt":9,"pushedAt":9,"updatedAt":22,"readmeContent":23,"aiSummary":24,"trendingCount":14,"starSnapshotCount":14,"syncStatus":25,"lastSyncTime":26,"discoverSource":27},82766,"tang-changan","andyhuo520\u002Ftang-changan","andyhuo520","大唐长安 · 智机府 — Tang Changan web game",null,"JavaScript",101,23,51,0,4,29,4.14,false,"main",true,[],"2026-06-12 02:04:27","# 大唐长安 · Tang Chang'an Diorama (V11)\n\n复刻 Expeditione™ 风格的互动微缩沙盘，主题 **大唐百年史**。120×160 单位级地图、**三大殿纵轴**（含元 → 宣政 → 紫宸）、跨河桥梁、七层大雁塔、曲江画舫、朱雀城门、东西二市、稻麦水利、胡旋舞乐——配以 **昼夜流转 · 四季流转 · 宵禁夜禁 · 唐诗节点 · 寺钟鸡鸣 · 天气切换（雨\u002F沙\u002F雾 + 闪电雷声 + 风向斜飘）· NPC 市井段子 · 历史事件轴 · 4 款 mini-game · 移动端适配 · 🎮 RPG 模式 · 👀 第一人称 FPS 模式 · 🖼 5 座 360° 殿宇展厅**，一幅可漫游、可对话、可吟诗、可游戏、可扮演、可入殿看展、可穿越百年的盛唐画卷。\n\u003Cimg width=\"2950\" height=\"1590\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F546e014d-cf7a-4ab6-a232-1c95c02da8a2\" \u002F>\n\n\u003Cimg width=\"2964\" height=\"1588\" alt=\"image\" src=\"https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fad984cc1-c831-43db-8d83-87500159a601\" \u002F>\n\n## 开发教程与 Agora Skills 安装\n\n- 科普教程 Markdown：[`docs\u002F05_从设计到完成_开发过程科普教程.md`](docs\u002F05_从设计到完成_开发过程科普教程.md)\n- 精排 HTML 版：[`docs\u002F05_从设计到完成_开发过程科普教程.html`](docs\u002F05_从设计到完成_开发过程科普教程.html)\n\n教程中的「7.0 开发前置：安装 Agora Skills \u002F Agora CLI」包含：\n\n- 安装 `agora` CLI；\n- `agora login` 登录；\n- `agora project doctor --feature convoai` 检查 ConvoAI；\n- `agora project env write .env.local --overwrite` 写入语音后端环境变量；\n- 常见 `CAN_NOT_GET_GATEWAY_SERVER` \u002F `401 Invalid token` 排查。\n\n## V11 · 经济基建 · 4 币种 · 5 类物品 · 5 处店铺\n\n游戏 (Mode 2) 与展示 (Mode 1) 至此**真正分家** —— Mode 2 多出一套有源有汇的经济：\n\n### 4 种货币（同步显示在屏右上\"钱包\"胸牌）\n\n| 币种 | 图标 | 主用途 |\n|------|------|--------|\n| **铜钱** copper | 🪙 | 食货 \u002F 小件文房 \u002F 小礼物 |\n| **绢帛** silk   | 🧵 | 衣冠 \u002F 中价文房 \u002F 雅物 |\n| **金锭** gold   | 🏵 | 真迹 \u002F 凭证 \u002F 城门通牒 |\n| **风雅** fame   | ✦ | 累计（雅物 \u002F 诗仙赞 → 解锁高阶 NPC） |\n\n### 4 职业 · 不同开局资源\n\n| 职业 | 开局钱包 | 开局物品 |\n|------|---------|---------|\n| 文士 scholar | 30 文 + 2 绢 + ✦5 | 湖州狼毫 + 一刀宣纸 |\n| 商贾 merchant | 80 文 + 4 绢 + ✦1 | — |\n| 仕女 lady | 50 文 + 3 绢 + 1 金 + ✦3 | 一枚玉佩 |\n| 武人 soldier | 40 文 + ✦2 | 胡饼 ×2 |\n\n### 5 类物品（共 27 件，分类聚合显示）\n\n| 类 | 例 | 效果 |\n|----|----|------|\n| 🥯 **食货** food | 胡饼 \u002F 葡萄酒 \u002F 酥山 \u002F 剑南春 | **吃** → 回体力 + 临时风度 charm |\n| 🖌 **文房** literati | 狼毫 \u002F 松烟墨 \u002F 宣纸 \u002F 端砚 \u002F 唐诗集 \u002F 全唐诗 | 累加 **poetryBonus**，达 15 解锁\"灵思一次\" |\n| 👘 **衣冠** attire | 青衫 \u002F 乌纱帽 \u002F 玉佩 \u002F 织锦帕 \u002F 香囊 | **着** → 装备槽（头\u002F身\u002F饰）+ 常驻 charm |\n| 🪞 **雅物** collectible | 西凉铜镜 \u002F 东海明珠 \u002F 吴道子真迹 \u002F 蜀锦 \u002F 滕王阁序拓本 | 入袋即 ✦风雅 累计 |\n| 🪪 **凭证** pass | 诗仙赞腰牌 \u002F 通关文牒 \u002F 进士印 | 解锁区域 \u002F 高阶 NPC |\n\n### 5 处店铺（实地店招 · 走近 `F` 开店）\n\n| 店 | 位置 | 主售 |\n|----|------|------|\n| 🏮 **朱雀酒肆** | (-5, -1) | 食货 7 件（胡饼\u002F葡萄酒\u002F酥山\u002F剑南春…） |\n| 🏮 **东市米粮铺** | (5, 16) | 食货 4 件（粳米\u002F胡饼\u002F栗子\u002F清茗） |\n| 🏮 **东市文房斋** | (-5, 17) | 文房 7 件（笔墨纸砚 + 唐诗集 + 全唐诗） |\n| 🏮 **东市绫罗肆** | (0, 19) | 衣冠 6 件（青衫\u002F乌纱\u002F玉佩\u002F竹簪…） |\n| 🏮 **西市胡商货栈** | (-22, -3) | 雅物 + 凭证（铜镜\u002F明珠\u002F真迹\u002F蜀锦\u002F拓本\u002F城坊图\u002F文牒） |\n\n店招实地建模：立柱 + 灯笼 + 牌匾（CanvasTexture 中文 STKaiti）+ 灯笼缓慢晃动。买\u002F卖 modal 顶部显示钱包 4 币种，按类聚合商品，价格用 🪙🧵🏵 图标，买不起的灰显禁用。\n\n### 体力 + 风度系统\n\n- **体力 stamina** 0-100，初始 100；每秒自动 +1 恢复（mini-game \u002F 跑步消耗待加）\n- 屏右上**绿色 4px 条**实时显示\n- 食物给定量回复，酒\u002F茶\u002F酥山额外给**临时 charm 风度**（60-180 秒 buff）\n\n### 文房灵感 → 接入诗会\n\n持有文房物品自动累计 poetryBonus（笔 +10、墨\u002F纸 +5、砚 +20、唐诗集 +25、全唐诗 +35）。\n- bonus ≥ **15** → 诗会内可灵思**一次**（答错时获一次重答机会，且会标红错项）\n- bonus ≥ **35** → 玩家直接成为\"长安第一才子\"（彩蛋）\n\n### Loot 重构\n\n旧的 REWARDS_GOOD\u002FSMALL\u002FCONSOL\u002FPERFECT → 统一迁到 `LOOT_TABLES` (win\u002Fdraw\u002Flose\u002Fperfect)，全部用 itemId 引用。币奖单独用 `COIN_10` \u002F `COIN_3` \u002F `SILK_1` token 处理。所有路径（猜拳\u002F猜谜\u002F对诗）共享一致 grantReward。\n\n## V10 · 诗酒小宴 · 飞花令 · 对对联 · 诗仙赞\n\n> 古人云：花间一壶酒，独酌无相亲；举杯邀明月，对影成三人。\n\n街头三玩之外再开一种 **盛唐文人雅集** —— 走到 NPC 旁 `E` 开对话，到末尾会出现紫粉色按钮 **🍷 对诗**（文士 \u002F 仕女 \u002F 老人 \u002F 僧人 100%，兵卒 \u002F 农夫 30%）。点开后随机抽 3 轮，混合两种唐风玩法：\n\n| 玩法 | 形式 |\n|------|------|\n| **飞花令** | 给关键字 (花\u002F月\u002F风\u002F春\u002F江\u002F酒\u002F山\u002F雪)，4 句中选**含此字**的诗 |\n| **对对联** | 给上联，4 句中选下联（干扰项均为**其他名联的下联**，迷惑性强） |\n\n**3 巡定胜负 · 奖品分级**：\n\n| 战绩 | 级别 | 奖品池 |\n|------|------|--------|\n| 3\u002F3 | **诗仙赞 ✦** | 🍶 一壶剑南春 \u002F 📚 《全唐诗》\u002F 🖌 湖州狼毫 \u002F 🟫 端州歙砚 \u002F 🎨 吴道子真迹 \u002F 🪪 诗仙赞墨色腰牌 |\n| 2\u002F3 | 才情不俗 | 小赏（三文钱 \u002F 胡饼 \u002F 打油诗…） |\n| 1\u002F3 | 勉强一巡 | 安慰（路人一笑 \u002F 鬼脸） |\n| 0\u002F3 | 颗粒无收 | 文士调侃：「公子何不饮酒，少谈诗？」 |\n\n题库规模：\n\n- 飞花令：**8 个关键字 × 每字 ~6 含字句 + ~6 不含字句**，组合数 >180\n- 对联：18 副名联（王勃 \u002F 李白 \u002F 王维 \u002F 柳宗元 \u002F 杜甫 \u002F 白居易 \u002F 王翰 \u002F 王之涣 \u002F 张九龄…）\n\n对诗 UI 与街头小游戏统一 `.sg-card` 风格，但配色改为 **暗夜紫 + 桃花粉**，提示气泡用 **STKaiti 楷体 + 紫色左竖条**，呼应\"花间一壶酒\"的雅意。\n\n## V9 · 街头玩耍 · 猜拳猜谜 + 随机赏赐 + 行囊系统\n\n游戏模式中靠近任意路人，按 `E` 打开对话；在对话**最后一行**会出现两枚按钮：\n\n| 按钮 | 玩法 |\n|------|------|\n| **🪨 猜拳** | 经典石剪布。你出招后，NPC 转手轮抽签 600ms 落定 → 胜 \u002F 平 \u002F 负 |\n| **🎴 猜谜** | 唐风题库（民俗谜语 + 长安史实），四选一，对错均有奖 |\n\n**胜负判定 → 不同奖品池**：\n\n- **胜** → 十文开元通宝 \u002F 西凉铜镜 \u002F 滕王阁序拓本 \u002F 龙井香囊 \u002F 葡萄酒 \u002F 东海明珠 \u002F 织锦帕 \u002F 酥山\n- **平** → 三文铜钱 \u002F 胡饼 \u002F 打油诗 \u002F 炒栗子 \u002F 竹簪\n- **负** → 路人一笑 \u002F \"再来\" \u002F 鬼脸（安慰，无价值但有趣）\n\nNPC 角色对游戏的态度：\n\n| 角色 | 愿意陪玩 |\n|------|---------|\n| 文士 \u002F 商贾 \u002F 仕女 \u002F 童子 \u002F 农夫 \u002F 胡商 \u002F 货郎 \u002F 街边路人 | 100% |\n| 兵卒 \u002F 官员 \u002F 僧侣 | 30%（性子严，但偶尔也兴致来时） |\n\n**行囊系统 (Inventory)**：\n\n- 屏幕右上 Inventory **胸牌**: `🪙 X 文 · 🎁 Y 件 · [最近 3 件 icon]`\n- 点击胸牌弹出**总览面板**：分行显示所有藏品（含数量×N）\n- 中央**赏赐 Toast** 飘字：`王翁 赏你 🪞 一面西凉铜镜`\n\n12 题谜库：\n\n> 「身穿绿衣衫，肚里水汪汪，生的子儿多，个个黑脸膛」答：西瓜\n> 「头戴红帽子，身披白褂子，说话伸脖子，走路摆架子」答：鹅\n> 「弟兄六七个，围着柱子坐，大家一分手，衣服全扯破」答：蒜\n> 「青枝绿叶不是树，开花结桃不是桃，剥开桃子白花花」答：棉花\n> 「腰里长出胡须来，没有须时还能吃，有了须时吃不来」答：玉米\n> 「上有半截草，下有一池水」答：茫\n> \"床前明月光\" 是谁所作？答：李白\n> 安史之乱在哪位皇帝在位？答：唐玄宗\n> 玄奘西行多少年？答：十七年\n> ……\n\n## V8 · 入殿看展 · 第一人称 + 壁画展厅\n\n新增三件大事：\n\n1. **天气升级**：雨天 5-20 秒概率触发 **闪电屏闪 + 低频雷鸣**；雨\u002F沙\u002F雾各有风向 → 雨条斜飘、沙粒阵风吹拂、雾色阴沉\n2. **第一人称 (FPS) 模式**：游戏中按 `V` 切换第三\u002F第一人称；点击锁鼠标真实视角看世界；按 `Esc` 释放\n3. **大殿 360° 展厅**：走到 5 个殿门口（含元殿 \u002F 宣政殿 \u002F 紫宸殿 \u002F 大雁塔 \u002F 曲江亭）→ 按 `F` 入展 → FPS 在展厅内自由游走，看向壁画时屏幕底部显示标题 + 注释；按 `F` 或 `Esc` 礼出展厅\n\n### 5 座展厅清单\n\n| ID | 标题 | 壁画 |\n| --- | --- | --- |\n| `hanyuan`   | 含元殿 · 万邦来朝 | 万邦来朝图 \u002F 元日大朝 \u002F 受降图 \u002F 凤翔丹墀 |\n| `xuanzheng` | 宣政殿 · 常朝政务 | 常朝图 \u002F 紫绯朝服 \u002F 中书省草制 \u002F 御史台 |\n| `zichen`    | 紫宸殿 · 内朝寝兴 | 入阁仪 \u002F 夜对 \u002F 后宫 |\n| `pagoda`    | 大雁塔 · 玄奘西天 | 玄奘取经图 \u002F 译经场 \u002F 雁塔题名 \u002F 佛祖说法 |\n| `qujiang`   | 曲江亭 · 文人雅集 | 丽人行 \u002F 曲江流饮 \u002F 杏园探花 |\n\n每幅壁画现在是程序化占位（暖金色调底 + 题字 + 注解）。**想换真实素材**：把图片放进 `murals\u002F`，命名 `{galleryId}_{index}.jpg`，详见 `murals\u002FREADME.md`。\n\n## V7 · 长安行客 · RPG 模式\n\n点击顶栏 **🎮 游戏模式** 按钮，从 4 个角色预设（**士子 \u002F 商贾 \u002F 仕女 \u002F 游侠**）中挑选你的长安身份，输入名字，进入第三人称漫游：\n\n| 操作 | 键位 |\n| --- | --- |\n| 移动 | `W` `A` `S` `D` 或方向键 |\n| 疾走 | 长按 `Shift` |\n| 与最近 NPC 交互 | `E` \u002F 空格 \u002F 回车 |\n| 退出游戏 | `Esc` |\n\n- **主线任务**：《初到长安》5 步剧情链：朱雀门 → 西市张掌柜 → 大雁塔题名 → 大明宫含元殿 → 名垂长安\n- **场景自动联动**：与 217 个 NPC 都可对话；不同坊里的人物会按身份（守门将\u002F商贾\u002F学子\u002F儒生\u002F百姓\u002F官员\u002F胡商\u002F僧侣）说出不同的市井段子\n- **任务驱动**：在朱雀门附近的兵卒、西市的商贾、大雁塔下的学子会触发任务专属台词与剧情推进\n- **HUD**：左上任务条 \u002F 下方按键提示 \u002F 顶部 toast 通知 \u002F 底部对话框\n- **镜头**：相机从俯瞰沙盘平滑过渡到主角第三人称跟随，主角头顶有金色光环 + 箭头标识\n\n## 一句话技术栈\n**纯前端**（HTML + Three.js + 原生 JS），**无构建步骤**，浏览器直接打开即可。\n\n## 如何运行\n\n```bash\ncd \u002FUsers\u002Fandyhu\u002FDownloads\u002FCompany\u002Fhan-diorama\npython3 -m http.server 8088\n# 访问 http:\u002F\u002Flocalhost:8088\u002F\n```\n\n> 因为用了 ES Module + Import Map，必须经 HTTP 服务，**直接双击 `index.html` 跑不起来**。\n\n## 场景全景 (V6·三殿盛唐版)\n\n```\n        ┌─────────────────────────────────────┐\n        │   🏛 紫宸殿  (内殿\u002F皇帝寝兴)         │  z=-89\n        │   私密单层 · 飞檐高耸 · 4 近臣 + 琴师 │\n        └────────────────┬────────────────────┘\n                         │←連廊\n        ┌────────────────┴────────────────────┐\n        │   🏛 宣政殿  (常朝\u002F政务)            │  z=-76\n        │   重檐两层 · 8 朝臣紫绯 · 4 带刀侍卫 │\n        └────────────────┬────────────────────┘\n                         │←連廊\n        ┌────────────────┴────────────────────┐\n        │   🏛 含元殿  (大朝\u002F万邦来朝)        │  z=-60\n        │   三层金顶 · 龙凤丹墀 · 翔鸾栖凤双阙 │\n        │   12 御林军 + 8 朝臣 + 苍松石狮     │\n        └────────────────┬────────────────────┘\n        ┌────────────────┴────────────────────┐\n        │   🏯 朱雀门 (皇城南正门)             │\n        └────────────────┬────────────────────┘\n        ┌────────────────┴────────────────────┐\n        │   ⚔️ 边塞战场 \u002F 突厥穹庐 \u002F 烽燧     │\n        └────────────────┬────────────────────┘\n ┌────────┐ ┌────────────┴────────────┐ ┌─────────────────┐\n │ 🐫 驼商│ │                          │ │                  │\n │ + 🏛西市│←┤ 朱雀大街 · 22 行人坊灯 28 ├→│ 🌾 田畴 筒车曲辕犁│\n │ 胡旋舞 │ │ 官吏马队 · 宵禁可见      │ │ 弯腰插秧农夫     │\n └────────┘ └────────────┬─────────────┘ └─────────────────┘\n            ┌────────────┴─────────────┐\n            │ 🌊 灞河 + 渭水 + 拱桥     │\n            └────────────┬─────────────┘\n        ┌────────────────┴────────────────────┐\n        │ 🌅 曲江池 (西南)   🏯 大雁塔 (东南)   │\n        │ 画舫 · 亭台 · 柳岸 · 慈恩寺 · 石狮香炉 │\n        └─────────────────────────────────────┘\n```\n\n## 内容清单 (V6 三殿百年版)\n\n### 🏛️ 唐代地标\n- **大明宫三大殿**（V6）— 含元殿 + 宣政殿 + 紫宸殿 三层纵轴，双侧長廊相连\n  - **含元殿** — 三层金顶高台、龙凤丹墀龙尾道、翔鸾·栖凤双阙、12 御林军 + 8 朝臣\n  - **宣政殿**（新）— 重檐两层、9 柱前廊、8 紫绯朝臣 + 4 甲士\n  - **紫宸殿**（新）— 单层精巧高翘飞檐、4 近臣 + 仕女琴师、后花园松柏假山\n- **大雁塔**（慈恩寺塔）— 7 层方塔、攒尖砖石、四面拱窗、金顶刹\n- **朱雀门城楼** — 三门道、九五至尊八十一钉、重檐两层、龙凤双旗\n- **曲江池** — 22×18 大水面、中央水亭、2 艘画舫、垂柳成行\n- **东市\u002F西市** — 双市制、围墙·市门牌坊·8 摊位·胡姬舞台\n- **灞河 \u002F 渭水** — 贯穿南北 + 东西的双河系统、跨河石拱桥\n- **筒车 \u002F 曲辕犁** — 唐代标志性农具\n- **朱雀大街坊灯** — 28 盏路灯，夜间发光\n\n### 👥 人物角色 (217 NPC)\n- 文士 \u002F 农夫 \u002F 商人 \u002F 西域胡商 \u002F 仕女 \u002F 进贤冠学者 \u002F 童子 \u002F 兵卒 \u002F 突厥\n- **胡姬胡旋舞**（4 人围圈旋转，袖飞带飘）\n- 弯腰插秧农夫（4 人，pose=bend \u002F squat \u002F kneel）\n- 朱雀大街 22 名行人（**宵禁时隐去**）+ 3 队官吏马队\n- 含元殿御林军 12 + 紫绯朝臣 8 + 宣政殿朝臣 8 + 紫宸殿近臣 4\n- 朱雀门下 6 名出入旅人 + 城上 4 名甲士 + 门外 3 骑迎送\n- 慈恩寺塔前 8 名香客\u002F僧侣 + 曲江池 8 名游赏人\n\n### 🎬 实时动画 (18 种)\n1. 阴阳昼夜循环（日出·日落·星空）\n2. 人物原地浮动\n3. 旗帜飘动 + 战旗\n4. 龙骨水车 + 筒车旋转\n5. 烽燧夜间脉冲发光（**天宝乱期间日夜常燃**）\n6. 步兵 \u002F 骑兵路径行进\n7. 鸟群盘旋\n8. 桃花飘落（春季）\n9. 帅帐战鼓拍动\n10. 战场扬尘消散\n11. 画舫水面摆动\n12. 胡姬胡旋舞\n13. 香炉烟柱\n14. 落叶飘零（秋季）\n15. 雪花飘落（冬季）\n16. 萤火虫游弋（夏夜）\n17. **雨滴垂落**（新，天气=雨）\n18. **风沙横扫**（新，天气=沙）\n\n### 🌙 里坊夜禁\n- 22:00 - 5:00 自动进入宵禁\n- 街上 22 名行人**隐去**（不见人烟）\n- 朱雀大街两侧 28 盏**坊灯**点亮发光\n- 顶部弹出\"宵禁中 · CURFEW · 街禁闭坊\"徽章\n\n### 🌸 四季流转\n| 季 | 草色 | 树色 | 粒子 |\n| --- | --- | --- | --- |\n| 春 仲春·二月 | 翠绿 0x7BA84C | 嫩柳 | 桃花瓣 |\n| 夏 盛夏·六月 | 深绿 0x4F7E2C | 苍翠 | 萤火虫（夜） |\n| 秋 秋深·九月 | 黄棕 0x9A8C3A | 金红枫叶 | 落叶 |\n| 冬 严冬·腊月 | 雪白 0xC8CED2 | 枯枝 | 雪花 |\n\n### 🌧️ 天气系统 (新)\n| 天气 | 雾色 | 视距 | 粒子 |\n| --- | --- | --- | --- |\n| 晴 | 暗夜色 | 200-450 | — |\n| 雨 | 蓝灰 0x556070 | 80-320 | 380 滴垂直雨丝 |\n| 沙 | 沙黄 0x8a6840 | 30-180 | 240 颗沙粒横扫 |\n| 雾 | 苍白 0xb8c0c8 | 30-220 | — |\n\n切换在左下角\"晴雨沙雾\"按钮（季节按钮上方）。\n\n### 📜 历史事件轴 (新)\n| 时代 | 年代 | 主君 | 视觉特征 |\n| --- | --- | --- | --- |\n| **贞观之治** | 627-649 | 唐太宗 | 兵力 1.6×，市场 0.8×，洁净 |\n| **开元盛世** | 713-741 | 唐玄宗 | 市场 1.4×，胡商繁忙，金黄 tint |\n| **安史之乱** | 755-763 | 玄宗→肃宗 | 兵力 2.0×，市场 0.3×，烽火常燃 |\n| **天宝之后** | 763-907 | 代宗以后 | 市场 0.6×，藩镇割据，苍白 tint |\n\n顶部时间轴按钮（⏱）打开年代切换，**自动调整 NPC 分布 + 环境光 + 烽火状态**，并弹出 8 秒历史信息横幅。\n\n### 🗨️ 点击 NPC (新)\n- 217 个 NPC 全部可点击（屏幕半径 32 像素匹配）\n- 8 类身份各 4-6 句市井段子：\n  - 里坊百姓 \u002F 市井商贾 \u002F 深闺仕女 \u002F 士林文士 \u002F 军中兵卒 \u002F 孩童 \u002F 西域胡商 \u002F 北蕃突厥\n- 点击弹出气泡（角色标签 + 段子），4.2 秒自动淡出\n\n例：\n```\n军中·兵卒  \"边塞月明夜，闻笛能让壮士落泪。\"\n市井·商贾  \"西州瓜，安息香，要不要看看？三十文一斤。\"\n深闺·仕女  \"今春流行高髻簪花，鬓边再贴个红色花钿。\"\n```\n\n### 🔊 音效 (Web Audio synth)\n- 寺钟（早朝 6:00 \u002F 午时 12:00 \u002F 暮鼓 18:00）— 三泛音合成\n- 关坊鼓（22:00）— 低音 + 噪声击打\n- 鸡鸣（5:00）— 锯齿波频扫\n- 切换场景轻铃 + 持续环境底音\n- 顶部喇叭按钮可一键静音\n- 弓射 mini-game 中击中靶心马蹄音\n\n### 📜 唐诗节点\n顶部\"诗\"按钮开启诗心模式，9 个场景各配一首唐诗：\n- 朱雀大街 ·《长安古意》卢照邻\n- 大明宫 ·《和贾舍人早朝大明宫之作》王维\n- 大雁塔 ·《与高适薛据登慈恩寺浮图》岑参\n- 曲江池 ·《丽人行》杜甫\n- 东市 ·《长安道》储光羲\n- 田畴 ·《观刈麦》白居易\n- 朱雀门 ·《和贾至舍人早朝大明宫》杜甫\n- 边塞 ·《从军行》王昌龄\n- 驼商 ·《凉州词》王翰\n\n诗签为羊皮纸色衬线竖排，浮于右上。\n\n### 📱 移动端适配\n- ≤ 900px 自动切换：侧栏改为汉堡抽屉\n- 顶部·底部 HUD 缩小重排，场景按钮横排\n- OrbitControls 内置双指捏合缩放\n- 切换场景自动收起侧栏\n\n### 🎮 小游戏 (4 款全部完成 V6)\n顶部 ⊕ 按钮打开 mini-games modal：\n- **蹴鞠** — 点击鞠球持续高踢，连踢数记录\n- **雁塔题名**（新）— 石壁描红，长安鼠标拖出\"進士及第\"四字（含碑文水印）\n- **曲江流饮**（新）— 羽觞顺曲水漂流，停下时点击赋诗（8 回，倒计圈 1.5s）\n- **弓射**（新）— 准星 + 拉弓蓄力 + 风向偏差，5 箭计中靶环数\n\n每款都带退出按钮，互不干扰。\n\n### 🌐 镜头导览系统\n- 9 个预定视点：朱雀大街 \u002F 大明宫 \u002F 大雁塔 \u002F 曲江池 \u002F 东市 \u002F 田畴 \u002F 朱雀门 \u002F 边塞 \u002F 驼商\n- 三大殿专属视点（URL）：\n  - `#view=palaceAxis` — 三殿纵轴俯视\n  - `#view=xuanzheng` — 宣政殿前广场\n  - `#view=zichen` — 紫宸殿内庭\n- 顶部魔术棒按钮启动自动巡游，每段约 7 秒\n- URL 深链：\n  - `#h=18` 设置初始时刻\n  - `#view=palace` 直跳大明宫\n  - `#tour=1` 启动时自动巡游\n\n### 🗨️ 交互系统\n- **18 个**可点击热点（新增宣政殿、紫宸殿）\n- 每个场景独立的多人对话剧本（老者×子游 角色扮演）\n- 时间滑块：0-24 小时手动控制 \u002F 切换自动模式\n\n### 🎮 RPG 游戏模式 (V7)\n- 顶部 🎮 按钮：弹出 4 角色选择卡（士子 \u002F 商贾 \u002F 仕女 \u002F 游侠）\n- WASD 第三人称漫游，相机平滑跟随\n- 主角头顶金色光环 + 箭头标识\n- 走近 NPC → `E` 提示 → 弹出对话框（含背景、连续 3-5 行剧本）\n- 5 步主线任务《初到长安》\n- 触发雁塔 mini-game 联动（题名后任务推进）\n- 8 类身份化 NPC 段子（兵卒\u002F官员\u002F商贾\u002F学子\u002F儒生\u002F百姓\u002F胡商\u002F僧侣）\n- 任务面板 + Toast 通知 + 控制提示常驻\n- `Esc` 退出回到上帝视角\n\n### 👀 FPS 第一人称 (V8)\n- 游戏中按 `V` 切换第三\u002F第一人称\n- 点击画布锁定鼠标（PointerLockControls）→ 鼠标看 \u002F WASD 走 \u002F Shift 疾走\n- 头部位置 (y=1.6) + 走路微晃\n- `Esc` 释放鼠标，再按 `V` 切回 TPS\n\n### 🖼 360° 殿宇展厅 (V8)\n- 5 座展厅：含元殿 \u002F 宣政殿 \u002F 紫宸殿 \u002F 大雁塔 \u002F 曲江亭\n- 走到殿门 8 单位内 → 屏幕显示 `F 入 XX 看壁画`\n- 进入展厅 = FPS + 球形房间 + 4-8 面墙挂壁画 + 中央木匾牌\n- 看向壁画 (≥ 0.85 朝向 dot) → 底部弹出 **标题 + 注释卡**\n- 程序化壁画：暖色底 + 描金边 + 题字 + 注解，每幅独立色调\n- **支持真实素材**：丢图到 `murals\u002F`，自动替换占位\n- `F` \u002F `Esc` 礼出展厅\n\n### ⛈ 天气增强 (V8)\n- 雨天每 6-20 秒概率闪电：**屏幕白闪 220ms** + 0.8-3s 后 **低频雷鸣**（Web Audio 合成）\n- 雨：风向 `(-0.6, 0.3)` → 雨条整体 -7° 斜倾\n- 沙：风向 `(1.4, 0.15)` 强度 3.0 → 阵风调制（gust = 1+0.5sin）\n- 雾：风弱，几乎静止\n- 晴：微风从东吹\n\n## UI \u002F 控制\n\n| 操作 | 效果 |\n| ---- | ---- |\n| 拖动 \u002F 鼠标右键 | 旋转视角 |\n| 滚轮 \u002F 双指捏合 | 缩放（受限） |\n| 鼠标左键 \u002F 触摸 | 点击物体看历史介绍 \u002F 点击 NPC 看段子 |\n| 右侧 1-9 编号按钮 | 切换 9 大场景 |\n| 顶部 ☀ 图标 | 切换自动昼夜 |\n| 顶部 ✦ 魔术棒图标 | 启动自动巡游 |\n| 顶部 ◁ 喇叭图标 | 音效开关 |\n| 顶部 ☷ 诗图标 | 切换诗心模式 |\n| 顶部 ⊕ 圈图标 | 打开小游戏 |\n| 顶部 ⏱ 时间轴图标 | 打开历史事件轴 |\n| 顶部 🎮 角色图标 | 进入 RPG 游戏模式 |\n| 左下春夏秋冬 | 切换季节 |\n| 左下晴雨沙雾 | 切换天气 |\n| 底部时间滑块 | 手动调节小时 |\n| **游戏模式** WASD \u002F 方向键 | 控制主角行走 |\n| **游戏模式** Shift | 长按疾走 |\n| **游戏模式** E \u002F Space \u002F Enter | 与最近 NPC 对话 |\n| **游戏模式** V | 切换 第三人称 \u002F 第一人称 |\n| **游戏模式** F | 入殿看壁画 \u002F 退展厅 |\n| **游戏模式** Esc | 释放鼠标 \u002F 退展厅 \u002F 退游戏 |\n| **FPS 模式** 点击画布 | 锁定鼠标进入真实视角 |\n| **FPS 模式** 鼠标 | 转头看世界 |\n| **展厅模式** 鼠标 + WASD | 在 360° 房间内自由游走，看向壁画看注释 |\n| `#h=X` URL 参数 | 设定初始小时（0-23.99） |\n| `#view=KEY` | 直跳视点 |\n| `#tour=1` | 启动时自动巡游 |\n\n## 文件结构\n\n```\nhan-diorama\u002F\n├── index.html   ← UI 框架 + CSS + 顶栏底栏 + 场景栏 + 时间滑块 + modal\u002Foverlay + 游戏模式 HUD\n├── scene.js     ← Three.js 主程序（~6600 行）\n└── README.md\n```\n\n## 渲染特性\n\n- **正交相机**（OrthographicCamera）+ frustum=64，sandbox 俯视感（游戏模式相机 zoom=1.4 + 平滑 lerp 跟随主角）\n- 阴影范围 ±100（覆盖 120×160 单位地图）\n- 雾默认 200-450 单位（天气切换会变窄）\n- 后期：OutlinePass（拾取高亮）+ UnrealBloom（灯笼 \u002F 烽火 \u002F 金顶辉光）\n- 性能：~1200+ 网格、217 NPC、移动端 30+ FPS\n- 游戏模式：WASD 输入捕获 + 60Hz 主角位姿更新 + 屏幕空间最近 NPC 查询\n\n## Phase 11 路线（继续可做）\n\n- [ ] **Mode 1 区分**：把现有漫游变成\"5 主题策展导览\"（自动相机巡线 + 字幕 + 解说音）\n- [ ] **价格浮动**：早市 \u002F 午市 \u002F 晚市差价，跨市套利\n- [ ] **NPC 雇佣 \u002F 短工**：上午帮工 → 下午结算 → 给铜钱\n- [ ] **科举系统**：以一次性诗会大测验解锁\"进士印\"凭证\n- [ ] **接入名家 NPC**：李白 \u002F 杜甫 \u002F 王维，各开诗仙赞解锁支线\n- [ ] **安史之乱触发 cutscene**：财产损失判定 + 选阵营\n- [ ] **着装影响 NPC 称呼**：着青衫 → 文士叫你\"君\"；着乌纱 → 商贾叫你\"大人\"\n\n## Phase 10 路线（继续可做）\n\n- [ ] **酒令系统**：曲水流觞中真的实现行酒令 (击鼓传花 \u002F 五色筹 \u002F 雅令俗令分级)\n- [ ] **诗词填空**：给一句缺 1-2 字的名句，玩家从 4 字中补出（更高级别）\n- [ ] **诗仙赞累积**：累计获得 3 张诗仙赞墨色腰牌 → 解锁李白 NPC 邀你登黄鹤楼\n- [ ] **更大诗库**：扩到 50 副对联 + 16 个飞花令关键字（添风\u002F雨\u002F夜\u002F星\u002F泪\u002F愁\u002F梦\u002F酒等）\n- [ ] **NPC 出题难度**：根据 NPC 角色生成不同难度（文士出冷门，童子出热门）\n\n## Phase 9 路线（继续可做）\n\n- [ ] **更多街头游戏**：投壶 \u002F 双陆 \u002F 蹴鞠 \u002F 围棋开局猜白先黑先\n- [ ] **赏品装备化**：腰牌 \u002F 锦帕 → 解锁特殊对话或区域\n- [ ] **NPC 个性表情**：胜场加倍兴奋、败场摆鬼脸的连续表情动画\n- [ ] **连胜奖品爆发**：连续 3 胜后概率掉落\"东海明珠\"等顶级藏品\n\n## Phase 8 路线（继续可做）\n1. **真实壁画素材** — 用户提供图片后接入 5 座展厅\n2. **多支线任务** — 加\"长安八景巡礼\"\"坊间公案\"等支线\n3. **战斗系统** — 边塞场景接入弓射 mini-game 作为简易战斗\n4. **多人物联动剧情** — 主角间互动\n5. **物品栏 \u002F 装备** — 拾取笔墨纸砚、腰牌、钱袋\n6. **更多殿宇展厅** — 麟德殿 \u002F 太极殿 \u002F 兴庆宫\n7. **天气过渡动画** — 切天气时雾参数渐变\n8. **历史事件 cutscene** — 安史之乱触发后烽火台炸开\n9. **VR \u002F WebXR** — 头显沉浸式漫游\n10. **多人联机** — WebSocket 同步漫游\n11. **碰撞检测** — 让主角不能穿墙穿建筑\n12. **环境音** — 不同坊里的环境声（市集喧哗 \u002F 寺院钟鸣 \u002F 边塞马蹄）\n\n## GitHub 部署\n\n静态站点可托管在 **GitHub Pages**（含 CI 自动发布）。步骤见 [docs\u002FGITHUB_DEPLOY.md](docs\u002FGITHUB_DEPLOY.md)。\n\n```bash\ngh auth login\nchmod +x scripts\u002Fpush-to-github.sh\n.\u002Fscripts\u002Fpush-to-github.sh tang-changan   # 仓库名可自定\n```\n\n线上示例 URL：`https:\u002F\u002F\u003C你的用户名>.github.io\u002Ftang-changan\u002Findex.html?world=new`\n\n## 致谢\n- Three.js \u002F OrbitControls \u002F postprocessing \u002F EffectComposer\n- 营造法式 \u002F 唐两京城坊考 \u002F 大唐六典 \u002F 资治通鉴 — 历史参考\n- 《全唐诗》 — 诗歌素材\n","大唐长安 · 智机府是一款以唐代长安城为背景的互动Web游戏，采用JavaScript开发。该游戏通过精美的微缩沙盘再现了唐朝盛世的风貌，包括三大殿、桥梁、大雁塔等标志性建筑，并融入昼夜变化、四季更替、天气系统等元素，增强沉浸感。玩家可以体验到丰富的互动内容，如唐诗吟诵、NPC对话、历史事件重现及迷你游戏等，同时支持RPG和第一人称视角模式。此外，项目还设计了一套经济体系，涵盖多种货币与商品交易，适合对历史文化感兴趣的用户或教育场景使用，既可作为娱乐工具也能用于教学辅助。",2,"2026-06-11 04:09:09","CREATED_QUERY"]