Deep Agents Code（dcode）命令行参考总结
这是dcode的完整命令行标志与管理子命令参考，用于在启动时覆盖默认配置、脚本化非交互任务，或无需打开会话即可管理工具、代理、会话、技能、凭证和配置。
一、启动与模型选择（核心）
-a/--agent NAME：使用指定命名代理（有独立记忆、技能、AGENTS.md），覆盖配置中的默认/最近代理。-M/--model MODEL：指定模型（provider:model格式，如anthropic:claude-opus-4-8或openai:gpt-5.5）。- 模型解析优先级（无
--model时）：--model标志config.toml中的[models].default[models].recent- 环境自动检测（
OPENAI_API_KEY→ANTHROPIC_API_KEY→GOOGLE_API_KEY等）
--default-model [MODEL]/--clear-default-model：设置或清除全局默认模型。--model-params JSON：传入模型额外构造参数（仅当前会话）。--profile-override JSON：覆盖模型 profile（如max_input_tokens），会持久影响会话内切换。--install NAME：安装可选 provider/sandbox 扩展（如groq、fireworks、daytona）。
二、会话与代理管理
-r/--resume [ID]：恢复最近或指定线程会话（会忽略 agent 选择，恢复原代理）。- 管理命令：
dcode threads list [--agent] [--limit] [--sort] [--branch] [--cwd] [-v] [-r]dcode threads delete ID（支持--dry-run）dcode agents list/dcode agents reset --agent NAME（可复制其他代理记忆）
三、非交互模式与管道（脚本化重点）
-n/--non-interactive TEXT：单次任务后退出，每次都是新线程（文件状态会持久）。- stdin 管道自动进入非交互模式。
-q/--quiet：只输出最终回复到 stdout（方便管道）。--no-stream：缓冲完整回复再输出。--max-turns N/--timeout SECONDS：限制轮次或时间，超时退出码 124（必须配合-n）。- Shell 默认在非交互模式下禁用，需用
-S/--shell-allow-list开启：- 逗号分隔命令名
recommended（安全只读默认）all（允许任意命令，危险）
--allow-fs-tools LIST：限制文件系统工具（必须包含read_file；有效值：ls,read_file,write_file,edit_file,delete,glob,grep,execute）。- 注意：
--allow-fs-tools控制工具是否存在，-S控制execute允许哪些命令。非交互要跑命令必须两者都设。
- 注意：
四、启动时技能、目标与初始提示
--skill NAME：启动时立即调用技能（可配合-n/-q）。--rubric TEXT|@PATH+--rubric-model+--rubric-max-iterations：非交互模式下传入验收标准（rubric 评分）。-m/--message TEXT：交互模式启动后自动提交初始提示。--startup-cmd CMD：启动前先跑 shell 命令，输出只显示在 transcript，不会进入 agent 消息历史。要把输出给 agent，请用管道。
五、审批与安全模式
- 默认需要人工确认危险操作。
-y/--auto-approve：Auto 模式（LLM 分类器自动审批）。--yolo：跳过审查直接执行（交互模式，有风险确认）。- 交互中可用
Shift+Tab切换 Manual/Auto。
六、远程沙箱
--sandbox TYPE（langsmith、agentcore、daytona、modal、runloop、vercel等）。- 配合
--sandbox-id、--sandbox-snapshot-name、--sandbox-setup。 - 无值时使用
config.toml中的默认。
七、MCP 控制
--mcp-config PATH：最高优先级添加 MCP 配置。--no-mcp：完全禁用。--trust-project-mcp：信任项目级 MCP（非交互时不提示）。dcode mcp login NAME：OAuth 登录。
八、其他重要标志
--recursion-limit N（默认 2000，范围 25–100000）--interpreter/--interpreter-tools：控制 JS 解释器。--acp：以 ACP 服务器模式运行（stdio）。--update/--auto-update/-v/-h
九、管理子命令速查
| 命令组 | 主要用途 |
|---|---|
dcode auth | 管理 API 密钥（set/list/status/remove/path，推荐管道或--from-env） |
dcode config | 查看有效配置（show/get/list/path） |
dcode doctor | 诊断安装、依赖、追踪、数据目录问题 |
dcode tools list | 列出当前可用工具（可先加--allow-fs-tools等） |
dcode skills | list/create/info/delete技能 |
dcode threads | 列出会话 / 删除会话 |
dcode agents | 列出 / 重置代理记忆 |
所有管理子命令支持--json输出机器可读格式。破坏性操作支持--dry-run。
十、学习重点（标粗推荐优先掌握）
- 模型选择与默认设置（
--model、--default-model、解析优先级） - 非交互模式完整工作流（
-n、管道、-q、--max-turns/--timeout） - Shell 与文件系统权限控制（
-S与--allow-fs-tools的区别与组合） - 审批模式（Manual / Auto
-y/ YOLO） --startup-cmd与管道的区别（输出是否进入 agent 上下文）- 会话恢复（
-r）与代理隔离（-a） - 技能与 Rubric（非交互自动化验收）
dcode auth/dcode config/dcode doctor日常运维命令
这些是日常使用和脚本化时最核心的内容。建议先掌握模型指定、非交互运行 + 权限控制、以及会话/代理管理这三块。
