Changelog

新增

• 本机 Coding Agent 执行与原角色回报（#820）
• 任务管理与配置重载期间的追踪（#821）
• add task dashboard and observed progress（#822）
• session 默认 default，设置页从本机 session 列表选择（#835）
• 面板按 workspace 显示 session 全部 agent（#837）

修复

• 运行时代切换中断在途后台任务，插件开关不再卡死（#826）

改进

• 看板 RPC 改 list/get，界面按宿主二级栏重做（#827）
• 删除 message_push 中不可达的「角色外部渠道记会话」分支（#836）

新增

• 每日发版生成中文 Release 说明（#796）

修复

• 导入角色卡时不再误报「超出工作区」。
• 新建角色页面的布局与角色详情对齐，资料输入框的状态显示正确。

改进

• 侧栏与主面板之间的分界阴影调淡，界面更清爽。

新增与改进

• 角色好感度：新增七个关系阶段、对话中的好感变化、长期未联系时的衰减、变化历史与分阶段语气设置。
• 桌宠直播陪伴：支持 B 站扫码登录、接收直播间弹幕、回复排队，以及桌宠气泡与语音输出，可暂停、继续和结束陪伴。
• 本地语音：内置 SenseVoiceSmall 语音识别和 GPT-SoVITS 语音合成插件，支持独立环境下载或导入、选择安装位置、空间检查和环境删除。角色声音收进能力卡片，支持自动保存和按情绪配置参考音频。
• 角色卡导出：支持预览并导出 CHARX、PNG、JSON 角色卡。
• 聊天与 QQ：切换会话保留草稿，支持拖入图片；QQ 支持读取当前消息及引用消息中的 TXT、Markdown 附件。

修复

• 后台消息插入时，流式回复仍归属原来的聊天回合。
• 取消对话时发出终止事件，让桌宠语音及时结束。
• 空回复重试保留工具调用能力。
• 修复 Windows 通知身份与点击唤起异常。
• 删除角色时清理其定时任务；NovelAI 的 CG 补充不再影响主动互动状态。

升级说明

• 原腾讯、MiniMax 语音实现已移除。旧文件、密钥和远端音色不会被删除，也不会自动转换为本地语音配置。需要语音时，请启用相应插件并配置服务、参考音频和桌宠语音。
• 两个本地语音插件默认停用，大型模型与推理环境不包含在安装包中，需要单独下载、导入或连接已运行的本机服务。
• SenseVoiceSmall 使用 CPU；GPT-SoVITS 托管环境需要 NVIDIA CUDA。
• 直播陪伴通过桌宠显示和朗读回复，不会向 B 站发送弹幕。
• 本版内置 SDK / Runtime API 3.1.1，合并此前尚未发布的契约变更。使用旧 SurfaceHandle.voice 或关系字段 closeness 的外部插件需要更新适配；声明 >=3.1.0 <4.0.0 本身不会阻止这类旧插件加载。详见插件运行时契约。
• 20 个已有内置插件统一为 0.1.1，两个新增语音插件保持 0.2.0。SDK 与插件自身版本各自独立，后续按正式发布批次更新。

插件 SDK 3.1.1 已同步发布到 npm 和 PyPI。插件开发者可直接安装新版，并按兼容说明适配已移除的接口。

修复工作摘要在上游报告未超预算时，仍被本地估算误判为超限、导致上下文压缩失败的问题。

修复与改进

• 工作摘要优先使用模型接口返回的有效输出用量，并扣除明确报告的思考用量；无法取得可靠用量时才采用明确标记的本地估算。
• 在「设置 → 高级 → 上下文压缩」新增「工作摘要长度上限」，默认 2000 token，可按需要调整。
• 摘要来源消息 ID 保序去重；完整但超长的摘要最多自动缩写一次。格式无效或输出截断时仍明确报错，保留原窗口、原摘要和已整理的记忆。
• 超限详情展示本次计数及计数来源，诊断日志补齐每次摘要尝试的预算与结果。
• 完善 Windows 自动发布流程和发布制品校验。

曾遇到“工作摘要超过 2000 token 上限”的用户，可在升级后再次手动压缩；对于上游实际用量未超限的情况，无需提高默认预算。

0.5.0 汇总了自 0.4.0 以来的 53 个提交，重点是长对话的上下文管理、后台消息通知，以及独立发布的插件 SDK。

主要更新

