Skip to content

Repository files navigation

zcode-keysmith

GitHub Stars Python 3.10+ MIT License

简体中文 · English · 使用说明 · License

zcode-keysmith

给 ZCode 装上一份可撤销的指令。先看计划,确认了再写入。

简体中文

Keysmith 给本机的 AI 编程工具装指令:先预览,再写入,能验证,能撤走。

zcode-keysmith 面向 ZCode。装上之后,新开的对话会按这份指令工作。不读取账号和密钥。ZCode 3.12+ 为了保住独立存储启动和 Keysmith 注入,会备份并补丁 glm/zcode.cjs;卸载还原。更早版本不改 App 原包。

Important

这会改变 ZCode 之后新开的对话。默认只给你看计划,加上确认才会写入。装完后请完全退出并重新打开 ZCode。

使用方式

先看计划,确认后装上,新对话生效,随时可以撤走

  1. 先看计划。 确认之前什么都不会写入。
  2. 确认后装上。 指令交给本机 ZCode,软件保持原样。
  3. 新开一轮对话。 完全退出并重新打开之后才会生效。
  4. 随时撤走。 同样先看计划,确认后恢复成原来的样子。

示意预览;实际路径与输出以本机 dry-run 为准

选哪个 Keysmith

你在用 用这个 怎么开始
Codex codex-keysmith 稳定版安装包
Claude Code claude-keysmith 源码
Grok Build grok-keysmith 稳定版安装包
ZCode zcode-keysmith 源码 zip;桌面候选见下方

每个工具一份安装器。选你正在用的即可。

效果

同一批 10 题,完整交出产物从 1 题到 4 题

同一模型、同一批 10 道题,完整交出产物的题数从 1 题到 4 题。逐题记录见 测量说明。

开始使用

本机需要已经装好 ZCode。下方命令下载目前公开的 0.3.3 zip,支持 ZCode 3.12 与 3.14。macOS 上官方自动更新换包后,LaunchAgent 会重打同一套补丁;锚点变了则跳过并提示升级 Keysmith。若监视进程掉出当前登录会话,另一个不监视 App 包的 LaunchAgent 会把它重新挂回去。项目内 MEMORY.md 不再盖过 Pier;verify 在 runtime-patch 下不再因 leftover wrapper smoke 失败。v0.3.0 会停在启动页,v0.3.1 打不上 3.14。

源码 zip 是当前公开入口。仓库里有第一份 unsigned 桌面候选(GUI 0.1.0-beta.1);不要把它当成已发布安装包。

macOS:

curl -LO https://github.com/Jia-Ethan/zcode-keysmith/releases/download/v0.3.3/zcode-keysmith-v0.3.3.zip
curl -LO https://github.com/Jia-Ethan/zcode-keysmith/releases/download/v0.3.3/SHA256SUMS
shasum -a 256 -c SHA256SUMS
unzip zcode-keysmith-v0.3.3.zip
cd zcode-keysmith-v0.3.3
python3 zcode-keysmith.py install --dry-run
python3 zcode-keysmith.py install --yes

完全退出并重新打开 ZCode,再新开一轮对话。

Windows:

先完全退出 ZCode,再运行:

curl.exe -LO https://github.com/Jia-Ethan/zcode-keysmith/releases/download/v0.3.3/zcode-keysmith-v0.3.3.zip
curl.exe -LO https://github.com/Jia-Ethan/zcode-keysmith/releases/download/v0.3.3/SHA256SUMS
Get-FileHash .\zcode-keysmith-v0.3.3.zip -Algorithm SHA256
Expand-Archive .\zcode-keysmith-v0.3.3.zip -DestinationPath .
cd zcode-keysmith-v0.3.3
py zcode-keysmith.py install --dry-run
py zcode-keysmith.py install --yes

重新打开 ZCode,新开一轮对话。

也可以把 代装说明 交给你正在用的 AI 助手,让它按步骤完成。校验、路径和进阶选项见 使用说明。

怎么撤走

python3 zcode-keysmith.py uninstall --dry-run
python3 zcode-keysmith.py uninstall --yes

Windows 把 python3 换成 py。先看计划,确认后再恢复。

适用环境

macOS 与 Windows。需要 Python 3.10+。Linux 暂不支持。

文档

系列

官方反馈:GitHub Discussions · 社区:LINUX DO

Star History

Star History Chart

About

ZCode App managed true system-role entrypoint

Topics

Resources

Stars

288 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages