docs: make the roadmap actionable

.github/workflows/test-fun-asr-nano-vllm.yml

@@ -0,0 +1,62 @@
+name: Validate Fun-ASR-Nano vLLM
+
+on:
+  pull_request:
+    paths:
+      - "funasr/models/fun_asr_nano/**"
+      - "funasr/models/glm_asr/**"
+      - "tests/test_fun_asr_nano_*.py"
+      - "tests/test_glm_asr_vllm_*.py"
+      - "tests/test_vllm_model_source_docs.py"
+      - ".github/workflows/test-fun-asr-nano-vllm.yml"
+  push:
+    branches:
+      - main
+    paths:
+      - "funasr/models/fun_asr_nano/**"
+      - "funasr/models/glm_asr/**"
+      - "tests/test_fun_asr_nano_*.py"
+      - "tests/test_glm_asr_vllm_*.py"
+      - "tests/test_vllm_model_source_docs.py"
+      - ".github/workflows/test-fun-asr-nano-vllm.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  contract:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: pip
+      - name: Install contract-test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install \
+            torch --index-url https://download.pytorch.org/whl/cpu
+          python -m pip install \
+            pytest numpy soundfile requests packaging \
+            omegaconf hydra-core kaldiio librosa tqdm pyyaml
+      - name: Check syntax
+        run: |
+          python -m py_compile \
+            funasr/models/fun_asr_nano/inference_vllm.py \
+            funasr/models/fun_asr_nano/inference_vllm_streaming.py
+      - name: Run vLLM regression contracts
+        run: |
+          python -m pytest -q \
+            tests/test_fun_asr_nano_autocast_device.py \
+            tests/test_fun_asr_nano_ctc_batch_fallback.py \
+            tests/test_fun_asr_nano_lora_injection.py \
+            tests/test_fun_asr_nano_missing_ctc_weights.py \
+            tests/test_fun_asr_nano_openai_response.py \
+            tests/test_fun_asr_nano_repetition_penalty.py \
+            tests/test_fun_asr_nano_vllm_dtype.py \
+            tests/test_glm_asr_vllm_dedup_keys.py \
+            tests/test_glm_asr_vllm_dtype.py \
+            tests/test_glm_asr_vllm_sampling.py \
+            tests/test_vllm_model_source_docs.py

.github/workflows/test-moss-adapter.yml

@@ -5,7 +5,13 @@ on:
     paths:
       - "funasr/models/moss_transcribe_diarize/**"
       - "funasr/auto/auto_model.py"
+      - "funasr/bin/_server_app.py"
+      - "funasr/bin/server.py"
+      - "examples/openai_api/**"
+      - "README*.md"
+      - "docs/index.rst"
       - "docs/moss_transcribe_diarize*.md"
+      - "web-pages/product-site/data/deployments.json"
       - "tests/test_moss_transcribe_diarize_*.py"
       - ".github/workflows/test-moss-adapter.yml"
   push:
@@ -14,7 +20,13 @@ on:
     paths:
       - "funasr/models/moss_transcribe_diarize/**"
       - "funasr/auto/auto_model.py"
+      - "funasr/bin/_server_app.py"
+      - "funasr/bin/server.py"
+      - "examples/openai_api/**"
+      - "README*.md"
+      - "docs/index.rst"
       - "docs/moss_transcribe_diarize*.md"
+      - "web-pages/product-site/data/deployments.json"
       - "tests/test_moss_transcribe_diarize_*.py"
       - ".github/workflows/test-moss-adapter.yml"
 
@@ -45,9 +57,14 @@ jobs:
             funasr/models/moss_transcribe_diarize/model.py \
             tests/test_moss_transcribe_diarize_model.py \
             tests/test_moss_transcribe_diarize_docs.py
-          python -m py_compile funasr/models/moss_transcribe_diarize/model.py
+          python -m py_compile \
+            funasr/models/moss_transcribe_diarize/model.py \
+            funasr/bin/_server_app.py \
+            funasr/bin/server.py \
+            examples/openai_api/server.py
       - name: Run adapter and documentation contracts
         run: |
           python -m pytest -q \
             tests/test_moss_transcribe_diarize_model.py \
-            tests/test_moss_transcribe_diarize_docs.py
+            tests/test_moss_transcribe_diarize_docs.py \
+            tests/test_server_app_openai_segments.py

CONTRIBUTING.md

@@ -17,6 +17,14 @@ FunASR spans four repositories. Before opening an issue or PR, check which repo
 
 Full details: [Repository roles & roadmap](./docs/repository_roles.md) ([中文](./docs/repository_roles_zh.md))
 
+## Find a task
+
+- [good first issue](https://github.com/modelscope/FunASR/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22) lists bounded work with a clear starting point.
+- [help wanted](https://github.com/modelscope/FunASR/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) lists work that needs community hardware, domain knowledge, or implementation capacity.
+- [ready for PR](https://github.com/modelscope/FunASR/issues?q=is%3Aissue+is%3Aopen+label%3A%22ready+for+PR%22) lists work whose expected behavior and acceptance evidence are defined.
+
+Read the complete issue timeline and comment before starting so work is not duplicated. An issue marked `needs feedback` is waiting for reporter or hardware validation; a related PR may merge while the issue remains open. The roadmap's [contributor table](./docs/repository_roles.md#contribute-to-the-roadmap) lists current hardware and upstream-review needs.
+
 ## High-impact areas
 
 - **Quick start reliability:** installation notes, CPU/GPU/MPS compatibility, dependency fixes, and runnable examples.