# submit-dsh-plugin

Adopt this skill: https://proskills.md/skills/other/imsai-sh-awesome-deepseek-harness-plugins-skills-submit-dsh-plugin

Page: https://proskills.md/skills/other/imsai-sh-awesome-deepseek-harness-plugins-skills-submit-dsh-plugin
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/submit-dsh-plugin/SKILL.md
size: 10365
sha: b8c7ef7b49c9987a054e9e673f72c1afe2c7e08e
upstream: https://github.com/imsai-sh/awesome-deepseek-harness-plugins/blob/main/skills/submit-dsh-plugin/SKILL.md

````text
---
name: submit-dsh-plugin
description: 验证并提交 DeepSeek Harness 插件到 imsai-sh/awesome-deepseek-harness-plugins 社区目录。适用于插件作者要求收录、发布或提交自己的插件，创建目录 JSON，修复目录提交 PR，或者发起合规 PR。检查公开仓库、dsh-plugin topic、dsh.bundle.patch、作者测试证据、双语元数据和单文件差异，并在获得授权后执行 fork、push 和创建 PR。
---

# 提交 DSH 插件

从插件作者的仓库准备一份聚焦的目录收录 PR。始终把 `catalog/plugins/*.json` 视为贡献者唯一可以编辑的目录源数据。

## 安全与范围

- 不得在插件提交 PR 中编辑 `README.md`、`catalog/README.md`、工作流或脚本。两个 README 是 bot 生成的目录投影，合并后由 CI 自动刷新。
- 不得仅为了检查插件而安装依赖、运行生命周期脚本、构建或执行插件代码。运行作者代码前必须先征得同意。
- 保留所有无关的本地改动。如果目录仓库工作区不干净，应停止操作；除非用户指定一个干净 worktree，或明确界定现有改动的范围。
- 将“准备”或“起草”理解为仅做本地修改。只有用户明确要求“提交”“推送”或“创建 PR”时，才视为已授权在展示准确目标后执行 fork、push 和创建 PR。
- 不得手动合并 PR，也不得修改生成投影。合规的非草稿新增类目录 PR 会在可信静态审查通过后自动合并；修改或删除既有条目的 PR 即使静态审查通过也不会自动合并，必须等待目录仓库维护者人工审核后手动合并。合并进入 `main` 后，CI 自动把目录条目同步到网站数据库（D1）并重新生成两个 README，即自动同步，无任何维护者手工步骤。

## 1. 明确提交信息

确定以下内容：

- 插件 ID：仓库级插件为 `owner/repository`；monorepo 子包插件为 `owner/repository/sub/dir`，前两段之后的路径段指向仓库内的子目录
- 插件名称：仓库级插件通常与仓库名一致，子目录 ID 默认取最后一个路径段（子包目录名）
- 一个主要目录分类
- 客观的英文与中文简介
- 作者实际执行的测试命令和结果

ID 各段仅限 `A-Za-z0-9_.-` 字符，路径段不得是 `.` 或 `..`，总长不超过 201 字符。无论 ID 是否携带路径，条目的 `repository` 字段始终是由前两段推导的仓库根 URL `https://github.com/owner/repository`。ID 的路径段锁定插件源码位置：子目录 ID 的 `<sub/dir>/package.json` 必须恰好是插件的 manifest。安装入口只来自发布到 npm 的包（1024 Store 仅提供 npm 安装），目录条目本身只记录源码仓库。

目录仓库固定使用 `https://github.com/imsai-sh/awesome-deepseek-harness-plugins`。创建文件前，读取其当前 checkout 中的 `CONTRIBUTING.md` 和 `catalog/categories.json`；如果线上仓库规范与本 Skill 不同，以线上规范为准。

选择分类或编写 PR 时，读取 [references/submission-reference.md](references/submission-reference.md)。

## 2. 检查插件仓库

先完成只读检查：

1. 确认仓库公开且存在默认分支。
2. 确认仓库包含 `dsh-plugin` GitHub topic。如果缺少 topic、用户拥有该仓库且已授权外部写入，才可执行 `gh repo edit owner/repository --add-topic dsh-plugin`。topic 作用于仓库本身：`gh repo edit` 的参数只取 ID 的前两段 `owner/repository`，子目录 ID 的路径段不参与。
3. 定位插件的 manifest：两段 ID 可使用根目录或任意嵌套的 `package.json`（排除 `node_modules`）；子目录 ID 则必须在 `<sub/dir>/package.json` 恰好找到 manifest——ID 的路径就是插件在仓库中的位置，仓库里其他位置的 manifest 不算数。
4. 确认其中声明了非空字符串 `dsh.bundle.patch`。
5. 相对于声明该字段的 `package.json` 解析补丁路径；拒绝绝对路径、反斜杠以及跳出仓库的路径。
6. 确认 manifest 和引用的补丁都存在于 GitHub 默认分支，而不只是尚未推送的本地提交。
7. 向作者说明**安装可用性**：1024 Store 只提供 npm 安装，不再提供 GitHub 源码安装。
   网站会自动探测 manifest 中声明的 npm 包名；只要 npm 上的 latest manifest 声明 `dsh.bundle`，插件即可安装（`repository` 回链缺失或不一致不影响验证）。
   **未发布 npm 包不影响收录**：插件照常收录，以浏览模式展示（有仓库链接，无安装命令），PR 评论会提示作者发布 npm 包后目录自动检测、无需追加 PR。
