@ai-wendao/ant 0.3.14 → 0.3.16

package/README.md

@@ -6,13 +6,13 @@ ANT (AI-native Teams) connects a DeepSeek Harness Desktop profile to its team's
 
 ## 企业精选技能
 
-团队管理员可在 ANT 管理台从 GitHub 目录、ZIP、TAR、TAR.GZ／TGZ 或单份 `SKILL.md` 导入技能，核对来源、文件和依赖后发布。已连接团队的成员从 DSH 左侧“企业扩展”入口进入独立页面浏览并安装技能；ANT 插件设置页只处理连接、模型和更新。ANT Host 将固定版本的完整文件集放进 DSH 的用户技能目录，并重新核对本机文件；启用本地技能的 DSH 会话随后由原生技能提供者发现和使用。ANT 不用 Host 全局技能列表判断会话是否已发现技能。
+团队管理员可在 ANT 管理台从 GitHub 目录、ZIP、TAR、TAR.GZ／TGZ 或单份 `SKILL.md` 导入技能，核对来源、文件和依赖后发布。已连接团队的成员从 DSH 左侧“企业扩展”入口进入统一目录，默认同时浏览技能和插件，并可按类型、状态筛选或搜索；ANT 插件设置页只处理连接、模型和更新。ANT Host 将固定版本的完整文件集放进 DSH 的用户技能目录，并重新核对本机文件；启用本地技能的 DSH 会话随后由原生技能提供者发现和使用。ANT 不用 Host 全局技能列表判断会话是否已发现技能。
 
 安装不会自动运行技能脚本或安装 Python、Node 等系统依赖。ANT 只更新或卸载自己管理且本机内容未被修改的技能目录；发现同名个人技能或本机改动时会停止覆盖。
 
 ## 企业精选插件
 
-管理员可从 npm 官方源的 DSH Bundle 精确版本创建草稿，填写源码、许可证、依赖和安装脚本的审核记录后发布。成员在“企业扩展 → 插件”查看审核信息和本机状态。对无新增依赖、无安装阶段脚本且归档符合首批准入条件的草稿，管理员可从 npm 官方源锁定实际 `.tgz` 并查看文件清单、下载核验制品；这类草稿经审核发布后，成员可让 DSH 从 ANT 的固定制品地址一键安装。其他版本仍是目录项，需联系管理员安排。安全撤回版本会停止新的 ANT 下载，但不会自动删除本机副本；ANT 设置页继续显示相应风险公告。范围与限制见[上线边界](../../docs/decisions/2026-10-15-plugin-center-rollout.md)。
+管理员可从 npm 官方源的 DSH Bundle 精确版本创建草稿，填写源码、许可证、依赖和安装脚本的审核记录后发布。成员在“企业扩展”总览或“插件”分类查看审核信息和本机状态。对无新增依赖、无安装阶段脚本且归档符合首批准入条件的草稿，管理员可从 npm 官方源锁定实际 `.tgz` 并查看文件清单、下载核验制品；这类草稿经审核发布后，成员可让 DSH 从 ANT 的固定制品地址一键安装。其他版本仍是目录项，需联系管理员安排。安全撤回版本会停止新的 ANT 下载，但不会自动删除本机副本；ANT 设置页继续显示相应风险公告。范围与限制见[上线边界](../../docs/decisions/2026-10-15-plugin-center-rollout.md)。
 
 ANT 自身更新使用单独的已审核安装包。管理员将与 npm 发布一致的 `.tgz` 上传到 ANT 服务端并登记版本；新版 ANT 页面可点击“更新”，DSH 原位替换同名 Bundle 后提示重启。旧版 `@ai-wendao/ant` 用户可打开团队服务的 `/ant-update` 指引，在 DSH“添加插件”中粘贴该安装包地址完成一次性原位更新，无需先卸载或使用终端。此入口只分发 ANT 自身，不启用扩展中心其他插件的一键安装。
 

package/client.js

