SHIORI Resource — 3.0M‑Mac 仕様書（完全版 / UKADOC準拠）

ステータス: Draft / Ourin (macOS 10.15+ / Universal 2)
更新日: 2026-06-15 (JST) — 原本 SHIORI_RESOURCE_3.0M_SPEC_en-us.md から日本語版を整備
互換方針: UKADOC「[SHIORI Resourceリスト]」に載る全要素の名称・意味・返値を踏襲し、OS 依存値のみ macOS ネイティブ（M‑Diff）に置換。
対象: Ourin（ベースウェア）および SHIORI 実装者。

典拠: SHIORI Resource の一次情報は UKADOC を参照。項目名や返値の意味は UKADOC が正です。
本仕様は macOS 移植差分（M‑Diff）と実装上の統一方針を追加定義します。

1. 基本規約

• 文字コード: 既定 UTF‑8。互換のため CP932/Shift_JIS 受理→内部 UTF‑8 正規化可。
• 改行: CR+LF を受理（内部処理は LF 正規化可）。
• 返値の型: 文字列／数値／ブール（0/1 文字列）／色（R,G,B の整数）など。戻りはさくらスクリプトでない短文が基本。
• 省略時: 未対応・未設定は空文字を返す。*.visible は省略時 1（表示）。

2. M‑Diff（macOS 置換点）

• パス（*.filename / log_path / 各URL・画像パス）: POSIX 絶対パスまたは file:// URL を標準。Windows 形式が来た場合は受信側で正規化。
• 座標（*.defaultleft / *.defaulttop / 入力ボックス .default*）: ディスプレイ座標（ピクセル）。Ourin 内部では Cocoa の座標系差（原点位置）の吸収を行い、SSP と等価の表示位置になるよう変換。
• 色: menu.*.color.(r|g|b) は 0–255 の整数を推奨。
• 列挙: popupmenu.type 等の列挙値は SSP と同義。未知値は既定動作にフォールバック。

3. 要素一覧（完全）

3.1 SHIORI情報

3.2 ゴースト情報

デフォルト位置（画像/画面）

入力ボックス初期位置
(communicatebox|scriptbox|addressbar|teachbox|dateinput|timeinput|ipinput|sliderinput|passwordinput|inputbox).defaultleft / .defaulttop … ディスプレイ座標（ピクセル）。

おすすめ/ポータル

3.3 更新情報

3.4 オーナードローメニュー画像

3.5 オーナードローメニュー文字色

3.6 オーナードローメニュー項目名（caption 系）

以下の .caption キーはメニューに表示するラベル。Ourin では X.caption に対し X.visible（0/1）も受理し、未指定は 1（表示）とする。

activaterootbutton.caption, addressbarbutton.caption, alignrootbutton.caption,
alwaysstayontopbutton.caption, alwaystrayiconvisiblebutton.caption,
balloonhistorybutton.caption, balloonrootbutton.caption, biffallbutton.caption,
biffbutton.caption, calendarbutton.caption, callghosthistorybutton.caption,
callghostrootbutton.caption, callsstpsendboxbutton.caption, char*.recommendsites.caption,
charsetbutton.caption, closeballoonbutton.caption, closebutton.caption,
collisionvisiblebutton.caption, configurationbutton.caption, configurationrootbutton.caption,
debugballoonbutton.caption, definedsurfaceonlybutton.caption, dressuprootbutton.caption,
duibutton.caption, enableballoonmovebutton.caption, firststaffbutton.caption,
ghostexplorerbutton.caption, ghosthistorybutton.caption, ghostinstallbutton.caption,
ghostrootbutton.caption, headlinesensehistorybutton.caption, headlinesenserootbutton.caption,
helpbutton.caption, hidebutton.caption, historyrootbutton.caption, inforootbutton.caption,
leavepassivebutton.caption, messengerbutton.caption, pluginhistorybutton.caption,
pluginrootbutton.caption, portalrootbutton.caption, purgeghostcachebutton.caption,
quitbutton.caption, rateofuseballoonbutton.caption, rateofusebutton.caption,
rateofuserootbutton.caption, rateofusetotalbutton.caption, readmebutton.caption,
recommendrootbutton.caption, regionenabledbutton.caption, reloadinfobutton.caption,
resetballoonpositionbutton.caption, resettodefaultbutton.caption, scriptlogbutton.caption,
shellrootbutton.caption, shellscaleotherbutton.caption, shellscalerootbutton.caption,
sntpbutton.caption, switchactivatewhentalkbutton.caption,
switchactivatewhentalkexceptupdatebutton.caption, switchautobiffbutton.caption,
switchautoheadlinesensebutton.caption, switchblacklistingbutton.caption,
switchcompatiblemodebutton.caption, switchconsolealwaysvisiblebutton.caption,
switchconsolevisiblebutton.caption, switchdeactivatebutton.caption,
switchdontactivatebutton.caption, switchdontforcealignbutton.caption,
switchduivisiblebutton.caption, switchforcealignfreebutton.caption,
switchforcealignlimitbutton.caption, switchignoreserikomovebutton.caption,
switchlocalsstpbutton.caption, switchmovetodefaultpositionbutton.caption,
switchproxybutton.caption, switchquietbutton.caption, switchreloadbutton.caption,
switchreloadtempghostbutton.caption, switchremotesstpbutton.caption, switchrootbutton.caption,
switchtalkghostbutton.caption, systeminfobutton.caption, updatebutton.caption,
updatefmobutton.caption, updateplatformbutton.caption, utilityrootbutton.caption,
vanishbutton.caption, aistatebutton.caption, dictationbutton.caption, texttospeechbutton.caption

ショートカットキー
項目のショートカットキーは UKADOC の「ショートカットキー」節の規定に従う（キー設定で当該項目を起動）。

3.7 ツールチップイベント（補足）

tooltip / balloon_tooltip は ツールチップ表示時に参照されるイベント名。Ourin は UKADOC の推奨順に解決し、スクリプトを取得して表示する。

4. 返答規則と既定値

• 返答は短いテキスト（0/1 や連結文字列含む）。
• *.visible は省略時 1。
• おすすめ/ポータルの連結形式は [0x01]（SOH）と [0x02]（STX）で区切る慣例に従う。

5. 互換性と注意点

• SHIORI/3.0 準拠：Resource は SHIORI/3.0 の通常イベント扱いだが、返値がスクリプトではない点に注意。
• 未知キー：Ourin は未知の Resource でも透過で処理可能（将来拡張互換）。
• 画像パス：menu.*.bitmap.filename の相対はゴーストルート基準で解決。
• キャッシュ/SET：Ourin の ResourceBridge は 5 秒 TTL でキャッシュし、set(key:value:) による SET 上書き層を持つ（上書き値は SHIORI 問い合わせより優先、空文字で定義削除）。

6. 変更履歴

• 2025‑07‑27: 初版（3.0M‑Mac、全要素）。
• 2026‑06‑15: 日本語版を原本（en-us）から整備。ResourceBridge のキャッシュ/SET 追記。