@ai-wendao/ant 0.4.8 → 0.4.10

package/README.md

@@ -20,11 +20,11 @@ ANT (AI-native Teams) connects a DeepSeek Harness Desktop profile to its team's
 
 ## 企业精选插件
 
-管理员可从 npm 官方源的 DSH Bundle 精确版本创建草稿，填写源码、许可证、依赖和安装脚本的审核记录后发布。成员在“企业扩展”总览或“插件”分类查看审核信息和本机状态。对无新增依赖、无安装阶段脚本且归档符合首批准入条件的草稿，管理员可从 npm 官方源锁定实际 `.tgz` 并查看文件清单、下载核验制品；这类草稿经审核发布后，成员可让 DSH 从 ANT 的固定制品地址一键安装。其他版本仍是目录项，需联系管理员安排。安全撤回版本会停止新的 ANT 下载，但不会自动删除本机副本；ANT 设置页继续显示相应风险公告。范围与限制见[上线边界](../../docs/decisions/2026-10-15-plugin-center-rollout.md)。
+管理员从 npm 官方源的 DSH Bundle 精确版本创建草稿，填写源码、许可证、依赖和安装脚本的审核记录后发布。成员在“企业扩展”总览或“插件”分类查看审核信息和本机状态；发布后可让 DSH 官方插件管理器从 npm 安装目录中的精确版本，无须先由管理员锁定 ANT tarball。ANT 也保留可选的固定 tarball 安装路径。直接安装时，DSH 按 registry/fallback 配置解析依赖，设备间版本可能不同；ANT 不会批准依赖构建脚本，如安装因此中断需按 DSH 提示转到原生插件管理页处理。ANT 目录不控制插件之后的自更新；部分插件可提供自己的更新器，DSH 原生插件管理页也可更换版本。安全撤回版本会停止通过 ANT 目录发起的新安装，但不会自动删除本机副本。范围与限制见[上线边界](../../docs/decisions/2026-10-15-plugin-center-rollout.md)。
 
 ANT 自身更新使用单独的已审核安装包。管理员将与 npm 发布一致的 `.tgz` 上传到 ANT 服务端并登记版本；新版 ANT 页面可点击“更新”，DSH 原位替换同名 Bundle 后提示重启。旧版 `@ai-wendao/ant` 用户可打开团队服务的 `/ant-update` 指引，在 DSH“添加插件”中粘贴该安装包地址完成一次性原位更新，无需先卸载或使用终端。此入口只分发 ANT 自身，不启用扩展中心其他插件的一键安装。
 
-企业精选是团队推荐目录，不是强制白名单；ANT 不能阻止成员从 DSH 原生插件管理页自行安装其他包。第一批一键安装只分发 ANT 已核验并保存的顶层包，不把有依赖或安装脚本的版本伪装成已受控；DSH RC2 后续包管理能否一直保留这一固定制品仍需真机验收。上线边界见[待决策记录](../../docs/decisions/2026-10-15-plugin-center-rollout.md)。
+企业精选是团队推荐目录，不是强制白名单；ANT 不能阻止成员从 DSH 原生插件管理页或插件自身更新器安装其他版本。DSH `0.2.0-rc.2` 本身不自动更新已安装 Bundle；插件可以提供自己的更新操作。ANT 目录只约束它发起的安装，不对本机安装后的版本持续强制管理。上线边界见[待决策记录](../../docs/decisions/2026-10-15-plugin-center-rollout.md)。
 
 ## Existing `ant` alias installations
 

package/client.js

@@ -227,6 +227,12 @@ window.__ModuleLoader__.load({
         ? url.href : null
     }
 
+    function pluginInstallSpec(plugin) {
+      if (plugin?.status !== 'published' || typeof plugin.package_name !== 'string'
+        || typeof plugin.version !== 'string' || !plugin.package_name || !plugin.version) return ''
+      return approvedPluginArtifactUrl(plugin) || directInstallSpec(plugin)
+    }
+
     function previouslyInstalledReviewedPlugin(plugin) {
       try { return localStorage.getItem(`${PLUGIN_INSTALL_RECORD_PREFIX}${plugin.id}`) === plugin.artifact_sha256 }
       catch { return false }
@@ -435,7 +441,8 @@ window.__ModuleLoader__.load({
             border: '0', borderBottom: activeTab === tab ? '2px solid var(--dsw-alias-state-business-primary)' : '2px solid transparent',
             backgroundColor: 'transparent',
           } }, tab === 'updates' && updateNeedsAttention ? `${label} · ${updateSummary.state === 'available' ? '有新版' : '需处理'}` : label)))),
