chore: 添加开源社区基础设施和项目文档

- 添加 README、LICENSE (MIT)、CONTRIBUTING、CHANGELOG
- 添加 GitHub Issue/PR 模板和 FUNDING 配置
- 添加 CI/CD 工作流(ci.yml + release.yml)
- 添加项目文档页面 (docs/index.html)
- 添加 logo 和社群二维码图片资源
- 添加开发和构建脚本 (dev.sh + build.sh)
- 更新 package-lock.json 依赖
This commit is contained in:
晴天
2026-02-28 03:23:39 +08:00
parent add7f1e083
commit 75e94a7560
17 changed files with 1092 additions and 0 deletions

82
CONTRIBUTING.md Normal file
View File

@@ -0,0 +1,82 @@
# 贡献指南
感谢你对 ClawPanel 项目的关注!以下是参与贡献的相关说明。
## 开发环境要求
| 依赖 | 最低版本 | 说明 |
|------|----------|------|
| Node.js | 18+ | 前端构建 |
| Rust | stable | Tauri 后端编译 |
| Tauri CLI | v2 | `cargo install tauri-cli --version "^2"` |
### 快速开始
```bash
# 克隆仓库
git clone https://github.com/qingchencloud/clawpanel.git
cd clawpanel
# 安装前端依赖
npm install
# 启动开发模式
cargo tauri dev
```
## 分支策略
- 所有开发基于 `main` 分支
- 新功能分支:`feature/功能描述`(例如 `feature/log-export`
- 修复分支:`fix/问题描述`(例如 `fix/model-save-crash`
- 完成后发起 PR 合并回 `main`
## 提交规范
提交信息采用 [Conventional Commits](https://www.conventionalcommits.org/) 格式:
```
<类型>(可选范围): 简要描述
```
### 类型说明
| 类型 | 说明 |
|------|------|
| `feat` | 新功能 |
| `fix` | 修复 Bug |
| `docs` | 文档变更 |
| `style` | 代码格式调整(不影响逻辑) |
| `refactor` | 重构(非新功能、非 Bug 修复) |
| `test` | 测试相关 |
| `chore` | 构建/工具/依赖变更 |
### 示例
```
feat(model): 新增模型批量测试功能
fix(gateway): 修复端口配置未生效的问题
docs: 更新安装说明
```
## PR 流程
1. Fork 本仓库并克隆到本地
2.`main` 创建新分支
3. 完成开发并进行本地测试
4. 确保代码风格一致、注释完整
5. 提交并推送到你的 Fork 仓库
6. 发起 Pull Request描述清楚变更内容和测试情况
7. 等待代码审查,根据反馈修改
## 代码规范
- **前端**:使用 Vanilla JS不引入第三方框架
- **注释**:所有代码注释使用中文
- **风格**:简洁清晰,避免过度封装
- **命名**变量和函数使用驼峰命名camelCaseCSS 类名使用短横线命名kebab-case
- **资源**:静态资源本地化,禁止引用远程 CDN
## 问题反馈
如果发现 Bug 或有功能建议,欢迎通过 [GitHub Issues](https://github.com/qingchencloud/clawpanel/issues) 提交。