Storydex v0.4.0

Storydex v0.4.0

本次更新完成 Provider usage 来源治理，并将 Storydex 的 Coomi 运行时固定到基于官方 1.1.2 制作的专用适配版。

用量统计

• 明确区分上游报告、缺失、历史未知和本地估算 usage。
• 支持 OpenAI-compatible 与 Anthropic 返回的输入、输出、缓存和推理 token。
• 流式响应中的累计 usage 快照只记录一次终态值，避免重复累加。
• Provider 未返回 usage 时保持缺失状态，不再用字符估算冒充真实用量。

运行与发布稳定性

• 项目 Python、全哈希依赖锁、桌面内嵌 Python 和安装包统一使用 coomi-agent==1.1.2+storydex.usage1。
• 专用 wheel 固定来源和 SHA-256，并纳入桌面同步、内嵌运行时和打包资产校验。
• 长会话真实验证覆盖同一会话连续 3 轮、11 次 Provider 请求，usage 覆盖率 100%，录制与回放结果一致。
• 完整后端、前端、桌面打包和 packaged E2E 发布门禁通过。

已安装用户可在 Storydex 内检查更新；便携版用户请下载新版本并重新解压。

Storydex v0.3.10

Storydex v0.3.10

本次为长会话与发布稳定性更新。

• 按 Storydex 项目与 sessionId 隔离 Agent 运行态、意图状态和会话恢复，避免跨工作区串用上下文。
• 完善 ContextTrace：记录上下文来源、候选与实际纳入量、截断、重复段落、Provider 请求及 token 估算，便于定位长会话问题。
• 增强 LLM 录制/回放一致性，规范工具参数、稳定路径与累计 usage 快照，并在请求结束后回收请求级指标。
• 修复重复工具开始状态；继续保证需复核的故事知识变更不写入，混合批次只持久化已接受操作。
• 修复本地 Release 版本漂移、编码校验误扫本地输出和前端回归测试先于生产构建执行的问题。

已安装用户可在 Storydex 内检查更新；便携版请下载新版本重新解压。

Storydex v0.3.9

Storydex v0.3.9

本次为稳定性更新。

• 修复部分模型服务下 token 统计异常、上下文过早压缩的问题。
• 修复工具执行状态重复显示。
• 加强故事知识变更保护，需复核的删除不会被自动写入。
• 完善内置运行环境和依赖一致性检查。

已安装用户可在 Storydex 内检查更新；便携版请下载新版本重新解压。

Storydex v0.3.7

Storydex v0.3.7

本版本同时包含原计划 v0.3.6 的稳定性改进，并修复 Windows 环境下的 Agent HTTPS 连接问题。

AI 稳定性与诊断

• 提升 AI 对话与任务执行在不同安装环境下的稳定性和一致性。
• 加强启动时的运行环境检查，依赖异常时提供更明确的诊断信息。
• 完善安装包与便携包的兼容性验证，降低环境差异导致的启动和运行异常。

Windows HTTPS 连接修复

• 修复部分 Windows 环境调用 LLM Provider 时持续出现 APIConnectionError 或 SSLEOFError 的问题。
• 优化 Python 运行时选择，避免迁移环境中不匹配的 OpenSSL 组件影响 HTTPS 连接。
• 内嵌运行环境保持统一并经过发布前验证。

安装方式

• 已安装 v0.3.5 及更早版本的安装版用户，可在 Storydex 内检查更新并升级到 v0.3.7，也可下载完整安装包覆盖安装。
• 便携版用户请下载 v0.3.7 便携包并重新解压。
• 安装包与便携包均内置 Python 3.9、后端依赖和 MinGit，无需另行安装 Python 或 Git。

Storydex v0.3.5

Storydex v0.3.5

大文件与工作区体验

• 小于 2MB 的文件保持完整编辑，2～20MB 文件渐进加载，大于 20MB 默认进入只读快速预览。
• 首屏按约 256KB 分块读取，支持 UTF-8 字符边界、BOM、后台行索引、LRU 缓存、快速跳转和过期请求取消。
• 资源浏览器空目录提示更紧凑，并新增统一问题面板与错误、警告、迁移提示分级。

长期记忆与变量

