{
"$type": "com.whtwnd.blog.entry",
"blobs": [
{
"name": "a.png",
"blobref": {
"$type": "blob",
"ref": {
"$link": "bafkreidx6gnsc6x2w23nhnmmra4upslmmjhd2wqxeia4otqvz2x7uw7gtq"
},
"mimeType": "image/png",
"size": 2256555
},
"encoding": "image/png"
}
],
"theme": "github-light",
"title": "Klearskyの機能50選",
"content": "[「Bluesky Advent Calendar 2024」](https://adventar.org/calendars/10752) 12月21日分の記事です。\nBlueskyの3rdPartyクライアント「Klearsky」の知られざる機能を50個くらいまとめています。\n\n\n\n## Klearskyとは\n私（ [mimonelu](https://bsky.app/profile/mimonelu.net) ）が個人的に開発しているATProtocol/Bluesky用のWebクライアントです。特徴は以下の通り。\n\n* オープンソース（BSD-3-Clause license） ※ [GitHub](https://github.com/mimonelu/klearsky)\n* Cloudflareでホスティング ※ [https://klearsky.pages.dev](https://klearsky.pages.dev)\n* たぶんサーバレス\n* X/TwitterライクのわかりやすいUI\n* 公式アプリの機能＋α（色々な便利機能）\n* ややエンジニア寄りでリテラシーの高い人向けかもしれない\n* 2023年3月下旬あたりにリリースした老舗クライアント。もうじき90回目の更新を迎える。更新履歴は [こちら](https://klearsky.pages.dev/#/search/post?text=from:mimonelu.net+%E2%AD%90+Klearsky+|+%F0%9F%94%A5+Klearsky)\n\n「とにかく面白そうな機能は後先考えず実装してみようぜ」の精神で真っ先に地雷を踏んできました。以下に挙げる大体の機能はKlearskyが初めて実装した機能になります。たぶん。違ったらご指摘ください。大体役には立ちませんが、ひとつくらいは役に立つかも？ではどうぞ。\n\n## アカウント関連\n\n### アカウント作成機能\nたぶん他の3Pクライアントでは実装していない、アカウントを作成する機能です。が、あまりテストしていないので非推奨。公式から作成してください。ちなみにログイン時の二要素認証にも対応しています。OAuthはまだ。\n\n### メール認証アイコン\nメールアドレスの認証が済んでいるかどうかを✔アイコンでお知らせしています。認証しないと未成年扱いですよ。\n\n## 投稿関連\n\n### カスタムリンク\n本文中に `[文字列](URL)` と書くことで任意の文字列にテキストリンクを張れます。便利！\n\n### Zapリンク\n本文中に `@zap` と書くことでZapリンクを張れます。ただし「設定」→「その他の設定」→「Lightning」にアドレス類を入力しておくこと。もちろん閲覧者側もWallet of Satoshiなどのウォレットアプリをインストールしている必要があります。\n\n### アニメーション画像の添付／再生\nアニメーションGIF、アニメーションPNG（.apng）、WebPなどを添付できます。SVGもアニメーション付きで再生可能。ただし他のクライアントでは静止画像（JPEG）で表示されるでしょうね。たぶんKlearskyしか対応していないし、公式が対応しない限り3Pで対応してもね…といったところ。\n\n### （ポストの）カスタムラベル\nカスタムラベル（任意の文字列）を設定できます。何の役にも立ちません。エンジニアが遊びやテストで使うような機能です。\n\n### リストメンション\n任意のリストを選択して投稿すると、そのリストユーザーに通知が届きます（最大30人まで）。表面的には普通のポストで、通常のメンション文字列（ @mimonelu.net みたいな）が表示されることもありません。つまり表向きにはメンションしているかどうかすらわかりません。実際これは facets という内部機能を勝手に応用しているので褒められたものではないのですが、多数の知り合いに呼びかける際などには有用です。\n\n### 過去ポスト\nポストの投稿日時を変更できます。役には立ちませんが、例えば645年6月12日に設定して「大化の改新なう！」みたいな遊びができますね。ただし公式アプリでは投稿日時が改ざんされている旨が表記されるのでバレます。悪用はやめましょう。また最新のポストではないのでTL上にも流れてきません。これを利用して誰にも気付かれずにポストすることも可能と言えば可能です。\n\n### 「本日の投稿可能な動画数／動画容量」\nそのままですが、投稿可能な動画の本数と合計サイズを表示しています。この情報を表示しているクライアントは他にあるのかな？あってもまず見ないでしょうけど\n\n## 検索関連\n\n### 検索キーワードの保存\n検索キーワードを保存・呼び出すことができます。地味に便利。\n\n### `me`\n`me` チェックボックスをONにすると自分自身のポストから検索できます。 `from:me` と書くのと一緒。\n\n### トレンドタグ with SkyFeed\nSkyFeedが提供しているトレンドデータをタグクラウドっぽく一覧表示します。トレンドと言っても使用頻度の高いハッシュタグなので、大体が一人で同じタグを使い回しているよくわからないユーザーばかりですね…これは公式のトレンド機能が実装されたら撤去する予定。\n\n## 通知関連\n\n### 種類別タブボタン\nリプライやリポスト、引用RPなど通知の種類ごとにフィルタリングできます。通知数も表示。\n\n### 通知別にまとめて表示\n公式もこの形式ですが、取得した通知ごとにまとめる方式なので何度も同じ通知が表示されるんですよね。Klearskyはすべてひとつにまとめます。この機能はリリース当初から実装している自慢の機能なんですよ、はい。\n\n### フィードジェネレーターへのいいねを通知\n青いハートの通知がそれです。\n\n### スターターパック経由で新規登録したフォロワーを通知\nたしか、カードのアイコンが表示されている通知がそれです。うろ覚えです。\n\n## チャット関連\nチャットまわりは特に独自機能と呼べるものはありません。翻訳、DID・本文のコピー、ソースの表示くらいです。\n\n## ポスト関連\n\n### ポストを非表示にはしない方針\n機能というか方針なんですが、コンテンツフィルタやワードミュートなどにヒットしたポストでも完全には非表示にせず、折り畳んだ状態で表示します。これは「なるべくすべての情報を表示する、少なくとも存在はユーザーに知らせる」というKlearskyの方針によるものです。\n\n### 自動翻訳\nBluesky初の自動翻訳機能なんですよ。「設定」→「ポスト設定」→「自動翻訳」から設定可能。ポスト本文の下に翻訳を表示します。でもAPI制限もあるし、もっぱら本文中の「翻訳する」リンクで翻訳してますね。\n\n### 強制翻訳\n自動翻訳や「翻訳する」リンクはポスト言語が設定されているポストでのみ有効です。設定されていない外国語のポストを翻訳したい場合はポストメニューの「翻訳する」を選択してください。後はGoogle翻訳がよろしくやってくれます。\n\n### ブックマーク\nお気に入りのポストをブックマークできます。タグも付けられます。そしてデータはPDSに保存されるので閲覧環境が変わっても安心。カスタムコレクションを使った機能ですね。ちなみにSkyFeedでインポート可能なJSON形式に変換することもできます。\n\n### タイムフィード\n「特定のポストを基点として、その前後のポストを表示する」機能です。これは何に使うかと言うと、例えば何か興味を引くリポストが流れてきたとして、そのポストがどういった文脈で投稿されたのか気になったことはありませんか？それを解決するために実装した機能です。\n\n### 「この直後に投稿する」\n読んで字のごとし、前述の「過去ポスト」の応用で、そのポストの直後に投稿したように見せかける機能です。以前に投稿したポストを補足するようなポストを人知れず投稿したい時に役に立つ、かもしれません。\n\n### 固定ポスト\n今でこそ公式の機能ですが、最初に固定ポストを先走ってカスタムプロパティで実装したのは私でした。その後、例の悲劇が起きました。ということだけ伝えさせてください…\n\n### 各種コピー機能\n公式URLとかDIDとかハンドルとか本文とか、色んなものをコピーできます。メニューによって中身は変わるので注意。\n\n### 「外部アプリで開く」\nKlearskyと言えばこれですね。他のATProtocol/Bluesky関連サービスでポストやアカウントを開く機能です。Klearskyは早くから他の3Pサービスと連携する機能を開発していて、一時期はけっこうな数の3Pクライアントが名を連ねていました（クライアントは今は2つだけ…）。下4つはエンジニア向けです。\n\n### 「共有する」\n私にもよくわからないんですが、OS？ブラウザ？のシェア機能を呼び出せます。環境によっては項目自体表示されません。なんすかこれ？\n\n### 「ソースを表示する」\nポストやアカウントのデータ（APIレスポンス）を別タブで表示します。が、レスポンスそのものではなく、Klearskyが扱いやすいように整形したり、インジェクションしたデータが入っちゃったりしています…いやちょっとメモリがですね、はい\n\n### ポストメニューの「プロフィール」のアイコン\nさりげなくポストユーザーをフォローしている／されている状態をハートのアイコンで示しています。\n（Blueskyにはリストがあるし、フォロー機能自体必要ないと個人的には思っていますが…とりあえず。）\n\n### 添付画像を背景に設定する機能\nKlearskyには画像のURLを入力することで背景画像に設定できる機能があります（「デザイン設定」→「壁紙」）。で、ポスト画像を拡大表示した時に表示される左上のアイコンを押すと、自動的にその画像が背景画像になるってわけ。へぇ〜\n\n### リンクカードの埋込再生\nApple Music・Giphy・Spotify・Tenor・Twitch・YouTube・Vimeo・ニコニコ動画の埋込再生に対応しています。埋込再生も最初に実装したのはKlearskyなんですが、これがまた重いんですよ。そして見えないところでエラーが大量に発生しているはずです（私のせいではない）。なのでOFFにした方がよろしいかと\n\n### ラベル押下でラベラー設定を直接表示\n公式もこうすればいいのに。\n\n### 引用元の引用元を表示\n実はポストデータには「引用元の引用元」まで含まれています。で、Klearskyはそれを表示することが可能です。入れ子の入れ子ですね。\n\n## プロフィール関連\n\n### ハンドル変更履歴\nハンドル押下でハンドル変更履歴ポップアップが表示されます。主にエンジニア向け。なりすましの調査に利用したりすることもあります。\n\n### （アカウントの）カスタムラベル\nこれもエンジニアのおもちゃみたいな機能です。「プロフィールの編集」から設定できます。できますがしない方が良いと言っておきます。\n\n### 「ポスト検索」\nそのユーザーのポストだけを対象にして検索できます。 `from:ハンドル` と一緒。\n\n### 「最初のポストを見る」\nそのユーザーが最初に投稿したポストを前述した「タイムフィード」で表示します。つまり古い順でポストを閲覧できます。気になるあの人の最初のポストを見てみたい！という時にどうぞ\n\n### 「投稿画像をダウンロード」\n色々条件付きですが、そのユーザーが投稿した画像を一括ダウンロードしてZIPに固める機能です。悪用厳禁…とは言え悪用する人はこんな機能使わないか。一人で楽しむ人用の機能です。\n\n### 「APIをコールする」\nまさにエンジニアのおもちゃです。大体 `describeRepo` を叩くためにあります。自分自身のプロフィールメニューではさらに3つのAPIをコール可能。\n\n### Atmosphere コンテンツの表示機能\nこれもKlearskyを代表する機能ですね。カスタムコレクションを利用した他サービスのコンテンツを一覧表示します。最近はサービスの数も増えてきて追い付けていない感ありますが…というか全部対応するのは無理があるのでどうにかしたいところ。というかというか、この機能だけ別サービスとして切り出した方が良くないですか？私誰と喋ってるんですか？\n\n### 1日あたりの平均ポスト数\n何気に気に入っている機能です。フォローするかリストに入れるかの判断材料にどうぞ。\n\n### Blueskyの開始日\n「俺はこんな昔からいるんだぜ」と自慢したい時にどうぞ。嫌われます。\n\n### リポスト一覧機能\nそのユーザーのリポストを一覧表示します。自分自身のプロフィール画面ではいいねしたポストの一覧も表示できます。実はいいね一覧を初めて実装したのも公式ではなくKlearskyで、当時は他人のいいね一覧も表示していたんですが、精神衛生上よろしくないと思われたため撤去した過去があります。\n\n### おすすめユーザー一覧機能\nそのユーザーに関連するユーザーを一覧表示します。そういうAPIがあるので作ったわけなんですが、これ公式は使ってない？のかな？なんなのこれ？\n\n## フィード関連\n前提として、マイフィードは公式アプリと連動しています。\n\n### マイフィードのソート機能\nマイフィードポップアップの左上にあるアイコンでフィードをソートできます。いいねの多い順とか、名前順とか。ただし一度ソートしたら元に戻すことはできません。あしからず。\n\n### マイフィードのドラッグ＆ドロップによる入れ替え機能\nPC版には右サイドバーにマイフィード一覧があるんですが、そこでフィードをドラッグ＆ドロップして順番を入れ替えることができます。便利。\n\n## リスト関連\nリストも公式アプリと連動しています。\n\n### 「リストの複製」\n最近実装した機能ですね。文字通りリストを複製します。ただし色々条件付き。そしてAPI制限を受けやすい機能でもある。GitHubのフォークみたいなものです。\n\n### 「フォロー中ユーザーの検証」\nそのリストにフォローしているユーザーが含まれているかどうか検証します。これは「リストミュート・ブロックしたらそのリストにフォローしているユーザーも含まれていてさぁ大変」現象を回避するために実装しました。\n\n### リファレンスリストの表示\nリファレンスリストとはスターターパックで使用されるリストのことです。公式アプリでは表示されませんが、Klearskyでは表示できます。つまり後からスターターパックのユーザーを編集できます。\n\n## スターターパック関連\n\n### ユーザーをリストで指定\n公式アプリでスターターパックを作成する際はいちいちユーザーを一人ずつ指定する必要がありますが、Klearskyではリストで指定できます。簡単！\n\n### ユーザーリストの変更\nスターターパックを作成すると、自動的に登録したユーザーをまとめたリファレンスリストも作成されます。そしてKlearskyではスターターパックで使用するリストそのものを後から変更可能です。これができるのはKlearskyだけ！なぜか一部の海外ユーザーに重宝されているようです。\n\n## ラベラー関連\nラベラーまわりは特別な機能はありません。ラベルの説明文を翻訳できたりとか、その程度。なおラベラーアカウントのサムネイルは四角で表示されます。\n\n## その他\n\n### マイワード\nよく使う単語を保存して本文に挿入するだけの機能なので別にいいです。\n\n### ワードミュート\n公式のAPIは使わずに独自に実装しています。メリットとして、ひとつのワードミュートに複数のワードを設定でき、簡単にON/OFFできる、ローカルストレージだから保存が早い、などがあります。\n\n### メディアの制御\n画像や動画を表示しないようにできます。「適度」を選択するとフォロー中ユーザーのみ表示する、だったかな？\n\n### 時間表記の切替\n相対表記（「15分前」）と絶対表記（「10:15」）を切り替えられます。\n\n### 各種新着情報の取得間隔\n新着通知・新着チャット・新着フォロー中フィードを取得する間隔を設定できます。取得しないようにもできます。\n\n### 心理的安全性の設定\nリアクション数を非表示にしたり、ポストの投稿ユーザーを匿名化したりできます。これはもしかしたら撤去するかも\n\n### グローバルフィード\nリアルタイムにすべてのポストを表示するヤバい機能です。 `subscribeRepos` いわゆるFirehoseのデータをほぼそのまま表示しています（本当はJetstreamを使いたいんだけどWebなので…）。「いつか消す機能」筆頭なんですが、ずっと残ってますね。いつか消します。\n\n他にも正確に書き出せば上記の倍くらいはあるんですが、気持ち悪くなってきたのでやめます。\n\nKlearskyの今後については考えないようにしているので特にお伝えすることはありません。マイルストンなんて設定したら仕事になっちゃうし。行き当たりばったりです。まぁ、さしあたってはOAuthとリファクタ、パフォーマンス改善ですかね。特にリファクタ。今かなりひどいので…というわけで何か要望・不具合等ございましたらBlueskyか [GitHubのイシュー](https://github.com/mimonelu/klearsky/issues) へお願いします。\n\nそれでは良い年末を 三🦀\n",
"createdAt": "2024-12-21T08:31:24.318Z",
"visibility": "public"
}