前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」。面对社区中成千上万的插件，开发者通常面临两个痛点：一是难以在海量生态中精准发现适配当前项目阶段的工具，二是缺乏统一的安全管理机制。现有的插件分发方式往往依赖外部网络或缺乏对本地项目状态的感知。
smart-dsh-market 是一个旨在解决上述问题的本地化插件中枢。它集成了海量插件索引、项目生命周期感知推荐与极简交互界面，致力于提供本地优先、零数据上传的安全插件管理体验。
插件定位¶
该插件由开发者 wsifan31-bit 维护，是一个基于 MIT 许可证的 DSH 插件市场。它不仅是一个插件索引库，更是一个集成了双引擎发现机制、安全分级体系与智能推荐功能的 DSH 生产力中枢。其核心价值在于将原本滞后的 2,786 款插件索引扩展至 12,435+ 款，并能在本地根据 Git 状态智能推荐插件。
核心功能¶
插件提供了以下主要能力：
-
双引擎发现与海量索引
插件通过动态接入本地 DSH Desktop 缓存，打破原先 2,786 款插件的检索局限。它实现了全网最新插件生态的实时同步，支持双引擎发现机制，确保开发者能获取到最新的插件资源。 -
双轨安全分级体系
市场对插件实行分级管理：- 官方严选：针对 2,786 款已验证插件，采用 SHA Commit 锁定与无侵入静态审计，支持一键静默秒装。
- 社区探索：针对 9,649 款社区插件，自动分流至 Agent 隔离沙箱安装，防止未经核验的代码直接侵入系统。
-
26px Nano HUD 会话底栏
在 DSH 的会话输入栏下方挂载了一个超轻量的 26px 浮动条。它会实时探测本地 Git 仓库状态（分支、脏工作区、提交频率）与项目生命周期阶段，并在气泡中就地推荐适配的插件，不占用主要聊天空间。 -
项目生命周期智能推导
插件能从本地 Git 历史与测试占比推断项目阶段（如架构、原型、实现、测试、打磨、维护）。基于证据化打分（匹配度、质量、增长、新鲜度、兼容性），它能对插件进行排序推荐。 -
本地优先与隐私保护
所有打分、阶段检测与缓存索引均支持 100% 离线运行。插件不会调用外部模型，也不会上传任何私有代码数据。
安装与启用¶
可以通过以下三种方式安装该插件：
方式一：使用 DSH CLI 安装（推荐）
在终端执行以下命令，将插件实体安装在当前 Profile 的 node_modules 作用域内：
dsh plugin --profile web add github:wsifan31-bit/smart-dsh-market
桌面端同样支持该命令。
方式二：一键安装脚本
* Windows：直接双击运行仓库根目录的 install.bat，或在 PowerShell 中执行 powershell -ExecutionPolicy Bypass -File scripts/install-desktop.ps1。
* Linux / macOS：在终端执行 bash install.sh。
方式三：Agent 安装
针对复杂构建或配置需求，可选择 Agent 安装模式。
安装完成后，启动 DSH 并进入 设置 → 插件 → 插件市场 即可使用。
使用指南¶
进入插件市场后，包含三个主要子页面：
- 插件市场：用于搜索、分类、排序插件，查看验证信息并执行安装。
- 已安装插件：过滤、检查更新、卸载或停用当前 Profile 的插件。
- 管理与诊断：支持手动命令安装、选择自定义安装位置以及执行冲突诊断。
安装模式说明
市场支持三种安装模式：
1. 一键安装：适用于精确 GitHub commit 或 npm 版本已通过检查的场景。
2. 手动命令安装：用户粘贴官方 DSH 命令，市场解析并锁定 commit 后安全安装。
3. Agent 安装：针对需要构建授权、生命周期脚本或额外核验的插件，创建隔离会话执行。
自建 Registry
插件支持配置自定义 Registry。默认使用中心化 Registry，若远程不可用，市场会自动回退使用包内快照。配置方式包括环境变量或插件配置项中的 registryUrl。
注意事项¶
-
依赖与安装位置
插件运行依赖两个 Host 端协议包（@deepseek-ai/dsh-typert-protocol、@deepseek-ai/dsh-app-boot）。这些包被设计为 peerDependency，必须由 DSH 运行时从 hoisted 存储提供，不要将它们改为 dependencies 或打入 bundle，否则会导致服务静默失效。安装必须确保插件实体落在 Profile 的node_modules作用域内。 -
Agent 工作区
Agent 默认绑定工作区路径为$DSH_HOME/marketplace/agent-workspace。自定义工作区必须预先存在且可读写。 -
冲突诊断
市场内置的冲突诊断面板会对已启用插件进行启发式静态检测（如重复的 Bundle ID、Cordis 服务注册形式），作为启动崩溃的前置防线。
结语¶
smart-dsh-market 通过双引擎发现、安全分级与本地化智能推荐，为 DSH 用户提供了一个从发现、安装到管理的完整闭环。它降低了寻找合适插件的成本，并通过隔离机制保障了安全性，是构建本地化 DSH 开发环境的实用工具。
