zrr1999 · zrr1999 · Dec 29, 2025 · Dec 29, 2025 · Dec 29, 2025 · Dec 29, 2025
diff --git a/.github/workflows/static-check.yml → .github/workflows/ci-static-checks.yml b/.github/workflows/static-check.yml → .github/workflows/ci-static-checks.yml
@@ -1,9 +1,10 @@
-name: CodeStyle Check
+name: "CI: Static Checks"
 
 on:
   push:
     branches: [main]
   pull_request:
+    branches: [main]
 
 jobs:
   code-style-check:

diff --git a/.github/workflows/readme-translation-sync.yml b/.github/workflows/readme-translation-sync.yml
@@ -0,0 +1,37 @@
+name: README Translation Sync
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [main]
+    paths:
+      - README.md
+
+permissions:
+  contents: write
+  pull-requests: write
+  models: read
+
+jobs:
+  translate:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: zrr-lab/readme-translation-sync@main
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          target-language: English
+          target-file: README.en-US.md
+      - uses: peter-evans/create-pull-request@v7
+        with:
+          commit-message: "📝 docs: sync README.en-US.md translation"
+          title: "📝 docs: sync README.en-US.md translation"
+          body: |
+            This PR automatically syncs the English translation with the latest changes in `README.md`.
+
+            Generated using GitHub Models.
+          branch: readme-translation-sync
+          delete-branch: true
+          labels: documentation
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -1,19 +1,32 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.6.0
+    rev: v6.0.0
     hooks:
       - id: check-added-large-files
+      - id: check-case-conflict
+      - id: check-executables-have-shebangs
       - id: check-yaml
       - id: check-json
-      - id: check-toml
       - id: check-merge-conflict
-      - id: debug-statements
+      - id: destroyed-symlinks
       - id: end-of-file-fixer
       - id: mixed-line-ending
       - id: trailing-whitespace
+
+  - repo: https://github.com/tombi-toml/tombi-pre-commit
+    rev: v0.7.0
+    hooks:
+      - id: tombi-format
+      - id: tombi-lint
+
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.7.2
+    rev: v0.14.6
     hooks:
+      - id: ruff-check
+        args: [--fix]
       - id: ruff-format
-      - id: ruff
-        args: [--fix, --unsafe-fixes, --exit-non-zero-on-fix]
+
+  - repo: https://github.com/crate-ci/typos
+    rev: v1.33.1
+    hooks:
+      - id: typos
diff --git a/README.md b/README.md
@@ -1,4 +1,5 @@
 # 多模态情绪识别 (Multimodal Emotion Recognition)
+中文 | [English](README.en-US.md)
 
 > 基于深度学习的多模态情绪识别方法研究套件，支持文本、音频、视频三种模态的情绪分类与情感分析任务。
 

diff --git a/_typos.toml b/_typos.toml
@@ -0,0 +1,3 @@
+[default.extend-words]
+ACII = "ACII"
+NCE = "NCE"
diff --git a/configs/encoders/A+V.toml b/configs/encoders/A+V.toml
@@ -1,5 +1,3 @@
-
-
 [model.encoder.A]
 feature_size = 768
 model = "facebook/data2vec-audio-base-960h"

diff --git a/configs/encoders/A.toml b/configs/encoders/A.toml
@@ -1,5 +1,3 @@
-
-
 [model.encoder.A]
 feature_size = 768
 model = "facebook/data2vec-audio-base-960h"
diff --git a/configs/fusion/DF-0.1.toml b/configs/fusion/DF-0.1.toml
@@ -1,5 +1,6 @@
 [model.fusion]
 base = "DisentanglementFusion"
 args = ["feature_sizes_dict", "256", "128"]
+
 [model.fusion.kwargs]
 alpha = "0.1"
diff --git a/configs/fusion/DF-1.0.toml b/configs/fusion/DF-1.0.toml
@@ -1,5 +1,6 @@
 [model.fusion]
 base = "DisentanglementFusion"
 args = ["feature_sizes_dict", "256", "128"]
+
 [model.fusion.kwargs]
 alpha = "1"
diff --git a/configs/fusion/DF-2.0.toml b/configs/fusion/DF-2.0.toml
@@ -1,5 +1,6 @@
 [model.fusion]
 base = "DisentanglementFusion"
 args = ["feature_sizes_dict", "256", "128"]
+
 [model.fusion.kwargs]
 alpha = "2"
diff --git a/configs/fusion/deep-vallina.toml b/configs/fusion/deep-vallina.toml
@@ -1,5 +1,6 @@
 [model.fusion]
 base = "VallinaFusionLayer"
 args = ["feature_sizes_dict", "128"]
+
 [model.fusion.kwargs]
 depth = "5"
diff --git a/configs/fusion/shared-iemocap.toml b/configs/fusion/shared-iemocap.toml
@@ -1,5 +1,6 @@
 [model.fusion]
 base = "SharedFeatureFusion"
 args = ["feature_sizes_dict", "128"]