• .storydex/memory 只保存正式变量、事实、人物状态、关系、时间线等长期记忆，禁止写入历史会话、工具日志和临时文件。
• 历史会话继续保存在 .storydex/.agent/sessions；.storydex/temp 仅作为普通临时工作台，不参与索引、诊断、自动清理或常规上下文注入。
• 引入自适应模块目录、schemaVersion、稳定 ID、revision、变更账本、恢复点和非破坏性旧项目迁移。

诊断、依赖与安装

• UTF-8 BOM 可兼容读取并一键移除；诊断标记与 Git 修改状态彻底分离。
• 开发、CI 和安装包内嵌环境严格固定并验证 coomi-agent==1.1.2。
• 差分安装使用独立可见的辅助窗口，展示安装进度、失败恢复和日志；安装锁阻止半更新状态启动，完成后由用户选择是否启动 Storydex。

安装方式

已安装 v0.3.4 的用户可在 Storydex 内检查并下载 v0.3.5。安装包与便携包继续内置可迁移 Python 3.9 环境、完整后端依赖和 MinGit，无需额外安装 Python 或 Git。

Storydex v0.3.4

Storydex v0.3.4

桌面差分更新热修复

• 修复 v0.3.3 差分安装完成时强制立即拉起程序，可能在应用文件仍处于替换窗口时触发 Cannot find module ... electron-updater/out/main.js 主进程错误的问题。
• 安装更新后不再强制抢跑新进程；静默安装完成后由用户重新打开 Storydex，避免读取到半更新状态的运行目录。
• 自动更新组件遇到临时模块加载失败时会按确定性间隔重试，文件就位后自动恢复更新能力，不再永久停留在“缺少 electron-updater 依赖”状态。
• “更新与关于”页面不再重复显示同一条不支持更新错误，并明确显示更新组件初始化状态。
• 打包资源检查新增 electron-updater/out/main.js 强制校验；Electron E2E 新增安装切换窗口模拟，验证入口文件短暂缺失后能够自动恢复。

更新方式

已安装 v0.3.3 的用户可以检查并下载 v0.3.4。安装开始后 Storydex 会退出，安装完成后请手动重新打开应用。也可以下载完整安装包覆盖安装，项目文件、会话记录和用户配置不会随应用安装目录替换而删除。

安装包与便携包继续内置可迁移 Python 3.9 环境、后端依赖和 MinGit，无需额外安装 Python 或 Git。

Storydex v0.3.3

Storydex v0.3.3

修复与体验改进

• 修复桌面冷启动、离线运行或字体首次加载失败时 Material Symbols 图标空白的问题；加入重试、超时状态和可见降级。
• Coomi 请求进入后立即返回 RunAccepted，意图识别、上下文装配、任务规划和模型等待期间持续输出带耗时的阶段事件与 heartbeat。
• 将 Coomi/OpenAI provider 冷启动初始化移出 SSE 事件循环，避免首次导入阻塞 heartbeat。
• 意图 LLM 最长等待 2 秒，超时使用确定性 heuristic fallback；明确指令优先走快速路径。
• 恢复应用重启后的真实 Coomi JSONL 会话上下文、上一轮助手回复和 pending action；项目与 sessionId 完全隔离。
• 修复活动文件位于 chapters/ 时省略指令被错误判定为新剧情生成的问题。
• 优化 Git 提交确认面板：点击后立即反馈、跳过走快速路径、自动提交说明超时后使用本地回退。
• 修复启动阶段旧历史响应覆盖正在运行会话、导致末尾 Git 提示丢失的竞态。
• Windows 安装包和便携包内置可迁移 Python 3.9、后端依赖与 MinGit，无需用户另行安装 Python/Git。
• 正式包自动排除测试目录、coverage、pytest 缓存、日志、.env 等开发期文件。
• 新增后端、前端和 Electron 分层测试、统一 Fast/Full/Release 测试入口、可复用 CI 质量门禁和打包冒烟验证。

从 v0.3.2 更新

安装版可在应用内检查 v0.3.3。更新源同时提供 latest.yml、v0.3.3 installer 与对应 blockmap，electron-updater 会优先执行 v0.3.2 → v0.3.3 差分下载；也可直接下载完整安装包覆盖安装。更新失败时不会删除现有 v0.3.2 安装，用户仍可重新启动旧版本。

