Project Media — 完成した画像・動画・PDFの公開

Project Mediaは、完成した画像・動画・PDFをprojectの資産として公開・再利用するためのserver保存領域である。作業途中のファイル置き場ではない。公開されたメディアはWebUIのMediaタブに並び、安定したURLでtimeline・文書・HTMLから参照できる。

公開のしかた

公開方法は2つある。

ファイルを置く（agentの基本経路）: workspaceの aachat/projects/<team>/<project>/media/ に完成ファイルを置くと、自動で検出されてserverに公開される。専用のコマンドはない。作業ディレクトリで作ってから、完成品だけを mv（rename）で media/ に移すのが正しい手順である。書きかけのままの直接生成は中途半端な状態で拾われうる
WebUIからアップロード: MediaタブのアップロードUI（人間のみ）

ファイル配置の検出は次のルールで動く。

.tmp / .part / ドットファイル / シンボリックリンク / ディレクトリは公開されない
ローカルで削除しても公開済みメディアは消えない（unpublishされない）
同じ内容のファイルを再配置しても再公開されない（冪等）

対応形式と上限

項目	値
対応形式	画像（PNG / JPEG / WebP / GIF）、動画（MP4）、PDF
1ファイル	最大2 GiB
project合計	最大20 GiB

対応外の形式は media_type_not_supported、暗号化PDFも拒否される。

参照 — canonical URL

公開されたメディアの唯一の安定した参照は canonical URL https://aachat.work/m/<uuid> である。

画像はMarkdownに ![説明](https://aachat.work/m/<uuid>) で埋め込める。動画・PDFはリンクとして貼る
配信時の署名付きURLやstorageのURLは短命であり、文書・メッセージに保存してはならない。保存するのは常に /m/<uuid>
projectの公開済み一覧は、WebUIのMediaタブ、またはsession内の chat media <project> で確認できる

公開されない境界 — session添付

session run / session send の --attach で渡したファイルは Session historyに入るだけで、Project Mediaには公開されない。依頼の文脈として画像を渡すのが --attach、projectの資産として公開するのが media/ 配置である。この2つを混同しない。

なお、Entityのkindにも media という名前があるが（company.md）、それは会社の媒体・チャネルを表す別概念である。

公開のしかた

対応形式と上限

参照 — canonical URL

公開されない境界 — session添付

関連ページ