v3.4.1

Phrontis v3.4.1

v3.4.1（2026-10-07）

本版一句话：工作台左栏添两员大将——「记账」用手机 AI 生成账单、一键导入，余额默认打码；「终端」内置真 pty，AI 要跑命令每条都在你眼前确认。AI 教学再进一步：课程模式与课时生命周期，从大纲到检验闭环。AI 助手新增「手册通道」，软件怎么用直接问、自动翻官方手册。

✨ 记账（新模块）

• 入口：工作台左栏书签新增「记账」；右栏出现「记账」面板（仅记账模块激活时显示），中央为流水 / 统计 / 复盘三视图，左栏可按月份与分类筛选
• 记一笔：支出 / 收入、金额、日期、分类、支付方式、商户、备注；中央流水按日分组，可改可删
• 手机 AI 账单导入：花销后让手机 AI 按固定格式输出 JSON，回软件粘贴或拖入 .json，也能直接粘给 AI 助手；自动去重，新分类与新账户自动创建；面板内置「手机端指令模板」
• 账户余额：账户 = 支付方式（微信 / 支付宝 / 银行卡 / 现金 + 自定义）；当前余额 = 初始余额 + 累计收入 − 累计支出；默认打码，点眼睛按钮才显示；统计页可加账户并改初始余额
• 统计与复盘：本月收支 / 结余、分类占比、近 6 月趋势；复盘入口跳博客的周 / 月 / 年总结，总结统计块自动带上「本期支出 / 本期收入」
• AI 工具：accounting.import-json / accounting.query / accounting.balances，模块权限默认读写

✨ 终端（新模块）

• 入口：工作台左栏书签新增「终端」；node-pty + xterm.js 真 pty，会话常驻主进程（可回放 / Tab 保活 / 上限 4），工作目录固定当前仓库根
• AI 执行四道门：设置开关（默认关，关了不进 AI 视野）→ 模块权限 → 支线会话硬拦 → 每条命令行内确认；高危命令弹严重警告，90 秒不确认视为拒绝
• 多 shell：三平台 shell 探测，版本按系统实测，标签不再写死
• 界面降噪：侧栏底栏悬停展开 shell·cwd、工具栏去重、会话条保活文案收进悬停；修复切走再切回左栏空白

✨ AI 教学

• 课程模式：工作区主界面升级——左栏大纲树、顶栏「课程主页 ⇄ 上课」分段、上课 chip；建课向导支持依据锚定与流式生成（过程可见可收起）
• 课时生命周期 L0–L5：progress.json 进度模型与自动迁移、目录物理分层、打开知识点即续课、结束课时产讲义与交接、知识点收尾自测与总结篇、跳转引用网络、画像与素材下沉到知识点级

✨ AI 助手

• 手册通道：软件用法类问题自动分流到官方手册——只检索手册、轻量回答、首字快；会话列表带「使用帮助」徽标，检测到操作意图会自动升格为通用助手
• AI 对话整页：新增「回到底部」浮标；整页划词「问 AI」就地接管，选段进本页引用胶囊（不自动发送）；引用合并格式收敛为单一实现，悬浮侧栏 / 右栏 / 整页三处同源

🔧 体验修复与优化

• 助手定制菜单脱离宿主裁剪；分享卡片整行公式按展示型居中；划词问 AI 落到右栏不再要求有书在读；从整窗模块回工作台恢复进整窗前的工作台标签
• 阅读器书签：改字号 / 拉窗口重新分页后再点不再重复收藏（同一处再点即移除）；桌面「添加控件」补上「终端 / 记账」模块磁贴
• 发布脚本输出去 emoji（内部）

---

安装包：Phrontis-3.4.1-setup.exe（含 blockmap 与 latest.yml，支持应用内自动更新）。

v3.4.0

本版一句话：桌面重做成可拼装的三栏工作台——图标条、书签栏、页面条、右栏小工具与 AI 面板各就各位；首页换成能钉磁贴的看板；书架升级成支持六种格式的阅读器，划一句话就能问 AI；新增在线书市；AI 助手会读你 @ 的笔记、能感知你的知识库、还能在编辑器里顺着往下写；新增分享卡片与工作台文件树，四季主题配套氛围特效。

本版是自 v3.1.2 以来三个内部迭代（v3.2.0-beta.1 / v3.4.0-beta.2 / v3.4.0-beta.3）汇总后的首个正式版，下面按功能面汇总这段时间的全部变化。

✨ 工作台三栏外壳

