awesome-deepseek-harness-plugins/packages/dsh1024

131Star66Fork15Issue0Watching

把 1024 Store 精选目录搬进 DeepSeek Harness 设置页,支持浏览、搜索、一键安装/卸载并自带带匿名统计的 CLI 包装器。

机审证据安装命令仓库已核验dsh-plugin Topic许可证READMEAI 百科
语言
TypeScript
License
MIT
分支
main
awesome-listcatalogdeepseekdeepseek-harnessdeepseek-harness-pluginsdeepseek1024dshdsh-1024store

安装

$ dsh plugin --profile web add github:imsai-sh/awesome-deepseek-harness-plugins/packages/dsh1024

在终端中运行以上命令,通过 dsh CLI 安装此插件。可在右上角切换 Profile。 第一次用 dsh?看这篇新手教程

对话式安装

帮我安装 DeepSeek Harness 插件 imsai-sh/awesome-deepseek-harness-plugins/packages/dsh1024:先查看仓库 https://github.com/imsai-sh/awesome-deepseek-harness-plugins.git 确认安全性,然后执行安装命令并验证插件加载成功。

把这段指令粘贴给 DSH Web GUI 里的助手,由它代你完成安装与验证。

一句话定位

把 1024 Store 官方精选插件目录搬进 DeepSeek Harness 的设置页,让你在不离开宿主应用的情况下浏览、搜索、一键安装或卸载社区插件,同时附带一个对官方 dsh 命令的薄包装器,把匿名安装结果上报给 1024Store 统计 API。

核心能力

  • 在设置页内动态加载并校验 1024Store 公共目录,支持搜索、分类筛选、热门/最新排序和已安装识别
  • 提供三个入口:设置页左侧导航行、设置 → 插件里的「1024 Store(N)」标签页、侧边栏底部带目录总数徽标的浮层入口
  • 安装/卸载走同源 POST,同一时刻只允许一个操作,带实时进度反馈
  • 安装器只接受经过目录校验的 GitHub 仓库 URL,自动派生出 github:owner/repository 参数,不执行目录里的展示命令
  • 启动时检查自身版本并提示新版本;目录先用上一次结果立即渲染,再后台静默校验,新收录的插件无需手动刷新
  • 附带 dsh1024 命令行,作为官方 dsh plugin 的薄包装,参数原样透传,复用 PATH 上的官方 CLI 并上报匿名安装/卸载结果

技术实现

  • 语言: TypeScript(服务端 + CLI 编译产物);客户端用 React 组件,通过宿主提供的 __ModuleLoader__ 注入
  • 关键依赖: @deepseek-ai/cordis ^4.0.1(宿主注入的 peer,可选);@deepseek-ai/dsh(CLI 透传的目标包,运行时通过 npx 或 PATH 解析);Node 标准库 node:fs/promisesnode:child_processnode:cryptonode:pathnode:os
  • 架构模式: Cordis 宿主插件,通过 package.json#dsh.bundle.patchdsh1024 注入宿主 bundle,由 apply(ctx, config)webServer 服务就绪后挂载本地 HTTP 路由;客户端用 window.__ModuleLoader__.load 注册 React 组件,通过 slots 把 UI 注入到侧边栏、设置页、插件标签页三个槽位
  • 入口文件: 服务端 packages/dsh1024/src/index.ts;客户端 packages/dsh1024/client/client.js;CLI packages/dsh1024/bin/dsh1024.js

适用场景

适合想要在 DeepSeek Harness 里直接浏览、搜索、安装第三方插件而不想切换到终端的用户,以及想把每次安装/卸载作为匿名统计事件上报给 1024Store 的开发者。CLI 包装器则适合在 CI 或脚本里复用官方 dsh 命令的同时记录安装结果。

前置依赖与兼容性

依赖最低版本说明
DSH未声明插件通过 cordis 宿主注入,DSH 的 dsh.bundle.patch + client.inject 机制加载运行时模块
Node.js>=22仓库根 package.json 与子包 package.json 的 engines.node 字段
平台跨平台运行时通过 process.platform 区分,CLI 内含 Windows 特定的 taskkill / PATH 解析逻辑
原生模块仅使用 Node 内建模块,无 node-pty / node:sqlite 等原生扩展

安装方式

dsh plugin --profile web add github:imsai-sh/awesome-deepseek-harness-plugins/packages/dsh1024

配置项