+
 [model.fusion.kwargs]
 alpha = "2"
diff --git a/configs/fusion/shared-meld.toml b/configs/fusion/shared-meld.toml
@@ -1,5 +1,6 @@
 [model.fusion]
 base = "SharedFeatureFusion"
 args = ["feature_sizes_dict", "128"]
+
 [model.fusion.kwargs]
 alpha = "0.1"
diff --git a/experiments/baseline/multimodal.toml b/experiments/baseline/multimodal.toml
@@ -8,17 +8,18 @@ seed = ["114"]
 [tasks.multimodal]
 command = "uv run emotion-recognize train"
 args = [
-    "configs/dataset/{dataset}.toml",
-    "configs/encoders/{encoder}.toml",
-    "configs/fusion/{fusion}.toml",
-    "configs/losses/classification/weight.toml",
-    "--seed {seed}",
+  "configs/dataset/{dataset}.toml",
+  "configs/encoders/{encoder}.toml",
+  "configs/fusion/{fusion}.toml",
+  "configs/losses/classification/weight.toml",
+  "--seed {seed}",
 ]
+
 [tasks.multimodal.matrix]
 encoder = [
-    "T+A",
-    "T+V",
-    "A+V",
-    "T+A+V",
+  "T+A",
+  "T+V",
+  "A+V",
+  "T+A+V",
 ]
 fusion = ["configs/fusion/vallina.toml"]
diff --git a/experiments/baseline/unimodal.toml b/experiments/baseline/unimodal.toml
@@ -9,14 +9,15 @@ classification = ["focal"]
 [tasks.unimodal]
 command = "uv run emotion-recognize train"
 args = [
-    "configs/dataset/{dataset}.toml",
-    "configs/encoders/{encoder}.toml",
-    "configs/losses/classification/{classification}.toml",
-    "--seed {seed}",
+  "configs/dataset/{dataset}.toml",
+  "configs/encoders/{encoder}.toml",
+  "configs/losses/classification/{classification}.toml",
+  "--seed {seed}",
 ]
+
 [tasks.unimodal.matrix]
 encoder = [
-    "T",
-    "A",
-    "V",
+  "T",
+  "A",
+  "V",
 ]
diff --git a/experiments/makd-ablation.toml b/experiments/makd-ablation.toml
@@ -7,10 +7,10 @@ loss = ["focal", "weight"]
 [tasks.unimodal]
 command = "uv run emotion-recognize train"
 args = [
-    "configs/dataset/{dataset}.toml",
-    "configs/encoders/T.toml",
-    "configs/losses/classification/{loss}.toml",
-    "--seed {seed}",
+  "configs/dataset/{dataset}.toml",
+  "configs/encoders/T.toml",
+  "configs/losses/classification/{loss}.toml",
+  "--seed {seed}",
 ]
 
 [tasks.unimodal.matrix]
@@ -20,97 +20,103 @@ seed = ["0", "114"]
 [tasks.meld-losses]
 command = "uv run emotion-recognize train"
 args = [
-    "configs/dataset/MELD--E.toml",
-    "configs/encoders/T+A+V.toml",
-    "configs/fusion/DF-1.0.toml",
-    "configs/fusion/kwargs/attn.toml",
-    "configs/losses/classification/{loss}.toml",
-    "{extra}",
-    "--seed 114",
+  "configs/dataset/MELD--E.toml",
+  "configs/encoders/T+A+V.toml",
+  "configs/fusion/DF-1.0.toml",
+  "configs/fusion/kwargs/attn.toml",
+  "configs/losses/classification/{loss}.toml",
+  "{extra}",
+  "--seed 114",
 ]
 deps = ["unimodal"]
+
 [tasks.meld-losses.matrix]
 extra = [
-    "configs/losses/frl-meld.toml",
-    "--teacher-checkpoint checkpoints/training/MELD--E/trainable--2--{loss}/1xE--T/ce200638--114",
+  "configs/losses/frl-meld.toml",
+  "--teacher-checkpoint checkpoints/training/MELD--E/trainable--2--{loss}/1xE--T/ce200638--114",
 ]
 
 [tasks.meld-model]
 command = "uv run emotion-recognize train"
 args = [
-    "configs/dataset/MELD--E.toml",
-    "configs/encoders/T+A+V.toml",
-    "configs/fusion/{fusion}.toml",
-    "configs/losses/classification/{loss}.toml",
-    "configs/losses/frl-meld.toml",
-    "--teacher-checkpoint checkpoints/training/MELD--E/trainable--2--{loss}/1xE--T/ce200638--114",
-    "--seed 114",
+  "configs/dataset/MELD--E.toml",
+  "configs/encoders/T+A+V.toml",
+  "configs/fusion/{fusion}.toml",
+  "configs/losses/classification/{loss}.toml",
+  "configs/losses/frl-meld.toml",
+  "--teacher-checkpoint checkpoints/training/MELD--E/trainable--2--{loss}/1xE--T/ce200638--114",
+  "--seed 114",
 ]
 deps = ["unimodal"]
