dsh-token-panorama 1.0.0 → 1.0.1

package/README.md

@@ -62,6 +62,24 @@ After installation the sidebar shows a **Token Panorama** entry; selecting it op
 
 To remove it, uninstall the `dsh-token-panorama` bundle from the Plugins page.
 
+## npm package
+
+The plugin is also published to the public npm registry as `dsh-token-panorama`. Storefronts
+(the awesome-dsh-plugin catalog and the in-app market) can then install it by package name
+and show a download figure, instead of falling back to the GitHub Release tarball.
+
+- Publish a new version with `npm publish --access public`. npm requires either two-factor
+  authentication or a granular access token with Bypass 2FA enabled.
+- The catalog reads the `name` field of the repository `package.json`, confirms that package on
+  the registry, and requires the npm package `repository` field to point back at this GitHub
+  repo. The mapping is discovered automatically; no field needs to be added to any listing.
+- The download figure is the npm download count over a rolling 30-day UTC window
+  (`api.npmjs.org/downloads/point`), refreshed by the catalog nightly probe. It is not a
+  page-view or visit count: neither the catalog nor the market exposes any view metric.
+  GitHub Release asset downloads are a separate number and do not feed this field.
+- Every change bumps `version` in `package.json`; publish that version too, so the registry
+  `latest` tag and the catalog `version` stay in step.
+
 ## Usage
 
 1. Select **Token Panorama** in the sidebar.

package/README.zh-CN.md

@@ -53,6 +53,23 @@ plugin_manager install_bundle target="<本目录的绝对路径>"
 
 卸载：在「插件」页面卸载 `dsh-token-panorama` 即可。
 
+## npm 包与下载量口径
+
+本插件同时发布到公共 npm registry，包名 `dsh-token-panorama`。目录站（awesome-dsh-plugin）与
+应用内市场可据此按包名安装并显示下载量；未发布到 npm 时才回退到 GitHub Release 的 tgz 附件。
+
+- 发布新版本：`npm publish --access public`。npm 要求开启两步验证，或使用勾选了 Bypass 2FA
+  的 granular access token。
+- 目录站会读取仓库 `package.json` 的 `name`，在 registry 上确认同名包，并要求该 npm 包的
+  `repository` 字段回指本 GitHub 仓库。这层映射自动从 registry 抓取，条目里无需、也不允许
+  手写 `npm:` 字段。
+- 市场显示的「下载量」是 npm 近 30 天（UTC 滚动窗口）下载数，来自
+  `api.npmjs.org/downloads/point`，由目录站每天夜间探测刷新。它不是「查看量 / 浏览量」：
+  目录与市场都不提供任何访问量字段。GitHub Release 附件的下载次数是另一套独立计数，
+  不会进入这个字段。
+- 每次修改都会迭代 `package.json` 的 `version`，并发布新版本，使 registry 的 `latest`
+  与目录里的 `version` 保持一致。
+
 ## 使用
 
 1. 在侧边栏点击 **Token 统计**。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-token-panorama",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "description": "Token panorama for DSH: totals, cache hit rate, peak/off-peak cost, calendar heatmap, session tree, workspaces, CSV/JSON export, plus context clear/compact actions and prompt optimization.",
   "keywords": [