docs(FEAT-MO-005): 对齐最终 GitNexus 基线

docs(FEAT-MO-005): 完善市场结构功能追溯档案
feat(FEAT-MO-005): 展示市场结构与成交额趋势
2026-08-25 02:39:34 +08:00 · 2026-08-25 02:38:06 +08:00 · 2026-08-25 02:33:21 +08:00 · 2026-08-25 02:10:22 +08:00 · 2026-08-25 02:04:00 +08:00 · 2026-08-25 01:56:51 +08:00
424 changed files with 35585 additions and 382 deletions
@@ -3,6 +3,8 @@ node_modules/
 dist/
 coverage/
 *.tsbuildinfo
 playwright-report/
 test-results/
 # 本地环境与密钥
 .env
@@ -28,3 +30,5 @@ CLAUDE.md
 *.log
 tmp/
 work/
 .worktrees/
 .superpowers/
@@ -0,0 +1,4 @@
 engine-strict=true
 save-exact=true
 strict-peer-dependencies=true
 only-built-dependencies[]=esbuild
@@ -0,0 +1,11 @@
 # 自动生成或不可变发布产物
 AGENTS.md
 pnpm-lock.yaml
 database/schema-baselines/
 # 历史功能档案与人类维护文档不由代码格式器改写，追溯内容保持原样。
 docs/
 # 已有治理脚本保留原历史格式；其行为由专项测试门禁覆盖。
 tools/database/
 tools/governance/
@@ -0,0 +1,6 @@
 {
  "singleQuote": true,
  "trailingComma": "all",
  "printWidth": 100,
  "semi": true
 }
@@ -19,12 +19,17 @@
 8. 禁止提交密钥、密码、访问令牌、生产数据、`.env` 和 GitNexus 本地索引；凭据不得写入远程 URL、文档、脚本或命令参数。
 9. 开发完成后必须先通过代码 Review 和开发规范符合性 Review，再进入发布；Review 结论和问题处置必须写入功能档案。
 10. 每次提交验证通过后必须立即推送当前分支到项目 Gitea；本次新建标签必须单独推送。推送失败时任务不得标记完成，禁止强推或自动覆盖未知远程提交。
-11. Schema 基线只能读取 `APP_ENV=development` 的 `a_share_analysis_dev`，启用时主机必须是开发机回环地址；禁止连接、探测或读取生产数据库。MySQL 未启用时只允许生成可验证的 `not_applicable` 清单，禁止用空 SQL 冒充基线。`governance:start` 还必须确认基线已提交、已推送且远程标签一致。
+11. Schema 基线只能读取 `APP_ENV=development` 的 `a_share_analysis_dev`，启用时主机必须命中代码内固定开发白名单（开发机回环地址或 `112.192.20.11`）；禁止连接、探测或读取生产数据库。MySQL 未启用时只允许生成可验证的 `not_applicable` 清单，启用但无对象时生成 `captured_empty` 清单，禁止用空 SQL 冒充基线。`governance:start` 还必须确认基线已提交、已推送且远程标签一致。
 12. 功能和缺陷修复开发前必须用 GitNexus 评估直接、间接及跨模块影响，并逐项判断 HTTP/OpenAPI、Web API、消息、数据库、Redis、API、Scheduler、Worker、部署、测试和文档是否同步修改；`partial` 结果不得视为无影响。
 13. 设计、测试计划和 Review 必须包含安全策略、性能目标、验证证据及残余风险；不适用项必须写明原因与边界。
 14. 每个未发布功能必须有独立 `development-summary.md`，明确原始需求、范围变化、实际完成、修复缺陷、延期项、关键提交和验证证据，不得合并到发布说明。
 15. 后端以业务模块为一级目录并在模块内按需分层，小模块不凑目录；前端统一由 `web/src/utils/request.ts` 封装 Axios，业务请求只能位于 `web/src/api/<业务域>/index.ts`，OpenAPI 类型继续作为契约来源。
 16. 复用代码只有在真实重复和稳定职责出现后才能抽取；新增依赖必须先评估用途、替代、安全、许可证、体积或运行成本、维护和退出方案。
 <!-- gitnexus:start -->
 # GitNexus — Code Intelligence