+
 [tasks.meld-model.matrix]
 fusion = ["vallina", "shared-meld", "private", "DF-1.0"]
 
 [tasks.meld-modality]
 command = "uv run emotion-recognize train"
 args = [
-    "configs/dataset/MELD--E.toml",
-    "configs/encoders/{encoder}.toml",
-    "configs/fusion/DF-1.0.toml",
-    "configs/fusion/kwargs/attn.toml",
-    "configs/losses/classification/{loss}.toml",
-    "configs/losses/frl-meld.toml",
-    "--teacher-checkpoint checkpoints/training/MELD--E/trainable--2--{loss}/1xE--T/ce200638--114",
-    "--seed 114",
+  "configs/dataset/MELD--E.toml",
+  "configs/encoders/{encoder}.toml",
+  "configs/fusion/DF-1.0.toml",
+  "configs/fusion/kwargs/attn.toml",
+  "configs/losses/classification/{loss}.toml",
+  "configs/losses/frl-meld.toml",
+  "--teacher-checkpoint checkpoints/training/MELD--E/trainable--2--{loss}/1xE--T/ce200638--114",
+  "--seed 114",
 ]
 deps = ["unimodal"]
+
 [tasks.meld-modality.matrix]
 encoder = ["T+A", "T+V"]
 
 [tasks.iemocap-losses]
 command = "uv run emotion-recognize train"
 args = [
-    "configs/dataset/IEMOCAP--E.toml",
-    "configs/encoders/T+A+V.toml",
-    "configs/fusion/DF-2.0.toml",
-    "configs/fusion/kwargs/attn.toml",
-    "configs/losses/classification/{loss}.toml",
-    "{extra}",
-    "--seed 0",
+  "configs/dataset/IEMOCAP--E.toml",
+  "configs/encoders/T+A+V.toml",
+  "configs/fusion/DF-2.0.toml",
+  "configs/fusion/kwargs/attn.toml",
+  "configs/losses/classification/{loss}.toml",
+  "{extra}",
+  "--seed 0",
 ]
 deps = ["unimodal"]
+
 [tasks.iemocap-losses.matrix]
 extra = [
-    "configs/losses/frl-iemocap.toml",
-    "--teacher-checkpoint checkpoints/training/IEMOCAP--E/trainable--4--{loss}/1xE--T/ce200638--114",
+  "configs/losses/frl-iemocap.toml",
+  "--teacher-checkpoint checkpoints/training/IEMOCAP--E/trainable--4--{loss}/1xE--T/ce200638--114",
 ]
 
 [tasks.iemocap-model]
 command = "uv run emotion-recognize train"
 args = [
-    "configs/dataset/IEMOCAP--E.toml",
-    "configs/encoders/T+A+V.toml",
-    "configs/fusion/{fusion}.toml",
-    "configs/losses/classification/{loss}.toml",
-    "configs/losses/frl-iemocap.toml",
-    "--teacher-checkpoint checkpoints/training/IEMOCAP--E/trainable--4--{loss}/1xE--T/ce200638--114",
-    "--seed 0",
+  "configs/dataset/IEMOCAP--E.toml",
+  "configs/encoders/T+A+V.toml",
+  "configs/fusion/{fusion}.toml",
+  "configs/losses/classification/{loss}.toml",
+  "configs/losses/frl-iemocap.toml",
+  "--teacher-checkpoint checkpoints/training/IEMOCAP--E/trainable--4--{loss}/1xE--T/ce200638--114",
+  "--seed 0",
 ]
 deps = ["unimodal"]
+
 [tasks.iemocap-model.matrix]
 fusion = ["vallina", "shared-iemocap", "private", "DF-2.0"]
 
 [tasks.iemocap-modality]
 command = "uv run emotion-recognize train"
 args = [
-    "configs/dataset/IEMOCAP--E.toml",
-    "configs/encoders/{encoder}.toml",
-    "configs/fusion/DF-2.0.toml",
-    "configs/fusion/kwargs/attn.toml",
-    "configs/losses/classification/{loss}.toml",
-    "configs/losses/frl-iemocap.toml",
-    "--teacher-checkpoint checkpoints/training/IEMOCAP--E/trainable--4--{loss}/1xE--T/ce200638--114",
-    "--seed 0",
+  "configs/dataset/IEMOCAP--E.toml",
+  "configs/encoders/{encoder}.toml",
+  "configs/fusion/DF-2.0.toml",
+  "configs/fusion/kwargs/attn.toml",
+  "configs/losses/classification/{loss}.toml",
+  "configs/losses/frl-iemocap.toml",
+  "--teacher-checkpoint checkpoints/training/IEMOCAP--E/trainable--4--{loss}/1xE--T/ce200638--114",
+  "--seed 0",
 ]
 deps = ["unimodal"]
+
 [tasks.iemocap-modality.matrix]
 encoder = ["T+A", "T+V"]