@houser/edus-plugin 1.0.5 → 1.0.7

package/README.md

@@ -34,7 +34,7 @@ npm run dev
 │       ├── Brand.tsx          # 品牌名称与 Logo React 组件
 │       └── logo.png           # 裁切、缩放后的透明 Logo 源文件
 ├── scripts/
-│   └── embed-logo.mjs         # 构建时将 PNG 内联为 data URL
+│   └── generate-typert.mjs    # 构建时生成 typert 协议桥接代码
 └── lib/                       # 构建产物（自动生成，不提交）
     ├── index.js
     ├── client.js
@@ -70,6 +70,52 @@ npm run build         # 清理后依次执行以上两步
 
 ## 发布版本
 
-发布版本的时候必须指定 tag，tag 会关联 deepseek harness 版本（一般就是当前分支的名称）
+### 必须先构建
 
-示例 `npm publish --registry=https://registry.npmjs.org --tag dsh-v0.1.6-alpha.2`
+`package.json` 中没有 `prepare` / `prepublishOnly` / `prepack` 钩子，`npm publish` **不会**自动构建。而 `files` 字段声明的全部是 `lib/` 下的产物，且 `lib/` 已被 `.gitignore` 忽略。因此发布前必须手动执行构建，否则会把上一次遗留的旧产物发出去，或发出一个缺少入口文件的空包。
+
+### 发布步骤
+
+```bash
+# 1. 同步依赖（切换分支或改过 peerDependencies 后必做）
+pnpm install
+
+# 2. 构建 + 测试：clean → build:host → build:client → vitest
+npm run check
+
+# 3. 确认打包内容：应包含 lib/index.js、lib/client.js、
+#    lib/typert.*.js、lib/types/**/*.d.ts、cordis.yml
+npm run pack:dry
+
+# 4. 升版本号（会自动创建 git commit 和 tag）
+npm version patch
+
+# 5. 发布，必须带 --tag
+npm publish --registry=https://registry.npmjs.org --tag dsh-v0.1.6-alpha.2
+
+# 6. 推送版本提交
+git push && git push --tags
+
+# npm 需要登录
+npm login --registry=https://registry.npmjs.org/
+```
+
+### 关于 `--tag`
+
+发布必须指定 npm dist-tag，用于关联对应的 DeepSeek Harness 版本（一般就是当前分支名称）。**不要**使用默认的 `latest`：不同 Harness 版本的 peerDependencies 不兼容，混用 `latest` 会让安装方拿到与自己 Harness 版本不匹配的插件。
+
+dist-tag 取值与 `peerDependencies` 中 `@deepseek-ai/dsh-*` 的版本保持一致，例如当前 peer 版本为 `0.1.6-alpha.2`，则 tag 为 `dsh-v0.1.6-alpha.2`。
+
+安装方按 tag 取包：
+
+```bash
+npm install @houser/edus-plugin@dsh-v0.1.6-alpha.2
+```
+
+### 发布前检查清单
+
+- [ ] `peerDependencies` 中的 `@deepseek-ai/dsh-*` 版本与目标 Harness 版本一致
+- [ ] `npm run check` 通过（构建 + 测试）
+- [ ] `npm run pack:dry` 的文件列表完整，且不含 `src/`、`node_modules/` 等多余内容
+- [ ] 替换过 `src/client/logo.png` 的话，已重新构建（data URL 在构建时生成）
+- [ ] `--tag` 与目标 Harness 版本对应，且不是 `latest`

package/lib/client.js

@@ -6351,9 +6351,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				...base.error,
 				...theme.error
 			};
+			const busyRef = (0, react.useRef)(busy);
+			const busyChangeRef = (0, react.useRef)(onBusyChange);
+			busyRef.current = busy;
+			busyChangeRef.current = onBusyChange;
 			(0, react.useEffect)(() => {
 				onBusyChange?.(busy);
 			}, [busy, onBusyChange]);
