Skip to content
 
 

Repository files navigation

OpenMinis-PC

License: GPL v3 Platform Release Build Status

⚠️ 特别声明 / Disclaimer
备注:OpenMinis Windows 体验版
本项目为基于 OpenMinis 官方核心哲学针对 Windows 桌面操作系统 的全功能移植与深度加固版本,融合了 Hermes AgentAionUi (OpenClaw) 的前沿设计,仅供个人技术研究与实验性探索使用。


🌟 什么是 OpenMinis-PC?

你的桌面私有端侧 AI 智能体(Your private, on-device AI agent for Windows)。

它绝不是又一个平庸的网页套壳聊天框,而是真正给大模型一台电脑让它为你干活

OpenMinis-PC 将主流大模型供应商和本地 Ollama 接入 Windows 桌面体验。它提供独立的 Alpine Linux 隔离沙箱,让 Agent 可以安装软件包、运行 Python/Shell 脚本、通过系统 Edge Headless 抓取网页与生成截图、在模型故障时按模型组回退,并在本地保存会话、记忆和技能。MCP 当前提供服务器配置管理,执行协议栈仍在开发中。

完全开源,零多余依赖,极度轻量。


🎯 核心功能特性 (What It Does)

核心维度 功能说明
自备任意模型 (BYOM) 支持添加任意 OpenAI 兼容供应商(DeepSeek、OpenAI、Claude、硅基流动、本地 Ollama 等),支持一键自动拉取模型列表。
真实 Linux 沙箱 基于 Windows 原生 WSL2 的轻量 Alpine Linux 沙箱,Agent 以非特权用户隔离运行,可 pip install --user、运行 Python、生成与处理文件;系统包安装仅限宿主修复流程。
模型组自动容灾 (Fallback) 对齐原版 Model Groups 的主模型与备选队列;主模型遇到限流或请求错误时尝试组内后备模型。
深度思考模式 (Thinking) 支持常见的 reasoning_contentreasoning_effort 接口,带思考计时、折叠显示和强度设置。
Edge Headless 网页工具 调用系统 Microsoft Edge 抓取渲染后 DOM、提取正文和生成网页截图;.35 起升级为常驻 CDP 实例,支持持久 Cookie 登录态与连续操作同一页面;交互式 click/type/scroll 与用户接管(真实窗口)仍在开发中。
原生终端与 SSH 运维 自动化脚本支持 sshpass 批量操作;需要交互输入密码或运行 Vim/Htop 时,一键无缝唤起系统级 Windows Terminal (wt.exe)。
真实 Token 用量统计 1:1 原版仪表盘:精确统计总输入 (含缓存)、输出 Token、缓存读取量与命中率,按模型展示历史消耗排行榜。
图文混排与多模态文件 支持从 Windows 资源管理器直接拖拽文件/图片进入窗口,支持 Ctrl+V 粘贴截图,支持文字与附件一同联合发送。
持久化记忆与跨会话回忆 每日日志 (YYYY-MM-DD.md) + 全局记忆 (GLOBAL.md) 双层穿透检索;会话完整独立存储,支持点击历史一键恢复对话。
MCP 服务器配置 支持保存和启停 Stdio / SSE / HTTP 服务器配置;MCP 客户端连接、工具发现与 Agent 动态注册尚在开发中。

💡 你可以用 OpenMinis-PC 做什么?

  • 自动化网络深度研报:让 Agent 自动使用 Edge 浏览器遍历多篇网页、分析提取数据、生成对比图表并保存至沙箱工作区。
  • 批量服务器运维与排查:让 Agent 编写运维脚本,通过内置 SSH 工具链批量连接 VPS 检查网络延迟、服务状态并汇总报告。
  • 代码重构与本地测试:直接拖入 Python、TypeScript 或 C++ 代码文件,让 Agent 在隔离沙箱中安全运行测试、排查 Bug 并输出修复后的文件。
  • 定时任务实验功能:可保存计划并在应用运行期间触发事件;完整无人值守执行、重试和任务结果归档仍在完善。
  • 高复杂问题深度推演:开启 High/Max 思考强度,调用 DeepSeek-R1 或 o3 等推理模型,展开完整思考链卡片查看推演全过程。

🛠️ 相比原版移动端与市面客户端的独家改进

1. 拒绝 Electron:极轻量的 Tauri v2 原生架构

  • 发布资产由 GitHub Actions 生成,实际体积以 Releases 页面为准;
  • Tauri 复用系统 WebView2,不捆绑独立 Chromium;
  • 后台进程均使用无控制台窗口方式启动,减少黑框闪现。

