From 6eb34b5afe2ebeb80eb4131fd6970d9f2c362910 Mon Sep 17 00:00:00 2001
From: Citrons <909229731@qq.com>
Date: Tue, 18 Aug 2026 13:05:32 +0800
Subject: [PATCH] =?UTF-8?q?docs(FEAT-MO-001):=20=E8=AE=B0=E5=BD=95TDX?=
 =?UTF-8?q?=E5=BC=80=E5=8F=91=E5=89=8D=E9=97=A8=E7=A6=81?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../gitnexus/impact-plan.md                   | 12 +++----
 .../gitnexus/implementation-baseline.md       | 32 +++++++++++++++++++
 .../tdx-smoke-report.md                       | 22 +++++++++++++
 3 files changed, 60 insertions(+), 6 deletions(-)
 create mode 100644 docs/features/FEAT-MO-001-market-overview/gitnexus/implementation-baseline.md
 create mode 100644 docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md

diff --git a/docs/features/FEAT-MO-001-market-overview/gitnexus/impact-plan.md b/docs/features/FEAT-MO-001-market-overview/gitnexus/impact-plan.md
index 9e2ac15..b3607b0 100644
--- a/docs/features/FEAT-MO-001-market-overview/gitnexus/impact-plan.md
+++ b/docs/features/FEAT-MO-001-market-overview/gitnexus/impact-plan.md
@@ -2,8 +2,8 @@
 
 - 功能编号：FEAT-MO-001
 - 基线提交：`c0a6f5560584`
-- 当前阶段：TDX 开发连接设计与首页方案确认
-- 当前总体风险：LOW（仅本机 SSH 配置和操作文档）；首页业务代码风险待设计确认后按符号补充
+- 当前阶段：TDX 直连首页实施，已完成开发前门禁和最小只读协议验证
+- 当前总体风险：LOW（新增边界尚未落地）；TDX 客户端、API、OpenAPI 和 Web 首屏实现后按符号补充
 
 ## 直接与间接影响
 
@@ -11,14 +11,14 @@
 
 - 正式行情来源确定为 TDX；家庭局域网和外部 Tailscale 只改变 Mac 到同一 Windows `sshd` 的网络路径。
 - TDX Bridge 的稳定入口固定为 Mac 回环地址 `127.0.0.1:17710`，市场概览、规则分析、AI 分析和未来 HTTP 契约不得依赖家庭地址、Tailscale 地址或 TDX 原始字段。
-- 当前仓库没有 TDX Provider 或市场概览运行时符号，本阶段只更新操作文档；GitNexus 未识别可执行调用链影响。
+- 当前仓库尚无 TDX Provider 或市场概览运行时符号；本次将新增 API 业务模块、TDX 客户端、OpenAPI 契约和 Web 首屏。新增符号的直接调用链将在实现后重新索引并执行变更检测。
 - 首页业务设计确认后，必须对 `App.vue`、`createAppRouter`、后端模块装配、HTTP DTO 和新增市场概览符号分别执行 upstream impact。HIGH 或 CRITICAL 结果先告知用户再修改。
 
 ## 跨模块同步修改
 
-- HTTP/OpenAPI：当前连接文档不修改；首页正式接入时需要版本化市场概览 DTO 与 OpenAPI 契约。
-- Web API 与 adapter：当前不修改；未来页面只能经 `web/src/api/<业务域>/index.ts`、Axios 封装和 ViewModel 消费数据。
-- 消息契约、Redis、MySQL、Scheduler、Worker：当前不启用。正式采集链路仍按独立功能立项，不能由 API 请求临时抓取全市场数据。
+- HTTP/OpenAPI：本次新增版本化市场概览 DTO 和五个只读路径，并重新生成 OpenAPI 契约。
+- Web API 与 adapter：本次新增 `web/src/api/market-overview/index.ts`，页面只能经 Axios 封装和 ViewModel 消费数据。
+- 消息契约、Redis、MySQL、Scheduler、Worker：本次首屏不启用业务链路，仅保留既有架构边界；正式采集、快照持久化、缓存和异步分发仍按独立功能立项。
 - 配置部署：真实地址、用户名、密钥和控制套接字只保留在开发机，不进入仓库、环境模板或前端构建物。
 - 测试：两种 SSH 路径均需验证到同一 Mac 回环端点；离线样本只作显式开发回退，不得标记为实时 TDX。
 - 文档：同步更新 Tailscale/SSH 开发手册，明确家庭局域网与外部 Tailscale 的选择、启动、停止、切换和验证方法。
