插件市场里搜得到,装完却没生效?先分清索引、确认框和运行时

简介: DeepSeek Harness 默认不内置市场索引;要显示 `发现` 标签,需启用实验性的自定义插件市场组合包,索引源也按 profile 分别保存。因此,市场里搜得到,不代表当前 profile 已能使用:索引格式通过、版本兼容、插件在运行时注册能力,是三个独立关卡。本文沿着索引 → 安装确认框 → 运行时逐步排查,并提供证据对照表和可复核的安装记录模板。

在插件市场里搜到了目标插件,版本兼容检查也通过了,可安装完成后,对应能力却没有出现。 这通常不是插件坏了,而是把三个独立关卡混成了一件事:索引能否解析、插件能否安装、能力能否在运行时被调用。三道检查各自都可能失败。

本文沿着实际链路依次排查:市场索引是什么、为什么看不到 发现 标签、确认框里要核对什么、安装后如何判断是否生效,以及哪些结论超出了现有证据能支持的范围。

一、市场索引只是「可发现的候选项清单」

官方插件市场指南把市场定义得很窄:一份列出可安装 DSH 组合包、版本和展示信息的 JSON 索引。

这会带来三个直接结论:

  • 它提供的是发现和安装路径,不是安全结论;
  • 标题、作者、描述、图标和来源声明都由市场提供,DSH 只检查索引格式,不验证这些声明;
  • 索引里的一条记录存在,只说明「某个索引声称有这样一份产物」,不说明它可用、可信或与描述相符。

因此,严格地说,「市场里有」只是某个索引源声称有。要进一步确认自己能不能安装,还得检查当前 profile 是否配置了这个索引源。

二、发现 标签默认不存在,索引源按 profile 保存

DSH 默认不内置任何索引源。要看到 发现 标签,得先启用实验性的自定义插件市场组合包;关掉这个组合包,标签会一起消失。

还要注意:索引源属于当前 profile。这一点很容易被忽略——

在 A profile 里加过的索引源,不会自动出现在 B profile 里。

所以在动手排查之前,先把三个问题分开问:

  1. 这个 profile 装了自定义插件市场组合包吗?
  2. 这个 profile 的 发现 里,加了包含目标插件的索引源吗?
  3. 这个 profile 的运行时里,插件真的被加载并注册能力了吗?

三问里任何一问是「否」,后面的现象都会长得一模一样。

添加索引源时的两条硬性要求

文档要求索引 URL 使用 http: 或 https:,且不能包含用户名、密码或片段。

在不受控制的网络上优先用 HTTPS:HTTP 索引以及它给出的安装 spec,都可能在传输中被修改。这不是「建议」,而是一条你能自己验证的边界——索引和安装来源一旦能被中间人改写,「我审过这个包」这句话就不成立了。

另外,指南没有提供通用索引 URL。除非发布者明确说明仓库首页本身就是索引文件,否则不要把首页地址当索引填进去。填错的表现通常是「加了源但搜不到」,很容易被误当成索引内容问题。

三、发现页在替你做什么,以及它不做什么

搜索会匹配名称、作者、关键词,以及各语言的标题、描述、分类和标签;筛选和排序则依据市场声明的元数据。

版本选择的规则是确定的:卡片推荐与当前 DSH 兼容的最高非预发布版本;如果插件没有任何非预发布版本,则推荐最高的兼容预发布版本。打开插件页可以看到完整的列出清单,包括 DSH 接受的旧版和预发布版本。

这里容易产生误解:「推荐了这个版本」只表示兼容性检查通过。这不代表版本经过审计,也不代表市场作者的描述属实。

四、确认框才是唯一的凭据

点安装后先弹确认框,里面列的是:

  • npm 来源:包名 + 注册表
  • Git 来源:仓库 + 提交 + 目录

确认之后才进入常规安装流程,包括兼容性和注册表检查。未经确认不会安装任何东西。

确认框的关键作用是:它是整条链路上唯一给出「确切产物身份」的地方。卡片标题、描述和图标都可以由市场控制;只有确认框里的包名/提交,才指向你真正将要运行的代码。

因此,审查要落在确认框上:把这些确切标识与你准备信任的代码和发布者逐一核对;不一致或无法判断时取消,不要抱着「先装上再说」的想法继续。

一张对照表:哪些证据能证明什么

证据 可以用于 不能证明
索引格式通过 DSH 能解析列出的结构 插件身份或安全性
版本兼容 版本满足 DSH 兼容性检查 代码可信
Git 提交和目录 定位要审查的确切来源 其他分支或发布版内容相同
Registry 收录 寻找候选仓库 背书或安全审计

这张表建议在排查时直接拿出来用:多数「以为装的是另一个东西」的问题,都能找到一行对上。

五、按顺序走完的五步

  1. 打开插件,在实验性插件旁点更多,启用自定义插件市场。此时出现 发现 标签;关闭组合包后该标签会移除。
  2. 在发现里选添加索引源,输入你要信任的索引 URL(http:/https:,不带用户名、密码、片段)。不受控网络上优先 HTTPS。
  3. 搜索目标能力并打开候选项,核对版本列表与当前 DSH 的兼容性。发现失败时,在管理索引源里查看各来源最近一次的错误。
  4. 检查确认框里的 npm 注册表与包名,或 Git 仓库、提交与目录,和你要信任的代码、发布者对照。不一致就取消。
  5. 确认安装,然后在合适的测试环境里验证目标功能,记下来源和版本,供升级时重新审查。

