diff --git a/.gitattributes b/.gitattributes index b6d7da2..ee75643 100644 --- a/.gitattributes +++ b/.gitattributes @@ -13,3 +13,7 @@ *.docx binary *.woff binary *.woff2 binary + +# Byte-for-byte fixtures from preview.20; their published digests must survive checkout. +scripts/fixtures/library-preview20/library.sqlite binary +scripts/fixtures/library-preview20/backup.json -text diff --git a/.github/workflows/library-s2-installer.yml b/.github/workflows/library-s2-installer.yml new file mode 100644 index 0000000..3cad27a --- /dev/null +++ b/.github/workflows/library-s2-installer.yml @@ -0,0 +1,114 @@ +name: S2 Windows Setup +on: + push: + branches: [codex/library-s2-installer-qa] + paths-ignore: + - 'docs/**' + - 'ROADMAP.md' + - 'scripts/benchmark-*.mjs' + +permissions: + contents: read + actions: read + +jobs: + qualify: + if: github.repository == 'SHIN09-git/novel' && !github.event.deleted + runs-on: windows-2025 + timeout-minutes: 60 + strategy: + fail-fast: false + matrix: + route: [clean, upgrade] + name: S2 ${{ matrix.route }} + env: + ROUTE: ${{ matrix.route }} + SETUP_ARTIFACT: s2-setup-${{ github.sha }}-${{ github.run_attempt }} + defaults: + run: + shell: pwsh + steps: + - name: Start evidence record + run: | + $dir = New-Item -ItemType Directory -Path (Join-Path $env:RUNNER_TEMP 's2-evidence') + @{ route=$env:ROUTE; commit=$env:GITHUB_SHA; run=$env:GITHUB_RUN_ID; attempt=$env:GITHUB_RUN_ATTEMPT } | + ConvertTo-Json | Set-Content (Join-Path $dir.FullName 'job.json') + - uses: actions/checkout@v4 + with: + persist-credentials: false + - uses: actions/setup-node@v4 + with: + node-version: 24 + - name: Install locked dependencies + run: npm.cmd ci + - name: Require a newer candidate version from this commit + run: node -e "const v=require('./package.json').version,l=require('./package-lock.json');if(!require('semver').gt(v,'0.1.6-preview.20')||v!==l.version||v!==l.packages[''].version)throw Error('Set and lock the candidate version before pushing')" + - name: Build the single candidate (no publishing) + if: matrix.route == 'clean' + run: npm.cmd run dist:win + - name: Retain candidate Setup and build records + if: matrix.route == 'clean' + uses: actions/upload-artifact@v4 + with: + name: ${{ env.SETUP_ARTIFACT }} + path: | + release/Novel Director Setup *.exe + release/SHA256SUMS.txt + release/BUILD_INFO.json + compression-level: 0 + if-no-files-found: error + retention-days: 14 + # Both VMs consume the uploaded artifact. No third Windows build VM. + - name: Wait for this run's candidate + if: matrix.route == 'upgrade' + timeout-minutes: 40 + env: + GH_TOKEN: ${{ github.token }} + run: | + $run = "repos/$env:GITHUB_REPOSITORY/actions/runs/$env:GITHUB_RUN_ID" + while ($true) { + $assets = gh api "$run/artifacts?name=$env:SETUP_ARTIFACT" | ConvertFrom-Json + if ($LASTEXITCODE) { throw 'Cannot read run artifacts' } + if (@($assets.artifacts | Where-Object { $_.name -ceq $env:SETUP_ARTIFACT -and !$_.expired }).Count -eq 1) { break } + $jobs = gh api "$run/attempts/$env:GITHUB_RUN_ATTEMPT/jobs" | ConvertFrom-Json + if ($LASTEXITCODE) { throw 'Cannot read packaging job status' } + if ($jobs.jobs | Where-Object { $_.name -eq 'S2 clean' -and $_.status -eq 'completed' -and $_.conclusion -ne 'success' }) { + throw 'Packaging job ended without handing over the Setup' + } + Start-Sleep -Seconds 12 + } + - name: Download the same immutable candidate + env: + GH_TOKEN: ${{ github.token }} + timeout-minutes: 6 + run: | + # The artifact can be indexed for this run before its download endpoint is ready. + $PSNativeCommandUseErrorActionPreference = $false + $inputDir = Join-Path $env:RUNNER_TEMP 's2-input' + for ($i=1; $i -le 8; $i++) { + $attemptDir = Join-Path $env:RUNNER_TEMP "s2-download-$i" + gh run download $env:GITHUB_RUN_ID --name $env:SETUP_ARTIFACT --dir $attemptDir + if ($LASTEXITCODE -eq 0) { + New-Item -ItemType Directory -Path $inputDir -ErrorAction Stop | Out-Null + Get-ChildItem -LiteralPath $attemptDir -File | Copy-Item -Destination $inputDir -ErrorAction Stop + exit 0 + } + if ($i -lt 8) { Start-Sleep -Seconds 8 } + } + throw 'Unable to download this attempt''s immutable Setup' + - name: Exercise installed product + run: ./scripts/s2-windows/qualify.ps1 + - name: Record job outcome + if: always() + env: + RESULT: ${{ job.status }} + run: | + $env:RESULT | Set-Content (Join-Path $env:RUNNER_TEMP 's2-evidence/job-result.txt') + - name: Retain qualification evidence + if: always() + uses: actions/upload-artifact@v4 + with: + name: s2-${{ matrix.route }}-report-${{ github.sha }}-${{ github.run_attempt }} + path: ${{ runner.temp }}/s2-evidence/ + if-no-files-found: warn + retention-days: 14 diff --git a/README.md b/README.md index 5af567a..dcc5914 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ Novel Director 是一个实验性的、本地优先的 AI 长篇小说工作台 - 实验性本地优先桌面应用。 - Windows 是主要开发和验证平台。 -- 项目数据默认保存到本地 SQLite 数据库;JSON 导入、导出和 fallback 仍然保留。 +- 项目默认保存到本地 SQLite。仍可导入、导出 JSON,也可明确选择一份 JSON 作为独立书库。 - AI 功能是可选的,取决于你配置的模型供应商。 - 源码仓库不跟踪预构建 `.exe` 或打包产物。 @@ -86,16 +86,16 @@ npm.cmd run dist:win ### Windows 打包、SQLite 与 native 依赖 -Novel Director 使用 `better-sqlite3` 作为 main process 的 SQLite 后端。它是 native 依赖,在 Windows 上可能需要 Visual Studio C++ Build Tools(含 MSVC、Windows SDK 和 C++ CMake tools)才能重新编译 Electron 绑定。 +开发主线使用 `better-sqlite3` 13。打包前先让 Electron 执行一次 SQLite 查询。Windows x64 随依赖提供的组件能用时无需编译;只有需要从源码重新编译时才需要 Visual Studio C++ Build Tools。 建议: - 开发机先运行 `npm.cmd install`,再运行 `npm.cmd run build`。 - 运行 Electron 预览并连接 SQLite 前,先运行 `npm.cmd run native:electron`,或直接使用 `npm.cmd run preview:sqlite`。 -- 跑 Agent CLI、验证脚本或 Node.js 侧 SQLite 测试前,运行 `npm.cmd run native:node`,把 `better-sqlite3` 恢复为本机 Node.js ABI。 +- 运行 `npm.cmd run native:node` 可验证 Agent 和测试使用的 Node 也能查询 SQLite;已有组件可用时不会重新编译。 - 打包使用 `npm.cmd run dist:win`,脚本会使用仓库内 `.electron-cache` 和 `.electron-builder-cache`,减少 C 盘缓存压力。 - 打包流程会在生成 `release/win-unpacked/Novel Director.exe` 后运行 `npm.cmd run smoke:packaged`,检查图标、preload API、SQLite 默认路径、导入导出 API 和无 API Key 状态。 -- 如果 `better-sqlite3` rebuild 失败,先安装 Visual Studio C++ Build Tools;应用代码仍保留 JsonStorageService fallback,但正式安装包应优先修复 native 绑定后再发布。 +- 如果 SQLite 组件无法加载,桌面版会显示“书库未打开”,不会自动切换到 JSON。修复安装后点“重试”。明确选择独立 JSON 时,之后的修改只写入该文件。 单独运行打包后烟测: @@ -109,7 +109,7 @@ npm.cmd run smoke:packaged 排查建议: -- 如果 SQLite 数据库损坏,先备份当前 `novel-director-data.sqlite`,再尝试从设置页恢复最近备份或导入旧 JSON。 +- 如果看到“书库未打开”,先核对错误页的路径。外接磁盘断开时,接回原盘并点“重试”。文件损坏时,点“从备份恢复到新文件”,选择 JSON 备份和一个未用过的文件名,原库不会被覆盖。不需要先建空项目。 - 如果 JSON 导入失败,确认文件来自 Novel Director 导出或旧版 `novel-director-data.json`,不要直接导入章节 TXT/Markdown。 - 如果迁移或合并失败,不要删除源文件;检查自动生成的 `.bak` 或迁移前备份。 - 如果备份恢复失败,保留失败文件和日志,通过 Settings 的日志导出或 issue 模板提交脱敏信息。 @@ -219,7 +219,7 @@ Start with the [beginner tutorial](./docs/BEGINNER_TUTORIAL.md) or [quickstart]( - Experimental local-first desktop app. - Windows is the primary development target. -- Data is stored locally in SQLite by default; JSON import, export, and fallback remain available. +- SQLite is the default local store. JSON import, export, and explicitly selected standalone JSON libraries remain available. - AI features are optional and depend on the provider you configure. - No prebuilt binaries are tracked in this source repository. @@ -280,16 +280,16 @@ The default package is an unsigned trial build. Windows may show a SmartScreen w ### Windows Packaging, SQLite, and Native Dependencies -Novel Director uses `better-sqlite3` as the main-process SQLite backend. It is a native dependency, so Windows builds may require Visual Studio C++ Build Tools, including MSVC, Windows SDK, and C++ CMake tools, to rebuild Electron bindings. +The development branch uses `better-sqlite3` 13. Packaging tests the installed binding with an actual SQLite query in Electron. The bundled Windows x64 binary normally needs no compilation; Visual Studio C++ Build Tools are needed for a source rebuild. Recommendations: - Run `npm.cmd install`, then `npm.cmd run build` on the development machine. - Before running Electron preview against SQLite, run `npm.cmd run native:electron`, or use `npm.cmd run preview:sqlite`. -- Before running Agent CLI, validation scripts, or Node-side SQLite tests, run `npm.cmd run native:node` to restore the `better-sqlite3` binding for the local Node.js ABI. +- Use `npm.cmd run native:node` to verify the binding used by the Agent CLI and tests. It does not rebuild a working binding. - Use `npm.cmd run dist:win` for packaging. The script uses repository-local `.electron-cache` and `.electron-builder-cache` directories to reduce C drive pressure. - The packaging flow runs `npm.cmd run smoke:packaged` after creating `release/win-unpacked/Novel Director.exe`; the smoke test checks the icon, preload API, SQLite default path, import/export API, and no-key state. -- If `better-sqlite3` rebuild fails, install Visual Studio C++ Build Tools first. The app retains JsonStorageService fallback in code, but release packages should be shipped only after the native binding is healthy. +- If the SQLite component cannot load, the desktop app shows a recovery screen instead of switching to JSON. Repair the installation and retry. Changes made to an explicitly selected JSON library stay in that file. Run packaged smoke test separately: @@ -303,7 +303,7 @@ If the project list is empty on first launch, click `导入旧数据 JSON` and s Troubleshooting: -- If the SQLite database is corrupted, back up `novel-director-data.sqlite` first, then restore a recent backup or import old JSON from Settings. +- On the library recovery screen, check the displayed path. Reconnect the original disk and retry, or restore a JSON backup to a new filename. Recovery does not overwrite the original library or require an empty project first. - If JSON import fails, make sure the file is a Novel Director export or legacy `novel-director-data.json`, not a chapter TXT/Markdown export. - If migration or merge fails, do not delete the source file; check the generated `.bak` files or pre-migration backups. - If backup restore fails, keep the failed file and logs, then share redacted diagnostics through the security or issue process. diff --git a/ROADMAP.md b/ROADMAP.md index 3e8155b..9f44c66 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -1,6 +1,6 @@ # 路线图 / Roadmap -更新日期:2026-11-11。这里只保留当前方向和下一步,不再重复各版本的施工日志、源码行数和已完成待办。历史变更见 [CHANGELOG](./CHANGELOG.md),包的实际状态见 [发行产物说明](./docs/RELEASE_ARTIFACTS.md)。 +更新日期:2026-11-13。这里只保留当前方向和下一步,不再重复各版本的施工日志、源码行数和已完成待办。历史变更见 [CHANGELOG](./CHANGELOG.md),包的实际状态见 [发行产物说明](./docs/RELEASE_ARTIFACTS.md)。 ## 当前方向 @@ -13,20 +13,20 @@ - 桌面和 Agent 共用生成、审稿、修订、候选决定及正式提交流程;项目权限可以撤回。 - 章节阅读、局部重写、任务编辑、候选历史和作者诊断摘要已有入口。 -2026-10-31:复用单次 Novelty 审计的分词结果,去掉 Prompt 追踪的重复渲染,简化 token 扫描;修订指令按类型输出。范围、实测和限制见 [本轮性能记录](./docs/REDUNDANCY_PERFORMANCE.md)。已纳入本地 Preview.19 安装包和 `release/win-unpacked`,尚未上传 GitHub。 +[Preview.20](https://github.com/SHIN09-git/novel/releases/tag/v0.1.6-preview.20) 已公开发布,包含[长篇完稿修复](./docs/LONG_NOVEL_COMPLETION_REPAIR_PLAN.md):超限保稿、成稿硬规则核查、跨章对账、按书统计用量和批量改名。用量不能反推供应商余额或缺失的历史账单。此前减少 Novelty 重复分词、Prompt 追踪重复渲染的实测见[性能记录](./docs/REDUNDANCY_PERFORMANCE.md)。 ## 下一步优先事项 -按[长篇完稿后的修复计划](./docs/LONG_NOVEL_COMPLETION_REPAIR_PLAN.md),源码已支持保留超限稿、成稿硬规则核查、全书进度与连写顺序、按章取余额和跨章事实核对。P2 增加按书统计模型用量、调用前估算、连接诊断、按起止章编排导向,以及可预览和追溯的批量改名。尚不能从用量反推供应商余额或旧书缺失的账单。下表保留原有维护事项;安装包要单独更新。 +见[书库可靠性与长篇性能施工计划](./docs/LIBRARY_STABILITY_AND_PERFORMANCE_PLAN.md)。本轮候选为 **preview.21**;候选测试与公开发布分开,未替换已发布的 preview.20。 | 优先级 | 工作 | 完成条件 | | --- | --- | --- | -| 1 | 处理已报告的依赖安全告警 | 核对受影响调用,按兼容范围升级;完整回归和包内 SQLite 启动通过后再发包 | -| 2 | 继续压缩实际慢入口 | 复现具体操作,测量全量数据读取、跨进程传输或诊断耗时;只有可重复收益才新增定向查询或后台计算 | -| 3 | 用真实修订案例检查提示词 | 对比指定问题是否修好、无关段落是否保留;记录 Novelty 误报/漏报,避免继续堆全局禁令 | -| 4 | 修补高频操作中的阻碍 | 优先未保存输入恢复、采纳失败恢复、阅读和修订切换;按用户反馈选具体入口,不做全站重设计 | +| S0 / S1,本地完成 | 保留 preview.20 虚构库;区分书库未打开和空书库 | 从错误页重试、选择已有库、恢复至新文件或明确新建;不自动切换独立 JSON | +| S2,已验收 | 两台独立 Windows 虚拟机测试同一安装包 | [全新安装与原地升级均通过](./docs/S2_WINDOWS_QUALIFICATION.md),包含重启、卸载及回退 | +| S3-A / S3-B | 打开项目只写最近打开时间;SQLite 按本次采纳或修订所需的记录校验 | 继续检查版本、项目归属、报告与正文;使用同一份虚构长篇书库对照 | +| S4 | 压缩新自动备份,保留可供旧版恢复的普通 JSON;手动备份不轮替 | 两种格式均可恢复;不删除历史步骤或改写现有提交回执。首屏历史按需加载继续暂缓 | -真实模型对照需要另行确认供应商、模型和费用。本地性能基准不消耗模型额度,不能替代成文质量评估。 +具体的修订质量、Novelty 误报和未保存输入仍按作者反馈跟进,不阻塞上述交付。本轮性能验收不消耗模型额度,也不替代成文质量评估。 ## 保留的必要校验 @@ -40,7 +40,7 @@ npm.cmd test npm.cmd run build ``` -更新安装包时另跑 `npm.cmd run smoke:packaged`;公开发布前做密钥扫描。每项新优化必须有行为回归或实测依据,不新增只检查文案和文件行数的门槛。 +发布候选包另跑 `npm.cmd run smoke:release` 检查解包程序,再用 Setup 验证实际安装和升级;两者不能互相替代。公开发布前做密钥扫描。每项新优化必须有行为回归或实测依据,不新增只检查文案和文件行数的门槛。 ## 暂缓 @@ -56,8 +56,8 @@ npm.cmd run build ## English -Updated 2026-11-11. The [long-novel repair plan](./docs/LONG_NOVEL_COMPLETION_REPAIR_PLAN.md) now includes project-level usage, single-request cost estimates, connection diagnoses, custom story-direction ranges and auditable chapter renames, in addition to draft retention, canon checks and cross-chapter continuity. Provider balances and unrecorded historical usage remain unknown. This describes the working tree, not a new installer. +Updated 2026-11-13. The [preview.20 prerelease](https://github.com/SHIN09-git/novel/releases/tag/v0.1.6-preview.20) includes the [long-novel fixes](./docs/LONG_NOVEL_COMPLETION_REPAIR_PLAN.md). Provider balances and unrecorded historical usage remain unknown. -Next: verify dependency advisories; profile concrete slow operations before redesigning storage or threading; evaluate task-specific revision instructions with real cases; repair reported editing and acceptance friction. The [current performance record](./docs/REDUNDANCY_PERFORMANCE.md) covers the optimizations now packaged locally as Preview.19, not a claim about model quality or a GitHub publication. +The [library plan](./docs/LIBRARY_STABILITY_AND_PERFORMANCE_PLAN.md) qualifies preview.21 separately from public releases. Project opening no longer sends a full snapshot; SQLite commits load their validation inputs by scope. New automatic backups use compression where the file can be restored safely. Existing receipts and manual backups are retained. Full-library startup reads are a separate, deferred optimization. Keep project isolation, version conflict checks, idempotent commits, report provenance, rollback, backups, authorization and credential redaction. Full CRUD rewrites, FTS, graphs, cloud sync and generic extension systems remain deferred. Historical plans and measurements are references, not additional mandatory work. diff --git a/docs/LIBRARY_STABILITY_AND_PERFORMANCE_PLAN.md b/docs/LIBRARY_STABILITY_AND_PERFORMANCE_PLAN.md new file mode 100644 index 0000000..b7e834a --- /dev/null +++ b/docs/LIBRARY_STABILITY_AND_PERFORMANCE_PLAN.md @@ -0,0 +1,98 @@ +# 书库可靠性与长篇性能施工计划 / Library Reliability and Performance + +拟定于 2026-11-12,更新于 2026-11-13。本计划承接 [ROADMAP](../ROADMAP.md)。S0 / S1 是旧版样本和打开失败恢复;S2 是独立 Windows 安装验收;S3 和 S4 分别优化正式写入和备份。候选验收不等于公开发布。 + +下一版先让作者确信“打开的是原来的书库”,并用真正的 Windows 安装器验证升级。之后再缩短打开一本书、采纳或修订一章的等待时间。不要求先重构全库,也不拿删除作者历史来换取性能。 + +## 顺序与交付 + +| 批次 | 交付 | 启动条件 | +| --- | --- | --- | +| S0 准备 | 从核实过的远端主线建立独立工作区,准备虚构旧书库 | 首个工程步骤;不改动原工作区 | +| S1 书库打开失败 | 保留原路径,显示恢复入口,不悄悄换到另一份可写书库 | S0 后;下一版必做 | +| S2 Windows 升级验收 | 在受支持的 Electron 上验证安装、升级、SQLite 读写和重启 | 可与 S1 并行准备环境;交付候选包前必须合并并验过 S1 | +| S3-A 打开项目 | 只更新当前项目的最近打开时间;保留排序 | 用 S2 同一套依赖先测基线,可单独合并 | +| S3-B 采纳和修订 | 只读取这次提交真正需要的记录,保留原有事务校验 | 沿用 S3-A 的样本;采纳、修订分别对照 | +| S4 历史与备份 | 按瓶颈选做:按需读历史、减少新记录副本或压缩自动备份 | 不阻挡前面发版;每项须有测量或明确的磁盘需求 | + +## S0:选对起点 + +- 核查时 GitHub `main` 是 `78550db`。按 Git 的文件内容比对,当时本地 901 个非忽略项目文件均与 `v0.1.6-preview.20` 一致;与主线的差异只有 CI、依赖清单和锁文件。这是**拟定本计划前**的结果,不代表后来新增的文件都已发布。 +- 开工前重新核对远端、未提交和未跟踪文件。从最新已核实的 `origin/main` 建独立工作区,带入这份计划及经确认的后续变更。保留作者原工作区,不硬重置,不用旧锁文件覆盖主线。 +- 只用临时目录、虚构书库和模型替身。准备一份由 preview.20 写出的样本,至少含两本书、一章已采纳正文、一次修订和一条尚可续跑的任务。记录项目 ID、正文摘要值、版本链和已采纳草稿 ID,供后续逐项核对。不要复制真实书库做测试。 + +## S1:打开失败,不冒充空库 + +**preview.20 的问题。** SQLite 模块加载失败时,旧版可能切换为独立 JSON 并改写路径;文件缺失或损坏时,旧界面还可能显示可编辑的空项目列表。S1 将[打开与恢复](../src/main/LibrarySession.ts)分开:先完整读出所选库,再交给保存功能。读取已有库不建表,不用旁边的文件修复它;只有首次建库、明确新建或恢复才初始化文件。 + +| 情形 | 作者应看到 / 程序应做什么 | +| --- | --- | +| 真正首次使用,尚无书库 | 按现有流程创建默认库;已有合法旧 JSON 的首次迁移仍保留原件和备份 | +| 已选书库因磁盘未连接、路径失效、原生模块不匹配或读取失败而无法打开 | 显示出错的书库路径、简短原因及下一步;不改配置,不创建替代库,不开放对空数据的保存 | +| 用户要恢复 | 提供“重试”“选择已有书库”“从备份恢复”入口。先在所选位置验证能读,再切换;恢复优先写新位置。选择失败或取消,仍指向原库 | +| 用户明确选择使用 JSON | 保留 JSON 的独立使用及导入导出能力,说明写入哪个文件;不暗示新写内容会自动合回 SQLite | + +不能只凭“文件不存在”认定是新用户。旧配置不足以区分首次使用和磁盘离线时,先请作者选择已有书库或明确新建。不要在判断之前调用会初始化空库的读取方法。 + +**验收:** 分别模拟模块不可用、已有库损坏及已配置的库暂时找不到;确认原数据库、配置和同目录 JSON 未被改写,也没有新建空库。恢复正常条件后点“重试”,两本书及版本链都在。另跑新用户首次启动、旧 JSON 迁移和显式恢复的正向用例。复用[存储验证](../scripts/validate-sqlite-storage.mjs),并从成品窗口验证作者看到的状态,而不只看日志。 + +**复测入口。** [preview.20 虚构旧库](../scripts/fixtures/library-preview20/README.md)含两个项目、一次正式采纳、一次手动修订、一个可续跑的任务,以及原始 SQLite 和 JSON 备份的校验值。旧版和候选版只打开它的临时副本。用 `npm.cmd test -- validate-library validate-agent-library-choice` 检查选库、原件保护和 Agent 读写;用 `npm.cmd run qa:library:ui` 检查恢复页面和保存队列。成品窗口复测命令见样本说明,不能用开发预览或网页代替。 + +**S0 / S1 验收(2026-11-12,Windows x64):** + +| 验证范围 | 结果 | +| --- | --- | +| S0 起点 | 核对远端主线 `78550db`;在独立工作区保留两份计划文档,使用主线锁文件。未修改原工作区或作者书库。 | +| 旧版实证 | 在 preview.20 的独立窗口复现了 4 种误导性空列表:书库目录缺失、文件缺失、损坏且旁有 JSON、仅有损坏文件。 | +| 新版故障恢复 | 同一份样本分别模拟上述 4 种故障和原生 SQLite 组件不可用。出错时数据读写被拒绝,配置、原库和旁边 JSON 未被改写。恢复原条件后在同一进程重试,两个项目、正文、版本链和待续跑任务均与清单一致。 | +| 首次使用与作者操作 | 成品窗口分别验证首次建库、合法旧 JSON 迁移、选择已有库、将备份恢复至新文件、明确选择独立 JSON、明确新建;取消选择和选错文件不切库。所有窗口仅用虚构数据,未请求模型。 | +| 防止空备份覆盖 | 旧设置页的备份恢复及覆盖导入也检查完整书库结构。空对象、无效字节不能替代整库;有实际记录的旧项目片段仍可合并,支持带 UTF-8 BOM 的备份。 | +| 成品凭据 | 最终验过的候选 `app.asar` SHA-256 为 `4b235d3221f59c64f69a8dd7182a521f2e12e9eb296fb41053f8f65f0a9614ae`。11/11 种场景、23 个进程会话,模型请求为 0。 | +| 交付边界 | 这是未发布的解包程序验收,不是 Setup 安装、卸载或原地升级。公开 preview.20 安装包未替换。 | + +## S2:发布候选包必须过安装升级 + +preview.20 实包使用 Electron 39.8.10 / better-sqlite3 12.9.0;核查时主线锁定的是 44.9.1 / 13.0.3。按候选提交的锁文件和 [Electron 支持日程](https://releases.electronjs.org/schedule)复核,不把源码升级当成安装包升级。区分会随应用运行的依赖和只影响构建的依赖,不为清零告警一次合并所有大版本。 + +1. 在独立工作区安装锁定依赖,跑类型检查、全量测试和生产构建。从同一提交生成 **新版本号** 的 Windows x64 安装包,核对版本、SQLite 原生模块与 SHA-256。保留已公开的 preview.20 标签及附件。 +2. 保留 CI 预览启动检查,并用 `npm.cmd run smoke:release` 检查实际 `win-unpacked`。后者不等于运行 Setup。另在干净 Windows 环境用 Setup 安装、启动,再验证卸载;第二条路径先装 preview.20、写入 S0 样本,再原地升级候选版。两条测试均不使用作者的用户目录。 +3. 升级后核对原书库路径、项目 ID、正文摘要值和版本链;编辑样本一章、关闭再重开,确认写回同一 SQLite。独立验证 Node/Agent 仍能读取同一份样本。保留验收记录;任何一项失败均不发布,不用 JSON 回退冒充通过。 + +**回退:** 保留上一已验证安装包和升级前样本备份。先在隔离环境验证旧程序能否读取新版写过的样本;不能直接降级时,使用旧程序和升级前备份恢复到另一位置,不覆盖升级后的作者数据。S2 验收通过即可交付候选包,无须等待性能批次;对外发布另行确认。 + +## S3:按作者操作测量和修改 + +**先测,再改。** 沿用 [500 章基线及计时定义](./PREVIEW14_LONG_NOVEL_PERFORMANCE.md)和[虚构样本](../scripts/fixtures/long-novel-performance.mjs)。增加一档多项目、每章多次生成、采纳并非最后一次成功、含失败续跑与多轮修订的样本;目标约 150–200 MiB,以实际紧凑 UTF-8 JSON 字节数为准。这个数字是测试目标,不是真实作品统计,也不拿带缩进的备份大小与它直接相比。 + +在同一机器、同一依赖和同一份虚构库上分别跑改前与改后。记录启动到项目列表、点击“进入”到工作台可操作、采纳和修订到提交成功的耗时;同时记录每次操作的整库读取次数、跨进程传输字节和实体变更数。桌面操作建议先热身,再至少测 5 次,报告中位数、最慢一次和样本数;备份到期与不需要备份分开测。毫秒数用于对照,不设跨机器 CI 时限。 + +| 操作 | 改动入口与边界 | 可判定的完成条件 | +| --- | --- | --- | +| S3-A 打开项目 | [项目列表](../src/renderer/src/views/HomeView.tsx)当前为更新时间而等待整库保存。改为单项目更新,复用保存队列与版本冲突处理;导入后进入项目也走同一入口 | 在非备份日,打开已有项目不再为时间戳发送完整 AppData;除该项目和必要的存储版本标识外不改其他记录。重启仍按最近打开排序,并发编辑不被覆盖 | +| S3-B 采纳草稿、提交修订 | [SQLite 提交路径](../src/storage/SqliteStorageService.ts)目前两者都在事务内读完整库;生成步骤已有按任务读取的实现,不重写。列出校验实际用到的章节、版本、报告和回执,在原事务内按 ID 核对存在性及项目归属;保留独立的 Agent 授权校验 | 新旧实现对相同样本给出相同的接受或拒绝结果;常规提交不再读取无关项目历史。与当前正文不匹配的报告、过期版本和跨项目引用仍被拒绝;重复提交不增版本,中途报错不留半次修改,恢复后的正文一致 | + +给每批保留一份同机对照:如果整库读取或传输没有下降、交互没有可重复的收益,先排查,再决定是否保留改动。不要因此删除校验、关闭备份或跳过存储版本检查。 + +## S4:有依据再减容 + +- **历史按需读取:先分读写,再减首屏。** [全量保存](../src/storage/sqlite/sqliteSnapshotWriter.ts)把输入缺少的实体视作删除。项目列表或历史摘要只能作为只读结果,不能补空数组后送回全量保存。先试一个入口:列表只拿概要,打开某章历史才取详情。回归场景是“不打开历史、编辑一章、保存、重启”,未加载的步骤、追踪、其他书的版本必须原样存在;全量 JSON 导入导出仍保留原语义。 +- **优先减少新副本,不批量改旧回执。** 只在占用统计证实值得做时,让新回执引用不可变版本和对应报告;缺少可靠引用时保留快照。作者采纳的不一定是最后生成的那一稿,旧章节的修订前正文还可能只在[提交记录](../src/services/ChapterVersionChainService.ts)里。测试要能恢复旧版、查到当时的报告、续跑未完任务;不设“每章只留最后成功”规则。 +- **备份先可恢复,再压缩。** [现有备份](../src/main/BackupService.ts)是未压缩 JSON。先让列表、识别和恢复兼容旧 `.json` 与拟用的 `.json.gz`,验证完整还原、坏文件和空间不足,再给**新自动备份**启用压缩。沿用自动备份保留 7 份的规则,只在新备份成功后轮替。保留旧版能读的普通 JSON 回退副本;不改手动备份和作品 JSON 导出,不自动清历史发行包。库外的 `.usage` 用量收据不随单个库文件恢复;密钥和授权不随作品备份搬运。 + +## 验证与交接 + +每个修改程序的批次运行 `npm.cmd run typecheck`、`npm.cmd test`、`npm.cmd run build`。S3 额外保留 [采纳](../scripts/validate-chapter-commit-bundle.mjs)、[修订](../scripts/validate-p2c-revision-commit-bundle.mjs)、[版本恢复](../scripts/validate-version-chain-restore.mjs)的对照;S4 压缩若启动,还要验证旧 JSON 导入导出、备份列表和恢复。性能记录只提交样本配方、指标与复现方式,不含私人路径、正文或密钥。不调用付费模型。 + +### Preview.21 实施记录 + +- **S2 已通过:** [Windows 双机验收及校验值](./S2_WINDOWS_QUALIFICATION.md),[实际运行](https://github.com/SHIN09-git/novel/actions/runs/43306395735)。两台使用同一安装包,共 10 次窗口检查,覆盖全新安装、preview.20 原地升级、编辑、冷启动、Agent 回读、卸载重装及回退。公开 preview.20 保持原样。 +- **S3-A:** 界面携带项目 ID、所选书库路径与修订号,在原保存队列内更新时间。SQLite 只改目标项目及书库修订标记;JSON 后端仍需重写单文件。编辑时间不随打开项目而改变。 +- **S3-B:** 采纳和修订在原事务内读取关联章节、版本、报告、候选与回执,并保留冲突拒绝及失败回滚。涉及全书计数的硬规则仍可读取当前项目的章节;不拿部分书库数据走整库保存。 +- **成品对照:** [720 章虚构库及原始数据](./S3_LIBRARY_PERFORMANCE.md)。未到备份期时,进入项目、采纳、修订的中位数分别从 1,389、863、860 ms 降至 382、220、17 ms。冷启动约 1.9 秒,仍读取完整书库。 +- **S4:** 选择压缩新自动备份,不批量改写旧回执或裁剪生成历史。[备份实测](./S4_AUTO_BACKUPS.md)包含恢复、空间不足及超出解压上限的处理。虚构的 500 章样本保留占用从 541 MiB 降至 92 MiB,代价是到期写入中位数由 229 ms 增至 368 ms。启动读取整库仍是独立问题。 + +暂不安排流水线引擎搬目录、全库 CRUD 重构或清理作者历史。 + +## English summary + +Start from a clean worktree based on verified upstream `main`. First distinguish an unavailable library from an empty one; preserve the original path and require an explicit recovery choice. Qualify a new Windows candidate with both a clean Setup installation and an in-place upgrade from preview.20 using synthetic data. Next benchmark and narrow two operations: updating the last-opened project and committing an accepted or revised chapter. Lazy history reads, smaller new receipts and compressed automatic backups are conditional; never submit a partial view as a full snapshot, delete an author's only recoverable version, or rotate manual backups automatically. diff --git a/docs/RELEASE_ARTIFACTS.md b/docs/RELEASE_ARTIFACTS.md index 54b6d13..aa94141 100644 --- a/docs/RELEASE_ARTIFACTS.md +++ b/docs/RELEASE_ARTIFACTS.md @@ -13,13 +13,17 @@ Novel Director 的本地目录按用途分为三层: - `Novel Director Setup <版本号>.exe`:给普通用户安装的文件。 - `win-unpacked/Novel Director.exe`:无需安装的本地测试版本。 - `SHA256SUMS.txt`:安装包 SHA-256 校验值。 -- `BUILD_INFO.json`:版本、构建时间、Electron 版本和打包烟雾测试状态。 +- `BUILD_INFO.json`:版本、构建时间、Electron 与 SQLite 绑定版本、安装包及 app.asar 的 SHA-256、烟雾测试结果;干净检出还会记录源码提交号。 同一版本重新打包时,旧的同版本构建产物会被替换。升级版本时,上一版本会自动归档。因此请始终从 `release/` 上传当前 GitHub Release,不要从 `releases/archive/` 选择安装包。 小说项目和 SQLite 用户数据库不存放在这些目录中,整理发行产物不会移动或删除用户数据。 -### 当前本地发行(2026-11-11) +### Preview.21 验收候选 + +`0.1.6-preview.21` 是书库恢复、项目打开、正式提交与自动备份的 Windows 验收版本,使用 Electron 44.9.1 与 better-sqlite3 13.0.3。专用分支的 [Setup 验收工作流](../.github/workflows/library-s2-installer.yml)让两台临时 Windows 机器使用同一安装包和校验文件;验收附件不等于公开 Release。下载和核对时使用同一构建的 SHA256SUMS.txt,不混用不同机器生成的未签名安装包。 + +### 上一公开发行(2026-11-11) `0.1.6-preview.20` 合并了[长篇完稿修复 P0–P2](./LONG_NOVEL_COMPLETION_REPAIR_PLAN.md)。安装请用 `release/Novel Director Setup 0.1.6-preview.20.exe`;不安装可直接打开 `release/win-unpacked/Novel Director.exe`。打开项目,在**设置 → 运行信息**中核对应用版本、运行方式和程序位置。已安装的旧版不会因更新仓库目录而自动升级。 @@ -97,7 +101,11 @@ Rebuilding the same version replaces generated output. Building a newer version Novel projects and the SQLite user database are stored elsewhere. Organizing release artifacts does not move or delete user data. -### Current Local Release (2026-11-11) +### Preview.21 Qualification Candidate + +This unsigned Windows x64 candidate is qualified separately from public releases. Both Windows jobs must use the same Setup from the same workflow run and attempt. See the [qualification procedure](./S2_WINDOWS_QUALIFICATION.md). Do not mix a locally built installer and the checksum from CI. + +### Previous Public Release (2026-11-11) Preview.20 ships the [P0–P2 long-manuscript repairs](./LONG_NOVEL_COMPLETION_REPAIR_PLAN.md). Install `release/Novel Director Setup 0.1.6-preview.20.exe` or start `release/win-unpacked/Novel Director.exe`. In an open project, Settings → Runtime information shows the application version, packaged mode and executable path. An installed older copy is not automatically updated by a new repository build. diff --git a/docs/S2_WINDOWS_QUALIFICATION.md b/docs/S2_WINDOWS_QUALIFICATION.md new file mode 100644 index 0000000..56905db --- /dev/null +++ b/docs/S2_WINDOWS_QUALIFICATION.md @@ -0,0 +1,60 @@ +# S2:Windows Setup 验收 + +唯一的真实安装入口是 [S2 Windows Setup](../.github/workflows/library-s2-installer.yml)。它只响应 `SHIN09-git/novel` 的 `codex/library-s2-installer-qa` 分支推送。在 GitHub 托管的两台临时 Windows x64 上运行,不是发布流程。只改 `docs/**`、`ROADMAP.md` 或 `scripts/benchmark-*.mjs` 不会触发;根目录 `README.md` 不在排除范围。 + +**证据边界。** 本机只读检查未发现可确认的一次性 Windows 客户机:没有可用的 Hyper-V 管理命令或虚拟机 CIM 命名空间,未找到 Windows Sandbox 或常见桌面虚拟机管理程序。仅看到计算服务运行,不足以证明有可用客户机。未安装虚拟化组件,也未在作者账号运行 Setup。本页是复测说明,不替代某一次 CI 的验收记录。 + +## Preview.21 实际验收:两条路径通过 + +2026-11-13(北京时间),[GitHub Actions 43306395735,第 1 次尝试](https://github.com/SHIN09-git/novel/actions/runs/43306395735) 在两台 GitHub 托管的 Windows x64 运行器上完成。验收源码为 `8f1beabf2a792f24f7a31d86c2e5a41aa3a793da`。两台机器使用同一份 `Novel Director Setup 0.1.6-preview.21.exe`;下载后独立重算的 SHA-256 与两台记录、构建记录及校验文件均相符: + +```text +Setup 9A78C1C8EE56D3F986FBECC8503090FB44C2A2CD141CFFC49DDF5979D691491C +app.asar E441D2A376893C438A35185E0070510AB9BB8BB36C62B34BC4681612A2086AE1 +``` + +| 路径 | 实测结果 | +| --- | --- | +| 全新安装 | 初次启动、写入两本虚构作品、在窗口中修订一章、冷启动读回三版;卸载、重装后正文和版本仍在,再卸载。 | +| 原地升级 | 安装并运行公开的 preview.20,选择非默认 SQLite,写入样本后冷启动。原地升级 preview.21 后仍选中原路径,编辑和冷启动读回通过。卸载后重装旧版,用独立副本分别验证升级后正文和升级前备份,不覆盖升级后的原文件。 | + +两份 `qualification.json` 均为 `passed`,共 10 次窗口检查;每次程序正常退出且模型请求为 0。独立 Node Agent 从各阶段预期的 SQLite 回读正文和版本链。该结果针对本次未签名 x64 安装器及虚构书库,不覆盖所有 Windows 版本或真实作品。未发布 GitHub Release。 + +## 如何运行 + +1. 由集成人确认候选提交,包含 S1、候选版本号及其锁文件、当前构建记录生成脚本和 S2 验收脚本。候选号必须高于 `0.1.6-preview.20`。只在获授权后推送到上述精确分支,不需要先修改默认分支、不需要创建 Release。 +2. 矩阵的 `S2 clean` 用现有 `npm.cmd run dist:win` 打一次 x64 Setup;该命令自带解包成品启动检查,不是安装验收。`S2 upgrade` 不打包,只等同一次运行、同一次尝试的 artifact。两台机器都下载这一份,核实 Setup 的 SHA-256、`SHA256SUMS.txt`、`BUILD_INFO.json`、提交 SHA 和包名才安装。 +3. 等两个任务结束。若需重跑,选择 **Re-run all jobs**;不要仅重跑失败的矩阵项。新尝试有独立的 artifact 名。要复核原来的安装包,保留原尝试的文件,不能用第二次构建的同版本包代替。 + +旧版取自[公开的 preview.20](https://github.com/SHIN09-git/novel/releases/tag/v0.1.6-preview.20)。`Novel.Director.Setup.0.1.6-preview.20.exe` 固定 SHA-256 为 `aa38b6dbcba629591113d928617f4ea82ee9c9dcfdfd199e67a7a9ce4c0d50ce`(与该发布的 [SHA256SUMS.txt](https://github.com/SHIN09-git/novel/releases/download/v0.1.6-preview.20/SHA256SUMS.txt) 一致)。每次执行 Setup 前重新算哈希,不下载“最新版”,不更新标签或附件。安装和卸载均为当前客户机用户的静默 NSIS 路径,不测试提升权限、全用户安装或交互向导。 + +## 验收判据 + +| 路径 | 实际动作及失败条件 | +| --- | --- | +| 全新安装 | 确认无既有安装或应用配置;运行候选 Setup;启动安装位置的应用,确认默认库为空。用桌面保存接口写入 S0 数据,在阅读页编辑并保存一章。关闭、重开,核对正文、三版版本链和独立 Agent 读数。运行真正的卸载器,检查程序和注册项消失;重装同一 Setup,默认路径和编辑仍在;再次卸载。 | +| 原地升级 | 在另一台机器安装固定的 preview.20;旧版通过桌面接口把固定 S0 备份写到非默认 SQLite 路径。关闭、重开旧版并备份已关闭的数据库。**不卸载旧版**,运行候选 Setup,不再传安装目录。候选必须接管旧位置,读到旧配置选择的原库;桌面编辑并重启后,随后运行的 Agent 必须读到同一路径和第三个版本。 | +| 回退 | 卸载候选、重装固定旧版。旧版先在单独配置目录打开升级后数据库的**副本**,验证编辑及三版链;另在新文件和新配置目录恢复升级前 SQLite 备份,验证原正文及两版链。两次均检查升级后原库的哈希不变。即使新版文件兼容性检查失败,也尝试备份恢复;前一失败不会因后一成功变绿,应记录为“仅备份回退已证实”,交由集成人判定。 | + +每次启动都核对运行中的 exe、成品模式和 renderer 来源。应用版本以已安装 `app.asar/package.json` 和运行中应用报告为准;记录注册表 `DisplayVersion`,但不用它决定预发布后缀。候选应用的 asar 哈希、Electron 和 better-sqlite3 版本须与构建记录一致;依赖版本也与锁文件比对,记录实际原生绑定文件的校验值。只有安装后的界面能在 SQLite 上读写并在冷启动后读回才通过。 + +两本书的项目 ID、章节 ID、正文哈希、已采纳草稿、提交回执、版本 ID 和父版本、另一项目待续跑任务的步骤与检查点,均对照 [S0 清单](../scripts/fixtures/library-preview20/manifest.json)。编辑必须产生一条引用原第二版的新手动修订,原记录保留。Agent 在独立 Node 进程中仅指定应用配置目录,**不传数据库路径**;它自己选中的后端必须是 SQLite,不接受 JSON 回退。样本模型地址限制为回环拒绝端口;不启动生成任务,不携带模型凭据。 + +## 取回证据 + +在对应提交的 Actions 运行页下载以下三个 artifact,保留 **run ID、attempt、commit SHA、Setup SHA-256**: + +- `s2-setup--`:实际分给两台机器的 Setup、`SHA256SUMS.txt`、`BUILD_INFO.json`。 +- `s2-clean-report--` 和 `s2-upgrade-report--`:每台的 `qualification.json` 记录 NSIS 的命令、退出码、注册项、安装位置和哈希;各阶段 JSON 记录桌面及 Agent 回读、版本链、绑定、模型请求数和失败原因。若在安装前就失败,可能只有 job 记录;详见对应步骤日志。 + +按原始字节自行核对下载的 Setup、两份报告中的候选 SHA-256、构建记录中的提交与 asar 哈希。两份报告都须为 `passed`,关键阶段不能缺失。artifact 保留 14 天,长期留存由集成人负责。解包成品启动、静态检查、合成测试或单台成功都不能证明两条路径通过。 + +## 本地复测 + +只运行以下命令。它使用仓库内虚构样本的临时副本,通过真实的 SQLite 修订事务和 Node Agent 验证回读,不启动 Electron、不安装程序、不接触作者书库: + +```powershell +node --test scripts/s2-windows/readback.test.mjs +``` + +该测试覆盖原始两版及修订后三版回读、损坏样本拒绝、升级前备份异地恢复、拒绝覆盖已有文件及拒绝复制尚有未写回日志的数据库。真实安装脚本有托管环境检查;不要在本机设置 CI 环境变量来绕过它。 diff --git a/docs/S3_LIBRARY_PERFORMANCE.md b/docs/S3_LIBRARY_PERFORMANCE.md new file mode 100644 index 0000000..874a0b4 --- /dev/null +++ b/docs/S3_LIBRARY_PERFORMANCE.md @@ -0,0 +1,83 @@ +# S3 书库性能:同机桌面对照 + +这份记录只使用合成书库。不打开真实作品,不调用模型,不运行安装器,不评价安装升级。测试源为干净的 S1 提交 `804f738`。S1 计时使用已验收的 `tmp/s1-final/win-unpacked`,改后只认本工作树的 `release/win-unpacked`;版本号变化本身不是 S3 已打包的证据。 + +## 结果 + +**未到期时,打开项目、采纳和修订分别比 S1 少等 72.5%、74.5% 和 98.1%(比较中位数);启动没有提速。** 改后程序在本地从 `6563d15` 对应的生产代码打包,包含 S3-A/B 及 S4 自动备份。到期组测得的是这个组合成品,不是 S3 或 gzip 的单项效果。 + +| 操作 | 未到期 S1 | 未到期改后 | 到期 S1 | 到期改后 | +| --- | ---: | ---: | ---: | ---: | +| 启动至项目列表可用 | 1,882 / 1,989 | 1,957 / 1,990 | 1,924 / 2,382 | 1,921 / 1,975 | +| 进入已有项目 | 1,389 / 1,440 | 382 / 466 | 2,667 / 3,010 | 1,940 / 2,000 | +| 确认已审稿草稿至采纳成功 | 863 / 878 | 220 / 243 | 2,330 / 3,086 | 1,817 / 1,922 | +| 确认修订至正式提交成功 | 860 / 877 | 17 / 50 | 2,464 / 2,624 | 1,683 / 1,726 | + +单位毫秒,每格为 **中位数 / 最慢一次,n=5**,均另有一次不计入的热身。启动尚未触发写入,两种备份条件下启动的小幅差异不能解释为备份成本。测量依次完成,未锁定系统后台负载;只比较本机本样本。17 毫秒接近两帧就绪检查的分辨率,不代表 SQLite 事务本身耗时 17 毫秒。 + +**未到期的逐操作诊断**(各 1 次,未参与计时)。箭头左为 S1,右为改后: + +| 操作 | 整库正文读取次数 | SQLite 返回的实体 JSON 行 | IPC 请求字节 | IPC 应答字节 | 净变更实体 | +| --- | ---: | ---: | ---: | ---: | ---: | +| 启动 | 1 → 1 | 30,921 → 30,921 | 0 → 0 | 172,845,392 → 172,845,391 | 0 → 0 | +| 进入 | 0 → 0 | 0 → 0 | 172,845,273 → 246 | 235 → 282 | 1 → 1 | +| 采纳 | 1 → 0 | 30,921 → 11 | 31,944 → 31,944 | 419 → 418 | 5 → 5 | +| 修订 | 1 → 0 | 30,923 → 6 | 46,922 → 46,922 | 363 → 362 | 5 → 5 | + +S1 进入项目虽然未读取全部实体正文,但枚举了 **30,921 条集合/ID** 并接收完整书库;改后该枚举为 0,两版均只改变目标项目的实体 JSON。采纳和修订的 IPC 提交包大小没变,改善位于数据库校验读:改后仅返回 43,475 和 68,937 字节实体 JSON,带第二本书 ID 前缀的行从各 9,470 条降为 0。启动仍读完整书库并传给窗口;此处不能宣称已做历史按需加载。改后两项正式提交的结果、回执与正文均已回读;不是用减少写入冒充提速。 + +**到期时**,启动、进入、采纳、修订的整库正文读取次数由 `1/1/2/2` 变为 `1/1/1/1`;三个写操作都真实生成了备份。改后三项的 IPC 请求/应答及净变更实体数与上表一致,但备份各需读取一次完整库。仅看打开项目这一次,到期时 S1 自动 JSON 为 179,005,905 字节;改后自动 gzip 为 5,213,522 字节,**另有 179,005,905 字节的普通回退 JSON**。这次写出的两份文件合计 184,219,427 字节,不能把 gzip 单文件当成总磁盘占用。本档 720 章样本未测 7 份轮替后的长期占用;另见 [S4 的 500 章轮替实测](./S4_AUTO_BACKUPS.md#测量)。未到期的两版均已实证:单一兼容备份条目、大小、标识、修改时间及内容哈希未变。 + +**S4 取舍:** 若目标是减少打开列表的传输,值得先测只读项目概要:启动应答仍约 165 MiB,最大的生成步骤集合占 43.34%。若目标是减小新历史,两个回执集合合计占 24.54%,这是整个集合的体积,**不是可回收量**;早期采纳稿与后续修订链确有不同正文,不能用“留最后成功稿”代替历史。这些是下一次实验方向,不是已经测出的优化收益。 + +原始样本、42 个集合的字节数、SQL 形状及回读证据见 [S1 数值记录](../scripts/performance/s3-before.json) 和 [改后数值记录](../scripts/performance/s3-after.json)。包内依赖指纹一致;两版规范化依赖锁哈希均为 `785b1000108997831132713949eeadd955f0f5468c8dba4f8fd6809695392c2a`。S1 和改后 app.asar SHA-256 分别为 `4b235d3221f59c64f69a8dd7182a521f2e12e9eb296fb41053f8f65f0a9614ae`、`7727b338110c6e6cc25ca9f82304368e68cfe82154ebd6456661e99865a6572b`;同一 SQLite 种子为 `978c6f1da08db48ff3428c0e798e88f1896a1ce781494bb82f319183639a0946`。 + +## 样本与回读 + +种子 SQLite 文件为 190,050,304 字节;经 S1 存储服务保存并回读的 AppData,序列化为**无缩进 UTF-8 JSON** 后是 **172,845,159 字节(164.84 MiB)**。SQLite、JSON、自动备份是三种不同口径。配方使用已有长篇合成器,主项目 500 章,另一本 220 章;不是给小库追加无关填充文本。42 个数组集合合计 30,921 个实体。正式对照需要每轮复制同一份已关闭的 SQLite,而不是为两版分别造库。 + +| 集合 | 条数 | 紧凑 JSON 字节 | 整库占比 | +| --- | ---: | ---: | ---: | +| chapterGenerationSteps | 20,202 | 74,910,523 | 43.34% | +| chapterCommitBundles | 720 | 28,969,153 | 16.76% | +| chapterVersions | 1,800 | 16,162,133 | 9.35% | +| promptContextSnapshots | 720 | 13,739,653 | 7.95% | +| revisionCommitBundles | 360 | 13,442,541 | 7.78% | +| generatedChapterDrafts | 1,441 | 13,024,850 | 7.54% | +| chapters | 720 | 7,101,693 | 4.11% | +| generationRunTraces | 721 | 2,817,267 | 1.63% | + +每个集合按 `Buffer.byteLength(JSON.stringify(array))` **实测**,包括方括号和逗号,不含集合键名;空集合为 2 字节。整库还包含设置、键名和顶层结构。完整明细随原始数值记录给出。合成文本重复有规律,其压缩率不能外推为真实小说的节省比例。 + +两个项目每章都有较早的采纳回执和之后生成的不同草稿;每四章有两轮相连的正式修订,每本另有一次失败中断。每轮先核对桌面实际使用的是本轮 SQLite,再从这份库只读核对: +- 两本书各抽第 4 章:回执仍指向较早、状态为 accepted 的草稿;回执正文与当时版本相同。后来的草稿属于另一个已完成的生成任务,正文不同、状态仍为 draft。两份修订回执前后正文衔接、父版本衔接,最终正文与第二份修订一致。 +- 两个 unfinished 任务的失败步骤均为 generate_chapter_draft;之前有已完成且保留输出的步骤,之后有 pending 步骤。检查的是**保留续跑所需的记录**,没有实际调用模型续跑。 +- 另外核对两个**通过窗口提交**的目标:主项目第 2 章走已审稿采纳,回执关联匹配的质量报告与编辑裁定;第 500 章接受一份有来源正文哈希的修订。各新增一份正式回执;两处正式正文、修订版本及候选状态均须与提交一致。 + +## 测量口径 + +Windows x64,Ryzen 7 7800X3D,16 个逻辑处理器,33,397,133,312 字节内存。两边均核对 Electron 实际版本 44.9.1、better-sqlite3 13.0.3、原生模块哈希及包内依赖文件指纹。锁文件核对 `lock.packages`:**只删除** `packages[""].version`,递归排序对象键、保留数组顺序,对紧凑 UTF-8 JSON 求 SHA-256。这样根包名称、依赖声明、传递依赖和完整性字段仍参与比对;不要求整个文件字节相同。 + +- **计时**:实际解包程序、全新进程和临时用户目录。每种备份条件各 1 轮热身、5 轮正式样本,串行;不清操作系统文件缓存。复制种子、造备份和读回都在计时之外。启动从生成进程开始,到列表显示两个项目且目标“进入”可用;打开从原生鼠标点击到工作台显示正确项目且导航可用。采纳和修订分别从最后一次原生确认点击到界面显示该次提交成功。条件连续两个动画帧成立。选择项目、导航、阅读、首次点击与最终确认之间的等待不计入提交耗时。 +- **备份**:未到期时提供可读的合成整库 JSON,文件名为 `novel-director-