Skip to content
Back to search

OmniSpace

本地优先的全栈 AI 创作工作站:AI对话 · AI漫画 · 漫剧创作 · 写作台 · 知识学习五大模块;vLLM / llama.cpp / Transformers 多引擎本地推理,显存智能调度、舱壁隔离自愈、仅供学习使用,欢迎交流指正。(最新进度(除插件系统)受到协议限制,暂时无法提交到仓库)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yzw202011--omnispace/badge.svg)](/listings/yzw202011--omnispace)

HTML

<a href="/listings/yzw202011--omnispace"><img src="/api/listings/yzw202011--omnispace/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 394 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # 🚀 OmniSpace AI v2.5.0
  3. **本地优先的全栈 AI 漫剧创作工作站**
  4. <p align="center">
  5. <a href="#-界面预览">界面预览</a> •
  6. <a href="#-核心特性">核心特性</a> •
  7. <a href="#-技术栈">技术栈</a> •
  8. <a href="#-快速开始">快速开始</a> •
  9. <a href="#-内部开发流程">内部开发流程</a> •
  10. <a href="#-路线图">路线图</a>
  11. </p>
  12. <p align="center">
  13. <img src="https://img.shields.io/badge/Python-3.12.10-blue?logo=python" alt="Python">
  14. <img src="https://img.shields.io/badge/React-19.0-61dafb?logo=react" alt="React">
  15. <img src="https://img.shields.io/badge/FastAPI-0.141.1-009688?logo=fastapi" alt="FastAPI">
  16. <img src="https://img.shields.io/badge/PyTorch-2.13_cu130-ee4c2c?logo=pytorch" alt="PyTorch">
  17. <img src="https://img.shields.io/badge/vLLM-0.27.1-7c3aed" alt="vLLM">
  18. <img src="https://img.shields.io/badge/license-Proprietary-red" alt="License">
  19. </p>
  20. > 💡 **对话 × 漫画 × 漫剧 × 写作 × 知识学习**
  21. > 默认全部推理在 **本地 GPU** 完成;如需更强模型,可自带 Key 选接云端 API(明确标注、可关闭)
  22. >
  23. > 🆕 **2026-09-19 大版本功能周**:六批共 26 项功能更新上线
  24. > 全页面新手引导、上游变更过期标记、功能舱壁隔离与自愈阶梯、恢复指南与安全模式、
  25. > 删除分级确认、存储清理中心、硬件健康中心、操作审计、备份加密、断电自恢复、
  26. > 全局任务中心、Ctrl+K 全局搜索、生成物文件库、气泡五形、写作台篇幅参数与降AI味文风档。
  27. </div>
  28. ---
  29. ## 🌟 为什么 OmniSpace 值得选择
  30. 这不是又一个 AI 玩具 —— 这是一个**完整的、工程化的、可落地的本地 AI 创作平台**。
  31. | 亮点 | 说明 |
  32. |------|------|
  33. | 🎯 **真·全模态** | 文本 / 图像 / 视频 / 语音 / 知识图谱,一站式创作管线 |
  34. | 🏠 **本地优先** | 默认所有模型推理跑在你自己的 GPU 上,数据不出本机;云端 API 是可选的自带 Key 档位(页内徽标直连配置) |
  35. | ⚡ **显存调度器** | 自研显存协调器(账本/准入/单一编排),16GB 消费级显卡可跑各条创作链路(自动加载/卸载/互斥/让档,持续调优中) |
  36. | 🩺 **舱壁隔离 + 自愈阶梯** | 每个重模块(对话/绘画/视频/训练)独立健康账本,连续异常自动进入恢复阶梯(重拉引擎→验证→恢复指南+安全模式兜底);一键体检(8 项只读)+ 深度体检(27 项环境级探测)、错误必带出路指引 |
  37. | 🧹 **数据全生命周期** | 删除分级确认(轻/中/重三要素)、存储清理中心(白名单动作)、备份加密 + 每日自动备份 + 断电自恢复、操作审计日志、垃圾产物统一盘点 |
  38. | 🏗️ **工程质量高** | 376 个 HTTP 端点(对账闸实时核对)+ 4 条 WebSocket 状态通道;pytest **1132 用例**(GPU 集成显式开关)/ vitest **101 用例** / 文档对账闸 + 活后端 E2E 多层测试体系 |
  39. | 🧩 **插件式推理引擎** | vLLM / llama.cpp (GGUF) / Transformers 多后端热切换;**CuteMamen 插件系统**(子进程沙箱隔离、AST 安检、三级信任徽章、免重启热重载) |
  40. | 📚 **丰富文档** | 架构图、API 文档、部署手册、故障排查,新人友好 |
  41. ---
  42. ## 📸 界面预览
  43. <div align="center">
  44. **启动页 · 点火序列 HUD**(环境自检 → 后端服务 → 模型预热 → 就绪)
  45. <img src="docs/promo/01-splash.png" width="86%" alt="启动页"/>
  46. <br/><br/>
  47. 🎬 **[▶️ 观看演示视频 —— AI 生成漫剧成片(11 秒)](docs/promo/demo-video.mp4)**
  48. <br/>
  49. <table>
  50. <tr>
  51. <td width="50%" align="center">
  52. <img src="docs/promo/02-dialog.png" width="100%" alt="AI 对话"/><br><sub><b>AI 对话</b> · 本地多模态推理 / 流式输出 / 深度思考</sub>
  53. </td>
  54. <td width="50%" align="center">
  55. <img src="docs/promo/03-paint.png" width="100%" alt="AI 绘画"/><br><sub><b>AI 绘画</b> · FLUX.2 Klein 本地文生图 / 多比例出图</sub>
  56. </td>
  57. </tr>
  58. <tr>
  59. <td width="50%" align="center">
  60. <img src="docs/promo/04-paint-viewer.png" width="100%" alt="出图效果"/><br><sub><b>出图效果</b> · 2688×1536 高清成图</sub>
  61. </td>
  62. <td width="50%" align="center">
  63. <img src="docs/promo/05-manga-projects.png" width="100%" alt="漫剧创作"/><br><sub><b>漫剧创作</b> · 从剧本到成片的工作台</sub>
  64. </td>
  65. </tr>
  66. <tr>
  67. <td width="50%" align="center">
  68. <img src="docs/promo/06-storyboard.png" width="100%" alt="分镜编辑器"/><br><sub><b>分镜编辑器</b> · 角色/场景/道具资产 + 四视图一致性</sub>
  69. </td>
  70. <td width="50%" align="center">
  71. <img src="docs/promo/07-learning.png" width="100%" alt="知识学习"/><br><sub><b>知识学习</b> · AI 自主学习 + 知识库 RAG</sub>
  72. </td>
  73. </tr>
  74. <tr>
  75. <td width="50%" align="center">
  76. <img src="docs/promo/08-models.png" width="100%" alt="模型管理"/><br><sub><b>模型管理</b> · 本地模型装载 / 显存监控 / 就绪体检</sub>
  77. </td>
  78. <td width="50%" align="center">
  79. <img src="docs/promo/09-settings.png" width="100%" alt="设置"/><br><sub><b>个性化</b> · 双主题族 × 亮暗模式</sub>
  80. </td>
  81. </tr>
  82. <tr>
  83. <td width="50%" align="center">
  84. <img src="docs/promo/10-logs.png" width="100%" alt="系统日志"/><br><sub><b>系统日志</b> · 大白话事件时间线 + 异常聚合</sub>
  85. </td>
  86. <td width="50%" align="center">
  87. <img src="docs/promo/11-help.png" width="100%" alt="帮助"/><br><sub><b>帮助中心</b> · 功能总览 + 新手五步上手</sub>
  88. </td>
  89. </tr>
  90. </table>
  91. </div>
  92. ---
  93. ## ✨ 核心特性
  94. ### 🎨 AI 漫画(Comic)
  95. - **参考图角色一致性**:角色参考图锚定跨格统一(角色 LoRA 当前接入漫剧关键帧链;漫画分格链接入见未完成清单)
  96. - **四视图生成**:角色设定图一键出三视图/四视图
  97. - **AI 写分格**:从剧本文本自动划分漫画格(2/4/6/8/12 格可选)
  98. - **台词气泡五形**:💬对话 / 🎬旁白 / 💭思考 / 💥喊叫 / 🤫低语 五种形状一键切换,拖拽定位 + 把手拉伸宽度,导出成册同步烘入
  99. - **资产库**:角色 / 场景 / 道具三页签,支持上传与 AI 生成、批量删除、SAM AI 抠图
  100. - **大图预览**:分格图与资产卡单击放大灯箱、右击直接下载原图
  101. - **整页导出与阅读预览**:PNG 长图 / PDF 每格一页 / PDF 2×2 拼版
  102. ### 🎬 AI 漫剧(Manga)
  103. - **分镜编辑器**:剧情 → 分镜 → 资产 → 关键帧 → 视频 → 成片全链路,五步工序条实时联动
  104. - **多角色一致性**:跨镜形象统一(双硬锁并发保护 + 角色 LoRA 身份锁)
  105. - **上游变更过期标记**:改描述词 / 换画风 / 更新资产后,受影响的旧图自动亮「已过期」角标,一键批量重生成
  106. - **视频生成**:主力 MiniMax H3 多镜链式生成(本地 ComfyUI 推理),Wan2.2-ti2v-5b 图生视频补档;视频队列排队/取消/进度可视
  107. - **生成记录**:图片与视频双页签,成功/失败/耗时/模型/seed 全字段留痕,失败一键重试
  108. - **镜头语言结构化**:A/B/C 三段式提示词 + 中文导演运镜 + 台词行 + AI 提示词自定义注入
  109. - **风格包**:30 个预置视频/画风风格包,一键套用,自定义风格包导入
  110. - **资产库管理**:角色、场景、道具系统化管理(描述词生成/AI 抠图/音色绑定/转全局跨项目复用)
  111. ### 💬 AI 对话(Dialog)
  112. - 多引擎本地对话(vLLM / llama.cpp GGUF / Transformers,按显存自动路由)
  113. - 流式输出(WebSocket 实时帧推送),打字机效果
  114. - 深度思考双通道(推理过程与正文分离呈现)
  115. - 上下文记忆 + 知识库 RAG(可调温度 / 上下文长度,随模型能力自动适配附件入口)
  116. - 图片(多图对比理解)与文档(txt/md/docx/pdf)上传,插件技能即焚注入
  117. - 排队不秒拒、自动降级明示(装不下的模型自动换档并提示)
  118. - 会话管理:重命名/置顶/搜索/批量删除/消息评分反馈
  119. ### ✍️ 写作台(Novel)
  120. - **篇幅规划三参数**:计划章数 / 每章目标字数 / 卷数——大纲出纲与正文生成真实吃参数(附快捷档一键填)
  121. - **降AI味文风三档**:标准 / 拟真·轻 / 拟真·重(低频词、禁模板比喻、情感层次、句长错落、人物语气区分),同章可对照
  122. - **AI 大纲树**:灵感 → 卷/章细纲,逐节点可改可删,重新生成带覆盖确认
  123. - **生成未完成章节**:批量补缺不覆盖已完成,队列可视可取消
  124. - **角色 / 伏笔 / 世界观**:AI 设计角色吃补充要求、伏笔烂尾预警、世界观导入知识库联动正文
  125. - **整本导出** TXT / MD,批量删除作品
  126. ### 🧠 知识学习(Learn)
  127. - 文档 / 图片自动向量化入库(多道入库质检闸)
  128. - RAG 检索增强生成(向量 + FTS5 全文 + RRF 融合)
  129. - 知识图谱可视化,知识库批量删除 + 图片知识管理
  130. - 浏览器代理自主上网学习(AI 控制 ↔ 用户接管即时切换)
  131. - **学习分析报表**:效率/来源/趋势/主题对比,实时轮询刷新
  132. - **学习配额可设置**:知识库容量上限自定义,接近上限预警
  133. - 行为学习微调(操作偏好沉淀,手动触发)
  134. ### 🔊 语音能力(Voice)
  135. - TTS 文字转语音(Windows SAPI5 本地语音)+ Whisper 本地语音识别
  136. - 自定义音色上传(wav/mp3/flac/m4a ≤20MB),已内置于漫剧配音链路
  137. - AI 声音克隆为规划中功能(本地开源栈调研阶段)
  138. ### 🧩 插件系统(Plugins)
  139. - **CuteMamen 包格式**:自包含 tar.gz(manifest + 权重 + 三级记忆),支持纯数据档与含源码档
  140. - **分级安全模型**:出厂件(进程内·已审查)/ 用户纯数据(进程内)/ 用户含源码(**子进程沙箱**——超时硬杀、内存上限、崩溃不连坐后端)
  141. - **导入链**:AST 静态安检 + 大白话确认门 + 试装载 + 失败清场
  142. - **信任徽章**:三档可视化(蓝盾出厂/绿库纯数据/橙盾含源码)
  143. - **产品接线**:对话/小说/漫画三端技能插座(chat/novel/comic skill;出厂技能面为空——宁缺毋滥)、Rust 编译错误分类(演示件)
  144. ### 🖥 系统与运维
  145. - **新手引导 + 快捷键**:十个功能页统一引导(首访自动弹 / 悬浮?随时重看);Ctrl+K 全局搜索(七类目标一处搜)、Alt+数字切模块、Alt+N 新建对话
  146. - **全局任务中心**:跨模块任务统一排队 / 取消 / 进度(顶栏铃铛直达),通知历史留痕可回看
  147. - **生成物文件库**:图片 / 关键帧 / 视频 / 导出件一处浏览下载,灯箱预览
  148. - **存储清理中心**:磁盘占用盘点 / 白名单一键清理 / 备份文件管理
  149. - **硬件健康中心**:显存 / 内存 / 温度 / 磁盘四仪表三色预警 + 硬件自检(驱动版本 / 外部模型可达性)
  150. - **操作审计日志**:删除 / 导出 / 设置变更 / 云端连接 / 激活解绑全留痕可查
  151. - **数据安全底座**:备份加密(AES-GCM)+ 每日自动备份 + 断电自恢复(挂死任务清扫)+ 密钥保险箱(云端 Key 加密存放、日志与诊断包脱敏)
  152. - **睡眠保护**:生成 / 训练持锁期间自动阻止系统睡眠,结束即恢复
  153. - **删除分级确认**:轻 / 中 / 重三级模板(删什么 / 留什么 / 可否反悔三要素),全应用统一
  154. ---
  155. ## 🛠 技术栈
  156. | 层级 | 技术 |
  157. |------|------|
  158. | **前端** | React 19.0 + TypeScript + Vite 6 + Tailwind CSS v4 + Zustand 5 + React Router 7(Hash 路由,六主题族可切换) |
  159. | **后端** | FastAPI 0.141.1 + Pydantic v2 + uvicorn(Python 3.12.10 嵌入式 runtime) |
  160. | **AI 推理** | PyTorch 2.13 (cu130) + Diffusers + Transformers;对话引擎 vLLM 0.27.1 子进程(py313)与 llama.cpp GGUF / Transformers 热切换 |
  161. | **数据库** | SQLite (WAL) + ChromaDB + FTS5 全文检索 |
  162. | **存储加密** | AES-256-GCM 字段级加密(对话正文/行为日志)+ DPAPI 密钥保护 |
  163. | **交付形态** | launcher 守护进程 + 系统浏览器 / 内嵌 WebView 壳(设置页可选);Tauri 已于 2026-08-20 经 [ADR-002](docs/ADR-002-tauri-shell-decision.md) 裁剪 |
  164. | **测试** | pytest(1132 用例,GPU 集成显式开关)+ vitest(101 用例)+ 活后端 E2E 流程编排 |
  165. | **代码质量** | ruff + mypy 基线闸(只增不减)+ 文档对账闸(doc_claims.json 哨兵)+ pre-commit 五步闸 |
  166. ---
  167. ## 📁 项目结构
  168. ```
  169. OmniSpace/
  170. ├── src/ # 后端 + 内核统一扁平包(原 src/ + DistributedFormer 内核)
  171. │ ├── api/ # 路由层(dialog / comic / manga / novel / learn / models …)
  172. │ ├── services/ # 业务层 + 推理引擎 + 模型管理(含 Transformers 后端)
  173. │ ├── engines/ # 资源层(GPU / VRAM / 内存管理)
  174. │ ├── data/ # 存储层(DB / 向量 / 全文 / 图谱 / 加密)+ Rust 训练语料
  175. │ ├── middleware/ # 横切层(错误处理 / 限流 / 互斥锁 / CORS)
  176. │ ├── core/ # 内核层:DistributedFormer 脉冲主模型(CubeGPT)
  177. │ ├── cutemamen/ # 内核层:CuteMamen 插件内核(路由/生命周期/三级记忆/包格式)
  178. │ ├── codec/ # 内核层:脉冲 / 多模态编解码
  179. │ └── training/ # 内核层:主模型 → 插件 知识迁移读出层
  180. ├── plugin/ # CuteMamen 插件包(.CuteMamen,自包含:manifest+权重+记忆)
  181. ├── frontend/ # React SPA
  182. ├── launcher/ # 启动守护进程(自检/端口/心跳/重启/启动页)
  183. ├── docs/ # 完整文档(含 AGENTS.md / CLAUDE.md)
  184. ├── tools/ # 构建与诊断脚本(第三方工具树不入库)
  185. └── tests/ # tests/unit 单元测试 + E2E 流程编排
  186. ```
  187. ---
  188. ## 🚀 快速开始
  189. ### 前置要求
  190. - Windows 10/11
  191. - NVIDIA GPU(≥ 16GB 显存 = 完整体验档;12GB = 降级体验档,自动走降级链)
  192. - CUDA 12.x
  193. - ≥ 50GB 磁盘空间(模型文件)
  194. ### 启动
  195. ```powershell
  196. # 进入项目目录(公开仓库)
  197. cd E:\OmniSpace
  198. # 方式一:双击 启动OmniSpace.bat(免黑窗可用桌面快捷方式)
  199. # 方式二:命令行启动(需先配置模型文件,详见部署手册)
  200. runtime\py312\python.exe launcher\launcher.py
  201. ```
  202. 浏览器会自动打开 `http://127.0.0.1:8765`
  203. > 端口说明:launcher 默认 `--port 8765`(冲突时先清理残留进程,再扫描 5800–5835 递进);
  204. > 开发模式直接跑 uvicorn 时用 `config.yaml` 里的 5800。
  205. ### 开发模式
  206. ```powershell
  207. # 后端(端口 5800)
  208. runtime\py312\python.exe -m uvicorn src.main:app --reload
  209. # 前端(端口 5173,自动代理 API)
  210. cd frontend
  211. pnpm install
  212. pnpm dev
  213. ```
  214. ---
  215. ## 🤝 开发流程
  216. 公开仓库,仅协作开发。
  217. ### 💡 协作方向
  218. | 方向 | 适合人群 | 入门难度 |
  219. |------|---------|---------|
  220. | 🐛 **Bug 修复** | 所有人 | ⭐ |
  221. | 📝 **文档完善** | 技术写作爱好者 | ⭐ |
  222. | 🎨 **UI/UX 优化** | 前端/设计师 | ⭐⭐ |
  223. | 🔧 **新功能开发** | 全栈开发者 | ⭐⭐⭐ |
  224. | 🧠 **模型集成** | AI 算法工程师 | ⭐⭐⭐⭐ |
  225. | ⚡ **性能优化** | 资深工程师 | ⭐⭐⭐⭐ |
  226. ### 🚀 快速上手
  227. 1. **创建分支**
  228. ```bash
  229. git checkout -b feature/你的功能名
  230. ```
  231. 2. **提交更改**
  232. ```bash
  233. git commit -m "feat: 添加了什么功能"
  234. ```
  235. 3. **本地合并**(自测通过后合回 main)
  236. ```bash
  237. git checkout main && git merge feature/你的功能名
  238. ```
  239. ### 📋 上手建议
  240. 想找容易上手的任务?关注以下方向:
  241. - 前端 UI 细节优化(动画、交互、响应式)
  242. - 后端 API 补充单元测试
  243. - 文档翻译与润色
  244. - 添加更多模型支持
  245. ### 📐 代码规范
  246. - 后端:遵循 `ruff.toml` 配置,提交前跑 `ruff check`
  247. - 前端:TypeScript strict 模式,遵循项目已有代码风格
  248. - 提交信息:`feat: / fix: / docs: / refactor: / perf:` 前缀
  249. ---
  250. ## 🗺 路线图(Roadmap)
  251. > 项目处于**持续开发中**:以下清单只代表"到今天为止做了什么",不代表"做完了"。
  252. > 功能均可打磨,发现问题欢迎提 Issue / 直接动手修。
  253. ### 🧩 当前已具备的能力(不代表完成,持续打磨中)
  254. - [x] 基础架构搭建(FastAPI + React)
  255. - [x] AI 对话模块(多引擎本地推理 + RAG 混合检索 + 排队与降级明示)
  256. - [x] AI 漫画模块(参考图一致性 / 角色 LoRA / AI 分格 / 台词气泡 / 整页导出 / 资产库 / SAM AI 抠图)
  257. - [x] 漫剧创作模块(分镜→资产→关键帧→视频链路已可跑通,MiniMax H3 链式生成主力)
  258. - [x] 写作台(小说/剧本创作,剧本直通漫画与漫剧)
  259. - [x] 知识学习与 RAG(ChromaDB + FTS5 + RRF 融合,图片知识入库,学习分析报表)
  260. - [x] 显存协调器(账本/准入/编排重构)与功能互斥锁(跨线程安全)
  261. - [x] 一键体检与自愈机制(8 项只读 + 27 项深度体检、错误出路指引、崩溃取证快照、自动备份)
  262. - [x] 可选云端 API 接入(文本 / 图像可用,自带 Key)
  263. - [x] 多主题族界面(含治愈系「Dali·风花雪月」六态主题)
  264. - [x] 模型性能基准与 LoRA 版本管理(BenchmarkCard / 版本对比/回滚)
  265. - [x] 风格训练控制(暂停/恢复/取消,epoch 检查点挂起不丢进度)
  266. - [x] 插件系统 P1/P2/P3(导入/启停/删除/子进程沙箱/AST 安检/漫剧快速预览)
  267. - [x] 系统运维底座(存储清理中心 / 硬件健康中心 / 操作审计 / 备份加密 / 断电自恢复 / 密钥保险箱)
  268. - [x] 全局任务中心 + Ctrl+K 全局搜索 + 生成物文件库
  269. - [x] **功能舱壁隔离 + 自愈阶梯 + 恢复指南 + 安全模式**(单模块异常不连坐,自动修复失败给分步人话指南)
  270. - [x] **上游变更过期标记**(描述词/画风/资产变更 → 旧产物自动亮灯 + 批量重生成)
  271. - [x] **新手引导系统**(十页统一:首访自动 / 悬浮重看 / 可隐藏重启恢复)+ Alt 快捷键体系
  272. - [x] **删除分级确认规范**(轻/中/重三要素模板全应用统一)
  273. - [x] **写作台增强**(篇幅规划三参数 / 降AI味文风三档 / 作品批量删除)
  274. - [x] **漫画气泡五形形状库**(对话/旁白/思考/喊叫/低语)
  275. - [x] **学习增强**(分析报表实时轮询 / 知识库容量配额可设置)
  276. - [x] **通知历史中心**(重要提醒弹完不丢,铃铛回看)
  277. - [x] **插件热重载 + 卸载残留报告**
  278. > 注:图生 3D(TripoSR)后端管线与 3D 导演台曾实现,后者已于 2026-08-29 裁定整链路剔除;/art 视觉工具端点后端保留。上表各项均为"可运行"状态,效果与稳定性仍在迭代。
  279. ### 🔄 进行中
  280. - [ ] 联网搜索 v1(免费双通道:无头浏览器自搜 + SearXNG 自建)
  281. - [ ] 模型下载管理器(/models/download 前端接线)
  282. - [ ] 项目导入导出与备份恢复 UI
  283. - [ ] 语音克隆本地实现(开源栈调研中)
  284. - [ ] 多显卡实机验证
  285. ### 🔮 规划中
  286. - [ ] OSP↔内核插件实例合流(单实例双面服务)
  287. - [ ] 多人协作创作
  288. - [ ] 社区素材共享平台
  289. - [ ] Linux / macOS 支持
  290. - [ ] 更多模型生态接入
  291. > 💡 **有想法?直接在团队内部讨论!** 我们非常欢迎新的创意和建议。
  292. ---
  293. ## 📚 文档索引
  294. | 文档 | 内容 | 何时看 |
  295. |------|------|--------|
  296. | [部署手册](docs/deployment-manual.md) | 硬件要求、环境装配、模型配置 | 第一次部署 |
  297. | [开发者快速上手指南](docs/开发者快速上手指南.md) | **从克隆到联调/测试/提交的开发环境逐步搭建** | 第一次参与开发 |
  298. | [架构总览](docs/design/architecture-overview.md) | 分层结构、中间件链、数据流 | 理解系统设计 |
  299. | [API 端点总表](docs/design/api-endpoints.md) | HTTP / WS 端点文档(快照,增量以代码为准) | 开发对接 |
  300. | [数据库 ER](docs/design/database-er.md) | 数据库表结构与迁移说明 | 数据库相关 |
  301. | [故障排查](docs/troubleshooting.md) | OOM / 端口冲突 / 模型加载失败 | 出问题时 |
  302. | [需求追踪矩阵](docs/requirements-traceability.md) | 功能/模块/架构/工程四类需求追踪 | 查需求状态 |
  303. ---
  304. ## 📄 License
  305. 版权所有 © 2026 OmniSpace。保留所有权利(All Rights Reserved)。
  306. **本项目仅供学习使用,商业授权请+Q 3559331368。**
  307. 本项目为半开源软件,未经授权不得复制、分发、反向工程或二次开发,仅供学习,未经授权不得商业行为(除非成为技术合伙人共同开发)。正式商业授权协议(EULA)随发行版提供。
  308. ---
  309. <div align="center">
  310. **用 AI 释放创作力 · OmniSpace**
  311. Made with ❤️ by the OmniSpace Team
  312. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.