feat: 既存Misskeyフォークの独自機能をAiscriptで再現

[hitalin]

背景

Misskey のフォーク群には「サーバーを改造しないと無理」な機能と、「実はクライアント層だけで十分再現できる」機能が混在している。後者は本家 Misskey / NoteDeck に乗ったまま misstore の AiScript プラグイン・ウィジェット・クエリとして提供できるはずで、フォークを乗り換えずに同等の体験を得られるようにしたい。

主要フォーク 36 件の README / 独自 CHANGELOG / 独自ブランチのコミットを調査した結果は下のコメントにカタログとして残してある。

実現レイヤーの分け方

層	手段	再現できるもの
L1	AiScript プラグイン (register_note_view_interruptor / note_post_interruptor / note_action / user_action / post_form_action)	ノートの表示加工、投稿前加工、メニュー追加、API 叩き
L2	NoteDeck ウィジェット (AiScript App)	常駐処理・定期実行・独自 UI が要るもの
L3	カラムフィルタクエリ (notedeck#783)	「見せる / 隠す」だけで済むもの
L4	再現不可	連合・DB・ロール・モデレーション・AP の実装が必須なもの

採否の基準（実装を通して固まったもの）

1. UI がネイティブで完結するか — プラグインは CSS を注入できず独自 UI も持てない。使えるのはノート / ユーザーメニュー、投稿フォームのボタン、Plugin:config の設定画面だけ
2. 本文テキストを汚さないか — note_view_interruptor で本文に印やバッジを差し込む手法はコピペや引用に混入するので採らない
3. 常駐に依存しないか — 「時間が来たら消える / 投稿される」系はクライアントが開いている間しか動かない。発火保証のない機能を保証があるかのように出さない

実装状況

機能	出典	層	エントリ	状態
カクヨム形式のルビ振り	隠れ家	L1	plugins/kakuyomu-ruby	✅ e512fd8
技術系オートリンク	tempura, taiyme	L1	plugins/tech-autolink	✅ 52f7627
CW ⇄ 本文の入れ替え	MISTEMS	L1	plugins/cw-swap（仮）	📝 未着手
ハッシュタグミュート	MISTEMS	L3	queries/hashtag-hide（仮）	📝 未着手

✅ ルビ振り（e512fd8）

｜漢字《かんじ》 → $[ruby 漢字 かんじ]。MFM の ruby は text.split(' ') で親文字を切るため、親文字やルビに空白を含む場合は変換しない。《》 を引用符として使う日本語文への誤爆を避けるため縦棒は必須。コード内も対象外。

✅ 技術系オートリンク（52f7627）

CVE / JVN / JVNVU / JVNTA / JVNDB / DLsite / ニコニコ動画 / GitHub コミットハッシュ。tempura の tms/rj-number.ts が表示時に VNode を差し込むのに対し、こちらは投稿時に Markdown リンクへ落とすのでプラグイン未導入の閲覧者やリモートのサーバーでもリンクになる。

誤検出対策として本家フォークの正規表現より条件を厳しくした：

• コミットハッシュは 16 進の連なりを読み切って 40 桁ちょうどのみ採用（tempura の [0-9a-f]{40} は SHA-256 の先頭 40 桁にマッチする）
• 前後に英数字が隣接する場合は語中とみなして変換しない（XCVE-2024-1234 / CVE-2024-1234x）
• コード / URL 内 / Markdown リンク内 / ハッシュタグは変換しない。二重変換しても壊れない
• リンク先 URL は大文字の正規 ID に正規化する
• ニコニコは sm に加えて nm / so にも対応

📝 残りの 2 件

CW ⇄ 本文の入れ替え — MkPostForm.vue の showActions を確認済み。プラグインに渡るのは text と cw だけで必要十分だが、update は typeof value !== 'string' で握り潰すため null を渡して CW をオフにできない。CW が空の状態で swap すると欄が開いたまま空で残るので、そのケースは実行せずダイアログで知らせる。

ハッシュタグミュート — notedeck#783 の allowlist で note.tags は NormalizedNote に存在せず不採用とされているため、note.text.lower().incl("#タグ") の否定形になる。str.incl / str.lower は QIR の演算 allowlist 内なので層 1（高速パス）に乗るが、否定形は FTS5 プリフィルタに押し込めない（keyword-hide と同じ性質）。前方一致の誤爆（#技術書典 が #技術書典2024 に当たる）も meta に明記する。

実装メモ（AiScript / プラグイン API の落とし穴）

2 本の実装で踏んだもの。次のエントリでも効く。

• out は予約語 — 変数名に使うと構文エラーになる
• "...".incl("") は true を返す — 1 文字ずつ判定する関数では空文字チェックを先に入れないと、文末で誤判定する（実際にオートリンクの初版がこれで全件スキップした）
• Str:tab は存在しない — 空白判定は / 　 / Str:lf で組む
• 正規表現がない — 文字単位の手書きスキャナを書く。pakuru が先例
• note_post_interruptor は同期実行 — 確認ダイアログも Mk:api も使えない。したがって「投稿時に黙って本文が書き換わる」形になるので、post_form_action の明示変換を既定にし、自動変換は Plugin:config のオプトインにするのを定石とする（post-guard の設計と同じ結論）
• テストは実インタプリタで回せる — @syuilo/aiscript@1.2.1 を入れて Plugin:* を values.FN_NATIVE のダミーとして注入すれば、plugin.is にテストコードを連結して実行できる。ルビ振り 24 ケース / オートリンク 44 ケースはこの方法で検証した

保留（品質基準を満たせないもの）

機能	出典	理由
公開範囲の色分け / 青ふぁぼ・赤ふぁぼ	Ebisskey, MISTEMS	CSS を注入できず、絵文字プレフィックスでの近似は本文を汚す
セルフリノート省略 / Renote 省略条件	隠れ家	note_view_interruptor はノートの非表示化を保証しない
nyaize 無効化 / インク節約モード	tempura, Ebisskey	表示テキストの後段書き換えになりコピー時に加工後テキストが混入する
エアリプ / ニックネーム登録	Ebisskey, tempura	プラグインに自由入力 UI がない（Mk:dialog は表示のみ、Mk:confirm は yes/no のみ）
予約投稿 / ノートの自動消滅	tempura, 隠れ家	クライアント常駐依存で発火保証がない
アカウント整理（一括削除）	tempura	破壊的 × 常駐依存
タイムマシン	MISTEMS	L2 なら実現可能。プラグイン 4 件が片付いてから再検討する

L4: 再現不可（参考・対象外）

• ノート編集 + 編集履歴 + 編集の連合（serafuku）— AP の実装が必須
• セミパブリック（LTL 非掲載の public ノート）、コミュニティロール、ロール宛お知らせ（tempura）
• ホスト単位の公開範囲制限 / モデレーターによる公開範囲降格 / canIgnoreSensitiveWords（hoto.moe）
• VRTL / VSTL 本体（anatawa12）— nodeinfo 拡張とサーバー側 TL 実装が必要。L3 クエリでサーバー allowlist による近似は可能
• リモートと同名のリアクション、PGroonga 全文検索（paricafe）、オブジェクトストレージ PATH 分離・孤立 S3 掃除（tempura, serafuku）
• 禅モード（隠れ家）、加入承認制、dimension（MisskeyIO）ほかサーバー設定・UI シェル本体に手を入れるもの

進め方

• 1 機能 = 1 エントリ = 1 PR / コミット
• 出典フォークは meta.json の説明と plugin.is の冒頭コメントに明記して敬意を払う
• フォーク側の実装が読める場合は必ず読み、同等以上（誤爆耐性・連合先での見え方）を目標にする

[hitalin]

調査結果: フォーク別 独自機能カタログ

fedidb 等のフォーク一覧から実インスタンスを持つ主要フォーク 36 件について、README・フォーク固有 CHANGELOG・フォーク独自ブランチのコミットを実際に取得して確認した。以下は「独自機能あり」と確認できたものだけ。

独自機能が大量にあるフォーク

lqvp/misskey-tempura（9 インスタンス / フォーク 2 位）— 「隠居向け・お一人様向け」。差分が最大 (diff.md)

• 予約投稿、ノートの自動消滅（添付ファイルも同時削除）、後から非公開化（ローカルは論理削除・リモートは物理削除）
• セミパブリック（LTL に載らない public ノート）、ダイレクトリノート、ダイレクト宛先リストの保存/呼び出し
• コミュニティロール、ロール宛お知らせ、ユーザー個別通知、フォロー/フォロリク履歴
• 未ログインユーザーへの露出を潰すプライバシー設定群（RSS/Atom/JSON フィード無効化、リアクションユーザー閲覧制限、鍵アカの検索除外、認証要求の拡充）
• アカウント整理（public/home/followers のノートと添付を一括消去）、孤立 S3 ファイルの自動クリーンアップ、オブジェクトストレージの PATH 分離、リモートメディアのキャッシュ期間設定
• CVE/JVN/JVNVU/JVNTA/JVNDB・RJ番号・nicovideo・GitHub コミットハッシュの自動リンク化
• DeepLX-JS 対応、ListenBrainz 連携（Sharkey と連合）、ニックネーム、nyaize 無効化、本文 8192 文字
• 直近では LLM によるモデレーション（LLMmod）で API を選択可能にするコミットも入っている

hideki0403/kakurega.app（隠れ家）— ユーザー体験の QoL 全振り (相違点一覧)

• 禅モード（TL を隠して投稿フォームだけ表示）、ノートの自己消滅（時限ノート）
• 日の出/日の入りに合わせた自動テーマ切り替え、カスタムフォント
• カクヨム形式のルビ振り、ミュート & ブロック同時実行、GTL 限定サーバーミュート、ユーザー単位の GTL 有効/無効
• Patreon 連携によるロール自動付与、登録フォームの年齢確認、新規アカウント登録制限
• デッキのカラムフィルター、セルフリノート省略、Renote 省略条件のカスタマイズ、複数付箋ウィジェット、モバイルデータ時の自動データセーバー

mistems/mistems — 「ほしい機能詰め込み改造」

• タイムマシン（過去のタイムラインを遡る）
• リアクション数に応じてノートが青ふぁぼ/赤ふぁぼ化（閾値はコントロールパネルで設定）
• ハッシュタグミュート、チャンネル既読同期、CW ⇄ 本文の入れ替えボタン、チャンネルピッカー
• Bluesky 投稿の埋め込み表示、検索を本文のみ/本文+CW で切替、期間指定ショートカット
• フォロー数が多いユーザーのホーム TL 構築の高速化、FTTL 歯抜け修正など運用系も厚い

serafuku/misskey（韓国語圏）— 技術的に一番尖っている

• ノート編集機能 + 編集履歴 + 編集の連合（raw diff 表示付き）
• リモートメディアのキャッシュ期間設定、外部ファイルアクセス時の再キャッシュ、用途別 S3 PATH 分離、孤立 S3 ファイル掃除
• 加入承認制、リモートのフォロー/フォロワー数を相手サーバー基準で表示、リモート絵文字の同名補完

shrimpia/misskey（Ebisskey）— 発想が独創的 (CHANGELOG)

• エアリプ機能、なでなで（他人のなでなでがリアルタイムで見える）、ジョーク機能「インク節約モード」
• 公開範囲の色分け、自分用メモ、パクる、メディア TL、「トゲのある」絵文字属性
• 独自機能を Shrimpia Labs から個別にオン/オフできる設計

連合・運用まわりで見どころのあるフォーク

フォーク	独自機能
anatawa12/misskey（+ niri-la, m-hayabusa）	VRTL / VSTL（ぶいみみリレータイムライン）。リレー参加サーバー横断の LTL 相当。nodeinfo に vmimiRelayTimelineImplemented を生やしてサードパーティから検出可能にし、汎用ブランチ + drop-in な Docker イメージで他フォークに配布できる形にしている
hotomoe/hotomoe	モデレーション特化。ホスト単位の public ノート可視性制限、モデレーターによるノート公開範囲の降格、canIgnoreSensitiveWords ロール、削除ノートの返信を tombstone で保全、リモートユーザー名の同期、trusted inbox relay
MisskeyIO/misskey	misskey.io 実運用由来。dimension（次元）、投稿/表示言語のデフォルト有効化、起動〜listen 時間短縮、Admin API でのインスタンスキャッシュクリア
paricafe/misskey	PGroonga によるノート全文検索、Pari Plus、承認制、AP の分散ロック / リモートノート更新の直列化
tiramiss-community/endolphin	唯一の「引き算」フォーク。ページ/ギャラリー/実績/Games/チャート等を削除しつつ、削除済み endpoint は read 系＝空応答、write 系＝410 FEATURE_REMOVED で API 互換を維持
taiyme/misskey	mfm-js を自前フォークして RJ番号記法を MFM に追加、アプリ内ウィンドウの挙動改善
heartles/egirlskey	Sharkey ベース。Iceshrimp.NET 向けに既定リアクションを Like で送る、LD 署名の well-known context 圧縮、ミュートキーワードを投票・メディアにも適用

調査したが対象外としたもの

• CGsama/misskey、4rkng/nagisky — v12 世代で更新停止
• nyaone, Otaku-Social/maniakey, CyberRex0/misskey-cbrx, grapeapple0, 2510, miyakogi, t1nyb0x, ZerglingGo, Ogame3334, Akkiesoft, Bymnet1845, 4erdac ほか — 公開ブランチ上は upstream 追従が主で、独自機能の記述・コミットを確認できず（ブランド差し替えや運用設定のみと思われる）
• HanasakiNayori/misskey-tempura、sylphre/hotomoe — それぞれ tempura / hoto.moe の再フォーク

[hitalin]

実装対象を 4 件に確定

前コメントの候補から ルビ振り / 技術系オートリンク / CW ⇄ 本文入れ替え / ハッシュタグミュート の 4 件に絞る。Misskey 本体と notedeck#783 の実装を読んで実現可能性と UI/UX を詰めたので、その結果を残す。

---

1. カクヨム形式のルビ振り（出典: 隠れ家）

実現可能性: ○（制約あり）

MFM には ruby 関数が存在する。ただし実装は以下の通りで、親文字に空白を含められない：

// packages/frontend/src/components/global/MkMfm.ts
case 'ruby': {
  return h('ruby', {}, [text.split(' ')[0], h('rt', text.split(' ')[1])]);
}

｜親文字《ルビ》 → $[ruby 親文字 ルビ] の変換自体は note_post_interruptor で完結する。ただし AiScript に正規表現がないため、pakuru と同様に文字単位の手書きスキャナを書くことになる（｜ / | / 《 / 》 を舐めるだけなので難度は低い）。コードブロック・インラインコード・URL 内をスキップする処理は品質のために必須。

UI/UX

• レンダリングは本家の MFM がそのまま行うので、見た目はフォーク版と同一
• ⚠️ 前コメントで「連合先でもルビとして表示される」と書いたが、正確には MFM を解釈する実装（Misskey 系）でのみルビになる。MFM 非対応の実装で $[ruby ...] がどう見えるかは AP 変換後の HTML 次第なので、実装前に実測が要る
• 親文字に空白が入るケース（英単語など）は変換対象から除外し、警告を出すのが誠実

---

2. 技術系オートリンク（出典: tempura, taiyme）

実現可能性: ◎

CVE / JVN / RJ番号 / GitHub コミットハッシュを Markdown リンクに変換するだけ。こちらも正規表現がないので手書きスキャナだが、空白区切りのトークン単位で先頭一致を見るだけで済むためルビより単純。

taiyme は RJ番号を MFM 構文そのものに追加している（mfm-js を自前フォーク）が、本プラグインは Markdown リンクに落とすため、mfm-js に手を入れずに済み、かつ他実装にもリンクとして届くという利点がある。ここはフォーク実装に対する明確な優位点。

UI/UX

• ⚠️ リンク化で本文が確実に長くなる。note_post_interruptor は投稿処理の途中で走るため、変換後に文字数上限を超えるとサーバー側で弾かれる。上限に近いノートでは変換をスキップするガードが必要
• 変換対象の種別（CVE / JVN / RJ / commit hash）は Plugin:config の boolean で個別にオン/オフできるようにする

---

3. CW ⇄ 本文の入れ替え（出典: MISTEMS）

実現可能性: ◎（ただし CW を空にはできない）

本体の実装を確認した：

// packages/frontend/src/components/MkPostForm.vue (showActions)
action.handler({
  text: text.value,
  cw: cw.value,
}, (key, value) => {
  if (typeof key !== 'string' || typeof value !== 'string') return;
  if (key === 'text') { text.value = value; }
  if (key === 'cw') { useCw.value = value !== null; cw.value = value; }

分かったこと：

• プラグインに渡るのは text と cw だけ。この機能に必要な情報は過不足なく揃っている
• update は value が string でないと握り潰される（typeof value !== 'string' で return）。したがって null を渡して CW をオフにすることはできない。useCw.value = value !== null の分岐は事実上常に true になる

UI/UX

• ⚠️ CW が空の状態で swap すると、CW 欄が開いたまま空になる（閉じられない）。「CW → 本文」方向の片付けが最後まで綺麗に終わらないのがフォーク版との唯一の差。CW が空のときは swap を実行せずダイアログで知らせるのが無難
• ⚠️ プラグインアクションは投稿フォーム下部の 🔌 ボタン → ポップアップメニューという 2 タップ。フォーク版はフォームに専用ボタンが 1 つ生えるので、ここは構造的に劣る。ただし snippet-palette で確立済みの導線であり、ストアの他エントリと一貫はしている

---

4. ハッシュタグミュート（出典: MISTEMS）

実現可能性: ○（text 判定になる）

notedeck#783 のフィールド allowlist を確認したところ、note.tags は NormalizedNote に存在しないため不採用とされている。したがって note.text.lower().incl("#タグ") の否定形で書くことになり、形としては既存 keyword-hide の裏返しになる。

使用するのは str.incl / str.lower のみで、どちらも QIR の演算 allowlist に含まれるため 層 1（コンパイル成功 = 高速パス）に乗る。

UI/UX

• streaming 適用は同期 QIR 評価なので体感は既存の hide 系クエリと同じ
• ⚠️ ただし 否定形は FTS5 プリフィルタに押し込めない（プリフィルタの健全性規則が「連言・正極性」を要求するため）。ローカルキャッシュのバックフィル時は走査上限に当たり得る。これは keyword-hide / server-hide と同じ性質なので新規のリスクではないが、meta の説明に書いておく
• ⚠️ text 判定なので 前方一致で誤爆する（#技術書典 を隠すと #技術書典2024 も隠れる）。テンプレートのコメントで明示し、必要なら長いタグを先に書く運用を案内する

---

実装順の提案

順	エントリ	理由
1	ハッシュタグミュート（query）	既存 keyword-hide の派生で最小コスト。仕様上の不確定要素ゼロ
2	CW ⇄ 本文入れ替え（plugin）	本体実装を読んで挙動が確定済み。実装は数十行
3	技術系オートリンク（plugin）	スキャナが単純。文字数ガードだけ注意
4	ルビ振り（plugin）	スキャナが最も重く、MFM 非対応実装での見え方の実測が要る

2・3 に共通する設計方針として、note_post_interruptor による自動変換だけにすると 投稿ボタンを押した後に黙って本文が書き換わる ことになり、ユーザーが結果をプレビューできない（post-guard に書いた通り interruptor は同期実行なので確認ダイアログも挟めない）。そこで post_form_action に「変換して本文に反映」も併設し、自動変換のほうは Plugin:config のオプトインにする二段構えを推奨する。これなら変換結果を目で見て、気に入らなければ Undo できる。