Merge branch 'dev'

Merge dev into main for Linux menu and Mermaid fixes

Author: manyougz

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,126 @@
+name: Bug Report
+description: Report a bug in velotype
+title: "[Bug]: "
+labels: ["bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug.
+
+        Before submitting, please search existing issues, test the latest release,
+        and include the smallest reproduction you can provide.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched the existing issues
+          required: true
+        - label: I have tested this on the latest release
+          required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: velotype version
+      description: Exact version number or commit hash.
+      placeholder: e.g. 0.3.2
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Platform
+      description: Where did the issue happen?
+      options:
+        - Windows
+        - macOS
+        - Linux(Ubuntu / Debian / Fedora / Arch / Kali, Wayland or X11)
+        - Other(not currently supported)
+    validations:
+      required: true
+
+  - type: input
+    id: environment
+    attributes:
+      label: Environment details
+      description: Include OS version, Linux distro, desktop/session, scaling, display setup, IME, or other relevant context.
+      placeholder: e.g. Ubuntu 24.04, GNOME, Wayland, X11, etc
+    validations:
+      required: true
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Affected area
+      description: Which part of velotype is affected?
+      options:
+        - Rendering / layout
+        - Editing / IME / shortcuts
+        - Markdown parsing
+        - Menu / window / file operations
+        - Export
+        - Theme / i18n
+        - Crash / freeze / performance
+        - Other
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: What happened?
+      description: Describe the actual behavior.
+      placeholder: Tell us what you saw.
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: What did you expect to happen?
+      description: Describe the expected behavior.
+      placeholder: Tell us what should have happened.
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      description: Please provide the shortest possible steps.
+      placeholder: |
+        1. Open velotype
+        2. Load a markdown file
+        3. Click ...
+        4. Observe ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: sample
+    attributes:
+      label: Minimal sample / reproduction file
+      description: Paste a minimal markdown snippet, or link to a repo / gist / file if needed.
+      placeholder: |
+        ```md
+        # Minimal example
+        ...
+        ```
+    validations:
+      required: false
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Evidence / additional context
+      description: Add logs, panic messages, screenshots, recordings, theme/font details, or anything else that may help.
+      placeholder: |
+        - Logs:
+        - Screenshot:
+        - Video:
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,60 @@
+name: Feature Request
+description: Suggest a new feature or improvement for velotype
+title: "[Feature]: "
+labels:
+  - enhancement
+  - needs-triage
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a feature for velotype.
+
+        Before submitting, please search existing issues, keep the request focused,
+        and describe the real workflow or use case behind it.
+
+        If an existing feature is behaving incorrectly, please use the Bug Report template instead.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Checklist
+      options:
+        - label: I have searched the existing issues
+          required: true
+        - label: This request is focused on a single feature or improvement
+          required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem / use case
+      description: Describe the limitation, missing workflow, or goal this request addresses.
+      placeholder: |
+        Example:
+        Editing large markdown documents currently becomes difficult because...
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: Describe how you would like Velotype to behave.
+      placeholder: |
+        Example:
+        Add a floating outline panel that...
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional_context
+    attributes:
+      label: Additional context
+      description: Add references, mockups, related tools, links, or sample Markdown if useful.
+      placeholder: |
+        Example:
+        Related tools, mockups, workflow notes, or Markdown examples...
+    validations:
+      required: false

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "velotype"
-version = "0.3.4"
+version = "0.3.9"
 edition = "2024"
 license = "Apache-2.0"
 

Cargo.toml

@@ -4,7 +4,7 @@
 
 ![Velotype banner](./assets/icon/velotype-banner.png)
 
-**A Rust + GPUI native Markdown editor with WYSIWYG and source editing modes.** 
+**A Rust + GPUI native Markdown editor with WYSIWYG and source editing modes.**
 
 [Editor Showcase](./assets/showcase/showcase.md)
 
@@ -43,6 +43,8 @@ Velotype targets Windows, Linux, and macOS. The app is naturally suitable for di
 
 Download the Windows, Linux, or macOS build from the [Velotype Releases](https://github.com/manyougz/velotype/releases) page. Release artifacts are designed as portable desktop programs and can be run directly.
 
+> Note: macOS users need to sign the `app` file locally on their machine; otherwise, Velotype will not run properly.
+
 ### 2. Build from source
 
 Prerequisites:
@@ -72,6 +74,8 @@ Syntax support will continue to improve. Planned work includes:
 
 - [x] ~~Mind-map drawing and rendering support~~
 - [x] ~~LaTeX math syntax and rendering support~~
+- [ ] Optimize the parsing and rendering capabilities for extremely large Markdown documents
+- [ ] Workspace Mode and Outline Parsing
 - [ ] Built-in image hosting
 - [ ] More complete IME behavior
 
@@ -88,7 +92,7 @@ Start with the example files:
 
 In the app, use `Theme -> Add Theme Config` or `Language -> Add Language Config` to import a `.json` or `.jsonc` file. JSONC comments are accepted for writing and sharing examples; normalized configuration files saved by the app are strict JSON.
 
-> Thank you for helping translate Velotype or enrich the Velotype theme ecosystem.
+> Thank you for helping translate Velotype or enrich the Velotype theme ecosystem. The project is evolving rapidly, so theme field changes may occur frequently.
 
 ## Architecture
 

README.md

@@ -43,6 +43,8 @@ Velotype 目标支持 Windows、Linux 和 macOS。应用天然适合作为独立
 
 从 [Velotype Releases](https://github.com/manyougz/velotype/releases) 页面下载 Windows、Linux 或 macOS 构建。Release 产物按便携桌面程序设计，可直接运行。
 
+> 注意，macOS 系统用户需要在本地自行对 `app` 文件进行签名，否则 Velotype 无法正常运行。
+
 ### 2. 从源码构建
 
 前置需求：
@@ -72,6 +74,8 @@ Velotype 目前已经支持几乎所有基础 Markdown 语法，以及绝大多
 
 - [x] ~~脑图绘图与渲染支持~~
 - [x] ~~LaTeX 数学语法与渲染支持~~
+- [ ] 优化对超大 Markdown 文档的解析与渲染能力
+- [ ] 工作区模式与大纲解析
 - [ ] 内置图床
 - [ ] 更完善的 IME 功能
 
@@ -88,7 +92,7 @@ Velotype 将视觉主题和界面语言包拆分管理。主题文件可以覆
 
 在应用内使用 `主题 -> 添加主题配置` 或 `语言 -> 添加语言配置` 导入 `.json` / `.jsonc` 文件。JSONC 注释用于方便编写和分享示例；应用规范化保存后的配置文件会是严格 JSON。
 
-> 十分感谢您帮助翻译 Velotype 或丰富 Velotype 主题生态！
+> 十分感谢您帮助翻译 Velotype 或丰富 Velotype 主题生态！项目处于快速更迭阶段，主题字段的变更可能较为频繁。
 
 ## 架构