常见问题

一般问题

Yuli 是免费的吗？

是的。IDE 可免费下载，且无需注册账户。AI 的费用由你承担：使用你已有的订阅（Claude Code、Kiro、Codex 或 Antigravity），或使用你所选提供商的 API key。

YULI 是什么意思？

Yield Unified Local Intelligent Framework for Orchestrated Generation & Execution。参见什么是 Yuli。

支持哪些系统？

Windows、macOS 和 Linux，64 位。参见安装 Yuli。

已经是正式版了吗？

Yuli 目前处于测试版。它可以用于实际工作，但可能存在错误。请通过 帮助 → 报告问题… 报告。

适用于哪些语言？

它为数十种语言提供语法高亮，并为 Java、TypeScript、JavaScript、CSS、Python 和 Rust 提供语言服务器。最擅长的是 Java（包括使用 Ant、Eclipse、Struts 和 JSP 的遗留系统）和 Web 前端。参见编辑器与语言。

AI

我需要 API key 吗？

不需要。默认情况下，Yuli 使用你的 Claude Code、Kiro、Codex 或 Antigravity 订阅工作。只有在 Platform 模式下才需要 API key。参见连接 AI。

可以使用本地模型吗？

可以。在 Platform 模式下，Local 提供商支持兼容 OpenAI API 的服务器：Ollama、LM Studio、vLLM 或 llama.cpp。参见模型与提供商。

Yuli 会修改 Claude Code 或使用我的账户吗？

不会。Yuli 通过公开的选项打开你安装的 claude。由你自己通过官方流程登录。Yuli 从不接触你的凭据。

智能体会破坏我的项目吗？

每项更改在写入磁盘之前都会经过 AI 更改 窗口，并留下一个检查点。你可以用 Ctrl+Alt+Shift+Z 撤销整个任务。参见审查更改。

智能体会推送代码或删除我的分支吗？

除非你要求，否则不会。Git、CI 和 DevOps 默认被阻止，除非你明确提出，即便如此，每个操作也需要批准。创建分支需要单独提出。在无人值守模式下，git push 不可用。

它用什么语言回复？

用你输入时所用的语言。

为什么智能体要等一切都通过才算完成？

这就是完成标准：如果本轮修改了代码，它必须能编译、通过测试、成功启动，并通过度量阶段。这样你就不会收到被当作已完成的半成品。

安全与隐私

我的代码会离开我的电脑吗？

只有你选择的 AI 读取的内容才会发送给该提供商。发出前，机密会被替换为占位标记。使用本地模型时，任何内容都不会离开你的网络。参见安全。

Yuli 会读取我的 .env 文件吗？

不会。无论是 Yuli 智能体，还是 Claude Code、Kiro、Codex 或 Antigravity，都无法读取 .env、私钥、证书或凭据。参见机密与隐私。

我的 API key 保存在哪里？

保存在操作系统的密钥链中。绝不存入项目。

智能体会删除我数据库中的数据吗？

只有当你为该连接授予 超级权限、勾选了相应的语句类别，并逐条批准语句时才会。默认情况下它只能查询。参见安全的数据库访问。

Yuli 会发送遥测数据吗？

问题报告只在你选择时才会发送，并且绝不包含你的代码或对话。智能体的各项指标都在本地计算。

项目与团队

Yuli 会修改我的仓库吗？

默认情况下，它不会把智能体的配置写入项目。它在 .ai/ 中保存的内容分为与团队共享的部分（契约、记忆、规则）和本地部分，后者通过 .git/info/exclude 排除在 Git 之外。它绝不会编辑你的 .gitignore。参见.ai 文件夹。

可以对整个团队强制执行质量规则吗？

可以，通过 .ai/contract.json 中的质量契约，以及 Git hooks 和 CI 中的 gate。它们对人和智能体同样适用。

提交记录会显示是 AI 写的吗？

不会。Yuli 绝不会添加来自 AI 的 Co-Authored-By 或“Generated with”。作者始终是负责的那个人。

可以将 Yuli 与 Cursor、Copilot 或 Gemini CLI 一起使用吗？

它们不会在 Yuli 内部运行，但你可以从治理中心为它们导出相同的项目规则。参见 Kiro、Codex 与 Antigravity。