使用说明
本地代理商
MCP工作流的本地第一代理运行时，具有明确的信任控制和可重放的运行。
LocalAgent可帮助您从好奇心转向工作的本地代理工作流，而无需与提供程序设置、不安全的默认值或不透明的故障作斗争。
它是为本地代理的硬部分而构建的：以一种引导、可检查和操作清晰的方式将机器上的LLM连接到MCP工具。
为什么选择LocalAgent
当地代理商之间的大部分摩擦都是可操作的。
LocalAgent通过以下方式缩小了这一差距：
- 引导式启动和提供商自动检测
- 用于本地代理工作流的交互式TUI聊天
- 具有批准和审计跟踪的明确信任控制
- 可重放的工件和可检查的事件日志
- 除非明确启用，否则禁用shell和写访问的安全默认值
- 内置eval工作流和可审查的运行输出
- 不隐藏高级控件的初学者友好路径
快速启动
启动受支持的本地提供程序，然后在要在其中工作的项目目录中启动LocalAgent。
# 1) Install from the repo root
cargo install --path . --force
# 2) Launch LocalAgent in the workspace you want to work in
localagent
如果您的提供商在LocalAgent已打开后启动，请按 R 在启动屏幕中刷新提供者检测。
支持的提供商
- 奥拉玛
- LM 工作室
- llama.cpp服务器
常用命令
一次性任务
localagent --provider ollama --model llama3.2 --prompt "Summarize src/main.rs" run
交互式TUI聊天
localagent --provider ollama --model llama3.2 chat --tui
验证提供者
localagent doctor --provider ollama
localagent doctor --provider lmstudio
localagent doctor --provider llamacpp
启用信任控制
localagent --trust on --provider ollama --model llama3.2 chat --tui
仅当您有意想要副作用时，才启用shell和编写工具。
CLI注释
全球旗帜出现在子命令之前。请参阅上述示例和 CLI参考 获取完整的命令语法。
安全模型
LocalAgent旨在明确副作用。
- 除非明确启用，否则禁用shell和写访问
--allow-shell-in-workdir是一种比--allow-shell- 信任模式可以强制执行策略和审批
- 持久运行仍然可以通过工件和日志进行检查
我们的目标不是消除所有限制。这是为了使本地代理在不隐藏风险的情况下可用。
提供商设置
在运行LocalAgent之前，请启动受支持的本地提供程序，并确保模型可用。
请参阅： 提供商设置
安装
从源代码构建
cargo build --release
二进制输出：
- 窗户：
target/release/localagent.exe - Linux/macOS：
target/release/localagent
从源代码全局安装
cargo install --path . --force
发布
预构建的二进制文件可在GitHub版本中获得。
有关完整安装、更新、Windows疑难解答和验证步骤，请参阅：
文档
入门
运行时内部
运行时策略
附加文档
贡献
欢迎提出问题、反馈和意见。
从这里开始：
许可证
麻省理工学院
