From 72777a8c74b0821dad76f60143860c25f5bcb487 Mon Sep 17 00:00:00 2001 From: cflmy Date: Wed, 5 Aug 2026 17:17:00 +0800 Subject: [PATCH] Release v0.1.1: debug page Logo branding and packaging notes. Bump crate version, use official Logo for marqdo debug favicon/brand, and document VS Code extension assets in the Windows release script. Co-authored-by: Cursor --- Cargo.toml | 2 +- README.md | 5 +++-- scripts/release-windows.ps1 | 18 ++++++++++++++---- src/view/debug_page.rs | 7 ++++++- 4 files changed, 24 insertions(+), 8 deletions(-) diff --git a/Cargo.toml b/Cargo.toml index 79a904a..7b6a49c 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "marqdo" -version = "0.1.0" +version = "0.1.1" edition = "2021" license = "Apache-2.0" description = "Marqdo — Markdown markers as an interpreted programming language" diff --git a/README.md b/README.md index d2fd006..1784a68 100644 --- a/README.md +++ b/README.md @@ -95,14 +95,15 @@ marqdo catalog public -o .marqdo --- -## 现状(v0.1.0) +## 现状(v0.1.1) - 映射与解释器:Phase I 树遍历 + 字节码后端可用;金样例在 `tests/` - **`marqdo view`**:文档浏览器(Structure + 函数大纲/搜索 + Execution + Source) -- **`marqdo debug`**:独立调试页(断点 / 单步 / locals;默认端口 7430) +- **`marqdo debug`**:独立调试页(断点 / 单步 / locals;默认端口 7430;页面 favicon / 品牌使用官方 Logo) - **`marqdo catalog` / `sync`**:OKF 风格 YAML + 模块概念页 - 标准库:文本、文件、系统、时间、JSON、网络、数学(公式/绘图)、外联(Python 等) - **用户静态站**:`public/` → `view output` → CI 发布 [gh-pages](https://cflmy.github.io/marqdo/) +- **VS Code 扩展**:分支 `vscode-extension`;Release 附带 `.vsix`(Run / View / Debug + CLI 安装助手) - 选型:[ADR 0001 — Rust](doc/adr/0001-implementation-language.md) ```bash diff --git a/scripts/release-windows.ps1 b/scripts/release-windows.ps1 index d6b86db..000758c 100644 --- a/scripts/release-windows.ps1 +++ b/scripts/release-windows.ps1 @@ -2,7 +2,7 @@ # to an existing GitHub Release tag. # Usage (from repo root): # powershell -File ./scripts/release-windows.ps1 -# powershell -File ./scripts/release-windows.ps1 -Tag v0.1.0 +# powershell -File ./scripts/release-windows.ps1 -Tag v0.1.1 param( [string]$Tag = "" ) @@ -79,26 +79,36 @@ $notes = @" | ``$exeName`` | **Executable only** — does **not** include the standard library | | ``$zipName`` | **Recommended**: ``marqdo.exe`` + ``lib/`` (place them together; ``lib/`` is resolved next to the binary) | | ``$stdlibName`` | Standard library only (``lib/*.mq.md``) — unpack next to an existing ``marqdo.exe``, or set ``MARQDO_LIB`` | +| ``marqdo-0.0.5.vsix`` | **VS Code / Cursor extension** — syntax highlight, Run / View / Debug toolbar, CLI+stdlib install helper. Install via ``Extensions: Install from VSIX…``. Source: branch ``vscode-extension``. | > **Important:** the standalone ``.exe`` does **not** ship ``lib/``. Importing ``lib/text.mq.md`` etc. needs the bundle zip or the stdlib zip beside the binary (or ``MARQDO_LIB``). ### Highlights - Code as docs as knowledge: ``.mq.md`` is narrative + program -- ``marqdo debug``: breakpoints / step / locals; ``marqdo view`` stays docs-only -- View: function outline + search; wider layout +- ``marqdo debug``: breakpoints / step / locals; page favicon and brand use the official Logo +- ``marqdo view``: docs-only Structure + outline/search + Execution +- VS Code extension v0.0.5: three editor actions (Run / View / Debug), logo cover icon, startup CLI version & stdlib detection with optional install +- ``marqdo catalog`` / ``sync``: OKF-style YAML + module pages - Roadmap: deeper OKF-aligned catalog for human–AI knowledge bases +### Quick start + ``````text marqdo --version marqdo run public/00-welcome.mq.md marqdo view public marqdo debug public +marqdo catalog public -o .marqdo `````` + +### Requirements +- Windows x64 for the prebuilt ``.exe`` / zip assets above +- Extension needs Marqdo CLI ≥ 0.1.0 (this release is 0.1.1); auto-install downloads the GitHub bundle when missing "@ $body = @{ tag_name = $Tag - name = $Tag + name = "Marqdo $Tag" body = $notes draft = $false prerelease = $false diff --git a/src/view/debug_page.rs b/src/view/debug_page.rs index 6893397..5e967c9 100644 --- a/src/view/debug_page.rs +++ b/src/view/debug_page.rs @@ -76,6 +76,7 @@ window.MARQDO_FILE_PATH = {path_js};
+ marqdo debug
@@ -167,6 +168,9 @@ fn layout_debug(title: &str, main: &str) -> String { debug · {title} · marqdo + + + @@ -225,7 +229,8 @@ html, body { margin: 0; height: 100%; } border-bottom: 1px solid #000; flex-shrink: 0; } -.dbg-brand { display: flex; align-items: baseline; gap: 0.35rem; } +.dbg-brand { display: flex; align-items: center; gap: 0.4rem; } +.dbg-logo { display: block; border-radius: 3px; flex-shrink: 0; } .dbg-mark { font-weight: 700; letter-spacing: -0.02em; color: #fff; font-size: 0.9rem; } .dbg-mode { font-size: 0.65rem;