OmicOS 开发者文档

欢迎。这是 OmicOS 生态的中文开发者教程。我们假设你已经会用桌面端，希望 往里面写代码——加 skill、加 agent、改 sidecar、调 admin、定制 UI。

如果你只是想用 OmicOS 做生信分析，参考 omicverse-tutorials，那是用户向手册。

本文档基于的版本

omicos-core ≥ 0.2.0、omicOS-ui ≥ 0.1.0、omicos-admin、omicOS-server、 omicos-server-ui 跟主干同步至 2026-05-12。某些章节的代码引用可能略快于 最新 release，但核心架构相对稳定，所有结论都注明了源码路径，可对照阅读。

2026-05 新功能速览

最近这一周加进来的大动作（详细说明散在各章节）：

  • Goal 模式 / 长时程任务（/goal <objective>）— 见 Goal 模式

  • Codex 风格三档权限（read_only / auto / full）— 见 权限模式

  • Skill / Agent v2：category、summary、use_when、example_prompts、per-agent skills 白名单、文件夹感知管理

  • Cloud sync 增量化：conversation ?since_seq 游标 + /ws/events push

  • Trajectory Q&A：viewer 提问 + owner 审计两条 sheet

  • kernel + tool pipeline：kernel_install / skill_resource 新工具、>16 KB 输出 spool 到磁盘、stdin EPIPE 自动 respawn

  • MiniMax provider：MINIMAX_API_KEY 自动识别

  • 移动 / Web SPA 重做：Groups 三级钻取替换 Profile、Trajectory 详情扁平化设计 — 见 omicos-server-ui

你最关心的入口

🚀 第一次贡献？

从 架构总览 起步，然后 搭一个能跑的本地环境。

项目愿景与三层架构总览
🧠 想理解核心概念

跳到 Agent / Team / Toolset 模型 和 Skill 系统。

Agent / Team / Toolset 模型
🔧 直接来加功能

看 写一个 skill 或 写一个 agent。

写一个 skill

文档地图

入门

核心概念

omicos-core (Rust sidecar)

omicos-ui (Tauri 前端)

omicos-admin (Flask)

扩展开发

运维 / 部署

贡献指南

文档维护

本文档的源码位于 PrimorDecode/omicos-develop-tutorial。 任何错误、过时章节、希望补充的内容，欢迎直接提 PR——文档和代码同等重要。

文档采用 Markdown（通过 MyST 解析器）， 不需要学习 reStructuredText。

License: MIT。