ZCode ACP Review

让支持本地命令和 Skill 的 Agent 通过 ACP 调用本机 ZCode，审查方案或代码、沿用会话复审，并为每次调用保存一份短记录。

Codex / 其他宿主
  → review.ps1 → acpx（ACP 客户端）
  → ACP / stdio → zcode-acp（适配器）→ 本机 ZCode app-server

ACP 是协议；acpx 是这里选用的客户端，并不是必需的唯一实现。本项目不是 MCP 服务，也不提供模型或 ZCode 登录凭据。

支持范围

• 首版仅支持 Windows、PowerShell 7、Node.js 22.13+、Git。
• 已安装并登录 ZCode，能找到应用自带的 resources/glm/zcode.cjs。
• 固定依赖 acpx@0.15.1、zcode-acp-server@0.35.1。
• 本机验证版本：Node 22.22.2、ZCode 3.10.2 / 内置 CLI 0.16.5。其他版本不保证兼容。

安装与使用

git clone https://github.com/Lianminx/zcode-acp-review.git
cd zcode-acp-review
pwsh -File ./skills/zcode-acp-review/scripts/setup.ps1 -ZcodeBin 'C:/实际安装目录/ZCode/resources/glm/zcode.cjs'

将 skills/zcode-acp-review 目录放入宿主认可的 Skill 目录，或让宿主直接读取其中的 SKILL.md。已有同名 Skill 时先比较内容，不直接覆盖。脚本也可以独立运行，无需宿主安装。

向宿主说明：“通过 ZCode 审查这个方案，允许它调查当前目录，保留记录。”代码审查请同时给出基线提交。主 Agent 应核实反馈，不能把调用成功视为审查通过。

完整命令、参数、复审和卸载见 使用说明。验证边界见 验证记录。

权限与数据

-TrustWorkspace 明确启用当前实现的工具权限自动批准。ZCode 可读取工作区并运行命令；“只审查、不实施”由提示词约束，不是只读沙箱。需要硬隔离时，请先建立受限工作区与运行环境，不要只依靠这个开关。

审查材料将进入 ZCode 配置的模型服务。请求临时文件会删除，但 acpx / ZCode 自己的会话仍保留。短记录默认在 %LOCALAPPDATA%/zcode-acp-review/reviews，包含本地路径、版本、会话 ID 和截断的回答；简单脱敏不保证覆盖所有敏感内容，公开前必须人工检查。不要把运行记录和本机配置提交到公开仓库。

脚本进入执行后会记录失败；参数绑定失败、记录目录不可写等启动前故障无法保证留档，强制结束可能留下 running。不自动循环复审到通过。

上游与许可证

• Agent Client Protocol
• openclaw/acpx：MIT
• william0wang/zcode-acp：Apache-2.0，社区适配器

本仓库自己的脚本、提示词和文档使用 MIT。依赖分别遵循其许可证；不分发 ZCode，不隶属于上述项目。