# 在 GitHub 上 fork 仓库
# 克隆您的 fork
git clone https://github.com/YOUR_USERNAME/downcity.git
cd downcity

# 添加 upstream 远程
git remote add upstream https://github.com/wangenius/downcity.git

# 安装依赖
pnpm install

# 设置开发环境
pnpm dev:setup

# 构建项目
pnpm build

# 运行测试
pnpm test

# 运行 linter
pnpm lint

# 类型检查
pnpm typecheck

downcity/
├── packages/
│   ├── cli/              # CLI 工具
│   ├── core/             # 核心 agent 逻辑
│   ├── llm/              # LLM 提供商实现
│   └── tools/            # 内置工具
├── homepage/             # 文档站点
└── examples/             # 示例配置

# 创建功能分支
git checkout -b feature/my-feature

# 或修复 bug
git checkout -b fix/issue-123

# 或文档
git checkout -b docs/update-guide

feat: 添加对自定义工具的支持
fix: 解决任务调度器中的竞态条件
docs: 更新安装指南
chore: 升级依赖
test: 为权限系统添加测试
refactor: 改进 LLM 提供商抽象

# 运行格式化工具
pnpm format

# 运行 linter
pnpm lint:fix

# 类型检查
pnpm typecheck

# 1. 创建分支
git checkout -b feature/add-discord-plugin

# 2. 进行更改
# ... 编辑文件 ...

# 3. 提交更改
git add .
git commit -m "feat: 添加 Discord bot 集成"

# 4. 测试
pnpm test

# 5. 推送到 fork
git push origin feature/add-discord-plugin

# 6. 在 GitHub 上创建 PR
# 访问您的 fork 并创建拉取请求

# 获取上游更新
git fetch upstream

# 合并上游 main
git checkout main
git merge upstream/main

# 推送到您的 fork
git push origin main

开发者起源证书
版本 1.1

1. 开发者和利益相关者通过贡献和补丁与项目的合作
   是项目的预期合作和协作方法。

2. 开发者保证：
   (a) 贡献全部或部分由我创建，我有权在文件中
       指示的开源许可证下提交；或
   (b) 贡献基于先前的工作，据我所知，涵盖在适当的
       开源许可证下，我有权在该许可证下提交该工作，
       包括对其进行的修改，无论是全部或部分由我创建，
       与该项目相关的同一开源许可证（除非被允许
       在不同许可证下提交），如文件中所示；或
   (c) 贡献直接由我提供的其他一些创建、认证 (a)、(b)
       或 (c) 且我未修改它的人。

   (d) 我理解并同意该项目和贡献是公开的，贡献记录
       （包括我提交的所有个人信息，包括我的签名）
       将无限期维护，并根据该项目或所涉及的开源许可证
       一致地重新分发。

git commit -s -m "feat: 添加新功能"