• 三栏骨架：最左图标条 + 左侧边栏 + 中间主体 + 右侧边栏；左右栏拖拽拉伸（140~480px），Ctrl+B 开合左栏、Ctrl+Alt+B 开合右栏，开合带宽度过渡；四块区域统一卡片化
• 左栏三态：总览（6 个彩色书签 + 零散文件区 + 底部仓库切换）/ 模块侧栏（点书签原位切换，带「‹ 返回」与 📌 锁定，中间切标签时自动跟随）/ 文件树模式
• 中间页面条：模块与文档统一成一条页面条，✕ 悬停显形、中键关闭、拖拽重排，激活标签与内容区同色连体
• 图标条：AI 教学 / 回收站 / 插件市场 / 动态 / 书市——激活时整窗独占，带「返回工作台」
• 右栏三态：🧩 小工具（工具箱工具入口区 + 「🕘 最近编辑」+ 控件条）/ 🤖 AI / 🎨 分享，⋯ 菜单管理显隐
• 文件树模式（本版新增）：左栏头 🌳 把左栏换成整个仓库的文件树——展开目录、右键新建 / 重命名 / 删除、拖拽移动、复制路径、目录聚焦；点文件直接在中间打开并进入编辑；资源管理器 / git 里的外部改动约 1 秒内自动跟上。从总览点书签或从活动栏切模块都会退出树模式。

✨ 看板（首页）

• 磁贴工作台：首页从固定布局改成栅格——把时钟 / 月历 / 日程面板 / 打卡轨迹 / 知识库统计等钉成磁贴，拖动换位、拉手柄调尺寸（14 × 16），还能按场景存多套布局预设；非编辑态点磁贴是安全的
• 看板模块：独立整窗仪表盘——日期与问候（问候语里的称呼可点击直接改名）、「今天该做的」主卡（逾期 + 今日待办、逐条勾选、进度条）、「今日打卡」（勾选瞬间彩纸炸开）、「今日使用」与半年热力图（使用 / 专注双指标）、「最近编辑」、「在读的书」
• 编辑卡片弹层：卡片自由显隐 + 四种背景档位；紧凑窗口自适应，不漏滚动条

✨ 书架与阅读器

• 六种格式原生支持：PDF / TXT / EPUB / FB2 / FBZ / CBZ
• 书架真实现：自动扫描仓库生成封面网格 + 续读进度条；点书直接在书架里开读，左栏原位变成该书的「目录 / 缩略图 / 书签」侧边栏
• PDF 三种阅读模式：竖排滚动 / 单页横翻 / 双页对开（窄屏自动降级并提示）；页边悬浮箭头与 ←→ 翻页；Ctrl+滚轮 缩放、护眼模式、页内链接跳转，页码 / 位置 / 模式 / 缩放全部记得住
• TXT 看齐 PDF：全文搜索、书签、字号、纸色三档；按需分块续读（滚到底自动加载下一块，不再有体积截断）
• 划选浮条统一为六件事：5 色高亮 / 摘录 / 想法 / 问 AI / 翻译 / 复制；「想法」独立成类型
• 右栏阅读面板：书卡头（封面 + 格式角标 + 迷你进度条）+ 摘录 / 时间线双 Tab；一键导出为读书笔记——每本书一篇页，可重复导出不会翻倍，每条摘录都能跳回原文
• 删书与删书签：右键「删除书籍」连进度 / 书签 / 摘录一并清掉（已导出的读书笔记页保留）；右栏书签行加悬停 ✕
• 大书装载有反馈：按体积分档（≤128MB 直接开 / 128~384MB 先确认 / 更大则拒绝并建议转 PDF）；扫描件页标记「扫描页」并说明为何不能划选

✨ 书市（新模块）

• 在线找书下载：独立整窗模块（发现 / 书源双视图 + 详情抽屉 + 下载队列）；协议走 OPDS 与声明式自定义源（只做字段映射、不执行脚本）；不预置任何侵权书源，内置只有公版与公共目录
• 下载与上架：流式下载 + 断点续传 + 进度队列；下载完自动落进仓库并上架书架，显示真书名、作者与封面
• 凭据与代理：书源可保存 Basic 认证凭据（系统级加密）；可选 HTTP 代理（只影响书市，不影响 AI）
• AI 代起草书源：跟 AI 说「把我家 Calibre 配成书源」，它给出草案并把界面切到书市预填表单；草案不落库，核对无误后你自己点添加
• 元数据自愈：在文件管理器里直接把书删掉，应用会在 30 秒内回收孤儿元数据与封面

✨ 分享卡片（本版新增）

• 右栏 🎨 分享态：把打卡与题目画成一张竖版卡片（导出 1080×1920），一键复制图片或另存 PNG
• 三套主视觉（纸山 / 书页 / 热力）+ 卡片明暗独立开关（不跟随应用主题）
• 图上直接改字：寄语 / 品牌语 / 署名三处可直接在卡片上点击输入，也能在右侧表单改，两边同步
• 题目区支持行内 Markdown 与 LaTeX：**粗**、*斜*、`代码`、$行内公式$、$$整行公式$$ 由 KaTeX 排版后随卡片一起导出；题目每天现贴，不属于模板
• 我的模板：整套快照（风格 + 明暗 + 三处文案）+ 内置三套，可命名 / 重命名 / 删除

✨ AI 助手

