Ally

你是否希望有一个能理解项目上下文、执行命令、读写文件，并全程保留在本地环境中的 AI 助手？

Ally 是一款基于终端的 AI 驱动 CLI 工具，旨在帮助开发者和系统用户高效完成从日常任务到复杂项目构建的各类工作，无需离开终端，也无需将数据上传至云端。

它原生集成 Ollama，支持完全本地化运行，同时也可连接 OpenAI、Anthropic、Google GenAI 和 Cerebras 等远程模型服务（更多集成正在开发中）。

对于重视隐私、需要自动化能力又不愿牺牲安全性的用户来说，Ally 提供了一个强大而可控的选择。

核心功能一览

默认聊天模式：你的终端全能协作者

在默认模式下，Ally 作为一个通用代理，能够：

• 读取、创建、修改或删除文件与目录；
• 执行 shell 命令和代码片段；
• 访问互联网（仅在获得明确许可后）；

⚠️ 安全机制：所有敏感操作（如文件更改、命令执行）都会先请求确认，确保你始终掌握控制权。

你可以像提问一样输入需求，例如：

“列出当前目录下的 Python 文件”
“帮我把 config.json 中的端口改为 8080”
“运行测试脚本并输出结果”

每一步操作前，Ally 都会展示即将执行的内容，等待你输入 y 确认。

RAG（检索增强生成）：让AI记住你的项目

Ally 支持本地 RAG 能力，可将你的文档、代码库或笔记嵌入其知识库，在后续对话中实现高准确度响应。

支持的嵌入模型：

• Hugging Face 模型（本地运行）
• Ollama 嵌入模型（如 nomic-embed-text）

未来还将支持更多开源嵌入方案。

使用流程：

1. 编辑 config.json，配置你喜欢的嵌入模型；
2. 进入目标目录，运行：

   /embed . my_project_docs
   

   将当前目录内容存入名为 my_project_docs 的集合；

3. 启动 RAG 会话：

   /start_rag
   

4. 开始提问，例如：
   

   “这个项目是如何处理用户认证的？”

   Ally 将基于你提供的文件内容回答，不会主动调用外部信息。

5. 结束会话：

   /stop_rag
   

其他 RAG 命令：

🔐 注意：RAG 模式下，默认不使用外部数据，除非你明确授权。

项目生成工作流（Beta）：从想法到代码一键启动

Ally 正在测试一项完整的项目生成流程，可通过以下方式触发：

ally --create-project

或在聊天界面输入：

/project

工作流步骤：

1. 需求收集：Ally 会询问你的项目目标和功能设想；
2. 头脑风暴（Brainstormer Agent）：
   • 生成项目结构图、技术选型建议；
   • 输出一份完整的 .md 格式项目规范；
   • 可通过交互式对话进一步细化需求；
3. 代码生成（CodeGen Agent）：
   • 基于规范自动生成目录结构和源码文件；
   • 支持多文件协同编写；
4. 持续迭代：
   • 进入交互模式，随时添加功能、修复错误或重构代码。

🧪 当前为 Beta 阶段，适用于原型设计和学习用途，生产环境使用需谨慎验证。

为什么选择 Ally？