# MingCode

**Repository Path**: m1014395102/ming-code

## Basic Information

- **Project Name**: MingCode
- **Description**: No description available
- **Primary Language**: TypeScript
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-07
- **Last Updated**: 2026-07-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MingCode

基于 opencode 的开源 AI 编码编排引擎，对标 Claude Code 的完整能力。

## 定位

```
┌─ 用户交互层 ──────────────────────────────────┐
│  CLI / TUI / VS Code Extension                │
├─ MingCode 编排引擎 (本项目) ──────────────────┤
│  Workflow Engine | Agent Mgmt | Permissions   │
│  Cost Tracking | Multi-Repo | Skill Engine    │
├─ Opencode (基础能力提供者) ───────────────────┤
│  Provider Layer | Session | Tools | MCP       │
└───────────────────────────────────────────────┘
```

## 核心特性

- **100% Claude Code Skill 兼容** — 直接使用 `.claude/skills/` 生态
- **Dynamic Workflow Engine** — 动态编排数十到数百个子代理并行工作
- **嵌套子代理（3 层）** — 隔离上下文的树形代理结构
- **Checkpoint / Resume** — 中断恢复，不怕长任务
- **细粒度权限系统** — Allow/Ask/Deny 三层 + 范围控制
- **成本追踪** — Token 计数 + 预算执行 + 归因报告
- **Provider 无关** — 支持 Anthropic、OpenAI、本地模型等

## 技术栈

| 维度 | 选择 |
|------|------|
| 语言 | TypeScript (ES2022) |
| 运行时 | Node.js / Bun 兼容 |
| 包管理 | pnpm |
| CLI 框架 | cac |
| 持久化 | JSON 文件存储 |
| Schema | Zod |
| 测试 | Vitest |
| LLM | 8+ 厂商：Anthropic / OpenAI / DeepSeek / Moonshot / Zhipu / Qwen / OpenRouter / 自定义 |

## 安装

```bash
# 一行安装（推荐）
npm install -g ming-code

# 设置 API Key
export DEEPSEEK_API_KEY="sk-xxx"

# 使用
ming providers
ming run "帮我审查代码" --provider deepseek
```

## 快速开始（源码开发）

```bash
git clone https://gitee.com/m1014395102/ming-code.git
cd ming-code
pnpm install
pnpm dev providers
pnpm dev run "hello" --provider deepseek
pnpm test
pnpm build
```

## 项目结构

## 项目结构

```
src/
├── index.ts          # CLI 入口
├── cli/              # 命令定义 (run, workflow)
├── config/           # 配置系统 (Zod schema)
├── provider/         # LLM Provider 抽象层
├── storage/          # SQLite 持久化
├── utils/            # 日志 & 错误类型
├── workflow/         # ✅ 工作流引擎 (P2)
├── agent/            # ✅ 代理管理 + Checkpoint (P3)
├── skill/            # ✅ Skill 引擎 (P1)
├── permission/       # ✅ 权限系统 (P4)
├── cost/             # ✅ 成本追踪 (P4)
└── multi-repo/       # ✅ 多仓库编排 (P5)
```

## 实施路线图

| 阶段 | 内容 | 状态 |
|------|------|------|
| **P0** | 项目脚手架、CLI、Provider 层、存储 | ✅ |
| **P1** | Skill 引擎（Claude Code 兼容） | ✅ |
| **P2** | Workflow Engine | ✅ |
| **P3** | Agent Management + Checkpoint | ✅ |
| **P4** | 权限系统 + 成本追踪 | ✅ |
| **P5** | 多仓库编排 | ✅ |
| **P6** | 集成 + 端到端测试 | ✅ |