diff --git a/docs/zh/_toc.yaml b/docs/zh/_toc.yaml
index 32226043bd93f94f88311ab0e1dff1ca8b97efb9..7cbfba173fc831e17486be00844219f7e159adfd 100644
--- a/docs/zh/_toc.yaml
+++ b/docs/zh/_toc.yaml
@@ -1,12 +1,12 @@
 label: Roo Code概述
 isManual: true
-description: Roo Code是vscodium中的AI代理插件
+description: Roo Code 是 vscodium 中的 AI 代理插件
 sections:
   - label: roo-code概述
     href: ./index.md
   - label: 安装卸载指导
-    href: ./install/install-and-remove.md
+    href: ./install/install_and_remove.md
   - label: 设置API秘钥和语言
-    href: ./manual/setting-api-key-and-language.md
+    href: ./manual/setting_api_key_and_language.md
   - label: 创建你的第一个任务
-    href: ./manual/create-your-first-task.md
+    href: ./manual/create_your_first_task.md
diff --git a/docs/zh/install/install-and-remove.md b/docs/zh/install/install_and_remove.md
similarity index 100%
rename from docs/zh/install/install-and-remove.md
rename to docs/zh/install/install_and_remove.md
diff --git a/docs/zh/manual/pic/1-install.png b/docs/zh/install/pic/1-install.png
similarity index 100%
rename from docs/zh/manual/pic/1-install.png
rename to docs/zh/install/pic/1-install.png
diff --git a/docs/zh/manual/create-your-first-task.md b/docs/zh/manual/create_your_first_task.md
similarity index 100%
rename from docs/zh/manual/create-your-first-task.md
rename to docs/zh/manual/create_your_first_task.md
diff --git a/docs/zh/manual/setting-api-key-and-language.md b/docs/zh/manual/setting_api_key_and_language.md
similarity index 100%
rename from docs/zh/manual/setting-api-key-and-language.md
rename to docs/zh/manual/setting_api_key_and_language.md
diff --git a/roo-code.spec b/roo-code.spec
index 7e99de381d116ab82179c5809d76adef2e386014..e9ec6d4e31880b88d002b00fd172d4c4aebaf16a 100644
--- a/roo-code.spec
+++ b/roo-code.spec
@@ -2,7 +2,7 @@
 
 Name:           roo-code
 Version:        3.10.5
-Release:        2
+Release:        3
 Summary:        Roo Code (prev. Roo Cline) gives you a whole dev team of AI agents in your code editor.
 License:        Apache-2.0
 URL:            https://github.com/RooVetGit/Roo-Code
@@ -47,6 +47,9 @@ mv extension %{buildroot}%{_datadir}/vscodium/resources/app/extensions/%{name}
 
 
 %changelog
+* Tue Jun 10 2025 wu-donger <wudonger@huawei.com> - 3.10.5-3
+- revise docs formatting guidelines
+
 * Thu Mar 27 2025 wangkui <wangkui35@h-partner.com> - 3.10.5-2
 - add docs