OliviaSoul · 林离离线增强工具

面向已安装《BSide: Olivia Lin》离线客户端的 Windows 本地工具，提供信件与记忆管理、兼容 AI 接入、成品演奏视频导入、游戏端“我的上传”播放与作品编辑，以及轻量桌面歌词。

不提供游戏本体、官方账号数据或官方演奏视频，不恢复已关闭的官方服务器。

R10.7 中转 API 兼容更新（2026-09-14）

更新标识 2008.2.7-linli.9，程序版本保持 2008.2.7，客户端补丁仍为 FE v44 / WebPlayer v18。包含下方 R10.6 的全部功能。

本次发布页 · 安装版 Setup · 便携版 Portable · SHA-256 校验

• 新增手动填写模型名及可选模型查询；中转站与本地服务统一使用“通用兼容 API”档案。
• 兼容完整 Chat Completions 地址、JSON 分段正文及 SSE 响应；明确拒绝 max_tokens 时按同一上限兼容 max_completion_tokens。
• 修复查询结果覆盖手填模型名、非 DeepSeek 模型收到专用参数，以及推理内容、截断回复被误判成功的问题；统一检测、AI 导入、文本整理和实际回信的处理规则。
• 随包附中文 API 配置说明，包含 seekai.cc 示例、地址用途和常见错误说明。尚未使用 seekai.cc 用户密钥实测，不代表支持所有原生协议或商业中转站。

本次更新说明 · API 配置使用说明 · 兼容范围

R10.6 历史更新：桌面歌词与曲库（2026-09-10）

更新标识 2008.2.7-linli.8，程序版本保持 2008.2.7，客户端补丁 FE v44 / WebPlayer v18。安装版和便携版包含完整运行时，不需要另外安装 Node.js。

本次发布页 · 安装版 Setup · 便携版 Portable · SHA-256 校验

新增

• 桌面歌词：独立歌词设置，托盘、管理页和游戏“词”按钮共用开关；支持横排/竖排、单行/双行、系统字体、字号及配色。悬浮显示工具栏，锁定后悬浮显示解锁图标。
• 歌词关联与控制：同一作品的多个视频默认共用 LRC，各版本偏移独立保存；提供上一曲、暂停/继续、下一曲。歌词工具栏暂停保留歌词和当前进度，无歌词时显示曲名与提示。
• 曲库移除：管理页和游戏歌曲外层提供移除入口，管理页支持多选、数量提示及批量移除。移除不删除视频，手动重新导入可以恢复，后台同步不会自动恢复。

修复与优化

• 导入完成后即时通知前后台刷新；新歌按相同顺序显示，保留搜索、已选项目和播放状态，避免旧请求覆盖新列表。
• 移除正在播放的上传作品后，按原队列续播下一首可用的官方或上传歌曲；修复进度条停留 0:00、播放失败仍显示播放中，以及移除后重新加播单不显示的问题。
• 多目录分别保存和展示来源；单个作品文件夹内的多段视频保持为同一作品，兼容改名后重新导入的内容核验。自动监测仍仅针对最近导入目录。
• 普通引用导入不再依赖游戏曲目保存路径；保留 linli.7 的路径字段解析修复。旧补丁识别和升级提示同步更新，缺少干净备份时不强行覆盖。
• 修复管理窗口最大化后需要关闭两次、字体下拉与系统字体、托盘与管理页开机自启动状态联动等问题。

**升级步骤：**退出游戏和托盘程序，备份整个 UserData 与外部视频，覆盖安装或完整解压新版；在“客户端与桌面”更新补丁至 FE v44 / WebPlayer v18，再启动游戏。仅安装软件不会自动替换游戏中的旧补丁。

完整更新说明 · 歌词使用说明 · 本次构建与验证记录

本次完成定向回归、原生构建、包内服务验证和文件一致性核对；不把下方历史四小时压测当成本版结果，也不宣称全部游戏内存问题已解决。

R10.5 历史更新：曲目路径识别修复（2026-09-08）