本地 Git 功能只为小说项目创建本地提交，不自动配置远程仓库，也不会自动 push。

Storydex v0.3.2

Storydex v0.3.2

本次为桌面版应用内更新热修。

修复

• 修复更新源未正确保留，导致「检查更新」按钮不可用的问题。
• 恢复应用内检查更新和后续差分更新。

升级说明

• v0.3.0 和 v0.3.1 用户请手动下载 v0.3.2 覆盖安装一次。

Storydex v0.3.1

Storydex v0.3.1 Windows 修复版

Storydex v0.3.1 修复桌面版应用内更新入口在部分安装包中缺少更新源配置的问题。

修复

• 修复点击「系统设置 -> 更新与关于 -> 检查更新」时可能报错 ENOENT: no such file or directory, open ...\\resources\\app-update.yml 的问题。新版客户端会在运行时显式设置更新源，不再单独依赖 resources/app-update.yml。
• 修复 Windows 安装包未携带 resources/app-update.yml 的问题。后续安装包会在打包阶段写入更新源配置，指向 https://updates.septemc.com/storydex/windows/。

下载内容

• StorydexSetup-x64-0.3.1.exe：Windows x64 安装包，推荐大多数用户下载。
• Storydex-win-unpacked.zip：免安装版本，解压后运行 Storydex.exe。
• SHA256SUMS.txt：发布文件校验值。

以下文件用于应用内更新，不需要手动打开：

• latest.yml
• StorydexSetup-x64-0.3.1.exe.blockmap

升级说明

• 如果已安装的 v0.3.0 点击检查更新时报缺少 app-update.yml，请直接下载 v0.3.1 安装包覆盖安装一次。安装 v0.3.1 后，后续版本即可继续通过「系统设置 -> 更新与关于」进行应用内差分更新。
• Storydex 不会主动删除用户项目；升级前仍建议确认重要写作项目已经备份或提交到版本控制。

Storydex v0.3.0

Storydex v0.3.0 Windows 正式版

Storydex v0.3.0 现已发布。本版本重点升级 Agent 的意图理解、检索与记忆能力：Agent 改用 LLM 结合项目语义做意图路由，准确理解你想续写、改设定还是整理资料；续写时会自动带上章节摘要、相关旧文与 WIKI 参考，Agent 也学会了在引用旧情节前先查证，显著减少长篇写作中的前后矛盾。桌面版应用内更新支持差分下载，升级新版本不再需要重新下载完整安装包。同时改进 WIKI 图谱稳定性、上下文配置能力，并强化项目文件安全边界。

建议所有用户升级到此版本。

新增功能

• 新增应用内差分更新。在「系统设置 → 更新与关于」检查并下载新版本时，只下载与已安装版本有差异的部分，不再重新下载完整安装包，显著节省流量和等待时间。首次通过应用内更新升级时仍会下载完整安装包，之后的每次升级自动使用增量下载。
• 新增智能意图路由。Agent 判断你这轮想做什么（续写正文、设计角色、维护世界书、写剧本大纲、整理 WIKI、整理项目目录等）不再依赖关键词匹配，而是由 LLM 结合项目技能注册表与上一轮对话做结构化分类：「然后呢」「继续」这类省略式请求也能正确延续上一轮意图；识别出的意图会连同产出落点（如角色设定 → .storydex/characters/）和匹配技能一起注入执行上下文，Agent 清楚这轮产出该写到哪里。项目里自定义的新技能类型会自动加入可识别范围。LLM 不可用或超时会自动回退关键词模式，功能不中断。
• 新增 Agent 项目检索工具。Agent 现在可以对章节正文、角色、世界书和记忆做相关性排序的全文检索（针对中文优化），也可以直接查询 WIKI 知识图谱中的实体、关系与伏笔。续写涉及较早剧情时，Agent 会先查证原文再落笔，查不到的细节不再凭空编造。
• 新增滚动章节摘要。Agent 每轮续写会顺带维护一份 150-300 字的本章摘要，下一轮生成时自动注入最近章节的剧情脉络，弥补「最近几段正文」与「人物设定」之间缺失的中程记忆。
• 新增相关旧文段落召回。生成上下文会自动检索与当前活跃角色相关的旧文摘录（如几十章前的道具、地名、伏笔），作为续写参考。
• 新增 WIKI 参考条目注入。当前场景涉及的角色/设定若已有 WIKI 条目，其摘要会连同置信度一起注入上下文；待审阅条目不会注入，避免未确认的推断影响正文。
• 新增「上下文窗口（tokens）」配置项。在 LLM 配置面板中可按所用模型填写真实上下文窗口，Agent 的自动压缩阈值随之生效——使用小窗口模型时不再因阈值失真而爆上下文。

