詳細マニュアル

クイックマニュアルで全体像をつかんだ方向けに、機能ごとの詳しい使い方と、AI 連携の運用例まで解説します。

1. チャートマスターの位置付け

両者を 往復 することで、実戦感覚と理想形の両方を磨けます。

2. 起動 → 開始画面

アプリを起動すると、まず CM ロゴの起動画面（Splash） が約 2 秒表示され、続いて開始画面に切り替わります。Splash の見た目：黒背景＋金色の「チャートマスター」「Professional Chart Analysis Tool」「Where there's a will, there's a way.」＋ 中央に CM アプリアイコン。

2-1. 主要ボタン

2-2. 詳細設定

※ AI 共有設定の中身：プロンプトは「通常モード」「JSON 出力依頼モード」「AI チャート分析依頼」の 3 種類を別々に編集できます。同梱トグル（JSON 同梱・OHLCV 同梱）は 共有 BottomSheet 側に集約 されているのでここには出ません。

チャート選択範囲の仕組み（Task #23、2026-05-08〜）

「DL するデータ範囲」と「開始日として選べる範囲」を分離した設定です（建玉マスター互換）。

• DL（取得）範囲は固定で「上場日以降全部」：銘柄追加・更新時に Yahoo Finance から 取得可能な最大期間（30〜40 年以上）を取得します。月足 100 ヶ月線（≒ 8.3 年バッファ）が左端まで描けるように。旧仕様（10/5/3 年から選択）は撤廃。
• 開始日として選べる範囲は別途 3 択：
• 10 年（既定）：直近 10 年。日々の分析はこのレンジで十分という想定
• 20 年：リーマンショック前後（2008）まで遡って分析したい時に
• 制限なし：CSV 最古日（=「データ最古日 + 20 ヶ月」のガード適用後）まで遡れる

ガード（20 ヶ月）は強制 ON で固定 — 旧 UI の ON/OFF スイッチは Task #23 で撤去しました。月足 20 ヶ月線が描画されないと MA がブツ切れになり、相場流の長期分析に支障が出るためです。旧ユーザーが過去に「データ開始日ガード OFF」を保存していた場合も、次回起動から自動的に ON 扱いに切替わります（既存の OFF 保存値は無視され、UI も復活しません）。

旧 Phase7Settings.fetchYears キーで 10/5/3 年を保存していた既存ユーザーは、初回起動時に新キー chartRangeYears に自動で流用されます。詳細は 建玉マスターの詳細マニュアル §9 を参照（実装は両アプリ共通の chart_master_core 層）。

3. ペイント画面

3-1. ヘッダ

3-2. ツールバー（画面下）

3-3. 開始時メモ

操作モード時、画面右下に 📝 開始時メモ ボタンが表示されます。月足／週足／日足の所感を残せます。

• 保存後もボタンは残ります（再編集可、保存済みは ✓ で表示）
• ただし 売買・コメント・描画・計測のいずれかツールを使い始めると、それ以降は表示されません（初期セットアップは 1 回で OK）

4. 売買マーカー

4-1. 4 アクション

4-2. 配置手順

1. ツールバー「売買」 → 4 アクションから選択
2. チャート上の対象ローソクを 長押し（虫眼鏡ループでロックオン）
3. 指を離すとコメント記入ダイアログ
4. 建玉数（売-買）・テンプレチップ・自由文を入力
5. OK で配置

4-3. コメント編集

• 編集モード（✎）を ON → コメントバブルをタップ → 再編集ダイアログ
• 削除モード（🗑）を ON → マーカーをタップで削除

4-4. ドラッグ移動

• 通常（操作）モード or 編集モード → コメントバブルを 長押し（500ms）→ ドラッグ
• 重なって読みづらいバブルを好きな位置に移動できる

4-5. 同一バー縦積み

同じバーで違うアクションを置くと自動で縦に積まれます（kStackSpacingFactor = 2.5）。

5. その他のペイントツール

5-1. フリーコメント

• 任意位置に黄色バブルを配置
• 長押し 500ms で配置 → ダイアログでテキスト入力
• ドラッグで移動、編集モードで本文編集、削除モードで消去
• UNDO/REDO 対応

