dsh-connect-minimaxcode 0.4.0 → 0.4.2

package/README.md

@@ -186,14 +186,14 @@ Content-Type: application/json
 
 ### 积分会过期吗？会
 
-积分不是一池子，而是**按笔发放的批次**，每批有自己的到期日。客户端每天发一批，每批大约在**发放后 29 天**到期，于是形成一条逐日错开的 30 天阶梯：
+积分不是一池子，而是**按笔发放的批次**，每批有自己的到期日。客户端每天发一批，每批在**发放日 + 30 个自然日**到期（按账户所在时区，当日 00:00 失效），于是形成一条逐日错开的 30 天阶梯：
 
 ```
-GET https://agent.minimax.cn/minimax-cloud/api/v1/credit/details?page=1&page_size=100
-→ details[] { granted_amount, remaining_amount, consumed_amount, granted_at_ms, expire_at_ms }
+GET https://agent.minimax.cn/minimax-cloud/api/v1/credit/details?page_number=1&page_size=100
+→ details[] { granted_amount, remaining_amount, consumed_amount, granted_at_ms, expire_at_ms, credit_type }
 ```
 
-实测本机 23 笔：09-20 发的在 10-19 到期，09-21 发的在 10-20 到期……另有一笔 08-25 发的在 **2027-08-25** 到期（一年期批次）。
+实测本机 23 笔：09-20 发的在 10-20 到期、09-21 发的在 10-21 到期……另有一笔 08-25 发的在 2027-08-25 到期（一年期批次，`credit_type` 1=购买 / 2=签到）。**到期日一律读 `expire_at_ms`**，不写死天数——至少存在 30 天与 365 天两种制式。
 
 插件据此在**插件页面**（设置 → 插件 → DSH Connect MiniMax Code）与输入框下方的胶囊里给出：
 
@@ -202,9 +202,11 @@ GET https://agent.minimax.cn/minimax-cloud/api/v1/credit/details?page=1&page_siz
 - 接下来几笔**到期批次**的清单（日期 + 金额）
 - 余额条与本机消耗（token 数、等效金额）
 
-只统计**仍有余额**的批次：已发放但用光的批次到期时并没有东西可损失，把它算进去会让每个账号都看起来"快过期了"。
+只统计**仍有余额**的批次：已发放但用光的批次到期时并没有东西可损失，把它算进去会让每个账号都看起来"快过期了"。积分的消耗近似先进先出，所以**"7 天内到期"的金额常常是 0**（快到期的那些基本都已被用完），因此界面同时给出**最早到期时间**，那才是真正有意义的信号。
 
-> 台账的 `remaining_amount` 合计与余额接口的 `total_remaining_amount` 会**略有出入**（实测差 0.006，浮点累加所致；两次采样之间余额本身也会变）。插件以**余额接口**显示总额，台账只用来回答"什么时候过期"。
+> 过期不会把批次里的 `remaining_amount` 清零（实测会留下 -0.31 这样的负值残留），而是把过期批次**排除在余额之外**；所以总额以余额接口为准。
+>
+> 台账的 `remaining_amount` 合计与余额接口的 `total_remaining_amount` 在**静止期逐位相等**；两次采样之间看到的差异，是账户在这段时间里被真实消耗掉的量。
 
 ### 消耗怎么算
 