+			(0, react.useEffect)(() => () => {
+				if (busyRef.current) busyChangeRef.current?.(false);
+			}, []);
 			const switchMode = (next) => {
 				setMode(next);
 				setError("");
@@ -6495,6 +6502,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		function basename(path) {
 			return path.split("/").at(-1) ?? path;
 		}
+		/** 后端在未开通会员时返回的提示里带有这个字眼，此时改为引导扫码联系客服。 */
+		const MEMBERSHIP_HINT = "需要开通会员";
+		const SERVICE_QR = "https://cdn.juzhenai.cn/ai-edu/assets/wechat.webp";
 		const styles$1 = {
 			root: {
 				display: "flex",
@@ -6668,6 +6678,36 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				fontSize: 18,
 				fontWeight: 700
 			},
+			memberCard: {
+				display: "flex",
+				gap: 14,
+				alignItems: "center",
+				margin: "14px 0 0",
+				padding: 13,
+				border: "1px solid color-mix(in srgb, var(--dsw-alias-state-error-primary) 35%, var(--dsw-alias-border-l2))",
+				borderRadius: 11,
+				background: "var(--dsw-alias-bg-layer-1)"
+			},
+			memberQr: {
+				flex: "none",
+				width: 96,
+				height: 96,
+				borderRadius: 8,
+				background: "#fff",
+				objectFit: "contain"
+			},
+			memberTitle: {
+				margin: 0,
+				color: "var(--dsw-alias-label-primary)",
+				fontSize: 13,
+				fontWeight: 650
+			},
+			memberText: {
+				margin: "5px 0 0",
+				color: "var(--dsw-alias-label-secondary)",
+				fontSize: 12,
+				lineHeight: 1.55
+			},
 			accountCard: {
 				margin: "0 0 15px",
 				padding: "9px 11px",
@@ -6679,6 +6719,31 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				lineHeight: 1.5
 			}
 		};
+		/** 普通报错直接展示文案；会员相关的报错额外给出客服二维码。 */
+		function PublishError({ message }) {
+			if (message === "") return null;
+			if (!message.includes(MEMBERSHIP_HINT)) return (0, react_jsx_runtime.jsx)("p", {
+				style: styles$1.error,
+				children: message
+			});
+			return (0, react_jsx_runtime.jsxs)("div", {
+				style: styles$1.memberCard,
+				children: [(0, react_jsx_runtime.jsx)("img", {
+					alt: "客服微信二维码",
+					src: SERVICE_QR,
+					style: styles$1.memberQr
+				}), (0, react_jsx_runtime.jsxs)("div", {
+					style: { minWidth: 0 },
+					children: [(0, react_jsx_runtime.jsx)("p", {
+						style: styles$1.memberTitle,
+						children: message
+					}), (0, react_jsx_runtime.jsx)("p", {
+						style: styles$1.memberText,
+						children: "该功能需要开通会员后使用。请用微信扫描左侧二维码添加客服咨询开通。"
+					})]
+				})]
+			});
+		}
 		/** An extension-priority document body: native right-preview ergonomics plus a complete edus publishing flow. */
 		function HtmlPublishPreview({ content, resourceAddress, remote }) {
 			const account = useEdusLogin();
@@ -6727,6 +6792,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const afterLogin = (0, react.useCallback)((result) => {
 				EdusAuthStore.set(result);
 				setError("");
+				setBusy(false);
 				setDestination(marker !== null && marker.owner === result.phone ? "current" : "new");
 				setStage("destination");
 			}, [marker]);
@@ -6909,10 +6975,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 												onChange: (event) => setTitle(event.target.value)
 											})]
 										}),
-										error !== "" && (0, react_jsx_runtime.jsx)("p", {
-											style: styles$1.error,
-											children: error
-										}),
+										(0, react_jsx_runtime.jsx)(PublishError, { message: error }),
 										(0, react_jsx_runtime.jsxs)("div", {
 											style: styles$1.actions,
 											children: [(0, react_jsx_runtime.jsx)("button", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@houser/edus-plugin",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "",
   "license": "ISC",
   "author": "",