TW-Market Live Data Intelligence

TW-Market Live Data Intelligence

English | 繁體中文

オペレーターと AI アシスタントのための、台湾市場に関するローカルファーストでガバナンスされたエビデンスです。まず検証し、範囲を限定した作業をプレビューしてから、機能が許す場合に限り、明示的に許可したうえで1回実行します。

ProductVersion = 1.5.0。選択中の v1.5.0 は未公開であり、選択しただけでは技術的な受け入れとはなりません。 現在の安定版リリースは v1.0.0 (GitHub Release) です。公開済みのプレリリース履歴は v1.0.0-rc.1 (GitHub Release) で、それ以前の安定版 GitHub Release は v0.1.0 でした。現在の開発 ラインでは、V1/V2 との互換性を維持しながら、Unified Request/Result/Audit V3 を 優先的な基準として使用しています。Phase G G1/G2 のランタイム機能は、範囲を 限定した制御下のライブ受け入れに合格しています。Phase H では TPEx の注意喚起ルートが 1つ稼働中です。Roadmap Phase G/H のより広範な範囲は、引き続き明示的に未完了です。これはローカルファーストの エビデンス用ワークベンチであり、リアルタイム取引製品ではありません。

TW-Market が選ばれる理由

AI による議論には、条件のない価格情報ではなく、識別情報、情報源、タイムスタンプ、注意事項、 実行の来歴を備えたエビデンスが必要です。このワークベンチは、別個の監査パッケージを保持しながら、 人間のオペレーターがリクエストの検証から AI への引き継ぎまでを行える、ガバナンスされたローカル経路を提供します。

クイックスタート

git clone https://github.com/SmartyJohnway/tw-market-live-data-intelligence.git
cd tw-market-live-data-intelligence
python -m venv .venv
# Activate .venv using your shell, then:
python -m pip install -r requirements-lock.txt
python scripts/verify_environment.py
python scripts/manage_security_master.py status

新規インストール時の通常の状態は NOT_INITIALIZED です。Security Master の更新は オペレーターが明示的に実行する操作であり、公式の外部データ取得を使用する場合があります。

python scripts/manage_security_master.py update --live
python scripts/run_unified_workbench.py

ループバック Workbench を /workbench/ で開きます。 MCP ホストでは、別個の stdio ランチャーを起動します。

python scripts/run_unified_market_evidence_mcp.py

ガバナンスされた 2330 ワークフロー

1. インストール内に保存される Watchlist を作成または選択し、2330 を追加します。
2. Unified Market Evidence Request を作成し、その識別情報を検証します。
3. 計画された操作と、その機能境界をプレビューします。
4. プレビューが実行可能な場合に限り、範囲を限定した実行を1回だけ、明示的に許可して確定します。
5. 正規の Result と Audit Package を確認するか、AI 対応の引き継ぎ情報をエクスポートして議論を続けます。

主な機能

• 識別情報を考慮したリクエスト： Mode A は、対象をインストール内の Taiwan Market Identity Service に照らして検証します。
• 範囲を限定した実行： Mode B は、ガバナンスされた機能で実行可能な場合に限り、1件のリクエストをプレビューし、明示的な許可を得て実行します。
• 監査可能な引き継ぎ： Mode C は、別の市場情報源に問い合わせることなく、正規の Result、個別の Audit Package、AI 対応の Markdown を作成します。
• 永続的な Watchlist に対応： インストール内の Watchlist は、不変のリビジョン、楽観的同時実行制御、明示的なプレビューと変更確定に対応します。
• 公式の調査エビデンス： 対象となる TWSE/TPEX 普通株式は、直近の完了済み公式重要情報開示バッチと、利用可能な最新の月次売上高（TWD、単位は千）に対応しています。公式 CSV を使用し、ガバナンスで明示された公式 JSON へのフォールバックも利用できます。

Unified MCP

MCP サーフェスには、ガバナンスされたツールがちょうど6つあります。

