Skip to content
Draft
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: 11 additions & 11 deletions .env
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
# ReadMD 全局统一版本配置 (Single Source of Truth for Global Versioning)
# 修改此文件中的 READMD_VERSION 或运行 cargo xtask sync-version <version> 即可一键同步全库所有文件

READMD_VERSION=0.0.4
READMD_VERSION_TAG=v0.0.4
READMD_VERSION_SEMVER=0.0.4
READMD_VERSION_TRIPLET=0.0.4
READMD_VERSION=0.0.5
READMD_VERSION_TAG=v0.0.5
READMD_VERSION_SEMVER=0.0.5
READMD_VERSION_TRIPLET=0.0.5
READMD_VERSION_MAJOR=0
READMD_VERSION_MINOR=0
READMD_VERSION_PATCH=4
READMD_VERSION_PATCH=5
READMD_VERSION_PRERELEASE=
READMD_VERSION_LINGLONG=0.0.4.0
READMD_VERSION_HARMONY_CODE=4
READMD_VERSION_HARMONY_NAME=0.0.4
READMD_VERSION_WINDOWS_FILEVER=0.0.4.0
READMD_VERSION_VSCODE=0.0.4
READMD_VERSION_LINGLONG=0.0.5.0
READMD_VERSION_HARMONY_CODE=5
READMD_VERSION_HARMONY_NAME=0.0.5
READMD_VERSION_WINDOWS_FILEVER=0.0.5.0
READMD_VERSION_VSCODE=0.0.5
READMD_VERSION_RPM_REL=1
READMD_VERSION_ARCH_REL=1
READMD_VERSION_BUILD_DATE=2026-10-04
READMD_VERSION_BUILD_DATE=2026-10-07
22 changes: 11 additions & 11 deletions .env.example
Original file line number Diff line number Diff line change
@@ -1,19 +1,19 @@
# ReadMD 全局统一版本配置 (Single Source of Truth for Global Versioning)
# 修改此文件中的 READMD_VERSION 或运行 cargo xtask sync-version <version> 即可一键同步全库所有文件

READMD_VERSION=0.0.4
READMD_VERSION_TAG=v0.0.4
READMD_VERSION_SEMVER=0.0.4
READMD_VERSION_TRIPLET=0.0.4
READMD_VERSION=0.0.5
READMD_VERSION_TAG=v0.0.5
READMD_VERSION_SEMVER=0.0.5
READMD_VERSION_TRIPLET=0.0.5
READMD_VERSION_MAJOR=0
READMD_VERSION_MINOR=0
READMD_VERSION_PATCH=4
READMD_VERSION_PATCH=5
READMD_VERSION_PRERELEASE=
READMD_VERSION_LINGLONG=0.0.4.0
READMD_VERSION_HARMONY_CODE=4
READMD_VERSION_HARMONY_NAME=0.0.4
READMD_VERSION_WINDOWS_FILEVER=0.0.4.0
READMD_VERSION_VSCODE=0.0.4
READMD_VERSION_LINGLONG=0.0.5.0
READMD_VERSION_HARMONY_CODE=5
READMD_VERSION_HARMONY_NAME=0.0.5
READMD_VERSION_WINDOWS_FILEVER=0.0.5.0
READMD_VERSION_VSCODE=0.0.5
READMD_VERSION_RPM_REL=1
READMD_VERSION_ARCH_REL=1
READMD_VERSION_BUILD_DATE=2026-10-04
READMD_VERSION_BUILD_DATE=2026-10-07
10 changes: 9 additions & 1 deletion .github/workflows/repo-quality.yml
Original file line number Diff line number Diff line change
Expand Up @@ -90,6 +90,7 @@ jobs:
cargo fetch --locked --manifest-path rust/Cargo.toml
npm ci --ignore-scripts --prefix packages/vscode-extension
npm ci --ignore-scripts --prefix ui-tests
npm ci --ignore-scripts --prefix website
cd ui-tests
npx --no-install playwright install --with-deps chromium webkit
- name: Compile and test integrations offline
Expand All @@ -109,6 +110,13 @@ jobs:
run: npx --no-install playwright test --config vscode-preview.config.cjs
- name: Package integrations without downloads
run: node tools/package-integrations.mjs dist/integrations
- name: Build website offline and verify scroll video in Chrome
env:
NODE_PATH: ${{ github.workspace }}/ui-tests/node_modules
READMD_MOTION_CHANNEL: chrome
run: |
npm run verify:release --prefix website
node website/tools/motion-smoke.cjs
- name: Upload integration packages
uses: actions/upload-artifact@v4
with:
Expand Down Expand Up @@ -145,4 +153,4 @@ jobs:
READMD_BIN: ${{ github.workspace }}/rust/target/debug/readmd
READMD_PANEL_TEST_LOCALES: zh-CN,en,zh-TW,de,ar
READMD_PANEL_TEST_THEMES: light,dark,sepia
run: npx playwright test ui-quality.spec.js interaction-regressions.spec.js ai-model-discovery.spec.js all-panels-layout.spec.js editor-layout-production.spec.js language-production.spec.js panel-ux-production.spec.js community-upgrade.spec.js --project=desktop --project=mobile
run: npx playwright test ui-quality.spec.js interaction-regressions.spec.js ai-model-discovery.spec.js all-panels-layout.spec.js editor-layout-production.spec.js language-production.spec.js panel-ux-production.spec.js community-upgrade.spec.js document-intelligence.spec.js --project=desktop --project=mobile
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -131,3 +131,6 @@ packages/readmd-pet-rust/target/

