March

三月诞生，向前进军，码农的伙伴。

March（MA）是一个以上下文管理为核心竞争力的 agentic coding 工具，用 Rust 实现核心、Tauri + Vue 3 做桌面壳。

核心理念：Conversations that never decay

其他 coding agent 常见的问题，不是记不住，而是越聊越脏——读文件、改文件、跑命令的历史记录一路累积，久了 AI 面前会同时摆着很多过期、彼此打架的旧快照。

March 不靠累积旧上下文来维持能力，而是每一轮都回到当前项目状态，让 AI 始终面对一份干净的工作台。这通过两个设计实现：

1. 文件系统映射：file watcher 持续把"磁盘上现在是什么样"映射成 AI 看到的上下文，不记录"历史上改过什么"
2. 上下文每轮重建：大小由当前状态决定，不随对话轮次增长

一个主题就是一个对话框。用户改需求、转方向、反复来回都在同一个窗口里进行，March 自己管理 AI 侧的信息密度，用户不需要感知上下文。

完整设计见 codestable/architecture/DESIGN.md。

技术栈

• 核心：Rust（workspace = crates/march-core + src-tauri）
• 壳层：Tauri 2
• 前端：Vue 3 + TypeScript + Vite 6 + Tailwind 4 + reka-ui
• 渲染：markstream-vue（流式 Markdown）

开发

前置：Node.js、Rust toolchain、Tauri 所需的系统依赖（见 Tauri 官方文档）。

npm install

# 纯前端开发（浏览器，不走 Tauri）
npm run dev

# 桌面端开发（Tauri + Vite）
npm run tauri:dev

# 复用已启动的 vite dev server
npm run tauri:dev:reuse-web

常用命令

npm run typecheck        # TypeScript 类型检查
npm run check            # typecheck + 自定义检查（shadow-js 等）
npm run test:unit        # Vitest 单元测试
npm run build            # 前端构建（先跑 check）
npm run tauri:build      # 打包桌面应用

目录结构

crates/march-core/       Rust 核心：context builder / watcher / agent loop
src-tauri/               Tauri 壳层 + IPC
src/                     Vue 前端（App / components / composables / styles）
codestable/architecture/    项目级架构权威文档（DESIGN.md 为入口）
codestable/features/        单个 feature 的 prd / design / acceptance
scripts/                 构建与检查脚本

项目规则

• 架构权威文档是 codestable/architecture/DESIGN.md，所有模块设计必须能从中追溯
• 详细的编码约定、UI 约定、数据流规范见 AGENTS.md
• 样式走 primitive → semantic → component 三层 token，细则见 design-system.md

License

见 LICENSE。