Files
agent-radar 1a3a4ccde1
Creator App Tests / PR Spam Gate (push) Skipped
Frontend Tests / PR Spam Gate (push) Skipped
NPM Format (website & console) / PR Spam Gate (push) Skipped
Pre-commit Checks / PR Spam Gate (push) Skipped
QwenPaw Creator Plugin Release / check-version (push) Canceled after 0s
QwenPaw Creator Plugin Release / upload-oss (push) Canceled after 0s
Tests / PR Spam Gate (push) Skipped
CodeQL / CodeQL (python) (push) Canceled after 0s
CodeQL / CodeQL (typescript) (push) Canceled after 0s
Creator App Tests / Creator Backend Tests (push) Canceled after 0s
Creator App Tests / Creator UI Build & Tests (push) Canceled after 0s
E2E Smoke Tests / Playwright UI Smoke (push) Canceled after 0s
Frontend Tests / Detect console changes (push) Canceled after 0s
NPM Format (website & console) / website format check (push) Canceled after 0s
NPM Format (website & console) / console format check (push) Canceled after 0s
Pre-commit Checks / Pre-commit (push) Canceled after 0s
QwenPaw Data Plugin Release / check-version (push) Canceled after 0s
Tests / Detect code changes (push) Canceled after 0s
Frontend Tests / Vitest Unit Tests (push) Canceled after 0s
Frontend Tests / Frontend Summary (push) Canceled after 0s
QwenPaw Data Plugin Release / upload-oss (push) Canceled after 0s
Tests / Maintainer Approval (push) Canceled after 0s
Tests / Unit Tests - py3.11 - macos-latest (push) Canceled after 0s
Tests / Unit Tests - py3.11 - ubuntu-latest (push) Canceled after 0s
Tests / Unit Tests - py3.13 - ubuntu-latest (push) Canceled after 0s
Tests / Unit Tests - py3.11 - windows-latest (push) Canceled after 0s
Tests / Contract Tests - py3.11 - macos-latest (push) Canceled after 0s
Tests / Contract Tests - py3.11 - ubuntu-latest (push) Canceled after 0s
Tests / Contract Tests - py3.13 - ubuntu-latest (push) Canceled after 0s
Tests / Contract Tests - py3.11 - windows-latest (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - macos-latest - p0 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - macos-latest - p1 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - macos-latest - p2 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - ubuntu-latest - fallback (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - ubuntu-latest - p0 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - ubuntu-latest - p1 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - ubuntu-latest - p2 (push) Canceled after 0s
Tests / Integrated Tests - py3.13 - ubuntu-latest - p0 (push) Canceled after 0s
Tests / Integrated Tests - py3.13 - ubuntu-latest - p1 (push) Canceled after 0s
Tests / Integrated Tests - py3.13 - ubuntu-latest - p2 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - windows-latest - p0 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - windows-latest - p1 (push) Canceled after 0s
Tests / Integrated Tests - py3.11 - windows-latest - p2 (push) Canceled after 0s
Tests / Coverage Report (push) Canceled after 0s
Tests / Test Summary (push) Canceled after 0s
源码快照 @ 2026-09-01 (source-only, 剔除非源码素材)
2026-09-01 20:01:50 +08:00

105 lines
3.3 KiB
Markdown

# Open Source & Contribution
QwenPaw is open source. The project repository is hosted on GitHub:
**https://github.com/agentscope-ai/QwenPaw**
---
## 🎯 How to Contribute
Thank you for your interest in QwenPaw, and we warmly welcome all forms of contribution! To keep collaboration smooth and maintain quality, please follow these guidelines.
### 1. Check Existing Plans and Issues
Before starting:
- **Check [Open Issues](https://github.com/agentscope-ai/QwenPaw/issues)** and the [Roadmap](/docs/roadmap)
- **If a related issue exists** and is open or unassigned: comment to say you want to work on it to avoid duplicate effort
- **If no related issue exists**: open a new issue describing your proposal. The maintainers will respond and help align with the project direction
### 2. Commit Message Format
We follow the [Conventional Commits](https://www.conventionalcommits.org/) specification for clear history and tooling.
**Format:**
```
<type>(<scope>): <subject>
```
**Types:**
- `feat:` New feature
- `fix:` Bug fix
- `docs:` Documentation only
- `style:` Code style (whitespace, formatting, etc.)
- `refactor:` Code change that neither fixes a bug nor adds a feature
- `perf:` Performance improvement
- `test:` Adding or updating tests
- `chore:` Build, tooling, or maintenance
**Examples:**
```bash
feat(channels): add Telegram channel support
fix(skills): correct SKILL.md front matter parsing
docs(readme): update Docker quick start
refactor(providers): simplify custom provider validation
test(agents): add tests for skill loading
```
### 3. Pull Request Title Format
PR titles should follow the same convention:
**Format:** `<type>(<scope>): <description>`
- Use one of: `feat`, `fix`, `docs`, `test`, `refactor`, `chore`, `perf`, `style`, `build`, `revert`
- **Scope must be lowercase** (letters, numbers, hyphens, underscores only)
- Keep the description short and descriptive
**Examples:**
```
feat(models): add custom provider for Azure OpenAI
fix(channels): handle empty content_parts in Discord
docs(skills): document Skills Hub import
```
### 4. Code and Quality
- **Required local gate (must pass before push/PR):**
```bash
pip install -e ".[dev,full]"
pre-commit install
pre-commit run --all-files
pytest
```
- **If pre-commit modifies files:** Commit those changes, then rerun `pre-commit run --all-files` until it passes cleanly
- **CI policy:** Pull requests with failing pre-commit checks are not merge-ready
- **Frontend formatting:** If your changes involve the `console` or `website` directories, run the formatter before committing:
```bash
cd console && npm run format
cd website && pnpm format
```
- **Documentation:** Update docs when you add or change user-facing behavior. The docs live under `website/public/docs/`
---
## 💬 Getting Help
- **Discussions:** [GitHub Discussions](https://github.com/agentscope-ai/QwenPaw/discussions)
- **Bugs and features:** [GitHub Issues](https://github.com/agentscope-ai/QwenPaw/issues)
- **Community and developer groups:** See [Community page](/docs/community)
---
## 🗺️ Roadmap
Check our [Roadmap](/docs/roadmap) for items marked **Seeking Contributors** (e.g. new channels, model providers, skills, MCPs, or display/UX improvements) — great places to start!
---
Thank you for contributing to QwenPaw. Your work helps make it a better assistant for everyone. 🐾