• 右栏 AI 面板：AI Tab 常驻对话（折叠也不丢草稿）；点「⤢ 扩大」在中间开宽版「AI 对话」标签页，右栏原位变成消耗面板——今日消耗卡、「改动文件」卡（点击直达编辑器）、会话消耗 TOP（输入输出双色 meter）
• @ 引用笔记：输入 @ 弹出文件菜单，把笔记的标题骨架与首段带进对话
• 感知模式：建好索引后按匹配度从你的笔记里取素材（关键词 + 语义向量融合）；没配向量模型时有提示与「去配置」直达
• 编辑器内联续写：打字停顿 800ms 自动给建议，Alt+A 立即要一条；连续 3 次没采纳会自动暂停；设置 → 编辑器新增「AI 内联建议」一组
• 输入区气泡化：五处 AI 输入区统一成悬浮气泡卡片，设置 → 外观里有九种「AI 助手输入样式」可选
• 划词问 AI 落到右栏：阅读器里划词点「问 AI」，右栏自动拉开停在 AI 对话，选段已填进输入框

✨ AI 教学

• 支线旁问：就某条回答开一条独立支线深挖，不打断主线节奏；浮窗可拖动 / 八向缩放 / 拖近右缘自动停靠，可「升格为会话」
• 会话「准备态」：新对话先备素材与要求再开讲，首轮不再由程序代发；工作区级要求补齐为全局 / 工作区 / 本会话三层
• 资料范围与产物落点纪律：教学会话默认只读素材登记项 + 本工作区文件夹；AI 创建的文档一律写进本会话文件夹
• 素材支持 Word 文档（docx / doc 可登记、可提取、可视觉转写）
• Ctrl+J 在教学区不再唤出 AI 助手；文件树新建 / 重命名改用内联输入

🔧 笔记区与编辑

• 编辑区与笔记区合并：原「编辑区」模块整体退役，能力并进笔记区——就地编辑、文件树、零散文件区统一到一处；知识库左栏「文件 | 大纲」切换回来了
• 右键菜单与内联命名：左栏树右键「删除 / 重命名」与头部「+」新建；零散文件右键可打开 / 重命名 / 复制路径 / 删除到回收站
• 文件树实时刷新 + Ctrl+V 粘贴系统剪贴板里的文件

🔧 图谱、主题与设置

• 知识图谱独立成标签页：从知识库内核迁出为独立页，左栏支持分区导航（点群进群），剔除软件自身目录
• 四季主题氛围特效：春·樱瓣 / 夏·丁达尔光束 / 秋·落叶 / 冬·结晶雪，覆盖工作台 / 看板 / 设置 / 说说 / 书市；设置 → 外观可开关与调密度，系统「减少动态效果」时降级为静态
• 主题插件 v1.6.0：四季主题 + --bg-gradient 渐变基建
• 设置 → 账户：原「用户」模块整体删除，数据清空等并入设置；新增 AI 内联建议、AI 输入样式、书市代理等设置项
• 「插件」图标全局统一为箱子（网页剪藏扩展除外）

🔧 修复与优化

• PDF 划选 / 翻译 / 摘录整体失效：根因是 PDF 文本层从未进 DOM，已修；渲染层换成 pdf.js 官方 viewer
• 长会话输入卡顿：击键会让该会话每条 AI 消息的 Markdown 全量重解析（单条约 27.4ms、40 条约 1097ms），改为输入值走镜像引用，不再重解析
• AI 创建的文档即时可见：写 / 改 / 改名 / 删除后文件树落盘即刷新
• 启动白屏（多处，React Hook 数变化触发）、ResizeObserver 告警刷屏、自动更新卡在 100%、托盘图标偶发显示为紫色方块、更新说明点「知道了」误开空白页 —— 已修
• 沉浸阅读模式不能向下滚动已修；沉浸阅读读 md 时左栏自动切换大纲
• 删除笔记后左栏误退回总览已修；从其他模块点「工作台」回总览不再被带到笔记区
• PDF 左侧目录跳页不准（乱跳 / 差一页）、非激活标签页误显示「打开」发光态 —— 已修
• 工作台文件树空白处右键点不到（树根未铺满可视区）已修；日程编辑弹层遮不住右栏（z 层级）已修
• 分享卡片在打包版里题目区画不出来：Vite 把小体积 KaTeX 字体内联成 data: URL，而其加载被页面 CSP 拒掉，已修（开发环境不受影响，仅在打包版复现）

本版不含：「工作台分屏」与「错题本入口重做」已改排 v3.5.0；「仓库 git 集成」尚未开工。

v3.1.2

v3.1.2（2026-09-14）

AI 教学的三块地基：支线旁问（在主线旁边追问、不打断节奏）、会话「准备态」（对话开讲前先把素材与要求备齐）、产物落点与可见性纪律（写哪儿、写完当场看得见）。另修掉长会话输入卡顿。

✨ AI 助手

• 支线旁问：就某条回答开一条独立支线深挖，不打断主线节奏——支线独立会话 + 独立消息文件，与主线物理隔离，主线消息数与上下文完全不变。四条纪律（只答小知识点 / 不改文件 / 不出题 / 回答精简）由提示词层 + 工具层硬过滤 + 运行时守卫三重保障，写类工具从支线视野里直接消失
  • 浮窗可拖动 / 八向缩放 / 拖近右缘自动停靠，双击标题栏复位；⤢ 一键在中栏浮窗与右栏宽轨间切换，内容与已追问的轮次完整保留
  • 素材绑定继承主线（按主线所属工作区解析），不用重新登记
  • 锚点回答的 chip 显示「支线追问 · 已开」可随时重开；未发送的空支线会自行回收，不留残留会话行
  • 可「升格为会话」转为正式对话（单向），升格后不再随主线删除连带清除
