@ai-wendao/ant 0.4.5 → 0.4.6

package/README.md

@@ -8,7 +8,7 @@ ANT (AI-native Teams) connects a DeepSeek Harness Desktop profile to its team's
 
 成员在 ANT 插件设置页选择一个 DSH-IM 飞书机器人并启用协作收件。每段私聊、群聊或话题由同一受限 DSH 会话自然回答和追问；只有 DSH 准备执行任务时，才通过 ANT 工具提交任务卡 ID 和参数，由服务端再次核对真实请求人、群、参数及授权。成员按需创建任务卡，设置意图、参数、请求人、适用会话和有效期；PR 审查只是可选示例。普通文字任务由没有本机工具权限的 DSH 会话处理。单个 Gitea PR 参数还可选择 Codex 专用只读 CLI，或 DSH 已注册的 Claude Code 子代理试用：ANT 用只读 Gitea 令牌为每项 PR 审查能力维护本机仓库缓存，并按已核验的 PR Head SHA 创建独立工作树；令牌不会交给执行器。Codex 使用固定只读权限配置，Claude Code 沿用 DSH 提供方的本机权限设置。执行器可查看完整源码和已核验 diff；工作区不含 `.git`、符号链接或子模块，也不会运行仓库脚本。Claude Code 仍是所有者手动开放的本机试用，不宣称具备操作系统级只读隔离。成员可查询或取消任务；每台电脑默认同时处理三项任务，成员可调整，旧版 PR 审查与新任务共用名额。
 
-群聊由所有者逐群启用普通聊天，任务授权再按卡单独设置。群里有人 @ 机器人后，群 ID 出现在插件列表；所有者也可手动填写群 ID。若所有者在群里，可先私聊机器人绑定飞书身份，再在群内提出“在本群启用聊天”，或按提示确认“在本群启用任务 任务名称”。群消息只在明确 @ 时处理，任务结果公开回复原群／原话题；要求私聊回复的群消息会提示请求人改为私聊发起。当前 DSH-IM 未提供可核验的机器人进／出群发起者，所以不会因被拉群自动启用。不同群、话题和私聊的上下文默认隔离；群历史按需读取，默认先看十条、最多检查一百条平台记录，实际可见范围由飞书权限决定。
+私聊默认开启，所有者可按机器人单独关闭或重新开启；关闭后新私聊消息不会进入 DSH，机器人每五分钟最多向同一请求人发送一次静态恢复指引；所有者身份绑定命令仍可用。关闭前已提交的任务不会撤销，仍回复原私聊；群聊设置不受影响。群聊由所有者逐群启用普通聊天，任务授权再按卡单独设置。群里有人 @ 机器人后，群 ID 出现在插件列表；所有者也可手动填写群 ID。若所有者在群里，可先私聊机器人绑定飞书身份，再在群内提出“在本群启用聊天”，或按提示确认“在本群启用任务 任务名称”。群消息只在明确 @ 时处理，任务结果公开回复原群／原话题；要求私聊回复的群消息会提示请求人改为私聊发起。当前 DSH-IM 未提供可核验的机器人进／出群发起者，所以不会因被拉群自动启用。不同群、话题和私聊的上下文默认隔离；每项能力当前只能关联一个范围，即私聊或一个群；要让多个群或私聊都能执行，需分别建立能力卡，并分别设定请求人和有效期。群历史按需读取，默认先看十条、最多检查一百条平台记录，实际可见范围由飞书权限决定。
 
 新建任务卡的 Codex 与 Claude Code 执行方目前只接受一个必填 Gitea PR 参数。Gitea PR 源仓库和目标仓库大小按 API KiB 换算为 bytes，并在 fetch 前与 512 MiB 单仓库快照上限及本机总缓存预算核对。每台 DSH 的长期 bare 仓库缓存默认最多 10 GiB，可在插件的“本机处理设置”调整为 1–100 GiB；按缓存文件逻辑大小计算，不含临时工作目录及文件系统分配开销。预算也为即将拉取的仓库预留空间。Git fetch 强制使用单 pack；POSIX 系统用进程文件大小限制约束 pack 与 index 的总预算，并监控缓存总量。正常情况下不会淘汰仍启用能力的缓存；若实际 fetch 越界，会清理本项能力的仓库缓存（旧 PR 可在后续任务重新下载）。Windows 暂未实现等效的原生 fetch 硬限制，Codex/Claude Code PR 快照会失败关闭，界面会禁用对应选项并提示 DSH 差异审查。停用/过期能力的缓存会在刷新时回收。任务工作树是短期目录，受单快照 512 MiB、最多 10,000 个文件、单文件最多 64 MiB 限制，不计入长期缓存预算，完成后删除。快照不支持符号链接或子模块，也不下载 Git LFS 实际文件；快照中的 LFS 指针不能代表已审查的实际文件内容。Codex/Claude Code 的 granular Gitea Token 还需 `read:repository` 和 `read:user`，后者仅用于本机获取 Git HTTPS 用户名。超限时任务失败，不降级为 diff-only。快照与权限验收范围见[Claude Code 任务卡计划](../../docs/plans/2026-10-22-claude-code-task-card.md)及[执行方隔离](../../docs/decisions/2026-10-22-im-native-executor-isolation.md)。普通对话和 DSH 文字任务不直接获得文件、命令或网络工具。机器人独占收件模式由 DSH-IM 保存；停止 ANT 授权后若需恢复 DSH-IM 原有聊天，需要在 DSH-IM 中切回普通模式。
 

package/client.js

