Q: Blinko の Markdown エクスポートで 'Unauthorized' エラーにより 1KB の画像ファイルが生成される問題の修正方法

これは、Blinko の Markdown エクスポートが `/api/file/ ` を通じてオリジナル画像をダウンロードする際に、認証が必要なことが原因で発生します。エクスポートジョブはトークンや Cookie を付与しないため、API は `{"error":"Unauthorized"}` を返し、その JSON が画像ファイルとして保存されてしまいます（そのため約1KBのサイズになります）。なお、`/api/file/ ?thumbnail=true` は匿名アクセスのために意図的に開放されていますが、オリジナルファイルのエンドポイントは常に認証が必要です。 回避策: 1. エクスポートする前にノートを公開/共有に設定してください。これにより画像エンドポイントで認証が不要になり、画像が正しくエクスポートされます。 2. 画像の URL にトークンパラメータを手動で追加してください（例: `/api/file/pic01.png?token= `）。組み込みのエクスポート機能はこれを自動的には行わないため、エクスポートされたファイルまたはエクスポートコードを自分で修正する必要があります。 3. 別の方法として、ログインなしで動作するサムネイルエンドポイント（`?thumbnail=true`）経由で画像をダウンロードすることもできます。

Question 1

Blinkoでノートを思考に切り替えたときに、なぜwebhookがトリガーされないのですか？

Accepted Answer

Blinkoの既知のバグにより、ノートのタイプを変更した（例：'note'から'thought'、またはその逆）際にwebhookが発火しません。根本原因：`server/routerTrpc/note.ts`内の`upsert`関数は`content`がnullのときに早期リターンし、タイプのみの変更ではcontentが省略されるため、`SendWebhook`呼び出しがスキップされます。修正するには、おおよそ行668～735のコードを以下のように変更します：

```ts
if (content == null) {
  SendWebhook({ ...note, attachments }, isRecycle ? 'delete' : 'update', ctx);
  return note;
}
```

これにより、タイプのみが更新された場合でもwebhookが確実にトリガーされます。恒久的なリリース修正については、この問題を追跡してください。

Question 2

Blinkoで一番下までスクロールしても、すべてのノートが読み込まれないのはなぜですか？

Accepted Answer

まず、見つからないノートが誤ってアーカイブされていないか確認してください。アーカイブ済みノートのビュー/フィルターを開き、必要に応じてアーカイブを解除してください。ページにスクロールバーがないためにページネーションがトリガーされないだけの場合は、Ctrlキーを押しながらマウスホイールを下に回してズームアウトし、スクロールバーが表示されたら一番下までスクロールして追加の項目を読み込んでください。また、PR #1069でページネーションの重複項目の問題が修正されているため、Blinkoを最新バージョンに更新してください。

Question 3

Blinko の Markdown エクスポートで 'Unauthorized' エラーにより 1KB の画像ファイルが生成される問題の修正方法

Accepted Answer

これは、Blinko の Markdown エクスポートが `/api/file/` を通じてオリジナル画像をダウンロードする際に、認証が必要なことが原因で発生します。エクスポートジョブはトークンや Cookie を付与しないため、API は `{"error":"Unauthorized"}` を返し、その JSON が画像ファイルとして保存されてしまいます（そのため約1KBのサイズになります）。なお、`/api/file/?thumbnail=true` は匿名アクセスのために意図的に開放されていますが、オリジナルファイルのエンドポイントは常に認証が必要です。回避策: 1. エクスポートする前にノートを公開/共有に設定してください。これにより画像エンドポイントで認証が不要になり、画像が正しくエクスポートされます。 2. 画像の URL にトークンパラメータを手動で追加してください（例: `/api/file/pic01.png?token=`）。組み込みのエクスポート機能はこれを自動的には行わないため、エクスポートされたファイルまたはエクスポートコードを自分で修正する必要があります。 3. 別の方法として、ログインなしで動作するサムネイルエンドポイント（`?thumbnail=true`）経由で画像をダウンロードすることもできます。

Question 4

なぜDocker build from sourceはmonorepoの依存関係で'Could not resolve'エラーが発生して失敗するのですか？

Accepted Answer

これは、プロジェクト内のesbuild.config.tsがexternalリストから必要なパッケージを多く欠いているためです（例：mime-types、zod、dayjs、lodash/submodules、@langchain/*）。回避策として、ソースからビルドする代わりに、公式のプレビルドDockerイメージ（例：ghcr.io/blinko-space/blinko:latest）を使用してください。ビルドを修正するには、server/esbuild.config.tsのexternal配列に欠けている依存関係をすべて追加し、Dockerfile内でbun installが--frozen-lockfileフラグを使用するようにしてください。

blinko

主な機能

できないこと

使用例

タグ

はじめ方

類似プロジェクト