• 更可控的长对话：按模型实际上下文容量管理输入预算，结合接口返回的用量校准估算。接近容量时自动整理记忆、生成工作摘要并压缩上下文；可设置自动压缩阈值和希望保留的最近完整对话轮数，预算不足时会减少保留轮数。聊天原文继续保存在历史记录中。
• 上下文用量与手动压缩：聊天输入区新增用量圆环，可查看上下文占用并手动压缩，也可使用 /compact。操作反馈显示压缩结果，并区分记忆已整理但压缩失败的情况；切换角色后保留已读取的用量。
• 后台消息通知：桌面窗口在后台时，桌面对话中的新回复可触发系统通知，点击通知进入对应角色的对话。
• 角色设置改进：主动推送开关及相关设置集中到角色能力页；角色资料支持折叠，长文本展示更易浏览。
• 公共插件 SDK：TypeScript 包 @yinfengwindy/shiori-sdk 与 Python 包 shiori-sdk 已公开发布，提供插件契约、共享界面组件与独立测试支持。内置插件统一通过 SDK 使用宿主能力。

修复与改进

• 修复空正文回复和模板回复的恢复处理，改善错误归因、恢复操作与诊断详情。
• 改进工作摘要的分批生成及预算管理，修复手动压缩的保留轮数与反馈问题。
• 修复上下文压缩时，模型返回额外摘要字段导致“记忆已整理、压缩失败”的问题，并完善摘要生成约束和错误提示。曾遇到此问题的用户可在升级后手动重试压缩。（#662）
• 新绑定的渠道私聊只将绑定后的消息加入共享用户上下文；绑定前的聊天原文仍保留。
• 修复 QQBot 账号重连时入站状态丢失，以及渠道停止时插件资源过早释放的问题。
• 升级 Browser Use 原生运行时，修复错误输出可能导致操作卡住的问题。
• 合并配置保存，避免重复重启插件；共享桌面事件订阅，减少重复监听。
• 清理回复中不完整的引用标记，更新配置示例和使用文档。

升级注意事项

• 模型容量：请在模型设置中确认实际上下文容量。旧的容量字段会自动迁移；缺少容量的模型需要补填后才能开始对话。自动压缩阈值可选。
• 第三方插件：本版 Runtime API 为 3.1.0，仅声明兼容 2.x 的旧插件需要升级。插件开发者需迁移到公共 SDK；前端使用旧 SDK 包名的插件必须更新为 @yinfengwindy/shiori-sdk 并重新构建。详见 SDK 文档。应用版本与 SDK 版本独立，本次应用升级不改变 SDK 的 3.1.0 版本。
• Akasha：已移除内置 Akasha 引擎。若配置中显式指定了 memory.engine = "akasha"，需改为已安装的记忆引擎后启动。原有 Akasha 工作区数据不会自动迁移或删除。

0.4.0 汇总了自 0.3.1 以来的 119 个提交，重点是多渠道账号、群聊旁听、分层记忆，以及焕新的桌面界面。

主要更新

• 角色走进群聊：新增群聊旁听，未被叫到时也能了解群里的前文；被 @ 或在渠道支持时被回复才开口。旁听记录按群整理，角色可查询成员档案、群笔记和最近动态。
• 小手机：在独立的小手机界面查看外部渠道的会话与实时消息，展示群和发送者头像、消息来源及 QQ 引用内容；群聊详情可查看笔记、最近动态和成员档案。桌面聊天页聚焦桌面对话。
• 多渠道账号：Telegram、QQ（NapCat）、QQBot 和飞书统一采用插件与角色账号管理，支持多账号隔离、账号状态与删除、群聊黑名单及用户身份绑定。QQ 新增托管 NapCat 登录与进程管理，飞书支持长连接与流式卡片。
• 更清楚的记忆边界：区分用户本人、群友与外部上下文，外部对话不注入用户私人记忆；群环境、成员档案和用户记忆分别整理，群消息不会挤掉桌面原文窗口。角色页提供 Markdown 记忆、语义记录与时间线。
• 桌面界面焕新：更新导航、聊天、角色、设置、生图和首次引导；看板娘吟风出现在启动、空状态、确认及错误反馈中，并加入角色转场、心情动效与减少动态效果适配。
• 浏览器与电脑操作：加入 Browser Use 和 Computer Use 插件，支持浏览器操作、截图及 Windows 窗口操作；全新安装默认关闭，可按需启用。
• 插件开发：提供 @shiori/plugin-sdk，统一共享组件、样式、宿主服务与契约；扩展渠道账号、头像、旁听和引用消息支持。

修复与改进

• QQ 回复支持随文字发送图片、读取引用原文与图片，长文本改为合并转发；托管 NapCat 与桌面 QQ 使用独立登录目录，并清理退出后的残留进程。
• 修复 QQBot 流式收尾竞态及失败后的重复发送，完善普通回复和主动推送的实际投递记录。
• 主动推送结合桌面在场与最近对话选择目标，改进同角色消息顺序与图片记录。
• 修复中文标点旁的加粗、单换行和深层标题渲染，以及表情面板裁切、记忆搜索和分页问题。
• 减少重复证书加载、启动时全文索引重建和数据库建表开销；渠道重试不再阻塞其他渠道。

