beatsad_Vault2Dify/CHANGELOG_ZH.md

更新日志

English | 中文

本项目的所有重要变更都会记录在这个文件中。

1.0.0 - 2026-06-08

新增

• 中文优先的 Obsidian 设置页、通知、状态栏和命令。
• 支持配置 Dify API 主地址、局域网地址和公网地址。
• 支持端点策略选择和自动回退。
• 通过 GET /v1/datasets 测试连接并刷新知识库。
• 支持文件夹到知识库的映射。
• 支持一个文件夹同步到多个 Dify 知识库。
• 支持多个文件夹同步到同一个 Dify 知识库。
• 支持 Markdown 文件创建、修改和重命名事件触发同步。
• 支持启动同步和周期性全量扫描兜底。
• 支持请求超时、重试、并发、同步队列和同步锁处理。
• 兼容 Dify 文档路径 create-by-text / update-by-text 和 create_by_text / update_by_text。
• 同步记录按 知识库 ID + 文件路径 建立键值。
• 远程文档名称基于 Obsidian 文件路径生成，避免同名文件冲突。
• 记录本地删除行为，但不会自动删除远程文档。
• 可选检查 Dify 索引状态。
• 支持调试日志和同步记录重置工具。
• 为常见 Dify API、权限、超时和网络错误提供更友好的连接诊断。
• 设置页诊断信息显示当前活动 Dify 端点和最近同步详情。
• 为 URL 规范化、文件夹匹配、ID 解析、数字范围限制和同步记录键等同步工具增加测试基础。
• 逐步拆分共享类型、Dify API 客户端、同步记录辅助函数和路径/解析工具。
• 渐进式首次使用路径：填写 Dify API Key、测试连接、刷新知识库，然后添加文件夹映射。
• 连接健康概览显示当前可用性、活动 Dify 地址、上次成功地址、最近同步状态和更清晰的失败反馈。
• 卡片式文件夹映射，支持启用/禁用状态、知识库标签、编辑控制和带本地/远程删除边界说明的删除确认。
• 映射弹窗流程，支持选择 Obsidian 文件夹、选择一个或多个 Dify 知识库，并保存为启用或禁用映射。
• 同步诊断面板显示最近同步来源、总数、耗时、活动地址、错误和最近失败文件。
• 简短状态栏消息，例如就绪、同步中和失败；更长的详情移到设置页诊断中。
• 设置页评审布局，顶部包含语言、帮助、GitHub 操作，以及四个最近同步摘要指标。
• 连接操作行支持清空配置和测试 Dify 连接；测试成功后会刷新并保存知识库列表。
• 连接配置区支持显示/隐藏 API Key。
• 表格式路径映射，包含序号、Obsidian 路径、知识库标签、状态开关和仅图标编辑/删除控制。
• 为最近同步指标和连接状态语气增加经过测试的设置摘要视图模型。

变更

• 将发布身份重命名为 Vault2Dify，包括插件元数据、包元数据、GitHub 链接、安装路径和设置/帮助文案。
• 将 package.json、package-lock.json、manifest.json 和 versions.json 中的发布元数据更新为 1.0.0。
• 更新 README、中文用户指南、安装说明和发布检查清单，以匹配设置页评审体验。
• 将当前文档与最新发布的插件 UI 对齐，包括路径映射、固定同步设置选项和隐藏的兼容字段。

验证

• 为版本一致性、设置流程、Dify 连接检查、文件夹映射、同步行为、本地删除策略、发布产物和隐私边界增加发布检查清单覆盖。

文档

• 新增中文用户指南。
• 新增公开发布就绪计划。
• 新增安全和隐私文档。
• 更新安装指南以支持多知识库映射。