インストールと接続を済ませ、
安全なモードから始める。

01 / BEFORE YOU START

始める前に

TrueFix Studioは、市場調査、戦略テスト、取引前確認のためのデスクトップアプリです。資金を預からず、証券会社や取引所の代わりにもなりません。公式Nightly版をインストールし、必要なサービスだけを接続してください。

02 / FIRST RUN

最初の15分

1. 1

   ワークスペースを開く

   前回の市場とパネル配置を復元できます。復元できない場合は安全な初期画面が開きます。

2. 2

   画面上部の状態を確認

   一つのサービスが使えなくてもアプリには入れます。そのサービスを使う前に、復旧を待つか表示されたエラーを確認してください。

3. 3

   テスト用サービスを一つ接続

   相場データまたは模擬取引を一つ接続します。銘柄を検索し、価格の提供元を確認して、送信しない注文を作ってみます。

上級セクションで使う用語

Providerは証券会社、取引所、データ、AIサービスのことです。ClientInstanceは保存した一つの接続、Environmentはテスト用か実取引用かを表します。設定画面と照合できるよう、上級セクションでは英語名も残しています。

03 / PROVIDER CENTRE

ProviderとClientInstanceを設定

「接続管理」から「完全な接続センターを開く」を選び、Provider Centreを開きます。「Add monitoring ClientInstance」フォームにID、Provider slug、表示名、市場、商品範囲、実際の環境を入力します。接続パラメーターは画面内の「Connection JSON」欄に入力します。Historical／Realtimeと必要に応じてConnect after savingを選び、「Save monitoring ClientInstance」を押します。このフォームは相場監視用で、取引権限を付与しません。

• Provider所有のschemaがインスタンス再構築前に設定を検証します。
• Secretは書き込み専用で、元の値は再表示されません。
• 接続済みは取引可能を意味しません。capability、entitlement、口座、正確な銘柄mapping、環境、healthを確認します。

保存後の確認

PaperとLiveは別々のClientInstanceにし、broker-paper-us / broker-live-us のように明確に命名します。

04 / MARKET CONTEXT

銘柄と市場ソースの選択

グローバル検索からcanonical Instrumentを選択します。Historical、Realtime、Tradingの経路は独立して解決されます。

Provider、ClientInstance、quality、timestampを常に確認できます。正確なmappingがない場合は経路を拒否し、似たsymbolを同一銘柄と推測しません。

06 / PORTFOLIO

口座、ポジション、注文、約定

Portfolioは権威ある取引プロジェクションを読み、Provider、ClientInstance、口座、環境でフィルターします。アプリ注文と外部/不明注文は分離されます。

• 一貫したFX revisionなしに異なる通貨を合計しません。
• partialまたはstale評価は状態を保ち、完全な資産として表示しません。
• Provider切断または環境切替後、旧口座ドメインは現在の操作に参加しません。

08 / AGENT

Agent の設定と使い方

Agent は権限を制限された操作アシスタントであり、自律取引ボットではありません。認可された TrueFix ツールを介して銘柄、市場データ、ニュース、Signal、口座、Quant 状態を読み取り、取引はレビュー可能な提案としてのみ作成します。利用可能なツールはテストビルドによって異なるため、実行タイムラインの表示を基準にしてください。

A. モデルを設定する

Desktopの「設定 → AI」フォームにAPI KeyとモデルIDを入力して保存します。モデルリクエストパラメーターのJSONは画面内の入力欄に記入し、保存はアプリが行います。

1. 1

   設定 → AI

   「AI trading agents」で「追加」を選択します。

2. 2

   接続情報

   表示名、Provider（OpenAI / Anthropic / Google / Custom）、API Key、モデル ID を入力します。互換ゲートウェイを使う場合のみ Base URL を指定します。

3. 3

   追加パラメータ

   モデルリクエストパラメータは {"enable_thinking": false} のような JSON オブジェクトです。不要なら {} のままにし、Secret は入れません。

4. 4

   有効化して保存

   既存 Agent の編集では API Key を空欄にすると保存済みキーを保持します。保存後に有効状態を確認します。

B. 安全なセッションを実行する

1. 1

   Agent を開く

   Desktop、Web Desktop、H5 の下部コマンドバーから新規セッションを作り、有効なモデルを選びます。

2. 2

   範囲を明示する

   銘柄、市場、期間、優先ソース、目的を指定します。口座を扱う場合は Environment も書き、Simulator / Testnet から始めます。

3. 3

   タイムラインを確認

   admission、model、tool、approval、final の状態と、Provider、ClientInstance、時刻、freshness、evidence を確認します。

4. 4

   結果を検証する

   事実、推論、相関を区別します。stale、degraded、拒否、ソース不足なら、質問を絞るか接続を修復します。

