docs: #902 の注意書き

VOICEVOX · Dec 22, 2024 · cde2707 · cde2707
1 parent bf7448d
commit cde2707
Show file tree

Hide file tree

Showing 5 changed files with 28 additions and 1 deletion.
diff --git a/crates/voicevox_core/src/nonblocking.rs b/crates/voicevox_core/src/nonblocking.rs
@@ -9,8 +9,12 @@
 //! スレッドプールのサイズは、blockingクレートの説明にある通り`$BLOCKING_MAX_THREADS`で調整すること
 //! ができる。
 //!
+//! また未調査ではあるが、[`cpu_num_threads`]を`0`にするのは適切ではない可能性がある ([VOICEVOX/voicevox_core#902])。
+//!
 //! [blocking]: https://docs.rs/crate/blocking
 //! [pollster]: https://docs.rs/crate/pollster
+//! [VOICEVOX/voicevox_core#902]: https://github.com/VOICEVOX/voicevox_core/issues/902
+//! [`cpu_num_threads`]: crate::InitializeOptions::cpu_num_threads
 
 pub use crate::{
     engine::open_jtalk::nonblocking::OpenJtalk,

diff --git a/crates/voicevox_core/src/synthesizer.rs b/crates/voicevox_core/src/synthesizer.rs
@@ -97,6 +97,15 @@ pub enum AccelerationMode {
 #[derive(Default)]
 pub struct InitializeOptions {
     pub acceleration_mode: AccelerationMode,
+
+    /// CPU利用数を指定。0を指定すると環境に合わせたCPUが利用される。
+    ///
+    /// # Performance
+    ///
+    /// 未調査ではあるが、[非同期版API]においては`0`にするのは適切ではない可能性がある ([VOICEVOX/voicevox_core#902])。
+    ///
+    /// [非同期版API]: crate::nonblocking
+    /// [VOICEVOX/voicevox_core#902]: https://github.com/VOICEVOX/voicevox_core/issues/902
     pub cpu_num_threads: u16,
 }
 

diff --git a/crates/voicevox_core_python_api/python/voicevox_core/_rust/asyncio.pyi b/crates/voicevox_core_python_api/python/voicevox_core/_rust/asyncio.pyi
@@ -157,7 +157,8 @@ class Synthesizer:
     acceleration_mode
         ハードウェアアクセラレーションモード。
     cpu_num_threads
-        CPU利用数を指定。0を指定すると環境に合わせたCPUが利用される。
+        CPU利用数を指定。0を指定すると環境に合わせたCPUが利用される。未調査ではあるが、 ``0`` にするのは適切ではない可能性がある
+        (`VOICEVOX/voicevox_core#902 <https://github.com/VOICEVOX/voicevox_core/issues/902>`_)。
     """
 
     def __init__(

diff --git a/crates/voicevox_core_python_api/python/voicevox_core/asyncio.py b/crates/voicevox_core_python_api/python/voicevox_core/asyncio.py
@@ -1,3 +1,14 @@
+# TODO: Rust API同様に、`$BLOCKING_MAX_THREADS`について言及
+"""
+非同期API。
+
+Performance
+-----------
+
+未調査ではあるが、 ``cpu_num_threads`` に ``0`` にするのは適切ではない可能性がある
+(`VOICEVOX/voicevox_core#902 <https://github.com/VOICEVOX/voicevox_core/issues/902>`_)。
+"""
+
 # pyright: reportMissingModuleSource=false
 from ._rust.asyncio import Onnxruntime, OpenJtalk, Synthesizer, UserDict, VoiceModelFile
 

diff --git a/crates/voicevox_core_python_api/python/voicevox_core/blocking.py b/crates/voicevox_core_python_api/python/voicevox_core/blocking.py
@@ -1,3 +1,5 @@
+# TODO: Rust API同様のmodule levelのdocstringを書く
+
 # pyright: reportMissingModuleSource=false
 from ._rust.blocking import (
     AudioFeature,