# 分享与插件市场发布

本交付仅在本地打包，**未上传GitHub、npm或插件市场**。ZIP是可审阅源码，TGZ是npm标准可安装包。

## A. 给朋友
发送 `dsh-video-learning-0.3.5.tgz` 和README安装说明。朋友需自己配置Python/Pillow/FFmpeg，可选下载器/ASR。不要发送开发电脑的profile配置、installation-backup、tests/artifacts或模型。

使用Desktop自带CLI，先初始化后完整退出应用：
```powershell
& '<DSH安装目录>\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add '<完整路径>\dsh-video-learning-0.3.5.tgz'
```
朋友的目录不同，请替换占位路径。通用npm版DSH CLI默认不管理Electron的desktop profile。

## B. 准备公开GitHub仓库
1. 将源码ZIP解压后的根目录推到你自己的公开仓库。目录根应直接含package.json与cordis.patch.yml。
2. 添加仓库topic `dsh-plugin`。确认源码/README/许可证完整，无个人数据。
3. package.json按实际仓库填写（当前包没有虚构repository/author，发布前必须自己填）：
```json
"repository": {"type":"git","url":"git+https://github.com/YOUR_ACCOUNT/dsh-video-learning.git"},
"homepage": "https://github.com/YOUR_ACCOUNT/dsh-video-learning",
"bugs": {"url":"https://github.com/YOUR_ACCOUNT/dsh-video-learning/issues"},
"author": "你希望公开显示的作者名"
```
占位信息不是可直接发布的真实身份。填写后重新打包，不能只修改ZIP外的一个文件。

## C. npm公开发布（可选，推荐）
`npm pack`仅本地打包，`npm publish`会公开上传。必须使用你自己的npm账号、权限和2FA，不向AI发送密码/令牌。

发布前先检查名称是否仍可用；当前查不到公开包不等于已占名。若改包名，必须同步package.json.name、cordis.patch.yml的insert.name、index.js导出的name与显示元信息。

```powershell
npm pack --ignore-scripts
# 检查tarball，确认repository回链公开仓库，README与依赖说明正确。
npm login --registry=https://registry.npmjs.org/
npm publish .\dsh-video-learning-0.3.5.tgz --access public --registry=https://registry.npmjs.org/
```
本文件提供操作说明，不代表这些发布命令已执行。

## D. 插件市场收录
以当前awesome-dsh-plugin社区目录规则为准：
https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/blob/main/contributing.md

- 仓库真实可用、维护中，声明dsh.bundle，创建满1天，topic为dsh-plugin。
- 向目录仓库提交PR，仅新增 `data/plugins/YOUR_ACCOUNT__dsh-video-learning.yml`，不要手工改自动生成README。
- 条目参考：
```yaml
url: https://github.com/YOUR_ACCOUNT/dsh-video-learning
name: YOUR_ACCOUNT/dsh-video-learning
category: vision
description:
  en: 'Windows DSH toolkit for timestamped video evidence, restricted acquisition and optional offline transcription.'
  zh: 'Windows DSH视频证据工具，提供时间索引、受限视频获取和可选离线转写。'
# 不发布npm时可指向GitHub Release托管的https .tgz：
# tarball: https://github.com/YOUR_ACCOUNT/dsh-video-learning/releases/download/v0.3.5/dsh-video-learning-0.3.5.tgz
```
替换占位账号为真实仓库；`npm:`不是条目字段，npm关联通过包repository回链自动判断。npm关键词也不是自动收录开关。

可选择GitHub Release上传TGZ而不发npm；当前一些原生Discover索引仅输出已关联npm的条目，社区市场/网站则可含GitHub-only。公开GitHub＋npm＋目录PR是更完整的分发路线。

包内icon.svg可用于插件；社区目录卡片icon要求GitHub托管PNG/JPG/WebP，SVG不能填那里。可不填，回退作者头像。截图可在自己仓库screenshots.json声明，注意只用不含个人信息的示意或合成素材。

## 发布检查表
- [ ] 作者与公开仓库由用户确认，repository/homepage/bugs真实。
- [ ] 私人视频/缓存/模型/账号/本机安装记录不入包。
- [ ] Windows、NTFS、Python与已验证FFmpeg要求明确。
- [ ] 无自动安装期脚本，setup默认只检查。
- [ ] 真实平台下载与ASR尚未验收等边界没有夸大。
- [ ] 测试通过，TGZ与源码清单复核，SHA256校验文件一起分享。
- [ ] 使用自己的账号完成发布，遵守依赖许可与视频平台条款。