@@ -265,6 +267,14 @@ OAuth 令牌有效期约 1 小时，由客户端自动续期。插件**只在自
 
 历史版本见 [GitHub Releases](https://github.com/JeffTsuiCUG/dsh-connect-minimaxcode/releases) 与 [npm 版本列表](https://www.npmjs.com/package/dsh-connect-minimaxcode?activeTab=versions)。
 
+## 市场收录与展示
+
+插件已包含可安装的 `dsh.bundle` manifest，并发布到 npm。社区插件市场（`dshmarket`）的目录由 [Awesome DSH Plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 注册表生成，本插件的收录条目已提交为 PR [#8110](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/8110)，仓库内保留了一份草稿与操作说明：[`awesome-dsh-plugin-submission/`](awesome-dsh-plugin-submission/)。
+
+市场截图按当前约定由**插件自己仓库根目录的** `screenshots.json` 声明（注册表 `data/screenshots.json` 是旧约定下的回退，不再新增键）。
+
+> 界面胶囊放在**输入框下方的 dock**，而不是输入框工具栏：工具栏是**共享插槽**，外壳自己的控件和别的插件都注册在那里，无法保证每个占用者都可见——同族插件就因为这个原因丢过一次读数。
+
 ## 卸载
 
 ```bash

package/lib/index.d.ts

@@ -312,8 +312,9 @@ interface CreditSnapshot {
  * One grant of credits.
  *
  * Credits are granted in lots, and each lot carries its own expiry: the
- * desktop app grants credits daily, and every lot falls due about a month
- * later on a day of its own. Credits in a lot are lost when that day arrives.
+ * desktop app grants credits daily, and a lot falls due thirty calendar days
+ * after the day it was granted, at midnight in the account's own timezone.
+ * Credits in a lot are lost when that moment arrives.
  */
 interface CreditLot {
   /** How much this lot was granted. */

package/lib/index.js

@@ -994,9 +994,12 @@ function parseCreditLots(document) {
 /**
 * Fetch the credit ledger.
 *
-* The ledger is paginated, so every page is read. The number of pages comes
-* from the account's own `total_count` rather than from a guess, and a lot
-* count that stops growing ends the walk.
+* The ledger is paginated, and the page parameter is `page_number` — `page`
+* is accepted and then ignored, which would make every page return the same
+* rows. The page size is capped upstream at 100.
+*
+* The default view already excludes expired grants, which is what this wants:
+* a grant that expired has nothing left to lose.
 */
 async function fetchCreditLots(credential, region, fetchImpl = fetch) {
 	const pageSize = 100;
@@ -1004,14 +1007,16 @@ async function fetchCreditLots(credential, region, fetchImpl = fetch) {
 	let page = 1;
 	let total = Number.POSITIVE_INFINITY;
 	while (lots.length < total && page <= 50) {
-		const response = await fetchImpl(`${MINIMAX_ACCOUNT_HOSTS[region]}${CREDIT_DETAILS_PATH}?page=${page}&page_size=${pageSize}`, { headers: { authorization: `Bearer ${credential.token}` } });
+		const response = await fetchImpl(`${MINIMAX_ACCOUNT_HOSTS[region]}${CREDIT_DETAILS_PATH}?page_number=${page}&page_size=${pageSize}`, { headers: { authorization: `Bearer ${credential.token}` } });
 		if (!response.ok) throw new Error(`credit ledger request failed: HTTP ${response.status}`);
 		const document = await response.json();
 		const batch = parseCreditLots(document);
+		const before = lots.length;
 		lots.push(...batch);
 		const count = toNumber(document.total_count);
 		if (count !== void 0) total = count;
 		if (batch.length < pageSize) break;
+		if (lots.length === before) break;
 		page += 1;
 	}
 	return lots;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-connect-minimaxcode",
   "displayName": "DSH Connect MiniMax Code",
-  "description": "把本机已登录的 MiniMax Code 桌面 App 的模型接入 DeepSeek Harness：复用其登录态，提供 Anthropic Messages 兼容接入、动态模型目录与积分余额/到期提示。",
-  "version": "0.4.0",
+  "description": "把本机已登录的 MiniMax Code 桌面 App 模型接入 DeepSeek Harness：零配置、Anthropic Messages 兼容、动态模型目录，并显示积分余额与到期 — bring MiniMax Code desktop app models into DSH with a dynamic model catalog and a credit balance with expiry details.",
+  "version": "0.4.2",
   "author": "JeffTsuiCUG",
   "license": "MIT",
   "private": false,
@@ -49,10 +49,13 @@
   },
   "keywords": [
     "dsh-plugin",
+    "dsh",
     "deepseek-harness",
     "minimax",
     "minimax-code",
-    "model-provider"
+    "model-provider",
+    "credits",
+    "usage"
   ],
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.4 <5.0.0",