修复 Issue #2：部分游戏设置文件已有曲目目录，但软件提示“没有有效的 songStoragePath”，导致导入失败。升级后在“客户端与桌面”点击“重新读取路径”，再扫描并导入曲库。下面保留的四小时压力测试结果来自 R10.4。

该历史版本发布标识 2008.2.7-linli.7，程序版本为 2008.2.7，相关修复已包含在 R10.6（linli.8）。

R10.5 发布页 · 安装版 Setup · 便携版 Portable · SHA-256 校验

• WebPlayer v14 限制轮询与进度请求并释放旧请求，降低长时间播放的 CEF 内存压力。

• 4 小时压力测试完成 952 次采样：0 错误、0 新崩溃，系统提交内存峰值 36.82%。

• 修复新旧 WebPlayer 补丁状态误判及客户端路径识别问题。

• 已去除 OliviaSoul 软件界面水印和游戏音乐视频画面的 UID 水印。

• 下载支持系统代理、暂停/继续/取消及完整性校验；修复旧任务误续传/降级、取消提示覆盖检查结果。

• 安装向导支持系统语言默认选择和中英文切换，统一安装与错误弹窗。

• 客户端只读检查合并重复请求、超时重试一次，明确 FE/WP 版本和真实挂载状态。

• AI 配置及上次检测结果保留，启动后台检查、页面自动刷新，保存测试后同步状态。

• 管理选项卡新增提醒圆点：金色未读信息、红色待处理异常，悬停说明原因。

• 完整保留播放/时段/永久曲名修复、原生写信和音乐入口，以及启停、卸载恢复保护。

合并更新说明 · 使用说明

R10.1 历史下载与文档

• 软件版本：2008.2.7。
• 发布标识：R10.1 / 2008.2.7-linli.3，日期 2026-09-05。程序版本固定为 2008.2.7，请同时核对 Release 标签。
• R10.1 发布页 · 安装版 Setup · 便携版 Portable · SHA-256 校验。
• Windows x64；未配置代码签名，系统可能显示“未知发布者”。请核对下载来源与哈希，不要关闭安全软件。

R10.1 压力测试修复

• 修复本地作品自动切到较短的官方歌曲时，旧进度变成拖动指令、直接跳到结尾而反复切歌的问题；单曲重播同样从零开始。
• 同一播放会话的结束通知去重；状态查询一次只保留一个请求，超时取消，无本地会话时不继续查询。
• FE 补丁升级到 v32，同时保留备份验证、停用与卸载恢复能力；不改变循环模式、曲名/时段绑定和暂停回默认壁纸逻辑。
• **闪退边界：**压力测试中另捕获到 Chromium 内存分配失败（0xE0000008）。尚未确认内存压力来源，本版不宣称所有内存闪退已解决。请勿通过删除数据或关闭安全软件处理。

保留 R10 重点功能

• 恢复游戏角色旁的写信、音乐小组件及信箱入口；补齐 0.0.9.627 客户端原生隐藏判断的修复，只有网页补丁时不再误报完整挂载。
• 修复用户上传作品的媒体绑定、播单自动切换约 2 秒中断、播放进度和结束状态；暂停/停止恢复默认壁纸。
• 统一前后台作品预览、名称与时段编辑，支持永久曲名纠错；仅改名不改变原视频和时段绑定。
• 修复服务启停、备份恢复、映射网络盘执行和托盘退出；安装版卸载前安全恢复已登记客户端补丁。
• 新安装使用中性模型配置；升级保留自己的 UserData，可单独清除模型配置。修复页面缓存与窄窗口布局。

旧版升级必读：先关闭游戏和 OliviaSoul，备份 UserData，覆盖安装到原目录；然后启动 OliviaSoul，在“客户端与桌面”重新启用服务或更新客户端补丁，再从 Steam 启动游戏。仅安装新版不会自动补齐游戏里的旧补丁。 不承诺任意后续游戏版本兼容，提示不兼容时请反馈。

完整说明：使用说明 · 本次更新内容 · Bug 与功能反馈。

快速开始