5-2. 描画ツール

• 水平線：2 点指定で水平に伸びる線
• トレンドライン：2 点指定で結ぶ線
• ボタン再タップで色サイクル（白 → ピンク → シアン）
• ボディ部分を縦平行ドラッグで全体上下移動

5-3. 計測ツール

• 2 点を指定すると、値幅・%（ON/OFF 可）・本数を表示
• ラベルをドラッグで移動可能
• 線本体を縦平行ドラッグで全体上下移動
• つかみ中は amber ハイライト

変動率%は「終値ベース」で計算します（2026-05-11 改修）。2 点目のロウソク終値 ÷ 1 点目のロウソク終値 − 1 を表示。
高値・安値ベースではないので、「高値からの下落%」を測りたい場合は計測の始点・終点を意図した位置に置き直してください。

6. 終了 → お疲れさまでした画面

「終了」を押すと：
1. 現在のペイント要素一式が PaintSession として sqflite に保存
2. PNG キャプチャを生成（チャート＋ペイント要素）
3. お疲れさまでした画面へ遷移

6-1. 主要ボタン

6-2. 掲示板テキスト出力例

📊 チャートマスター 分析チャート
━━━━━━━━━━━━━━━━━━━
銘柄：7203 : トヨタ自動車
期間：2024/3/1〜2024/4/15

【開始時所感】
（中略）

【売買マーカー】
買IN 3/5 1250円 [下半身、PPP] 0-1
（中略）

【計測】
2024/3/5〜2024/3/20：+85円（+6.8%）／12本

━━━━━━━━━━━━━━━━━━━
#チャートマスター

7. AI 連携（最重要）

ここがチャートマスターの本丸。AI に「お手本の分析チャート」「指摘」「分析」を依頼できます。

7-1. AI 連携の 5 つの動線

動線 B + C を組み合わせると、AI が書いた指摘ペイントをチャートマスター内で編集・追加できます。これがチャートマスターの一番強い機能です。

動線 E は 「お手本だけ欲しい」ときに使います。自分で書き込まずにいきなり AI に「この銘柄のこの期間でどう売買するのが理想？」を依頼 → AI が返した JSON を C で開く、という流れです。

7-2. AI 共有 BottomSheet の 3 トグル

「🤖 AI に共有」を押すと BottomSheet が出て、3 つのトグルで送信内容をコントロール：

下に共有先 3 つ：
- AI アプリへ送る（OS 共有シート）
- Claude プロジェクトに送る（要 URL 登録）
- Gemini Gem に送る（要 URL 登録）

7-3. 動線 A：通常レビュー

目的：AI に言葉でアドバイスをもらう。

1. ペイント画面 → 終了 → お疲れさまでした画面
2. 🤖 AI に共有 → 共有先を選択
3. AI からテキストで「ここが良かった、ここが惜しかった」が返る

おすすめ設定：
- JSON 出力依頼モード = OFF
- JSON 同梱 = OFF（必要なければ）
- OHLCV 同梱 = ON（精度向上）

7-4. 動線 B：JSON 出力依頼モード（最強）

目的：AI に「(図中①)」「(図中②)」と番号付きで指摘してもらい、チャートマスター内に書き込んで返してもらう。

1. ペイント画面 → 終了 → お疲れさまでした画面
2. 🤖 AI に共有 → JSON 出力依頼モード = ON
3. 共有先を選択して送信
4. AI が以下を返す：
   - 言葉のアドバイス（「(図中①) 3/5 のエントリーは早すぎ…」）
   - 編集後 PaintSession JSON（① ② の番号ラベル付き freeComment が追加されたもの、```json … ``` ブロック）
5. AI 返答からその JSON ブロックをコピー
6. チャートマスター起動画面 → 「AI から取り込む」 → 貼付け
7. ペイント画面に AI 指摘の番号付きラベルが表示される

AI の出力品質を高めるコツ：OHLCV 同梱を ON にしておくと、AI が画像 OCR ではなく数値で分析できるため、「3/15 の安値 1,255 円」のような正確な指摘が増えます。

7-5. 動線 C：AI から取り込む

目的：AI が返した PaintSession JSON を読み込んでペイント画面を再現。

