Sedum Note

S3 互換のストレージか WebDAV のサーバーで同期する、エンドツーエンド暗号化（E2EE）のメモ帳です。Windows・macOS・Linux・Android のアプリ（Tauri）と、ブラウザで動く Web 版があります。アプリは CI の成果物から入れられます。

• メモ・ノートブック・写真は、このデバイスで暗号化してからストレージへ送ります。ストレージに置かれるのは暗号文とランダムな ID だけで、タイトルやノートブックの名前も見えません。
• オフラインでも書けます。つながったら、編集の 2 秒後と 60 秒おきに同期します。自動の同期はデバイスごとに切れ、切っても「今すぐ同期」は使えます。
• 2 台で同じメモを同時に変えても、両方の変更が 1 つのメモにマージされます（本文は Yjs。タイトルやピン留めなどは、あとに変えた方が残ります）。
• 同期しなくても使えます。同期は、あとから「設定」で足せます。
• 写真のほか、ファイルも添付できます（1 件 100 MB まで）。写真は、右下の持ち手をドラッグして大きさを変えられます（ダブルクリックで本文の幅に合わせる形に戻ります）。添付も 1 件ずつ暗号化します。添付した PDF は、メモの中でプレビューを開いて読めます（ページ送りと拡大）。アプリの中で録音して添付でき、添付した音声はその場で再生できます（PC では「/」の「録音」から始めます。録音の機能が無い環境では、録音のボタンと「録音」は出ません）。
• 「設定」から、メモ・ノートブック・添付を暗号化したまま 1 つのファイルに書き出せます。新しく入れたアプリの最初の画面の「バックアップから復元」で戻せます。
• 本文には、表、色付きのコード、ほかのメモへのリンクを入れられます。リンクは、リンク先のタイトルを変えても表示がついてきます。リンクにポインターを乗せると、リンク先の題と本文の頭が出ます。左の列のメモを本文へドラッグすると、落とした所にそのメモへのリンクが入ります。リンクされたメモの下には、リンクしているメモの一覧（バックリンク）が出ます。PC の画面の「グラフ表示」では、メモ同士のリンクのつながりを図で見られます。
• メモの中のブロック（段落、見出し、箇条書きの項目）へもリンクできます（「/」の「ブロックへのリンク」）。リンクにはそのブロックの今の文字が出て、押すとメモを開いてそのブロックまで送ります。リンクされたブロックは、動かしても書き換えてもリンクが付いていきます。Markdown では、ブロックの行の末尾の ^ID と、リンク先の後ろの #ID の形で往復します。
• 書類を撮って、傾きを直した画像として貼れます（「/」の「書類のスキャン」。スマホではカメラが開き、PC では写真を選びます）。写真の上で書類の四隅に印を合わせると、長方形に直します。画像はデバイスの中だけで処理します。文字の読み取りはしません。
• 手書きの線と図形（直線・四角・円）を描ける枠を、本文に入れられます（「/」の「手書き・図形」）。あとから描き足せ、消しゴムで線を 1 本ずつ消せます。線のデータとして持つので、2 台で同時に描いても両方の線が残ります。Markdown では、言語が sedum-drawing のコードの囲みと往復します。HTML で書き出すと、図として見えます。
• ほかのメモ（か同じメモ）のブロックを、本文の中に埋め込めます（「/」の「ブロックの埋め込み」）。埋め込みには元のブロックの今の中身が出て、元を書き換えると表示も変わります。埋め込みの側では書き換えられません。Markdown では、ブロックを指す ![タイトル](sedum-note://note/…#ID) だけの段落と往復します。HTML とテキストで書き出すと、元のメモのタイトルだけが残ります。
• クエリのブロックを置くと、条件（ノートブック、タグ、含まれる言葉、プロパティの値）に合うメモの一覧が、本文の中に出ます。
• 数式を LaTeX で書けます。行の中は $...$、独立した行は「/」のメニューの「数式」か $$...$$ です。表示の部品（KaTeX）は、数式を出すときにだけ読み込みます。
• コードのブロックの言語を mermaid にすると、中身を図として表示します（「/」のメニューの「図」からも入れられます）。図を押すと、元の文字を書き直せます。描く部品（Mermaid）は、図を出すときにだけ読み込みます。
• 段組み（2 段か 3 段）で、ブロックを横に並べられます。空の段には「ここに書く」が薄く出ます。スマホの幅では縦に並びます。Markdown で書き出すと、左の段から順に上から並びます。
• 脚注を入れると、本文に番号の印が付き、本文の下に脚注の文が並びます。Markdown では [^1] の形と往復します。
• 動画や Web ページを、URL で埋め込めます。メモを開いただけでは外へつながず、「読み込む」を押したときに初めて読み込みます。
• 注意や補足を目立たせるコールアウト（色付きの囲み）を入れられます。Markdown では > [!note] の形と往復します。
• 選んだ文字に、ハイライトと文字色を付けられます。ハイライトは Markdown の ==文字== と往復します。文字色と、表のセルの背景色は、Markdown で書き出すと落ちます。
• 表は、列の境目をドラッグして幅を変えられます。行と列を上下左右に足す、セルを結合する、ヘッダー行とヘッダー列を切り替える、列ごとに文字を揃える、行と列を隣と入れ替える、列の値で行をソートする、列に含まれる言葉で行をフィルターする、ができます。フィルターは表示だけで、メモを開き直すと解除されます。Markdown で書き出すと、列の幅は落ち、結合したセルは左上のマスだけに中身が残ります。
• PC の画面では、書式のボタンを本文の上に並べず、文字を選んだときだけ、その上に見出し・太字・斜体・下線・ハイライト・文字色・リンクと「AIに依頼」のボタンを出します。「AIに依頼」からは、選んだ所の言い換え・要約・英語や日本語への翻訳を頼め、答えで選んだ所を入れ替えられます。写真・ファイル・表・コードなどは「/」から入れます。カーソルが表の中にある間は、上のバーに表のメニューが出ます。スマホでは、画面の下にボタンが並びます。
• 本文で「/」を打つと、見出し（6 段まで）・リスト・表・画像などのブロックを選べ、今日の日付や今の日時も入れられます。長いメモには目次を出せます。子の項目を持つ箇条書きと、見出しは、折りたためます（Ctrl+Alt+[ ですべて折りたたみ、Ctrl+Alt+] ですべて開きます）。箇条書きの項目と、見出しのセクションにズームできます。項目は行頭の印を押すか、見出しは左に出るボタンを押すか、Ctrl+.（Mac は ⌘+.）かメモの「…」から選ぶと、その項目と子（見出しなら、次の同じ段か上の段の見出しの手前まで）だけが、題やタブなどを隠した画面いっぱいに出ます。左上の戻るボタンか Esc（または Ctrl+Shift+.）で、1 つ上の階層へ戻れます。PC の画面では、ブロックの左に出る持ち手をドラッグして、ブロックを並べ替えられます（箇条書きの項目は、子ごと動きます）。持ち手を押すとブロックのメニューが開き、見出し・箇条書き・引用・コードなどへの変換（何行かを選んでいれば、まとめて変換）、上下への移動、複製、削除ができます。持ち手の左の「＋」を押すと、すぐ下に行を足して「/」の候補が開きます。ブロックは Ctrl+Shift+↑↓ で上下に動かし、Ctrl+D で複製できます。「- 」「1. 」などで書式に変わった直後に Backspace を押すと、打った文字に戻ります。日本語入力をオンのまま「・ 」「ー 」「１． 」と打っても箇条書きになります。箇条書きは Tab で深く、Shift+Tab で浅くなり、番号は 1. → a. → i.、点は ● → ○ → ■ と深さごとに変わります。コードの中の Tab は字下げで、それ以外の所で Tab を押しても、カーソルは本文の外へ出ません。
• メモの中を検索でき（Ctrl+F）、当たった所に色が付きます。大文字と小文字の区別、単語単位、正規表現を切り替えられます。検索した言葉は、1 つずつ、または全部まとめて置換できます（Ctrl+R で置換の欄も開きます。正規表現では、置換の文字に $1 のような括弧の中身を使えます）。メモ全体の検索は、#タグ でタグに、notebook:名前 でノートブックに絞り込め（空白を含む言葉は "…" で囲みます）、結果の行には本文の中で当たった所が前後の文と一緒に出て、名前を付けて保存でき、左の列から同じ検索を開けます（保存した検索は同期されます）。メモの文字数も出ます。PC の画面にはキーボードショートカットがあります（一覧は「設定」の「ショートカット」。メモの「…」のメニューでも、項目の右にキーが出ます）。この README に書いたキーは既定のキーで、「設定」の「ショートカット」で、どこでも効くキーと本文・表の中のキーを変えたり、キーなしにしたりできます（Ctrl、Mac は ⌘ を含む組み合わせ。ほかのショートカットや、文字の編集・コピーなどに使うキーには割り当てられません）。変えたキーは、そのデバイスだけで使います。コマンドパレット（Ctrl+K）では、メモ（題と本文）・ノートブック・タグ・設定の項目・操作をまとめて探せます。何も打っていないときは、更新が新しいメモ（8 件まで）と、よく使う操作（新しいメモ、設定を開く、期限の一覧）が、ショートカットのキーと一緒に並びます。設定の項目を選ぶと、そのページのその項目へ移ります。「>」で始めると、操作だけを探します。打った言葉と同じ題のメモが無ければ、その言葉を題にして新しいメモを作れます。
• PC の画面には、左の列とツールバーを隠して本文だけにするフォーカスモードと、打っている行を中央に保つタイプライターモードがあります。
• PC の画面では、本文の列を左寄せ・中央・右寄せのどこに置くかを、メモごとに選べます（メモの「…」の「本文の配置」）。選んでいないメモは、「設定」の「一般」の「本文の配置（デフォルト）」に従います。
• メモをテンプレートにしておくと、そこから新しいメモを作れます。「/」からは、テンプレートの本文をその場に入れられます。テンプレートの題と本文に @date（日付）・@time（時刻）・@datetime（日時）・@title（メモの題）と書いておくと、メモを作るときや「/」で入れるときに、その時の値に置き換わります。@title は、作るときはできあがるメモの題、「/」で入れるときは入れる先のメモの題になります。日付と時刻の形式は、「設定」の「一般」の「テンプレート」で選べます（2026-11-13 の形か、画面の言語の書き方）。コードの中と、foo@date.example のように英数字に続く @ は置き換えません。テンプレートそのものは変わりません。
• メモの「…」から履歴を開けます。本文を編集し始める前の状態が約 10 分おきに残り、選んだバージョンにそのメモを戻せます。戻るのはタイトルと本文です。ノートブックやピン留めなどは今のままです。戻す前の状態も「復元前」として履歴に残ります。履歴は、メモごとに新しい方から 50 件までで、90 日より前のものは消えます。同期を設定していれば、暗号化して同期先にも置くので、ほかのデバイスで残したバージョンも見られます（履歴を開いたときに取ってきます）。バックアップには入りません。
• Markdown の文字を本文に貼り付けると、見出し・リスト・表・コードなどの書式になります。コードの中に貼り付けたときと、書式つきでコピーしたものは、そのまま貼り付きます。
• Markdown のファイル（.md）と、それをまとめた zip を取り込めます。書き出しは Markdown・HTML・テキストから選べ、ノートブックをフォルダにした zip になります。1 つのメモは、メモの「…」の「エクスポート」で形式を選んで書き出せます。書き出したファイルは暗号化されません。
• メモを複製できます。ほかのメモを結合すると、相手の本文が末尾に入り、相手はゴミ箱に入ります。
• Android では、ほかのアプリの「共有」から文字・写真・ファイルを受け取り、新しいメモにします。
• Android では、カメラでその場で撮って貼れます。ホーム画面のウィジェットとアイコンの長押しから、新しいメモを開けます。
• 写真は、貼るときに小さくできます（長い辺を 2048px まで）。既定は元のままです。
• メモは印刷でき、OS の印刷の画面から PDF にも保存できます（Android のアプリを除く）。
• 1 つのメモを、いくつものノートブックに入れられます。メモの「…」の「ノートブックを選択」で、入れるノートブックを選びます。ノートブックが多いときは、名前で絞り込めます。
• ノートブックには色とアイコンを付けられます。
• ノートブックごとに、メモのプロパティ（文字・数・日付・選択肢・チェックの項目）を決められます。そのノートブックのメモには、値を入れる欄が出ます。Markdown では、先頭の項目として書き出され、取り込むと文字のプロパティになります。
• PC の画面では、ノートブックの「データベース表示」で、メモをプロパティの列つきのテーブルか、選択肢のプロパティで分けたボードで見られます。値はその場で変えられ、並べ方と見え方はノートブックに保存されます。テーブルの下とボードの列の下の「新しいメモ」では、タイトルを打つとそのノートブックにメモができます（ボードでは、その列の値が入ります）。テーブルの見出しの右端の「＋」からは、プロパティを足せます。
• PC の画面では、左の列のメモをドラッグして、ノートブック・お気に入り・ゴミ箱へ移せます。ノートブックへは、行だけでなく、中のメモの上に落としても移せます。メモの「…」か右クリックから、名前の変更やゴミ箱への移動ができます。タブの並べ替えと、左の列の幅の変更もドラッグでできます。
• 左の列のメモは、Shiftを押しながら押すか、Shift+↑↓で、開かずに複数選べます。選んだメモはまとめてドラッグでき、右クリックからまとめてゴミ箱に入れられます。Ctrl（MacではCommand）を押しながら押すと、そのメモを別のウィンドウで開きます（Androidのアプリでは新しいタブ）。左の列は、↑↓ で行を移り、→← で一覧を開け閉めし、Enter で開けます。
• PCの画面で、サイドバーのメモを押すと、タイトルが斜体の「仮のタブ」で開きます。仮のタブは1つだけで、次にサイドバーで押したメモと入れ替わります。メモに書く、タブかサイドバーの行をダブルクリックする、ピン留めする、ドラッグで並べ替えると、普通のタブになります。中クリックと、検索の結果やリンクから開いたメモは、普通のタブで開きます。
• PC の画面のタブは、切り替えて戻ると、本文のスクロール位置とカーソルの位置が元に戻ります。タブの右クリックで、ほかのタブや右のタブを閉じたり、ピン留めしたりできます。閉じたタブは Ctrl+Alt+Shift+T で開き直せ、タブの並びの右端のボタンから、開いているタブを一覧で選べます。
• スマホの一覧では、メモを右へ払うとピン留めを付け外しし、左へ払うとゴミ箱に入れます。同期先があれば、一覧をいちばん上から下へ引いて離すと同期します。
• Androidのアプリでは、チェックボックスやスイッチを押したときと、一覧のスワイプと引っ張って同期で操作が決まる所まで指を動かしたときに、短く振動します。設定の「一般」の「操作したときに振動する」で切れます。
• メモをゴミ箱に入れると、その場で元に戻せる知らせが出ます。
• ゴミ箱のメモを、決めた日数がたったら完全に削除できます。既定は削除しません。
• テーマは 6 種類から選べ、色を選んで自分のテーマも作れます。自分で書いた CSS（カスタム CSS）も当てられます。言語は日本語と英語です。メモの並び順と、本文の文字の大きさ・字の間・行の間も選べます（設定の画面で見本の文を見ながら変えられます）。これらの設定はデバイスごとで、同期しません。
• メモとチェックリストの項目に、期限を付けられます。メモは「…」の「メモの期限を設定」、項目は本文の「/」の「期限」で付けます。項目の期限は、項目の文字の中の「📅 2026-11-15 09:00」の形の印で、手で打つこともでき、Markdown でもそのまま往復します（時刻を省くと朝 9 時）。期限のあるものは、期限の一覧（Ctrl+Alt+E）に、期限切れ・今日・これから に分かれて並び、項目はそこからチェックを付けられます。
• 「設定」の「期限の通知」を入れると、期限が来たときに OS の通知で知らせます。PC のアプリと Web 版は、開いていてロックを解除している間に通知します（閉じていた間に過ぎた 1 日以内の期限は、次に開いたときに通知します）。Android のアプリは、通知を端末に予約するので、アプリを開いていなくても出ます。Windows と Mac のアプリは、「ウィンドウを閉じても、バックグラウンドで実行する」を入れると、ウィンドウを閉じても終了せず、通知の領域（Mac はメニューバー）のアイコンに残ります。ロックを解除したままなら、閉じている間も通知します。通知には項目の文字とメモの題が出ます。
• 2 つのメモを、左右に並べて開けます（メモの「…」か、タブの右クリックの「右に並べて開く」。PC の画面）。右のメモは、左で別のメモを開いても、開いたままです。
• メモを、別のウィンドウで開けます（メモの「…」の「別のウィンドウで開く」か、左の列のメモをCtrl（MacではCommand）を押しながら押す。PC のアプリと、PC のブラウザの Web 版）。元のウィンドウのロックを解除していれば、別のウィンドウはパスフレーズを聞かずに開きます。PC のアプリでは、ウィンドウを最前面に固定できます（メモの「…」の「ウィンドウを最前面に固定」）。
• 同じメモを 2 つのウィンドウ（Web 版なら 2 つのタブ）で開いて書いても、どちらの編集も残ります。同期は、そのうち 1 つのウィンドウが受け持ちます。
• スペースで、メモの保管先を分けて、切り替えて使えます（「設定」の「一般」の「スペース」で足します。仕事用と個人用のように）。スペースごとに、手元の保存・同期先・暗号化キーが別になります。パスフレーズは、そのデバイスの全部のスペースで同じです（足すときに確かめ、変えるときは全部のスペースで変わります）。スペースを切り替えて戻るときは、ロックするまで、パスフレーズを聞きません。同期・期限の通知・MCP は、開いているスペースのものだけが働きます。AI と MCP の設定は、スペースごとに入れます。スペースの名前は、このデバイスの中に、暗号化せずに置きます（同期先には送りません）。
• Ctrl+L（Mac は Command+L）か「設定」の「ロック」で、アプリをその場でロックできます。開くには、起動のときと同じパスフレーズを入れます。ロックは全部のウィンドウで共通で、どれかのウィンドウでロックすると、別のウィンドウやほかのタブで開いている分も、一緒にロックされます。PCのアプリでは、どれかのウィンドウでロックを解除すると、ロックの画面のままのほかのウィンドウも開きます。Web版では、メモを開いた別のウィンドウと、それを開いた元のウィンドウの間でだけ、解除が伝わります（ほかのタブは、それぞれパスフレーズで解除します）。
• 「設定」の「セキュリティ」の「操作が無いときに自動でロック」で、どのウィンドウでもキー・マウス・タッチ・スクロールの操作が無いまま、選んだ時間（15分・45分・1・3・6・12・24時間か、1分〜7日で指定）が過ぎると、自動でロックします。アプリが裏にある間やスリープしていた間も時間は進み、画面に戻ったときに過ぎていればロックします。デフォルトはオフで、このデバイスだけの設定です。
• パスフレーズを忘れたときや、デバイスを手放すときは、そのデバイスのデータを消せます（ロック解除の画面と「設定」）。同期先のメモは消えません。

AI からの操作（MCP）

デスクトップのアプリは、MCP に対応した AI のクライアントから、メモを検索・読み取り・作成・書き換えできる窓口を持っています。既定はオフで、「設定」の「AI」のページの「MCPサーバー」で開きます。MCP が入っているのは PC 版（Windows・macOS・Linux のアプリ）だけで、Web 版と Android のアプリには入っていません。

• 窓口が開いているのは、アプリのロックを解除している間だけです。ロックすると閉じます。
• このマシンの中（http://127.0.0.1:47821/mcp）からしかつながりません。クライアントには、設定に出るトークンを Authorization: Bearer で渡します。
• 対応しているのは、MCP の仕様 2026-07-28 の HTTP（Streamable HTTP）です。それより前の手順（initialize で始める形）でつなぐクライアントからはつながりません。Claude Code 2.1 と、公式のクライアント（@modelcontextprotocol/client 2.4 で versionNegotiation を auto にしたもの）でつながることを確かめています。
• AI が読んだメモは、暗号化されない形で AI の提供元へ送られます。
• 本文は Markdown でやり取りします。本文の書き換え（replace_note_body）は、変わったブロックだけを入れ替え、直していないブロックの書式（文字色など）を残します。長い本文は、get_note の offset と maxCharacters で分けて読めます。本文を書き換える前の状態は、そのメモの履歴に残ります。完全な削除は、設定で許したときだけできます。

アプリ内の AI

AI とチャットして、メモについて質問したり、要約や書き直しを頼んだりできます。AI は、メモを探して読み、作り、直すこともできます（MCP と同じ操作です）。既定はオフで、「設定」の「AI」のページの「AIチャット」で、つなぎ先を入れて有効にします。メモの「…」の「AIチャット」か、ショートカット（Ctrl+Alt+A）で開きます。PC では画面の右の欄に、スマホではダイアログに出ます。

• つなぎ先は、Claude の API か、OpenAI 互換のエンドポイント（Ollama などのローカルの LLM、OpenAI の API）から選びます。API キー（とエンドポイント）を入れて「保存して接続を確認」を押すと、つなぎ先から使えるモデルの一覧を取ってきます。取れたときだけ保存し、モデルはその一覧から選びます。チャットの上でも、モデルを切り替えられます。
• 発言には、文脈を添えられます。開いているメモ、選択している文字（範囲指定）、入力欄で「@」を打って題で探したメモです。何を添えているかは、入力欄の上に出ます。
• 添えたメモの本文、選択した文字、AI が読んだメモの本文は、暗号化されない形でつなぎ先へ送られます。ローカルの LLM をつなぎ先にすれば、このマシンの外へは出ません。添付の中身は送りません。
• AI は、答えを考える途中で、メモの検索・読み取り・作成・本文の書き換え・末尾への追記・題やノートブックの変更・ゴミ箱への出し入れ・ノートブックの作成と削除を、続けて何回でも行えます。何をしたかは、答えの中に 1 行ずつ出ます（行を押すと、そのメモを開きます）。止めるボタンは、答えを受け取っている間も、承認を待っている間も、ツールを動かしている間も効きます。
• AI に任せる操作は、「設定」の「AI」のページの「AIに任せるメモの操作」で、種類ごと（メモの検索・読み取り／メモとノートブックの作成・編集／ゴミ箱への移動・ノートブックの削除／完全な削除）に「許可しない」「毎回確認」「確認せずに許可」から選びます。既定は、検索・読み取りは「確認せずに許可」、作成・編集とゴミ箱への移動・ノートブックの削除は「毎回確認」、完全な削除は「許可しない」です。
• 答えは、コピーするか、開いているメモのカーソルの位置か末尾に入れられます。
• 「毎回確認」の操作は、答えの下のカードで、何をするか（本文は、消すブロックと足すブロックの差分）を見てから「許可」か「拒否」かを選びます。1 つの答えに変更がいくつかあるときは 1 枚のカードにまとまり、選んだものだけを行えます。承認を待つ間に対象のメモが変わったら、その変更は行いません。
• 本文の書き換えで入るのは、変わったブロックだけです。直していないブロックの書式（文字色など）はそのまま残ります。書き換える前の状態は、メモの履歴に「置き換え前（AI・MCP・プラグイン）」として残り、開いているメモならエディタの取り消し（Ctrl+Z）でも戻せます。AI が読んだあとで書き換えたメモは、AI が読み直すまで本文を書き換えさせません。チャットの下の「このチャットでは、メモの作成・編集に承認を求めない」は、そのチャットの間だけ、作成・編集の許可を「確認せずに許可」と「毎回確認」で切り替えます。
• OpenAI 互換のつなぎ先がツール（function calling）に対応していなければ、ツールを使わずに、添えたメモだけで答えます。
• 会話は、答えが届くたびに、このデバイスのこのスペースに暗号化して残します（新しい方から 50 件まで）。チャットの上の「チャット履歴」から開いて続きを話せ、1 件ずつ消せます（開き直した会話では、AI は前に読んだメモの本文を覚えていないので、必要なら読み直します）。同期とバックアップには入りません。添えたメモは、会話の中には本文の写しを残さず、送るたびに今の本文を読みます（消したメモは、消えたことだけを AI に伝えます）。
• API キーは、そのデバイスだけに暗号化して保存します。同期とバックアップには入りません。

プラグイン

プラグインで、メモの「…」のメニューにコマンドを足せます。「設定」の「プラグイン」に、GitHub のリポジトリ（所有者/リポジトリ/フォルダ@タグ の形か、GitHub の URL）を入れて取り込みます。入れる前に、プラグインが読むもの・書くもの・足すコマンドを確かめられます。

• プラグインは、外の関数を何も使えない WebAssembly として動きます。受け取るのは、コマンドを実行したときに開いているメモのうち、宣言したもの（題・本文・選択した文字）だけです。通信も、保存も、ほかのメモを読むこともできません。
• 入れたプラグインは、取り込んだコミットのものに固定されます。「更新を確認」を押したときだけ、取り込み元を見にいき、変わっていれば、できることを見せ直してから入れ替えます。
• プラグインは、暗号化してそのデバイスのそのスペースに置きます。同期はしません。
• 見本は plugins/text-tools にあります（取り込み元は aida0710/sedum-note/plugins/text-tools）。選択した行の並べ替え、重なった行の削除、文字数の表示、行末の空白の削除を足します。
• 形式の仕様は docs/plugins.md にあります。

アプリの更新

デスクトップのアプリは、ロックを解除したときに新しいバージョンがあるかを確かめ、あれば「設定」からダウンロードして入れ替えられます。入れ替える前に、配布元の署名を確かめます。Android のアプリは、新しいバージョンがあることを知らせ、リリースのページを開きます。Web 版は、開くたびに最新のものが届きます。

「設定」の「更新」の「更新を確認する」を押すと、いつでも確かめられます（Web 版も）。最新なら確かめた時刻と一緒にそう出し、確かめられなかったとき（回線が無いときなど）は、最新とは言わずにそう出します。Web 版で新しいバージョンが見つかったら、「読み込み直して更新」でページを読み込み直します。

確かめるときは GitHub へつなぎます。送るのはアプリのバージョンと OS の種類だけです。ロックを解除したときの確認は、「設定」の「更新」で止められます。

メモのデータの形（本文の書式や、記録の書き方）を変えたバージョンでは、データの形の版を上げます。古いバージョンのアプリで新しい形のメモを開くと、古いアプリが知らない書式を本文から消してしまうためです。どれか 1 台を新しいバージョンに上げて同期すると、ほかのデバイスは、アプリを更新するまで同期を止めて更新を求めます。新しいバージョンのアプリは、ロックを解除したときに、手元のメモを新しい形に移し替えます。決まりは docs/data-format.md にあります。

同期先の用意

S3 互換のストレージなら、サービスを問わず同期先にできます（AWS S3、Cloudflare R2、自分で立てた MinIO や SeaweedFS など）。条件は、条件付き書き込み（If-Match・If-None-Match）を守ることだけです。アプリはつなぐときにこれを確かめ、守らないストレージには同期先として設定させません。

ストレージ	エンドポイント	リージョン
AWS S3	https://s3.<リージョン>.amazonaws.com	バケットのリージョン（例: ap-northeast-1）
Cloudflare R2	https://<アカウント>.r2.cloudflarestorage.com	auto
自分で立てたサーバー	そのサーバーの URL（https）	そのサーバーの設定に合わせる

バケットの名前は、エンドポイントに含めず、別の欄に入れます。実際に同期まで確かめたのは、Cloudflare R2 と SeaweedFS です。

WebDAV のサーバーも同期先にできます（同期先の種類で「WebDAV」を選び、メモを置くフォルダの URL と、ユーザー名・パスワードを入れます）。条件は S3 と同じで、条件付き書き込みを守ることです。守らないサーバーは、つなぐときの確認で断ります。書き込みの応答に ETag を返さないサーバーでは、書いた直後に読み戻して確かめます。実際に同期まで確かめたのは、Apache（mod_dav）と Nextcloud です。Web 版から WebDAV につなぐには、サーバーの側で、Web 版の origin からの要求（PROPFIND・MKCOL・PUT・DELETE と、If-Match・If-None-Match・Depth・Authorization のヘッダー）を許し、ETag を見せる CORS の設定が要ります。

アプリ（Windows・macOS・Linux・Android）は、バケットとアクセスキーを作るだけでつながります。

同期先を入れて「接続を確認」を押すと、そこに何があるかで次に入れるものが決まります。

• 空の同期先なら、そこに新しく作ります。ほかのデバイスを加えるときに使う「暗号化キー」は、自動で生成するか、自分で入力するかを選べます。生成したキーは、作成のあとに 1 度だけ表示します。
• 既存のメモがあれば、その暗号化キーを入れて参加します。
• フォルダを入れずに確かめると、バケットの直下とそのすぐ下のフォルダから既存のメモを探します。1 か所だけ見つかれば、そこを同期先にします。

2 台目からは、同期先を手で入れずに済みます。参加済みのデバイスの「設定」→「同期」→「同期設定をエクスポート」で、QR とファイルを出せます。加えるデバイスの最初の画面で、カメラで QR を読むかファイルを選び、暗号化キーを入れると、同期先が入って確認まで進みます。書き出したものは、暗号化キーが無いと読めません。

パスフレーズと暗号化キーは別のものです。

• パスフレーズは、そのデバイスのロックを解除するためのものです。デバイスごとに決められ、変えても同期先とほかのデバイスは変わりません。自分で決めるほか、強いものを生成できます。
• 暗号化キーは、同期するデバイス全部で共通です。あとから表示し直せませんが、「設定」で作り直せます。作り直すと、前のキーでは参加できなくなります。参加済みのデバイスはそのまま同期を続けられます。メモは暗号化し直さないので、前のキーと、作り直す前の vault.json の写しを持っている人は、これからのメモも読めます。

同期に続けて失敗する間は、間隔を 5 分まで延ばしてやり直します。アクセスキーが断られたときなど、待っても直らない失敗では、自動の同期を止めて理由を出します。

v0.2 までのアプリで作った同期先は、暗号化キーが無いので、今のアプリでは使えません。そのデバイスにメモが残っていれば、「設定」の「同期先を変更」で空のフォルダを同期先にすると、メモをそこへ送り直し、前の同期先の添付も写します。ほかのデバイスは、新しい同期先に参加し直します。

Web 版はブラウザからストレージへ直接つなぐので、Web 版を使うときだけ、バケットに CORS の設定が要ります。入れる設定は、Web 版の最初の画面と「設定」に出ます。

[
  {
    "AllowedOrigins": ["https://aida0710.github.io"],
    "AllowedMethods": ["GET", "PUT", "HEAD", "DELETE"],
    "AllowedHeaders": ["*"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

v0.2.1 までのアプリは、アプリからつなぐときにも CORS の設定が要ります（AllowedOrigins に http://tauri.localhost と tauri://localhost）。

暗号化の形

メモと添付は、ランダムなマスターキー（AES-256）で暗号化します。マスターキーは、置き場所ごとに別の秘密から Argon2id（64 MiB、3 回）で作ったキーで包みます。手元ではそのデバイスのパスフレーズで包み、同期先の vault.json では暗号化キーで包みます。パスフレーズと、それで包んだものは、同期先に置きません。メモと添付は 1 件ごとに AES-256-GCM で暗号化し、記録の ID を追加認証データに入れます。そのため、ストレージの上で暗号文を別の ID へ入れ替えても開けません。同期先の認証情報も、マスターキーで暗号化して手元に保存します。

ロックを解除したウィンドウは、マスターキーをメモリにだけ持ちます。ほかのウィンドウをパスフレーズなしで開くときは、そのウィンドウに頼まれてから、マスターキーを取り出せない形（CryptoKey）のまま渡し、どこにも保存しません。PCのアプリでは、アプリのウィンドウの間（BroadcastChannel）で渡します。Web版のページの出どころ（github.io）はほかのページと共有なので、BroadcastChannelには流さず、アプリが開いた別のウィンドウと元のウィンドウの間でだけ、相手のウィンドウへ直接（postMessage）渡します。受け取ったウィンドウは、そのマスターキーが手元のvaultのものかを確かめてから開きます。

ストレージには次のものを置きます。

キー	中身
<フォルダ>/vault.json	暗号化キーで包んだマスターキーと Argon2id の値
<フォルダ>/records/<id>	メモ・ノートブック 1 件の暗号文
<フォルダ>/blobs/<id>	写真など 1 件の暗号文
<フォルダ>/versions/<メモの id>/<版の id>-<残した時刻の暗号文>	メモの履歴 1 件の暗号文。古い履歴を一覧だけで見分けて消せるよう、残した時刻を名前に入れています。時刻はマスターキーで暗号化してあり、ストレージからは読めません

開発

Node.js 22 と npm 11、Rust（stable）が必要です。

npm ci
npm run dev            # ブラウザで画面を開く
npm test               # 単体試験
integration/s3-up.sh   # 試験用の S3 互換サーバー（SeaweedFS、127.0.0.1:18333）
integration/webdav-up.sh  # 試験用の WebDAV サーバー（Apache、127.0.0.1:18480）
npm run test:integration
npm run e2e            # ブラウザでの画面の試験（2 台の同期を含む）
npx tauri dev          # デスクトップのアプリ
npx tauri android dev  # Android（Android SDK・NDK と JDK 21 が必要）

アプリの Rust 側を変えたときは、scripts/app-checks/linux/build-app.sh で、Linux のアプリを Docker のコンテナの中で組み立てられます（WebKitGTK の開発用パッケージを手元に入れずに済みます）。

エディタに書式（ノードやマーク）を足したときや、記録の書き方を変えたときは、src/core/format/dataFormat.ts の DATA_FORMAT_VERSION を 1 つ上げます。足す前のアプリがその書式を本文から消さないようにするためです。手元の記録を新しい形にする手順が要るときの決まりは、docs/data-format.md にあります。

docs/releases/<タグ>.md を置いて v0.2.0 の形のタグを push すると、CI がインストーラーと、アプリの更新用の latest.json を GitHub Releases に置きます。CI は Linux で、古いバージョンから組み立てた AppImage へ実際に更新する予行もします。

License

Apache License 2.0

アイコンと、設定の「このアプリについて」の絵（public/app-artwork.webp、作者: aida0710）も、同じ Apache License 2.0 で公開しています。

アプリに入れている、ほかの人が作ったソフトウェアのライセンスは、アプリの設定の「このアプリについて」の「ライセンス」で見られます。一覧は npm run licenses で作ります（依存を足したり版を上げたりしたら流し直します。流し忘れは単体試験が見つけます）。