ZCode安全机制全解：权限系统、远程访问令牌与代码数据保护的完整设计

ZCode安全机制全解权限系统、远程访问令牌与代码数据保护的完整设计【免费下载链接】ZCodeZCode 是 AI 编程工作台提供桌面应用、浏览器界面和终端 Agent。本仓库包含客户端、后端服务、共享 UI以及 Agent CLI 与运行时源码。项目地址: https://gitcode.com/zai-org/ZCodeZCode 是智谱推出的 AI 编程工作台提供桌面应用、浏览器界面和终端 Agent 三种形态。很多用户担心让 AI 直接操作我的代码和终端安全吗这篇指南带你完整看懂 ZCode 的权限系统、远程访问令牌和代码数据保护设计理解它如何确保 AI 的每一步操作都受你控制。三层安全模型总览ZCode 的安全设计可以概括为三层防线从AI 想做什么到数据怎么存逐层设防防线回答的问题核心模块权限系统AI 能执行哪些操作permission/远程访问控制谁能连到我的代码remoteSshHostKey.ts数据与令牌保护密码、Token 存在哪、怎么加密credentialService.ts下面逐层拆解。权限系统AI 动手前先问你要不要四种协作模式一句话解释ZCode 的终端 Agent 通过**协作模式Collaboration Mode**控制 AI 的行动自由度逻辑定义在 permission/service.ts 中️Plan 模式AI 只规划、不动手。进入该模式后一切写入操作都会被拦截只能由用户主动确认后退出见 plan-mode-policy.ts。✏️Edit 模式日常默认AI 可以改文件但关键动作仍需你批准。Build 模式更激进的自动执行适合已充分信任的任务。⚡Yolo 模式跳过权限提示自动放行——仅限在隔离环境如容器中使用ZCode 对此有明确的模式语义区分。每个工具如文件编辑、命令执行、网页抓取都会声明自己的**风险等级Risk Level**与副作用范围权限服务据此输出三种决策之一allow放行、ask询问你、deny拒绝。规则匹配让这次允许变成以后都允许当你选择本次会话始终允许时ZCode 会在会话内生成一条allow 规则。规则引擎rule-matching.ts支持通配符匹配如npm run *:*/这类前缀规则针对WebFetch的 URL 规则按域名维度放行isWebFetchPreapprovedUrl项目级权限规则文件deny永远优先于askask优先于allow——越严格的规则越先生效。会话结束或/new开新会话后会话级规则自动清空不存在上次授权、这次静默执行的越权风险。权限 Broker异步审批不阻塞permission/broker.ts 采用先拒绝、后协商的默认策略若没有配置任何权限客户端比如脚本化无人值守场景默认DenyPermissionBroker会直接拒绝——安全默认值永远是不而非是。交互式请求则有超时与取消机制审批弹窗被挂起时任务会被干净地中止而不是卡死。远程访问令牌你的代码不会裸奔在网络上ZCode 支持通过 SSH 连接远程机器上的代码仓库桌面端连接远端工作区。这里有两个关键设计共享身份密钥密码永远不进共享状态buildSshRemoteHostKey 函数会为每个远程主机构造一个共享身份用于窗口内复用连接。源码注释写得很直白密码和私钥口令只用于建连禁止进入共享键或日志。也就是说共享身份里只包含主机名、端口、用户名、认证方式和私钥路径经过规范化绝不含密码或私钥内容本身。路径规范化还会阻止..越界防止恶意构造的路径逃逸到意外目录。服务权限模式三种部署形态的隔离边界ZCode 通过环境变量ZCODE_SERVICE_AUTHORITY_MODE区分三种运行形态serviceAuthority.ts模式场景desktop-local桌面端本地运行desktop-attached-remote桌面端挂载远程服务standalone-server独立服务端如容器部署远程形态下OAuth 凭据与本地凭据的读取策略会按模式切换避免远程端误读本地用户目录下的敏感配置。代码与数据保护令牌如何落地加密存储而不是明文 JSON登录态 JWT 和 OAuth Token 统一由 OAuthService 管理令牌以zcodejwttoken等键名写入凭据存储。关键点在于 credentialService.ts 的实现写入前加密、读取时解密credentials.json中保存的是密文不是明文令牌原子写 文件锁桌面 host 与 CLI 是独立进程通过共享目录锁覆盖读—改—写全过程防止并发写坏文件损坏即拒绝覆盖如果凭据文件损坏或 schema 校验失败服务会先备份损坏文件再报错绝不会把损坏当成空库、顺手清掉你的其他登录凭据。日志脱敏与审计服务层日志统一走分级 loggerserviceLogger损坏凭据等安全告警会落盘但不记录凭据内容本身遥测数据同样经过 telemetryRedaction.ts 的脱敏处理保证你的代码路径和令牌不会随上报数据外泄。常见疑问 FAQQ1Yolo 模式危险吗它跳过了所有权限询问ZCode 将其定位为隔离环境专用。日常开发请保持 Edit/Plan 模式。Q2会话授权会泄露到下个会话吗不会。会话级 allow 规则随实例消亡重启或/new后一切从零开始。Q3远程连接时密码会出现在日志里吗不会。共享身份密钥被明确设计为排除密码与私钥口令日志中只会出现主机、端口、用户名等连接元数据。Q4凭据文件被删了会怎样ZCode 只会在文件损坏时备份保留证据并报错不会自动重建空库防止静默丢失其他登录凭据。总结安全默认值处处是不ZCode 的安全设计有一条贯穿始终的主线默认拒绝、最小授权、凭据加密、日志脱敏。从 PermissionService 的决策链到 凭据加密存储 的防御式实现再到 SSH 共享身份 对密码的硬性隔离每一层都在回答同一个问题——AI 能替你做事但方向盘始终在你手里。如果你想深入阅读源码可以从这三个入口开始权限判定核心permission/service.ts令牌与 OAuth 生命周期oauth/oauthService.ts共享类型与协议packages/shared/src/【免费下载链接】ZCodeZCode 是 AI 编程工作台提供桌面应用、浏览器界面和终端 Agent。本仓库包含客户端、后端服务、共享 UI以及 Agent CLI 与运行时源码。项目地址: https://gitcode.com/zai-org/ZCode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考