改进

• 界面视觉全面收敛：清理早期遗留的「药丸按钮 + 大圆角卡片 + 悬浮光晕」风格，统一为贴近 VS Code 的紧凑工作台质感——全局圆角收敛到 4/6px 两档（仅设置窗口 8px），按钮、输入框、弹层、标签全面锐化；悬停不再位移发光，顶栏与弹窗遮罩去除毛玻璃模糊，弹层投影收敛为贴边短投影；圆形语义元素（加载环、进度环、头像、开关、计数徽章）保持全圆。同时保留 Storydex 的暖色强调与五套主题个性。
• 续写上下文全面重排：最近正文片段紧随预设注入，不再被记忆块挤占预算；上下文总预算从 7600 字符提升到 10000 字符，尾部信息不再被静默丢弃。
• WIKI 关系边容量从 300 提升到 1200，超出上限时按「结构关系优先、权重降序」智能淘汰，不再按顺序硬截断；角色共现关系去除了方向重复。
• Agent 的文件读写与命令执行显式绑定当前小说项目目录，不再依赖进程级目录切换，多项目、多会话场景更稳定。
• 全文检索索引增量更新：只重建有变动的文件，已删除文件自动清出索引。

修复

• 修复续写时章节目录反复产生同名空目录的问题（如同时出现「第1章 苏家少年」和空的「第一章 苏家少年」）。根因是章节规范名用中文数字、而默认模板与实际落盘用阿拉伯数字，目录归一重命名与写入互相打架。现在章节命名统一为阿拉伯数字（第1章、第2章），异体命名的写入路径会自动归并到现有章节目录，历史遗留的同章号空目录会在下次打开或生成时自动清理；章号唯一的空章节目录（例如你手动新建的待写章节）不受影响。
• 修复 WIKI 章节条目在插入、删除或重命名章节后互相错位覆盖的问题。章节条目现在使用稳定标识，旧图谱会在下次打开或同步时自动完成迁移，无需手动处理。
• 修复预设编译失败被静默忽略的问题。编译出错时对话流会显示「⚠ 预设编译失败（已回退为原文摘要）」，预设状态工具同步报告编译健康度。
• 修复中文全文检索基本失效的问题（索引改用中文二元分词）。
• 修复 WIKI 同步在异常数据下可能报错中断的问题。

安全

• Agent 的写入操作新增工作区硬边界：目标路径不在当前小说项目内时一律拒绝，任何权限模式（包括完全访问）下都不例外。默认权限保持「完全访问」，日常使用体验不变。

下载内容

• StorydexSetup-x64-0.3.0.exe：Windows x64 安装包，推荐大多数用户下载。
• Storydex-win-unpacked.zip：免安装版本，解压后运行 Storydex.exe。
• SHA256SUMS.txt：发布文件校验值。

以下文件用于应用内更新，不需要手动打开：

• latest.yml
• StorydexSetup-x64-0.3.0.exe.blockmap

升级说明

• 从 v0.1.x 升级时，请下载新版安装包直接覆盖安装；本版本起即可在「系统设置 → 更新与关于」中检查并增量更新后续版本。
• 从 v0.2.x 升级时，可直接在应用内检查更新并安装。
• WIKI 图谱数据结构升级到 v4：首次读取或增量同步时自动全量重建，过程无需人工干预。
• 全文检索索引位于项目 .storydex/.cache/ 目录，首次使用时自动构建，可随时删除，下次会自动重建。
• 如需关闭自动旧文召回，可在项目 .storydex/config/feature-flags.json 中将 CONTEXT_PIPELINE_FTS5 设为 false。
• Storydex 不会主动删除用户项目；升级前仍建议确认重要写作项目已经备份或提交到版本控制。