diff --git a/README.md b/README.md
index 545e130..f151007 100644
--- a/README.md
+++ b/README.md
@@ -181,6 +181,16 @@ The scanners are guardrails, not a substitute for human review. See
 
 <sub>Traffic snapshot: 2026-08-10. GitHub exposes clone and unique-visitor analytics only to maintainers, so those values are a dated, transparent snapshot rather than a token-backed public badge.</sub>
 
+### Star history
+
+<p align="center">
+  <a href="https://www.star-history.com/#JNHFlow21/trove&Date">
+    <img width="800" src="https://api.star-history.com/svg?repos=JNHFlow21/trove&type=Date" alt="TROVE star history chart">
+  </a>
+</p>
+
+<sub>Live white-background chart from Star History. It follows public GitHub star data and becomes more informative as the repository grows.</sub>
+
 ## Documentation
 
 - [Architecture](docs/architecture.md)
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 78a011a..5d84bf7 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -145,6 +145,16 @@ gitleaks git --redact
 
 <sub>数据快照日期：2026-08-10。GitHub 只向仓库维护者提供克隆与独立访客数据，因此这里采用注明日期的透明快照，而不是需要私密 Token 的公开徽章。</sub>
 
+### Star 增长曲线
+
+<p align="center">
+  <a href="https://www.star-history.com/#JNHFlow21/trove&Date">
+    <img width="800" src="https://api.star-history.com/svg?repos=JNHFlow21/trove&type=Date" alt="TROVE Star 增长曲线">
+  </a>
+</p>
+
+<sub>这是由 Star History 提供的动态白底增长曲线，读取 GitHub 公开 Star 数据；随着项目获得更多 Star，曲线会自动变得更完整。</sub>
+
 ## 文档
 
 - [架构](docs/architecture.md)
diff --git a/tests/test_documentation_contract.py b/tests/test_documentation_contract.py
index 3fa0ed2..b98c69f 100644
--- a/tests/test_documentation_contract.py
+++ b/tests/test_documentation_contract.py
@@ -137,6 +137,9 @@ def test_readme_is_ordered_artifact_walkthrough(self):
         chinese = self.files['README.zh-CN.md']
         self.assertIn('<strong>简体中文</strong>', chinese)
         self.assertIn('README.zh-CN.md', readme)
+        chart = 'https://api.star-history.com/svg?repos=JNHFlow21/trove&type=Date'
+        self.assertIn(chart, readme)
+        self.assertIn(chart, chinese)
 
     def test_generated_reference_is_byte_identical_to_catalog(self):
         self.assertEqual(