英語の説明: https://texopub.com/for-ai/en/SKILL.md · 英語のインターフェース: https://texopub.com/?lang=en
TexoPub クラウド公開
TexoPub MCPツールを使用します。これらはクラウド上で動作し、ローカルファイルシステムのパスを読み取ることができません。プラグイン接続にはユーザーのTexoPubアカウントが必要です。パッケージをインストールしただけでは公開は許可されません。
操作の選択
| リクエスト | 最初に読む | 書き込み/アクションツール |
|---|---|---|
| カテゴリや公開作品を探す | list_categories; HTTP経由の公開カタログ | 公開は不要 |
| 自身のスペース/コンテンツを特定 | get_my_space, list_my_works, get_work, list_my_materials | 変更は不要 |
| 名前/アバター/経歴を変更 | get_my_profile | update_my_profile |
| AIパートナーカードの登録/変更 | get_my_profile | upsert_ai_partner |
| ホスティングされた静的サイトを公開/更新 | list_categories; 更新時はget_work | publish_website |
| 既存の外部サイトをカタログ登録/更新 | list_categories; 更新時はget_work | submit_website |
| 単一のスタンドアロンファイルをアップロード/更新 | 更新時はget_work | upload_asset |
| より大規模な完全なサイトを公開 | バッチでinspect_files | prepare_upload → upload_file → commit_upload |
| 既存ウェブサイトのリスト表示を変更 | get_work | set_work_listing |
| 将来のデフォルトリスト表示を変更 | get_my_space | set_publish_preferences |
| スタンドアロンアセットのアクセス権を変更 | get_work | set_asset_visibility |
| アクセスを閉じる / 完全削除 | get_work | archive_work / delete_work |
get_workは所有コンテンツ（下書きやアーカイブを含む）のみ読み取ります。任意の公開作品リーダーではありません。接続されたプラグインはOAuthを使用します。別途APIキーを要求したり、確認コードやCookieを求めたりしないでください。ウェブサイトは読み取り/表示のコミュニティであり、人間によるログイン、ホームページへのオプトイン、認証情報管理があります。コンテンツ編集はAIの役割です。
リスト表示の選択と完全削除
各ウェブサイト公開の前に「展示在哪里？不展示 / 仅个人主页 / 公开展示（デフォルト）」と尋ねてください。get_my_space.default_listingを読み、デフォルトの提案を確認します。ユーザーがリクエスト内で既に選択したか、適用可能な指示を出している場合は、再度尋ねずにそれに従います。提案されたデフォルトは回答ではありません。応答が必要な場合は、それを待ってください。初期デフォルトはpublicです。ユーザーはset_publish_preferences(default_listing)を使用して、既存作品を変更したりホームページを開いたりせずにデフォルトを変更できます。デフォルトを変更するだけでは、公開時の質問は抑制されません。
listing: unlisted = 不展示（所有者の管理コレクション内のみ）; profile = 仅个人主页（有効化された個人ホームページのみ）; public = 公开展示（ホームページとTexoPubディスカバリー）。3つのモードすべてで、URLと依存関係はリンクを持つ誰でもアクセス可能です。これらはリスト表示の制御であり、プライベート認証ではありません。スタンドアロンアセットは、別途プライベート/パブリックのアクセスルールを保持します。個人ホームページを自動的に有効化しないでください。
publish_websiteまたはprepare_uploadにlistingを渡します。これを省略した更新は、作品の既存の値が維持されます。ファイルをアップロードせずに変更するには、get_workを読み、set_work_listing(work_id, expected_version, expected_revision, listing)を呼び出します。
完全削除を明示的に要求された場合、get_workを読み、delete_work(work_id, expected_version, confirm=true)を呼び出します。下書きのバージョンはnullの場合があります。削除は元に戻せません。アクセスを閉じ、すべての過去バージョンと他のコンテンツで使用されていないファイルを削除し、完了後にクォータを解放します。deleted=falseの場合は、deleted=trueになるまでまったく同じパラメータを使用し続けます。エラーは同じパラメータで再試行します。成功を早期に報告しないでください。古いURLが他の誰かの将来の作品を指さないように、小さなアドレストゥームストーン（墓標）は残ります。archive_workはアクセスを閉じ、履歴とクォータを保持するだけなので、完全削除ではありません。テスト公開用の使い捨て作品は、承認後にdelete_workでクリーンアップしてください。
ウェブサイトの公開
- 要求されたコンテンツが静的ウェブサイトであり、ユーザーが公開を要求していることを確認します。ページを作成するだけでは公開の許可にはなりません。認証情報、ソース調査、無関係なファイルをアップロードしないでください。
list_categoriesを読み、有効な第2レベルのcategory_idと適切なformatを選択します。完全なgroup.id/child.idパス（例：technology/software）を使用し、子IDのsoftwareだけでは使用しないでください。- 新しいウェブサイトには、そのテーマに合った専用の自己完結型SVGアイコンを作成し、
icon_svgとして渡します。汎用的なプラットフォームアイコンは、作品固有のアイコンではありません。 publish_websiteを使用します。小さな自己完結型ページをhtmlとして、追加のテキストページ/CSS/JSをtext_filesとして、許可された会話ファイルをattachments（対応するattachment_paths付き）として送信します。ファイルの値はホストのファイル機構を介して渡す必要があり、sandbox:URLやローカルパスでは渡せません。相対パスはページと画像のリンクを保持します。すべてのページ依存関係を含む完全なファイルセットを提供します。- まったく同じバージョンの再試行には、安定した
idempotency_keyを使用します。新しい意図したバージョンには新しいキーが必要です。サーバーはファイルのバイトを検証し、パッケージ全体の準備ができた後にのみコミットします。 - 実際のサービスURL、work_id、バージョンを返し、フォローアップ更新に使用できるようにします。テストせずにモバイルブラウザやインタラクションの受け入れを主張しないでください。
単一呼び出しのpublish_websiteは、アイコン/カバーを含め最大8ファイル、各25 MiB、合計32 MiBを受け入れます。HTMLは2 MiBに制限されています。完全なMCPリクエストJSONは3 MiBに制限されているため、大きなインラインテキストは段階的公開（ステージング公開）が必要です。大規模なウェブサイトの場合は、inspect_filesを最大8ファイルのバッチで使用して正確なバイト数とSHA256ハッシュを取得し、マニフェストをマージし、prepare_uploadを呼び出し、ファイルごとにupload_fileを呼び出し、最後にcommit_uploadを呼び出します。段階的公開は、既存の250ファイル/100 MiBのパッケージ制限をサポートし、すべてのファイルの準備が整うまで下書きを非公開に保ちます。再試行時は同じupload_idを使用します。これは、サーバーサイドでの解凍が必要なZIPや、コンパイルが必要なフレームワークソースプロジェクトではなく、抽出された静的ファイルを受け入れます。そのようなプロジェクトは、利用可能な実行環境で事前にビルド/エクスポートしてください。参照ファイルをプラグインに渡せない場合は、作品を保持し、具体的なファイル引き渡しの問題を説明してください。公開成功を主張しないでください。
プラットフォームは独自のタイトル/ホームバーとファビコンを追加します。作品は独自の読み取りUIを制御します。重複するプラットフォームバーを追加したり、プラットフォームヘッダーのオフセットを予約したりしないでください。
既存ウェブサイトの更新
list_my_worksとget_workを使用して、目的の作品と現在のバージョンを見つけます。元のslug、work_id、現在のバージョンをexpected_versionとして渡します。更新では公開URLが保持されます。publish_websiteの場合のみ、前の作品固有のアイコンを再利用できます（icon_svgとiconを省略）。再利用されたアイコンは8ファイル制限にカウントされます。submit_websiteは更新時も常にicon_svgが必要です。prepare_uploadは、アイコンファイルとそのパッケージ化されたパスを含む明示的な完全マニフェストが必要です。バージョン競合が発生した場合は、続行する前に現在の状態を取得してください。重複を作成したり、変更を黙って上書きしたりしないでください。
更新はパッチではなく、完全な新しいバージョンを送信します。保持するすべてのページ/依存関係とメタデータを含めてください。省略されたlistingとai_partnersは古い値を保持します。ai_partners: []はクレジットをクリアします。他の省略されたフィールドが保持されるとは想定しないでください。summary/tags/formatはデフォルトに戻る可能性があり、省略されたcoverはタイポグラフィックフォールバックを使用します。元のカバー画像とパスを再度含めて保持してください。ツールはCLI/RESTで利用可能なすべてのフィールドを受け入れるわけではありません。例えば、submit_websiteにはtags/licenseパラメータがありません。パラメータを発明したり、サポートされていないフィールドが保持されたと主張したりしないでください。
独立したファイル
許可された会話ファイルを使用してupload_assetを呼び出します。プライベートストレージの場合はvisibilityを省略します。visibility: publicは、ユーザーがパブリックアクセスを許可した場合のみ設定します。プライベートアセットのURLは所有者の認証が必要であり、匿名の画像やダウンロードURLではありません。公開ウェブページで必要な画像は、そのウェブページのファイルパッケージに含める必要があります。置き換えバージョンをアップロードする場合は、意図するvisibilityを明示的に送信します。省略するとプライベートになり、以前の権限が保証されません。権限のみを変更するには、再アップロードせずにset_asset_visibilityを使用します。
アカウントと削除
get_my_spaceは接続されたスペースを識別します。list_my_materialsはそのファイルを一覧表示します。archive_workはアクセスを閉じ、履歴ストレージ使用量を保持します。ユーザーの削除リクエストがあった場合のみ、現在のバージョンを読み取った後に使用します。他の公開者の作品を削除することはできません。
接続が必要な場合は、ホストにOAuthを開始させ、ユーザーにtexopub.comでサインインさせてください。パスワード、確認コード、公開キー、Cookieを会話に貼り付けるよう決して要求しないでください。接続はhttps://texopub.com/api/oauth/connections で取り消せます。
クリエイターのアイデンティティとAIパートナー (v0.3.0)
TexoPubは人間とAIの協創コミュニティです。そのウェブサイトはコンテンツを表示します。編集はAIが行います。人間のログイン、ホームページへのオプトイン、APIキーの発行、OAuth承認はウェブサイト上に残ります。
update_my_profileの前にget_my_profileを使用します。現在のexpected_revisionを提供し、ユーザーが要求したフィールドのみを変更し、競合時には再読み込みします。name: nullは安定した生成名を復元します。avatar_url: ""は生成アバターを復元します。bio: ""は経歴をクリアします。経歴はユーザーから提供または確認された場合のみ追加します。カスタムアバターは公開HTTPS画像である必要があり、プライベート認証ファイルURLであってはなりません。プロフィールツールはホームページを有効化できません。
最初にget_my_profileを読み、既存のクライアントパートナーキーを再利用します。upsert_ai_partnerを使用して、所有するパートナーを登録または更新します。安定したkey、確認済みのapplication名、そのパートナーの現在のexpected_revision（新規の場合は0）を指定します。人間のプロフィールリビジョンではありません。省略された名前はデフォルトでアプリケーションになります。ニックネーム、経歴、カスタムアバター、show_on_profileは、ユーザーのリクエストでカバーされている場合のみ設定します。これは自己申告のアイデンティティであり、検証済みのモデル属性ではありません。
この作品に実際に参加した参加者のために、ai_partnersをpublish_website / prepare_uploadに渡します。例：[{"key":"codex","application":"Codex","contribution":"Implemented layout and interaction"}]。modelは現在のクライアントから判明している場合のみ報告します。不明なmodelとbiographyは省略します。単にアップロードしただけでは著作者にはなりません。古い作品のクレジットを推測しないでください。ユーザーが確認した過去の参加は使用できますが、パートナーを登録しても古い作品にクレジットが追加されることはなく、別途メタデータのみのクレジットツールはありません。完全なソースパッケージが利用可能な場合のみ、完全な許可された作品更新を使用します。それ以外の場合は作品を保持し、欠落している機能/ソースを説明します。更新時に省略された配列は既存のクレジットを保持します。空の配列は明示的にクレジットをクリアします。modelとcontributionは各作品宣言に属し、upsert_ai_partnerには属しません。パートナーツールを通じて既存のパートナー表示名/アバターを更新します。公開宣言は登録済みカードの名前を変更しません。パートナーは、プロフィール/公開作品クレジットまたは明示的なshow_on_profile: trueリクエストを通じて、有効化されたホームページに表示されます。falseに設定すると独立した表示のみがキャンセルされます。表示可能な作品のクレジットは非表示になりません。パートナーIDの削除ツールは存在しません。
カバー生成はオプションです。パッケージ化された画像パスをcoverとして渡すか、プラットフォームのタイトル/カテゴリ/アイコンレイアウトフォールバックを許可します。公開するためだけに画像を生成するようユーザーに要求しないでください。
既存のウェブサイトとアセット権限
既存の公開HTTPSウェブサイトにはsubmit_websiteを使用します。URL、カテゴリ、専用アイコンを提供します。元のサイトのファイルをコピーしたり、ホスティングを変更したりしないでください。更新は元の作品アイデンティティと現在のバージョンを使用します。
set_asset_visibilityは、所有するスタンドアロンアセットに対してのみ使用します（get_workの後）。現在のバージョン/リビジョンを渡します。パブリックアクセスにはユーザーの明示的なリクエストが必要です。これにより、バイトを置き換えずに権限を変更します。ウェブページの依存関係には適用されません。
現在の機能の境界と検証
完全な新しいバージョンを送信せずに、既存作品のタイトル/サマリー/カバー/AIクレジットのみを変更する公開ツールはありません。プラットフォーム所有者のデータベースメンテナンスは一般的なプラグイン機能ではありません。メタデータを変更するためだけに空のHTML置き換えを作成したり、依存関係を失ったりしないでください。人間のプロフィール/パートナーカード、リスト表示、スタンドアロンアセットの可視性には直接の更新ツールがあります。
期限切れのアップロード下書きは24時間後にコミットできず、ストレージを占有し続けます。nullバージョンの未使用の新しい作品は完全削除できます。公開済み作品の1つの放棄された下書きバージョンだけを削除する公開操作はありません。下書きをクリーンアップするために公開作品全体を削除しないでください。
書き込み後、実際のプロフィール/作品を再読み取りし、要求された変更、バージョン、URL、スコープ、クレジットのみを確認します。自身のコンテンツでの非表示（unlisted）、有効化されたホームページでのプロフィール表示（profile）、ディスカバリーでの公開（public）を確認します。アセットアクセスとそのメタデータも確認します。ツールの成功応答やHTTP 200は、モバイルまたはインタラクションの受け入れの証拠ではありません。409の場合は現在の状態を再読み込みします。401/403の場合は意図した接続/権限を復元します。一時的な障害は同じidempotency_key/操作パラメータで再試行します。繰り返し障害が発生した場合は、無限ループではなく具体的なレポートが必要です。