1. 安装 Windows x64 安装包，或将便携包完整解压到独立、可写的目录。**不要放进游戏目录，不要直接在 ZIP 内运行，也不要同时运行安装版和便携版。**不需要另装 Node.js 或运行 npm。
2. 打开 OliviaSoul，等待本机服务就绪。“AI 模型”中选择远程/本地兼容 API，填写自己的地址及鉴权信息，点击“查询模型列表”，选择模型，再“保存并测试”。检测成功后点击“检测并设为当前模型”才启用。
3. 本地模型服务需要用户自行启动；OliviaSoul 不负责启动 Ollama、LM Studio 等程序。仅导入/播放已有作品不需要 AI 生成视频。
4. 先关闭游戏，进入“客户端与桌面”选择正确的游戏 exe，点击“启用服务”，等待明确成功，再从 Steam 启动游戏。后续使用本地功能时，应先开 OliviaSoul 并保持后台运行，再开游戏。
5. “官方作品”中选择包含成品 MP4 的文件夹，点击“扫描预览”，核对可导入/跳过项目后“确认导入”。在游戏曲库的“我的上传”中查看、播放或编辑。
6. 需要歌词时，在“歌词设置”启用；上传作品可在“名称 / 时段”编辑器导入 LRC。同一作品的视频版本默认共享文本、分别保存偏移；游戏底部“词”按钮可随时开关。

R10.7 新增的手动模型名、中转地址及响应兼容处理见 模型与中转 API 兼容说明；配置步骤见 API 配置使用说明。旧的 R10.6 安装包不包含这些改动。

关闭管理窗口会隐藏到托盘；托盘“退出”会立即收起窗口，随后结束后台清理。停用服务是还原游戏客户端的本地接入补丁，不等于退出 OliviaSoul。启用/停用期间不要强制结束程序；若失败，保留报错并反馈。

导入音乐：请先核对内容，再校正名称

玩家上传音乐分享链接

此链接由维护者提供，资源独立于软件安装包，来源致谢见文末。下载可用性及资源内容以分享页为准；软件不会自动下载整套曲库。请仅使用有权使用的媒体，下载后保留作品目录结构，再到“官方作品”扫描预览并确认导入。不要将文件数当作歌曲数，同一歌曲可能有多个时段视频。

导入名称可能来自目录名、分享记录或 library.json，原始整理数据本身可能有错。软件不会听歌识曲，也不能保证导入名称就是视频里的歌曲。

• 在后台“官方作品 → 我的上传”或游戏“我的上传”点击“名称 / 时段”，打开同一套编辑器，展开预览核对歌曲。
• “保存”：修改显示名称。
• “永久保存曲名”：纠正正式名称，并保存内容匹配记录；保留用户数据和同一媒体内容时，重新导入可沿用。不会重命名视频文件、搬动目录或改变视频绑定。
• “恢复正式名称”只撤销显示别名；已永久纠错的名称不会因此退回最初的错误名称。再次永久保存可继续纠正。
• 一首作品的白天、傍晚、夜晚视频是同一作品的变体，只改一次作品名称，不需要给三个视频分别取歌曲名。要确认歌曲可先听一个片段；要确认时段，需要查看各片段画面。
• 对哈希文件名、DEFAULT、ALT_2、ALT_3，不能根据排序猜时段。有明确时段信息时自动匹配；没有明确标记时请在编辑器手动选择白天/傍晚/夜晚。
• 本机时间范围：白天 06:00–16:00；傍晚 16:00–20:00；夜晚 20:00–次日 06:00。保存时段用于下次播放，不强行切换当前演奏。

永久纠错依赖 UserData 中的数据库和纠错记录，不是上传到云端的曲名库。换电脑应备份完整 UserData；不要只保留 MP4 后删除全部用户数据。

路径、备份与注意事项