diff --git a/docs/features/FEAT-MO-001-market-overview/gitnexus/implementation-baseline.md b/docs/features/FEAT-MO-001-market-overview/gitnexus/implementation-baseline.md
new file mode 100644
index 0000000..a8c892c
--- /dev/null
+++ b/docs/features/FEAT-MO-001-market-overview/gitnexus/implementation-baseline.md
@@ -0,0 +1,32 @@
+# FEAT-MO-001 实施前门禁基线
+
+- 功能编号：FEAT-MO-001
+- 分支：`codex/feat-mo-001-tdx-overview`
+- 基线提交：`d283ee319692d4550149c591d4fe7f522c0bc6b8`
+- 记录时间：2026-08-18 13:04 CST
+
+## Schema
+
+- `pnpm schema:baseline`：通过，`v0.0.10 captured_empty`。
+- `pnpm schema:verify`：通过，`v0.0.10 captured_empty`。
+- 本次没有数据库结构变更，不读取生产数据库。
+
+## GitNexus
+
+```text
+Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis/.worktrees/feat-mo-001-tdx-overview
+Indexed commit: d283ee3
+Current commit: d283ee3
+Status: up-to-date
+```
+
+影响分析结果：
+
+- `ApiModule` upstream：LOW，直接消费者为 API `main.ts` 和进程冒烟测试。
+- `createAppRouter` upstream：LOW，无直接执行流消费者。
+- `createRequestClient` upstream：LOW，直接使用方为 Web API 健康请求模块。
+- `ApiModule.register` 复合名称未被 CLI 解析，已用 `ApiModule` 类上下文、`main.ts` 静态引用和 `register` 候选结果补齐证据；没有 HIGH/CRITICAL 结果。
+
+## 工作区说明
+
+主工作区已有用户修改的 `AGENTS.md`，本功能分支不将其纳入提交。功能代码只在本隔离工作区开发。
diff --git a/docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md b/docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md
new file mode 100644
index 0000000..4e7cbaa
--- /dev/null
+++ b/docs/features/FEAT-MO-001-market-overview/tdx-smoke-report.md
@@ -0,0 +1,22 @@
+# FEAT-MO-001 TDX 只读冒烟报告
+
+- 验证时间：2026-08-18 13:04 CST
+- 网络场景：外出 Tailscale + SSH 隧道
+- 本机业务入口：`127.0.0.1:17710`
+- 请求方式：HTTP POST JSON
+- 请求类型：单只公开行情 K 线只读请求
+- 原始载荷：未保存
+
+## 结果
+
+- HTTP 请求成功。
+- TDX 业务 `ErrorId` 为 `0`。
+- 返回字段完整性满足当前协议基线。
+- 响应包含：股票代码键、K 线日期、开盘价、最高价、最低价、收盘价、成交额、成交量、复权因子和分页元数据。
+- 未调用交易、账户、自选、写入或批量接口。
+
+## 脱敏与限制
+
+- 报告不保存真实价格、成交量、家庭网络地址、Tailscale 地址、SSH 用户、密钥或完整响应。
+- 本报告只证明当前开发机到 TDX 的只读协议可达，不证明 7×24 生产采集、商业再分发授权或所有板块/资金方法已经可用。
+- 后续接口实现必须继续以小批量只读请求验证板块、宽度和资金字段，并在映射测试中固定字段口径。