Releases: LiYuanStudio/Papyrus_Desktop
Releases · LiYuanStudio/Papyrus_Desktop
Release list
Papyrus Desktop v2.0.0-beta.15
Papyrus Desktop v2.0.0-beta.15
发布日期：2026-08-01
版本类型：Beta 测试版
本版本聚焦数据兼容性、归档解析、AI 提供商通信与 Electron 桌面安全性，并补齐多类边界测试。Beta 用户升级前请先备份 Papyrus 数据目录。
本版重点
- 加固归档包与扩展包解析、校验及恢复相关路径。
- 改进卡片、复习进度和 SM-2 在旧数据及异常输入下的稳定性。
- 强化 Electron 导航与本地资源校验，并改善 AI 提供商通信安全边界。
- 补充数据库、MCP、API、复习流程和桌面安全校验的单元与集成测试。
- 提供 Windows、macOS（arm64/x64）和 Linux 安装包，共 5 个可下载产物。
新增功能
本版本无独立的面向用户的新功能，主要围绕现有能力的兼容性、安全性和稳定性进行加固。
体验改进
- 复习与进度相关接口对旧卡片数据、缺失字段和异常评分输入提供更稳健的处理。
- MCP 与 API 错误路径的请求处理更加完整，降低异常请求导致连接问题的概率。
- 更新项目文档中的版本信息，保持 beta.15 发布信息一致。
安全与稳定性
- 归档/扩展包解析增加边界校验，降低异常压缩包或不完整数据导致导入失败的风险。
- 修复缺少题目或答案字段、非法评分值、旧数据 interval 为 0 等边界场景。
- 加强 AI 提供商地址与传输相关安全校验，补充 Electron 导航安全验证。
- 修复数据库、MCP 服务、复习与卡片 API 的多类回归问题，并增加对应测试覆盖。
构建与发布
- 版本号统一为
2.0.0-beta.15，tag 为v2.0.0-beta.15。 - GitHub Actions 已完成测试、类型检查、安全扫描及四个平台构建。
- 本 Draft Prerelease 提供 Windows x64、macOS arm64、macOS x64、Linux AppImage 和 Linux DEB 安装包。
相比上一版本
上一版本为 v2.0.0-beta.14。本版本在其基础上进一步加强归档与扩展包处理、复习数据兼容、Electron 桌面安全和 AI 提供商通信，并补齐覆盖异常路径的测试。
使用提示
- 本版本为 Beta 测试版，界面与 API 仍可能继续调整。
- 升级前建议备份
$HOME/PapyrusData（Windows 用户请对应自己的用户数据目录）。 - 请从本 Release 页面下载与你的平台和架构匹配的安装包。
贡献者
Contributors
Alpaca233114514
Assets 7
Papyrus Desktop v2.0.0-beta.14
Papyrus Desktop v2.0.0-beta.14
发布日期：2026-07-24
版本类型：Beta 测试版
本版本重点加入知识库版本控制，并修复 Beta 更新通道、关于页版本显示和更新卡片布局问题。发布包新增用户数据库排除门禁与真包启动检查；测试版升级前仍建议备份现有数据。
本版重点
- 新增知识库版本、分支、历史记录和恢复能力，可追踪卡片、笔记、关系、文件及学习进度变化。
- 修复 Beta App 将较旧正式版识别为更新的问题，并支持发现后续 Beta 或同版本正式版。
- 修复聊天历史标题溢出、标题栏搜索框边界不清晰及更新提示卡片内容溢出。
- 关于页固定显示当前安装包的真实版本号，避免旧后端进程导致版本回退显示。
- 发布流程新增数据库泄露拦截、前后端版本一致性检查和打包后端真实启动冒烟。
新增功能
知识库版本控制
- 新增知识库版本快照、版本列表、详情查看和恢复流程。
- 新增版本分支管理，可创建、切换、重命名及维护不同知识状态。
- 版本快照覆盖卡片、笔记、关系、文件元数据及学习进度，并提供恢复前安全校验。
- 设置页新增知识库版本控制界面及四种语言文案。
体验改进
- 限制自动生成的聊天标题长度，并修复历史对话侧栏文本溢出。
- 增强标题栏搜索框边框，在浅色背景下更容易辨识。
- 更新提示卡片增加响应式内边距；较长发布说明改为卡片内滚动，长链接可自动换行。
- 关于页以 Electron 安装包版本作为显示基准，确保 BA14 显示
2.0.0-beta.14。
安全与稳定性
- 更新检查改用严格 SemVer 比较，不再以“版本字符串不相等”判定升级，阻止 Beta 向较旧正式版反向降级。
- Beta 客户端使用包含预发布版本的 Release 通道；正式版继续使用稳定版通道。
- Electron 主进程向后端提供可信 App 版本、平台和架构，用于正确选择更新基线与安装包。
- 知识库版本恢复流程增加事务、路径及一致性校验，降低部分恢复或错误覆盖风险。
- 打包门禁禁止
.db、.sqlite、WAL、SHM 及遗留用户配置进入安装包，避免发布开发数据库、对话记录或版本分支数据。
构建与发布
- 提供 Windows x64 NSIS、macOS arm64、macOS x64、Linux x64 AppImage 和 DEB 安装包。
- Release 工作流在每次附件和文案更新时显式保留 Draft 与 Prerelease 状态。
- 所有平台在上传前执行依赖结构检查、前后端及 UI 版本一致性检查、用户数据排除检查和打包后端启动冒烟。
- 发布流水线继续执行类型检查、后端测试、根脚本测试、E2E API 测试和依赖安全扫描。
相比上一版本
v2.0.0-beta.13 主要完善跨平台桌面打包与基础稳定性；v2.0.0-beta.14 在此基础上新增完整的知识库版本控制，并集中修复真机测试发现的更新通道、界面布局、版本显示及发布包数据隔离问题。
使用提示
- 本版本仍为 Beta 测试版，升级前请备份 Papyrus 用户数据目录。
- 首次创建或恢复较大知识库版本时请等待操作完成，不要强制退出应用。
- Windows CI 安装包未使用正式代码签名证书，系统可能显示安全提示；请仅从本 Draft Release 下载测试包。
- 若已安装旧 BA14 测试包，请退出 Papyrus 后使用本 Draft 中的新安装包覆盖安装。
贡献者
Contributors
Alpaca233114514
Assets 7
Papyrus Desktop v2.0.0-beta.13
Papyrus Desktop v2.0.0-beta.13
发布日期：2026-07-19
版本类型：Beta 测试版
BA13 是一次覆盖桌面体验、AI 会话管理、跨平台适配与安全性的综合更新。建议升级前备份重要数据；测试版仍可能存在边缘问题。后续相关release发布将沿用此格式
本版重点
- AI 对话新增侧边栏历史记录、自动标题、重命名与删除管理，长期开启多个会话时更容易查找和整理。
- 完善 Windows 与 macOS 原生桌面体验，并同时提供 macOS Apple Silicon 与 Intel 构建。
- 统一主要页面的视觉设计语言，集中优化侧边栏、标题栏、设置页与复习流程。
- 加固本地 API、AI Provider 与代理访问边界，降低密钥泄露、SSRF 和未授权访问风险。
新增功能
AI 会话与模型
- 新增侧边栏 AI 会话历史，可快速切换、重命名和删除会话。
- 支持根据对话内容自动生成会话标题，减少大量“新对话”难以区分的问题。
- 优化会话排序和重复空白会话处理，历史记录展示更稳定。
- 设置中支持选择翻译模型，并完善模型、Provider 与附件相关交互。
桌面平台
- 新增 macOS 原生应用菜单、系统快捷键、窗口控制与平台外观适配。
- macOS 发布同时构建
arm64与x64，覆盖 Apple Silicon 和 Intel 设备。 - Windows 标题栏加入 Acrylic 视觉效果，并改进无边框窗口交互。
体验改进
- 统一主题色、卡片、间距和页面布局，侧边栏、标题栏、设置页及统计页视觉更一致。
- 优化闪卡复习工具栏、评分按钮、空状态与卡片布局，键盘驱动的复习流程更清晰。
- 改进聊天面板、文件添加、本地化文案和多语言显示细节。
- 修复聊天会话顺序、空白会话重复、PDF 预览和部分界面布局问题。
安全与稳定性
- 强化本地 API 鉴权范围，收紧敏感接口和文件访问边界。
- 加固 AI Provider URL 校验与 SSRF 防护，改进 API Key 加密、遮罩和兼容迁移。
- 改善系统代理和 GitHub 更新检查的回退逻辑。
- 将测试数据与用户数据目录隔离，避免边缘测试污染本地 Papyrus 数据。
- 完善聊天历史与配置数据的 SQLite 持久化及旧数据迁移。
构建与发布
- 更新 Electron/Node.js 桌面构建适配，改善跨平台后端启动路径与原生依赖兼容性。
- 修复 ASAR 文件路径在 Windows、Linux、macOS 上的差异导致的依赖校验误报。
- 增加打包依赖回归测试，确保前端入口与后端运行依赖确实进入安装包。
- 完善多平台 Release 工作流和构建产物检查。
相比 BA12
BA12 主要聚焦 AI 消息操作、翻译能力和窄面板体验；BA13 在此基础上进一步补齐了完整的会话历史管理，并把改进范围扩展到原生桌面交互、跨平台构建、安全边界、数据迁移和全局视觉一致性。
使用提示
- 本版本仍为 Beta 测试版，升级前建议备份
PapyrusData。 - CI 构建未进行商业代码签名或 Apple 公证，首次运行时可能出现系统安全提示。
- 如从较早版本升级，首次启动可能执行配置或会话数据迁移，请等待迁移完成后再关闭应用。
贡献者
Contributors
Alpaca233114514
Assets 7
v2.0.0-beta.12
版本发布说明
版本: v2.0.0-beta.12
日期: 2026-07-08
测试版本，请谨慎下载。此阶段较稳定，推荐升级。
MacOS用户注意：本应用未对MacOS做专门的UI适配，请谨慎下载。
新增功能
AI 聊天面板
- 消息操作栏：支持复制、编辑、重新生成、翻译、保存到笔记、删除
- 翻译功能：新增翻译弹窗，流式输出译文，支持复制译文
- 窄面板适配：聊天面板在较窄宽度下优化布局，消息气泡与操作按钮更易用
- 推理链展示：优化推理过程（Reasoning Chain）的样式与折叠交互
后端 API
- 新增
/api/ai-chat/translate翻译接口，支持 SSE 流式返回
改进
界面与交互
- 搜索栏：优化全局搜索框宽度，避免占用过多空间
- 标题栏：修复 Agent 标志与搜索框过宽的问题
- 工具调用卡片：微调工具调用卡片的视觉样式
开始页
- 移除首页快捷卡片区域，界面更简洁
开发体验
npm run dev启动前自动清理占用端口（新增kill-ports.js）- 简化 Electron 开发/构建脚本逻辑
国际化
- 聊天消息操作相关文案已同步至 简体中文 / 繁体中文 / English / 日本語
构建与分发
- 修复 Release 工作流文件异常，确保 tag 推送后可正常触发 CI 构建
- 移除仓库内的聊天 UI 设计稿 mock 资源，保持发布包干净
Bug 修复
| 问题 | 状态 |
|---|---|
| Agent 标志与搜索框在标题栏过宽 | ✅ 已修复 |
| Release 工作流因合并冲突无法解析、CI 秒失败 | ✅ 已修复 |
| 聊天面板窄宽度下布局拥挤、操作不便 | ✅ 已修复 |
注
- 本版本主要聚焦 AI 聊天体验与标题栏/搜索栏细节优化
- 首页快捷入口已移除，相关功能仍可通过侧边栏访问
贡献者
Contributors
Alpaca233114514
Assets 6
v2.0.0-beta.11
版本发布说明
版本: v2.0.0-beta.11
日期: 2026-06-17
测试版本，请谨慎下载。此阶段较稳定，推荐升级。
MacOS用户注意：本应用未对MacOS做专门的UI适配，请谨慎下载。
公告
由于近期风控，DeepSeek免费调用服务下线。
此版本为BA6到BA10的合并版本
新增功能
多语言支持
- 全新 国际化(i18n) 框架，基于
react-i18next - 支持 简体中文 / 繁体中文 / English / 日本語 四种语言切换
- 语言设置即时生效，重启后保持
- 已完成翻译：侧边栏、开始页、设置页（通用设置）、标题栏菜单
工具调用
- 加入完善的工具调用功能，在「工具设置」中可用
卷轴管理
- 卷轴界面新增「添加卷轴」功能，不再需要依赖 AI 执行
文件上传
- 正式支持 PDF、DOCX 格式上传
更新检测
- 支持通过代理检测更新
改进
后端与 API
- 日志配置持久化：日志路径、级别、轮转等设置保存到
ai_config.json，重启后依然生效 - 数据界面同步：开始页「最近卷轴」「待复习队列」「最近笔记」监听卡片/笔记变更事件并自动刷新
构建与分发
- 文件名统一改为 Papyrus Desktop，不再使用
APP+版本号作为文件名
Bug 修复
| 问题 | 状态 |
|---|---|
| 开始页「最近卷轴」「待复习队列」「最近笔记」不随卡片/笔记更新而刷新 | ✅ 已修复 |
| 设置日志文件夹路径后重启丢失 | ✅ 已修复 |
| 工具假执行（实际未执行但返回成功） | ✅ 已修复 |
| 关闭对话框后重新开启，仍沿用旧对话上下文 | ✅ 已修复 |
检查更新出现 fail to fetch |
✅ 已修复 |
| 版本号未正确更新 | ✅ 已修复 |
| 其他已知问题及多项安全修复 | ✅ 已修复 |
注
- 修改了一些UI
- 修复了一些安全问题
贡献者
Contributors
claude, ChimeHsia, and 2 other contributors
Assets 6
v2.0.0-beta.5
公告
- 本版本为 beta 版本且由于时间限制未充分测试，可能遇到功能不可用情况，若发现 bug，请及时提供反馈，谢谢。
- 本版本包含笔记关联系统、AI 聊天改进和文件管理增强等多项更新，建议用户升级体验。
- 当前changelog被误传，现已恢复公告。
亮点
- 笔记关联系统: 笔记之间可以创建双向链接，支持知识图谱可视化，构建你的知识网络
- AI 聊天增强: 消息流式状态管理重构，配置更改实时生效，聊天体验更稳定
- 文件管理增强: 支持文件夹双击进入、面包屑导航、按类型筛选文件
- 开始页面实时刷新: 完成闪卡学习后，开始页统计自动刷新，无需手动切换页面
新增功能
笔记关联系统
- 全新 笔记关联 功能，可在笔记之间建立双向链接关系
- 后端支持完整的关系 CRUD 操作和 BFS 图遍历查询
- 为后续知识图谱可视化提供数据基础
文件页面改进
- 文件夹导航: 双击文件夹进入子目录，支持面包屑返回上级
- 文件类型筛选: 可按文档、图片、视频、音频等类型过滤文件列表
- 文件页面背景随图片亮度自适应调整
Electron 桌面端
- 新增安全的
shell:openFolder接口，可在用户目录或应用数据目录内打开文件夹 - 后端健康检查间隔从 2 秒缩短至 500 毫秒，启动检测更快
AI 与聊天
- 聊天状态管理: 消息流式输出改用不可变状态更新，修复潜在的渲染异常
- 配置实时同步: 设置页修改 AI 配置后，聊天面板无需重启即可生效
- AI 补全优化: 默认 max tokens 从 150 调整为 50，响应更快
- 助手消息头像改为顶部对齐，长推理内容更易阅读
编辑器与输入
- SmartTextArea: 重写 ghost text 定位逻辑，解决相对容器偏移问题
- 新增后端状态指示器，AI 补全服务不可用时显示状态提示
笔记与学习
- 笔记保存体验: 从编辑模式切换到预览模式后，不再自动跳回笔记列表
- 开始页面: 退出闪卡学习后自动刷新统计数据和复习进度
后端与 API
- 搜索 API: 增加 try-catch 错误处理，数据库锁定时返回 500 而非崩溃
- API 认证: Token 缓存和重试逻辑加固，减少 401 错误
构建与部署
- 发布工作流支持
v2.0.0beta.5分支自动触发构建
Bug 修复
- 修复 Provider 表单重置时机，成功保存后再重置，防止数据丢失
- 修复设置页错误提示，现在显示后端具体错误信息而非通用文案
- 修复托盘关闭操作的错误处理，避免异常崩溃
测试
- 新增笔记关联系统核心模块单元测试