AVL Code

第六章　信任与排障

本章覆盖第 26–28 章：安全与隐私边界、故障排查与常见问题，以及一组经过验证的最佳实践。

第二十六节 安全与隐私

AVL Code 在设计上把用户数据当作"敏感数据"处理。

26.1 数据落地

  • 所有会话历史保存在本地，不上传到任何第三方。
  • 仅在你显式调用模型时，对应消息内容才会按所选服务提供方的协议传输到模型方。
  • 反编译能力会按需向反编译模型发送相关反汇编片段；只有你主动调用相关工具才会触发。

26.2 凭证管理

  • 登录凭证、模型 API Key、外部服务凭证都以受保护方式存储在本机。
  • 服务提供方的 API Key 与外部服务凭证不会随对话内容上传到模型；只有调用对应工具时才作为头部送给对方服务。

26.3 样本目录的特殊保护

工作区下名为 samples/ 的子目录被强制视为"不可执行"区，任何执行类工具调用都会被无条件拒绝，这一策略不可解除。

26.3.1 删除类操作的路径护栏

删除类操作（包括「关闭项目工作区并清除数据」）在动手之前会先把路径按软链接解析成真实路径，再与家目录、系统黑名单目录比对。此前如果家目录（$HOME）是通过软链接可达的，护栏可能识别不出来，存在被整体误删的风险 —— 现已按解析后的真实路径比对，堵住这个隐患。

命令执行同样不受工作目录劫持：工作区下就算有个与常用命令同名的文件，也不会被当成要执行的程序。

26.4 审计

所有工具调用、所有审批结果、所有计划修改都以独立卡片记录在会话流中，可作为完整审计材料。

轨迹导出带脱敏：把一次运行的轨迹导出成文件时，默认勾选「脱敏」—— 按 设置 → 数据脱敏 的规则替换后再落盘，便于把运行记录交给别人排查而不泄露敏感内容；需要原文时取消勾选即可（见 §9.4.2）。

26.5 网络访问

  • AVL Code 启动后会访问账号服务获取登录状态与套餐额度。
  • 访问服务提供方时按所选模型配置发起请求。
  • 启用 SBOM 在线审计 / 同步时才会访问 OSV 漏洞库（api.osv.dev、OSV dump 存储桶）与 CISA KEV 名录；隔离网可改指内部镜像或走离线导入，全程不联网。
  • 不会主动联网做用户行为埋点。

26.6 升级安全

升级包带签名校验，验签失败会自动回滚，避免被中间人替换。