Dart open source projects

纯 Dart 开源项目技能集合

项目筛选标准

只收录 纯 Dart 开发（不依赖 Flutter 框架） 的开源项目：

• 使用 language:Dart NOT flutter 搜索 GitHub
• 排除移动端 UI 框架项目（Flutter widget/packages）
• 优先收录可独立运行的 CLI 工具、服务端框架、通用库

难度分级总览

等级	项目	GitHub	关联技能
L1 入门	dart-for-beginners-course	链接	dart-fundamentals
L1 入门	design-patterns-in-dart	链接	dart-classes-objects
L1 入门	google-translator	链接	dart-fundamentals
L1 入门	common_utils	链接	dart-core-libraries
L2 进阶	formz	链接	dart-type-system
L2 进阶	fresh	链接	dart-async-concurrency
L2 进阶	talker	链接	dart-core-libraries
L2 进阶	dson	链接	dart-core-libraries
L3 高级	very_good_cli	链接	dart-packages-pub
L3 高级	mason	链接	dart-packages-pub
L3 高级	dart_frog	链接	dart-async-concurrency
L3 高级	image	链接	dart-core-libraries

推荐学习路线

L1 基础语法入门
  → dart-oss-beginners-course (配合 dart-fundamentals)
  → dart-oss-design-patterns (配合 dart-classes-objects)

L2 库与工具进阶
  → dart-oss-common-utils / dart-oss-google-translator
  → dart-oss-formz (类型系统) / dart-oss-fresh (异步)

L3 实战项目
  → dart-oss-dart-frog (后端框架)
  → dart-oss-very-good-cli (CLI 工具)
  → dart-oss-mason (模板引擎)
  → dart-oss-image (底层算法)

## 维护指南

不定期搜索 GitHub 上新出现的纯 Dart 开源项目，手动添加到本集合。

### 搜索策略

**主搜索查询**（GitHub 搜索框或 API）：

language:Dart NOT flutter stars:>30

**分类搜索**：

| 类别 | 查询 |
|------|------|
| Dart 库/包 | `language:Dart topic:dart-package stars:>30` |
| Dart CLI 工具 | `language:Dart topic:cli topic:dart stars:>10` |
| Dart 服务端 | `language:Dart topic:dart-server stars:>10` |
| 最近更新 | `language:Dart NOT flutter pushed:>2026-01-01 sort:updated` |
| 新兴项目 | `language:Dart NOT flutter stars:10..100 created:>2025-01-01` |

**API 搜索**（获取结构化结果）：

https://api.github.com/search/repositories?q=language:Dart+NOT+flutter+stars:>50&sort=stars&order=desc&per_page=30

### 筛选规则

| 条件 | 操作 |
|------|------|
| Flutter 项目（含 `flutter` topic / 依赖 flutter SDK） | **排除** |
| 纯 Dart 项目且 Stars > 20 | 加入候选列表 |
| 代码量 < 50 行或仅 README | 排除 |
| 项目已归档（archived） | 排除 |
| 超过 2 年未更新 | 降低优先级 |

### 添加新项目的步骤

#### Step 1: 评估项目

```bash
# 克隆项目，快速评估
git clone --depth 1 <project_url> /tmp/project-eval
# 检查是否依赖 flutter
grep -r "flutter" /tmp/project-eval/pubspec.yaml
# 估算代码量
find /tmp/project-eval -name "*.dart" | xargs wc -l | tail -1

Step 2: 分级与映射

评判维度	L1 入门	L2 进阶	L3 高级
核心代码行数	< 500	500-3000	> 3000
依赖复杂度	无/少依赖	中等	Monorepo/多包
Dart 特性覆盖	基础语法	泛型/异步/核心库	全栈/底层算法
架构复杂度	单文件/少量文件	多模块	框架级

映射到最相关的 Dart 主题 skill（dart-fundamentals / dart-async-concurrency / dart-core-libraries 等）。

Step 3: 创建 Skill 目录和文件

# 目录命名：dart-oss-<project-key>
mkdir -p skills/dart-open-source-projects/dart-oss-<name>

SKILL.md 格式（参见已有文件）：

---
name: dart-oss-<name>
description: 学习 <author/project> 开源项目，通过 <描述> 理解 <关联的 Dart 技能>。
metadata:
  model: deepseek-v4-pro
  last_modified: <date>
  related_skills:
    - <dart-topic-skill>
  project:
    url: https://github.com/<author>/<repo>
    stars: <N>
    difficulty: beginner|intermediate|advanced
    category: library|cli|tutorial|framework|patterns
---

# 学习 <Project Name> 项目

## Contents
- [项目概览](#项目概览)
- [与 <related-skill> 的关联](#与-xxx-的关联)
- [项目架构分析](#项目架构分析)
- [核心实现详解](#核心实现详解)
- [Workflow: <学习目标>](#workflow-xxx)
- [Examples](#examples)

## 项目概览
<!-- GitHub 链接、Stars、难度、项目简介 -->

## 与 <related-skill> 的关联
<!-- 用表格列出项目代码中使用的 Dart 特性与对应 skill 主题的映射 -->

## 项目架构分析
<!-- 核心模块、类层级图、数据流 -->

## 核心实现详解
<!-- 关键代码片段和设计模式分析 -->

## Workflow: <学习目标>
<!-- Task Progress 步骤 + 条件逻辑 -->

## Examples
<!-- 从项目中学到的模式 + 延伸练习 -->

Step 4: 更新集合文件

1. 在 skills/dart-open-source-projects/SKILL.md 的难度分级表中添加新行
2. 在 README.md 的"纯 Dart 开源项目技能"表中添加新行
3. 运行 dart analyze 确认无错误

Step 5: 验证清单

• dart analyze 通过
• SKILL.md 包含正确的 YAML frontmatter（name、description、metadata）
• 项目确实为纯 Dart（不依赖 Flutter SDK）
• GitHub 链接有效，Stars 数字准确
• 映射的关联技能合理
• README.md 已同步更新