• 默认引用导入目录，不自动搬走或统一复制视频。请保留源文件；若文件夹改名或位置改变，应重新扫描并确认导入，以核验内容并补记来源。移动硬盘/网络盘需保持可访问。
• 只读获取游戏保存路径；修改游戏路径不等于自动迁移旧视频。需要迁移时，在“客户端与桌面”先预览、核对空间，再明确确认；迁移成功后使用迁移位置，来源文件保留。
• 数据位于 <安装目录>\UserData\；信件数据库在 database\olivia-local.sqlite，可读档案在 信件往来\。视频可能仍在外部引用目录，应一并备份。
• 升级前从托盘完全退出，备份 UserData；在同一目录升级，保留 UserData。不建议卸载后再安装来升级。旧 C 盘版本的数据位置可能不同，请先导出/备份。
• .soul 导入是覆盖式恢复，会替换当前记忆、摘要和关联视频，请先导出备份。它不等于完整的作品库及所有设置备份。
• 每日写信默认 3 封，用户可设置整数 0–999；0 表示当天不能写信，不是无限次数。升级保留已保存的数量。
• 缺少 WebView2 Runtime 时，首次启动可能需要联网安装微软运行时。包内已有 Node.js、FFmpeg、whisper.cpp 和 Whisper small；首次预览大视频或从网络盘读取可能较慢。
• 对映射网络盘游戏路径，请正常启动 OliviaSoul，不要手动改为管理员运行；提权上下文可能看不到原盘符。启停前请关闭游戏。
• 游戏原有暂停/停止入口仍结束当前演奏并回到默认壁纸；歌词工具栏的暂停/继续则保留当前演奏进度与歌词。播单内自然结束按当前播放模式推进；不在播单的单独播放结束后退出演奏。
• 没有 MIDI 上传、MIDI 视频生成、FluidSynth/Godot 琴键渲染或自动人物演奏。“定制演奏”隐藏；只有 MIDI、没有有效成品 MP4 的目录会跳过。

隐私与反馈

公开包不应包含个人密钥、信件、数据库、日志、账号 Cookie 或曲库。使用远程 AI 时，相关信件/记忆/转写文本会按功能发送到用户配置的接口；“本地数据保存”不等于所有 AI 请求都离线。不要公开上传完整 UserData 或 .soul 文件。

升级与卸载

• 升级：退出游戏和托盘程序，备份整个 UserData 与外部媒体，运行新安装包并沿用原安装目录，无需先卸载。
• 安装版卸载：先退出游戏、Steam 和 OliviaSoul，再通过 Windows“已安装的应用”卸载，或运行安装目录内的 unins000.exe。
• 卸载器会预检并恢复已登记、可验证的客户端网页、播放器、受支持 DLL 补丁和严格匹配的 Steam 启动项；不修改游戏 usersettings.dat。
• 路径失效、备份不可信、文件后来被改动或权限不足时，卸载中止并保留恢复材料。不要强行删除安装目录；解决提示后重试。
• UserData 默认保留，外部来源视频不会被删除。便携版无安装式卸载器，请先逐个停用曾挂载的客户端并恢复使用过的 Steam 启动衔接，再移除程序目录。

Bug 与功能建议

欢迎在 GitHub Issues 积极反馈 Bug，也欢迎提出希望更新的功能。请附版本和构建日期、复现步骤、预期/实际结果、脱敏截图及相关日志片段。音乐问题请区分“原视频内容本来就不对”和“点击作品后播放了另一个文件”；不必公开上传整首视频。详细模板见反馈指南。

开发说明

使用已有打包脚本生成新的空输出目录；构建依赖包含 .NET、Node.js 与 Inno Setup。开发命令使用 npm.cmd 可避免 PowerShell 将 npm 解析到受执行策略限制的 npm.ps1。

Set-Location .\source\local-service
npm.cmd install
npm.cmd test
npm.cmd run build:win

本项目基于 yilangren/OliviaSoul 继续维护，不隶属于游戏官方。请仅使用你有权访问和使用的游戏、媒体及数据，并保留第三方许可说明。

致谢

• Clouly——开源项目《OliviaSoul》
• 挥手-再见——玩家上传歌曲库

感谢参与测试、提交 Bug 和提出改进建议的朋友。