配置类型说明默认值
profile字符串决定这台机器上哪个 DSH profile 来承担插件增删。当未显式设置时,先看启动命令中是否带 --profile <name>,否则取 webweb
registryUrlHTTPS URL1024Store 目录接口的地址,插件启动和每次打开面板都从这里拉取https://deepseek1024.com/api/v1/registry
updateUrlHTTPS URL自检版本时查询最新版本号的接口;失败时回退到 GitHub 仓库 package.jsonhttps://registry.npmjs.org/dsh1024/latest
DSH_HOME路径覆盖 DSH 数据目录,插件从中读取 profile 列表和写入本地缓存~/.dsh
DSH1024_TELEMETRY0 关闭其余开启把当前进程的匿名安装统计关闭开启
DSH1024_DSH_PACKAGE包名CLI 透传给官方 dsh 时的包规格,便于锁定版本或测试@deepseek-ai/dsh
DSH1024_DSH_VERSION版本号当包规格本身不带版本时,作为上报事件里的 DSH 版本号
DSH1024_TELEMETRY_URLHTTPS URL覆盖匿名事件上报的端点https://deepseek1024.com/api/v1/install-events
DSH1024_TELEMETRY_TIMEOUT_MS100-30000 毫秒上报请求的超时时间2500

上面三行 profile / registryUrl / updateUrl 是宿主通过 apply(ctx, config) 传入的运行时配置;其余为环境变量。旧的 DSH_1024STORE_* 拼写永久兼容,新写法优先。

常见问题

Q: 这个插件安装后从哪儿打开?

A: 安装并重启 DeepSeek Harness 后共有三个入口:设置页左侧的「1024 Store」导航行、设置 → 插件里的「1024 Store(N)」标签页、侧边栏底部带目录总数徽标的下载图标。删掉任何一个入口都会被 scripts/preflight.mjs 拦下。

Q: 商店里的插件列表从哪里来,是本地快照吗?

A: 来自公共 HTTPS 接口 https://deepseek1024.com/api/v1/registry,运行时动态拉取并按 validateRegistry 严格校验,不内置快照。打开面板先用上一次成功结果立即渲染,再后台静默校验;并发刷新会合并成一次请求,失败时维持当前列表。

Q: 一次能装多个插件吗?卸载有限制吗?

A: 装/卸路由每次只允许一个操作,第二个会拿到 409 冲突;只接受经过目录校验的 GitHub 仓库 URL,插件自己派生出 github:owner/repositorygithub:owner/repo#path:sub/dir 形式,不会执行目录里的展示命令。dsh1024 本身不能从面板里卸载(删除它要走 host CLI 卸载普通插件的方式)。

Q: 附带那个 dsh1024 命令行是干什么的?

A: 它是官方 dsh plugin 的薄包装:plugin 之后的所有参数原样透传,不补默认值。如果 PATH 上已有官方 dsh 就直接复用,省掉 npx 的解析开销;用 DSH1024_DSH_PACKAGE 钉版本时则走 npx。结束后会核对目标 profile 的依赖是否真实写入,并上报一条匿名安装结果。

Q: 它会上报什么数据,怎么关掉?

A: 每次安装/卸载上报一条匿名事件(随机事件 UUID、随机客户端 UUID、插件 ID、profile、结果、耗时、CLI/DSH 版本、OS/CPU 架构、是否 CI),不含 IP、命令、路径、提示词或 API Key。永久关闭:npx dsh1024 telemetry disable;临时关闭:DO_NOT_TRACK=1DSH1024_TELEMETRY=0;换新匿名身份:npx dsh1024 telemetry reset

Q: 我的网络断了还能浏览目录吗?

A: 拉取失败时如果有上一次成功缓存会直接展示缓存,让离线机器也能继续浏览;重新连上后下次打开面板时会在后台校验并自动刷新。

Q: 之前用的 @dsh-1024store/clidsh-1024store 怎么办?

A: 两个包都已弃用:把 npx @dsh-1024store/cli ... 换成 npx dsh1024 ...,把 dsh plugin --profile web add dsh-1024store 换成 dsh plugin --profile web add dsh1024。旧的本地身份、receipt 和 DSH_1024STORE_* 环境变量名继续生效,无需迁移。

上手难度

入门 — 装好就能在设置页直接用,无需手写命令;CLI 用法也只需要把 dsh 名字换成 dsh1024

已知问题与限制

  • dsh1024 本身不能在店内面板里卸载(路由层加了 name === 'dsh1024' 拦截),需要通过外部途径移除
  • 目录接口只接受 https://github.com/owner/repository 形式的 GitHub 仓库 URL,不支持 GitLab、BitBucket、gist、jsr、workspace、catalog、npm alias 或完整 git URL
  • CLI 包装器对安装命令的归因采用「宁可漏记也不错记」原则:本地路径、file:/link:/portal:、URL、驱动盘符、模糊的命令向量等情况下虽然照常安装,但不会计入统计
  • 匿名身份基于 DSH_HOME(默认 ~/.dsh),同一台机器的多个 DSH home 会被当作多个匿名安装者;多个用户共用同一个 DSH home 则共享一个匿名身份

收录徽章

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/imsai-sh/awesome-deepseek-harness-plugins/packages/dsh1024)

把这段 markdown 粘贴到你的 GitHub README,链接回本插件详情页。徽章只声明已被本站收录,不代表安全认证。

返回插件目录