Steel语言命令行工具重构与文档生成功能增强

背景与目标

Steel语言作为一门新兴的编程语言，其命令行工具正在经历一次重要的功能扩展。本次改进的核心目标是重构现有命令行接口(CLI)，并重点增强文档生成能力，使开发者能够直接从源代码注释生成格式化的技术文档。

CLI重构方案

原命令行工具存在以下待改进点：

1. 子命令缺乏快捷方式
2. 缺少Shell自动补全支持
3. 参数命名不够直观

新设计方案采用更符合现代CLI工具的最佳实践：

steel [FILE] [ARGS]... <COMMAND>

主要改进包括：

• 为所有子命令添加别名（如repl可简写为r）
• 新增completions命令支持Bash/Zsh等Shell的自动补全
• 统一参数命名风格，使用更清晰的描述

文档生成功能增强

文档生成子系统(doc命令)将获得重大升级：

steel doc [OPTIONS] [REST_ARGS]...

新功能特性：

1. 多格式输出：支持HTML和Markdown两种文档格式
2. 路径定制：
   • 通过-i/--input-path指定源代码目录
   • 通过-o/--output-path设置文档输出目录
3. 兼容性保证：完全保留原有的@doc运行时文档访问机制

技术实现要点

1. 参数解析层：

   • 采用更灵活的解析策略处理位置参数和可选参数
   • 实现智能的默认值机制（如默认输出目录为docs）

2. 文档处理引擎：

   • 注释解析器支持Javadoc风格的文档标签
   • 模板系统支持多格式输出扩展

3. 工程化考虑：

   • 保持向后兼容性
   • 错误处理机制增强

未来扩展方向

1. 增加PDF输出格式支持
2. 实现文档主题定制功能
3. 开发实时文档预览模式
4. 集成API文档自动生成

结语

本次CLI重构和文档功能增强将显著提升Steel语言的开发者体验。新的文档生成系统借鉴了Rustdoc等成熟工具的设计理念，同时保持了Steel语言本身的特性。这些改进为Steel向更成熟的开发工具链迈进奠定了重要基础。