用途:面向 Windows、macOS、Linux 的本地 Codex 用户,处理 Stitch Design 首次使用、缺少 STITCH_API_KEY 或认证失败时的凭据配置与诊断。插件已内置本地 stdio MCP 代理,本技能只处理用户凭据缺失和受限的用户级配置。
主要能力:检查 STITCH_API_KEY 是否已在当前进程或用户配置中设置(不输出其值);指导用户隐藏输入自己的 Stitch API key 并保存到跨平台当前用户受限配置文件;用保存的凭据启动 Codex CLI,或向指定本地命令注入环境变量。
使用方式:先做只读检查:python /absolute/plugin/root/scripts/stitch_setup.py check。检查失败时按最后一行区分:STITCH_API_KEY is not configured 表示凭据缺失,MCP 代理会自动打开本地 Token 页面,用户从 Stitch Settings 创建 key;Stitch MCP configuration is missing 表示安装不完整,新建 key 无效,应修复或重装插件后重跑 check。页面未自动打开时可手动执行:Windows 用 python C:\absolute\plugin\root\scripts\stitch_setup.py ui,macOS/Linux 用 python /absolute/plugin/root/scripts/stitch_setup.py ui。设置后先回对话重发原请求;若宿主未重建 MCP 进程,再用 python /absolute/plugin/root/scripts/stitch_setup.py cli 启动 Codex,自定义命令用 run -- <command>。新任务先只读调用 list_projects 验证。
限制:PATH 中 python 必须为 3.11 或更高版本。不搜索浏览器、其他客户端配置、shell profile、历史或日志中的 key;不执行 echo "$STITCH_API_KEY"、printenv STITCH_API_KEY 或全量 env;不修改 .zshrc、PowerShell Profile 或系统环境。凭据仅来自当前进程或受限用户配置文件,Unix 使用 0700/0600 权限,Windows 继承当前用户 Profile ACL。ChatGPT 网页插件授权应由正式 connector/OAuth 处理,不要求粘贴 key;团队共享作者 key 不适用。移除时先在 Stitch Settings 吊销 key,再删除凭据文件。