diff --git a/addons/game_base/static/description/icon.png b/addons/game_base/static/description/icon.png
new file mode 100644
index 0000000..c4cf0a7
Binary files /dev/null and b/addons/game_base/static/description/icon.png differ
diff --git a/addons/game_base/static/description/index.html b/addons/game_base/static/description/index.html
new file mode 100644
index 0000000..013833d
--- /dev/null
+++ b/addons/game_base/static/description/index.html
@@ -0,0 +1,112 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+    <meta charset="UTF-8">
+    <title>Yusen Game Base</title>
+    <style>
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, "PingFang SC", "Microsoft YaHei", sans-serif;
+            padding: 24px;
+            color: #333;
+            background: #fff;
+            line-height: 1.6;
+        }
+        .hero {
+            display: flex;
+            align-items: center;
+            gap: 24px;
+            margin-bottom: 24px;
+        }
+        .hero img {
+            width: 96px;
+            height: 96px;
+            image-rendering: pixelated;
+            border-radius: 16px;
+            box-shadow: 0 4px 16px rgba(0,0,0,0.12);
+        }
+        .hero h1 {
+            margin: 0 0 6px;
+            font-size: 24px;
+            color: #1a1a1a;
+        }
+        .hero p {
+            margin: 0;
+            color: #666;
+            font-size: 14px;
+        }
+        .section {
+            margin-top: 18px;
+        }
+        .section h2 {
+            font-size: 16px;
+            margin: 0 0 8px;
+            color: #2c3e50;
+            border-bottom: 2px solid #4fc3f7;
+            padding-bottom: 4px;
+            display: inline-block;
+        }
+        .section ul {
+            margin: 0;
+            padding-left: 20px;
+        }
+        .section li {
+            margin-bottom: 6px;
+        }
+        code {
+            background: #f4f6f8;
+            padding: 2px 6px;
+            border-radius: 4px;
+            font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, monospace;
+            font-size: 13px;
+            color: #c0392b;
+        }
+        .tag {
+            display: inline-block;
+            background: #e3f2fd;
+            color: #0277bd;
+            padding: 2px 8px;
+            border-radius: 12px;
+            font-size: 12px;
+            margin-right: 6px;
+        }
+    </style>
+</head>
+<body>
+    <div class="hero">
+        <img src="logo.png" alt="Yusen Game Base logo">
+        <div>
+            <h1>Yusen Game Base</h1>
+            <p><span class="tag">Game</span> 宇森沙盘游戏后台基础模块</p>
+        </div>
+    </div>
+
+    <p>沉淀游戏世界观内容，为前端 <code>/game/api/*</code> 提供只读数据；同时打通 Odoo <code>res.users</code>，提供玩家登录/注册能力。</p>
+
+    <div class="section">
+        <h2>数据模型</h2>
+        <ul>
+            <li><strong>图鉴 (Codex)</strong> — 怪物、物品、地形等条目，支持分类与富文本。</li>
+            <li><strong>规则 (Rule)</strong> — 游戏规则与设定说明，版本化管理。</li>
+            <li><strong>论坛 (Forum)</strong> — 帖子与回复，沉淀玩家讨论。</li>
+            <li><strong>公告 (Announcement)</strong> — 游戏运营公告与更新日志。</li>
+        </ul>
+    </div>
+
+    <div class="section">
+        <h2>前端 API</h2>
+        <ul>
+            <li><code>GET /game/api/codex?db=game</code></li>
+            <li><code>GET /game/api/rules?db=game</code></li>
+            <li><code>GET /game/api/threads?db=game</code></li>
+            <li><code>GET /game/api/announcements?db=game</code></li>
+            <li><code>POST /game/api/login?db=game</code></li>
+            <li><code>POST /game/api/register?db=game</code></li>
+        </ul>
+    </div>
+
+    <div class="section">
+        <h2>依赖</h2>
+        <p>仅依赖 <code>base</code>，安装简单，无额外第三方模块。</p>
+    </div>
+</body>
+</html>
diff --git a/addons/game_base/static/description/logo.png b/addons/game_base/static/description/logo.png
new file mode 100644
index 0000000..e231f1d
Binary files /dev/null and b/addons/game_base/static/description/logo.png differ
