diff --git a/vscode/webview-ui/src/App.tsx b/vscode/webview-ui/src/App.tsx
index 2272bde..bea94a2 100644
--- a/vscode/webview-ui/src/App.tsx
+++ b/vscode/webview-ui/src/App.tsx
@@ -13,6 +13,7 @@ import { ToastStack } from './components/ToastStack'
 import { useIssues } from './hooks/useIssues'
 import { useManagedSessions } from './hooks/useManagedSessions'
 import { useProfiles } from './hooks/useProfiles'
+import { filterIssues } from './lib/issueFilter'
 import { compareIssuesInColumn } from './lib/issueSort'
 import { COLUMN_ORDER } from './types'
 
@@ -127,6 +128,9 @@ export function App() {
     setShowNewIssueModal(false)
   }
 
+  // 顶部筛选框内容。纯前端过滤，不影响拖拽与详情面板拿到的全量列表。
+  const [filterQuery, setFilterQuery] = useState('')
+
   // Drop selectedId if it's no longer present after issues refresh.
   const readyIssues = state.status === 'ready' ? state.issues : null
   useEffect(() => {
@@ -153,13 +157,15 @@ export function App() {
 
   // Issues partitioned by column, in COLUMN_ORDER. Used for arrow navigation.
   // 排序与看板视觉一致：完成列按 PR 合并时间降序，其余列按工单号降序。
+  // 键盘导航只在筛选后可见的卡片之间走，和看板显示保持一致。
   const ordered = useMemo<Issue[][]>(() => {
     if (!readyIssues)
       return []
+    const visible = filterIssues(readyIssues, filterQuery)
     return COLUMN_ORDER.map(col =>
-      readyIssues.filter(i => i.column === col).sort((a, b) => compareIssuesInColumn(col, a, b)),
+      visible.filter(i => i.column === col).sort((a, b) => compareIssuesInColumn(col, a, b)),
     )
-  }, [readyIssues])
+  }, [readyIssues, filterQuery])
 
   // Resolved selected issue (or null) for the detail panel.
   const selectedIssue = useMemo<Issue | null>(() => {
@@ -312,6 +318,8 @@ export function App() {
       {state.status === 'loading' && (
         <>
           <PanelHeader
+            filterQuery={filterQuery}
+            onFilterChange={setFilterQuery}
             onRefresh={refresh}
             refreshing={refreshing}
             scope={scope}
@@ -339,6 +347,8 @@ export function App() {
       {state.status === 'ready' && (
         <>
           <PanelHeader
+            filterQuery={filterQuery}
+            onFilterChange={setFilterQuery}
             onRefresh={refresh}
             refreshing={refreshing}
             scope={scope}
@@ -361,6 +371,7 @@ export function App() {
             <div className="min-h-0 flex-1 overflow-hidden">
               <KanbanBoard
                 issues={state.issues}
+                filterQuery={filterQuery}
                 onIssuesChange={setIssues}
                 onCreateIssue={() => setShowNewIssueModal(true)}
                 selectedId={selectedId}
@@ -445,6 +456,8 @@ export function App() {
       {state.status === 'error' && (
         <>
           <PanelHeader
+            filterQuery={filterQuery}
+            onFilterChange={setFilterQuery}
             onRefresh={refresh}
             refreshing={refreshing}
             scope={scope}
diff --git a/vscode/webview-ui/src/components/KanbanBoard.tsx b/vscode/webview-ui/src/components/KanbanBoard.tsx
index a6408fa..d0ef0f5 100644
--- a/vscode/webview-ui/src/components/KanbanBoard.tsx
+++ b/vscode/webview-ui/src/components/KanbanBoard.tsx
@@ -19,6 +19,7 @@ import {
 import { useEffect, useMemo, useRef, useState } from 'react'
 import { isIssueMine, issueOwnerLogin } from '@/lib/issueOwnership'
 import { isIssueLocked } from '../lib/dependencies'
+import { filterIssues } from '../lib/issueFilter'
 import { compareIssuesInColumn } from '../lib/issueSort'
 import { isColumnId, resolveKanbanDrag } from '../lib/kanbanDrag'
 import { COLUMN_ORDER } from '../types'
@@ -27,6 +28,11 @@ import { KanbanColumn } from './KanbanColumn'
 
 interface KanbanBoardProps {
   issues: Issue[]
+  /**
+   * 顶部筛选框内容。只收窄渲染出来的卡片；拖拽、依赖锁定仍按 `issues`
+   * 全量算，免得筛选期间的一次拖动把被隐藏的工单从列表里抹掉。
+   */
+  filterQuery?: string
   onIssuesChange: (next: Issue[]) => void
   /** Renders the + button on the todo column when provided. */
   onCreateIssue?: () => void
@@ -103,6 +109,7 @@ function buildTodoTree(todoIssues: Issue[]): Array<{ issue: Issue, depth: number
 
 export function KanbanBoard({
   issues,
+  filterQuery = '',
   onIssuesChange,
   onCreateIssue,
   selectedId,
@@ -127,7 +134,7 @@ export function KanbanBoard({
       'review': [],
       'done': [],
     }
-    for (const issue of issues)
+    for (const issue of filterIssues(issues, filterQuery))
       map[issue.column].push(issue)
     // 各列排序：完成列按 PR 合并时间降序（最近合并在最前），其余列按 issue.number
     // 降序让新工单置顶。todo 列的降序顺序同时是 `buildTodoTree` 的输入顺序——它按
@@ -135,6 +142,14 @@ export function KanbanBoard({
     for (const col of Object.keys(map) as IssueColumn[])
       map[col].sort((a, b) => compareIssuesInColumn(col, a, b))
     return map
+  }, [issues, filterQuery])
+
+  // 未筛选时的每列总数，供列头角标显示「可见 / 总数」。
+  const totalByColumn = useMemo(() => {
+    const map: Record<IssueColumn, number> = { 'todo': 0, 'in-progress': 0, 'review': 0, 'done': 0 }
+    for (const issue of issues)
+      map[issue.column] += 1
+    return map
   }, [issues])
 
   const activeIssue = activeId ? issues.find(i => i.id === activeId) ?? null : null
@@ -240,6 +255,7 @@ export function KanbanBoard({
               key={column}
               column={column}
               issues={columnIssues}
+              totalCount={totalByColumn[column]}
               onCreate={column === 'todo' ? onCreateIssue : undefined}
             >
               <SortableContext items={ids} strategy={verticalListSortingStrategy}>
diff --git a/vscode/webview-ui/src/components/KanbanColumn.tsx b/vscode/webview-ui/src/components/KanbanColumn.tsx
index 3fde9d3..c58c389 100644
--- a/vscode/webview-ui/src/components/KanbanColumn.tsx
+++ b/vscode/webview-ui/src/components/KanbanColumn.tsx
@@ -9,12 +9,15 @@ import { Badge } from './ui/badge'
 interface KanbanColumnProps {
   column: IssueColumn
   issues: Issue[]
+  /** 该列未经筛选的卡片总数。与 `issues.length` 不等时角标显示「可见 / 总数」。 */
+  totalCount?: number
   children: ReactNode
   /** When provided, renders a + button in the header. Used for the todo column. */
   onCreate?: () => void
 }
 
-export function KanbanColumn({ column, issues, children, onCreate }: KanbanColumnProps) {
+export function KanbanColumn({ column, issues, totalCount, children, onCreate }: KanbanColumnProps) {
+  const filtered = totalCount !== undefined && totalCount !== issues.length
   const { setNodeRef, isOver } = useDroppable({ id: column })
 
   return (
@@ -31,7 +34,7 @@ export function KanbanColumn({ column, issues, children, onCreate }: KanbanColum
           {COLUMN_LABELS[column]}
         </span>
         <div className="flex items-center gap-1.5">
-          <Badge variant="outline">{issues.length}</Badge>
+          <Badge variant="outline">{filtered ? `${issues.length} / ${totalCount}` : issues.length}</Badge>
           {onCreate && (
             <button
               type="button"
@@ -49,7 +52,7 @@ export function KanbanColumn({ column, issues, children, onCreate }: KanbanColum
         {issues.length === 0
           ? (
               <div className="flex flex-1 items-center justify-center rounded-md border border-dashed border-[var(--vscode-foreground)] border-opacity-20 p-4 text-xs text-muted-foreground opacity-60">
-                拖到这里
+                {filtered ? '没有匹配的工单' : '拖到这里'}
               </div>
             )
           : (
diff --git a/vscode/webview-ui/src/components/PanelHeader.tsx b/vscode/webview-ui/src/components/PanelHeader.tsx
index 7ba593c..05b04ff 100644
--- a/vscode/webview-ui/src/components/PanelHeader.tsx
+++ b/vscode/webview-ui/src/components/PanelHeader.tsx
@@ -1,8 +1,11 @@
 import type { ReleaseAction, ReleaseStatus } from '../hooks/useIssues'
-import { GitCommit, ListPlus, Loader2, Lock, RefreshCw, Rocket, Settings, Unlock, User, Users } from 'lucide-react'
+import { GitCommit, ListPlus, Loader2, Lock, RefreshCw, Rocket, Search, Settings, Unlock, User, Users, X } from 'lucide-react'
 import { useEffect, useRef, useState } from 'react'
 
 interface Props {
+  /** 顶部筛选框当前内容；按标题 / 工单号 / PR 号过滤看板卡片。 */
+  filterQuery: string
+  onFilterChange: (query: string) => void
   onRefresh: () => void
   /** host 正在重拉看板；为 true 时刷新图标转起来。 */
   refreshing: boolean
@@ -66,6 +69,8 @@ function releaseTitle(release: ReleaseStatus | undefined): string {
 }
 
 export function PanelHeader({
+  filterQuery,
+  onFilterChange,
   onRefresh,
   refreshing,
   scope,
@@ -113,7 +118,35 @@ export function PanelHeader({
   }
 
   return (
-    <div className="flex h-8 shrink-0 items-center justify-end gap-1 border-b border-[var(--vscode-panel-border)] px-2">
+    <div className="flex h-8 shrink-0 items-center gap-1 border-b border-[var(--vscode-panel-border)] px-2">
+      <div className="relative mr-auto flex items-center">
+        <Search size={12} className="pointer-events-none absolute left-2 opacity-60" />
+        <input
+          type="text"
+          value={filterQuery}
+          onChange={e => onFilterChange(e.target.value)}
+          onKeyDown={(e) => {
+            if (e.key === 'Escape') {
+              e.stopPropagation()
+              onFilterChange('')
+            }
+          }}
+          placeholder="筛选：标题 / 工单号 / PR 号"
+          aria-label="筛选工单"
+          className="h-6 w-56 rounded border border-[var(--vscode-input-border,transparent)] bg-[var(--vscode-input-background)] pl-6 pr-6 text-xs text-[var(--vscode-input-foreground)] outline-none placeholder:text-[var(--vscode-input-placeholderForeground)] focus:border-[var(--vscode-focusBorder)]"
+        />
+        {filterQuery !== '' && (
+          <button
+            type="button"
+            onClick={() => onFilterChange('')}
+            title="清空筛选"
+            aria-label="清空筛选"
+            className="absolute right-1 flex h-4 w-4 items-center justify-center rounded hover:bg-[var(--vscode-toolbar-hoverBackground)]"
+          >
+            <X size={11} />
+          </button>
+        )}
+      </div>
       <div ref={menuRef} className="relative">
         <button
           type="button"
diff --git a/vscode/webview-ui/src/lib/issueFilter.test.ts b/vscode/webview-ui/src/lib/issueFilter.test.ts
new file mode 100644
index 0000000..3f3912a
--- /dev/null
+++ b/vscode/webview-ui/src/lib/issueFilter.test.ts
@@ -0,0 +1,60 @@
+import type { Issue } from '../types'
+import { describe, expect, it } from 'vitest'
+import { filterIssues } from './issueFilter'
+
+function issue(number: number, title: string, extra: Partial<Issue> = {}): Issue {
+  return {
+    id: `repo#${number}`,
+    number,
+    title,
+    column: 'todo',
+    htmlUrl: '',
+    ...extra,
+  }
+}
+
+const board = [
+  issue(426, '编程大赛：报名与提交作品'),
+  issue(427, '编程大赛-作品墙分类', { pr: '318' }),
+  issue(419, '管理后台统计各模型用量'),
+  issue(42, 'auto 模型：自动为用户会话选模型'),
+]
+
+function numbers(query: string): number[] {
+  return filterIssues(board, query).map(i => i.number)
+}
+
+describe('filterIssues', () => {
+  it('空查询放行全部，且原样返回同一个数组', () => {
+    expect(filterIssues(board, '   ')).toBe(board)
+  })
+
+  it('按标题子串匹配', () => {
+    expect(numbers('作品')).toEqual([426, 427])
+  })
+
+  it('标题匹配不区分大小写', () => {
+    expect(numbers('AUTO')).toEqual([42])
+  })
+
+  it('按工单号匹配，带不带 # 都行', () => {
+    expect(numbers('#427')).toEqual([427])
+    expect(numbers('427')).toEqual([427])
+  })
+
+  it('数字按包含匹配，短号能带出长号', () => {
+    expect(numbers('42')).toEqual([426, 427, 42])
+  })
+
+  it('按 PR 号匹配', () => {
+    expect(numbers('318')).toEqual([427])
+  })
+
+  it('多个词之间是 AND', () => {
+    expect(numbers('编程 分类')).toEqual([427])
+  })
+
+  it('没有命中时返回空', () => {
+    expect(numbers('不存在的东西')).toEqual([])
+  })
+})
diff --git a/vscode/webview-ui/src/lib/issueFilter.ts b/vscode/webview-ui/src/lib/issueFilter.ts
new file mode 100644
index 0000000..2e6c1e9
--- /dev/null
+++ b/vscode/webview-ui/src/lib/issueFilter.ts
@@ -0,0 +1,34 @@
+import type { Issue } from '../types'
+
+/**
+ * 看板顶部筛选框的匹配规则。
+ *
+ * 查询按空白切成多个词，逐词 AND：工单要留在板上，每个词都得命中它的
+ * 标题、工单号或 PR 号之一。词首的 `#` 先去掉，`#427` 与 `427` 等价。
+ * 纯数字的词按「包含」匹配编号，`42` 既能带出 #42 也能带出 #427，
+ * 免得用户记不全编号就搜不到。
+ */
+export function parseFilterTerms(query: string): string[] {
+  return query.trim().toLowerCase().split(/\s+/).filter(Boolean)
+}
+
+function matchesTerm(issue: Issue, term: string): boolean {
+  if (issue.title.toLowerCase().includes(term))
+    return true
+  const digits = term.replace(/^#/, '')
+  if (digits === '' || !/^\d+$/.test(digits))
+    return false
+  return String(issue.number).includes(digits) || (issue.pr ?? '').includes(digits)
+}
+
+export function matchesIssueFilter(issue: Issue, terms: string[]): boolean {
+  return terms.every(term => matchesTerm(issue, term))
+}
+
+/** 空查询原样返回，调用方据此免掉一次无意义的数组拷贝。 */
+export function filterIssues(issues: Issue[], query: string): Issue[] {
+  const terms = parseFilterTerms(query)
+  if (terms.length === 0)
+    return issues
+  return issues.filter(issue => matchesIssueFilter(issue, terms))
+}