5. 5

   取引提案を扱う

   Approval Card の銘柄、方向、数量、口座、環境、期限、証拠を確認します。承認後も Review、RiskGuard、明示送信が必要で、拒否・期限切れでは注文されません。

10 / WEB GATEWAY & ACME

ブラウザーアクセスと HTTPS の設定

Desktopの「設定 → Web Gateway」の画面で設定します。以下のローカル接続またはリモート接続の手順に従い、必要な待受、ドメイン、HTTPSの項目を入力して、有効化と「保存して適用」を選びます。保存と反映はアプリが行い、Desktop KernelやProvider接続は停止しません。DNSレコードとファイアウォールはDNSサービスやネットワークの管理画面で設定します。

A. ローカル接続

1. 1

   設定 → Web Gateway

   この画面でランダムパスワードを生成して直ちにコピーするか、独自のアクセスパスワード欄に12文字以上を入力して変更ボタンを押します。どちらも既存のWeb/H5セッションを失効させます。「保存して適用」はGateway設定のみを保存し、パスワードを変更しません。

2. 2

   loopback に限定

   HTTPS証明書で「ローカルHTTP」を選び、待受アドレスを127.0.0.1または::1にし、サービスポートを入力します。有効化して「保存して適用」を押し、画面に表示されたURLを開きます。

3. 3

   表示 URL を開く

   パスワードでログインします。「ログイン状態を保持」は端末セッションを延長するだけで、取引権限を増やしません。

B. リモート接続

1. 1

   DNS

   studio.example.com の A/AAAA を Gateway の公開アドレスへ向けます。IPv6 が到達できないなら誤った AAAA を削除します。

2. 2

   公開 URL

   許可ドメイン はプロトコル、ポート、パスを含まない DNS 名のみ。公開アクセスURL は完全な https:// URL です。ワイルドカードは許可されません。

3. 3

   TLS

   既存の証明書を使う場合はHTTPS証明書で自分の証明書を選び、画面の証明書PEMパスと秘密鍵PEMパスを入力します。自動証明書はLet’s Encryptを選び、ACMEメールアドレスと検証方式を入力します。DNS-01のCloudflare Zone IDとAPI Tokenも同じフォームで設定します。

C. 推奨 ACME 手順

1. 1

   「設定 → Web Gateway」のHTTPS証明書でLet’s Encryptを選びます。

2. 2

   許可ドメインにstudio.example.com、公開アクセスURLにhttps://studio.example.comを入力します。

3. 3

   ACME Directory欄にhttps://acme-staging-v02.api.letsencrypt.org/directoryを入力し、メールアドレス、検証方式と必要な欄を設定します。

4. 4

   有効化して「保存して適用」を押し、画面の稼働状態と証明書状態を確認します。Staging証明書をブラウザーが信頼しないのは正常です。

5. 5

   検証後、同じACME Directory欄をhttps://acme-v02.api.letsencrypt.org/directoryに変更して再度保存・適用し、発行者、ドメイン、有効期限を確認します。

Staging 証明書が信頼されないのは正常です。HTTP-01 は公開 /.well-known/acme-challenge/* を保持します。DNS-01 は対象 Zone 限定の最小 DNS:Edit Token を使い、Global API Key は使いません。

D. セッションと端末

• 「ログイン状態を保持」はローテーションするHttpOnly Refresh Cookieを使い、JavaScriptやURLには入りません。
• Desktop設定でWeb端末を個別に失効できます。ログアウト、全ログアウト、パスワード変更、Gateway停止でも対応セッションを失効します。
• ?workspace=<id>でworkspaceを指定でき、既定はmain-workspaceです。

11 / OPERATIONS & AUDIT

運用、ログ、監査

Operationsは「いつ、誰が、何を、どの範囲で行ったか」を調べる入口です。Logsはローテーション可能ですが、取引・セキュリティAuditは耐久記録です。ログがないことは正常の証明ではありません。

問題を報告する前に

1. 1

   時刻と環境を記録

   タイムゾーン、Environment、Provider、ClientInstanceを含めます。

2. 2

   安定した証拠を保存

   error code、correlation ID、revision、freshnessを保存し、秘密情報を除きます。

3. 3

   期待と実際を説明

   再現手順と、Liveや外部注文への影響を記載します。

12 / STATUS GLOSSARY

不明をゼロにしないための状態用語

source、as-of、revision、stable codeを一緒に確認してください。

13 / ARCHITECTURE

構成とデータ境界

ブラウザーは銘柄、口座、注文、市場データ、リスク、AI/Quantの権威所有者ではありません。全エントリーポイントはcanonical contractsを共有し、元のadapter provenanceを保持します。

14 / TROUBLESHOOTING

よくある質問