From 98a332c1a3a5f2bd3b0ec272dd49f7a0782c140e Mon Sep 17 00:00:00 2001 From: Evan <88482418+Li-Evan@users.noreply.github.com> Date: Tue, 17 Nov 2026 12:44:46 +0800 Subject: [PATCH] docs: install the DSH plugin from npm (bloomtutor-dsh 0.1.0) What: - bloomtutor-dsh 0.1.0 is now on npm. README, README.zh.md and integrations/deepseek-harness/README.md lead with `dsh plugin --profile web add bloomtutor-dsh` and keep the GitHub install (`github:Li-Evan/BloomTutor`) as the second option, since several plugin markets read install commands from the README. - The maintainer release note now says to run `npm publish --access public` from the repository root, and that npm's two-factor confirmation link is only valid for about five minutes. - The published 0.1.0 tarball still carries the previous README; the npm page picks this up with the next version. How to verify: - npm view bloomtutor-dsh -> version 0.1.0, latest tag, 21 files, shasum 5b484d05d072a97c5d4afee6a26ecff9befbe37e (the tarball built from d3d9c0b and leak-scanned before publishing). - node integrations/deepseek-harness/scripts/acceptance.mjs --source bloomtutor-dsh@0.1.0 -> all 9 steps pass on DSH 0.2.2-rc.1, Node 24.22.2, macOS arm64 (install from npm, seven Skills load, uninstall). - Docs only otherwise; scripts/secret-scan.sh passes. How to roll back: - git revert . That only restores the GitHub-first docs; the npm package stays published (npm unpublish is limited to 72 hours and would break anyone who installed it). Co-Authored-By: Claude Opus 5.5 --- README.md | 6 ++++-- README.zh.md | 6 ++++-- integrations/deepseek-harness/README.md | 10 +++++++--- 3 files changed, 15 insertions(+), 7 deletions(-) diff --git a/README.md b/README.md index b06fab6..d6ef3be 100644 --- a/README.md +++ b/README.md @@ -73,12 +73,14 @@ Then say: `Create a new folder and help me learn [any topic]` /plugin install bloom@li-evan ``` -**Or use it in [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)**: this repository is also the `bloomtutor-dsh` plugin, with the same skills: +**Or use it in [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)**: the same skills ship as the `bloomtutor-dsh` plugin on npm: ```bash -dsh plugin --profile web add github:Li-Evan/BloomTutor +dsh plugin --profile web add bloomtutor-dsh ``` +Or straight from this repository: `dsh plugin --profile web add github:Li-Evan/BloomTutor`. + Details in [integrations/deepseek-harness](./integrations/deepseek-harness/README.md). See [GUIDE.md](./GUIDE.md) for the full walkthrough. diff --git a/README.zh.md b/README.zh.md index 1095ca2..49d8497 100644 --- a/README.zh.md +++ b/README.zh.md @@ -73,12 +73,14 @@ claude /plugin install bloom@li-evan ``` -**也可以在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 里用**:这个仓库本身也是 `bloomtutor-dsh` 插件,带同一套 skill: +**也可以在 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 里用**:同一套 skill 已作为 `bloomtutor-dsh` 插件发布到 npm: ```bash -dsh plugin --profile web add github:Li-Evan/BloomTutor +dsh plugin --profile web add bloomtutor-dsh ``` +也可以直接从这个仓库装:`dsh plugin --profile web add github:Li-Evan/BloomTutor`。 + 详见 [integrations/deepseek-harness](./integrations/deepseek-harness/README.md#中文)。 详见 [GUIDE.zh.md](./GUIDE.zh.md)。 diff --git a/integrations/deepseek-harness/README.md b/integrations/deepseek-harness/README.md index 06ade8d..69bb75d 100644 --- a/integrations/deepseek-harness/README.md +++ b/integrations/deepseek-harness/README.md @@ -9,9 +9,11 @@ This is a community plugin. It is not made or endorsed by DeepSeek. ## Install ```bash -dsh plugin --profile web add github:Li-Evan/BloomTutor +dsh plugin --profile web add bloomtutor-dsh ``` +The package is [`bloomtutor-dsh` on npm](https://www.npmjs.com/package/bloomtutor-dsh). To install straight from this repository instead, use `dsh plugin --profile web add github:Li-Evan/BloomTutor`; both ship the same files. + Use `npx @deepseek-ai/dsh plugin …` if `dsh` is not on your PATH. Run the command once for each profile you use; running it again picks up the latest version. Tested with DeepSeek Harness `0.2.2-rc.1` and `0.2.2-rc.3` on Node 24. DeepSeek Harness is a developer preview; other versions may work but have not been tested. @@ -66,9 +68,11 @@ dsh plugin --profile web remove bloomtutor-dsh 安装: ```bash -dsh plugin --profile web add github:Li-Evan/BloomTutor +dsh plugin --profile web add bloomtutor-dsh ``` +这是 npm 上的 [`bloomtutor-dsh`](https://www.npmjs.com/package/bloomtutor-dsh)。也可以直接从这个仓库装:`dsh plugin --profile web add github:Li-Evan/BloomTutor`,两种装上的文件一样。 + `dsh` 不在 PATH 里时,用 `npx @deepseek-ai/dsh plugin …`。每个要用的 profile 各装一次;再运行一次就会更新到最新版。已在 DeepSeek Harness `0.2.2-rc.1` 和 `0.2.2-rc.3`、Node 24 上测过。 装好后在对话里说「开个文件夹,帮我学 Rust 的所有权」,或者点名某个 Skill,比如「用 learn-feynman 检验一下我是不是真懂了 TCP 拥塞控制」。读课时在没看懂的地方标 `???`,读完在文末写反馈,然后说「我读完了」。 @@ -108,4 +112,4 @@ node integrations/deepseek-harness/scripts/acceptance.mjs --source github:Li-Eva It works in a temporary directory with its own `DSH_HOME` and `DSH_AGENTS_HOME`, and prints a JSON receipt. If registry.npmjs.org is slow from your network, set `npm_config_registry=https://registry.npmmirror.com/`. -To release a version: bump `version` in the root `package.json`, run both checks (update `TESTED_DSH_VERSION` in `scripts/acceptance.mjs` and the tested versions above if you tested a newer host), then publish to npm from the repository root if the package is on npm. +To release a version: bump `version` in the root `package.json`, run both checks (update `TESTED_DSH_VERSION` in `scripts/acceptance.mjs` and the tested versions above if you tested a newer host), then run `npm publish --access public` from the repository root. The npm account needs two-factor authentication; npm prints a confirmation link that stays valid for about five minutes, so open it right away.