freedak
f7a720204a
- 移除 GovAI, nomifun-tauri, 算力盒子 的 submodule 引用 - 添加所有子项目的完整源代码 - 保留原始 .git 为 .git.bak 备份
74 lines
3.9 KiB
Markdown
74 lines
3.9 KiB
Markdown
# 简介
|
||
|
||
**NomiFun** 是一个面向 AI agent 工作流的本地优先工作台。它把多种
|
||
CLI agent、内置 Nomi 引擎、模型提供商、MCP 服务、技能、终端、计划任务
|
||
和远程 WebUI 收拢到同一个 Rust + Tauri monorepo 中。
|
||
|
||
> 想立刻开始？请先读 [安装](installation.zh.md)，再读
|
||
> [快速上手](quick-start.zh.md)。完整文档地图见 [`../README.zh.md`](../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/`](../architecture/)，用户指南见
|
||
[`../guides/`](../guides/)。
|
||
|
||
## 项目状态
|
||
|
||
NomiFun 仍在活跃开发中，但已经不是旧的 Electron 多仓迁移状态。当前仓库是
|
||
Rust workspace + Tauri desktop + Web host 的单仓结构。顶层
|
||
[`../../STATUS.md`](../../STATUS.md) 记录当前状态；历史设计稿与审计记录不在
|
||
仓库中保留，需要时请查阅 git 历史。
|
||
|
||
## 接下来
|
||
|
||
- [安装](installation.zh.md)
|
||
- [快速上手](quick-start.zh.md)
|
||
- [开发环境](../contributing/development.zh.md)
|
||
- [Web 服务部署](../guides/web-server-deployment.zh.md)
|