TW-Market Live Data Intelligence

TW-Market Live Data Intelligence

English | 繁體中文

为运营人员和 AI 助手提供本地优先、受治理的台湾市场证据——先验证，再预览范围受限的操作，然后仅在能力允许时明确授权执行一次。

ProductVersion = 1.5.0。选定的 v1.5.0 尚未发布；仅选择该版本不代表技术验收通过。 当前稳定版本为 v1.0.0 (GitHub Release)。 已发布的预发布版本历史为 v1.0.0-rc.1 (GitHub Release)， 此前的稳定 GitHub Release 为 v0.1.0。当前开发线现以 Unified Request/Result/Audit V3 作为首选权威版本，同时 保留 V1/V2 兼容性。Phase G G1/G2 运行时能力已通过范围受限的受控实时验收；Phase H 目前有一条启用的 TPEx 提醒路由；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. 仅当预览显示可执行时，才明确授权并确认一次范围受限的执行。
5. 阅读规范 Result 和 Audit Package，或导出面向 AI 的交接内容以继续讨论。

核心能力

• 支持标识感知请求： Mode A 会根据安装本地的 Taiwan Market Identity Service 验证目标。
• 范围受限的执行： 仅当受治理能力可执行时，Mode B 才会预览、明确授权并执行一次请求。
• 可审计的交接： Mode C 会创建规范 Result、独立 Audit Package 和面向 AI 的 Markdown，不会再分派其他市场数据源。
• 支持持久化 Watchlist： 安装本地的 Watchlist 具有不可变修订版本、乐观并发控制，以及明确的预览/提交变更流程。
• 官方研究证据： 符合条件的 TWSE/TPEX 普通股支持获取最新已完成的官方重大讯息批次和最新可用的月营收（TWD，单位为千），使用官方 CSV，并在受治理的情况下明确回退到官方 JSON。

Unified MCP

MCP 接口恰好包含六种受治理工具：

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 传输，并提供相同的六种工具。官方 Registry 条目 为 io.github.SmartyJohnway/tw-market-live-data-intelligence。有关安装范围、完整性和 Security Master 边界，请参阅 MCP 分发。

数据与来源注意事项

能力支持、数据时效性、来源溯源和执行资格均为明确的产品数据。支持某个标的身份并不意味着存在可执行的数据源路由；预览不代表授权；来源观测不代表实时保证。研究支持不提供任意披露信息或月度营收历史、实时披露信息，也不提供 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 Release）； 已发布的预发布版本历史仍为 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 历史 README。 这些内容仅为审计和兼容性而保留，并非第二份当前产品契约。

许可证

请参阅 LICENSE。