dsh-external-api
在终端中运行以下命令:
dsh plugin install WilShi/dsh-external-api
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中执行 dsh plugin install WilShi/dsh-external-api,即可从 https://github.com/WilShi/dsh-external-api 安装该插件。
插件介绍
想在自动化脚本、自建面板或局域网设备里驱动 DSH 的 Agent,却不想折腾桌面 UI 里的每一次点击?DSH External API 是 DSH Desktop 的可选 HTTP 服务:默认关闭,启用后通常只监听本机,让你用熟悉的 REST 与 SSE 去创建会话、发起 Run、订阅实时事件,而不复用或转发 DSH 主站的 /api。
核心能力围绕「受控对外」设计:除健康检查外一律 Bearer Token 鉴权,可按 Token 授权工作区与 Agent Preset 白名单;提供 capabilities、工作区、预设、模型与技能查询,以及会话列表、消息历史(脱敏)、Run 状态与取消;最省事的路径是一次 POST 创建会话并立即 Run,再用 SSE(支持 Last-Event-ID 续传)消费 run 与 message、tool 等事件。配置与 Token 归属由桌面「设置 → API 服务」管理,持久化仅保存 Token 摘要,并划清哪些内部能力不会对外暴露。
适合本机或受信内网里的集成开发者、运维与高级用户:需要把 DSH 接到 CI、内部工具或专用客户端,且愿意按 README 调整监听地址、防火墙与令牌范围的人。若要在不可信网络使用,应通过 VPN 或受信任的 TLS 反向代理并限制来源,勿把明文 HTTP 端口直接暴露到公网。
使用场景
- 本机脚本一键创建会话并发起 Run,用 SSE 跟进 Agent 输出
- 内网服务为团队成员签发 Token,在授权工作区内远程调用 DSH
- 自建面板列出会话、查询 Run 状态并在需要时取消任务
适合人员
- 需要把 DSH Agent 接入自动化或内部系统的开发者
- 在受信内网管理 DSH 并要做 API 集成的运维与高级用户
- 为局域网设备或专用客户端提供受控访问能力的集成负责人