用途：为终端类编码智能体（Claude Code、Codex、Pi、JCode 等）和个人自动化搭建一个独立、本地可控的 Stream Deck 驾驶舱。核心链路为：Stream Deck 动作或启动器 → 本地守护进程 cockpitd → 预声明的命令/会话适配器 → 各 CLI。运行时不依赖 streamdeck-mcp、其他 MCP 服务器、AgentDeck 或模型。
主要能力：提供两种模式。仅启动器模式使用 Stream Deck 内置动作打开生成的 .command/.cmd 启动器，适合静态点按，无需编译插件；原生插件模式使用一个绑定 controlId 的通用动作，支持动态标题/图标、状态轮询、长按、旋钮旋转与按下、单控件设置。控件按稳定的逻辑 controlId 绑定，不使用物理行列坐标。
使用方式：先探测环境（python3 scripts/probe_environment.py --json），生成能力清单；再创建或更新配置版本 3，基于 assets/cockpit.example.json 并以 assets/cockpit.schema.json 校验（python3 scripts/validate_cockpit.py path/to/cockpit.json）。可用 python3 bin/cockpitd.py --config path/to/cockpit.json 启动守护进程，并用 cockpitctl.py 检查 health 与 controls；仅启动器模式用 scripts/generate_launchers.py 生成启动器。构建插件时在 streamdeck-plugin 目录执行 npm ci、npm test、npm run typecheck、npm run build，再运行 scripts/install_streamdeck_plugin.py --force。
限制：只执行本地配置中声明的命令，不接受任意 shell 文本；命令为 argv 数组并以 shell=False 执行；守护进程绑定回环并用文件令牌认证；不承诺通用控制第三方插件；不根据进程存在、耗时、终端标题或抓取文本推断“思考/完成/阻塞”或百分比等语义状态；语义状态仅来自钩子、事件适配器或显式上报；不默认直接编辑 Stream Deck 配置文件存储，仅在用户明确要求时使用受保护的 profile 助手并先备份。