Yana AI Vibe 项目

项目简介

Yana AI 是一个本地优先、跨平台的 AI 运行与治理系统，官方一句话概括为"One runtime. Any AI. Human-governed."——任何模型都可以接入，但最终由人来决定它能走多远。它的核心命题写在项目首页最显眼的位置：模型提议，Yana 决定，人始终掌握控制权。项目由越南开发者 Vũ Văn Tâm 主导开发，采用 Apache-2.0 协议，主体为 Python 与 Rust 混合实现。

核心功能

1. 统一的权限裁决链路：任何模型的动作都要走同一条路径——模型提议动作，Authority 判断这个 Agent 有没有资格发起请求，Capability 界定具体是哪一项固定能力，Policy 依据规则并结合人工审批决定"现在能不能做"，Executor 最终只执行被许可的那一步操作。
2. 一个 Rust 运行时掌控全部客户端：yana-rt 单个二进制文件持有每一轮的对话循环与权限检查，Studio、CLI、MCP 三端共用一套权限逻辑，不会各自重复实现。
3. 19 个模型供应商：云端 13 个（Anthropic、OpenAI、Gemini、Groq、DeepSeek、OpenRouter、xAI、Novita、NVIDIA、MiniMax、GLM、HuggingFace、9Router、Kimi）与本地 6 个（Ollama、LM Studio、llama.cpp、TurboFieldfare、AirLLM），另支持自定义 OpenAI 兼容端点，并具备类型化错误处理、备用供应商切换与凭据池轮换。
4. 受控的能力工具集：文件读取与补丁、在校验下执行命令、通过 stdio 的 MCP 客户端、经检查的 HTTPS 层的 web.search、只读 LSP 客户端。
5. 可验证的治理链路：能力清单（capability manifests）、人工审批、哈希链审计日志（改一行即可被发现）、SHA-256 的 core-lock 完整性清单（锁定 287 个核心文件）。
6. 独立看门狗 Giám Thị：运行在所有 AI 会话之外，由操作系统调度器每 6 小时拉起（macOS launchd / Linux systemd timer / Windows 计划任务），一旦发现执行配置文件被改动就写入 GIAMTHI_HALT.lock，此后所有工具调用被一律拒绝，且只有人手动删除锁文件才能解除。
7. 大而全的知识层：内置 100 个专家 Agent、2026 个技能、170 个 Claude Code 斜杠命令、66 个 PreToolUse/PostToolUse/Stop 钩子与 71 条规则，技能负责"教 Agent 怎么做事"，但只有能力才能"授予它做事的权限"。
8. 多宿主适配：Claude Code 走原生钩子与规则，运行时逐次阻断并写入哈希链审计；Codex 通过 AGENTS.md 与 .codex/ 钩子；Cursor 通过 .cursorrules 与 beforeShellExecution 钩子筛查命令；Antigravity 仅为建议级。

技术实现

整个项目刻意把"权限"从"提示词"里剥离出来，做成一条独立、可审计的执行链路。yana-rt 用 Rust 实现，充当所有客户端共享的权限网关：模型永远只能提议，真正的放行权在 Capability 与 Policy 两层，Policy 采取"规则优先、再看人工"的顺序，强制推送、发布、部署、删除这几类动作必须在当前会话里重新确认，之前的批准不延续到下一次。状态层用 SQLite 存会话并支持全文检索、崩溃恢复与影子 Git 检查点回滚。完整性机制有两层：core-lock 是 SHA-256 清单，能发现核心文件被改、删或注入，但官方坦白它只能证明目录与锁文件一致、不能证明有人审阅过；真正的独立校验交给 Giám Thị，它跑在会话之外、由操作系统调度，发现漂移就落锁阻断后续一切工具调用。审计日志同样是哈希链结构，官方明确说明它是"可检测篡改"而非"防篡改"。局限也在文档中明说：guard-destructive.sh 只做命令字符串匹配而非完整 shell 解析，刻意构造的命令仍可能绕过；Cursor 不审查 MCP 工具调用；Antigravity 仅建议不强制；纯浏览器部署（无 Rust 运行时）无法获得完整治理。

快速上手

1. 安装命令行：执行 pip install yana-ai 安装 Python CLI；追求零 Python 依赖可改用 cargo install yana-rt 直接装原生运行时。
2. 接入工程：在仓库根目录运行 yana-ai install，把 Yana 的钩子与规则写进你的工程。
3. 自检接线：执行 yana-ai doctor . 检查各层是否正确挂载。
4. 启用看门狗（可选）：用 yana-ai giamthi install 安装 Giám Thị，后续可用 status、repair、uninstall 管理。
5. 安装桌面版：从 GitHub Releases 或官网下载，提供 macOS 的 .dmg/.zip、Windows 的 .exe（x64/ARM64）、Linux 的 .deb/.AppImage（暂无 Linux ARM 构建，macOS 包为临时签名未做公证）。
6. 按宿主适配：切换宿主可用 yana-ai install --engine codex 等命令，170 个斜杠命令（/plan、/verify、/code-review 等）可直接在会话中调用。

适用人群

已经在用 AI 编程工具、但担心 Agent 权限失控的开发者；需要在团队里推行"AI 可审计"合规要求的工程团队与安全负责人；想统一管理多个模型供应商、不想被单一厂商绑定的技术负责人；以及愿意用一点配置成本换取确定性边界的重度 AI 编程用户。

官网链接

源码仓库：https://github.com/yanacuti1121/Yana-AI ｜ 官网：https://yana.vutam.link ｜ 运行时：https://crates.io/crates/yana-rt ｜ Python 包：https://pypi.org/project/yana-ai/ ｜ 最新版本：studio-v1.6.2（2026 年 10 月 6 日发布，仓库 2026 年 10 月 20 日仍在推送）