Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 18 additions & 4 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,27 @@
# 更新记录

## 未发布

## 0.2.0 — 2026-09-29

开发预览版。六条内容路径的草稿保存与发布前准备、五站真实数据和评论读取尚未全部通过真实平台验收;最终发布仍由用户在原站手动完成。

- 重做工作台视觉层级、深蓝导航、内容卡片与响应式布局,清理重复的说明小字。
- 新增“设置”分类页;界面默认字号提高到 16px,正文默认 17px,支持即时调节并持久保存,提供默认视图与启动刷新开关。
- 新增每 6 小时自动检查 GitHub Release、手动检查、预览版筛选和新版本提醒;用户自行选择下载,再按步骤更新解压扩展,不自动安装。

- 内容库新增多词搜索、平台与发布记录筛选、三种排序、卡片/列表视图、分页,以及复制、批量归档、撤销和导出。返回内容库保留筛选与页码。
- 编辑器新增格式工具栏、Ctrl+B / Ctrl+I / Ctrl+S、专注写作/双栏对照/阅读预览和当前版本导出。
- 修复多窗口继续编辑时覆盖较新母稿、平台版本无并发保护,以及批量导入失败残留图片的问题。
- 连续输入合并保存;保存失败后阻止后续写入和离开页面,支持重试或将全部当前版本另存为新稿。
- 修复正文恢复母稿继承时被编辑器回调再次写成独立内容;切换平台清空旧文字选区。
- 导出 Markdown 和配套图片,重写本地图片引用;缺失图片时明确报错。内容导出与完整备份分别提供。
- 发布队列增加状态、平台和标题筛选,并只执行筛选范围内可启动的任务。
- 有原站操作痕迹的失败/取消任务继续阻止重复排队;取消和后台领取在事务内互斥,防止旧页面取消已执行任务。
- 页面按需加载,预览复用已读取的图片,ZIP 压缩复用独立 Worker;目录备份完成后检查期间的新编辑,错误支持手动重试。
- 正式构建预览支持 `PORT` 环境变量,方便在独立来源中验证数据与 CSP。
- 采用 A「经典四色」图标,统一扩展工具栏、标签页与工作台品牌。
- 更新仓库首页:品牌横幅、真实本地示例截图、中英文说明和平台进度表。
- 增加路线图、Issue 表单和 Pull Request 模板。

以上变更位于源码分支,既有 v0.1.2 Release 安装包不变。

## 0.1.2 — 2026-09-22

首个以 **zMatrix · 自媒体矩阵工作台** 名称公开的开发预览版。
Expand Down
48 changes: 27 additions & 21 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@
</p>

> [!IMPORTANT]
> **v0.1.2 is a developer preview.** Local editing, variants and backups are implemented. None of the 12 real-platform draft/pre-publication acceptance flows have passed yet; live metrics and comments also remain unverified. You always perform the final publication on the platform yourself. See the [acceptance record](docs/acceptance.md).
> **v0.2.0 is a developer preview.** Local editing, variants and backups are implemented. None of the 12 real-platform draft/pre-publication acceptance flows have passed yet; live metrics and comments also remain unverified. You always perform the final publication on the platform yourself. See the [acceptance record](docs/acceptance.md).

## Your content, in one workspace

Expand All @@ -32,15 +32,21 @@ Keep a master draft, tailor titles and content for each platform, prepare image

![Master draft, platform variants and Markdown preview](docs/assets/editor.png)

