- Markdown 优先：正文以普通
.md文件保存，可被其他编辑器、Git 和脚本直接读取。 - 本地工作区：文档、资源、图稿和工作区元数据保存在用户选择的目录中，不依赖专有云端格式。
- 写作与组织一体化：提供目录树、多标签编辑、日程、Inbox、全文搜索、图谱和多格式导入导出。
- 原生桌面能力：通过 Tauri v2 集成文件系统、Git、终端、系统菜单和安全签名的应用更新。
- 可控的 AI 协作：内置 Codex 工作区入口，文件变更仍落在可审查、可回滚的本地仓库中。
前往 GitHub Releases 下载：
| 平台 | 安装包 |
|---|---|
| macOS Apple Silicon | Markune_aarch64.dmg |
| macOS Intel | Markune_x64.dmg |
| Windows x64 | Markune_x64-setup.exe |
当前 macOS 构建尚未完成 Apple 公证，Windows 安装包尚未使用 Authenticode 签名，首次安装可能出现系统安全提示。请只从本仓库 Releases 下载，并核对版本与文件名。
Markune 不改变 Markdown-first 的存储方式。应用级工作区数据统一保存在工作区根目录的 .markune/ 中，资源与图稿引用使用 markune-asset://、markune-drawing:// 等持久化协议。
从旧版 Madora 首次打开含 .madora/ 的工作区时，Markune 会先显示品牌迁移说明。只有用户确认后才会迁移；迁移会创建带 SHA-256 清单的备份，发生错误时自动回滚。若 .madora/ 与 .markune/ 同时存在，应用会阻止自动合并，避免覆盖无法判断归属的数据。
- Node.js 24
- pnpm 11.16.0
- Rust stable（最低版本以
src-tauri/Cargo.toml为准） - macOS：Xcode Command Line Tools
- Windows：Microsoft C++ Build Tools 与 WebView2 Runtime
git clone git@github.com:Refinex-Space/markune.git
cd markune
pnpm install
pnpm desktop:dev仅启动 Next.js 开发服务可运行 pnpm dev。桌面端开发会额外准备 Codex、Pandoc、Typst 与导入导出运行时。
| 命令 | 用途 |
|---|---|
pnpm dev |
启动 Web 开发服务 |
pnpm desktop:dev |
启动 Tauri 桌面开发模式 |
pnpm test:run |
运行前端测试 |
pnpm lint |
运行 ESLint |
pnpm build:desktop:web |
构建 Tauri 使用的静态前端 |
cargo test --manifest-path src-tauri/Cargo.toml |
运行 Rust 测试 |
pnpm harness:check |
检查仓库知识与治理文档 |
本地诊断安装包可使用 pnpm desktop:build --no-sign，但无签名产物不得作为正式 Release 或自动更新资产发布。完整打包、签名和回滚流程见 发布与更新手册。
| 层 | 主要技术 | 职责 |
|---|---|---|
| Web shell | Next.js App Router、React、TypeScript | 工作区界面与交互状态 |
| Editor | Markweave、CodeMirror | Markdown Live/Source 编辑 |
| Desktop | Tauri v2、Rust | 文件系统、Git、终端、更新与原生窗口 |
| Drawing | Excalidraw | 本地图稿与 Markdown 快照引用 |
| AI runtime | Codex App Server | 本地工作区内的可审查协作 |
更细的运行时和持久化边界见 架构说明，文档索引见 项目知识地图。
提交 Issue 或 Pull Request 前，请阅读 贡献指南、行为准则 与 安全策略。代码变更应保持 Markdown-first、本地优先和最小权限边界，并按变更层运行最小相关测试。
本项目基于 Apache License 2.0 发布。