@ai-wendao/ant 0.5.0 → 0.5.2

package/README.md

@@ -8,6 +8,12 @@ ANT (AI-native Teams) connects a DeepSeek Harness Desktop profile to its team's
 
 每个 OpenAI 兼容模型可配置 Chat Completions 或 Responses API。旧模型记录在升级后按 Chat Completions 解释；ANT 服务端继续使用原配置的 `/chat/completions` URL，并从相同 API 根路径派生 `/responses` 上游路径。
 
+## 企业品牌
+
+团队管理员可在 ANT 管理台的“企业品牌”页设置 DSH 侧栏 Logo、品牌名称、品牌徽标和新会话标题。Logo 接受 PNG、JPEG 或 WebP，最大 350 KB；图片和文字保存在当前团队的 ANT 服务端。成员 Bundle 启动时立即同步，DSH 保持打开时每 5 分钟通过 ETag 检查版本；网络暂时不可用时继续使用本机最近一次成功配置，不阻止 DSH 启动。
+
+Logo 与侧栏品牌使用 DSH 正式 UI 插槽。新会话标题目前没有官方文本插槽，Bundle 只在页面中精确匹配 DSH 当前标题原文后替换；上游更改该文案时可能需要更新 ANT Bundle。此项不影响会话和工具功能，也不控制 DSH 原生欢迎/登录窗口、菜单或应用图标。
+
 飞书和企业微信的机器人连接、消息收发由 DSH-IM 负责；ANT Bundle 不保存机器人密钥或直连 IM 平台。ANT 继续负责团队成员身份和模型授权，并可在成员显式开启时接管一个专用飞书机器人的文本收件，按成员授权范围处理协作请求。
 
 ## 协作机器人与任务卡

package/client.js

@@ -12,6 +12,8 @@ window.__ModuleLoader__.load({
       return value.replace(suffix, '').trim() || 'OpenAI'
     }
     const SERVICE_URL_STORAGE_KEY = 'ant-team-service-url'
+    const BRANDING_CACHE_PREFIX = 'ant-team-branding:'
+    const BRANDING_SYNC_PATH = '/api/ant-teams/branding'
     const PROVIDER_ROUTES_STORAGE_KEY = 'ant-team-provider-routes'
     const PROVIDER_SYNC_EXCLUSIONS_KEY = 'ant-team-provider-sync-exclusions'
     const DEVICE_ID_STORAGE_KEY = 'ant-team-device-id'
@@ -3065,7 +3067,197 @@ window.__ModuleLoader__.load({
           includePlugins: tab === 'all', ...navigation })
     }
 