@@ -13,7 +13,7 @@ window.__ModuleLoader__.load({
     const ANT_SETTINGS_TAB_STORAGE_KEY = 'ant-settings-tab'
     const ANT_SETTINGS_TABS = [
       ['connection', '团队连接'], ['models', '团队模型'], ['bot-chat', '机器人与聊天'],
-      ['capability', '能力授权'], ['local', '本机与任务'], ['updates', 'ANT 更新'],
+      ['capability', '能力授权'], ['local', '本机与任务'], ['updates', '关于'],
     ]
     const loadAntSettingsTab = () => {
       try {
@@ -113,6 +113,7 @@ window.__ModuleLoader__.load({
       backgroundColor: 'var(--dsw-alias-bg-module-platform)', boxSizing: 'border-box',
     }
     const mutedTextStyle = { margin: 0, color: 'var(--dsw-alias-label-secondary)', fontSize: 13, lineHeight: 1.6 }
+    const sectionTitleStyle = { margin: 0, fontSize: 16, fontWeight: 650, lineHeight: 1.4 }
     const inputStyle = {
       width: '100%', boxSizing: 'border-box', padding: '10px 12px',
       color: 'var(--dsw-alias-label-primary)', backgroundColor: 'var(--dsw-specific-input-major)',
@@ -359,7 +360,7 @@ window.__ModuleLoader__.load({
       }
       const teamServicePanel = h('section', { style: { ...panelStyle, display: activeTab === 'connection' ? 'grid' : 'none' } },
         h('div', null,
-          h('h3', { style: { margin: 0, fontSize: 16, fontWeight: 650 } }, '团队服务'),
+          h('h3', { style: sectionTitleStyle }, '团队服务'),
           h('p', { style: { ...mutedTextStyle, marginTop: 4 } }, '由团队管理员提供服务地址；管理员可在控制台管理成员、模型和协作设置。')),
         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 ? '当前连接的团队服务地址' : '服务地址'),
@@ -375,7 +376,9 @@ window.__ModuleLoader__.load({
           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))
       return h('section', { style: { display: 'grid', gap: 16, width: '100%', maxWidth: 1120 } },
-        h('p', { style: mutedTextStyle }, '连接团队服务后，即可同步获准模型并使用团队协作。'),
+        h('div', { style: { display: 'grid', gap: 4 } },
+          h('h2', { style: { margin: 0, fontSize: 20, fontWeight: 650, lineHeight: 1.35 } }, '协作机器人'),
+          h('p', { style: mutedTextStyle }, '同事可以像平常一样聊天；需要使用你电脑的能力时，ANT 才核验授权。')),
         h('div', { role: 'status', style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between',
           flexWrap: 'wrap', gap: 10, padding: '10px 12px', borderRadius: 8,
           backgroundColor: bindingReadyForSummary ? 'var(--dsw-alias-state-success-tertiary)' : 'var(--dsw-alias-bg-layer-2)' } },
@@ -386,7 +389,7 @@ window.__ModuleLoader__.load({
           backgroundColor: 'var(--dsw-alias-bg-module-platform)' } },
         pluginAlerts.length ? h('section', { role: 'alert', style: { ...panelStyle,
           borderColor: 'var(--dsw-alias-label-danger, #d44)', maxHeight: '28vh', overflowY: 'auto' } },
-          h('h3', { style: { margin: 0, fontSize: 16 } }, '已安装插件存在安全撤回公告'),
+          h('h3', { style: sectionTitleStyle }, '已安装插件存在安全撤回公告'),
           ...pluginAlerts.map((plugin) => h('p', { key: plugin.id, style: mutedTextStyle },
             `${plugin.title} ${plugin.version}${plugin.versionUnknown ? '（本机版本暂无法读取，请核对是否受影响）' : ''}：${plugin.withdrawal_reason}`)),
           ...pluginAlerts.map((plugin) => h('button', { key: `${plugin.id}-open`, type: 'button',
@@ -404,7 +407,7 @@ window.__ModuleLoader__.load({
             ? `有新版 ANT：${updateSummary.currentVersion || '当前版本未知'} → ${updateSummary.version}`
             : updateSummary.state === 'done' ? `ANT ${updateSummary.version} 已安装，需重启 DSH`
               : updateSummary.state === 'revoked' ? '当前 ANT 安装包已撤回' : 'ANT 更新需要处理'),
-          h('span', { style: mutedTextStyle }, updateSummary.message || '打开 ANT 更新查看处理方式。')),
+          h('span', { style: mutedTextStyle }, updateSummary.message || '打开“关于”查看处理方式。')),
         h('button', { type: 'button', onClick: () => selectSettingsTab('updates'), style: primaryButtonStyle },
           updateSummary.state === 'available' ? '查看并更新' : '查看处理方式')) : null,
         h('nav', { role: 'tablist', 'aria-label': 'ANT 插件设置', style: {
@@ -462,6 +465,7 @@ window.__ModuleLoader__.load({
       const [loadFailures, setLoadFailures] = useState([])
       const [createOpen, setCreateOpen] = useState(false)
       const [message, setMessage] = useState('')
+      const [draftNotice, setDraftNotice] = useState('')
       const load = async () => {
         setLoading(true)
         setMessage('')
@@ -504,8 +508,22 @@ window.__ModuleLoader__.load({
       const botConnected = Boolean(selectedBot?.available && selectedBot?.connected)
       const selectedEnrollment = enrolled.find((bot) => bot.bot_fingerprint === selectedBot?.fingerprint)
       const selectedEnrollmentBound = selectedEnrollment?.device_bound_to_current === true
+      const dmChatSettingAvailable = typeof selectedEnrollment?.dm_chat_enabled === 'boolean'
+      const dmChatEnabled = selectedEnrollment?.dm_chat_enabled !== false
+      const dmChatStatus = !selectedBot ? '先选择机器人'
+        : loadFailures.includes('enrolled-bots') ? '暂时无法读取'
+          : !selectedEnrollmentBound ? '先绑定本机'
+            : !dmChatSettingAvailable ? '需升级服务端' : dmChatEnabled ? '已开启' : '已关闭'
+      const dmChatDescription = !selectedBot ? '选择机器人后查看或修改私聊设置。'
+        : loadFailures.includes('enrolled-bots') ? '暂时无法读取私聊设置，请刷新状态后再试。'
+          : !selectedEnrollmentBound ? '请先把机器人绑定到这台 DSH，再修改私聊设置。'
+            : !dmChatSettingAvailable ? '当前团队服务端尚未提供私聊开关，请先升级服务端。'
+              : dmChatEnabled
+                ? '允许此机器人接收私聊；任务仍按能力授权执行。'
+                : '新私聊消息不会交给 DSH；所有者身份绑定仍可用，已提交任务仍会在原私聊回复。已开放能力不撤销，重新开启后未过期能力恢复触发。'
       const availableGroups = groups.filter((group) => group.bot_fingerprint === selectedBot?.fingerprint)
       const selectedChatGroup = availableGroups.find((group) => group.group_id === chatGroupId)
+      const groupChatLoadFailed = loadFailures.includes('groups')
       const activeCards = cards.filter((card) => !card.revoked_at && card.expires_at * 1000 > Date.now())
       const selectedGroupHasTasks = Boolean(selectedBot && chatGroupId && (
         activeCards.some((card) => card.bot_fingerprint === selectedBot.fingerprint
@@ -524,6 +542,10 @@ window.__ModuleLoader__.load({
         ? `仅指定成员：${senderIds.trim() || '尚未填写成员 ID'}`
         : conversationKind === 'group' ? `群 ${groupId || '尚未选择'} 的所有成员` : '任何能私聊此机器人的人'
       const resultRouteSummary = conversationKind === 'group' ? '回复到原群（群内可见）' : '回复到发起任务的私聊'
+      const executorSummary = runner === 'codex' ? '本机 Codex · PR 快照'
+        : runner === 'claude-code' ? '本机 Claude Code · PR 快照' : 'DSH · 当前授权模型'
+      const resourceSummary = selectedRunnerNeedsPr ? '指定仓库的已核验 PR 快照'
+        : '当前会话中 DSH 实际可见的内容'
       const cardBlockReason = enrollmentLoadError ? '暂时无法核对机器人是否已启用协作，请刷新状态后再试。'
         : !botConnected || !selectedEnrollmentBound ? '先在上方把机器人绑定到这台 DSH。'
         : conversationKind === 'group' && loadFailures.includes('groups') ? '暂时无法核对目标群，请刷新状态后再试。'
@@ -589,7 +611,7 @@ window.__ModuleLoader__.load({
           if (!response.ok) throw new Error(result.message || '协作机器人启用失败。')
           await load()
           if (origin) setTrustedOrigin(origin)
-          setMessage('协作机器人已启用。你可以开放能力；私聊时也能正常聊天。')
+          setMessage('协作机器人已启用。你可以分别设置私聊和群聊，再开放需要的能力。')
         } catch (error) { setMessage(error.message) }
         finally { setBusy(false) }
       }
@@ -626,9 +648,8 @@ window.__ModuleLoader__.load({
         } catch (error) { setMessage(error.message) }
         finally { setBusy(false) }
       }
-      const saveGroupChat = async () => {
+      const saveGroupChat = async (enabled) => {
         if (!selectedBot || !selectedEnrollmentBound || !chatGroupId.trim()) return
-        const enabled = !selectedChatGroup?.chat_enabled
         if (!enabled && selectedGroupHasTasks) {
           setMessage('这个群还有开放能力。请先停止这些能力，再关闭群聊。')
           return
@@ -654,6 +675,27 @@ window.__ModuleLoader__.load({
         } catch (error) { setMessage(error.message) }
         finally { setBusy(false) }
       }
+      const saveDmChat = async (enabled) => {
+        if (!selectedBot || !selectedEnrollmentBound || !dmChatSettingAvailable) return
+        if (!window.confirm(enabled
+          ? '开启后，此机器人会在私聊中正常对话；私聊任务仍逐项按能力授权核验。'
+          : '关闭后，新私聊消息不会进入 DSH，包括普通聊天、任务请求和状态查询；所有者身份绑定命令仍可用。关闭前已提交的任务不会被撤销，仍按原私聊回复。已开放的私聊能力不会删除；重新开启后，未过期的能力会恢复触发。群聊设置不受影响。')) return
+        setBusy(true)
+        try {
+          const response = await fetch('/api/ant-teams/delegation/dm-chat', {
+            method: 'PUT', headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ bot_id: selectedBot.bot_id,
+              bot_fingerprint: selectedBot.fingerprint, enabled }),
+          })
+          if (!response.ok) {
+            const result = await readLocalJsonResponse(response)
+            throw new Error(result.message || '私聊设置保存失败。')
+          }
+          await load()
+          setMessage(enabled ? '已开启此机器人的私聊。' : '已关闭此机器人的私聊；群聊设置保持不变。')
+        } catch (error) { setMessage(error.message) }
+        finally { setBusy(false) }
+      }
       const saveLocalProcessingSettings = async (event) => {
         event.preventDefault()
         setBusy(true)
@@ -673,8 +715,51 @@ window.__ModuleLoader__.load({
         } catch (error) { setMessage(error.message) }
         finally { setBusy(false) }
       }
+      const setupStepper = h('ol', { 'aria-label': '设置步骤', style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(min(100%, 150px), 1fr))',
+        gap: 8, padding: 0, margin: 0, listStyle: 'none' } },
+      ...[
+        { label: '绑定机器人', detail: '连接到这台 DSH' },
+        { label: '设置聊天范围', detail: '私聊和群聊分别控制' },
+        { label: '开放能力', detail: selectedTaskCount ? `${selectedTaskCount} 项已开放` : '按需要逐项开放' },
+        { label: '复核授权', detail: createOpen ? '正在配置授权范围' : selectedTaskCount ? '可随时查看与停止' : '请求范围由所有者设定' },
+      ].map((step, index) => {
+        const currentStep = !botConnected || !selectedEnrollmentBound ? 0 : createOpen ? 3 : selectedTaskCount ? 4 : 2
+        const state = index < currentStep ? '完成' : index === currentStep ? '当前' : '待完成'
+        return h('li', { key: step.label, style: { display: 'grid', gap: 3, padding: '8px 10px',
+          borderTop: `2px solid ${state === '完成' ? 'var(--dsw-alias-state-success-primary)' : state === '当前' ? 'var(--dsw-alias-state-business-primary)' : 'var(--dsw-alias-border-l2)'}`,
+          minWidth: 0 } },
+        h('strong', { style: { fontSize: 13, fontWeight: 600 } }, step.label),
+        h('span', { style: mutedTextStyle }, step.detail))
+      }))
+      const chatScopePanel = h('div', { style: { border: '1px solid var(--dsw-alias-border-l2)', borderRadius: 8, padding: 12,
+        display: 'grid', gap: 8 } },
+      h('strong', null, '机器人和聊天范围'),
+      h('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(min(100%, 240px), 1fr))', gap: 8 } },
+        h('div', { style: { display: 'grid', gap: 5, padding: 10, borderRadius: 8,
+          backgroundColor: 'var(--dsw-alias-bg-layer-2)' } },
+        h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', gap: 8 } },
+          h('label', { style: { display: 'flex', gap: 8, alignItems: 'center' } },
+            h('input', { type: 'checkbox', checked: dmChatEnabled,
+              disabled: busy || !selectedBot || !selectedEnrollmentBound
+                || enrollmentLoadError || !dmChatSettingAvailable,
+              onChange: (event) => void saveDmChat(event.target.checked),
+              'aria-label': '允许机器人私聊' }), h('strong', null, '私聊')),
+          h('span', { style: { ...mutedTextStyle, whiteSpace: 'nowrap' } }, dmChatStatus)),
+        h('p', { style: mutedTextStyle }, dmChatDescription)),
+        h('div', { style: { display: 'grid', gap: 5, padding: 10, borderRadius: 8,
+          backgroundColor: 'var(--dsw-alias-bg-layer-2)' } },
+        h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', gap: 8 } },
+          h('label', { style: { display: 'flex', gap: 8, alignItems: 'center' } },
+            h('input', { type: 'checkbox', checked: Boolean(selectedChatGroup?.chat_enabled),
+              disabled: busy || groupChatLoadFailed || !selectedEnrollmentBound || !botConnected || !chatGroupId.trim()
+                || (Boolean(selectedChatGroup?.chat_enabled) && selectedGroupHasTasks),
+              onChange: (event) => void saveGroupChat(event.target.checked),
+              'aria-label': '允许所选群进行普通聊天' }), h('strong', null, '群聊')),
+          h('span', { style: { ...mutedTextStyle, whiteSpace: 'nowrap' } }, `${availableGroups.length} 个已发现`)),
+        h('p', { style: mutedTextStyle }, '选择一个群后可单独启用；不影响私聊设置，群任务仍需单独授权。'))))
       const createCard = async (event) => {
         event.preventDefault()
+        setDraftNotice('')
         if (!selectedBot || !botConnected || !selectedEnrollmentBound) { setMessage('请先在这台 DSH 绑定选中的协作机器人。'); return }
         if (!title.trim() || !intent.trim() || !taskPrompt.trim()) {
           setMessage('请填写能力名称、适用请求说明和处理要求。'); return
@@ -781,6 +866,30 @@ window.__ModuleLoader__.load({
         } catch (error) { setMessage(error.message) }
         finally { setBusy(false) }
       }
+      const copyCardToDraft = (card) => {
+        const cardBot = bots.find((bot) => bot.fingerprint === card.bot_fingerprint)
+        const cardEnrollment = enrolled.find((bot) => bot.bot_fingerprint === card.bot_fingerprint)
+        const titleChars = Array.from(`复制：${card.title || '未命名能力'}`)
+        while (new TextEncoder().encode(titleChars.join('')).length > 100) titleChars.pop()
+        setBotId(card.bot_id || cardBot?.bot_id || '')
+        setTrustedOrigin(cardEnrollment?.gitea_origin || '')
+        setTitle(titleChars.join(''))
+        setIntent(card.intent || '')
+        setExamples(Array.isArray(card.examples) ? card.examples.join('\n') : '')
+        setTaskPrompt(card.task_prompt || '')
+        setRunner(['dsh', 'codex', 'claude-code'].includes(card.runner) ? card.runner : 'dsh')
+        setParameters(Array.isArray(card.parameters) ? card.parameters.map((rule) => ({
+          ...rule, min: String(rule.min ?? ''), max: String(rule.max ?? ''), choices: Array.isArray(rule.choices) ? rule.choices.join(',') : String(rule.choices ?? ''),
+        })) : [])
+        setConversationKind(card.conversation_kind === 'group' ? 'group' : 'dm')
+        setGroupId(card.conversation_id || '')
+        setSenderScope(card.sender_scope === 'allowlist' ? 'allowlist' : 'any')
+        setSenderIds(Array.isArray(card.sender_ids) ? card.sender_ids.join('\n') : '')
+        setDays(7)
+        setDraftNotice('已复制到新草稿。复制不保留原有效期；开放前请重新核对群、请求人和执行方，默认有效期为 7 天。')
+        setCreateOpen(true)
+        onSelectTab('capability')
+      }
       const cancelTask = async (task) => {
         if (!window.confirm(`取消任务 ${task.task_id}？已经发生的读取不能撤回。`)) return
         setBusy(true)
@@ -798,19 +907,11 @@ window.__ModuleLoader__.load({
       'aria-label': '协作机器人与开放能力' },
         message ? h('p', { role: 'status', style: mutedTextStyle }, message) : null,
         h('div', { role: 'region', 'aria-label': '机器人连接和聊天范围', style: { display: activeTab === 'bot-chat' ? 'grid' : 'none', gap: 14 } },
-        h('h3', { style: { margin: 0, fontSize: 16 } }, '协作机器人'),
-        h('p', { style: mutedTextStyle }, '同事可以像平常一样和机器人聊天。DSH 负责理解与回答；只有准备执行你开放的能力时，ANT 才核对请求人、群、参数和权限。群里的任务结果会回复原群。'),
+        h('h3', { style: sectionTitleStyle }, '协作机器人'),
+        h('p', { style: mutedTextStyle }, '在所有者开启的私聊或群聊中，同事可以像平常一样和机器人聊天。DSH 负责理解与回答；只有准备执行你开放的能力时，ANT 才核对请求人、群、参数和权限。群里的任务结果会回复原群。'),
         h('p', { role: 'status', style: mutedTextStyle }, '每项能力都单独设定执行方和请求范围。普通对话不会自动获得读取电脑、调用工具或访问其他群的权限。'),
         loadFailures.length ? h('p', { role: 'status', style: mutedTextStyle },
           `部分协作信息暂时无法读取：${loadFailures.map((path) => loadNames[path]).join('、')}。已读取的信息仍显示，请稍后刷新状态。`) : null,
-        h('div', { style: { border: '1px solid var(--dsw-alias-border-l2)', borderRadius: 8, padding: 12,
-          display: 'grid', gap: 8 } },
-          h('strong', null, '机器人和聊天范围'),
-          h('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(min(100%, 240px), 1fr))', gap: 8 } },
-            h('div', { style: { padding: 10, borderRadius: 8, backgroundColor: 'var(--dsw-alias-bg-layer-2)' } },
-              h('strong', null, '私聊'), h('p', { style: { ...mutedTextStyle, marginTop: 4 } }, '默认可用，可正常聊天；执行任务仍需单独授权。')),
-            h('div', { style: { padding: 10, borderRadius: 8, backgroundColor: 'var(--dsw-alias-bg-layer-2)' } },
-              h('strong', null, '群聊'), h('p', { style: { ...mutedTextStyle, marginTop: 4 } }, '可同时启用；群成员是否能执行任务由每项能力授权决定。'))),
           h('span', { role: 'status', style: mutedTextStyle }, loading ? '正在读取机器人与任务状态…'
             : botLoadError ? '暂时无法读取机器人状态。请刷新后再试。'
               : connectedBots.length === 0 ? '尚未发现已连接的机器人。请先在 DSH-IM 中连接飞书机器人。'
@@ -820,12 +921,13 @@ window.__ModuleLoader__.load({
                     : '机器人已连接；协作启用状态暂未读取，请刷新状态。'
                   : selectedBot && !selectedEnrollmentBound ? selectedEnrollment
                     ? `“${selectedBot.name}”已连接；原协作配置尚未绑定到这台 DSH，请在本机重新启用。若原设备令牌曾被撤销，旧任务权限已关闭，绑定后需重新开放。`
-                    : `“${selectedBot.name}”已连接；请先启用本机协作。启用后，它仍能正常聊天。`
-                  : enrolledCount === 0 ? '机器人已连接；请选择并启用协作。启用后，它仍能正常聊天。'
-                      : !selectedBot ? '已有协作机器人；请选择一台，查看已开放的能力并私聊自测。'
-                      : authorizationLoadError ? `“${selectedBot.name}”已启用协作；已开放任务暂未读取，请刷新状态。普通聊天仍可自测。`
-                      : selectedTaskCount === 0 ? `“${selectedBot.name}”已启用协作；下一步开放一项能力。你也可以先私聊自测普通聊天。`
-                        : `“${selectedBot.name}”已启用协作 · ${selectedTaskCount} 项能力已开放。可以私聊自测。`),
+                    : `“${selectedBot.name}”已连接；请先启用本机协作。`
+                  : enrolledCount === 0 ? '机器人已连接；请选择并启用协作。'
+                      : !selectedBot ? '已有协作机器人；请选择一台，查看已开放的能力和聊天范围。'
+                      : authorizationLoadError ? `“${selectedBot.name}”已启用协作；已开放任务暂未读取，请刷新状态。`
+                      : !dmChatEnabled ? `“${selectedBot.name}”已启用协作；私聊已关闭，群聊仍按各自设置工作。`
+                        : selectedTaskCount === 0 ? `“${selectedBot.name}”已启用协作；下一步开放一项能力。你也可以先私聊自测普通聊天。`
+                          : `“${selectedBot.name}”已启用协作 · ${selectedTaskCount} 项能力已开放。可以私聊自测。`),
           bots.length ? h('label', null, '我的机器人', h('select', { 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 },
@@ -841,8 +943,6 @@ window.__ModuleLoader__.load({
           selectedBot && !selectedEnrollmentBound ? h('button', { type: 'button', disabled: busy || !botConnected || enrollmentLoadError,
             onClick: () => void enrollBot(), style: secondaryButtonStyle },
             selectedEnrollment ? '绑定原协作配置到这台 DSH' : '启用并绑定到这台 DSH') : null,
-          selectedEnrollmentBound && botConnected ? h('p', { style: mutedTextStyle },
-            `自测：私聊“${selectedBot.name}”发送“你能做什么”；发起任务后可问“刚才的任务怎么样了”。群聊请先在目标群 @机器人，再开放能力时选择该群。`) : null,
           selectedBot ? h('div', { style: { display: 'grid', gap: 8, padding: 10,
             border: '1px solid var(--dsw-alias-border-l2)', borderRadius: 8 } },
             h('strong', null, `可信 Gitea 地址 · ${selectedBot.name}`),
@@ -854,41 +954,104 @@ window.__ModuleLoader__.load({
               h('button', { type: 'button', disabled: busy || !trustedOrigin.trim() || (!selectedEnrollmentBound && !botConnected),
                 onClick: () => void (selectedEnrollmentBound ? saveTrustedOrigin() : enrollBot()), style: secondaryButtonStyle },
                 selectedEnrollmentBound ? '保存可信地址' : botConnected ? '绑定机器人并保存地址' : '先连接机器人'))) : null,
+          setupStepper,
+          chatScopePanel,
+          selectedEnrollmentBound && botConnected ? h('p', { style: mutedTextStyle },
+            dmChatEnabled
+              ? `自测：私聊“${selectedBot.name}”发送“你能做什么”；发起任务后可问“刚才的任务怎么样了”。群聊请先在目标群 @机器人，再开放能力时选择该群。`
+              : '私聊当前已关闭；如要恢复，请在上方开启。群聊请先在目标群 @机器人，再开放能力时选择该群。') : null,
           selectedEnrollmentBound && botConnected ? h('div', { style: { display: 'grid', gap: 8 } },
-            h('strong', null, '允许聊天的群'),
-            h('span', { style: mutedTextStyle }, '群成员可以正常聊天；是否能让机器人办事，由每项能力单独决定。若机器人尚未发现群，可以直接填群 ID。'),
-            h('select', { 'aria-label': '已记录的群', value: availableGroups.some((group) => group.group_id === chatGroupId) ? chatGroupId : '',
-              onChange: (event) => setChatGroupId(event.target.value), style: inputStyle },
-              h('option', { value: '' }, '从已记录的群中选择'),
-              ...availableGroups.map((group) => h('option', { key: group.group_id, value: group.group_id },
-                `${group.group_code} · ${group.chat_enabled ? '已允许聊天' : '未允许聊天'}`))),
-            h('input', { 'aria-label': '群 ID', value: chatGroupId, maxLength: 256,
-              onChange: (event) => setChatGroupId(event.target.value.trim()),
-              placeholder: '也可以手动填写群 ID', style: inputStyle }),
-            h('button', { type: 'button', disabled: busy || !chatGroupId.trim()
-              || (selectedChatGroup?.chat_enabled && selectedGroupHasTasks),
-              onClick: () => void saveGroupChat(), style: secondaryButtonStyle },
-              selectedChatGroup?.chat_enabled ? '关闭此群聊天'
-                : selectedGroupHasTasks ? '能力到期后仍允许聊天' : '允许此群聊天'),
+            h('strong', null, '群聊白名单'),
+            h('span', { role: 'status', style: mutedTextStyle }, groupChatLoadFailed
+              ? '群聊列表与当前权限暂时无法读取，请刷新后再更改；仍可填写群 ID。'
+              : availableGroups.length
+                ? '从机器人已发现的群中选择；仍可手动填写群 ID。允许普通聊天不等于允许群成员执行任务。'
+                : '先在目标群 @机器人并刷新列表；若平台暂未返回群列表，也可以手动填写群 ID。'),
+            h('div', { style: { display: 'grid', gridTemplateColumns: 'minmax(0, 1fr) auto', gap: 8, alignItems: 'end' } },
+              h('label', { style: { display: 'grid', gap: 5 } },
+                h('span', { style: mutedTextStyle }, '选择已记录的群'),
+                h('select', { 'aria-label': '已记录的群', value: availableGroups.some((group) => group.group_id === chatGroupId) ? chatGroupId : '',
+                  onChange: (event) => setChatGroupId(event.target.value), style: inputStyle },
+                  h('option', { value: '' }, '选择已发现的群聊'),
+                  ...availableGroups.map((group) => h('option', { key: group.group_id, value: group.group_id },
+                    `${group.group_code} · ${group.chat_enabled ? '已允许普通聊天' : '未允许普通聊天'}`)))),
+              h('button', { type: 'button', disabled: busy || !selectedEnrollmentBound,
+                onClick: () => void load().catch((error) => setMessage(error.message)), style: secondaryButtonStyle }, '刷新群列表')),
+            h('label', { style: { display: 'grid', gap: 5 } },
+              h('span', { style: mutedTextStyle }, '群 ID（平台未返回群名时可手动填写）'),
+              h('input', { 'aria-label': '群 ID', value: chatGroupId, maxLength: 256,
+                onChange: (event) => setChatGroupId(event.target.value.trim()),
+                placeholder: '输入群 ID', style: inputStyle })),
             selectedChatGroup?.chat_enabled && selectedGroupHasTasks ? h('span', { style: mutedTextStyle },
-              '本群还有开放能力；关闭聊天前请先停止这些能力。') : null) : null,
+              '本群还有开放能力；关闭普通聊天前请先停止这些能力。') : 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 }, '刷新状态')))),
+              style: secondaryButtonStyle }, '刷新状态'))),
         h('div', { role: 'region', 'aria-label': '已开放能力列表', style: { display: activeTab === 'capability' ? 'grid' : 'none', gap: 12 } },
-        h('h4', { style: { marginBottom: 0 } }, `我开放的能力 · ${authorizationLoadError ? '暂未读取' : activeCards.length}`),
-        ...activeCards.map((card) => h('div', { key: card.id, style: { display: 'flex', gap: 12,
-          alignItems: 'center', justifyContent: 'space-between', flexWrap: 'wrap', borderTop: '1px solid var(--dsw-alias-border-l2)', paddingTop: 8 } },
-          h('span', { style: { flex: '1 1 280px', minWidth: 0, overflowWrap: 'anywhere' } }, `${card.title} · ${bots.find((bot) => bot.fingerprint === card.bot_fingerprint)?.name || '机器人'} · ${card.conversation_kind === 'group' ? `群 ${groups.find((group) => group.group_id === card.conversation_id)?.group_code || card.conversation_id}` : '私聊'} · ${card.sender_scope === 'allowlist' ? '仅指定成员可请求' : card.conversation_kind === 'group' ? '群成员可请求' : '可私聊者可请求'} · 结果回复原${card.conversation_kind === 'group' ? '群' : '私聊'} · ${card.runner === 'codex' ? 'Codex PR 快照审查试用' : card.runner === 'claude-code' ? 'Claude Code PR 完整快照审查试用' : 'DSH 文字处理'} · ${new Date(card.expires_at * 1000).toLocaleString('zh-CN')} 到期`),
-          h('button', { type: 'button', disabled: busy, onClick: () => void revokeCard(card), style: secondaryButtonStyle }, '停止'))),
+        h('h4', { style: sectionTitleStyle }, `我开放的能力 · ${authorizationLoadError ? '暂未读取' : activeCards.length}`),
+        h('p', { style: mutedTextStyle }, '当前一项能力只能绑定一个范围：私聊，或某一个群。若要给其他群或私聊开放相同任务，目前需分别建立能力卡；它们的请求人和有效期独立。'),
+        ...activeCards.map((card) => {
+          const expiresAt = Number(card.expires_at) * 1000
+          const remainingDays = Math.max(1, Math.ceil((expiresAt - Date.now()) / 86_400_000))
+          const expiry = remainingDays <= 7 ? `${remainingDays} 天后到期` : `至 ${new Date(expiresAt).toLocaleDateString('zh-CN')}`
+          const conversation = card.conversation_kind === 'group'
+            ? `群 ${groups.find((group) => group.group_id === card.conversation_id)?.group_code || card.conversation_id}` : '私聊'
+          const requester = card.sender_scope === 'allowlist' ? '指定成员可请求'
+            : card.conversation_kind === 'group' ? '群成员可请求' : '可私聊者可请求'
+          const runnerName = card.runner === 'codex' ? '本机 Codex · PR 快照'
+            : card.runner === 'claude-code' ? '本机 Claude Code · PR 快照' : 'DSH 文字处理'
+          const parametersText = (card.parameters || []).map((rule) => {
+            const constraint = rule.kind === 'gitea_pr' && rule.repository ? `仓库 ${rule.repository}`
+              : rule.kind === 'choice' ? `选项 ${(rule.choices || []).join('、')}`
+                : ['integer', 'gitea_pr'].includes(rule.kind)
+                  ? `范围 ${rule.min ?? 1}–${rule.max ?? '无上限'}` : ''
+            return `${rule.name}：${rule.description || rule.kind}${rule.required ? '（必填）' : '（可选）'}${constraint ? ` · ${constraint}` : ''}`
+          }).join('；')
+          const examplesText = Array.isArray(card.examples) ? card.examples.join('、') : ''
+          const requesterIds = card.sender_scope === 'allowlist' && Array.isArray(card.sender_ids) ? card.sender_ids.join('、') : ''
+          const remainingDaysLabel = remainingDays <= 7 ? 'var(--dsw-alias-state-warning-primary, var(--dsw-alias-label-secondary))'
+            : 'var(--dsw-alias-label-secondary)'
+          return h('div', { key: card.id, style: { display: 'grid', gridTemplateColumns: 'minmax(0, 1fr) auto',
+            alignItems: 'start', gap: 12, borderTop: '1px solid var(--dsw-alias-border-l2)', padding: '10px 0' } },
+          h('div', { style: { display: 'grid', gap: 4, minWidth: 0 } },
+            h('div', { style: { display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap' } },
+              h('strong', { style: { overflowWrap: 'anywhere' } }, card.title || '未命名能力'),
+              h('span', { style: { ...mutedTextStyle, padding: '2px 8px', borderRadius: 999,
+                backgroundColor: 'var(--dsw-alias-bg-layer-2)', color: remainingDaysLabel, whiteSpace: 'nowrap' } }, expiry)),
+            h('span', { style: mutedTextStyle }, `${runnerName} · ${conversation} · ${requester} · 结果回复原${card.conversation_kind === 'group' ? '群' : '私聊'}`),
+            h('details', null,
+              h('summary', { style: { cursor: 'pointer', color: 'var(--dsw-alias-link)', fontSize: 13 } }, '查看配置'),
+              h('div', { style: { display: 'grid', gap: 4, paddingTop: 6 } },
+                card.intent ? h('p', { style: mutedTextStyle }, `适用请求：${card.intent}`) : null,
+                parametersText ? h('p', { style: { ...mutedTextStyle, overflowWrap: 'anywhere' } }, `请求参数：${parametersText}`)
+                  : h('p', { style: mutedTextStyle }, '请求参数：无'),
+                requesterIds ? h('p', { style: { ...mutedTextStyle, overflowWrap: 'anywhere' } }, `允许请求的 IM 用户：${requesterIds}`) : null,
+                examplesText ? h('p', { style: mutedTextStyle }, `请求示例：${examplesText}`) : null,
+                card.task_prompt ? h('p', { style: mutedTextStyle }, `处理要求：${card.task_prompt}`) : null))),
+          h('div', { style: { display: 'flex', gap: 6, flexWrap: 'wrap', justifyContent: 'flex-end' } },
+            h('button', { type: 'button', disabled: busy, onClick: () => copyCardToDraft(card), style: secondaryButtonStyle }, '复制'),
+            h('button', { type: 'button', disabled: busy, onClick: () => void revokeCard(card), style: secondaryButtonStyle }, '停止')))
+        }),
         activeCards.length === 0 ? h('p', { style: mutedTextStyle },
           authorizationLoadError ? '暂时无法确认已开放的能力，请刷新状态后再试。'
             : '还没有开放能力。先选机器人，再开放一项能力；PR 审查只是可选示例。') : null),
         h('div', { role: 'region', 'aria-label': '最近任务', style: { display: activeTab === 'local' ? 'grid' : 'none', gap: 12 } },
-        h('h4', { style: { marginBottom: 0 } }, '最近任务'),
+        h('h4', { style: sectionTitleStyle }, '最近任务'),
         ...(tasks.filter((task) => task.task_id).length ? tasks.filter((task) => task.task_id)
           .map((task) => {
             const title = task.title || (task.pr_number
@@ -913,10 +1076,14 @@ window.__ModuleLoader__.load({
           onToggle: (event) => setCreateOpen(event.currentTarget.open),
           style: { border: '1px solid var(--dsw-alias-border-l2)', borderRadius: 8, padding: 12 } },
           h('summary', { style: { cursor: 'pointer', fontWeight: 600 } }, '开放一项能力'),
-        h('form', { onSubmit: createCard, style: { display: 'grid', gap: 9, maxWidth: 760 } },
+        h('div', { style: { display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(min(100%, 320px), 1fr))',
+          gap: 16, alignItems: 'start', marginTop: 12 } },
+        h('form', { id: 'ant-capability-create-form', onSubmit: createCard, style: { display: 'grid', gap: 9, minWidth: 0 } },
           h('p', { style: mutedTextStyle }, selectedBot
             ? `当前机器人：${selectedBot.name}${selectedEnrollmentBound ? ' · 已绑定此设备' : ' · 请先绑定到此设备'}`
             : '请先在上方选择机器人并启用协作。'),
+          draftNotice ? h('p', { role: 'status', style: { ...mutedTextStyle,
+            color: 'var(--dsw-alias-state-warning-primary, var(--dsw-alias-label-secondary))' } }, draftNotice) : null,
           selectedEnrollmentBound ? h('p', { style: mutedTextStyle },
             '机器人及其任务能力只在这台 DSH 设备接收和执行；同一账号的其他设备不会继承本机授权。') : null,
           selectedEnrollment && !selectedEnrollmentBound ? h('p', { style: mutedTextStyle },
@@ -946,8 +1113,6 @@ window.__ModuleLoader__.load({
             'Claude Code 通过 DSH 已注册的子代理运行，可查看本次 PR 的临时代码快照。ANT 不会传 Gitea 令牌；Claude Code 沿用 DSH 提供方的本机权限，不具备 Codex 路径相同的固定只读隔离。Git LFS 实际文件不会下载。') : null,
           selectedRunnerNeedsPr ? h('p', { role: 'status', style: mutedTextStyle },
             '本机 PR 执行方需要 Gitea granular token 的只读权限 read:repository 和 read:user；read:user 仅用于这台 DSH 获取 Git HTTPS 登录名。') : null,
-          h('p', { role: 'status', style: mutedTextStyle },
-            `开放后：${requesterSummary}可请求 · 有效期 ${days} 天 · ${resultRouteSummary}`),
           h('details', { style: { border: '1px solid var(--dsw-alias-border-l2)', borderRadius: 8, padding: 10 } },
             h('summary', { style: { cursor: 'pointer' } }, '参数与授权范围'),
           h('div', null, h('strong', null, '需要从请求中确认的参数'),
@@ -963,7 +1128,7 @@ window.__ModuleLoader__.load({
               onChange: (event) => updateParameter(index, { kind: event.target.value }), style: { ...inputStyle, flex: '1 1 150px' } },
               h('option', { value: 'text' }, '文本'), h('option', { value: 'integer' }, '整数'),
               h('option', { value: 'choice' }, '选项'), h('option', { value: 'gitea_pr' }, 'Gitea PR 编号')),
-            h('label', null, h('input', { type: 'checkbox', checked: rule.required,
+            h('label', null, h('input', { type: 'checkbox', checked: rule.required, 'aria-label': '参数必填',
               onChange: (event) => updateParameter(index, { required: event.target.checked }) }), ' 必填'),
             ['integer', 'gitea_pr'].includes(rule.kind) ? h('input', { 'aria-label': '最小值', type: 'number', value: rule.min,
               onChange: (event) => updateParameter(index, { min: event.target.value }), placeholder: '最小值', style: { ...inputStyle, width: 120 } }) : null,
@@ -996,12 +1161,6 @@ window.__ModuleLoader__.load({
               `识别码 ${group.group_code} · ${group.group_id}`)))) : null,
           conversationKind === 'group' ? h('button', { type: 'button', disabled: busy,
             onClick: () => void load().catch((error) => setMessage(error.message)), style: secondaryButtonStyle }, '刷新群列表') : null,
-          conversationKind === 'group' && selectedEnrollmentBound ? h('div', { style: { display: 'flex', gap: 8, alignItems: 'center', flexWrap: 'wrap' } },
-            h('span', { style: mutedTextStyle }, selectedEnrollment.owner_bound ? '已绑定你的飞书身份，可在群内批准任务' : '群内批准前需绑定你的飞书身份'),
-            h('button', { type: 'button', disabled: busy, onClick: () => void issueBindingCode(), style: secondaryButtonStyle },
-              selectedEnrollment.owner_bound ? '重新获取绑定码' : '获取身份绑定码')) : null,
-          conversationKind === 'group' && bindingCode ? h('p', { role: 'status', style: mutedTextStyle },
-            `请你本人私聊机器人发送“绑定身份 ${bindingCode}”。完成后在群里 @机器人发送“在本群启用任务 任务名称”，并按提示确认；结果会公开回复该群。`) : null,
           h('label', null, '谁可以请求', h('select', { value: senderScope,
             onChange: (event) => setSenderScope(event.target.value), style: inputStyle },
             h('option', { value: 'any' }, conversationKind === 'group' ? '此群任何成员' : '任何能私聊此机器人者'),
@@ -1010,9 +1169,29 @@ window.__ModuleLoader__.load({
             onChange: (event) => setSenderIds(event.target.value), placeholder: '多个 ID 用逗号分隔', style: inputStyle }) : null,
           h('label', null, '有效期', h('select', { value: days, onChange: (event) => setDays(Number(event.target.value)), style: inputStyle },
             h('option', { value: 1 }, '1 天'), h('option', { value: 7 }, '7 天'), h('option', { value: 30 }, '30 天')))),
-          cardBlockReason ? h('p', { role: 'status', style: mutedTextStyle }, cardBlockReason) : null,
-          h('button', { disabled: busy || Boolean(cardBlockReason),
-            style: primaryButtonStyle }, '保存并开放能力')))),
+        ),
+        h('aside', { role: 'region', 'aria-label': '开放前复核', style: { ...panelStyle, padding: 14, gap: 10,
+          position: 'sticky', top: 12, alignSelf: 'start' } },
+          h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', gap: 8 } },
+            h('h4', { style: sectionTitleStyle }, '开放前复核'),
+            h('span', { style: { ...mutedTextStyle, padding: '3px 8px', borderRadius: 999,
+              backgroundColor: 'var(--dsw-alias-bg-layer-2)' } }, '草稿 · 未开放')),
+          h('p', { style: mutedTextStyle }, '保存后，机器人只会在以下范围内执行这项能力。'),
+          h('dl', { style: { display: 'grid', gap: 8, margin: 0 } },
+            ...[
+              ['触发位置', conversationKind === 'group' ? `群 ${groupId || '尚未选择'}` : '私聊'],
+              ['可请求人', requesterSummary],
+              ['执行方', executorSummary],
+              ['读取资料', resourceSummary],
+              ['有效期', `${days} 天`],
+              ['回复位置', resultRouteSummary],
+            ].map(([label, value]) => h('div', { key: label, style: { display: 'grid', gridTemplateColumns: '84px minmax(0, 1fr)', gap: 8 } },
+              h('dt', { style: mutedTextStyle }, label),
+              h('dd', { style: { margin: 0, minWidth: 0, overflowWrap: 'anywhere' } }, value)))),
+          cardBlockReason ? h('p', { role: 'status', style: { ...mutedTextStyle,
+            color: 'var(--dsw-alias-state-warning-primary, var(--dsw-alias-label-secondary))' } }, cardBlockReason) : null,
+          h('button', { type: 'submit', form: 'ant-capability-create-form', disabled: busy || Boolean(cardBlockReason),
+            style: { ...primaryButtonStyle, width: '100%' } }, '确认并开放能力'))))),
         h('div', { role: 'region', 'aria-label': '本机处理设置', style: { display: activeTab === 'local' ? 'grid' : 'none', gap: 12 } },
         h('section', { style: { ...panelStyle, padding: 14 } },
           h('strong', null, 'Gitea 本机凭据'),
@@ -2056,19 +2235,25 @@ window.__ModuleLoader__.load({
       const updateGuideUrl = pinnedServiceUrl
         ? new URL('/ant-update', pinnedServiceUrl).href : null
       const modelRows = authorizedModels.map((model) => h('div', { key: `${model.protocol}:${model.model_id}`, role: 'listitem',
-        style: { display: 'flex', flexWrap: 'wrap', justifyContent: 'space-between', gap: 12, alignItems: 'center',
-          padding: '10px 2px', borderBottom: '1px solid var(--dsw-alias-border-l2)' } },
-        h('strong', null, model.display_name || model.model_id),
-        h('span', { style: mutedTextStyle }, model.protocol === 'anthropic' ? 'Anthropic' : 'OpenAI'),
-        h('span', { style: mutedTextStyle }, '已同步到 DSH')))
+        style: { display: 'grid', gridTemplateColumns: 'minmax(0, 1fr) minmax(120px, auto) minmax(130px, auto)',
+          gap: 12, alignItems: 'center', padding: '10px 2px', borderBottom: '1px solid var(--dsw-alias-border-l2)' } },
+        h('strong', { style: { minWidth: 0, overflowWrap: 'anywhere' } }, model.display_name || model.model_id),
+        h('span', { style: { display: 'inline-flex', justifySelf: 'start', padding: '3px 8px', borderRadius: 999,
+          backgroundColor: 'var(--dsw-alias-bg-layer-2)', color: 'var(--dsw-alias-label-secondary)', fontSize: 12 } },
+        `${model.protocol === 'anthropic' ? 'Anthropic' : 'OpenAI'} 协议`),
+        h('span', { style: { ...mutedTextStyle, textAlign: 'right' } }, '已同步到 DSH')))
       const connectionPanel = h('section', { style: { ...panelStyle, display: activeTab === 'connection' ? 'grid' : 'none' } },
         h('div', null,
-          h('h3', { style: { margin: 0, fontSize: 16, fontWeight: 650 } }, 'ANT 团队账号'),
+          h('h3', { style: sectionTitleStyle }, 'ANT 团队账号'),
           h('p', { style: { ...mutedTextStyle, marginTop: 4 } }, '邮箱验证建立这台 DSH 的成员凭证；断开后会清除此设备凭证和同步的模型设置。')),
         h('span', { role: 'status', style: mutedTextStyle }, credentialConfigured === true && !bindingReady
           ? '本机有 ANT 凭证，但尚未确认它绑定的团队；请完成上方的绑定检查。'
           : credentialConfigured === true ? 'DSH 已安全保存此设备的 ANT 团队凭证。'
             : credentialConfigured === false ? '验证工作邮箱后即可连接团队服务。' : '正在检查 ANT 连接状态…'),
+        h('div', { role: 'note', style: { display: 'grid', gap: 3, padding: '9px 11px', borderRadius: 8,
+          backgroundColor: 'var(--dsw-alias-bg-layer-2)' } },
+        h('strong', { style: { fontSize: 13, fontWeight: 600 } }, '配置保存范围'),
+        h('p', { style: mutedTextStyle }, '团队模型与能力授权由 ANT 管理；成员凭证、Gitea 令牌、本机缓存和任务记录保存在这台 DSH。')),
         serviceCompatibility.state !== 'idle' ? h('p', { role: 'status', style: { ...mutedTextStyle,
           color: serviceCompatibility.state === 'incompatible' ? 'var(--dsw-alias-state-error-primary)' : mutedTextStyle.color } },
         serviceCompatibility.message) : null,
@@ -2113,7 +2298,7 @@ window.__ModuleLoader__.load({
       const modelPanel = h('section', { style: { ...panelStyle, display: activeTab === 'models' ? 'grid' : 'none' } },
         h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', gap: 12 } },
           h('div', null,
-            h('h3', { style: { margin: 0, fontSize: 16, fontWeight: 650 } }, '团队模型'),
+            h('h3', { style: sectionTitleStyle }, '团队模型'),
             h('p', { style: { ...mutedTextStyle, marginTop: 4 } }, '每个获准模型单独列出；刷新后同步到 DSH 模型选择器。')),
           h('span', { style: { flexShrink: 0, padding: '4px 9px', borderRadius: 999,
             color: credentialConfigured === true && bindingReady ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-label-secondary)',
@@ -2133,36 +2318,50 @@ window.__ModuleLoader__.load({
           lastModelSync ? h('span', { style: mutedTextStyle }, `最近同步：${lastModelSync.toLocaleString('zh-CN')}`) : null),
         modelMessage && !modelMessage.startsWith('正在') ? h('p', { role: 'status', style: mutedTextStyle }, modelMessage) : null)
 
+      const updateStatusLabels = {
+        available: '有新版', 'artifact-missing': '等待发布制品', revoked: '安装包已撤回',
+        'migration-required': '需要迁移', unknown: '状态待确认', failed: '检查失败',
+        installing: '正在安装', done: '需重启 DSH', current: '已是最新', checking: '正在检查', none: '尚未发布',
+      }
+      const updateStatusNeedsDetails = ['artifact-missing', 'revoked', 'migration-required', 'unknown', 'failed', 'installing', 'done']
+      const updateVersionSummary = bundleUpdate.currentVersion && bundleRelease?.version
+        ? bundleUpdate.currentVersion === bundleRelease.version
+          ? `当前版本 ${bundleUpdate.currentVersion} · 已是最新`
+          : `当前版本 ${bundleUpdate.currentVersion} · 最新版本 ${bundleRelease.version}`
+        : bundleUpdate.currentVersion ? `当前版本 ${bundleUpdate.currentVersion}`
+          : bundleRelease?.version ? `最新版本 ${bundleRelease.version}` : ''
+      const showReleaseNotes = canCheckUpdate && bundleRelease?.version && bundleRelease.release_notes
+        && ['current', 'available', 'artifact-missing'].includes(bundleUpdate.state)
       const updatePanel = h('section', { style: { ...panelStyle, display: activeTab === 'updates' ? 'grid' : 'none' } },
         h('div', { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', gap: 12 } },
           h('div', null,
-            h('h3', { style: { margin: 0, fontSize: 16, fontWeight: 650 } }, 'ANT 插件更新'),
-            h('p', { style: { ...mutedTextStyle, marginTop: 4 } }, '团队连接就绪后自动检查；有新版时顶部会持续提醒。')),
-          h('span', { style: { ...mutedTextStyle, color: bundleUpdate.state === 'revoked'
-            ? 'var(--dsw-alias-state-error-primary)' : 'var(--dsw-alias-state-warning-primary, var(--dsw-alias-label-secondary))' } },
-          bundleUpdate.state === 'available' ? '有新版' : bundleUpdate.state === 'done' ? '需重启 DSH'
-            : bundleUpdate.state === 'current' ? '已是最新' : bundleUpdate.state === 'revoked' ? '安装包已撤回' : '更新状态')),
-        bundleUpdate.currentVersion ? h('p', { style: mutedTextStyle }, `当前安装版本：${bundleUpdate.currentVersion}`) : null,
-        bundleRelease?.version ? h('p', { style: mutedTextStyle }, `最新发布版本：${bundleRelease.version} · 精确包名：${directInstallSpec(bundleRelease)}`) : null,
-        serviceCompatibility.state !== 'idle' ? h('p', { role: 'status', style: {
+            h('h3', { style: sectionTitleStyle }, '关于 ANT'),
+            h('p', { style: { ...mutedTextStyle, marginTop: 4 } }, '查看版本、更新说明和兼容状态。')),
+          h('span', { style: { ...mutedTextStyle, flexShrink: 0,
+            color: bundleUpdate.state === 'revoked' || serviceCompatibility.state === 'incompatible'
+              ? 'var(--dsw-alias-state-error-primary)' : mutedTextStyle.color } },
+          updateStatusLabels[bundleUpdate.state] || '等待检查')),
+        updateVersionSummary ? h('p', { style: { ...mutedTextStyle, color: 'var(--dsw-alias-label-primary)', fontWeight: 550 } }, updateVersionSummary) : null,
+        showReleaseNotes ? h('section', { style: { display: 'grid', gap: 6, padding: 12, borderRadius: 8,
+          backgroundColor: 'var(--dsw-alias-bg-layer-2)' } },
+        h('strong', { style: { fontSize: 14, lineHeight: 1.4 } }, '本版更新'),
+        h('p', { style: mutedTextStyle }, bundleRelease.release_notes)) : null,
+        ['incompatible', 'unknown'].includes(serviceCompatibility.state) ? h('p', { role: 'status', style: {
           ...mutedTextStyle,
-          color: serviceCompatibility.state === 'incompatible' ? 'var(--dsw-alias-state-error-primary)' : mutedTextStyle.color,
-        } }, `当前已安装版本与团队服务端协议：${serviceCompatibility.message}`) : null,
-        bundleUpdate.message ? h('p', { role: 'status', style: bundleUpdate.state === 'revoked'
+          color: serviceCompatibility.state === 'incompatible' ? 'var(--dsw-alias-state-error-primary)'
+            : 'var(--dsw-alias-state-warning-primary, var(--dsw-alias-label-secondary))',
+        } }, `服务端兼容性：${serviceCompatibility.message}`) : null,
+        bundleUpdate.message && updateStatusNeedsDetails.includes(bundleUpdate.state) ? h('p', { role: 'status', style: bundleUpdate.state === 'revoked'
           ? { ...mutedTextStyle, color: 'var(--dsw-alias-state-error-primary)' } : mutedTextStyle }, bundleUpdate.message) : null,
         !canCheckUpdate && updateGuideUrl ? h('a', { href: updateGuideUrl, target: '_blank', rel: 'noopener noreferrer',
-          style: { color: 'var(--dsw-alias-link)', fontSize: 13 } }, `打开 ${pinnedServiceUrl} 的更新指引 ↗`) : null,
+          style: { color: 'var(--dsw-alias-link)', fontSize: 13 } }, '打开更新指引 ↗') : null,
         !canCheckUpdate && !updateGuideUrl ? h('p', { style: mutedTextStyle }, '无法核对原团队地址时，请向企业管理员索取更新指引。') : null,
         !canCheckUpdate ? h('button', { type: 'button', onClick: () => onSelectTab('connection'), style: secondaryButtonStyle },
           '前往团队连接') : null,
-        canCheckUpdate && bundleRelease?.version && ['available', 'artifact-missing'].includes(bundleUpdate.state)
-          ? h('div', { style: { display: 'grid', gap: 8 } },
-            bundleRelease.release_notes ? h('div', { style: { ...panelStyle, padding: 12 } },
-              h('strong', null, '更新说明'), h('p', { style: mutedTextStyle }, bundleRelease.release_notes)) : null,
-            bundleUpdate.state === 'available'
-              ? h('button', { type: 'button', disabled: busy, onClick: () => void installBundleUpdate(), style: primaryButtonStyle }, busy ? '更新中…' : '更新 ANT') : null) : null,
+        canCheckUpdate && bundleUpdate.state === 'available'
+          ? h('button', { type: 'button', disabled: busy, onClick: () => void installBundleUpdate(), style: primaryButtonStyle }, busy ? '更新中…' : '更新 ANT') : null,
         h('button', { type: 'button', disabled: busy || !canCheckUpdate || bundleUpdate.state === 'checking',
-          onClick: () => void checkBundleUpdate(), style: secondaryButtonStyle }, bundleUpdate.state === 'checking' ? '检查中…' : '重新检查更新'))
+          onClick: () => void checkBundleUpdate(), style: secondaryButtonStyle }, bundleUpdate.state === 'checking' ? '正在检查…' : '检查更新'))
 
       return h('div', { style: { display: 'grid', gap: 16, width: '100%' } },
         connectionPanel, modelPanel, updatePanel)

package/delegation.js

@@ -1048,6 +1048,8 @@ export function startDelegationHost(ctx, readConnection, { ledger = new Delegati
   const consumers = new Map()
   let enrolledFingerprints = new Set()
   let enrolledOrigins = new Map()
+  let dmChatEnabledByFingerprint = new Map()
+  const dmDisabledNoticeAt = new Map()
   let legacyDmGrants = []
   let legacyGroupGrants = []
   let enrollmentKnown = false
@@ -1270,6 +1272,25 @@ export function startDelegationHost(ctx, readConnection, { ledger = new Delegati
       scheduleProcess(entry, 'ANT owner binding reply stalled:')
       return { accepted: true }
     }
+    if (dmChatEnabledByFingerprint.get(event.fingerprint) === false) {
+      const noticeKey = `${event.fingerprint}\0${event.actor.id}`
+      const now = Date.now()
+      for (const [key, at] of dmDisabledNoticeAt) if (now - at >= 5 * 60_000) dmDisabledNoticeAt.delete(key)
+      if (now - (dmDisabledNoticeAt.get(noticeKey) || 0) >= 5 * 60_000) {
+        dmDisabledNoticeAt.set(noticeKey, now)
+        while (dmDisabledNoticeAt.size > 500) dmDisabledNoticeAt.delete(dmDisabledNoticeAt.keys().next().value)
+        try {
+          const notice = await ctx.dshIm.replyChecked(event.botId, event.reply,
+            '机器人所有者已关闭此机器人的私聊。请联系所有者在 ANT 插件的“机器人与聊天”页重新开启；群聊设置不受影响。',
+            { expectedFingerprint: event.fingerprint, signal: signal || controller.signal })
+          if (notice?.sent !== true) dmDisabledNoticeAt.delete(noticeKey)
+        } catch (error) {
+          dmDisabledNoticeAt.delete(noticeKey)
+          logger.warn?.('ANT 私聊关闭提示暂不可用:', error?.message)
+        }
+      }
+      return { accepted: true }
+    }
     const proposedLegacy = parseDelegatedPrRequest(text)
     const matchingLegacy = proposedLegacy.kind === 'pr_review' && legacyDmGrants.some((grant) =>
       grant.bot_fingerprint === event.fingerprint && grant.pr_number === proposedLegacy.pr_number
@@ -1482,6 +1503,7 @@ export function startDelegationHost(ctx, readConnection, { ledger = new Delegati
         consumers.clear()
         enrolledFingerprints = new Set()
         enrolledOrigins = new Map()
+        dmChatEnabledByFingerprint = new Map()
         legacyDmGrants = []
         legacyGroupGrants = []
         enrollmentKnown = false
@@ -1523,6 +1545,8 @@ export function startDelegationHost(ctx, readConnection, { ledger = new Delegati
       if (enrollmentKnown) {
         enrolledFingerprints = new Set(deviceEnrolled.map((bot) => bot.bot_fingerprint))
         enrolledOrigins = new Map(deviceEnrolled.map((bot) => [bot.bot_fingerprint, bot.gitea_origin]))
+        dmChatEnabledByFingerprint = new Map(deviceEnrolled.map((bot) =>
+          [bot.bot_fingerprint, bot.dm_chat_enabled !== false]))
       }
       let groups = []
       try {
@@ -1605,6 +1629,11 @@ export function startDelegationHost(ctx, readConnection, { ledger = new Delegati
     if (refreshing) await refreshDone
     if (!stopped) await refresh()
   }
+  stop.setDmChat = (fingerprint, enabled) => {
+    if (typeof fingerprint === 'string' && typeof enabled === 'boolean') {
+      dmChatEnabledByFingerprint.set(fingerprint.toLowerCase(), enabled)
+    }
+  }
   stop.cancelTask = async (taskId, serviceUrl) => {
     await ready
     if (stopped || !ledgerReady) return false

package/index.js

@@ -25,6 +25,7 @@ const DELEGATION_BOTS_PATH = '/api/ant-teams/delegation/bots'
 const DELEGATION_GRANTS_PATH = '/api/ant-teams/delegation/grants'
 const DELEGATION_ENROLLED_BOTS_PATH = '/api/ant-teams/delegation/enrolled-bots'
 const DELEGATION_GROUPS_PATH = '/api/ant-teams/delegation/groups'
+const DELEGATION_DM_CHAT_PATH = '/api/ant-teams/delegation/dm-chat'
 const DELEGATION_OWNER_CHALLENGE_PATH = '/api/ant-teams/delegation/owner-challenge'
 const DELEGATION_STATUS_PATH = '/api/ant-teams/delegation/status'
 const DELEGATION_CARDS_PATH = '/api/ant-teams/delegation/cards'
@@ -281,7 +282,8 @@ async function fetchDelegationGrants(request, ctx, credentials, settings) {
 }
 
 async function fetchDelegationGroupSettings(request, ctx, credentials, settings, kind, getHost) {
-  const methods = kind === 'groups' ? ['GET', 'PUT'] : kind === 'challenge' ? ['POST'] : ['GET', 'POST', 'DELETE']
+  const methods = kind === 'groups' ? ['GET', 'PUT'] : kind === 'dm-chat' ? ['PUT']
+    : kind === 'challenge' ? ['POST'] : ['GET', 'POST', 'DELETE']
   if (!methods.includes(request.method)) return jsonResponse(405, { message: '请求方式不支持。' })
   let connection
   try { connection = await readMemberConnection(credentials, settings) } catch {
@@ -312,6 +314,7 @@ async function fetchDelegationGroupSettings(request, ctx, credentials, settings,
     return jsonResponse(400, { message: '机器人编号无效。' })
   }
   const path = kind === 'groups' ? '/api/me/im-delegations/groups'
+    : kind === 'dm-chat' ? '/api/me/im-delegations/dm-chat'
     : kind === 'challenge' ? '/api/me/im-delegations/owner-challenge'
       : request.method === 'DELETE'
         ? `/api/me/im-delegations/bots/${encodeURIComponent(body.bot_id)}`
@@ -331,11 +334,13 @@ async function fetchDelegationGroupSettings(request, ctx, credentials, settings,
       redirect: 'manual', signal: AbortSignal.timeout(12_000),
     })
     if (response.status === 404 && request.method !== 'DELETE') {
-      return jsonResponse(426, { message: '团队服务端尚未支持群聊委托，请联系管理员升级 ANT 服务端。' })
+      return jsonResponse(426, { message: '团队服务端尚未支持这项协作设置，请联系管理员升级 ANT 服务端。' })
     }
     if (response.status === 204) {
-      if (kind === 'groups' && request.method === 'PUT') {
-        const refresh = getHost?.()?.refresh
+      if (['groups', 'dm-chat'].includes(kind) && request.method === 'PUT') {
+        const host = getHost?.()
+        if (kind === 'dm-chat') host?.setDmChat?.(body.bot_fingerprint, body.enabled)
+        const refresh = host?.refresh
         if (refresh) await refresh().catch(() => undefined)
       }
       return new Response(null, { status: 204 })
@@ -943,6 +948,7 @@ export function apply(ctx) {
     for (const [path, methods, kind] of [
       [DELEGATION_ENROLLED_BOTS_PATH, ['GET', 'POST', 'DELETE'], 'bots'],
       [DELEGATION_GROUPS_PATH, ['GET', 'PUT'], 'groups'],
+      [DELEGATION_DM_CHAT_PATH, ['PUT'], 'dm-chat'],
       [DELEGATION_OWNER_CHALLENGE_PATH, ['POST'], 'challenge'],
     ]) {
       connectionCtx.effect(() => connectionCtx.connection.fetch.register({

package/package.json

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