pasta_shiori

「伺か」SHIORI DLL インターフェースを提供するクレートです。

概要

pasta_shiori は pasta_lua を使用して SHIORI/3.0 プロトコルを実装し、従来の伺かユーザー向けのDLLインターフェースを提供します。

Windows DLL（pasta.dll）として出力され、伺かベースウェアから呼び出されます。

アーキテクチャ

pasta_shiori
├── SHIORI Protocol    # SHIORI/3.0 プロトコル実装
│   ├── load           # 初期化
│   ├── request        # イベント処理
│   └── unload         # 終了
├── Lua Integration    # pasta_lua ランタイムとの統合
│   ├── PastaLoader    # スクリプトロード
│   └── LuaRequest     # Luaへのリクエスト変換
└── Windows DLL        # C FFI エクスポート
    └── shiori32       # DLL エントリポイント

ディレクトリ構成

pasta_shiori/
├── Cargo.toml
└── src/
    ├── lib.rs           # クレートエントリーポイント
    ├── error.rs         # エラー型定義
    ├── shiori.rs        # PastaShiori - SHIORI プロトコル実装
    ├── shiori_tests.rs  # SHIORI テストモジュール（#[path]属性による例外的配置）
    ├── lua_request.rs   # Lua リクエスト処理
    ├── windows.rs       # Windows DLL エクスポート（#[cfg(windows)]）
    └── util/            # ユーティリティ関数

SHIORI プロトコル

プロトコルフロー

ベースウェア → shiori32.dll
                    ↓
               load(hinst, load_dir)     # 初期化
                    ↓
               request(SHIORI/3.0)       # イベント処理（繰り返し）
                    ↓
               unload()                  # 終了

サポートイベント

イベント	説明
`load`	初期化。`pasta.toml` 読み込み、ランタイム起動
`request`	SHIORI/3.0 リクエスト処理
`unload`	終了処理。リソース解放

SHIORI/3.0 リクエスト形式

GET SHIORI/3.0
Charset: UTF-8
Sender: SSP
SecurityLevel: local
ID: OnFirstBoot
Reference0: 1

レスポンス形式

SHIORI/3.0 200 OK
Charset: UTF-8
Value: \0\s[0]初めまして！\e

公開API

PastaShiori

メソッド	説明
`load(hinst, load_dir)`	ランタイム初期化
`request(request)`	SHIORI リクエスト処理
`Default::default()`	新規インスタンス作成

Shiori トレイト

pub trait Shiori {
    fn load<S: AsRef<OsStr>>(&mut self, hinst: isize, load_dir: S) -> Result<bool>;
    fn request<S: AsRef<str>>(&mut self, request: S) -> Result<String>;
}

使用例

Rust からの利用（テスト用）

use pasta_shiori::{PastaShiori, Shiori};

let mut shiori = PastaShiori::default();

// 初期化
let success = shiori.load(0, "path/to/ghost/master").unwrap();
assert!(success);

// リクエスト送信
let request = "GET SHIORI/3.0\r\nID: OnBoot\r\n\r\n";
let response = shiori.request(request).unwrap();
println!("Response: {}", response);

ゴーストディレクトリ構成

ghost/
└── master/                  # load_dir（SHIORIのload_dir）
    ├── pasta.toml           # 設定ファイル（必須）
    ├── dic/                 # Pasta DSL ソース
    │   └── *.pasta
    ├── scripts/             # Lua スクリプト
    │   └── pasta/
    │       └── shiori/
    │           └── entry.lua # SHIORI エントリーポイント
    └── profile/             # ランタイム生成
        └── pasta/
            ├── save/        # 永続化データ
            ├── cache/       # キャッシュ
            └── logs/        # ログ

依存関係

クレート	バージョン	用途
pasta_core	workspace	レジストリ
pasta_lua	workspace	Luaランタイム（pasta_dsl経由でDSLパーサーに依存）
time	0.3	タイムスタンプ処理
tracing	0.1	ロギング
thiserror	2	エラー型定義

Windows 専用

クレート	バージョン	用途
windows-sys	0.59	Windows API（メモリ、文字コード）

ビルド

Windows DLL

cargo build --release -p pasta_shiori

# 出力: target/release/pasta.dll

ライブラリ（テスト用）

cargo build -p pasta_shiori

cargo test -p pasta_shiori

外部仕様参照

SHIORI/3.0 仕様 - SHIORI プロトコル仕様
伺か - デスクトップマスコット基盤

ライセンス

プロジェクトルートの LICENSE ファイルを参照してください。

pasta_shiori 0.1.22