# Bundle 分发与收录检查

## 依据

对照 [awesome-dsh-plugin 贡献指南](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md)。这是该目录的收录规范，不代表收录即经过安全审计。

## 本包满足的结构

- `package.json` 声明 `dsh.bundle.patch: ./cordis.patch.yml`。
- 包根的 patch 使用包名 `dsh-lsp-bridge` 挂载 `lsp`，不绑定个人绝对路径或 profile 名称。
- `main` 与 `exports["."]` 指向真实服务端 Cordis 插件；已有工具实现和测试，不是只有依赖的聚合包。
- `files` 包含源码、预生成客户端 Bundle、Bundle patch、示例与文档，无安装期脚本。GitHub 源安装不需要运行构建。
- 声明 `dsh.client.platform: web` 与 `exports["./client"]`，同一设置 UI 同时供 web 和 Desktop 使用；不虚构截图。
- Host 设置 schema 导入官方 `@deepseek-ai/schemastery`，按收录规范声明为 peerDependency，并以 devDependency 支撑独立测试；其余官方 Client 模块由宿主注入，客户端通过 ModuleLoader require，不作为运行依赖重复安装。
- web 和 desktop 使用同一个服务端 Bundle 与客户端 Bundle，区别仅在安装所用 CLI 和 profile。

## 发布前仍需人工完成

本地实现通过不等于满足全部收录条件。公开仓库为 `https://github.com/voidmind26/dsh-lsp-bridge`，采用 MIT 许可，并已在 `package.json` 声明 repository、homepage 和 bugs 元数据。

提交收录前仍需确认：

- 仓库创建满 1 天，且继续保持非归档与活跃维护状态。
- GitHub topic 包含 `dsh-plugin`（package.json keywords 不能替代仓库 topic）。
- 在目标 web / desktop 实例完成真实安装、工具调用及卸载验证。
- 在列表中核对是否已有重复条目，选择贴切类别（建议 `dev`）。

## 收录条目模板

向列表仓库仅添加 `data/plugins/voidmind26__dsh-lsp-bridge.yml`，不要手工修改其生成的 README。建议条目：

```yaml
url: https://github.com/voidmind26/dsh-lsp-bridge
name: voidmind26/dsh-lsp-bridge
category: dev
description:
  en: 'Multi-language LSP queries for DeepSeek Harness with a configuration UI, bounded workspace discovery, multi-root projects, and session-scoped server reuse.'
  zh: '为 DeepSeek Harness 提供多语言 LSP 查询、配置界面、有界工作区发现、多根项目及会话级服务器复用。'
```

英文描述是对方收录格式的必填字段，保留中英文描述；其余项目文档使用中文。若最终采用 monorepo，按贡献指南改为子目录 URL、`owner/repo#subname` 名称和对应文件名。

## 分发产物

在插件目录执行 `npm pack` 即可生成包含所有运行时代码的 `.tgz`，不依赖安装时编译。发布 npm 不是收录必需条件。也可将打包产物附到 GitHub Release；若使用可选 `tarball` 字段，必须是真实 GitHub Release HTTPS `.tgz` 地址。不要将版本化文件名放到会随发布变化的 `latest/download/` 地址中。

本项目不会自动发布 npm或提交收录 PR。GitHub topic、仓库描述等仓库元数据需使用 GitHub 管理接口维护。