-This project is indexed by GitNexus as **a-share-analysis** (958 symbols, 1141 relationships, 23 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
+This project is indexed by GitNexus as **a-share-analysis** (4266 symbols, 6330 relationships, 147 execution flows). Use the GitNexus MCP tools to understand code, assess impact, and navigate safely.
 > If any GitNexus tool warns the index is stale, run `npx gitnexus analyze` in terminal first.
@@ -2,6 +2,33 @@
 本项目采用语义化版本。功能级变化请从 `docs/features/` 按功能编号追溯。
 ## Unreleased
 ## 0.0.10 - 2026-08-18
 - 使用 Node.js 22.x 与 mysql2 直接读取 MySQL 5.7.x 元数据和 `SHOW CREATE`，移除 Schema 基线对本机 MySQL CLI 的依赖。
 - 新增 format v3 exporter/driver 元数据，永久只读兼容 format v1/v2。
 - 增加对象目录、视图依赖排序、并发漂移检测、错误脱敏、超时和定义大小保护。
 - 恢复版本开发门禁并封存 `v0.0.9` development `captured_empty` Schema 基线。
 ## 0.0.9 - 2026-08-17
 - Node.js 运行时约束明确为完整 22.x，不绑定 minor 或 patch。
 - MySQL 客户端、mysqldump、服务端和健康检查统一接受完整 5.7.x，不设置最低补丁版本。
 - MySQL 健康详情改为展示服务端实际三段版本，字符集、排序规则、库名和东八区时区继续严格校验。
 - 系统架构、开发规范、本地开发和 Ubuntu 源码部署手册统一采用系列版本口径，历史版本证据保持原样。
 - 用户确认开发库为空并授权 GOV-011 一次性跳过 v0.0.8 Schema 基线；仓库未伪造基线或增加通用绕过开关。
 ## 0.0.8 - 2026-08-17
 - 新增安全、性能、GitNexus 跨模块影响和独立开发总结的可执行治理门禁。
 - 约定后端业务模块内按需分层，以及前端 Axios 统一封装、API 分域和 OpenAPI 类型契约。
 - 项目生产交付统一为 Ubuntu 源码部署，移除 Dockerfile、Compose、镜像校验和容器测试入口。
 - 本地 Redis、MySQL 5.7.42 与 RocketMQ 5.x 均作为外部服务，项目不再提供自动启动或容器兜底。
 - 新增源码发布门禁，校验 Web/Server 构建产物与 systemd、Nginx 配置一致性。
 - 完成 Vue 3 Web、NestJS API/Scheduler/Worker、OpenAPI 单向契约和最小权限配置的工程基线确认。
 - 补充 Tailscale 访问 Windows TDX 的开发操作文档和采集 PoC 前置档案；本版本不实现常驻采集程序。
 ## 0.0.7 - 2026-08-13
 - 将项目唯一消息队列技术基线由 RabbitMQ 调整为 RocketMQ 5.x。
@@ -1,27 +1,59 @@
 # A-Share Analysis
-A read-only A-share market overview and analysis tool.
+一个只读的 A 股市场概览与盘面分析工具，面向个人复盘和小范围使用，不提供交易下单、荐股、社区或公开组合功能。
 ## 当前阶段
-项目正在建立工程基线，首个业务模块为市场综合概览。当前不包含用户体系、订阅与支付。
+项目当前以市场综合概览为首个业务模块，用户体系、订阅与支付暂不进入首屏业务范围。
 当前已接入 TDX 只读行情并完成以下首屏模块：
 - 市场结论、驱动因素和风险摘要。
 - 核心指数、三市场宽度、一级行业板块强弱和三市场成交额趋势。
 - 综合、短线、中长线视角入口，以及规则、AI、混合、对照分析偏好入口。
 - 指数和板块详情入口已预留，详情页另立功能实现；强势个股模块尚未开发。
 - 超短情绪补充模块已接入本机 AKTools：展示涨停、最高连板、炸板、昨日涨停表现、涨停行业和规则结论；AKTools 不可用时独立降级。
 主力净流入、完整盘中新闻、版本化概念题材成分和 AI 自动结论仍需独立数据源或后续功能立项，不用 TDX 或 AKShare 缺失字段冒充。
 ## Projects
- `web/`: Vue 3 market terminal frontend.
+- web/: Vue 3、Vite、TypeScript、Naive UI、Dart Sass、Axios 前端。
- `server/`: NestJS API, scheduler, and workers. Added in a later module.
+- server/: NestJS API、Scheduler 与 Worker 三个独立源码进程。
- `deploy/`: MySQL 5.7, Redis, and RocketMQ 5.x deployment configuration. Added with the backend module.
+- deploy/: MySQL 5.7.x、Redis、RocketMQ 5.x 的配置契约，以及 systemd/Nginx 源码部署模板。
- `docs/`: Product and implementation specifications.
+- docs/: PRD、架构、治理、部署和功能档案。
 - tools/: Schema、契约、边界和治理验证工具。
-The first implementation slice is the market overview screen in `web/`.
+首个实现切片是 web/ 下的市场综合概览首屏。
 ## 环境与部署
- [本地开发环境](docs/deployment/local-development.md)：Compose 只启动 Redis，应用从源码运行。
+- [本地开发环境](docs/deployment/local-development.md)：使用开发机已有 Redis，应用全部从源码运行。
- [Docker Compose 生产部署](docs/deployment/docker-compose-production.md)：当前为应用脚手架落地前的配置契约骨架。
+- [Ubuntu 源码生产部署](docs/deployment/ubuntu-source-production.md)：项目唯一生产部署方式，支持 Ubuntu 22.04/24.04 LTS x86_64。
 - [Ubuntu 源码生产部署](docs/deployment/ubuntu-source-production.md)：支持 Ubuntu 22.04/24.04 LTS x86_64。
-无秘密环境模板位于 `deploy/env/`。生产配置不进入 Git 或发布目录；Node.js 22 LTS、pnpm 10、Nginx 和基础设施由服务器管理员提供。
+无秘密环境模板位于 deploy/env/。生产配置不进入 Git 或发布目录；Node.js 22.x、pnpm 10.x、Nginx 和外部基础设施由服务器管理员提供。项目不安装、启动、停止或删除 Redis、MySQL 和 RocketMQ。
 前端开发服务器固定监听 127.0.0.1:8888，API 使用 127.0.0.1:3000。当前首屏不依赖 Scheduler、Worker 或 RocketMQ 消费链路；MySQL、Redis 和 RocketMQ 是否启用，以各进程的 local 配置和具体功能需求为准。
 AKTools 是项目外部维护的 AKShare HTTP 服务，开发机默认监听 `127.0.0.1:8080`。API 仅在 `AKTOOLS_ENABLED=true` 时调用三个固定接口；项目不安装、启动、停止或暴露 AKTools，也不允许前端直接请求它。生产是否启用必须先完成上游授权、稳定性和访问控制评估。
 数据库开发约束：Schema 基线只能读取开发库 a_share_analysis_dev，禁止触碰生产库；字符集为 utf8mb4，排序规则为 utf8mb4_general_ci，时区为东八区。
 ## TDX 连接方式
 平台始终访问 Mac 本机回环地址 http://127.0.0.1:17710/。该地址由 SSH 隧道转发到家中 Windows 的 TDX 客户端 127.0.0.1:17709，不把 TDX 暴露到局域网或公网。
 在家使用 tdx-windows-lan，在外通过 Tailscale 使用 tdx-windows-tailnet；两种隧道不能同时启动：
    # 外部网络场景
    tailscale up
    tailscale ping <WINDOWS_TAILSCALE_HOST>
    ssh -fN -M -S ~/.ssh/tdx-windows-tailnet-control tdx-windows-tailnet
    nc -vz 127.0.0.1 17710
    lsof -nP -iTCP:17710 -sTCP:LISTEN
 完整的 Windows OpenSSH、双场景切换、停止和只读冒烟步骤见 docs/deployment/tailscale-tdx-development.md。
 ## 开发入口
@@ -29,6 +61,9 @@ The first implementation slice is the market overview screen in `web/`.
 - [代码开发规范](docs/governance/code-development-standards.md)
 - [开发流程规范](docs/governance/development-workflow.md)
 - [系统架构](docs/architecture/system-architecture.md)
 - [本地开发环境](docs/deployment/local-development.md)
 - [TDX 隧道开发手册](docs/deployment/tailscale-tdx-development.md)
 - [Ubuntu 源码生产部署](docs/deployment/ubuntu-source-production.md)
 开始任何模块前，先阅读根目录 `AGENTS.md`，然后运行：
@@ -38,7 +73,24 @@ npm run schema:verify
 npm run governance:start -- FEAT-MO-001 market-overview
 ```
-Schema 命令只允许处理固定开发库；当前 MySQL 未启用时会为上一发布版本生成可验证的不适用清单，不会连接数据库或创建空 SQL。完整规则见 [开发流程规范](docs/governance/development-workflow.md)。
+Schema 命令只允许处理固定开发库；导出器使用 Node.js `mysql2`，本机无需安装 MySQL Server 或 CLI。当前 MySQL 未启用时会为上一发布版本生成可验证的不适用清单，不会连接数据库或创建空 SQL；启用但无对象时生成 format v3 `captured_empty` 清单。完整规则见 [开发流程规范](docs/governance/development-workflow.md)。
 ### 本地启动
    pnpm install --frozen-lockfile
    pnpm check:runtime
    redis-cli -h 127.0.0.1 -p 6379 ping
    pnpm --filter @a-share-analysis/server dev:api
    pnpm --filter @a-share-analysis/web dev
 访问 Web：<http://127.0.0.1:8888/>；访问 API 健康检查：<http://127.0.0.1:3000/api/v1/health>。前端同源 /api 请求由 Vite 代理到 API，strictPort 已启用，8888 被占用时会明确失败，不会静默换端口。
 Scheduler 和 Worker 只在对应任务链路开发时启动：
    pnpm --filter @a-share-analysis/server dev:scheduler
    pnpm --filter @a-share-analysis/server dev:worker
 前端 API 请求统一经过 web/src/utils/request.ts 封装的 Axios；业务请求位于 web/src/api/<业务域>/index.ts。
 ## 项目仓库
@@ -1 +1 @@
-0.0.7
+0.0.10
@@ -0,0 +1,33 @@
 {
  "format_version": 3,
  "status": "captured_empty",
  "application_version": "v0.0.10",
  "git_commit": "16bde94df68263672fa12e2823afe024c741f84e",
  "source_environment": "development",
  "database_name": "a_share_analysis_dev",
  "charset": "utf8mb4",
  "collation": "utf8mb4_general_ci",
  "generated_at": "2026-08-17T19:07:54.864Z",
  "generator": "schema-baseline/3.0.0",
  "reason": "none",
  "schema_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "objects": {
    "tables": false,
    "views": false,
    "triggers": false,
    "routines": false,
    "events": false
  },
  "object_counts": {
    "tables": 0,
    "views": 0,
    "triggers": 0,
    "routines": 0,
    "events": 0
  },
  "exporter_name": "mysql2-show-create",
  "exporter_version": "1.0.0",
  "database_driver": "mysql2",
  "database_driver_version": "3.23.3",
  "mysql_server_version": "5.7.42-0ubuntu0.18.04.1"
 }
@@ -0,0 +1,24 @@
 {
  "format_version": 1,
  "status": "not_applicable",
  "application_version": "v0.0.7",
  "git_commit": "7dc04a267199fb3a11c2ac43c2914ae5e1460cb9",
  "source_environment": "development",
  "database_name": "a_share_analysis_dev",
  "mysql_client_version": "not_enabled",
  "mysqldump_client_version": "not_enabled",
  "mysql_server_version": "not_enabled",
  "charset": "utf8mb4",
  "collation": "utf8mb4_general_ci",
  "generated_at": "2026-08-13T06:55:43.710Z",
  "generator": "schema-baseline/1.0.0",
  "reason": "mysql_disabled",
  "schema_sha256": "not_applicable",
  "objects": {
    "tables": false,
    "views": false,
    "triggers": false,
    "routines": false,
    "events": false
  }
 }
@@ -0,0 +1,33 @@
 {
  "format_version": 3,
  "status": "captured_empty",
  "application_version": "v0.0.9",
  "git_commit": "88e2fdffc8c71dd682405c148a81953a8dcee9d6",
  "source_environment": "development",
  "database_name": "a_share_analysis_dev",
  "charset": "utf8mb4",
  "collation": "utf8mb4_general_ci",
  "generated_at": "2026-08-17T18:56:33.473Z",
  "generator": "schema-baseline/3.0.0",
  "reason": "none",
  "schema_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
  "objects": {
    "tables": false,
    "views": false,
    "triggers": false,
    "routines": false,
    "events": false
  },
  "object_counts": {
    "tables": 0,
    "views": 0,
    "triggers": 0,
    "routines": 0,
    "events": 0
  },
  "exporter_name": "mysql2-show-create",
  "exporter_version": "1.0.0",
  "database_driver": "mysql2",
  "database_driver_version": "3.23.3",
  "mysql_server_version": "5.7.42-0ubuntu0.18.04.1"
 }
@@ -1,23 +0,0 @@
 name: a-share-analysis-development
 services:
  redis:
    image: redis:7.2.5-alpine
    container_name: a-share-analysis-dev-redis
    command: ["redis-server", "--appendonly", "yes"]
    ports:
      - "127.0.0.1:6379:6379"
    volumes:
      - ../../.local/redis:/data
    healthcheck:
      test: ["CMD", "redis-cli", "ping"]
      interval: 5s
      timeout: 3s
      retries: 10
    restart: unless-stopped
    networks:
      - a-share-analysis-dev
 networks:
  a-share-analysis-dev:
    name: a-share-analysis-dev
@@ -1,30 +0,0 @@
 # 应用镜像和启动入口将在 Web/Server 脚手架落地后验证。本文件先固定生产配置边界。
 name: a-share-analysis-production
 services:
  web:
    image: ${A_SHARE_WEB_IMAGE:?必须提供不可变 Web 镜像引用}
    env_file: ${A_SHARE_WEB_ENV_FILE:-/etc/a-share-analysis/web.env}
    ports:
      - "127.0.0.1:8080:80"
    restart: unless-stopped
  api:
    image: ${A_SHARE_SERVER_IMAGE:?必须提供不可变 Server 镜像引用}
    command: ["node", "dist/apps/api/main.js"]
    env_file: ${A_SHARE_API_ENV_FILE:-/etc/a-share-analysis/api.env}
    ports:
      - "127.0.0.1:3000:3000"
    restart: unless-stopped
  scheduler:
    image: ${A_SHARE_SERVER_IMAGE:?必须提供不可变 Server 镜像引用}
    command: ["node", "dist/apps/scheduler/main.js"]
    env_file: ${A_SHARE_SCHEDULER_ENV_FILE:-/etc/a-share-analysis/scheduler.env}
    restart: unless-stopped
  worker:
    image: ${A_SHARE_SERVER_IMAGE:?必须提供不可变 Server 镜像引用}
    command: ["node", "dist/apps/worker/main.js"]
    env_file: ${A_SHARE_WORKER_ENV_FILE:-/etc/a-share-analysis/worker.env}
    restart: unless-stopped
@@ -4,6 +4,12 @@ APP_ENV=development
 API_HOST=127.0.0.1
 API_PORT=3000
 LOG_LEVEL=debug
 TDX_BASE_URL=http://127.0.0.1:17710
 TDX_TIMEOUT_MS=5000
 # AKTools 仅在本机内网补充超短行情，关闭时短线模块返回不可用。
 AKTOOLS_ENABLED=false
 AKTOOLS_BASE_URL=http://127.0.0.1:8080
 AKTOOLS_TIMEOUT_MS=10000
 # 第一阶段实际启用的 Redis。
 REDIS_HOST=127.0.0.1
@@ -22,6 +28,7 @@ MYSQL_USERNAME=
 MYSQL_PASSWORD=
 MYSQL_CHARSET=utf8mb4
 MYSQL_COLLATION=utf8mb4_general_ci
 MYSQL_TIMEZONE=+08:00
 # 第一阶段关闭付费 AI；启用后 BASE_URL、API_KEY 和 MODEL 变为必填。
 AI_ENABLED=false
@@ -1,5 +1,5 @@
 # VITE 变量会进入浏览器，只允许公开配置。
 VITE_APP_ENV=development
 VITE_APP_TITLE=A-Share Analysis
-VITE_API_BASE_URL=http://127.0.0.1:3000/api
+VITE_API_BASE_URL=
 VITE_ENABLE_DEVTOOLS=true
@@ -21,6 +21,7 @@ MYSQL_USERNAME=
 MYSQL_PASSWORD=
 MYSQL_CHARSET=utf8mb4
 MYSQL_COLLATION=utf8mb4_general_ci
 MYSQL_TIMEZONE=+08:00
 ROCKETMQ_ENABLED=false
 ROCKETMQ_NAMESRV_ADDR=127.0.0.1:9876
@@ -3,6 +3,12 @@ APP_ENV=production
 API_HOST=127.0.0.1
 API_PORT=3000
 LOG_LEVEL=info
 TDX_BASE_URL=http://127.0.0.1:17710
 TDX_TIMEOUT_MS=5000
 # AKTools 仅允许受控内网回环部署，未配置时保持关闭。
 AKTOOLS_ENABLED=false
 AKTOOLS_BASE_URL=http://127.0.0.1:8080
 AKTOOLS_TIMEOUT_MS=10000
 REDIS_HOST=127.0.0.1
 REDIS_PORT=6379
@@ -20,6 +26,7 @@ MYSQL_USERNAME=
 MYSQL_PASSWORD=
 MYSQL_CHARSET=utf8mb4
 MYSQL_COLLATION=utf8mb4_general_ci
 MYSQL_TIMEZONE=+08:00
 AI_ENABLED=false
 AI_BASE_URL=
@@ -1,5 +1,5 @@
 # VITE 变量会进入浏览器，只允许公开配置。
 VITE_APP_ENV=production
 VITE_APP_TITLE=A-Share Analysis
-VITE_API_BASE_URL=/api
+VITE_API_BASE_URL=
 VITE_ENABLE_DEVTOOLS=false
@@ -21,6 +21,7 @@ MYSQL_USERNAME=
 MYSQL_PASSWORD=
 MYSQL_CHARSET=utf8mb4
 MYSQL_COLLATION=utf8mb4_general_ci
 MYSQL_TIMEZONE=+08:00
 ROCKETMQ_ENABLED=false
 ROCKETMQ_NAMESRV_ADDR=
@@ -9,11 +9,14 @@ User=a-share
 Group=a-share
 WorkingDirectory=/opt/a-share-analysis/current
 EnvironmentFile=/etc/a-share-analysis/api.env
-ExecStart=/usr/bin/node server/dist/apps/api/main.js
+ExecStart=/usr/bin/node /opt/a-share-analysis/current/server/dist/apps/api/main.js
 ExecStartPre=/usr/bin/test -r /etc/a-share-analysis/api.env
 Restart=on-failure
 RestartSec=5
 NoNewPrivileges=true
 PrivateTmp=true
 ProtectSystem=strict
 ProtectHome=true
 [Install]
 WantedBy=multi-user.target
@@ -9,11 +9,14 @@ User=a-share
 Group=a-share
 WorkingDirectory=/opt/a-share-analysis/current
 EnvironmentFile=/etc/a-share-analysis/scheduler.env
-ExecStart=/usr/bin/node server/dist/apps/scheduler/main.js
+ExecStart=/usr/bin/node /opt/a-share-analysis/current/server/dist/apps/scheduler/main.js
 ExecStartPre=/usr/bin/test -r /etc/a-share-analysis/scheduler.env
 Restart=on-failure
 RestartSec=5
 NoNewPrivileges=true
 PrivateTmp=true
 ProtectSystem=strict
 ProtectHome=true
 [Install]
 WantedBy=multi-user.target
@@ -9,11 +9,14 @@ User=a-share
 Group=a-share
 WorkingDirectory=/opt/a-share-analysis/current
 EnvironmentFile=/etc/a-share-analysis/worker.env
-ExecStart=/usr/bin/node server/dist/apps/worker/main.js
+ExecStart=/usr/bin/node /opt/a-share-analysis/current/server/dist/apps/worker/main.js
 ExecStartPre=/usr/bin/test -r /etc/a-share-analysis/worker.env
 Restart=on-failure
 RestartSec=5
 NoNewPrivileges=true
 PrivateTmp=true
 ProtectSystem=strict
 ProtectHome=true
 [Install]
 WantedBy=multi-user.target
@@ -7,7 +7,9 @@
 ```text
 web/        Vue 3 前端
 server/     NestJS API、Scheduler 与 Worker
-contracts/  HTTP 与 RocketMQ 版本化契约
+server/openapi/                 HTTP OpenAPI 产物
 server/libs/http-contracts/     后端 HTTP DTO
 server/libs/message-contracts/  后端 RocketMQ 版本化契约
 deploy/     MySQL、Redis、RocketMQ 5.x 和运行配置
 docs/       规范、架构、ADR 与功能档案
 tools/      可重复执行的治理和开发工具
@@ -38,23 +40,43 @@ tools/      可重复执行的治理和开发工具
 - Redis保存最新快照、缓存、锁和限流状态。
 - Vue前端只读后端 API，不直接接触外部数据源和密钥。
-## 3. 数据库技术基线
+市场概览的 AKTools 补充链路是按需读取的例外：Nest API 通过固定 Adapter 调用外部 AKTools HTTP 服务，前端不直连，且失败只影响超短模块。它不经过 Scheduler、Worker、RocketMQ、MySQL 或 Redis，也不改变后续正式采集链路的总体架构。
- 数据库服务端固定使用 MySQL 5.7.x，开发、测试和生产环境禁止使用 MySQL 8.x 代替兼容性验证。
+## 3. 前后端模块边界
 后端以业务模块为一级目录，模块内部按实际职责建立 Controller、Service、DTO、Domain、Repository 和 Adapter。小模块不强制凑齐目录，禁止把全部 Controller/Service 堆入全局目录，也禁止无业务逻辑的透传层。领域规则只依赖项目端口，MySQL、Redis、RocketMQ、免费数据源和 AI Provider 由基础设施 Adapter 实现。
 前端 HTTP 数据流固定为：
 ```text
 NestJS DTO 与 Swagger 元数据
  → server/openapi/openapi.json
  → openapi-typescript 生成 web/src/api/generated/schema.ts
  → web/src/api/<业务域>/index.ts
  → web/src/utils/request.ts（Axios）
  → 功能 adapter / ViewModel
  → 页面、组件和 Store
 ```
 OpenAPI 负责描述本项目 HTTP 契约，Axios 负责浏览器实际请求。页面、组件、Store 和 Composable 不直接发 HTTP。兼容 OpenAI API 指未来后端 AI Provider 的外部协议，与前端请求库无关。
 ## 4. 数据库技术基线
 - 数据库服务端统一使用 MySQL 5.7.x；开发、测试和生产环境禁止使用 MySQL 5.6.x、8.x、MariaDB 或其他数据库代替兼容性验证，但不锁定 5.7 系列内的补丁版本。
 - 数据库与表默认字符集固定为 `utf8mb4`，排序规则固定为 `utf8mb4_general_ci`。
 - 数据库初始化、表结构、连接会话、ORM 配置和迁移脚本必须显式声明或验证该字符集与排序规则，不能依赖服务器默认值。
- 正式启用持久化前，必须在真实 MySQL 5.7 环境验证服务端版本、Schema/表排序规则、迁移和关键查询。
+- 正式启用持久化前，必须在真实 MySQL 5.7.x 环境验证服务端版本、Schema/表排序规则、迁移和关键查询。
 - 第一阶段市场概览只定义 MySQL Repository 接口并使用内存实现，不启动数据库、不建立生产连接；后续启用时不得改变前端 API 和核心分析契约。
-## 4. 当前实施顺序
+## 5. 当前实施顺序
 第一阶段先实现可交互的市场综合概览和稳定数据契约，再接入正式行情采集链路。用户、邀请、权限、会员和支付后置，不进入当前核心架构。
-## 5. 环境与部署基线
+## 6. 环境与部署基线
 - 应用运行环境只定义 `development` 与 `production`；生产环境禁止模拟数据、热更新、调试端口和开发默认值回退。
 - API、Scheduler、Worker、Web 分别拥有开发和生产模板；同一进程跨环境使用相同变量名，通过启动 Schema 校验条件必填项。
- 本地开发使用 Docker Compose 只启动 Redis，应用进程从源码运行；第一阶段 MySQL 与 RocketMQ 保持关闭。需要联调时可以连接本机独立运行的 RocketMQ 5.x。
+- 本地开发直接连接开发机已开机自启的 Redis `127.0.0.1:6379`，应用进程从源码运行；第一阶段 MySQL 与 RocketMQ 保持关闭，需要联调时连接开发者独立维护的外部服务。
- 生产同时支持 Docker Compose 和 Ubuntu 22.04/24.04 LTS x86_64 源码部署，两者共用配置契约和进程边界。
+- 生产只支持 Ubuntu 22.04/24.04 LTS x86_64 源码部署，不提供容器运行、构建、测试或部署入口。
- 源码部署由管理员预装 Node.js 22 LTS、pnpm 10、Nginx 和基础设施；项目只验证，不安装或修改系统软件源。
+- 源码部署由管理员预装 Node.js 22.x、pnpm 10.25.0、Nginx 和外部基础设施；项目只验证，不安装、启动、停止或删除系统服务。
 - 源码部署使用不可变发布目录、`a-share` 用户和 systemd 独立进程配置；生产 env 存放在 `/etc/a-share-analysis/`，不随代码版本切换覆盖。
@@ -1,19 +0,0 @@
 # Docker Compose 生产部署
 生产 Docker Compose 使用不可变应用镜像和外部 env 文件。当前 `production.yml.example` 是部署契约骨架，应用镜像、健康检查和实际启动命令必须在 Web/Server 脚手架完成后验证，未验证前不得用于线上部署。
 ## 配置边界
 - 从 `deploy/env/production/` 准备四份真实配置，存放在服务器 `/etc/a-share-analysis/` 或其他受控目录。
 - Compose 通过外部路径加载，不在 YAML、镜像和 Git 中保存秘密。
 - 镜像引用必须包含版本或内容摘要，禁止浮动 `latest`。
 - 第一阶段只依赖 Redis；MySQL 和 RocketMQ 5.x 功能开关保持关闭。
 - 启用 RocketMQ 时优先连接受运维管理的外部集群或独立基础设施 Compose，不把 NameServer、Broker、Proxy 混入应用发布生命周期。
 ## 发布与回退
 部署前验证镜像对应已推送提交或标签、环境 Schema、健康检查和数据目录。升级只修改不可变镜像引用；失败时恢复上一完整镜像集合和未改变的外部配置。禁止删除 Redis、MySQL 或 RocketMQ CommitLog 数据目录作为应用回退手段。
 ## 验证
 应用脚手架落地后必须补充 `docker compose config`、服务健康检查、日志读取、优雅停止和回退演练证据。本版本不声称生产 Compose 已可运行。
@@ -1,27 +1,52 @@
 # 本地开发环境
-本地开发使用 Docker Compose 只启动 Redis，Web、API、Scheduler 和 Worker 从源码运行并使用开发环境模板。第一阶段不自动启动 MySQL 和 RocketMQ 5.x。
+本地开发由开发机提供 Node.js 22.x、pnpm 10.25.0 和已开机自启的 Redis `127.0.0.1:6379`。Web、API、Scheduler 与 Worker 全部从源码启动；MySQL 5.7.x 和 RocketMQ 5.x 也是外部服务，项目脚本不负责安装、启动、停止或删除任何基础设施。
-## 配置
+## 首次准备
 从 `deploy/env/development/` 中对应的 `*.env.example` 创建本机 `*.env.local`。真实文件被 Git 忽略，不得写入生产地址或真实密钥。
 ## Redis
 ```bash
-docker compose -f deploy/compose/development.yml up -d
+node --version
-docker compose -f deploy/compose/development.yml ps
+pnpm --version
-docker compose -f deploy/compose/development.yml down
+redis-cli -h 127.0.0.1 -p 6379 ping
 pnpm install --frozen-lockfile
 pnpm check:runtime
 ```
-Redis 只绑定 `127.0.0.1:6379`，数据写入仓库忽略的 `.local/redis/`。不得把该 Compose 文件用于生产。
+Redis 必须返回 `PONG`。如果不可达，应先修复开发机外部服务；测试和应用不会创建替代实例。
-## RocketMQ 联调
+把 `deploy/env/development/*.env.example` 复制为同目录的 `*.env.local`。四份 local 文件被 Git 忽略：Web 只能含 `VITE_` 公开变量；API、Scheduler、Worker 按最小权限分别读取自己的配置，不共享一份全能 env。
-RocketMQ 由开发者在项目 Compose 外独立启动。应用启用前至少需要 NameServer、Broker；采用推荐的 Node.js Proxy 接入时还需要 Proxy。默认端口约定：NameServer `9876`、Broker `10911`、Proxy gRPC `8081`。
+固定开发 MySQL 只允许 `a_share_analysis_dev`，主机必须是回环地址或代码内白名单 `112.192.20.11`，服务端必须属于 MySQL 5.7.x 且不限制系列内补丁版本，字符集为 `utf8mb4`、排序规则为 `utf8mb4_general_ci`、会话时区为 `+08:00`。Schema 工具和开发检查禁止连接、探测或读取生产库。
-`nc -vz 127.0.0.1 9876` 只能证明 NameServer TCP 可达，不能证明 Topic 路由、Broker 注册或消息收发可用。完整联调必须继续检查 Broker 列表，并执行一次测试 Topic 的生产与消费。开发模板默认 `ROCKETMQ_ENABLED=false`；启用后必须提供可用的 `ROCKETMQ_ENDPOINT`，不得把生产地址写入本地配置或仓库。
+## 启动顺序
-## 应用状态
+建议分别打开四个终端，依次运行：
-Web 和 Server 尚未完成脚手架，因此本版本只交付配置契约和 Redis 开发环境。后续脚手架必须使用 Node.js 22 LTS、pnpm 10 和这些模板，不能在本文档中假装应用已经可启动。
+```bash
 pnpm --filter @a-share-analysis/server dev:api
 pnpm --filter @a-share-analysis/server dev:scheduler
 pnpm --filter @a-share-analysis/server dev:worker
 pnpm --filter @a-share-analysis/web dev
 ```
 API 健康端点是 `http://127.0.0.1:3000/api/v1/health`，Web 是 `http://127.0.0.1:8888/`。Scheduler 与 Worker 在 GOV-009 中保持 `ROCKETMQ_ENABLED=false`；没有经过验证的 Node RocketMQ 客户端时，启用配置会直接失败，不使用内存队列伪降级。
 ## AKTools 补充数据源
 AKTools/AKShare 作为开发机外部服务单独运行，默认地址为 `http://127.0.0.1:8080`。启动 API 前确认服务可访问；需要启用短线情绪模块时，在 API local 配置中设置 `AKTOOLS_ENABLED=true`，否则模块明确显示不可用，不影响 TDX 模块。Nest 只允许三个已验证接口，前端不直连 AKTools。项目不会管理该 Python 服务的安装、进程和数据。
 ```bash
 curl --fail 'http://127.0.0.1:8080/api/public/stock_zt_pool_em?date=20260824'
 ```
 生产环境不能直接复用本机 AKTools 配置；启用前必须提供受控内网地址、认证/访问控制、上游授权和稳定性评估，并扩展服务端白名单校验。
 ## 日常验证与停止
 ```bash
 pnpm check:contracts
 pnpm verify
 pnpm verify:release
 ```
 应用进程通过各自终端或信号正常停止，外部 Redis/MySQL/RocketMQ 生命周期不由项目管理。RocketMQ 的 TCP 端口可达不等于生产消费链路通过，完整联调仍需验证 Topic 路由和实际生产/消费。
@@ -0,0 +1,441 @@
 # Tailscale + SSH 隧道访问 TDX 开发手册
 ## 1. 用途与适用边界
 本手册用于 Mac 本地开发期间，访问家中 Windows 上仅监听回环地址的 TDX HTTP 接口。TDX 是市场概览的正式行情来源；SSH 隧道负责把家庭局域网和外部 Tailscale 两种开发位置统一成同一个 Mac 回环入口。该链路不是生产采集、数据上报或公网部署方案。
 ```text
 Mac 本地程序 / TDX Bridge
  -> 127.0.0.1:17710
  -> SSH 本地端口转发
  -> 家庭局域网或 Tailscale 私有网络
  -> 同一台 Windows OpenSSH
  -> Windows 127.0.0.1:17709
  -> TDX
 ```
 两个场景只切换 SSH 目标别名，TDX Bridge 和上层业务始终访问 `http://127.0.0.1:17710/`。离线样本只允许作为显式开发和自动化测试回退，并必须标记为离线数据；不得伪装为实时 TDX。Windows 离线不得阻塞普通测试或构建。
 ## 2. 安全边界
 - 不在路由器上开放或转发 SSH、RDP、`17709`、`17710` 等端口。
 - TDX 继续只监听 Windows `127.0.0.1:17709`，不得改为 `0.0.0.0`。
 - SSH 使用独立 Ed25519 密钥，不在脚本、仓库、文档或远程 URL 中保存密码和私钥。
 - Mac 转发端口只绑定 `127.0.0.1:17710`，不得绑定局域网或所有网卡。
 - 真实返回只用于只读验证。日志和测试报告必须脱敏，不保存家庭网络信息、登录信息或无关原始载荷。
 - 开发隧道不连接生产数据库、不承担生产采集，也不证明数据源具备商业展示或再分发授权。
 文档中的值均为占位符：
 - `<WINDOWS_TAILSCALE_HOST>`：Windows 的 Tailscale MagicDNS 名称或 Tailscale IP。
 - `<WINDOWS_SSH_USER>`：用于 SSH 登录的 Windows 用户。
 - `<MAC_TAILSCALE_IP>`：Mac 的 Tailscale IP，仅在收紧防火墙来源时使用。
 ## 3. 首次建立 Tailscale 网络
 ### 3.1 Mac
 1. 从 Tailscale 官方渠道安装客户端。
 2. 登录项目使用的同一个 Tailnet。
 3. 确认菜单栏中的 Tailscale 状态为已连接。
 4. 在终端检查本机和节点列表：
 ```bash
 tailscale ip -4
 tailscale status
 ```
 ### 3.2 Windows
 1. 从 Tailscale 官方渠道安装客户端。
 2. 登录与 Mac 相同的 Tailnet。
 3. 确认 Windows 节点在 Tailscale 管理后台和 Mac 的 `tailscale status` 中均为在线。
 4. 在 Windows PowerShell 中检查地址和状态：
 ```powershell
 tailscale ip -4
 tailscale status
 ```
 ### 3.3 私网连通验证
 在 Mac 执行：
 ```bash
 tailscale ping <WINDOWS_TAILSCALE_HOST>
 ```
 只有 Tailscale ping 成功后再排查 SSH。不要用公网 IP 替换占位符，也不要为排障临时开放路由器端口。
 ## 4. 配置 Windows OpenSSH Server
 以下命令在 Windows 管理员 PowerShell 中执行。
 ### 4.1 安装并启动服务
 ```powershell
 Get-WindowsCapability -Online | Where-Object Name -Like 'OpenSSH.Server*'
 Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
 Start-Service sshd
 Set-Service -Name sshd -StartupType Automatic
 Get-Service sshd
 ```
 如果 OpenSSH Server 已安装，`Add-WindowsCapability` 可以跳过。`Get-Service sshd` 应显示服务正在运行且启动类型为自动。
 检查端口监听：
 ```powershell
 Get-NetTCPConnection -LocalPort 22 -State Listen
 ```
 ### 4.2 确认防火墙规则
 OpenSSH 安装通常会创建入站规则。先检查，不要重复创建同名规则：
 ```powershell
 Get-NetFirewallRule -Name 'OpenSSH-Server-In-TCP' -ErrorAction SilentlyContinue
 ```
 首次联调可以保留系统创建的 SSH 规则；链路确认后按第 11 节限制为 Tailscale 来源。不得新增公网端口映射。
 ## 5. 配置 SSH 密钥登录
 ### 5.1 在 Mac 生成项目专用密钥
 ```bash
 ssh-keygen -t ed25519 -a 100 -f ~/.ssh/tdx_windows -C "tdx-windows-development"
 chmod 600 ~/.ssh/tdx_windows
 chmod 644 ~/.ssh/tdx_windows.pub
 pbcopy < ~/.ssh/tdx_windows.pub
 ```
 私钥 `~/.ssh/tdx_windows` 只保留在 Mac，不发送给 Windows，也不提交仓库。建议为私钥设置口令，并由 macOS 钥匙串或 `ssh-agent` 管理。
 ### 5.2 Windows 管理员账户
 Windows OpenSSH 默认从 `C:\ProgramData\ssh\administrators_authorized_keys` 读取管理员公钥。必须先创建文件，再设置 ACL；否则 `icacls` 会报“系统找不到指定的文件”。
 在管理员 PowerShell 中执行，按提示粘贴刚复制的单行公钥：
 ```powershell
 $authorizedKeys = "$env:ProgramData\ssh\administrators_authorized_keys"
 New-Item -ItemType Directory -Force -Path (Split-Path $authorizedKeys)
 if (-not (Test-Path $authorizedKeys)) {
  New-Item -ItemType File -Path $authorizedKeys
 }
 $publicKey = Read-Host '粘贴 Mac 的单行 SSH 公钥'
 if (-not (Get-Content $authorizedKeys | Where-Object { $_ -eq $publicKey })) {
  Add-Content -Path $authorizedKeys -Value $publicKey -Encoding ascii
 }
 icacls $authorizedKeys /inheritance:r
 icacls $authorizedKeys /grant "*S-1-5-18:F" "*S-1-5-32-544:F"
 Restart-Service sshd
 ```
 `S-1-5-18` 是 SYSTEM，`S-1-5-32-544` 是本地 Administrators 组。使用 SID 可以避免中文 Windows 的组名本地化问题。
 ### 5.3 Windows 非管理员账户
 非管理员账户使用用户目录下的 `authorized_keys`。在该登录用户自己的 PowerShell 中执行：
 ```powershell
 $sshDirectory = "$env:USERPROFILE\.ssh"
 $authorizedKeys = "$sshDirectory\authorized_keys"
 New-Item -ItemType Directory -Force -Path $sshDirectory
 if (-not (Test-Path $authorizedKeys)) {
  New-Item -ItemType File -Path $authorizedKeys
 }
 $publicKey = Read-Host '粘贴 Mac 的单行 SSH 公钥'
 if (-not (Get-Content $authorizedKeys | Where-Object { $_ -eq $publicKey })) {
  Add-Content -Path $authorizedKeys -Value $publicKey -Encoding ascii
 }
 icacls $authorizedKeys /inheritance:r
 icacls $authorizedKeys /grant "$($env:USERNAME):F"
 Restart-Service sshd
 ```
 管理员和非管理员两种方式只选与实际账户匹配的一种。若修改了 `C:\ProgramData\ssh\sshd_config`，先执行 `sshd -t` 校验，再重启服务。
 ## 6. 配置 Mac SSH 双场景别名
 家庭局域网和外部 Tailscale 连接同一台 Windows、同一个账户和同一个 `sshd`，复用同一把项目专用密钥，不创建第二把 SSH 密钥。编辑 Mac 的 `~/.ssh/config`，加入：
 ```sshconfig
 Host tdx-windows-lan tdx-windows-tailnet
  User <WINDOWS_SSH_USER>
  IdentityFile ~/.ssh/tdx_windows
  IdentitiesOnly yes
  UseKeychain yes
  AddKeysToAgent yes
  ServerAliveInterval 30
  ServerAliveCountMax 3
  ExitOnForwardFailure yes
  LocalForward 127.0.0.1:17710 127.0.0.1:17709
 Host tdx-windows-lan
  HostName <WINDOWS_LAN_HOST>
 Host tdx-windows-tailnet
  HostName <WINDOWS_TAILSCALE_HOST>
 ```
 真实局域网地址、Tailscale 地址和用户名只保存在本机 SSH 配置，不写入仓库。开发代理需要核对当前配置时使用：
 ```bash
 ssh -G tdx-windows-lan | awk '/^(hostname|user|identityfile|localforward) / {print}'
 ssh -G tdx-windows-tailnet | awk '/^(hostname|user|identityfile|localforward) / {print}'
 ```
 然后修正权限：
 ```bash
 chmod 700 ~/.ssh
 chmod 600 ~/.ssh/config ~/.ssh/tdx_windows
 ```
 首次连接先验证密钥登录：
 先在 Windows 管理员 PowerShell 查看主机公钥指纹：
 ```powershell
 ssh-keygen -lf "$env:ProgramData\ssh\ssh_host_ed25519_key.pub"
 ```
 再在 Mac 连接，并确认首次连接提示的 Ed25519 指纹与 Windows 输出一致：
 ```bash
 ssh -v tdx-windows-tailnet
 ```
 预期可以直接登录，或只要求输入私钥口令。若仍要求 Windows 账户密码，重点检查公钥文件位置、ACL、登录账户是否属于 Administrators，以及 SSH 调试输出中实际使用的密钥。
 ## 7. 两种场景的选择、启动和停止
 ### 7.1 选择规则
 | 当前场景 | 使用别名 | 前置条件 |
 |---|---|---|
 | Mac 与 Windows 位于已配置的家庭局域网 | `tdx-windows-lan` | Windows 在线、TDX 已登录、家庭 LAN 的 SSH 22 可达 |
 | Mac 在外部网络，或家庭 LAN SSH 不可达 | `tdx-windows-tailnet` | Mac 与 Windows 的 Tailscale 均在线，Tailnet ping 成功 |
 两种隧道不能同时启动，因为都会独占 Mac `127.0.0.1:17710`。在家庭网络内优先使用 LAN；若 LAN 前置检查失败，不修改 TDX 监听地址，改用 Tailscale。
 ### 7.2 家庭局域网模式
 前置检查：
 ```bash
 ssh -o BatchMode=yes -o ClearAllForwardings=yes -T tdx-windows-lan exit
 ```
 仓库文档不保存真实地址，家庭路径直接通过 SSH 别名验证。首次连接必须核对局域网地址与已信任的 Tailscale 地址返回相同 Windows 主机密钥指纹。
 后台启动和检查：
 ```bash
 ssh -fN -M -S ~/.ssh/tdx-windows-lan-control tdx-windows-lan
 ssh -S ~/.ssh/tdx-windows-lan-control -O check tdx-windows-lan
 ```
 停止：
 ```bash
 ssh -S ~/.ssh/tdx-windows-lan-control -O exit tdx-windows-lan
 ```
 Windows 的家庭 SSH 防火墙规则应使用项目专用名称 `A-Share-TDX-SSH-LAN`，只允许家庭子网访问 TCP 22。系统原有的全范围 OpenSSH 入站规则保持禁用，不为 TDX 开放 `17709`。
 ### 7.3 外部 Tailscale 模式
 前置检查：
 ```bash
 tailscale up
 tailscale ping <WINDOWS_TAILSCALE_HOST>
 ```
 后台启动和检查：
 ```bash
 ssh -fN -M -S ~/.ssh/tdx-windows-tailnet-control tdx-windows-tailnet
 ssh -S ~/.ssh/tdx-windows-tailnet-control -O check tdx-windows-tailnet
 ```
 停止：
 ```bash
 ssh -S ~/.ssh/tdx-windows-tailnet-control -O exit tdx-windows-tailnet
 ```
 如果控制套接字残留但进程已不存在，先确认 `17710` 没有监听，再删除对应场景的单个控制套接字。不要用宽泛的 `pkill ssh`，以免终止其他 SSH 会话。
 ## 8. 验证 TDX 链路
 ### 8.1 Windows 本机验证
 先确认 TDX 客户端已启动、已登录，接口监听 `127.0.0.1:17709`：
 ```powershell
 Get-NetTCPConnection -LocalAddress 127.0.0.1 -LocalPort 17709 -State Listen
 ```
 端口没有监听时，应先恢复 TDX 客户端；SSH 和 Tailscale 无法替代 TDX 服务本身。
 ### 8.2 Mac 端口验证
 隧道启动后在 Mac 执行：
 ```bash
 nc -vz 127.0.0.1 17710
 lsof -nP -iTCP:17710 -sTCP:LISTEN
 ```
 `17710` 的监听进程应为本次 SSH 隧道，不应是其他应用。
 ### 8.3 只读 HTTP 冒烟
 ```bash
 curl --fail-with-body --silent --show-error \
  --connect-timeout 3 \
  --max-time 10 \
  -H 'Content-Type: application/json' \
  -X POST 'http://127.0.0.1:17710/' \
  --data '{"id":1,"method":"get_market_data","params":{"stock_list":["600519.SH"],"count":5,"dividend_type":"none","period":"1d"}}'
 ```
 链路验收条件：HTTP 返回成功，且 TDX 业务响应中的错误码表示成功。只验证少量公开行情，不调用交易、账户、自选、写入或大批量接口。
 ## 9. 外网场景验证
 在真正离开家庭网络前，使用 Mac 手机热点或其他外部网络完成一次演练：
 1. 确认 Windows 保持开机、联网，Tailscale 和 `sshd` 在线，TDX 已启动并登录。
 2. Mac 切换到外部网络后重新连接 Tailscale。
 3. 执行 `tailscale ping <WINDOWS_TAILSCALE_HOST>`。
 4. 执行 `ssh -N tdx-windows-tailnet` 并保持终端运行。
 5. 依次执行 `nc` 和只读 `curl` 冒烟。
 6. 停止隧道，确认 `127.0.0.1:17710` 不再监听。
 如果外网演练失败，开发和自动化测试可显式切换到离线样本，并明确标记数据来源。不要临时开放公网 SSH、RDP 或 TDX 端口。
 ## 10. Windows 无人值守准备
 当前链路是开发辅助，不承诺生产级 7x24 可用性。为了减少外出后无法联调的概率，可在 Windows 上做以下准备：
 - 将虚拟机配置为宿主机启动后自动启动，并确认异常关机后的恢复策略。
 - 保持 Tailscale 与 `sshd` 服务自动启动，重启后通过另一台 Tailnet 设备验证在线状态。
 - 接通电源时禁用自动睡眠：
 ```powershell
 powercfg /change standby-timeout-ac 0
 ```
 - 明确 TDX 是否需要交互式桌面登录、验证码或人工确认。需要人工登录时，不得把它描述为无人值守服务。
 - 安排 Windows 更新和虚拟机重启窗口；更新后重新验证 Tailscale、SSH、TDX 监听和只读请求。
 - 不为自动启动把 Windows 密码、TDX 凭据或 SSH 私钥写入仓库和普通脚本。
 ## 11. 收紧访问范围
 链路验证通过后，在 Tailscale 管理后台将访问规则限制为指定开发身份或 Mac 到 Windows SSH 端口。具体策略应以当前 Tailnet 的身份和标签设计为准，不在仓库保存真实账户和地址。
 还可在 Windows 中新增一条仅允许 Mac Tailscale IP 访问 SSH 的规则。先确认 Tailscale 网卡名称，再创建规则：
 ```powershell
 Get-NetAdapter | Where-Object InterfaceDescription -Match 'Tailscale'
 New-NetFirewallRule `
  -DisplayName 'OpenSSH Server - Tailscale Mac Only' `
  -Direction Inbound `
  -Action Allow `
  -Protocol TCP `
  -LocalPort 22 `
  -RemoteAddress '<MAC_TAILSCALE_IP>' `
  -InterfaceAlias 'Tailscale'
 ```
 新规则必须在外网场景实测通过后，才能禁用范围更宽的旧 SSH 规则。若实际网卡别名不是 `Tailscale`，使用 `Get-NetAdapter` 显示的名称，不凭猜测修改。
 ## 12. 故障排查
 ### Tailscale ping 不通
 - 检查两端是否登录同一个 Tailnet、节点是否过期、Windows 是否睡眠或断网。
 - 检查 Tailnet ACL 或设备审批状态。
 - 不要先排查 TDX；此时底层私网尚未连通。
 ### SSH 连接超时或拒绝
 - Windows 执行 `Get-Service sshd` 和 `Get-NetTCPConnection -LocalPort 22 -State Listen`。
 - 检查 Windows 防火墙和 Tailscale 访问规则。
 - Mac 执行 `ssh -vvv tdx-windows-tailnet`，确认目标是 Tailscale 地址而非家庭公网地址。
 ### SSH 仍要求 Windows 密码
 - 确认 `IdentityFile` 指向 `~/.ssh/tdx_windows`，并检查 `ssh -vvv` 是否提供了该密钥。
 - 管理员账户确认文件是 `C:\ProgramData\ssh\administrators_authorized_keys`；非管理员账户确认文件是用户目录下的 `.ssh\authorized_keys`。
 - 确认公钥为完整单行文本，文件已先创建，ACL 没有继承无关权限。
 - 执行 `sshd -t` 检查配置，再执行 `Restart-Service sshd`。
 ### Mac 的 `17710` 无法监听
 - 查看 SSH 前台错误；`ExitOnForwardFailure yes` 会在端口冲突或转发失败时直接退出。
 - 执行 `lsof -nP -iTCP:17710 -sTCP:LISTEN` 查找占用者。
 - 不要把本地端口改成 `0.0.0.0`；需要换端口时同步修改本机开发配置，并保持回环绑定。
 ### 端口可连但 HTTP 失败
 - 在 Windows 本机确认 TDX `127.0.0.1:17709` 正在监听。
 - 确认 TDX 客户端已登录且当前版本仍支持目标方法。
 - 使用最小只读请求检查 HTTP 状态、TDX 错误码和响应时间，不把协议错误误判为网络错误。
 ### 外出后 Windows 不在线
 - 无法远程唤醒或恢复交互式 TDX 登录时，显式切回离线样本继续开发，并保持非实时标记。
 - 不通过新增公网暴露、共享密码或关闭防火墙绕过问题。
 - 待公网部署需求明确后，另立功能实现生产级采集器、心跳、补传和远程运维。
 ## 13. 日常操作速查
 ### 13.1 在家开发
 ```bash
 ssh -o BatchMode=yes -o ClearAllForwardings=yes -T tdx-windows-lan exit
 ssh -fN -M -S ~/.ssh/tdx-windows-lan-control tdx-windows-lan
 ssh -S ~/.ssh/tdx-windows-lan-control -O check tdx-windows-lan
 nc -vz 127.0.0.1 17710
 ```
 结束家庭局域网联调：
 ```bash
 ssh -S ~/.ssh/tdx-windows-lan-control -O exit tdx-windows-lan
 lsof -nP -iTCP:17710 -sTCP:LISTEN
 ```
 ### 13.2 在外开发
 ```bash
 tailscale up
 tailscale ping <WINDOWS_TAILSCALE_HOST>
 ssh -fN -M -S ~/.ssh/tdx-windows-tailnet-control tdx-windows-tailnet
 ssh -S ~/.ssh/tdx-windows-tailnet-control -O check tdx-windows-tailnet
 nc -vz 127.0.0.1 17710
 ```
 结束外部联调：
 ```bash
 ssh -S ~/.ssh/tdx-windows-tailnet-control -O exit tdx-windows-tailnet
 lsof -nP -iTCP:17710 -sTCP:LISTEN
 ```
 最后一条命令无输出表示本地转发已经停止。切换场景时必须先停止当前隧道，再启动另一场景；不得通过更换 TDX Bridge 地址绕过端口冲突。
 ## 14. 后续 Provider 接入约束
 - 平台配置只能引用 Mac 回环地址 `127.0.0.1:17710`，不得保存家庭网络或 Tailscale 地址。
 - TDX 是正式行情来源；离线样本只作为显式开发和测试回退，必须展示来源与陈旧状态，生产环境禁止启用。
 - Provider 必须限制请求超时、响应体大小、股票数量和并发，并输出来源、采集时间、交易日期、协议版本、追踪 ID 和陈旧状态。
 - TDX 原始字段仅在 Adapter 内转换，上层市场概览、规则分析和 AI 分析只依赖版本化内部契约。
 - 隧道中断必须返回明确的不可用或陈旧状态，不能把离线样本伪装成实时行情。
 - Windows 采集器、公网接收 API、多目标推送、补传队列和无人值守运维继续延期，实施时单独立项并重新进行安全、性能和合规评估。
@@ -1,37 +1,54 @@
 # Ubuntu 源码生产部署
-正式支持 Ubuntu 22.04 LTS 与 Ubuntu 24.04 LTS 的 x86_64。服务器管理员预先提供 Node.js 22 LTS、pnpm 10、Nginx，以及 MySQL 5.7、Redis、RocketMQ 5.x 或相应外部服务；项目不负责安装或升级这些软件，也不修改系统软件源。
+这是项目唯一生产部署方式，支持 Ubuntu 22.04 LTS 与 Ubuntu 24.04 LTS x86_64。服务器管理员预先提供 Node.js 22.x、pnpm 10.25.0、Nginx，以及外部 MySQL 5.7.x、Redis、RocketMQ 5.x；项目不负责安装、升级、启动、停止、删除或修改这些系统软件与服务。
-## 前置验证
+## 构建发布目录
 在固定提交的干净工作区执行：
 ```bash
 uname -m
 node --version
 pnpm --version
-nginx -v
+pnpm install --frozen-lockfile
 pnpm verify:release
 ```
-架构必须为 `x86_64`，Node.js 必须为 22 LTS，pnpm 必须为 10.x。不满足要求时终止部署。
+架构必须为 `x86_64`，Node.js 必须为 22.x，pnpm 必须为 10.25.0。发布门禁会完成测试、Web/Server 构建、双视口浏览器检查，并核对 Web、API、Scheduler、Worker 产物与 systemd/Nginx 模板。
-## 目录与配置
+每次发布使用 `/opt/a-share-analysis/releases/<版本或提交>/` 新目录。完整传输并验证目录后，再把 `/opt/a-share-analysis/current` 原子切换到目标目录；禁止在 `current` 中原地覆盖文件，也禁止只发布部分进程产物。
- 发布目录：`/opt/a-share-analysis/releases/<版本或提交>/`。
+## 配置与 systemd
 - 当前版本：`/opt/a-share-analysis/current` 符号链接。
 - 生产配置：`/etc/a-share-analysis/api.env`、`scheduler.env`、`worker.env`、`web.env`。
 - 运行用户：非登录系统用户 `a-share`。
-真实配置从仓库生产模板生成，但不得放入发布目录。API、Scheduler、Worker 的 systemd 单元分别通过 `EnvironmentFile=` 读取自己的配置；包含秘密的文件建议为 `root:a-share 0640`。
+生产配置放在 `/etc/a-share-analysis/api.env`、`scheduler.env`、`worker.env`，建议权限 `root:a-share 0640`；Web 的 `VITE_` 公开变量在构建前注入。三个 systemd 单元通过各自的 `EnvironmentFile=` 只读取本进程需要的键，运行用户为非登录系统用户 `a-share`。
-## 构建与启动边界
+```bash
 sudo install -m 0644 deploy/systemd/a-share-api.service.example /etc/systemd/system/a-share-api.service
 sudo install -m 0644 deploy/systemd/a-share-scheduler.service.example /etc/systemd/system/a-share-scheduler.service
 sudo install -m 0644 deploy/systemd/a-share-worker.service.example /etc/systemd/system/a-share-worker.service
 sudo install -m 0644 deploy/nginx/a-share-analysis.conf.example /etc/nginx/conf.d/a-share-analysis.conf
 sudo systemd-analyze verify /etc/systemd/system/a-share-api.service
 sudo systemd-analyze verify /etc/systemd/system/a-share-scheduler.service
 sudo systemd-analyze verify /etc/systemd/system/a-share-worker.service
 sudo nginx -t
 sudo systemctl daemon-reload
 sudo systemctl restart a-share-api.service
 sudo systemctl restart a-share-scheduler.service
 sudo systemctl restart a-share-worker.service
 sudo systemctl status a-share-api.service a-share-scheduler.service a-share-worker.service
 sudo journalctl -u a-share-api.service -u a-share-scheduler.service -u a-share-worker.service --since '5 minutes ago'
 curl --fail http://127.0.0.1:3000/api/v1/health
 curl --fail http://127.0.0.1/
 ```
-使用 `pnpm install --frozen-lockfile` 安装锁定依赖，在新发布目录构建 Web 和 Server。Web 静态文件由 Nginx 托管，API、Scheduler、Worker 运行编译后的 JavaScript。禁止 Vite 开发服务器、watch、调试端口和生产运行 TypeScript。
+当前工程尚无业务表迁移；后续新增迁移后必须在切换 `current` 前单独执行并记录结果。生产环境禁止 `synchronize: true`，开发流程也禁止用生产数据库做 Schema 基线或连接测试。
-当前应用尚未脚手架化，仓库中的 systemd 与 Nginx 文件是路径和权限契约示例，不能冒充已经验证的线上启动文件。后续应用功能必须补充实际构建、启动和健康检查验证。
+## AKTools 生产边界
-## 升级、检查与回退
+AKTools 不随本项目发布，也不由 systemd 单元管理。生产 API 默认关闭 `AKTOOLS_ENABLED`；只有在 AKTools 以受控内网服务部署、完成访问控制、授权和稳定性评估后，才可在 API 的生产环境文件中启用。生产配置不得把 AKTools 地址暴露给浏览器，且必须同步修改服务端白名单和健康检查方案；未完成这些前置条件时保持短线模块 `unavailable`。
-在新的不可变发布目录完成安装、构建和配置校验后，原子切换 `current`，依次重启 API、Scheduler、Worker 并检查 `systemctl status`、`journalctl` 和 HTTP 健康端点。失败时切回上一完整目录并重启服务；生产配置不随版本切换覆盖。
+## 检查与回退
-项目部署流程禁止连接或读取生产数据库做开发验证。数据库备份属于独立运维职责，应用回退不得删除或覆盖数据。
+使用 `systemctl status`、`journalctl -u`、HTTP 健康端点和 Nginx 同源访问结果确认发布。任一验证失败时，把 `/opt/a-share-analysis/current` 原子切回上一完整发布目录，重启三个 systemd 服务并重复健康检查。
-RocketMQ 由运维独立维护 NameServer、Broker 和需要时的 Proxy。应用发布只读取受控的 RocketMQ Endpoint、Topic 前缀与 Group 配置，不负责创建或升级集群，也不得把 Broker 数据目录放进应用发布目录。
+`/etc/a-share-analysis/*.env` 和外部 Redis、MySQL、RocketMQ 数据不随应用目录切换而覆盖或删除。RocketMQ 的 NameServer、Broker、Proxy 与 CommitLog 由运维独立维护。
@@ -0,0 +1,39 @@
 # AKTools 超短行情补充数据源设计
 ## 方案
 AKTools 保持为独立的内网 HTTP 服务，Nest 在市场概览模块内增加 AKTools Adapter。Adapter 负责请求、超时、响应大小和错误边界；Mapper 负责把 AKTools 中文字段转换成稳定领域 DTO；Service 并行调用三个接口并生成规则结论。
 ```text
 Vue → Nest Controller → ShortTerm Service → AKTools Client → 127.0.0.1:8080 → AKShare
                                    └→ TDX 既有市场概览链路保持独立
 ```
 ## 接口
 ```text
 GET /api/v1/market-overview/short-term/emotion
 GET /api/v1/market-overview/short-term/conclusion
 ```
 两个接口共享一次请求内的 `snapshotId`，但不要求跨请求持久化。`emotion` 返回结构化指标，`conclusion` 返回规则结论和证据引用。
 ## 安全策略与评估
 - `AKTOOLS_BASE_URL` 只能是配置值，禁止来自请求参数；启动时仅允许回环地址或明确内网白名单。
 - 客户端只使用 GET 和固定接口名，不把任意函数名暴露成代理能力。
 - 超时、响应体大小和 JSON 结构均在 Adapter 层限制；异常只返回脱敏 warning。
 - AKTools 不直接对外开放；若未来扩展到多机内网，必须增加访问控制和反向代理认证。
 - 不保存 AKShare 原始载荷、不记录真实内网地址、不提交凭据。
 ## 性能目标与评估
 三个上游请求使用 `Promise.allSettled` 并行执行，单请求超时 10 秒，短线接口 P95 目标小于 12 秒。由于 V1 不持久化、不缓存，性能风险主要是 AKShare 上游限流和网络延迟；通过超时、部分结果和独立降级控制影响面。
 ## 错误处理与回退
 AKTools 完全不可用时短线响应为 `unavailable`，TDX 响应不受影响。单个接口失败时返回 `partial` 并保留其他有效模块。回退只关闭 AKTools 功能开关和相关路由，不删除 TDX 代码。
 ## 架构同步
 需要同步 OpenAPI DTO、Web API 类型、开发/生产环境模板、API 健康检查说明、测试和功能档案；不修改消息、数据库、Redis、Scheduler、Worker。
@@ -0,0 +1,33 @@
 # AKTools 超短行情补充数据源开发总结
 - 功能编号：FEAT-DS-001
 - 状态：in_review
 - 发布状态：unreleased
 ## 原始开发需求
 在内网环境使用已经运行的 AKTools，补充 TDX 不提供的超短行情数据。
 ## 需求与范围变化
 V1 采用 AKTools 外部服务直连，不新增 Python 服务和 Docker；暂不接入全市场现货接口，因为该接口本地验证返回 HTTP 500。
 ## 实际完成需求
 已完成 AKTools 配置校验、固定接口 Client、中文字段 Mapper、短线情绪与规则结论 DTO/Service/Controller、OpenAPI 生成契约、Vue Axios API、Composable 状态、短线情绪面板和开发/生产环境模板。页面通过独立状态展示正常、部分、延迟、不可用和空数据，不阻塞 TDX 模块。
 ## 修复缺陷
 修复了短线情绪面板缺失导致的前端测试导入失败，并补齐页面未消费短线结论响应的问题；同时修复页面接线遗漏造成的 `shortTermConclusion` 未定义告警。补充修复 MySQL 健康检查因 `mysql2` 的 `timezone` 选项不会设置服务端会话时区而误判不可用的问题：健康检查现在在同一连接上显式执行 `SET SESSION time_zone = '+08:00'`，完成元数据校验后始终释放连接。未发现 TDX 回归。
 ## 未完成与延期项
 炸板率严格口径、资金净流入、盘中新闻、历史快照和生产授权评估不属于 V1。
 ## 关键提交
 关键提交：`6e8a051 feat(FEAT-DS-001): 接入AKTools超短行情补充数据源`、`61283c5 docs(FEAT-DS-001): 完成AKTools治理追溯`、`1398804 style(FEAT-DS-001): 统一超短行情代码格式`、`358004f docs(FEAT-DS-001): 更新最终GitNexus基线`、`9ff6646 fix(FEAT-DS-001): 修正MySQL健康检查会话时区`，均已推送 `origin/main`。
 ## 验证证据
 Schema 基线与校验通过（`v0.0.10 captured_empty`）；开发前 GitNexus 风险 LOW，页面改动前对 `useMarketOverview` 影响分析为 LOW；后端 15 个测试文件 80 个测试通过，前端 8 个测试文件 23 个测试通过，Web typecheck 通过，`pnpm verify` 全量门禁通过且 Playwright 4 个测试通过。健康接口真实验证返回 HTTP 200，MySQL 为 5.7.42 / `a_share_analysis_dev` / `+08:00`。安全边界包括回环地址白名单、固定接口、超时、响应体上限、JSON 校验和错误脱敏；三个上游请求并行，单请求超时 10 秒，MySQL 健康查询使用连接级 finally 释放，当前性能证据为本机定向测试，不代表生产容量。
@@ -0,0 +1,24 @@
 # GitNexus 开发后基线
 - 功能编号：FEAT-DS-001
 - 状态：已刷新
 - 索引提交：`9ff6646`
 ## GitNexus 状态
 ```text
 Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
 Indexed: 2026-08-24 22:43:05 GMT+8
 Indexed commit: 9ff6646
 Current commit: 9ff6646
 Status: up-to-date
 统计：3,445 nodes / 4,913 edges / 72 clusters / 104 flows
 ```
 ## 开发后影响
 新增 AKTools Adapter、短线 Service/Controller、OpenAPI、Web API、Composable 和页面组件形成独立短线执行流；既有 TDX 概览执行流未被改写。`loadApiConfig` 上游影响为 LOW，直接消费者仅配置测试；`useMarketOverview` 页面影响为 LOW。数据库、Redis、RocketMQ、Scheduler 和 Worker 没有新增业务执行流。本轮 MySQL 健康检查修复的暂存区检测识别 `UseFactory → MysqlHealthClient` 与 `OnModuleDestroy → End` 两条连接生命周期流，工具风险 MEDIUM；逐项复核后确认仅是连接池获取/释放行为变化。
 ## 变更检测
 提交 `9ff6646` 后已重新索引，状态为 up-to-date；`gitnexus_detect_changes({ scope: "all" })` 仅识别 GitNexus 生成的 `AGENTS.md` 统计行，风险 LOW，无业务执行流影响。健康检查代码及本功能档案已包含在 `9ff6646`，远程 `origin/main` 已同步。
@@ -0,0 +1,26 @@
 # GitNexus 开发前基线
 - 功能编号：FEAT-DS-001
 - 记录时间：2026年8月24日 GMT+8 20:38:07
 - 分支：main
 - 基线提交：0d0d1eea4530
 ## 工作区
 ```text
 ?? "SRMS3.6.0\345\270\270\350\247\201\351\227\256\351\242\230\346\265\213\350\257\204\351\242\230.2csv"
 ```
 ## GitNexus 状态
 ```text
 Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
 Indexed: 8/24/2026, 8:38:06 PM
 Indexed commit: 0d0d1ee
 Current commit: 0d0d1ee
 Status: ✅ up-to-date
 ```
 ## 后续人工分析
 在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。
@@ -0,0 +1,3 @@
 # GitNexus 前后对比
 开发前基线已记录在 `before.md`。开发后 GitNexus 重新索引确认新增 AKTools Adapter、短线 Service、Controller、Web API、配置、页面和文档均落在计划范围；现有 TDX 市场概览执行流未被改写。`useMarketOverview` 的直接消费者为页面和测试，影响风险 LOW；未发现数据库、Redis、RocketMQ、Scheduler 或 Worker 新执行流。本轮健康检查修复前后对比增加连接级会话设置和 finally 释放，暂存区工具风险 MEDIUM 仅来自连接生命周期执行流，未形成新的跨模块业务依赖。
@@ -0,0 +1,11 @@
 # GitNexus 变更检测
 - 功能编号：FEAT-DS-001
 - 开发前：已完成 `MarketOverviewService` 和 `useMarketOverview` 影响分析，均为 LOW。
 - 提交前：`gitnexus_detect_changes({ scope: "staged" })` 识别新增 AKTools、短线接口、前端状态、配置和文档；风险被工具标记为 CRITICAL，复核确认原因为新增 API 启动注册和配置加载执行流，不是跨到数据库、消息或生产模块。
 - 首次提交后：`gitnexus_detect_changes({ scope: "all" })` 返回无变更，索引与提交 `6e8a051` 一致；格式化提交 `1398804` 前的 staged 检测仅触及同一短线执行流，已由全量测试复验。
 - 当前：修复提交 `9ff6646` 已推送；重新索引后 GitNexus 与提交一致，当前全量检测仅识别自动更新的 `AGENTS.md` 统计行（LOW、无业务执行流）。
 - 本轮健康检查修复暂存区检测：6 个文件、28 个符号、2 条执行流，工具风险为 MEDIUM；实际代码影响集中在 `createMysqlHealthClient`、`MysqlHealthClient` 及 `OnModuleDestroy → End` 连接生命周期，文档章节被工具按标题识别为符号。直接 upstream impact 均为 LOW，未发现业务模块、Web、消息、数据库 Schema 或数据源执行流影响。
 复核结论：TDX 核心链路保持独立；没有新增数据库、Redis、RocketMQ、Scheduler 或 Worker 业务执行流。工具报告中的 MEDIUM 结果已记录并完成逐项 `context/impact` 复核，原因是连接关闭生命周期被纳入执行流，而非跨模块业务耦合。
@@ -0,0 +1,27 @@
 # GitNexus 开发前影响计划
 - 功能编号：FEAT-DS-001
 - 总体风险：LOW
 ## 直接与间接影响
 GitNexus query 以“市场概览 超短行情总结 指数 板块 宽度 资金趋势”为目标执行，未发现现有超短执行流；结果主要定位到市场概览文档、测试和 `MarketOverviewService`。
 `MarketOverviewService` context：直接消费者为市场概览 Controller、Module、OpenAPI 导出和测试；现有方法为指数、摘要、宽度、板块和成交额趋势，不包含 AKTools 数据。
 `MarketOverviewService` upstream impact：影响 5 个关联对象，直接关联 3 个，风险 LOW，受影响执行流 0，受影响模块 0。结论是新增 AKTools 适配器和独立短线接口，不改写现有 TDX 方法，避免扩大现有概览方法的调用面。
 ## 跨模块同步修改
 | 范围 | 判断 | 处置 |
 |---|---|---|
 | HTTP/OpenAPI | 需要同步 | 新增短线情绪和短线结论 DTO、Controller 路由并重新生成契约。 |
 | Web API | 需要同步 | 新增 `web/src/api/market-overview/index.ts` 的业务请求和短线页面状态。 |
 | 消息契约 | 不修改 | V1 为按需读取，不发布行情事件。 |
 | 数据库 | 不修改 | 不持久化 AKTools 响应，不读取生产库。 |
 | Redis | 不修改 | 暂不缓存，避免在数据口径未稳定时引入一致性问题。 |
 | API 进程 | 需要同步 | Nest API 增加固定内网 AKTools 客户端和超时降级。 |
 | Scheduler/Worker | 不修改 | V1 无采集任务、重试队列或历史快照任务。 |
 | 配置部署 | 需要同步 | 增加可选 `AKTOOLS_ENABLED`、`AKTOOLS_BASE_URL`、`AKTOOLS_TIMEOUT_MS` 模板和文档。 |
 | 测试 | 需要同步 | 增加客户端、映射、Service、OpenAPI、Web 状态和 E2E 覆盖。 |
 | 文档 | 需要同步 | 更新架构、开发环境、功能档案和 AKTools 内网运行说明。 |
@@ -0,0 +1,22 @@
 # AKTools 超短行情补充数据源实施计划
 ## 任务清单
 1. [x] 完成功能档案、配置契约和 GitNexus 影响记录。
 2. [x] 为 AKTools 客户端、字段类型和映射器编写失败测试。
 3. [x] 实现固定接口、超时、响应校验和中文字段映射。
 4. [x] 实现短线情绪 Service、规则结论、DTO 和 Controller。
 5. [x] 更新 OpenAPI 生成契约、前端 API、页面模块和异常状态。
 6. [x] 补充开发/生产模板及内网 AKTools 运维说明。
 7. [ ] 执行完整 `pnpm verify`、治理完成门禁和远程推送（收尾阶段）。
 ## 文件边界
 - 新增 `server/apps/api/src/market-overview/aktools/` 客户端、类型和映射。
 - 新增短线业务 DTO、Service 和 Controller；不改动既有 TDX Mapper。
 - 修改 `web/src/api/market-overview/index.ts`，页面只消费公开 DTO。
 - 修改环境模板、架构文档、开发文档和 OpenAPI 生成产物。
 ## 实施顺序
 先测试字段校验和映射，再实现客户端；先实现后端契约，再实现前端状态；每个阶段执行对应定向测试，最后执行完整门禁。
@@ -0,0 +1,8 @@
 featureId: FEAT-DS-001
 slug: aktools-supplement
 name: AKTools 超短行情补充数据源
 status: in_review
 release: unreleased
 source: aktools
 scope: internal_lan_only
 createdAt: 2026-08-24
@@ -0,0 +1,69 @@
 # AKTools 超短行情补充数据源 PRD
 - 功能编号：FEAT-DS-001
 - PRD 版本：0.1
 - 状态：design_approved
 - 日期：2026-08-24
 ## 背景与问题
 TDX 已提供指数、市场宽度、板块和成交额，但不能覆盖涨停池、炸板池、昨日涨停表现等超短情绪指标。AKTools 已在本机内网环境运行，并验证了相关 HTTP 接口。
 ## 目标用户与场景
 个人用户在盘中或收盘后查看超短情绪，不进行交易下单。V1 仅支持本机或受控内网访问，AKTools 只作为 Nest API 的内部补充数据源。
 ## 产品目标
 - 在市场概览中提供结构化超短情绪数据。
 - 显示涨停数量、最高连板、连板梯队、炸板数量和昨日涨停表现。
 - 所有结论都能追溯到 AKShare 数据字段、交易日期和数据状态。
 - AKTools 不可用时不影响 TDX 核心市场概览。
 ## 非目标
 - 不实现交易建议、买卖信号、目标价或仓位建议。
 - 不直接暴露 AKTools 的通用接口给前端或公网。
 - 不在 V1 计算未经确认口径的炸板率、资金净流入或新闻情绪评分。
 - 不启用 MySQL、Redis、RocketMQ 或历史快照存储。
 ## 功能需求
 | 编号 | 优先级 | 需求 | 可观察结果 |
 |---|---|---|---|
 | FR-001 | P0 | 读取涨停池 | 展示涨停数量、最高连板和连板梯队。 |
 | FR-002 | P0 | 读取炸板池 | 展示炸板数量和可用的炸板次数摘要。 |
 | FR-003 | P0 | 读取昨日涨停池 | 展示今日平均涨跌幅及上涨、下跌、持平数量。 |
 | FR-004 | P0 | 生成规则结论 | 结论必须携带依据、交易日期和状态。 |
 | FR-005 | P0 | 独立降级 | AKTools 超时或异常时，短线模块显示 unavailable，TDX 模块继续可用。 |
 | FR-006 | P1 | 内网边界 | AKTools 地址只来自服务端固定配置，默认回环地址。 |
 ## 数据与口径
 V1 调用 `stock_zt_pool_em`、`stock_zt_pool_zbgc_em`、`stock_zt_pool_previous_em`。AKTools 返回的中文字段只在 Adapter 内解析，领域 DTO 使用稳定英文属性。
 - 涨停数量：涨停池有效记录数。
 - 最高连板：有效 `连板数` 的最大值。
 - 连板梯队：按 `连板数` 分组计数。
 - 炸板数量：炸板池有效记录数；不直接推导炸板率。
 - 昨日涨停表现：昨日涨停池有效 `涨跌幅` 的算术平均，以及正、负、零数量。
 - 封板资金：仅作为原始统计摘要展示，单位转换为亿元并标明来源，不解释为主力净流入。
 ## 状态与异常
 响应统一使用 `fresh`、`delayed`、`partial`、`unavailable`。交易日不等于上海当前日期时标记 `delayed`；字段缺失或部分接口失败时标记 `partial`；连接失败、超时、HTTP 5xx 或响应格式错误时标记 `unavailable`。
 ## 安全与合规
 AKTools 仅绑定 `127.0.0.1:8080`。Nest 不接受客户端传入上游 URL，不记录原始载荷，不向前端透传上游异常。AKShare 及其上游数据的授权和再分发边界在正式对外部署前另行评估。
 ## 性能目标
 三个 AKTools 请求并行执行，单请求超时目标 10 秒，短线接口正常响应目标 P95 小于 12 秒。V1 不引入缓存，避免陈旧数据和缓存击穿复杂度。
 ## 验收标准
 - 有效交易日数据可生成短线情绪 DTO 和规则结论。
 - 任一 AKTools 接口失败不会导致 TDX 市场概览接口失败。
 - OpenAPI、前端 API 和页面状态与后端 DTO 一致。
 - API 地址固定为本机内网配置，仓库不包含真实凭据和机器地址。
@@ -0,0 +1,13 @@
 # 测试结果
 ## 当前状态
 已完成代码验证：后端 Vitest 15 个测试文件、80 个测试通过，包含 MySQL 健康检查连接设置/释放回归、AKTools Client/Mapper、短线 Service、HTTP E2E 和 OpenAPI；前端 Vitest 8 个测试文件、23 个测试通过，包含短线面板、Composable 和 API；Web typecheck 通过。`pnpm verify` 全量门禁通过，Playwright 4 个测试通过。AKTools 本机涨停池、炸板池和昨日涨停池冒烟均返回 HTTP 200；`stock_zh_a_spot_em` 返回 HTTP 500，未纳入 V1。
 ## 安全验证
 配置测试验证仅允许 `127.0.0.1:8080`，Client 测试覆盖禁用、超时、HTTP/协议错误、响应大小上限和脱敏异常；未向 Web 暴露 AKTools 地址或原始字段。
 ## 性能验证
 Service 测试验证三个请求使用 `Promise.allSettled` 并行、单个失败返回 `partial`、全部失败返回 `unavailable`；MySQL 健康检查验证会话时区设置、元数据查询和异常路径释放连接。单请求超时配置为 10 秒；当前仅有本机测试证据，不将其视为生产容量结论。
@@ -0,0 +1,13 @@
 # 视觉验证
 ## 当前状态
 已在 `http://127.0.0.1:8888/` 完成桌面默认视口和 `390×844` 窄屏检查。短线面板在 DOM 中可见，TDX 不可用时仍展示明确的 AKShare 空状态；窄屏 `document.documentElement.scrollWidth` 与 `window.innerWidth` 均为 390，无横向溢出。组件测试覆盖有效数据和 unavailable 警告，部分/延迟文案沿用既有面板样式并通过类型检查。
 ## 安全验证
 视觉验证不得展示凭据、真实内网地址或 AKTools 原始错误载荷。
 ## 性能验证
 首次可见状态先展示 TDX 和 AKShare 各自占位，不互相阻塞；短线 API 失败只改变短线模块状态。视觉检查未展示凭据、真实内网地址或原始异常载荷。
@@ -0,0 +1,5 @@
 # 发布说明
 ## 未发布
 FEAT-DS-001 当前为未发布功能。已接入 AKTools 内网补充数据源，提供超短情绪指标和规则结论；不改变 TDX 核心市场概览。生产默认关闭，待授权、访问控制和稳定性评估后再决定启用。
@@ -0,0 +1,24 @@
 # AKTools 超短行情补充数据源需求
 ## 原始需求
 使用 AKTools 提供的 AKShare HTTP 接口，补充 TDX 没有的超短行情数据；当前只考虑内网环境。
 ## 实际范围
 - Nest 服务端调用本机 AKTools，不让 Vue 直连 AKTools。
 - 首批接入涨停池、炸板池、昨日涨停池。
 - 新增短线情绪和短线结论业务接口。
 - 保留 TDX 核心市场概览链路不变。
 ## 数据口径
 所有数量只统计通过字段校验的记录；缺失数值不折算为零。结论只能使用本功能列出的确定性规则，不能把 AKShare 原始字段解释为交易建议。
 ## 依赖边界
 AKTools 作为项目外部服务运行，默认地址为 `http://127.0.0.1:8080`。V1 不新增 Python 代码、不新增 Docker、不启用数据库、缓存和消息队列。
 ## 范围变化
 已确认不接入 `stock_zh_a_spot_em` 作为核心接口，因为当前本地验证返回 HTTP 500；该接口不影响本功能其余目标接口。
@@ -0,0 +1,37 @@
 # 代码 Review
 ## 审查范围
 设计阶段审查目标为 AKTools Client、Mapper、短线 Service、DTO、Controller、Web API、配置和测试。
 ## PRD 与设计符合性
 实现后检查只接入三个已验证接口，保持 TDX 独立，且不把原始 AKTools 字段直接暴露给前端。
 ## 发现
 已完成实现 Review：未发现阻断项。Client 只允许三个固定 AKTools 路径，Service 用 `Promise.allSettled` 做模块级降级，DTO 不透传中文原始字段；Web 只通过 Axios API 文件访问 Nest。发现页面接线遗漏 `shortTermConclusion` 未解构，已在测试失败后修复。后续健康检查复核发现 `mysql2` 的 `timezone` 选项不会改变服务端会话变量，已在同一连接上显式设置 `+08:00` 并用 `finally` 释放；成功顺序和查询失败释放均有回归测试。
 ## 测试缺口
 上游 5xx、超时、部分接口失败、字段非法、响应大小、不可用状态、MySQL 会话时区/释放和窄屏布局已有定向覆盖；交易日期延迟口径和 AKShare 字段漂移仍需后续真实交易日联调。
 ## 安全与残余风险
 固定地址白名单、日期参数校验、固定接口、超时、响应体上限、JSON 结构校验和错误脱敏均已检查；未发现凭据或原始载荷进入前端。残余风险为 AKShare 授权、上游限流/字段变更和生产多机访问控制，故生产默认关闭。
 ## 性能与资源影响
 三个请求并行，10 秒超时，2 MiB 响应上限；MySQL 健康检查复用单个连接完成会话设置和元数据查询，并在成功或异常路径释放连接；不引入缓存和消息链路，测试证据仅证明行为和边界，不构成生产容量证明。
 ## GitNexus 与同步修改
 实现后核对变更检测结果只覆盖计划中的短线链路和文档。
 ## 修复与复审
 发现问题后记录修复提交和复审证据；本轮健康检查修复通过 80 项后端测试、全量门禁和真实 `/api/v1/health` HTTP 200 验证。
 ## 最终结论
 最终结论：passed
@@ -0,0 +1,21 @@
 # 开发规范符合性 Review
 ## 检查结果
 设计阶段已检查功能档案、Schema/GitNexus 前置流程、TDX 与 AKTools 边界及源码部署约束；代码实现后进行逐项复核。
 ## 不符合项与处置
 逐项检查通过：功能档案、中文注释、OpenAPI 生成契约、Axios API 边界、固定数据源 Adapter、模块级降级、环境模板和未提交凭据约束均符合规范。实现期间发现的页面接线遗漏已修复并由前端全量测试复验；MySQL 健康检查的服务端时区误判已通过显式会话设置、连接释放 finally 和回归测试修复。
 ## 安全、性能与架构检查
 确认 AKTools 仅作为外部内网 Adapter，未新增 Docker、Python 服务、生产数据库连接、Redis/RocketMQ 消息链路或前端直连；超时、响应上限、并行请求和降级均有实现与测试证据。生产启用的授权、访问控制和容量评估仍是明确前置条件。
 ## GitNexus 与开发总结检查
 开发前后 GitNexus 报告、影响计划、变更检测、开发总结、测试结果、视觉 QA、Review 和回退说明均已补齐；本轮修复的 GitNexus 影响分析为 LOW，仅影响健康客户端和 API 工厂直接调用；`governance:finish` 及最终提交前再次执行变更检测。
 ## 最终结论
 最终结论：passed
@@ -0,0 +1,16 @@
 # 回退说明
 ## 触发条件
 出现 TDX 核心行情回归、AKTools 请求阻塞 API、上游原始字段泄漏、OpenAPI 契约不一致或短线模块遮挡核心概览时回退。
 ## 回退步骤
 1. 关闭 `AKTOOLS_ENABLED` 或回退到上一个完整发布目录。
 2. 重启 API 并确认 TDX 概览接口、Web 健康检查和构建产物正常。
 3. 保留 AKTools 外部服务，不删除其运行环境和数据缓存。
 4. 记录回退原因、提交 SHA、验证结果和后续修复计划。
 ## 数据与外部服务
 本功能不写 MySQL、Redis 或 RocketMQ，不需要数据回退；AKTools 是独立外部服务，应用回退不负责停止或删除它。
@@ -0,0 +1,30 @@
 # AKTools 超短行情补充数据源测试计划
 ## 功能验证
 - 用固定响应夹具验证涨停数量、最高连板和梯队分布。
 - 验证炸板池和昨日涨停池字段缺失、非法数字、空数组的处理。
 - 验证三个请求并行且单个失败返回 partial。
 - 验证全部失败返回 unavailable，TDX 既有接口仍能独立响应。
 - 验证 OpenAPI DTO、Web API 类型和页面状态一致。
 ## 安全验证
 - 验证客户端拒绝请求参数注入的上游 URL。
 - 验证配置不允许生产地址和公网任意地址。
 - 验证超时、过大响应、非 JSON 响应和上游错误均脱敏。
 - 验证前端构建产物不包含 AKTools 凭据或内部地址。
 ## 性能验证
 - 验证三个请求使用并行调度而非串行等待。
 - 使用受控延迟夹具验证单请求超时和整体响应上限。
 - 记录定向请求耗时，不把本地单次结果当作生产容量证明。
 ## 视觉验证
 验证桌面和窄屏下短线情绪模块的加载、部分、不可用、空数据状态，确保警告和交易日期不遮挡指标。
 ## 残余风险
 AKShare 上游限流、字段变更、数据授权和长期稳定性需要在后续联调与生产评估中持续验证。
@@ -0,0 +1,55 @@
 # 数据源接入架构与 TDX PoC 规划
 ## 方案结论
 当前采用“平台先行、采集器后置”。Mac 本地开发以固定样本回放为默认 Provider；需要验证真实字段时，通过 Tailscale + SSH 隧道访问家中 Windows 的 TDX `127.0.0.1:17709`。不在当前阶段实现 Windows 常驻采集程序、GUI 或公网推送。
 ```text
 固定样本 / Mac TDX 隧道
        ↓
 DataProvider 端口
        ↓
 标准化市场事件 → 市场概览业务
 未来公网模式：采集器 → 多目标隔离推送 → 平台接收 API
 ```
 ## 方案比较
 - 本地样本回放（当前采用）：不引入 Windows/公网依赖，测试稳定可重复，适合先开发市场概览；缺点是不能代表实时数据质量。
 - Mac 通过 Tailscale SSH 隧道调用 TDX（当前联调）：可以验证真实字段，但依赖家中 Windows 在线和人工维护。
 - Windows 常驻采集器（延期）：未来可选 Node、Python、Go、Rust、Electron、Tauri 或系统服务，必须按部署规模、资源、自动更新和安全能力重新评估。
 ## 当前组件边界
 当前只新增/维护平台侧 Provider 端口和固定样本。样本 Provider 与真实 TDX Provider 使用同一标准化契约，市场概览不感知来源差异。未来采集器应作为独立项目或 workspace，不反向污染 NestJS 业务模块；公网接收 API、目标队列、签名握手和 GUI 另立功能档案。
 ## Provider 与事件模型
 Provider 生成不可变标准化事件，包含 `eventId`、`source`、`capturedAt`、`tradeDate`、`schemaVersion`、`traceId` 和数据新鲜度。TDX 原始字段只能存在于 Adapter 内，规则分析、AI 分析、API 和页面只依赖内部模型。
 ## 安全策略与评估
 - Mac 本地样本和 TDX 隧道均不接触生产配置、生产数据库或公网接收 API。
 - 真实 TDX 只读调用使用 SSH 密钥隧道，`17709`、SSH 和 RDP 不做公网端口映射。
 - 样本删除凭据、家庭地址和无关原始字段；日志只保存统一错误分类和性能摘要。
 - 未来采集器的密钥存储、目标认证、IPC 和自动更新不在当前方案中预设，必须重新安全评估。
 - 数据再分发许可属于外部合规风险。PoC 只用于个人开发验证，不宣称获得商业展示或再分发授权。
 ## 性能目标与评估
 - 固定样本回放必须确定性、可重复且不访问网络；Provider 标准化耗时纳入单元测试与基准记录。
 - 真实 TDX 请求目标超时 5 秒并记录响应耗时和字段完整性。
 - 公网上传并发、队列容量、心跳周期和 GUI 资源目标延期到采集器立项，不在当前阶段作容量承诺。
 ## 失败恢复
 TDX 请求失败返回统一错误分类和陈旧状态；本地平台可切回固定样本继续开发，不能把样本伪装为实时行情。上传重试、补传、熔断和备用免费源切换属于后续公网功能。
 ## 测试边界
 单元测试使用固定 TDX 响应验证 Provider、标准化和错误映射；通过 Tailscale SSH 隧道做真实只读冒烟。Electron/Tauri 安装、托盘、开机启动、操作系统密钥存储、目标队列和公网接收测试延期，不能在当前阶段宣称通过。
 ## 依赖与退出方案
 当前不新增 Electron、Python、Go、Rust 或其他采集器运行时依赖。未来采集器实现前重新比较语言、部署形态、许可证、资源、自动更新和安全边界；只要遵循 Provider/上传契约，采集器可替换而不改市场概览。
@@ -0,0 +1,26 @@
 # GitNexus 开发前基线
 - 功能编号：FEAT-DS-001
 - 记录时间：2026年8月14日 GMT+8 02:38:03
 - 分支：main
 - 基线提交：a398bc418d39
 ## 工作区
 ```text
 ?? docs/features/FEAT-DS-001-tdx-ingestion-poc/
 ```
 ## GitNexus 状态
 ```text
 Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
 Indexed: 8/14/2026, 2:38:02 AM
 Indexed commit: a398bc4
 Current commit: a398bc4
 Status: ✅ up-to-date
 ```
 ## 后续人工分析
 在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。
@@ -0,0 +1,24 @@
 # GitNexus 开发前影响计划
 - 功能编号：FEAT-DS-001
 - 总体风险：LOW（当前仅规划 Provider 边界和本地联调，不新增桌面应用或公网入口）
 ## 直接与间接影响
 - `gitnexus query --repo a-share-analysis "market data ingestion TDX adapter scheduler worker"` 未找到现成行情 Provider，相关现有流程集中在 Scheduler/Worker 启动和运行时配置。
 - `gitnexus query --repo a-share-analysis "configuration HTTP API health Redis MySQL RocketMQ"` 表明 API 当前只有健康检查流程，新增接收模块不会修改 `HealthService`。
 - 对名称 `health` 的 upstream impact 命中 Web API 目录且风险为 LOW、无上游消费者；由于名称存在歧义，结论仅作为辅助证据，不解释为对 API 全局无影响。
 - 当前不新增 `desktop/tdx-agent` 或 `MarketIngestModule`，不会修改现有 Web、API、Scheduler 或 Worker 符号。
 - 直接消费者是后续市场概览 Service；未来采集器、RocketMQ Worker、Redis 快照和 MySQL 历史属于延期功能，必须重新执行影响分析。
 ## 跨模块同步修改
 - HTTP/OpenAPI：当前不新增公网握手或上报 DTO；Provider 内部契约不得泄漏到 Web。
 - Web API：主平台 Vue 不修改；不存在 Electron renderer。
 - 消息契约：本 PoC 不启用 RocketMQ，也不预留伪接收实现。
 - 数据库与 Redis：不新增 Schema，不读取生产库；PoC 接收仅做受控确认。
 - API：后续 Provider 如进入 API，再对 `ApiModule.register`、OpenAPI 和运行时配置执行影响分析。
 - Scheduler/Worker：本 PoC 不修改；后续正式排队功能另立功能档案和影响分析。
 - 配置部署：当前不新增 Windows 或公网配置，不改变主平台源码部署政策。
 - 测试：使用固定样本和 TDX 隧道冒烟；采集器打包和 Windows 无人值守测试延期。
 - 文档：记录延期原因、Provider 边界、安全、性能和未来重新立项条件。
@@ -0,0 +1,17 @@
 # 数据源接入架构与 TDX PoC 规划
 ## 当前计划（不实现采集器）
 1. 建立与运行时无关的 `DataProvider`、市场事件和数据新鲜度契约。
 2. 用固定样本 Provider 支撑市场概览的规则、AI、混合和对照分析开发。
 3. 按 [Tailscale + SSH 隧道访问 TDX 开发手册](../../deployment/tailscale-tdx-development.md) 执行真实 TDX 只读请求，保存脱敏字段报告。
 4. 对 TDX 字段缺失、协议错误和陈旧数据做 Provider 层降级，不连接生产数据。
 5. 暂不新增 Windows 应用、Electron/Tauri、目标推送、补传队列、公网接收 API、RocketMQ 事件或数据库表。
 6. 待公网部署需求确定后，另立采集器功能档案，重新评估 Node、Python、Go、Rust 或系统服务方案。
 ## 后置功能必须覆盖
 - 单次采集、多目标隔离推送。
 - production/development 独立地址、密钥、队列、状态和启停；两者地址均可修改。
 - production 未配置或停止为正常状态；停止时不删除队列、不转投 development。
 - HTTPS/HMAC、重放防护、握手身份、限流、补传、熔断、心跳、无人值守运行和系统更新。
@@ -0,0 +1,12 @@
 id: FEAT-DS-001
 name: 数据源接入架构与 TDX PoC 规划
 slug: tdx-ingestion-poc
 status: deferred
 owner: project
 created_at: 2026-08-14
 requirements: requirements.md
 prd: prd.md
 design: design.md
 implementation_plan: implementation-plan.md
 traceability_note: 当前只完成数据源边界和本地联调规划；操作步骤见 ../../deployment/tailscale-tdx-development.md；Windows 采集器与公网接入延期到公网部署需求确认后单独立项。
 release: unreleased
@@ -0,0 +1,37 @@
 # TDX 数据接入 PoC PRD
 ## 用户问题
 TDX 客户端运行在家中 Windows 虚拟机，并且接口只监听 Windows 本机 `127.0.0.1:17709`。公网平台和人在外面的开发设备都不能直接访问该端口，需要验证一套不暴露 TDX、可 7×24 小时运行的数据上报链路。
 ## 目标
 在不提前引入公网部署和 Windows 常驻程序的前提下，先确定 TDX 数据源边界、标准化 Provider 契约和 Mac 本地联调方式。Windows 采集器、托盘 GUI、目标推送和公网接收入口延期，避免在生产部署形态尚未确定时锁定技术栈。
 ## 范围
 - Mac 本地开发使用固定样本回放作为默认数据源，并保留通过 Tailscale SSH 隧道调用家中 Windows TDX 的人工联调方式。
 - 只定义与运行时无关的 `DataProvider`、标准化事件和数据新鲜度字段，不实现 Windows 常驻采集程序。
 - 记录未来公网模式的单次采集、多目标隔离推送、地址可变和目标启停原则，但不在本功能实现。
 - 只读验证指数、单股 K 线、快照、分时和板块接口中实际可用的字段。
 - 通过 Tailscale + SSH 隧道从外部 Mac 远程验证家中 Windows TDX；验证结果只用于 Provider 契约，不写入生产链路。
 ## 非目标
 - 不在本功能中开发 Windows 采集应用、Electron/Tauri GUI、开发/生产接收 API、目标队列或公网推送。
 - 不在本功能中开发市场概览页面、AI 分析、正式 Worker 消费或生产接入。
 - 不开放 TDX `17709`、SSH 或 RDP 到公网。
 - 不写入自选、交易、账户或 TDX 状态。
 - 不把通达信数据授权问题解释为已解决；商业展示和再分发授权仍需单独确认。
 ## 成功指标
 - 固定样本能够覆盖 Provider 的 K 线、快照、分时、板块和错误映射测试。
 - 通过 SSH 隧道完成至少一次真实 TDX 只读请求，并保存脱敏字段报告。
 - Provider 契约不依赖 Node、Electron、Python 或具体传输方式；未来采集器可独立替换。
 ## 风险
 - TDX 客户端协议和返回字段可能变化；代理必须保留原始字段版本和来源标识。
 - 未来公网部署会增加采集节点、推送认证和再分发风险；延期期间不把这些风险误标为已解决。
 - 行情数据的展示、再分发和商业使用权利不由代码许可证自动授予。
@@ -0,0 +1,28 @@
 # 数据源接入架构与 TDX PoC 工程需求
 ## 当前阶段 Provider 边界
 - Provider 暴露与采集器语言和传输方式无关的只读接口，统一返回 `source`、`capturedAt`、`tradeDate`、`schemaVersion`、`traceId` 和数据新鲜度。
 - 默认开发 Provider 使用仓库内固定样本，不连接生产数据源；真实 TDX Provider 只通过显式本地配置和 Tailscale SSH 隧道联调。
 - TDX Provider 限制回环地址、请求超时、响应体大小、股票列表和并发；不得把家庭地址或凭据写入代码。
 - Provider 原始响应映射为版本化内部载荷，上层分析不得依赖 TDX 原始字段名称。
 ## 当前运行与环境
 - 平台仅在 Mac 本地源码运行，不要求安装 Windows 采集程序。
 - 固定样本支持离线、确定性和可重复测试；真实 TDX 联调依赖家中 Windows 在线，但不能成为日常测试门禁。
 - 当前不新增 Electron、Tauri、Python 服务、Go/Rust 程序、公网接收 API、文件补传队列或目标密钥。
 - SSH 私钥、TDX 地址、家庭网络信息和开发数据库凭据不得进入仓库、日志、样本或前端构建物。
 ## 延期的公网采集原则
 - 采集器语言、GUI 壳和打包方式不预设为 Node/Electron，待公网部署需求确认后比较 Node、Python、Go、Rust 和系统服务方案。
 - 未来采集器只采集一次，production/development 使用独立地址、节点 ID、密钥、队列、上传器、心跳和启停状态。
 - production 与 development 地址均可修改且独立测试；任一目标故障或重配不得影响另一目标。
 - production 未配置或停止属于正常状态；停止时不删除已有队列、不转投 development。
 - 公网模式必须重新设计 HTTPS/HMAC、重放防护、身份握手、限流、补传、熔断、无人值守运行和操作系统密钥存储。
 ## 可观测性
 - Provider 结果标记来源、采集时间、数据时间、陈旧状态和统一错误分类。
 - 真实联调报告必须脱敏，不保存完整家庭地址、SSH 信息、供应商凭据或未筛选的原始载荷。
@@ -0,0 +1,23 @@
 # 数据源接入架构与 TDX PoC 测试计划
 ## 当前阶段功能验证
 - 固定样本验证 K 线、快照、分时和板块 Provider 载荷映射。
 - 通过 Tailscale SSH 隧道验证真实 TDX 只读请求，并保存脱敏字段报告。
 - 验证 Provider 在 TDX 错误、超时、空结果和陈旧数据下返回统一错误分类。
 - 验证市场概览只依赖内部模型，不直接读取 TDX 原始字段。
 ## 安全验证
 - SSH 私钥、TDX 地址、家庭网络信息和开发数据库凭据不进入仓库、样本、日志或前端构建物。
 - TDX 只通过 SSH 隧道访问，`17709` 不开放公网。
 - 固定样本不包含供应商凭据和不必要的完整原始载荷。
 ## 性能验证
 - 固定样本下测量 Provider 标准化耗时，确保回放不依赖外部网络。
 - 真实 TDX 请求记录响应耗时和字段完整性；不对未来采集器的上传、队列和 GUI 资源作结论。
 ## 不适用项与边界
 不做 Electron/Tauri 窗口、托盘、安装包、生产数据库迁移、RocketMQ 收发和公网接收验证，原因是采集器与公网部署已延期。市场概览页面另按业务功能执行视觉验证。
@@ -1,5 +1,33 @@
 # 设计
-首屏顺序为：市场结论、驱动与风险、核心指数、市场宽度与量能、板块概览、情绪与资金摘要。分析偏好保存在浏览器本地，页面只显示轻量的当前状态入口。
+首屏顺序为：市场结论、驱动与风险、核心指数、市场宽度与量能、板块概览、资金趋势。分析偏好保存在浏览器本地，页面显示轻量的当前状态入口。Vue 不直连 TDX，由 Nest API 按模块拆分接口并隔离失败。
 ## 数据可用性
 - `summary` 和 `indices`：使用 TDX K 线真实响应，展示来源、快照时间和指数涨跌。
 - `breadth`：使用 TDX 指数快照的 `UpHome`、`DownHome` 汇总上证、深证和北证市场宽度；未返回的 `unchanged` 明确为 `null`，不得用总数推算。
 - `sectors`：使用 TDX 系统分类中的一级行业（`get_stock_list(market=16)`）和批量日行情，按涨跌幅排序后展示重点强弱板块。
 - `funds`：模块名称和口径为“成交额趋势”，使用核心交易所指数日行情的 `Amount` 汇总当前与前一交易日成交额；这不是主力净流入。
 - 交易日对齐：交易日期必须是有效 `YYYYMMDD` 公历日期；指数和一级行业只有在前一根日期有效且严格早于当前日期时才计算涨跌，随后只保留最新交易日截面。成交额还要求日期与金额数组等长且前一交易日早于当前交易日，再按最新有效日期对汇总，避免畸形日期、数组错位或旧市场覆盖新数据。市场宽度额外并行读取一个核心指数日线作为日期参考。
 - 新鲜度：日行情交易日期与 `Asia/Shanghai` 当前日历日期不同即标记 `delayed`；宽度沿用参考指数日期。首版不引入交易日历依赖，休市日保守标延迟并展示实际日期。
 - 主力净流入和盘中新闻不在本次 TDX 首屏主链路中，后续通过独立补充数据源适配器接入，并在响应中标记来源与数据质量。
 - 页面不把缺失或权限不足的指标降级为模拟值；单个来源失败只影响对应模块。
 ## 运行边界
 本功能只读调用 TDX。MySQL、Redis、RocketMQ 仍为已规划基础设施，但当前没有业务状态、缓存或异步任务需要它们，因此本切片不启用。
 ## 安全策略与评估
 - TDX 地址在配置层固定为 `http://127.0.0.1:17710`，API 是唯一访问边界，Vue 不直连行情服务。
 - 请求只允许固定方法和公开行情参数；客户端限制超时与 1 MiB 响应，异常脱敏，不记录原始载荷、凭据或网络地址。
 - 本功能不提供交易写入、账户操作、用户输入拼接查询或 AI 密钥下发；MySQL/Redis/RocketMQ 未启用，不读取生产数据库。
 - 已通过客户端、服务、HTTP/OpenAPI、边界和 E2E 测试；生产授权、长期断线恢复和公网安全仍需后续评估。
 ## 性能目标与评估
 - 五个模块并行请求，单个 TDX 请求受配置超时保护，模块失败不阻断其他模块。
 - 客户端限制响应大小，避免异常行情载荷占用过多内存；本切片不增加数据库、缓存或消息队列负载。
 - 已完成构建、浏览器桌面/390px 移动端验证；未进行 7×24 采集、峰值并发和长期网络抖动压测。
 ETF监控、两融数据、大盘云图和实时消息仍是独立一级菜单，不属于短线和中长线切换。
@@ -0,0 +1,57 @@
 # FEAT-MO-001 开发总结
 ## 原始开发需求
 实现市场概览首屏：结论优先展示市场状态、驱动与风险，并支持综合、短线、中长线视角和规则、AI、混合、对照分析选择；用户可从指数和板块入口进入后续详细分析。
 ## 需求与范围变化
 - 数据源从早期“确定性模拟快照”调整为 TDX 只读直连，Nest API 访问本机 `127.0.0.1:17710`，Vue 不直接访问 TDX。
 - API 按摘要、指数、市场宽度、板块和资金拆分，避免把整个首屏塞入单个接口。
 - 当前 TDX 桥接已确认 `get_market_snapshot`、`get_stock_list` 和批量 `get_market_data` 可用；市场宽度、一级行业板块和成交额趋势改为真实 TDX 映射。主力净流入字段虽存在但当前实测为零值，盘中新闻无官方行情接口，因此两者延期到补充源功能。
 - MySQL、Redis、RocketMQ 和 AI 仍不进入本切片运行链路；它们保留为后续基础设施边界。
 ## 实际完成需求
 - 新增 TDX 配置校验、超时/响应大小限制、错误脱敏的 Node 客户端。
 - 新增市场概览 DTO、服务、控制器、OpenAPI 契约和前端 Axios API 文件。
 - 完成结论、驱动与风险、核心指数、市场宽度、板块、资金趋势模块，以及加载/错误/不可用状态。
 - 完成分析视角和分析引擎切换，本地保存用户偏好。
 - 真实 TDX 指数和摘要已通过本机隧道冒烟；未用指数或离线样本伪造缺失指标。
 - 真实 TDX 市场宽度、一级行业和成交额趋势已通过本机桥接冒烟；资金模块明确使用成交额口径，不宣称主力净流入。
 ## 修复缺陷
 - 修正 PRD 和实施计划中仍描述“模拟数据”的旧表述。
 - 避免单个 TDX 模块失败导致整页失败，改为五个模块并行、独立状态。
 - 对未注册桥接方法返回结构化原因，避免前端显示“实时”或空白数据。
 - 修复 Vue TypeScript 单文件组件未被 ESLint 正确解析的问题，并为 E2E 测试进程补齐必需的本机 TDX 配置边界。
 - 隔离应用外壳单测中的真实 Axios 请求，消除 JSDOM 网络错误噪声，保持页面测试只验证外壳职责。
 - 根据代码 Review 修复畸形 TDX 字段被折算为零、缺市场成交额误报三市、交易日错位跨日求和、空行业目录误报 `fresh`、前端隐藏 `partial/delayed` 警告和零变化使用上涨色等缺陷，并补齐对应回归测试。
 - 根据二次 Review 继续修复涨跌家数接受非整数、成交额受市场定义顺序影响、指数/板块跨交易日混排和后端从不生成 `delayed` 的边界；宽度增加核心指数日期参考，不新增基础设施或第三方依赖。
 - 根据第三轮独立 Review 修复 8 位畸形日期被误认为有效公历日期、成交额接受倒序日期对与日期/金额数组错位，以及服务测试依赖运行当天的问题。
 - 根据第四轮独立 Review 修复指数/板块未校验前一根 K 线日期的问题；非法、重复或倒序的前一日期不再生成涨跌信号。
 - 修复首屏更新时间直接展示 UTC ISO 字符串的问题：保留 API 的标准 UTC `asOf` 契约，Web 统一按 `Asia/Shanghai` 展示完整日期时间和时分秒。
 ## 未完成与延期项
 - 主力净流入的权限/数据质量验证、盘中新闻补充源、真实图表和口径仍延期。
 - “查看依据”抽屉、指数/板块详情页、AI 请求和用户体系另立功能。
 - 本地验证不代表生产 7×24 采集稳定性、商业授权或公网部署安全性。
 ## 关键提交
 - `9a965fa`、`d283ee3`、`6eb34b5`、`c2fa929`、`15a2500`、`27bc3c1`、`8261948`、`ff8ada8`、`49f6be9`、`7e4dcd9`、`ae2a7e0`、`c2fdfa6`、`b1310fb fix(FEAT-MO-001): 修正概览时间时区显示`
 ## 验证证据
 - GitNexus 已完成提交前重新索引；上一修复提交的最终 staged 检测映射 66 个符号、21 条概览执行流并标记 critical。风险来自本功能修改核心概览服务、TDX 映射和前端数据面板，已由定向单测、HTTP/OpenAPI、前端状态回归、构建、浏览器视觉验证和 E2E 覆盖；未发现额外业务模块调用方。第三轮修复前又用 MCP 对 `toTradeDate` 和 `mapTurnoverTrend` 执行符号级影响分析，直接调用方仅在市场概览映射与测试范围。
 - API 冒烟：`/breadth`、`/sectors`、`/funds` 均返回 `source=tdx,status=fresh`；完整结果和耗时见 `tdx-smoke-report.md`。
 - 家庭 LAN 隧道二次复验：五个市场概览接口均为 `fresh`，指数 3 项、板块 8 项、成交额覆盖 3 个市场且交易日期完整；只保存脱敏统计。
 - 日期对齐与延迟状态修复后，后端 60/60、完整全仓门禁和家庭 LAN 五接口当日 `fresh` 复验通过；第三轮日期真实性与测试时钟修复后，后端增加至 63/63；第四轮相邻日期修复后，后端增加至 67/67。`c2fdfa6` 推送前后均执行完整 `pnpm verify`，契约、Lint、格式、类型、全部测试、构建和 E2E 均通过。
 - 前端单测、typecheck、build、后端 TDX/映射/服务/HTTP/OpenAPI 测试通过。
 - `pnpm verify:e2e`：4/4 通过（桌面和移动端各覆盖页面与健康契约）。
 - 浏览器桌面与 390px 移动视口验证无横向溢出，视角与引擎切换可用。
 - 五轮独立 Review 均已归档：前四轮发现的数据完整性、状态、日期真实性/顺序、测试时钟和前一根日期校验问题均已关闭；第五轮最终结论为 `Ready to merge: Yes`，无 Critical、Important 或 Minor 问题。
 - 开发 Schema 按用户确认跳过，沿用 `v0.0.10 captured_empty` 追溯边界，不读取生产库。
 - 本轮前端日期工具测试覆盖 UTC 到上海时区转换、无效值占位和两个概览组件接线；未修改后端、OpenAPI、数据库或消息契约。
@@ -0,0 +1,26 @@
 # GitNexus 开发后基线
 ## GitNexus 状态
 ```text
 Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis/.worktrees/feat-mo-001-tdx-overview
 Indexed: 8/18/2026, 9:13:11 PM
 Indexed commit: c2fdfa6
 Current commit: c2fdfa6
 Status: ✅ up-to-date
 ```
 ## Git 已跟踪变更摘要
 ```text
 AGENTS.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
 ```
 ## Git 工作区摘要
 ```text
 M AGENTS.md
 ```
 业务代码基线 `c2fdfa6` 已提交并推送；上述唯一工作区差异是 GitNexus 自动维护的入口说明，未纳入功能提交。
@@ -0,0 +1,31 @@
 # GitNexus 开发前基线
 - 功能编号：FEAT-MO-001
 - 记录时间：2026年08月18日 00:26:46 CST
 - 分支：main
 - 基线提交：`c0a6f5560584`
 - 创建方式：用户授权跳过 `v0.0.9` Schema 备份后，按 `governance:start` 输出结构手工留痕
 ## 工作区
 ```text
 (干净)
 ```
 ## GitNexus 状态
 ```text
 Repository: /Users/citrons/Documents/Codex/2026-08-12/wo-x/a-share-analysis
 Indexed: 8/17/2026, 6:03:13 PM
 Indexed commit: c0a6f55
 Current commit: c0a6f55
 Status: up-to-date
 ```
 ## Schema 门禁例外
 失败证据、用户决定、禁止伪造边界和残余风险见 `../schema-baseline-waiver.md`。本记录不表示 `governance:start` 自动门禁通过。
 ## 后续人工分析
 首页设计确认后，在修改任何函数、类或方法前继续执行 GitNexus query、context 和 upstream impact，并将直接、间接、跨模块消费者及高风险处置补充到 `impact-plan.md`。
@@ -0,0 +1,16 @@
 # GitNexus 前后对比
 ## 开发前
 - 基线：`gitnexus/before.md`、`gitnexus/implementation-baseline.md`。
 - 目标是把模拟首屏改为 TDX 只读概览，并拆分五个 HTTP 模块接口。
 ## 开发后
 - CLI 已完成最终重新索引，保留 85 条执行流并识别本功能影响路径。
 - 宽范围修复曾识别 21 条概览执行流并标记 critical；最终相邻日期修复收敛为 3 条候选映射执行流并标记 medium。核心路径均有单测、HTTP/OpenAPI、前端状态、构建、视觉和 E2E 验证。
 - 未新增消息、数据库、Redis、Scheduler、Worker 或部署运行时依赖。
 ## 差异结论
 直接影响集中于 TDX API、市场概览服务、前端 API/页面和测试夹具；生产数据边界、基础设施暂不启用边界和回退路径保持不变。
@@ -0,0 +1,25 @@
 # GitNexus 开发后变更检测
 ## 检测命令
 ```text
 npx gitnexus analyze
 npx gitnexus detect-changes --repo "$PWD" --scope staged
 ```
 ## 结果
 - 索引：已完成最终增量更新。
 - 暂存文件：11 个文件、24 个符号；GitNexus 自动改写的 `AGENTS.md` 已明确排除。
 - 影响执行流：3 条，CLI 风险：medium。
 - 主要执行流：`Candidates → ToNumber`、`Candidates → ToTradeDate` 与 `Candidates → MapDirection`；本轮未修改服务状态策略或跨模块契约。
 ## 处置
 本轮 medium 来自指数/板块相邻日期比较的局部映射变更，不是未知跨业务扩散。已用 TDX 映射/服务测试、类型检查和 `git diff --check` 验证；前一提交已覆盖 HTTP/OpenAPI、前端状态、构建、浏览器视觉和 4/4 E2E，未发现用户、消息、数据库、Redis、RocketMQ、Scheduler、Worker、认证或部署调用方。当前环境已使用 GitNexus MCP 与同版本 CLI 交叉确认，没有将工具限制误判为低风险。
 ## 第六轮显示修复
 - GitNexus 对 `useMarketOverview` upstream impact 为 LOW，直接消费者为 `MarketOverviewPage.vue` 和状态测试；Vue 单文件组件文件级符号由查询结果确认，未发现后端或跨模块调用方。
 - 本轮仅变更 Web 日期格式化工具及两个概览组件显示，不修改 API、OpenAPI、TDX、数据库、Redis、RocketMQ、Scheduler 或 Worker。
 - 修复提交 `b1310fb` 后重新索引统计为 3,457 nodes / 4,935 edges / 73 clusters / 104 flows，状态 up-to-date；全量检测仅识别 GitNexus 自动更新的 `AGENTS.md` 统计行，风险 LOW、0 条受影响执行流。
@@ -0,0 +1,36 @@
 # GitNexus 开发前影响计划
 - 功能编号：FEAT-MO-001
 - 基线提交：`c0a6f5560584`
 - 当前阶段：TDX 直连首页实施，已完成开发前门禁和最小只读协议验证
 - 当前总体风险：LOW（新增边界尚未落地）；TDX 客户端、API、OpenAPI 和 Web 首屏实现后按符号补充
 ## 直接与间接影响
 ### TDX 双路径开发连接
 - 正式行情来源确定为 TDX；家庭局域网和外部 Tailscale 只改变 Mac 到同一 Windows `sshd` 的网络路径。
 - TDX Bridge 的稳定入口固定为 Mac 回环地址 `127.0.0.1:17710`，市场概览、规则分析、AI 分析和未来 HTTP 契约不得依赖家庭地址、Tailscale 地址或 TDX 原始字段。
 - 当前仓库尚无 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/market-overview/index.ts`，页面只能经 Axios 封装和 ViewModel 消费数据。
 - 消息契约、Redis、MySQL、Scheduler、Worker：本次首屏不启用业务链路，仅保留既有架构边界；正式采集、快照持久化、缓存和异步分发仍按独立功能立项。
 - 配置部署：真实地址、用户名、密钥和控制套接字只保留在开发机，不进入仓库、环境模板或前端构建物。
 - 测试：两种 SSH 路径均需验证到同一 Mac 回环端点；离线样本只作显式开发回退，不得标记为实时 TDX。
 - 文档：同步更新 Tailscale/SSH 开发手册，明确家庭局域网与外部 Tailscale 的选择、启动、停止、切换和验证方法。
 ## 安全、性能与回退
 - Windows 的 TDX 继续只监听 `127.0.0.1:17709`，禁止改为局域网或公网监听。
 - 家庭 SSH 入站规则只允许家庭子网访问 TCP 22；系统原有全范围 OpenSSH 规则保持禁用。
 - 两条 SSH 路径复用同一项目专用 Ed25519 密钥；局域网主机密钥必须与已验证的 Tailscale 主机密钥指纹一致。
 - 家庭 LAN 与当前 Tailscale 直连延迟均足以满足开发期分钟级行情；首页不得承诺秒级刷新。
 - 回退时停止对应 SSH 控制连接、删除本机 TDX 别名，并删除 Windows 项目专用防火墙规则；不得删除通用 SSH 密钥、Tailscale 账户或 TDX 数据。
 ## Schema 例外风险
 `v0.0.9` Schema 基线缺失会阻断严格自动治理门禁，风险见 `../schema-baseline-waiver.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`，本功能分支不将其纳入提交。功能代码只在本隔离工作区开发。
@@ -1,8 +1,11 @@
 # 实施计划
-1. 初始化 Vue 3、Vite、TypeScript和 Dart Sass。
+1. ~~初始化 Vue 3、Vite、TypeScript 和 Dart Sass。~~ 已完成。
-2. 建立市场快照类型和确定性模拟数据。
+2. ~~建立 TDX 配置、Node fetch 客户端、DTO、映射和五个模块接口。~~ 已完成。
-3. 实现终端外壳、数据状态和结论区。
+3. ~~实现终端外壳、分模块加载状态和结论区。~~ 已完成。
-4. 实现指数、宽度、量能、板块、情绪与资金模块。
+4. ~~实现指数、宽度、板块和资金模块；不可用指标使用结构化状态。~~ 已完成。
-5. 实现分析偏好菜单和依据抽屉。
+5. ~~实现分析偏好菜单和本地持久化。~~ 已完成；依据抽屉和详情页入口延期至独立功能。
-6. 完成测试、构建、浏览器验证和视觉对比。
+6. ~~完成单元测试、类型检查、构建、接口冒烟、浏览器桌面/移动端视觉验证。~~ 已完成。
 7. ~~补齐 TDX 市场宽度、一级行业板块和成交额趋势映射。~~ 已确认官方接口和本机桥接可用；主力净流入与盘中新闻保留为补充源需求。
 8. 更新 DTO、OpenAPI 类型和前端组件，使真实数据状态、单位和 `unchanged=null` 口径可见。
 9. 完成 TDX 真实响应夹具、错误隔离、类型、构建和浏览器视觉验证；Review 后再收口功能档案。
@@ -1,12 +1,12 @@
 id: FEAT-MO-001
 name: 市场综合概览
 slug: market-overview
-status: approved
+status: in_review
 owner: project
 created_at: 2026-08-12
 requirements: requirements.md
 prd: prd.md
 design: design.md
 implementation_plan: implementation-plan.md
-traceability_note: 开发尚未开始，GitNexus与QA证据将在开发门禁执行时创建
+traceability_note: 已完成 TDX 直连开发、GitNexus 前后分析、接口冒烟、桌面/移动端视觉验证、独立代码 Review 和规范 Review；开发完成门禁已通过，待合并发布
 release: unreleased
@@ -23,7 +23,7 @@
 ## 非目标
 - 不做自选股、持仓、笔记、交易计划、社区、荐股、跟单和公开组合。
- 本切片不接正式行情源、RocketMQ、MySQL、Redis和付费 AI。
+- 本切片直接接入已验证的 TDX 只读桥接层；不接入 RocketMQ、MySQL、Redis 和付费 AI。
 - 本切片不实现用户、邀请、会员、订阅和支付。
 - ETF监控、两融数据、大盘云图和实时消息仍是独立一级模块。
@@ -41,7 +41,7 @@
 | 编号 | 优先级 | 需求 | 可观察结果 |
 |---|---|---|---|
 | FR-001 | P0 | 结论优先展示市场定性 | 首屏顶部出现一句结论、市场状态、量能状态和情绪状态 |
-| FR-002 | P0 | 展示驱动与风险 | 结论下方并列显示至少三条驱动和三条风险证据 |
+| FR-002 | P0 | 展示驱动与风险 | 结论下方并列显示已由 TDX 支持的驱动和风险证据；缺少口径时明确标记 |
 | FR-003 | P0 | 展示数据新鲜度 | 页面显示交易状态、数据更新时间和正常/延迟/不完整状态 |
 | FR-004 | P0 | 提供分析偏好 | 可选择综合/短线/中长线和规则/AI/混合/对照，并在本地保存默认值 |
 | FR-005 | P1 | 展示市场证据模块 | 指数、宽度、量能、板块、情绪和资金摘要可阅读 |
@@ -50,10 +50,16 @@
 ## 数据与口径
-首个切片使用确定性模拟快照。字段仍必须包含交易日期、快照时间、来源状态、完整性和单位，以便以后无结构变更地替换为后端 API。
+首个切片由 Nest API 直接读取 TDX 只读桥接层。指数和摘要使用真实 TDX K 线映射；市场宽度使用三市场指数快照，板块使用一级行业目录与日行情，量能使用三市场指数成交额汇总。主力净流入和盘中新闻不在本切片 TDX 主链路中，必须保持明确的补充源边界，不得用指数或离线样本冒充。所有响应仍包含交易日期、快照时间、来源状态、完整性和单位。
 A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百分比。历史数据和低频资金数据必须显示实际数据日期，旧数据不得标记为实时。
 TDX 交易日期必须通过真实公历日期校验。成交额当前/前一日金额必须与同索引日期对齐，且前一交易日严格早于当前交易日；不满足条件的市场不参与汇总，也不得抢占最新日期截面。
 指数和板块涨跌幅必须同时具备有效且严格递增的相邻日期。前一根日期非法、重复或晚于当前日期时，指数只展示当前价而不生成涨跌信号，板块不进入强弱排序。
 首个切片不引入交易日历依赖：指数、一级行业和成交额的最新交易日期与 `Asia/Shanghai` 当前日历日期不同即标记 `delayed`；市场宽度快照缺少日期字段，使用同批核心指数日线作为日期参考。周末和法定休市日会保守显示延迟并同时展示实际交易日期，后续接入权威交易日历后再细化“最新交易日”语义。
 ## 状态与异常
 - 交易中：显示分钟级更新时间。
@@ -77,7 +83,7 @@ A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百
 - Given 页面加载有效快照，When 用户进入市场概览，Then 结论、驱动、风险和更新时间在首屏可见。
 - Given 用户打开分析状态入口，When 切换周期或引擎，Then 页面状态立即更新且可选择设为默认。
 - Given 数据快照被标记为延迟，When 页面渲染，Then 最近有效值保留并明确显示延迟，不能显示“实时”。
- Given 用户点击查看依据，When 抽屉打开，Then 能看到指标名称、数值、口径和更新时间。
+- Given 用户看到查看依据入口，When 后续依据抽屉功能立项，Then 能看到指标名称、数值、口径和更新时间；本切片只保留入口。
 ## 风险与依赖
@@ -92,3 +98,5 @@ A 股使用红涨绿跌。成交额统一展示为亿元，比例明确使用百
 ## 变更记录
 - 0.1：建立首版 PRD，补充结论优先、分析偏好和异常状态。
 - 0.2：根据 TDX 实连验证修正数据源、可用性边界和未接入基础设施范围。
 - 0.3：核对官方行情接口后确认市场宽度、一级行业板块和成交额趋势可由 TDX 直接提供；主力净流入与盘中新闻保留补充源边界。
@@ -0,0 +1,20 @@
 # FEAT-MO-001 测试结果
 ## 自动化结果
 - 前端 Vitest：9 个文件、28 个测试通过，新增 UTC 到上海时区格式化和概览组件显示回归；修复提交 `b1310fb` 已推送到 Gitea。
 - 后端 Vitest：11 个文件、67 个测试通过；API 启动器 Node 测试 2/2 通过，Schema、治理、边界和部署门禁通过。
 - `pnpm verify:e2e`：桌面/移动端页面和健康契约共 4 个测试通过。
 - `pnpm typecheck`、`pnpm build`、`pnpm format:check`：通过。
 - ESLint：0 error，保留 35 条 Vue 风格 warning，不阻断门禁。
 ## 手工结果
 - `GET /api/v1/market-overview/indices` 和 `summary` 返回真实 TDX `fresh` 快照。
 - TDX 隧道未监听时，五个模块均返回明确不可用状态，未伪造指标；切换到家庭 LAN 隧道后，`summary`、`indices`、`breadth`、`sectors`、`funds` 均返回 `source=tdx,status=fresh`。
 - 家庭 LAN 真实冒烟中，指数返回 3 项、板块返回 8 项、成交额覆盖 3 个市场且交易日期完整；未保存真实价格或成交额数值。
 - 修复日期对齐和延迟状态后再次通过家庭 LAN 真实冒烟，五个接口在当日数据下仍为 `fresh` 且无 warning。
 - 第三轮 Review 修复后，非法月份/日期、倒序日期对和日期/金额数组错位均被映射层排除；服务测试统一冻结时钟，不依赖执行当天。
 - 第四轮 Review 修复后，指数前一根非法、重复或倒序日期不再生成涨跌幅，板块对应记录不进入强弱排序。
 - 桌面默认视口与 390px 移动视口无横向溢出；视角和引擎切换可用。
 - 浏览器实测确认结论区显示 `2026-08-24 22:59:55`、指数卡片显示 `22:59:27`，不再显示 UTC 的 `14:59` 时间；桌面和移动视口均无横向溢出。
@@ -0,0 +1,20 @@
 # FEAT-MO-001 视觉 QA
 ## 验证范围
 - 桌面默认视口：顶部应用识别、结论区、驱动/风险、核心指数和不可用模块均可见。
 - 移动视口：390×844，首屏按单列排列，标题、状态、指数和模块说明不遮挡。
 ## 结果
 - 通过：2026-08-18 使用本地 API/Web 实际页面复验；桌面视口为 `1440×900`，移动视口为 `390×844`。
 - 通过：桌面 `clientWidth=1440, scrollWidth=1440`，移动端 `clientWidth=390, scrollWidth=390`；移动端六个主要区块左右边界均位于 `14px~376px`，未发生页面级或区块级横向溢出。
 - 通过：综合、短线、中长线切换和规则/AI/混合/对照选择有可见状态。
 - 通过：实际切换到“综合”和“混合”后，按钮激活态和下拉选中项同步更新。
 - 通过：家庭 LAN 隧道 `127.0.0.1:17710` 下完成真实 TDX 行情复验；摘要、3 个核心指数、市场宽度、8 个一级行业板块和 3 市成交额均显示 `source=tdx`、`status=fresh`，无模块警告。
 - 通过：桌面与移动端浏览器控制台均无 `warning` 或 `error`；移动端仅有 Vite 开发服务器连接调试信息。
 - 通过：真实行情移动端 `clientWidth=390, scrollWidth=390`，无页面级横向溢出、内部文字截断或控件重叠；长风险说明、指数数值、板块标签和成交额均完整展示。
 ## 残余项
 依据抽屉、指数/板块详情页和真实图表尚未立项，不作为本次首屏视觉验收项。真实 TDX 接口值、交易日期和模块状态的逐项证据见 `tdx-smoke-report.md`；本次视觉复验使用同一家庭 LAN 隧道和真实接口响应，不使用离线样本伪装实时行情。
@@ -0,0 +1,17 @@
 # FEAT-MO-001 发布说明
 ## 本次发布
 - 新增 TDX 直连的市场概览首屏和五个模块 API。
 - 支持综合、短线、中长线视角与规则、AI、混合、对照偏好选择。
 - 市场宽度、一级行业强弱和成交额趋势接入真实 TDX 数据，并对空数据、部分数据、日期不一致和延迟状态显示明确边界。
 - 指数和板块按最新交易日截面对齐，成交额按最新有效交易日期对汇总；后端根据上海当前日历日期实际生成 `delayed`，市场宽度使用同批核心指数日期参考。
 - 拒绝非法公历日期、倒序交易日期以及日期/金额数组错位的 TDX 数据，避免异常市场抢占最新截面或产生时间倒置的成交额趋势。
 - 指数和板块仅使用有效且严格递增的相邻 K 线日期计算涨跌，前一日期非法、重复或倒序时不生成市场强弱信号。
 - 明确显示 TDX 来源、快照时间、交易日期、市场覆盖数和模块级错误。
 ## 明确不包含
 - 不启用 MySQL、Redis、RocketMQ 或 AI 运行链路。
 - 不包含用户体系、详情页、依据抽屉、交易操作和荐股能力。
 - 不包含主力净流入、盘中新闻、真实图表和详情页；这些能力需另立补充数据源和功能需求。
@@ -2,4 +2,12 @@
 首屏为“市场概览”模块中的综合概览，采用结论优先。市场概览内部通过轻量分析状态入口切换综合、短线和中长线视角，并支持规则、AI、混合与对照分析。
-当前切片仅开发 Vue 3 可交互首屏和本地模拟数据，不接用户体系和正式数据链路。
+当前切片开发 Vue 3 可交互首屏，Nest API 通过 TDX 只读桥接层提供真实指数、市场宽度、板块和成交额趋势；主力净流入与盘中新闻不作为本次 TDX 主链路指标，不使用离线样本。不接用户体系，也不启用 MySQL、Redis、RocketMQ 或 AI 运行链路。
 ## 本次实际范围
 - 已完成综合、短线、中长线视角切换，以及规则、AI、混合、对照偏好选择；偏好只保存于浏览器本地。
 - 已完成按摘要、指数、宽度、板块、资金拆分的五个 HTTP 接口和前端 API 封装。
 - 已完成 TDX 请求超时、响应大小限制、错误脱敏和模块级失败隔离。
 - 已确认并接入 TDX 市场宽度、一级行业板块和成交额趋势；资金模块明确不等同于主力净流入，`unchanged` 无可靠总数时返回 `null`。
 - 详情页和“查看依据”抽屉只保留入口，另立需求实现，不在本次发布范围内。
@@ -0,0 +1,97 @@
 # 代码 Review
 ## 首轮独立 Review
 - 对比基线：`8261948`
 - 审查提交：`ff8ada8`
 - 结论：`Ready to merge: No`
 首轮发现及处置：
 1. 畸形 `UpHome/DownHome` 被折算为零并误标 `fresh`：改为有限、非负且成对校验，无效市场整体排除并按有效市场数返回 `fresh/partial/unavailable`。
 2. 成交额缺市场或交易日错位仍误标三市实时数据：只汇总非负金额和一致交易日，公开 `marketCount`、`tradeDate`、`previousTradeDate`，缺市场返回 `partial`。
 3. 空板块目录误标 `fresh`：一级行业为空时直接返回 `unavailable`，且只保留存在相邻两日收盘价和有效涨跌幅的板块。
 4. 前端隐藏 `partial/delayed` 警告：宽度、板块和成交额面板均展示非 `fresh` 状态提示，并展示板块与成交额真实交易日期。
 5. PRD、发布说明和 Review 文档残留旧口径：已同步更正为真实 TDX 宽度、一级行业与成交额趋势口径，主力净流入和新闻仍明确延期。
 6. 异常分支测试不足：新增畸形宽度、部分市场、错位交易日、空行业目录、额外字段隔离、前端状态提示和零变化中性色回归测试。
 次要问题也已同步处理：OpenAPI `required + nullable` 定义、板块 DTO 额外 `price` 字段泄露、成交额零变化上涨色和新增映射中文口径注释。
 ## 范围
 覆盖 TDX 客户端、市场概览后端模块、OpenAPI/前端契约、Axios API 封装、Vue 首屏组件和对应测试。
 ## 检查结果
 - 通过：API 按模块拆分，前端请求集中在 `web/src/api/market-overview/index.ts`，Vue 不直连 TDX。
 - 通过：真实指数和摘要字段经过 DTO/映射；桥接层未提供的方法返回结构化 `unavailable`，没有模拟数据冒充。
 - 通过：模块并行加载且独立处理异常；TDX 请求有固定回环地址、超时、响应大小限制和错误脱敏。
 - 通过：未将密码、令牌、行情原始载荷或生产数据写入代码、文档和日志。
 - 通过：E2E 测试夹具显式声明回环 TDX 配置但不要求 TDX 可达，避免测试环境绕过正式配置校验。
 ## 安全与残余风险
 - TDX 只读边界固定为回环地址，客户端限制超时和响应大小并脱敏异常；未接入交易、AI 密钥、数据库写入或生产数据。
 - 残余风险是 TDX 桥接方法覆盖不全、市场数据授权和生产 7×24 稳定性尚未验证，已在需求和回退说明中标明。
 ## GitNexus 与同步修改
 开发前已保存 GitNexus 影响计划。早期提交曾映射 11 条执行流并标记 high；`49f6be9` 修复提交的 staged 检测映射 20 个文件、67 个符号、16 条执行流并标记 critical。critical 来自市场概览核心服务、TDX 映射和前端数据面板，不是未知跨业务扩散；未发现数据库、Redis、RocketMQ、Scheduler、Worker、认证或部署调用方。当前环境未暴露 GitNexus MCP 变更检测工具，已使用同版本 CLI 和 worktree 绝对路径保留证据。
 ## 性能与资源影响
 - 五个模块并行请求，单请求超时并限制 1 MiB 响应；市场宽度并行增加一次单指数、单日线日期参考请求，不引入 MySQL、Redis、RocketMQ 在线负载。
 - 未进行 7×24、断线重连和生产压测；主力净流入、盘中新闻、权威交易日历及详情页仍待独立功能。
 - ESLint 对 Vue 单文件组件仅保留 35 条既有风格 warning，无 error；格式、类型和构建门禁均通过。
 ## 二次独立 Review
 - 审查范围：`ff8ada8..49f6be9`
 - 结论：`Ready to merge: No`
 - Critical：无。
 - Important：宽度仍接受小数/十六进制等非计数值；成交额以首个市场日期为锚；板块跨交易日混排仍标 `fresh`；后端没有真实 `delayed` 路径。
 - Minor：GitNexus 风险/执行流和 TDX 已接入范围存在旧口径。
 上述问题已按 TDD 增加失败用例后修复：宽度只接受十进制非负安全整数；指数/板块只保留最新交易日；成交额选择最新有效日期对；四个后端日行情路径均具备 `delayed` 判定，宽度使用同批指数日期参考。修复后等待再次独立 Review。
 ## 第三轮独立 Review
 - 审查范围：`49f6be9..7e4dcd9`
 - 结论：`Ready to merge: No`
 - Critical：无。
 - Important：8 位数字日期未验证真实公历语义，成交额未强制前一交易日早于当前日且未验证日期/金额数组对齐；服务测试固定使用 `20260818` 行情却没有统一冻结系统时间，会在自然日期变化后失败。
 - Minor：开发总结未包含 `7e4dcd9`，GitNexus 仍保留上一轮 16 条执行流口径。
 处置：按 TDD 先得到 3 个预期失败，再增加真实公历日期、日期顺序和数组对齐校验；服务测试套件统一冻结上海日期，并由单个延迟用例显式切换。修复后后端 Vitest `63/63`、启动器 `2/2` 和类型检查通过，等待再次独立 Review。
 ## 第四轮独立 Review
 - 审查范围：`49f6be9..ae2a7e0`
 - 结论：`Ready to merge: No`
 - Critical：无。
 - Important：指数和板块只校验当前 K 线日期，前一根日期非法、重复或倒序时仍计算涨跌；最终治理材料仍处于 `pending`，尚未执行 `governance:finish`。
 - Minor：无新增。
 处置：按 TDD 先得到 4 个预期失败，再要求前一日期有效且严格早于当前日期；无可比前收盘时指数保留当前价但不生成涨跌，板块不进入强弱排序。后端 Vitest 增加至 `67/67`。治理状态保持 `pending` 是有意的门禁顺序：需本修复再次独立 Review 通过后，才能合法写入 `passed` 并运行 `governance:finish`。
 ## 第五轮最终独立 Review
 - 审查范围：`ae2a7e0..c2fdfa6`
 - 结论：`Ready to merge: Yes`
 - Critical：无。
 - Important：无；上一轮指数/板块前一根 K 线日期校验问题已关闭。
 - Minor：无。
 - 验证：指数非法、重复、倒序前一日期参数化用例和板块过滤用例齐全；后端 Vitest `67/67`、启动器 `2/2`、服务端类型检查与 `git diff --check` 均通过。安全、性能及 PRD/设计/测试/QA 口径一致。
 最终结论：passed
 ## 第六轮显示修复 Review
 - 审查范围：市场概览前端日期显示工具、结论组件、指数组件及回归测试。
 - 根因：API `asOf` 是带 `Z` 的标准 UTC 时间，前端原样展示并直接截取 UTC 时分秒。
 - 处置：新增 `Asia/Shanghai` 格式化工具；不修改后端时间契约，非法值统一显示占位符。
 - 安全与性能：仅使用原生 `Intl.DateTimeFormat`，无新依赖、无网络请求、无敏感数据处理；格式化开销只发生在两个展示节点。
 - 验证：前端 Vitest 9 个文件/28 个测试、typecheck、全量 `pnpm verify` 和桌面/移动浏览器实测通过。
 - 结论：passed
 最终结论：passed
@@ -0,0 +1,30 @@
 # 开发规范符合性 Review
 ## 安全、性能与架构检查
 - 已建立并更新 PRD、需求、设计、实施计划、测试计划、开发总结和 Review 文档。
 - 已记录安全策略、性能目标、GitNexus 影响、验证证据、范围变化和残余风险。
 - 后端按业务模块组织并使用 DTO/映射；前端请求通过统一 Axios 封装，业务 API 独立存放。
 - 代码注释集中在配置边界、异常恢复和偏好存储等非显然逻辑，没有逐行噪声注释。
 - 未启用 MySQL、Redis、RocketMQ；本切片没有伪造基础设施已接入，也没有触碰生产数据库。
 - Git 提交和推送将在 Review 通过后按中文 Conventional Commit 执行；不修改 Git 全局配置。
 ## GitNexus 与开发总结检查
 - 开发前影响计划、开发后索引、变更检测和风险处置已归档。
 - 开发总结记录原始需求、范围变化、实际完成、修复缺陷、延期项、提交和验证证据。
 - QA、发布说明和回退说明与本功能档案保持同一功能编号。
 ## 首轮问题同步检查
 - 数据完整性、状态语义、OpenAPI nullable、DTO 输出边界和前端降级提示均已补齐回归测试。
 - PRD、发布说明、测试计划和开发总结已同步实际口径，避免实现与文档分叉。
 - 浏览器复验覆盖桌面与 `390×844` 移动视口；当前 TDX 隧道未监听时只确认结构化降级，历史真实行情冒烟证据保持独立。
 - 二次独立 Review 发现的严格整数、日期对齐和真实 `delayed` 语义已按 TDD 修复；后端新增 9 个断言并完成家庭 LAN 当日行情复验。
 - 新鲜度暂按上海当前日历日期保守判断，周末和法定休市日可能显示 `delayed`；该残余边界已同步 PRD、设计和测试计划，不伪装成交易日历已接入。
 - 第三轮 Review 的日期真实性、先后顺序、数组对齐和测试时钟问题已按 TDD 修复；需求、设计、测试计划、测试结果、发布说明和开发总结已同步。
 - 第四轮 Review 的前一根日期校验问题已按 TDD 修复；治理结论继续保持 `pending`，等待本次代码修复再次独立确认。
 - 第五轮最终独立 Review 无 Critical、Important 或 Minor 问题并给出 `Ready to merge: Yes`；中文提交、Gitea 推送、GitNexus、完整门禁和视觉证据均已复核。
 - 第六轮显示修复保持后端 UTC 契约、前端 Axios 边界和业务模块职责不变；新增工具有真实重复场景和独立测试依据，无新增依赖，安全、性能、类型、构建和 E2E 证据齐全。
 最终结论：passed
@@ -0,0 +1,17 @@
 # FEAT-MO-001 回退说明
 ## 触发条件
 - TDX 请求错误导致核心指数无法展示或页面加载阻断。
 - 发现前端横向溢出、来源状态误标为实时，或不可用指标被伪造。
 - 生产部署验证发现配置边界、权限或错误脱敏回归。
 ## 操作
 1. 停止当前 API/Web systemd 服务，保留日志和失败快照摘要，不保存原始行情载荷。
 2. 回退到上一个已推送的 Gitea 提交/标签，重新执行源码构建和 `pnpm verify:source`。
 3. 恢复 TDX 桥接隧道后只做只读接口冒烟；确认通过前不得重新对外开放。
 ## 数据边界
 本功能没有写入 MySQL、Redis 或 RocketMQ，也没有数据库迁移；回退不执行生产数据库操作。开发 Schema 继续遵循仅读取开发库的门禁。
@@ -0,0 +1,23 @@
 # v0.0.9 Schema 基线一次性例外
 - 功能编号：FEAT-MO-001
 - 日期：2026-08-18
 - 适用范围：仅 FEAT-MO-001 开发启动
 ## 事实记录
 按常规流程执行 `npm run schema:baseline` 时，本机因不存在 MySQL 5.7.x 的 `mysql` 与 `mysqldump` 客户端，在执行 `mysql --version` 前以 `spawnSync mysql ENOENT` 失败。失败发生在客户端前置检查阶段，未连接开发数据库，也未生成基线目录或半成品。
 用户确认本次继续跳过数据库备份。该决定只适用于从已发布版本 `v0.0.9` 启动 FEAT-MO-001，不继承 GOV-011 对 `v0.0.8` 的一次性例外，也不建立通用跳过能力。
 ## 处理决定
 - 不伪造 `not_applicable`、`captured_empty`、空 SQL、客户端版本、服务端版本或校验摘要。
 - 不修改 Schema 工具或 `governance:start` 增加跳过参数。
 - 手工保存与 `governance:start` 同等结构的 GitNexus 开发前基线和影响计划。
 - FEAT-MO-001 不得因此连接、探测或读取生产数据库。
 - 后续功能需要 Schema 基线时，仍必须提供可验证的 MySQL 5.7.x 客户端，或再次获得用户针对该版本的明确授权。
 ## 风险与接受
 缺少 `v0.0.9` Schema 基线意味着仓库不能证明该发布版本对应的开发库结构，也会使依赖严格 Schema 证据的自动治理门禁无法通过。用户接受本次追溯风险；该例外不表示数据库门禁、发布门禁或未来数据库变更已经通过。
@@ -0,0 +1,34 @@
 # FEAT-MO-001 TDX 只读冒烟报告
 - 验证时间：2026-08-18 17:21 CST
 - 网络场景：本机回环桥接（TDX 服务可达）
 - 本机业务入口：`127.0.0.1:17710`
 - API 入口：`127.0.0.1:3000/api/v1/market-overview`
 - 请求方式：HTTP GET（业务 API）及桥接层 HTTP POST JSON
 - 请求类型：市场宽度、一级行业板块、成交额趋势只读请求
 - 原始载荷：未保存
 ## 结果
 - 三条业务接口均返回 HTTP `200`，响应状态均为 `fresh`，`source` 均为 `tdx`。
 - `/breadth`：成功汇总上证、深证和北证指数快照中的 `UpHome`、`DownHome`；`unchanged` 返回 `null`，未进行总数推算。
 - `/sectors`：成功读取一级行业目录并批量获取日行情，按涨跌幅排序返回前 8 项。
 - `/funds`：成功汇总三个交易所指数日行情 `Amount`，按万元转换为亿元并计算较前一交易日变化；该指标展示为“成交额趋势”，不宣称主力净流入。
 - 端到端耗时：市场宽度约 `0.11s`，一级行业约 `0.27s`，成交额趋势约 `0.12s`（单次本机冒烟，不代表生产 SLA）。
 - 未调用交易、账户、自选、写入接口；未保存真实行情原始载荷。
 ## 家庭 LAN 二次复验
 - 验证时间：2026-08-18 19:35 CST。
 - 先按开发手册切换到家庭 LAN SSH 别名，确认本机 `127.0.0.1:17710` 的监听者为本次 SSH 隧道；平台配置仍只使用回环地址。
 - 桥接层最小只读 HTTP POST 成功，没有调用交易、账户、自选或写入方法。
 - Nest API 的 `/summary`、`/indices`、`/breadth`、`/sectors`、`/funds` 均返回 HTTP `200`、`source=tdx`、`status=fresh` 且无 warning。
 - `/indices` 返回 3 项，`/sectors` 返回 8 项；`/breadth` 返回有限且非负的涨跌家数；`/funds` 返回 `marketCount=3`，当前和上一交易日期均存在且不同。
 - 本次只记录结构、状态、数量和日期完整性，不记录真实价格、成交额数值、家庭网络地址、SSH 用户或原始响应。
 - 完成严格整数、最新交易日截面和后端 `delayed` 修复后再次复验：五个接口在当日行情下仍为 `fresh` 且无 warning，证明新增新鲜度判断未误伤当前日期数据。
 ## 脱敏与限制
 - 报告不保存真实价格、成交量、家庭网络地址、Tailscale 地址、SSH 用户、密钥或完整响应。
 - 本报告只证明当前开发机到 TDX 的只读接口和本次映射可达，不证明 7×24 生产采集、商业再分发授权、主力净流入口径或盘中新闻接口已经可用。
 - 主力净流入和盘中新闻继续保留为补充数据源需求；后续接入必须单独记录来源、权限、口径和数据质量。
@@ -3,6 +3,36 @@
 - 结论、驱动和风险在首屏可见。
 - 分析状态可以临时切换并保存默认值。
 - 依据抽屉能够打开和关闭。
- 时间范围切换更新图表。
+- 五个模块并行请求，一个模块失败不阻断其他模块。
 - 真实 TDX 指数、市场宽度、一级行业板块和成交额趋势响应可映射；主力净流入与盘中新闻不以占位值伪造。
 - 加载、部分数据、过期和错误状态具有明确文案。
 - 桌面和窄窗口不出现阻断核心内容的溢出。
 ## 已执行证据
 - 前端 Vitest、typecheck、build：通过。
 - 后端 TDX 客户端、映射、服务、HTTP/OpenAPI 测试：通过。
 - `curl` 冒烟：`/breadth`、`/sectors`、`/funds` 均返回 `source=tdx,status=fresh`；分别验证 `UpHome/DownHome` 汇总、一级行业排序和成交额单位转换。
 - 异常映射：覆盖畸形涨跌家数字段（小数、指数、十六进制和超出安全整数）、当前及前一根非法公历日期、相邻日期重复/倒序、空一级行业目录、单根板块 K 线、指数/板块混合交易日、成交额缺市场/交易日倒序/日期金额数组错位/负数/首市场落后，以及三市完整性状态。
 - 后端状态：覆盖指数、市场宽度、一级行业和成交额旧交易日期的真实 `delayed` 分支；休市日保守延迟属于已记录边界。
 - 测试时钟：市场概览服务套件统一冻结到上海 `2026-08-18`，单个 `delayed` 用例显式切换目标日期并在用例后恢复，保证测试不会随自然日期变化。
 - 前端状态：覆盖宽度、板块和成交额模块的 `partial`/`delayed` 警告、真实交易日期和成交额零变化中性色。
 - 浏览器验证：桌面默认视口和 390px 移动视口无横向溢出；综合/短线切换和分析引擎选择可用。
 ## 安全、性能与残余风险
 - 安全：TDX 地址固定为本机回环桥接端口；请求超时、响应 1 MiB 上限、错误脱敏；只读行情，不接受用户输入拼接请求。
 - 性能：五个模块并行请求，单次 TDX 请求受超时保护；本切片不引入数据库、缓存或消息负载，未进行持续压测。
 - 残余风险：主力净流入字段当前桥接实测为零值，需权限和口径专项验证；盘中新闻仍需补充源；详情页、依据抽屉和 AI 运行时需另立功能；市场数据授权和生产 7×24 稳定性未由本地冒烟证明。
 ## 安全验证
 - 验证 TDX 只能使用回环地址和固定端口，错误响应不包含原始 URL、请求体或凭据。
 - 验证前端只能通过统一 Axios API 文件访问后端，边界测试拒绝页面直连 Axios/fetch 和 Server 内部依赖。
 - 验证 E2E 夹具使用无秘密的生产测试环境变量，不读取仓库内本地凭据或生产配置。
 ## 性能验证
 - 验证五个模块并发加载、单模块失败隔离和请求超时行为。
 - 验证响应体 1 MiB 上限和构建产物体积；浏览器桌面/移动端无横向溢出。
 - 7×24 运行、峰值并发、TDX 断线重连和消息/缓存压力测试不适用于当前只读首屏，已列为后续采集与生产功能边界。
@@ -0,0 +1,21 @@
 # 设计
 ## 方案
 在 `web/vite.config.ts` 的 `server.port` 设置 8888；同步 `web/playwright.config.ts` 的 `baseURL` 与 `webServer.url`，并更新 `docs/deployment/local-development.md`。保持 `host: 127.0.0.1`、`strictPort: true` 和 `/api` 代理不变。
 ## 安全策略与评估
 - 监听地址仍为回环地址，不增加局域网或公网暴露。
 - 不停止 8080 的外部项目进程。
 - 不读取或写入凭据，不改变 API、TDX 或外部基础设施配置。
 ## 性能目标与评估
 - 端口调整不改变前端构建产物和运行时逻辑。
 - Vite 启动验证目标为 30 秒内可访问；本次实际启动耗时小于 1 秒。
 - E2E 启动入口与真实监听地址保持一致，避免重复启动或等待错误端口。
 ## 错误处理与回退
 `strictPort: true` 保持不变；8888 被占用时启动明确失败，不自动抢占或切换端口。回退时将四处当前配置恢复为 5173，并同步恢复文档。
@@ -0,0 +1,45 @@
 # Web 开发端口调整开发总结
 - 功能编号：FEAT-MO-002
 - 总结版本：0.1
 - 日期：2026-08-19
 ## 原始开发需求
 将前端端口改为 8080，检查占用并启动；经检查 8080 被其他项目占用后，用户确认改用 8888。
 ## 需求与范围变化
 初始目标从 8080 调整为 8888，原因是 8080 已被另一个本地项目占用；该进程不属于本项目，本次没有停止或修改它。
 ## 实际完成需求
 - `web/vite.config.ts` 开发端口改为 8888。
 - `web/playwright.config.ts` 两处 Web 地址改为 8888。
 - 本地开发手册 Web 地址改为 8888。
 - 新增端口回归测试。
 - Web 已在 `http://127.0.0.1:8888/` 启动并返回 200。
 - Tailscale 外部隧道已启动，SSH 控制隧道监听 `127.0.0.1:17710`，TDX 只读行情请求成功。
 - 为保证外部隧道切换后的 API 可重复启动，在被 Git 忽略的 `deploy/env/development/api.env.local` 补充了 `TDX_BASE_URL` 和 `TDX_TIMEOUT_MS`，未写入仓库。
 ## 修复缺陷
 本次没有修复既有业务缺陷；变化属于本地开发配置和对应验证入口的一致性调整。新增回归断言防止端口意外恢复为 5173。
 ## 未完成与延期项
 生产部署不在本次范围。完整 E2E 在收尾复验时发现市场概览夹具时钟未隔离，已由 `FEAT-QA-001` 修复；API 健康检查因开发 MySQL 不可用返回 503，但 Redis 正常，市场概览接口和 TDX 只读链路返回 200，MySQL 状态不属于本次端口变更。
 ## 关键提交
 - `f00e114f88464f07bcbba3ca6691f04ca9699d38`：`chore(FEAT-MO-002): 调整 Web 开发端口为 8888`。
 - 该实施提交已推送至项目 Gitea `origin/main`，远端分支 SHA 与本地一致。
 ## 验证证据
 - Schema：`npm run schema:baseline` 和 `npm run schema:verify` 均通过，版本 `v0.0.10 (captured_empty)`。
 - GitNexus：开发前索引状态最新；开发后检测为 LOW、受影响执行流 0。
 - 测试：Web Vitest 8 个文件、21 个测试通过；修改前新增端口测试按预期失败。
 - 启动：Vite 监听 8888，首页 HTTP 200；API 使用本地配置启动并监听 3000。
 - TDX：Tailscale ping 经 DERP 成功，SSH 隧道监听 17710，`get_market_data` 返回 `ErrorId=0`。
 - 安全：保持 127.0.0.1，不停止其他项目，不读取凭据。
@@ -0,0 +1,13 @@
 # GitNexus 开发后基线
 ## GitNexus 状态
 完成 Web 配置、测试和文档修改后刷新索引：3,122 nodes、4,343 edges、68 clusters、85 flows，状态 `up-to-date`。本功能影响评估为 LOW，受影响执行流为 0。
 ## Git 已跟踪变更摘要
 Vite 开发端口、Playwright Web 地址和本地开发手册由 5173 统一调整为 8888；AGENTS.md 的既有修改保留，不属于本功能。
 ## Git 工作区摘要
 工作区包含本功能档案和端口相关修改；无关未跟踪文件明确排除。提交与推送将在最终独立 Review 通过后执行。
@@ -0,0 +1,26 @@
 # GitNexus 开发前基线
 - 功能编号：FEAT-MO-002
 - 记录时间：2026年8月19日 GMT+8 12:23:44
 - 分支：main
 - 基线提交：1f6ed00e6fbb
 ## 工作区
 ```text
 M AGENTS.md
 ```
 ## GitNexus 状态
 ```text
 Repository: <project-root>
 Indexed: 8/18/2026, 9:31:53 PM
 Indexed commit: 1f6ed00
 Current commit: 1f6ed00
 Status: ✅ up-to-date
 ```
 ## 后续人工分析
 在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。
@@ -0,0 +1,13 @@
 # GitNexus 前后对比
 ## 开发前
 Vite 监听 5173，Playwright 和本地手册使用 5173；GitNexus 索引为项目当前基线。
 ## 开发后
 Vite、Playwright 和本地开发手册统一使用 8888；业务模块执行流、API 契约和数据基础设施不变。GitNexus 变更检测为 LOW，受影响执行流 0。
 ## 差异处置
 8080 的外部 Python 进程未被停止；Tailscale 外部 TDX 隧道独立切换到 `tdx-windows-tailnet`，不改变平台固定的 127.0.0.1:17710 入口。
@@ -0,0 +1,9 @@
 # GitNexus 变更检测
 执行：`gitnexus_detect_changes({scope: "unstaged", repo: "a-share-analysis"})`。
 结果：`changed_count=3`、`changed_files=5`、`affected_count=0`、`risk_level=low`、受影响执行流 0。GitNexus 识别到 AGENTS.md（既有工作区修改）和本地开发文档章节；Vite/Playwright 的端口常量变化未映射为业务符号，已通过配置测试、类型检查、构建和 HTTP 启动验证覆盖。
 本功能预期变更仅为：Vite 端口、Vite 配置测试、Playwright 地址、本地开发文档和功能档案。AGENTS.md 是用户已有修改，本次不触碰其内容，也不将其视为功能变更。
 同步判断：不涉及 API/OpenAPI、消息契约、数据库、Redis、Scheduler、Worker 或生产部署；Web 开发启动流程已同步。
@@ -0,0 +1,35 @@
 # GitNexus 开发前影响计划
 - 功能编号：FEAT-MO-002
 - 目标：将 Vue/Vite 本地开发服务器端口从 5173 调整为 8888。
 - 总体风险：LOW
 ## 直接与间接影响
 - `gitnexus_query("Vite development server port web startup")` 定位到 `web/vite.config.ts` 和 `web/src/vite-config.test.ts`。
 - `gitnexus_context({name: "vite.config.ts", file_path: "web/vite.config.ts"})` 显示该配置文件被 `web/src/vite-config.test.ts` 导入，配置内部调用 `readDevelopmentPublicEnv`。
 - `gitnexus_impact({target: "vite.config.ts", direction: "upstream"})`：直接调用方 0、受影响执行流 0、受影响模块 0，风险 LOW。
 - `gitnexus_impact({target: "playwright.config.ts", direction: "upstream"})`：直接调用方 0、受影响执行流 0、受影响模块 0，风险 LOW；该配置自身启动并访问 Web 开发服务器，需要同步更新端口。
 - 对 `readDevelopmentPublicEnv` 的 upstream 影响为 1 个配置文件调用方，风险 LOW；端口字段是 Vite 配置常量，不改变 API、数据契约或业务逻辑。
 - 8080 已被另一个本地项目占用；该进程不属于本项目，本次不停止、不修改，也不记录其本机目录或临时进程标识。
 ## 跨模块同步修改
 | 维度 | 判断 | 同步修改 |
 |---|---|---|
 | HTTP/OpenAPI | 不涉及页面 API 契约 | 无 |
 | Web API | 不涉及 Axios 请求路径 | 无 |
 | 消息契约 | 不涉及 RocketMQ | 无 |
 | 数据库 | 不涉及 MySQL Schema | 无 |
 | Redis | 不涉及缓存 | 无 |
 | API | Nest API 端口保持 3000 | 无 |
 | Scheduler/Worker | 不涉及任务进程 | 无 |
 | 部署 | 仅开发 Vite 端口；生产 Web 配置不变 | 更新本功能说明 |
 | 测试 | Vite 配置回归测试增加 8888 断言；Playwright baseURL/webServer URL 同步 | 修改 `web/src/vite-config.test.ts`、`web/playwright.config.ts` |
 | 文档 | 本地开发 Web 地址同步为 8888 | 修改 `docs/deployment/local-development.md` 和本功能档案 |
 ## 安全、性能与残余风险
 - 安全：不改变监听地址（仍为 `127.0.0.1`），不暴露新公网入口，不接触凭据。
 - 性能：仅改变本地开发服务器监听端口，不改变构建产物、代理或运行时性能。
 - 残余风险：如果其他本地进程占用 8888，因 `strictPort: true` 启动会失败；启动前必须检测并报告。
@@ -0,0 +1,9 @@
 # 实施计划
 1. 检查 8080/8888 占用情况和工作区状态。
 2. 执行 Schema 基线与校验，运行治理起始门禁。
 3. 使用 GitNexus 评估 Vite、Playwright 配置和测试影响。
 4. 先添加 8888 回归断言并确认旧配置下失败，再修改 Vite 配置。
 5. 同步 Playwright 和本地开发文档。
 6. 启动 Web，验证 8888 HTTP 200；切换 Tailscale 外部 TDX 隧道并验证只读行情。
 7. 执行测试、构建、GitNexus 变更检测和 Review。
@@ -0,0 +1,12 @@
 id: FEAT-MO-002
 name: Web 开发端口调整为 8888
 slug: web-port-8888
 status: ready_for_release
 owner: project
 created_at: 2026-08-19
 requirements: requirements.md
 prd: prd.md
 design: design.md
 implementation_plan: implementation-plan.md
 release: unreleased
 traceability_note: 端口配置、安全断言、完整门禁、GitNexus 与独立 Review 已通过，等待正式版本发布
@@ -0,0 +1,47 @@
 # Web 开发端口调整为 8888 PRD
 - 功能编号：FEAT-MO-002
 - PRD版本：0.1
 - 状态：approved
 - 日期：2026-08-19
 ## 背景与问题
 本机 8080 已被其他项目占用，现有 A 股分析工具前端开发端口 5173 需要调整为用户指定的 8888。
 ## 产品目标
 - Web 开发服务器监听 `127.0.0.1:8888`。
 - Playwright、本地开发文档和端口回归测试使用同一地址。
 - API 仍监听 `127.0.0.1:3000`，TDX 隧道仍使用 `127.0.0.1:17710`。
 ## 非目标
 - 不改变生产 Web 端口、Nginx、API、TDX、Redis、MySQL 或 RocketMQ 配置。
 - 不停止其他项目进程，不开放公网监听。
 ## 功能需求
 | 编号 | 优先级 | 需求 | 可观察结果 |
 |---|---|---|---|
 | FR-001 | P0 | 调整 Vite 开发端口 | `vite.config.ts` 的 `server.port` 为 8888 |
 | FR-002 | P0 | 同步 E2E 和本地文档 | Playwright 和开发手册访问 8888 |
 | FR-003 | P0 | 保持本机安全边界 | host 仍为 127.0.0.1，strictPort 仍启用 |
 ## 安全需求与信任边界
 本次只改变本机开发监听端口，不改变监听地址、代理目标、认证、数据源或凭据。8080 占用进程不属于本项目，不停止或操作该进程。
 ## 性能目标与容量假设
 端口变化不应改变构建、代理和页面运行时性能；Vite 应在 30 秒内启动并返回首页。
 ## 验收标准
 - `web/src/vite-config.test.ts` 断言端口为 8888。
 - `http://127.0.0.1:8888/` 返回 HTTP 200。
 - API 代理仍转发到 `http://127.0.0.1:3000`。
 ## 关联模块与同步修改
 涉及 Web Vite 配置、Web 配置测试、Playwright 配置和本地开发文档；不涉及 HTTP/OpenAPI、数据库、Redis、消息、Scheduler、Worker 和生产部署。
@@ -0,0 +1,19 @@
 # 测试结果
 - RED：端口断言在旧配置下按预期失败，实际值为 5173，期望值为 8888。
 - GREEN：Web Vitest 8 个测试文件、21 个测试全部通过。
 - 安全回归：Vite 配置测试同时锁定 `host=127.0.0.1`、`port=8888` 和 `strictPort=true`。
 - HTTP：`curl -I http://127.0.0.1:8888/` 返回 HTTP 200。
 - API：`/api/v1/market-overview/summary` 返回 HTTP 200，`source=tdx`、`status=fresh`。
 - TDX：外部 Tailscale SSH 隧道 `127.0.0.1:17710` 只读请求返回 `ErrorId=0`。
 - 健康检查：API 返回 503，明确原因为开发 MySQL 不可用；Redis 为 healthy，RocketMQ 为 disabled。该结果不影响端口和 TDX 链路验收。
 - 完整门禁：`pnpm verify` 通过，Web 21/21、Server 67/67、启动器 2/2、Playwright 4/4，类型检查与前后端构建通过。
 - Lint：0 error；保留市场概览组件既有 35 条格式 warning，本功能没有新增 warning。
 ## 安全验证
 监听地址保持回环；未停止或修改占用 8080 的外部进程；变更中未写入新凭据、本机绝对路径或临时进程标识。
 ## 性能验证
 Vite 启动耗时约 194ms，首页可立即访问；完整构建和 E2E 通过，未增加运行时依赖和外部服务调用。
@@ -0,0 +1,11 @@
 # 视觉验证
 本次仅改变开发服务器端口，不改变页面布局、样式或组件。收尾的 Playwright 在桌面与移动端共执行 4 个用例并全部通过；页面视觉基线继续沿用 FEAT-MO-001 的既有截图，不制造重复截图产物。
 ## 安全验证
 Web 仍只绑定 `127.0.0.1`，没有新增局域网或公网访问入口。
 ## 性能验证
 Vite 监听 8888 后首页响应正常，端口变更不影响页面资源加载路径。
@@ -0,0 +1,3 @@
 # 发布说明
 本地开发 Web 端口从 5173 调整为 8888。API、TDX 隧道和生产配置不变。该功能尚未创建发布标签。
@@ -0,0 +1,14 @@
 # 需求
 用户要求将前端开发端口改为 `8888`，检查是否被占用并启动项目。
 ## 实际范围
 - Vite 开发服务器从 5173 改为 8888。
 - Playwright `baseURL` 和 Web Server 检查地址同步为 8888。
 - 本地开发手册 Web 地址同步为 8888。
 - API 继续使用 3000，TDX 外部隧道继续映射到 17710。
 ## 范围变化
 8080 初次检查发现已被其他项目 Python `run.py` 进程占用，因此没有停止该进程，改用用户确认的 8888。
@@ -0,0 +1,46 @@
 # 代码 Review
 - 功能编号：FEAT-MO-002
 - reviewer_type：self
 - reviewer：Codex
 - 日期：2026-08-19
 ## 审查范围
 审查 `web/vite.config.ts`、`web/src/vite-config.test.ts`、`web/playwright.config.ts`、本地开发手册及对应功能档案。
 ## PRD 与设计符合性
 符合：Vite、Playwright 和本地开发文档统一使用 8888，API 3000、TDX 隧道 17710 和回环监听保持不变。
 ## 发现
 | 严重程度 | 位置 | 问题 | 影响 | 处理 |
 |---|---|---|---|---|
 | 无 | - | 未发现本次范围内问题 | - | - |
 ## 测试缺口
 收尾时完整 E2E 首次运行发现市场概览测试夹具时钟未隔离；该跨日缺陷不属于端口行为，已由 `FEAT-QA-001` 使用固定测试时钟修复并纳入完整门禁。
 ## 安全与残余风险
 保持 `127.0.0.1` 和 `strictPort`，不停止其他项目。残余风险是 8888 被其他进程占用时启动会明确失败。
 ## 性能与资源影响
 仅改变监听端口；Vite 启动约 194ms，无新依赖和外部负载。
 ## GitNexus 与同步修改
 GitNexus 对 Vite 和 Playwright 配置影响评估为 LOW；同步更新了配置测试、E2E 地址和本地开发文档。
 ## 修复与复审
 端口测试已完成 RED/GREEN；独立 Review 要求补锁回环地址和 `strictPort`，对应断言已增加。档案中的本机绝对路径、临时 PID 和旧验证结论已清理；完整门禁通过，等待最终复审。
 ## 最终结论
 最终独立复审确认回环监听、8888、`strictPort`、Playwright 和文档一致；无 Critical、Important 或 Minor 问题，`Ready to commit: Yes`。
 最终结论：passed
@@ -0,0 +1,36 @@
 # 开发规范符合性 Review
 - 功能编号：FEAT-MO-002
 - reviewer_type：self
 - reviewer：Codex
 - 日期：2026-08-19
 ## 检查结果
 - [x] 必要中文注释准确且没有逐行废话注释。
 - [x] 文件按稳定职责拆分，没有过度碎片化。
 - [x] 端口、监听地址和时间语义明确。
 - [x] 错误处理和 strictPort 行为保持不变。
 - [x] 安全策略、性能目标、验证证据和残余风险完整。
 - [x] 未引入依赖，未发生 API 或前端请求边界变化。
 - [x] GitNexus 开发前影响分析和开发后检测已记录，风险 LOW、0 受影响执行流。
 - [x] 开发总结记录了需求、范围变化、完成项、延期项和验证证据。
 - [x] PRD、设计、测试、发布和回退口径一致。
 ## 不符合项与处置
 独立 Review 发现安全配置断言不足、功能档案含本机绝对路径/临时 PID 且验证结论已过时。现已清理敏感环境细节并补充 `host`、`port`、`strictPort` 回归断言；完整门禁通过，等待最终复审。
 ## 安全、性能与架构检查
 监听仍为 127.0.0.1；端口变化不改变资源性能；8080 外部进程未被操作。
 ## GitNexus 与开发总结检查
 影响风险 LOW，配置、测试、E2E 和文档同步修改均已记录；开发总结列出 TDX 外部隧道与 MySQL 健康检查证据。
 ## 最终结论
 最终独立复审确认完整门禁、GitNexus、安全清理和逐路径提交策略符合规范；无未关闭问题。
 最终结论：passed
@@ -0,0 +1,19 @@
 # 回退说明
 ## 触发条件
 - 8888 与本机其他必要服务冲突。
 - Playwright 或本地开发脚本无法访问前端。
 - 发现端口改动影响非开发环境配置。
 ## 回退步骤
 1. 将 `web/vite.config.ts` 的 `server.port` 恢复为 5173。
 2. 将 `web/playwright.config.ts` 的 `baseURL` 和 `webServer.url` 恢复为 5173。
 3. 将 `docs/deployment/local-development.md` 的 Web 地址恢复为 5173。
 4. 同步修改端口回归测试和本功能档案，执行 Web 测试与启动验证。
 5. 停止本功能启动的 Web 进程，不操作 8080 的其他项目。
 ## 数据与外部服务
 本次不修改 MySQL、Redis、RocketMQ、TDX 客户端或 SSH 隧道配置，因此无需数据回退。
@@ -0,0 +1,22 @@
 # 测试计划
 ## 功能验证
 - Vite 配置单元测试：监听地址为 `127.0.0.1`、端口为 8888、`strictPort=true`，代理仍为本地 API。
 - Web 启动验证：8888 返回首页 HTML。
 - Playwright 配置检查：baseURL 和 webServer URL 均为 8888。
 ## 安全验证
 - 检查监听地址仍为 `127.0.0.1`。
 - 检查 8080 外部 Python 进程未被停止或修改。
 - 检查无密钥、密码和公网地址进入变更文件。
 ## 性能验证
 - 记录 Vite 启动耗时和首页 HTTP 响应。
 - 端口配置不引入新依赖、不增加 API 或数据源负载。
 ## 验证边界
 生产部署验证不属于本地开发端口范围；收尾时仍执行完整仓库门禁和 Playwright 桌面/移动端回归，确保端口同步没有破坏测试启动链路。
@@ -0,0 +1,17 @@
 # 设计
 ## 设计方案
 只修改根目录 README，事实来源固定为现有部署手册、系统架构、FEAT-MO-001 市场概览和 FEAT-MO-002 端口档案。README 作为入口索引，不复制完整的 Tailscale、生产部署或治理规则。
 ## 安全策略与评估
 仅写入 TDX 本机回环入口、SSH 别名和占位符；不写真实 Windows 地址、Tailscale IP、SSH 用户、Token、密码或私钥。README 明确 TDX 不开放公网、Schema 禁止触碰生产库。
 ## 性能目标与评估
 文档变化不影响编译、运行时和网络性能；只增加可发现性和启动指导。
 ## 兼容与回退
 README 可以独立回退，不需要数据迁移或服务重启。后续端口、部署或数据源变更必须同步 README 和专项文档。
@@ -0,0 +1,40 @@
 # README 文档同步开发总结
 - 功能编号：FEAT-MO-003
 - 总结版本：0.1
 - 日期：2026-08-19
 ## 原始开发需求
 用户指出 README 落后，要求更新为当前项目状态。
 ## 需求与范围变化
 从旧的英文工程简介扩展为当前可运行状态说明，新增 8888 Web、TDX 双隧道、首屏模块、基础设施边界和启动验证；未改变代码和运行行为。
 ## 实际完成需求
 - README 已同步当前市场概览首屏、技术栈和源码部署边界。
 - README 已同步 Web 8888、API 3000 和 TDX 17710 回环入口。
 - README 已补充 LAN/Tailscale 隧道、启动、停止和验证入口。
 - README 已补充 Schema、GitNexus、Review 和 Gitea 约束链接。
 ## 修复缺陷
 修复 README 将项目描述、端口、启动方式和基础设施启用边界写旧的问题；没有业务代码缺陷修复。
 ## 未完成与延期项
 README 不替代完整 Tailscale、生产部署和治理文档；这些内容继续由专项文档维护。
 ## 关键提交
 - `6cbfd8d8a4d0bfadef33c87a21d16ea900d9978e`：`docs(FEAT-MO-003): 更新项目 README`。
 - 该实施提交已推送至项目 Gitea `origin/main`，远端分支 SHA 与本地一致。
 ## 验证证据
 - Schema：npm run schema:baseline 和 npm run schema:verify 通过，v0.0.10 captured_empty。
 - GitNexus：README upstream 风险 LOW，执行流 0；开发后检测已记录。
 - 文档检查：旧的当前端口引用清理，README 链接和命令与现有文件一致。
 - 安全：未写入凭据、真实 Tailscale 地址、Windows 用户或 Token。
@@ -0,0 +1,5 @@
 # GitNexus 开发后基线
 GitNexus 已刷新：3,122 nodes、4,343 edges、68 clusters、85 flows，状态 up-to-date。
 README upstream 风险 LOW，受影响执行流 0；开发后变更检测 risk_level=low、affected_count=0。
@@ -0,0 +1,32 @@
 # GitNexus 开发前基线
 - 功能编号：FEAT-MO-003
 - 记录时间：2026年8月19日 GMT+8 12:57:47
 - 分支：main
 - 基线提交：1f6ed00e6fbb
 ## 工作区
 ```text
 M AGENTS.md
 M README.md
 M docs/deployment/local-development.md
 M web/playwright.config.ts
 M web/src/vite-config.test.ts
 M web/vite.config.ts
 ?? docs/features/FEAT-MO-002-web-port-8888/
 ```
 ## GitNexus 状态
 ```text
 Repository: <project-root>
 Indexed: 8/19/2026, 12:57:47 PM
 Indexed commit: 1f6ed00
 Current commit: 1f6ed00
 Status: ✅ up-to-date
 ```
 ## 后续人工分析
 在修改代码前，将 GitNexus query、context、impact 的结论写入 `gitnexus/impact-plan.md`。高风险结果必须先获得用户确认。
@@ -0,0 +1,3 @@
 # GitNexus 前后对比
 开发前 README 使用旧的英文项目简介、5173 端口和不完整启动说明；开发后同步当前 8888、TDX 双隧道、首屏模块和治理入口。README 不参与业务执行流。
@@ -0,0 +1,5 @@
 # GitNexus 变更检测
 执行 `gitnexus_detect_changes({scope: "unstaged", repo: "a-share-analysis"})` 结果：changed_count=10、changed_files=6、affected_count=0、risk_level=low、受影响执行流 0。
 GitNexus 识别到 README 的 6 个章节和既有 AGENTS.md/本地开发文档章节；本功能没有业务代码或运行时执行流变化。AGENTS.md 的既有用户修改保留，不属于本功能。
@@ -0,0 +1,27 @@
 # GitNexus 开发前影响计划
 - 功能编号：FEAT-MO-003
 - 目标：同步根目录 README 与当前前端端口、TDX 双隧道、本地启动、技术栈和首屏能力。
 - 总体风险：LOW
 ## 直接与间接影响
 - GitNexus context：README.md 仅关联 docs/index、治理、部署和架构文档，没有业务执行流调用方。
 - GitNexus impact：README.md upstream 直接调用方 0、受影响执行流 0、受影响模块 0，风险 LOW。
 - README 的事实来源为现有本地开发、TDX 隧道、系统架构和 FEAT-MO-001/002 功能档案。
 ## 跨模块同步修改
 | 维度 | 判断 | 同步修改 |
 |---|---|---|
 | HTTP/OpenAPI | 不涉及 | 无 |
 | Web API | 不涉及 | 无 |
 | 消息、数据库、Redis | 不涉及运行配置 | 无 |
 | API、Scheduler、Worker | 不改变启动行为 | README 仅说明边界 |
 | 部署 | 仅补充现有源码部署和本地文档入口 | README 链接同步 |
 | 测试 | 文档变更不要求业务测试；执行格式检查和功能门禁 | 功能档案 |
 | 安全 | 不写入凭据、真实地址或 Token；保留回环和 TDX 隧道边界 | README |
 ## 性能与残余风险
 README 不参与运行时路径，不增加性能负载。残余风险是文档与后续配置变更可能再次漂移，后续端口或部署变更必须同步 README 和对应专项文档。
@@ -0,0 +1,6 @@
 # 实施计划
 1. 对比 README 与当前部署、架构和功能档案。
 2. 执行 Schema 基线和 GitNexus 开发前影响分析。
 3. 更新 README 的状态、技术栈、TDX 隧道、启动和治理内容。
 4. 检查旧端口和敏感信息，执行格式检查和治理完成门禁。
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
FoXiMao	db45838e22	docs(FEAT-MO-005): 对齐最终 GitNexus 基线	2026-08-25 02:39:34 +08:00
FoXiMao	21393ef451	docs(FEAT-MO-005): 完善市场结构功能追溯档案	2026-08-25 02:38:06 +08:00
FoXiMao	64a9f2e866	feat(FEAT-MO-005): 展示市场结构与成交额趋势	2026-08-25 02:33:21 +08:00
FoXiMao	b95b9e5c92	feat(FEAT-MO-005): 接入市场结构前端数据层	2026-08-25 02:10:22 +08:00
FoXiMao	ad40ffffc4	feat(FEAT-MO-005): 增加全市场成交额趋势接口	2026-08-25 02:04:00 +08:00
FoXiMao	7b76dd1353	feat(FEAT-MO-005): 增加行业题材资金流向接口	2026-08-25 01:56:51 +08:00
FoXiMao	8174f3f698	feat(FEAT-MO-005): 增加行业题材板块排行接口	2026-08-25 01:51:23 +08:00
FoXiMao	b6a9f40ed8	chore(FEAT-MO-005): 同步OpenAPI生成契约	2026-08-25 01:44:50 +08:00
FoXiMao	548f9c4b8b	feat(FEAT-MO-005): 建立市场结构数据映射边界	2026-08-25 01:42:59 +08:00
FoXiMao	a019aaa343	test(FEAT-MO-005): 补充探针地址边界测试	2026-08-25 01:34:13 +08:00
FoXiMao	50b5266903	docs(FEAT-MO-005): 建立市场结构数据源探针	2026-08-25 01:27:41 +08:00
FoXiMao	4f5a56df3a	docs(FEAT-MO-005): 编写市场结构实施计划	2026-08-25 01:06:48 +08:00
FoXiMao	bdfab99b10	docs(FEAT-MO-005): 固化市场结构与成交额趋势设计	2026-08-25 01:00:30 +08:00
FoXiMao	a1b4d8c591	docs(FEAT-MO-004): 修正收盘后分时时效结论	2026-08-25 00:51:58 +08:00
FoXiMao	86de51f184	docs(GOV-010): 更新GitNexus索引状态	2026-08-25 00:49:50 +08:00
FoXiMao	cf520193b3	docs(FEAT-MO-004): 记录AKTools分时能力探针	2026-08-25 00:48:34 +08:00
FoXiMao	bdb7923f75	docs(FEAT-MO-004): 固化最终GitNexus状态	2026-08-25 00:27:12 +08:00
FoXiMao	40a24549bc	docs(FEAT-MO-004): 更新GitNexus最终基线	2026-08-25 00:25:45 +08:00
FoXiMao	50b6318d25	docs(FEAT-MO-004): 完成详情页治理追溯	2026-08-25 00:24:11 +08:00
FoXiMao	0131f863b6	feat(FEAT-MO-004): 实现指数板块详情分析页	2026-08-25 00:16:43 +08:00
FoXiMao	f8f4da93dc	docs(FEAT-MO-004): 更新GitNexus索引统计	2026-08-24 23:27:47 +08:00
FoXiMao	a7d85bc4a3	docs(FEAT-MO-004): 固化指数板块详情页设计	2026-08-24 23:26:46 +08:00
FoXiMao	2cf31f5137	docs(FEAT-MO-001): 修正概览Review结论门禁	2026-08-24 23:13:21 +08:00
FoXiMao	96232ff225	docs(FEAT-MO-001): 记录概览时间修复追溯	2026-08-24 23:11:01 +08:00
FoXiMao	b1310fb86d	fix(FEAT-MO-001): 修正概览时间时区显示	2026-08-24 23:08:46 +08:00
FoXiMao	1e80e7d2de	docs(FEAT-DS-001): 更新健康检查修复追溯	2026-08-24 22:45:05 +08:00
FoXiMao	9ff6646d56	fix(FEAT-DS-001): 修正MySQL健康检查会话时区	2026-08-24 22:42:21 +08:00
FoXiMao	a10c785ff8	docs(FEAT-DS-001): 固化最终开发摘要	2026-08-24 21:53:56 +08:00
FoXiMao	358004fd12	docs(FEAT-DS-001): 更新最终GitNexus基线	2026-08-24 21:52:08 +08:00
FoXiMao	1398804a6f	style(FEAT-DS-001): 统一超短行情代码格式	2026-08-24 21:49:48 +08:00
FoXiMao	61283c5c38	docs(FEAT-DS-001): 完成AKTools治理追溯	2026-08-24 21:44:23 +08:00
FoXiMao	6e8a05114e	feat(FEAT-DS-001): 接入AKTools超短行情补充数据源	2026-08-24 21:40:22 +08:00
FoXiMao	81c48af8cc	docs(FEAT-DS-001): 设计 AKTools 超短补充数据源	2026-08-24 20:43:14 +08:00
FoXiMao	0d0d1eea45	docs(FEAT-QA-001): 补充修复与索引记录	2026-08-24 17:56:20 +08:00
FoXiMao	368672f001	fix(FEAT-QA-001): 隔离市场概览 E2E 测试时钟	2026-08-24 17:53:09 +08:00
FoXiMao	7904571ddd	docs(FEAT-MO-003): 补充提交推送记录	2026-08-24 17:52:26 +08:00
FoXiMao	6cbfd8d8a4	docs(FEAT-MO-003): 更新项目 README	2026-08-24 17:51:31 +08:00
FoXiMao	ab0b53a56b	docs(FEAT-MO-002): 补充提交推送记录	2026-08-24 17:50:49 +08:00
FoXiMao	f00e114f88	chore(FEAT-MO-002): 调整 Web 开发端口为 8888	2026-08-24 17:49:19 +08:00
FoXiMao	1f6ed00e6f	docs(FEAT-MO-001): 完成评审与治理收口	2026-08-18 21:24:05 +08:00
FoXiMao	c2fdfa625b	fix(FEAT-MO-001): 校验相邻行情日期	2026-08-18 21:10:58 +08:00
FoXiMao	ae2a7e08ed	fix(FEAT-MO-001): 校验TDX交易日期语义	2026-08-18 20:48:20 +08:00
FoXiMao	7e4dcd9232	fix(FEAT-MO-001): 修复交易日对齐与延迟状态	2026-08-18 20:12:26 +08:00
FoXiMao	49f6be9c43	fix(FEAT-MO-001): 修复TDX数据完整性与状态展示	2026-08-18 19:30:34 +08:00
FoXiMao	ff8ada8316	feat(FEAT-MO-001): 接入TDX市场宽度板块与成交额趋势	2026-08-18 17:37:36 +08:00
FoXiMao	82619489a9	feat(FEAT-MO-001): 完成TDX市场概览首屏	2026-08-18 15:28:35 +08:00
FoXiMao	27bc3c198f	feat(FEAT-MO-001): 同步市场概览前端契约	2026-08-18 13:43:48 +08:00
FoXiMao	15a25002ce	feat(FEAT-MO-001): 增加市场概览分模块接口	2026-08-18 13:31:24 +08:00
FoXiMao	c2fa929936	feat(FEAT-MO-001): 增加TDX直连配置与客户端	2026-08-18 13:16:07 +08:00
FoXiMao	6eb34b5afe	docs(FEAT-MO-001): 记录TDX开发前门禁	2026-08-18 13:05:32 +08:00
FoXiMao	d283ee3196	docs(FEAT-MO-001): 制定TDX概览实施计划	2026-08-18 12:59:17 +08:00
FoXiMao	9a965fab14	docs(FEAT-MO-001): 确认TDX直连概览设计	2026-08-18 12:48:28 +08:00
FoXiMao	b49e7b8b08	docs(GOV-012): 完成发布后基线追溯记录	2026-08-18 03:10:29 +08:00
FoXiMao	11edeb0111	chore(GOV-012): 封存 v0.0.10 开发库 Schema 基线	2026-08-18 03:08:38 +08:00
FoXiMao	16bde94df6	chore(GOV-012): 发布 v0.0.10 元数据	2026-08-18 03:06:48 +08:00
FoXiMao	58026aead3	docs(GOV-012): 完成功能质量与发布追溯档案	2026-08-18 03:04:59 +08:00
FoXiMao	f1c412b6a3	docs(GOV-012): 更新纯 Node Schema 基线规范	2026-08-18 03:00:47 +08:00
FoXiMao	afd186c8a4	fix(GOV-012): 兼容 MySQL 5.7 视图目录并封存 v0.0.9 基线	2026-08-18 02:57:40 +08:00
FoXiMao	874796ab65	fix(GOV-012): 修复 Schema 定义安全与错误语义	2026-08-18 02:46:50 +08:00
FoXiMao	3d12c83621	fix(GOV-012): 修复目录元数据校验与查询错误脱敏	2026-08-18 02:34:14 +08:00
FoXiMao	c11de09fa7	feat(GOV-012): 升级 Schema 基线 format v3	2026-08-18 02:24:54 +08:00
FoXiMao	dc8ad7d4b6	feat(GOV-012): 实现完整 SHOW CREATE 结构导出	2026-08-18 02:02:41 +08:00
FoXiMao	7e9d9065bb	feat(GOV-012): 实现 Schema 对象目录与视图排序	2026-08-18 01:54:50 +08:00
FoXiMao	54fd92837a	docs(GOV-012): 更新安全契约 GitNexus 基线	2026-08-18 01:49:16 +08:00
FoXiMao	8e954a3f5f	fix(GOV-012): 拒绝 MariaDB 伪装版本	2026-08-18 01:44:25 +08:00
FoXiMao	06466f388e	feat(GOV-012): 建立纯 Node 导出器安全契约	2026-08-18 01:21:29 +08:00
FoXiMao	235163cb61	chore(GOV-012): 忽略 SDD 过程账本	2026-08-18 01:11:41 +08:00
FoXiMao	cb2e22c13d	chore(GOV-012): 忽略本地功能工作区	2026-08-18 01:10:46 +08:00
FoXiMao	97535b8b3f	docs(GOV-012): 更新实施计划 GitNexus 基线	2026-08-18 01:08:00 +08:00
FoXiMao	190fba7a0b	docs(GOV-012): 完成纯 Node Schema 导出器实施计划	2026-08-18 01:07:14 +08:00
FoXiMao	0f81677b35	docs(GOV-012): 更新设计阶段 GitNexus 基线	2026-08-18 00:47:16 +08:00
FoXiMao	c605935403	docs(GOV-012): 确认纯 Node Schema 导出器设计	2026-08-18 00:46:03 +08:00
FoXiMao	3555b7c222	docs(FEAT-MO-001): 更新 TDX 接入后的 GitNexus 基线	2026-08-18 00:34:08 +08:00
FoXiMao	998c9276d5	docs(FEAT-MO-001): 记录 TDX 双场景开发接入	2026-08-18 00:32:04 +08:00
FoXiMao	c0a6f55605	docs(GOV-011): 更新最终 GitNexus 基线	2026-08-17 18:00:49 +08:00
FoXiMao	405b9858f0	docs(GOV-011): 回填 v0.0.9 发布追溯	2026-08-17 18:00:11 +08:00
FoXiMao	88e2fdffc8	chore(GOV-011): 发布 v0.0.9 系列版本约束	2026-08-17 17:58:02 +08:00
FoXiMao	7478a96bdc	docs(GOV-011): 完成系列版本验证与审查	2026-08-17 17:50:58 +08:00
FoXiMao	cce77aa884	docs(GOV-011): 统一运行时系列版本口径	2026-08-17 17:36:44 +08:00
FoXiMao	dc8da80809	fix(GOV-011): 支持 MySQL 5.7 系列健康检查	2026-08-17 17:31:10 +08:00
FoXiMao	54499f0678	fix(GOV-011): 放宽 MySQL 服务端为完整 5.7 系列	2026-08-17 17:28:48 +08:00
FoXiMao	c8277ef25a	test(GOV-011): 补充 Node 22 系列边界验证	2026-08-17 17:23:29 +08:00
FoXiMao	426870b704	docs(GOV-011): 制定运行时系列版本实施计划	2026-08-17 17:19:38 +08:00
FoXiMao	fcfef2d524	docs(GOV-011): 确认系列版本约束设计	2026-08-17 17:01:39 +08:00
FoXiMao	9e85809096	docs(GOV-009): 封存 GOV-009 与 GOV-010 架构基线	2026-08-17 16:27:37 +08:00
FoXiMao	4971077d3b	docs(FEAT-DS-001): 更新操作手册后的 GitNexus 基线	2026-08-17 12:25:56 +08:00
FoXiMao	81e5d331ca	docs(FEAT-DS-001): 新增 Tailscale TDX 开发操作手册	2026-08-17 12:25:13 +08:00
FoXiMao	4f5588ffcb	docs(FEAT-DS-001): 更新规划后的 GitNexus 基线	2026-08-14 03:06:07 +08:00
FoXiMao	551fe5e5e7	docs(FEAT-DS-001): 记录采集器后置与本地数据源方案	2026-08-14 03:05:23 +08:00
FoXiMao	a398bc418d	docs(GOV-010): 更新最终 GitNexus 基线	2026-08-14 00:01:15 +08:00
FoXiMao	38b731a334	docs(GOV-010): 完善最终验证追踪	2026-08-13 23:58:11 +08:00
FoXiMao	f178fb4044	feat(GOV-010): 完成开发质量与架构治理	2026-08-13 23:56:21 +08:00
FoXiMao	61f85e5fa4	docs(GOV-010): 记录开发需求与完成结果	2026-08-13 23:35:50 +08:00
FoXiMao	e992edccce	fix(GOV-010): 修复 Swagger 传递依赖漏洞	2026-08-13 23:32:46 +08:00
FoXiMao	d2c18634ed	feat(GOV-010): 建立前端 API 分域边界	2026-08-13 23:14:22 +08:00
FoXiMao	4105336cb2	refactor(GOV-010): 统一封装前端 Axios 请求	2026-08-13 23:02:36 +08:00
FoXiMao	3a22fdeef3	docs(GOV-010): 完善安全性能与架构规范	2026-08-13 22:54:32 +08:00
FoXiMao	e12c57222b	feat(GOV-010): 强制校验开发质量证据	2026-08-13 22:47:51 +08:00
FoXiMao	a8dcd0601b	docs(GOV-010): 制定开发质量治理实施计划	2026-08-13 22:37:35 +08:00
FoXiMao	1c1b15e709	docs(GOV-010): 确认开发质量与架构规范设计	2026-08-13 22:20:54 +08:00
FoXiMao	bbda26fa41	docs(GOV-009): 更新最终 GitNexus 索引统计	2026-08-13 21:35:45 +08:00
FoXiMao	c75665446b	fix(GOV-009): 完成仅源码部署最终复审	2026-08-13 21:33:38 +08:00
FoXiMao	47d0e0d248	refactor(GOV-009): 彻底切换为仅源码部署	2026-08-13 21:12:12 +08:00
FoXiMao	ab48f06150	docs(GOV-009): 制定仅源码部署实施计划	2026-08-13 20:55:31 +08:00
FoXiMao	cfcd7f13d9	docs(GOV-009): 确认仅源码部署设计	2026-08-13 20:46:58 +08:00
FoXiMao	f50268b70f	docs(GOV-009): 封存脚手架复核材料	2026-08-13 19:55:45 +08:00
FoXiMao	95b8611bd9	fix(GOV-009): 封堵外部脚本边界绕过	2026-08-13 19:49:42 +08:00
FoXiMao	cb550e3d5c	fix(GOV-009): 完成最终复审整改	2026-08-13 18:51:14 +08:00
FoXiMao	3a8120a33a	fix(GOV-009): 完成脚手架审查整改	2026-08-13 18:30:57 +08:00
FoXiMao	dcdf634457	fix(GOV-009): 消除前端运行时模板警告	2026-08-13 18:03:35 +08:00
FoXiMao	c771a98d4d	build(GOV-009): 对齐应用部署与运行入口	2026-08-13 17:56:37 +08:00
FoXiMao	4665336a63	feat(GOV-009): 建立前端 OpenAPI 客户端边界	2026-08-13 17:36:55 +08:00
FoXiMao	420aa22342	feat(GOV-009): 建立后端契约与健康检查	2026-08-13 17:26:51 +08:00
FoXiMao	3fc703de0b	feat(GOV-009): 建立 NestJS 三进程基线	2026-08-13 16:59:09 +08:00
FoXiMao	28d54186ad	feat(GOV-009): 建立 Vue 前端工程基线	2026-08-13 16:42:25 +08:00
FoXiMao	258a2d21f6	build(GOV-009): 建立 Node 与工作区基线	2026-08-13 15:54:07 +08:00
FoXiMao	b3d8e29f52	feat(GOV-009): 支持固定开发库结构基线	2026-08-13 15:43:06 +08:00
FoXiMao	c5a6e6a2c0	docs(GOV-009): 更新 GitNexus 图谱统计	2026-08-13 15:26:58 +08:00
FoXiMao	2e4cffeff1	docs(GOV-009): 细化应用脚手架实施计划	2026-08-13 15:25:38 +08:00
FoXiMao	c04184a611	docs(GOV-009): 明确应用脚手架设计边界	2026-08-13 15:07:36 +08:00
FoXiMao	19cc5f948d	docs(GOV-009): 封存 v0.0.7 开发库基线	2026-08-13 14:56:14 +08:00
		`@@ -0,0 +1,3 @@`
							`# GitNexus 前后对比`

							开发前基线已记录在 `before.md`。开发后 GitNexus 重新索引确认新增 AKTools Adapter、短线 Service、Controller、Web API、配置、页面和文档均落在计划范围；现有 TDX 市场概览执行流未被改写。`useMarketOverview` 的直接消费者为页面和测试，影响风险 LOW；未发现数据库、Redis、RocketMQ、Scheduler 或 Worker 新执行流。本轮健康检查修复前后对比增加连接级会话设置和 finally 释放，暂存区工具风险 MEDIUM 仅来自连接生命周期执行流，未形成新的跨模块业务依赖。
		`@@ -0,0 +1,3 @@`
							`# 发布说明`

							`本地开发 Web 端口从 5173 调整为 8888。API、TDX 隧道和生产配置不变。该功能尚未创建发布标签。`
		`@@ -0,0 +1,3 @@`
							`# GitNexus 前后对比`

							`开发前 README 使用旧的英文项目简介、5173 端口和不完整启动说明；开发后同步当前 8888、TDX 双隧道、首屏模块和治理入口。README 不参与业务执行流。`