pyproject.toml 的 [project.scripts] 定义了七个命令：
| 命令 | 实现 | 用途 |
|---|---|---|
dm-agent |
dm_agent.cli:main |
主 CLI：跑任务、交互模式 |
dm-agent-trace |
dm_agent.tracing.cli:main |
view / analyze / analyze-dir / replay / diff / fork |
dm-agent-bench |
dm_agent.benchmarks.cli:main |
coding / maintenance benchmark |
dm-agent-eval |
dm_agent.evals.cli:main |
确定性 eval（无需 API key） |
dm-agent-economics |
dm_agent.benchmarks.economics:main |
离线 token 成本核算 |
dm-agent-manifest-diff |
dm_agent.benchmarks.manifest_diff:main |
benchmark 任务集漂移检测 |
dm-agent-score-diff |
dm_agent.benchmarks.score_diff:main |
两份 benchmark 报告的分数差、逐题翻转与成本对照 |
dm-agent-web |
dm_agent.server.cli:main |
Web 控制台（需 [web] extra），见 Web 控制台 |
根目录 main.py 是 python main.py 的兼容转发，不会作为顶级 main 模块安装。
python -m dm_agent.cli 也可用（dm_agent/cli/__main__.py）。
CLI 参数 > ./config.json > ~/.dm_agent/config.json > 硬编码默认
两个 config.json 位置先到先得：项目级存在就用它，否则用用户级，都没有就用硬编码默认。
交互式设置向导保存时写回它读到的那一个；两者都不存在时落用户级
（~/.dm_agent/，与扩展目录、信任文件同一个家）。
API key 是例外：只从环境变量读（DEEPSEEK_API_KEY / OPENAI_API_KEY /
CLAUDE_API_KEY / GEMINI_API_KEY），不参与上面的链条。.env 按
./.env → ~/.dm_agent/.env 顺序加载，且已导出的环境变量始终优先——
所以 DEEPSEEK_API_KEY=sk-xxx dm-agent "..." 永远压过任何文件。
MCP 配置独立于当前工作目录的 mcp_config.json，见 MCP 配置。
| 参数 | 默认 | 说明 |
|---|---|---|
--provider |
deepseek |
已注册的供应商；扩展可注册新的 |
--model |
deepseek-chat |
模型标识 |
--base-url |
供应商默认 | 自建网关 / 代理 |
--max-steps |
100 |
ReAct 步数上限（ReactAgent 作为库使用时默认 200） |
--temperature |
0.7 |
采样温度（ReactAgent 库默认 0.0） |
--show-steps |
关 | 实时打印中间步骤 |
--interactive |
— | 进入交互式菜单（不给 task 时也会进） |
--conversation-stdin |
— | 长驻会话模式：多轮任务从 stdin 逐行进来，共享同一个 agent 的上下文 |
--report PATH |
— | 输出人类可读的 Markdown 运行报告 |
Web 控制台的多轮对话就跑在这个模式上，但它本身是个通用入口：一个进程、一个
ReactAgent、顺序跑多轮，对话历史 / 本地记忆 / 折叠状态跨轮延续。
printf '%s\n' \
'{"task": "读一遍 README，说说这个项目在做什么"}' \
'{"task": "接着上一轮，把它的分层契约也讲清楚"}' \
| dm-agent --conversation-stdin --trace sessions/chat.jsonl- stdin 每行一个 JSON 对象：
{"task": "..."}跑一轮，{"type": "reset"}清空历史。 用 JSON 而不是裸文本行，因为任务描述完全可能含换行。 - 没有 stdout 协议。每一轮的进展与结果都在
--trace的会话日志里 （run_start/run_end），调用方跟读那个文件即可；stdout 保持人类可读日志。 - 读到 EOF 正常退出。单轮失败只记一条
run_error并继续等下一轮，不会杀掉整个会话。
三条前置校验（不满足直接退出码 2）：必须配 --trace、不能带位置参数任务、
不能与 --resume 同用（resume 恢复的是同一任务的中断点）。
这些是「防止 agent 把自己搞死」的护栏，默认启用，只能显式放宽：
| 参数 | 默认 | 说明 |
|---|---|---|
--max-observation-chars |
8000 |
单条工具观察的字符上限，超出截断并附分页提示；0 关闭 |
--context-token-budget |
24000 |
估算 token 超预算时提前触发上下文折叠；0 只按消息节奏折叠 |
--disable-edit-guard |
守卫开启 | 关闭 read-before-edit 守卫（首次编辑前需读；写后只有行号模式要求重读，内容锚定模式重新做唯一匹配） |
--llm-max-retries |
2 |
四家 provider 统一的瞬时故障重试次数 |
原子文件写入、修改前备份、解析失败响应的上下文替换，以及 identity no-op 的零写入处理 始终开启，没有开关。identity no-op 不创建备份、不推进写台账，也不完成 planner 的编辑步骤。
| 参数 | 附带参数 | 说明 |
|---|---|---|
--enable-adaptive-replanning |
--max-replans -1 |
错误信号映射到重规划策略 |
Planning 与上下文折叠默认开启，但没有暴露成 dm-agent 开关；它们只在 bench/eval
里作为 ablation 变体存在（no_planning / no_compression）。
v2.1 移除了 Reflexion / Critic / Self-Consistency / 工具熔断 / 记忆卫生 / LLM 摘要压缩及其全部开关——它们的毕业标准依赖已冻结的真实评测。 见 devlog 33。
这些开关是过渡写法：它们内部等价于「加载对应的内置扩展」，实现见 生命周期事件。
| 参数 | 说明 |
|---|---|
--trace PATH |
写可分享的脱敏会话日志 |
--trace-llm-io |
在 trace 中包含完整 LLM 输入/输出，仅私有调试用；malformed 原文即使完整留档，后续请求仍使用 parse_error.context_replacement |
--checkpoint PATH |
*.jsonl 写 append-only 会话日志（可配合 --resume-at 与 fork）；其他后缀写单文件 JSON 快照 |
--resume PATH |
从上面两种形态中的任意一种恢复；任务参数可省略 |
--resume-at ENTRY_ID |
仅对 JSONL 会话日志有效，定位到某条 entry（支持唯一前缀） |
--trace 与 --checkpoint 不能指向同一个文件（前者默认脱敏，后者含完整对话）。
细节见 会话与 trace。
| 参数 | 说明 |
|---|---|
--no-extensions |
只留内置能力：不扫目录、不查 entry point、不触发项目信任提示 |
--extension PATH |
显式加载单个已审查的 .py，仅本次生效，可重复 |
两者互斥。安全模型见 扩展开发。