dsh-ai-courses 0.1.2 → 0.1.4

package/lib/client.js

@@ -680,6 +680,27 @@ const AIC_COURSES_CORE = (function () {
     return DEFAULT_LOCALE
   }
 
+  /**
+   * 动态 `t(key, vars)`：**每次调用现读**宿主语言。
+   *
+   * 为什么不能在 apply 时 `createT(detectLocale(...))` 一次定死：
+   * DSH 的 locale 插件在启动后才把 `<html lang>` 从服务端默认的 `en` 改成用户设置
+   * （profile patch 里 `locale.preference: zh` 的情况）。apply 时读到的还是 `en`，
+   * 于是整个面板一直显示英文。这里按 locale 缓存翻译器，语言变了下一次渲染就切过来。
+   */
+  function createLiveT (doc, nav) {
+    const cache = new Map()
+    return function t (key, vars) {
+      const locale = detectLocale(doc, nav)
+      let tr = cache.get(locale)
+      if (!tr) {
+        tr = createT(locale)
+        cache.set(locale, tr)
+      }
+      return tr(key, vars)
+    }
+  }
+
   /* --------------------------------------------------- 编号（绝不解析 id） */
   /** 章节的人类编号：由 `order` 派生（05 §4 / 06 §4.2）。 */
   function chapterNo (ch) {
@@ -1172,6 +1193,7 @@ const AIC_COURSES_CORE = (function () {
     LOCALES,
     DEFAULT_LOCALE,
     createT,
+    createLiveT,
     detectLocale,
     genSpec,
     learnSpec,
@@ -4458,9 +4480,28 @@ function PageState (props) {
   )
 }
 
+/**
+ * `<html lang>` 变化时强制重渲染。
+ *
+ * DSH 的 locale 插件在启动后才把服务端默认的 `en` 改成用户设置；`t` 本身是
+ * `createLiveT`（每次调用现读），但组件需要一次 re-render 才会重新取词。
+ */
+function useLocaleRefresh () {
+  const [, setTick] = React.useState(0)
+  React.useEffect(() => {
+    if (typeof document === 'undefined' || typeof MutationObserver !== 'function') return undefined
+    const el = document.documentElement
+    if (!el || typeof el.getAttribute !== 'function') return undefined
+    const obs = new MutationObserver(() => setTick((n) => n + 1))
+    obs.observe(el, { attributes: true, attributeFilter: ['lang'] })
+    return () => obs.disconnect()
+  }, [])
+}
+
 function AicCoursesApp (props) {
   const t = props.t
   const core = AIC_COURSES_CORE
+  useLocaleRefresh()
   const [view, setView] = React.useState('library')
   const [courseId, setCourseId] = React.useState(null)
   const [kpId, setKpId] = React.useState(null)
@@ -4697,7 +4738,9 @@ function aicCoursesApply (ctx) {
 
   const doc = typeof document === 'undefined' ? null : document
   const nav = typeof navigator === 'undefined' ? null : navigator
-  const t = AIC_COURSES_CORE.createT(AIC_COURSES_CORE.detectLocale(doc, nav))
+  /* 动态语言：`<html lang>` 由 DSH locale 插件在启动后改成用户设置，
+     不能在这里一次性 detectLocale 后锁死（否则中文设置下一直显示英文）。 */
+  const t = AIC_COURSES_CORE.createLiveT(doc, nav)
 
   /* 样式：构建期内联（宿主不会自动加载包内 lib/styles.css —— 见 doc/03 §6 的定案），
      挂一个 <style> 并在停用/卸载时移除；不用 innerHTML。 */
@@ -4715,19 +4758,38 @@ function aicCoursesApply (ctx) {
 
   const disposers = []
 
-  /* 侧边栏面板图标。`id` 必须与 `main` 的 `key` 是同一字符串（宿主按 list id 寻址 main 面板，E-8）；
-     `label` 必须是函数。 */
-  disposers.push(
-    slots.register(
-      { name: 'sidebar.panellist', id: 'ai-courses', order: 30, label: () => t('panel.title') },
-      (props) => h(CoursePanelIcon, props),
-    ),
-  )
-
-  /* 主面板。key = 'ai-courses'（**不能**用 'course'：那是 dsh-course-plugin 的格位） */
-  disposers.push(
-    slots.register({ name: 'main', key: 'ai-courses' }, () => h(AicCoursesApp, { t: t, ctx: ctx })),
-  )
+  /* 侧边栏面板图标 / 主面板：**等槽声明后再注册**。
+     `sidebar.panellist` 由 `@deepseek-ai/dsh-client-ui-sidebar` 声明；在 `dsh web` 里这个声明
+     发生在 sidebar 首次渲染时，比插件 apply 晚 —— 直接 `slots.register` 会抛
+     「slot "sidebar.panellist" is not declared」，整个 client entry 被标 failed（真机踩到）。
+     用 `slots.inject` 等声明；老宿主没有 inject 时退回直接注册。 */
+  if (slots && typeof slots.inject === 'function') {
+    /* `id` 必须与 `main` 的 `key` 是同一字符串（宿主按 list id 寻址 main 面板，E-8）；
+       `label` 必须是函数。 */
+    disposers.push(
+      slots.inject('sidebar.panellist', () => slots.register(
+        { name: 'sidebar.panellist', id: 'ai-courses', order: 30, label: () => t('panel.title') },
+        (props) => h(CoursePanelIcon, props),
+      )),
+    )
+    /* 主面板。key = 'ai-courses'（**不能**用 'course'：那是 dsh-course-plugin 的格位） */
+    disposers.push(
+      slots.inject('main', () => slots.register(
+        { name: 'main', key: 'ai-courses' },
+        () => h(AicCoursesApp, { t: t, ctx: ctx }),
+      )),
+    )
+  } else {
+    disposers.push(
+      slots.register(
+        { name: 'sidebar.panellist', id: 'ai-courses', order: 30, label: () => t('panel.title') },
+        (props) => h(CoursePanelIcon, props),
+      ),
+    )
+    disposers.push(
+      slots.register({ name: 'main', key: 'ai-courses' }, () => h(AicCoursesApp, { t: t, ctx: ctx })),
+    )
+  }
 
   /* 主会话里的 `/ai-course` 实时状态卡片（conversation.chat.commandview，见 55-status-card.js）：
      宿主 ui-chat 声明该槽，用 inject 等声明出现再注册（直接 register 会抛「未声明」）。 */
@@ -4748,7 +4810,7 @@ function aicCoursesApply (ctx) {
     if (styleEl && styleEl.parentNode) styleEl.parentNode.removeChild(styleEl)
   })
 
-  console.log('[ai-courses] 客户端已就绪（sidebar.panellist#ai-courses + main[ai-courses]）')
+  console.log('[ai-courses] 客户端已就绪（sidebar/main 等槽声明后注册；主会话槽已注册）')
 }
 
 /* ==================== src/client/99-shell-tail.js ==================== */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-ai-courses",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "private": false,
   "license": "MIT",
   "repository": {