ReadMD.exe
/test-results-pagination/

# Local incremental videos and production scripts never enter software releases.
/showcase/updates/
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ ReadMD 解决的是长期资料库里的实际问题:大文件能继续读,
## 多系统与信创国产适配

### 1. Linux 与国产操作系统适配(统信 UOS / 银河麒麟 / 深度)
- **直接安装使用**:下载 [`ReadMD-linux-x86_64.deb`](https://github.com/Natsummerance/rust-ReadMD/releases/download/V0.0.4/ReadMD-linux-x86_64.deb) 双击安装,或直接运行 [`ReadMD-linux-x86_64.tar.gz`](https://github.com/Natsummerance/rust-ReadMD/releases/download/V0.0.4/ReadMD-linux-x86_64.tar.gz)。银河麒麟 V10 + 飞腾 ARM64 设备使用 [`readmd_0.0.4_arm64.deb`](https://github.com/Natsummerance/rust-ReadMD/tree/main/scripts/linux)。
- **直接安装使用**:下载 [`ReadMD-linux-x86_64.deb`](https://github.com/Natsummerance/rust-ReadMD/releases/download/V0.0.4/ReadMD-linux-x86_64.deb) 双击安装,或直接运行 [`ReadMD-linux-x86_64.tar.gz`](https://github.com/Natsummerance/rust-ReadMD/releases/download/V0.0.4/ReadMD-linux-x86_64.tar.gz)。银河麒麟 V10 + 飞腾 ARM64 设备使用 [`readmd_0.0.5_arm64.deb`](https://github.com/Natsummerance/rust-ReadMD/tree/main/scripts/linux)。
- **飞腾安全回退**:自动识别 Phytium D2000/E2000/FT 系列;WebKitGTK 启动时优先选择 UKUI/X11、禁用 DMABUF 合成并回退 llvmpipe,避免旧 GPU 驱动白屏或崩溃。
- **系统与环境识别**:100% 纯原生 Rust 内核(`native_system`)自动识别系统发行版,自适应配置 Wayland / X11 显示后端。
- **桌面与深色模式**:自动侦测 DDE(统信/Deepin)、UKUI(银河麒麟)与 GNOME/KDE 的外观主题,实时同步深色/浅色配色。
Expand Down Expand Up @@ -123,15 +123,15 @@ ReadMD 解决的是长期资料库里的实际问题:大文件能继续读,
## VSCode 扩展与 MCP Server 生态

### 1. VSCode 插件安装与使用
- **界面安装**:下载 [`readmd-vscode-0.0.4.vsix`](https://github.com/Natsummerance/rust-ReadMD/tree/main/packages/vscode-extension) -> 在 VSCode 扩展面板选择 `... -> 从 VSIX 安装...`。
- **界面安装**:下载 [`readmd-vscode-0.0.5.vsix`](https://github.com/Natsummerance/rust-ReadMD/tree/main/packages/vscode-extension) -> 在 VSCode 扩展面板选择 `... -> 从 VSIX 安装...`。
- **命令行安装**:
```bash
code --install-extension readmd-vscode-0.0.4.vsix
code --install-extension readmd-vscode-0.0.5.vsix
```
- **核心功能**:打开 Markdown 文件点击右上角书本图标开启同步预览;右键菜单支持一键自动修复语法错误与转换为 LaTeX 源码。

### 2. MCP (Model Context Protocol) Server 配置
直接下载解压 [`readmd-mcp-server-0.0.4.zip`](https://github.com/Natsummerance/rust-ReadMD/tree/main/rust/readmd-kernel/src/mcp_server.rs),在 Claude Desktop、Cursor、Antigravity 与 Cline 中配置(请将 `args` 中的路径替换为本机解压的**绝对路径**):
直接下载解压 [`readmd-mcp-server-0.0.5.zip`](https://github.com/Natsummerance/rust-ReadMD/tree/main/rust/readmd-kernel/src/mcp_server.rs),在 Claude Desktop、Cursor、Antigravity 与 Cline 中配置(请将 `args` 中的路径替换为本机解压的**绝对路径**):

**Windows**:
```json
Expand Down
18 changes: 18 additions & 0 deletions RELEASE_NOTES.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,21 @@
# ReadMD V0.0.5 · 发布候选

本轮补强本地 Markdown 工作流,复用现有入口,重点提升文档检查、工作区检索、VS Code 与 MCP 文件操作。正式发布前需完成平台打包与验收;当前公开下载仍为 V0.0.4。

- **文档检查**:当前草稿的标题、双链、本地链接与锚点由共用 Rust AST 检查,跳过代码示例;结果过期、处理上限和检查失败明确显示。桌面端放入原有修复报告。

- **VS Code**:原生“问题”面板诊断和可点击 Wiki 双链;命令面板搜索当前工作区,支持短语、路径、标题、YAML 标签及排除词。保持工具栏不增加新入口,缓存跟随文档版本与文件变化失效。

- **MCP**:22 → 27 项工具。新增文档检查、工作区搜索、带版本读取、默认预览的文字替换与恢复记录读取。提交需明确确认及匹配文件版本;保护编码、未改部分的换行,拒绝不可无损编码及超限结果。恢复集中保存,不污染原目录。

- **网站**:保留原有 Apple 风格,补齐四语言集成说明及搜索收录信息。修复旧仓库动态版本请求、大小写标签、过期版本说明、源码误标为安装包;区分公开正式版和待发布候选,避免无效下载。

- **验证与演示**:增量操作使用真实桌面应用、VS Code Extension Host 和 Rust MCP;合成哲学阅读材料,2K 原生录制,软件画面不含文件夹或录制编号。制作工程和视频仅保存在本机,不进入软件提交。

操作清单、测试证据与边界见 docs/reviews/readmd-v005-upgrade-2026-10-07.md。

---

# ReadMD V0.0.4

本次版本整合桌宠、编辑保存、功能面板、原生窗口与完整演示网站的升级。程序、安装包和更新检查统一使用 `0.0.4`,更新源切换到 `Natsummerance/rust-ReadMD`。
Expand Down
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.0.4
0.0.5
3 changes: 3 additions & 0 deletions assets/css/panels.css
Original file line number Diff line number Diff line change
Expand Up @@ -1353,3 +1353,6 @@ body:has(#edit-bar:not(.hidden)) .statusbar-left-group { flex:0 1 24%; }
#share-refresh { margin-inline-start: 0; }
#search-count { max-width: 30%; font-size: var(--text-xs); }
}
/* Current-draft inspection shares the existing repair report. */
#fix-list .document-inspection-summary { font-weight: 600; margin-top: 12px; }
#fix-list .document-inspection-issue { overflow-wrap: anywhere; }
11 changes: 11 additions & 0 deletions assets/i18n/ar.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
{
"inspection.changed": "The document changed. Reopen this report to inspect the latest content.",
"inspection.ambiguous_link": "Multiple files match this link",
"inspection.atLine": "Line {line}",
"inspection.failed": "Document inspection is unavailable. Check the local service and try again.",
"inspection.limited": "Some checks reached processing limits; unchecked content may still contain issues.",
"inspection.loading": "Checking links and headings in the current document…",
"inspection.missing_anchor": "Heading anchor not found",
"inspection.missing_file": "Local file not found",
"inspection.missing_footnote": "Footnote definition not found",
"inspection.outside_workspace": "Link is outside the inspected folder and was not read",
"inspection.summary": "Document inspection: {count} items to review",
"window.globalActions": "إجراءات عامة",
"window.assocChoose": "اختر ReadMD لملفات Markdown في تطبيقات Windows الافتراضية.",
"window.close": "إغلاق النافذة",
Expand Down
11 changes: 11 additions & 0 deletions assets/i18n/bn.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
{
"inspection.changed": "The document changed. Reopen this report to inspect the latest content.",
"inspection.ambiguous_link": "Multiple files match this link",
"inspection.atLine": "Line {line}",
"inspection.failed": "Document inspection is unavailable. Check the local service and try again.",
"inspection.limited": "Some checks reached processing limits; unchecked content may still contain issues.",
"inspection.loading": "Checking links and headings in the current document…",
"inspection.missing_anchor": "Heading anchor not found",
"inspection.missing_file": "Local file not found",
"inspection.missing_footnote": "Footnote definition not found",
"inspection.outside_workspace": "Link is outside the inspected folder and was not read",
"inspection.summary": "Document inspection: {count} items to review",
"window.globalActions": "সার্বিক কাজ",
"window.assocChoose": "উইন্ডোজ ডিফল্ট অ্যাপসে মার্কডাউন ফাইলের জন্য ReadMD বেছে নিন।",
"window.close": "উইন্ডো বন্ধ করুন",
Expand Down
11 changes: 11 additions & 0 deletions assets/i18n/bo.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
{
"inspection.changed": "The document changed. Reopen this report to inspect the latest content.",
"inspection.ambiguous_link": "Multiple files match this link",
"inspection.atLine": "Line {line}",
"inspection.failed": "Document inspection is unavailable. Check the local service and try again.",
"inspection.limited": "Some checks reached processing limits; unchecked content may still contain issues.",
"inspection.loading": "Checking links and headings in the current document…",
"inspection.missing_anchor": "Heading anchor not found",
"inspection.missing_file": "Local file not found",
"inspection.missing_footnote": "Footnote definition not found",
"inspection.outside_workspace": "Link is outside the inspected folder and was not read",
"inspection.summary": "Document inspection: {count} items to review",
"window.globalActions": "སྤྱི་ཁྱབ་བྱ་ཐབས།",
"window.assocChoose": "Windows ཀྱི་སྔོན་སྒྲིག་ཉེར་སྤྱོད་ནང་ Markdown ཡིག་ཆའི་ཆེད་དུ་ ReadMD འདེམས་རོགས།",
"window.close": "སྒེའུ་ཁུང་རྒྱག་པ།",
Expand Down
11 changes: 11 additions & 0 deletions assets/i18n/da.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
{
"inspection.changed": "The document changed. Reopen this report to inspect the latest content.",
"inspection.ambiguous_link": "Multiple files match this link",
"inspection.atLine": "Line {line}",
"inspection.failed": "Document inspection is unavailable. Check the local service and try again.",
"inspection.limited": "Some checks reached processing limits; unchecked content may still contain issues.",
"inspection.loading": "Checking links and headings in the current document…",
"inspection.missing_anchor": "Heading anchor not found",
"inspection.missing_file": "Local file not found",
"inspection.missing_footnote": "Footnote definition not found",
"inspection.outside_workspace": "Link is outside the inspected folder and was not read",
"inspection.summary": "Document inspection: {count} items to review",
"window.globalActions": "Globale handlinger",
"window.assocChoose": "Vælg ReadMD til Markdown-filer i Standardapps i Windows.",
"window.close": "Luk vindue",
Expand Down
11 changes: 11 additions & 0 deletions assets/i18n/de.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
{
"inspection.changed": "The document changed. Reopen this report to inspect the latest content.",
"inspection.ambiguous_link": "Multiple files match this link",
"inspection.atLine": "Line {line}",
"inspection.failed": "Document inspection is unavailable. Check the local service and try again.",
"inspection.limited": "Some checks reached processing limits; unchecked content may still contain issues.",
"inspection.loading": "Checking links and headings in the current document…",
"inspection.missing_anchor": "Heading anchor not found",
"inspection.missing_file": "Local file not found",
"inspection.missing_footnote": "Footnote definition not found",
"inspection.outside_workspace": "Link is outside the inspected folder and was not read",
"inspection.summary": "Document inspection: {count} items to review",
"window.globalActions": "Globale Aktionen",
"window.assocChoose": "Wählen Sie ReadMD für Markdown-Dateien in den Windows-Standard-Apps.",
"window.close": "Fenster schließen",
Expand Down
11 changes: 11 additions & 0 deletions assets/i18n/el.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
{
"inspection.changed": "The document changed. Reopen this report to inspect the latest content.",
"inspection.ambiguous_link": "Multiple files match this link",
"inspection.atLine": "Line {line}",
"inspection.failed": "Document inspection is unavailable. Check the local service and try again.",
"inspection.limited": "Some checks reached processing limits; unchecked content may still contain issues.",
"inspection.loading": "Checking links and headings in the current document…",
"inspection.missing_anchor": "Heading anchor not found",
"inspection.missing_file": "Local file not found",
"inspection.missing_footnote": "Footnote definition not found",
"inspection.outside_workspace": "Link is outside the inspected folder and was not read",
"inspection.summary": "Document inspection: {count} items to review",
"window.globalActions": "Καθολικές ενέργειες",
"window.assocChoose": "Επιλέξτε το ReadMD για αρχεία Markdown στις Προεπιλεγμένες εφαρμογές των Windows.",
"window.close": "Κλείσιμο παραθύρου",
Expand Down
11 changes: 11 additions & 0 deletions assets/i18n/en.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
{
"inspection.changed": "The document changed. Reopen this report to inspect the latest content.",
"inspection.ambiguous_link": "Multiple files match this link",
"inspection.atLine": "Line {line}",
"inspection.failed": "Document inspection is unavailable. Check the local service and try again.",
"inspection.limited": "Some checks reached processing limits; unchecked content may still contain issues.",
"inspection.loading": "Checking links and headings in the current document…",
"inspection.missing_anchor": "Heading anchor not found",
"inspection.missing_file": "Local file not found",
"inspection.missing_footnote": "Footnote definition not found",
"inspection.outside_workspace": "Link is outside the inspected folder and was not read",
"inspection.summary": "Document inspection: {count} items to review",
"window.globalActions": "Global actions",
"window.assocChoose": "Choose ReadMD for Markdown files in Windows Default apps.",
"window.close": "Close window",
Expand Down
11 changes: 11 additions & 0 deletions assets/i18n/eo.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
{
"inspection.changed": "The document changed. Reopen this report to inspect the latest content.",
"inspection.ambiguous_link": "Multiple files match this link",
"inspection.atLine": "Line {line}",
"inspection.failed": "Document inspection is unavailable. Check the local service and try again.",
"inspection.limited": "Some checks reached processing limits; unchecked content may still contain issues.",
"inspection.loading": "Checking links and headings in the current document…",
"inspection.missing_anchor": "Heading anchor not found",
"inspection.missing_file": "Local file not found",
"inspection.missing_footnote": "Footnote definition not found",
"inspection.outside_workspace": "Link is outside the inspected folder and was not read",
"inspection.summary": "Document inspection: {count} items to review",
"window.globalActions": "Tutmondaj agoj",
"window.assocChoose": "Elektu ReadMD por Markdown-dosieroj en la defaŭltaj aplikaĵoj de Vindozo.",
"window.close": "Fermi fenestron",
Expand Down
11 changes: 11 additions & 0 deletions assets/i18n/es.json
Original file line number Diff line number Diff line change
@@ -1,4 +1,15 @@
{
"inspection.changed": "The document changed. Reopen this report to inspect the latest content.",
"inspection.ambiguous_link": "Multiple files match this link",
"inspection.atLine": "Line {line}",
"inspection.failed": "Document inspection is unavailable. Check the local service and try again.",
"inspection.limited": "Some checks reached processing limits; unchecked content may still contain issues.",
"inspection.loading": "Checking links and headings in the current document…",
"inspection.missing_anchor": "Heading anchor not found",
"inspection.missing_file": "Local file not found",
"inspection.missing_footnote": "Footnote definition not found",
"inspection.outside_workspace": "Link is outside the inspected folder and was not read",
"inspection.summary": "Document inspection: {count} items to review",
"window.globalActions": "Acciones globales",
"window.assocChoose": "Elegir ReadMD para archivos Markdown en las aplicaciones predeterminadas de Windows.",
"window.close": "Cerrar ventana",
Expand Down
Loading
Loading