DSH 的理念是「一切皆插件」。在 Web 界面中直接调用本地 Windows 操作能力，是很多智能体开发者的需求。dsh-winagent 插件解决了这个问题，它把桌面版 WinAgent 的能力封装进 DSH，让你无需离开浏览器就能使用 Windows Agent 的功能。
插件介绍¶
这是一个由 HarrisXiu 维护的插件，授权协议为 MIT。它的核心作用是将 WinAgent 的完整能力——包括 OpenAI 兼容 API / 本地 Ollama、53+ 个 Windows 工具、Skills、MCP 以及 LLM Wiki 个人知识库——移植到 DSH 的 Web 界面中。
核心功能¶
- 聊天与交互：支持流式输出、思维链折叠、工具调用卡片。处理附件时支持图片、文本和 PDF。对于危险操作，系统会弹出确认弹窗。
- 配置与设置：支持 Provider 管理（OpenAI 或 Ollama），可配置请求行为、视觉辅助、人设提示词，以及 skills/mcp/vault 的路径。
- 个人知识库：提供文件树浏览、全文搜索、编辑功能，支持通过 URL 导入或上传文件自动编译入库（LLM Wiki），包含 LINT / REFLECT 工作流。
- 文档处理：支持 PDF、Word、Excel、PPT 的转换与处理。
- 数据存储：插件数据位于
$DSH_HOME/winagent/。
安装与启用¶
使用官方安装命令即可：
dsh plugin --profile web add dsh-winagent
安装完成后，需要重启 dsh web 进程并在浏览器刷新页面，插件才会生效。
使用步骤¶
- 安装并重启
dsh web后，页面右下角会出现 WinAgent 悬浮按钮，点击打开插件界面。 - 先在「设置」里配置 Provider。如果是 OpenAI 兼容端，需填写含
/v1的 Base URL + API Key + 模型；如果是本地 Ollama，配置 Ollama 服务地址即可。 - 配置完成后，直接在输入框下指令即可使用。
适用场景与注意¶
- 权限与安全：插件以当前 Windows 用户权限执行工具。删除、写注册表、结束进程、执行命令等危险操作默认需要弹窗确认，可在设置里关闭，但需谨慎操作。API Key 以明文存于
$DSH_HOME/winagent/config.json（用户私有目录），请勿分享该目录。 - 范围说明：个性化桌宠主题（如立绘）不在本插件范围内；人设提示词可在设置里自由修改。
总结¶
dsh-winagent 插件通过将桌面版 WinAgent 的能力集成到 DSH 的 Web 界面，实现了在浏览器中直接操作 Windows 系统的能力。开发者可以在配置好 Provider 后，直接在 Web 界面使用 53+ 个 Windows 工具、管理个人知识库并处理各类文档。