+    function brandingCacheKey() {
+      const serviceUrl = loadServiceUrl()
+      return serviceUrl ? `${BRANDING_CACHE_PREFIX}${serviceUrl}` : null
+    }
+
+    function readBrandingCache() {
+      const key = brandingCacheKey()
+      if (!key) return null
+      try {
+        const value = JSON.parse(localStorage.getItem(key) || 'null')
+        if (!value || !Number.isSafeInteger(value.revision) || value.revision < 0) return null
+        return value
+      } catch { return null }
+    }
+
+    function normalizeBranding(value) {
+      if (!value || !Number.isSafeInteger(value.revision) || value.revision < 0) return null
+      const fields = ['wordmark', 'badge', 'headline']
+      if (fields.some((field) => value[field] != null && typeof value[field] !== 'string')) return null
+      if (value.logo_data_url != null && (typeof value.logo_data_url !== 'string'
+        || !/^data:image\/(?:png|jpeg|webp);base64,[A-Za-z0-9+/]+=*$/u.test(value.logo_data_url)
+        || value.logo_data_url.length > 512 * 1024)) return null
+      return { revision: value.revision, logo_data_url: value.logo_data_url || null,
+        wordmark: value.wordmark || null, badge: value.badge || null, headline: value.headline || null }
+    }
+
+    function installEnterpriseBranding(ctx) {
+      const slotDisposers = new Map()
+      const slotValues = new Map()
+      const originalHeadlines = new Map()
+      let headlineObserver = null
+      let applied = null
+      let timer = null
+      let retryTimer = null
+      let disposed = false
+      const isHeroHeadlineNode = (node) => {
+        let container = node?.parentElement
+        const compact = (value) => value?.replace(/\s+/gu, '') || ''
+        const aliases = [node?.textContent?.trim(), originalHeadlines.get(node)?.original,
+          originalHeadlines.get(node)?.current, '探索未至之境', 'Into the Unknown'].filter(Boolean).map(compact)
+        for (let depth = 0; container && depth < 6; depth += 1, container = container.parentElement) {
+          if (!container.querySelector) continue
+          const badges = [...container.querySelectorAll('span, small, label')]
+            .filter((element) => ['预览版', 'Preview'].includes(element.textContent?.trim()))
+          const marks = container.querySelectorAll('svg, img')
+          const wholeRow = compact(container.textContent)
+          if (badges.length === 1 && marks.length === 1
+            && aliases.some((title) => ['预览版', 'Preview'].some((badge) =>
+              wholeRow === `${title}${compact(badge)}` || wholeRow === `${compact(badge)}${title}`))) return true
+        }
+        return false
+      }
+      const replaceSlot = (name, value, component) => {
+        if (slotValues.get(name) === value) return
+        slotDisposers.get(name)?.()
+        slotDisposers.delete(name); slotValues.delete(name)
+        if (!value) return
+        const dispose = ctx.slots.inject(name, () => ctx.slots.register({ name, priority: -1 }, component))
+        slotDisposers.set(name, dispose); slotValues.set(name, value)
+      }
+      const replaceHeadlineNode = (node) => {
+        if (node?.nodeType !== Node.TEXT_NODE) return
+        const text = node.textContent?.trim()
+        const prior = originalHeadlines.get(node)
+        const matchesHeadline = text === '探索未至之境' || text === 'Into the Unknown'
+          || text === prior?.original || text === prior?.current
+        if (applied?.headline && text !== applied.headline && matchesHeadline && isHeroHeadlineNode(node)) {
+          originalHeadlines.set(node, { original: prior?.original || text, current: applied.headline })
+          node.textContent = applied.headline
+        } else if (!applied?.headline && prior && text === prior.current) {
+          node.textContent = prior.original
+          originalHeadlines.delete(node)
+        }
+      }
+      const replaceHeadlineSubtree = (root) => {
+        if (!root) return
+        if (root.nodeType === Node.TEXT_NODE) { replaceHeadlineNode(root); return }
+        const walker = document.createTreeWalker(root, NodeFilter.SHOW_TEXT)
+        let node
+        while ((node = walker.nextNode())) replaceHeadlineNode(node)
+      }
+      const updateHeadline = (records = null) => {
+        if (typeof document === 'undefined' || !document.body) return
+        if (!applied?.headline) {
+          for (const [node, prior] of originalHeadlines) {
+            if (node.textContent?.trim() === prior.current) {
+              node.textContent = prior.original
+              originalHeadlines.delete(node)
+            }
+          }
+          return
+        }
+        if (!records) { replaceHeadlineSubtree(document.body); return }
+        for (const record of records) {
+          if (record.type === 'characterData') replaceHeadlineNode(record.target)
+          else for (const node of record.addedNodes) replaceHeadlineSubtree(node)
+        }
+        for (const node of originalHeadlines.keys()) if (!node.isConnected) originalHeadlines.delete(node)
+      }
+      const apply = (value) => {
+        const branding = normalizeBranding(value)
+        applied = branding ? { ...branding } : null
+        const logo = branding?.logo_data_url || null
+        const nameValue = branding && (branding.wordmark || branding.badge)
+          ? `${branding.wordmark || ''}\u0000${branding.badge || ''}` : null
+        const mark = ({ size = 24, className }) => logo
+          ? h('img', { src: logo, alt: '', className, draggable: false,
+            style: { display: 'block', width: size, height: size, objectFit: 'contain' } }) : null
+        const brandName = () => h('div', { style: { display: 'flex', alignItems: 'center', gap: 6, whiteSpace: 'nowrap' } },
+          h('span', { style: { color: 'var(--dsw-alias-brand-primary)', fontWeight: 650 } }, branding?.wordmark || 'DEEPSEEK'),
+          h('span', { style: { padding: '2px 5px', borderRadius: 4, color: 'var(--dsw-alias-label-primary-inverted)',
+            background: 'var(--dsw-alias-brand-primary)', fontSize: 10, fontWeight: 650, letterSpacing: '.04em' } }, branding?.badge || 'HARNESS'))
+        replaceSlot('sidebar.brand.mark', logo, mark)
+        replaceSlot('conversation.hero.brand.mark', logo, mark)
+        replaceSlot('sidebar.brand.name', nameValue, brandName)
+        if (branding?.headline && !headlineObserver && typeof document !== 'undefined' && document.body) {
+          headlineObserver = new MutationObserver(updateHeadline)
+          headlineObserver.observe(document.body, { childList: true, subtree: true, characterData: true })
+        }
+        updateHeadline()
+      }
+
+      const cleanup = () => {
+        if (disposed) return
+        disposed = true
+        if (timer !== null) clearInterval(timer)
+        if (retryTimer !== null) clearTimeout(retryTimer)
+        headlineObserver?.disconnect()
+        for (const [node, prior] of originalHeadlines) {
+          if (node.textContent?.trim() === prior.current) node.textContent = prior.original
+        }
+        for (const dispose of slotDisposers.values()) dispose?.()
+      }
+
+      try {
+        apply(readBrandingCache())
+      } catch (error) {
+        cleanup()
+        console.warn('ANT branding setup failed; continuing with the default DSH branding.', error)
+        return cleanup
+      }
+
+      let etag = applied?.revision ? `"${applied.revision}"` : null
+      let retryCount = 0
+      const refresh = async () => {
+        if (disposed) return
+        let retryable = true
+        try {
+          if (!loadServiceUrl()) {
+            const originResponse = await fetch('/api/ant-teams/connection-origin', { cache: 'no-store' })
+            if (disposed) return
+            if (!originResponse.ok) return
+            const originInfo = await readLocalJsonResponse(originResponse)
+            if (disposed) return
+            const origin = normalizeServiceUrl(originInfo?.service_url || '')
+            if (!origin) return
+            try { localStorage.setItem(SERVICE_URL_STORAGE_KEY, origin) } catch {}
+          }
+          const response = await fetch(BRANDING_SYNC_PATH, { cache: 'no-store',
+            headers: etag ? { 'if-none-match': etag } : {} })
+          if (disposed) return
+          if (response.status === 304) { retryCount = 0; return }
+          if (!response.ok) {
+            retryable = [404, 426, 502, 503].includes(response.status)
+            throw new Error('branding sync unavailable')
+          }
+          const branding = normalizeBranding(await readLocalJsonResponse(response))
+          if (disposed || !branding) return
+          etag = response.headers.get('etag') || `"${branding.revision}"`
+          const key = brandingCacheKey()
+          if (key) {
+            try { localStorage.setItem(key, JSON.stringify(branding)) } catch {}
+          }
+          apply(branding)
+          retryCount = 0
+        } catch {
+          if (!disposed && retryable && retryCount < 3) {
+            const delay = [3_000, 10_000, 30_000][retryCount]
+            retryCount += 1
+            clearTimeout(retryTimer)
+            retryTimer = setTimeout(() => void refresh(), delay)
+          }
+        }
+      }
+      void refresh()
+      timer = setInterval(() => void refresh(), 5 * 60 * 1000)
+      return cleanup
+    }
+
     function apply(ctx) {
+      ctx.effect(() => installEnterpriseBranding(ctx), 'ANT enterprise branding synchronization')
       const remote = {
         credentials: ctx.remote.credentials,
         settings: ctx.remote.settings,

package/index.js

@@ -10,6 +10,7 @@ import { readLocalDelegationSettings, recentDelegationStatus, startDelegationHos
 export const inject = []
 
 const MODEL_SYNC_PATH = '/api/ant-teams/models'
+const BRANDING_PATH = '/api/ant-teams/branding'
 const SERVICE_INFO_PATH = '/api/ant-teams/service-info'
 const BUNDLE_RELEASE_PATH = '/api/ant-teams/bundle-release'
 const CONNECTION_ORIGIN_PATH = '/api/ant-teams/connection-origin'
@@ -842,6 +843,38 @@ async function fetchMemberPlugins(request, credentials, settings) {
   }
 }
 
+async function fetchMemberBranding(request, credentials, settings) {
+  if (request.method !== 'GET') return jsonResponse(405, { message: '只支持 GET 请求。' })
+  try {
+    const connection = await readMemberConnection(credentials, settings)
+    if (!connection) return jsonResponse(401, { message: '请先连接 ANT 团队。' })
+    const etag = request.headers.get('if-none-match')
+    const upstream = await fetch(new URL('/api/me/branding', connection.serviceUrl), {
+      headers: { authorization: `Bearer ${connection.token}`, accept: 'application/json',
+        ...(etag ? { 'if-none-match': etag } : {}) },
+      redirect: 'manual', signal: AbortSignal.timeout(10_000),
+    })
+    if (upstream.status === 304) {
+      return new Response(null, { status: 304, headers: { etag: upstream.headers.get('etag') || etag || '' } })
+    }
+    if (!upstream.ok) return jsonResponse(upstream.status === 401 || upstream.status === 403 ? 401 : 502,
+      { message: '暂时无法读取企业品牌设置。' })
+    const text = await readLimitedBody(upstream, 600 * 1024)
+    if (text === null) return jsonResponse(502, { message: '企业品牌设置响应过大。' })
+    const branding = JSON.parse(text)
+    if (!Number.isSafeInteger(branding?.revision) || branding.revision < 0
+      || ![null, undefined].includes(branding.logo_data_url) && typeof branding.logo_data_url !== 'string'
+      || ![null, undefined].includes(branding.wordmark) && typeof branding.wordmark !== 'string'
+      || ![null, undefined].includes(branding.badge) && typeof branding.badge !== 'string'
+      || ![null, undefined].includes(branding.headline) && typeof branding.headline !== 'string') {
+      return jsonResponse(502, { message: '企业品牌设置格式无效。' })
+    }
+    return new Response(text, { status: 200,
+      headers: { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store',
+        ...(upstream.headers.get('etag') ? { etag: upstream.headers.get('etag') } : {}) } })
+  } catch { return jsonResponse(502, { message: '暂时无法读取企业品牌设置。' }) }
+}
+
 async function fetchAuthRequest(request, endpoint, credentials, settings) {
   if (request.method !== 'POST') return jsonResponse(405, { message: '只支持 POST 请求' })
   let body
@@ -941,6 +974,10 @@ export function apply(ctx) {
       requestBody: 'buffered',
       fetch: (request) => fetchMemberModels(request, connectionCtx.credentials, connectionCtx.settings),
     }), 'ant-teams: authenticated model catalog relay')
+    connectionCtx.effect(() => connectionCtx.connection.fetch.register({
+      path: BRANDING_PATH, methods: ['GET'], requestBody: 'buffered',
+      fetch: (request) => fetchMemberBranding(request, connectionCtx.credentials, connectionCtx.settings),
+    }), 'ant-teams: conditional enterprise branding relay')
     connectionCtx.effect(() => connectionCtx.connection.fetch.register({
       path: BUNDLE_RELEASE_PATH,
       methods: ['GET'],

package/package.json

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