• 会话「准备态」：新建场景对话不再自动空发首轮。先进入准备态——加素材 / 写本会话要求 / 编辑首条消息（按场景模板预填），备齐再点「开始对话」
  • 首轮不再由程序代发，AI 也不会再自己翻一遍仓库找资料：每开一个新对话省下一轮 LLM 调用 + 一串工具翻查
• 工作区级要求：约束补齐为三层——全局 / 工作区 / 本会话。一门课公共要求写「工作区要求」（该工作区所有会话下一轮生效），跨课共用才写全局；会话要求弹层补入口与三层指引
• 资料范围纪律：教学会话默认只读素材登记项 + 本工作区文件夹，不再未经要求就全仓库检索；用户明确提出「在整个仓库找一下」时照常放宽
• 产物落点纪律：AI 创建的文档一律写入本会话文件夹，禁止写进 SOURCES/（那是给它读的素材）或仓库顶层；除提示词约束外，工具层另做落点归一化兜底，返回给模型的即真实路径
• 素材支持 Word 文档：docx / doc 现在可登记、可提取文本、可视觉转写（复用 LibreOffice 无头转换，公式与版式保真口径与 PDF 一致）
• Token 用量区分输入 / 输出：设置 → AI 模型「本月 tokens」、AI 教学「用量明细」弹层的本会话与本月两行，均补 ↑输入 ↓输出 拆分；旧记录缺拆分字段时回落显示合计

🔧 修复与优化

• 长会话输入卡顿（含删除卡顿）：击键会让该会话每条 AI 消息的 Markdown 全量重解析——单条实测中位约 27.4 ms（数学公式约 16.4 + 代码高亮约 7.5），40 条会话每次击键累计约 1097 ms。现改为输入值走镜像引用，回调不再随击键换引用，Markdown 不再重解析
• AI 创建的文档即时可见：AI 写 / 改 / 改名 / 删除文件后，编辑区文件树此前不刷新（要手动展开目录或重启才出现），现已落盘即刷新对应目录；带 frontmatter 的正规页同时进知识库列表（无 frontmatter 的草稿仍按设计不入列表）
• / 指令弹层背景透明：修正弹层引用了主题里不存在的变量导致背景与边框全透明、与聊天内容重叠不可读的问题（对齐既有弹层底色口径）
• 扩大态左右侧栏可拖宽：其他模块旁的 AI 对话扩大后，左右两栏可拖拽调宽并记住宽度，中间对话区保持可读宽度（只可调宽，不提供收起）
• 广播通道收敛：主进程「发给所有窗口」的手写样板收敛为单一出口 + 通道常量表（19 处发送点、删掉 3 份同通道的私有副本），改通道名不再可能漏改一处而静默失效

v3.1.1

体验优化与问题修复：一批日常使用打磨。

• AI 输入 / 命令补全面板：已安装 Skill 一并列出，选中即显式注入本轮对话
• 提问卡支持收起，读回答时不再被占屏
• 示意图支持手动缩放（Ctrl +/-/0 / Ctrl+滚轮），工具条一键回适应
• 出题链路加固：引号约束 + 解析自动修复 + 解析失败一键重出；移除分值徽章
• 聊天输入框关闭拼写检查；/compress 压缩增加进行时提示
• 日程 AI 写工具支持修改/删除待办

安装包：Knowbase.Programmer.Edition.Setup.3.1.1.exe（含自动更新 latest.yml）

v3.1.0

v3.1.0（2026-09-12）

AI 讲明白 + 插件生态一期：知识库接入语义检索、会话历史从「裁剪」升级为「压缩纪要」、Agent 循环可配且耗尽优雅收场；插件开放插槽 / 命令 / 事件 / 生命周期 / 声明式设置 / 渲染器六大扩展面；日程截止提醒接入系统通知；错题本退役插件双轨全内置；全站操作动效统一。

✨ 插件生态（一期）

• 侧栏插槽：插件视图可挂入编辑器 / 知识库 / 博客 / 日程侧栏（此前仅知识库），无插件时界面零侵入
• 命令通道：插件命令进入全局命令面板（Ctrl+Shift+P）——界面插件命令直达其视图，后台插件命令推送常驻 Worker
• 事件通道：页面保存 / 删除、博文保存、待办完成四类宿主事件可被后台插件订阅；权限映射现有模块能力，含限流背压
• 生命周期 + 声明式设置：后台插件获得启停通知；清单声明设置项即可在详情页自动渲染表单，值存插件私有存储
• 渲染扩展点：插件可注册自定义 围栏 渲染器——零能力只读沙箱、高度协商、失败自动回退普通代码块
• 市场装修：移除「错题本（插件版）」推荐条目与双态切换残留

✨ AI 助手

