# Ink Whiteboard Pro 更新日志

本文件从 1.0.3 起记录面向用户的功能变化。仓库此前没有可追溯的发布标签，因此 1.0.3 条目依据当前发布构建、功能实现与验证结果整理，不作为更早版本逐提交差异的完整清单。

## [1.0.3] - 2026-08-20

### 版本摘要

1.0.3 是一次覆盖授权体系、内容嵌入、导入导出、思维导图、跨设备交互和数据安全的正式版更新。现有 `.iwb`、`.iwm`、`.iwd` 文件格式保持不变，最低支持 Obsidian 1.5.0。

> [!IMPORTANT]
> 产品已升级为 Ink Whiteboard Pro 商业授权版本。升级后需要使用 `IWB1` 购买码激活；桌面端与移动端分别保存本机授权状态。授权信息不会写入 Vault，现有白板文件也不会因未激活而被修改或删除。

### 新增

- 新增 Pro 授权流程：支持购买码激活、授权恢复、设备管理和手动授权同步；桌面端设备私钥使用系统安全存储保护，移动端使用独立 IndexedDB。
- 新增白板 Markdown 嵌入：在笔记中使用 `![[项目白板.iwb]]`、`![[导图.iwm]]` 或 `![[绘图.iwd]]` 可显示实际内容预览，并可进入受控交互模式操作支持的组件。
- 新增格式导入：可将当前 Obsidian Canvas 转为 Ink 白板，也可将幕布、MindNode、WorkFlowy 等工具导出的 OPML 大纲导入为思维导图。
- 扩展思维导图：提供辐射状、右侧、左侧、树形、时间轴和鱼骨图六种布局，并增强 Markdown 双向同步、多选编辑、复制粘贴、自动排版和导出。
- 新增演示路线：可把选区或当前视口保存为镜头，调整顺序后播放，并支持演示过程中的自由漫游。
- 扩展嵌入内容：支持网页、音频、视频、Base、Dataview/多维表数据和首页组件，首页组件包括倒计时、最近文件、快捷入口、统计、历史上的今天和引语等。
- 新增跨白板复制：复制节点到其他白板时，可保留结构、关系与支持的资源引用，并迁移相关文件链接。
- 增强导出：支持选区、当前视口或全部内容导出为 PNG、SVG、JPG、PDF；改进富文本、思维导图文本和复杂组件的导出还原度。

### 交互与性能改进

- 区分桌面、平板和手机的输入与性能策略；带触摸屏的 Windows PC 继续使用桌面交互，不再被误判为移动端。
- 重做导航期间的渲染策略，拖动、缩放、键盘平移和触控板移动时继续保留卡片、文本、表格及数据组件，减少闪烁和“先消失再出现”。
- 调整画布、笔迹和图结构渲染预算，针对低内存设备降低峰值占用，并及时释放离屏画布资源。
- 优化生产构建体积和加载路径，补充发布打包、本地部署及运行时检查流程。
- 更新《使用手册》《操作手册》和可直接打开的《Ink Whiteboard 使用指南》白板。

### 修复

- 修复框选过程中实时出现“选择 N”标识的问题；选择结果改为在操作完成后统一呈现。
- 修复拖动文本框时原位置残留一份文字、形成重复字体的问题。
- 修复卡片等 DOM 组件在拖动、缩放、键盘或触控板平移时短暂消失后再出现的问题。
- 修复预览图层和正式图层同时绘制移动中节点，造成内容重影的问题。
- 修复任务看板回写可能命中错误源行的问题，并保留原 Markdown 文件的 CRLF/LF 换行格式。
- 修复部分界面文案出现乱码的问题。
- 修复文件改名后部分白板资源引用没有同步迁移的问题。

### 保存、安全与隐私

- 保存流程改为串行、版本感知的脏状态管理，避免较早的保存结果覆盖较新的编辑。
- 在关闭视图、应用转入后台或图形资源释放前优先落盘；正常保存失败时，会在 `Recovery` 目录生成可恢复白板文件。
- 加强白板 JSON 的备份、校验与恢复模式，降低异常关闭或损坏数据造成的损失。
- 收紧网页嵌入权限，移除不必要的剪贴板读取、写入及同源沙箱能力。
- 插件启动和后台运行不会联网；只有用户主动执行激活、恢复、设备管理或授权同步时才访问授权服务，且不上传笔记、文件名、白板内容或使用数据。

### 升级说明

- 升级前建议备份 Vault，随后替换插件目录中的 `manifest.json`、`main.js` 和 `styles.css`，并重新加载插件。
- 首次进入 1.0.3 时，请在插件设置中使用 `IWB1` 购买码激活；在另一台电脑或移动设备上使用时，需要在该设备单独激活或恢复授权。
- 原有 `.iwb`、`.iwm`、`.iwd` 文件无需转换；授权状态不会写入或改动这些文件。
- 部分网站会通过自身安全策略拒绝 iframe 嵌入，此时可改用链接卡片或系统浏览器打开。

### 质量验证

- 已通过 TypeScript 编译、生产构建、主文件语法检查，以及稳定性、交互、渲染性能、移动端内存、导图、剪贴板、导出、文件引用迁移、看板回写、授权协议和文档一致性检查。