升级与下载

Windows x64 用户可通过「设置 → 关于」检查更新，或下载 Shiori-Setup-0.4.0.exe 安装。

本版渠道账号统一在角色页管理；升级后请在角色页核对账号连接状态，并通过身份绑定让角色认出各渠道中的你。群聊旁听可在小手机的群聊详情中设置。

Windows shell 工具需要 PowerShell 7（pwsh 在 PATH 中）。latest.yml 与 .blockmap 用于应用内更新，下载文件的 SHA-256 校验值见 SHA256SUMS.txt。

发布源码：d32d98e7847a70a9461525bd33fd6b156ad7a2d0。

完整变更

修复

• 修复角色偶尔返回旧格式 JSON 时，聊天和语音直接输出整包内容的问题；现在只显示或朗读正文（#333）。
• 流式回复、最终消息和新保存的聊天历史保持一致，普通文本继续实时输出。

升级

从 0.3.0 可通过应用内检查更新升级，也可下载 Windows x64 安装包 Shiori-Setup-0.3.1.exe。

本版本将此前补入 0.3.0 的修复以独立补丁版本发布，让已安装 0.3.0 的用户可以正常收到更新。无需手动迁移数据；已经保存的旧 JSON 消息不会被改写。

latest.yml 和 .blockmap 用于应用内更新；文件校验值见 SHA256SUMS.txt。

发布源码：98a5418d7ab68f65ac1c43009c8a1804a523d7d5。

修复详情

插件与扩展

• 新增外部插件 ZIP 安装、更新和卸载入口，安装与更新前展示版本、来源和信任确认，重启应用后生效。
• 支持插件提供独立页面、设置、后台任务和桌面窗口；插件设置集中到「插件」标签，点击插件标题可查看详情。
• 桌宠、NovelAI、故事模式等功能迁入独立插件，完善启停、跨插件通信、失败回滚和资源清理。
• 插件数据集中存放到工作区的 plugin-data/<id>/；卸载默认保留数据和配置，明确选择后才删除。

对话与桌面体验

• 角色回复正文直接流式输出，心情和当下想法在回复后更新；心情获取失败时仍能正常收到正文。
• 修复模型偶尔返回旧格式角色 JSON 时，聊天与语音直接显示或朗读整包内容的问题；现在仅输出正文（#333）。
• 修复同一条回复出现两个气泡、消息投递状态标记到其他消息，以及主动回复后角色状态不同步的问题。
• 改善聊天自动跟随、会话滚动位置恢复、状态侧栏排版和插件页面滚动。
• 改善桌宠窗口首次显示与回复气泡，屏幕观察作为独立插件管理。
• 修复更新渠道暂无已发布版本时误报「更新失败」的问题。

稳定性与升级

• 修复 Windows 打包版遗漏后端模块导致部分插件或工具无法使用的问题。
• 完善旧插件配置、数据库、图片与桌宠素材迁移；故事和聊天分别保存图片副本，避免清理生成记录后图片丢失。
• 角色清单升级至 v5。升级前建议备份工作区；如需回退到 0.2.0，请同时恢复升级前兼容的角色数据备份。

新增与改进

• 新增“设置 → 关于”：在 Shiori 版本信息右侧显示更新状态，支持检查更新、下载进度、失败重试和重启安装。
• 关于页提供更新日志、GitHub 仓库及联系作者入口，链接通过系统浏览器或邮件客户端打开。
• 全面更新桌面界面，统一导航、聊天、角色管理、设置及生图与素材工作区的视觉样式，改善键盘操作和无障碍体验。
• 新手引导支持中途退出后继续，并可在创建角色时生成头像。
• 完善角色卡导入预览、结构化档案编辑和角色知识条目管理。
• 支持空模型配置启动和配置热更新；切换配置时保留正在执行的任务。
• 聊天回复支持 Markdown、取消流式生成，聊天历史支持自动分页加载。

修复

• 修复回复覆盖用户消息、中断后重复回复、失败回合未正确结束等聊天问题。
• 改善长聊天列表、搜索跳转及消息定位的稳定性。
• 修复上下文重试时历史记录丢失、定时消息投递归属和空推送持久化问题。
• 将角色 SELF 初始化延后至首次对话，避免角色创建阶段提前调用模型。

Shiori 的第一个 Windows 独立桌面版本。

主要内容

• 桌宠语音：支持语音识别与语音合成，可以直接和桌宠说话。
• 角色详情改为档案式多页签编辑。
• 故事模式雏形：视觉小说式的剧情与 CG 生成。
• 统一模型管理，每个角色可以单独切换模型。
• 回复改为流式输出，并能展示思考过程。
• QQ 渠道支持把角色绑定到单个联系人。
• 完成 Windows 安装包的发布流程。