awesome-deepseek-harness-plugins/packages/dsh-1024store

132Star66Fork15Issue0Watching

把 DSH 1024Store 精选目录搬进 DeepSeek Harness 设置页,支持浏览、搜索、一键安装/卸载与匿名安装统计。

机审证据安装命令仓库已核验dsh-plugin Topic许可证READMEAI 百科

此插件是大仓库 imsai-sh/awesome-deepseek-harness-plugins 的子包,星数与活跃度统计的是整个仓库。

语言
TypeScript
License
MIT
分支
main
awesome-listcatalogdeepseekdeepseek-harnessdeepseek-harness-pluginsdeepseek1024dshdsh-1024store

安装

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

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

对话式安装

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

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

一句话定位

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

核心能力

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

技术实现

  • 语言: TypeScript(CLI 端用编译后的 ESM JavaScript,客户端用 React 模块加载器格式)
  • 关键依赖: @deepseek-ai/cordis ^4.0.1(peerDependency,宿主注入用)、@deepseek-ai/dsh(CLI 透传的目标包,运行时通过 npx 或 PATH 解析)、Node 自带 node:fs/promisesnode:child_processnode:crypto 等标准库
  • 架构模式: Cordis 宿主插件;通过 package.json#dsh.bundle.patchdsh1024 注入宿主 bundle,由 apply(ctx, config)webServer 服务就绪后挂载本地 HTTP 路由;客户端侧用 window.__ModuleLoader__.load 注册 React 组件并通过 slots 注入三个入口
  • 入口文件: 服务端入口 packages/dsh1024/src/index.ts;客户端入口 packages/dsh1024/client/client.js;CLI 入口 packages/dsh1024/bin/dsh1024.js

适用场景

适合想直接在 DeepSeek Harness 里浏览和安装社区插件、而不是手动复制 GitHub 路径去命令行的普通用户。如果你想追踪自己装过的插件版本,或者想做批量管理,CLI 包装器也能让你在脚本里复用官方命令的同时拿到一份本地 receipt。

前置依赖与兼容性

依赖最低版本说明
Node.js>=22packages/dsh1024/package.json#engines.node 声明
DSH(宿主)未声明仅声明可选 peer @deepseek-ai/cordis ^4.0.1,未指定宿主版本范围
平台跨平台macOS / Linux / Windows 全部支持;CLI 透传和文件锁对 win32 做了 taskkill 兼容处理
原生模块不依赖 node-ptynode:sqlite 等原生模块

安装方式

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

说明:本仓库子目录实际名为 packages/dsh1024,npm 上的发布包名是 dsh1024。如果你希望通过 npm 名直接装,写 dsh plugin --profile web add dsh1024 是仓库 README 推荐的形式。

配置项

apply(ctx, config) 在宿主侧支持以下三个可选覆盖:

配置类型说明默认值
profile字符串拥有本次插件变更的 DSH profile 名--profile 命令行参数的值,没有则用 web
registryUrlHTTPS URL目录 API 地址https://deepseek1024.com/api/v1/registry
updateUrlHTTPS URL自更新检查 API 地址(带 GitHub 兜底)https://registry.npmjs.org/dsh1024/latest

CLI 和共享层还会读取以下环境变量:

环境变量作用默认值
DSH_HOMEDSH 数据目录~/.dsh
DO_NOT_TRACK设为 1 / true 时关闭遥测不设置
DSH1024_TELEMETRY(兼容旧名 DSH_1024STORE_TELEMETRY设为 0 时关闭遥测不设置
DSH1024_DSH_PACKAGE钉住官方 CLI 包名@deepseek-ai/dsh
DSH1024_DSH_VERSION未指定版本时上报的 DSH 版本号不设置
DSH1024_TELEMETRY_URL完整事件上报端点https://deepseek1024.com/api/v1/install-events
DSH1024_TELEMETRY_TIMEOUT_MS上传超时,范围 100–300002500

常见问题

Q: 这个插件装在哪个 profile 下?

A: 默认装到 --profile 参数指定的 profile,没有指定则用 web。配置项 profile 可以覆盖。宿主侧变更后需要重启 DeepSeek Harness 才生效。

Q: 它会上报我的 IP、命令或者路径吗?

A: 不会。上报字段只有事件 UUID、客户端 UUID、插件 ID、profile、操作结果、起止时间、耗时、OS/架构、CLI 版本和错误码;没有 IP、命令、文件路径、提示词或 API Key。事件通过 fire-and-forget 上报,失败静默,不影响安装退出码。

Q: 目录里的插件是经过审核的吗?

A: 是的。/api/v1/registry 的 JSON 在被消费前会做严格 schema 校验(类型、GitHub URL 形态、分类 ID、count 与 plugins 长度一致等),不通过就抛错,旧的缓存兜底。安装器只接受校验通过的仓库 URL,并且只从 URL 自己派生出 github:owner/repo 参数,不会执行目录里的展示命令。

Q: 怎么彻底关掉遥测?

A: 跑一次 npx dsh1024 telemetry disable,身份文件和待发送队列会被一起清掉;或在当前进程设 DO_NOT_TRACK=1 / DSH1024_TELEMETRY=0(旧名 DSH_1024STORE_TELEMETRY 永久兼容)。需要时可用 telemetry reset 旋转身份并清空队列,telemetry status 查看当前状态。

Q: 跟旧的 @dsh-1024store/clidsh-1024store 是什么关系?

A: 新包 dsh1024 取代了这两个已弃用的包。命令换名字、行为不变;旧的本地配置($DSH_HOME/.dsh-1024store/ 下的身份、receipt、pending)会被继续复用,不需要迁移。

Q: 离线时还能用吗?

A: 目录 API 拉取失败时,插件会回退到上一次成功的结果(source: 'cache'),保证面板不会白屏;插件的安装/卸载要依赖官方 dsh 命令的网络,因此离线状态下变更操作会失败。

上手难度

入门 — 只要会 dsh plugin --profile web add dsh1024 就能用,UI 在三个固定入口都能找到;高级用法(环境变量调优、CLI 包装器、telemetry 命令)按需查阅 README 即可。

已知问题与限制

  • 仓库子目录实际名为 packages/dsh1024,npm 发布包名是 dsh1024;落地页登记的 packages/dsh-1024store 路径与 README 中 dsh plugin --profile web add dsh1024 不一致,从 GitHub 路径形式安装前请确认路径正确。
  • preflight 脚本会强制要求客户端 bundle、cordis patch、目录 URL、三个 UI 入口都齐全;任何一处被改动都会让 npm test 失败。
  • 目录缓存使用 last-good fallback:API 不可达时返回 source: 'cache',但只在 5 分钟 TTL 内有效;超过 TTL 且网络不通时会返回 500。
  • 安装/卸载失败时,如果官方 CLI 退出码为 0 但 profile 实际未变更,CLI 包装器会返回 PROFILE_NOT_UPDATED 错误码,并提示「installed but could not verify」。
  • 同一个 DSH HOME 下并发安装会被互斥锁串行化,最多等待 30 秒;同一时间只允许一个插件操作,重复请求返回 409。
  • dsh1024 本身不能通过店内面板被卸载,接口会直接返回 plugin cannot be uninstalled here

收录徽章

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/dsh-1024store)

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

返回插件目录