• 语义检索：知识库检索升级为关键词 + 向量混合召回（RRF 融合），设置页可配置嵌入模型与手动重建索引
• 会话压缩：上下文逼近预算时自动把较早对话折叠为持久化纪要（代替静默丢弃），/compress 指令可手动触发，纪要随仓库保存、跨会话可读
• Agent 循环升级：只读工具并行执行；推理轮数 / token 预算可配（默认 16 轮）；预算耗尽自动总结收场，不再报错丢进展
• 工具返回瘦身：批量查询默认 50→20 条、单条结果硬上限 24000 字符、更早的历史结果渐进压缩——同一批 127 条错题实测 6990 → 2460 token
• 提示缓存与故障转移：system 与工具表打缓存断点（命中量计入用量观测）；供应商级错误自动切换备用通道

✨ 日程

• 任务截止提醒 · 系统通知：提醒时刻 = 截止时间 − 提前量（分钟到天可设），逾期可重复提醒；免打扰时段（默认 22:30–07:30）内静默、出时段补发一条汇总；点通知直达任务所在面板
• 周视图改造：DDL 红线解耦排期、周任务双态、提醒条与 AI 工具扩展

✨ 错题本

• 退役插件双轨、全内置：错题本工具族全部内置化，判题一律写仓库主表（存量插件数据保留迁移 / 导出 / 清理通道）
• 数据面板重做：内部表名换成 6 张概览卡，加「按错次档位 / 按书」两条真实分布，附导出备份与分级清空

🎨 界面

• 目录聚焦：编辑器 / 知识库侧栏新增准星开关——只显示当前打开文件的目录链与同级文件，其余目录（含同级零散目录）收成骨架条：悬停显原名、点击定位并退出；骨架式 / 隐藏式两档（设置 → 编辑器 → 显示），开关状态重启保留
• 知识库标签栏回归多开：浏览只占一个预览槽，双击 / 图钉 / 右键「固定标签」后永不被浏览替换；支持中键关闭与右键「关闭其他 / 全部关闭」
• 全局动效：面板开合 / 列表增删 / 弹层进出 / 按钮与开关反馈 / 视图切换统一动效令牌——只动 transform 与 opacity，跟随系统「减弱动态效果」自动降级
• 层级参考线：编辑器 / 知识库 / AI 教学 左栏多层树加缩进竖线（实线 / 虚线 / 关闭可调）
• 更新说明：升级后自动打开一次（只看中间版本号、首装不弹），亮点卡 + 完整清单双层数据，阅读记录随仓库走

🏗️ 内核

• 会话存储 v2：消息按会话分文件追加写（JSONL），替代全量重写；存量数据自动迁移

v3.0.0

v3.0.0（2026-09-10）

首个正式版（结束 beta）：本版汇总 Vault 重构以来的全部更新——数据层对齐 Obsidian（Vault 文件即数据 + 双链 + 图谱），外壳对齐 VS Code（Workbench 布局 + 编辑器组），sql.js 完整移除；并新增 AI 教学 模块、知识图谱、网页剪藏、PDF 工具箱、日程表周视图 等。

🏗️ 内核重构：Vault 文件化（去 sql.js）

