fix(docs): propagate the fundamental zoo family + 0.1.11 counts to frontend, skills, and wiki

Post-release cross-audit findings: the 5th Alpha Zoo family never reached the frontend (AlphaZoo card grid missing fundamental, academic still 6, '4 zoos' i18n strings x5 locales), factors/__init__ docstring, or the asset-allocation skill ('4 optimizers'). Wiki: 29->30 presets, docs version selector bumped to 0.1.11 (labels only; content is unversioned). README x5: locale parity for the 07-04 UTC news entry, india_broker in the loaders tree comment (20 sources), ja/ko contributor headings translated.
2026-07-11 01:31:22 +08:00
parent 3a9e72f2f6
commit fa5e098143
14 changed files with 69 additions and 41 deletions
@@ -1235,7 +1235,7 @@ Vibe-Trading/
 │   │
 │   └── backtest/                   # Backtest engines
 │       ├── engines/                #   7 engines + composite cross-market engine + options_portfolio
-│       ├── loaders/                #   19 sources: tushare, okx, yfinance, akshare, baostock, tencent, mootdx, ccxt, futu, local, eastmoney, sina, stooq, yahoo, finnhub, alphavantage, tiingo, fmp, qveris
+│       ├── loaders/                #   20 sources: tushare, okx, yfinance, akshare, baostock, tencent, mootdx, ccxt, futu, local, eastmoney, sina, stooq, yahoo, finnhub, alphavantage, tiingo, fmp, qveris, india_broker
 │       │   ├── base.py             #   DataLoader Protocol
 │       │   └── registry.py         #   Registry + auto-fallback chains
 │       └── optimizers/             #   MVO, equal vol, max div, risk parity
