v1.2.0

✨ 新功能

Anki 卡片系统

• 新增完整的 Anki 卡片生成和管理功能
• 支持从笔记自动生成 Anki 卡片
• 支持导出为 .apkg 格式文件，可直接导入 Anki
• 新增专用的 Anki 管理页面
• 支持自定义卡片模板和配置

笔记保存功能

• 新增快速保存笔记功能
• 支持键盘快捷键（Cmd+S / Ctrl+S）
• 添加保存成功的 Toast 提示通知

🔒 安全性改进

• 集成 DOMPurify 库用于 Anki 卡片渲染时的 HTML 清理
• 提升了应用的整体安全性，防止 XSS 攻击

🐛 Bug 修复

• 修复 TypeScript 类型检查错误
• 修复 ESLint 代码规范问题
• 优化代码质量和稳定性

📦 依赖更新

• 新增 dompurify (^3.3.1) - HTML 清理和安全防护
• 新增 anki-apkg-export (^4.0.0) - Anki 包导出功能
• 更新多个核心依赖到最新稳定版本

🎯 改进

• UI/UX 优化和界面改进
• 更好的用户交互体验
• 增强的快捷键支持

---

完整更新日志: v1.1.1...v1.2.0

v1.1.1

🎉 v1.1.1 新特性

本次更新带来了全新的用户引导流程、测验功能以及全面的设计系统升级！

✨ 主要新功能

🚀 新用户引导流程 (Onboarding Flow)

• 首次启动应用时提供友好的欢迎引导
• 帮助新用户快速了解 KnowNote 的核心功能
• 支持跳过和重新查看引导内容
• 默认语言更新为 en-US，提供更好的国际化体验

📝 测验功能 (Quiz)

• 智能测验生成：基于知识库内容自动生成测验题
• 多种题型支持：单选题、多选题等
• 可配置参数：
  • 题目数量（5-20题）
  • 难度级别（简单/中等/困难）
  • 题目语言
• 完整的测验流程：
  • 开始配置 → 生成题目 → 答题界面 → 结果查看
  • 实时显示答题进度
  • 详细的答题结果统计
  • 支持复习模式
• 独立测验窗口：在 QuizPage 中管理所有测验相关内容
• 数据库持久化：保存测验记录和答题历史

🎨 设计系统全面升级

Atom Enhanced 设计系统

字体系统

• Display 字体：Outfit（几何感强，适合标题）
• Body 字体：Plus Jakarta Sans（清晰易读，适合正文）
• 完整的排版层级：display/h1-h4/body/caption/small
• 响应式字体大小支持

色彩与视觉效果

• 基于 Atom 配色的渐变系统（primary/accent/cool/warm）
• 彩色阴影效果，增强视觉深度
• 玻璃态效果
• 背景装饰纹理（网格/点阵/噪点）
• 光晕和渐变边框

动画与微交互

• 流畅的缓动曲线
• 丰富的动画效果
• 列表项交错延迟动画（支持 20 项）
• 主题切换过渡动画
• 卡片悬停提升效果
• 无障碍支持

键盘快捷键系统

• 完整的快捷键管理：
  • 自定义快捷键录制
  • 冲突检测与提示
  • 启用/禁用快捷键
  • 一键重置为默认设置
• 核心快捷键：
  • 创建/关闭笔记本
  • 切换知识库面板
  • 切换创意空间面板
• 持久化存储和跨平台支持

UI 组件库升级

• 集成 Radix UI 组件：
  • AlertDialog（确认对话框）
  • Separator（分隔线）
  • Tabs（标签页导航）
• 替换所有原生 confirm 对话框为 React Dialog 组件
• 统一的对话框宽度和样式

🔧 功能改进

本地模型列表

• 内置模型配置：支持主流 AI 服务商的模型列表
  • OpenAI、DeepSeek、Kimi、Ollama、Qwen、SiliconFlow、智谱等
• 智能合并策略：
  • 远程字段反映最新状态
  • 内置字段提供准确的元数据
  • 自动分类新的模型类型
• 离线可用：远程获取失败时使用内置配置
• UI 反馈优化：显示模型来源和统计信息