| Feature | Current implementation |
| --- | --- |
| Writing and import | Markdown editor, files with companion images, pasted text and images |
| Platform variants | Inherited or overridden titles, content and images; change reminders, diffs and snapshots |
| Technical content | Code, tables, LaTeX and Mermaid previews; selected content converted to images as needed |
| Image posts | Three templates, covers, colors, typography and pagination; 1080 × 1440 PNG export |
| Publication preparation | Frozen content, persistent sequential tasks and a manual final publication step |
| Tracking | Registered article links, cached metrics, paginated comments and local read status; live integrations await validation |
| Storage and backup | IndexedDB autosave, ZIP export/restore and backups to an authorized local folder |
| Feature | Current implementation |
| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Writing and import | Markdown formatting toolbar, focus/split/reading views, atomic import with companion images, pasted text and images |
| Content library | Multi-term title/body/platform-tag search, platform and publication-record filters, sorting, list view, pagination, duplication and bulk archiving with undo |
| Platform variants | Inherited or overridden titles, content and images; change reminders, diffs and snapshots |
| Technical content | Code, tables, LaTeX and Mermaid previews; selected content converted to images as needed |
| Image posts | Three templates, covers, colors, typography and pagination; 1080 × 1440 PNG export |
| Publication preparation | Frozen content, persistent sequential tasks and a manual final publication step |
| Tracking | Registered article links, cached metrics, paginated comments and local read status; live integrations await validation |
| Storage and backup | Coalesced autosave, multi-window conflict protection with save-as-copy recovery, ZIP backup/restore and authorized-folder backups |
| Portable content | Export a version or multiple articles as Markdown ZIPs, with platform metadata and images referenced by relative paths |
| Preferences | Larger default typography, independent interface/editor font sizes, default views and startup refresh preferences saved locally |
| Update checks | Check releases every six hours or manually, choose whether to include previews, and download updates on request; unpacked extensions are replaced and reloaded manually |

These features are included in the v0.2.0 development preview. [Workflow and export guide (Chinese)](docs/workbench.md).

<details>
<summary>See the image-post studio</summary>
Expand All @@ -49,27 +55,27 @@ Keep a master draft, tailor titles and content for each platform, prepare image

</details>

Screenshots show the actual local web preview with the built-in sample article. They do not show live platform integration or private account data. Screenshots may be ahead of the published v0.1.2 package. The application UI is currently in Chinese.
Screenshots show the local web preview with the built-in sample article. They do not show live platform integration or private account data. The application UI is currently in Chinese.

## Platform status

Adapter code is not proof of a working platform flow.

| Platform / content type | Save and reopen draft | Complete preparation before final publication | Live metrics / comments |
| --- | --- | --- | --- |
| Zhihu · article | Pending | Pending | Pending |
| Juejin · article | Pending | Pending | Pending |
| CNBlogs · article | Pending | Pending | Pending |
| CSDN · article | Pending | Pending | Pending |
| Xiaohongshu · long article | Pending | Pending | Pending |
| Xiaohongshu · image post | Pending | Pending | Pending |
| LINUX DO | Manual assistance | Manual assistance | Best effort; unverified |
| Platform / content type | Save and reopen draft | Complete preparation before final publication | Live metrics / comments |
| -------------------------- | --------------------- | --------------------------------------------- | ----------------------- |
| Zhihu · article | Pending | Pending | Pending |
| Juejin · article | Pending | Pending | Pending |
| CNBlogs · article | Pending | Pending | Pending |
| CSDN · article | Pending | Pending | Pending |
| Xiaohongshu · long article | Pending | Pending | Pending |
| Xiaohongshu · image post | Pending | Pending | Pending |
| LINUX DO | Manual assistance | Manual assistance | Best effort; unverified |

Missing settings completed manually do not count as successful automation. Uncertain results require verification before retrying.

## Get started

