chore: quick update feat/manager at 2026-01-21 23:01:56

Author: kooksee

README.md

@@ -17,6 +17,9 @@
 - ⚙️ **Configuration-driven** - YAML-based project configuration
 - 📊 **Progress Display** - Visual progress bars and detailed error messages
 - 🗑️ **Cache Management** - Clean and manage dependency cache
+- 🌐 **Web UI** - Visual configuration editor with proto file browser
+- 🏥 **Environment Check** - Doctor command to diagnose development environment
+- 🎯 **Project Initialization** - Quick project setup with templates
 
 ## Installation
 
@@ -75,6 +78,10 @@ protobuild gen
 | `web --port 9090` | Start web UI on custom port |
 | `clean` | Clean dependency cache |
 | `clean --dry-run` | Show what would be cleaned without deleting |
+| `init` | Initialize a new protobuild project |
+| `init --template grpc` | Initialize with specific template (basic, grpc, minimal) |
+| `doctor` | Check development environment and dependencies |
+| `doctor --fix` | Auto-install missing Go plugins |
 | `version` | Show version information |
 
 ## Configuration
@@ -256,6 +263,52 @@ The web interface provides:
 - 🔌 Plugin configuration
 - 🚀 One-click build, lint, format operations
 - 📄 Real-time YAML preview
+- 📊 Project statistics dashboard
+- 🔍 Proto file browser with syntax highlighting
+- 📚 Configuration examples reference
+
+### Initialize New Project
+
+```bash
+# Interactive initialization
+protobuild init
+
+# Use specific template
+protobuild init --template basic    # Basic Go + gRPC project
+protobuild init --template grpc     # Full gRPC-Gateway project
+protobuild init --template minimal  # Minimal configuration
+
+# Specify output directory
+protobuild init -o ./my-project
+```
+
+### Check Development Environment
+
+```bash
+# Diagnose environment issues
+protobuild doctor
+
+# Auto-install missing Go plugins
+protobuild doctor --fix
+```
+
+Example output:
+```
+🏥 Protobuild Doctor
+
+  Checking development environment...
+
+  ✅ protoc                 installed (v25.1)
+  ✅ protoc-gen-go          installed
+  ✅ protoc-gen-go-grpc     installed
+  ✅ buf                    installed (v1.28.1)
+  ✅ api-linter             installed
+  ✅ go                     installed (go1.21.5)
+  ✅ Configuration          protobuf.yaml found
+  ⚠️  Vendor directory       not found (run 'protobuild vendor')
+
+  ✅ Environment check passed!
+```
 
 ### Force Vendor Update
 
@@ -378,6 +431,20 @@ protobuild
 - [Multi-Source Dependencies](./docs/MULTI_SOURCE_DEPS.md) - Design document for multi-source dependency resolution
 - [Design Document](./docs/DESIGN.md) - Architecture and design documentation
 
+## Roadmap
+
+Upcoming features planned for future releases:
+
+| Feature | Description | Status |
+|---------|-------------|--------|
+| 🔗 **Dependency Graph** | Visualize proto file import dependencies | Planned |
+| ⚠️ **Breaking Change Detection** | Detect incompatible changes between versions | Planned |
+| 📚 **API Documentation Generator** | Auto-generate Markdown/HTML docs from proto comments | Planned |
+| 🎭 **Mock Server** | Auto-start mock gRPC/HTTP server for testing | Planned |
+| 📝 **Proto Templates** | Quick generation of common proto patterns (CRUD, pagination) | Planned |
+| 📊 **Field Statistics** | Analyze field naming conventions and type distribution | Planned |
+| ✏️ **Online Editor** | Edit proto files directly in Web UI | Planned |
+
 ## License
 
 [MIT License](LICENSE)

README_CN.md

@@ -17,6 +17,9 @@
 - ⚙️ **配置驱动** - 基于 YAML 的项目配置
 - 📊 **进度显示** - 可视化进度条和详细错误信息
 - 🗑️ **缓存管理** - 清理和管理依赖缓存
+- 🌐 **Web 界面** - 可视化配置编辑器，支持 Proto 文件浏览
+- 🏥 **环境诊断** - Doctor 命令检查开发环境配置
+- 🎯 **项目初始化** - 快速项目设置，支持多种模板
 
 ## 安装
 
@@ -76,6 +79,10 @@ protobuild gen
 | `web --port 9090` | 指定端口启动 Web 界面 |
 | `clean` | 清理依赖缓存 |
 | `clean --dry-run` | 预览将被清理的内容 |