UI 改进

• 知识库友好提示：未配置嵌入模型时引导用户前往设置
• 全局文本选择控制：仅聊天消息内容可选择，提升用户体验
• 加载样式优化：知识库文件上传采用简洁的加载设计
• 设置界面重构：
  • 从独立窗口改为对话框形式
  • 统一的容器样式和间距
  • 更清晰的信息层级

其他优化

• 新增侧边栏（sidebar）组件
• 新增字段（field）组件
• 新增面板头部（panel-header）组件
• 优化滚动区域（scroll-area）样式
• 新增骨架屏（skeleton）加载效果
• 新增移动端检测 hook（use-mobile）
• 平台检测工具（lib/platform.ts）

🐛 问题修复

• 修复 macOS 窗口红绿灯位置
• 防止标签页切换时的闪烁问题
• 修复快捷键在窗口重建时的重新注册问题
• 限制拖拽仅支持垂直方向
• 修复 PostCSS 导入顺序问题
• 优化 useEffect 依赖，防止频繁重新注册
• 修复滚动条硬编码颜色，改用 CSS 变量

📚 文档更新

• 更新中英文 README
• 统一文档结构和样式
• 添加 Star History 图表
• 修复 Markdown 格式问题

🎯 技术细节

• 142 个文件变更
• 9,470 行新增代码
• 2,562 行删除代码
• 新增数据库迁移：
• 新增 QuizService、ShortcutManager 等核心服务
• 完整的国际化支持（quiz、shortcuts 等新增翻译）

---

📦 下载

请从 Releases 页面下载适合您操作系统的安装包。

🙏 致谢

感谢所有贡献者和用户的反馈与支持！

---

完整更新日志: v1.1.0...v1.1.1

1.1.0

🎉 KnowNote v1.1.0

✨ 新功能

思维导图功能

• ✅ 全新的思维导图系统，支持独立窗口展示
• ✅ 支持多种布局模式切换
• ✅ 思维导图导出为图片功能（自动排除控制元素和背景）
• ✅ i18n 国际化支持，思维导图提示支持多语言

Items 管理系统

• ✅ 统一的 Items 系统，支持拖放排序
• ✅ 右键菜单支持重命名和删除操作
• ✅ 改进的拖放交互体验

🐛 Bug 修复

