OPC-AgentOS

一人公司专属多智能体协作命令行工具

让每个一人公司创始人都能拥有自己的 AI 虚拟团队，真正实现"一个人就是一家公司"。

快速开始

# 安装
npm install -g opc-agentos

# 初始化（设置 DeepSeek API Key）
opc-agentos init

# 创建专属智能体
opc-agentos create

# 下达任务
opc-agentos run "帮我写一篇关于 AI 发展趋势的文章"

命令一览

| 命令 | 说明 | |------|------| | opc-agentos init | 初始化配置，设置 API Key | | opc-agentos create | 创建自定义智能体 | | opc-agentos create --list | 列出所有智能体 | | opc-agentos run "<任务>" | 下达任务 | | opc-agentos run "<任务>" --team <名称> | 指定团队执行 | | opc-agentos run "<任务>" --plan | 只生成任务计划，不执行 | | opc-agentos run "<任务>" --interactive | 交互模式，关键节点等待确认 | | opc-agentos run "<任务>" --model deepseek-reasoner | 覆盖本次模型 | | opc-agentos run "<任务>" --file ./ref.md | 附带参考文件 | | opc-agentos team create | 创建团队 | | opc-agentos team use <名称> | 切换当前团队 | | opc-agentos team list | 列出所有团队 | | opc-agentos status | 查看最近任务状态 | | opc-agentos export <智能体ID> | 导出智能体配置 | | opc-agentos import <文件> | 导入智能体配置 |

工作原理

采用 1个主智能体 + N个子智能体 的星型协作架构：

用户下达任务
    ↓
主智能体（项目经理）分解任务
    ↓
子智能体1 → 子智能体2 → 子智能体3
（前置输出自动传递给后续智能体）
    ↓
主智能体整合审核，交付最终成果

智能体配置

所有智能体采用纯 Markdown 文件配置，存储在 ~/.opc-agentos/agents/ 目录。

标准模板包含三层结构：

## 身份 Identity
你是一名...

## 灵魂 Soul
### 核心价值观
- 准确：...

## 角色 Role
### 主要职责
1. ...

## 工具 Tools
- 搜索引擎
- 代码执行器

# 模型：deepseek-reasoner   ← 可指定专用模型（可选）

典型场景

内容创作团队

opc-agentos create   # 创建「新闻研究员」
opc-agentos create   # 创建「内容创作者」
opc-agentos team create  # 组建 content-team
opc-agentos run "写一篇关于 2026 年 AI 趋势的公众号文章" --team content-team

软件开发团队

# 创建产品经理、前端工程师、后端工程师、测试工程师
opc-agentos team create  # 组建 dev-team
opc-agentos run "开发一个待办事项 Web 应用" --team dev-team

数据存储

| 路径 | 内容 | |------|------| | ~/.opc-agentos/config.json | API Key、默认模型等配置 | | ~/.opc-agentos/agents/*.md | 智能体配置文件 | | ~/.opc-agentos/teams/*.json | 团队配置文件 | | ~/.opc-agentos/tasks.db | 任务记录 + 智能体记忆（SQLite）| | ~/.opc-agentos/archive/ | 历史任务成果归档 | | ./opc-agentos-output/ | 当前目录任务成果输出 |

支持的模型

本工具专属 DeepSeek，不接入其他大模型接口。仅支持以下 DeepSeek 模型：

| 模型 | 用途 | 说明 | |------|------|------| | deepseek-v4-flash | 默认 | 速度快、成本低，适合日常任务 | | deepseek-v4-pro | 深度推理 | 启用思考模式，适合复杂分析 | | deepseek-chat | 旧名兼容 | 自动映射到 deepseek-v4-flash | | deepseek-reasoner | 旧名兼容 | 自动映射到 deepseek-v4-pro |

传入非 DeepSeek 模型会被拦截并报错。

系统要求

• Node.js >= 18.0.0
• DeepSeek API Key（申请地址）

目录结构

OPC_Agent_OS/
├── website/          # 官网页（公开，提交 git）— 项目介绍、功能、文档
├── src/              # CLI 核心源码
│   ├── commands/     #   命令实现（run/init/create/team/tasks/memory）
│   ├── core/         #   核心模块（executor/llmClient/memory/taskBoard 等）
│   ├── tui/          #   TUI 终端界面（Ink/React）
│   ├── utils/        #   工具函数
│   └── web/          #   Web UI 本地服务（routes/server）
├── bin/              # CLI 入口（opc-agentos.js）
├── scripts/          # 运行时脚本（migrate-v5.js）
├── tests/            # 测试套件（unit/integration/e2e/fixtures/reports）
├── deploy/           # 部署规程（DEPLOY_SOP.md + scripts/ + envs/）
├── docs/             # 内部文档（不提交 git）— PRD/arch/images
└── package.json

详细部署与发布流程见 deploy/DEPLOY_SOP.md。