284 lines
12 KiB
Markdown
284 lines
12 KiB
Markdown
|
||
# 版本信息
|
||
‼️ 发布版本时填写，供脚本~/pubsh/release.sh使用
|
||
|
||
|
||
## v1.3.12
|
||
### 🚀 核心架构重构与优化
|
||
|
||
#### 新增核心模块系统
|
||
- **ErrorHandler**: 统一错误处理机制，提供集中化的错误管理和用户友好的提示
|
||
- **ProgressIndicator**: 全新的进度反馈系统，为长时间操作提供实时状态更新
|
||
- **ConfigManager**: 中心化配置管理，支持运行时配置验证和热更新
|
||
- **PublisherInterface**: 标准化平台发布接口，支持多平台扩展
|
||
- **PublisherManager**: 统一的发布平台管理器
|
||
- **ContentProcessor**: 模块化内容处理流水线
|
||
|
||
#### 专业化处理模块
|
||
- **GalleryProcessor**: 专门处理图库短代码，支持目录式和块级图库
|
||
- **ImageProcessor**: 统一图像处理接口，支持WebP转换、批量处理、微信上传
|
||
- **HtmlProcessor**: HTML内容生成和格式化，支持响应式设计和移动端优化
|
||
|
||
#### 架构改进
|
||
```
|
||
┌─────────────────────────────────────────────┐
|
||
│ Core System Layer (新增) │
|
||
│ - ErrorHandler (错误处理) │
|
||
│ - ProgressIndicator (进度反馈) │
|
||
│ - ConfigManager (配置管理) │
|
||
│ - PublisherManager (发布管理) │
|
||
└──────────────┬──────────────────────────────┘
|
||
│ 支撑
|
||
↓
|
||
┌─────────────────────────────────────────────┐
|
||
│ Business Logic Layer │
|
||
│ preview-manager.ts (中央调度器) │
|
||
│ - 集成核心模块 │
|
||
│ - 增强错误处理 │
|
||
│ - 进度反馈集成 │
|
||
└──────────────┬──────────────────────────────┘
|
||
│ 管理
|
||
┌───────┼───────┐
|
||
↓ ↓ ↓
|
||
┌──────────┐ ┌──────────┐ ┌──────────┐
|
||
│Platform │ │Wechat │ │Xiaohong- │
|
||
│Chooser │ │Preview │ │shu │
|
||
│(UI选择器)│ │(微信实现)│ │Preview │
|
||
└──────────┘ └──────────┘ │(小红书) │
|
||
└──────────┘
|
||
```
|
||
|
||
#### 性能优化
|
||
- 模块化加载，减少初始化时间
|
||
- 异步处理优化，提升响应性能
|
||
- 智能缓存机制，减少重复计算
|
||
|
||
#### 可维护性提升
|
||
- 明确的模块职责分离
|
||
- 统一的接口和约定
|
||
- 完善的类型定义
|
||
- 向后兼容的API设计
|
||
|
||
### 🔧 技术改进
|
||
- 重构项目名称从"note-to-mp"到"note2any"
|
||
- 更新仓库地址到 https://biboer.cn/gitea/gavin/note2any.git
|
||
- 批量更新66个CSS主题文件的类名
|
||
- 优化构建和部署流程
|
||
|
||
### 📚 文档更新
|
||
- 新增系统优化报告 (OPTIMIZATION_REPORT_v1.3.12.md)
|
||
- 更新README文档，反映新的项目名称
|
||
- 完善架构文档
|
||
|
||
## v1.3.4
|
||
### 重构
|
||
#### 新的架构图
|
||
|
||
```
|
||
┌─────────────────────────────────────────────┐
|
||
│ Obsidian Framework Layer │
|
||
│ preview-view.ts (ItemView 容器) │
|
||
│ - 视图生命周期管理 │
|
||
│ - 事件监听注册 │
|
||
│ - 委托所有业务逻辑 │
|
||
└──────────────┬──────────────────────────────┘
|
||
│ 持有并委托
|
||
↓
|
||
┌─────────────────────────────────────────────┐
|
||
│ Business Logic Layer │
|
||
│ preview-manager.ts (中央调度器) ★ │
|
||
│ - 创建和管理所有子组件 │
|
||
│ - 处理平台切换（唯一入口） │
|
||
│ - 协调组件交互 │
|
||
│ - 管理渲染流程 │
|
||
└──────────────┬──────────────────────────────┘
|
||
│ 管理
|
||
┌───────┼───────┐
|
||
↓ ↓ ↓
|
||
┌──────────┐ ┌──────────┐ ┌──────────┐
|
||
│Platform │ │Wechat │ │Xiaohong- │
|
||
│Chooser │ │Preview │ │shu │
|
||
│(UI选择器)│ │(微信实现)│ │Preview │
|
||
└──────────┘ └──────────┘ │(小红书) │
|
||
└──────────┘
|
||
```
|
||
|
||
#### 单向数据流
|
||
|
||
```
|
||
用户操作 → PlatformChooser.onChange()
|
||
↓
|
||
PreviewManager.switchPlatform()
|
||
↓
|
||
┌────┴────┐
|
||
↓ ↓
|
||
show/hide show/hide
|
||
Wechat Xiaohongshu
|
||
```
|
||
|
||
## bug修复
|
||
**症状1**：Obsidian 一直处于"加载工作区中"状态
|
||
**症状2**：进入安全模式后关闭安全模式，插件能加载但提示：
|
||
> "获取样式失败defaultldefault，请检查主题是否正确安装。"
|
||
|
||
## v1.3.8
|
||
重新实现分页测量，清理多余日志。
|
||
- 重新实现分页测量：构建隐藏的“测量页面”，与真实页面同样的宽度、内边距（40px）和 class，逐个把克隆元素追加进去，利用 scrollHeight 决定是否换页，保证 margin 折叠后计算准确 (src/xiaohongshu/paginator.ts:57；waitForLayout 新增)。
|
||
- 当元素放不下当前页时，移除测量克隆并把已排内容写入分页，再以该元素开启新页；不可分割元素允许独占一页即便超高 (src/xiaohongshu/paginator.ts:101)。
|
||
- 清理多余日志，同时共用 PAGE_PADDING 常量让 renderPage 和测量逻辑保持一致 (src/xiaohongshu/paginator.ts:182)。
|
||
|
||
现在分页依据真实渲染高度，预览窗口内不会再丢失底部内容。建议在小红书预览里多翻几页、调整字号后重新分页验证结果。
|
||
|
||
## v1.3.10
|
||
重构xhs和wechat布局，统一使用grid，便于维护。
|
||
|
||
## v1.3.11
|
||
修改wechat封面旋转问题。对全局配置进行了重构，分页显示，更加清晰。
|
||
|
||
封面图片先转位png解决旋转问题。
|
||
|
||
## v1.3.12
|
||
本次更新主要为项目重命名，核心功能保持不变
|
||
|
||
### 重大更新
|
||
#### 项目名称变更 & 仓库迁移
|
||
- **新仓库地址**：https://biboer.cn/gitea/gavin/note2any.git
|
||
- **问题反馈**：https://biboer.cn/gitea/gavin/note2any/issues
|
||
- **发布页面**：https://biboer.cn/gitea/gavin/note2any/releases
|
||
|
||
#### 样式系统更新
|
||
- CSS类名 & 主题资源统一
|
||
|
||
## v1.4.0
|
||
架构升级与代码质量提升
|
||
|
||
### 🏗️ 架构升级与代码质量提升
|
||
|
||
#### 核心架构现代化
|
||
- **模块化重构**: 建立了完整的核心模块系统，包含错误处理、进度反馈、配置管理等9个专业模块
|
||
- **类型安全**: 全面的TypeScript类型定义，零编译错误，提升代码可靠性
|
||
- **接口标准化**: 统一的平台发布接口，支持更好的扩展性和维护性
|
||
|
||
#### 新增核心功能模块
|
||
- **统一错误处理**: ErrorHandler模块提供集中化的错误管理和用户友好提示
|
||
- **实时进度反馈**: ProgressIndicator为长时间操作提供状态更新
|
||
- **智能配置管理**: ConfigManager支持运行时验证和热更新
|
||
- **可扩展发布系统**: 标准化的平台接口，便于新平台接入
|
||
|
||
#### 专业化处理引擎
|
||
- **图库处理器**: 专门优化图库短代码处理，支持多种格式和智能选择
|
||
- **图像处理引擎**: 统一的图像处理接口，支持格式转换、批量处理、云端上传
|
||
- **HTML生成器**: 增强的HTML处理，支持响应式设计和移动端优化
|
||
|
||
#### 开发体验改进
|
||
- **代码组织**: 清晰的模块职责分离，1400+行新增代码
|
||
- **维护性**: 统一的接口约定和完善的文档
|
||
- **向后兼容**: 保持现有API稳定，平滑升级路径
|
||
|
||
#### 性能与稳定性
|
||
- **启动优化**: 模块化加载减少初始化时间
|
||
- **响应性能**: 异步处理优化，提升用户体验
|
||
- **错误恢复**: 智能的错误处理和恢复机制
|
||
|
||
### 🔧 技术债务清理
|
||
- 重构大型文件，提升代码可读性
|
||
- 统一错误处理模式
|
||
- 优化资源加载策略
|
||
- 完善类型定义覆盖
|
||
|
||
### 📖 文档与工程化
|
||
- 新增详细的架构文档和优化报告
|
||
- 完善开发和部署流程
|
||
- 更新项目说明和使用指南
|
||
|
||
## v1.5.0
|
||
### 🎨 使用figma重构界面。功能完善与体验优化。
|
||
|
||
#### 小红书平台增强
|
||
- **可编辑页码**: 页码输入框支持直接输入跳转，提升翻页效率
|
||
- 点击页码框可直接输入目标页码
|
||
- 支持回车键和失焦自动跳转
|
||
- 聚焦时自动全选文本，方便快速输入
|
||
- 输入验证：超出范围自动恢复当前页码
|
||
|
||
- **切图功能完善**: 实现完整的小红书切图保存功能
|
||
- 支持"当前图"和"全部图"两种切图模式
|
||
- 自动计算正确的图片尺寸（基于宽度和横竖比设置）
|
||
- 修复切图布局问题：内容正确填充整个图片区域
|
||
- 修复定位问题：移除 transform 缩放和 absolute 定位影响
|
||
- 智能路径处理：支持绝对路径和 vault 相对路径
|
||
|
||
- **路径管理优化**:
|
||
- 默认保存路径改为 vault 相对路径（`xhs-images`）
|
||
- 支持绝对路径（如 `/Users/xxx/images/xhs/`）
|
||
- 支持 vault 内相对路径（如 `images/xhs`）
|
||
- 自动创建不存在的目录
|
||
- 保存成功后显示完整文件路径通知
|
||
|
||
#### 主题系统优化
|
||
- **统一宽度限制**:
|
||
- `wx-mp-pro` 主题添加 `max-width: 750px` 限制
|
||
- 与 `xhs-philosophy` 主题保持一致
|
||
- 添加 `margin: 0 auto` 实现内容居中
|
||
- 统一 padding 为 20px，提升阅读体验
|
||
|
||
- **主题一致性**:
|
||
- 确保不同主题在相同宽度设置下显示效果一致
|
||
- 避免内容过度拉伸，保持舒适的阅读宽度
|
||
- 优化移动端和桌面端的显示效果
|
||
|
||
#### 默认设置改进
|
||
- **默认平台调整**:
|
||
- 启动时默认显示"公众号"平台
|
||
- 更符合主流用户使用习惯
|
||
- `currentPlatform` 默认值从 `xiaohongshu` 改为 `wechat`
|
||
|
||
- **设置界面优化**:
|
||
- 切图保存路径说明更新为"vault 内相对路径"
|
||
- 占位符文本更新为相对路径示例
|
||
- 添加路径类型说明，避免用户混淆
|
||
|
||
#### 代码质量提升
|
||
- **类型安全**:
|
||
- 添加 `parseAspectRatio` 函数处理横竖比解析
|
||
- 完善 `slice.ts` 的类型定义和错误处理
|
||
- 统一使用 TypeScript 严格模式
|
||
|
||
- **函数优化**:
|
||
- 重构 `ensureDir` 支持两种路径类型
|
||
- 优化图片保存逻辑，使用正确的 API
|
||
- 改进样式恢复机制，确保预览不受影响
|
||
|
||
#### Bug 修复
|
||
- 修复切图内容只占右下角的布局问题
|
||
- 修复切图高度计算错误的问题
|
||
- 修复绝对路径文件保存失败的问题
|
||
- 修复主题切换时宽度不一致的问题
|
||
- 修复页码显示元素引用错误的问题
|
||
|
||
#### 技术细节
|
||
- 切图时临时设置：
|
||
```typescript
|
||
position: 'static' // 移除绝对定位
|
||
transform: 'none' // 移除缩放变换
|
||
width: sliceImageWidth // 设置实际宽度
|
||
height: sliceImageHeight // 设置实际高度（新增）
|
||
```
|
||
|
||
- 路径判断逻辑：
|
||
```typescript
|
||
if (isAbsolutePath(path)) {
|
||
// 使用 Node.js fs API
|
||
fs.writeFileSync(...)
|
||
} else {
|
||
// 使用 Obsidian vault API
|
||
app.vault.adapter.writeBinary(...)
|
||
}
|
||
```
|
||
|
||
### 📚 文档更新
|
||
- 更新 README.md 反映 v1.5.0 新功能
|
||
- 添加小红书切图功能使用说明
|
||
- 完善路径配置说明文档
|
||
|