隐私与数据存储说明
Vela 的核心架构围绕“本地优先 (Local-First)”原则构建。在此如实说明数据存储位置、访问边界、外部网络交互与数据清理方式。
1. 工程数据保存在本地目录
Vela 的所有工程资产与索引仅保存在你个人的本地磁盘中(当前开发预览版默认位于 ~/.vela-dev/,正式版位于 ~/.vela/)。
系统内不包含任何中心化云端数据库,不设置云端用户账号体系,也没有静默的后台自动同步服务。工程数据属于你的本地设备,由你自主决定备份与版本归档方式。
2. 零后台遥测与无行为上报 (Zero Telemetry)
Vela 自身未集成任何商业分析 SDK、使用行为埋点、留存统计或静默崩溃上报模块。
系统不会将你的项目代码、本地会话内容或 Prompt 文本发送至 Vela 分析服务器。所有支持的本地日志解析与经验匹配均在本地计算处理。
3. 私密资料的检索边界 (Private Library)
在 Library 知识库中标记为“私密 (Private)”的文档,仅供工程师在本地应用界面中手动检索或阅读。
Vela 的 stdio MCP 与自动召回会排除标记为 Private 的 Library 条目。该标记约束 Vela 自身的检索接口,并非文件系统沙箱;你显式批准的脚本或第三方 Coding Agent 仍受其自身权限和数据处理方式约束。
4. 明确的网络通信与模型数据流边界
Vela 自身不主动产生任何未经请求的后台网络通信,请勿将“本地优先”误解为“物理隔离断网”或“任何数据永不离机”。以下操作会产生正常的外部网络交互:
- 编码智能体 Provider 数据流:Coding Agent 本身(如 Claude Code、Codex CLI、Cursor)在执行问答或代码生成时,依据其自身 Harness 与用户的 API 密钥配置,会将上下文 Prompt 发送至其对应的模型服务商(Anthropic、OpenAI 等)。Vela 作为工程支持层仅监听其本地生成的日志文件。
- 显式网页导入:当你在 Library 中主动输入外部 URL 要求提取网页知识时,系统会向目标网址发起 HTTP 请求并处理可能发生的重定向。
- 经批准执行的外部命令:在 Workflows 工作流或 Lab 实验中,由工程师明确点击批准执行的外部脚本或第三方智能体命令,可能依据其自身逻辑访问网络。
- 外部链接跳转:在界面中点击 GitHub 仓库、文档或 Releases 链接时,会在系统默认浏览器中打开对应网页。
5. 数据清理与自主权说明
退出 Vela 应用程序及所有正在使用该存储目录的 CLI/MCP 进程,按需备份文件后,删除选定的本地数据目录 ~/.vela-dev(或对应的 ~/.vela),即可清除该目录中保存的 SQLite 数据库与托管资产(Memory、Workflow、Guideline、Library、Checkpoint)。
需要说明的是,此操作不会撤销此前已经由工作流批准写入到工程代码仓库中的文件修改,亦不会删除原始智能体工具自身的本地日志、系统备份或通知历史。