Keysmith Switch

独立的 Agent 提示词管理与快速部署桌面工具。用户可以粘贴自己的提示词，选择目标 Agent 和范围，先审阅部署计划，再通过对应适配器执行写入。

Switch 不绑定某一组官方提示词正文。提示词可以来自粘贴，或用户明确选择的本地 Markdown 文件；快速部署默认离线工作，不从其他 Keysmith 仓库的远程分支抓取内容。同一 Agent 的相同正文复用既有库条目；如果原条目标题或标签不同，返回并部署原条目，不会暗中改写其元数据。

所有真实配置写入都经过现有四个 Agent adapter。GUI 不直接改写目标 Agent 的配置文件；适配器负责目标格式，Switch 负责提示词库、版本、哈希校验、计划预览及操作记录。备份、漂移检测和恢复能力取决于当前 adapter。库中的 Markdown 带有元数据；交给 adapter 的临时文件只包含提示词正文，完成预览或执行后会清理。

界面与发布结构参照 MIT 开源项目 CC Switch 的桌面产品完成度，业务模型仍是 Keysmith Switch。映射与版权见 docs/CC_SWITCH_MAPPING.md。

状态

公开稳定版是 v0.1.8。main 已合并 Quick Deploy #28；v0.1.9 正在准备中，尚未创建该版本的 tag、安装包或公共 feed。不要把准备分支当作可下载版本。

v0.1.4 接替四个独立桌面安装包。之后只维护 Keysmith Switch。已发出的 Claude、Grok、Codex、Zcode 桌面包保持原样，不撤回，也不改成各自仓库的 Latest。

已安装 v0.1.3 及以上的 Switch 可以在应用内检查更新到已发布的 v0.1.8；v0.1.9 仅在正式发布后才会进入更新渠道。v0.1.1 内置测试 updater 公钥，仍须手动安装。范围见 keysmith-switch#6。

公开 updater 仓库 Jia-Ethan/keysmith-switch-releases、来源验证、生产 updater 签名与受保护发布环境已经启用。

详见 docs/IMPLEMENTATION_STATUS.md 与 docs/RELEASE_GATES.md。

复制给智能体安装

请先阅读本仓库 README 与发布边界，再从公开 Releases 安装当前稳定版。操作前检查系统架构、现有版本和数据目录，列出准确的下载、安装与备份路径；覆盖现有应用或写入托管配置前等待确认。安装后最小验证安装包 SHA-256、应用启动、既有提示词数据和“检查更新”。除非明确要求，不要从源码构建。

下载

当前可下载的稳定版是 v0.1.8。v0.1.9 的安装包尚未发布。

• macOS Apple Silicon（M 系列，含 Mac Studio M4 Max）：Keysmith.Switch_0.1.8_aarch64.dmg
• Windows x64：Keysmith.Switch_0.1.8_x64-setup.exe

v0.1.1 用户需要手动安装 v0.1.3 或更新版本才能完成 updater bootstrap。已安装 v0.1.3 及以上的用户可以在应用内检查更新；未来版本仍需完成独立发布流程。

开发

开发需要 Node 20+、Rust 1.85+。打包 sidecar 需要 Python 3.9+ 与 PyInstaller。用户安装应用不需要 Python。

npm install
npm test
npm run build
cd src-tauri && cargo fmt --check && cargo check && cargo test

桌面调试：

npx tauri dev

macOS Apple Silicon 本地开发构建（不生成 updater artifact）：

npx tauri build --target aarch64-apple-darwin --config src-tauri/tauri.preview.macos.conf.json

GitHub Actions 的 development-candidate 工作流只用于开发候选验证，不生成 updater artifacts。release workflow 从 GitHub-verified tag 构建 macOS/Windows updater payload，使用 minisign 签名，并在 latest.json 写入 minimum_updater_version 与准确 payload 字节数后交给公开仓库复核。

数据位置

• ~/.keysmith-switch/keysmith-switch.db
• ~/.keysmith-switch/prompts/<tool>/<prompt-id>.md
• ~/.keysmith-switch/backups/<operation-id>/
• ~/.keysmith-switch/logs/

测试可用 KEYSMITH_SWITCH_HOME 覆盖数据根。

反馈

Bug、需求与破限建议统一提交至 GitHub Discussions。请勿公开提交 token、完整配置、提示词正文或其他敏感信息。当前仓库尚未启用 Private Vulnerability Reporting，安全漏洞请勿在 Discussion 公开披露。

Agent adapter artifacts

当前发行包仍包含四个 legacy adapter sidecar，用于兼容 Claude Code、Codex、Grok Build 与 ZCode 的目标配置协议。它们是执行实现，不是 Quick Deploy 的默认提示词来源；Quick Deploy 不会自动抓取这些仓库的提示词，也不要求用户安装对应的 Keysmith 仓库。

third_party/keysmith/ 中的版本锁只约束 legacy adapter artifact 的构建与审计。后续 Agent registry 会把这些 artifact 迁移到统一的 adapter manifest；用户提示词库和适配器供应链保持独立。

许可

MIT