2. 严苛的零信任沙箱安全隔离

  • Agent 以非特权沙箱用户执行(非 root),内核级禁止挂载 Windows 宿主盘(mount -t drvfspermission denied);
  • 沙箱 /etc/wsl.conf 默认禁用自动挂载与 Interop;宿主导出仅限宿主侧授权目录(.openminis 与用户配置挂载),挂载点固定于 /var/minis/
  • 执行前路径校验 + 符号链接解析检查,文件工具仅可访问 /var/minis/;每次 Agent 轮次前置隔离门禁,检测到漂移即拒绝执行并提示一键修复;
  • 文件写入使用 stdin 流式管道,避免命令行长度限制和 WSL UNC 休眠阻塞;
  • 引入并发调度互斥锁与单轮 20 次工具死循环熔断保护。

3. 官方设计语言与 Windows 交互适配

  • 彻底洗净廉价“AI 模板味”,采用原版纯黑(#000000)高质感底色;
  • 去除所有大机器人头像,保留 Assistant 纯净左对齐排版与 User 原生气泡;
  • 原版 ToolCapsuleView 极简单行胶囊与 ChatInputBar 原版经典向上发送键 (arrow.up.circle.fill)。

📦 下载与快速开始

1. 下载可执行文件 (GitHub Releases)

所有安装包均通过 GitHub Actions 自动化流水线安全构建:

👉 前往 GitHub Releases 查看与下载最新版本 (v1.13.0.41)

安装包文件 大小 说明 快速直链
OpenMinis_1.13.0.41_x64-setup.exe ~3.8 MB 标准安装向导版(强烈推荐) 点击直接下载
OpenMinis_1.13.0.41_x64_en-US.msi ~5.5 MB Windows 原生 MSI 安装程序 点击直接下载
openminis-windows-v1.13.0.41.exe ~15.1 MB 绿色单文件便携免安装版,双击即跑 点击直接下载

2. 沙箱初始化 (仅首次使用)

  • 方式 A(普通用户,推荐):打开 OpenMinis,若顶部状态显示 Sandbox Not Ready,点击该状态进入 RootFS / 沙箱设置,点击 【一键全自动配置沙箱】
    • 若系统尚未启用 WSL2:应用会弹出 UAC 请求启用 WSL2 + 虚拟机平台;同意后必须重启电脑
    • 重启后再次打开 OpenMinis,应用会自动继续完成 Alpine 镜像导入、隔离加固与工具安装(约 20 秒),无需再次操作。
  • 方式 B(WSL 未启用,手工方式):以管理员身份打开 PowerShell 执行:
    wsl --install --no-distribution
    重启电脑,然后打开 OpenMinis 点击【一键全自动配置沙箱】完成导入。
  • 方式 C(开发者,已克隆仓库):在仓库根目录执行(需先确保已启用 WSL2,见方式 B):
    powershell -ExecutionPolicy Bypass -File .\src\windows\scripts\init_wsl_sandbox.ps1

说明:从 Releases 安装的 EXE / MSI / 便携版不包含仓库源码,因此方式 C 的 src\windows\scripts\... 路径仅对克隆仓库的开发者有效。


🙏 致谢与致敬 (Acknowledgements)

站在巨人的肩膀上,特别向以下优秀的开源先驱致以崇高的敬意与由衷感谢:

  • OpenMinis(原作者团队及贡献者):感谢创造了卓越的端侧 AI Agent 核心架构理念与克制优雅的设计范式。
  • Nous Research(Hermes Agent 团队):感谢启发了跨会话回忆、自主学习持久记忆循环及优雅的交互规范。
  • iOfficeAI Team(AionUi / OpenClaw 团队):感谢在多 Agent 协同、24/7 无人值守 Cron 调度与办公工具集成方面的宝贵开源探索。
  • Tauri Apps Team:感谢提供极致轻量、安全、高效的跨平台桌面应用开发底座。
  • Alpine Linux & Microsoft WSL2:感谢提供精简可靠的 Linux Minirootfs 与 Windows 原生轻量虚拟化技术。

开发与版本

本项目遵循 GNU General Public License v3.0 (GPLv3) 开源协议。所有改动完全开源透明,尊重并严格传承上游所有开源组件之授权协议。

About

OpenMinis-PC: 真正的 Windows 私有端侧 AI 智能体 (Tauri v2 + WSL2 Alpine 沙箱 + 模型组 Fallback + Edge 真实渲染 + Token 统计)

Resources

Contributing

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages