From 796251e5b0da524584c9e81b8ad6e1dcc0931aa3 Mon Sep 17 00:00:00 2001 From: tanaka takashi Date: Sat, 12 Sep 2026 21:19:16 +0900 Subject: base prompt結合機能を追加 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit config.tomlの[prompt]でpositive/negativeのbase promptファイルを指定し、 MCP経由でLLMから渡されたプロンプトと結合してpipelineへ渡す機能を追加する。 プロンプトファイルは/prompts/に固定し、TOMLにはファイル名のみ 指定する。モデルパスと同じ方針でパストラバーサルを拒否する。 結合方式: - positive: base_positive, user_positive の順でカンマ区切り - negative: base_negative\nuser_negative の順で改行区切り - baseが空の場合はuserプロンプトのみ（後方互換） - [prompt]省略時はbase promptなし（後方互換） 結合場所はschema.pyのTextToImageRequest.create()に集約し、GuidedImageRequest とInpaintImageRequestは内部でTextToImageRequest.create()を呼ぶため1箇所の 変更で3ツールすべてに適用される。MCP Tool入力にはbase promptを公開しない。 変更内容: - config.py: PromptConfig dataclass、AppConfig.promptフィールド、 _read_promptヘルパー、load_configの[prompt]読込・validation追加。 positive_file/negative_fileはファイル名のみ受け付け、/prompts/へ解決 - schema.py: _combineヘルパー、TextToImageRequest.create()に base_positive/base_negative引数追加、GuidedImageRequest.create()と InpaintImageRequest.create()から転送 - tools/generate_image.py: service.config.promptからbaseを取りcreate()へ渡す - tools/generate_guided_image.py: 同上 - tools/inpaint_image.py: 同上 - tests/conftest.py: app_config fixtureにprompt=PromptConfig()追加 - tests/test_config.py: [prompt]の正常系・異常系テスト追加 (省略時空、ファイル読込、パストラバーサル拒否、ファイル不存在、positiveのみ) - tests/test_schema.py: 結合ロジックのテスト追加 (base両方、positiveのみ、negativeのみ、base空、guided/inpaint転送) - doc/config.md: §10 [prompt]セクション追記、設定項目一覧表・ディレクトリ構成・ 全設定例更新、既存セクション番号を§11〜§13へ繰り下げ - config.example.toml: [prompt]コメント例追記 - doc/Specifications.md: モデル構成表にBase prompt行追加、推奨ディレクトリに prompts/追記、設定例更新 - doc/Design.md: 設定オブジェクトにPromptConfig追記、モデルパス解決表に prompts/追加 - doc/mcp.md: §2.1にbase prompt結合の記載追記 - README.md: [prompt]設定例と結合規則の説明追記 検証: - ruff format/check、pyright 0 errors、pytest 61 passed - 実GPU・実モデルでstreamable-http経由generate_imageでbase prompt結合を確認 positive='masterpiece, best quality, ..., sharp focus, a small red cube on a white table' negative='low quality, ..., jpeg artifacts\nnoise' base前置・user後置の結合順序が仕様通り機能することをサーバログで検証済み --- src/mcp_sd15/schema.py | 34 ++++++++++++++++++++++++++++++---- 1 file changed, 30 insertions(+), 4 deletions(-) (limited to 'src/mcp_sd15/schema.py') diff --git a/src/mcp_sd15/schema.py b/src/mcp_sd15/schema.py index e22450d..184cc8d 100644 --- a/src/mcp_sd15/schema.py +++ b/src/mcp_sd15/schema.py @@ -49,6 +49,14 @@ def _size(value: str | ImageSize | None, default: str) -> ImageSize: raise InvalidRequestError(f"unsupported size: {value}") from exc +def _combine(base: str, user: str, *, separator: str) -> str: + if not base: + return user + if not user: + return base + return f"{base}{separator}{user}" + + @dataclass(frozen=True) class TextToImageRequest: positive_prompt: str @@ -63,10 +71,14 @@ class TextToImageRequest: size: str | ImageSize | None = None, *, default_size: str = ImageSize.SQUARE_512, + base_positive: str = "", + base_negative: str = "", ) -> TextToImageRequest: + user_positive = _prompt(positive_prompt, "positive_prompt", required=True) + user_negative = _prompt(negative_prompt, "negative_prompt", required=False) return cls( - _prompt(positive_prompt, "positive_prompt", required=True), - _prompt(negative_prompt, "negative_prompt", required=False), + _combine(base_positive, user_positive, separator=", "), + _combine(base_negative, user_negative, separator="\n"), _size(size, default_size), ) @@ -89,9 +101,16 @@ class GuidedImageRequest: size: str | ImageSize | None = None, *, default_size: str = ImageSize.SQUARE_512, + base_positive: str = "", + base_negative: str = "", ) -> GuidedImageRequest: base = TextToImageRequest.create( - positive_prompt, negative_prompt, size, default_size=default_size + positive_prompt, + negative_prompt, + size, + default_size=default_size, + base_positive=base_positive, + base_negative=base_negative, ) try: mode = ControlMode(control_mode) @@ -120,9 +139,16 @@ class InpaintImageRequest: size: str | ImageSize | None = None, *, default_size: str = ImageSize.SQUARE_512, + base_positive: str = "", + base_negative: str = "", ) -> InpaintImageRequest: base = TextToImageRequest.create( - positive_prompt, negative_prompt, size, default_size=default_size + positive_prompt, + negative_prompt, + size, + default_size=default_size, + base_positive=base_positive, + base_negative=base_negative, ) for label, value in (("input_image", input_image), ("mask_image", mask_image)): if not isinstance(value, str) or not value.strip(): -- cgit v1.2.3