8. 记录作者实际执行的兼容性测试。如果尚未测试，应停止并要求作者先测试；目录自动审查不会执行第三方代码。

使用 GitHub 或 `gh` 获取远程默认分支证据。不得用仅存在于本地的文件作为证明。

## 3. 准备干净的目录分支

优先复用干净的目录 checkout。仅本地准备时，直接克隆上游目录仓库，不创建 fork。已授权正式提交时，使用 GitHub CLI fork 并克隆，或者把用户已有的 fork 添加为推送 remote。保留上游仓库 remote，拉取其默认分支，然后基于完整插件 ID 创建聚焦分支，例如：

```text
add-owner-repository
add-owner-repository-sub-dir
```

子目录 ID 的分支名包含 slug 化的路径段，这样同一仓库的两个子包提交不会撞到同一个分支名。

不得把目录条目放进插件仓库。不得基于另一个尚未合并的贡献分支创建本次分支。

## 4. 创建目录条目

解析本 Skill 目录的绝对路径，然后运行其中的确定性创建脚本：

```bash
node <skill-directory>/scripts/create-catalog-entry.mjs \
  --catalog-root <catalog-checkout> \
  --id owner/repository \
  --category skill \
  --description-en "A factual English description." \
  --description-zh "客观、具体的中文说明。"
```

monorepo 子包传入完整 ID，例如 `--id owner/repository/packages/foo`；脚本会保持 `repository` 为仓库根 URL，并把路径段编入文件名。

仅当展示名称需要不同于默认值（两段 ID 为仓库名，子目录 ID 为最后一个路径段）时传入 `--name`。仅当需要覆盖当天 UTC 日期时传入 `--added YYYY-MM-DD`。

脚本必须拒绝未知分类、重复 ID（不区分大小写，含路径段）、无效 ID 和已存在的目标文件。同一仓库以不同子目录路径提交多个条目是允许的，只要每个完整 ID 唯一。不得绕过这些错误手工创建文件。

## 5. 验证单文件约束

要求当前分支相对上游最新默认分支的完整差异只包含一个新增文件：

```text
A catalog/plugins/<owner>--<repository>.json
```

文件名由完整 ID 推导：每个 `/` 分隔的段转为全小写、把连续非字母数字字符替换成 `-`，再用 `--` 连接。子目录 ID 的路径段同样编入文件名，例如 `owner/repository/packages/foo` → `A catalog/plugins/owner--repository--packages--foo.json`。文件始终平铺在 `catalog/plugins/` 下，不创建子目录。

然后执行以下检查：

1. 再次解析 JSON。
2. 确认文件名与规范化后的 `id` 一致。
3. 确认中英文简介客观、中性、具体，且有仓库证据支持。
4. 确认 `added` 是提交日期。
5. 只暂存该 JSON 文件，并运行 `git diff --cached --check`。
6. 检查暂存差异是否包含凭据、私有路径、邮箱、token 或无关数据。

如果可以针对已提交分支在本地运行目录仓库的可信审查脚本，应传入上游基础 SHA、当前分支 HEAD SHA、作为 `PLUGIN_REVIEW_ROOT` 的目录 checkout，以及已认证的 GitHub token。不得把该静态审查描述成插件运行测试。

## 6. 提交并创建 PR

使用聚焦的提交信息，写入完整插件 ID，例如：

```text
catalog: add owner/repository
catalog: add owner/repository/packages/foo
```

推送前，说明 fork、分支、上游仓库和唯一暂存的文件。只有获得授权后才可推送并创建 PR。

使用 [references/submission-reference.md](references/submission-reference.md) 中的模板编写 PR，填写真实的测试命令和结果，并保持“允许维护者修改”开启。
仓库根 PR 模板只包含插件与目录提交确认清单，逐项如实完成即可。

## 7. 跟进自动检查

创建 PR 后：

