fix: resolve CLI help format crash, test encodings, gitignore cache, and add requirements-dev

Author: TryWorld2026

.gitignore

@@ -1,4 +1,5 @@
-
 __pycache__/
-
 work/
+.pytest_cache/
+*.py[cod]
+*$py.class

requirements-dev.txt

@@ -0,0 +1,4 @@
+# Development dependencies for paper-algorithm
+pytest>=8.0.0
+edge-tts>=6.1.0
+mutagen>=1.47.0

skills/tryworld-paper/scripts/tts_yunxi.py

@@ -238,8 +238,8 @@ def main() -> int:
         "--theme", type=Path, default=None,
         help="theme JSON file; its voice.preset is used when --voice is omitted",
     )
-    parser.add_argument("--rate", default="+8%", help="speech rate, e.g. +5% / +8% / +15%")
-    parser.add_argument("--volume", default="+0%", help="volume, e.g. +0%")
+    parser.add_argument("--rate", default="+8%", help="speech rate, e.g. +5%% / +8%% / +15%%")
+    parser.add_argument("--volume", default="+0%", help="volume, e.g. +0%%")
     parser.add_argument("--pitch", default="+0Hz", help="pitch, e.g. +0Hz")
     parser.add_argument("--max-chars", type=int, default=700, help="max chars per segment")
     args = parser.parse_args()

tests/test_prose.py

@@ -59,6 +59,7 @@ def test_checker_help(self):
         r = subprocess.run(
             [sys.executable, "-X", "utf8", str(CHECKER), "--help"],
             capture_output=True, text=True,
+            encoding="utf-8", errors="replace",
         )
         assert r.returncode == 0
         assert r.returncode == 0

tests/test_tts.py

@@ -55,3 +55,15 @@ def test_strip_markdown_exists(self):
         assert callable(m.normalize_paragraph)
         assert callable(m.split_sentences)
         assert callable(m.build_segments)
+
+class TestCli:
+    def test_tts_help(self):
+        import subprocess
+        import sys
+        r = subprocess.run(
+            [sys.executable, "-X", "utf8", str(TTS), "--help"],
+            capture_output=True, text=True,
+            encoding="utf-8", errors="replace",
+        )
+        assert r.returncode == 0
+        assert "Chinese narration pipeline" in r.stdout

tests/test_verify.py

@@ -63,6 +63,7 @@ def test_help(self):
         r = subprocess.run(
             [sys.executable, "-X", "utf8", str(VERIFY), "--help"],
             capture_output=True, text=True,
+            encoding="utf-8", errors="replace",
         )
         assert r.returncode == 0
         assert r.returncode == 0