用途:本资料为 droid-control 工作流提供 Droid CLI 的目标模式、快捷键、模式与启动辅助知识,由编排器路由加载,不直接调用。
主要能力与快捷键:shift tab 切换 Spec 模式;ctrl l 循环自主级别(Off > Low > Med > High > Off);ctrl n 循环可用模型;tab 循环推理级别(High > none > Low > Medium > High);esc 取消/关闭/停止流式输出;ctrl u 清空当前行;空输入时按 ! 切换 bash 模式(提示符在 > 与 $ 间切换);? 打开快捷键帮助;shift enter 插入换行不提交。对话框用上下键移动高亮,enter 选择,esc 关闭。
斜杠命令:/help、/settings、/model、/clear 或 /new、/sessions、/status、/cost、/compress [prompt]。文件提及:输入 @ 打开文件建议,输入过滤,tab 接受,esc 取消。视觉提示:Spec 模式开启时输入边框显示 Spec;bash 模式提示符为 $;空闲时提示符为 > 且无 spinner;对话框为带导航提示的盒状菜单;文件建议为输入框下方下拉;思考时显示 Thinking... 与停止提示。
启动方式:droid-dev 是位于 ~/.local/bin/droid-dev 的轻量 bash shim,通过 bun 运行 DROID_DEV_REPO_ROOT 指向的检出,不使用预编译二进制。任一检出执行一次 npm run setup 即可安装 shim,切换分支通过 --repo-root 即时完成。前提是目标 worktree 已安装 node_modules(仓库根执行 npm install),否则 bun 启动失败。tctl --repo-root 会自动设置 DROID_DEV_REPO_ROOT 并将会话固定到该 worktree;tctl --cwd 独立于 --repo-root,未设置时默认取 --repo-root。droid-dev 启动必须提供 --repo-root(或 --env DROID_DEV_REPO_ROOT=...),否则 tctl 会拒绝。
示例命令:$TCTL launch "droid-dev" -s demo --backend tuistory --repo-root /path/to/worktree --cols 120 --rows 36;true-input 后端使用真实终端证明。对比场景可分别启动 before/after 会话并加 --record 与 --env FORCE_COLOR=3 --env COLORTERM=truecolor。查找 worktree 用 git worktree list,创建用 git worktree add /tmp/baseline-worktree dev。
执行与日志:非交互单次执行 droid exec "analyze this file"、droid exec --auto medium "run the tests"。调试日志通过 --env FACTORY_LOG_FILE=/tmp/droid-test.log 传入,再用 tail -f 查看。
限制:资料未提供收费、价格、平台支持范围与效果数据;droid-dev 依赖已安装 node_modules,且必须指定 --repo-root。