档 1：本地开发调试
档 1：本地开发调试
Section titled “档 1：本地开发调试”档 1 给 Agent 足够的本机运行态能力，用来完成日常编码和调试。
你提供/确认
Section titled “你提供/确认”- 仓库入口和你想让 Agent 接管的服务目标。
- 本地 loopback 前端的浏览器调试边界。
- 可选的非敏感
auth_hint，解释登录或换 token 流程。 - 可选的
debug_credentials，放允许 Agent 明文读取的测试账号、密码或服务 API key。
Agent 会自己做什么
Section titled “Agent 会自己做什么”- 检查仓库后创建或更新 SuperDev 项目模型。
- 探测 language runtime provider，生成并校验本地服务的 runtime / deployment 配置。
- 写配置前先 preview；需要审批时等你确认。
- 用
start_service、stop_service、restart_service管理服务。 - 用
tail_logs、search_logs、get_log_context读日志。 - 用
list_browser_targets->open_browser_debug_session->browser_snapshot->browser_*调试本地页面。 - 日志和诊断不够时，用
list_code_debug_targets->debug_capture_at抓断点。 - 看到凭据提示且需要鉴权时，调用
get_debug_credentials。
项目已被 SuperDev 接管时，Agent 不该自己 npm run dev、go run 或 tail -f。那会产生孤儿进程，也会让运行态事实分裂。
浏览器调试只覆盖本地 loopback 前端 deployment，不控制任意公网网站或你的个人浏览器 profile。browser_evaluate 默认关闭，因它能读页面存储和 cookie，需要用户显式开启。
代码断点调试是最后手段。debug_capture_at attach 到运行中的进程，不为了进入调试而重启服务。