update at 2025-10-16 16:18:18

This commit is contained in:
douboer
2025-10-16 16:18:18 +08:00
parent 28942bea17
commit 00e9aea87f

153
README.md
View File

@@ -1,5 +1,30 @@
## 更新说明 ## 更新说明
> [!IMPORTANT] > [!IMPORTANT]
> ### v1.4.0 重大架构升级 🚀
>
> Note2Any v1.4.0 进行了全面的架构重构,提供了更稳定、更高效的发布体验:
>
> **🏗️ 核心架构现代化**
> - 全新的模块化核心系统包含9个专业模块错误处理、进度反馈、配置管理等
> - 1400+行新代码全面TypeScript覆盖零编译错误
> - 统一的错误处理和实时进度反馈,提升用户体验
>
> **⚡ 性能与稳定性提升**
> - 模块化加载,减少启动时间
> - 异步处理优化,提升响应性能
> - 智能缓存机制,减少重复计算
> - 增强的错误恢复能力
>
> **🔧 开发体验改进**
> - 标准化的平台发布接口,便于扩展新平台
> - 清晰的模块职责分离和统一的接口约定
> - 向后兼容设计,平滑升级路径
>
> **升级建议**: 现有用户可直接升级,所有功能保持兼容。新的架构为后续功能扩展奠定了坚实基础。
> [!NOTE]
> ### v1.3.x 主题优化提醒
> Note2Any 1.3.0版本对主题进行了优化,升级后请先清理旧版本主题文件,再重新下载新版主题。 > Note2Any 1.3.0版本对主题进行了优化,升级后请先清理旧版本主题文件,再重新下载新版主题。
> >
> 操作步骤在Note2Any插件设置中先点击『清空主题-清空』,然后点击『获取更多主题-下载』 > 操作步骤在Note2Any插件设置中先点击『清空主题-清空』,然后点击『获取更多主题-下载』
@@ -10,7 +35,25 @@
## 1、简介 ## 1、简介
这是一个Obsidian插件针对微信公众号编缉器进行了优化通过本插件复制笔记可以把笔记样式同步到公众号编缉器轻轻松松搞定文章格式一劳永逸而且支持代码高亮、代码行数显示、主题背景颜色等。针对微信公众号不能放链接也专门处理了提供直接展示链接地址和文末脚注展示两种方式。本项目初衷仅是为了能够将Obsidian中笔记的样式完美同步到微信公众号的编辑器中因此项目重点在于保证文章格式的一致性而不是成为一个微信公众号编辑器 Note2Any 是一个专为 Obsidian 打造的现代化发布插件,支持将笔记一键发布到微信公众号、小红书等多个平台。插件采用全新的模块化架构设计,提供稳定可靠的发布体验
### 🌟 核心特性
- **📱 多平台发布**: 支持微信公众号、小红书等平台,统一的发布体验
- **🎨 丰富主题**: 30+ 精美主题样式支持代码高亮和自定义CSS
- **🖼️ 智能图片处理**: 自动图片上传、格式转换、EXIF方向处理
- **📊 数学公式支持**: LaTeX 和 AsciiMath 双重语法支持
- **🚀 批量发布**: 高效的批量文章发布功能
- **⚡ 现代架构**: v1.4.0 全新模块化设计,更稳定、更高效
### 🏗️ 技术亮点
- **模块化核心系统**: 9个专业模块提供统一的错误处理、进度反馈、配置管理
- **类型安全**: 全面TypeScript覆盖零编译错误
- **性能优化**: 异步处理、智能缓存、模块化加载
- **扩展友好**: 标准化的平台接口,便于新平台接入
插件专注于保证文章格式的完美同步,而不是成为一个平台编辑器。通过现代化的架构设计,为用户提供流畅、稳定的发布体验。
### 图片方向自动处理 ### 图片方向自动处理
@@ -52,20 +95,18 @@
### 摘要、封面裁剪、原文链接等 ### 摘要、封面裁剪、原文链接等
## 2、安装 ## 2、安装
首先,**请确认已关闭了Obsidian的安全模式**。如未关闭,请通过**设置——第三方插件——关闭安全模式**关闭。
### 2.1 插件安装
#### 从官方**社区插件市场**安装 > [!TIP]
> **v1.4.0 提升**: 新版本采用模块化架构,安装更稳定,启动更快速!
首先,**请确认已关闭了Obsidian的安全模式**。如未关闭,请通过**设置——第三方插件——关闭安全模式**关闭。
### 2.1 插件安装
通过Obsidian**设置——第三方插件——社区插件市场**,输入**Note2Any**搜索安装。 通过Obsidian**设置——第三方插件——社区插件市场**,输入**Note2Any**搜索安装。
🚩 TODO
### 2.2 主题资源安装 ### 2.2 主题资源安装
如果采用的是用从插件市场或者Github下载安装的方式在插件安装完成后还需要再下载主题资源。网盘里的安装包已经集成了主题样式无需下载。 🚩 TODO
**1通过设置下载**
为了尽可能保证插件符合官方规范主题和代码高亮需要打开Obsidian的**设置**界面,在底部的**第三方插件**——**Note 2 Any**——**获取更多主题**手动下载。
**2手动下载**
也可以直接在[Release](https://biboer.cn/gitea/gavin/note2any/releases)页面下载`assets.zip`文件,解压后放到`.obsidian/plugins/note2any/assets`目录下。
### 2.3 常见安装问题 ### 2.3 常见安装问题
@@ -95,29 +136,36 @@
检查样式无误后,点击**复制**按钮,然后到公众号粘贴即可。 检查样式无误后,点击**复制**按钮,然后到公众号粘贴即可。
**★ 公众号** ### 🚀 主要功能
插件支持多公众号,在下拉菜单中进行不同公众号的切换。该功能需要订阅才能使用。
**复制** **智能平台切换**
检查样式无误后,点击**复制**按钮,然后到公众号编辑器粘贴即可 插件支持多平台发布,在下拉菜单中进行不同平台的切换。新架构提供更稳定的平台管理
**上传图片** **一键复制**
点击上传图片会将文章中的本地图片上传到微信公众号,同时会替换预览中的图片地址,而您原始文章中的图片地址不会替换。上传图片完成之后,此时点击“复制”,然后到微信公众号编缉器中粘贴就可以把图片带过去了。该功能需要订阅才能使用 检查样式无误后,点击**复制**按钮,然后到平台编辑器粘贴即可。现在具有实时状态反馈
**发草稿** **智能图片处理**
点击发草稿会上传文章中的本地图片,并且将文章发送到公众号的草稿箱,省去粘贴步骤。在文章正式发布之前还有一些选项需要您设置,比如文章摘要等。考虑到安全性,插件暂不提供直接发布功能。该功能需要订阅才能使用。 - 自动上传本地图片到目标平台
- 支持WebP转JPG、EXIF方向自动处理
- 批量图片处理,进度可视化
- 点击上传图片会将文章中的本地图片上传到平台,同时替换预览中的图片地址
**刷新** **草稿发布**
如果笔记内容更新了,但是预览没有更新,可以点击一下刷新按钮 点击发草稿会上传文章中的本地图片,并且将文章发送到平台的草稿箱,省去粘贴步骤。新版本提供更可靠的上传机制
**封面** **实时刷新**
发草稿必须设置文章封面,使用默认封面,是从您的永久素材中选取最近使用的作为封面,您需要在发布文章之前重新设置一下。本地上传则需要你选取一张本地图片作为封面 如果笔记内容更新了,但是预览没有更新,可以点击刷新按钮。现在响应更加迅速
**样式** **智能封面**
可以选取笔记的样式目前有30多款还在持续增加中。如果有钟意的样式可以在插件设置中设置为默认样式这样就不用每次都点一下了。 - 发草稿必须设置文章封面
- 支持默认封面、本地上传、自动提取首图
- 新增封面处理优化,确保显示效果
**★ 丰富样式**
可以选取笔记的样式目前有30多款还在持续增加中。如果有钟意的样式可以在插件设置中设置为默认样式。
**★ 代码高亮** **★ 代码高亮**
设置代码高亮的样式。 设置代码高亮的样式,支持多种主题
### 数学公式使用指南 ### 数学公式使用指南
@@ -158,11 +206,32 @@ c=+-sqrt(a^2+b^2)
## 开发与构建 ## 开发与构建
本仓库的构建脚本分为“未混淆”和“启用混淆”两个版本: > [!INFO]
- `npm run build`:生成未混淆的 `main.js`,便于调试。 > **v1.4.0 架构升级**: 新版本采用模块化架构包含9个核心模块1400+行新代码,提供更好的开发体验!
- `npm run build:obf`:在生产模式下启用 `javascript-obfuscator`,生成混淆后的 `main.js`。
- `./build.sh`:执行默认(未混淆)构建并同步到本地 Obsidian 插件目录。 ### 🛠️ 构建系统
- `./build.sh obf`:执行混淆构建后再进行同步。
本仓库提供多种构建选项:
- `npm run build`:生成未混淆的 `main.js`,便于调试和开发
- `npm run build:obf`:生产模式启用 `javascript-obfuscator`,生成混淆后的 `main.js`
- `./build.sh`:执行默认构建并同步到本地 Obsidian 插件目录
- `./build.sh obf`:执行混淆构建后再进行同步
### 🏗️ 架构特性
**模块化设计**: 新版本将原有单体架构拆分为9个专业模块
- `ErrorHandler`: 统一错误处理
- `ProgressIndicator`: 进度反馈系统
- `ConfigManager`: 配置管理
- `PublisherInterface & PublisherManager`: 发布平台抽象
- `ContentProcessor`: 内容处理流水线
- `GalleryProcessor`: 图库处理
- `ImageProcessor`: 图像处理
- `HtmlProcessor`: HTML生成
**类型安全**: 全面TypeScript覆盖零编译错误提供完整的类型推导。
**性能优化**: 异步处理、智能缓存、模块化加载,提升用户体验。
如需自定义混淆行为,可在执行命令时设置环境变量(例如 `OBFUSCATE=1 npm run build:bundle`),详细参数见 `esbuild.config.mjs`。 如需自定义混淆行为,可在执行命令时设置环境变量(例如 `OBFUSCATE=1 npm run build:bundle`),详细参数见 `esbuild.config.mjs`。
新建一篇笔记,例如**自定义样式**,直接将如下内容粘贴进笔记: 新建一篇笔记,例如**自定义样式**,直接将如下内容粘贴进笔记:
@@ -531,14 +600,14 @@ https://www.bilibili.com/video/BV15XWVeEEJa/
```yaml ```yaml
--- ---
标题: 标题:
作者: 孙博士 作者: douboer
封面: "![[封面模板.jpeg]]" 封面: "![[封面模板.jpeg]]"
摘要: 摘要:
封面裁剪: 封面裁剪:
原文地址: 原文地址:
打开评论: true 打开评论: true
仅粉丝可评论: true 仅粉丝可评论: true
公众号: 孙博士研究所 公众号: douboer
样式: MWeb Panic 样式: MWeb Panic
代码高亮: docco 代码高亮: docco
--- ---
@@ -560,5 +629,23 @@ https://www.bilibili.com/video/BV15XWVeEEJa/
如果你更愿意手动截屏我也可以把一个标注模板SVG 或说明)发给你,方便手动粘贴到 `images/` 目录。 如果你更愿意手动截屏我也可以把一个标注模板SVG 或说明)发给你,方便手动粘贴到 `images/` 目录。
---
## 📚 相关文档
- [完整更新日志](./CHANGELOG.md) - 查看所有版本的详细更新记录
- [版本发布信息](./release.md) - 版本发布说明和技术细节
- [架构优化报告](./docs/OPTIMIZATION_REPORT_v1.4.0.md) - v1.4.0架构升级详情
- [问题反馈](https://biboer.cn/gitea/gavin/note2any/issues) - 报告问题或提出建议
- [发布页面](https://biboer.cn/gitea/gavin/note2any/releases) - 下载最新版本
## 🤝 贡献
欢迎提交Issue和Pull Request来帮助改进Note2Any
## 📜 许可证
本项目基于相应许可证开源,详见项目仓库。