本项目是北京智捷通云科技有限公司 EOS（Edge Operating System）边缘操作系统的 AI 引擎组件组成部分。通过跟踪研究 OpenCode 及其相关生态系统的仓库项目，我们持续更新使用技巧、技能包、文档和集成脚本工具，为 EOS 边缘操作系统提供实时更新的最前沿 AI 引擎技术。

• 技术跟踪：持续跟踪 OpenCode 及其插件生态的最新发展动态
• 技能积累：收集、整理和验证 AI 编程代理的最佳实践和使用技巧
• 工具集成：开发和维护与 EOS 边缘操作系统无缝集成的脚本和工具
• 文档输出：定期更新技术文档、操作指南和研究成果报告
• 前沿探索：研究 LLM Agents、多模型编排、边缘计算等前沿技术在实际场景中的应用

workspace/
├── README.md                      # 项目主文档
├── PROJECT_OUTLINE.md            # 项目大纲
├── QUICK_START.md                # 快速开始指南
├── INTEGRATION_REFERENCE.md      # 集成参考手册
├── package.json                  # 项目配置
├── .gitignore                   # Git 忽略文件
│
├── oh-my-opencode/              # OpenCode 增强插件
│   ├── src/                    # 源代码
│   ├── docs/                   # 插件文档
│   └── AGENTS.md               # 代理配置
│
├── opencode/                    # OpenCode 核心项目
│   ├── packages/               # 核心包
│   ├── script/                 # 脚本工具
│   └── README.md              # 核心文档
│
├── opencode-mcp/               # OpenCode MCP 服务器
│   ├── src/                   # 源代码
│   ├── prompts/               # 提示词模板
│   └── CLAUDE.md             # MCP 文档
│
├── docs/                       # 文档目录
│   ├── research/              # 研究文档
│   │   ├── architecture-analysis.md    # 核心架构分析
│   │   ├── mcp-integration-notes.md    # MCP 集成笔记
│   │   ├── research-learning-path.md   # 学习路径规划
│   │   └── README.md                   # 研究总览
│   ├── development/           # 开发指南
│   │   ├── custom-tool-guide.md       # 自定义工具开发
│   │   └── custom-agent-guide.md      # 自定义 Agent 开发
│   ├── integration/           # 集成文档
│   │   └── application-guide.md       # 应用集成指南
│   ├── guides/                # 操作指南
│   │   ├── installation-guide.md      # 安装指南
│   │   └── offline-mode-guide.md     # 离线模式配置
│   ├── research-methods.md   # 研究方法论
│   ├── documentation-specs.md # 文档规范
│   └── changelog.md          # 变更日志
│
├── skills/                    # 技能包
│   └── template.md          # 技能包模板
│
└── scripts/                   # 自动化脚本
    ├── integration-test.sh  # 集成测试
    ├── sync-upstream.sh     # 上游同步
    ├── run-tests.sh         # 测试套件
    └── generate-docs.sh     # 文档生成

• OpenCode：开源 AI 编程代理（支持 Claude、GPT、Gemini、本地模型）
• Oh-My-OpenCode：OpenCode 的增强插件，提供多智能体编排能力
  • Sisyphus 主代理（多智能体编排）
  • Oracle 代理（架构设计、调试）
  • Frontend Engineer 代理（前端开发）
  • Librarian 代理（文档检索、代码库探索）
  • Explore 代理（快速代码库搜索）
• OpenCode MCP：Model Context Protocol 服务器集成

• ✅ 多模型编排（Anthropic、OpenAI、Google、本地模型）
• ✅ LSP 和 AST 感知代码重构
• ✅ 并行后台任务执行
• ✅ 会话管理和持久化
• ✅ Git 集成（原子提交、分支管理）
• ✅ 钩子系统（25+ 内置钩子）
• ✅ MCP 生态集成
• ✅ TUI 终端界面

• QUICK_START.md - 5分钟快速上手
• INTEGRATION_REFERENCE.md - 集成参考手册