1. 起動画面 → AI から取り込む
2. JSON を貼付け（クリップボードから貼付ボタンも有り）
3. 「読み込み」 → ペイント画面が起動して JSON の内容が再現される

AI が PaintSession JSON 形式以外（matplotlib 画像など）を返した場合は取り込めません。AI に「PaintSession JSON 形式で出力してください」と依頼してください。

7-6. 動線 D：建玉マスターから取り込む

目的：建玉マスターでの実戦練習結果をチャートマスターでペイント化して継続分析。

1. 建玉マスター → 練習 → 終了 → 振り返り画面
2. 📊 チャートマスターに送る をタップ → JSON がクリップボードに
3. チャートマスター起動 → 建玉マスターから取り込む → 貼付け
4. 「玉データを取り込む」トグル（既定 ON）でコメント先頭に「{売}-{買}」を付けるか選ぶ
5. 読み込み → ペイント画面が建玉マスターの売買マーカーで埋まった状態で起動

→ あとは自由にコメント・計測線・描画を追加して掘り下げ。
→ 必要なら 7-4（動線 B）で AI に指摘してもらうことも可能。

7-7. 動線 E：AI チャート分析依頼（お手本依頼）

目的：ペイントせずに AI に「この銘柄・この期間で、理想の売買戦略を提示してください」と丸投げ。後知恵で最適解を研究するときに使う。

1. 起動画面で銘柄・開始日・本数を選ぶ（普段の練習開始と同じ手順）
2. 🤖 AI にチャート分析依頼 ボタンをタップ
3. BottomSheet で送信先を選択：
   - AI アプリへ送る（OS 共有シート）
   - Claude プロジェクトに送る（要 URL 登録）
   - Gemini Gem に送る（要 URL 登録）
   - クリップボードにコピーするだけ
4. 送信される内容：
   - AI チャート分析依頼用プロンプト（詳細設定で編集可）
   - OHLCV CSV（練習期間 + 過去 100 日の MA バッファ）
   - 空の PaintSession JSON テンプレート（AI に編集してもらう原本）
5. AI が PaintSession JSON で返す（言葉のアドバイス + 編集後 JSON）
6. その JSON を 「AI から取り込む」 で開く → AI が提案した売買マーカー・コメント・描画線が表示

プロンプトは詳細設定 → AI 共有の設定 → 「AI チャート分析依頼」タブ で編集できます。「相場流の観点で分析してください」「酒田五法を意識してください」のように追加文言で指向を変えられます。

📅 当日込みモード（2026-05-11〜）

AI チャート分析依頼の BottomSheet には 「📅 当日込み」トグル があります。ON にすると：

1. Yahoo Finance の当日 5 分足を集計 → 当日の partial bar（始値・高値・安値・現在値・出来高）を生成
2. 「📅 当日ザラ場の確認」ダイアログ が出て、生成された OHLC を確認・微修正できる
3. OK で AI への送信内容に当日 partial bar が追加（OHLCV CSV の末尾に append）

AI が当日込みで返した JSON を「AI から取り込む」で開くと、PaintPage 側も CSV ロード後に当日 partial bar を末尾に append。「今この瞬間どう動くべきか」を AI に相談する用途 に使います。

• 当日込み ON で送って当日込みで返ってきた → 当日 partial bar + AI マーカーが正しく表示
• 当日込み OFF（通常モード）→ 前営業日までのデータのみ

当日 partial bar の値はリアルタイムではなく、Yahoo 5 分足のスナップショット。場中で動いている時は、送信前に微修正ダイアログで現在値を最新化するか、後で取り込み時に値が古ければ気にせず参考扱いに留めてください。

📐 AI 取り込み時のコメント自動再配置（2026-05-14〜）

AI が返した売買マーカーのコメント・フリーコメントは、取り込み時にチャート上で衝突しないよう自動で位置を再配置します（最大 12 回の試行で衝突回避）。

• 同じ日付に複数マーカーが連続する場合、コメントバブルが重ならないよう 上下にオフセット
• 画面右端付近のマーカーは、コメントが画面外に出ないよう 左にオフセット
• AI が bubbleOffset を明示した場合はそれを尊重しつつ、衝突した場合のみ調整

