@ljwei-stak/model-router-galgame 0.10.1 → 0.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.dsh-plugin/client.js +2 -2
- package/INSTALLATION_GUIDE.zh.md +77 -72
- package/README.md +55 -24
- package/README.zh.md +52 -23
- package/aipicture/story-backgrounds/README.md +16 -0
- package/aipicture/story-backgrounds/model-city-title.webp +0 -0
- package/docs/ECHO_CITY_STORY.zh.md +7 -5
- package/docs/GAL_ART_SOURCES.zh.md +2 -0
- package/docs/GAL_SETTINGS.zh.md +211 -0
- package/docs/assets/candidate-pruning.svg +80 -0
- package/docs/assets/desktop-official-tools-0.9.0.png +0 -0
- package/docs/assets/gal-fullbody-0.11.0-preview.jpg +0 -0
- package/docs/assets/gal-official-fullbody-0.11.0.jpg +0 -0
- package/docs/assets/gal-official-rc2-0.11.0.jpg +0 -0
- package/docs/assets/gal-settings-0.11.0-preview.jpg +0 -0
- package/docs/assets/gal-title-0.11.0-preview.jpg +0 -0
- package/docs/assets/routing-workflow.svg +96 -0
- package/docs/assets/workbench-usage.svg +119 -0
- package/package.json +70 -59
package/.dsh-plugin/client.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
[diffend] Oversized file quarantined before diffing.
|
|
2
2
|
name: package/.dsh-plugin/client.js
|
|
3
|
-
size:
|
|
4
|
-
sha256:
|
|
3
|
+
size: 57234430 bytes
|
|
4
|
+
sha256: 3408d5989501efa0d7c28c0845c8a3f2b553014fcd4a5e76d9fb0df9016d7924
|
package/INSTALLATION_GUIDE.zh.md
CHANGED
|
@@ -1,114 +1,119 @@
|
|
|
1
1
|
# DeepSeek Harness Desktop 插件安装与验证
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> **当前版本为 0.11.1。** 从 [GitHub Release](https://github.com/Alice-Marx/model-router-galgame/releases/tag/v0.11.1) 下载 `.tgz` 并安装。npm `latest` 仍是旧版 0.4.32，因此不要省略版本号；npm 的 0.11.1 发布状态与最终安装源见[本轮总项目报告](https://github.com/Alice-Marx/model-router-galgame/blob/main/PROJECT-TASK-REPORT-2026-10-02-NPM-RELEASE-AND-README-FIX.md)。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
[README](README.zh.md) · [Gal 设置与播放器详细教程](docs/GAL_SETTINGS.zh.md) · [五剧目玩法](docs/ECHO_CITY_STORY.zh.md)
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
## 1. 先核对版本
|
|
8
|
+
|
|
9
|
+
| 插件版本 | 状态 | 声明的 DSH 依赖 | 如何使用 |
|
|
8
10
|
| --- | --- | --- | --- |
|
|
9
|
-
| **0.
|
|
10
|
-
| **0.
|
|
11
|
-
| 0.
|
|
12
|
-
| 0.
|
|
11
|
+
| **0.11.1** | 当前 GitHub 版；npm 上传待完成 | `0.2.0-rc.1 \|\| 0.2.0-rc.2` | 0.11.0 运行时与 Gal 功能；修复 README 与发布说明。 |
|
|
12
|
+
| **0.11.0** | 前一 npm / GitHub 发布版 | `0.2.0-rc.1 \|\| 0.2.0-rc.2` | 运行时相同，但 npm README 元数据缺失、包内说明过时；建议安装 0.11.1。 |
|
|
13
|
+
| **0.10.2** | 历史本地兼容修复，未发布 | `0.2.0-rc.1 \|\| 0.2.0-rc.2` | 官方 rc.2 运行时隔离安装已验证；兼容修复由 0.11.1 保留。 |
|
|
14
|
+
| **0.10.1** | 已发布 npm / GitHub 预发布 | `0.2.0-rc.1` | 只适配 rc.1；rc.2 管理器拒绝安装。 |
|
|
15
|
+
| **0.9.0** | 已发布历史版本 | `0.2.0-rc.1` | 历史兼容版，缺少后续 Gal 更新。 |
|
|
16
|
+
| 0.8.0 | 已发布历史版本 | `0.1.7-rc.2` | 与当前 0.2.0 系列桌面版不兼容。 |
|
|
17
|
+
| 0.4.32 | 旧版 npm `latest` 标签记录 | 旧 `dsh-settings` 依赖范围 | 裸包名可能选中旧版；当前安装必须指定 `@0.11.1`。 |
|
|
13
18
|
|
|
14
|
-
|
|
19
|
+
在官方桌面插件页核对宿主的完整版本，包括 `rc` 后缀。0.10.1 在 rc.2 的错误来自依赖范围，换 npm 镜像不能修复。0.11.1 支持 rc.1 与 rc.2；保留桌面程序与 profile，不必改 `app.asar` 或绕过版本检查。
|
|
15
20
|
|
|
16
|
-
## 安装 0.
|
|
21
|
+
## 2. 安装 0.11.1
|
|
17
22
|
|
|
18
|
-
1.
|
|
23
|
+
1. 打开 **DeepSeek Harness Desktop → 插件 → 添加插件**。
|
|
24
|
+
2. 从 [v0.11.1 Release](https://github.com/Alice-Marx/model-router-galgame/releases/download/v0.11.1/ljwei-stak-model-router-galgame-0.11.1.tgz) 下载 `.tgz`。在“包名、GitHub 仓库地址或本地目录路径”输入框填写该文件的绝对路径；若 npm 注册表已列出该版，也可以输入完整包名：
|
|
19
25
|
|
|
20
26
|
```text
|
|
21
|
-
@ljwei-stak/model-router-galgame@0.
|
|
27
|
+
@ljwei-stak/model-router-galgame@0.11.1
|
|
22
28
|
```
|
|
23
29
|
|
|
24
|
-
|
|
25
|
-
|
|
30
|
+
3. 本地安装包可放在 D 盘等自选位置；若精确 npm 版本不可用，先使用 GitHub Release 文件，不要改选裸包名。
|
|
31
|
+
4. 确认安装预览显示 **0.11.1**，没有宿主不兼容提示，安装并启用。出现重启提示时再重启桌面程序。
|
|
32
|
+
5. 核对侧边栏出现 **模型路由** 和 **Gal 模块**。进入 Gal 先显示 **标题画面**，可选择剧目、开始新故事或继续；另有 **剧情模式 · Gal 视图、自由模式、素材鉴赏**，上方有 **Gal 设置** 与 **开启音乐**。
|
|
26
33
|
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
34
|
+
若交付附带 `.sha256` 文件，用 PowerShell 计算安装包摘要并与交付校验文件比较：
|
|
35
|
+
|
|
36
|
+
```powershell
|
|
37
|
+
Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Plugins\ljwei-stak-model-router-galgame-0.11.1.tgz'
|
|
38
|
+
```
|
|
30
39
|
|
|
31
|
-
|
|
32
|
-
3. 确认插件详情显示 **0.10.1** 且无宿主不兼容提示，点击安装并启用；若提示重启则重启。已装旧版时，先在插件页禁用重复的旧实例。左侧应出现 **模型路由** 和 **Gal 模块**。不要手工改动应用安装目录、`app.asar` 或 profile 文件。
|
|
33
|
-
4. 进入 **Gal 模块 → 剧情模式 · Gal 视图**，核对五个剧目和立绘。安装后的逐项验证见下方清单；这一步仍须用户在官方桌面实装确认。
|
|
40
|
+
普通使用无需 `npm install -g`：全局 npm 安装不会注册到当前 Harness profile。也可解压 `.tgz`，再填写内层含 `package.json` 和 `.dsh-plugin` 的 `package` 目录绝对路径。安装文件可放在自选盘；运行时的数据目录仍由宿主 profile 决定。
|
|
34
41
|
|
|
35
|
-
|
|
42
|
+
### 已有同名旧版时
|
|
36
43
|
|
|
37
|
-
|
|
44
|
+
先在旧版导出当前剧情，或保留手动存档并备份 profile 数据。依插件管理器升级指引更新到 0.11.1；若同名插件被管理器判为已安装，按其升级指引替换旧实例。保留 profile 和应用数据，旧手动槽沿用原键读取。无需移除其他插件。
|
|
38
45
|
|
|
39
|
-
###
|
|
46
|
+
### 版本选择与旧包说明
|
|
40
47
|
|
|
41
|
-
|
|
48
|
+
始终使用完整包名：
|
|
42
49
|
|
|
43
50
|
```text
|
|
44
|
-
@ljwei-stak/model-router-galgame@0.
|
|
51
|
+
@ljwei-stak/model-router-galgame@0.11.1
|
|
45
52
|
```
|
|
46
53
|
|
|
47
|
-
|
|
54
|
+
**不要省略版本号。** npm `latest` 标签当前仍指向 0.4.32。只有在注册表列出 0.11.1 后才从 npm 安装；0.11.0 缺少 npm README 元数据，0.11.1 修正了包内文档。历史 0.10.1 只适配 rc.1，不能用于 rc.2。
|
|
48
55
|
|
|
49
|
-
|
|
56
|
+
## 3. 初次使用 Gal：先调立绘，再开音乐
|
|
50
57
|
|
|
51
|
-
|
|
58
|
+
1. **Gal 模块 → 剧情模式 · Gal 视图**，选择剧目。
|
|
59
|
+
2. **Gal 设置 → 立绘 · 大小与位置**，默认选 **完整全身原画**，先选 **主角色默认** 调缩放、水平位置和距底部距离，再选 **同伴默认** 调第二位人物。舞台会预留对话框空间；默认比例下脚部可见。想用旧六表情半身图时再改选 **表情特写**。
|
|
60
|
+
3. 单个角色仍不协调时，选 **角色名 · 单独设置**。只覆写该角色；其他角色继续使用默认值。预览随滑块变化，设置立即生效并保存于当前 profile。
|
|
61
|
+
4. **音乐与音效**选“跟随剧情”或内置曲目，点击 **开启音乐**。首次播放须用户点击；背景音乐与音效各调音量，**全部静音**控制两者。背景音量 0 时无背景音乐，音效音量 0 时无操作音效。
|
|
62
|
+
5. **选择本地音乐**支持本机可识别音频，最多 **30 MB**。文件不上传，仅当前插件会话使用，刷新或重新打开需重选。
|
|
63
|
+
6. **文字与阅读**调逐字间隔、字号、自动阅读等待和不透明度。工具栏 **自动阅读**和 **已读快进**遇选项、命名和结局停止，由用户决定。
|
|
64
|
+
7. 跨设备或升级前点击 **导出存档**下载 JSON。手动三槽、快捷存档和自动保存各有用途，详见[完整教程](docs/GAL_SETTINGS.zh.md)。
|
|
52
65
|
|
|
53
|
-
|
|
54
|
-
D:\Plugins\ljwei-stak-model-router-galgame-0.9.0.tgz
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
这里的 `D:\Plugins\` 只是示例，实际输入须与文件所在位置一致。官方插件管理器支持本地 `.tgz` 路径。发布包的 SHA-256 为 `FB06ED5527DE256062BB932EF5A35AF8FF9BEB8B6D2B3F635E2F30D0736A8E4B`；需要核对下载文件时，可在 PowerShell 运行 `Get-FileHash -Algorithm SHA256 -LiteralPath "D:\Plugins\ljwei-stak-model-router-galgame-0.9.0.tgz"`（按实际路径替换）。
|
|
66
|
+
本轮使用既有资源。下图为 **0.11.0 运行时代码的组件本地浏览器预览**，展示完整 Claude 原稿的布局预览与音乐设置；0.11.1 保留相同 Gal 界面：
|
|
58
67
|
|
|
59
|
-
|
|
68
|
+
|
|
60
69
|
|
|
61
|
-
|
|
70
|
+
*当前插件组件预览；不是用户官方桌面 profile 的安装结果。标题和舞台截图及逐控件说明见[播放器教程](docs/GAL_SETTINGS.zh.md)。*
|
|
62
71
|
|
|
63
|
-
|
|
64
|
-
git clone https://github.com/Alice-Marx/model-router-galgame.git
|
|
65
|
-
Set-Location model-router-galgame
|
|
66
|
-
git checkout v0.9.0
|
|
67
|
-
pnpm install --frozen-lockfile
|
|
68
|
-
npm run build:client
|
|
69
|
-
New-Item -ItemType Directory -Force dist | Out-Null
|
|
70
|
-
npm pack --pack-destination dist
|
|
71
|
-
```
|
|
72
|
+
## 4. 五部剧目与存档兼容
|
|
72
73
|
|
|
73
|
-
|
|
74
|
+
剧目下拉包括 **千桥协议、旧城迁移篇、雪灯来信、未寄出的春天、回声之城·正篇**。短篇、后日谈与正篇是不同剧目。正篇含共通八章、六条主线、隐藏线和 TRUE END，只有王女线有真／暗双结局；详情见[五剧目玩法](docs/ECHO_CITY_STORY.zh.md)。
|
|
74
75
|
|
|
75
|
-
|
|
76
|
+
自动进度与快捷存档按剧目独立。**千桥协议与旧城迁移篇沿用历史共用三槽**，读档会校验剧目；其他三部各有独立手动三槽。导出 JSON 备份当前剧情路径，不包含所有手动槽、立绘设置、已读记录或本地音乐。导入前先切到文件所属剧目，文件最多 **2 MB**；确认后替换当前自动进度，其他手动槽保留。
|
|
76
77
|
|
|
77
|
-
|
|
78
|
+
旧剧目、短篇和春篇直接进入章节会重新建立该章状态；正篇切章节保留本周目选择与好感。春篇修订版 1 的旧存档可读，不会凭空增加新选择旗标。体验新选择时先备份，再从开篇重新开始。清理 profile 或应用数据可能删除本地存档。
|
|
78
79
|
|
|
79
|
-
|
|
80
|
+
## 5. 模型路由与真实账号
|
|
80
81
|
|
|
81
|
-
|
|
82
|
+
1. 官方 **模型**页配置供应商、模型与凭据。插件读取准确 `provider/model` 目录，不另存 API Key。路线可填质量分数、USD/百万 token 单价和可选 `cliModel`；缺价显示“价格待配置”。
|
|
83
|
+
2. **模型路由**生成单任务或团队计划，查看每包难度、路线、依赖、渠道和估价。规划本地完成，不启动付费模型。
|
|
84
|
+
3. **官方工具**卡片提供固定来源探测、安装或修复、取消及日志。ZCode 使用原厂安装窗口，选目录并完成后再检测。工具就绪只证明本地可信入口通过检查。
|
|
85
|
+
4. 官方会话调用 `model_router_consult`、`model_router_tool_run` 或 `model_router_team_execute` 执行。可编辑任务需要干净 Git 仓库和宿主工具审批，先在测试仓库核对隔离工作区与补丁整合。
|
|
86
|
+
5. Gal **自由模式**发送消息是真实模型调用，可能产生费用。“停止生成”请求取消当前回复；复制开场提示词可交官方会话。登录、模型身份、计费和回复质量仍由账号持有人验收。
|
|
82
87
|
|
|
83
|
-
|
|
88
|
+
Claude、Codex、MiMo、Grok 支持只读或可编辑；Kimi、MiniMax、ZCode 的无界面模式只在获批的隔离可编辑工作区运行。CLI 模型名可能不同于 Harness 目录，可用 `cliModel` 或临时 `cliModelsJson` 映射；多数 CLI 不返回可核验的实际模型 ID，需看厂商记录。
|
|
84
89
|
|
|
85
|
-
|
|
90
|
+
希望官方 CLI 尽量装在非 C 盘时，先配置 npm 全局前缀。MiniMax Windows npm 原生依赖失败时，插件使用已审核、锁定哈希的官方脚本安装固定版本；内容变化会拒绝执行。Grok 使用非 C 盘 npm 目录时优先把原生程序和登录数据放入 `.model-router-grok`，独立终端登录需使用同一 `GROK_HOME`。
|
|
86
91
|
|
|
87
|
-
|
|
92
|
+
## 6. 安装后验收清单
|
|
88
93
|
|
|
89
|
-
|
|
94
|
+
| 检查 | 预期 |
|
|
95
|
+
| --- | --- |
|
|
96
|
+
| 版本与入口 | 详情为 0.11.1，rc.1 / rc.2 通过 peer 检查，两侧边栏入口可见。 |
|
|
97
|
+
| 标题菜单 | 选择剧目后开始或继续该剧目；新故事替换自动进度前确认；手动槽和快捷档保留。 |
|
|
98
|
+
| 立绘 | 默认完整全身，头、裙摆与脚部可见；全屏与窄窗口重新计算；主角、同伴和单独角色各自调节，刷新保留。 |
|
|
99
|
+
| 音频 | 首次点击播放；七首可切换；音量 0、全部静音有效；本地文件不上传，重开需重选。 |
|
|
100
|
+
| 阅读 | 自动等整句显示后推进；已读快进遇未读停；选项、命名、结局需人工操作；设置窗口或后台暂停阅读。 |
|
|
101
|
+
| 快捷键 | 点舞台空白处获取焦点；输入名字和操作表单时按键仍用于表单。 |
|
|
102
|
+
| 存档 | 三槽、快捷存档、JSON 导入导出；跨剧目拒绝；损坏槽原数据保留。 |
|
|
103
|
+
| 素材鉴赏 | 人物与场景可浏览，全部开放；缺表情回退基础图，可能含剧透。 |
|
|
104
|
+
| 自由与执行 | 用户真实账号核对回复、取消、CLI 实际模型与计费，独立于离线播放器测试。 |
|
|
90
105
|
|
|
91
|
-
|
|
106
|
+
0.11.1 沿用通过 **153 项主测试与 75 项额外剧情／游戏测试（共 228 项）**的 0.11.0 运行时。本轮重新核对 README 在包内的内容、npm 页面元数据、扫描状态及 npm / GitHub 安装包校验值。Gal 播放器隔离运行检查见 [Gal 播放器报告](PROJECT-TASK-REPORT-2026-10-01-GAL-PLAYER.md)，完整发布记录见 [0.11.1 项目报告](PROJECT-TASK-REPORT-2026-10-02-NPM-RELEASE-AND-README-FIX.md)。用户当前桌面 profile、真实登录、模型身份与费用仍需账号持有人验收。
|
|
92
107
|
|
|
93
|
-
|
|
94
|
-
2. 左侧打开**模型路由**：确认目录出现，输入任务生成单任务或团队计划，核对每个工作包的难度、路线和依赖；点击**官方工具**卡片可按固定官方来源下载安装、取消下载、查看日志与执行入口状态。若版本横幅已是目标版本、但安全校验找不到官方执行入口，点“修复官方执行入口”会按固定包重新安装。前六家使用固定 npm 包；ZCode 会打开已验签的官方安装窗口，选择 D 盘目录并完成安装后再点“重新检测”。取消正在进行的 npm 安装后也应重新检测实际版本。
|
|
95
|
-
3. 在官方会话调用 `model_router_consult` 获取另一模型意见。调用 `model_router_tool_run` 执行单个已适配官方工具；复杂任务可调用 `model_router_team_execute`。Claude、Codex、MiMo、Grok 可选只读或可编辑；Kimi、MiniMax、ZCode 的无界面执行只允许可编辑隔离工作区。可编辑模式需要干净 Git 仓库，先在独立工作区编辑，全部成功后应用补丁，并经过官方工具审批。
|
|
96
|
-
若单工具调用要指定厂商 CLI 里的准确模型名，同时传入官方目录的 `provider`/`model` 与 CLI 自身的 `cliModel`；MiniMax/MiMo 用 `provider/model` 格式。未提供时按下方默认模型规则执行。
|
|
97
|
-
团队任务请逐条列出具体需求；如需临时指定每家 CLI 或每个工作包的准确模型，可给 `model_router_team_execute` 传 `cliModelsJson`。格式如 `{"minimax-code":"minimax/your-configured-model"}`，实际调用时换成该 CLI 中已配置名称。先用 `model_router_plan` 查看工作包 ID，再按 ID 精确覆盖；临时工作包设置 > 临时工具设置 > 保存的路线映射。ZCode 无逐次切换模型能力。
|
|
98
|
-
4. 左侧打开**Gal 模块**：剧情模式可离线游玩与存档；自由模式从官方目录选路线，在面板发送消息会发生真实模型调用并可能产生费用，可用“停止生成”中断当前请求，也可复制开场提示词到官方会话。
|
|
108
|
+
## 7. 从 0.11.1 发布源码打包（开发者）
|
|
99
109
|
|
|
100
|
-
|
|
110
|
+
检出 `v0.11.1` 标签，使用 Node.js 22.19+ 与 pnpm：
|
|
101
111
|
|
|
102
|
-
|
|
112
|
+
```powershell
|
|
113
|
+
Set-Location 'F:\everyAI\all\model-router-galgame'
|
|
114
|
+
pnpm install --frozen-lockfile
|
|
115
|
+
npm run build:client
|
|
116
|
+
npm pack --pack-destination dist
|
|
117
|
+
```
|
|
103
118
|
|
|
104
|
-
|
|
105
|
-
| --- | --- |
|
|
106
|
-
| 插件启用 | 插件详情为 **0.10.1**，左侧出现“模型路由”和“Gal 模块”，无 DSH 0.2.0-rc.1 不兼容提示；若选择旧发布包，详情应为 0.9.0。 |
|
|
107
|
-
| 官方工具 | 七张工具卡显示状态；点击下载、取消和重试后确认真实探测版本及执行入口就绪状态；ZCode 须在原厂安装窗口完成安装。 |
|
|
108
|
-
| 本地规划 | 单任务与团队模式都能显示复杂度、每包难度、路线、渠道、依赖；完整填写单价时才显示费用，缺价时显示“价格待配置”。用简单与困难任务核对不同模型分配。 |
|
|
109
|
-
| Gal 剧情 | 0.10.1 的五部剧目、章节、选项、历史、结局和独立三槽可用；核对正篇连续章节旗标与好感、春篇修订版 2 的新选项/有条件结局、28 原稿基础图、27 套六表情与双人物同场、六幅新背景。JEV 应有基础图，但不应被误列为剧情出场或有六表情。 |
|
|
110
|
-
| Gal 自由 | 用户自行配置的模型可回复首轮和续轮消息；停止生成会取消当前请求，切换模型/角色会清空旧对话并请求取消旧回复。 |
|
|
111
|
-
| CLI 执行 | 已登录账号下逐家调用，核对实际模型、结构化终态与权限；可编辑任务先在干净测试仓库核对独立工作区与补丁整合。 |
|
|
112
|
-
| 团队执行 | 在测试仓库验证多工作包依赖、失败停止、取消、模型 ID 不受厂商接受时的错误。 |
|
|
113
|
-
|
|
114
|
-
真实账号、付费模型及 CLI 授权仍需由账号持有人操作并核对；每家模型名、实际计费和完整任务质量以厂商运行记录及用户验收为准。
|
|
119
|
+
开发验证另运行 `npm test`、`npm run check:client` 和 `pnpm peers check`。用 `git checkout v0.11.1` 获取当前完整源码。把生成包的绝对路径填入官方插件管理器。
|
package/README.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
# Model Router Galgame
|
|
2
2
|
|
|
3
|
+
> **Current release: 0.11.1.** Use the versioned [GitHub release archive](https://github.com/Alice-Marx/model-router-galgame/releases/tag/v0.11.1), or enter `@ljwei-stak/model-router-galgame@0.11.1` in the Desktop plugin manager if the npm registry has synchronized it. npm's `latest` tag remains on 0.4.32, so always specify the exact version. Version 0.11.1 keeps the 0.11.0 runtime and corrects release documentation; the old 0.11.0 npm page lacks README metadata. Live model sign-in and billing remain account-holder checks.
|
|
4
|
+
|
|
3
5
|
**A model routing and Galgame plugin for DeepSeek Harness Desktop.** It plans which of your configured models should handle a task, gives simpler work to an affordable capable route, and reserves stronger routes for difficult work. Compound requests become dependent work packages that can be run through supported official vendor tools.
|
|
4
6
|
|
|
5
|
-
[简体中文说明](README.zh.md) · [Installation guide (Chinese)](INSTALLATION_GUIDE.zh.md) · [v0.10.1
|
|
7
|
+
[简体中文说明](README.zh.md) · [Installation guide (Chinese)](INSTALLATION_GUIDE.zh.md) · [Gal settings guide (Chinese)](docs/GAL_SETTINGS.zh.md) · [Previously published v0.10.1](https://github.com/Alice-Marx/model-router-galgame/releases/tag/v0.10.1)
|
|
6
8
|
|
|
7
|
-
> **
|
|
9
|
+
> **Host compatibility:** 0.11.1 and 0.11.0 support DeepSeek Harness Desktop **0.2.0-rc.1 and 0.2.0-rc.2**. Version 0.10.2 is an unpublished local compatibility build. Published 0.10.1 accepts only rc.1 and is rejected on rc.2. The 0.11.x Gal controls reuse the five existing stories and artwork; 0.11.1 is a documentation and npm metadata correction, not a new story or artwork release.
|
|
8
10
|
|
|
9
11
|
|
|
10
12
|
|
|
@@ -18,7 +20,7 @@
|
|
|
18
20
|
| **Model profiles** | Lets you enter your own 0–100 quality score, USD input/output price per million tokens, specialties, and an optional vendor CLI model name for an exact Harness route. Missing prices remain unknown. |
|
|
19
21
|
| **Official tools** | Detects and offers one-click, fixed-source installation for Kimi Code, Claude Code, Codex CLI, MiniMax Code, MiMo Code, Grok Build, and ZCode. The panel shows installation and trusted launch readiness separately. |
|
|
20
22
|
| **Execution** | Session tools can consult another configured Harness model, run one supported official CLI, or execute a sequence of dependent work packages with the CLI team runner. |
|
|
21
|
-
| **Gal Module** |
|
|
23
|
+
| **Gal Module** | Five offline stories, portrait size/position settings, seven music loops and session-only local audio, automatic reading and read-only skipping, three manual slots, an independent quick save, JSON backups, and an open artwork gallery. Free mode can chat through a configured Harness model or copy a roleplay opening prompt. |
|
|
22
24
|
|
|
23
25
|
|
|
24
26
|
|
|
@@ -28,24 +30,33 @@
|
|
|
28
30
|
|
|
29
31
|
| Plugin version | Intended host | Install status |
|
|
30
32
|
| --- | --- | --- |
|
|
31
|
-
| **0.
|
|
33
|
+
| **0.11.1** | **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2** | Versioned GitHub release archive; use the exact npm version only when the registry reports it available. |
|
|
34
|
+
| **0.11.0** | **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2** | Previous release; runtime is the same, but its npm README metadata is missing and its bundled README is stale. Use 0.11.1. |
|
|
35
|
+
| **0.10.2** | **DeepSeek Harness Desktop 0.2.0-rc.1 / 0.2.0-rc.2** | Historical local compatibility fix, verified in an isolated official rc.2 runtime; not published. |
|
|
36
|
+
| **0.10.1** | **DeepSeek Harness Desktop 0.2.0-rc.1 only** | Historical prerelease; the Desktop plugin manager rejects it on rc.2. |
|
|
32
37
|
| **0.9.0** | **DeepSeek Harness Desktop 0.2.0-rc.1** | Previously published on npm and GitHub. This older build lacks the new Gal content. |
|
|
33
38
|
| **0.8.0** | DSH 0.1.7-rc.2 dependencies | Incompatible with Desktop 0.2.0-rc.1; the Desktop plugin manager rejects it. |
|
|
34
39
|
| **0.4.32** | Legacy `@deepseek-ai/dsh-settings` peer range `^0.1.1-rc.1 \|\| ^0.1.2-rc.1 \|\| ^0.1.5-rc.1` | Still carries npm's `latest` tag as of 2026-09-29. Installing without an explicit version can select this older package; this row does not claim every older Desktop build was tested. |
|
|
35
40
|
|
|
36
|
-
### Install 0.
|
|
41
|
+
### Install 0.11.1
|
|
37
42
|
|
|
38
|
-
|
|
43
|
+
In DeepSeek Harness Desktop, open **Plugins → Add plugin**. The versioned GitHub `.tgz` archive is the reliable source; download it from the [v0.11.1 release](https://github.com/Alice-Marx/model-router-galgame/releases/download/v0.11.1/ljwei-stak-model-router-galgame-0.11.1.tgz) and enter its absolute path. If the npm registry has synchronized 0.11.1, you can instead enter:
|
|
39
44
|
|
|
40
45
|
```text
|
|
41
|
-
@ljwei-stak/model-router-galgame@0.
|
|
46
|
+
@ljwei-stak/model-router-galgame@0.11.1
|
|
42
47
|
```
|
|
43
48
|
|
|
44
|
-
|
|
49
|
+
If the exact npm version is unavailable, choose the official HTTPS source `https://registry.npmjs.org/` or use the GitHub release archive. Install, enable, and restart if prompted. Confirm plugin details show **0.11.1**, the host is **0.2.0-rc.1 or 0.2.0-rc.2**, and the sidebar shows **Model Router** and **Gal Module**. Global `npm install -g` does not register a plugin in your Desktop profile.
|
|
50
|
+
|
|
51
|
+
### Upgrading an existing local plugin
|
|
52
|
+
|
|
53
|
+
If no matching plugin is listed under **Installed**, install the 0.11.1 release directly. If a same-named older copy is present, export current story progress when possible and back up your profile data, then follow the plugin manager's instructions to remove the older instance before adding the release. Disabling the old instance may still leave it marked as installed. Preserve the profile and application data. The existing manual save keys remain compatible.
|
|
54
|
+
|
|
55
|
+
You can also extract the archive and enter its inner `package` directory, which contains `package.json` and `.dsh-plugin`. Where a checksum sidecar is supplied, compare it with `Get-FileHash -Algorithm SHA256 -LiteralPath 'D:\Downloads\ljwei-stak-model-router-galgame-0.11.1.tgz'`. Do not work around the old rc.1-only peer rejection by modifying `app.asar` or bypassing the version check.
|
|
45
56
|
|
|
46
|
-
###
|
|
57
|
+
### Pin the version when installing from npm
|
|
47
58
|
|
|
48
|
-
|
|
59
|
+
Use `@ljwei-stak/model-router-galgame@0.11.1` only when the registry lists that exact version. The npm `latest` tag still points to 0.4.32, so a bare package name can select an incompatible older build. Version 0.11.0 is available for history, but use the v0.11.1 GitHub archive if the new npm version is unavailable.
|
|
49
60
|
|
|
50
61
|
### Previously published 0.9.0: install by package name
|
|
51
62
|
|
|
@@ -69,15 +80,13 @@ Get-FileHash 'D:\Downloads\ljwei-stak-model-router-galgame-0.9.0.tgz' -Algorithm
|
|
|
69
80
|
|
|
70
81
|
The published 0.9.0 archive has SHA-256 `FB06ED5527DE256062BB932EF5A35AF8FF9BEB8B6D2B3F635E2F30D0736A8E4B`. Replace the example path with your download path. The npm and GitHub release archives were downloaded and compared byte for byte during publication.
|
|
71
82
|
|
|
72
|
-
###
|
|
83
|
+
### Build the 0.11.1 release from source
|
|
73
84
|
|
|
74
|
-
With Node.js 22.19+ and pnpm installed, run these commands from
|
|
85
|
+
With Node.js 22.19+ and pnpm installed, check out the `v0.11.1` tag and run these commands from the repository root:
|
|
75
86
|
|
|
76
87
|
```powershell
|
|
77
|
-
git checkout v0.10.1
|
|
78
88
|
pnpm install --frozen-lockfile
|
|
79
89
|
npm run build:client
|
|
80
|
-
New-Item -ItemType Directory -Force dist | Out-Null
|
|
81
90
|
npm pack --pack-destination dist
|
|
82
91
|
```
|
|
83
92
|
|
|
@@ -262,7 +271,9 @@ The planned Harness model ID is not necessarily the vendor CLI's model name. A s
|
|
|
262
271
|
|
|
263
272
|
*Story artwork from the plugin's Gal assets; it is not a capture of the running interface.*
|
|
264
273
|
|
|
265
|
-
The **Story** tab runs locally: backgrounds, portraits, dialogue, choices, history, endings, autosave,
|
|
274
|
+
The **Story** tab runs locally: backgrounds, portraits, dialogue, choices, history, endings, autosave, manual slots, quick saves and JSON backups. No model account is needed. Version 0.11.0 retains five episodes:
|
|
275
|
+
|
|
276
|
+
The module opens on a **title menu**. Select an episode and choose **Start new story** or **Continue**; settings, the gallery and Free mode are also available there. The in-stage controls remain available in fullscreen.
|
|
266
277
|
|
|
267
278
|
| Episode in the selector | Scope | Ending distinction |
|
|
268
279
|
| --- | --- | --- |
|
|
@@ -272,24 +283,44 @@ The **Story** tab runs locally: backgrounds, portraits, dialogue, choices, histo
|
|
|
272
283
|
| **未寄出的春天** (The Unsent Spring) | An **independent twelve-chapter sequel** with nine optional character routes. | Five endings. The conditional “letters” ending requires two preserved originals, asking each person for consent, distributed relay, a shared anchor, and at least two completed side routes. |
|
|
273
284
|
| **回声之城·正篇** (Echo City: Main Saga) | Prologue, eight common chapters, six character routes, hidden *Shadow and Self* with the naming night, and a TRUE END. | **Only the ChatGPT/princess route has separate true and dark endings**; completing all six routes and the hidden route unlocks the ensemble TRUE END. |
|
|
274
285
|
|
|
275
|
-
Open **Gal Module → Story mode**, choose an episode, advance the dialogue and select choices. **History** revisits prior lines
|
|
286
|
+
Open **Gal Module → Story mode**, choose an episode, advance the dialogue and select choices. **History** revisits prior lines. **Save 1–3 / Load 1–3** keeps manual checkpoints; Thousand Bridges and Old City Migration retain their historical shared slots, while the three newer episodes have independent slots. A per-episode **Quick save** does not consume those slots. Export a JSON backup before upgrades or moving to another profile; imports accept the same episode, enforce a 2 MB UTF-8 limit, and confirm before replacing current progress.
|
|
287
|
+
|
|
288
|
+
For the short story, Spring, and older episodes, directly entering a chapter starts it with fresh state rather than inheriting earlier choices; play from the beginning to see consequences carry through. The **Main Saga** preserves flags and 14 character-affinity values across sequential chapter changes. Its hidden route requires the DeepSeek/snow route's true ending, a complete transcription of the chapter-four note, and two observations of the steward's daily life. All six character routes and the hidden route are required for the TRUE END. The naming night lets you name the steward; the default is 衔雪.
|
|
289
|
+
|
|
290
|
+
### Portraits, music and reading controls
|
|
291
|
+
|
|
292
|
+
**Full-body original artwork** is the default stage source, using all 28 existing character originals, including the orange-haired Claude supplied by the user. The stage reserves space above dialogue and choices to keep the complete body visible. **Expression close-ups** remain an alternative. Full-body moods use the same original image; dialogue avatars can still change expressions. This update does not add newly painted full-body expression variants.
|
|
293
|
+
|
|
294
|
+
Open **Gal Settings** from the page header or Story toolbar. Adjust **Main character default** and **Companion default** separately, or select a named character to create a size/position override. Scale is 40–180%, horizontal position is 0–100%, and bottom offset is −30–50%. The preview updates immediately and settings are saved to the current profile. Clear a character override to inherit the defaults; resetting all Gal settings preserves story saves and read-node records.
|
|
295
|
+
|
|
296
|
+
Seven built-in music loops play offline after you click **Enable music**. Music and UI effects have separate 0–100% volume controls; zero volume is silent, and **Mute all** covers both. You may select a recognized local audio file up to **30 MB**; it stays on your machine and is available only for the current plugin session, so select it again after reopening. This player has optional UI cues, not voiced character dialogue.
|
|
297
|
+
|
|
298
|
+
Set text interval (0–120 ms; 0 reveals immediately), font size (12–32 px), auto-reading delay (300–10000 ms), and dialogue opacity (20–100%). **Auto read** waits until each line finishes. **Read-text skip** stops at unread content unless you explicitly enable skipping unread text. Both stop at choices, naming inputs and endings; neither chooses branches. Reading pauses while settings, history or confirmation views are open and while the page is hidden. The music background-pause option separately controls music.
|
|
299
|
+
|
|
300
|
+
Click the Story stage's blank area to focus it before using **Enter/Space** to reveal or continue, **A/S** for auto/skip, **H/Escape** to hide/restore the interface, **F** for stage fullscreen, **Q/L** for quick save/load, and **←** for the previous line. Text inputs and controls keep their own keys. Previous-line rollback retains at most **30 steps in this reading session** and is cleared by reopening, switching episodes/chapters, or loading a save.
|
|
301
|
+
|
|
302
|
+
The **Artwork gallery** exposes the existing portraits and scene images from the start, with expression fallbacks and possible spoilers. It is an open asset viewer, not a progression-unlocked CG collection. See the [detailed Chinese player guide](docs/GAL_SETTINGS.zh.md) for every control and recovery step. JSON backups contain current story progress, not the entire profile, settings, music file or all manual slots.
|
|
276
303
|
|
|
277
304
|
Spring content revision 1 saves remain readable in revision 2; loading them does not invent flags for newly added choices. To experience the new **preserve two originals** and **ask each person** choices, manually save old progress in a slot and restart Spring from its opening. Story saves are local to the current Desktop profile and are not cloud backups. The stories use fictional personifications; their dialogue does not establish real product capabilities or prices. See the [Chinese five-story play guide](docs/ECHO_CITY_STORY.zh.md) for chapter and ending details.
|
|
278
305
|
|
|
279
|
-
The **Free** tab uses an officially configured model route for in-panel chat, can stop a pending response, or copies the opening prompt into a Harness session. Free-mode replies are real model calls and may incur charges. The plugin does not store provider credentials.
|
|
306
|
+
The **Free** tab uses an officially configured model route for in-panel chat, can stop a pending response, or copies the opening prompt into a Harness session. Portrait and text settings are shared with Story mode. Free-mode replies are real model calls and may incur charges. The plugin does not store provider credentials; real sign-in, permissions and billing remain user acceptance checks.
|
|
307
|
+
|
|
308
|
+
The existing 0.10.1 artwork collection provides **28 original PNG portraits** for base-image display and Free-mode character selection. **27 story characters × six generated expressions = 162** expression sprites, plus six Echo City backgrounds from that earlier update. JEV has an original base portrait and is selectable in Free mode, but has no story appearance or expression set. Two-person scenes use `cast` and `stageCharacters`. This player update reuses those assets; the [portrait provenance guide](docs/GAL_ART_SOURCES.zh.md) separates originals from generated variants.
|
|
309
|
+
|
|
310
|
+
|
|
280
311
|
|
|
281
|
-
|
|
312
|
+
*The actual 0.11.0 component in a local browser preview: episode selection, new story and continue.*
|
|
282
313
|
|
|
283
|
-
|
|
284
315
|
|
|
285
|
-
*
|
|
316
|
+
*The 0.11.0 archive loaded by the installed official rc.2 runtime in a separate test profile. Full-body art remains above the translucent dialogue box; in-stage controls work in fullscreen.*
|
|
286
317
|
|
|
287
|
-
|
|
288
319
|
|
|
289
|
-
*
|
|
320
|
+
*Claude's complete original portrait with live layout controls, music and reading settings. Title and settings images are local component previews; the stage is from the isolated official rc.2 runtime. The user's current Desktop profile still needs acceptance.*
|
|
290
321
|
|
|
291
322
|
## Verification status and further reading
|
|
292
323
|
|
|
293
|
-
The
|
|
324
|
+
The 0.11.1 package carries the 0.11.0 runtime, which passed **153 main tests and 75 additional story/game tests, 228 in total**, and loaded in a separate profile of the installed official rc.2 runtime. This build passes the 153-test suite, peer checks, client build check, and local archive asset verification. npm upload and registry-side README/security-scan verification remain pending; the report records the timeout. Current-profile installation, live sign-in, model identity and billing remain acceptance checks.
|
|
294
325
|
|
|
295
|
-
The [
|
|
326
|
+
The [0.11.1 release report](https://github.com/Alice-Marx/model-router-galgame/blob/main/PROJECT-TASK-REPORT-2026-10-02-NPM-RELEASE-AND-README-FIX.md) records changed files, publication checks, remaining acceptance work and the follow-up plan. The [Gal player report](PROJECT-TASK-REPORT-2026-10-01-GAL-PLAYER.md) covers runtime behavior; the [rc.2 compatibility report](PROJECT-TASK-REPORT-2026-10-01-RC2-COMPAT.md) covers host validation; and [migration notes](MIGRATION.md) cover older integrations.
|
package/README.zh.md
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
# Model Router Galgame · DeepSeek Harness 桌面插件
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
> **当前版本：0.11.1。** 可从 [v0.11.1 GitHub Release](https://github.com/Alice-Marx/model-router-galgame/releases/tag/v0.11.1) 下载版本化安装包；若 npm 注册表已同步该版本，也可在插件管理器输入完整包名 `@ljwei-stak/model-router-galgame@0.11.1`。npm 的 `latest` 标签仍是 0.4.32，因此必须填写完整版本号。0.11.1 保留 0.11.0 运行时并修正发布说明；旧 0.11.0 的 npm 页面缺少 README 元数据。真实模型登录与费用仍由账号持有人验收。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
[English](README.md) · [安装与验证指南](INSTALLATION_GUIDE.zh.md) · [Gal 设置详细教程](docs/GAL_SETTINGS.zh.md) · [历史已发布 v0.10.1](https://github.com/Alice-Marx/model-router-galgame/releases/tag/v0.10.1)
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
**0.11.1 与 0.11.0 沿用 0.10.2 修复后的依赖范围，声明适配 DeepSeek Harness Desktop 0.2.0-rc.1 和 0.2.0-rc.2。** Gal 模块保留五部剧目：原有《千桥协议》《旧城迁移篇》，独立改编短篇《雪灯来信》，十二章后日谈《未寄出的春天》，以及共通线八章、六条角色主线、隐藏线与 TRUE END 的《回声之城：正篇》。正篇**只有王女线设真／暗双结局**。0.11.0 增加播放器功能，0.11.1 修正文档与发布元数据，未更改运行时。插件还会分析任务复杂度、拆分复合请求，在用户已配置的模型中权衡质量与估计费用；用户明确调用执行工具时才启动对应的官方 CLI。
|
|
8
|
+
|
|
9
|
+
> **宿主兼容性：**0.11.1 与 0.11.0 声明支持 DeepSeek Harness Desktop **0.2.0-rc.1 和 0.2.0-rc.2**。0.10.2 是未发布的本地兼容修复版；已发布的 0.10.1 仅支持 rc.1，rc.2 安装失败是依赖范围不兼容，不是网络故障。0.11.x 沿用五部已有剧情与美术；0.11.1 只修正文档与 npm 元数据。
|
|
8
10
|
|
|
9
11
|
|
|
10
12
|
|
|
@@ -24,16 +26,28 @@
|
|
|
24
26
|
|
|
25
27
|
| DeepSeek Harness Desktop / 宿主依赖 | 插件版本 | 安装说明 |
|
|
26
28
|
| --- | --- | --- |
|
|
27
|
-
| **0.2.0-rc.1** | **0.
|
|
29
|
+
| **0.2.0-rc.1 / 0.2.0-rc.2** | **0.11.1 当前版** | 可从版本化 GitHub Release 安装；npm 请先确认注册表已有精确版本。 |
|
|
30
|
+
| **0.2.0-rc.1 / 0.2.0-rc.2** | **0.11.0 历史发布版** | 运行时代码相同，但 README 发布元数据不完整、包内发布指引过时；请改装 0.11.1。 |
|
|
31
|
+
| **0.2.0-rc.1 / 0.2.0-rc.2** | **0.10.2 本地兼容修复版** | 历史本地交付；官方 rc.2 运行时隔离安装已验证，未发布。 |
|
|
32
|
+
| 0.2.0-rc.1 | 0.10.1（历史已发布预发布） | 仅声明 rc.1 peer；**rc.2 会拒绝安装**，请使用当前 0.11.1。 |
|
|
28
33
|
| **0.2.0-rc.1** | **0.9.0 已发布版** | 历史兼容版；从 npm 指定 `@0.9.0`，不含本轮新增 Gal 内容。 |
|
|
29
34
|
| 0.1.7-rc.2 | 0.8.0 | 历史版本；其宿主 peer 与 0.2.0-rc.1 不兼容。 |
|
|
30
35
|
| 声明的旧 `dsh-settings` 范围：`^0.1.1-rc.1 \|\| ^0.1.2-rc.1 \|\| ^0.1.5-rc.1` | 0.4.32（npm `latest`） | 旧版发布记录；不要凭 `latest` 给 0.2.0-rc.1 安装。 |
|
|
31
36
|
|
|
32
|
-
**安装 0.
|
|
37
|
+
**安装 0.11.1**
|
|
38
|
+
|
|
39
|
+
1. 打开 DeepSeek Harness Desktop → **插件** → **添加插件**。推荐下载 [v0.11.1 GitHub Release](https://github.com/Alice-Marx/model-router-galgame/releases/download/v0.11.1/ljwei-stak-model-router-galgame-0.11.1.tgz)，填写其绝对路径。若 npm 注册表已有该版本，也可输入：
|
|
40
|
+
|
|
41
|
+
```text
|
|
42
|
+
@ljwei-stak/model-router-galgame@0.11.1
|
|
43
|
+
```
|
|
33
44
|
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
45
|
+
2. 若精确 npm 版本暂不可用，选择官方 HTTPS 源 `https://registry.npmjs.org/` 或使用 GitHub Release 安装包；本地包可放在任意磁盘。
|
|
46
|
+
3. 安装、启用插件；如有重启提示则重启。确认详情为 **0.11.1**，左侧出现 **“模型路由”** 与 **“Gal 模块”**。已有同名旧版时，先导出剧情备份，再依插件管理器升级指引更新。**保留 profile 和应用数据**，旧手动存档键仍兼容。
|
|
47
|
+
|
|
48
|
+
旧 0.10.1 的 peer 错误已在 0.10.2 修复，并由 0.11.0 / 0.11.1 保留。不要尝试 `allow-version` 或修改 `app.asar` 绕过版本检查。
|
|
49
|
+
|
|
50
|
+
**版本选择提示**：只有在注册表列出精确版本后，才输入 `@ljwei-stak/model-router-galgame@0.11.1`；不要只填裸包名，因为 npm `latest` 仍指向 0.4.32。若 npm 尚未同步，请使用 v0.11.1 GitHub Release 安装包。
|
|
37
51
|
|
|
38
52
|
**安装此前已发布的 0.9.0（历史版）**
|
|
39
53
|
|
|
@@ -53,19 +67,17 @@
|
|
|
53
67
|
|
|
54
68
|
0.9.0 包的 SHA-256 为 `FB06ED5527DE256062BB932EF5A35AF8FF9BEB8B6D2B3F635E2F30D0736A8E4B`；npm 与 GitHub 重新下载的包已核对为相同字节。旧版不被覆盖或删除。`npm install -g` 只安装 npm 包，**不会**在当前 Harness profile 注册和启用插件；正常使用请走插件管理器。不要修改桌面安装目录或 `app.asar`。
|
|
55
69
|
|
|
56
|
-
|
|
70
|
+
**从发布源码重建（开发者）**
|
|
57
71
|
|
|
58
|
-
开发者安装 Node.js 22.19+ 与 pnpm
|
|
72
|
+
开发者安装 Node.js 22.19+ 与 pnpm 后，检出 `v0.11.1` 标签，在仓库根目录运行：
|
|
59
73
|
|
|
60
74
|
```powershell
|
|
61
|
-
git checkout v0.10.1
|
|
62
75
|
pnpm install --frozen-lockfile
|
|
63
76
|
npm run build:client
|
|
64
|
-
New-Item -ItemType Directory -Force dist | Out-Null
|
|
65
77
|
npm pack --pack-destination dist
|
|
66
78
|
```
|
|
67
79
|
|
|
68
|
-
随后通过插件管理器安装 `dist` 中生成的 `.tgz
|
|
80
|
+
随后通过插件管理器安装 `dist` 中生成的 `.tgz`。复制 npm 压缩包不能恢复全部源码，开发需保留客户端、测试、脚本与美术目录。更多界面步骤与排障见[安装指南](INSTALLATION_GUIDE.zh.md)。
|
|
69
81
|
|
|
70
82
|
## 开始使用
|
|
71
83
|
|
|
@@ -218,10 +230,11 @@ Harness 目录中的模型 ID 未必是厂商 CLI 接受的名字。逐模型设
|
|
|
218
230
|
|
|
219
231
|
侧边栏中的 **Gal 模块**与模型路由平级：
|
|
220
232
|
|
|
221
|
-
-
|
|
233
|
+
- **标题画面**：选择剧目，然后开始新故事或继续自动存档；系统设置、素材鉴赏与自由模式也可从这里进入。
|
|
234
|
+
- **剧情模式 · Gal 视图**：场景、立绘、分支、历史、结局、自动阅读、已读快进、上一句、全屏，以及手动三槽、快捷存档与 JSON 备份。剧情引擎离线运行，无需模型账号。
|
|
222
235
|
- **自由模式**：选择宿主已配置的模型、角色与场景，在面板内发送消息、停止生成，也可复制开场提示词到官方会话。面板内对话会真实调用模型并可能计费。
|
|
223
236
|
|
|
224
|
-
0.
|
|
237
|
+
0.11.1 保留的 **“剧目”** 下拉框共有五项：
|
|
225
238
|
|
|
226
239
|
| 剧目 | 篇幅与玩法 | 结局说明 |
|
|
227
240
|
| --- | --- | --- |
|
|
@@ -231,26 +244,42 @@ Harness 目录中的模型 ID 未必是厂商 CLI 接受的名字。逐模型设
|
|
|
231
244
|
| 未寄出的春天 | 承接“各自点灯”的**独立十二章后日谈**，九条可选人物支线。 | 五个结局；完成有条件的“回信”结局需保留双份原件、逐人询问、分布转递、共享锚点，并完成至少两条支线。 |
|
|
232
245
|
| 回声之城·正篇 | 序章、共通线八章、六条角色主线、隐藏线“影与身”与命名之夜。 | **仅王女线有真／暗双结局**；六条主线与隐藏线完成后可达全员 TRUE END。 |
|
|
233
246
|
|
|
234
|
-
**上手方式**：进入 **Gal 模块 → 剧情模式 · Gal 视图**，选剧目，从开篇点对话继续，遇到选项点击作答；“历史”回看，“存 1–3 / 读 1–3
|
|
247
|
+
**上手方式**：进入 **Gal 模块 → 剧情模式 · Gal 视图**，选剧目，从开篇点对话继续，遇到选项点击作答；“历史”回看，“存 1–3 / 读 1–3”保留手动进度，独立快捷存档用于临时检查点，升级或跨设备前“导出存档”备份。自动进度和快捷存档按剧目分开；**千桥协议与旧城迁移篇保留历史共用三槽**，其他三部各有三槽。对短篇、春篇及旧剧目，从章节下拉框**直接进入某章会重新建立该章状态**，不继承前章选择；想看连续因果请从开篇顺序游玩。**正篇**连续章节切换保留本周目旗标与 14 位角色好感；从序章顺序游玩最便于解锁隐藏线：雪国线真结局、第四章短笺完整抄录、两次留意执事的日常；TRUE END 还需六线及隐藏线全通。命名之夜可给执事取名，默认“衔雪”。
|
|
248
|
+
|
|
249
|
+
### 立绘、音乐和阅读设置怎么用
|
|
250
|
+
|
|
251
|
+
点击页头 **Gal 设置**或剧情工具栏 **设置**：
|
|
252
|
+
|
|
253
|
+
1. **立绘**：默认 **完整全身原画**，使用已入库的 28 位角色完整立绘，Claude 使用你指定的橙发原稿。舞台会为对话和选项预留空间，完整显示身体；也可选 **表情特写（半身差分）**。先选 **主角色默认**和 **同伴默认**，分别调缩放（40–180%）、水平位置（0–100%）、距底部（−30–50%）；单个人物仍不协调时选 **角色名 · 单独设置**。变化实时预览并保存。全身原画在不同情绪下使用同一张图，头像仍会切换表情；本轮未新增全身差分。
|
|
254
|
+
2. **音乐与音效**：选“跟随剧情”或七首内置循环配乐，亲自点击 **开启音乐**。背景音乐和操作音效有独立音量，0 完全静音，“全部静音”作用于两者。本地音乐最多 **30 MB**，不上传，仅当前会话使用，重开需重选；操作音效不是对白配音。
|
|
255
|
+
3. **文字与阅读**：逐字间隔 0–120 ms（0 立即显示）、字号 12–32 px、自动等待 300–10000 ms、对话框不透明度 20–100%。**自动阅读**等整句显示后推进；默认 **已读快进**遇未读停；允许快进未读要明确勾选。两者都在分支、命名和结局停止，不代替用户作答。设置、历史、确认窗口和页面后台暂停推进。
|
|
256
|
+
4. **快捷键**：先点剧情舞台空白处获取焦点。Enter/空格显示整句或继续，A/S 自动/快进，H/Esc 隐藏/恢复，F 全屏，Q/L 快捷存/读，← 上一句；输入框和按钮保留自己的按键。**上一句仅本次阅读最多 30 步**，刷新、换剧目/章节或读档后清空。
|
|
257
|
+
5. **存档与鉴赏**：JSON 备份当前剧情状态，导入前切到对应剧目，最多 **2 MB**，确认后替换进度；不包含全部槽位、设置、音乐和已读记录。**素材鉴赏**可浏览已有立绘/表情和场景，全部开放、可能剧透，不是通关解锁 CG 系统。
|
|
258
|
+
|
|
259
|
+
完整逐控件说明、比例示例和故障处理见 **[Gal 设置与播放器教程](docs/GAL_SETTINGS.zh.md)**。自由模式仍需用户官方模型凭据，发送对话会发生真实调用并可能计费。
|
|
235
260
|
|
|
236
261
|
**春篇旧存档**：内容修订版 1 的存档仍可读取，不会凭空获得新增选择的旗标。若要体验修订版 2 的“保留双份原件”“逐人询问”，先把现有进度存入手动槽，再从本篇开篇重新开始。存档只在当前桌面配置的本地存储中；清理应用数据可能使其丢失。
|
|
237
262
|
|
|
238
|
-
|
|
263
|
+
**既有美术与显示**：0.10.1 已接入 28 张原稿人物 PNG、27 位剧情角色的六种派生表情（162 张）和六幅回声之城背景。JEV 有基础图，可自由选角，尚无剧情出场或六表情套。相邻人物按 `cast` / `stageCharacters` 同场显示。本轮使用已有美术完善播放器，未新增画稿；原图与派生资源见[立绘来源](docs/GAL_ART_SOURCES.zh.md)。
|
|
264
|
+
|
|
265
|
+
|
|
266
|
+
|
|
267
|
+
*图：实际 0.11.0 插件组件的本地浏览器预览，标题菜单支持选择剧目、开始与继续。*
|
|
239
268
|
|
|
240
|
-
|
|
241
270
|
|
|
242
|
-
*图：0.
|
|
271
|
+
*图：0.11.0 包在已安装官方 rc.2 运行时的独立测试 profile 中实际加载。全身原画的脚部位于对话框上方，底部操作栏在全屏中仍可使用。*
|
|
243
272
|
|
|
244
|
-
|
|
245
274
|
|
|
246
|
-
*图：0.
|
|
275
|
+
*图：Claude 完整原稿的布局预览与音乐、文字设置。标题、设置截图为本地组件预览；舞台截图为官方 rc.2 隔离运行时。用户当前桌面 profile 仍需安装并验收 0.11.1。*
|
|
247
276
|
|
|
248
277
|
详细章节、结局与存档步骤见 [Gal 五剧目玩法说明](docs/ECHO_CITY_STORY.zh.md)；旧剧目背景见 [Gal 预览说明](GAL_GAME_PREVIEW.md)。
|
|
249
278
|
|
|
250
279
|
## 验证与开发
|
|
251
280
|
|
|
252
|
-
0.
|
|
281
|
+
0.11.1 沿用通过 **153 项主测试 + 75 项额外剧情与游戏测试，共 228 项**的 0.11.0 运行时代码。本轮重新跑过 153 项主测试、客户端构建、peer 检查与本地安装包中的图片路径验证；npm 上传在注册表 PUT 阶段超时，不能据此宣称已发布。0.11.0 的组件曾在官方 rc.2 隔离 profile 中验证两个入口、标题、完整原画和全屏历史；0.11.1 的当前 profile、真实登录、模型身份与费用仍需验收。完整记录见本轮报告。
|
|
253
282
|
|
|
254
|
-
开发者可运行 `pnpm install --frozen-lockfile`、`npm test`、`npm run check:client` 和 `pnpm peers check
|
|
283
|
+
开发者可运行 `pnpm install --frozen-lockfile`、`npm test`、`npm run check:client` 和 `pnpm peers check`。本轮文件职责、发布验证、用户测试和剩余任务见[0.11.1 总项目报告](https://github.com/Alice-Marx/model-router-galgame/blob/main/PROJECT-TASK-REPORT-2026-10-02-NPM-RELEASE-AND-README-FIX.md)；播放器实现见[Gal 播放器报告](PROJECT-TASK-REPORT-2026-10-01-GAL-PLAYER.md)，历史兼容验证见[rc.2 报告](PROJECT-TASK-REPORT-2026-10-01-RC2-COMPAT.md)。欢迎通过 [Issues](https://github.com/Alice-Marx/model-router-galgame/issues) 附安装详情、宿主版本和脱敏错误日志反馈问题。
|
|
255
284
|
|
|
256
285
|
许可证：[MIT](LICENSE)。
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
# 《千桥协议》章节背景生成记录
|
|
2
|
+
|
|
3
|
+
这八张场景图使用 Codex 内置 ImageGen 生成，运行时转换为 1672×941 的 WebP。共同提示词约束为：精致的日系视觉小说背景、宽屏 16:9 构图、为画面中右部角色立绘保留平静空间、底部约 38% 使用较暗且低细节的区域承接对话框、场景内无人、无可读文字、无品牌标志、无界面、无水印。
|
|
4
|
+
|
|
5
|
+
各图在共同提示词上增加以下场景描述：
|
|
6
|
+
|
|
7
|
+
- `prologue-station.webp`：蓝金色的千桥总站大厅，弧形玻璃、远处桥群、夜间到站灯与安静检票台。
|
|
8
|
+
- `association-open-day.webp`：百模协会开放日大厅，模型、数据集和工具工坊以展台与档案架相连，暖色午后光。
|
|
9
|
+
- `laurel-theatre.webp`：月桂审议所在的旧剧院，空舞台、评审席、档案灯和深红帷幕，克制的金色照明。
|
|
10
|
+
- `bridges-night.webp`：千桥事故夜，交叠桥梁、故障信号灯、雾与封锁线，蓝橙色紧张照明。
|
|
11
|
+
- `three-harbors.webp`：清晨雾中的三座代码港，公开变更簿、流水线坞站与镜像钟楼由水道相连。
|
|
12
|
+
- `open-dome-hearing.webp`：木质开放议事厅与玻璃穹顶围绕圆形证据桌相接，上午天光，公开席和审议席各有入口。
|
|
13
|
+
- `protocol-composition.webp`：夜间档案馆的协议组合室，三层同心机械桌、卷宗、权限钥匙和桥形窗景。
|
|
14
|
+
- `six-endings.webp`：日出时的千桥观景台，多种桥形通往同一座城市，金蓝晨光，适合结局卡片覆盖。
|
|
15
|
+
|
|
16
|
+
原始生成结果由 Codex ImageGen 保存；仓库中的 WebP 是插件构建实际使用的版本。背景没有合成人物，角色仍使用项目已有立绘。
|
|
Binary file
|