前言¶
DeepSeek Harness (DSH) 的核心设计理念是「一切皆插件」。对于需要操作云资源的场景，直接调用 Azure CLI 往往面临输出格式非结构化、命令参数繁琐的问题。wode25500/dsh-az 插件旨在解决这一痛点，它通过封装 Azure CLI 提供原生工具，让模型能够直接读取结构化数据，并执行 Azure 资源的查询、展示与部署。
是什么¶
dsh-az 是一个独立社区项目，由 WODE25500 维护。它并非 Azure 官方工具，而是基于开源的 Azure/azure-cli（MIT 许可证）构建的 DSH 插件。该插件延续了微软系生态的主题，为 DSH 智能体提供了一套管理 Azure 资源的标准化工具链。
核心功能¶
插件提供了 7 个原生工具，覆盖了资源管理的核心场景：
- az_status：查询当前状态。
- az_subscriptions：管理订阅信息。
- az_resource_query：查询资源。
- az_show：展示特定资源详情。
- az_activity_log：诊断 Azure 活动日志。
- az_group_create：创建资源组。
- az_deploy：部署 Bicep 与 ARM JSON 模板。
除此之外，插件具备以下特性：
* 结构化数据输出：所有查询工具均强制使用 --output json，模型可以直接解析返回的 JSON 结构，无需编写正则或解析逻辑。
* 安全确认机制：对于写操作（如 group create 和 deploy），插件会显式请求确认，防止误操作。
* 模板支持：原生支持 Bicep 和 ARM JSON 模板的部署。
安装与启用¶
安装时，需要在 DSH 的配置中插入一个 ID 为 az 的工具。该工具指向插件的入口文件，并需配置 Azure CLI 的路径和订阅 ID。
- insert:
- id: az
name: './src/index.js'
config:
azPath: az
subscription: <your-sub-id>
说明：
* azPath：指定本地 az 命令的路径。
* subscription：指定操作的默认订阅 ID。
典型用法¶
基于上述安装，智能体可以通过以下步骤进行操作：
- 查询与展示：使用
az_status查看全局状态，或使用az_resource_query与az_show获取具体资源的结构化数据。 - 订阅管理：调用
az_subscriptions查看可用订阅列表。 - 资源组创建：使用
az_group_create创建新的资源组（需确认）。 - 模板部署：使用
az_deploy上传并执行 Bicep 或 ARM JSON 模板（需确认）。 - 日志诊断：利用
az_activity_log检查 Azure 的操作日志。
适用场景与注意¶
- 适用场景：适合需要在 DeepSeek Harness 环境中自动化管理 Azure 资源的开发者，特别是需要频繁进行模板部署或资源审计的场景。
- 注意事项：
- 这是独立社区项目，非官方出品，使用前建议检查源码与许可证。
- 由于插件以当前 DSH 进程的权限运行，请确保环境安全。
- 执行写操作时，务必关注显式确认的提示，避免意外修改生产环境。
结尾¶
dsh-az 通过将 Azure CLI 封装为 DSH 原生工具，降低了智能体操作云平台的门槛。它专注于提供结构化数据和安全的部署流程，是 Azure 用户在 DSH 生态中管理资源的实用工具。更多细节与源码，请访问项目主页。