@@ -69,6 +69,8 @@

 - **2026-07-04** 🧩 **شرائح API routes، ودليل صيني للمبتدئين، وحدود تبعيات أكثر أماناً**: انتقلت IM channel وSettings routes من `api_server.py` إلى `src/api/channels_routes.py` / `src/api/settings_routes.py` متابعةً لمسار [#331](https://github.com/HKUDS/Vibe-Trading/issues/331) الضيق للتقسيم المعياري ([#379](https://github.com/HKUDS/Vibe-Trading/pull/379)، [#382](https://github.com/HKUDS/Vibe-Trading/pull/382)، شكراً @shadowinlife). أضيف إلى Wiki دليل صيني للمبتدئين غير المتخصصين في المالية ([#393](https://github.com/HKUDS/Vibe-Trading/pull/393)، شكراً @kadaliao)، وتحدّثت حدود Pillow / LangChain / LangGraph إلى مسار patched قابل للتثبيت ([#390](https://github.com/HKUDS/Vibe-Trading/pull/390)، شكراً @aeonframework).

+- **2026-07-04** 🧹 **تنظيف طوابع UTC الزمنية لمسارات الجلسات وAPI**: تم إحكام إصلاح الطوابع الزمنية #395 بحيث تُصدر طوابع session وgoal وchannel وAPI قيم UTC واعية بالمنطقة الزمنية بصيغة ISO صريحة.
+
 - **2026-07-03** 🛡️ **Robinhood MCP refresh + API modularization + SSRF guard**: يستخدم Robinhood Agentic Trading الآن أسماء MCP الحالية عبر generic reads وlive-runner plumbing وdefault read-only seeds واختبارات mandate-gate، كما يحترم interactive startup ترتيب البحث نفسه عن `.env` الذي يستخدمه provider loader (`~/.vibe-trading/.env` → `agent/.env` → `$CWD/.env`) ([#391](https://github.com/HKUDS/Vibe-Trading/pull/391)، يغلق [#381](https://github.com/HKUDS/Vibe-Trading/issues/381) و[#380](https://github.com/HKUDS/Vibe-Trading/issues/380)). انتقلت System routes (`/health` و`/correlation` و`/system/shutdown` و`/skills` و`/api`) إلى `src/api/system_routes.py` كـ narrow API modularization slice تالية ([#378](https://github.com/HKUDS/Vibe-Trading/pull/378)، شكراً @shadowinlife). ترفض channel media SSRF defenses الآن أهداف CGNAT/mesh/non-global وQQ media redirect-to-internal قبل fetch ([#389](https://github.com/HKUDS/Vibe-Trading/pull/389)، شكراً @hobostay).

 - **2026-07-02** ⚡ **Factor acceleration + safer runtime boundaries**: تستخدم مسارات rolling factor الساخنة الآن fast paths عبر `bottleneck`/NumPy، وتتجنب موازاة alpha bench تمرير panel payload ضخم لكل worker مراراً، وأضيفت regression coverage لحسابات base equity ([#376](https://github.com/HKUDS/Vibe-Trading/pull/376)، يغلق [#339](https://github.com/HKUDS/Vibe-Trading/issues/339)، والعمل الأصلي من [#342](https://github.com/HKUDS/Vibe-Trading/pull/342) بواسطة @shadowinlife). نُقلت Upload وShadow report routes من `api_server.py` الضخم كأول slice ضيق من API modularization، مع إبقاء [#331](https://github.com/HKUDS/Vibe-Trading/issues/331) مفتوحاً ([#375](https://github.com/HKUDS/Vibe-Trading/pull/375)، مبني على [#358](https://github.com/HKUDS/Vibe-Trading/pull/358)، شكراً @shadowinlife). ترث عمليات generated backtest الفرعية الآن بيئة allowlist فقط بدلاً من parent secrets surface الكامل ([#374](https://github.com/HKUDS/Vibe-Trading/pull/374)، يغلق [#332](https://github.com/HKUDS/Vibe-Trading/issues/332))، وحصلت IM channels على `/new` session reset وأوامر pairing غير حساسة لحالة الأحرف ([#372](https://github.com/HKUDS/Vibe-Trading/pull/372)، يغلق [#371](https://github.com/HKUDS/Vibe-Trading/issues/371)، شكراً @shadowinlife).
@@ -1031,7 +1033,7 @@ Vibe-Trading/
 │   │
 │   └── backtest/                   # Backtest engines
 │       ├── engines/                #   7 engines + composite cross-market engine + options_portfolio
-│       ├── loaders/                #   19 sources: tushare, okx, yfinance, akshare, baostock, tencent, mootdx, ccxt, futu, local, eastmoney, sina, stooq, yahoo, finnhub, alphavantage, tiingo, fmp, qveris
+│       ├── loaders/                #   20 sources: tushare, okx, yfinance, akshare, baostock, tencent, mootdx, ccxt, futu, local, eastmoney, sina, stooq, yahoo, finnhub, alphavantage, tiingo, fmp, qveris, india_broker
 │       │   ├── base.py             #   DataLoader Protocol
 │       │   └── registry.py         #   Registry + auto-fallback chains
 │       └── optimizers/             #   MVO, equal vol, max div, risk parity
@@ -69,6 +69,8 @@

 - **2026-07-04** 🧩 **API route slices, Chinese tutorial docs, and safer dependency floors**：IM channel と Settings routes は `api_server.py` から `src/api/channels_routes.py` / `src/api/settings_routes.py` に移り、[#331](https://github.com/HKUDS/Vibe-Trading/issues/331) の狭い modularization path を継続します（[#379](https://github.com/HKUDS/Vibe-Trading/pull/379)、[#382](https://github.com/HKUDS/Vibe-Trading/pull/382)、@shadowinlife さんに感謝）。Wiki には非金融読者向けの中国語入門チュートリアルが加わり（[#393](https://github.com/HKUDS/Vibe-Trading/pull/393)、@kadaliao さんに感謝）、Pillow / LangChain / LangGraph の dependency floors も installable な patched track に更新されました（[#390](https://github.com/HKUDS/Vibe-Trading/pull/390)、@aeonframework さんに感謝）。

+- **2026-07-04** 🧹 **セッション/API パスの UTC タイムスタンプ整理**：#395 のタイムスタンプ修正を強化し、session・goal・channel・API のタイムスタンプが明示的な ISO 形式のタイムゾーン付き UTC 値を出力するようになりました。
+
 - **2026-07-03** 🛡️ **Robinhood MCP refresh + API modularization + SSRF guard**：Robinhood Agentic Trading は generic reads、live-runner plumbing、default read-only seeds、mandate-gate tests のすべてで現在の MCP tool names を使うようになり、interactive startup も provider loader と同じ `.env` 探索順（`~/.vibe-trading/.env` → `agent/.env` → `$CWD/.env`）を尊重します（[#391](https://github.com/HKUDS/Vibe-Trading/pull/391)、[#381](https://github.com/HKUDS/Vibe-Trading/issues/381) と [#380](https://github.com/HKUDS/Vibe-Trading/issues/380) をクローズ）。System routes（`/health`、`/correlation`、`/system/shutdown`、`/skills`、`/api`）は次の狭い API modularization slice として `src/api/system_routes.py` に移りました（[#378](https://github.com/HKUDS/Vibe-Trading/pull/378)、@shadowinlife さんに感謝）。Channel media SSRF defenses は fetch 前に CGNAT/mesh/non-global targets と QQ media redirect-to-internal を拒否するようになりました（[#389](https://github.com/HKUDS/Vibe-Trading/pull/389)、@hobostay さんに感謝）。

 - **2026-07-02** ⚡ **Factor acceleration + safer runtime boundaries**：rolling factor のホットパスは `bottleneck`/NumPy fast path を使うようになり、alpha bench の process parallelism は巨大 panel payload を worker ごとに繰り返し渡さず、base equity 計算にも regression coverage が入りました（[#376](https://github.com/HKUDS/Vibe-Trading/pull/376)、[#339](https://github.com/HKUDS/Vibe-Trading/issues/339) をクローズ、元の実装は @shadowinlife さんの [#342](https://github.com/HKUDS/Vibe-Trading/pull/342)）。Upload と Shadow report routes は巨大な `api_server.py` から切り出され、API modularization の最初の狭い slice になりました。[#331](https://github.com/HKUDS/Vibe-Trading/issues/331) は引き続き open です（[#375](https://github.com/HKUDS/Vibe-Trading/pull/375)、[#358](https://github.com/HKUDS/Vibe-Trading/pull/358) ベース、@shadowinlife さんに感謝）。Generated backtest subprocess は parent secrets surface 全体ではなく allowlist された環境だけを継承するようになり（[#374](https://github.com/HKUDS/Vibe-Trading/pull/374)、[#332](https://github.com/HKUDS/Vibe-Trading/issues/332) をクローズ）、IM channels には `/new` session reset と case-insensitive pairing commands も入りました（[#372](https://github.com/HKUDS/Vibe-Trading/pull/372)、[#371](https://github.com/HKUDS/Vibe-Trading/issues/371) をクローズ、@shadowinlife さんに感謝）。
@@ -1028,7 +1030,7 @@ Vibe-Trading/
 │   │
 │   └── backtest/                   # バックテストエンジン
 │       ├── engines/                #   7 エンジン + クロスマーケット composite engine + options_portfolio
-│       ├── loaders/                #   19 ソース: tushare、okx、yfinance、akshare、baostock、tencent、mootdx、ccxt、futu、local、eastmoney、sina、stooq、yahoo、finnhub、alphavantage、tiingo、fmp、qveris
+│       ├── loaders/                #   20 ソース: tushare、okx、yfinance、akshare、baostock、tencent、mootdx、ccxt、futu、local、eastmoney、sina、stooq、yahoo、finnhub、alphavantage、tiingo、fmp、qveris、india_broker
 │       │   ├── base.py             #   DataLoader Protocol
 │       │   └── registry.py         #   Registry + 自動フォールバックチェーン
 │       └── optimizers/             #   MVO、equal vol、max div、risk parity
@@ -1114,7 +1116,7 @@ Contributions を歓迎します。ガイドラインは [CONTRIBUTING.md](CONTR

 Vibe-Trading に貢献してくださった皆さまに感謝します。

-最近の v0.1.11 cycle contributors and credits:
+最近の v0.1.11 サイクルの貢献者とクレジット：

 - @shadowinlife — the `api_server` modularization capstone (1,103 → 371 lines, #424 closing #331), centralized env config with the AST CI gate (#440), loader `fetch()` protocol conformance (#437), and the Strategy Development Manager RFC in review (#455/#457) — 12 merged PRs this cycle
 - @Robin1987China — Research Autopilot Phase 3 loop closure (#267), 4 canonical academic alphas (#277), Shadow Account PIT-safe entry conditions (#302/#314/#316), the turnover-aware portfolio optimizer (#466), scheduled-research route tests (#452), and test-coverage batches for trade-journal / pattern / loader layers (#268/#269/#276)
@@ -1149,7 +1151,7 @@ Vibe-Trading に貢献してくださった皆さまに感謝します。
 - @warren618 / Haozhe Wu — the fundamental factor layer (PIT-safe SEC panels), the QVeris premium track, the IM channel runtime, India-equity integration review, CN search fallbacks, and release integration

 <details>
-<summary>v0.1.10 cycle contributors</summary>
+<summary>v0.1.10 サイクルの貢献者</summary>

 - @Hinotoi-agent — a security-hardening wave: local-shutdown auth (#241), loopback-host rebinding rejection (#242), agent shell-tool opt-in (#243), settings-write auth (#245), mandate proposal-id containment (#256), persistent-memory type validation (#257), and MCP swarm run-id containment (#258)
 - @mvanhorn — the opt-in local data cache (#177), Gemini thoughtSignature round-trip over OpenAI-compat tool calls (#176), the custom data loader guide (#194), and the glm/zhipu provider alias + model-name inference (#247)
@@ -69,6 +69,8 @@

 - **2026-07-04** 🧩 **API route slices, 중국어 입문 튜토리얼, 안전한 dependency floors**: IM channel 및 Settings routes가 `api_server.py`에서 `src/api/channels_routes.py` / `src/api/settings_routes.py`로 이동해 [#331](https://github.com/HKUDS/Vibe-Trading/issues/331)의 좁은 modularization path를 이어갑니다([#379](https://github.com/HKUDS/Vibe-Trading/pull/379), [#382](https://github.com/HKUDS/Vibe-Trading/pull/382), @shadowinlife 님 감사합니다). Wiki에는 비금융 독자를 위한 중국어 입문 튜토리얼이 추가됐고([#393](https://github.com/HKUDS/Vibe-Trading/pull/393), @kadaliao 님 감사합니다), Pillow / LangChain / LangGraph dependency floors도 설치 가능한 patched track으로 업데이트됐습니다([#390](https://github.com/HKUDS/Vibe-Trading/pull/390), @aeonframework 님 감사합니다).

+- **2026-07-04** 🧹 **세션·API 경로의 UTC 타임스탬프 정리**: #395 타임스탬프 수정을 보강해 session, goal, channel, API 타임스탬프가 명시적 ISO 형식의 타임존 인지 UTC 값을 출력합니다.
+
 - **2026-07-03** 🛡️ **Robinhood MCP refresh + API modularization + SSRF guard**: Robinhood Agentic Trading은 이제 generic reads, live-runner plumbing, default read-only seeds, mandate-gate tests 전반에서 현재 MCP tool names를 사용합니다. Interactive startup도 provider loader와 같은 `.env` 검색 순서(`~/.vibe-trading/.env` → `agent/.env` → `$CWD/.env`)를 따릅니다([#391](https://github.com/HKUDS/Vibe-Trading/pull/391), [#381](https://github.com/HKUDS/Vibe-Trading/issues/381) 및 [#380](https://github.com/HKUDS/Vibe-Trading/issues/380) 닫힘). System routes(`/health`, `/correlation`, `/system/shutdown`, `/skills`, `/api`)는 다음 API modularization narrow slice로 `src/api/system_routes.py`에 이동했습니다([#378](https://github.com/HKUDS/Vibe-Trading/pull/378), @shadowinlife 님 감사합니다). Channel media SSRF defenses는 fetch 전에 CGNAT/mesh/non-global targets와 QQ media redirect-to-internal을 거부합니다([#389](https://github.com/HKUDS/Vibe-Trading/pull/389), @hobostay 님 감사합니다).

 - **2026-07-02** ⚡ **Factor acceleration + safer runtime boundaries**: rolling factor 핫패스가 `bottleneck`/NumPy fast path 를 사용하고, alpha bench 병렬 실행은 큰 panel payload 를 worker마다 반복 전달하지 않으며, base equity 계산에는 regression coverage 가 추가되었습니다([#376](https://github.com/HKUDS/Vibe-Trading/pull/376), [#339](https://github.com/HKUDS/Vibe-Trading/issues/339) 닫힘, 원 작업은 @shadowinlife 님의 [#342](https://github.com/HKUDS/Vibe-Trading/pull/342)). Upload 및 Shadow report routes 는 거대한 `api_server.py` 에서 분리되어 API modularization 의 첫 번째 좁은 slice 로 들어갔고, [#331](https://github.com/HKUDS/Vibe-Trading/issues/331) 은 계속 open 상태입니다([#375](https://github.com/HKUDS/Vibe-Trading/pull/375), [#358](https://github.com/HKUDS/Vibe-Trading/pull/358) 기반, @shadowinlife 님 감사합니다). Generated backtest subprocess 는 이제 parent secrets surface 전체가 아니라 allowlist 된 환경만 상속합니다([#374](https://github.com/HKUDS/Vibe-Trading/pull/374), [#332](https://github.com/HKUDS/Vibe-Trading/issues/332) 닫힘). IM channels 에는 `/new` session reset 과 대소문자 구분 없는 pairing commands 도 추가되었습니다([#372](https://github.com/HKUDS/Vibe-Trading/pull/372), [#371](https://github.com/HKUDS/Vibe-Trading/issues/371) 닫힘, @shadowinlife 님 감사합니다).
@@ -1031,7 +1033,7 @@ Vibe-Trading/
 │   │
 │   └── backtest/                   # Backtest engines
 │       ├── engines/                #   7 engines + composite cross-market engine + options_portfolio
-│       ├── loaders/                #   19 sources: tushare, okx, yfinance, akshare, baostock, tencent, mootdx, ccxt, futu, local, eastmoney, sina, stooq, yahoo, finnhub, alphavantage, tiingo, fmp, qveris
+│       ├── loaders/                #   20 sources: tushare, okx, yfinance, akshare, baostock, tencent, mootdx, ccxt, futu, local, eastmoney, sina, stooq, yahoo, finnhub, alphavantage, tiingo, fmp, qveris, india_broker
 │       │   ├── base.py             #   DataLoader Protocol
 │       │   └── registry.py         #   Registry + auto-fallback chains
 │       └── optimizers/             #   MVO, equal vol, max div, risk parity
@@ -1117,7 +1119,7 @@ Vibe-Trading은 **[HKUDS](https://github.com/HKUDS)** agent ecosystem의 일부

 Vibe-Trading에 기여해 주신 모든 분께 감사드립니다!

-최근 v0.1.11 cycle contributors and credits:
+최근 v0.1.11 사이클 기여자 및 크레딧:

 - @shadowinlife — the `api_server` modularization capstone (1,103 → 371 lines, #424 closing #331), centralized env config with the AST CI gate (#440), loader `fetch()` protocol conformance (#437), and the Strategy Development Manager RFC in review (#455/#457) — 12 merged PRs this cycle
 - @Robin1987China — Research Autopilot Phase 3 loop closure (#267), 4 canonical academic alphas (#277), Shadow Account PIT-safe entry conditions (#302/#314/#316), the turnover-aware portfolio optimizer (#466), scheduled-research route tests (#452), and test-coverage batches for trade-journal / pattern / loader layers (#268/#269/#276)
@@ -1152,7 +1154,7 @@ Vibe-Trading에 기여해 주신 모든 분께 감사드립니다!
 - @warren618 / Haozhe Wu — the fundamental factor layer (PIT-safe SEC panels), the QVeris premium track, the IM channel runtime, India-equity integration review, CN search fallbacks, and release integration

 <details>
-<summary>v0.1.10 cycle contributors</summary>
+<summary>v0.1.10 사이클 기여자</summary>

 - @Hinotoi-agent — a security-hardening wave: local-shutdown auth (#241), loopback-host rebinding rejection (#242), agent shell-tool opt-in (#243), settings-write auth (#245), mandate proposal-id containment (#256), persistent-memory type validation (#257), and MCP swarm run-id containment (#258)
 - @mvanhorn — the opt-in local data cache (#177), Gemini thoughtSignature round-trip over OpenAI-compat tool calls (#176), the custom data loader guide (#194), and the glm/zhipu provider alias + model-name inference (#247)
@@ -69,6 +69,8 @@

 - **2026-07-04** 🧩 **API 路由继续拆分、中文入门教程与依赖安全线**：IM channel 与 Settings routes 已从 `api_server.py` 迁入 `src/api/channels_routes.py` / `src/api/settings_routes.py`，延续 [#331](https://github.com/HKUDS/Vibe-Trading/issues/331) 的窄切片模块化路径（来自 [#379](https://github.com/HKUDS/Vibe-Trading/pull/379)、[#382](https://github.com/HKUDS/Vibe-Trading/pull/382)，感谢 @shadowinlife）。Wiki 新增面向非金融读者的中文入门教程（[#393](https://github.com/HKUDS/Vibe-Trading/pull/393)，感谢 @kadaliao）；Pillow / LangChain / LangGraph 依赖下限也更新到可安装的安全轨道（[#390](https://github.com/HKUDS/Vibe-Trading/pull/390)，感谢 @aeonframework）。

+- **2026-07-04** 🧹 **会话与 API 路径的 UTC 时间戳清理**：收紧 #395 的时间戳修复——session、goal、channel 与 API 时间戳现在统一输出显式 ISO 格式的时区感知 UTC 值。
+
 - **2026-07-03** 🛡️ **Robinhood MCP 刷新 + API 模块化 + SSRF 防护**：Robinhood Agentic Trading 现在在通用读取、live runner、默认只读 seed 和 mandate-gate 测试中统一使用当前 MCP 工具名；交互式启动也会按 provider loader 的同一顺序识别 `.env`：`~/.vibe-trading/.env` → `agent/.env` → `$CWD/.env`（[#391](https://github.com/HKUDS/Vibe-Trading/pull/391)，关闭 [#381](https://github.com/HKUDS/Vibe-Trading/issues/381) 和 [#380](https://github.com/HKUDS/Vibe-Trading/issues/380)）。System routes（`/health`、`/correlation`、`/system/shutdown`、`/skills`、`/api`）作为下一段 API 模块化窄切片迁入 `src/api/system_routes.py`（[#378](https://github.com/HKUDS/Vibe-Trading/pull/378)，感谢 @shadowinlife）。通道媒体 SSRF 防护现在会在 fetch 前拒绝 CGNAT/mesh/non-global 目标和 QQ media redirect-to-internal（[#389](https://github.com/HKUDS/Vibe-Trading/pull/389)，感谢 @hobostay）。

 - **2026-07-02** ⚡ **因子加速 + 更稳的运行边界**：滚动因子热路径现在使用 `bottleneck`/NumPy 快路径，alpha bench 的进程并行避免反复传输大面板数据，base equity 计算也补上回归覆盖（[#376](https://github.com/HKUDS/Vibe-Trading/pull/376)，关闭 [#339](https://github.com/HKUDS/Vibe-Trading/issues/339)，原始工作来自 @shadowinlife 的 [#342](https://github.com/HKUDS/Vibe-Trading/pull/342)）。上传与 Shadow report 路由已从巨大的 `api_server.py` 中拆出，作为 API 模块化的第一刀，同时 [#331](https://github.com/HKUDS/Vibe-Trading/issues/331) 继续保持 open（[#375](https://github.com/HKUDS/Vibe-Trading/pull/375)，基于 [#358](https://github.com/HKUDS/Vibe-Trading/pull/358)，感谢 @shadowinlife）。生成式回测子进程现在只继承 allowlist 环境变量，不再暴露完整父进程 secret surface（[#374](https://github.com/HKUDS/Vibe-Trading/pull/374)，关闭 [#332](https://github.com/HKUDS/Vibe-Trading/issues/332)）；IM 通道也新增 `/new` 会话重置，并让 pairing 命令大小写不敏感（[#372](https://github.com/HKUDS/Vibe-Trading/pull/372)，关闭 [#371](https://github.com/HKUDS/Vibe-Trading/issues/371)，感谢 @shadowinlife）。
@@ -1025,7 +1027,7 @@ Vibe-Trading/
 │   │
 │   └── backtest/                   # 回测引擎
 │       ├── engines/                #   7 个引擎 + 跨市场 composite 引擎 + options_portfolio
-│       ├── loaders/                #   19 个数据源：tushare、okx、yfinance、akshare、baostock、tencent、mootdx、ccxt、futu、local、eastmoney、sina、stooq、yahoo、finnhub、alphavantage、tiingo、fmp、qveris
+│       ├── loaders/                #   20 个数据源：tushare、okx、yfinance、akshare、baostock、tencent、mootdx、ccxt、futu、local、eastmoney、sina、stooq、yahoo、finnhub、alphavantage、tiingo、fmp、qveris、india_broker
 │       │   ├── base.py             #   DataLoader Protocol
 │       │   └── registry.py         #   Registry + 自动 fallback 链路
 │       └── optimizers/             #   MVO、equal vol、max div、risk parity
@@ -1,4 +1,4 @@
-"""Alpha Zoo: 4 zoos (alpha101 / gtja191 / qlib158 / academic) × ~450 alphas.
+"""Alpha Zoo: 5 zoos (alpha101 / gtja191 / qlib158 / academic / fundamental) × 460 alphas.

 See `docs/alpha-zoo/spec.md` for the panel format contract and operator semantics.
 """
@@ -1,6 +1,6 @@
 ---
 name: asset-allocation
-description: Asset allocation theory and optimizer usage — MPT / Black-Litterman / risk budgeting / all-weather strategy, including guides for 4 optimizers and rebalancing rules.
+description: Asset allocation theory and optimizer usage — MPT / Black-Litterman / risk budgeting / all-weather strategy, including guides for 5 optimizers and rebalancing rules.
 category: asset-class
 ---

@@ -86,7 +86,7 @@ Simplified allocation example for China-focused portfolios:
 - 15% commodities / REITs
 ```

-## Guide to the 4 Optimizers
+## Guide to the 5 Optimizers

 ### Overview of the Built-In Optimizers

@@ -495,9 +495,9 @@
  },
  "alphaZoo": {
    "title": "Alpha Zoo",
-    "prebuiltAlpha": "{{count}} ألفا كمي مُعدّ مسبقًا عبر 4 مكتبات عوامل",
-    "prebuiltAlphaLoading": "ألفا كمي مُعدّ مسبقًا عبر 4 مكتبات عوامل",
-    "browseDesc": "تصفّح الإشارات العرضية المعتمدة على الصيغ من Qlib ومجموعة Kakushadze 101 وGTJA 191 وأدبيات الشذوذ الأكاديمي. انقر على أي ألفا لقراءة صيغتها وشفرتها المصدرية، أو نفّذ قياسًا لتسجيل مكتبة العوامل بأكملها على'universe وفترة محددة.",
+    "prebuiltAlpha": "{{count}} ألفا كمي مُعدّ مسبقًا عبر 5 مكتبات عوامل",
+    "prebuiltAlphaLoading": "ألفا كمي مُعدّ مسبقًا عبر 5 مكتبات عوامل",
+    "browseDesc": "تصفّح الإشارات العرضية المعتمدة على الصيغ من Qlib ومجموعة Kakushadze 101 وGTJA 191 وأدبيات الشذوذ الأكاديمي والعوامل الأساسية الآمنة PIT. انقر على أي ألفا لقراءة صيغتها وشفرتها المصدرية، أو نفّذ قياسًا لتسجيل مكتبة العوامل بأكملها على'universe وفترة محددة.",
    "search": "بحث",
    "searchPlaceholder": "تصفية حسب المعرّف أو الاسم المستعار…",
    "zoo": "مكتبة العوامل",
@@ -579,13 +579,15 @@
      "qlib158": "Qlib 158",
      "alpha101": "Kakushadze 101 ألفا صيغية",
      "gtja191": "GTJA 191",
-      "academic": "الشذوذات الأكاديمية"
+      "academic": "الشذوذات الأكاديمية",
+      "fundamental": "أساسيات آمنة PIT"
    },
    "zooCardDesc": {
      "qlib158": "مكتبة Microsoft Qlib الكاملة ذات 158 ميزة تغطي الزخم والتذبذب والحجم والإشارات الإحصائية المتحركة.",
      "alpha101": "101 إشارة ألفا صيغية من Kakushadze (2015)؛ إشارات عرضية قصيرة المدى.",
      "gtja191": "191 ألفا من Guotai Junan Securities؛ إشارات فنية وبنية مجهرية مضبوطة لأسواق الأسهم الصينية A.",
-      "academic": "شذوذات طويلة المدى منسقة من الأدبيات الأكاديمية (القيمة، الزخم، الجودة، التذبذب المنخفض، إلخ)."
+      "academic": "شذوذات طويلة المدى منسقة من الأدبيات الأكاديمية (القيمة، الزخم، الجودة، التذبذب المنخفض، إلخ).",
+      "fundamental": "عوامل الجودة والقيمة محسوبة من بيانات SEC company facts الآمنة PIT — earnings yield وROE وgross profitability وasset growth (مثبّتة على filed-date)."
    },
    "universeOption": {
      "csi300": "CSI 300 (الصين A)",
@@ -500,9 +500,9 @@
  },
  "alphaZoo": {
    "title": "Alpha Zoo",
-    "prebuiltAlpha": "{{count}} pre-built quant alphas across 4 zoos",
-    "prebuiltAlphaLoading": "Pre-built quant alphas across 4 zoos",
-    "browseDesc": "Browse formula-driven cross-sectional signals from Qlib, the Kakushadze 101 set, GTJA 191, and the academic anomaly literature. Click any alpha to read its formula and source code, or run a bench to score the whole zoo on a universe and period.",
+    "prebuiltAlpha": "{{count}} pre-built quant alphas across 5 families",
+    "prebuiltAlphaLoading": "Pre-built quant alphas across 5 families",
+    "browseDesc": "Browse formula-driven cross-sectional signals from Qlib, the Kakushadze 101 set, GTJA 191, the academic anomaly literature, and PIT-safe fundamentals. Click any alpha to read its formula and source code, or run a bench to score the whole zoo on a universe and period.",
    "search": "Search",
    "searchPlaceholder": "Filter by id or nickname…",
    "zoo": "Zoo",
@@ -584,13 +584,15 @@
      "qlib158": "Qlib 158",
      "alpha101": "Kakushadze 101 Formulaic Alphas",
      "gtja191": "GTJA 191",
-      "academic": "Academic Anomalies"
+      "academic": "Academic Anomalies",
+      "fundamental": "PIT-Safe Fundamentals"
    },
    "zooCardDesc": {
      "qlib158": "Microsoft Qlib's full 158-feature library covering momentum, volatility, volume and rolling statistical signals.",
      "alpha101": "The 101 formulaic alphas from Kakushadze (2015); short-horizon cross-sectional signals.",
      "gtja191": "Guotai Junan Securities' 191 alphas; technical and microstructure signals tuned to China A-share markets.",
-      "academic": "Curated long-horizon anomalies from the academic literature (value, momentum, quality, low-vol, etc.)."
+      "academic": "Curated long-horizon anomalies from the academic literature (value, momentum, quality, low-vol, etc.).",
+      "fundamental": "Quality and value factors computed from PIT-safe SEC company facts — earnings yield, ROE, gross profitability, asset growth (filed-date anchored)."
    },
    "universeOption": {
      "csi300": "CSI 300 (China A)",
@@ -495,9 +495,9 @@
  },
  "alphaZoo": {
    "title": "Alpha Zoo",
-    "prebuiltAlpha": "4 つの Zoo にまたがる {{count}} 個の事前構築クォント Alpha",
-    "prebuiltAlphaLoading": "4 つの Zoo にまたがる事前構築クォント Alpha",
-    "browseDesc": "Qlib、Kakushadze 101、GTJA 191、および学術的アノマリー文献から、フォーミュラ駆動のクロスセクションシグナルを参照できます。任意の Alpha をクリックして式とソースコードを読むか、ベンチを実行して特定のユニバースと期間で Zoo 全体をスコアリングできます。",
+    "prebuiltAlpha": "5 つの Zoo にまたがる {{count}} 個の事前構築クォント Alpha",
+    "prebuiltAlphaLoading": "5 つの Zoo にまたがる事前構築クォント Alpha",
+    "browseDesc": "Qlib、Kakushadze 101、GTJA 191、学術的アノマリー文献、および PIT セーフなファンダメンタルズから、フォーミュラ駆動のクロスセクションシグナルを参照できます。任意の Alpha をクリックして式とソースコードを読むか、ベンチを実行して特定のユニバースと期間で Zoo 全体をスコアリングできます。",
    "search": "検索",
    "searchPlaceholder": "ID またはニックネームで絞り込み…",
    "zoo": "Zoo",
@@ -579,13 +579,15 @@
      "qlib158": "Qlib 158",
      "alpha101": "Kakushadze 101 定式 Alpha",
      "gtja191": "GTJA 191",
-      "academic": "学術的アノマリー"
+      "academic": "学術的アノマリー",
+      "fundamental": "ファンダメンタル（PIT セーフ）"
    },
    "zooCardDesc": {
      "qlib158": "Microsoft Qlib の全 158 特徴ライブラリ。モメンタム、ボラティリティ、出来高、ローリング統計シグナルをカバー。",
      "alpha101": "Kakushadze (2015) の 101 個の定式 alpha シグナル。短期ホライゾンのクロスセクションシグナル。",
      "gtja191": "国泰君安証券の 191 個の Alpha。中国 A 株市場向けにチューニングされたテクニカルおよびマイクロストラクチャーシグナル。",
-      "academic": "学術文献からの長期ホライズンアノマリーのキュレーション (バリュー、モメンタム、クオリティ、低ボラティリティなど)。"
+      "academic": "学術文献からの長期ホライズンアノマリーのキュレーション (バリュー、モメンタム、クオリティ、低ボラティリティなど)。",
+      "fundamental": "PIT セーフな SEC company facts から算出される品質・バリュー系ファクター — earnings yield、ROE、gross profitability、asset growth（filed-date 基準）。"
    },
    "universeOption": {
      "csi300": "CSI 300 (中国 A 株)",
@@ -495,9 +495,9 @@
  },
  "alphaZoo": {
    "title": "Alpha Zoo",
-    "prebuiltAlpha": "4개 Zoo에 걸친 {{count}}개의 사전 구축 퀀트 Alpha",
-    "prebuiltAlphaLoading": "4개 Zoo에 걸친 사전 구축 퀀트 Alpha",
-    "browseDesc": "Qlib, Kakushadze 101, GTJA 191 및 학술 이상 현상 문헌에서 포뮬러 기반의 횡단면 시그널을 살펴보세요. Alpha를 클릭하여 공식과 소스 코드를 확인하거나, 벤치를 실행하여 특정 유니버스와 기간에 대해 Zoo 전체를 스코어링할 수 있습니다.",
+    "prebuiltAlpha": "5개 Zoo에 걸친 {{count}}개의 사전 구축 퀀트 Alpha",
+    "prebuiltAlphaLoading": "5개 Zoo에 걸친 사전 구축 퀀트 Alpha",
+    "browseDesc": "Qlib, Kakushadze 101, GTJA 191, 학술 이상 현상 문헌 및 PIT-safe 펀더멘털에서 포뮬러 기반의 횡단면 시그널을 살펴보세요. Alpha를 클릭하여 공식과 소스 코드를 확인하거나, 벤치를 실행하여 특정 유니버스와 기간에 대해 Zoo 전체를 스코어링할 수 있습니다.",
    "search": "검색",
    "searchPlaceholder": "ID 또는 별명으로 필터…",
    "zoo": "Zoo",
@@ -579,13 +579,15 @@
      "qlib158": "Qlib 158",
      "alpha101": "Kakushadze 101 공식 Alpha",
      "gtja191": "GTJA 191",
-      "academic": "학술 이상 현상"
+      "academic": "학술 이상 현상",
+      "fundamental": "펀더멘털 (PIT-safe)"
    },
    "zooCardDesc": {
      "qlib158": "Microsoft Qlib의 전체 158개 피처 라이브러리. 모멘텀, 변동성, 거래량 및 롤링 통계 시그널을 포함합니다.",
      "alpha101": "Kakushadze(2015)의 101개 공식 alpha 시그널. 단기 횡단면 시그널.",
      "gtja191": "궈타이쥔안증권의 191개 Alpha. 중국 A주 시장에 최적화된 기술적 및 마이크로스트럭처 시그널.",
-      "academic": "학술 문헌에서 선별된 장기 이상 현상(가치, 모멘텀, 품질, 저변동성 등)."
+      "academic": "학술 문헌에서 선별된 장기 이상 현상(가치, 모멘텀, 품질, 저변동성 등).",
+      "fundamental": "PIT-safe SEC company facts로 계산되는 퀄리티·밸류 팩터 — earnings yield, ROE, gross profitability, asset growth (filed-date 기준)."
    },
    "universeOption": {
      "csi300": "CSI 300 (중국 A주)",
@@ -495,9 +495,9 @@
  },
  "alphaZoo": {
    "title": "Alpha 因子库",
-    "prebuiltAlpha": "{{count}} 个预构建量化 Alpha，覆盖 4 个因子库",
-    "prebuiltAlphaLoading": "预构建量化 Alpha，覆盖 4 个因子库",
-    "browseDesc": "浏览来自 Qlib、Kakushadze 101 公式集、GTJA 191 以及学术异象文献的公式驱动截面信号。点击任意 Alpha 查看公式和源码，或运行基准测试在特定市场和时间段上评分整个因子库。",
+    "prebuiltAlpha": "{{count}} 个预构建量化 Alpha，覆盖 5 个因子库",
+    "prebuiltAlphaLoading": "预构建量化 Alpha，覆盖 5 个因子库",
+    "browseDesc": "浏览来自 Qlib、Kakushadze 101 公式集、GTJA 191、学术异象文献以及 PIT 安全基本面因子的公式驱动截面信号。点击任意 Alpha 查看公式和源码，或运行基准测试在特定市场和时间段上评分整个因子库。",
    "search": "搜索",
    "searchPlaceholder": "按 ID 或昵称筛选…",
    "zoo": "因子库",
@@ -579,13 +579,15 @@
      "qlib158": "Qlib 158",
      "alpha101": "Kakushadze 101 公式化 Alpha",
      "gtja191": "国泰君安 191",
-      "academic": "学术文献异象因子"
+      "academic": "学术文献异象因子",
+      "fundamental": "基本面因子（PIT 安全）"
    },
    "zooCardDesc": {
      "qlib158": "微软 Qlib 完整的 158 特征库，涵盖动量、波动率、成交量及滚动统计信号。",
      "alpha101": "来自 Kakushadze（2015）的 101 个公式化 Alpha 信号；短周期截面信号。",
      "gtja191": "国泰君安证券的 191 个 Alpha；专门针对中国 A 股市场优化的技术面与微观结构信号。",
-      "academic": "来自学术文献的长期异象因子精选（价值、动量、质量、低波动率等）。"
+      "academic": "来自学术文献的长期异象因子精选（价值、动量、质量、低波动率等）。",
+      "fundamental": "基于 PIT 安全的 SEC company facts 计算的质量与价值因子——盈利收益率、ROE、毛利率、资产增长（按 filed-date 锚定）。"
    },
    "universeOption": {
      "csi300": "沪深 300（A 股）",
@@ -84,9 +84,17 @@ const ZOO_CARDS: ZooCard[] = [
    title: "Academic Anomalies",
    description:
      "Curated long-horizon anomalies from the academic literature (value, momentum, quality, low-vol, etc.).",
-    approxCount: 6,
+    approxCount: 10,
    accent: "from-violet-500/20 to-violet-500/5",
  },
+  {
+    id: "fundamental",
+    title: "PIT-Safe Fundamentals",
+    description:
+      "Quality and value factors computed from PIT-safe SEC company facts — earnings yield, ROE, gross profitability, asset growth (filed-date anchored).",
+    approxCount: 4,
+    accent: "from-rose-500/20 to-rose-500/5",
+  },
 ];

 const UNIVERSE_OPTIONS = [
@@ -1,9 +1,11 @@
-export const DOCS_DEFAULT_VERSION = "0.1.9";
+export const DOCS_DEFAULT_VERSION = "0.1.11";
 export const DOCS_LATEST_ALIAS = "latest";
 export const DOCS_DEFAULT_PAGE = "getting-started/vibe-trading-overview";

 export const DOCS_VERSIONS = [
-  { name: "0.1.9", label: "0.1.9 (latest)" },
+  { name: "0.1.11", label: "0.1.11 (latest)" },
+  { name: "0.1.10", label: "0.1.10" },
+  { name: "0.1.9", label: "0.1.9" },
  { name: "0.1.8", label: "0.1.8" },
  { name: "0.1.7", label: "0.1.7" }
 ];
@@ -193,7 +195,7 @@ TIMEOUT_SECONDS=2400</code></pre>
            id: "presets",
            title: "Presets",
            body: `
-              <p>Vibe-Trading includes 29 presets such as investment committee, quant strategy desk, crypto trading desk, macro rates and FX desk, and risk committee.</p>
+              <p>Vibe-Trading includes 30 presets such as investment committee, quant strategy desk, crypto trading desk, macro rates and FX desk, and risk committee.</p>
              <pre><code>vibe-trading --swarm-presets
 vibe-trading --swarm-run investment_committee '{"topic":"BTC outlook"}'</code></pre>
            `