- 移除 GovAI, nomifun-tauri, 算力盒子 的 submodule 引用 - 添加所有子项目的完整源代码 - 保留原始 .git 为 .git.bak 备份
3.9 KiB
简介
NomiFun 是一个面向 AI agent 工作流的本地优先工作台。它把多种 CLI agent、内置 Nomi 引擎、模型提供商、MCP 服务、技能、终端、计划任务 和远程 WebUI 收拢到同一个 Rust + Tauri monorepo 中。
想立刻开始?请先读 安装,再读 快速上手。完整文档地图见
../README.zh.md。
它解决什么问题
真实的 AI 工作流经常被拆散在多个地方:一个终端跑 Claude Code,一个终端跑 Codex,浏览器里开着自托管页面,旁边还有单独的 MCP 服务和项目脚本。 NomiFun 的目标不是再做一个聊天框,而是把这些运行时接到同一个工作区:
- 一个会话入口,多种 agent。 会话可以选择内置 Nomi、Claude Code、 Codex、Gemini、Qwen、OpenCode、CodeBuddy 等后端。
- 一个模型目录,多处复用。 在
/models配好 Anthropic、OpenAI、 Bedrock、Vertex 或兼容接口后,支持这些模型的 agent 和助手可以复用。 - 一个工作区,不只是消息流。 会话有工作目录、文件树、预览面板和后端 管理的 PTY 终端。
- 后端驱动的自动化。 计划任务、AutoWork、IDMM、WebUI 远程访问、 MCP 暴露和频道能力都由 Rust 后端持久化管理。
- 桌面与 Web 共用后端。 Tauri 桌面端和
nomifun-web自托管服务使用 同一套nomifun-app后端与同一份 React SPA。
NomiFun 更适合已经在用 agent 做真实工作的用户。它要求你理解 API key、 本地数据目录、CLI agent 安装和自托管边界;它不是零配置的 SaaS 聊天产品。
两种运行方式
| 模式 | 二进制 | 鉴权模型 | 典型用途 |
|---|---|---|---|
| 桌面应用 | nomifun-desktop |
桌面外壳使用本地信任 token 访问嵌入式后端;远程浏览器仍需登录 | 单机工作站、日常开发 |
| Web 服务 | nomifun-web |
默认开启登录;首次访问创建管理员 | LAN/VPN/VPS 自托管 |
桌面模式会在进程内启动 nomifun-app,监听一个随机 localhost 端口,并通过
每次启动生成的本地信任 token 让 WebView 免登录访问。WebUI 远程访问打开后,
额外的 LAN 监听器仍然要求远程浏览器登录。
nomifun-web 则在一个端口上同时提供 SPA 与 API,默认端口是 8787。Docker
和 systemd 部署都走这条路径。
当前功能地图
- 会话与工作区:
/guid创建会话,/conversation/:id运行会话。 - 模型配置:
/models管理提供商、模型、凭据和全局故障转移队列。 - 助手与技能:
/assistants管理助手;其中tab=skills管理技能。 - MCP:
/mcp管理 MCP server、连接测试、OAuth 和 agent 配置同步。 - 开放能力:
/open-capabilities管理 WebUI 远程访问、MCP/API 暴露等外部入口。 - 桌面伙伴:
/nomi管理伙伴、远程频道绑定和 companion 相关设置。 - 终端:
/terminal-new创建、/terminal/:id运行后端 PTY。 - 计划任务:
/scheduled管理 cron 触发的会话任务。 - AutoWork:
/requirements管理需求看板和自动执行。
更多内部结构见 ../architecture/,用户指南见
../guides/。
项目状态
NomiFun 仍在活跃开发中,但已经不是旧的 Electron 多仓迁移状态。当前仓库是
Rust workspace + Tauri desktop + Web host 的单仓结构。顶层
../../STATUS.md 记录当前状态;历史设计稿与审计记录不在
仓库中保留,需要时请查阅 git 历史。
