Skip to content

CLI 工作流

March 的默认使用方式是在当前仓库里直接启动。

text
你 → 在项目目录运行 march
   → March 读取当前项目事实
   → March 通过明确工具修改文件或运行命令
   → March 汇报结果

启动会话

bash
cd path/to/project
march

也可以直接带上一条请求:

bash
march "解释这个包是怎么启动的"

如果想覆盖配置里的默认模型,可以传入 --provider--model

bash
march --provider openai --model gpt-5.1

March 看见什么

March 不会假设整个仓库已经在 prompt 里。它先带着稳定上下文启动,然后按任务需要读取文件和命令输出。

所以请求可以很直接:

text
找到 provider 配置在哪里加载,并解释这条链路。

March 会先定位相关文件,打开需要的部分,然后再回答或修改。

常见工作循环

  1. 让 March 检查或修改某件事。
  2. 让它读取相关文件。
  3. 查看它完成的修改或说明。
  4. 对有意义的改动跑一个聚焦检查;日常开发优先跑 fast 测试。

项目里的固定规则可以放在 AGENTS.md。March 会把它作为项目上下文读取,这样不用每轮都重复粘贴。

在 TUI 里复制代码

Assistant 回复里的 fenced code block 会带边框和自动换行,方便阅读。你在代码块内部选择文本时,March 会复制对应的源码范围,而不是复制终端里装饰后的格子文本:

  • 不复制边框、padding 和 ANSI 样式;
  • 被视觉换行的长行会合并回原始源码行;
  • 只选一行里的部分字符时,会保留对应的源码列范围。

这样复制生成命令、函数或配置片段时,不需要再手动清理边框和换行。

恢复或检查会话

--resume <id> 从已有 pi session id 继续:

bash
march --resume <id>

调试上下文组装时,--dump-context 会把 prompt 写到 .march/context-dumps/

bash
march --dump-context

开源、源码优先、终端原生、基于 Markdown。