1. 返回 PR URL。
2. 检查 `Plugin submission review / static-review` 及其机器人评论。
3. 如果检查失败，PR 会保持打开且不会被工作流自动关闭；仅通过修改目录 JSON 修复。不得为了通过检查而加入 README 或其他生成投影。
4. 非草稿新增类 PR 检查通过后会自动 squash merge，GitHub 随后将其记录为已合并（因此不再保持打开）；草稿 PR 会在标记 ready for review 后重新检查并自动合并。
5. 修改或删除既有条目的 PR 检查通过后，机器人会评论说明需要维护者人工审核；此时无须任何贡献者操作，等待维护者手动合并即可，不要催促或自行合并。
6. 不要请求维护者批准 fork CI，也不要手动合并；目录 PR 不运行贡献者分支上的通用 CI。

静态审查通过即表示该目录元数据符合收录规则；新增类 PR 随之触发自动合并，修改/删除类 PR 则进入维护者人工审核。合并进入 `main` 后，catalog-sync 工作流会自动把条目同步到线上目录数据库并刷新 `README.md` 与 `catalog/README.md`（github-actions[bot] 提交），插件随即出现在 [deepseek1024.com](https://deepseek1024.com/) 与两个 README 目录中。该结果仍不代表对第三方插件行为、安全性或质量的背书。

## 已存在的条目与更新

如果完整插件 ID 已经存在（不区分大小写），不得创建重复条目。唯一性按完整 ID 判断：同一仓库已存在其他条目（例如仓库级条目或另一个子目录条目）并不阻止提交一个新的、不同的 ID。需要修正或下架既有条目时，可以提交只修改或删除对应 `catalog/plugins/*.json` 文件的 PR：静态审查照常运行并逐个校验修改后的条目，但此类 PR 不会自动合并，必须由维护者人工审核后手动合并。提交前应向用户说明这一等待环节。
````

## File: skills/submit-dsh-plugin/scripts/create-catalog-entry.mjs
size: 6822
sha: ad414e1c548ce6f29fe1b7c12e8be3be019070e7
upstream: https://github.com/imsai-sh/awesome-deepseek-harness-plugins/blob/main/skills/submit-dsh-plugin/scripts/create-catalog-entry.mjs

```text
#!/usr/bin/env node

import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises'
import path from 'node:path'
import process from 'node:process'

const allowedOptions = new Set([
  'catalog-root',
  'id',
  'name',
  'category',
  'description-en',
  'description-zh',
  'added',
])

function usage() {
  return `用法：
  node create-catalog-entry.mjs \\
    --catalog-root <path> \\
    --id <owner/repository[/sub/dir]> \\
    --category <category-id> \\
    --description-en <text> \\
    --description-zh <text> \\
    [--name <display-name>] \\
    [--added <YYYY-MM-DD>] \\
    [--dry-run]

monorepo 子包在 --id 中追加仓库内路径段（例如 owner/repository/packages/foo），
路径段锁定插件 manifest 的位置（<sub/dir>/package.json）。`
}

function fail(message) {
  throw new Error(message)
}

function parseArgs(argv) {
  const values = new Map()
  let dryRun = false
  for (let index = 0; index < argv.length; index += 1) {
    const argument = argv[index]
    if (argument === '--help' || argument === '-h') return { help: true, values, dryRun }
    if (argument === '--dry-run') {
      dryRun = true
      continue
    }
    if (!argument.startsWith('--')) fail(`意外参数：${argument}`)
    const key = argument.slice(2)
    if (!allowedOptions.has(key)) fail(`未知选项：--${key}`)
    if (values.has(key)) fail(`重复选项：--${key}`)
    const value = argv[index + 1]
    if (value === undefined || value.startsWith('--')) fail(`--${key} 缺少参数值`)
    values.set(key, value)
    index += 1
  }
  return { help: false, values, dryRun }
}

function required(values, key) {
  const value = values.get(key)?.trim()
  if (!value) fail(`缺少必填选项：--${key}`)
  return value
}

function slugPart(value) {
  return value
    .toLocaleLowerCase('en-US')
    .replace(/[^a-z0-9]+/g, '-')
    .replace(/^-+|-+$/g, '')
}

// 文件名覆盖完整 ID：每个 `/` 分隔的段转小写并把连续非字母数字字符替换成
// `-`，再用 `--` 连接（与目录仓库 scripts/lib/catalog-entry.mjs 的
// pluginFileName 保持一致），因此同一仓库的不同子目录条目得到不同文件名。
function pluginFileName(id) {
  return `${id.split('/').map(slugPart).join('--')}.json`
}

// 插件 ID 为 owner/repository，可追加仓库内路径段（monorepo 子包）。路径段
// 锁定插件 manifest 在仓库中的目录并与 git 树路径逐段比对，因此 `.` 与 `..`
// 段一律拒绝；201 字符上限与目录仓库的可信审查保持一致。
const idSegmentPattern = /^[A-Za-z0-9_.-]+$/

function isValidPluginId(id) {
  if (id.length > 201) return false
  const segments = id.split('/')
  return segments.length >= 2
    && segments.every(segment => idSegmentPattern.test(segment) && segment !== '.' && segment !== '..')
}

function isIsoDate(value) {
  if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) return false
  const parsed = new Date(`${value}T00:00:00.000Z`)
  return Number.isFinite(parsed.getTime()) && parsed.toISOString().slice(0, 10) === value
}

async function readJson(file) {
  try {
    return JSON.parse(await readFile(file, 'utf8'))
  } catch (error) {
    fail(`无法读取 ${file}：${error instanceof Error ? error.message : String(error)}`)
  }
}

function validateDescription(value, locale) {
  const description = value.trim()
  if (description.length === 0 || description.length > 1000) {
    fail(`${locale}简介长度必须为 1–1000 个字符`)
  }
  return description
}

async function main() {
  const { help, values, dryRun } = parseArgs(process.argv.slice(2))
  if (help) {
    console.log(usage())
    return
  }

  const root = path.resolve(required(values, 'catalog-root'))
  const id = required(values, 'id')
  if (!isValidPluginId(id)) {
    fail('--id 必须使用 owner/repository[/sub/dir] 格式（各段仅限 A-Za-z0-9_.-，路径段不能是 . 或 ..，总长不超过 201 字符）')
  }
  const idSegments = id.split('/')
  const [owner, repositoryName] = idSegments
  // 默认展示名称取 ID 的最后一段：两段 ID 即仓库名，子目录 ID 即子包目录名。
  const name = (values.get('name') ?? idSegments.at(-1)).trim()
  if (name.length === 0 || name.length > 120) fail('--name 长度必须为 1–120 个字符')

  const categoriesFile = path.join(root, 'catalog/categories.json')
  const pluginsDirectory = path.join(root, 'catalog/plugins')
  const categories = await readJson(categoriesFile)
  const categoryIds = new Set(categories?.categories?.map(category => category?.id))
  const category = required(values, 'category')
  if (!categoryIds.has(category)) {
    fail(`未知分类“${category}”。可用分类：${[...categoryIds].join(', ')}`)
  }

  const added = (values.get('added') ?? new Date().toISOString().slice(0, 10)).trim()
  if (!isIsoDate(added)) fail('--added 必须是 YYYY-MM-DD 格式的有效日期')

  const entry = {
    $schema: '../schema/plugin.schema.json',
    id,
    name,
    // repository 始终是由 ID 前两段推导的仓库根 URL；子目录路径只存在于 id 中。
    repository: `https://github.com/${owner}/${repositoryName}`,
    category,
    description: {
      en: validateDescription(required(values, 'description-en'), '英文'),
      zh: validateDescription(required(values, 'description-zh'), '中文'),
    },
    added,
  }

  let existingFiles
  try {
    existingFiles = (await readdir(pluginsDirectory)).filter(file => file.endsWith('.json'))
  } catch (error) {
    fail(`无法读取 ${pluginsDirectory}：${error instanceof Error ? error.message : String(error)}`)
  }
  // 唯一性按完整 ID（不区分大小写）判断：同一仓库允许以不同子目录路径
  // 出现在多个条目中，因此不做仓库级别的重复拦截。
  for (const file of existingFiles) {
    const existing = await readJson(path.join(pluginsDirectory, file))
    if (existing?.id?.toLocaleLowerCase('en-US') === id.toLocaleLowerCase('en-US')) {
      fail(`插件 ID 已存在于 catalog/plugins/${file}`)
    }
  }

  const relativeTarget = path.posix.join('catalog/plugins', pluginFileName(id))
  const target = path.join(root, relativeTarget)
  const serialized = `${JSON.stringify(entry, null, 2)}\n`
  if (dryRun) {
    console.log(serialized.trimEnd())
    console.error(`试运行：将创建 ${relativeTarget}`)
    return
  }

  await mkdir(pluginsDirectory, { recursive: true })
  try {
    await writeFile(target, serialized, { flag: 'wx' })
  } catch (error) {
    if (error?.code === 'EEXIST') fail(`拒绝覆盖 ${relativeTarget}`)
    throw error
  }
  console.log(`已创建 ${relativeTarget}`)
}