• 核心架构分析 - OpenCode 三层架构详解
• 学习路径规划 - 8周系统学习计划
• Skills 技能包研究 - 提示词工程与技能包开发
• Agent 智能体研究 - Agent 设计与开发
• MCP 集成笔记 - MCP 生态研究

• 自定义工具开发 - 工具接口与实现
• 自定义 Agent 开发 - Agent 定义与配置

• 应用集成指南 - 集成使用指南
• 安装指南 - 完整安装配置
• 离线模式配置 - 本地模型与离线部署

• 研究方法论 - 研究流程与质量控制
• 文档规范 - 文档编写标准

# 快速安装
curl -fsSL https://opencode.ai/install | bash

# 使用包管理器
npm i -g opencode-ai@latest
brew install anomalyco/tap/opencode

# 安装 oh-my-opencode
npm install -g oh-my-opencode@latest

# 配置 OpenCode
# 编辑 ~/.config/opencode/opencode.json

opencode --version
opencode list-models

opencode run "ultrawork 实现用户认证系统"

• CLI 架构和命令系统
• 代理系统（Agent System）
• 会话管理和持久化
• LLM 集成与流式处理
• 工具系统（Tool System）
• 权限与安全系统

• Sisyphus 多智能体编排系统
• 钩子系统（25+ Hooks）
• 技能包（Skills）开发
• 后台任务管理

• 多模型切换策略
• 提示工程最佳实践
• Token 优化和成本控制
• 离线模式支持

• MCP 协议深入研究
• 自定义 MCP 服务器开发
• 第三方 MCP 工具集成
• EOS 专用 MCP 服务器

• 边缘计算适配
• 离线模式实现
• 安全性增强
• CI/CD 集成

• OpenCode 三层架构
• Agent 定义系统
• 工具注册机制

• 工具接口设计
• 现有工具分析
• 自定义工具开发

• 流式处理架构
• 系统提示设计
• 事件驱动架构

• 权限模型
• 规则匹配机制
• 安全最佳实践

• 会话生命周期
• 消息流处理

• Agent 定义系统
• 设计原则
• 实践案例

详见：完整学习计划

# 运行测试
npm test
bash scripts/run-tests.sh

# 集成测试
npm run integration
bash scripts/integration-test.sh

# 同步上游更新
npm run sync
bash scripts/sync-upstream.sh

# 生成文档
npm run docs
bash scripts/generate-docs.sh

• 2026-01-25：项目初始化，建立研究框架
• OpenCode 生态持续跟踪中

详见 研究报告目录

• ultrawork / ulw：启用所有高级功能（并行代理、后台任务、深度探索）
• ultrathink：深度思考模式，适合复杂问题分析

代理	适用场景
Sisyphus	综合任务、多步骤工作
Oracle	架构设计、代码审查
Frontend	前端界面开发
Librarian	文档检索、代码搜索
Explore	快速代码探索

• Context7：官方文档检索
• Exa：Web 搜索和网页获取
• Grep.app：GitHub 代码搜索

本项目主要用于内部研究和 EOS 边缘操作系统的 AI 引擎集成开发。如需贡献，请遵循以下流程：

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

本项目遵循其依赖项目的许可证：

• OpenCode License - Apache 2.0 / 商业许可
• Oh-My-OpenCode License - SUL-1.0
• OpenCode MCP License - MIT

• 公司：北京智捷通云科技有限公司
• 项目：EOS 边缘操作系统 AI 引擎组件

感谢以下开源项目的贡献：

• OpenCode - SST Team
• Oh-My-OpenCode - code-yeongyu
• MCP - Anthropic

本项目是对 OpenCode 生态的研究和集成工作，旨在为 EOS 边缘操作系统提供 AI 引擎技术支持。我们尊重并遵循所有相关项目的开源许可证。

---

注意：请定期检查上游项目的更新，并及时同步最新的功能和修复。