docs: add Chinese README to root, clarify docs/README.md as directory structure guide

Author: Hongwei-MB

README.md

@@ -1,66 +1,40 @@
 # Modulus
-Modulus - Modular Application Template for Cross-Platform Tooling
-
-**Modulus** 是一个现代化的跨平台插件式工具应用模板，旨在帮助开发者快速构建可扩展、可维护、支持 AI 的桌面工具类软件。
-
-该模板具备模块化架构、热插拔插件、配置系统、依赖注入、本地化、多版本兼容、签名验证等关键特性，帮助你专注业务开发而非基础设施。
-
----
-
-## ✨ 特性亮点
-
-- 🔌 插件热更新与动态卸载（基于 AssemblyLoadContext）
-- ⚙️ 插件配置支持（JSON-based）
-- 📦 插件依赖注入（DI 容器隔离）
-- 🌐 多语言本地化（支持自动切换）
-- 🔐 插件签名验证与版本控制
-- 🧠 AI Agent 插件支持（可嵌入 LLM）
-- 🛠️ 提供插件开发 SDK 与模板工程
-- 🖥️ 跨平台支持：Windows / macOS（Avalonia UI）
-
----
-
-## 📦 用途场景
-
-- 构建桌面数据工具 / UI 自动化工具
-- 快速构建开发者辅助类应用（Log Viewer、Code Generator）
-- 面向 AI 插件开发的任务框架
-- 内部工具平台（多团队协作）
-
----
-
-## 🚀 快速开始
 
+Modulus is a modern, cross-platform, plugin-based application template designed to help developers quickly build extensible, maintainable, and AI-ready desktop tools.
+
+## ✨ Features
+- Hot-reloadable and dynamically unloadable plugins (AssemblyLoadContext)
+- Plugin configuration support (JSON-based)
+- Dependency injection for plugins (DI container isolation)
+- Multi-language localization (automatic switching)
+- Plugin signature verification and version control
+- AI Agent plugin support (LLM integration)
+- Plugin development SDK and project templates
+- Cross-platform: Windows / macOS (Avalonia UI)
+
+## 📦 Use Cases
+- Desktop data tools / UI automation tools
+- Rapid development of developer utilities (Log Viewer, Code Generator)
+- Task framework for AI plugin development
+- Internal tool platforms (multi-team collaboration)
+
+## 🚀 Getting Started
 ```bash
 dotnet new --install Modulus.Templates
 dotnet new modulus-plugin -n MyPlugin
 ```
 
----
-
-## 📚 文档
-
-完整的项目文档可以在 [docs](./docs/README.md) 目录中找到。文档包括：
-
-- **用户指南**：安装说明、使用说明和故障排除
-- **开发者指南**：插件开发、系统架构和 API 参考
-- **用户故事**：产品开发路线图和功能演进
-
-文档提供多种语言版本：
+## 📚 Documentation
 - [English Documentation](./docs/en-US/README.md)
-- [中文文档](./docs/zh-CN/README.md)
-
----
-
-## 📊 项目状态
-
-查看当前项目进度与状态请参阅 [README-Project-Status.md](./README-Project-Status.md)。
+- [中文文档 Chinese Documentation](./docs/zh-CN/README.md)
 
-我们使用标准化的用户故事文档，所有 Story 文件遵循以下命名规则：
-- 文件格式：`S-XXXX-标题.md`
-- 文档标题：`# S-XXXX-标题`
-- 必要元数据：包含优先级和状态标记
+## Project Status
+- See progress report: [docs/reports/story-progress-report.en-US.md](./docs/reports/story-progress-report.en-US.md)
 
-通过运行 `.\Generate-StoryProgress.ps1` 可生成最新的项目进度报告。
+## Story Naming Convention
+- File format: `S-XXXX-Title.md`
+- Document title: `# S-XXXX-Title`
+- Required metadata: priority and status tags
 
----
+## Contributing
+Pull requests and issues are welcome!

README.zh-CN.md

