PaceCode

PaceCode 是独立运行的 VS Code AI 编程扩展，支持 Windows x64 和 Apple 芯片 Mac（arm64）。 安装包内置 Agent、Node 运行时和原生搜索工具，使用时无需启动桌面客户端，也无需另装 Node。 当前开发预览版可配置自己的模型服务，在侧边栏对话、处理项目代码并继续本地历史。 正式产品计划接入团队统一登录、模型权限与用量服务，相关接口尚待桌面团队提供。

当前为预览版，尚未上架 Marketplace。 Windows 安装包已支持构建，Windows 实机验收尚待完成。 Marketplace Publisher ID 已设置为 paceex-wangqi，扩展 ID 为 paceex-wangqi.pacecode。 旧的 pacecode-local.pacecode 预览版属于不同扩展身份，历史与 SecretStorage 不会自动迁移； 需要查看旧历史时请保留原预览版，新扩展需重新配置模型。

Windows 安装和使用

1. 在 VS Code 中打开项目目录并信任该工作区。
2. 执行 Extensions: Install from VSIX...，选择 pacecode-0.1.2-win32-x64.vsix。
3. 点击活动栏 PaceCode，按向导选择模型 API 类型、填写 Base URL、模型 ID 和 API Key。
4. 发送消息开始工作。支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 协议；模型服务须自行提供访问权限。
5. 在编辑器选中代码后按 Ctrl+Alt+K 附加到对话，包含尚未保存的内容。点击输入框旁的 文件 可添加当前整个文件；卡片可展开预览、单独移除。

齿轮按钮或 PaceCode: Configure Model 可重新配置。API Key 保存于 VS Code SecretStorage。 历史按工作区保存在扩展的 global storage 中。关闭 VS Code 会停止本扩展的 Agent；重新打开后可继续历史。 发送中断时先重连检查历史，再决定是否重发，扩展不会自动重发结果未知的消息。 Windows 的命令执行沿用 Agent 的 shell 检测（Git Bash / cmd）；Git 操作需要安装 Git。

Apple 芯片 Mac 安装

在 VS Code 执行 Extensions: Install from VSIX...，选择 pacecode-0.1.2-darwin-arm64.vsix。模型配置和独立 Agent 使用方式与 Windows 相同， 附加选区快捷键为 Cmd+Alt+K。内置 macOS arm64 Node 和原生搜索工具，无需另装 Node。 Windows 包不能在 Mac 使用，Intel Mac 不在支持范围内。 两种打包命令需要顺序执行；它们共用 dist/runtime 暂存目录，但输出的两个 VSIX 会同时保留。

功能和边界

• 侧边栏、流式输出、历史搜索、新建与继续对话、停止运行。
• 工具输出、权限确认、原生问题回答、多选区/文件附件和 VS Code 原生 Diff。
• 最多 8 个附件，单个 32,000 字符、合计 64,000 字符；重新添加同一范围会替换快照。切换对话、新建对话或重连会清除附件，发送失败时保留。
• 对话底部的“已加载的修改”按文件汇总修改记录，可逐次审阅。它显示已加载历史中的修改片段，不代表当前 Git 净变更。
• 中英文界面、主题跟随、逐会话保留未发送草稿。
• 目前支持本机受信任的文件工作区；Remote SSH、WSL、Dev Container 和虚拟工作区未适配。
• 桌面对话共享仍是后续工作。实验性 pacecode.backend=desktop 仅用于含 IDE bridge 的兼容开发构建；默认独立模式完全不依赖它。
• 复杂工作区钩子审核、完整文件回滚、桌面自动化和浏览器自动化尚未提供完整扩展入口。
• 分别提供 Windows x64 与 macOS arm64 安装包；不支持 Intel Mac，其他目标尚未准备。

开发和验证

从仓库根目录使用 Node 24.14.0 和 pnpm 10.33.2：

pnpm install
pnpm --filter pacecode prepare:runtime
pnpm dev:vscode
pnpm --filter pacecode test
pnpm --filter pacecode test:standalone
pnpm --filter pacecode test:e2e
pnpm typecheck
pnpm lint
pnpm architecture:check --changed
pnpm --filter pacecode package:windows
pnpm --filter pacecode package:mac

prepare:runtime 构建当前平台运行时，需在 F5 开发调试和真实 Agent 测试前执行。 跨平台构建 Windows 包时，把官方 Node 24.14.0 Windows x64 压缩包解压，设置 PACECODE_NODE_DISTRIBUTION 指向其中包含 node.exe 和 LICENSE 的目录；脚本校验官方 SHA-256。 本机 Windows 构建直接使用当前 Node，版本和校验值同样须匹配。输出在 dist/。

test 包含真实 CLI 对本地模型模拟服务的集成测试：流式回复、持久化恢复、重复 owner 拒绝和临时配置清理。 test:standalone 启动隔离的 VS Code profile，自动填写真实模型设置窗口，验证实际扩展宿主与 Agent。 test:e2e 另行验证可选桌面桥。测试不使用个人模型或真实对话；本地模型模拟服务不能代替付费服务兼容性验收。 可设置 VSCODE_EXECUTABLE 指向 VS Code 可执行文件（Windows 推荐 Code.exe，不是 code.cmd）。

Webview 键盘、IME、草稿与 Diff 测试：先运行 pnpm --filter pacecode test:e2e --inspect-ui， 再运行 pnpm --filter pacecode exec node scripts/test-webview.mjs。在打印的临时目录创建 finish-ui 空文件结束。仅隔离测试开启 9338 调试端口，正常扩展不开放调试端口。

上架

1. 用对应 Microsoft 账号登录 Marketplace 发布者管理，选择已创建的 paceex-wangqi Publisher。
2. 确认 package.json 的 publisher 为 paceex-wangqi，并填写团队自己的仓库、支持地址。
3. 在 Windows 实机完成安装、配置、对话、文件修改授权、停止和重启恢复验收；使用真实模型验证兼容性。
4. 打包后在扩展目录执行 node scripts/package.mjs --release，会拒绝占位 Publisher ID。
5. 在同一个扩展条目下上传 Windows x64 和 macOS arm64 两个目标包，保持 Publisher、名称和版本一致。 Marketplace 验证并发布成功后，才能在 VS Code 扩展市场搜索 PaceCode。

参见 VS Code 官方发布说明。 该仓库不会自动上传安装包，不包含发布凭据。

合并说明

规格位于 specs/pacecode-vscode.md，默认入口为 standaloneBackend.ts。 ChatBackend / ChatConnection 隔离 Agent 与侧边栏，后续桌面共享仍复用同一协议端口。 合并包含扩展目录、services 的 agent-transport 公开出口、根脚本/lockfile、架构策略和调试配置。 桌面桥相关改动属于实验适配器；没有读写原桌面会话数据库或迁移手机恢复链路。

CLI 当前通过文件读取 Provider 配置，因此运行期间会在私有目录生成临时凭据文件，退出时删除； 异常崩溃可能遗留文件。持久凭据保存在 SecretStorage，Webview 和发布包不含凭据。 本扩展基于 ZCode 修改，保留 Apache-2.0 LICENSE、Agent 第三方声明和所附 Node 许可证。