diff --git a/README.md b/README.md
index de853c6..cd98205 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,9 @@
 # FortranCallJulia
 
+<p align="center">
+  <img src="docs/assets/logo.png" alt="FortranCallJulia logo" width="251">
+</p>
+
 [![docs](https://github.com/openEarthModelling/FortranCallJulia/actions/workflows/docs.yml/badge.svg)](https://github.com/openEarthModelling/FortranCallJulia/actions/workflows/docs.yml)
 [![cmake](https://github.com/openEarthModelling/FortranCallJulia/actions/workflows/cmake.yml/badge.svg)](https://github.com/openEarthModelling/FortranCallJulia/actions/workflows/cmake.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-informational.svg)](LICENSE)
diff --git a/docs/assets/favicon.png b/docs/assets/favicon.png
new file mode 100644
index 0000000..2fbacfe
Binary files /dev/null and b/docs/assets/favicon.png differ
diff --git a/docs/assets/logo-square.png b/docs/assets/logo-square.png
new file mode 100644
index 0000000..8f6eb09
Binary files /dev/null and b/docs/assets/logo-square.png differ
diff --git a/docs/assets/logo.png b/docs/assets/logo.png
new file mode 100644
index 0000000..66c32c3
Binary files /dev/null and b/docs/assets/logo.png differ
diff --git a/docs/en/index.md b/docs/en/index.md
index e4084a3..c8151ee 100644
--- a/docs/en/index.md
+++ b/docs/en/index.md
@@ -3,6 +3,8 @@ title: FortranCallJulia
 sync: 2026-10-31
 ---
 
+![FortranCallJulia logo](../assets/logo.png)
+
 Embed the Julia runtime inside a Fortran application: Fortran calls Julia
 through a C bridge (the `fcj_*` C ABI), and Julia solvers call back into
 Fortran -- one process, zero-copy arrays, every call exception-checked.
diff --git a/docs/en/intro/architecture.md b/docs/en/intro/architecture.md
index b5d6486..1ddd155 100644
--- a/docs/en/intro/architecture.md
+++ b/docs/en/intro/architecture.md
@@ -78,12 +78,12 @@ call ~12 μs) -- see [Deployment modes](../user/deployment-modes.md).
 
 ## The full system, interactively
 
-<a href="/assets/fcj-architecture.html" target="_blank">Open the full version
+<a href="../../assets/fcj-architecture.html" target="_blank">Open the full version
 in a new tab</a> -- it supports search, path tracing between two nodes, and
 a guided tour.
 
 <figure>
-  <iframe src="/assets/fcj-architecture.html"
+  <iframe src="../../assets/fcj-architecture.html"
           title="FortranCallJulia architecture diagram (interactive)"
           loading="lazy"
           style="width:100%;height:900px;border:1px solid #ccc;">
@@ -93,7 +93,7 @@ a guided tour.
 If the embedded frame is unavailable (no JavaScript, restricted network),
 the static preview below carries the same layer structure:
 
-![Static preview of the FortranCallJulia architecture diagram](/assets/architecture-preview.png)
+![Static preview of the FortranCallJulia architecture diagram](../../assets/architecture-preview.png)
 
 Reading the diagram: the three columns are the three worlds above; edges
 crossing columns are the `fcj_*` ABI and the `@cfunction` callback path.
diff --git a/docs/zh/developer/annex-figures.md b/docs/zh/developer/annex-figures.md
index 2e5d7d8..a1ca11d 100644
--- a/docs/zh/developer/annex-figures.md
+++ b/docs/zh/developer/annex-figures.md
@@ -48,7 +48,7 @@ cd ../../examples/07_capstone/figures && python3 plot_capstone.py
 
 ## fig1_sod_transport — Sod 激波管三联图（ρ / u / p，183 mm 双栏）
 
-![fig1：Sod 激波管三联图（ρ / u / p）](/assets/figs/fig1_sod_transport.png)
+![fig1：Sod 激波管三联图（ρ / u / p）](../../assets/figs/fig1_sod_transport.png)
 
 ### 数学模型与精确解
 
@@ -101,7 +101,7 @@ $p\ 1.09\times10^{-3}$，与一阶精度 $O(\Delta x)$ 一致。守恒格式的
 
 ## fig2_detonation_structure — CJ 爆震结构四联（183 mm 双栏）
 
-![fig2：CJ 爆震结构四联](/assets/figs/fig2_detonation_structure.png)
+![fig2：CJ 爆震结构四联](../../assets/figs/fig2_detonation_structure.png)
 
 ### 数学模型
 
@@ -159,7 +159,7 @@ $\Delta x = 1.11\times10^{-3}$）。d 联的 Z 悬崖即反应层，inset 放大
 
 ## fig3_front_speed — 前沿轨迹与爆速（89 mm 单栏）
 
-![fig3：前沿轨迹与爆速](/assets/figs/fig3_front_speed.png)
+![fig3：前沿轨迹与爆速](../../assets/figs/fig3_front_speed.png)
 
 ### 数学与测量协议
 
@@ -191,7 +191,7 @@ CJ 参考线。红虚骑在蓝割线上方且缝隙对齐——两条线在图
 
 ## fig4_performance — 四模式成本对比（89 mm 单栏）
 
-![fig4：四模式成本对比](/assets/figs/fig4_performance.png)
+![fig4：四模式成本对比](../../assets/figs/fig4_performance.png)
 
 ### 数学/统计口径
 
@@ -225,7 +225,7 @@ b 联唯一的数据排除已在图内脚注与 PERFORMANCE.md 记录：AOT 的
 
 ## fig5_gri_ignition — GRI-Mech 3.0 均质点火（89 mm 双联）
 
-![fig5：GRI-Mech 3.0 均质点火](/assets/figs/fig5_gri_ignition.png)
+![fig5：GRI-Mech 3.0 均质点火](../../assets/figs/fig5_gri_ignition.png)
 
 ### 数学模型
 
@@ -268,7 +268,7 @@ dataviz 六项校验器全对通过；紫–蓝对 protan ΔE 7.5 落在 6–8 
 
 ## fig6_bridge_vs_native — 桥接 vs 原生逐点对照（89 mm 双联）
 
-![fig6：桥接 vs 原生逐点对照](/assets/figs/fig6_bridge_vs_native.png)
+![fig6：桥接 vs 原生逐点对照](../../assets/figs/fig6_bridge_vs_native.png)
 
 ### 对照协议
 
@@ -307,7 +307,7 @@ $|\Delta q| / \max(|q_\mathrm{native}|, 10^{-10})$：分母条件化下限
 
 ## fig7_heat_release — 放热率判据 |dT/dt|（89 mm 单栏）
 
-![fig7：放热率判据 |dT/dt|](/assets/figs/fig7_heat_release.png)
+![fig7：放热率判据 |dT/dt|](../../assets/figs/fig7_heat_release.png)
 
 ### 量的定义
 
@@ -324,7 +324,7 @@ K/µs，此后随链支反应加速单调爬升（0.8 ms 处 0.10、1.0 ms 处
 
 ## fig8_capstone_overview — 收官总览（183 mm 2×3）
 
-![fig8：收官总览](/assets/figs/fig8_capstone_overview.png)
+![fig8：收官总览](../../assets/figs/fig8_capstone_overview.png)
 
 一页看全整个 capstone，六联全部是已审计数据的重绘（无新数据通道）：
 **a** Sod ρ vs 精确 Riemann 解（输运内核，fig1）；**b** 爆震 p + CJ
diff --git a/docs/zh/index.md b/docs/zh/index.md
index 3dadcc4..7587ff7 100644
--- a/docs/zh/index.md
+++ b/docs/zh/index.md
@@ -3,6 +3,8 @@ title: 在 Fortran 中嵌入 Julia 运行时
 sync: 2026-10-31
 ---
 
+![FortranCallJulia 徽标](../assets/logo.png)
+
 把 Julia 运行时嵌入 Fortran 应用程序：Fortran 经 C 桥（`fcj_*` C ABI）调用
 Julia，Julia 求解器再回调 Fortran——同一进程、零拷贝数组、每次调用都做异常检查。
 
diff --git a/docs/zh/intro/architecture.md b/docs/zh/intro/architecture.md
index b806246..0aaa77a 100644
--- a/docs/zh/intro/architecture.md
+++ b/docs/zh/intro/architecture.md
@@ -51,10 +51,10 @@ Fortran bind(c) 调用方
 
 ## 交互式全景图
 
-<a href="/assets/fcj-architecture.html" target="_blank">在新标签页打开完整版</a>——支持搜索、两点间路径追踪和引导式浏览。
+<a href="../../../assets/fcj-architecture.html" target="_blank">在新标签页打开完整版</a>——支持搜索、两点间路径追踪和引导式浏览。
 
 <figure>
-  <iframe src="/assets/fcj-architecture.html"
+  <iframe src="../../../assets/fcj-architecture.html"
           title="FortranCallJulia 架构图（交互式）"
           loading="lazy"
           style="width:100%;height:900px;border:1px solid #ccc;">
@@ -63,6 +63,6 @@ Fortran bind(c) 调用方
 
 若内嵌框架不可用（禁用 JavaScript、受限网络），下面的静态预览承载同样的分层结构：
 
-![FortranCallJulia 架构图静态预览](/assets/architecture-preview.png)
+![FortranCallJulia 架构图静态预览](../../assets/architecture-preview.png)
 
 读图要领：三列即上述三个世界；跨列的边就是 `fcj_*` ABI 与 `@cfunction` 回调路径。下一页把整套构造钉在数字上：[验证](validation.md)。
diff --git a/mkdocs.yml b/mkdocs.yml
index 95de359..0c3546f 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -4,6 +4,8 @@ copyright: FortranCallJulia - MIT License
 
 theme:
   name: material
+  logo: assets/logo-square.png
+  favicon: assets/favicon.png
 
 plugins:
   - search