docs(readme): trim to principles and cross-link docs

CONTRIBUTING.md

@@ -83,6 +83,8 @@ npm run dev
 npm start
 ```
 
+See also [Development guide](./docs/development.md) and [Main README](./README.md).
+
 ## Testing
 
 - Unit tests: `npm run test:unit`

docker-compose.yml

@@ -51,7 +51,7 @@ services:
       - opencode-config:/home/node/.config/opencode
     restart: unless-stopped
     # Guard small (1GB) hosts: cap memory/CPU so one slow request cannot wedge
-    # the whole machine (see docs/host-deployments.md §9). Raw `docker run`
+    # the whole machine (see `docs/host-deployments.md` §9). Raw `docker run`
     # hosts should pass the equivalents: --memory=768m --memory-reservation=256m
     # --cpus=1.5 --pids-limit=256.
     mem_limit: 768m

docs/AI_BOT.md

@@ -1,5 +1,7 @@
 # AI Bot (GitHub Actions)
 
+> 📖 [Docs Index](./README.md) | 🏠 [Main README](../README.md)
+
 In-repo advisory bot for OpenCode2API: issue investigation, multi-agent PR
 review, PR explanations, scheduled repo scans with auto-issue, and fix-plan
 proposals with opt-in draft PRs.

docs/README.md

@@ -4,7 +4,7 @@
   <img src="https://img.shields.io/badge/version-1.6.0-blue" alt="Version">
 </p>
 
-> **Language:** [English](./README.md) | [简体中文](./README.zh-CN.md) *(per-guide Chinese versions, see Translation status below)*
+> **Language:** **English** | [简体中文](./README.zh-CN.md) *(per-guide Chinese versions, see Translation status below)*
 >
 > 🏠 [Main README](../README.md) | [简体中文 README](../README.zh-CN.md) | 🐛 [Issues](https://github.com/samson910022/OpenCode2API/issues)
 

docs/README.zh-CN.md

@@ -4,9 +4,9 @@
   <img src="https://img.shields.io/badge/version-1.6.0-blue" alt="Version">
 </p>
 
-> **語言：** [English](./README.md) | [简体中文](./README.zh-CN.md)
+> **语言：** [English](./README.md) | **简体中文**
 >
-> 🏠 [主 README（English）](../README.md) | [主 README（简体中文）](../README.zh-CN.md)
+> 🏠 [主 README（English）](../README.md) | [主 README（简体中文）](../README.zh-CN.md) | 🐛 [Issues](https://github.com/samson910022/OpenCode2API/issues)
 >
 > 欢迎查看 OpenCode2API 文档
 

docs/api-reference.md

@@ -4,6 +4,8 @@
   <img src="https://img.shields.io/badge/version-1.6.0-blue" alt="Version">
 </p>
 
+> 📖 [Docs Index](./README.md) | 🏠 [Main README](../README.md)
+
 ---
 
 ## 📋 基础信息

docs/configuration.md

@@ -10,6 +10,8 @@
 
 > 配置优先级：**环境变量 > config.json > 默认值**
 
+> 📖 [Docs Index](./README.md) | 🏠 [Main README](../README.md)
+
 ---
 
 ## 🔧 环境变量

docs/development.md

@@ -136,3 +136,7 @@ OpenCode2API/
 ## 📄 许可证
 
 MIT License - 详见 [LICENSE](../LICENSE.md)
+
+---
+
+> 📖 [Docs Index](./README.md) | 🏠 [Main README](../README.md) | 🤝 [CONTRIBUTING](../CONTRIBUTING.md)

docs/docker.md

@@ -154,3 +154,7 @@ docker compose logs
 ### 挂载权限问题
 
 确保 PUID/PGID 配置正确 (默认 1000:1000)。
+
+---
+
+> 📖 [Docs Index](./README.md) | 🚀 [Getting Started](./getting-started.md)

docs/getting-started.md

@@ -96,3 +96,5 @@ curl -N -X POST http://127.0.0.1:10000/v1/responses \
 
 - ⚙️ 查看 [Configuration](./configuration.md) 了解更多配置选项
 - 🐳 查看 [Docker Deployment](./docker.md) 了解 Docker 部署详情
+
+> 📖 [Docs Index](./README.md) | 🏠 [Main README](../README.md)

docs/troubleshooting.md

@@ -157,3 +157,5 @@ OPENCODE_PROXY_DEBUG=true
 ## 🆘 获取帮助
 
 - 🐛 [GitHub Issues](https://github.com/samson910022/OpenCode2API/issues)
+
+> 📖 [Docs Index](./README.md) | 🏠 [Main README](../README.md)