dsh-winget

dsh-winget

Windows Package Manager (winget) 的 DeepSeek Harness (dsh) 插件 —— 让 dsh 智能体通过原生工具
搜索、安装、升级、卸载、导入导出 Windows 软件包。所有命令走非交互模式，可在无头环境工作。

独立社区项目，非官方。基于微软 winget-cli（MIT）。

特性

• 9 个原生 dsh 工具：winget_search / winget_show / winget_install / winget_upgrade /
  winget_list / winget_uninstall / winget_export / winget_import / winget_pin
• 附带 SKILL.md 技能文件，指导 agent 何时用、安全规则
• Schemastery 配置（wingetPath / alwaysAcceptAgreements / timeoutMs）
• bundle patch 层（cordis.patch.yml），一键加入任意 profile
• 默认非交互 + 自动接受协议（无头安装必需）
• 安全设计：install/uninstall/upgrade-all 工具描述明确标注需先确认

前置要求

• DeepSeek Harness（dsh）
• Windows 10 1809+ / Windows 11，winget 可用（winget --version）

安装

作为 bundle 加入 profile

- insert:
    - id: winget
      name: './src/index.js'
      config:
        wingetPath: winget
        alwaysAcceptAgreements: true

本地 patch 临时加载

pnpm dsh web --patch ./dsh-winget/cordis.patch.yml

然后问 agent："用 winget_search 帮我找 VS Code 并查看详情"。

工具

工具	行为
winget_search	搜索软件（query/id/name/moniker/tag）
winget_show	软件详情（版本/来源/安装器）
winget_install	安装（会改变系统，先确认）
winget_upgrade	升级指定或全部（all=true）
winget_list	已安装列表/筛选/导出
winget_uninstall	卸载（必须确认）
winget_export / winget_import	清单导出/导入
winget_pin	版本固定 add/list/remove

配置项

键	默认	说明
wingetPath	winget	winget.exe 路径
alwaysAcceptAgreements	true	自动接受包/源协议（无头必需）
timeoutMs	600000	单次调用超时（安装可能很慢）

已知限制

• 本版本 winget 无 JSON 输出，工具返回表格文本（模型可读）
• 需要管理员权限的安装可能失败（UAC 无法在非交互模式弹出）——如实返回错误
• msstore 来源的包部分需登录微软账号

目录结构

dsh-winget/
  src/index.js            # 插件入口：9 个工具 + 配置
  skills/winget/SKILL.md  # agent 技能
  docs/                   # 文档
  cordis.patch.yml        # bundle patch 层

许可

MIT。