@@ -3,7 +3,7 @@ window.__ModuleLoader__.load({
   factory: (require) => {
     var module = { exports: {} }
     var exports = module.exports
-    const { createElement, useEffect, useState } = require('react')
+    const { createElement, useEffect, useRef, useState } = require('react')
     const h = createElement
     const SERVICE_URL_STORAGE_KEY = 'ant-team-service-url'
     const DEVICE_ID_STORAGE_KEY = 'ant-team-device-id'
@@ -34,14 +34,15 @@ window.__ModuleLoader__.load({
       border: '0.5px solid var(--dsw-alias-border-l2)', borderRadius: 8,
       cursor: 'pointer',
     }
+    const categoryButtonStyle = { ...secondaryButtonStyle, minHeight: 34, padding: '6px 12px', whiteSpace: 'nowrap' }
     function ExtensionRequestNotice() {
       return h('aside', { role: 'note', style: {
-        ...panelStyle,
-        borderColor: 'var(--dsw-alias-state-business-primary)',
-        gap: 5,
+        display: 'flex', alignItems: 'baseline', gap: 8, padding: '9px 12px',
+        borderRadius: 8, backgroundColor: 'var(--dsw-alias-bg-layer-2)',
+        color: 'var(--dsw-alias-label-secondary)', fontSize: 13, lineHeight: 1.6,
       } },
-        h('h2', { style: { margin: 0, fontSize: 16 } }, '没有找到想用的技能或插件？'),
-        h('p', { style: mutedTextStyle }, '目录里没有想用的扩展，或插件没有安装按钮？请联系企业管理员，说明你希望完成的任务或提供扩展地址。已开放安装的技能和插件可在这里直接安装；勿自行安装未经审核的扩展。'))
+        h('strong', { style: { flexShrink: 0, color: 'var(--dsw-alias-label-primary)' } }, '提示'),
+        h('span', null, '没有找到想用的扩展，或插件没有安装按钮？联系企业管理员，说明用途或提供地址。已开放的扩展可直接安装；未经审核的版本请勿自行安装。'))
     }
     const normalizeServiceUrl = (value) => {
       let url
@@ -149,8 +150,38 @@ window.__ModuleLoader__.load({
     function TeamServiceConfig({ remote, openInstalledPlugin }) {
       const [serviceUrl, setServiceUrl] = useState(loadServiceUrl)
       const [draft, setDraft] = useState(serviceUrl)
+      const [binding, setBinding] = useState({ state: 'checking', url: null })
+      const bindingRevision = useRef(0)
       const [message, setMessage] = useState('')
       const [pluginAlerts, setPluginAlerts] = useState([])
+      useEffect(() => {
+        let disposed = false
+        const revision = bindingRevision.current
+        const current = () => !disposed && bindingRevision.current === revision
+        const inspectBinding = async () => {
+          try {
+            const response = await fetch('/api/ant-teams/connection-origin', { cache: 'no-store' })
+            const result = await readLocalJsonResponse(response)
+            if (!response.ok) throw new Error()
+            const pinned = result.service_url == null ? null : normalizeServiceUrl(result.service_url)
+            if (result.service_url != null && !pinned) throw new Error()
+            if (pinned) {
+              if (current()) {
+                setBinding({ state: 'ready', url: pinned })
+                setServiceUrl(pinned)
+                setDraft(pinned)
+                try { localStorage.setItem(SERVICE_URL_STORAGE_KEY, pinned) } catch {}
+              }
+              return
+            }
+            const described = await remote?.credentials?.describe?.(['ANT_MODEL_API_KEY'])
+            if (!described?.ok) throw new Error()
+            if (current()) setBinding({ state: described.value?.ANT_MODEL_API_KEY?.configured ? 'unverified' : 'ready', url: null })
+          } catch { if (current()) setBinding({ state: 'error', url: null }) }
+        }
+        void inspectBinding()
+        return () => { disposed = true }
+      }, [remote])
       useEffect(() => {
         let disposed = false
         const inspect = async () => {
@@ -175,6 +206,10 @@ window.__ModuleLoader__.load({
       }, [remote])
       const save = (event) => {
         event.preventDefault()
+        if (binding.state !== 'ready' || binding.url) {
+          setMessage(binding.url ? '当前已连接团队；切换前请先在下方断开当前设备。' : '尚未核对这台 DSH 的团队绑定，不能修改地址。')
+          return
+        }
         const normalized = normalizeServiceUrl(draft)
         if (!normalized) {
           setMessage('请输入 HTTPS 团队服务地址；本机测试可使用 localhost。')
@@ -189,25 +224,39 @@ window.__ModuleLoader__.load({
           setMessage('浏览器无法保存此地址，请检查本地存储权限。')
         }
       }
-      const link = consoleUrl(serviceUrl)
+      const link = binding.state === 'ready' ? consoleUrl(binding.url || serviceUrl) : null
+      const onConnectionChange = (url) => {
+        bindingRevision.current += 1
+        setBinding({ state: 'ready', url: url || null })
+        if (url) {
+          setServiceUrl(url)
+          setDraft(url)
+          try { localStorage.setItem(SERVICE_URL_STORAGE_KEY, url) } catch {}
+        }
+      }
       return h('section', { style: { display: 'grid', gap: 16, width: '100%', maxWidth: 1120 } },
         h('p', { style: mutedTextStyle }, '连接团队服务后，即可同步获准模型并使用团队协作。'),
         h('section', { style: panelStyle },
           h('div', null,
             h('h3', { style: { margin: 0, fontSize: 16, fontWeight: 650 } }, '团队服务'),
             h('p', { style: { ...mutedTextStyle, marginTop: 4 } }, '由团队管理员提供服务地址；管理员可在控制台管理成员、模型和协作设置。')),
-          h('form', { onSubmit: save, style: { display: 'grid', gridTemplateColumns: 'minmax(0, 1fr) auto', alignItems: 'end', gap: 10 } },
-          h('label', { htmlFor: 'ant-team-service-url', style: { gridColumn: '1 / -1', fontSize: 13, fontWeight: 550 } }, '服务地址'),
+          h('form', { onSubmit: save, style: { display: 'grid', gridTemplateColumns: binding.url ? '1fr' : 'minmax(0, 1fr) auto', alignItems: 'end', gap: 10 } },
+          h('label', { htmlFor: 'ant-team-service-url', style: { gridColumn: '1 / -1', fontSize: 13, fontWeight: 550 } }, binding.url ? '当前连接的团队服务地址' : '服务地址'),
           h('input', {
             id: 'ant-team-service-url',
             type: 'url',
             required: true,
-            value: draft,
+            value: binding.url || draft,
+            readOnly: binding.state !== 'ready' || Boolean(binding.url),
             placeholder: 'https://ant.example.com',
-            onChange: (event) => setDraft(event.target.value),
+            onChange: (event) => { if (binding.state === 'ready' && !binding.url) setDraft(event.target.value) },
             style: inputStyle,
           }),
-          h('button', { type: 'submit', style: primaryButtonStyle }, '保存地址')),
+          binding.url ? null : h('button', { type: 'submit', disabled: binding.state !== 'ready', style: primaryButtonStyle }, '保存地址')),
+          binding.url ? h('p', { style: mutedTextStyle }, '若要切换团队，请先在下方断开当前设备，再填写新地址并验证邮箱。') : null,
+          binding.state === 'checking' ? h('p', { role: 'status', style: mutedTextStyle }, '正在核对这台 DSH 绑定的团队…') : null,
+          binding.state === 'unverified' ? h('p', { role: 'status', style: mutedTextStyle }, '本机仍有 ANT 凭证，但无法核对所属团队。请联系原团队管理员核查并撤销旧设备；确认后可在下方断开或仅清理本机。') : null,
+          binding.state === 'error' ? h('p', { role: 'status', style: mutedTextStyle }, '暂时无法核对这台 DSH 的团队绑定，请重新打开 ANT 或联系管理员。') : null,
           h('div', { style: { display: 'flex', flexWrap: 'wrap', alignItems: 'center', gap: 12 } },
             message ? h('p', { role: 'status', style: mutedTextStyle }, message) : null,
             link ? h('a', { href: link, target: '_blank', rel: 'noopener noreferrer', style: { color: 'var(--dsw-alias-link)', fontSize: 13 } }, '打开团队管理 ↗') : null)),
@@ -217,17 +266,22 @@ window.__ModuleLoader__.load({
             `${plugin.title} ${plugin.version}${plugin.versionUnknown ? '（本机版本暂无法读取，请核对是否受影响）' : ''}：${plugin.withdrawal_reason}`)),
           ...pluginAlerts.map((plugin) => h('button', { key: `${plugin.id}-open`, type: 'button',
             onClick: () => openInstalledPlugin(plugin.package_name), style: secondaryButtonStyle }, `在 DSH 中查看 ${plugin.title}`))) : null,
-        h(ModelSyncFooter, { remote, serviceUrl, onServiceUrlChange: setServiceUrl }))
+        h(ModelSyncFooter, { remote, serviceUrl, bindingReady: binding.state === 'ready',
+          onServiceUrlChange: setServiceUrl, onConnectionChange }))
     }
 
-    function SkillCenterPage({ onBack, onPlugins }) {
+    function SkillCenterPage({ remote, onBack, onAll, onSkills, onPlugins, openBundle,
+      includePlugins, query, onQueryChange }) {
       const [skills, setSkills] = useState([])
       const [loading, setLoading] = useState(false)
+      const [loadError, setLoadError] = useState(false)
       const [workingId, setWorkingId] = useState('')
       const [message, setMessage] = useState('')
-      const [query, setQuery] = useState('')
       const [filter, setFilter] = useState('all')
+      const [refreshToken, setRefreshToken] = useState(0)
+      const refreshGeneration = useRef(0)
       const refresh = async () => {
+        const generation = ++refreshGeneration.current
         setLoading(true)
         try {
           const response = await fetch('/api/ant-teams/skills', { cache: 'no-store' })
@@ -236,13 +290,17 @@ window.__ModuleLoader__.load({
             ? '请返回 ANT 插件设置，先验证工作邮箱并连接团队。'
             : result.message || `读取技能失败（${response.status}）。`)
           if (!Array.isArray(result.skills)) throw new Error('企业技能目录格式无效。')
+          if (generation !== refreshGeneration.current) return
           setSkills(result.skills)
+          setLoadError(false)
           setMessage(result.skills.length ? '' : '团队暂未发布精选技能。')
         } catch (error) {
+          if (generation !== refreshGeneration.current) return
           setSkills([])
+          setLoadError(true)
           setMessage(error instanceof Error ? error.message : '无法读取企业精选技能。')
         }
-        finally { setLoading(false) }
+        finally { if (generation === refreshGeneration.current) setLoading(false) }
       }
       useEffect(() => { void refresh() }, [])
       const changeInstall = async (skill, remove = false) => {
@@ -267,38 +325,58 @@ window.__ModuleLoader__.load({
         finally { setWorkingId('') }
       }
       const visible = skills.filter((skill) => {
-        const matchesFilter = filter === 'all' || skill.local_status === filter
+        const matchesFilter = filter === 'all'
+          || filter === 'available' && ['not-installed', 'update-available'].includes(skill.local_status)
+          || filter === 'installed' && ['installed', 'update-available'].includes(skill.local_status)
+          || filter === 'updates' && skill.local_status === 'update-available'
         const matchesQuery = !query.trim() || `${skill.title} ${skill.description} ${skill.dsh_name}`.toLowerCase().includes(query.trim().toLowerCase())
         return matchesFilter && matchesQuery
       })
       const statusLabel = { installed: '已放入本机目录', 'update-available': '可更新', 'not-installed': '未安装', conflict: '本机冲突' }
-      return h('section', { 'aria-label': '企业精选技能', style: {
+      return h('section', { 'aria-label': includePlugins ? '企业扩展' : '企业精选技能', style: {
         height: '100%', overflowY: 'auto', boxSizing: 'border-box',
         padding: 'calc(var(--dsh-frame-top-clearance, 0px) + 20px) clamp(16px, 3vw, 36px) 48px',
       } }, h('div', { style: { maxWidth: 1440, margin: '0 auto', display: 'grid', gap: 22 } },
-        h('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 8 } },
-          h('button', { type: 'button', onClick: onBack, style: secondaryButtonStyle }, '← 返回 ANT 插件设置'),
-          h('button', { type: 'button', onClick: onPlugins, style: secondaryButtonStyle }, '查看企业精选插件 →')),
+        h('div', { style: { display: 'flex', flexWrap: 'wrap', alignItems: 'center', gap: 8 } },
+          h('nav', { 'aria-label': '企业扩展分类', style: { display: 'flex', gap: 6 } },
+            includePlugins
+              ? h('span', { 'aria-current': 'page', style: { ...categoryButtonStyle, display: 'inline-flex', alignItems: 'center', cursor: 'default', backgroundColor: 'var(--dsw-alias-bg-layer-2)' } }, '总览')
+              : h('button', { type: 'button', onClick: onAll, style: categoryButtonStyle }, '总览'),
+            includePlugins
+              ? h('button', { type: 'button', onClick: onSkills, style: categoryButtonStyle }, '技能')
+              : h('span', { 'aria-current': 'page', style: { ...categoryButtonStyle, display: 'inline-flex', alignItems: 'center', cursor: 'default', backgroundColor: 'var(--dsw-alias-bg-layer-2)' } }, '技能'),
+            h('button', { type: 'button', onClick: onPlugins, style: categoryButtonStyle }, '插件')),
+          h('button', { type: 'button', onClick: onBack, style: { ...categoryButtonStyle, marginLeft: 'auto' } }, 'ANT 设置')),
         h('div', { style: { display: 'flex', flexWrap: 'wrap', alignItems: 'end', justifyContent: 'space-between', gap: 16 } },
           h('div', null,
-            h('h1', { style: { margin: 0, fontSize: 28 } }, '企业精选技能'),
-            h('p', { style: { ...mutedTextStyle, marginTop: 6 } }, '团队管理员审核后发布；安装到这台 DSH 后，由 DSH 原生技能系统发现和使用。')),
-          h('button', { type: 'button', disabled: loading || Boolean(workingId), onClick: () => void refresh(), style: secondaryButtonStyle }, loading ? '读取中…' : '刷新目录')),
+            h('h1', { style: { margin: 0, fontSize: 28 } }, includePlugins ? '企业扩展' : '企业精选技能'),
+            h('p', { style: { ...mutedTextStyle, marginTop: 6 } }, includePlugins
+              ? '浏览团队审核的技能与插件；选择需要的扩展安装到这台 DSH。'
+              : '团队管理员审核后发布；安装到这台 DSH 后，由 DSH 原生技能系统发现和使用。')),
+          h('button', { type: 'button', disabled: loading || Boolean(workingId), onClick: () => {
+            void refresh()
+            if (includePlugins) setRefreshToken((value) => value + 1)
+          }, style: secondaryButtonStyle }, loading ? '读取中…' : '刷新目录')),
         h(ExtensionRequestNotice),
         h('div', { style: { ...panelStyle, gap: 12 } },
-          h('input', { type: 'search', value: query, onChange: (event) => setQuery(event.target.value), placeholder: '搜索技能名称或说明', 'aria-label': '搜索企业精选技能', style: inputStyle }),
+          h('input', { type: 'search', value: query, onChange: (event) => onQueryChange(event.target.value),
+            placeholder: includePlugins ? '搜索技能或插件名称、用途' : '搜索技能名称或说明',
+            'aria-label': includePlugins ? '搜索企业扩展' : '搜索企业精选技能', style: inputStyle }),
           h('div', { style: { display: 'flex', flexWrap: 'wrap', alignItems: 'center', gap: 8 } },
-            ...[['all', '全部'], ['not-installed', '可安装'], ['installed', '已安装'], ['update-available', '可更新']].map(([value, label]) =>
+            ...[['all', '全部'], ['available', '可安装或更新'], ['installed', '已安装'], ['updates', '可更新']].map(([value, label]) =>
               h('button', { key: value, type: 'button', onClick: () => setFilter(value), 'aria-pressed': filter === value,
                 style: { ...secondaryButtonStyle, minHeight: 34, padding: '6px 12px', backgroundColor: filter === value ? 'var(--dsw-alias-bg-layer-2)' : secondaryButtonStyle.backgroundColor } }, label)),
-            h('span', { style: { ...mutedTextStyle, marginLeft: 'auto' } }, `显示 ${visible.length} / ${skills.length} 个技能`))),
-        message ? h('p', { role: 'status', style: mutedTextStyle }, message) : null,
+            includePlugins ? null : h('span', { style: { ...mutedTextStyle, marginLeft: 'auto' } }, `显示 ${visible.length} / ${skills.length} 个技能`))),
+        includePlugins ? h('h2', { style: { margin: 0, fontSize: 20 } }, loading ? '技能 · 读取中…' : `技能 · ${visible.length}`) : null,
+        message && (!includePlugins || loadError || skills.length) ? h('p', { role: loadError ? 'alert' : 'status', style: mutedTextStyle }, message) : null,
         visible.length ? h('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(min(100%, 420px), 1fr))', gap: 16 } },
           ...visible.map((skill) => {
             const description = skill.description || ''
             return h('article', { key: skill.id, style: { ...panelStyle, gap: 13 } },
               h('div', { style: { display: 'flex', flexWrap: 'wrap', justifyContent: 'space-between', alignItems: 'baseline', gap: 8 } },
-                h('h2', { style: { margin: 0, fontSize: 19 } }, skill.title),
+                h('div', { style: { display: 'flex', alignItems: 'baseline', flexWrap: 'wrap', gap: 8 } },
+                  h('h2', { style: { margin: 0, fontSize: 19 } }, skill.title),
+                  includePlugins ? h('span', { style: mutedTextStyle }, '技能') : null),
                 h('span', { style: mutedTextStyle }, statusLabel[skill.local_status] || '状态未知')),
               h('p', { style: mutedTextStyle }, description.length > 180 ? `${description.slice(0, 180)}…` : description),
               description.length > 180 ? h('details', null,
@@ -309,25 +387,33 @@ window.__ModuleLoader__.load({
               skill.local_status === 'conflict'
                 ? h('p', { role: 'status', style: mutedTextStyle }, '本机同名技能有未受 ANT 管理的内容、文件已被修改或备份损坏；请联系管理员处理。')
                 : h('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 8, marginTop: 'auto' } },
-                    h('button', { type: 'button', disabled: Boolean(workingId) || skill.local_status === 'installed',
+                    skill.local_status === 'installed' ? null : h('button', { type: 'button', disabled: Boolean(workingId),
                       onClick: () => void changeInstall(skill), style: primaryButtonStyle },
-                    skill.local_status === 'installed' ? '文件已安装' : skill.local_status === 'update-available' ? '更新技能' : '安装到这台 DSH'),
+                    skill.local_status === 'update-available' ? '更新技能' : '安装到这台 DSH'),
                     skill.local_status !== 'not-installed' ? h('button', { type: 'button', disabled: Boolean(workingId),
                       onClick: () => void changeInstall(skill, true), style: secondaryButtonStyle }, '卸载') : null))
-          })) : !loading && skills.length ? h('p', { style: mutedTextStyle }, '没有符合筛选条件的技能。') : null))
+          })) : !includePlugins && !loading && skills.length ? h('p', { style: mutedTextStyle }, '没有符合筛选条件的技能。') : null,
+        includePlugins ? h(PluginCenterPage, { remote, onBack, onAll, onSkills, openBundle,
+          embedded: true, query, onQueryChange, externalFilter: filter,
+          hasSkillMatches: visible.length > 0, skillCatalogReady: !loading && !loadError,
+          refreshToken }) : null))
     }
 
-    function PluginCenterPage({ remote, onBack, onSkills, openBundle }) {
+    function PluginCenterPage({ remote, onBack, onAll, onSkills, openBundle,
+      embedded = false, query, onQueryChange, externalFilter = 'all',
+      hasSkillMatches = false, skillCatalogReady = false, refreshToken }) {
       const [plugins, setPlugins] = useState([])
       const [bundles, setBundles] = useState([])
-      const [loading, setLoading] = useState(false)
+      const [loading, setLoading] = useState(true)
+      const [loadError, setLoadError] = useState(false)
       const [workingId, setWorkingId] = useState('')
       const [uncertainId, setUncertainId] = useState('')
       const [completedId, setCompletedId] = useState('')
       const [message, setMessage] = useState('')
-      const [query, setQuery] = useState('')
       const [filter, setFilter] = useState('all')
+      const refreshGeneration = useRef(0)
       const refresh = async () => {
+        const generation = ++refreshGeneration.current
         setLoading(true)
         try {
           const manager = remote?.pluginManager
@@ -339,16 +425,20 @@ window.__ModuleLoader__.load({
           if (!response.ok) throw new Error(result.message || `读取插件目录失败（${response.status}）。`)
           if (!Array.isArray(result.plugins)) throw new Error('企业插件目录格式无效。')
           if (!listed.ok) throw new Error(listed.error?.message || '无法读取 DSH 本机插件。')
+          if (generation !== refreshGeneration.current) return
           setPlugins(result.plugins)
           setBundles(listed.value)
+          setLoadError(false)
           setMessage(result.plugins.length ? '' : '团队暂未发布精选插件。')
         } catch (error) {
+          if (generation !== refreshGeneration.current) return
           setPlugins([])
           setBundles([])
+          setLoadError(true)
           setMessage(error instanceof Error ? error.message : '无法读取企业精选插件。')
-        } finally { setLoading(false) }
+        } finally { if (generation === refreshGeneration.current) setLoading(false) }
       }
-      useEffect(() => { void refresh() }, [])
+      useEffect(() => { void refresh() }, [refreshToken])
       const install = async (plugin) => {
         const artifactUrl = approvedPluginArtifactUrl(plugin)
         if (!artifactUrl || workingId || uncertainId === plugin.id || completedId === plugin.id) return
@@ -433,37 +523,51 @@ window.__ModuleLoader__.load({
           setMessage(error instanceof Error ? error.message : '插件安装未完成，请稍后重试。')
         } finally { setWorkingId('') }
       }
+      const activeFilter = embedded ? externalFilter : filter
       const visible = plugins.filter((plugin) => {
         const installed = bundles.find((bundle) => bundle.name === plugin.package_name && bundle.installed)
         const artifactUrl = approvedPluginArtifactUrl(plugin)
         const matches = !query.trim() || `${plugin.title} ${plugin.description} ${plugin.package_name}`.toLowerCase().includes(query.trim().toLowerCase())
-        return matches && (filter === 'all' || filter === 'installed' && installed?.version === plugin.version
-          || filter === 'available' && artifactUrl && (!installed || (installed.version && installed.version !== plugin.version))
-          || filter === 'retired' && plugin.status !== 'published')
+        return matches && (activeFilter === 'all' || activeFilter === 'installed' && Boolean(installed)
+          || activeFilter === 'available' && artifactUrl && (!installed || (installed.version && installed.version !== plugin.version))
+          || activeFilter === 'updates' && artifactUrl && installed && installed.version && installed.version !== plugin.version
+          || activeFilter === 'retired' && plugin.status !== 'published')
       })
-      return h('section', { 'aria-label': '企业精选插件', style: {
-        height: '100%', overflowY: 'auto', boxSizing: 'border-box',
-        padding: 'calc(var(--dsh-frame-top-clearance, 0px) + 20px) clamp(16px, 3vw, 36px) 48px',
-      } }, h('div', { style: { maxWidth: 1440, margin: '0 auto', display: 'grid', gap: 22 } },
-        h('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 8 } },
-          h('button', { type: 'button', onClick: onBack, style: secondaryButtonStyle }, '← 返回 ANT 插件设置'),
-          h('button', { type: 'button', onClick: onSkills, style: secondaryButtonStyle }, '查看企业精选技能 →')),
-        h('div', { style: { display: 'flex', flexWrap: 'wrap', justifyContent: 'space-between', gap: 16 } },
+      const noMatches = embedded
+        ? skillCatalogReady ? '没有找到符合条件的企业扩展。' : '插件中没有符合条件的结果。'
+        : activeFilter === 'available'
+          ? '当前没有可一键安装的插件。可在“全部”查看审核目录，或联系企业管理员。'
+          : '没有符合筛选条件的插件。'
+      return h('section', { 'aria-label': '企业精选插件', style: embedded
+        ? { display: 'grid', gap: 16 }
+        : { height: '100%', overflowY: 'auto', boxSizing: 'border-box',
+          padding: 'calc(var(--dsh-frame-top-clearance, 0px) + 20px) clamp(16px, 3vw, 36px) 48px' },
+      }, h('div', { style: embedded ? { display: 'grid', gap: 16 } : { maxWidth: 1440, margin: '0 auto', display: 'grid', gap: 22 } },
+        embedded ? h('h2', { style: { margin: 0, fontSize: 20 } }, loading ? '插件 · 读取中…' : `插件 · ${visible.length}`) : h('div', { style: { display: 'flex', flexWrap: 'wrap', alignItems: 'center', gap: 8 } },
+          h('nav', { 'aria-label': '企业扩展分类', style: { display: 'flex', gap: 6 } },
+            h('button', { type: 'button', onClick: onAll, style: categoryButtonStyle }, '总览'),
+            h('button', { type: 'button', onClick: onSkills, style: categoryButtonStyle }, '技能'),
+            h('span', { 'aria-current': 'page', style: { ...categoryButtonStyle, display: 'inline-flex', alignItems: 'center', cursor: 'default', backgroundColor: 'var(--dsw-alias-bg-layer-2)' } }, '插件')),
+          h('button', { type: 'button', onClick: onBack, style: { ...categoryButtonStyle, marginLeft: 'auto' } }, 'ANT 设置')),
+        embedded ? null : h('div', { style: { display: 'flex', flexWrap: 'wrap', justifyContent: 'space-between', gap: 16 } },
           h('div', null,
             h('h1', { style: { margin: 0, fontSize: 28 } }, '企业精选插件'),
             h('p', { style: { ...mutedTextStyle, marginTop: 6 } }, '这里展示团队审核过的插件版本及本机状态。')),
           h('button', { type: 'button', disabled: loading, onClick: () => void refresh(), style: secondaryButtonStyle }, loading ? '读取中…' : '刷新目录')),
-        h('aside', { role: 'note', style: { ...panelStyle, borderColor: 'var(--dsw-alias-label-danger, #d44)' } },
-          h('strong', null, '只安装团队锁定的固定版本'),
-          h('p', { style: mutedTextStyle }, '显示“安装”按钮的版本已锁定实际安装包并由管理员发布；其他目录项仅供查看，如需使用请联系企业管理员。')),
-        h(ExtensionRequestNotice),
-        h('div', { style: panelStyle },
-          h('input', { type: 'search', value: query, onChange: (event) => setQuery(event.target.value), placeholder: '搜索插件名称或用途', 'aria-label': '搜索企业精选插件', style: inputStyle }),
+        !loading && !plugins.length && !loadError ? embedded
+          ? h('p', { role: 'status', style: mutedTextStyle }, '团队暂未发布精选插件。')
+          : h('section', { role: 'status', style: panelStyle },
+              h('h2', { style: { margin: 0, fontSize: 18 } }, '团队暂未发布精选插件'),
+              h('p', { style: mutedTextStyle }, '需要某个插件？请联系企业管理员，说明用途或提供插件地址。审核发布后会显示在这里。')) : null,
+        !loading && loadError ? h('p', { role: 'alert', style: mutedTextStyle }, message) : null,
+        plugins.length && !embedded ? h(ExtensionRequestNotice) : null,
+        plugins.length && !embedded ? h('div', { style: panelStyle },
+          h('input', { type: 'search', value: query, onChange: (event) => onQueryChange(event.target.value), placeholder: '搜索插件名称或用途', 'aria-label': '搜索企业精选插件', style: inputStyle }),
           h('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 8 } },
             ...[['all', '全部'], ['available', '可安装或升级'], ['installed', '已安装'], ['retired', '已废弃']].map(([value, label]) =>
               h('button', { key: value, type: 'button', onClick: () => setFilter(value), 'aria-pressed': filter === value,
-                style: { ...secondaryButtonStyle, minHeight: 34, backgroundColor: filter === value ? 'var(--dsw-alias-bg-layer-2)' : secondaryButtonStyle.backgroundColor } }, label)))),
-        message ? h('p', { role: 'status', style: mutedTextStyle }, message) : null,
+                style: { ...secondaryButtonStyle, minHeight: 34, backgroundColor: filter === value ? 'var(--dsw-alias-bg-layer-2)' : secondaryButtonStyle.backgroundColor } }, label)))) : null,
+        plugins.length && message ? h('p', { role: 'status', style: mutedTextStyle }, message) : null,
         visible.length ? h('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(min(100%, 420px), 1fr))', gap: 16 } },
           ...visible.map((plugin) => {
             const local = bundles.find((bundle) => bundle.name === plugin.package_name && bundle.installed)
@@ -483,7 +587,9 @@ window.__ModuleLoader__.load({
             return h('article', { key: plugin.id, style: security
               ? { ...panelStyle, borderColor: 'var(--dsw-alias-label-danger, #d44)' } : panelStyle },
               h('div', { style: { display: 'flex', flexWrap: 'wrap', justifyContent: 'space-between', gap: 8 } },
-                h('h2', { style: { margin: 0, fontSize: 19 } }, plugin.title),
+                h('div', { style: { display: 'flex', alignItems: 'baseline', flexWrap: 'wrap', gap: 8 } },
+                  h('h2', { style: { margin: 0, fontSize: 19 } }, plugin.title),
+                  embedded ? h('span', { style: mutedTextStyle }, '插件') : null),
                 h('span', { style: security
                   ? { ...mutedTextStyle, color: 'var(--dsw-alias-label-danger, #d44)', fontWeight: 650 } : mutedTextStyle }, status)),
               h('p', { style: mutedTextStyle }, plugin.description),
@@ -510,12 +616,11 @@ window.__ModuleLoader__.load({
                 local || uncertainId === plugin.id ? h('button', { type: 'button', onClick: () => openBundle(plugin.package_name), style: secondaryButtonStyle }, '打开 DSH 插件管理') : null,
                 local && !sameVersion && plugin.status === 'published' && !artifactUrl
                   ? h('p', { style: mutedTextStyle }, '本机版本与团队审核版本不同；请联系企业管理员核对。') : null))
-          })) : !loading && plugins.length ? h('p', { style: mutedTextStyle }, filter === 'available'
-            ? '当前没有可一键安装的插件。可在“全部”查看审核目录，或联系企业管理员。'
-            : '没有符合筛选条件的插件。') : null))
+          })) : !loading && plugins.length && (!embedded || !hasSkillMatches)
+          ? h('p', { style: mutedTextStyle }, noMatches) : null))
     }
 
-    function ModelSyncFooter({ remote, serviceUrl, onServiceUrlChange }) {
+    function ModelSyncFooter({ remote, serviceUrl, bindingReady, onServiceUrlChange, onConnectionChange }) {
       const [email, setEmail] = useState('')
       const [code, setCode] = useState('')
       const [message, setMessage] = useState('')
@@ -540,13 +645,13 @@ window.__ModuleLoader__.load({
           : `${message} 本机无法确认旧设备编号；请让原团队管理员按成员查看设备清单，勿用新编号猜测。`
       }
 
-      const inspectServiceCompatibility = async (rawServiceUrl, useSavedConnection = false) => {
+      const inspectServiceCompatibility = async (rawServiceUrl, useSavedConnection = false, isCurrent = () => true) => {
         const normalized = normalizeServiceUrl(rawServiceUrl)
         if (!normalized && !useSavedConnection) {
-          setServiceCompatibility({ state: 'idle', message: '' })
+          if (isCurrent()) setServiceCompatibility({ state: 'idle', message: '' })
           return null
         }
-        setServiceCompatibility({ state: 'checking', message: '正在识别 ANT 客户端与服务端版本…' })
+        if (isCurrent()) setServiceCompatibility({ state: 'checking', message: '正在识别 ANT 客户端与服务端版本…' })
         try {
           const manager = remote?.pluginManager
           if (typeof manager?.listBundles !== 'function') throw new Error('当前 DSH 未提供 Bundle 版本读取接口。')
@@ -577,14 +682,14 @@ window.__ModuleLoader__.load({
               : `已识别 ANT Bundle v${result.bundle_version} 和服务端 v${result.server_version}；服务端未提供协议能力，兼容性未知，仍允许继续。`
           const state = compatibility === true ? 'compatible' : compatibility === false ? 'incompatible' : 'unknown'
           const status = { state, message, ...result }
-          setServiceCompatibility(status)
+          if (isCurrent()) setServiceCompatibility(status)
           return status
         } catch (error) {
           const status = {
             state: 'unknown',
             message: `无法确认 ANT 版本兼容性，仍允许继续：${error instanceof Error ? error.message : '连接检查失败。'}`,
           }
-          setServiceCompatibility(status)
+          if (isCurrent()) setServiceCompatibility(status)
           return status
         }
       }
@@ -629,6 +734,10 @@ window.__ModuleLoader__.load({
       }
 
       const refreshModels = async () => {
+        if (!bindingReady) {
+          setMessage('请先等待团队绑定检查完成，再刷新团队模型。')
+          return
+        }
         setBusy(true)
         setMessage('正在从 ANT 刷新获准模型…')
         try {
@@ -806,6 +915,7 @@ window.__ModuleLoader__.load({
         const credentialResult = await remote.credentials.unset('ANT_MODEL_API_KEY')
         if (!credentialResult.ok) throw new Error(credentialResult.error?.message || 'ANT 成员凭证未能清除。')
         setCredentialConfigured(false)
+        onConnectionChange?.(null)
         setNeedsReconnect(false)
         setReauthenticate(false)
         setAllowLocalCleanup(false)
@@ -857,13 +967,13 @@ window.__ModuleLoader__.load({
           if (!current) return
           const configured = result.ok ? Boolean(result.value?.ANT_MODEL_API_KEY?.configured) : null
           setCredentialConfigured(configured)
-          if (configured) {
+          if (configured && bindingReady) {
             void refreshModels()
             void checkBundleUpdate()
           }
         }).catch(() => { if (current) setCredentialConfigured(null) })
         return () => { current = false }
-      }, [remote])
+      }, [remote, bindingReady])
 
       useEffect(() => {
         let current = true
@@ -883,11 +993,21 @@ window.__ModuleLoader__.load({
       }, [remote, credentialConfigured])
 
       useEffect(() => {
-        void inspectServiceCompatibility(serviceUrl, credentialConfigured === true)
-      }, [remote, serviceUrl, credentialConfigured])
+        if (!bindingReady) {
+          setServiceCompatibility({ state: 'idle', message: '' })
+          return
+        }
+        let current = true
+        void inspectServiceCompatibility(serviceUrl, credentialConfigured === true, () => current)
+        return () => { current = false }
+      }, [remote, serviceUrl, credentialConfigured, bindingReady])
 
       const requestCode = async (event) => {
         event.preventDefault()
+        if (!bindingReady) {
+          setMessage('请先等待团队绑定检查完成，再验证工作邮箱。')
+          return
+        }
         const normalized = normalizeServiceUrl(serviceUrl)
         const normalizedEmail = email.trim()
         if (!normalized) {
@@ -929,6 +1049,10 @@ window.__ModuleLoader__.load({
 
       const connect = async (event) => {
         event.preventDefault()
+        if (!bindingReady) {
+          setMessage('请先等待团队绑定检查完成，再连接团队。')
+          return
+        }
         const normalized = normalizeServiceUrl(serviceUrl)
         const normalizedEmail = email.trim()
         const normalizedCode = code.trim()
@@ -945,6 +1069,7 @@ window.__ModuleLoader__.load({
         }
         setBusy(true)
         setMessage('正在验证邮箱并同步团队模型…')
+        let credentialSaved = false
         try {
           await requireCompatibleService(normalized)
           localStorage.setItem(SERVICE_URL_STORAGE_KEY, normalized)
@@ -968,24 +1093,34 @@ window.__ModuleLoader__.load({
           }
           const credentialWrite = await remote.credentials.set('ANT_MODEL_API_KEY', result.token)
           if (!credentialWrite.ok) throw new Error(credentialWrite.error?.message || 'DSH 无法安全保存 ANT 凭证。')
+          credentialSaved = true
           await applyAuthorizedModels(result.models, normalized)
           setCode('')
           onServiceUrlChange(normalized)
           setCodeRequested(false)
           setCredentialConfigured(true)
+          onConnectionChange?.(normalized)
           setAllowLocalCleanup(false)
           setNeedsReconnect(false)
           setReauthenticate(false)
           setMessage(`已连接 ${result.email || normalizedEmail}，同步 ${result.models.length} 个获准模型。它们现已出现在 DSH 模型选择器中。`)
         } catch (error) {
-          setMessage(error instanceof Error ? error.message : '连接失败，请稍后重试。')
+          if (credentialSaved) {
+            setCredentialConfigured(true)
+            setCode('')
+            setCodeRequested(false)
+            onConnectionChange?.(normalized)
+            setMessage(`ANT 凭证已保存，但团队模型未能同步：${error instanceof Error ? error.message : '请稍后重试。'} 请点击“刷新团队模型”重试。`)
+          } else {
+            setMessage(error instanceof Error ? error.message : '连接失败，请稍后重试。')
+          }
         } finally {
           setBusy(false)
         }
       }
 
       const showConnectForm = credentialConfigured !== true || reauthenticate || needsReconnect
-      const canCheckUpdate = credentialConfigured === true && !needsReconnect
+      const canCheckUpdate = bindingReady && credentialConfigured === true && !needsReconnect
       const updateGuideUrl = pinnedServiceUrl
         ? new URL('/ant-update', pinnedServiceUrl).href : null
       return h('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(min(100%, 400px), 1fr))', alignItems: 'start', gap: 16 } },
@@ -996,11 +1131,13 @@ window.__ModuleLoader__.load({
               h('p', { style: { ...mutedTextStyle, marginTop: 4 } }, '使用上方团队服务地址验证工作邮箱并同步授权模型。连接状态变化时可随时刷新。')),
             h('span', { style: {
               flexShrink: 0, padding: '4px 9px', borderRadius: 999,
-              color: credentialConfigured === true ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-label-secondary)',
-              backgroundColor: credentialConfigured === true ? 'var(--dsw-alias-state-success-tertiary)' : 'var(--dsw-alias-bg-layer-2)',
+              color: credentialConfigured === true && bindingReady ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-label-secondary)',
+              backgroundColor: credentialConfigured === true && bindingReady ? 'var(--dsw-alias-state-success-tertiary)' : 'var(--dsw-alias-bg-layer-2)',
               fontSize: 12,
-            } }, credentialConfigured === true ? '已连接' : credentialConfigured === false ? '未连接' : '检查中')),
-          h('p', { role: 'status', style: mutedTextStyle }, credentialConfigured === true
+            } }, credentialConfigured === true ? bindingReady ? '已连接' : '待核对' : credentialConfigured === false ? '未连接' : '检查中')),
+          h('p', { role: 'status', style: mutedTextStyle }, credentialConfigured === true && !bindingReady
+            ? '本机有 ANT 凭证，但尚未确认它绑定的团队；请先完成上方的绑定检查。'
+            : credentialConfigured === true
             ? 'DSH 已安全保存此设备的 ANT 团队凭证。'
             : credentialConfigured === false ? '验证工作邮箱后即可连接团队模型。' : '正在检查 ANT 连接状态…'),
           serviceCompatibility.state !== 'idle' ? h('p', {
@@ -1011,10 +1148,10 @@ window.__ModuleLoader__.load({
             },
           }, serviceCompatibility.message) : null,
           credentialConfigured === true && !showConnectForm ? h('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 8 } },
-            h('button', { type: 'button', disabled: busy, onClick: () => void refreshModels(), style: primaryButtonStyle }, busy ? '刷新中…' : '刷新团队模型'),
-            h('button', { type: 'button', disabled: busy, onClick: () => { setReauthenticate(true); setMessage('') }, style: secondaryButtonStyle }, '重新验证邮箱'),
+            h('button', { type: 'button', disabled: busy || !bindingReady, onClick: () => void refreshModels(), style: primaryButtonStyle }, busy ? '刷新中…' : '刷新团队模型'),
+            h('button', { type: 'button', disabled: busy || !bindingReady, onClick: () => { setReauthenticate(true); setMessage('') }, style: secondaryButtonStyle }, '重新验证邮箱'),
             h('button', { type: 'button', disabled: busy, onClick: () => { if (window.confirm('断开当前设备与 ANT 的连接？本机 ANT 凭证和模型设置将被清除，团队服务地址会保留。')) void disconnect() }, style: secondaryButtonStyle }, '断开当前设备')) : null,
-          h('section', { style: { ...panelStyle, padding: 14, gap: 10 } },
+          h('section', { style: { display: 'grid', gap: 8, paddingTop: 12, borderTop: '0.5px solid var(--dsw-alias-border-l2)' } },
             h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', gap: 12 } },
               h('h4', { style: { margin: 0, fontSize: 14, fontWeight: 650 } }, 'ANT 插件更新'),
               h('button', { type: 'button', disabled: busy || !canCheckUpdate || bundleUpdate.state === 'checking', onClick: () => void checkBundleUpdate(), style: secondaryButtonStyle }, bundleUpdate.state === 'checking' ? '检查中…' : '检查更新')),
@@ -1034,7 +1171,7 @@ window.__ModuleLoader__.load({
               id: 'ant-team-model-email', type: 'email', autoComplete: 'email', required: true, value: email,
               onChange: (event) => setEmail(event.target.value), style: inputStyle,
             }),
-            h('button', { type: 'submit', disabled: busy, style: primaryButtonStyle }, busy ? '发送中…' : '发送验证码')) : null,
+            h('button', { type: 'submit', disabled: busy || !bindingReady, style: primaryButtonStyle }, busy ? '发送中…' : '发送验证码')) : null,
           credentialConfigured === true && showConnectForm ? h('button', {
             type: 'button', disabled: busy,
             onClick: () => { if (window.confirm('断开当前设备与 ANT 的连接？本机 ANT 凭证和模型设置将被清除，团队服务地址会保留。')) void disconnect() },
@@ -1047,7 +1184,7 @@ window.__ModuleLoader__.load({
               required: true, maxLength: 8, value: code, placeholder: '8 位验证码',
               onChange: (event) => setCode(event.target.value.replace(/\D/gu, '').slice(0, 8)), style: inputStyle,
             }),
-            h('button', { type: 'submit', disabled: busy || code.length !== 8, style: primaryButtonStyle }, busy ? '连接中…' : '验证并连接')) : null,
+            h('button', { type: 'submit', disabled: busy || !bindingReady || code.length !== 8, style: primaryButtonStyle }, busy ? '连接中…' : '验证并连接')) : null,
           allowLocalCleanup ? h('section', { style: { ...panelStyle, padding: 14, gap: 9 } },
             h('p', { style: mutedTextStyle }, savedDeviceId()
               ? `已保存的设备编号：${savedDeviceId()}。请交给原团队管理员核对。`
@@ -1077,10 +1214,16 @@ window.__ModuleLoader__.load({
     }
 
     function EnterpriseExtensionsPage({ remote, onBack, openBundle }) {
-      const [tab, setTab] = useState('skills')
-      return tab === 'skills'
-        ? h(SkillCenterPage, { onBack, onPlugins: () => setTab('plugins') })
-        : h(PluginCenterPage, { remote, onBack, onSkills: () => setTab('skills'), openBundle })
+      const [tab, setTab] = useState('all')
+      const [query, setQuery] = useState('')
+      const navigation = {
+        onAll: () => setTab('all'), onSkills: () => setTab('skills'),
+        onPlugins: () => setTab('plugins'),
+      }
+      return tab === 'plugins'
+        ? h(PluginCenterPage, { remote, onBack, openBundle, query, onQueryChange: setQuery, ...navigation })
+        : h(SkillCenterPage, { remote, onBack, openBundle, query, onQueryChange: setQuery,
+          includePlugins: tab === 'all', ...navigation })
     }
 
     function apply(ctx) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-wendao/ant",
-  "version": "0.3.14",
+  "version": "0.3.16",
   "description": "ANT (AI-native Teams) connects a DeepSeek Harness Desktop profile to team identity and approved models.",
   "type": "module",
   "scripts": {