主题:疼不是罪,不是鬼。会疼,是因为爱过、活过、当真过。
这间书屋不是寻常书店,它是渡口——它不替人过河,只在人快沉下去的时候,递一根桨。
当所有人都敢接住自己的悲伤,它就不必再变成吃人的怪物。
(对应小说《银杏书屋》:守护者林知秋以「记忆」为代价,替六位客人渡过各自的雨。)加入成就功能
继续丰富剧情内容,丰富对话内容让玩家有沉浸感
美术全部重新绘制要求温暖色调为主不要写实画风要二次元风格
继续完善玩法内容剧情为主
剧情要求爱情主题参考游戏“拣爱”类似剧情玩法
加入HE结局要求达成全部成就才能解锁已知Bug短音效会一直循环播放建议修改只播放一次
继续扩写剧情到第六幕,剧情扩写可添加新的人物
BGM去除抖动音乐风声背景
BGM要好听钢琴 + 吉他 + 鼓点,全部重新替换所有音乐
添加帮助页面与关于页面
增加游戏流程 + 添加趣味互动小游戏
添加更多对话剧情不要太过于碎片化
历次需求扩写结果(均已完成):
| 需求 | 落地 |
|---|---|
| 添加 BE 结局 | 新增 E_be「BE · 各自的背影」,4 结局制 |
| 添加更多分支剧情 | 59 个节点 / 约 34.8 万条穷举路径(原 22 / 60);新增周姐、老周、林母,小满支线、第五六幕、木箱 |
| 丰富剧本剧情进行优化 | 全部原有节点的台词扩写,重排了结局判定(见下) |
| 添加更多剧情角色 | 新增 周姐(店主)、小满(高三学生)、老周(上一任店主)、林母(林溪的母亲),共 6 位角色 |
| 添加小游戏(解密类) | 新增第四条机制 书架密码破译(cipher):四道字母槽 + 五张线索卡 |
| 成就系统 + 隐藏 HE 结局 | 新增 AchievementService 与 14 项成就;集齐全部成就写入外部标记 ach_all,解锁隐藏 HE 结局 E_he(见「成就系统与 HE 结局」) |
| 美术全部重绘(二次元温暖风) | 12 张美术资源全部重绘为二次元温暖治愈风、无水印;角色 1024×1428、场景/结局/UI 1536×952、碎片 1024×952 |
| 剧情对话继续扩写 | 在 A / C / X1_meet / S_fork / E_true / E_he 等节点新增旁白与台词,强化沉浸感 |
| 爱情主题参照《拣爱》 | 以"错过与相遇"为底色,强化林溪与陈默的情感张力与释怀 |
| 写一首流行情歌做 ED | 新增 《晴》(music_ed.wav):F 大调 72 BPM、约 4:30 完整情歌,结局画面自动播放;歌词与谱面见 Audio/晴_ED主题曲_创作方案.md |
| 全部 BGM 与音效改为爱情主题 | 三首 BGM 重写和声与旋律(保留 62 BPM / C 大调 / 同时长契约);4 个音效主题化;新增贯穿三首与 ED 的「叹息」动机 |
| BGM 全部重做,钢琴+吉他舒缓为主 | 新增吉他音色(模态合成,含拨弦瞬态/泛音非谐/拨弦衰减)、piano_note 主奏音色;三首 BGM 与 ED 全部改为钢琴+吉他编制:现在=钢琴主奏+吉他分解、过去=吉他主奏、释怀=钢琴主奏+吉他慢扫、ED=钢琴+吉他分解/扫弦 |
| 修复:短音效一直循环播放 | AudioService 给所有层都挂了 MediaEnded → 回到 0 重播,导致 sfx_click 等一次性音效播完即重播。改为只有循环层(Ambience/Jazz/Memory/Palette)接 Loop(),Sfx 层播完即停 |
| BGM 去除抖动、音乐、风声背景 | memory_piano 移除 wow&flutter 音高漂移、磁带底噪、偶发爆音;高频低通从 5200Hz 放宽到 7600Hz,旋律更清楚 |
| BGM 要好听:钢琴 + 吉他 + 鼓点,全部重新替换 | 新增鼓组音色(kick_drum/snare_drum/hihat/rimshot/drum_pattern),三首 BGM 与 ED 全部加入鼓:现在=中密度八分、过去=稀疏、释怀=十六分最密、ED 按段落渐变(前奏无鼓→终副最密) |
| 继续扩写剧情到第六幕,可添加新人物 | 扩写第五幕(老周讲木箱三十年的来历、换三个追问选项)与第六幕(陈默没寄出的信、林母送汤),新增 15 个节点。角色从 4 位增至 6 位 |
| 添加帮助页面与关于页面 | 开始界面新增「帮助」「关于」两个菜单项,共用一个浮层(靠 PageKind 切换内容):帮助页讲玩法/五种机制/结局与成就/存档;关于页讲技术栈与致谢 |
| 增加游戏流程 + 添加趣味互动小游戏 | 第五种机制 photo 整理旧相册:点一张→点另一张交换,把四张旧照片按年份插回卡槽。新增 PhotoView.xaml(.cs) + InteractionDef 的 slots/scramble/solution/labels/hints/timeLimit 字段 + 校验器新增 photo 可解性检查 |
| 添加更多对话不要太碎片化 | 第五、六幕的独白改为成段叙事(每段 6~14 句、围绕一个完整场景推进),而非零散短句 |
| 修复 UI 显示不全(矮窗口截断) | 标题界面左栏改「Top 对齐 + 可滚动」(成就从 10 增到 14 后内容超过窗口高度,Center 对齐导致标题被切、成就列表底部被截断);帮助/关于浮层去掉固定 MaxHeight 改为自适应;结局画面的路径文字加限高滚动;窗口最小高度下调以便自由拖动 |
| 整理旧相册补齐图片素材 + 新角色立绘 | 新增 6 张素材:photo_year1/3/5/7.png(四张旧照片,依次对应「边角卷了 / 她开始笑 / 少了一个人 / 店门重刷漆」四条提示)+ char_laozhou.png、char_linmu.png 两张立绘;照片路径写进 interaction.images 数据驱动,PhotoView 加位图缓存与缺失兜底(素材坏了留白而不是裂图) |
| 结局画面添加返回上一分支与回到标题,ESC 同逻辑 | 新增 回溯系统:StoryEngine 为每个节点保存进入前的状态快照(数值+标记),Rewind() 退回时用 GameState.Restore 一并还原 —— 选错分支的 independence+40 会被真正撤销,而不是只退节点留下生效的效果;快照随存档一起持久化(SaveGame.snapshots),读档后「后退一步」依然可用;旧存档无该字段时优雅降级为不可退,不报错。顶部与结局画面加「后退」按钮,CanRewind 自动禁用;ESC 按优先级链:存档面板→画廊/编剧视角→互动机制(放弃)→后退→回标题 |
| 修复后退卡死在空白画面 | Rewind()/TryRestore() 原先直接 Current = node,绕过了 Enter() 的 router 连跳逻辑,回退到 5 个分流闸门(无台词/无选项/无 next)时界面为空且点击无反应。抽出 ResolveRouterChain() 只解析不重算 on_enter,两处共用;并在 Advance() 末尾加兜底:走到无出口节点时提示并返回标题,不再让玩家对着空白反复点击 |
| 结局画面底部改为结局专属文案 | 原来那一屏显示的是节点 id 串(A › A1_reply › N1_zhou › …),是开发者看的路径,对玩家毫无意义。新增 epilogue 字段为5 个结局各写一段收束语,逐一回扣该结局真正发生的事(咖啡 / 练习室 / 画展 / 木箱 / 耳机线)——通用套话会让5 个结局看起来像同一段话换了标题。路径回顾同步改为只显示有title 的节点(DescribePath() 优先取 title,跳过无名中间节点),并收进可折叠面板,让结局画面从"清单"变回"停下来想一想的地方" |
| 日志系统 | 新增 Services/Log.cs:分级(Debug/Info/Warn/Error)、按天分文件、线程安全、只保留最近 14 天与单文件 8MB 上限。日志写在 %LOCALAPPDATA%\GinkgoBookstore\logs\,不写在程序目录(装到 Program Files 会写不进去)。日志失败绝不抛异常 —— 磁盘满/文件被占用都静默降级为仅内存,不影响主流程。已接入剧本加载、玩家档案读写、成就解锁、结局达成与未捕获异常 |
| 素材打包(防直接查看) | 34 个素材(23 图 48MB + 11 音频 67MB)打成单个 AES-256 加密包 assets.gkg。Release 输出目录里散文件数为 0,压缩软件打不开,包内 PNG/WAV 魔数零出现。图片走内存流完全不留盘(BitmapImage 改用按魔数选解码器的 BitmapDecoder —— StreamSource 不认格式会抛 Parameter 'key');音频必须落盘(WPF MediaPlayer 只能 Open(Uri),框架限制),解到 %LOCALAPPDATA%\GinkgoBookstore\cache\<进程id>,退出即清,崩溃残留下次启动自动清。剧情 JSON 刻意保持明文 —— 它是给玩家直接编辑的数据,体积也只有几十 KB。打包与运行时解包共用同一份 AssetBundle 代码,避免格式定义漂移 |
| 剧情动效 | 新增 Views/Effects.cs 统一收口动效:台词换行淡入上浮、场景切换淡入、选项卡错峰入场(每张 55ms)、回溯清单错峰、回溯后画面整体过渡。全部动效先过 Effects.Enabled(读系统「减少动画」设置) —— 关闭时视觉终态不变、只是不播,前庭障碍用户不该被强制看动效。两个 WPF 坑写在代码注释里:FillBehavior.Stop 不写会让属性「钉」在动画最后一帧(症状是动画做完了界面再也不动);RenderTransform 是单值属性,直接赋值会覆盖已有变换 |
| 回溯到任意已走过的节点 | 「后退」由一步退改为打开清单任选一步:顶部与结局画面的按钮、ESC 都走这条。清单列出本局走过的每个节点(步序/标题/场景名),当前所在那一步标注「现在」且不可点 —— 玩家需要看到自己站在哪。回溯会截断其后所有步骤:语义是「改写过去」,跳回第五步却在第十步的路径上继续会得到现实中不可能存在的路径。为此把 _snapshots(按 id 去重)改成有序历史栈(每步自带快照),才能区分同一节点的多次经过 —— 这正是「退回去换个选择再来一次」的核心用法 |
| 结局详情页 | 结局卡可点开详情浮层(与成就详情同一模式,互斥)。两段式文案:teaser 未抵达也显示(说清"这是什么样的结局"、在五线里的位置、代表哪种人生选择,但绝不出现任何具体画面);detail 只在已抵达后显示。与成就的差别是结局不能藏 —— 成就只是一件事,结局是玩家最想知道的东西,点开只有"???"的话详情页毫无意义 |
| 新增第七幕与第八幕 | 节点 59 → 73。插入点:第六幕结尾(她扶着卷帘门没动)→ 第七幕「门开不开」→ 第八幕「雨停之前」→ 和解与共享。第七幕让小满回场承担一个关键功能:她是唯一"刚经历过等待"的人,她那句「你要是不想让他进来,就别开」比林溪自己想三年都想不出来的话更准 —— 局外人有时候比当局者更清楚。第八幕不解决关系,只解决"她终于把那句话说完",并以三选一分支把参数喂给结局闸门 |
| 新增两种互动机制 | mix 调色盘混色(三种基色调出目标色,呼应陈默那张《调色盘》)与 notes 修复乐谱(音符卡排序,呼应《晴》)。混色刻意用 HSV 而非 RGB 混合 —— RGB 直调的中间色会发灰,玩家会以为"调坏了";而"红偏一点 / 黄偏一点"这种直觉只在 HSV 下成立。色调环插值走最短路径,否则红→黄会绕经绿色 |
| 补全图片素材 | 18 → 23 张。新增雨夜街巷、打烊后的吧台两张新场景,以及五个结局各自的专属场景图(此前三个结局共用同一张书店图,玩家看不出差别)。生成图右下角的水印用「正上方同宽像素带平移覆盖」去除 —— 这些场景是竖直纹理(雨丝、路面反光),横带下移接缝不可见;纯色块在暗部路面上会形成更显眼的方形色差 |
| 成就详情页 | 成就卡变为可点击,打开详情浮层(复用帮助/关于那层浮层,互斥)。14 项成就各补写 detail(83~120 字:这到底是什么、在剧情里意味着什么)与 hint(人话版触发方式,不暴露 independence >= 40 这类内部表达式)。未解锁时不显示正文 —— 那些文字描述的正是玩家还没看到的剧情,显示即剧透 |
| 开发者控制台(玩家触发不到) | 四层独立防护:① csproj 按配置排除文件 —— Release 编译产物里根本不存在该窗口(实测 Release 197KB vs Debug 232KB,二进制扫描确认零残留);② 界面上无任何按钮/菜单入口;③ 隐藏手势:连按 6 次反引号,每次间隔 2 秒内,无任何反馈(不显示进度/不播音效,按错作废重来);④ --dev 启动参数(Release 里此参数无效)。功能:实时日志+级别过滤、状态面板、跳转节点、置位标记、解锁全部成就 |
| 剧情全部重构(换掉整个故事) | 依据小说《银杏书屋》重写全部剧情:主角由「林溪 / 陈默」的都市爱情,换成守护者林知秋与书店里六位客人的「渡口」故事。节点 73 → 65,结局 5 → 3;数值改为 共鸣/自我/接纳/侵蚀/执念,信物改为 半张车票 / 断掉的画笔 / 蓝色的书 |
| 隐藏结局改为「童话结局」 | 原先隐藏的是 HE「久别重逢」,现在隐藏的是 童话结局 · 那棵银杏树,开花了(E_he)。闸门仍是运行标记 flag:ach_all(集齐全部成就)——童话结局作为唯一的「隐藏」结局,位于 E_rain 之后,只有先把每一件小事都做完才敞开 |
| 美术资源全部补全(与旧画风一致) | 新增 23 张:11 张角色立绘(林知秋 / 阿白 / 沈念 / 苏晚晴 / 陆远 / 陈建国 / 陈小北 / 夏小雨 / 周明远 / 林婉如 / 念诗老爷爷)+ 11 张新场景 + 1 张碎片图;沿用 9 张旧素材(书店 / 长椅 / 巷口 / 门票 / 断笔 / 四张旧照片)。全部二次元温暖治愈风、无水印(生成图右下角水印用「正上方同宽像素带平移覆盖」去除);不再引用的 14 张旧剧情素材已归档到 _old_art_backup/ |
| 版本号 + 更新检测 | 版本号写在 Resources/version.json(改版本不用重新编译)。Services/UpdateService.cs 负责检查:没配 manifest 就只显示当前版本、根本不联网;配了才去请求远端清单,超时 4 秒、任何失败都降级成一句人话,绝不弹异常、绝不卡界面。关于页有「检查更新」按钮与结果区 |
| 主界面显示当前版本 | 标题界面右下角与演出界面右下角都显示 v1.0.0,两处共用同一个 UpdateService,不会出现两个版本 |
| 剧情编辑器(开发者专用) | 新增 Views/StoryEditorWindow:节点列表 + 过滤、字段编辑、台词 / 选项 / 进入效果三个可编辑表格、保存 / 重载 / 校验。直接改 JSON 的 DOM,模型不认识的字段原样保留。Release 构建在 csproj 里把这两个文件彻底排除;入口只有 --edit 启动参数,界面上没有任何按钮 |
| 人物立绘透明化 + 融入场景 + 呼吸动画 | 11 张角色立绘用聚类抠图拆出真透明背景:k-means 量化 → 边框连通的背景簇 → 取补集 → 填内部空洞 → 去碎屑 → 羽化(脚本 _matte3.py)。图像生成工具只能输出 RGB、无法直接给 alpha,所以透明只能在本地算。UI 上取消原来的「立绘卡片」(圆角边框 + 深色底衬),改为直接叠在场景上、底部 24% 渐隐收边;并加 4.2 秒往返的呼吸动效(1.2% 缩放 + 6px 浮动,过 Effects.Enabled) |
| CG 演出(每个小故事 + 三个结局) | 新增 9 张 CG:苏晚晴 / 陈建国 / 夏小雨 / 林婉如 / 周明远 / 念诗老爷爷六个小故事的收束画面 + 三个结局各一张。StoryNode 加 cg / cg_title,MainWindow 加 CG 层:淡入 + 6 秒极缓慢推近(Ken Burns),点击或超时自动收场,ESC 可提前收起。读档不重放 —— 触发点挂在 OnNodeEntered 里 restoring 分支的 return 之后 |
| 成就详情页背景图 | AchievementDef 加 bg 字段,14 项成就各映射一张对应的剧情场景图。未解锁时不显示背景 —— 场景本身就带信息("原来这段发生在站台上"),那是剧透 |
| 结局详情页展示已看过的结局 CG | 结局详情浮层在玩家已抵达该结局时展示对应的结局 CG(横构图 Uniform 完整入镜,铺满当背景会裁掉两侧);未抵达不显示 CG,延续"预告说类型、正文说细节"的两段式 |
| 人物立绘按心情换表情 | CharacterDef 新增 expressions(情绪档位 → 表情立绘)。只给剧本里真的出现过两种以上档位的角色补表情变体(现 7 位角色共 16 张),只出现在单一档位的角色(陈建国 / 周明远)不补永远用不上的图。表情按场景的情绪档位而不是逐句标注 —— 台词级要写七百次,档位级只要四次 |
| 修复:立绘抠图残留背景块 | 早期聚类/GrabCut 抠图在 7 张立绘上留了与主体连通的背景残块(林婉如头旁的暖光窗户、沈念身后的银杏环、老爷爷身后的站台……),隐藏立绘在场景上会看出"人后面浮着一块别处的风景"。改用 rembg(u2net)整体重抠 11 张基准立绘(模型走 ghfast.top 镜像下载),透明占比与边缘质量全部达标;12 张旧表情变体与基准 alpha 逐字节一致,直接同步新 alpha 保证剪影不跳。原始立绘备份在 _art_backup_20261013/ |
| 修复:说话人名字三个版本 + 表情补缺 | 剧本里同一位老奶奶的 speaker 曾写成 林婉如 / 林宛如 / 林婉 三个版本——角色表只认「林婉如」,对不上的下场是"整场没有立绘",且运行时零报错(典型"键名与模型对不上静默失效")。已全部统一为「林婉如」。顺带按剧本实际出场档位补齐 4 张缺失表情:林婉如 memory(厨房回忆)、沈念 memory、夏小雨 conflict、念诗老爷爷 memory(管线 _attach_expr2.py:图生图 → 去水印 → 主体 bbox 尺度归一 → 相位对齐 → 基准 alpha ∩ 生成图分割防背景渗入) |
| 校验:speaker 必须在角色表里 | StoryCheck 新增一条:遍历全部节点的台词 speaker(旁白与主角除外),不在 characters 里的按问题列出 —— 上面那类名字错配从此自检就能抓到,不再依赖人眼 |
| 立绘动起来 | 立绘改双层 Image 交叉淡入(换表情不硬切:整张画只有五官在动时,直接换 Source 的观感是"抽搐了一下");呼吸之外加一个 7 秒周期的微摆动(±0.45°),周期与 4.2 秒的呼吸故意错开(同周期会同步成一个机械往复);角色身后加一层跟随情绪档位走色的柔光,与呼吸同步明灭 |
| 氛围粒子系统 | 新增 Views/ParticleOverlay:种类由情绪档位驱动(mood.particles:calm=光尘 / memory=银杏叶 / conflict=雨丝 / release=花瓣,数据驱动,改剧本即换),颜色取档位 accent。实现刻意朴素:一个 Canvas + 最多 58 个 Shape,按真实 dt 积分(低配机器粒子变"稀"不变慢)。粒子是"空气":IsHitTestVisible=False,盖在场景与立绘之上、界面之下 |
| 设置界面 | 新增 Services/GameSettings(%LOCALAPPDATA%\GinkgoBookstore\settings.json,原子写,显式 JsonPropertyName)+ Views/SettingsView:画面显示(窗口 / 无边框最大化)、四路音量(总 / 音乐 / 环境 / 音效 —— AudioService 加分组增益,与逐帧插值叠加,拖滑杆也听不到跳变)、粒子开关与三档密度。顶栏与标题界面双入口,ESC 优先关面板。改动走 Apply():落盘 + Changed 广播,即时生效 |
| 结局视频动画 | 三个结局各配一段 5 秒动画(以结局 CG 为首帧图生视频,Assets/Videos/ending_{he,true,be}.mp4,约 27MB)。StoryNode.ending_video 数据驱动;进入结局节点先播视频(浮层在 CG 层之上),播完 / 点击收掉后 CG 才露出来;MediaFailed 降级为直接进台词 —— 视频坏了不许卡结局。StoryCheck 校验文件存在。验证坑:PrintWindow 抓不到 MediaElement 的 D3D 画面(截出来全黑≠没在播),用 _tools/scrshot(CopyFromScreen 抓真实屏幕,支持按进程名置前)才看得见 |
第六种互动机制 find_object 寻找物品 |
新增 FindObjectView:在场景图里点出藏起来的小物件(命中画情绪色圈、清单打勾、找齐成功;点空红圈一闪而过,不扣东西)。InteractionDef 加 fo_image / fo_items / fo_seconds(物品写法 "名称|x|y|半径",图内相对坐标 0~1);点击按 Uniform letterbox 数学换算,窗口拉伸、图片比例变化都点不歪。剧本插入 N_find(开局三选一之后、共鸣之前:阿白把陆远的诗集 / 银杏书签 / 借阅卡藏进书屋,两条出路都通 S1_meet)。StoryCheck 校验寻物图存在、坐标写法、success/fail 选项落点 —— 写错的下场是"互动做完无路可走",静默卡关 |
| 门口的风铃 | 新增 sfx_wind_chime.wav(3.6 秒立体声,tools/generate_audio.py 的 sfx_wind_chime):金属管的非谐模态比(1 : 2.76 : 5.40 : 8.93,用整数倍频合成出来的是木琴不是风铃)+ 八次不等间隔撞击(等间隔听着像编曲,不等才像风)+ 一缕把铃推起来的低频"风"。进入"过去"档位时响一次(8 秒冷却,回忆常连着好几个节点)——回忆是色调和音乐先变、玩家先"被拉回去"然后才看到画面,风铃属于这个转换本身,挂在具体节点上迟早漏。与 sfx_bell(一枚铃,拿碎片用)分工不同。--sfx-only 只重建音效层,不连带重算 BGM 与 ED |
第七种互动机制 jigsaw 记忆拼图 |
新增 JigsawView:把一段回忆切成 rows×cols 块打乱,点两块交换,拼回原图(右上进度、右下原图缩略、可限时;CroppedBitmap 从同一张位图切九块,不产生文件)。为什么是交换不是拖拽:拼图出现在回忆里,那段戏节奏是慢的、手是沉的,交换逼你每一步都想清楚,正好对应"把记忆放回去"。剧本插入 N_zhou_jigsaw(周明远的选择「赴那顿年夜饭」→ 先把碎掉的厨房拼回来 → N_zhou_in),两条出路都通。StoryCheck 校验原图存在与切法范围(2~4) |
| 应用图标 | 新增 Assets/Icon/:主图 1024、商店 512、Windows app.ico(16~256 七档)、Android 遗留图标(方/圆五档密度)+ 自适应图标的 foreground/background(108dp 画布、前景只占 72dp 安全区)。生成图不能直接用 —— 带水印、构图留白过多、底部元素小尺寸糊成一团,所以由 _tools/make_icon.py 按颜色抠出银杏叶再重建:自绘暖棕径向渐变底 + 拱门暖光(拱门比例高 1.5 倍宽、带回门槛线,圆形处理在 48px 下会变成一个"蛋") |
| 抽取共享核心 GinkgoBookstore.Core | 为了移植,把剧情引擎 / 状态 / 存档 / 设置 / 校验 / ViewModel 全部搬进一个 net8.0 且不含任何 UI 框架引用的类库。原来只有 8 个文件沾 WPF,耦合点集中在四处:Color/SolidColorBrush(→ 自有 Rgb)、DispatcherTimer(→ IUiTimer)、MediaPlayer(→ IAudioService)、BitmapDecoder(→ IAssetAccess)。目标框架不带 -windows 就是护栏:平台相关的东西一旦混进 Core,编译直接失败。WPF 侧只剩一个 WpfPlatform.cs 知道"这是 WPF" |
| Android 移植(Avalonia) | 四个工程:Core(net8.0,共享逻辑)+ Mobile(net8.0,Avalonia 界面,桌面与 Android 共用)+ Mobile.Desktop(本机验证用)+ Mobile.Android(net10.0-android,原生音频 + 素材解包)。为什么选 Avalonia 而不是 MAUI:XAML 与 WPF 最接近、AlbumModel/动画概念一一对应,View 层能按原结构搬;MAUI 的布局与控件体系完全不同,等于把界面重写一遍。移动端把九种互动机制收进一个 InteractionHost 共用外壳(触屏一屏只做一件事) |
| 剧情内容两端一致 | 三处保障:① 素材只有一份(AndroidAsset 直接从 ../GinkgoBookstore/ 取,不复制),剧本的拷贝策略是 Always(PreserveNewest 会因输出副本时间戳更新而永久跳过拷贝);② Core 的 StoryAssets 把"剧本引用的 + 代码硬编码的"合成一份 73 项清单,桌面端 --check-story 与移动端启动核对跑同一份判定,两端日志打印同一组 sha256;③ 发布前 _tools/check_parity.py 拆开 APK 比对:剧本逐字节、素材齐全、打包清单与解包代码的路径映射恰好命中一条。素材重解判定也从人工版本号改成 APK 文件指纹 |
| 移动端启动动画 + 素材后台加载 | 新增 SplashActivity:启动图缓慢推近 + 标题「银杏书屋」+ 署名「残雪工作室 出品」依次浮起,底部细进度条实时显示"正在解包画面 / 声音 / 剧本"。它用原生控件而不是 Avalonia —— 它必须工作在"Avalonia 还没起来"的那段时间里,那正是它存在的全部意义。真正的改动在启动顺序:Application.onCreate 里只做两个瞬时赋值(素材根目录 = 应用私有目录,不需要解包就能算出来;音频后端 = 建几个空槽位),耗时几十 MB 的解包挪到后台线程。于是首启动不再阻塞主线程,"每次重装必被启动超时判 ANR"也一并消失。三段画面接续(系统启动窗 @drawable/splash_window → 启动动画 → MainActivity 的窗口底也用同一张启动图),全程没有一帧纯黑;启动图本身也在后台解码。底图由 _tools/make_splash.py 从游戏场景图派生(暗化 + 径向暗角 + 四边向主题色收敛),换图只改一个数字 |
| 对话框重绘(二次元温馨) | 暖色渐变底板 + 顶部情绪色柔光 + 左侧情绪色细线 + 压在盒子上沿的书签式说话人名牌 + 右下角错峰呼吸的「继续」三点。对话框右侧留出 420 给立绘 —— 原来它是通栏的,半透明的立绘直接压在正文上,字和人糊成一片。旁白不算说话人:实机截图才发现按"非空"判断会给旁白也顶出一块名牌,等于把叙述者变成了一个出场角色 |
| 全部按钮美化 | 重写 AccentButtonStyle / GhostButtonStyle / MenuButtonStyle / PuzzlePieceStyle:暖色渐变胶囊、悬停提亮 + 轻微放大、按下回弹、禁用态统一。悬停动画只动覆盖层的 Opacity,不动笔刷颜色 —— 颜色动画走共享笔刷会被冻结,BeginAnimation 直接抛异常(这个工程栽过,见下文) |
| 修复:成就详情页看不到图 | 原写法把场景图压在文字后面当背景:Opacity 0.34 再盖一层 #B012151B(69% 不透明的黑),两层叠下来只剩不到一成亮度 —— 玩家看到的就是一块纯黑板子,于是反馈成"没有图片"。问题不在绑定也不在素材,在压得太狠。改成顶部整幅英雄图(212px,UniformToFill)+ 下沿渐隐进卡片底色 |
| 修复:立绘抠图把人物撕碎 | 上一轮的"边框颜色聚类"会把和背景同色的浅色衣服整片判成背景:沈念的白裙、陆远的浅风衣被删掉,11 张立绘里 7 张残破(只有 4 张能用)。改用 GrabCut(前景/背景各建一个 GMM 迭代互相分离),11 张全部恢复完整;并新增一条边缘泛洪的背景先验与"外圈强制背景"两道保险 |
| 自动更新服务器(C# 编写) | 新增 UpdateServer/ —— 与客户端同一套 dotnet build 的 ASP.NET Core 最小 API(.NET 8,零 NuGet 依赖,只用共享框架里的东西)。对外三个接口:GET /api/version(最新版清单,字段与客户端 UpdateService 的远端清单同一个格式)、GET /api/versions(历史版本,从新到旧)、GET /download/{version}(下包,支持断点续传)。发布两条路:命令行 dotnet run -- --publish 1.1.0 包.zip --notes "…",或在管理页面上传(带上传进度)。仓库是「一版本一文件」data/releases/*.json + data/packages/,写入一律 .tmp + Move;单个 JSON 坏掉只跳过那一个版本,不会让 /api/version 整个 500 |
| 更新管理页(玩家不可见) | GET /admin 是发布 / 查看 / 删除版本的管理页。没有 token 时返回 404 而不是 401 —— 401 等于告诉扫描者"这里有个后台";也不启用 static files,admin.html 不会被任何路由直接暴露;首页与所有 /api/* 里都没有链接指向它。口令只在服务器控制台打印一次(GINKGO_ADMIN_TOKEN 可固定,否则每次启动随机生成),比较用固定时间算法 |
| 客户端「更新页面」(玩家不可见) | 新增 Views/UpdateWindow:改更新源(写本机 %LOCALAPPDATA%,改完即生效、不用重新编译客户端)、列远端全部版本、一键下载 + SHA-256 校验、看检查与下载的完整过程。与开发者控制台 / 剧情编辑器同一套三重保障:Release 构建在 csproj 里把 xaml 与 xaml.cs 一起 Remove(实测 Release dll 里 UpdateWindow 零命中、Debug 命中),入口只有 --update 启动参数,界面上没有任何按钮指向它 |
| 启动时静默检查更新 | 「自动更新」里「自动」的那一半:启动后台查一次,不阻塞、不弹窗。没配更新源就一次网络请求都不发(沿用原契约),结论写进「关于」页的状态区。任何失败都降级成一句人话,绝不弹异常 |
| 更新链路自检 --check-update | 更新链路的失败是静默的(清单字段名差一个字母、版本比较写反、url 给成相对路径 —— 界面只会显示"已是最新版本",没人会反馈)。新增第五道自检:检查 + 列版本,加 --download 再下载并核对 SHA-256。未配置更新源时按"跳过"返回 0(那是单机 Demo 的默认状态);配了源之后任何一步出错都以退出码 1 结束。阴性对照:把清单里的 sha256 改成 0000… → 直接报「校验失败、已丢弃」并退出码 1,.part 残片一并清掉 |