+| `init` | 初始化新的 protobuild 项目 |
+| `init --template grpc` | 使用指定模板初始化（basic、grpc、minimal）|
+| `doctor` | 检查开发环境和依赖配置 |
+| `doctor --fix` | 自动安装缺失的 Go 插件 |
 | `version` | 显示版本信息 |
 
 ## 配置说明
@@ -257,6 +264,52 @@ Web 界面提供：
 - 🔌 插件配置
 - 🚀 一键执行构建、检查、格式化等操作
 - 📄 实时 YAML 配置预览
+- 📊 项目统计仪表盘
+- 🔍 Proto 文件浏览器（支持语法高亮）
+- 📚 配置示例参考
+
+### 初始化新项目
+
+```bash
+# 交互式初始化
+protobuild init
+
+# 使用指定模板
+protobuild init --template basic    # 基础 Go + gRPC 项目
+protobuild init --template grpc     # 完整 gRPC-Gateway 项目
+protobuild init --template minimal  # 最小化配置
+
+# 指定输出目录
+protobuild init -o ./my-project
+```
+
+### 检查开发环境
+
+```bash
+# 诊断环境问题
+protobuild doctor
+
+# 自动安装缺失的 Go 插件
+protobuild doctor --fix
+```
+
+输出示例：
+```
+🏥 Protobuild Doctor
+
+  正在检查开发环境...
+
+  ✅ protoc                 已安装 (v25.1)
+  ✅ protoc-gen-go          已安装
+  ✅ protoc-gen-go-grpc     已安装
+  ✅ buf                    已安装 (v1.28.1)
+  ✅ api-linter             已安装
+  ✅ go                     已安装 (go1.21.5)
+  ✅ 配置文件               已找到 protobuf.yaml
+  ⚠️  Vendor 目录            未找到（请运行 'protobuild vendor'）
+
+  ✅ 环境检查通过！
+```
 
 ### 强制更新 Vendor
 
@@ -349,6 +402,20 @@ plugins:
 - [多源依赖设计](./docs/MULTI_SOURCE_DEPS.md) - 多源依赖解析设计文档
 - [设计文档](./docs/DESIGN_CN.md) - 架构和设计文档
 
+## 路线图
+
+以下是计划在未来版本中实现的功能：
+
+| 功能 | 描述 | 状态 |
+|------|------|------|
+| 🔗 **依赖关系图** | 可视化 proto 文件的 import 依赖关系 | 计划中 |
+| ⚠️ **Breaking Change 检测** | 检测版本间的不兼容变更 | 计划中 |
+| 📚 **API 文档生成** | 从 proto 注释自动生成 Markdown/HTML 文档 | 计划中 |
+| 🎭 **Mock 服务器** | 自动启动用于测试的 mock gRPC/HTTP 服务器 | 计划中 |
+| 📝 **Proto 模板** | 快速生成常用 proto 模式（CRUD、分页等）| 计划中 |
+| 📊 **字段统计分析** | 分析字段命名规范和类型分布 | 计划中 |
+| ✏️ **在线编辑器** | 在 Web 界面直接编辑 proto 文件 | 计划中 |
+
 ## 项目架构
 
 ```

Taskfile.yml

@@ -131,4 +131,4 @@ tasks:
   web:
     desc: Run web server
     cmds:
-      - go run *.go web
+      - go run -v *.go web

cmd/webcmd/server.go

@@ -479,15 +479,15 @@ func (s *Server) handleProtoContent(w http.ResponseWriter, r *http.Request) {
 
 // ProjectStats represents project statistics.
 type ProjectStats struct {
-	ProtoFiles     int      `json:"proto_files"`
-	TotalLines     int      `json:"total_lines"`
-	MessageCount   int      `json:"message_count"`
-	ServiceCount   int      `json:"service_count"`
-	DependencyCount int     `json:"dependency_count"`
-	PluginCount    int      `json:"plugin_count"`
-	ProtoRoots     []string `json:"proto_roots"`
-	VendorDir      string   `json:"vendor_dir"`
-	VendorFiles    int      `json:"vendor_files"`
+	ProtoFiles      int      `json:"proto_files"`
+	TotalLines      int      `json:"total_lines"`
+	MessageCount    int      `json:"message_count"`
+	ServiceCount    int      `json:"service_count"`
+	DependencyCount int      `json:"dependency_count"`
+	PluginCount     int      `json:"plugin_count"`
+	ProtoRoots      []string `json:"proto_roots"`
+	VendorDir       string   `json:"vendor_dir"`
+	VendorFiles     int      `json:"vendor_files"`
 }
 
 // handleProjectStats returns project statistics.