main().catch(error => {
  console.error(`错误：${error instanceof Error ? error.message : String(error)}`)
  console.error(usage())
  process.exitCode = 1
})
```

## File: skills/submit-dsh-plugin/references/submission-reference.md
size: 4668
sha: b06ffb5e41c08956c9c4f1310af9468d883a4b96
upstream: https://github.com/imsai-sh/awesome-deepseek-harness-plugins/blob/main/skills/submit-dsh-plugin/references/submission-reference.md

````text
# 提交参考

## 分类指南

选择最能代表插件主要用户价值的单一分类。

| ID | 适用范围 |
| --- | --- |
| `ui` | 输入框、侧边栏、对话界面和其他 UI 功能 |
| `theme` | 皮肤、颜色、字体排版和视觉外观 |
| `session` | 消息、历史记录、导航、导入导出和分享 |
| `memory` | 召回、持久上下文和知识保存 |
| `tools` | Agent 工具和外部能力 |
| `skill` | Skill 库、加载器、路由和 Skill 管理 |
| `workflow` | 自动化、编排、调度和 Agent 循环 |
| `notify` | 通知和第三方通信集成 |
| `model` | 模型提供商、凭据、路由、用量和计费 |
| `dev` | 开发工具、运行时、协议、调试和部署 |
| `fun` | 游戏、宠物和以娱乐为主要目的的插件 |

如果两个分类都合适，应按用户安装插件后获得的主要能力分类，而不是按内部实现分类。

## 元数据规则

- 只能使用以下字段：`$schema`、`id`、`name`、`repository`、`category`、`description`、`added`。
- `id` 为 `owner/repository`，monorepo 子包插件为 `owner/repository/sub/dir`：前两段之后的路径段指向仓库内子目录。各段仅限 `A-Za-z0-9_.-` 字符，路径段不得是 `.` 或 `..`，总长不超过 201 字符。
- 唯一性按完整 `id`（不区分大小写）判断：同一仓库可以以不同子目录路径出现在多个条目中，重复的 `id` 必须拒绝。
- 将 `repository` 固定为由 `id` 前两段推导的仓库根 URL `https://github.com/<owner>/<repository>`；子目录路径只出现在 `id` 中，绝不出现在 `repository` URL 里。
- `name` 默认取 `id` 的最后一段（两段 ID 即仓库名，子目录 ID 即子包目录名）。
- 根据完整 `id` 生成文件名：每个 `/` 分隔的段转为全小写、把连续的非字母数字字符替换成 `-`，再用 `--` 连接。示例：`owner/repository` → `<owner>--<repository>.json`；`owner/repository/packages/foo` → `owner--repository--packages--foo.json`。文件平铺在 `catalog/plugins/` 下。
- `id` 的路径段锁定插件源码位置：子目录 ID 的路径必须恰好指向声明 `dsh.bundle.patch` 的 `package.json` 所在目录（即 `<sub/dir>/package.json`）。
- 1024 Store 只提供 npm 安装。网站会探测该 manifest 声明的 npm 包名：latest npm manifest 存在且声明 `dsh.bundle` 时插件即可安装；npm manifest 的 `repository` 字段缺失或与目录仓库不一致均不影响验证。未发布 npm 包的插件以浏览模式收录，展示仓库链接、不展示安装命令。
- 保持 `description.en` 和 `description.zh` 客观、中性且具体。
- 避免最高级、号召性语言、排名、Star 数量以及仓库证据无法支持的宣传。
- `added` 使用提交日期。

