PLA Research Observatory · public research selection

中共軍事研究資料庫

本頁說明如何介接本站公開選讀資料。本期 catalog 列七項可核對資源:七則公開公告、兩篇完整研究、研究概念、學習路徑及地理關係示意。

發布範圍與狀態

本期資料涵蓋 2026-11-08 至 2026-11-14(Asia/Taipei,按公告發布日選編),release ID 為 research-20261114-v1。本站正式基址為 https://pla-research-observatory.pages.dev/;可由下方公開目錄核對本版來源、涵蓋期間與檔案雜湊。

本站提供公開選讀。完整私有研究資料庫、原始郵件、內部附件、未選編研究紀錄和私有 API 不在此介接範圍。catalog 的 full_database_exposed 固定為 false。

再利用界線:公開可讀不等於取得第三方轉授權、鏡像、再發布、商用或模型訓練權利。引用資料請保留原始來源;其他用途另取得權利人書面同意。

網站模組與資料對照

首頁與來源流程

首頁 index.html 說明資料範圍;七則公告位於 data/bulletins.json,保存公告日期、觀測窗口、數值單位、船舶類別與來源網址。

圖表與觀測值

首頁圖表由公告 JSON 呈現。航空數值按 aircraft.unit 保留原值;架與架次不混加,PLAN 共艦與公務船分開呈現。

研究概念

data/concepts.json 提供三筆研究概念,連結至報告中對應章節。

閱讀與分析路徑

data/learning-paths.json 提供三條任務路徑,列出步驟、證據資源與建議閱讀章節。

七項機器可讀資源

從本站根目錄相對路徑 data/catalog.json 取得 allowlist、byte count、SHA-256 及 MIME type;依 catalog 逐項讀取,不推測未列資源。下載套件包含欄位契約、唯讀範例與離線資料。

建議介接流程

1.讀取 catalog

以部署方確認的 HTTPS base URL 讀取相對路徑 data/catalog.json,固定 release ID 與涵蓋期間。

2.核對資源

只依七項 allowlist 讀取資源,檢查路徑、MIME type、byte count、SHA-256 與 schema。

3.匯入資料

以穩定 ID 做 upsert;保留日期、窗口、原單位與來源。未知值不改成 0,不由匯入端產生研判。

4.呈現研究

清楚標示涵蓋期、來源與方法界線。報告英文僅提供摘要;完整正文為繁體中文。

連結、JSON 與嵌入

一般導覽優先使用連結並以新分頁開啟。合作方後端可讀取公開 catalog allowlist 中的 JSON,建議沿 HTTPS 直接讀取或以合作方自己的同源反向代理提供;若瀏覽器跨來源讀 JSON,請明確使用 credentials: "omit",不傳 Cookie、Authorization 或 token。不得跨來源 redirect。

iframe 不作預設。現行 SAMEORIGIN/frame-ancestors 限制跨站嵌入;需要框架時雙方須另行確認政策、可及性與手機版版面。公開可讀不自動代表允許 iframe。

下載或快取限 catalog 列出的七項資源。不得讀取私有研究站資料,不沿用舊 school-partner token 或 quota。