[Mandatory reference when adding settings] Required steps when adding a new setting (e.g., v-switch / v-select) to KonomiTV. You must add entries to SettingsStore.ts, Settings.ts, config.py, and Settings/*.vue.
以下に、KonomiTV のフロントエンドに新しい設定フィールドを追加する際の手順を示します。
ブラウザの LocalStorage に JSON データで保存しています。
KonomiTV アカウントで同期が有効な際は、UI 表示中はサーバーが保持している設定データと双方向に同期されます。
サーバーと同期される設定と同期されない設定があり、後者はサーバー側には送られません。
まず自動同期する設定かしない設定かを把握する必要があります。
同期される設定とされない設定で記述内容が異なります。
また、各設定ごとのキー名は、必ず「見ただけである程度どのような設定項目なのかが理解できる」ものである必要があります。
すでに追加されている他のキー名の命名を参考にしながら、多少長くても意味が明快で、設定項目の実装詳細を端的に表している表現を用いてください。
次に、設定値が新しく追加された際、もしくははじめてそのブラウザで KonomiTV を開いた際のデフォルト値を把握しましょう。
また、設定値は原則「設定画面から直接変更できない設定値」->「L字画面のクロップ設定」-> 設定ページ上での並び順 (client/src/views/Settings/Base.vue などを参照) で記述してください。
フィールドは複数の箇所に追加する必要がありますが、原則個々の記述箇所でフィールドの並び順が共通でなければなりません。
client/src/views/Settings/ 以下に、各設定ページごとの .vue ファイルがあるので、一番適している位置（あるいは指定があったセクション）に新しい設定を、わかりやすく簡潔な言い回しの説明文と共に追加します。 HTML やフォーム UI の props は周囲のコードに合わせてください。
npx skills add tsukumijima/add-new-setting-field下载完整 Skill 目录，包含 SKILL.md 及所有相关文件
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer