.NET AI Chat Web 模板参数变更解析

在.NET生态系统中，AI应用开发模板的快速迭代带来了参数命名的重大变更。最新版本的dotnet new aichatweb模板对命令行参数进行了规范化调整，这直接影响了开发者创建AI聊天应用的方式。

参数变更对比

旧版参数采用驼峰式命名且区分大小写，例如：

--AiServiceProvider "ollama"
--VectorStore "local"

新版则改为全小写短横线命名规范：

--provider "ollama"
--vector-store "local"

关键参数详解

1. 框架选择参数
   从--framework简化为-F，同时保持对.NET 9.0的支持：

   -F net9.0
   

2. AI服务提供商
   参数名从--AiServiceProvider改为--provider，支持四种选项：

   • azureopenai（Azure OpenAI服务）
   • githubmodels（GitHub模型）
   • ollama（本地Ollama服务）
   • openai（OpenAI平台）

3. 向量存储方案
   参数名从--VectorStore改为--vector-store，提供三种存储方式：

   • local（本地JSON文件）
   • azureaisearch（Azure AI搜索）
   • qdrant（Docker容器中的Qdrant）

新增功能参数

1. 托管身份认证
   --managed-identity参数支持使用Azure托管身份访问云服务，在特定服务组合下自动启用。

2. Aspire集成
   --aspire参数可将项目创建为分布式应用，利用.NET Aspire进行编排。

3. 模型定制
   新增-C指定聊天模型，-E指定嵌入模型，支持开发者灵活选择不同规格的AI模型。

最佳实践建议

1. 始终使用dotnet new aichatweb -h查看最新参数说明
2. 在CI/CD流水线中更新相关构建脚本
3. 项目文档应及时同步参数变更
4. 考虑创建参数映射表辅助迁移

这次参数变更反映了.NET工具链向更规范、更一致的命令行体验迈进，虽然带来短期适配成本，但长期来看提升了开发体验的统一性。开发者应当及时了解这些变更，以确保项目创建流程的顺畅。