## PR 正文模板

替换所有占位符，并填写真实的测试证据。摘要里的链接文本使用完整插件 ID，链接目标始终是仓库根 URL。`子目录` 一行仅子目录 ID 保留（其值等于 ID 前两段之后的路径），两段 ID 删除该行；子目录 ID 的 `Manifest` 必须恰好是 `<sub/dir>/package.json`。

自动审查失败时，PR 会保持打开以便继续推送修复，工作流永远不会自动关闭 PR；非草稿新增类 PR 通过后会自动 squash merge，并由 GitHub 记录为已合并。修改或删除既有条目的 PR 通过静态审查后不会自动合并，需等待维护者人工审核后手动合并。

仓库根 PR 模板只包含插件与目录提交清单，逐项如实完成即可；不得把目录投稿描述成
网站或 API 变更（网站与 CLI 的源码在 dsh-1024store 仓库，那不是目录投稿的去处）。

```markdown
## 摘要

将 [`<插件 ID>`](https://github.com/owner/repository) 添加到 DeepSeek Harness 插件目录。

## 插件验证

- Manifest：`<path>/package.json`
- 子目录：`<sub/dir>`（其 `<sub/dir>/package.json` 即插件 manifest；仅子目录 ID 保留本行）
- Bundle patch：`<path/to/patch>`
- 测试命令：`<实际执行的命令>`
- 测试结果：`<简洁的真实结果>`

## 目录提交确认

- [x] 本 PR 只新增一个 `catalog/plugins/*.json` 文件，不包含其他改动
- [x] 插件仓库声明了 `dsh.bundle.patch`，并已提交引用的补丁文件
- [x] 作者已经测试插件行为和兼容性
- [x] 插件仓库已添加 `dsh-plugin` topic
- [x] 中英文简介中性且准确
- [x] 我理解检查失败时 PR 会保持打开以便修复；非草稿 PR 通过后会自动合并，合并后由 CI 自动同步到网站目录与 README，且收录不代表对插件行为、安全性或质量的背书
```
````

## File: skills/submit-dsh-plugin/agents/openai.yaml
size: 249
sha: 72027588929e70f6ae08797f7a31e2e08a777fa1
upstream: https://github.com/imsai-sh/awesome-deepseek-harness-plugins/blob/main/skills/submit-dsh-plugin/agents/openai.yaml

```text
interface:
  display_name: "提交 DSH 插件"
  short_description: "检查插件仓库并创建符合规范的 DSH 社区目录提交 PR"
  default_prompt: "使用 $submit-dsh-plugin 检查我的 DeepSeek Harness 插件并提交到社区目录。"
```

## File: README.md
upstream: https://github.com/imsai-sh/awesome-deepseek-harness-plugins/blob/main/README.md

````text
# Awesome DeepSeek Harness Plugins

<!-- 本文件由 scripts/build-readme.mjs 从 deepseek1024.com 目录 API 自动生成，请勿手工编辑。 -->

面向 [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness)（`dsh`）生态的社区插件目录，共收录 **14059** 个插件（含 PR 收录与 GitHub `dsh-plugin` topic 自动发现），目录数据更新于 2026-11-15。

> [!TIP]
> **新开源项目：[Fish Pocket](https://github.com/imsai-sh/fish-pocket)**
>
> 让 DeepSeek Harness 运行在 iPhone 和 iPad 上，随时随地使用。欢迎 Star 关注、一起共建。

> 📦 **仓库拆分公告**：自 2026-08-25 起，deepseek1024.com 网站与 `dsh1024` CLI 的源码已拆分至独立仓库 [imsai-sh/dsh-1024store](https://github.com/imsai-sh/dsh-1024store)。本仓库从此专注插件目录（awesome 清单）与收录流程；网站与 CLI 相关的 issue / PR 请移步新仓库，插件收录照旧在这里提交。

**但这个项目不只是一份 awesome list。** 它还包括一个在线插件市场、一个把市场装进 `dsh` 本体的插件，以及一套免费的公开查询 API——这些应用代码开源在姊妹仓库 [dsh-1024store](https://github.com/imsai-sh/dsh-1024store)；本仓库专注目录本身：经静态校验的 PR 收录流水线与自动生成的目录 README，目录数据另有自动收集服务持续喂入。全部代码 MIT 协议，fork 之后就能部署成你自己的插件市场。

[![DSH 1024Store 插件市场首页](https://raw.githubusercontent.com/imsai-sh/awesome-deepseek-harness-plugins/assets/homepage.zh.png?v=e3971a6d00b2)](https://deepseek1024.com/)

[在线网站](https://deepseek1024.com/) · [API 文档](https://github.com/imsai-sh/dsh-1024store/blob/main/web/docs/api.md) · [英文目录](catalog/README.md) · [提交插件](CONTRIBUTING.md) · [网站与 CLI 源码](https://github.com/imsai-sh/dsh-1024store)

[![GitHub Stars](https://img.shields.io/github/stars/imsai-sh/awesome-deepseek-harness-plugins?style=social)](https://github.com/imsai-sh/awesome-deepseek-harness-plugins/stargazers)

<div align="center">
  <strong>DSH插件社区</strong><br><br>
  <img src="docs/assets/wechat-group.jpg" alt="DSH插件社区微信二维码" width="280">
</div>

## 项目亮点

### 在线插件市场（开源 · 可一键自部署）

[deepseek1024.com](https://deepseek1024.com/) 提供搜索、分类筛选、安装排行榜、插件详情与 GitHub 活跃度数据。整站跑在 Cloudflare Workers + D1 + KV 上，源码在 [dsh-1024store](https://github.com/imsai-sh/dsh-1024store) 的 [`web`](https://github.com/imsai-sh/dsh-1024store/tree/main/web)。

想要一个完全属于自己的插件市场：fork [dsh-1024store](https://github.com/imsai-sh/dsh-1024store)，把 `web/wrangler.jsonc` 里的 `routes` 换成你自己的域名，创建 D1 数据库与 KV 命名空间，配齐 `secrets.required` 列出的 Worker secret，然后本地执行 `npm run db:migrate:remote` 和 `npm run deploy` 完成部署（部署是显式的本地操作，push 不会自动上线）。完整步骤见该仓库的[部署文档](https://github.com/imsai-sh/dsh-1024store/blob/main/web/docs/deployment.md)。

### 把插件市场装进 dsh 本体

不想切浏览器，就把市场本身作为插件装进 DeepSeek Harness：

```bash
dsh plugin --profile web add dsh1024@latest
```

重启后「设置」里会出现独立的 **1024 Store** 入口，「设置 → 插件」下也会多出一个 **1024 Store（数量）** 标签页，可以直接搜索目录、按分类筛选、识别已安装状态、安装与卸载，并显示操作进度。安装器只接受目录 API 返回并通过严格语法校验的结构化目标：优先使用已发布 npm 包，否则使用与插件 ID、仓库 URL 一致的 GitHub 源码规格；展示命令不会被直接执行。源码见 [`plugin`](https://github.com/imsai-sh/dsh-1024store/tree/main/plugin)。

### 定时自动收集 + 格式校验

这是本目录与多数插件市场最大的区别：**目录不靠人肉维护，收录前一定过校验。**

- **定时收集**：自动收录带 `dsh-plugin` topic 的 GitHub 仓库，增量抓取新建与新推送的仓库，并定期全量对账——长期不活跃的仓库不会被漏收，掉了 topic 也只在一次成功的全量对账后才下架。
- **格式校验**：每个候选仓库都要通过静态校验——读取默认分支的 Git tree，检查 `package.json`、`dsh.bundle.patch` 字段，以及 patch 文件在同一棵 tree 中确实存在。**全程只读文件，绝不安装依赖、绝不执行仓库代码。** 校验不通过就不进目录。
- **自动同步**：PR 合并后由 CI 自动同步目录到网站数据库并刷新本 README，贡献者和维护者都不需要手工改任何生成文件。

数据来源与校验语义见 [目录数据来源文档](docs/plugin-discovery.md)。

### 免费查询 API

目录数据免费开放，匿名即可调用：

```bash
curl 'https://api.deepseek1024.com/v1/plugins/search?q=memory'
```

匿名调用每天 50 次、每分钟 10 次；用 GitHub 账号登录网站创建 API Key 后提升到每天 500 次、每分钟 30 次。另有 `/api/v1/registry` 返回按安装热度排序的精简目录快照（至多 500 条）。完整端点、参数与错误码见 [API 参考](https://github.com/imsai-sh/dsh-1024store/blob/main/web/docs/api.md)。

## 参与进来

这个项目由社区维护，下面每一种参与都真的有用：

- **点个 Star** — [Star 本仓库](https://github.com/imsai-sh/awesome-deepseek-harness-plugins/stargazers)是成本最低、帮助最大的支持，能让更多 DeepSeek Harness 用户找到这里。
- **提 Issue** — 插件信息有误、分类不合理、网站或 API 有问题、想要新功能，都欢迎[提 Issue](https://github.com/imsai-sh/awesome-deepseek-harness-plugins/issues/new)。
- **发 PR** — [提交你自己的插件](CONTRIBUTING.md)或改进目录流水线，欢迎直接发 [Pull Request](https://github.com/imsai-sh/awesome-deepseek-harness-plugins/pulls)；网站、CLI 与市场插件的改进请发到 [dsh-1024store](https://github.com/imsai-sh/dsh-1024store)。
- **Fork 自建** — 想要自己的插件市场，[Fork dsh-1024store](https://github.com/imsai-sh/dsh-1024store/fork) 之后按上面的步骤配置即可，MIT 协议，随便改。

## 安装插件并计入统计

1024 Store 只提供 npm 安装：插件详情页展示的命令安装的是作者发布到 npm、声明 `dsh.bundle` 的包；尚未发布 npm 包的插件以浏览模式收录（有仓库链接，无安装命令）。网站优先提供开源包装 CLI；它会调用官方 DeepSeek Harness 插件命令、校验 profile 的真实安装结果，并把匿名安装结果可靠地上报到排行榜：

```bash
dsh1024 plugin --profile web add <npm-package>
```

首次使用先一次性全局安装：`npm install -g dsh1024`。它与官方命令只差一个名字——`plugin` 之后的参数原样转发给官方 CLI，不增删、不改写、不重排，包装器只负责在结束后核对 profile 并记录一条匿名安装结果。参数不会写入遥测或本地 receipt。

monorepo 子目录插件的标识形如 `owner/repo/packages/foo`，每个子包发布并安装自己的 npm 包，同仓库的兄弟插件各自独立计数。

统计身份是保存在 `$DSH_HOME/.dsh-1024store/` 的随机安装实例 ID，不是实名用户或账号。CLI 不上传命令输出、路径、用户名、环境变量、会话内容或原始错误；可用 `npx dsh1024 telemetry disable`、`DO_NOT_TRACK=1` 或 `DSH1024_TELEMETRY=0`（旧变量名 `DSH_1024STORE_TELEMETRY` 仍兼容）关闭。直接使用官方 `dsh plugin` 命令仍然可用，但不会计入 DSH 1024Store 安装统计。详细字段、口径、存储和部署方式见 [安装统计设计](https://github.com/imsai-sh/dsh-1024store/blob/main/web/docs/install-analytics.md)，CLI 源码见 [`plugin`](https://github.com/imsai-sh/dsh-1024store/tree/main/plugin)。

## 提交插件

### 使用 Agent Skill 提交（推荐）

如果你使用 Codex、Claude Code、Cursor 或其他兼容 Agent Skills 的编程助手，可以安装本仓库提供的提交 Skill：

```bash
npx skills add imsai-sh/awesome-deepseek-harness-plugins --skill submit-dsh-plugin -g
```

安装后告诉助手：

```text
使用 $submit-dsh-plugin 检查并提交我的 DeepSeek Harness 插件。
```

该 Skill 会检查插件仓库、生成唯一允许提交的目录 JSON、验证变更范围，并在获得授权后创建 PR。新增条目的非草稿 PR 通过静态审查后会自动合并；修改或删除既有条目的 PR 同样会跑静态审查，但不会自动合并，需要维护者人工审核后手动合并。合并后 CI 自动同步目录到网站数据库并刷新本 README，贡献者和维护者都不需要手工更新任何生成文件。查看 [Skill 源码](skills/submit-dsh-plugin/SKILL.md)。

### 手动提交

欢迎把你的 DeepSeek Harness 插件提交到本目录。请阅读 [CONTRIBUTING.md](CONTRIBUTING.md)，通过 PR 提交一个新的结构化插件文件；自动审查将验证提交范围和最基础的 DeepSeek Harness 插件配置，通过后自动合并，并由 CI 自动同步到网站与本 README。需要修正或下架既有条目时也可以发 PR，静态审查照常运行，但这类 PR 由维护者人工审核后合并。

安装命令以插件详情页展示的 npm 包为准：`dsh1024 plugin --profile web add <npm-package>`（首次使用先 `npm install -g dsh1024`）。

## 项目定位

本项目与 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 都服务于 DeepSeek Harness 插件生态。在继承其目录数据与社区整理思路的基础上，本项目把「一份人工维护的列表」扩展成一套开源、可自部署的插件市场基建：在线市场网站、dsh 内置市场插件、静态校验的 PR 收录流水线与免费查询 API，并由自动收集服务持续补充目录数据，具体见上文[项目亮点](#项目亮点)。

## 项目结构

```text
catalog/plugins/    插件提交表单与 curated 元数据（每个插件一个 JSON）
catalog/categories.json  分类定义（唯一分类信源）
catalog/schema/     插件提交 JSON Schema
skills/             面向贡献者的可安装 Agent Skills
scripts/            提交审查、目录同步与 README 生成脚本
docs/               目录数据模型文档
```

网站与 CLI 的源码（`web` 与 `plugin`）在姊妹仓库 [dsh-1024store](https://github.com/imsai-sh/dsh-1024store)。线上目录数据的唯一信源是 Cloudflare D1；本 README 与 [catalog/README.md](catalog/README.md) 由 CI 从目录 API 全量生成，职责划分见 [仓库布局](docs/repository-layout.md)。

## 网站与 CLI 的本地运行与部署

网站与 CLI 的本地开发、D1 迁移与 Cloudflare 部署流程都在 [dsh-1024store](https://github.com/imsai-sh/dsh-1024store)：见其 [README](https://github.com/imsai-sh/dsh-1024store#readme) 与[部署文档](https://github.com/imsai-sh/dsh-1024store/blob/main/web/docs/deployment.md)。本仓库只需要 Node.js 22+ 与 `npm ci && npm test` 即可参与目录流水线开发。

## 致谢

感谢以下项目为本目录提供基础与参考：

- [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)：提供插件系统、`dsh.bundle` 规范和插件开发文档。
- [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)：提供初始插件目录数据和社区目录设计参考。

## 插件分类

分组默认折叠，点开即可展开。GitHub 对单个文件的渲染长度有上限，条目较多的分类只列出其中一部分（分类标题会写明列出了多少），完整目录请在[在线网站](https://deepseek1024.com/)搜索浏览。

- [UI 增强](#ui) (2698)
- [主题与外观](#theme) (504)
- [会话与消息](#session) (903)
- [记忆](#memory) (451)
- [工具与能力](#tools) (4081)
- [技能包](#skill) (1054)
- [工作流与自动化](#workflow) (786)
- [通知与集成](#notify) (515)
- [模型与账号接入](#model) (836)
- [开发与运行时](#dev) (1664)
- [娱乐](#fun) (567)

<a id="ui"></a>

<details>
<summary><strong>UI 增强</strong> · 显示 233 / 共 2698 个</summary>

- [01_content](https://github.com/Aisland-SJL/dsh-worktable/tree/HEAD/01_content) — 为控制台增加侧边栏应用抽屉和可停靠拆分工作区，形成项目实时控制台。
- [a2ui-render-in-dsh](https://github.com/baihui-ai/a2ui-render-in-dsh) — 在聊天中内联渲染交互式卡片，支持测验、表单、图表等并回传操作。
- [account-card](https://github.com/picoaide/picoaide-harness/tree/HEAD/packages/client/account-card) — 在客户端界面中显示账户信息。
- [acp-app](https://github.com/ChisaAlter/Deepseek-H
````
