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