SakeScript

SakeSaySo の iOS および Android アプリは、英語学習向けのカスタムコンテンツ作成を支援するように設計されています。記事、物語、対話などのコンテンツは SakeScript 形式で構成されています。SakeScript は、マニフェスト、コンテンツ用 JSON、画像などの任意アセットを zip アーカイブにまとめるため、持ち運びや配布が簡単です。アプリはマニフェストを索引化し、検索しやすく魅力的な学習体験を提供します。

インポート方法:

コミュニティリポジトリ: ストーリーを共有する最も簡単な方法は、コミュニティ GitHub リポジトリを使うことです。このリポジトリはアプリにあらかじめ設定されており、プルリクエストがマージされると自動 GitHub Action によりアプリの検索インデックスが更新されます。
カスタムリポジトリ: 個人用のストーリーライブラリを Settings -> Advanced Settings -> Add Repository から追加できます。詳しくは Custom Repositories を参照してください。
アプリ内インポート: アプリのストーリーページで右上の + ボタンをタップし、SakeScript の .zip ファイルを選択します。

エクスポート方法:

アプリからストーリーを共有するには、まずストーリーを開き、情報ページへ進み、共有ボタンをタップします。

SakeScript 形式仕様

各 SakeScript ZIP アーカイブは、1 つの学習コンテンツ単位（たとえばストーリー、ニュース記事、レッスン、練習問題）を表します。アーカイブには次が含まれます。マニフェストファイル: 学習コンテンツのメタデータを含む manifest.json コンテンツファイル: main.json と、学習素材を構成する各種ファイル（テキスト、画像、音声） SakeScript アーカイブの作成には zip CLI を使えます。必要なファイル（JSON、画像など）をすべて含めてください。例: zip my-story-name.zip manifest.json main.json images/* main.json: コンテンツファイル形式 main.json には学習素材の本文を記述します。SakeScript は現在、story と article の 2 種類をサポートしています。各形式は以下の通りです。 title: 言語コードからタイトルへのマップ（例: "en": "The Mountain Trail"） cover: このフィールドは画像ファイルに対応します。uri には外部画像 URL（例: "https://example.org/cover.jpg"）またはアーカイブ内画像ファイルへの相対パス（例: "images/cover.jpg"）を指定できます。例: "cover": { "type": "image", "uri": "images/cover.jpg" // or "https://example.org/cover.jpg" } type: コンテンツ種別（"story" または "article"） chapters: 章の一覧 title (optional): 現時点では story 型でサポート。言語コードからタイトルへのマップ（例: "en": "About Tokyo"） sentences: 文の一覧 ja: 日本語文 en: 英語文 { "title": { "en": "Journey Through Japan", "ja": "日本の旅" }, "cover": { "type": "image", "uri": "https://www3.nhk.or.jp/news/html/20231111/K10014254991_2311111600_1111160953_01_02.jpg" }, "type": "story", "chapters": [ { "title": { "en": "About Tokyo", "ja": "東京について" }, "sentences": [ { "ja": "東京は日本の首都です。", "en": "Tokyo is the capital of Japan." }, { "ja": "新宿はにぎやかな場所です。", "en": "Shinjuku is a bustling area." } ] } ] } manifest.json: メタデータ形式各 SakeScript アーカイブの manifest.json には次のフィールドがあります。 ...

単語カードデッキ形式

SakeScript の単語カードデッキは Anki デッキよりずっと単純です。内容はプレーンテキスト形式の語彙、文、またはフレーズの一覧だけで、現在はデッキのインポートとエクスポートで説明しているように、辞書マッチングあり/なしで取り込んで使います。Anki デッキを変換する場合は、まず SakeSaySo に取り込むのがおすすめです。その後、アプリ内で内容をより整理されたシンプルな txt ファイルとして書き出せるため、共有や追加編集がしやすくなります。単純な txt 形式に加えて、SakeScript デッキは SakeScript ZIP アーカイブやコミュニティリポジトリ、その他の Git リポジトリを通じて共有できます。アーカイブには次が含まれます。マニフェストファイル: 学習コンテンツのメタデータを含む manifest.json コンテンツファイル: main.txt manifest.json: メタデータ形式各 SakeScript アーカイブの manifest.json は、通常の SakeScript 形式と同じです。 main.txt: コンテンツファイル「デッキ」は、持ち運び可能な zip ファイル内の main.txt に記述された単語カードの集まりです。このファイルには、単純なテキスト形式で学習リソースを記述します。英語→日本語でも日本語→英語でも使え、取り込み時には辞書マッチングを任意で適用できるため、相互参照やアプリ機能との統合がしやすくなります。例: 乾杯（かんぱい） cheers, bottoms-up, prosit 宴会（えんかい） party, banquet, reception コミュニティリポジトリに実例があります。

SakeScript ストーリーのインポートとエクスポート

このページでは、SakeScript の .zip ファイルを使ったストーリーや記事のやり取りについて説明します。標準では、SakeScript アプリは community と daily news リポジトリの両方にアクセスします。カスタムの HTTP ベースリポジトリも設定でき、GitHub 上でホストすることも可能です。詳しくはカスタムリポジトリのページを参照してください。 SakeScript のオンラインコンテンツは、一度ダウンロードするとオフラインでも利用できます。アプリは各ダウンロードの sha256 ハッシュを検証して整合性を確認し、zip ファイルを端末のドキュメントディレクトリに保存します。ストーリーをエクスポートするには、ストーリー情報ページへ移動し、ダウンロード後に (i) アイコンをタップすると、メッセンジャー、Google Drive、その他のプラットフォーム経由で zip ファイルを簡単に共有できます。

カスタムリポジトリ

このガイドの技術的な内容は、Git、GitHub、JSON テキスト形式にある程度慣れていることを前提にしています。 SakeSaySo の iOS および Android アプリは、主に次の 2 つのリポジトリ方式でカスタムコンテンツを扱えるよう設計されています。コミュニティリポジトリ: コミュニティ GitHub リポジトリへの参加は簡単です。このリポジトリはアプリに初期設定されており、プルリクエストがマージされると自動 GitHub Action によって検索インデックスが更新されます。カスタムリポジトリ: 個人向けに調整した学習体験のために、Settings -> Advanced Settings -> Add Repository からカスタムリポジトリを追加できます。カスタムリポジトリのセットアップアプリがカスタムリポジトリを利用するには、HTTP サーバー経由でアクセスできる必要があります。そこでは、各マニフェストを列挙した index.json をホストします。マニフェスト一覧には、相対パスで参照されるストーリー .zip ファイルと、整合性確認および更新追跡用の正しい sha256 チェックサムが必要です。 GitHub でホストする GitHub でも、コミュニティリポジトリと同様にカスタムリポジトリをホストできます。GitHub 上のリポジトリには次の形式を使ってください。 name: [repository name] uri: https://api.github.com/repos/<username or organization>/<repository name>/contents/ 必要に応じて weburl を指定すると、公開リポジトリの場合にリポジトリページに情報アイコン (i) が表示され、閲覧可能な GitHub ページへリンクできます。 weburl: https://github.com/<username or organization>/<repository name> ブランチ別コンテンツを使う場合（たとえばテスト用）は次のようにします。 branch: [branch name] 非公開リポジトリにアクセスする Basic 認証: Basic 認証保護されたサーバーでは、ユーザー名とパスワードをリポジトリ URL に含めます。 https://username:[email protected]/my/custom/repository GitHub PAT トークン: GitHub リポジトリでは、認証に Personal Access Token (PAT) を使います。トークンはアプリ内に直接追加します。 github_pat_[your_token] 注: 現在アプリが非公開リポジトリへのアクセスで対応しているのは、Basic 認証と GitHub PAT トークンです。 ...

日次ニュース集約のための GitHub Actions

このガイドでは、GitHub Actions を使って独自スクリプトをスケジュール実行し、タスクを自動化する方法を示します。 SakeSaySo は 2023 年以降の LLM によるコンテンツ生成の流れを取り入れ、ニュース集約プロセスで Anthropic AI を活用しています。私たちは Python より Go ベースのツールやスクリプトを好むため、GitHub Actions と組み合わせてこの種の処理を自動化しています。以下の設定は、cron スケジュールを含む構成例であり、同様の仕組みを自分用に再現する際の参考になります。 name: Go Scheduled Newswriter on: push: branches: [ master ] schedule: - cron: '0 21 * * *' # Runs at 21:00 UTC (6 AM JST) jobs: build: runs-on: ubuntu-latest steps: - name: Checkout Current Repository uses: actions/checkout@v2 - name: Checkout sakesayso/news Repository uses: actions/checkout@v2 with: repository: 'sakesayso/news' token: ${{ secrets.SAKESAYSO_WRITER_PAT }} path: 'news' - name: Set up Go uses: actions/setup-go@v2 with: go-version: '1.21' - name: Run Newswriter A env: ANTHROPIC_TOKEN: ${{ secrets.ANTHROPIC_TOKEN }} run: go run cmd/newswriter/main.go - name: Commit and Push Changes run: | cd news git config --global user.name 'sakebot' git config --global user.email '[email protected]' git add . git commit -m "Update from newswriter" || true git push この設定例では、リポジトリのチェックアウトから Go スクリプトの実行、更新の push までの流れを示しています。 ...