-        h('div', { id: 'ant-settings-content', role: 'tabpanel', 'aria-labelledby': `ant-settings-tab-${activeTab}` },
+        h('div', { id: 'ant-settings-content', role: 'tabpanel', 'aria-labelledby': `ant-settings-tab-${activeTab}`,
+          style: { display: 'grid', gap: activeTab === 'connection' ? 12 : 0 } },
           teamServicePanel,
           h(ModelSyncFooter, { remote, serviceUrl, bindingReady: binding.state === 'ready', activeTab,
             onServiceUrlChange: setServiceUrl, onConnectionChange,
@@ -657,7 +664,7 @@ window.__ModuleLoader__.load({
           const result = await readLocalJsonResponse(response)
           if (!response.ok) throw new Error(result.message || '无法获取身份绑定码。')
           setBindingCode(result.code)
-          setMessage('绑定码 5 分钟有效。请你本人私聊这个机器人完成绑定。')
+          setMessage('')
         } catch (error) { setMessage(error.message) }
         finally { setBusy(false) }
       }
@@ -949,7 +956,8 @@ window.__ModuleLoader__.load({
         h('p', { role: 'status', style: mutedTextStyle }, '私聊与群聊可同时开启；每项能力一次只授权给一个私聊或一个群。普通对话不会自动获得读取电脑、调用工具或访问其他群的权限。'),
         loadFailures.length ? h('p', { role: 'status', style: mutedTextStyle },
           `部分协作信息暂时无法读取：${loadFailures.map((path) => loadNames[path]).join('、')}。已读取的信息仍显示，请稍后刷新状态。`) : null,
-          h('span', { role: 'status', style: mutedTextStyle }, loading ? '正在读取机器人与任务状态…'
+          h('div', { style: { display: 'flex', flexWrap: 'wrap', alignItems: 'flex-start', justifyContent: 'space-between', gap: 8 } },
+          h('span', { role: 'status', style: { ...mutedTextStyle, flex: '1 1 260px', minWidth: 0 } }, loading ? '正在读取机器人与任务状态…'
             : botLoadError ? '暂时无法读取机器人状态。请刷新后再试。'
               : connectedBots.length === 0 ? '尚未发现已连接的机器人。请先在 DSH-IM 中连接飞书机器人。'
                 : selectedBot && !botConnected ? `“${selectedBot.name}”当前离线；请先在 DSH-IM 恢复连接。`
@@ -965,6 +973,10 @@ window.__ModuleLoader__.load({
                       : !dmChatEnabled ? `“${selectedBot.name}”已启用协作；私聊已关闭，群聊仍按各自设置工作。`
                         : selectedTaskCount === 0 ? `“${selectedBot.name}”已启用协作；下一步开放一项能力。你也可以先私聊自测普通聊天。`
                           : `“${selectedBot.name}”已启用协作 · ${selectedTaskCount} 项能力已开放。可以私聊自测。`),
+          h('button', { type: 'button', disabled: loading || busy,
+            onClick: () => void load().catch((error) => setMessage(error.message)),
+            style: { ...secondaryButtonStyle, whiteSpace: 'nowrap' } },
+          loading ? '正在刷新…' : '刷新状态')),
           bots.length ? h('label', null, '我的机器人', h('select', { id: 'ant-bot-selector', value: botId,
             onChange: (event) => { setBotId(event.target.value); setGroupId(''); setChatGroupId(''); setBindingCode('');
               setTrustedOrigin(enrolled.find((bot) => bot.bot_id === event.target.value)?.gitea_origin || '') }, style: inputStyle },
@@ -991,13 +1003,29 @@ window.__ModuleLoader__.load({
               h('button', { type: 'button', disabled: busy || !trustedOrigin.trim() || (!selectedEnrollmentBound && !botConnected),
                 onClick: () => void (selectedEnrollmentBound ? saveTrustedOrigin() : enrollBot()), style: secondaryButtonStyle },
                 selectedEnrollmentBound ? '保存可信地址' : botConnected ? '绑定机器人并保存地址' : '先连接机器人'))) : null,
+          selectedBot && selectedEnrollmentBound ? h('div', { role: 'region', 'aria-label': '群任务所有者身份验证',
+            style: { display: 'grid', gap: 8, padding: 10, border: '1px solid var(--dsw-alias-border-l2)', borderRadius: 8,
+              backgroundColor: 'var(--dsw-alias-bg-layer-1)' } },
+          h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', gap: 8 } },
+            h('strong', null, '群任务所有者身份'),
+            h('span', { role: 'status', style: { ...mutedTextStyle, color: selectedEnrollment.owner_bound
+              ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-state-warning-primary, var(--dsw-alias-label-secondary))' } },
+            selectedEnrollment.owner_bound ? '已绑定' : '尚未绑定')),
+          h('p', { style: mutedTextStyle }, '绑定只针对当前机器人，所有群共用。只有允许群成员请求已开放能力时才需要；普通群聊无需绑定。绑定后，群任务仍需你在目标群按机器人提示确认。'),
+          h('div', { style: { display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' } },
+            h('button', { type: 'button', disabled: busy || !botConnected || enrollmentLoadError,
+              onClick: () => void issueBindingCode(), style: secondaryButtonStyle },
+              selectedEnrollment.owner_bound ? '重新获取绑定码' : '获取绑定码'),
+            bindingCode ? h('span', { role: 'status', style: mutedTextStyle },
+              `请你本人私聊“${selectedBot.name}”发送“绑定身份 ${bindingCode}”。绑定码 5 分钟有效。`) : null)) : null,
           setupStepper,
           chatScopePanel,
           selectedEnrollmentBound && botConnected ? h('p', { style: mutedTextStyle },
             dmChatEnabled
               ? `自测：私聊“${selectedBot.name}”发送“你能做什么”；发起任务后可问“刚才的任务怎么样了”。群聊请先在目标群 @机器人，再开放能力时选择该群。`
               : '私聊当前已关闭；如要恢复，请在上方开启。群聊请先在目标群 @机器人，再开放能力时选择该群。') : null,
-          selectedEnrollmentBound && botConnected ? h('div', { style: { display: 'grid', gap: 8 } },
+          selectedEnrollmentBound && botConnected ? h('div', { role: 'region', 'aria-label': '群聊白名单',
+            style: { display: 'grid', gap: 8 } },
             h('strong', null, '群聊白名单'),
             h('span', { role: 'status', style: mutedTextStyle }, groupChatLoadFailed
               ? '群聊列表与当前权限暂时无法读取，请刷新后再更改；仍可填写群 ID。'
@@ -1020,28 +1048,16 @@ window.__ModuleLoader__.load({
                 onChange: (event) => setChatGroupId(event.target.value.trim()),
                 placeholder: '输入群 ID', style: inputStyle })),
             selectedChatGroup?.chat_enabled && selectedGroupHasTasks ? h('span', { style: mutedTextStyle },
-              '本群还有开放能力；关闭普通聊天前请先停止这些能力。') : null,
-            h('div', { style: { display: 'flex', gap: 8, alignItems: 'center', flexWrap: 'wrap', paddingTop: 4,
-              borderTop: '1px solid var(--dsw-alias-border-l2)' } },
-              h('span', { style: mutedTextStyle }, '群内所有者身份'),
-              h('span', { style: { ...mutedTextStyle, color: selectedEnrollment.owner_bound
-                ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-state-warning-primary, var(--dsw-alias-label-secondary))' } },
-              selectedEnrollment.owner_bound ? '已绑定' : '尚未绑定'),
-              h('button', { type: 'button', disabled: busy || !chatGroupId.trim(),
-                onClick: () => void issueBindingCode(), style: secondaryButtonStyle },
-                selectedEnrollment.owner_bound ? '重新获取绑定码' : '获取绑定码')),
-            h('span', { style: mutedTextStyle }, '仅当允许群成员发起受限能力时需要；验证后由机器人所有者在群内确认。'),
-            bindingCode ? h('p', { role: 'status', style: mutedTextStyle },
-              `请你本人私聊机器人发送“绑定身份 ${bindingCode}”，再回到群里 @机器人完成确认。`) : null) : null,
-          h('div', { style: { display: 'flex', gap: 8, flexWrap: 'wrap' } },
-            h('button', { type: 'button', onClick: () => { setCreateOpen(true); onSelectTab('capability') },
-              style: primaryButtonStyle }, '开放新能力'),
-            h('button', { type: 'button', onClick: () => { preparePrExample(); onSelectTab('capability') }, style: secondaryButtonStyle }, '使用 PR 差异审查示例'),
-            h('button', { type: 'button', onClick: () => void load().catch((error) => setMessage(error.message)),
-              style: secondaryButtonStyle }, '刷新状态'))),
+              '本群还有开放能力；关闭普通聊天前请先停止这些能力。') : null) : null),
         h('div', { id: 'ant-capability-list', role: 'region', 'aria-label': '已开放能力列表', tabIndex: -1,
           style: { display: activeTab === 'capability' ? 'grid' : 'none', gap: 12 } },
-        h('h4', { style: sectionTitleStyle }, `我开放的能力 · ${authorizationLoadError ? '暂未读取' : activeCards.length}`),
+        h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', gap: 10, flexWrap: 'wrap' } },
+          h('h4', { style: sectionTitleStyle }, `我开放的能力 · ${authorizationLoadError ? '暂未读取' : activeCards.length}`),
+          h('div', { role: 'toolbar', 'aria-label': '能力授权操作', style: { display: 'flex', gap: 8, flexWrap: 'wrap' } },
+            h('button', { type: 'button', onClick: () => { setCreateOpen(true); onSelectTab('capability') },
+              style: primaryButtonStyle }, '开放新能力'),
+            h('button', { type: 'button', onClick: () => { preparePrExample(); onSelectTab('capability') },
+              style: secondaryButtonStyle }, '使用 PR 差异审查示例'))),
         h('p', { style: mutedTextStyle }, '当前一项能力只能绑定一个范围：私聊，或某一个群。若要给其他群或私聊开放相同任务，目前需分别建立能力卡；它们的请求人和有效期独立。'),
         ...activeCards.map((card) => {
           const expiresAt = Number(card.expires_at) * 1000
@@ -1257,18 +1273,21 @@ window.__ModuleLoader__.load({
           h('button', { type: 'button', onClick: () => void load().catch((error) => setMessage(error.message)), style: secondaryButtonStyle }, '刷新')),
         loadFailures.includes('local-settings') ? h('p', { role: 'status', style: mutedTextStyle },
           '本机处理设置暂未读取；请刷新后重试。')
-          : h('form', { onSubmit: saveLocalProcessingSettings, style: { display: 'flex', gap: 8, flexWrap: 'wrap', alignItems: 'end' } },
-          h('label', null, '这台电脑最多同时处理',
+          : h('form', { onSubmit: saveLocalProcessingSettings, style: { display: 'flex', gap: 12, flexWrap: 'wrap', alignItems: 'end' } },
+          h('label', { style: { display: 'grid', gap: 5, flex: '0 1 280px', maxWidth: '100%' } }, '这台电脑最多同时处理',
             h('select', { value: localConcurrency == null ? '' : String(localConcurrency),
-              onChange: (event) => setLocalConcurrency(event.target.value), style: inputStyle },
+              onChange: (event) => setLocalConcurrency(event.target.value), style: { ...inputStyle, width: '100%' } },
             h('option', { value: '' }, '跟随团队默认'),
             ...Array.from({ length: 8 }, (_, index) => h('option', { key: index + 1, value: index + 1 }, `${index + 1} 项任务`)))),
-          h('label', null, '这台电脑 PR 仓库缓存上限（GiB）',
-            h('input', { type: 'number', min: 1, max: 100, step: 1, required: true,
+          h('label', { style: { display: 'grid', gap: 5, flex: '0 1 200px', maxWidth: '100%' } },
+            '这台电脑 PR 仓库缓存上限（GiB）',
+            h('input', { 'aria-label': '这台电脑 PR 仓库缓存上限（GiB）', type: 'number', min: 1, max: 100, step: 1, required: true,
               value: repositoryCacheLimitGib,
-              onChange: (event) => setRepositoryCacheLimitGib(event.target.value), style: inputStyle }),
-            h('span', { style: mutedTextStyle }, '默认 10 GiB，范围 1–100 GiB，按长期仓库文件逻辑大小计算（不含临时工作区和文件系统分配开销）。日常不会淘汰仍启用能力的缓存；停用或到期能力会在刷新时回收。单次拉取若实际越界，为恢复预算会清理这项能力的仓库缓存（旧 PR 可重新下载）。')),
-          h('button', { disabled: busy, style: secondaryButtonStyle }, '保存本机处理设置')),
+              onChange: (event) => setRepositoryCacheLimitGib(event.target.value),
+              style: { ...inputStyle, width: 128, maxWidth: '100%', boxSizing: 'border-box' } })),
+          h('button', { disabled: busy, style: secondaryButtonStyle }, '保存本机处理设置'),
+          h('p', { style: { ...mutedTextStyle, flex: '1 1 100%', margin: 0 } },
+            '默认 10 GiB，范围 1–100 GiB，按长期仓库文件逻辑大小计算（不含临时工作区和文件系统分配开销）。日常不会淘汰仍启用能力的缓存；停用或到期能力会在刷新时回收。单次拉取若实际越界，为恢复预算会清理这项能力的仓库缓存（旧 PR 可重新下载）。')),
         h('p', { style: mutedTextStyle }, `本机检测到的执行方：${executors.map((item) => `${item.title}${item.available ? '（可用）' : `（${item.reason || '未启用或未找到'}）`}`).join('、') || '暂未读取到'}。只有能力配置下拉框中列出的执行方能接收委托。`))))
     }
 
@@ -1583,15 +1602,21 @@ window.__ModuleLoader__.load({
       useEffect(() => { void refresh() }, [refreshToken])
       const install = async (plugin) => {
         const artifactUrl = approvedPluginArtifactUrl(plugin)
-        if (!artifactUrl || workingId || uncertainId === plugin.id || completedId === plugin.id) return
+        const installSpec = pluginInstallSpec(plugin)
+        if (!installSpec || workingId || uncertainId === plugin.id || completedId === plugin.id) return
         const manager = remote?.pluginManager
         if (typeof manager?.installBundle !== 'function') {
           setMessage('当前 DSH 未提供插件安装接口，请联系管理员。')
           return
         }
         const local = bundles.find((bundle) => bundle.name === plugin.package_name && bundle.installed)
-        const action = local ? local.version === plugin.version ? '重新安装' : '更新' : '安装'
-        if (!window.confirm(`在这台 DSH ${action}团队审核的 ${plugin.title} ${plugin.version}？插件将在本机运行，完成后需要完全重启 DSH。`)) return
+        const localAhead = local?.version && newerVersion(local.version, plugin.version)
+        const action = localAhead ? '回退到团队版本' : local ? local.version === plugin.version ? '重新安装' : '更新' : '安装'
+        const sourceNotice = artifactUrl
+          ? 'DSH 将安装 ANT 固定的顶层制品。'
+          : `DSH 将优先从 npm 官方源以 ${installSpec} 安装此精确版本，并按其配置回退 registry；依赖版本可能因设备不同。`
+        const updateNotice = 'ANT 不会批准依赖构建脚本；插件自身的更新器或 DSH 原生管理页之后仍可安装其他版本。'
+        if (!window.confirm(`在这台 DSH ${action}团队审核的 ${plugin.title} ${plugin.version}？${sourceNotice}${updateNotice} 插件将在本机运行，完成后需要完全重启 DSH。`)) return
         setWorkingId(plugin.id)
         setMessage(`正在安装 ${plugin.title}，请不要退出 DSH…`)
         try {
@@ -1600,13 +1625,15 @@ window.__ModuleLoader__.load({
           const latest = Array.isArray(catalog?.plugins)
             ? catalog.plugins.find((item) => item.id === plugin.id) : null
           if (!response.ok || latest?.package_name !== plugin.package_name
-            || latest?.version !== plugin.version || latest?.artifact_sha256 !== plugin.artifact_sha256
-            || approvedPluginArtifactUrl(latest) !== artifactUrl) {
+            || latest?.version !== plugin.version || pluginInstallSpec(latest) !== installSpec) {
             throw new Error('插件审核信息已变化，请刷新目录后重试。')
           }
           const requestId = crypto.randomUUID()
           let result
-          try { result = await manager.installBundle(artifactUrl, { enabled: true, requestId }) }
+          const options = artifactUrl
+            ? { enabled: true, requestId }
+            : { enabled: true, requestId, registry: 'https://registry.npmjs.org/' }
+          try { result = await manager.installBundle(installSpec, options) }
           catch { result = null }
           if (!result?.ok) {
             let recovered = null
@@ -1658,7 +1685,9 @@ window.__ModuleLoader__.load({
             return
           }
           await refresh()
-          try { localStorage.setItem(`${PLUGIN_INSTALL_RECORD_PREFIX}${plugin.id}`, plugin.artifact_sha256) } catch {}
+          if (artifactUrl && plugin.artifact_sha256) {
+            try { localStorage.setItem(`${PLUGIN_INSTALL_RECORD_PREFIX}${plugin.id}`, plugin.artifact_sha256) } catch {}
+          }
           setCompletedId(plugin.id)
           setMessage(`${plugin.title} 已安装。请完全退出并重新启动 DSH 后使用。`)
         } catch (error) {
@@ -1669,10 +1698,12 @@ window.__ModuleLoader__.load({
       const visible = plugins.filter((plugin) => {
         const installed = bundles.find((bundle) => bundle.name === plugin.package_name && bundle.installed)
         const artifactUrl = approvedPluginArtifactUrl(plugin)
+        const installSpec = pluginInstallSpec(plugin)
+        const localAhead = installed?.version && newerVersion(installed.version, plugin.version)
         const matches = !query.trim() || `${plugin.title} ${plugin.description} ${plugin.package_name}`.toLowerCase().includes(query.trim().toLowerCase())
         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 === 'available' && installSpec && !localAhead && (!installed || (installed.version && installed.version !== plugin.version))
+          || activeFilter === 'updates' && installSpec && installed && installed.version && installed.version !== plugin.version && !localAhead
           || activeFilter === 'retired' && plugin.status !== 'published')
       })
       const noMatches = embedded
@@ -1694,7 +1725,7 @@ window.__ModuleLoader__.load({
         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('p', { style: { ...mutedTextStyle, marginTop: 6 } }, '这里展示团队审核过的插件版本及本机状态。DSH 0.2.0-rc.2 不会自动更新 Bundle；插件自身的更新器可能绕过此目录安装其他版本。')),
           h('button', { type: 'button', disabled: loading, onClick: () => void refresh(), style: secondaryButtonStyle }, loading ? '读取中…' : '刷新目录')),
         !loading && !plugins.length && !loadError ? embedded
           ? h('p', { role: 'status', style: mutedTextStyle }, '团队暂未发布精选插件。')
@@ -1716,16 +1747,19 @@ window.__ModuleLoader__.load({
             const sameVersion = local?.version === plugin.version
             const security = plugin.status === 'security_withdrawn'
             const artifactUrl = approvedPluginArtifactUrl(plugin)
+            const installSpec = pluginInstallSpec(plugin)
+            const localAhead = local?.version && newerVersion(local.version, plugin.version)
             const sourceKnown = typeof local?.source === 'string'
             const verifiedLocal = sameVersion && artifactUrl && sourceKnown && local.source === artifactUrl
             const recordedInstall = sameVersion && !sourceKnown && previouslyInstalledReviewedPlugin(plugin)
             const status = security ? '已废弃（安全风险）'
-              : plugin.status === 'deprecated' ? '已废弃' : local?.error ? '加载异常' : sameVersion
+              : plugin.status === 'deprecated' ? '已废弃' : local?.error ? '加载异常' : localAhead
+                ? '本机版本高于团队目录版本' : sameVersion
                 ? verifiedLocal ? local.enabled ? '本机已装（团队来源，已启用）' : '本机已装（团队来源，未启用）'
                   : sourceKnown ? '本机同版，来源不同' : recordedInstall
                     ? '本机同版，曾由企业扩展安装；当前 DSH 无法复核来源' : '本机同版，当前 DSH 无法核对来源'
-                : artifactUrl ? local ? local.version ? `可更新 · 本机 ${local.version}` : '本机版本暂无法读取' : '可安装'
-                  : local ? `本机版本 ${local.version || '暂无法读取'}` : '已审核，暂需管理员安装'
+                : installSpec ? local ? local.version ? `可更新 · 本机 ${local.version}` : '本机版本暂无法读取' : artifactUrl ? '可安装' : '可从 npm 安装'
+                  : local ? `本机版本 ${local.version || '暂无法读取'}` : '已发布版本暂不可安装'
             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 } },
@@ -1738,6 +1772,10 @@ window.__ModuleLoader__.load({
               h('p', { style: mutedTextStyle }, `${plugin.package_name}@${plugin.version} · 许可证：${plugin.license || '未声明'}`),
               h('p', { style: mutedTextStyle }, `来源：${plugin.source_url || '未提供'} · DSH 版本要求：${plugin.peer_range || '包未声明'}`),
               h('p', { style: mutedTextStyle }, `额外配置：${plugin.requirements || '无'}`),
+              installSpec && !artifactUrl ? h('p', { role: 'note', style: mutedTextStyle },
+                'ANT 通过 DSH 包管理器安装目录中的精确 npm 版本；实际下载和依赖解析由 DSH 执行。ANT 不批准依赖构建脚本；若 DSH 因此拒绝安装，请按 DSH 提示在原生插件管理页处理。插件自身更新器或 DSH 原生管理也可更新到目录外的版本。') : null,
+              plugin.dependencies && artifactUrl ? h('p', { role: 'note', style: mutedTextStyle },
+                '此插件声明了依赖。ANT 固定插件包本身；DSH 会在本机按当前配置解析依赖，不同设备可能得到不同版本。依赖构建脚本由 DSH 单独请求批准。') : null,
               plugin.scripts ? h('p', { style: mutedTextStyle }, `包自身的安装脚本：${plugin.scripts}`) : null,
               plugin.status !== 'published' ? h('p', { role: 'status', style: security
                 ? { ...mutedTextStyle, color: 'var(--dsw-alias-label-danger, #d44)' } : mutedTextStyle },
@@ -1747,16 +1785,17 @@ window.__ModuleLoader__.load({
                 ? '此前曾由企业扩展安装；当前 DSH 无法再次核对来源。正常使用无需重复安装；若后来换过来源，可以重新安装。'
                 : '已装同版且使用正常时无需重复安装；若想改用团队审核包，可自愿安装。') : null,
               h('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 8 } },
-                artifactUrl && (!local || (local.version && !verifiedLocal))
+                installSpec && (!local || (local.version && local.version !== plugin.version && (!localAhead || artifactUrl))
+                  || (artifactUrl && sameVersion && !verifiedLocal))
                   ? h('button', { type: 'button', disabled: Boolean(workingId) || uncertainId === plugin.id || completedId === plugin.id,
                     onClick: () => void install(plugin), style: primaryButtonStyle },
                   workingId === plugin.id ? '安装中…' : uncertainId === plugin.id ? '先核对安装结果'
                     : completedId === plugin.id ? '重启 DSH 后生效'
-                    : local ? sameVersion ? '按团队审核包重新安装' : '更新到审核版本' : '安装到这台 DSH') : null,
-                plugin.status === 'published' && !local && !artifactUrl
+                    : local ? sameVersion || localAhead ? '按团队审核包重新安装' : '更新到审核版本' : '安装到这台 DSH') : null,
+                plugin.status === 'published' && !local && !installSpec
                   ? h('p', { style: mutedTextStyle }, '如需安装，请联系企业管理员安排。') : null,
                 local || uncertainId === plugin.id ? h('button', { type: 'button', onClick: () => openBundle(plugin.package_name), style: secondaryButtonStyle }, '打开 DSH 插件管理') : null,
-                local && !sameVersion && plugin.status === 'published' && !artifactUrl
+                local && !sameVersion && plugin.status === 'published' && !installSpec
                   ? h('p', { style: mutedTextStyle }, '本机版本与团队审核版本不同；请联系企业管理员核对。') : null))
           })) : !loading && plugins.length && (!embedded || !hasSkillMatches)
           ? h('p', { style: mutedTextStyle }, noMatches) : null))

package/package.json

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