• 修复OpenAI嵌入模型1024维度的支持 (#14)
• 修复Ollama两种Fetch model API的支持 (#12)
• 修复添加到笔记编辑器无法打开的问题 (#15)
• 修复思维导图组件的 TypeScript 类型错误
• 修复 ItemService 和 MindMapService 的 ESLint 代码规范问题

🔧 技术改进

• 新增 ItemService 和 MindMapService 服务层
• 改进 AI Provider 架构
• 新增思维导图窗口管理
• 数据库架构优化（新增 3 个迁移）

📝 完整更新日志

从 v1.0.6 到 v1.1.0 的所有改动详见：v1.0.6...v1.1.0

---

完整变更列表: v1.0.6...v1.1.0

1.0.7

fix: resolve TypeScript errors in mindmap components

- Fix CustomNodeData interface to extend Record<string, unknown>
- Update CustomNode component to use type assertions for NodeProps
- Simplify type definitions in MindMapCanvas to use standard Node/Edge types
- Fix ReactMarkdown className prop issue in NodeDetailPanel
- Add null check for mindMapId in mindmapStore generateMindMap
- All TypeScript compilation errors now resolved

1.0.6

KnowNote v1.0.6 Release Notes

发布日期：2025年12月18日

🎯 重要更新

🔧 Provider 架构重构

本次版本完成了 Provider 系统的重大升级，迁移到 Vercel AI SDK v5 架构：

新增 Provider 支持

• 智谱 AI (GLM)：新增智谱 AI 作为内置 Provider，支持 glm-4-plus 聊天模型和 embedding-3 嵌入模型
• Ollama v2：升级到 ollama-ai-provider-v2，修复了 API 端点和模型标准化问题
• qwen-ai-provider：集成通义千问社区 Provider
• @ai-sdk/deepseek：集成 DeepSeek 官方 Provider

技术改进

• 代码大幅优化：删除了约 500 行废弃代码
• 统一了所有 Provider 的实现方式
• 修复了嵌入模型解析逻辑，确保与前端配置的一致性

🧠 推理过程支持

为 DeepSeek Reasoner 等支持推理的模型提供了实时推理过程显示：

• 基于流式响应实时显示模型的思考过程
• 推理结束后自动折叠，保持界面整洁
• 支持在推理过程中手动切换展开/折叠状态

💻 平台支持增强

• Linux 平台：新增 Linux 平台的设置按钮支持
• 界面优化：改进了滚动条样式和下拉菜单的视觉体验

📝 文档更新

• 更新了 README，增加了对 LLM 服务支持的详细说明
• 改进了国际化支持，新增智谱 AI 相关的中英文翻译

🛠️ 技术细节

依赖更新

• 新增 ai 和 @ai-sdk/openai 依赖
• 集成多个社区和官方 AI SDK Provider
• 升级了相关依赖到最新稳定版本

代码优化

• 重构了聊天处理器逻辑，适配 AI SDK v5 的流式协议
• 优化了 IPC 消息格式，提升了前后端通信效率
• 改进了类型定义，增强了 TypeScript 类型安全

🐛 问题修复

• 修复了 Ollama API 端点配置问题（从 /models 改为 /api/tags）
• 修复了嵌入模型选择逻辑，现在会优先使用配置文件中的模型设置
• 修复了推理内容组件的状态管理问题

📦 安装与升级

新用户

访问 GitHub Releases 下载对应平台的安装包。

现有用户升级

• Windows：应用会自动检查更新并提示安装
• macOS：支持自动更新功能
• Linux：请手动下载最新版本安装包进行升级

🔮 下一步计划

• 继续优化 Provider 系统的性能和稳定性
• 支持更多 AI Provider（如 Kimi、百川等）
• 改进推理过程的显示效果
• 增加文档导入格式的支持

🙏 致谢

感谢所有为本次版本做出贡献的开发者和用户！特别感谢 Vercel AI SDK 团队提供的优秀工具链。

---

完整更新日志：查看 GitHub Commits

如遇到问题，请在 GitHub Issues 中反馈。

1.0.5-beta.1

Release v1.0.5-beta.1

Features:
- Add Qwen (通义千问) AI provider support
- Add Kimi (月之暗面) AI provider support
- Add Base URL configuration for all AI providers
- Add "Reset to Default" button for Base URL restoration

Changes:
- Remove Ollama provider
- Update provider UI with Base URL management
- Add i18n support for Qwen and Kimi providers

v1.0.5 - Ollama Support & Provider System Overhaul

🚀 KnowNote v1.0.5

This release introduces local LLM support with Ollama, a complete provider system architecture overhaul, and various UI improvements.

---

✨ Major Features

🤖 Ollama Local LLM Provider

• Run AI models completely offline with Ollama integration
• Support for both chat and embedding capabilities
• OpenAI-compatible API implementation for seamless integration
• Default endpoint: http://localhost:11434/v1
• Flexible configuration with custom server address support

🏗️ Provider System Architecture Overhaul

• Capability-based design: Modular chat, embedding, rerank, and image generation capabilities
• Config-driven architecture: Simplified provider registration and management
• Unified OpenAI-compatible implementation: Reduced code duplication
• Registry pattern with ProviderDescriptor and ProviderRegistry
• Cleaner separation between configuration and runtime logic

---

🔧 Improvements

Provider Management

• ✅ Fix model name truncation issue - now properly preserves version tags
  • Examples: qwen3:0.6b, gpt-4o-mini:2024-07-18, llama3.2:latest
• ✅ Unified provider URL configuration naming across all providers
• ✅ Enhanced custom provider support with Base URL configuration
• ✅ Improved error handling and validation

UI/UX Enhancements

• 🎨 Custom scrollbar styling for dropdown menus
• 🔧 Improved provider settings panel layout
• 📋 Better model selection interface

---

🐛 Bug Fixes

• Fixed model ID parsing to support colon-separated version tags
• Improved provider configuration persistence
• Enhanced error messages for better debugging

---

📦 Technical Details

New Architecture Components

src/main/providers/
├── capabilities/          # Modular capability interfaces
│   ├── BaseProvider.ts
│   ├── ChatCapability.ts
│   ├── EmbeddingCapability.ts
│   ├── RerankCapability.ts
│   └── ImageGenerationCapability.ts
├── handlers/             # Protocol-specific implementations
│   ├── OpenAIChatHandler.ts
│   └── OpenAIEmbeddingHandler.ts
├── registry/            # Provider registration system
│   ├── ProviderDescriptor.ts
│   ├── ProviderRegistry.ts
│   └── builtinProviders.ts
└── base/
    └── OpenAICompatibleProvider.ts

Code Changes

• 30 files changed: +1,422 insertions, -723 deletions
• Removed individual provider classes (DeepSeekProvider, KimiProvider, etc.)
• Centralized logic in OpenAICompatibleProvider
• Created reusable handler pattern for API communication

---

🎯 Supported Providers

Provider	Chat	Embedding	Notes
Ollama	✅	✅	NEW - Local LLM runner
OpenAI	✅	✅	GPT-4, GPT-3.5, etc.
DeepSeek	✅	✅	DeepSeek-V3, DeepSeek-Chat
Qwen	✅	✅	Qwen-Max, Qwen-Plus
Kimi	✅	❌	Moonshot AI
SiliconFlow	✅	✅	Model aggregation platform

---

📚 Getting Started with Ollama

Installation

# macOS
brew install ollama

# Linux
curl -fsSL https://ollama.com/install.sh | sh

# Windows: Download from https://ollama.com

Usage

# Start Ollama service
ollama serve

# Download models
ollama pull qwen2.5:7b        # Chat model
ollama pull nomic-embed-text  # Embedding model

Configuration in KnowNote

1. Open Settings → Providers
2. Select Ollama
3. API Key: Enter any value (e.g., ollama)
4. Base URL: Keep default http://localhost:11434/v1
5. Click "Fetch Models" and select your downloaded models
6. Enable the provider

---

🔄 Migration Notes

For Existing Users

• No breaking changes for existing provider configurations
• Model selections will be automatically preserved
• The architecture changes are internal and backward-compatible

For Developers

• Old provider classes (OpenAIProvider, DeepSeekProvider, etc.) have been removed
• All providers now use OpenAICompatibleProvider as the base
• Custom providers should implement capability interfaces
• See src/main/providers/registry/builtinProviders.ts for registration examples

---

🙏 Acknowledgments

Thanks to the Ollama team for creating an excellent local LLM runtime!

---

📝 Full Changelog

Commits included in this release:

• fdf9062 feat: add Ollama local LLM provider support (#7)
• 9f26183 style: add custom scrollbar styling to dropdown menus (#6)
• 9e48198 refactor: unify provider URL configuration naming
• 6edf9d3 refactor: restructure provider system with capability separation and config-driven architecture

Full Changelog: v1.0.4...v1.0.5

1.0.4

✨ 新功能

• 添加知识库和笔记面板的折叠/展开功能，支持更灵活的界面布局
  • 在顶部标题栏添加折叠按钮，可以独立控制左右面板的显示/隐藏
  • 折叠后自动保存面板宽度，展开时恢复原始宽度
  • 中间面板自动扩展以充分利用空间

🔧 改进

• 移除消息列表的最大宽度限制，消息内容可以更好地利用可用空间
• 代码重构：统一使用 `shrink-0` 类名替代 `flex-shrink-0`，提升代码一致性
• 优化文字换行样式，改进长文本显示效果

📦 其他

• 版本号更新至 1.0.4

1.0.3

v1.0.3

chore: bump version to 1.0.3

v1.0.2

✨ 新功能

• 🔄 简化更新流程：点击按钮后自动下载并安装，无需二次操作
• 🌐 外部链接改为在系统默认浏览器中打开（官方网站、意见反馈）

🐛 Bug 修复

• 📌 修复版本号硬编码问题，现在从 package.json 动态获取
• 🎨 修复深色模式下图标不可见的问题

📝 完整变更日志

查看详细变更：v1.0.1...v1.0.2