AI 側のプロンプトでも「bubbleOffset を (0, -40) 単位で離す」「同日売買があればコメントは作らない」等のルールを指示済みなので、取り込み後の見た目はだいぶ整っているはずです。

7-8. URL の取得方法（Claude Project / Gemini Gem）

Claude Project URL を取得（Android スマホの例）

1. Chrome アプリを開く（Claude アプリではなく、Web ブラウザ）
2. claude.ai にアクセス → Google アカウントでログイン
3. 左上のメニューボタン（三本線 ≡）をタップ
4. 「Projects」を選択
5. 使いたいプロジェクト（例：「チャートマスター 振り返り」）をタップ
6. プロジェクト画面が表示されたら、画面上部のアドレスバーをタップ
7. URL を長押し → 「コピー」を選択

URL の形式は https://claude.ai/project/01K95FJ...（末尾は英数字）。

Gemini Gem URL を取得（Android スマホの例）

1. Chrome アプリを開く
2. gemini.google.com にアクセス → Google アカウントでログイン
3. 左上のメニューボタン → 「Gems」 または 「Gem マネージャー」
4. 使いたい Gem をタップ
5. アドレスバーから URL コピー

URL の形式は https://gemini.google.com/gem/xxxxxxxx。

※ Gems 機能は Gemini Advanced（有料プラン） での提供のみとなる場合があります。

取得した URL をアプリに登録

1. チャートマスター 起動画面 → 詳細設定 → AI 共有の設定
2. 各欄に長押しで貼付：
   - プロンプト編集（通常モード ／ JSON 出力依頼モード タブ切替）
   - Claude Project URL
   - Gemini Gem URL
3. 保存 をタップ

以降、🤖 AI に共有 ボタンから Claude / Gemini に直接ジャンプできます。

7-9. AI に渡すプロンプトのカスタマイズ

詳細設定 → 「AI 共有の設定」で 3 種類のプロンプトを別々に編集できます（タブ切替）：

• 通常：動線 A 用
• JSON 出力依頼：動線 B 用
• AI チャート分析依頼：動線 E 用

通常モードの既定プロンプト

以下は株式投資の練習結果です。
チャート全体を見ながら「理想の売買戦略」を研究する練習
（後知恵を活用して最適解を検討する練習）の記録です。
『エントリーポイントの選択』『エグジットポイントの選択』
『建玉分配の最適性』を中心に、
理想に近づける観点で、良かった点・改善点・別解の提案を簡潔にお願いします。

JSON 出力依頼モードの既定プロンプト（抜粋）

以下は株式投資の練習結果です。
チャート全体を見ながら「理想の売買戦略」を研究する練習の記録で、
末尾に PaintSession JSON が同梱されています。

【お願い】2 種類のアウトプットを返してください。
(1) 言葉のアドバイス
    指摘ごとに「(図中①)」「(図中②)」… の番号で図と紐付けてください。
(2) PaintSession JSON の追記版
    ・freeComments に「①」「②」… と短い番号ラベルを追加
    ・編集後の PaintSession JSON 全体を ```json ... ``` で囲って返却

文言例：
  ・(図中①) 3/5 の買いエントリーはやや早かった…
  …

これらをカスタマイズして、自分のスタイル（相場流／酒田五法／短期トレード重視 等）に合わせられます。

8. 過去の振り返り

開始画面下部の「過去の振り返り」から、最大 20 セッションを保存・閲覧。

• 一覧から過去のセッションをタップでお疲れさまでした画面が再表示
• ペイント画面に戻って追記もできる
• 不要セッションは長押しで削除

9. データソース

β 配布版（β#1） は 3 銘柄を同梱：
- 7203 トヨタ自動車（1999-05-06 〜 現在、27 年分）
- ^N225 日経平均株価（指数、Yahoo の取得可能最古〜現在）
- CC=F ココア先物（CME、取得可能最古〜現在）

銘柄選択画面（または起動画面の「銘柄」ダイアログ）でこの 3 種類から選びます。