market_describe_capabilities、market_validate_request、 market_preview_request、market_read_result、 market_export_ai_handoff、market_fetch_evidence

Request v3 を優先し、Request v1 と v2 も互換性契約として引き続き受け付けます。 新たにガバナンス下で生成されるデータは、デフォルトで Result v3 と Audit Package v3 を使用します。過去の V1/V2/V3 パッケージは、書き換えることなく引き続き読み取り可能です。リクエスト、結果、 引き継ぎの意味については、 V1 の過去の公開契約と 現在の AI 利用ガイドを参照してください。

MCP 配布

サポート対象の Windows MCPB 配布物は v1.0.0 とともに公開されています。 MCPB をダウンロード し、SHA-256 サイドカーファイルも取得できます。 ローカルの stdio トランスポートを使用し、同じ 6 つのツールを提供します。公式 レジストリエントリーは io.github.SmartyJohnway/tw-market-live-data-intelligence です。インストール対象範囲、整合性、Security Master の境界については、 MCP 配布を参照してください。

データとソースに関する注意事項

機能のサポート状況、最新性、ソースの来歴、実行可否は、明示的な製品データです。ID がサポートされていても、実行可能なソースルートがあるとは限りません。プレビューは承認ではなく、ソースの観測結果はリアルタイム性を保証するものではありません。調査機能では、任意の開示情報や月次売上履歴、リアルタイム開示情報、financial_summary は提供されません。結果を利用する前に、機能マトリクス、 ソースマトリクス、ガバナンスの境界を確認してください。

安全性と対象外事項

自動ポーリング、スケジューラー、起動時の市場データ取得、Watchlist による自動実行、取引、注文ルーティング、市場全体のスキャン、モデルが選択する URL／実行器、リアルタイム性の保証はありません。永続的な Watchlist の変更は、明示的なプレビュー／コミットを通じてのみ行われます。認証情報、トークン、Cookie、非公開の市場データペイロードは絶対にコミットしないでください。

ドキュメント

リポジトリのガバナンスに関する入口：

• PROJECT.md — 現行のプロジェクト／製品に関する正式な情報
• ROADMAP.md — 正式な Roadmap V3.2
• HANDOFF.md — 現行の運用引き継ぎ情報
• AGENTS.md — AI／リポジトリのコラボレーションルール

製品ドキュメント：

• オペレーター向けクイックスタート
• ローカル Workbench ガイド
• トラブルシューティング
• ドキュメントの目次
• V1 リリース
• 変更履歴

コントリビューションとセキュリティ

プルリクエストを作成する前にCONTRIBUTING.mdをお読みください。セキュリティ上の懸念は、SECURITY.mdの根拠に基づくガイダンスに従って報告してください。

リリース状況

VERSION には 1.5.0（選定済み、未公開）が記録されています。現在の安定版リリースは v1.0.0 （GitHub リリース）です。公開済みのプレリリース履歴は引き続き v1.0.0-rc.1 です。現在の開発系列では、Phase G の G1／G2 ランタイム作業が承認され、H-ACT-V3 の優先権限昇格まで進んでいます。これは不変の v1.0.0 リリースのタグ付けや書き換えを行うものではありません。Roadmap の Phase G／H 完了範囲は、ROADMAP.mdで別途追跡されている、より広範なスコープの問題です。どちらのリリースタグも不変の正式な情報源であり、その後のドキュメント上の状況更新によってタグが移動することはありません。

プロジェクト概要

このルート README は、現行製品のエントリーポイントです。エンジニアリングの履歴、プロトコルの受け入れ状況、以前の M5／M6／M8 アーキテクチャについては、プロジェクト履歴、エンジニアリング履歴／プロトコルアーカイブ、および docs/archive/から引き続き参照できます。これには 2026-06-30 historical READMEも含まれます。 これらは監査と互換性のために保持されており、現行製品の契約を重複して定めるものではありません。

ライセンス

LICENSEを参照してください。