1. Download the extension ZIP from [Releases](https://github.com/zJay26/zMatrix/releases), such as `zMatrix-edge-0.1.2.zip`, and extract it to a permanent folder.
1. Download the extension ZIP from [Releases](https://github.com/zJay26/zMatrix/releases), such as `zMatrix-edge-0.2.0.zip`, and extract it to a permanent folder.
2. Open `edge://extensions`, enable **Developer mode**, select **Load unpacked**, and choose the folder containing `manifest.json`.
3. Open **zMatrix** from the browser toolbar. Try the sample article, then connect platforms and configure backups as needed.

Expand Down
66 changes: 36 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@
</p>

> [!IMPORTANT]
> **当前为 v0.1.2 开发预览。** 本地编辑、版本管理与备份已有实现;六条内容路径的 **12 项真实草稿/发布前流程验收尚未通过**,五站指标与评论仍待实测。最终发布始终由你在原站手动完成。详见 [验收记录](docs/acceptance.md)。
> **当前为 v0.2.0 开发预览。** 本地编辑、版本管理与备份已有实现;六条内容路径的 **12 项真实草稿/发布前流程验收尚未通过**,五站指标与评论仍待实测。最终发布始终由你在原站手动完成。详见 [验收记录](docs/acceptance.md)。

## 为什么做 zMatrix

Expand All @@ -53,39 +53,45 @@ Markdown 源码、正文预览和各平台版本并排组织。平台版本可

![zMatrix 图文制作:模板设置与分页图片预览](docs/assets/card-studio.png)

<sub>截图来自当前源码的本地网页预览,使用内置示例稿;不连接平台,不包含私人稿件或真实账号数据。截图可能领先于已发布的 v0.1.2 安装包。</sub>
<sub>截图来自本地网页预览,使用内置示例稿;不连接平台,不包含私人稿件或真实账号数据。</sub>

## 工作台能做什么

| 工作 | 当前实现 |
| --- | --- |
| **写作与导入** | 内置 Markdown 编辑器、文件及配套图片目录导入、正文和图片粘贴 |
| **母稿与平台版本** | 标题、正文、配图继承与独立覆盖;母稿变化提醒、版本差异和发布快照 |
| **技术内容排版** | 代码、表格、LaTeX、Mermaid 预览;按平台能力转换部分内容为图片 |
| **制作图文** | 三种模板、封面、配色与分页,输出 1080 × 1440 PNG |
| **发布准备** | 内容预览、冻结版本、持久化串行队列;最终按钮由用户手动点击 |
| **登记与汇总** | 文章链接登记、指标缓存、评论分页与工具内已读状态;真实平台读取待验收 |
| **本地保存与备份** | IndexedDB 自动保存、ZIP 导出与恢复、授权目录自动备份 |
| 工作 | 当前实现 |
| ------------------ | -------------------------------------------------------------------------------------------- |
| **写作与导入** | Markdown 格式工具栏、专注/双栏/阅读视图,文件及配套图片目录原子导入、正文和图片粘贴 |
| **内容管理** | 标题/正文/平台标签组合搜索、平台与发布记录筛选、排序、列表视图、分页、复制、批量归档与撤销 |
| **母稿与平台版本** | 标题、正文、配图继承与独立覆盖;母稿变化提醒、版本差异和发布快照 |
| **技术内容排版** | 代码、表格、LaTeX、Mermaid 预览;按平台能力转换部分内容为图片 |
| **制作图文** | 三种模板、封面、配色与分页,输出 1080 × 1440 PNG |
| **发布准备** | 内容预览、冻结版本、持久化串行队列;最终按钮由用户手动点击 |
| **登记与汇总** | 文章链接登记、指标缓存、评论分页与工具内已读状态;真实平台读取待验收 |
| **本地保存与备份** | 合并连续输入的自动保存、多窗口冲突保护与另存副本、ZIP 备份恢复、授权目录自动备份 |
| **携带稿件** | 单个版本或多篇稿件导出 ZIP,包含 Markdown、平台信息与使用相对路径的配套图片 |
| **阅读与设置** | 更大默认字号,界面/正文字号独立调节,默认视图与启动刷新偏好自动保存 |
| **版本检测** | 每 6 小时检查新版本、手动检查与预览版筛选;用户选择下载后手动替换并重载解压扩展 |

以上功能随 v0.2.0 开发预览版提供。[内容管理、快捷键与导出说明 →](docs/workbench.md)

## 平台进度

“已有适配代码”不等于“真实流程已通过”。本地版本编辑可用,远端能力以下表和验收记录为准。

| 平台 / 内容路径 | 草稿保存与重开 | 完整准备至最终发布前 | 真实指标与评论 |
| --- | --- | --- | --- |
| 知乎 · 长文 | 待验收 | 待验收 | 待验收 |
| 掘金 · 长文 | 待验收 | 待验收 | 待验收 |
| 博客园 · 长文 | 待验收 | 待验收 | 待验收 |
| CSDN · 长文 | 待验收 | 待验收 | 待验收 |
| 小红书 · 长文章 | 待验收 | 待验收 | 待验收 |
| 小红书 · 图文笔记 | 待验收 | 待验收 | 待验收 |
| LINUX DO | 人工发布辅助 | 人工发布辅助 | 尽量接入,尚未实测 |
| 平台 / 内容路径 | 草稿保存与重开 | 完整准备至最终发布前 | 真实指标与评论 |
| ----------------- | -------------- | -------------------- | ------------------ |
| 知乎 · 长文 | 待验收 | 待验收 | 待验收 |
| 掘金 · 长文 | 待验收 | 待验收 | 待验收 |
| 博客园 · 长文 | 待验收 | 待验收 | 待验收 |
| CSDN · 长文 | 待验收 | 待验收 | 待验收 |
| 小红书 · 长文章 | 待验收 | 待验收 | 待验收 |
| 小红书 · 图文笔记 | 待验收 | 待验收 | 待验收 |
| LINUX DO | 人工发布辅助 | 人工发布辅助 | 尽量接入,尚未实测 |

人工补齐缺失设置不计作自动流程通过;结果不确定时先核实,不自动重发。[查看逐项证据 →](docs/acceptance.md)

## 快速开始

1. 从 [Releases](https://github.com/zJay26/zMatrix/releases) 下载预览版扩展 ZIP,例如 `zMatrix-edge-0.1.2.zip`,解压到固定目录。
1. 从 [Releases](https://github.com/zJay26/zMatrix/releases) 下载预览版扩展 ZIP,例如 `zMatrix-edge-0.2.0.zip`,解压到固定目录。
2. 在 Edge 打开 `edge://extensions`,启用**开发人员模式**,选择**加载解压缩的扩展**。所选目录应直接包含 `manifest.json`。
3. 点击工具栏中的 **zMatrix**,打开工作台;先用示例体验写作与图文制作,再按需连接平台和设置备份。

Expand Down Expand Up @@ -125,15 +131,15 @@ npm run package # 检查、构建、ZIP 与 SHA256

**WXT · React · TypeScript · Dexie · CodeMirror 6 · unified · KaTeX · Mermaid · html-to-image**

| 目录 | 内容 |
| --- | --- |
| `src/core` | 数据模型、版本关系、内容转换、备份、任务与聚合 |
| `src/platforms` | 能力声明、URL 校验、平台适配与结果核实 |
| `src/entrypoints` | Manifest V3 后台与工作台入口 |
| `src/ui` | 编辑、图文、发布队列、数据、评论和设置 |
| `tests` | 转换、版本、任务、备份、评论与平台保护测试 |
| `public/icon` | 正式图标的 SVG 和各尺寸 PNG |
| `docs` | 安装、验收、路线图与品牌规范 |
| 目录 | 内容 |
| ----------------- | ---------------------------------------------- |
| `src/core` | 数据模型、版本关系、内容转换、备份、任务与聚合 |
| `src/platforms` | 能力声明、URL 校验、平台适配与结果核实 |
| `src/entrypoints` | Manifest V3 后台与工作台入口 |
| `src/ui` | 编辑、图文、发布队列、数据、评论和设置 |
| `tests` | 转换、版本、任务、备份、评论与平台保护测试 |
| `public/icon` | 正式图标的 SVG 和各尺寸 PNG |
| `docs` | 安装、验收、路线图与品牌规范 |

`npm run preview:built` 在 `http://127.0.0.1:4173` 预览正式构建,并施加扩展脚本 CSP。网页预览与单元测试均不能替代实际扩展验收。修改图标源文件后运行 `npm run icons`。

Expand Down
4 changes: 4 additions & 0 deletions docs/ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,10 @@
- [x] 文章链接登记、指标和评论缓存结构。
- [x] 本地自动保存、文件夹备份、ZIP 导出与校验恢复。
- [x] 稳定扩展身份、开发者模式安装、CI 和预览版打包。
- [x] 内容库组合筛选、排序、分页、列表视图与批量归档撤销。
- [x] 多窗口保存冲突保护、合并连续输入、失败后另存完整稿件副本。
- [x] 带相对图片路径的 Markdown 内容导出、当前版本导出和独立版本复制。
- [x] 专注/双栏/阅读视图、格式工具栏和发布队列筛选。

## v1 验收重点

Expand Down
2 changes: 2 additions & 0 deletions docs/acceptance.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# 验收记录

本地功能的新增验证见 [2026-09-26 改进验证记录](verification-2026-09-26.md)(63 项自动测试、并发编辑、导入导出、分页与本地队列)。下方真实平台验收状态不因此改变。

记录日期:2026-09-22。本记录公开技术观察和验收结论,不包含测试账号名称、登录数据或实际备份。原始本机验收资料仅保存在被 Git 忽略的 validation 目录中。原型、模拟测试和按钮识别不等同于真实平台成功。

## 最新验收边界
Expand Down
Loading