Flocculeasianhorseshoecrab213/shellforge
GitHub: Flocculeasianhorseshoecrab213/shellforge
一个在本地 Windows 环境中运行私有 AI 代理的单二进制工具,保护隐私并提供可控的自动化能力。
Stars: 0 | Forks: 0
# 🤖 shellforge - 在本地运行私有 AI 代理
[](https://github.com/Flocculeasianhorseshoecrab213/shellforge/releases)
## 🚀 shellforge 的功能
shellforge 帮助你在自己的 Windows 电脑上运行本地 AI 代理。它保护你的工作隐私,并让你控制代理的行为方式。
它围绕以下组件构建:
- Ollama 用于本地模型使用
- AgentGuard 用于策略控制
- OpenShell 用于命令操作
- DefenseClaw 用于安全检查
当你希望使用时:
- 在你的机器上本地运行的 AI
- 清晰控制代理可以做什么
- 适合日常使用的简单设置
- 减少对云工具的依赖
## 📥 下载 shellforge
访问此页面以下载 Windows 版本的 shellforge:
[从 GitHub 发布版下载](https://github.com/Flocculeasianhorseshoecrab213/shellforge/releases)
在发布页面中:
1. 打开最新的发布版本
2. 下载 Windows 文件
3. 将其保存到你的电脑
4. 运行该文件以开始安装或启动应用
如果浏览器请求权限,请在你信任来源并希望继续时选择“保留”或“运行”
## 🖥️ Windows 安装
shellforge 面向希望使用具有简单启动流程的本地应用的 Windows 用户。
在安装之前,请确保你的电脑具备以下条件:
- Windows 10 或 Windows 11
- 至少 8 GB 内存
- 5 GB 可用磁盘空间
- 首次下载需要互联网连接
- 如果 Windows 提示,需要管理员权限
要安装:
1. 进入发布页面
2. 下载最新的 Windows 构建版本
3. 打开你下载的文件
4. 按照屏幕上的步骤操作
5. 让 Windows 完成安装
6. 从开始菜单或应用文件夹启动 shellforge
如果 Windows 显示安全提示,请在检查文件来源后选择允许继续的选项
## 🛠️ 首次运行
当你第一次打开 shellforge 时,准备本地服务可能需要一些时间。
请先执行以下操作:
1. 打开应用
2. 等待它检查本地 AI 支持
3. 让它连接到 Ollama(如需要)
4. 查看默认代理规则
5. 从一个小任务开始
适合的新手任务:
- 让代理起草一条笔记
- 让它整理一个文本文件
- 让它解释一个文件夹中的文件
- 让它打开一个安全的本地命令
如果你已经使用 Ollama,shellforge 可以集成到你的现有设置中并使用你的本地模型路径
## 🔒 安全与控制
shellforge 专为受控使用而构建。这意味着它会尽量将代理操作限制在明确的范围内。
它使用以下安全层来提供帮助:
- 命令审查
- 本地策略检查
- 工具访问控制
- 对高风险步骤的操作限制
这使 shellforge 成为希望在本地使用 AI 而不失去系统控制的用户的合适选择
## 🧩 核心组件
这些组件在 shellforge 内部协同工作:
- Ollama:在你的电脑上运行本地模型
- AgentGuard:根据规则检查代理操作
- OpenShell:处理 Shell 和命令操作
- DefenseClaw:为操作添加安全层
- 本地代理循环:规划、检查并在你的机器上运行任务
你不需要手动设置每个组件即可正常使用。shellforge 会为最终用户保持流程简单
## 📁 你得到的内容
一个典型的 shellforge 发布版包括:
- 主要的 Windows 应用
- 本地代理支持
- 首次启动的安装文件
- 日常使用的安全默认设置
- 模型和工具访问的基础配置文件
该应用旨在在你自己的电脑上使用,而不是作为共享的云服务
## ⚙️ 常见使用场景
使用 shellforge 执行以下任务:
- 本地笔记起草
- 文件审查
- 简单的命令帮助
- 私有 AI 聊天
- 工作区清理
- 小型日常工作的自动化
当你希望获得 AI 帮助并让数据保留在本地时,它效果最佳
## 🧭 基本流程
一个简单的 shellforge 会话通常遵循以下流程:
1. 你输入一个任务
2. 代理读取请求
3. AgentGuard 检查代理可以做什么
4. DefenseClaw 审查高风险步骤
5. OpenShell 运行允许的命令
6. 代理返回结果
这使流程清晰且受控
## 🛠️ 故障排除
如果 shellforge 无法启动:
- 检查你是否下载了最新的 Windows 发布版本
- 尝试以管理员身份再次运行应用
- 确保 Windows 没有阻止该文件
- 确认你有足够的磁盘空间
如果应用无法访问本地 AI 支持:
- 检查 Ollama 是否已安装并正在运行
- 确保你的模型在本地可用
- 在 Ollama 启动后重新启动 shellforge
- 检查是否有其他应用使用了相同的本地端口
如果应用感觉缓慢:
- 关闭其他占用资源的应用
- 使用较小的本地模型
- 给系统更多可用内存
- 在长时间会话后重启应用
## 📝 新手友好帮助
如果你刚接触本地 AI 工具,请从小处开始:
- 使用简短的提示
- 一次只做一个任务
- 让应用完成后再给出下一个任务
- 使用你已经了解的文件
- 在采取行动前检查输出
这可以帮助你在不增加困惑的情况下了解 shellforge 的工作方式
## 🔧 建议设置以获得最佳结果
为了顺利首次运行:
- 如果可以,请使用 Windows 11
- 至少保留 10 GB 可用空间
- 使用 16 GB 内存以支持较大的本地模型
- 在打开 shellforge 之前准备好 Ollama
- 将文件存储在简单的文件夹路径中
性能更强的电脑能提供更快的响应和更多的模型选择
## 📌 项目重点
shellforge 结合了:
- 本地 LLM 使用
- 代理工作流
- 面向 Windows 的设置
- 代理操作的治理
- 以隐私为先的运行方式
- 工具使用的安全检查
它专为希望在自己机器上运行并遵循明确规则的 AI 代理而设计
## 🔗 再次下载
[访问 shellforge 发布页面以下载](https://github.com/Flocculeasianhorseshoecrab213/shellforge/releases)
## 🧪 示例任务
尝试使用 shellforge 执行以下任务:
- 在测试文件夹中整理文件
- 从粘贴的文本中撰写简短摘要
- 检查文件名列表
- 打开本地文件并解释其内容
- 从笔记创建简单的待办计划
在了解代理在你的电脑上的行为之前,请从低风险任务开始
## 📍 包详情
- 仓库:shellforge
- 平台重点:Windows
- 本地 AI 栈:Ollama
- 治理层:AgentGuard
- Shell 工具层:OpenShell
- 安全层:DefenseClaw
- 主要目标:私有本地代理使用
标签:AgentGuard, AI代理, AI风险缓解, DefenseClaw, EVTX分析, Go语言, LLM评估, Ollama, OpenShell, Windows AI, 个人计算, 云模型, 单二进制, 命令执行, 安全沙箱, 日志审计, 服务枚举, 本地AI, 本地模型, 离线AI, 私有AI, 程序破解, 策略控制, 简易安装, 终端安全, 网络安全, 网络安全, 软件发布, 隐私保护, 隐私保护