@@ -0,0 +1,40 @@
+# Modulus 项目简介
+
+Modulus 是一个现代化的跨平台插件式工具应用模板，旨在帮助开发者快速构建可扩展、可维护、支持 AI 的桌面工具类软件。
+
+## ✨ 特性亮点
+- 插件热更新与动态卸载（基于 AssemblyLoadContext）
+- 插件配置支持（JSON-based）
+- 插件依赖注入（DI 容器隔离）
+- 多语言本地化（支持自动切换）
+- 插件签名验证与版本控制
+- AI Agent 插件支持（可嵌入 LLM）
+- 提供插件开发 SDK 与模板工程
+- 跨平台支持：Windows / macOS（Avalonia UI）
+
+## 📦 用途场景
+- 构建桌面数据工具 / UI 自动化工具
+- 快速构建开发者辅助类应用（Log Viewer、Code Generator）
+- 面向 AI 插件开发的任务框架
+- 内部工具平台（多团队协作）
+
+## 🚀 快速开始
+```bash
+dotnet new --install Modulus.Templates
+dotnet new modulus-plugin -n MyPlugin
+```
+
+## 📚 文档
+- [English Documentation](./docs/en-US/README.md)
+- [中文文档](./README.zh-CN.md)
+
+## 项目状态
+- 进度报告见 [docs/reports/story-progress-report.zh-CN.md](./docs/reports/story-progress-report.zh-CN.md)
+
+## Story 命名规则
+- 文件格式：`S-XXXX-标题.md`
+- 文档标题：`# S-XXXX-标题`
+- 必要元数据：包含优先级和状态标记
+
+## 贡献
+欢迎提交 issue 和 PR！

docs/zh-CN/README.md

@@ -1,29 +1,40 @@
-# Modulus 项目文档（中文）
-
-欢迎阅读 Modulus 项目的中文文档。
-
-## 用户指南
-
-- [入门指南](./user-guide/getting-started.md) (待添加)
-- [安装指南](./user-guide/installation.md) (待添加)
-- [使用说明](./user-guide/usage.md)
-
-## 开发者指南
-
-### 插件系统
-
-- [插件开发指南](./developer-guide/plugin-system/plugin-development-guide.md)
-- [插件 API 参考](./developer-guide/plugin-system/plugin-api-reference.md) (待添加)
-
-### 系统架构
-
-- [系统架构](./developer-guide/architecture/system-architecture.md) (待添加)
-
-## 用户故事
-
-- [故事 001: 初始项目设置](./stories/story-001.md)
-- [故事 002: 基础 UI 框架](./stories/story-002.md)
-- [故事 003: 动态插件加载](./stories/story-003.md)
-- [故事 004: 插件契约定义](./stories/story-004.md)
-- [故事 005: 插件配置和本地化](./stories/story-005.md)
-- [故事 006: 插件管理界面](./stories/story-006.md)
+# Modulus 项目简介
+
+Modulus 是一个现代化的跨平台插件式工具应用模板，旨在帮助开发者快速构建可扩展、可维护、支持 AI 的桌面工具类软件。
+
+## ✨ 特性亮点
+- 插件热更新与动态卸载（基于 AssemblyLoadContext）
+- 插件配置支持（JSON-based）
+- 插件依赖注入（DI 容器隔离）
+- 多语言本地化（支持自动切换）
+- 插件签名验证与版本控制
+- AI Agent 插件支持（可嵌入 LLM）
+- 提供插件开发 SDK 与模板工程
+- 跨平台支持：Windows / macOS（Avalonia UI）
+
+## 📦 用途场景
+- 构建桌面数据工具 / UI 自动化工具
+- 快速构建开发者辅助类应用（Log Viewer、Code Generator）
+- 面向 AI 插件开发的任务框架
+- 内部工具平台（多团队协作）
+
+## 🚀 快速开始
+```bash
+dotnet new --install Modulus.Templates
+dotnet new modulus-plugin -n MyPlugin
+```
+
+## 📚 文档
+- [English Documentation](../en-US/README.md)
+- [中文文档](./README.md)
+
+## 项目状态
+- 进度报告见 [docs/reports/story-progress-report.zh-CN.md](../reports/story-progress-report.zh-CN.md)
+
+## Story 命名规则
+- 文件格式：`S-XXXX-标题.md`
+- 文档标题：`# S-XXXX-标题`
+- 必要元数据：包含优先级和状态标记
+
+## 贡献
+欢迎提交 issue 和 PR！