Update: 将子项目从 submodule 转为完整内容

- 移除 GovAI, nomifun-tauri, 算力盒子的 submodule 引用 - 添加所有子项目的完整源代码 - 保留原始 .git 为 .git.bak 备份
2026-07-04 19:20:46 +08:00
parent 54d6465fa7
commit f7a720204a
3360 changed files with 802660 additions and 3 deletions
@@ -0,0 +1,82 @@
+# Quick Start
+
+A short walkthrough for the first useful NomiFun session. This assumes the repo
+is already installed; otherwise start with [Installation](installation.md).
+
+## 1. Launch
+
+Desktop development:
+
+```bash
+bun run dev
+```
+
+The desktop shell starts the backend on a private loopback port and injects a
+local trust token into its own webview. There is no desktop login screen.
+
+Web server:
+
+```bash
+bun run serve:web
+# open http://127.0.0.1:8787
+```
+
+The web host requires login by default. On a fresh data directory, the first
+visitor creates the initial admin unless you pre-seed `NOMIFUN_ADMIN_PASSWORD`.
+
+![First-run admin setup](../images/gs-04-quickstart-login.png)
+
+## 2. Start From `/guid`
+
+After auth, the app opens `/guid`. This is the default session start surface.
+
+You can choose:
+
+- an agent/runtime,
+- a model/provider when the runtime supports it,
+- an assistant persona,
+- skills or MCP tools,
+- a workspace path,
+- and the first prompt.
+
+![The /guid landing page](../images/gs-05-quickstart-guid.png)
+
+## 3. Configure A Model
+
+Open **Models** (`/models`) and configure at least one provider or detected CLI
+agent. The page owns provider credentials, agent availability, and global
+reliability settings such as IDMM and model failover.
+
+![Model settings](../images/gs-06-quickstart-model-settings.png)
+
+For the simplest first run, use the built-in Nomi engine with an API provider
+you have credentials for. External CLIs such as Claude Code, Codex, Gemini CLI,
+Qwen, and OpenCode must also be installed on the host before NomiFun can use
+them.
+
+## 4. Send The First Message
+
+Back on `/guid`:
+
+1. Choose an agent.
+2. Choose a model if required.
+3. Optionally choose an assistant.
+4. Type a prompt.
+5. Send with the button or `Ctrl/Cmd+Enter`.
+
+NomiFun creates a conversation and navigates to `/conversation/<id>`.
+
+## 5. Use The Workspace
+
+Each conversation can use a working directory. Inside a conversation you can
+inspect messages, tool calls, file edits, previews, and terminal sessions.
+
+Useful next pages:
+
+- [Terminal](../guides/terminal.md)
+- [MCP & Skills](../guides/mcp-and-skills.md)
+- [Assistants](../guides/assistants.md)
+- [AutoWork & Requirements](../guides/autowork-requirements.md)
+- [Scheduled Tasks](../guides/scheduled-tasks.md)
+- [Web Server Deployment](../guides/web-server-deployment.md)
+- [Architecture Overview](../architecture/overview.md)