# 发布到 DSH 插件市场 **插件名**:`dsh-whale-girl-live2d` | **中文名**:鲸鱼娘桌宠 —— DSH 里的 Live2D 鲸鱼娘 **作者**:Andersen216()| **分类**:`fun` | **许可**:代码 MIT / 模型素材 CC BY-NC-SA 4.0(非商业) --- ## 一条命令发布 ```bash cd <本仓库目录> # 例如 ~/dsh-whale-girl-live2d # 1) 先自检(不写任何东西):名字有没有撞车、dsh.bundle 在不在、署名齐不齐、git 干不干净 npm run release:check # 2) 真发布:建仓库 → 推代码 → 给市场列表提 PR GITHUB_TOKEN=你的token npm run release:github ``` `GITHUB_TOKEN` 需要的权限: | 仓库 | 权限 | | --- | --- | | `Andersen216/dsh-whale-girl-live2d` | Contents: **Read and write** | | `awesome-dsh-plugin/awesome-dsh-plugin` | Contents: Read and write + **Pull requests: Read and write** | (或者一个 classic token 勾 `public_repo` 就够了。) token 只从环境变量读,**不落盘、不写进 git config、不打日志**,推完还会把 remote 里的 token 换成干净地址。 不想给 token 也行:照下面的「手动三步」做,一样能上架。 --- ## 手动三步(不给 token 的路线) 1. **建仓库**: → 名字填 `dsh-whale-girl-live2d`,**不要**勾 README。 2. **推代码**: ```bash cd <本仓库目录> git remote add origin https://github.com/Andersen216/dsh-whale-girl-live2d.git # 已配过就跳过 git push -u origin main ``` > 如果 `github.com:443` 连不上(`git push` 卡住 / 报 `Couldn't connect to server`), > 用下面的「github.com 连不上时怎么推代码」那一节的 API 推送法。 3. **提市场 PR**:打开下面这个链接,GitHub 会自动 fork 精选列表并把文件名填好, 把 `docs/投稿条目.yml` 里那段 YAML 粘进去、提交 PR: PR 合并后,站点与 `dshmarket`(市场界面)当天收录。 > **门禁会先卡你一天,这是正常的**:市场的 CI 要求「仓库创建满 1 天」(反刷榜, > 过滤掉 PR 前几分钟才建好的仓库)。仓库建好当天提的 PR 会红着,等满 1 天后 > `regate.yml`(每 6 小时一次)自动重跑,判定自己变绿,**不用重提、不用推代码**。 > 另外目录不是从仓库直接读的:合并进 main 后由 `build-site.yml` 重新构建 > `plugins.json`(站点 + npm 包 `dsh-plugin-catalog`),市场界面读的是它。 --- ## 以后怎么发新版本(一次配置,之后两步) **2026-09-25 已经发布过一次**: - 仓库: - 市场 PR: - Release: 把 token 存进 macOS 钥匙串一次(在你自己终端里跑,会提示你手动输入,**不会进 shell 历史**): ```bash security add-generic-password -a Andersen216 -s dsh-whale-girl-live2d-publish -w ``` 之后发新版本只有两步: ```bash # 1) 改代码、跑测试、改 package.json 的 version npm test && npm run smoke # 2) 一键发布(脚本自动从钥匙串读 token;仓库已存在,会直接推 + 更新市场条目) npm run release:github ``` 撤销:钥匙串里删掉那条(`security delete-generic-password -s dsh-whale-girl-live2d-publish`), 或去 吊销 token。 ## 为什么名字长这样 - `dsh-whale-girl`、`dsh-whale-girl-pet`、`dsh-whale-pet` **在 npm 上都被别人占了** (分别是 nickkkkkk123123 / yanzwzz / eric0v0 的鲸鱼娘桌宠)。 插件名撞车最坏的结果是**市场把别人的包装给用户**,所以必须挑一个两边都空着的名字。 - `dsh-whale-girl-live2d` 在 npm 与 GitHub 上**都空闲**,同时把「鲸鱼娘」和「Live2D」都写进去了。 - 展示名不靠包名:README 首行与市场 `description` 才是「这是干啥的」—— 中文名「鲸鱼娘桌宠 —— DSH 里的 Live2D 鲸鱼娘」,英文名 “Whale Girl Pet — the Live2D whale-girl companion for DeepSeek Harness”。 ## 许可与署名(发布前自查清单) 1. `package.json` → `author: Andersen216`;`LICENSE` → `Copyright (c) 2026 Andersen216`。 2. `AUTHORS.md` / `PROVENANCE.md` / `README.md` 三处都写了 **上善无形 / ZipZipPipe / 氵六青**, 并给了 B 站主页链接。 3. 三处都写了**非商业**:不收费、不带货、不接广告变现、不卖周边、不作为付费产品的卖点。 4. 模型包的《使用须知》原文保留在 `PROVENANCE.md`(允许商用直播/自印、禁止盗用与出售)。 5. **只要模型素材还在仓库里,整个仓库都不能商用**——哪怕代码是 MIT。 ## 本地这份插件改名之后要注意 工作区目录没动(还是 `dsh-live2d-pet`),但包名是 `dsh-whale-girl-live2d`。 本机 `~/.dsh/profiles/web` 已经全部改完了 —— 依赖名、`dsh.profile.bundles`、 `pnpm-lock.yaml`、`node_modules` 里的软链都是新名字,**不需要再做任何改名操作**。 换机器或重建 profile 时,按下面「别的 DSH 怎么装」那一节走即可。 ## github.com 连不上时怎么推代码 有些网络环境里 `api.github.com` 通、`github.com:443` 不通:`git push` 会卡住或报 `Failed to connect to github.com port 443`。这时用 REST 的 Git Data API 推(blobs → tree → commit → 改 ref)。 脚本会先比对 tree 哈希,对不上就拒绝推送,不做破坏性操作: ```bash GITHUB_TOKEN=<带 public_repo 的 token> node tools/push-via-api.mjs [本地提交sha] [owner/repo] [分支] ``` 推成功后 GitHub 上的 commit sha 与本地不同(提交者信息由 API 补齐),但**文件内容逐字节相同** —— 可以用 `git -c core.quotePath=false ls-tree -r <本地sha>` 与 `GET /repos/:o/:r/git/trees/?recursive=1` 逐文件比对 blob 哈希来验证。 ## 别的 DSH 怎么装 ```bash dsh plugin --profile web add github:Andersen216/dsh-whale-girl-live2d ```