正式版（Phase 7 機能 ON）では Yahoo Finance API から銘柄を自由に追加可能（建玉マスターと同じ仕組み）。指数（^N225/^TPX/^DJI/^GSPC/^IXIC/^VIX/USDJPY=X 等）も「指数」タブから追加でき、Y 軸通貨ラベルが ticker から自動判定（円 / $）されます。

9-1. DL は「上場日以降全部」、UI 範囲は「チャート選択範囲」で別途制限（Task #23、2026-05-08〜）

旧仕様（〜 2026-05-07）と現行の比較：

つまり「データはたっぷり持つ、見せる範囲だけ制限する」という方向にリファクタしました。月足の長期 MA を扱う相場流の分析との相性が良くなります。

Yahoo データ品質の注意（既知の問題）

US Yahoo Finance のデータは古い時期ほど品質にばらつきがあります。本アプリでは下記 2 種類の不正な行を 自動でフィルタ しています。

両方のフィルタは「アプリで Yahoo から DL する全経路」で自動適用 されます（建てマス・チャーマス共通の chart_master_core 層で実装）。同梱 assets（α 配布版のトヨタ 27 年分）も同じフィルタを通したものを採用しています（Phase 4-B、2026-05-08）。

副作用として、ごく稀に「実際は平常営業日なのに Yahoo 側にデータが無い特異日」も除外されます（例：トヨタ 2016-07-11）。CSV 上で 1 日歯抜けになりますが、MA / BOLL の計算はバー本数ベースなので連続性は保たれます。

フィルタしていない行（残置・要注意）

「OHLC 全部同じ値だが volume > 0」（=「点ロウソク」だが出来高はある）行は 意図的に残置 しています。理由：

• 出来高があるので実際に取引が成立した日。完全なフェイクではない可能性が高い
• 古い時代（1999〜2008 年頃）のトヨタ等で、薄商いや Yahoo の保存粒度の問題で OHL=close になったケース
• 機械的に除外すると本物の薄商い日まで消す過剰除去になるため、判断はユーザーに委ねる

チャート上で「点」「短い直線」のロウソクが見えたら、この種のデータ品質低下日だと思って読み解いてください。MA / RSI の計算には終値しか使わないので大きく崩れることはありませんが、その日のヒゲ・実体を根拠にしたペイント分析は不向きです。

詳細・検証スクリプトは 建玉マスターの詳細マニュアル §9-1 を参照してください。

9-1-1. 月足 MA を「左端から」描かせる開始日の目安

長期 MA は「過去 N 本分のバッファ」が無いと描画できません。月足の場合は「N ヶ月前」までデータが必要：

例：月足チャートで MA100（オレンジ）まで左端から見たい場合は 開始日を 2007 年 9 月以降 に設定してください。逆に 2002 年あたりから始めると、最初の数年は MA100 が描かれず、2007 年付近から徐々に描画され始めます（バッファが集まったタイミング）。

これは仕様であり、assets/stock_data.csv の最古日（1999-05-06）を変えるか、CSV 手動取り込みでさらに古いデータを足すしか改善方法はありません。

9-2. 「制限なし」を選んでも遡れる年数の上限がある理由 / さらに古いデータが欲しい場合

「チャート選択範囲 = 制限なし」を選んでも、開始日下限には常に 「データ最古日 + 20 ヶ月」 のガードがかかります。例：

それより古いデータ（1990 年代前半など）で分析したい場合は、ご自身でデータを用意して 取り込みます。

取り込み手順

1. PC ブラウザで上記いずれかのサービスから時系列 CSV を DL
2. 必要に応じて Yahoo 形式に整形（建玉マスター詳細マニュアル §9-2 を参照）
3. 端末に転送（メール添付・AirDrop・USB・Google Drive 等）
4. チャートマスター起動 → 詳細設定 → 「Yahoo CSV を取り込む」ボタン
5. ファイルを選んで取り込み完了

β 配布版では取り込んだ銘柄をそのままチャート分析に使えます。「銘柄」をタップすると 同梱 3 銘柄＋取り込み済みカスタム銘柄 から選べます（Divider 区切り、上が同梱、下がカスタム）。

10. トラブルシューティング

11. お問い合わせ

サポートメール：ms.success.llc@gmail.com
返信に 3 営業日ほどお時間をいただく場合があります。

以上。