第 4 步不要跳。跳过它的代价不是「多装了一个插件」,而是你的审查笔记和实际运行的产物对不上,后续所有判断都建在错误的前提上。

顺带区分一条容易混的路径:第一个插件教程讲的是从源码加载本地插件,那是开发路径,不是市场安装路径。两者装完的观感相似,出问题的排查方向完全不同。

六、装完没生效:按运行时而不是按市场排查

前面五步都过了,能力还是不出现,这时候问题大概率不在市场,在运行时。

DSH 插件通过上下文注册能力。第一个插件教程展示了 apply(ctx),Cordis 入门说明了服务、依赖、事件和生命周期副作用如何挂上去。这意味着一个插件的影响范围可能远超卡片上的那句话——要看它注册了什么,以及它请求的服务是否被满足。

先确认加载、依赖和能力名称

排查时先回答三个问题:

  • 插件是否被加载(而不是仅仅出现在已安装列表里)?
  • 它依赖的服务在这个 profile 里存在吗?
  • 它注册的能力名称,和你实际调用的名称一致吗?

一个常见的混淆是把「已安装」当成「已加载」。装在磁盘上和注册进运行时是两件事,中间还隔着依赖解析和加载顺序。

七、安装后评估变化:记录什么才有用

一次审查建议记录以下四项:

  1. 需要的功能(你为什么装它);
  2. 确切来源与版本(确认框里那串标识);
  3. 检查过的能力(文件、网络、凭据、命令等);
  4. 最小测试结果(用了什么输入,看到什么)。

还没查清的问题也要记下来。 这比只写「安装成功」更有用:后来的人可以对照新的提交或包版本,判断哪些结论仍然成立、哪些需要重新检查。

测试要先用非敏感输入。功能正常只能说明被测试的路径正常,不能证明未测试的依赖或操作安全。如果插件要求了意料之外的访问,应当停下来重新评估来源与配置,而不是「反正已经装上了」。

八、升级时必须重做的一件事

出现更新时,要重新检查新版本的确切来源,不能假定此前对旧版的审查覆盖新版本。

理由是具体的:新版本可能改变依赖或行为;Git 来源换了提交,默认分支的代码也可能已经不是你当初审的那份;npm 来源换了包版本,即使包名和注册表一致,选中的产物也变了。

市场版本列表可能提供兼容的旧版或预发布版,方便你留在已审过的版本上——但「兼容」不是「安全」,它只说明 DSH 接受这个版本在当前环境运行。

索引报错时,通过来源管理界面排查,不要把另一个未审查的索引当成等价替代。

九、边界说明

  • HTTPS 索引只保护到指定主机的传输,不能证明主机或内容可信。
  • 结构有效、兼容性通过、被 Registry 收录,都不是恶意代码扫描。
  • 沙箱或审批预设不等于插件行为审计;两者的区别见权限预设。
  • 市场元数据属于第三方内容;名字相似不代表两个确认框指向同一产物。
  • 索引不可用时,先查错误和来源 URL,不要为了让发现页工作而关闭安全控制。
  • 审查笔记和求助日志要排除密钥;评估陌生插件时,用满足需求的最小测试环境。
  • 本文依据官方插件市场指南与公开的插件开发文档整理,不是官方支持文档;示例行为可能随版本变化,动手前以你所在版本的官方文档为准。

十、相关术语

  • 市场索引:描述插件及可安装版本的 JSON 文档,格式由 DSH 检查,内容由市场提供。
  • 组合包:市场列出的可安装 DSH 包;也是启用 发现 标签的那个实验性单元。
  • Profile:索引源所属的配置作用域;索引源不跨 profile 共享。
  • 兼容性:DSH 是否接受该版本在当前环境运行,不是安全背书。
  • Cordis:Harness 底层管理插件服务、依赖与生命周期副作用的框架。

理解「确认框」和「运行时」这两个节点很关键——它们是两次责任转移:确认框之前,你能改变的是选哪份产物;确认框之后、运行时之前,决定成败的是依赖与加载;运行时之后,才轮到功能本身是否如描述。

相关阅读

本文依据 DeepSeek Harness 官方插件市场指南与插件开发参考整理,由 DSH Plugin 社区(dsh-plugin.com)维护者撰写,首发于阿里云开发者社区。
插件与文档收录于:https://dsh-plugin.com/zh/blog

目录
相关文章
|
18天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
8043 58
|
3天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1533 1
|
6天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
19天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5725 69
|
6天前
|
云安全 人工智能 安全
|
13天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2954 9
|
6天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
3天前
|
Linux Go 开发工具
手机上跑 DeepSeek 智能体:开源安卓客户端 DSH Go 安装与使用指南
DSH Go 是一款开源安卓客户端,将 DeepSeek Harness 智能体引擎装进手机:免 Root、免 Termux,一键安装即用;支持本机运行(内置 Ubuntu+Node.js)或远程接管电脑会话;具备插话打断、过程折叠、屏幕操控、端到端加密分享等特色功能,真正实现智能体“口袋化”。
2340 0
|
11天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1889 1

热门文章

最新文章