概述

新增 --headless 参数，允许 deepcode 在非交互模式下执行 prompt 后自动退出，不再停留 TUI 界面。

Close #139

使用场景

--headless 主要面向以下场景：

1. CI/CD 流水线集成：在 GitHub Actions / Jenkins 等环境中自动执行代码审查、变更摘要等任务
2. Shell 脚本与管道组合：输出到 stdout，可与其他 Unix 工具链组合（如 deepcode --headless -p "..." | tee result.txt）
3. Docker 容器化部署：无 TTY 环境下的容器内 Agent 集群化使用
4. 批量任务处理：对多个项目目录执行相同的分析指令

设计决策

权限策略

headless 模式没有用户可交互，因此：

• 权限自动批准：在 runHeadless() 中，getResolvedSettings 将 permissions 强制设为 { defaultMode: "allowAll" }，忽略用户在 settings.json 中的 askAll 配置
• 安全考量：--headless 是一个显式参数，使用者需明确指定；默认执行路径（无 --headless）不受任何影响

架构实现

核心改动是绕过 Ink/React TUI 渲染流程，直接调用 SessionManager：

改动文件

• packages/cli/src/cli-args.ts：新增 --headless 布尔参数 + 校验
• packages/cli/src/cli.tsx：新增 runHeadless() 函数

使用方式

deepcode --headless -p "总结这个项目"
deepcode --headless -p "列出所有 API 接口" | grep "auth"