• 数据层彻底 JSON 化（R6 拍板 D9）：日程 / 说说 / 习惯打卡 / 体重 / 密码本 / 错题本 / 单词本等全部模块迁入 <仓库>/.knowbase/modules/*.json——Vault 成为唯一真相源，sql.js 与全部内联迁移完整移除，换电脑 = 拷走仓库文件夹
  • 回收站退役 recycle_bin 表（全 JSON 化 + 恢复路径 vault 化）；用户档案切 user.json；附件台账 JSON 化；习惯联动规则 JSON 化；备份导出适配纯 .knowbase 打包
• 仓库 = 账户：启动仓库选择页（Obsidian 式）；标题栏仓库切换器（新增 / 删除 / 切换）；「在文件管理器中打开仓库」；删除仓库墓碑——回收站恢复目录后重启自动回到仓库列表；切换仓库自动失效 knowledge / graph 缓存
• 读写分工（D7）：知识库 = 阅读器 + 结构维护（建删目录 / 空间 / 笔记本、导入、重命名、排序、拖拽）；编辑器 = 唯一正文写入方（Monaco + Ctrl+S + mtime 冲突检测）
• 知识页双态模型：显式 status 字段区分草稿 / 归档；无 frontmatter id 的文件 = 草稿（知识库不显示）；编辑器保存归档页自动随写翻转
• 索引层：knowledgeIndex（页面元数据）+ GraphIndex（双链 / 反链 / 标签）；写时失效、用时懒重建，mtime 兜底
• 附件 attachment://vault 协议：页面 / 仓库移动不断链
• .ignore 过滤层：仓库根 gitignore 语法规则文件——私人目录 / 草稿在知识库、搜索、图谱、AI 检索中整体隐藏，编辑器不受影响；含规则对账提示

🖥️ Workbench 外壳（VS Code 化）

• 编辑器模块（新）：Monaco 内核（worker 标准配方 + 主题由 CSS 变量动态合成）、文件树（复用 vscode-icons）、VS Code 式内联命名（去居中弹框）、根列表「软件文件」折叠节沉底
• 分栏预览（R5）：编辑区左 Monaco 编辑 / 右实时 Markdown 渲染（取代 Live Preview 方案），预览开关 + 记忆
• 禅模式：Ctrl+K Z 三档状态机（壳层隐藏 + 顶部热区 + 悬浮信息条 + 限宽居中），Esc 退出，顶栏入口
• 文件操作撤销栈：Ctrl+Z / Ctrl+Shift+Z 覆盖移动 / 重命名 / 新建，编辑区与知识库共用一份
• 命令面板 / 快速切换器
• 侧栏统一化：ResizablePanel 拖拽调宽 + Ctrl+B 开合 + 双手柄，编辑器组侧栏槽
• 液态玻璃视觉：--window-radius 大圆角 + 内容卡片壳 + 留白玻璃质感；最大化贴边（去留白 / 圆角）、最大化拖边缘 → 恢复窗口并贴随鼠标（Edge 式）；红绿灯窗控

✨ 新增功能

• 🎓 AI 教学模块（原「Agent 沉浸式工作台」更名）：三栏工作台、会话 ⇄ 文件夹绑定（{MM-DD} 标题 命名 + 锚点扫描）、CONSTRAINTS.md 约束文件化、素材库结构 v3、视觉转写分批流水线（双模型槽位、自动筛选视觉模型、可见进度条）、自动出题、用户画像、Token 消耗可视化；工件栏——AI 生成的 HTML 产物经 kbview:// 自定义协议沙箱渲染
• 🕸️ 知识图谱（d3-force，入口在知识库左侧目录树底部）：Canvas 2D 渲染、物理动画、交互 / 过滤 / 增删动画、目录 scope（进入某目录只展示该目录图谱 + 跨目录关联）、节点卡片正文预览、设置持久化
• 🗓️ 日程表周视图：排期时段网格，任务从「待安排」拖入排期、边缘拉伸调时长、未完成自动延后；拖拽改用 pointer events（HTML5 拖放静默失败根治）
• 🧰 工具箱扩充至 11 件：
  • PDF 工具箱：多 PDF 合并 / 单文件页面整理（缩略图、旋转、重排、仅导出勾选页）/ 文本提取
  • 网页剪藏：桌面端 clipperServer（仅绑 127.0.0.1 + Origin 白名单 + Bearer token）+ MV3 薄浏览器扩展（activeTab 即点即取），defuddle 转 Markdown 落 .knowbase/_draft/clipper
  • 设备传输（lanShare）：二维码 http://ip:端口/?token 双向互传
  • 单词本
  • 密码本总览改版：收藏 / 分组 / 内置强密码生成器 / 悬浮窗新增
• 🔌 插件开放（R7 / V3）：放行 type: code 插件——Worker 沙箱运行时 + PluginHostGateway 单点能力裁决 + CSP 放行；ed25519 签名链路（keyring + 作者侧签名工具）；kb.store 插件私有存储、files 对话框授权能力
• 🤖 AI 工具链：vault.* 读写工具族（vaultFile 权限域）、会话级写上限、写后广播、web.read 网页通读、docs.read-text 仓库内 PDF/PPT 文本提取、划词问 AI 宿主路由
• 📄 内置 PDF 阅读器：编辑器打开 .pdf 走 PdfReaderView（文本层 / 大纲 / Ctrl+F 搜索 / 沉浸），知识库附件路由（含无扩展名 PDF 头探测）
• 日程完成反馈三档 + 四象限图标化（含 4 个设置项）
• 设置体系重构：S1 schema 单源化（66 key 补 UI 元数据 + 搜索索引自动生成）、S2 能力域重排（8 业务模块 → 9 能力域）、S4 NumberField 数值直输、iOS 风格胶囊开关 SettingSwitch

🎨 体验优化

• 「今日工作台」小窗四 Tab（日程 / 打卡 / 番茄 / 导航），嵌入式与脱离态共用一个窗口
• 界面更新文档十条全量落地（最大化圆角 / 边缘拖拽 / 侧栏手柄 / 菜单 portal 定位…）
• 仓库切换器迁移至编辑器侧栏底部、活动栏编辑器提首位、工具箱显隐管理、番茄钟预设溢出修复
• 主进程控制台输出英文化（Windows 终端 GBK 乱码根治）
• 内置工具列表两层折叠 + 悬浮覆盖层；AI 面板过程实时可视化 + 本次改动清单（点击直达编辑器）

🐛 Bug 修复

• AI 写工具链路：权限不足被预过滤出模型视野导致「假成功」、写盘后未广播致保活模块不重读、jsonStore 静默失败使工具误报 ok:true——三处一并修复
• 自动保存型编辑器三铁律（密码本条目被覆盖复盘）：待保存内容与目标 id 原子绑定、防抖 timer 置 null、全字段 update 带 expectedUpdatedAt 乐观锁
• 拖拽体系：HTML5 拖放改 pointer events（静默失败根治）；pointer 手势结束补发 click 的误触发编辑窗拦截；跨组件拖拽携带任务本体快照
• Monaco：MonacoEnvironment.getWorker 注册（dev 下 worker throw 致编辑器挂不起来）、dispose 竞态与错误边界、编辑区高度塌陷
• 知识库：分类树 dict 解析（76 分类全读空）、导入后图谱为空、性能卡顿（剥离大字段 + 去 N+1）、.ignore 稳定性、删除走系统回收站 / 编辑器树草稿徽标
• 仓库切换：设置快照回滚 currentVaultId、will-navigate 守卫吞掉 reload、下拉菜单被遮挡
• 启动：无当前仓库统一走仓库选择页、blog 无仓库静默跳过拉取、首次创建仓库后默认打开编辑器、新仓库自动落欢迎文档
• 用户模块永远「加载中」；网址导航导入浏览器收藏夹 HTML；回收站保留天数非法值兜底
• dev：renderer watcher 忽略原子写临时物（chokidar EBUSY 杀死 dev 进程）

🔧 内部改进

• 47 个内联迁移拆分为独立文件 + 顺序索引（顺序即语义，只允许追加）
• devbridge UI 工具链（/ui/screenshot + /ui/tree + ui.* 动作）——AI 具备界面操作验收能力
• 清理锁屏功能残留（设置区 / 孤儿组件 / 设置白名单）、下线「博客读源」灰度开关
• R0–R7 路线图整体收官（数据地基 → Workbench → 编辑器与链接 → 数据层推广 → 图谱 → 分栏预览 → 去库收尾 → 插件开放）
• tsc 双 tsconfig 门禁 + 冒烟脚本体系（ai-teaching / clipper 安全矩阵等）

v2.15.1

v2.15.1（2026-09-01）

🐛 Bug 修复

• 正式版关闭后再次启动窗口闪烁闪退：单实例锁获取失败时未短路后续启动流程（第二实例仍会初始化数据库/注册 IPC/创建窗口后退出）；托盘常驻下 second-instance 只 focus 不 show，隐藏窗口无法重新出现——两者叠加表现为「点 X 关闭后再启动就闪退且唤不回」。现改为锁失败立即静默退出，再次启动自动唤醒托盘中的窗口
• 番茄钟面板盖住任务栏：番茄钟全屏面板挂载在 <main> 下，展开时把右侧的日程打卡任务栏一并覆盖（表现为任务栏被关闭/唤不出）。挂载点移入主内容卡片，只覆盖内容区
• 日程模块「周任务」「月任务」标签无法取消：日程模块每次加载都兜底重建这两个默认标签，用户删除后自动回来。移除兜底（周/月总结面板本就按需创建），这两个标签转为系统维护的来源标签：标签管理中锁定展示（不可删、带说明），创建任务的标签选择器不再混入，任务卡片/四象限仍显示来源徽章
• 任务栏停靠动画断点：拖拽吸附顶部时旧窗口先销毁再重建，视觉上「闪一下回到主窗口再变停靠」。重构为三种桌面形态（漂浮/顶部停靠/桌面小组件）共享同一窗口运行时切换，动画连续

🎨 体验优化

• 任务栏脱离进入独立漂浮中间态：点击脱离先开出可自由拖动/调整的漂浮窗口，拖到顶部停住才吸附；吸附属于隐式切换不再被记忆，下次脱离仍是漂浮
• 任务栏高度按内容自适应：内容变多自动跟上、变少不缩（保留手动拉大的空间）；首次开窗直接贴合内容尺寸显示，不再先默认高度再收缩；自动吸附判定增加防抖与开窗宽限
• 任务栏底部模块栏移除「设置」入口，与主窗口模块栏职责分离
• 番茄钟状态常驻任务栏：停靠态下任务栏模块栏上方显示番茄钟倒计时 + 状态文字（专注中/休息中/已暂停）+ 阶段进度填充条；主窗口启动的番茄钟实时同步到独立任务栏窗口，点击状态行一键回到主窗口工具箱
• 移除底部状态栏：日期/文件类型/编码等低频信息下线；番茄钟全局激活入口下沉至 Provider（原仅状态栏监听）；清理编码设置相关的无监听死代码

v2.15.0

Knowbase Programmer Edition v2.15.0

✨ 新增功能

日程与打卡小窗

主窗口之外的独立伴随窗口，把「今天要做什么 / 今天打卡了没」常驻桌面一角：

• 逾期置顶：红色分组列出全部早于今天且未完成的顶层任务，支持一键改到今天、行内编辑、删除
• 今日任务：勾选完成、展开子任务、行内编辑时间
• 一句话快速添加：自动识别日期时间（明天下午3点开会 / 周五 14:00 复习计网 / 8月5号交报告），识别结果可点开修改
• 今日打卡：计划内习惯一键打卡 / 取消，显示连续天数
• 窗口行为：贴主窗口右缘磁吸跟随、拖离自由摆放（位置记忆）、跟随最小化 / 还原、跨零点自动翻页
• 入口：标题栏日历图标，或全局快捷键 Ctrl Alt S

任务栏与桌面互动

• 托盘常驻（关闭到托盘）
• 任务栏拖到屏幕顶部自动停靠（QQ 式收缩贴顶），停靠态出现模块切换栏
• 桌面小组件模式鼠标穿透；位置与状态持久化

设置搜索直达

搜索从"只匹配左侧大项"升级为深入每一个具体设置项：

• 36 个设置项中英文别名索引，拼写容错 + 多词 AND + 相关度排序
• 下拉候选带面包屑高亮、键盘选择、Tab 补全、热门推荐
• 点击直达：自动切大项 / AI 页签，滚动定位并闪烁高亮

日程周 / 月任务标签

新增「周任务」「月任务」默认标签，周 / 月总结创建任务自动带对应标签。

🎨 体验优化

• VS Code 式设置下拉控件：应用主题 / 删除动画皮肤 / 侧边栏图标 / 字体样式改为标准下拉框——说明常驻、悬浮项底部显示说明、默认值角标、键盘操作
• 设置长列表默认收起：AI 工具内置工具 / 最近调用改为折叠分组
• 三卡对称卡片壳布局：ActivityBar 与主内容区统一圆角卡片壳，玻璃质感
• 知识库侧边栏三档条目大小差距拉开，切换真正可见
• 插件手绘图标重绘；界面字号细节统一

🐛 Bug 修复

• 修复主窗口最大化时小窗跑到屏幕外、小窗永久遮挡主窗口、吸附态宽度 / 高度异常等一串窗口几何问题
• 修复小窗跨零点不刷新、逾期任务只覆盖两个月、一次操作触发两轮全量重载
• 修复设置模块某些状态进不去、测试版无法启动（safe-delete 误拦 + IPC 重复注册）
• 修复反复拖宽窗口右侧白空、任务栏收起白条、日期文字被截断等布局问题

---

完整更新日志见 CHANGELOG.md。

v2.14.0

Knowbase Programmer Edition v2.14.0

🎨 体验优化

• 全局更新状态中枢（新增 src/lib/updateStore.ts）：标题栏与设置 → 高级共用同一份数据源（useSyncExternalStore 单例）——标题栏开始下载 → 设置页实时显示同一进度；任一页暂停/取消，另一页立即同步。此前两处各自维护 state 互不感知，下载进度无法跨视图同步
• 标题栏更新入口升级：有新版/下载中/失败 → 点击展开下拉面板（更新说明摘要 Markdown 渲染、立即下载、进度条 + 暂停/取消、重试、去设置页管理）；已下载 → 点击直接运行安装。此前入口点击行为单一、下载失败进度无声消失无任何提示
• 下载失败可重试：失败态按原因结构化分流——坏字节类（大小/SHA512 校验不符）提示「服务器文件可能未传完整」并提供「重新下载」+「更换镜像重试」（自动聚焦镜像输入框，断点续传）；网络类提供「重试」+ 镜像引导。设置页与标题栏均生效
• latest.yml 缺失预警：下载仍按大小校验放行，但两处 UI 明确提示「更新源文件不完整（latest.yml 缺失）」及发布页手动下载指引，不再等到安装时才报无意义的 integrity check failed
• 更新日志展示：标题栏下拉面板同样支持折叠查看 Release notes（与设置页一致，Markdown 渲染）

🔧 内部改进

• 失败原因结构化（主进程 updateService.ts）：UpdateResult 新增 reason（size-mismatch / sha512-mismatch / network / channel-all-failed / cancelled / unknown）与 step（download / verify / sha512）诊断字段，UI 文案可精准区分「镜像坏字节」「服务器文件不完整」「纯网络波动」
• 新增发布脚本：scripts/publish-release.py——安装包发布三件套完整性门：①exe + .blockmap + latest.yml 必须同时存在；②latest.yml 的 sha512/size 与本地 exe 实测一致；③版本号一致；通过后 gh release 一次上传三件套并回读远端资产列表验证齐全。杜绝 v2.13.0「exe 先传、元数据后补」窗口期事故复发
• 安装包自动清理：安装程序成功拉起后记录标记，下次以新版本启动即删除旧安装包；安装被取消/失败（版本未变）则保留供重试
• 新增文档：docs/auto-update-improvements.md——自动更新链路问题清单、优化方案与实现记录（含 v2.13.0 发布事故复盘）

Knowbase Programmer Edition v2.13.0

v2.13.0（2026-08-30）

✨ 新增功能

• 错题本彻底插件化：C 级模块插件系统（插件自有数据表 plugin__*、结构化 CRUD 禁止任意 SQL、能力 data/knowledge/navigation、视图挂载点）；错题本插件版（数据存插件表、判题主进程路由、重刷复用宿主刷题器）已上架插件市场；内置版保留为回退
• 错题本归档细化：章节路径继承、多维标签（考点/题型/难度/关键词 + 批量打标）、掌握机制（连续答对 2 次移出）、统计面板、备注与跳源页面
• PDF 工具箱：多 PDF 合并 / 页面整理（旋转/删除/重排）/ 提取文本
• 阅读脚注：word^[标注] 行内脚注语法 + 编辑器脚注按钮
• 字体扩充 4 → 12 套（设置 → 编辑器）

🎨 体验优化

• 划词翻译卡片智能定位、知识库侧栏窄栏优化

🔧 内部改进

• 迁移 052/053、插件数据层/迁移面板/沙箱桥、publish-quizbook.py 发布脚本、pdf-lib/pdfjs-dist 依赖