feat: connect inbox confirmation workflow

2026-07-21 18:24:15 +08:00
parent 60e5ef0a87
commit dbc8de173e
16 changed files with 1295 additions and 129 deletions
--- a/apps/web_v1/scripts/structure-check.mjs
+++ b/apps/web_v1/scripts/structure-check.mjs
@@ -7,6 +7,7 @@ const requiredFiles = [
  'src/pages/workspace-home.tsx',
  'src/pages/workspace-explore.tsx',
  'src/pages/projects/project-overview.tsx',
+  'src/pages/projects/project-inbox.tsx',
  'src/pages/projects/project-channel-page.tsx',
  'src/pages/projects/project-tasks.tsx',
  'src/pages/projects/project-ai.tsx',
@@ -33,7 +34,7 @@ for (const token of ['--color-primary: #165dff', '--font-sans', '--space-4: 16px
  if (!tokenSource.toLowerCase().includes(token)) failures.push(`missing token ${token}`)
 }
 for (const forbidden of ['森林Agent', 'AI智能体', '实时接口', '进度 60%']) {
-  for (const file of requiredFiles.filter((name) => name.endsWith('.tsx'))) {
+  for (const file of requiredFiles.filter((name) => name.endsWith('.tsx') && existsSync(name))) {
    if (readFileSync(file, 'utf8').includes(forbidden)) failures.push(`${file} contains forbidden copy ${forbidden}`)
  }
 }
@@ -42,7 +43,7 @@ if (existsSync('src/App.tsx')) {
  failures.push('legacy src/App.tsx should be removed after page split')
 }

-for (const removed of ['src/pages/projects/project-data.tsx', 'src/pages/projects/project-inspector.tsx', 'src/pages/projects/project-inbox.tsx']) {
+for (const removed of ['src/pages/projects/project-data.tsx', 'src/pages/projects/project-inspector.tsx']) {
  if (existsSync(removed)) {
    failures.push(`${removed} should be removed; frontend data must come from backend APIs`)
  }
@@ -105,6 +106,11 @@ const inboxSource = existsSync('src/api/inbox.ts') ? readFileSync('src/api/inbox
 for (const path of ['/api/v1/projects/', '/api/v1/inbox/']) {
  if (inboxSource && !inboxSource.includes(path)) failures.push(`inbox API must use ${path}`)
 }
+if (inboxSource.includes('body: { suggestions }')) failures.push('inbox confirm must not send client-authored suggestion content')
+if (!inboxSource.includes('body: { suggestionIds }')) failures.push('inbox confirm must send only saved suggestion identities')
+
+const inboxPageSource = existsSync('src/pages/projects/project-inbox.tsx') ? readFileSync('src/pages/projects/project-inbox.tsx', 'utf8') : ''
+if (inboxPageSource && !inboxPageSource.includes('确认创建')) failures.push('project inbox must expose the single confirmation action')

 const html = readFileSync('index.html', 'utf8')
 if (!html.includes('<html lang="zh-CN">')) failures.push('index language must be zh-CN')
--- a/apps/web_v1/scripts/visual-check.mjs
+++ b/apps/web_v1/scripts/visual-check.mjs
@@ -20,6 +20,14 @@ const errors = []
 const failures = []
 const projectId = '019b0000-0000-7000-8000-000000000001'
 const taskSearchResultId = '019b0000-0000-7000-8000-000000000003'
+const inboxItemId = '019b0000-0000-7000-8000-000000000004'
+const inboxTaskSuggestionId = '019b0000-0000-7000-8000-000000000005'
+const inboxNoteSuggestionId = '019b0000-0000-7000-8000-000000000006'
+const inboxSourceSuggestionId = '019b0000-0000-7000-8000-000000000007'
+const secondInboxItemId = '019b0000-0000-7000-8000-000000000008'
+const secondInboxTaskSuggestionId = '019b0000-0000-7000-8000-000000000009'
+const secondInboxNoteSuggestionId = '019b0000-0000-7000-8000-000000000010'
+const secondInboxSourceSuggestionId = '019b0000-0000-7000-8000-000000000011'
 const unknownProjectId = '019b0000-0000-7000-8000-000000000099'
 const externalProjectId = '019b0000-0000-7000-8000-000000000088'
 const externalTaskId = '019b0000-0000-7000-8000-000000000089'
@@ -27,8 +35,16 @@ const externalNoteId = '019b0000-0000-7000-8000-000000000090'
 const searchRequests = []
 const workspaceRequests = []
 const projectPatchRequests = []
+const inboxAnalyzeRequests = []
+const inboxConfirmRequests = []
 let expectingProjectPatchError = false
 let expectedProjectPatchConsoleErrorCount = 0
+let expectingInboxConfirmError = false
+let expectedInboxConfirmConsoleErrorCount = 0
+let expectingInboxRefreshError = false
+let expectedInboxRefreshConsoleErrorCount = 0
+let failNextInboxConfirm = true
+let failNextInboxWorkspaceRefresh = false
 page.on('console', (message) => {
  if (message.type() !== 'error') return
  if (
@@ -39,6 +55,22 @@ page.on('console', (message) => {
    expectedProjectPatchConsoleErrorCount += 1
    return
  }
+  if (
+    expectingInboxConfirmError &&
+    expectedInboxConfirmConsoleErrorCount === 0 &&
+    message.text() === 'Failed to load resource: the server responded with a status of 500 (Internal Server Error)'
+  ) {
+    expectedInboxConfirmConsoleErrorCount += 1
+    return
+  }
+  if (
+    expectingInboxRefreshError &&
+    expectedInboxRefreshConsoleErrorCount === 0 &&
+    message.text() === 'Failed to load resource: the server responded with a status of 500 (Internal Server Error)'
+  ) {
+    expectedInboxRefreshConsoleErrorCount += 1
+    return
+  }
  errors.push(message.text())
 })

@@ -55,16 +87,38 @@ const visualCheckWorkspace = {
  },
  channels: [
    { id: 'overview', projectId, type: 'overview', title: '概况', icon: 'home', count: 0, url: '', sortOrder: 0 },
-    { id: 'tasks', projectId, type: 'tasks', title: '工作计划', icon: 'list', count: 1, url: '', sortOrder: 1 },
-    { id: 'ai', projectId, type: 'ai_sessions', title: 'AI 助手', icon: 'robot', count: 0, url: '', sortOrder: 2 },
-    { id: 'notes', projectId, type: 'notes_sources', title: '笔记资料', icon: 'file', count: 0, url: '', sortOrder: 3 },
-    { id: 'cron', projectId, type: 'cron', title: '计划任务', icon: 'clock', count: 0, url: '', sortOrder: 4 },
+    { id: 'inbox', projectId, type: 'inbox', title: 'Inbox 消息流', icon: 'mail', count: 2, url: '', sortOrder: 1 },
+    { id: 'tasks', projectId, type: 'tasks', title: '工作计划', icon: 'list', count: 1, url: '', sortOrder: 2 },
+    { id: 'ai', projectId, type: 'ai_sessions', title: 'AI 助手', icon: 'robot', count: 0, url: '', sortOrder: 3 },
+    { id: 'notes', projectId, type: 'notes_sources', title: '笔记资料', icon: 'file', count: 0, url: '', sortOrder: 4 },
+    { id: 'cron', projectId, type: 'cron', title: '计划任务', icon: 'clock', count: 0, url: '', sortOrder: 5 },
  ],
  tags: [{ id: '019b0000-0000-7000-8000-000000000002', name: '产品' }],
  recentSessions: [
    { id: 'session-1', projectId, title: '移动导航会话', summary: '检查抽屉关闭行为', updatedAt: '2026-07-21T02:00:00Z', references: [] },
  ],
-  inbox: [],
+  inbox: [
+    {
+      id: inboxItemId,
+      projectId,
+      source: '手动收集',
+      title: '整理客户访谈',
+      summary: '把访谈结论整理为后续任务、会议纪要和背景资料。',
+      status: 'open',
+      tag: '待处理',
+      time: '2026-07-21T02:30:00Z',
+    },
+    {
+      id: secondInboxItemId,
+      projectId,
+      source: '手动收集',
+      title: '项目复盘记录',
+      summary: '整理项目复盘中的行动项和背景信息。',
+      status: 'open',
+      tag: '待处理',
+      time: '2026-07-21T02:20:00Z',
+    },
+  ],
  tasks: [],
  aiSessions: [],
  notesSources: [],
@@ -88,9 +142,62 @@ await page.route('http://localhost:9150/api/v1/**', async (route) => {
  }
  if (url.pathname === `/api/v1/projects/${projectId}/workspace`) {
    workspaceRequests.push(url.pathname)
+    if (failNextInboxWorkspaceRefresh) {
+      failNextInboxWorkspaceRefresh = false
+      await route.fulfill({
+        status: 500,
+        json: { error: { code: 'internal_error', message: '工作区刷新失败，请稍后重试' } },
+      })
+      return
+    }
    await route.fulfill({ json: visualCheckWorkspace })
    return
  }
+  if (url.pathname === `/api/v1/inbox/${inboxItemId}/analyze` && method === 'POST') {
+    inboxAnalyzeRequests.push(inboxItemId)
+    if (inboxAnalyzeRequests.length === 1) await new Promise((resolve) => setTimeout(resolve, 250))
+    await route.fulfill({
+      json: {
+        suggestions: [
+          { id: inboxTaskSuggestionId, kind: 'task', title: '跟进客户反馈', body: '联系客户确认下一步时间。' },
+          { id: inboxNoteSuggestionId, kind: 'note', title: '客户访谈纪要', body: '保存访谈中的关键结论。' },
+          { id: inboxSourceSuggestionId, kind: 'source', title: '访谈背景资料', body: '保存为文本资料，不伪造文件路径。' },
+        ],
+      },
+    })
+    return
+  }
+  if (url.pathname === `/api/v1/inbox/${secondInboxItemId}/analyze` && method === 'POST') {
+    inboxAnalyzeRequests.push(secondInboxItemId)
+    await route.fulfill({
+      json: {
+        suggestions: [
+          { id: secondInboxTaskSuggestionId, kind: 'task', title: '整理复盘任务', body: '安排下一次复盘。' },
+          { id: secondInboxNoteSuggestionId, kind: 'note', title: '复盘记录', body: '保存复盘结论。' },
+          { id: secondInboxSourceSuggestionId, kind: 'source', title: '复盘资料', body: '保存复盘背景。' },
+        ],
+      },
+    })
+    return
+  }
+  if ([`/api/v1/inbox/${inboxItemId}/confirm`, `/api/v1/inbox/${secondInboxItemId}/confirm`].includes(url.pathname) && method === 'POST') {
+    inboxConfirmRequests.push(route.request().postDataJSON())
+    await new Promise((resolve) => setTimeout(resolve, 250))
+    if (failNextInboxConfirm) {
+      failNextInboxConfirm = false
+      await route.fulfill({
+        status: 500,
+        json: { error: { code: 'internal_error', message: '确认创建失败，请稍后重试' } },
+      })
+      return
+    }
+    const confirmedItemId = url.pathname.split('/').at(-2)
+    visualCheckWorkspace.inbox.find((item) => item.id === confirmedItemId).status = 'processed'
+    visualCheckWorkspace.channels.find((channel) => channel.type === 'inbox').count -= 1
+    if (confirmedItemId === secondInboxItemId) failNextInboxWorkspaceRefresh = true
+    await route.fulfill({ json: { createdCount: inboxConfirmRequests.at(-1).suggestionIds.length } })
+    return
+  }
  if (url.pathname === '/api/v1/search') {
    const query = url.searchParams.get('q') ?? ''
    searchRequests.push(query)
@@ -487,6 +594,119 @@ const stageHoverMetrics = await collectMetrics()
 await page.locator('.channel-list').hover()
 const channelListHoverMetrics = await collectMetrics()

+const inboxChannelButton = page.locator('.channel-button', { hasText: 'Inbox 消息流' })
+if (await inboxChannelButton.count() === 0) {
+  failures.push('project sidebar must expose the Inbox channel from the workspace API')
+} else {
+  await inboxChannelButton.click()
+  const inboxPage = page.locator('.project-inbox-page')
+  if (await inboxPage.count() === 0) {
+    failures.push('Inbox channel must render the confirmation workflow page')
+  } else {
+    for (const content of ['整理客户访谈', '把访谈结论整理为后续任务、会议纪要和背景资料。']) {
+      if (!await inboxPage.getByText(content, { exact: true }).first().isVisible()) failures.push(`Inbox content missing ${content}`)
+    }
+    if (await inboxPage.getByRole('button', { name: '确认创建', exact: true }).count() !== 1) {
+      failures.push('Inbox page must render exactly one 确认创建 action')
+    }
+    const firstInboxRow = inboxPage.locator('.mail-item', { hasText: '整理客户访谈' })
+    const secondInboxRow = inboxPage.locator('.mail-item', { hasText: '项目复盘记录' })
+    await inboxPage.getByRole('button', { name: '分析内容', exact: true }).click()
+    await secondInboxRow.click()
+    await page.waitForTimeout(300)
+    if (await inboxPage.getByRole('checkbox').count() !== 0) {
+      failures.push('a stale analysis response must not attach the previous item drafts to the newly selected Inbox item')
+    }
+    await firstInboxRow.click()
+    await inboxPage.getByRole('button', { name: '分析内容', exact: true }).click()
+    await inboxPage.getByRole('checkbox').first().waitFor({ state: 'attached', timeout: 2000 }).catch(() => {})
+    if (inboxAnalyzeRequests.length !== 2 || inboxConfirmRequests.length !== 0) {
+      failures.push('analysis must load drafts without invoking confirmation writes')
+    }
+    if (await inboxPage.getByRole('checkbox').count() !== 3) {
+      failures.push('analysis must render one checkbox for each saved suggestion')
+    }
+    const sourceSuggestionCheckbox = inboxPage.locator('.arco-checkbox', { hasText: '访谈背景资料' })
+    await sourceSuggestionCheckbox.click()
+    if (await sourceSuggestionCheckbox.locator('input[type="checkbox"]').isChecked()) {
+      failures.push('suggestion checkbox must allow the user to exclude a draft before confirmation')
+    }
+
+    const confirmButton = inboxPage.getByRole('button', { name: '确认创建', exact: true })
+    expectingInboxConfirmError = true
+    await confirmButton.click()
+    await page.waitForTimeout(50)
+    if (!await confirmButton.evaluate((button) => button.classList.contains('arco-btn-loading'))) {
+      failures.push('Inbox confirmation must show loading while the write is pending')
+    }
+    await page.waitForTimeout(300)
+    if (!await inboxPage.getByText('确认创建失败，请稍后重试', { exact: true }).isVisible()) {
+      failures.push('failed Inbox confirmation must show the API Chinese error')
+    }
+    expectingInboxConfirmError = false
+    if (expectedInboxConfirmConsoleErrorCount !== 1) {
+      failures.push(`expected one simulated Inbox confirm console error, got ${expectedInboxConfirmConsoleErrorCount}`)
+    }
+
+    const workspaceRequestCount = workspaceRequests.length
+    await confirmButton.click()
+    await inboxPage.getByText('已创建 2 个对象', { exact: true }).waitFor({ state: 'visible', timeout: 2000 }).catch(() => {})
+    if (!await inboxPage.getByText('已创建 2 个对象', { exact: true }).isVisible()) {
+      failures.push('successful Inbox confirmation must show the created object count')
+    }
+    const submitted = inboxConfirmRequests.at(-1)?.suggestionIds ?? []
+    if (JSON.stringify(submitted) !== JSON.stringify([inboxTaskSuggestionId, inboxNoteSuggestionId])) {
+      failures.push(`Inbox confirm must send only checked saved suggestion identities, got ${JSON.stringify(submitted)}`)
+    }
+    if (workspaceRequests.length <= workspaceRequestCount) {
+      failures.push('successful Inbox confirmation must refresh the project workspace')
+    }
+    await page.screenshot({ path: 'test-results/project-inbox-confirmed.png', fullPage: true })
+    await page.setViewportSize({ width: 390, height: 844 })
+    await page.waitForTimeout(250)
+    await page.screenshot({ path: 'test-results/project-inbox-confirmed-mobile.png', fullPage: true })
+    const inboxMobileLayout = await inboxPage.evaluate((node) => {
+      const workflow = node.querySelector('.mail-layout')
+      const detail = node.querySelector('.inbox-detail')
+      const detailRight = detail?.getBoundingClientRect().right ?? node.getBoundingClientRect().right
+      const clippedDetailLabels = [...node.querySelectorAll('.inbox-detail-head > div > .arco-typography-secondary, .inbox-draft-section .section-header > .arco-typography-secondary')]
+        .filter((label) => label.getBoundingClientRect().right > detailRight + 1)
+        .map((label) => label.textContent?.trim())
+      return {
+        pageOverflow: node.scrollWidth > node.clientWidth,
+        workflowOverflow: workflow ? workflow.scrollWidth > workflow.clientWidth : true,
+        clippedDetailLabels,
+      }
+    })
+    if (inboxMobileLayout.pageOverflow || inboxMobileLayout.workflowOverflow || inboxMobileLayout.clippedDetailLabels.length) {
+      failures.push(`Inbox confirmation page must stack without mobile horizontal overflow, got ${JSON.stringify(inboxMobileLayout)}`)
+    }
+    await page.setViewportSize({ width: 1440, height: 1024 })
+
+    await secondInboxRow.click()
+    await inboxPage.getByRole('button', { name: '分析内容', exact: true }).click()
+    await inboxPage.getByRole('checkbox').first().waitFor({ state: 'attached', timeout: 2000 }).catch(() => {})
+    expectingInboxRefreshError = true
+    const secondConfirmButton = inboxPage.getByRole('button', { name: '确认创建', exact: true })
+    await secondConfirmButton.click()
+    await inboxPage.getByText('已创建 3 个对象', { exact: true }).waitFor({ state: 'visible', timeout: 2000 }).catch(() => {})
+    if (!await inboxPage.getByText('已创建 3 个对象', { exact: true }).isVisible()) {
+      failures.push('a completed confirmation must preserve its created count when workspace refresh fails')
+    }
+    if (!await inboxPage.getByText('对象已创建，但工作区刷新失败，请稍后重新进入项目', { exact: true }).isVisible()) {
+      failures.push('workspace refresh failure after confirmation must be shown separately in Chinese')
+    }
+    if (!await secondConfirmButton.isDisabled()) {
+      failures.push('a confirmed item must remain non-repeatable when its workspace refresh fails')
+    }
+    expectingInboxRefreshError = false
+    if (expectedInboxRefreshConsoleErrorCount !== 1) {
+      failures.push(`expected one simulated Inbox refresh console error, got ${expectedInboxRefreshConsoleErrorCount}`)
+    }
+    await page.screenshot({ path: 'test-results/project-inbox-refresh-warning.png', fullPage: true })
+  }
+}
+
 const channelPageChecks = []
 for (const channel of [
  { label: '工作计划', pageClass: 'project-tasks-page', expectedHeading: '工作计划' },
--- a/apps/web_v1/src/App.css
+++ b/apps/web_v1/src/App.css
@@ -1421,6 +1421,99 @@
  text-overflow: ellipsis;
 }

+.inbox-detail .arco-card-body {
+  display: grid;
+  align-content: start;
+  gap: var(--space-4);
+}
+
+.inbox-detail-head,
+.inbox-confirm-bar {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: var(--space-3);
+}
+
+.inbox-detail-head h5,
+.inbox-draft-section h6 {
+  margin: 0;
+}
+
+.inbox-content,
+.inbox-draft-section {
+  display: grid;
+  gap: var(--space-2);
+  border-top: 1px solid var(--color-border);
+  padding-top: var(--space-3);
+}
+
+.inbox-content p {
+  margin: 0;
+  color: var(--color-text);
+  line-height: 1.7;
+}
+
+.inbox-section-label {
+  font-weight: 700;
+}
+
+.inbox-suggestion-list {
+  display: grid;
+  gap: var(--space-2);
+}
+
+.inbox-suggestion-list .arco-checkbox {
+  width: 100%;
+  align-items: flex-start;
+  border: 1px solid var(--color-border);
+  border-radius: var(--radius-control);
+  padding: 10px 12px;
+}
+
+.inbox-suggestion-copy {
+  min-width: 0;
+  display: grid;
+  gap: 5px;
+}
+
+.inbox-suggestion-copy > span:first-child {
+  display: flex;
+  align-items: center;
+  gap: var(--space-2);
+}
+
+.inbox-feedback {
+  margin: 0;
+}
+
+.inbox-confirm-bar {
+  align-items: center;
+  border-top: 1px solid var(--color-border);
+  padding-top: var(--space-3);
+}
+
+@media (max-width: 960px) {
+  .inbox-workspace {
+    grid-template-columns: minmax(0, 1fr);
+  }
+}
+
+@media (max-width: 560px) {
+  .project-inbox-page .overview-head,
+  .inbox-detail-head,
+  .inbox-confirm-bar {
+    align-items: stretch;
+    flex-direction: column;
+  }
+
+  .inbox-detail-head .arco-btn,
+  .inbox-confirm-bar .arco-btn {
+    width: 100%;
+    min-height: 40px;
+  }
+}
+
 .agent-chat-shell {
  min-height: calc(100vh - 170px);
  display: grid;
--- a/apps/web_v1/src/api/inbox.ts
+++ b/apps/web_v1/src/api/inbox.ts
@@ -12,6 +12,7 @@ export type InboxItemDTO = {
 }

 export type InboxSuggestionDTO = {
+  id: string
  kind: 'task' | 'note' | 'source'
  title: string
  body: string
@@ -21,6 +22,10 @@ export type AnalyzeInboxResponseDTO = {
  suggestions: InboxSuggestionDTO[]
 }

+export type ConfirmInboxResponseDTO = {
+  createdCount: number
+}
+
 export type CaptureInboxInput = {
  sourceType: string
  title: string
@@ -42,11 +47,10 @@ export async function analyzeInboxItem(session: ApiSession, inboxId: string) {
  })
 }

-export async function confirmInboxItem(session: ApiSession, inboxId: string, suggestions: InboxSuggestionDTO[]) {
-  return apiRequest<void>(`/api/v1/inbox/${inboxId}/confirm`, {
+export async function confirmInboxItem(session: ApiSession, inboxId: string, suggestionIds: string[]) {
+  return apiRequest<ConfirmInboxResponseDTO>(`/api/v1/inbox/${inboxId}/confirm`, {
    method: 'POST',
    token: session.token,
-    body: { suggestions },
-    responseType: 'void',
+    body: { suggestionIds },
  })
 }
--- a/apps/web_v1/src/api/mappers.tsx
+++ b/apps/web_v1/src/api/mappers.tsx
@@ -28,7 +28,7 @@ export function mapWorkspace(payload: ProjectWorkspaceDTO, index = 0): ProjectWo

  return {
    project,
-    channels: payload.channels.filter((channel) => channel.type !== 'inbox').map(mapChannel),
+    channels: payload.channels.map(mapChannel),
    tags: payload.tags.map((tag) => tag.name),
    recentSessions: payload.recentSessions.map(mapAISession),
    inbox: payload.inbox.map(mapInbox),
--- a/apps/web_v1/src/app/App.tsx
+++ b/apps/web_v1/src/app/App.tsx
@@ -3,6 +3,7 @@ import { ConfigProvider, Message, Spin } from '@arco-design/web-react'
 import '@arco-design/web-react/dist/css/arco.css'
 import '../App.css'
 import { login, setApiBaseUrl, type ApiSession } from '../api/client'
+import { analyzeInboxItem, confirmInboxItem } from '../api/inbox'
 import { mapWorkspace } from '../api/mappers'
 import {
  createCronPlan,
@@ -229,6 +230,24 @@ function App() {
    Message.success('项目设置已更新')
  }

+  async function handleAnalyzeInbox(inboxId: string) {
+    const response = await analyzeInboxItem(requireSession(), inboxId)
+    return response.suggestions
+  }
+
+  async function handleConfirmInbox(inboxId: string, suggestionIds: string[]) {
+    const response = await confirmInboxItem(requireSession(), inboxId, suggestionIds)
+    try {
+      await refreshAfterAction()
+      return { createdCount: response.createdCount }
+    } catch {
+      return {
+        createdCount: response.createdCount,
+        refreshError: '对象已创建，但工作区刷新失败，请稍后重新进入项目',
+      }
+    }
+  }
+
  function handleSelectSearchResult(result: SearchResultDTO) {
    const target = searchResultTarget(result.type)
    if (!target) {
@@ -296,6 +315,8 @@ function App() {
            onSearchQueryChange={workspaceSearch.onQueryChange}
            onSearch={() => void workspaceSearch.onSearch()}
            onSelectSearchResult={handleSelectSearchResult}
+            onAnalyzeInbox={handleAnalyzeInbox}
+            onConfirmInbox={handleConfirmInbox}
          />
        ) : (
          <Spin loading />
--- a/apps/web_v1/src/pages/projects/project-channel-page.tsx
+++ b/apps/web_v1/src/pages/projects/project-channel-page.tsx
@@ -1,11 +1,13 @@
 import { ProjectAi } from './project-ai'
 import { ProjectCron } from './project-cron'
+import { ProjectInbox } from './project-inbox'
 import { ProjectNewChannel } from './project-new-channel'
 import { ProjectNotes } from './project-notes'
 import { ProjectOverview } from './project-overview'
 import type { ProjectTaskUpdate } from './project-task-edit-modal'
 import { ProjectTasks } from './project-tasks'
-import type { ChannelKey, ProjectWorkspace } from './project-types'
+import type { ChannelKey, InboxConfirmationOutcome, ProjectWorkspace } from './project-types'
+import type { InboxSuggestionDTO } from '../../api/inbox'

 export function ProjectChannelPage({
  activeChannel,
@@ -19,6 +21,8 @@ export function ProjectChannelPage({
  onCreateCronPlan,
  onCreateProjectTag,
  onUpdateTask,
+  onAnalyzeInbox,
+  onConfirmInbox,
 }: {
  activeChannel: ChannelKey
  activeWorkspace: ProjectWorkspace
@@ -31,8 +35,12 @@ export function ProjectChannelPage({
  onCreateCronPlan: () => void
  onCreateProjectTag: (name: string) => void
  onUpdateTask: (update: ProjectTaskUpdate) => void
+  onAnalyzeInbox: (inboxId: string) => Promise<InboxSuggestionDTO[]>
+  onConfirmInbox: (inboxId: string, suggestionIds: string[]) => Promise<InboxConfirmationOutcome>
 }) {
  switch (activeChannel) {
+    case 'inbox':
+      return <ProjectInbox key={activeWorkspace.project.id} activeWorkspace={activeWorkspace} onAnalyze={onAnalyzeInbox} onConfirm={onConfirmInbox} />
    case 'tasks':
      return <ProjectTasks activeWorkspace={activeWorkspace} activeTaskID={activeTaskID} onOpenTask={onOpenTask} onCloseTask={onCloseTask} onSelectItem={onSelectItem} onCreateTask={onCreateTask} onCreateProjectTag={onCreateProjectTag} onUpdateTask={onUpdateTask} />
    case 'ai':
--- a/apps/web_v1/src/pages/projects/project-inbox.tsx
+++ b/apps/web_v1/src/pages/projects/project-inbox.tsx
@@ -0,0 +1,223 @@
+import { useMemo, useRef, useState } from 'react'
+import { Alert, Button, Card, Checkbox, Empty, Space, Tag, Typography } from '@arco-design/web-react'
+import { IconCheckCircle, IconRobot } from '@arco-design/web-react/icon'
+import type { InboxSuggestionDTO } from '../../api/inbox'
+import type { InboxConfirmationOutcome, InboxItem, ProjectWorkspace } from './project-types'
+
+const { Title, Text, Paragraph } = Typography
+
+type ProjectInboxProps = {
+  activeWorkspace: ProjectWorkspace
+  onAnalyze: (inboxId: string) => Promise<InboxSuggestionDTO[]>
+  onConfirm: (inboxId: string, suggestionIds: string[]) => Promise<InboxConfirmationOutcome>
+}
+
+export function ProjectInbox({ activeWorkspace, onAnalyze, onConfirm }: ProjectInboxProps) {
+  const [selectedItemId, setSelectedItemId] = useState(activeWorkspace.inbox[0]?.id ?? '')
+  const [draftSuggestions, setDraftSuggestions] = useState<InboxSuggestionDTO[]>([])
+  const [selectedSuggestionIds, setSelectedSuggestionIds] = useState<string[]>([])
+  const [analyzing, setAnalyzing] = useState(false)
+  const [confirming, setConfirming] = useState(false)
+  const [error, setError] = useState('')
+  const [success, setSuccess] = useState('')
+  const [refreshWarning, setRefreshWarning] = useState('')
+  const [locallyConfirmedItemIds, setLocallyConfirmedItemIds] = useState<string[]>([])
+  const analysisGeneration = useRef(0)
+  const selectedItem = useMemo(
+    () => activeWorkspace.inbox.find((item) => item.id === selectedItemId) ?? activeWorkspace.inbox[0],
+    [activeWorkspace.inbox, selectedItemId],
+  )
+
+  function selectItem(item: InboxItem) {
+    analysisGeneration.current += 1
+    setSelectedItemId(item.id)
+    setDraftSuggestions([])
+    setSelectedSuggestionIds([])
+    setError('')
+    setSuccess('')
+    setRefreshWarning('')
+    setAnalyzing(false)
+  }
+
+  async function analyzeSelectedItem() {
+    if (!selectedItem || selectedItem.status !== 'open') return
+    setAnalyzing(true)
+    setError('')
+    setSuccess('')
+    setRefreshWarning('')
+    const generation = analysisGeneration.current + 1
+    analysisGeneration.current = generation
+    const analyzedItemId = selectedItem.id
+    try {
+      const suggestions = await onAnalyze(analyzedItemId)
+      if (analysisGeneration.current !== generation || selectedItemId !== analyzedItemId) return
+      setDraftSuggestions(suggestions)
+      setSelectedSuggestionIds(suggestions.map((suggestion) => suggestion.id))
+    } catch (reason) {
+      if (analysisGeneration.current !== generation) return
+      setError(reason instanceof Error ? reason.message : '分析失败，请稍后重试')
+    } finally {
+      if (analysisGeneration.current === generation) setAnalyzing(false)
+    }
+  }
+
+  async function confirmSelectedSuggestions() {
+    if (!selectedItem) return
+    if (selectedSuggestionIds.length === 0) {
+      setError('请至少勾选一条建议')
+      return
+    }
+    setConfirming(true)
+    setError('')
+    setSuccess('')
+    try {
+      const outcome = await onConfirm(selectedItem.id, selectedSuggestionIds)
+      setLocallyConfirmedItemIds((current) => current.includes(selectedItem.id) ? current : [...current, selectedItem.id])
+      setSuccess(`已创建 ${outcome.createdCount} 个对象`)
+      setRefreshWarning(outcome.refreshError ?? '')
+    } catch (reason) {
+      setError(reason instanceof Error ? reason.message : '确认创建失败，请稍后重试')
+    } finally {
+      setConfirming(false)
+    }
+  }
+
+  function toggleSuggestion(identity: string, checked: boolean) {
+    setSelectedSuggestionIds((current) => checked
+      ? current.includes(identity) ? current : [...current, identity]
+      : current.filter((value) => value !== identity))
+  }
+
+  return (
+    <div className="project-channel-page project-inbox-page overview-page">
+      <div className="overview-head">
+        <div>
+          <Title heading={4}>Inbox 消息流</Title>
+          <Text type="secondary">查看原始内容，分析为候选草稿，并在确认后创建正式对象。</Text>
+        </div>
+      </div>
+
+      {activeWorkspace.inbox.length === 0 ? (
+        <Card className="queue-section" bordered>
+          <Empty description="当前没有待处理的 Inbox 内容" />
+        </Card>
+      ) : (
+        <div className="mail-layout inbox-workspace">
+          <Card className="queue-section mail-list" bordered>
+            <div className="section-header">
+              <Title heading={6}>收集内容（{activeWorkspace.inbox.length}）</Title>
+            </div>
+            {activeWorkspace.inbox.map((item) => (
+              <button
+                key={item.id}
+                type="button"
+                className={selectedItem?.id === item.id ? 'mail-item active' : 'mail-item'}
+                disabled={confirming}
+                onClick={() => selectItem(item)}
+              >
+                <span>{item.title}</span>
+                <Text type="secondary" ellipsis={{ showTooltip: true }}>{item.summary || '暂无内容'}</Text>
+                <div>
+                  <Tag color={isInboxItemProcessed(item, locallyConfirmedItemIds) ? 'green' : 'orange'}>{isInboxItemProcessed(item, locallyConfirmedItemIds) ? '已处理' : '待处理'}</Tag>
+                  <time>{item.time}</time>
+                </div>
+              </button>
+            ))}
+          </Card>
+
+          <Card className="queue-section mail-detail inbox-detail" bordered>
+            {selectedItem ? (
+              <>
+                <div className="inbox-detail-head">
+                  <div>
+                    <Space size={8}>
+                      <Title heading={5}>{selectedItem.title}</Title>
+                      <Tag color={isInboxItemProcessed(selectedItem, locallyConfirmedItemIds) ? 'green' : 'orange'}>
+                        {isInboxItemProcessed(selectedItem, locallyConfirmedItemIds) ? '已处理' : '待处理'}
+                      </Tag>
+                    </Space>
+                    <Text type="secondary">{selectedItem.meta} · {selectedItem.time}</Text>
+                  </div>
+                  <Button
+                    icon={<IconRobot />}
+                    loading={analyzing}
+                    disabled={confirming || isInboxItemProcessed(selectedItem, locallyConfirmedItemIds)}
+                    onClick={() => void analyzeSelectedItem()}
+                  >
+                    分析内容
+                  </Button>
+                </div>
+
+                <section className="inbox-content" aria-label="Inbox 原始内容">
+                  <Text className="inbox-section-label">原始内容</Text>
+                  <Paragraph>{selectedItem.summary || '暂无内容'}</Paragraph>
+                </section>
+
+                <section className="inbox-draft-section" aria-label="分析建议">
+                  <div className="section-header">
+                    <Title heading={6}>分析建议</Title>
+                    <Text type="secondary">仅勾选内容会在确认后创建</Text>
+                  </div>
+                  {draftSuggestions.length === 0 ? (
+                    <Text type="secondary">点击“分析内容”生成候选草稿，分析不会创建正式对象。</Text>
+                  ) : (
+                    <div className="inbox-suggestion-list">
+                      {draftSuggestions.map((suggestion) => (
+                        <Checkbox
+                          key={suggestion.id}
+                          checked={selectedSuggestionIds.includes(suggestion.id)}
+                          disabled={confirming || isInboxItemProcessed(selectedItem, locallyConfirmedItemIds)}
+                          onChange={(checked) => toggleSuggestion(suggestion.id, checked)}
+                        >
+                          <span className="inbox-suggestion-copy">
+                            <span>
+                              <Tag color={suggestionColor(suggestion.kind)}>{suggestionLabel(suggestion.kind)}</Tag>
+                              <strong>{suggestion.title}</strong>
+                            </span>
+                            <Text type="secondary">{suggestion.body || '暂无补充内容'}</Text>
+                          </span>
+                        </Checkbox>
+                      ))}
+                    </div>
+                  )}
+                </section>
+
+                {error && <Alert className="inbox-feedback" type="error" content={error} />}
+                {success && <Alert className="inbox-feedback" type="success" content={success} icon={<IconCheckCircle />} />}
+                {refreshWarning && <Alert className="inbox-feedback" type="warning" content={refreshWarning} />}
+
+                <div className="inbox-confirm-bar">
+                  <Text type="secondary">正式写入前请核对勾选项</Text>
+                  <Button
+                    type="primary"
+                    loading={confirming}
+                    disabled={analyzing || isInboxItemProcessed(selectedItem, locallyConfirmedItemIds) || draftSuggestions.length === 0}
+                    onClick={() => void confirmSelectedSuggestions()}
+                  >
+                    确认创建
+                  </Button>
+                </div>
+              </>
+            ) : null}
+          </Card>
+        </div>
+      )}
+    </div>
+  )
+}
+
+function isInboxItemProcessed(item: InboxItem, locallyConfirmedItemIds: string[]) {
+  return item.status !== 'open' || locallyConfirmedItemIds.includes(item.id)
+}
+
+function suggestionLabel(kind: InboxSuggestionDTO['kind']) {
+  if (kind === 'task') return '任务'
+  if (kind === 'note') return '笔记'
+  return '资料'
+}
+
+function suggestionColor(kind: InboxSuggestionDTO['kind']) {
+  if (kind === 'task') return 'arcoblue'
+  if (kind === 'note') return 'green'
+  return 'purple'
+}
--- a/apps/web_v1/src/pages/projects/project-types.ts
+++ b/apps/web_v1/src/pages/projects/project-types.ts
@@ -39,6 +39,11 @@ export type InboxItem = {
  status: string
 }

+export type InboxConfirmationOutcome = {
+  createdCount: number
+  refreshError?: string
+}
+
 export type TaskItem = {
  id: string
  title: string
--- a/apps/web_v1/src/pages/workspace-home.tsx
+++ b/apps/web_v1/src/pages/workspace-home.tsx
@@ -9,7 +9,8 @@ import { ProjectSidebar, type ProjectSettingsUpdate } from './projects/project-s
 import { ProjectStatusbar } from './projects/project-statusbar'
 import { ProjectTopbar } from './projects/project-topbar'
 import type { SearchResultDTO } from '../api/search'
-import type { ChannelKey, Project, ProjectWorkspace, Theme, WorkbenchView } from './projects/project-types'
+import type { InboxSuggestionDTO } from '../api/inbox'
+import type { ChannelKey, InboxConfirmationOutcome, Project, ProjectWorkspace, Theme, WorkbenchView } from './projects/project-types'

 const { Content } = Layout

@@ -42,6 +43,8 @@ export function ProjectPage({
  onSearchQueryChange,
  onSearch,
  onSelectSearchResult,
+  onAnalyzeInbox,
+  onConfirmInbox,
 }: {
  activeView: WorkbenchView
  activeWorkspace: ProjectWorkspace
@@ -71,6 +74,8 @@ export function ProjectPage({
  onSearchQueryChange: (value: string) => void
  onSearch: () => void
  onSelectSearchResult: (result: SearchResultDTO) => void
+  onAnalyzeInbox: (inboxId: string) => Promise<InboxSuggestionDTO[]>
+  onConfirmInbox: (inboxId: string, suggestionIds: string[]) => Promise<InboxConfirmationOutcome>
 }) {
  const isProject = activeView === 'project'
  const [navOpen, setNavOpen] = useState<'projects' | 'channels' | null>(null)
@@ -152,6 +157,8 @@ export function ProjectPage({
              onCreateCronPlan={onCreateCronPlan}
              onCreateProjectTag={onCreateProjectTag}
              onUpdateTask={updateActiveProjectTask}
+              onAnalyzeInbox={onAnalyzeInbox}
+              onConfirmInbox={onConfirmInbox}
            />
          )}
        </Content>