DeepSeek Harness 插件体系概览

DeepSeek Harness 插件体系概览

DeepSeek Harness 用插件组合模型、工具、界面和会话能力。你可以直接从应用的插件页管理扩展，也可以让 DeepSeek Harness 自动帮你开发插件；有兴趣深入的话，还可以阅读「第一个插件」及「组合包与 profile」章节自己动手制作。

内置能力和额外安装

文件读取、Shell、模型接入等基础能力已由当前 profile 的插件组合提供，完成首次任务不需要重新安装一套插件。两个容易混淆的概念：

• 处理图片应先选择实际支持视觉的模型并检查输入类型；
• Agent 预设与 profile 有区别：标准模式、PTC 模式等是会话使用的 Agent 预设，web、headless、sdk 等 profile 决定启动哪套应用配置——名为 tui 的自定义 profile 不代表所有安装都自带终端界面。

在应用中查找插件

1. 点击左侧「插件」，查看本机提供的分类和已安装内容。
2. 进入发现页时，先检查索引源是否已配置且能刷新——发现页的标题、作者和来源由索引提供。
3. 打开目标插件详情，核对用途、版本、兼容性、npm 包或 Git 来源。
4. 点击安装后，阅读确认框显示的实际来源，再决定是否安装。

注意：索引校验通过只说明格式有效，不代表官方审核了作者、代码或安全性。发现页没有合适插件时，可以从 GitHub 的 dsh-plugin 主题查找源码，再核对维护状态和兼容范围。

让 Harness 帮你开发插件

也可以直接把需求交给 DeepSeek Harness：把当前工作目录的需求做成左侧菜单入口，输入需求后等待开发完成；复制提示中给出的绝对路径，点击左侧插件菜单 → 添加插件，输入该路径并启用。启用后左侧会多出对应入口，插件列表中也能看到它；点击右上角编辑器选项，还可以在编辑器中查看插件目录与代码，方便继续修改。

CLI 安装到指定 profile

已安装 CLI 的用户，可以用 dsh plugin 把组合包安装到明确的 profile（下面的包名与路径是占位示例，需替换成实际存在且经过核对的插件）：

# 安装发布到 npm 的精确版本
dsh plugin --profile web add your-plugin-package@1.2.3

# 安装本地开发的组合包
dsh plugin --profile web add ./hello-plugin

# 查看最终组合配置
dsh --profile web --dump-config

要点提醒：

• 包需要声明 dsh.bundle 才能贡献配置层——普通依赖安装成功不等于能力已经加载；
• CLI 只影响所指定的 profile，不要假定 web 的插件会自动出现在桌面版当前环境中；
• 在终端中安装时，使用固定版本或仓库的确切提交，避免无意追踪变化中的默认分支。

安装后怎么验证

例如安装问候工具后，应看到 greet 调用返回 "Hello, IZZI!"；安装纯界面插件则应检查对应入口和交互。需要重启时按应用提示操作。