diff --git a/CCUI-OPTIMIZATION-RISK-REPORT.md b/CCUI-OPTIMIZATION-RISK-REPORT.md
new file mode 100644
index 00000000..36c4e15b
--- /dev/null
+++ b/CCUI-OPTIMIZATION-RISK-REPORT.md
@@ -0,0 +1,391 @@
+# ccui 组件待人工介入清单（58 条）
+
+> 经多代理重确认（每条 2 个对立视角 + 分歧裁决）：原 131 条待审项中，0 误报；73 条已确认为安全自动修并已提交（commit 759b980）；下列为**真正需要人工决策**的项——涉及对外行为/API 变更、快照/测试契约、设计取舍或较大重构。13 条标注「未复核」是裁决代理偶发失败、保守列入。
+
+
+## 响应式（行为/重构/契约） — 8 条
+
+
+### avatar
+- **[high]** img/name/error/nobody 元素在 setup 期一次性构建，prop 变更后不重渲  
+  `avatar/src/avatar.tsx` @ 54-124, 138-145  
+  方向：Move all four JSX const blocks AND the hasImgElement/hasNameElement helper bodies inside the returned render function so createVNode re-runs per render. Keep ns, styleNs, the backgroundNs computed, showErrorAvatar, and the watch outside. Concretely: `return ()
+
+### config-provider
+- **[high]** provide 注入的是 computed 的快照 ctx.value，子树永久丢失响应性  
+  `config-provider/src/config-provider.tsx` @ 76  
+  方向：Provide the computed ref and unwrap it inside useConfig so all existing consumers keep reading plain properties. (1) Change line 76 to `provide(CONFIG_INJECT_KEY, ctx)`. (2) Type the key as `InjectionKey<ComputedRef<ConfigContext>>` (or cast) and rewrite useCo
+
+### tabs
+- **[medium]** 外部修改 modelValue 不会同步 active（缺 watch）  
+  `tabs/src/tabs.tsx` @ 16  
+  方向：需在 import 中加入 watch（当前 line 2 只导入了 defineComponent, provide, reactive），再在 setup 内 state 声明后添加同步逻辑：
+
+import { defineComponent, provide, reactive, watch } from 'vue'
+
+watch(() => props.modelValue, (v) => { if (v !== state.active) state.active = v })
+
+加 v !== sta
+
+### tree
+- **[medium]** defaultExpandAll 只在 setup 同步执行一次，异步/后到的 data 不生效  
+  `tree/src/tree.tsx` @ 72  
+  方向：The bug is real but requires changes in BOTH files because the proposed watch alone won't propagate. Option A (recommended, minimal-risk): keep computing initialExpandedAll reactively AND make useControllableSet react to defaultValue changes when uncontrolled.
+
+### descriptions
+- **[medium]** computed 内调用 slot 渲染函数并缓存 VNode，存在 VNode 复用风险  
+  `descriptions/src/descriptions.tsx` @ 36-37  
+  方向：把 slot 的 VNode 调用从 computed 内推迟到 render 内（thunk 形态），slot 路径不缓存 VNode 实例。最小修改如下：
+
+1) ResolvedItem 的 label/content 改为可承载 thunk：
+   label: VNode | string | (() => VNode)
+   content: VNode | string | number | (() => VNode)
+
+2) resolveFromSlots 第36-37行存 thunk 而非立刻调
+
+### textarea
+- **[medium]** defaultValue 会吞掉“受控且初值为空字符串”的合法场景  
+  `textarea/src/textarea.tsx` @ 53  
+  方向：The proposed fix `props.defaultValue ?? props.modelValue` is a no-op: in that branch props.modelValue is already '' (its default), so it equals the current `props.defaultValue ?? ''`. A correct fix requires making "provided" detectable: in textarea-types.ts ch
+
+### masonry
+- **[medium]** ⚠️未复核 用数组下标 ci/ii 作 key，列数变化时 DOM 复用错位  
+  `masonry/src/masonry.tsx` @ 109,112  
+  方向：用全局序号 gi 做稳定身份，优先 VNode 自带 key。修改 columns 计算携带 gi，并在渲染用 key={vnode.key ?? gi}。
+
+1) 把 columns 计算改为携带原始全局序号（合并 sequential/默认两分支，因二者逻辑当前完全相同）：
+
+const columns = computed(() => {
+  const items = flatChildren(slots.default?.() ?? [])
+  const cols: { vnode: VNode, gi
+
+### affix
+- **[low]** watch target 仅监听 prop 引用变化，函数型 target 返回值改变时不会重新绑定  
+  `affix/src/affix.tsx` @ 153-160  
+  方向：优先采用文档化方案：明确"函数型 target 仅在挂载时解析一次，引用不变则不重绑"。若要代码修复，不应放进每帧 scroll 都会跑的 update()（会引入每次滚动调用 resolveTarget + DOM 查询的开销与潜在反复 add/removeEventListener），而应仅在 onMounted 的 requestAnimationFrame 回调里或 resize/ResizeObserver 等低频时机做一次比对：`const next = resolveTarget(props.targ
+
+## 逻辑（设计取舍/时序） — 8 条
+
+
+### date-picker
+- **[high]** showTime 下点击 clear 未重置 pendingValue / pendingDirty，面板残留旧高亮且 ok 仍可点  
+  `date-picker/src/date-picker.tsx` @ 401-405  
+  方向：The proposed fix is directionally right but unsafe as written: it calls initialPendingTime(), which reads selectedDayjs.value (a computed off props.modelValue). emitChange(null) only emits update:modelValue and does NOT synchronously update selectedDayjs, so i
+
+### tag
+- **[high]** variant 的 filled/solid/outlined 修饰类无任何样式，filled 与 solid 渲染完全一致  
+  `tag/src/tag.scss` @ 119  
+  方向：The defect is real, but a blanket `&--variant-solid` background rule is not minimal/safe: solid's promise is per-preset-color saturation, and the preset colors are generated in the `@each` loop (lines 119-126) as `background: var(--ccui-#{$name}-1)` plus statu
+
+### message
+- **[medium]** enforceMaxCount 用 arr.shift() 直接移除最旧消息，跳过 leave 过渡动画  
+  `message/src/use-message.ts` @ 80  
+  方向：The bug is real but the suggested "call the oldest item's close" fix is NOT directly applicable: MessageItem (message-item.tsx) keeps `visible` and `close` internal to setup and never `expose`s them, and the holder renders children via h(MessageItem,...) with 
+
+### modal
+- **[medium]** Escape 关闭对所有打开的 modal 全局生效，栈式多层 modal 会被同时关闭  
+  `modal/src/modal.tsx` @ 80-84  
+  方向：引入模块级栈并把 push/pop 绑定到 open/close 生命周期(不能只在 keydown 内处理):
+1) 文件顶部加 `const modalEscStack: number[] = []`。
+2) onKeydown 改为仅当本实例位于栈顶才响应,并阻止冒泡:
+```
+const onKeydown = (e: KeyboardEvent) => {
+  if (e.key !== 'Escape' || !props.closeOnEsc || !isOpen.value) return
+  if
+
+### table-column
+- **[medium]** 全局自增 columnSeq 决定列序，动态重挂载的列会跳到末尾  
+  `table-column/src/table-column.tsx` @ 7, 19  
+  方向：Do not apply the accuser's "minimal" variant as-is: locating by a stable key within the original `columns` order is invalid here, because in template-collection mode there is no `columns` array to index into — columns exist only via register(). The correct fix
+
+### input-number
+- **[medium]** handleInput 在每次击键时即 clamp 到 min/max 并按 precision 取整，妨碍正常输入  
+  `input-number/src/input-number.tsx` @ 111  
+  方向：Two-part change. (1) In handleInput, parse the raw value without clamp/precision so typing isn't disrupted, e.g. replace lines 111-112 with: `const raw = Number.parseFloat(value); if (!Number.isNaN(raw)) updateValue(raw, false)` — leaving clamp+precision to ha
+
+### space-compact
+- **[medium]** size 生成的修饰类无任何样式承接，且未透传到子项，是死输出  
+  `space-compact/src/space-compact.tsx` @ 16  
+  方向：Do NOT delete line 16 — that breaks existing assertions in test/space-compact.test.ts:24-26 requiring ccui-space-compact--large / --small. Take option (a): add the missing scss rules so the modifier is consumed. In space-compact.scss, inside the root block, ad
+
+### time-picker
+- **[low]** 「此刻」按钮不遵守 step 与 disabled 约束  
+  `time-picker/src/time-picker.tsx` @ 196-203 (clickNow)  
+  方向：Align `now` to an existing, non-disabled cell using the same column value lists that render the panel, instead of naive step rounding (columns floor to multiples of step starting at 0, and disabled cells must be skipped). Add a helper and use it in clickNow:
+
+
+
+## 可访问性 — 25 条
+
+
+### color-picker
+- **[high]** 清除按钮是嵌套在 <button> 内的可交互元素，HTML 非法且键盘不可达  
+  `color-picker/src/color-picker.tsx` @ 356-376  
+  方向：The defect is real, but the proposed fix is not a safe drop-in autofix: (a) changing the outer trigger from `<button>` to a `div+role=button` loses native focus/`disabled`/form semantics and is a behavior change; (b) the clear control is currently a flex child
+
+### input
+- **[high]** 清除按钮 <i> 缺 role/aria-label/键盘支持，且与同库其它组件不一致  
+  `input/src/input.tsx` @ 174  
+  方向：{hasClear && <i class={ns.e('clear')} role="button" aria-label="清除" tabindex={0} onClick={clearInput} onKeydown={(e: KeyboardEvent) => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); clearInput() } }}></i>}
+
+### segmented
+- **[high]** 单选项缺少 name 与 onChange，键盘无法切换且不成 radio group  
+  `segmented/src/segmented.tsx` @ 44-50  
+  方向：The proposed fix's direction is right (move the handler to onChange) but `name={ns.b()}` is wrong: ns.b() is a constant class string ('c-segmented') shared by every Segmented instance, so two Segmenteds on one page would collide into one radio group. Use a per
+
+### table
+- **[high]** 树形展开图标是裸 <span>，键盘不可达  
+  `table/src/table.tsx` @ 866-875  
+  方向：Replace the tree-expand span with a native button so keyboard (Enter/Space) and SR semantics come for free and it matches renderExpandCell. At line 864-875 change the inner branch to:
+
+h(
+  'button',
+  {
+    type: 'button',
+    class: [ns.e('tree-expand-icon')
+
+### carousel
+- **[medium]** tablist/tabpanel 角色不完整，缺 tab 角色与 aria-controls 关联  
+  `carousel/src/carousel.tsx` @ 318-324, 296-305, 263-285  
+  方向：建议修复中 `${idPrefix}-panel-${i}` 不成立——源码无 idPrefix 基础设施（grep 仅命中 role:，无 useId/aria-controls）。且存在结构性陷阱：dots 按 pageCount/currentPage（页）渲染，slides 按子节点（帧）渲染，multi（slidesToShow>1）时两者数量不一致，按同一 index i 做 1:1 aria-controls/aria-labelledby 映射会错位；customDot slot 路径（298-29
+
+### icon
+- **[medium]** clickable 图标无 title/ariaLabel 时是无名可聚焦 button  
+  `icon/src/icon.tsx` @ 166-179  
+  方向：Line 178 — give the interactive (button) branch a fallback accessible name from props.name: `'aria-label': props.ariaLabel || props.title || (interactive ? props.name || undefined : undefined)`. This only affects the clickable path, leaves non-interactive icon
+
+### image
+- **[medium]** 预览遮罩无 Escape 键关闭、无焦点/role 语义  
+  `image/src/image.tsx` @ 155-189  
+  方向：Escape-to-close + dialog semantics are the safe, minimal core. Prefer a watch over previewVisible (covers every open path, avoids duplicate listeners) instead of binding inside onClick:
+
+1) Add handler + lifecycle in setup:
+const onKeydown = (e: KeyboardEvent)
+
+### rate
+- **[medium]** role=radio 无键盘可达性（缺 tabindex/keydown）  
+  `rate/src/rate.tsx` @ 63-71  
+  方向：Add roving tabindex and a keydown handler that computes the index directly instead of reusing the MouseEvent-based handler. In iconList(), on the div add: tabindex={props.readOnly ? -1 : (isFullyChecked ? 0 : -1)} and a fallback so at least one item is focusab
+- **[medium]** aria-checked 忽略 hover 与半选，半选项永不报 checked  
+  `rate/src/rate.tsx` @ 61,66  
+  方向：The bug is real, but the proposed aria-checked="mixed" fix is INVALID: the element is role="radio" (line 65), and aria-checked="mixed" is only legal for role checkbox/menuitemcheckbox — for radio only true/false are valid. Minimal correct fix that keeps the ex
+
+### splitter
+- **[medium]** 拖拽分隔条 resizer 缺少 role=separator / aria 与键盘支持  
+  `splitter/src/splitter.tsx` @ 252  
+  方向：Two-part fix; only part 1 is a safe, minimal, non-breaking autofix. Part 1 (apply now): add static ARIA to the resizer at line 252 — `<div class={splitterCls} role="separator" aria-orientation={isHorizontal.value ? 'vertical' : 'horizontal'} tabindex={props.re
+
+### tabs
+- **[medium]** 方向键落到 disabled tab 时静默卡死，不跳过  
+  `tabs/src/components/tabs-nav/index.tsx` @ 62-65  
+  方向：Replace the single-index logic with a directional skip-loop bounded by list.length. Compute a step from the key (Right/Down = +1, Left/Up = -1; Home = start at 0 stepping +1, End = start at list.length-1 stepping -1), then iterate from the start index in that 
+
+### radio
+- **[medium]** RadioGroup 内的原生 <input> name 默认为空，破坏方向键键盘导航与原生单选语义  
+  `radio.tsx` @ 81  
+  方向：建议的 proposedFix 不可直接采用：它写的 `${cls-prefix}-radio-${id}` 中 cls-prefix/id 未定义、不可编译；且 radioGroupProps 当前根本没有 name 这个 prop，radioGroupInject?.name 取不到值。按"不新增公开 prop"约定，应在 radio-group 内部自动生成一个组级 name 并通过现有注入下发，而非新增公开 prop：1) radio-group.tsx 顶部生成内部 id，如 `const groupNa
+
+### date-picker
+- **[medium]** ⚠️未复核 role="button" 的 span/li（panel-label、preset-item、clear）无 tabindex 且无 keydown，键盘不可达  
+  `date-picker/src/date-picker.tsx` @ 494-498,717,938  
+  方向：给三处补 tabindex={0} 与 onKeydown，在 Enter/' ' 时 preventDefault 后调用对应处理器。注意 clear(e: MouseEvent) 内部调用 e.stopPropagation()，KeyboardEvent 同为 Event 也有该方法，可直接复用但需注意类型：可写 onKeydown={(e: KeyboardEvent) => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); cl
+
+### segmented
+- **[medium]** ⚠️未复核 role="listbox" 与子项缺 role="option"/aria-selected 语义不匹配  
+  `segmented/src/segmented.tsx` @ 32-41  
+  方向：Change line 32 to role="radiogroup": `<div class={cls.value} role="radiogroup">`. Then add aria-checked to the radio input (the element carrying the radio role), after line 49: `aria-checked={opt.value === props.modelValue}`. Do not add aria-checked to the <la
+
+### select
+- **[medium]** ⚠️未复核 清除按钮与 tag 删除按钮是纯 onClick 的 span，无键盘可达性  
+  `select/src/select.tsx` @ 710-712, 466-470  
+  方向：缺陷属实，但 proposedFix 直接用 keydown 调 onClear(event)/onRemoveTag(option.value, event) 会有类型不符：onClear(293) 与 onRemoveTag(300) 形参类型为 MouseEvent，传 KeyboardEvent TS 报错；且二者只调用了 event.stopPropagation()，需先把形参类型放宽为 `MouseEvent | KeyboardEvent`。最小修复：1) 把 onClear / onRemoveT
+
+### skeleton-node
+- **[medium]** ⚠️未复核 同一元素同时设 aria-busy=true 与 aria-hidden=true，二者矛盾  
+  `skeleton-node/src/skeleton-node.tsx` @ 31  
+  方向：Skeleton placeholders are decorative, so keep aria-hidden and drop the dead aria-busy. Change line 31 to: `{ class: cls.value, style: style.value, 'aria-hidden': 'true' }`. (Alternatively, if a "loading" announcement is desired, instead remove aria-hidden and 
+
+### tag
+- **[medium]** ⚠️未复核 关闭按钮是裸 span，缺 role/aria-label/键盘支持，且与库内其他关闭按钮不一致  
+  `tag/src/tag.tsx` @ 48  
+  方向：On tag.tsx:48 add `role="button" aria-label="close" tabindex={0}` and an `onKeydown` that triggers close on Enter/Space. Because `onClose` is typed `(e: MouseEvent)` and calls `e.stopPropagation()`, widen its signature to `(e: MouseEvent | KeyboardEvent)` (sto
+
+### textarea
+- **[medium]** ⚠️未复核 清除按钮不可键盘聚焦/激活，缺 role=button 与键盘支持  
+  `textarea/src/textarea.tsx` @ 218-237  
+  方向：Factor a shared a11y attribute set and apply to all branches. Add a keyboard handler and reuse common props:
+
+const onClearKeydown = (e: KeyboardEvent) => {
+  if (e.key === 'Enter' || e.key === ' ') {
+    e.preventDefault()
+    clearValue()
+  }
+}
+const clearPr
+
+### transfer
+- **[medium]** ⚠️未复核 role=option 的列表项可点但无键盘支持  
+  `transfer/src/transfer.tsx` @ 298-309  
+  方向：Add to the li (lines 298-309): tabindex={isDisabled ? -1 : 0} and onKeydown={(e: KeyboardEvent) => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); toggleItem(item.key, isDisabled) } }}. toggleItem(item.key, isDisabled) already early-returns whe
+
+### upload
+- **[medium]** ⚠️未复核 文件名 span 可点击触发 preview 但无键盘支持  
+  `upload/src/upload.tsx` @ 276  
+  方向：Make the preview targets keyboard-accessible. For the text-list filename (line 276) add role/tabindex and a keydown handler that activates on Enter/Space (preventDefault on Space to avoid page scroll):
+
+```tsx
+<span
+  class={ns.e('item-name')}
+  role="button"
+
+
+### auto-complete
+- **[low]** clear 清除按钮无键盘可达性（无 tabindex/keydown，且只绑 mousedown）  
+  `auto-complete/src/auto-complete.tsx` @ 293  
+  方向：Make the clear control keyboard-reachable. The proposed fix is correct in spirit but the description's `tabindex={-1}` is insufficient (use `0`), and the existing `clear(e: MouseEvent)` at line 220 must be widened to accept a KeyboardEvent. Minimal change:
+
+1)
+
+### carousel
+- **[low]** 非 infinite 边界时箭头无 disabled / aria-disabled  
+  `carousel/src/carousel.tsx` @ 328-352  
+  方向：In renderArrows compute boundary state using the same max the handlers use (single-frame: total-1, multi: maxActive):
+const max = isMulti.value ? maxActive.value : total.value - 1
+const atStart = !props.infinite && active.value <= 0
+const atEnd = !props.infini
+
+### date-picker
+- **[low]** role="gridcell" 的单元格缺少父级 role="grid"/role="row" 容器，ARIA grid 结构不完整  
+  `date-picker/src/date-picker.tsx` @ 615,642,759,789,820  
+  方向：The "minimal" variant (only add role="grid" to the four __grid divs) is ARIA-incomplete: gridcell must be owned by a row, so role="grid" with directly-nested gridcells still violates the owned-elements rule. Full fix: add role="grid" to each __grid container A
+
+### tree-select
+- **[low]** aria-haspopup="tree" 与弹层实际 role="dialog" 不一致  
+  `tree-select/src/tree-select.tsx` @ 504, 524 / 367  
+  方向：Change both aria-haspopup values to 'dialog' to match the popup's role="dialog" (line 367). Specifically: line 504 input aria-haspopup="dialog", and line 524 aria-haspopup={props.multiple ? 'dialog' : undefined}. This is the minimal, safe fix because the popup
+
+### typography
+- **[low]** disabled 的 Link 仍可点击且未暴露 aria-disabled  
+  `typography/src/typography.tsx` @ 317-320  
+  方向：在 tagName === 'a' 分支按 disabled 收口 href/target 与 a11y（最小改动）：
+
+```tsx
+if (tagName === 'a') {
+  const linkP = props as unknown as LinkProps
+  if (linkP.disabled) {
+    tagAttrs['aria-disabled'] = true
+    tagAttrs.onClick = (e: MouseEvent) => e.preventDefault()
+ 
+
+## 一致性 — 7 条
+
+
+### radio
+- **[high]** 状态类名写死为裸字符串 'active' / 'disabled'，未走 ns.is() BEM 约定  
+  `radio/src/radio.tsx` @ 30-32  
+  方向：两处需同步修改，缺一会破坏样式。
+
+1) radio.tsx 第 30-32 行（labelClass 返回数组，JSX class={labelClass.value} 已支持数组+假值过滤，无需改第 76 行）：
+```
+const labelClass = computed(() => {
+  return [ns.b(), isActive.value && ns.is('active'), isDisabled.value && ns.is('disabled')]
+})
+```
+
+2) radio.sc
+
+### timeline
+- **[medium]** center 用 ns.e('center') 把状态/修饰符当成 element 写  
+  `timeline/src/timeline-item.tsx` @ 66  
+  方向：命名诊断属实，但 proposedFix 不完整且方向偏差。按同库 button.tsx 先例（round/block/disabled 用 ns.m()），应改为 ns.m('center') → ccui-timeline-item--center（保留 block 前缀），而非 ns.is('center')（is-center 丢失前缀）。且必须三处联改、否则破坏现状/测试：(1) timeline-item.tsx:66 改 props.center && ns.m('center')；(2) timel
+
+### button-3d
+- **[medium]** ⚠️未复核 子元素类名写死字符串，未用 ns.e() BEM  
+  `button-3d/src/button-3d.tsx` @ 34-39  
+  方向：真正需修的是子元素类名（tsx + scss 必须同步改，否则样式断裂）：tsx 第34-39行 class="shadow"→{ns.e('shadow')}、"edge"→{ns.e('edge')}、"front"→{ns.e('front')}、"loading-spinner"→{ns.e('loading-spinner')}；同时 button-3d.scss 中所有 .shadow/.edge/.front/.loading-spinner 选择器（含 &--primary/--success/..
+
+### calendar
+- **[low]** 状态类 current-month / current-date 为写死字符串，未走 ns 命名空间  
+  `calendar/src/calendar.tsx` @ 131-135  
+  方向：这是真实的一致性问题，但提案的 ns.is() 不够精确：use-namespace.ts 第33行 is(name) 只返回 `is-${name}`，不带 ccui- / $cls-prefix，单独用并不能真正消除跨库串扰（仅在 SCSS 嵌套到带前缀的块下才隔离）。若目标是真正带前缀隔离，更稳的最小修复是用 ns.m()：tsx 改为 [ns.m('current-month')]: isCurrentMonth, [ns.m('current-date')]: isSelected,（生成 ccui-ca
+
+### check-box
+- **[low]** labelClass 用裸字符串 'active'/'disabled'，未走 ns BEM  
+  `check-box/src/check-box.tsx` @ 29  
+  方向：改 check-box.tsx:29 为：return `${ns.b()} ${isChecked.value ? ns.is('active') : ''} ${isDisabled.value ? ns.is('disabled') : ''}`（输出 is-active / is-disabled）。同步改 check-box.scss 全部四处选择器：第83行 &:not(.disabled):hover → &:not(.is-disabled):hover；第89行 &.active → &.is-a
+
+### rate
+- **[low]** 激活态 span 用块级修饰符 ns.m('active') 而非元素修饰符  
+  `rate/src/rate.tsx` @ 73  
+  方向：Apply the BEM rename AND update the test so it stays green. (1) rate.tsx:73 ns.m('active') -> ns.em('icon','active'). (2) rate.scss: move the block-level `&--active { color: $ccui-color-warning; fill: currentColor; }` block to be nested inside `&__icon` as `&-
+
+### steps
+- **[low]** type="navigation" 有声明并输出 class，但 scss 无任何对应样式  
+  `steps/src/steps-types.ts` @ 34-37  
+  方向：这是真实的 consistency 缺陷，但两种修复都不宜自动应用：(A) 在 steps.scss 补 &--navigation 样式属于设计决策，非最小修复；(B) 从 StepsType 移除 'navigation' 会改动公开类型并可能破坏已传 type="navigation" 的消费者。建议交由人工决定：若产品确认 navigation 形态短期不实现，则在 steps-types.ts:6 将 `export type StepsType = 'default' | 'navigation'` 收
+
+## 深色模式（非等值替换需判断） — 4 条
+
+
+### button-3d
+- **[medium]** 默认 .edge 渐变与 .shadow 用硬编码 hsl，深色模式不适配  
+  `button-3d/src/button-3d.scss` @ 38-44  
+  方向：分两处、且 .edge 非最小可安全自动修复：
+
+1) .shadow（第25行）安全替换为已存在的语义阴影 token（注意 alpha 由 0.25 变为浅 0.15/深 0.4，属可接受的轻微视觉变化，且深色会变深符合预期）：
+  background: $ccui-shadow;
+
+2) .edge 默认渐变（第40-43行）不可简单换 $ccui-color-border —— 该渐变是双层灰阶（中段更深 18%、两端更亮 36%）营造 3D 边缘立体感，替成单色边框 token 会丢失立体效果且浅色模式
+
+### layout
+- **[medium]** header / dark sider / trigger 硬编码颜色，深色模式失效  
+  `layout/src/layout.scss` @ 26, 45, 72, 75, 81  
+  方向：Do not auto-apply the proposed bg/text/fill token swap — it would either turn the intentionally-dark header/sider white (using $ccui-color-bg-container/-layout) or require inventing a new dark-container token, which is a behavior change and violates the no-new
+
+### button
+- **[low]** box-shadow 硬编码 rgba 颜色  
+  `button/src/button.scss` @ 31, 60  
+  方向：The accusation's suggested token `$ccui-box-shadow-tertiary` is WRONG: it exists but is a floating-panel elevation stack (`0 6px 16px 0 ...`, used by card/dropdown), not a `0 2px 0` button accent shadow — reusing it would visually break the button. There is no
+
+### menu
+- **[low]** &--dark 整块用硬编码 hex/rgba，未走 token 化深色方案  
+  `menu/src/menu.scss` @ 200-232  
+  方向：不要把 &--dark 的颜色直接换成 $ccui-color-bg-container/text/border 等"会随主题切换"的语义 token——因为 &--dark 由显式 prop theme="dark"（menu-types.ts:42 默认 light）触发，是"浅色页面上的深色侧边栏"特性，独立于全局 .dark；换成切换型 token 后，theme=dark 的菜单在浅色页会渲染成浅色，破坏现有行为。正确的最小修复是把这块抽成一组固定的 menu 深色专用 token（如 $ccui-men
+
+## 性能 — 4 条
+
+
+### form
+- **[medium]** ⚠️未复核 依赖项重校验被 Form 与 FormItem 双重触发  
+  `form/src/form.tsx` @ 130-140  
+  方向：删除 form.tsx 第 130-140 行整段 watch(() => props.model, () => { fields.value.forEach(field => { if (field.dependencies.length > 0) void field.validate() }) }, { deep: true });依赖项重校验完全交给 form-item.tsx:297-305 自身的 watcher 负责(该 watcher 在 form 存在时才生效,doValidate 在 !form
+
+### space
+- **[medium]** ⚠️未复核 列表用数组下标 idx 作 key，children 变动时复用错位  
+  `space/src/space.tsx` @ 50-65  
+  方向：Prefer the child VNode's own stable key, falling back to idx only when absent. Inside the map: `const k = child.key ?? idx`. Change line 52 `key={idx}` to `key={k}`, line 58 `<Fragment key={idx}>` to `<Fragment key={k}>`. Optionally distinguish the wrapper fro
+
+### grid
+- **[low]** resize 监听未做节流/防抖  
+  `grid/src/grid.tsx` @ 30  
+  方向：Coalesce resize handling with rAF and cancel the pending frame on unmount. Keep `update` as-is and wrap only the listener:
+
+```ts
+let rafId = 0
+const onResize = () => {
+  if (typeof window === 'undefined' || rafId)
+    return
+  rafId = window.requestAnimationF
+
+### time-range-picker
+- **[low]** ns.m(props.size) 对 default 尺寸输出冗余 --default 类  
+  `time-range-picker/src/time-range-picker.tsx` @ 149  
+  方向：Do not autofix. If the redundant `--default` class were to be removed, the change must be coordinated: (1) line 149 → `props.size !== 'default' && ns.m(props.size)`, AND (2) update test/time-range-picker.test.ts:102 to drop the 'default' case and instead asser
+
+## 样式去重 — 1 条
+
+
+### badge
+- **[low]** __sup 与 --count-standalone 大段声明重复可抽公共块  
+  `badge/src/badge.scss` @ 9-29, 40-53  
+  方向：改用 @mixin 而非 %extend，纯声明内联、不产生选择器分组、不改级联顺序：定义 @mixin ccui-badge-count-base { display: inline-block; height: 20px; min-width: 20px; padding: 0 6px; color: #ffffff; font-size: $ccui-font-size-sm; line-height: 20px; text-align: center; background: $ccui-color-err
\ No newline at end of file
diff --git a/packages/ccui/ui/affix/src/affix.tsx b/packages/ccui/ui/affix/src/affix.tsx
index 074addea..a31d332d 100644
--- a/packages/ccui/ui/affix/src/affix.tsx
+++ b/packages/ccui/ui/affix/src/affix.tsx
@@ -68,6 +68,7 @@ export default defineComponent({
 
     let container: HTMLElement | Window | null = null
     let resizeObserver: ResizeObserver | null = null
+    let rafId: number | null = null
 
     const isTopMode = computed(() => props.offsetBottom === undefined)
     const offsetTop = computed(() => props.offsetTop ?? 0)
@@ -140,7 +141,7 @@ export default defineComponent({
         resizeObserver.observe(wrapperRef.value)
       }
       // 等下一帧再计算，避免初次布局未完成
-      requestAnimationFrame(() => update())
+      rafId = requestAnimationFrame(() => update())
     })
 
     onBeforeUnmount(() => {
@@ -148,6 +149,11 @@ export default defineComponent({
       window.removeEventListener('resize', update)
       resizeObserver?.disconnect()
       resizeObserver = null
+      // 卸载时取消未执行的下一帧回调，避免卸载后再触发一次 update()
+      if (rafId !== null && typeof cancelAnimationFrame === 'function') {
+        cancelAnimationFrame(rafId)
+        rafId = null
+      }
     })
 
     watch(
diff --git a/packages/ccui/ui/alert/src/alert.scss b/packages/ccui/ui/alert/src/alert.scss
index c68492a3..cd1fa83f 100644
--- a/packages/ccui/ui/alert/src/alert.scss
+++ b/packages/ccui/ui/alert/src/alert.scss
@@ -91,7 +91,7 @@
 
     .#{$cls-prefix}-alert__icon {
       margin-top: 4px;
-      font-size: 24px;
+      font-size: $ccui-font-size-heading-3;
     }
 
     .#{$cls-prefix}-alert__message {
diff --git a/packages/ccui/ui/alert/src/alert.tsx b/packages/ccui/ui/alert/src/alert.tsx
index 106bec8d..b0b8097a 100644
--- a/packages/ccui/ui/alert/src/alert.tsx
+++ b/packages/ccui/ui/alert/src/alert.tsx
@@ -22,11 +22,14 @@ export default defineComponent({
     const ns = useNamespace('alert')
     const closed = ref(false)
 
+    // 是否渲染图标：显式开启、提供 icon 插槽、或 banner 模式
+    const showIcon = computed(() => props.showIcon || !!slots.icon || props.banner)
+
     const cls = computed(() => ({
       [ns.b()]: true,
       [ns.m(props.type)]: true,
       [ns.m('with-description')]: !!props.description || !!slots.description,
-      [ns.m('show-icon')]: props.showIcon || !!slots.icon,
+      [ns.m('show-icon')]: showIcon.value,
       [ns.m('banner')]: props.banner,
     }))
 
@@ -39,10 +42,9 @@ export default defineComponent({
       if (closed.value) {
         return null
       }
-      const showIcon = props.showIcon || !!slots.icon || props.banner
       return (
         <div class={[cls.value, props.classNames?.root]} style={props.styles?.root} role="alert">
-          {showIcon && (
+          {showIcon.value && (
             <span class={[ns.e('icon'), props.classNames?.icon]} style={props.styles?.icon}>
               {slots.icon ? (
                 slots.icon()
@@ -64,7 +66,7 @@ export default defineComponent({
             )}
           </div>
           {(props.closable || props.closeText) && (
-            <button class={ns.e('close')} type="button" onClick={onClose}>
+            <button class={ns.e('close')} type="button" aria-label="关闭" onClick={onClose}>
               {props.closeText ? (
                 <span>{props.closeText}</span>
               ) : (
diff --git a/packages/ccui/ui/anchor/src/anchor-types.ts b/packages/ccui/ui/anchor/src/anchor-types.ts
index 2dcf87b9..bdabd956 100644
--- a/packages/ccui/ui/anchor/src/anchor-types.ts
+++ b/packages/ccui/ui/anchor/src/anchor-types.ts
@@ -27,10 +27,6 @@ export const anchorProps = {
     type: [String, Object] as PropType<string | HTMLElement>,
     default: undefined,
   },
-  showInkInFixed: {
-    type: Boolean,
-    default: false,
-  },
   targetOffset: {
     type: Number,
     default: undefined,
diff --git a/packages/ccui/ui/anchor/src/anchor.tsx b/packages/ccui/ui/anchor/src/anchor.tsx
index 0bdf9ca8..5d5a5cce 100644
--- a/packages/ccui/ui/anchor/src/anchor.tsx
+++ b/packages/ccui/ui/anchor/src/anchor.tsx
@@ -54,13 +54,23 @@ export default defineComponent({
     const inkRef = ref<HTMLElement>()
     const linkRefs = ref<Map<string, HTMLElement>>(new Map())
 
-    const setLinkRef = (href: string) => (el: unknown) => {
-      const node = el as HTMLElement | null
-      if (node) {
-        linkRefs.value.set(href, node)
-      } else {
-        linkRefs.value.delete(href)
+    // 缓存每个 href 的 ref 回调，保证同一 href 始终复用同一函数引用，
+    // 避免每次渲染产生新函数导致 Vue 反复 detach/attach（null→node）抖动。
+    const linkRefSetters = new Map<string, (el: unknown) => void>()
+    const getLinkRef = (href: string) => {
+      let setter = linkRefSetters.get(href)
+      if (!setter) {
+        setter = (el: unknown) => {
+          const node = el as HTMLElement | null
+          if (node) {
+            linkRefs.value.set(href, node)
+          } else {
+            linkRefs.value.delete(href)
+          }
+        }
+        linkRefSetters.set(href, setter)
       }
+      return setter
     }
 
     const updateInk = () => {
@@ -130,14 +140,29 @@ export default defineComponent({
     }
 
     let container: HTMLElement | Window | null = null
-    onMounted(() => {
+    const bind = () => {
       container = getScrollContainer(props.scrollContainer)
       container.addEventListener('scroll', onScroll, { passive: true })
-      onScroll()
-    })
-    onBeforeUnmount(() => {
+    }
+    const unbind = () => {
       container?.removeEventListener('scroll', onScroll)
+      container = null
+    }
+    onMounted(() => {
+      bind()
+      onScroll()
     })
+    onBeforeUnmount(unbind)
+    // scrollContainer 运行时变化时，需把监听从旧容器迁移到新容器并重算高亮，
+    // 否则旧容器监听泄漏、新容器无监听导致滚动驱动失效。
+    watch(
+      () => props.scrollContainer,
+      () => {
+        unbind()
+        bind()
+        onScroll()
+      },
+    )
 
     watch(activeLink, () => {
       nextTick(updateInk)
@@ -177,7 +202,7 @@ export default defineComponent({
       return (
         <div class={ns.e('link')} key={link.href}>
           <a
-            ref={setLinkRef(link.href)}
+            ref={getLinkRef(link.href)}
             class={[ns.e('link-title'), active && ns.em('link-title', 'active')]}
             href={link.href}
             style={{ paddingInlineStart: `${16 + level * 16}px` }}
@@ -185,7 +210,7 @@ export default defineComponent({
           >
             {link.title ?? link.href}
           </a>
-          {link.children?.length && (
+          {!!link.children?.length && (
             <div class={ns.e('children')}>{link.children.map((child) => renderLink(child, level + 1))}</div>
           )}
         </div>
diff --git a/packages/ccui/ui/auto-complete/src/auto-complete.scss b/packages/ccui/ui/auto-complete/src/auto-complete.scss
index 21d45d59..2d22ba62 100644
--- a/packages/ccui/ui/auto-complete/src/auto-complete.scss
+++ b/packages/ccui/ui/auto-complete/src/auto-complete.scss
@@ -63,15 +63,15 @@
     border: 0;
     outline: 0;
     background: transparent;
-    color: rgba(0, 0, 0, 0.88);
+    color: $ccui-color-text;
     font-size: 14px;
 
     &::placeholder {
-      color: rgba(0, 0, 0, 0.25);
+      color: $ccui-color-text-placeholder;
     }
 
     &:disabled {
-      color: rgba(0, 0, 0, 0.4);
+      color: $ccui-color-text-disabled;
     }
   }
 
@@ -81,14 +81,14 @@
     justify-content: center;
     width: 16px;
     height: 16px;
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
     font-size: 11px;
     cursor: pointer;
     border-radius: 50%;
     transition: color 0.2s;
 
     &:hover {
-      color: rgba(0, 0, 0, 0.85);
+      color: $ccui-color-text;
     }
   }
 
@@ -96,9 +96,7 @@
     background: $ccui-base-bg;
     border: 1px solid $ccui-dividing-line;
     border-radius: 6px;
-    box-shadow:
-      0 6px 16px rgba(0, 0, 0, 0.08),
-      0 3px 6px -4px rgba(0, 0, 0, 0.12);
+    box-shadow: $ccui-box-shadow-secondary;
     box-sizing: border-box;
     overflow: auto;
     z-index: 1050;
@@ -113,17 +111,17 @@
 
   &__option {
     padding: 5px 12px;
-    color: rgba(0, 0, 0, 0.88);
+    color: $ccui-color-text;
     font-size: 14px;
     cursor: pointer;
     transition: background 0.2s;
 
     &.is-active {
-      background: rgba(0, 0, 0, 0.04);
+      background: $ccui-color-fill-tertiary;
     }
 
     &.is-disabled {
-      color: rgba(0, 0, 0, 0.25);
+      color: $ccui-color-text-disabled;
       cursor: not-allowed;
       background: transparent;
     }
@@ -131,7 +129,7 @@
 
   &__empty {
     padding: 12px;
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
     font-size: 13px;
     text-align: center;
   }
diff --git a/packages/ccui/ui/avatar/src/avatar.tsx b/packages/ccui/ui/avatar/src/avatar.tsx
index 48162309..90fcb3b5 100644
--- a/packages/ccui/ui/avatar/src/avatar.tsx
+++ b/packages/ccui/ui/avatar/src/avatar.tsx
@@ -33,7 +33,7 @@ export default defineComponent({
       fontSize.value = minNum.value / 4 + 3
 
       // 传入的name不存在 且不等于 '' 时
-      isNobody.value = !!name.value && name.value === ''
+      isNobody.value = !name.value
 
       // 计算背景颜色code
       BgColorCode.value = useGetBackgroundColor(gender.value, nameDisplay.value.substring(0, 1))
@@ -54,7 +54,7 @@ export default defineComponent({
     const imgElement = (
       <img
         src={imgSrc.value}
-        alt=""
+        alt={name.value || customText.value || ''}
         onError={showErrorAvatar}
         class={[props.classNames?.image]}
         style={
diff --git a/packages/ccui/ui/avatar/src/components/icon-nobody.tsx b/packages/ccui/ui/avatar/src/components/icon-nobody.tsx
deleted file mode 100644
index 9570aef3..00000000
--- a/packages/ccui/ui/avatar/src/components/icon-nobody.tsx
+++ /dev/null
@@ -1,29 +0,0 @@
-export function IconNobody(props: { width: number; height: number }) {
-  const { width, height } = props
-  return (
-    <svg
-      style={{
-        width: `${width}px`,
-        height: `${height}px`,
-        verticalAlign: 'middle',
-      }}
-      viewBox="0 0 30 30"
-      version="1.1"
-      xmlns="http://www.w3.org/2000/svg"
-    >
-      <g stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
-        <path
-          d="M22.31,19.2474562 L22.31,21.9974562 L20.81,21.9974562 L20.81,19.2474562 L18.06,19.2474562 L18.06,17.7474562 L20.81,17.7474562 L20.81,14.9974562 L22.31,14.9974562 L22.31,17.7474562 L25.06,17.7474562 L25.06,19.2474562 L22.31,19.2474562 Z M14.9297866,14.9974562 C12.4445053,14.9974562 10.4297866,12.9827376 10.4297866,10.4974562 C10.4297866,8.01217483 12.4445053,5.9974562 14.9297866,5.9974562 C17.415068,5.9974562 19.4297866,8.01217483 19.4297866,10.4974562 C19.4297866,12.9827376 17.415068,14.9974562 14.9297866,14.9974562 Z M19.6797866,20.2474562 L19.6797866,21.9971623 L6.93,21.9960092 C6.93,18.0096715 10.8192296,15.4974562 14.9297866,15.4974562 C16.4608397,15.4974562 17.9612467,15.983021 19.2414296,16.7474562 L17.06,16.7474562 L17.06,20.2474562 L19.6797866,20.2474562 Z"
-          id="形状结合"
-          fill="#959EB2"
-        ></path>
-        <path
-          d="M0,15 L1,15 C1,15.6118966 1.03919561,16.2186526 1.11683409,16.8178549 L0.125124012,16.9463505 C0.0425740367,16.309242 0,15.6595925 0,15 Z M0.503241262,18.867175 L1.46961749,18.6100428 C1.62594651,19.1975718 1.8203704,19.7729973 2.05141295,20.3332823 L1.12693074,20.7145074 C0.880599065,20.1171459 0.67172715,19.500393 0.503241262,18.867175 Z M1.99122134,22.4730778 L2.85786221,21.9741453 C3.16078316,22.5003161 3.49772502,23.0063252 3.86631639,23.4889602 L3.0715754,24.0959089 C2.6777461,23.5802273 2.31659753,23.0382531 1.99122134,22.4730778 Z M4.38894559,25.6021078 L5.09634867,24.8952974 C5.52582519,25.3251341 5.98272136,25.7268214 6.46397085,26.0975793 L5.85367498,26.8897529 C5.33779918,26.4923186 4.84851395,26.0620615 4.38894559,25.6021078 Z M7.4424647,27.9597887 L7.94703323,27.096417 C8.47111119,27.4026968 9.0146817,27.6746032 9.57453904,27.9101878 L9.18668461,28.8319084 C8.58423501,28.5784013 8.00181692,28.2866833 7.4424647,27.9597887 Z M11.0671021,29.4791103 L11.3286494,28.5139196 C11.9126912,28.6721832 12.5080563,28.7925378 13.1119738,28.8738935 L12.9784667,29.8649413 C12.3271613,29.7772019 11.6891102,29.647662 11.0671021,29.4791103 Z M15,30 C14.9951965,30 14.9903936,29.9999977 14.9855912,30 L14.9865313,28.9999937 C14.9929361,28.9999987 14.9929361,28.9999987 14.999296,29 C15.6071552,29 16.2093364,28.9614092 16.8041774,28.8849313 L16.9316965,29.8767674 C16.2992813,29.9580762 15.6545362,30 15,30 Z M18.8545762,29.5001051 L18.5982903,28.5335041 C19.1860387,28.3776677 19.7617059,28.1837179 20.3222555,27.9531286 L20.7026875,28.8779375 C20.1050484,29.123784 19.4880358,29.3321488 18.8545762,29.5001051 Z M22.4608087,28.0158343 L21.9626951,27.1487226 C22.4893928,26.8461604 22.9959399,26.5095265 23.479119,26.1411926 L24.0853678,26.9364676 C23.5691101,27.3300178 23.0265585,27.6908386 22.4608087,28.0158343 Z M25.5921583,25.6209863 L24.8860071,24.9129252 C25.3161421,24.4839504 25.7181674,24.0275419 26.0893023,23.5467621 L26.8808873,24.1578212 C26.4830546,24.6731862 26.0524368,25.1619493 25.5921583,25.6209863 Z M27.9526445,22.5697466 L27.0897495,22.0643633 C27.3964738,21.5406601 27.6688549,20.9974409 27.904942,20.4379104 L28.8262855,20.8266601 C28.5722411,21.4287497 28.2800163,22.0107897 27.9526445,22.5697466 Z M29.4756977,18.9454696 L28.5107363,18.6830777 C28.6695136,18.099165 28.7903877,17.5039035 28.8722662,16.9000659 L29.8631978,17.0344333 C29.7748946,17.6856516 29.6447979,18.3235936 29.4756977,18.9454696 Z M30,15 C30,15.0093541 29.9999914,15.0187063 29.9999743,15.0280564 L28.999976,15.0262257 C28.9999956,15.0134169 28.9999956,15.0134169 29,15.0006466 C29,14.3970304 28.9619395,13.7989704 28.8865088,13.208136 L29.8784576,13.0814959 C29.9586571,13.7096843 30,14.3500145 30,15 Z M29.5038108,11.1594275 L28.5369608,11.4147728 C28.3816616,10.8267413 28.1882232,10.2507676 27.9581175,9.68988857 L28.8832852,9.31033004 C29.1286141,9.90831524 29.3364318,10.5256569 29.5038108,11.1594275 Z M28.0228788,7.55146763 L27.1552968,8.0487618 C26.853241,7.52179373 26.5170958,7.0149453 26.1492295,6.53143425 L26.9450761,5.92593594 C27.3381231,6.44254364 27.6984223,6.98541919 28.0228788,7.55146763 Z M25.6309089,4.41780044 L24.9221905,5.12329189 C24.4935639,4.69270467 24.0374698,4.2902078 23.5569705,3.9185855 L24.1687554,3.12756133 C24.6838129,3.52591118 25.1722392,3.95703271 25.6309089,4.41780044 Z M22.5819506,2.05451093 L22.0757531,2.91692851 C21.5523008,2.60968727 21.0092999,2.33677531 20.4499564,2.10014728 L20.8395722,1.17916981 C21.4414531,1.43379309 22.0232574,1.72658499 22.5819506,2.05451093 Z M18.9594329,0.528106464 L18.696103,1.4928123 C18.1122842,1.33345081 17.517086,1.21199245 16.9132846,1.12953261 L17.0485964,0.138729543 C17.6997753,0.227659622 18.3376514,0.358382523 18.9594329,0.528106464 Z M15,-1.11022302e-16 C15.0139048,-1.11022302e-16 15.0278052,1.892004e-05 15.0417011,5.673578e-05 L15.0389797,1.00005303 C15.0197685,1.00000934 15.0197685,1.00000934 15.0005868,1.00000001 C14.4012162,1 13.8072783,1.03753392 13.2204527,1.11192427 L13.0946918,0.119863691 C13.7186509,0.0407660189 14.3545651,-1.11022302e-16 15,-1.11022302e-16 Z M11.1720354,0.492865376 L11.4265338,1.45993857 C10.8386468,1.61464899 10.2627801,1.80746996 9.70196444,2.03693489 L9.32327455,1.11141127 C9.92118954,0.86676666 10.5384173,0.659610554 11.1720354,0.492865376 Z M7.56375123,1.97008801 L8.06022548,2.83813946 C7.53298826,3.13968806 7.02583975,3.47534367 6.54199783,3.84274131 L5.93725081,3.04632368 C6.4542073,2.65378102 6.99740556,2.29400434 7.56375123,1.97008801 Z M4.42776842,4.35917772 L5.13259949,5.06855291 C4.70156141,5.49682984 4.29859416,5.95260763 3.92648544,6.43282469 L3.13602297,5.82031423 C3.53488885,5.30556625 3.96651291,4.81747851 4.42776842,4.35917772 Z M2.0616775,7.40585279 L2.92361696,7.91286401 C2.61586086,8.43606175 2.34241977,8.97884042 2.10525197,9.53799293 L1.18464153,9.14751063 C1.43984243,8.54584288 1.73319965,7.96427837 2.0616775,7.40585279 Z M0.531541456,11.0280046 L1.49601653,11.2921785 C1.33614878,11.8758413 1.21417484,12.4709081 1.13119244,13.074601 L0.140507978,12.9384235 C0.230001486,12.2873626 0.361276825,11.6496255 0.531541456,11.0280046 Z"
-          id="蒙版"
-          fill="#CACFD8"
-          fill-rule="nonzero"
-        ></path>
-      </g>
-    </svg>
-  )
-}
diff --git a/packages/ccui/ui/avatar/src/composables/use-get-background-color.ts b/packages/ccui/ui/avatar/src/composables/use-get-background-color.ts
index 784818c2..7f9d8768 100644
--- a/packages/ccui/ui/avatar/src/composables/use-get-background-color.ts
+++ b/packages/ccui/ui/avatar/src/composables/use-get-background-color.ts
@@ -1,19 +1,17 @@
-import { ref } from 'vue'
-
-export default function getBackgroundColor(gender: string, char: string): number {
-  const code = ref<number>(1)
+export default function useGetBackgroundColor(gender: string, char: string): number {
+  let code = 1
   // 性别存在  直接使用性别
   if (gender) {
     if (gender.toLowerCase() === 'male') {
-      code.value = 1
+      code = 1
     } else if (gender.toLowerCase() === 'female') {
-      code.value = 0
+      code = 0
     } else {
       throw new Error('gender must be "Male" or "Female"')
     }
   } else {
     const unicode = char.charCodeAt(0)
-    code.value = unicode % 2
+    code = unicode % 2
   }
-  return code.value
+  return code
 }
diff --git a/packages/ccui/ui/avatar/src/composables/use-get-display-name.ts b/packages/ccui/ui/avatar/src/composables/use-get-display-name.ts
index 78321999..f7d81908 100644
--- a/packages/ccui/ui/avatar/src/composables/use-get-display-name.ts
+++ b/packages/ccui/ui/avatar/src/composables/use-get-display-name.ts
@@ -31,7 +31,7 @@ export default function useGetDisplayName(name: string, customText: string, widt
     nameDisplay = name.length < 2 ? name : nameFormatting(name)
   }
 
-  if (width < 30) {
+  if (name && width < 30) {
     nameDisplay = name.substring(0, 1).toUpperCase()
   }
   return nameDisplay
diff --git a/packages/ccui/ui/badge/src/badge.tsx b/packages/ccui/ui/badge/src/badge.tsx
index 9569597e..e3d7894c 100644
--- a/packages/ccui/ui/badge/src/badge.tsx
+++ b/packages/ccui/ui/badge/src/badge.tsx
@@ -46,7 +46,11 @@ export default defineComponent({
       }
       if (props.offset && Array.isArray(props.offset)) {
         const [x, y] = props.offset
-        style.transform = `translate(calc(-50% + ${x}px), calc(-50% + ${y}px))`
+        // 独立模式以 scss 基线 transform: none 为锚做纯平移；
+        // 包裹模式以 scss 基线 translate(50%, -50%)（角标推到右上角外侧）为锚做微调
+        style.transform = isStandalone.value
+          ? `translate(${x}px, ${y}px)`
+          : `translate(calc(50% + ${x}px), calc(-50% + ${y}px))`
       }
       return Object.keys(style).length ? style : undefined
     })
@@ -82,6 +86,8 @@ export default defineComponent({
           <span
             class={[ns.b(), ns.m('count-standalone'), props.classNames?.root, props.classNames?.count]}
             style={[countStyle.value, props.styles?.root, props.styles?.count] as any}
+            // 溢出时 displayCount 会截断成 99+，用 title 暴露真实数值给读屏/悬停
+            title={props.dot ? undefined : typeof props.count === 'number' ? String(props.count) : displayCount.value}
           >
             {displayCount.value}
           </span>
@@ -97,6 +103,8 @@ export default defineComponent({
             props.dot ? props.classNames?.dot : props.classNames?.count,
           ]}
           style={[countStyle.value, props.dot ? props.styles?.dot : props.styles?.count] as any}
+          // 溢出时 displayCount 会截断成 99+，用 title 暴露真实数值给读屏/悬停（dot 模式无数值）
+          title={props.dot ? undefined : typeof props.count === 'number' ? String(props.count) : displayCount.value}
         >
           {props.dot ? null : displayCount.value}
         </sup>
diff --git a/packages/ccui/ui/border-beam/src/border-beam.scss b/packages/ccui/ui/border-beam/src/border-beam.scss
index f57dcc7c..9961aab9 100644
--- a/packages/ccui/ui/border-beam/src/border-beam.scss
+++ b/packages/ccui/ui/border-beam/src/border-beam.scss
@@ -1,6 +1,6 @@
 @use '../../style-var/index.scss' as *;
 
-// 对标 Ant Design border-beam 的实现：mask 取边框环 + offset-path 矩形路径（固定 round 100px，
+// 实现：mask 取边框环 + offset-path 矩形路径（固定 round 100px，
 // 大圆角让过弯旋转平滑无卡顿）+ offset-anchor 90% 50% 形成拖尾彗星，offset-distance 0→100% 循环。
 .#{$cls-prefix}-border-beam {
   position: relative;
diff --git a/packages/ccui/ui/breadcrumb/src/breadcrumb.scss b/packages/ccui/ui/breadcrumb/src/breadcrumb.scss
index e8c408aa..31c3b4c5 100644
--- a/packages/ccui/ui/breadcrumb/src/breadcrumb.scss
+++ b/packages/ccui/ui/breadcrumb/src/breadcrumb.scss
@@ -31,7 +31,7 @@
 
     &:hover {
       color: $ccui-color-text;
-      background-color: rgba(0, 0, 0, 0.06);
+      background-color: $ccui-color-fill-secondary;
       border-radius: $ccui-border-radius-sm;
     }
   }
@@ -46,6 +46,7 @@
     user-select: none;
   }
 
+  // 末项分隔符依赖 BreadcrumbItem 为 nav 的最后一个直接子节点；若其后另有节点则 :last-child 失效
   &__item:last-child &__separator {
     display: none;
   }
diff --git a/packages/ccui/ui/breadcrumb/src/breadcrumb.tsx b/packages/ccui/ui/breadcrumb/src/breadcrumb.tsx
index 79b45638..a97dfd3e 100644
--- a/packages/ccui/ui/breadcrumb/src/breadcrumb.tsx
+++ b/packages/ccui/ui/breadcrumb/src/breadcrumb.tsx
@@ -1,5 +1,5 @@
 import type { BreadcrumbItemProps, BreadcrumbProps } from './breadcrumb-types'
-import { defineComponent, inject, provide } from 'vue'
+import { defineComponent, inject, provide, ref, toRef } from 'vue'
 import { useNamespace } from '../../shared/hooks/use-namespace'
 import { breadcrumbItemProps, breadcrumbProps } from './breadcrumb-types'
 import './breadcrumb.scss'
@@ -12,7 +12,8 @@ export const Breadcrumb = defineComponent({
   setup(props: BreadcrumbProps, { slots }) {
     const ns = useNamespace('breadcrumb')
 
-    provide(BREADCRUMB_KEY, { separator: props.separator })
+    // 用 toRef 保留 props.separator 响应性，slot 用法下子项可随父级动态更新分隔符
+    provide(BREADCRUMB_KEY, { separator: toRef(props, 'separator') })
 
     const renderRoutes = () => {
       const routes = props.routes ?? []
@@ -24,7 +25,9 @@ export const Breadcrumb = defineComponent({
         return (
           <span key={idx} class={ns.e('item')}>
             {isLast || !link ? (
-              <span class={ns.e('link')}>{text}</span>
+              <span class={ns.e('link')} aria-current="page">
+                {text}
+              </span>
             ) : (
               <a class={ns.e('link')} href={link}>
                 {text}
@@ -49,10 +52,10 @@ export const BreadcrumbItem = defineComponent({
   props: breadcrumbItemProps,
   setup(props: BreadcrumbItemProps, { slots }) {
     const ns = useNamespace('breadcrumb')
-    const ctx = inject<{ separator: string }>(BREADCRUMB_KEY, { separator: '/' })
+    const ctx = inject<{ separator: { value: string } }>(BREADCRUMB_KEY, { separator: ref('/') })
 
     return () => {
-      const sep = props.separator || ctx.separator
+      const sep = props.separator || ctx.separator.value
       return (
         <span class={ns.e('item')}>
           {props.href ? (
@@ -60,7 +63,9 @@ export const BreadcrumbItem = defineComponent({
               {slots.default?.()}
             </a>
           ) : (
-            <span class={ns.e('link')}>{slots.default?.()}</span>
+            <span class={ns.e('link')} aria-current="page">
+              {slots.default?.()}
+            </span>
           )}
           <span class={ns.e('separator')}>{slots.separator ? slots.separator() : sep}</span>
         </span>
diff --git a/packages/ccui/ui/button-3d/src/button-3d.scss b/packages/ccui/ui/button-3d/src/button-3d.scss
index a9152b83..5a5f699c 100644
--- a/packages/ccui/ui/button-3d/src/button-3d.scss
+++ b/packages/ccui/ui/button-3d/src/button-3d.scss
@@ -13,7 +13,6 @@ $button-3d-info-active-color: $ccui-button-info-active;
   border-radius: $ccui-border-radius;
   outline-offset: 4px;
   user-select: none;
-  background: transparent;
 
   .shadow {
     position: absolute;
@@ -65,88 +64,30 @@ $button-3d-info-active-color: $ccui-button-info-active;
   }
 
   // 主要按钮类型样式
-  &--primary {
-    .edge {
-      background: linear-gradient(
-        to left,
-        $ccui-color-primary-active 0%,
-        $ccui-color-primary-active 8%,
-        $ccui-color-primary-active 92%,
-        $ccui-color-primary-active 100%
-      );
-    }
-
-    .front {
-      background: $ccui-color-primary;
-      color: $ccui-color-text-light-solid;
-    }
-  }
-
-  &--success {
-    .edge {
-      background: linear-gradient(
-        to left,
-        $ccui-color-success-active 0%,
-        $ccui-color-success-active 8%,
-        $ccui-color-success-active 92%,
-        $ccui-color-success-active 100%
-      );
-    }
-
-    .front {
-      background: $ccui-color-success;
-      color: $ccui-color-text-light-solid;
-    }
-  }
-
-  &--info {
+  // .edge 四个 stop 颜色一致，仅 type 不同，用 mixin + @each 收敛
+  @mixin edge-gradient($c) {
     .edge {
-      background: linear-gradient(
-        to left,
-        $button-3d-info-active-color 0%,
-        $button-3d-info-active-color 8%,
-        $button-3d-info-active-color 92%,
-        $button-3d-info-active-color 100%
-      );
-    }
-
-    .front {
-      background: $button-3d-info-color;
-      color: $ccui-color-text-light-solid;
+      background: linear-gradient(to left, $c 0%, $c 8%, $c 92%, $c 100%);
     }
   }
 
-  &--warning {
-    .edge {
-      background: linear-gradient(
-        to left,
-        $ccui-color-warning-active 0%,
-        $ccui-color-warning-active 8%,
-        $ccui-color-warning-active 92%,
-        $ccui-color-warning-active 100%
-      );
-    }
+  @each $name, $edge,
+    $front
+      in (
+        ('primary', $ccui-color-primary-active, $ccui-color-primary),
+        ('success', $ccui-color-success-active, $ccui-color-success),
+        ('info', $button-3d-info-active-color, $button-3d-info-color),
+        ('warning', $ccui-color-warning-active, $ccui-color-warning),
+        ('danger', $ccui-color-error-active, $ccui-color-error)
+      )
+  {
+    &--#{$name} {
+      @include edge-gradient($edge);
 
-    .front {
-      background: $ccui-color-warning;
-      color: $ccui-color-text-light-solid;
-    }
-  }
-
-  &--danger {
-    .edge {
-      background: linear-gradient(
-        to left,
-        $ccui-color-error-active 0%,
-        $ccui-color-error-active 8%,
-        $ccui-color-error-active 92%,
-        $ccui-color-error-active 100%
-      );
-    }
-
-    .front {
-      background: $ccui-color-error;
-      color: $ccui-color-text-light-solid;
+      .front {
+        background: $front;
+        color: $ccui-color-text-light-solid;
+      }
     }
   }
 
@@ -228,9 +169,10 @@ $button-3d-info-active-color: $ccui-button-info-active;
     display: inline-block;
     width: 16px;
     height: 16px;
-    border: 2px solid rgba(255, 255, 255, 0.3);
+    // 轨道与指示色跟随 .front 的字色：彩色 type 下解析为白，默认浅底 type 下解析为深色，保证可见
+    border: 2px solid color-mix(in srgb, currentColor 30%, transparent);
     border-radius: 50%;
-    border-top-color: white;
+    border-top-color: currentColor;
     animation: spin 1s ease-in-out infinite;
     margin-right: 8px;
   }
diff --git a/packages/ccui/ui/button-3d/src/button-3d.tsx b/packages/ccui/ui/button-3d/src/button-3d.tsx
index 13ee06de..a6544853 100644
--- a/packages/ccui/ui/button-3d/src/button-3d.tsx
+++ b/packages/ccui/ui/button-3d/src/button-3d.tsx
@@ -28,7 +28,10 @@ export default defineComponent({
           'is-loading': props.loading,
         }}
         type={props.nativeType}
-        disabled={props.disabled}
+        // loading 时同步原生 disabled，避免键盘 Enter/Space 触发原生提交
+        disabled={props.disabled || props.loading}
+        // 向辅助技术暴露忙碌状态
+        aria-busy={props.loading || undefined}
         onClick={onClick}
       >
         <span class="shadow"></span>
diff --git a/packages/ccui/ui/button/src/button.scss b/packages/ccui/ui/button/src/button.scss
index 56926c1b..b61aea97 100644
--- a/packages/ccui/ui/button/src/button.scss
+++ b/packages/ccui/ui/button/src/button.scss
@@ -44,7 +44,7 @@ $button-info-plain-border: $ccui-button-info-plain-border;
   &:disabled {
     cursor: not-allowed;
     color: $ccui-color-text-disabled;
-    background-color: rgba(0, 0, 0, 0.04);
+    background-color: $ccui-color-fill-tertiary;
     border-color: $ccui-color-border;
     box-shadow: none;
   }
@@ -65,7 +65,7 @@ $button-info-plain-border: $ccui-button-info-plain-border;
 
     &:disabled {
       color: $ccui-color-text-disabled;
-      background-color: rgba(0, 0, 0, 0.04);
+      background-color: $ccui-color-fill-tertiary;
       border-color: $ccui-color-border;
       box-shadow: none;
     }
@@ -149,12 +149,12 @@ $button-info-plain-border: $ccui-button-info-plain-border;
 
     &:hover {
       color: $ccui-color-primary-hover;
-      background: rgba(0, 0, 0, 0.06);
+      background: $ccui-color-fill-secondary;
     }
 
     &:active {
       color: $ccui-color-primary-active;
-      background: rgba(0, 0, 0, 0.15);
+      background: $ccui-color-fill;
     }
   }
 
diff --git a/packages/ccui/ui/button/src/button.tsx b/packages/ccui/ui/button/src/button.tsx
index 8e790742..d01b7646 100644
--- a/packages/ccui/ui/button/src/button.tsx
+++ b/packages/ccui/ui/button/src/button.tsx
@@ -188,7 +188,7 @@ export default defineComponent({
             // disabled <a> 没有原生支持，用 aria-disabled + click 拦截
             'aria-disabled': resolvedDisabled.value || isLoading.value ? 'true' : undefined,
             role: 'button',
-            tabindex: resolvedDisabled.value ? -1 : 0,
+            tabindex: resolvedDisabled.value || isLoading.value ? -1 : 0,
             onClick,
           },
           children,
diff --git a/packages/ccui/ui/calendar/src/calendar.tsx b/packages/ccui/ui/calendar/src/calendar.tsx
index 6dcd6074..ca89ba8b 100644
--- a/packages/ccui/ui/calendar/src/calendar.tsx
+++ b/packages/ccui/ui/calendar/src/calendar.tsx
@@ -41,19 +41,19 @@ export default defineComponent({
 
     // 根据月份计算当前展示日期的数组
     const generatedDate = (month?: string) => {
-      // 获取当月第一天是周几
-      const whichDay = dayjs(month).startOf('month').day()
-      // 计算开始开始日期 7 减去当月第一天是周几（获取到的周几是 0123456， 其中0代表周日）
-      const startDate = dayjs(dayjs(month).subtract(7 - whichDay, 'day')).format('YYYY-MM-DD')
+      // 当月第一天
+      const first = dayjs(month).startOf('month')
+      // 当月第一天是周几（0123456，其中 0 代表周日）
+      const whichDay = first.day()
+      // 起始日期回退到所在周的周日，使网格第 N 列恰好对应星期 N，与周日…周六表头对齐
+      const startDate = first.subtract(whichDay, 'day').format('YYYY-MM-DD')
 
       // 整理数据
       // 生成长度42的数组，为什么是42呢？ 因为有的月份是28 或者30 31， 35 会导致某些月份展示不全。
       curDateList.value = Array.from({ length: 42 }, (_, index) => index).reduce(
         (acc: Array<dateItem>, index: number) => {
           // 获取展示的日期
-          const date = dayjs(startDate)
-            .add(index + 1, 'day')
-            .format('YYYY-MM-DD')
+          const date = dayjs(startDate).add(index, 'day').format('YYYY-MM-DD')
           // 分割日期 用于获取是 几号 如 123456
           const dateList = date.split('-')
           // 获取周几
@@ -61,7 +61,7 @@ export default defineComponent({
 
           // 将需要的数据 放进数组
           acc.push({
-            index: index + 1,
+            index,
             date,
             day: dateList[dateList.length - 1],
             week: weekList.value[week],
@@ -78,6 +78,8 @@ export default defineComponent({
 
     // 设置当前天、选中天， 生成对应月份
     const setCurrentDate = (date: string) => {
+      // 只读模式下禁止任何改值（日期格点击、月份切换、header slot 暴露的 setDate/changeMonth 均经此收口）
+      if (props.readOnly) return
       currentDate.value = dayjs(date).format('YYYY-MM-DD')
       // 月份不同 重新生成日历
       if (!date.includes(currentMonth.value)) {
@@ -142,9 +144,18 @@ export default defineComponent({
 
         return (
           <div
+            role="button"
+            tabindex={0}
+            aria-selected={dateCellOpts.isSelected}
             onClick={() => {
               setCurrentDate(dateCellOpts.date)
             }}
+            onKeydown={(e: KeyboardEvent) => {
+              if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault()
+                setCurrentDate(dateCellOpts.date)
+              }
+            }}
             class={[className, props.classNames?.cell]}
             style={props.styles?.cell}
           >
diff --git a/packages/ccui/ui/card-meta/src/card-meta-types.ts b/packages/ccui/ui/card-meta/src/card-meta-types.ts
index 71fcd871..5f84ae27 100644
--- a/packages/ccui/ui/card-meta/src/card-meta-types.ts
+++ b/packages/ccui/ui/card-meta/src/card-meta-types.ts
@@ -4,7 +4,7 @@ import type { ExtractPropTypes } from 'vue'
  * 卡片元信息组件：
  *
  * - `title` / `description` 两段文字
- * - `avatar` slot 左侧 64×64 头像
+ * - `avatar` slot 左侧 48×48 头像
  * - 三段都可用 slot 替换
  */
 export const cardMetaProps = {
diff --git a/packages/ccui/ui/card/src/card.scss b/packages/ccui/ui/card/src/card.scss
index d99b804b..f5a3c578 100644
--- a/packages/ccui/ui/card/src/card.scss
+++ b/packages/ccui/ui/card/src/card.scss
@@ -31,8 +31,7 @@
 }
 
 .#{$cls-prefix}-card--hover-shadow {
-  &:hover,
-  &:focus {
+  &:hover {
     box-shadow: $ccui-box-shadow;
   }
 }
diff --git a/packages/ccui/ui/card/src/card.tsx b/packages/ccui/ui/card/src/card.tsx
index e33ff3f4..c730a1f3 100644
--- a/packages/ccui/ui/card/src/card.tsx
+++ b/packages/ccui/ui/card/src/card.tsx
@@ -10,14 +10,14 @@ export default defineComponent({
   setup(props: CardProps, { slots }) {
     const ns = useNamespace('card')
 
-    const boxClass = `${ns.b()} ${ns.m(props.shadow)}-shadow`
+    const boxClass = computed(() => `${ns.b()} ${ns.m(`${props.shadow}-shadow`)}`)
 
     const isHeader = computed(() => {
       return props.header || slots.header
     })
 
     return () => (
-      <div class={[boxClass, props.classNames?.root]} style={props.styles?.root}>
+      <div class={[boxClass.value, props.classNames?.root]} style={props.styles?.root}>
         {slots.cover && (
           <div class={[ns.e('cover'), props.classNames?.cover]} style={props.styles?.cover}>
             {slots.cover()}
diff --git a/packages/ccui/ui/carousel/src/carousel.scss b/packages/ccui/ui/carousel/src/carousel.scss
index a7038155..62e04a28 100644
--- a/packages/ccui/ui/carousel/src/carousel.scss
+++ b/packages/ccui/ui/carousel/src/carousel.scss
@@ -100,7 +100,7 @@
       padding: 0;
       border: 0;
       border-radius: 2px;
-      background: rgba(0, 0, 0, 0.25);
+      background: $ccui-color-fill;
       cursor: pointer;
       transition:
         background 0.3s,
@@ -133,8 +133,8 @@
     padding: 0;
     border: 0;
     border-radius: 50%;
-    color: #fff;
-    background: rgba(0, 0, 0, 0.4);
+    color: $ccui-color-text-light-solid;
+    background: $ccui-color-bg-mask;
     font-size: 18px;
     line-height: 32px;
     text-align: center;
@@ -143,7 +143,7 @@
     transition: background 0.2s;
 
     &:hover {
-      background: rgba(0, 0, 0, 0.6);
+      background: $ccui-color-bg-spotlight;
     }
 
     &--prev {
diff --git a/packages/ccui/ui/carousel/src/carousel.tsx b/packages/ccui/ui/carousel/src/carousel.tsx
index 1cad8ee3..8816dac4 100644
--- a/packages/ccui/ui/carousel/src/carousel.tsx
+++ b/packages/ccui/ui/carousel/src/carousel.tsx
@@ -125,18 +125,20 @@ export default defineComponent({
       const step = slidesToScroll.value
       const max = isMulti.value ? maxActive.value : total.value - 1
       let target = active.value + step
-      // 多帧并排时，最后一页要对齐到 maxActive（不能越过；但 infinite 时仍可绕到 0）
-      if (isMulti.value && !props.infinite && target > max) target = max
-      // 多帧并排时，跨过 max 但 infinite=true → 回到 0
-      if (isMulti.value && props.infinite && active.value >= max) target = 0
+      // 多帧并排时，target 越过 max：已在末页才绕回 0，否则对齐到 maxActive（保证最后一页填满）
+      if (isMulti.value && target > max) {
+        target = props.infinite && active.value >= max ? 0 : max
+      }
       setActive(target)
     }
     function prev(): void {
       const step = slidesToScroll.value
       const max = isMulti.value ? maxActive.value : total.value - 1
       let target = active.value - step
-      // 多帧并排 + infinite：从 0 倒退应回到末页（active = maxActive）
-      if (isMulti.value && props.infinite && active.value <= 0) target = max
+      // 多帧并排时，target 越过 0：已在首页才绕到末页（active = maxActive），否则对齐到 0
+      if (isMulti.value && target < 0) {
+        target = props.infinite && active.value <= 0 ? max : 0
+      }
       setActive(target)
     }
     function getCurrentIndex(): number {
diff --git a/packages/ccui/ui/cascader/src/cascader.tsx b/packages/ccui/ui/cascader/src/cascader.tsx
index 2149d467..c0b2f376 100644
--- a/packages/ccui/ui/cascader/src/cascader.tsx
+++ b/packages/ccui/ui/cascader/src/cascader.tsx
@@ -148,7 +148,7 @@ export default defineComponent({
     })
 
     function pathKey(path: CascaderOption[]): string {
-      return path.map((n) => String(getOptionValue(n, fn.value))).join('
')
+      return JSON.stringify(path.map((n) => getOptionValue(n, fn.value)))
     }
 
     const checkedKeys = computed<Set<string>>(() => {
@@ -483,7 +483,7 @@ export default defineComponent({
         if (k === 'Enter') {
           e.preventDefault()
           if (focusedColumn.value === -1 && focusedIndex.value >= 0 && focusedIndex.value < results.length) {
-            pickSearchResult(results[focusedColumn.value === -1 ? focusedIndex.value : 0])
+            pickSearchResult(results[focusedIndex.value])
           }
         }
         return
diff --git a/packages/ccui/ui/check-box/src/check-box-group.tsx b/packages/ccui/ui/check-box/src/check-box-group.tsx
index 046ab839..297128f5 100644
--- a/packages/ccui/ui/check-box/src/check-box-group.tsx
+++ b/packages/ccui/ui/check-box/src/check-box-group.tsx
@@ -26,10 +26,10 @@ export default defineComponent({
         return
       }
 
-      // 如果找到了就删除对应下标的元素并更新数据
-      valueList.value.splice(index, 1)
-      emit('change', valueList.value)
-      emit('update:modelValue', valueList.value)
+      // 如果找到了就生成删除该元素后的新数组并更新数据（不原地 mutate prop）
+      const res = valueList.value.filter((item) => item !== val)
+      emit('change', res)
+      emit('update:modelValue', res)
     }
     const isItemChecked = (val: LabelType) => {
       // 验证数组中是否存在该项 返回boolean
@@ -44,13 +44,8 @@ export default defineComponent({
       isItemChecked,
     })
 
-    const directionType = {
-      row: 'is-row',
-      column: 'is-column',
-    }
-
     const checkBoxGroupClass = computed(() => {
-      return `${ns.b()} ${directionType[props.direction]}`
+      return `${ns.b()} ${ns.is(props.direction)}`
     })
 
     return () => {
diff --git a/packages/ccui/ui/check-box/src/check-box.tsx b/packages/ccui/ui/check-box/src/check-box.tsx
index 68713cff..cc3bbc3f 100644
--- a/packages/ccui/ui/check-box/src/check-box.tsx
+++ b/packages/ccui/ui/check-box/src/check-box.tsx
@@ -11,64 +11,65 @@ export default defineComponent({
   props: checkBoxProps,
   emits: ['change', 'update:modelValue'],
   setup(props: CheckBoxProps, { emit, slots }) {
-    return () => {
-      const ns = useNamespace('check-box')
+    const ns = useNamespace('check-box')
 
-      const checkBoxGroupInject = inject(checkBoxGroupInjectionKey, null)
+    const checkBoxGroupInject = inject(checkBoxGroupInjectionKey, null)
 
-      const isDisabled = computed(() => {
-        return checkBoxGroupInject?.disabled.value || props.disabled
-      })
+    const isDisabled = computed(() => {
+      return checkBoxGroupInject?.disabled.value || props.disabled
+    })
 
-      const isChecked = computed(() => {
-        return checkBoxGroupInject?.isItemChecked(props.label) || props.modelValue
-      })
+    const isChecked = computed(() => {
+      // group 模式只认 group 状态，独立模式返回纯布尔
+      return checkBoxGroupInject ? checkBoxGroupInject.isItemChecked(props.label) : !!props.modelValue
+    })
 
-      // 计算组件样式
-      const labelClass = computed(() => {
-        return `${ns.b()} ${isChecked.value ? 'active' : ''} ${isDisabled.value ? 'disabled' : ''}`
-      })
+    // 计算组件样式
+    const labelClass = computed(() => {
+      return `${ns.b()} ${isChecked.value ? 'active' : ''} ${isDisabled.value ? 'disabled' : ''}`
+    })
 
-      const iconColor = computed(() => {
-        const color = checkBoxGroupInject?.color.value || props.color
-        return color ? `color: ${color}; fill: ${color}` : ''
-      })
+    const iconColor = computed(() => {
+      const color = checkBoxGroupInject?.color.value || props.color
+      return color ? `color: ${color}; fill: ${color}` : ''
+    })
 
-      // todo 带测试逻辑
-      const judgeCanChange = (hasChecked: boolean, value: LabelType) => {
-        // 禁用状态不能切换
-        if (isDisabled.value) {
-          return Promise.resolve(false)
-        }
+    // todo 带测试逻辑
+    const judgeCanChange = (hasChecked: boolean, value: LabelType) => {
+      // 禁用状态不能切换
+      if (isDisabled.value) {
+        return Promise.resolve(false)
+      }
 
-        const beforeChange = checkBoxGroupInject?.beforeChange || props.beforeChange
+      const beforeChange = checkBoxGroupInject?.beforeChange || props.beforeChange
 
-        // 判断beforeChange事件是否存在
-        if (beforeChange) {
-          const res = beforeChange(hasChecked, value)
-          // 存在boolean 返回对应的值，否则直接返回
-          if (typeof res === 'boolean') {
-            return Promise.resolve(res)
-          }
-          return res
+      // 判断beforeChange事件是否存在
+      if (beforeChange) {
+        const res = beforeChange(hasChecked, value)
+        // 存在boolean 返回对应的值，否则直接返回
+        if (typeof res === 'boolean') {
+          return Promise.resolve(res)
         }
-
-        return Promise.resolve(true)
+        return res
       }
 
-      const handleChange = async () => {
-        const curStatus = !isChecked.value
+      return Promise.resolve(true)
+    }
 
-        void judgeCanChange(curStatus, props.label).then((res) => {
-          if (res) {
-            // 更新选中的数组
-            checkBoxGroupInject?.toggleGroupVal(props.label)
-            emit('change', curStatus)
-            emit('update:modelValue', curStatus)
-          }
-        })
-      }
+    const handleChange = async () => {
+      const curStatus = !isChecked.value
 
+      void judgeCanChange(curStatus, props.label).then((res) => {
+        if (res) {
+          // 更新选中的数组
+          checkBoxGroupInject?.toggleGroupVal(props.label)
+          emit('change', curStatus)
+          emit('update:modelValue', curStatus)
+        }
+      })
+    }
+
+    return () => {
       return (
         <label class={labelClass.value}>
           <input
diff --git a/packages/ccui/ui/checkable-tag/src/checkable-tag-group.tsx b/packages/ccui/ui/checkable-tag/src/checkable-tag-group.tsx
index a70d1728..59590d1c 100644
--- a/packages/ccui/ui/checkable-tag/src/checkable-tag-group.tsx
+++ b/packages/ccui/ui/checkable-tag/src/checkable-tag-group.tsx
@@ -58,7 +58,6 @@ export default defineComponent({
     const wrapperCls = computed(() => ({
       [ns.b()]: true,
       [ns.m('disabled')]: props.disabled,
-      [ns.m(sizeRef.value)]: true,
     }))
 
     return () => {
diff --git a/packages/ccui/ui/checkable-tag/src/checkable-tag.scss b/packages/ccui/ui/checkable-tag/src/checkable-tag.scss
index 045ff509..7a4c08dc 100644
--- a/packages/ccui/ui/checkable-tag/src/checkable-tag.scss
+++ b/packages/ccui/ui/checkable-tag/src/checkable-tag.scss
@@ -61,7 +61,6 @@
   }
 
   &--small {
-    font-size: $ccui-font-size-sm;
     line-height: 18px;
     padding-inline: 6px;
   }
@@ -71,7 +70,6 @@
   display: inline-flex;
   flex-wrap: wrap;
   align-items: center;
-  gap: 0 0;
 
   &--disabled {
     pointer-events: none;
diff --git a/packages/ccui/ui/collapse/src/collapse-item.tsx b/packages/ccui/ui/collapse/src/collapse-item.tsx
index 03685a05..bba7c2fe 100644
--- a/packages/ccui/ui/collapse/src/collapse-item.tsx
+++ b/packages/ccui/ui/collapse/src/collapse-item.tsx
@@ -26,6 +26,13 @@ export default defineComponent({
       ctx?.toggle(props.name)
     }
 
+    const handleKeydown = (e: KeyboardEvent) => {
+      if (e.key === 'Enter' || e.key === ' ') {
+        e.preventDefault()
+        handleClick()
+      }
+    }
+
     const onBeforeEnter = (el: Element) => {
       ;(el as HTMLElement).style.height = '0'
     }
@@ -84,12 +91,7 @@ export default defineComponent({
             aria-disabled={props.disabled || undefined}
             tabindex={props.disabled ? -1 : 0}
             onClick={handleClick}
-            onKeydown={(e: KeyboardEvent) => {
-              if (e.key === 'Enter' || e.key === ' ') {
-                e.preventDefault()
-                handleClick()
-              }
-            }}
+            onKeydown={handleKeydown}
           >
             {headerChildren}
           </div>
diff --git a/packages/ccui/ui/collapse/src/collapse.scss b/packages/ccui/ui/collapse/src/collapse.scss
index c714b967..029449cc 100644
--- a/packages/ccui/ui/collapse/src/collapse.scss
+++ b/packages/ccui/ui/collapse/src/collapse.scss
@@ -1,7 +1,7 @@
 @use '../../style-var/index.scss' as *;
 
 .#{$cls-prefix}-collapse {
-  background-color: rgba(0, 0, 0, 0.02);
+  background-color: $ccui-color-fill-quaternary;
   border: 1px solid $ccui-color-border;
   border-radius: $ccui-border-radius;
   border-bottom: 0;
@@ -29,7 +29,7 @@
     transition: background-color $ccui-motion-duration-mid;
 
     &:hover {
-      background-color: rgba(0, 0, 0, 0.02);
+      background-color: $ccui-color-fill-quaternary;
     }
   }
 
diff --git a/packages/ccui/ui/collapse/src/collapse.tsx b/packages/ccui/ui/collapse/src/collapse.tsx
index 76fdcb25..a4ee1cdf 100644
--- a/packages/ccui/ui/collapse/src/collapse.tsx
+++ b/packages/ccui/ui/collapse/src/collapse.tsx
@@ -25,9 +25,9 @@ export default defineComponent({
     const activeNames = ref<(string | number)[]>(normalize(props.modelValue, props.accordion))
 
     watch(
-      () => props.modelValue,
-      (val) => {
-        activeNames.value = normalize(val, props.accordion)
+      () => [props.modelValue, props.accordion] as const,
+      ([val, acc]) => {
+        activeNames.value = normalize(val, acc)
       },
     )
 
diff --git a/packages/ccui/ui/color-picker/src/color-picker.scss b/packages/ccui/ui/color-picker/src/color-picker.scss
index 9ddc31aa..b8b6537e 100644
--- a/packages/ccui/ui/color-picker/src/color-picker.scss
+++ b/packages/ccui/ui/color-picker/src/color-picker.scss
@@ -51,10 +51,10 @@
     }
 
     &--status-error {
-      border-color: #ff4d4f;
+      border-color: $ccui-color-error;
     }
     &--status-warning {
-      border-color: #faad14;
+      border-color: $ccui-color-warning;
     }
   }
 
@@ -92,7 +92,7 @@
   }
 
   &__value-text {
-    color: rgba(0, 0, 0, 0.85);
+    color: $ccui-color-text;
     font-size: 13px;
     font-family: monospace;
   }
@@ -226,7 +226,7 @@
   }
 
   &__hash {
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
     margin-right: 4px;
     user-select: none;
   }
@@ -237,7 +237,7 @@
     border: 0;
     outline: 0;
     background: transparent;
-    color: rgba(0, 0, 0, 0.88);
+    color: $ccui-color-text;
     font-size: 13px;
     font-family: monospace;
     text-transform: uppercase;
@@ -264,7 +264,7 @@
     border: 0;
     outline: 0;
     background: transparent;
-    color: rgba(0, 0, 0, 0.88);
+    color: $ccui-color-text;
     font-size: 13px;
     text-align: right;
     -moz-appearance: textfield;
@@ -277,7 +277,7 @@
   }
 
   &__alpha-suffix {
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
     font-size: 13px;
     margin-left: 2px;
   }
@@ -296,7 +296,7 @@
   }
 
   &__preset-group-label {
-    color: rgba(0, 0, 0, 0.65);
+    color: $ccui-color-text-secondary;
     font-size: 12px;
     line-height: 1.4;
   }
diff --git a/packages/ccui/ui/color-picker/src/color-picker.tsx b/packages/ccui/ui/color-picker/src/color-picker.tsx
index 5495a218..addebcee 100644
--- a/packages/ccui/ui/color-picker/src/color-picker.tsx
+++ b/packages/ccui/ui/color-picker/src/color-picker.tsx
@@ -65,7 +65,11 @@ export default defineComponent({
       const raw = isControlled.value ? props.modelValue : innerValue.value
       return raw ?? DEFAULT_COLOR_HEX
     })
-    const currentRgb = computed<RGB>(() => hexToRgb(currentHex.value) ?? hexToRgb(DEFAULT_COLOR_HEX)!)
+    const currentRgb = computed<RGB>(() => {
+      const rgb = hexToRgb(currentHex.value) ?? hexToRgb(DEFAULT_COLOR_HEX)!
+      // disabledAlpha 时强制不透明，避免外部传入 8 位带 alpha 的 hex 让 swatch/显示文本仍带透明度
+      return props.disabledAlpha ? { ...rgb, a: 1 } : rgb
+    })
     // pending 状态供面板内部编辑使用
     const pendingHsv = shallowRef<HSV>(rgbToHsv(currentRgb.value))
 
@@ -160,9 +164,11 @@ export default defineComponent({
       const up = () => {
         document.removeEventListener('pointermove', move)
         document.removeEventListener('pointerup', up)
+        document.removeEventListener('pointercancel', up)
       }
       document.addEventListener('pointermove', move)
       document.addEventListener('pointerup', up)
+      document.addEventListener('pointercancel', up)
     }
 
     function onSvPointerDown(e: PointerEvent) {
@@ -411,6 +417,11 @@ export default defineComponent({
           onPointerdown={onHuePointerDown}
           onKeydown={onHueKeydown}
           tabindex={0}
+          role="slider"
+          aria-label="hue"
+          aria-valuemin={0}
+          aria-valuemax={360}
+          aria-valuenow={Math.round(pendingHsv.value.h)}
         >
           <div class={ns.e('hue-cursor')} style={cursorStyle} />
         </div>
@@ -431,6 +442,11 @@ export default defineComponent({
           onPointerdown={onAlphaPointerDown}
           onKeydown={onAlphaKeydown}
           tabindex={0}
+          role="slider"
+          aria-label="alpha"
+          aria-valuemin={0}
+          aria-valuemax={100}
+          aria-valuenow={Math.round(pendingHsv.value.a * 100)}
         >
           <div class={ns.e('alpha-track')} style={trackStyle} />
           <div class={ns.e('alpha-cursor')} style={cursorStyle} />
diff --git a/packages/ccui/ui/config-provider/src/config-provider.tsx b/packages/ccui/ui/config-provider/src/config-provider.tsx
index 4cf19644..5370474f 100644
--- a/packages/ccui/ui/config-provider/src/config-provider.tsx
+++ b/packages/ccui/ui/config-provider/src/config-provider.tsx
@@ -78,7 +78,7 @@ export const ConfigProvider = defineComponent({
     // locale 变更时切全局 dayjs locale。ConfigProvider locale.locale 用 'zh-CN' / 'en-US' /
     // 'ja-JP' / 'ko-KR' 命名，dayjs 用小写的 'zh-cn' / 'en' / 'ja' / 'ko'，做一次映射。
     watch(
-      () => ctx.value.locale?.locale,
+      () => mergeLocale(props.locale).locale,
       (name) => {
         if (!name) return
         void setDayjsLocale(name)
diff --git a/packages/ccui/ui/date-picker/src/date-picker.tsx b/packages/ccui/ui/date-picker/src/date-picker.tsx
index c75b9550..d40b6c77 100644
--- a/packages/ccui/ui/date-picker/src/date-picker.tsx
+++ b/packages/ccui/ui/date-picker/src/date-picker.tsx
@@ -295,9 +295,19 @@ export default defineComponent({
     function clickNow() {
       const now = dayjs()
       if (showTimeActive.value) {
+        // 与 cell 选择 / 时间列保持一致：此刻命中 disabledDate / minDate / maxDate / disabledTime 时不提交
+        if (isDateDisabled(now)) return
+        if (
+          mergedDisabledHours().includes(now.hour()) ||
+          mergedDisabledMinutes(now.hour()).includes(now.minute()) ||
+          mergedDisabledSeconds(now.hour(), now.minute()).includes(now.second())
+        )
+          return
         emitChange(now)
       } else {
-        emitChange(now.startOf('day'))
+        const target = now.startOf('day')
+        if (isDateDisabled(target)) return
+        emitChange(target)
       }
       closePopup()
     }
diff --git a/packages/ccui/ui/descriptions/src/descriptions.scss b/packages/ccui/ui/descriptions/src/descriptions.scss
index ac9e00a2..b8167899 100644
--- a/packages/ccui/ui/descriptions/src/descriptions.scss
+++ b/packages/ccui/ui/descriptions/src/descriptions.scss
@@ -82,7 +82,7 @@
     }
 
     .#{$cls-prefix}-descriptions__label {
-      background-color: rgba(0, 0, 0, 0.02);
+      background-color: $ccui-color-fill-quaternary;
       font-weight: 500;
       width: auto;
     }
diff --git a/packages/ccui/ui/descriptions/src/descriptions.tsx b/packages/ccui/ui/descriptions/src/descriptions.tsx
index 00c42248..d54c6066 100644
--- a/packages/ccui/ui/descriptions/src/descriptions.tsx
+++ b/packages/ccui/ui/descriptions/src/descriptions.tsx
@@ -131,7 +131,13 @@ export default defineComponent({
                     <Fragment key={`r-${rIdx}`}>
                       <tr class={ns.e('row')}>
                         {row.map((it, idx) => (
-                          <th key={`l-${idx}`} class={ns.e('label')} colspan={it.span} style={it.labelStyle}>
+                          <th
+                            key={`l-${idx}`}
+                            class={ns.e('label')}
+                            scope="col"
+                            colspan={it.span}
+                            style={it.labelStyle}
+                          >
                             {it.label}
                             {props.colon && !props.bordered ? ':' : ''}
                           </th>
@@ -153,7 +159,7 @@ export default defineComponent({
                       if (props.bordered) {
                         return (
                           <Fragment key={`p-${idx}`}>
-                            <th class={ns.e('label')} style={it.labelStyle}>
+                            <th class={ns.e('label')} scope="row" style={it.labelStyle}>
                               {it.label}
                             </th>
                             <td class={ns.e('content')} colspan={it.span * 2 - 1} style={it.contentStyle}>
diff --git a/packages/ccui/ui/divider/src/divider.tsx b/packages/ccui/ui/divider/src/divider.tsx
index fd4db55d..23f715f9 100644
--- a/packages/ccui/ui/divider/src/divider.tsx
+++ b/packages/ccui/ui/divider/src/divider.tsx
@@ -33,17 +33,17 @@ export default defineComponent({
     })
 
     const dividerTextCls = computed(() => {
-      return `${ns.e('text')} is-${props.contentPosition}`
+      return `${ns.e('text')} ${ns.is(props.contentPosition)}`
     })
 
-    return () => {
-      return (
-        <div class={dividerCls.value} style={dividerStyle.value}>
+    return () => (
+      <div class={dividerCls.value} style={dividerStyle.value}>
+        {props.direction === 'horizontal' && slots.default ? (
           <div class={dividerTextCls.value} style={dividerTextStyle.value}>
-            {slots.default && slots.default()}
+            {slots.default()}
           </div>
-        </div>
-      )
-    }
+        ) : null}
+      </div>
+    )
   },
 })
diff --git a/packages/ccui/ui/drawer/src/drawer.scss b/packages/ccui/ui/drawer/src/drawer.scss
index de1680e7..aeba8f2d 100644
--- a/packages/ccui/ui/drawer/src/drawer.scss
+++ b/packages/ccui/ui/drawer/src/drawer.scss
@@ -8,7 +8,7 @@
   &__mask {
     position: fixed;
     inset: 0;
-    background-color: rgba(0, 0, 0, 0.45);
+    background-color: $ccui-color-bg-mask;
     pointer-events: auto;
   }
 
@@ -22,6 +22,8 @@
     pointer-events: auto;
     display: flex;
     flex-direction: column;
+    // body 区 transform 过渡（用于 push 嵌套抽屉让位）
+    transition: transform $ccui-motion-duration-mid cubic-bezier(0.7, 0.3, 0.1, 1);
   }
 
   &__inner {
@@ -55,11 +57,6 @@
     margin-inline-start: 8px;
   }
 
-  // body 区 transform 过渡（用于 push 嵌套抽屉让位）
-  &__content {
-    transition: transform $ccui-motion-duration-mid cubic-bezier(0.7, 0.3, 0.1, 1);
-  }
-
   // loading 状态的骨架占位
   &__skeleton {
     display: flex;
@@ -116,7 +113,7 @@
 
     &:hover {
       color: $ccui-color-text;
-      background-color: rgba(0, 0, 0, 0.06);
+      background-color: $ccui-color-fill-secondary;
     }
   }
 
diff --git a/packages/ccui/ui/dropdown/src/dropdown.scss b/packages/ccui/ui/dropdown/src/dropdown.scss
index 55f8f342..c6d6949d 100644
--- a/packages/ccui/ui/dropdown/src/dropdown.scss
+++ b/packages/ccui/ui/dropdown/src/dropdown.scss
@@ -40,21 +40,22 @@
       background-color: $ccui-color-bg-text-hover;
     }
 
-    &--disabled {
-      color: $ccui-color-text-disabled;
-      cursor: not-allowed;
+    &--danger {
+      color: $ccui-color-error;
 
       &:hover {
-        background-color: transparent;
+        color: #ffffff;
+        background-color: $ccui-color-error;
       }
     }
 
-    &--danger {
-      color: $ccui-color-error;
+    &--disabled {
+      color: $ccui-color-text-disabled;
+      cursor: not-allowed;
 
       &:hover {
-        color: #ffffff;
-        background-color: $ccui-color-error;
+        color: $ccui-color-text-disabled;
+        background-color: transparent;
       }
     }
 
diff --git a/packages/ccui/ui/dropdown/src/dropdown.tsx b/packages/ccui/ui/dropdown/src/dropdown.tsx
index f0c3e143..750c0c93 100644
--- a/packages/ccui/ui/dropdown/src/dropdown.tsx
+++ b/packages/ccui/ui/dropdown/src/dropdown.tsx
@@ -77,7 +77,15 @@ export default defineComponent({
                         item.divided && ns.em('item', 'divided'),
                       ]}
                       role="menuitem"
+                      aria-disabled={item.disabled || undefined}
+                      tabindex={item.disabled ? undefined : 0}
                       onClick={() => onSelect(item)}
+                      onKeydown={(e: KeyboardEvent) => {
+                        if (e.key === 'Enter' || e.key === ' ') {
+                          e.preventDefault()
+                          onSelect(item)
+                        }
+                      }}
                     >
                       {item.icon && <i class={[ns.e('icon'), item.icon]} />}
                       <span class={ns.e('label')}>{item.label}</span>
diff --git a/packages/ccui/ui/empty/src/empty.tsx b/packages/ccui/ui/empty/src/empty.tsx
index 600edb69..379b4ec8 100644
--- a/packages/ccui/ui/empty/src/empty.tsx
+++ b/packages/ccui/ui/empty/src/empty.tsx
@@ -6,14 +6,14 @@ import { emptyProps } from './empty-types'
 import './empty.scss'
 
 const DEFAULT_IMG = (
-  <svg width="64" height="41" viewBox="0 0 64 41" xmlns="http://www.w3.org/2000/svg">
+  <svg aria-hidden="true" width="64" height="41" viewBox="0 0 64 41" xmlns="http://www.w3.org/2000/svg">
     <g transform="translate(0 1)" fill="none" fill-rule="evenodd">
-      <ellipse fill="#f5f5f5" cx="32" cy="33" rx="32" ry="7" />
-      <g fill-rule="nonzero" stroke="#d9d9d9">
+      <ellipse fill="var(--ccui-color-fill-quaternary, #f5f5f5)" cx="32" cy="33" rx="32" ry="7" />
+      <g fill-rule="nonzero" stroke="var(--ccui-line, #d9d9d9)">
         <path d="M55 12.76L44.854 1.258C44.367.474 43.656 0 42.907 0H21.093c-.749 0-1.46.474-1.947 1.257L9 12.761V22h46v-9.24z" />
         <path
           d="M41.613 15.931c0-1.605.994-2.93 2.227-2.931H55v18.137C55 33.26 53.68 35 52.05 35h-40.1C10.32 35 9 33.259 9 31.137V13h11.16c1.233 0 2.227 1.323 2.227 2.928v.022c0 1.605 1.005 2.901 2.237 2.901h14.752c1.232 0 2.237-1.308 2.237-2.913v-.007z"
-          fill="#fafafa"
+          fill="var(--ccui-color-fill-quaternary, #fafafa)"
         />
       </g>
     </g>
@@ -31,7 +31,7 @@ export default defineComponent({
     return () => (
       <div class={ns.b()}>
         <div class={ns.e('image')} style={props.imageStyle}>
-          {slots.image ? slots.image() : props.image ? <img src={props.image} alt="empty" /> : DEFAULT_IMG}
+          {slots.image ? slots.image() : props.image ? <img src={props.image} alt="" /> : DEFAULT_IMG}
         </div>
         <div class={ns.e('description')}>{slots.description ? slots.description() : descLocal.value}</div>
         {slots.default && <div class={ns.e('footer')}>{slots.default()}</div>}
diff --git a/packages/ccui/ui/flex/src/flex.tsx b/packages/ccui/ui/flex/src/flex.tsx
index c2a3ba48..17f7cfc9 100644
--- a/packages/ccui/ui/flex/src/flex.tsx
+++ b/packages/ccui/ui/flex/src/flex.tsx
@@ -14,7 +14,7 @@ export default defineComponent({
     const ns = useNamespace('flex')
 
     const style = computed<CSSProperties>(() => {
-      const wrapValue = props.wrap === true ? 'wrap' : props.wrap === false ? 'nowrap' : props.wrap
+      const wrapValue = props.wrap === true ? 'wrap' : props.wrap === false ? undefined : props.wrap // 'nowrap' 是默认值，无需输出
       let gapValue: string | undefined
       if (props.gap !== undefined && props.gap !== null) {
         if (typeof props.gap === 'number') {
@@ -24,11 +24,11 @@ export default defineComponent({
         }
       }
       return {
-        flexDirection: props.vertical ? 'column' : 'row',
+        flexDirection: props.vertical ? 'column' : undefined,
         flexWrap: wrapValue,
-        justifyContent: props.justify,
-        alignItems: props.align,
-        flex: props.flex,
+        justifyContent: props.justify === 'normal' ? undefined : props.justify,
+        alignItems: props.align === 'normal' ? undefined : props.align,
+        flex: props.flex === 'normal' ? undefined : props.flex,
         gap: gapValue,
       }
     })
diff --git a/packages/ccui/ui/float-button/src/back-top.tsx b/packages/ccui/ui/float-button/src/back-top.tsx
index 1215d273..06c0dfdd 100644
--- a/packages/ccui/ui/float-button/src/back-top.tsx
+++ b/packages/ccui/ui/float-button/src/back-top.tsx
@@ -1,5 +1,5 @@
 import type { BackTopProps } from './float-button-types'
-import { defineComponent, onBeforeUnmount, onMounted, ref, Transition } from 'vue'
+import { computed, defineComponent, onBeforeUnmount, onMounted, ref, Transition, watch } from 'vue'
 import { renderIconNode } from '../../shared/hooks/use-icon'
 import { useNamespace } from '../../shared/hooks/use-namespace'
 import { backTopProps } from './float-button-types'
@@ -40,10 +40,11 @@ function scrollTo(target: HTMLElement | Window, to: number, duration: number) {
       ;(target as HTMLElement).scrollTop = value
     }
     if (progress < 1) {
-      requestAnimationFrame(frame)
+      rafId = requestAnimationFrame(frame)
     }
   }
-  requestAnimationFrame(frame)
+  let rafId = requestAnimationFrame(frame)
+  return () => cancelAnimationFrame(rafId)
 }
 
 export default defineComponent({
@@ -54,6 +55,8 @@ export default defineComponent({
     const ns = useNamespace('float-button')
     const visible = ref(false)
     let container: HTMLElement | Window | null = null
+    // 跟踪滚动动画的取消句柄，组件卸载时需取消，避免卸载后仍有 rAF 副作用
+    let cancelScroll: (() => void) | null = null
 
     const onScroll = () => {
       if (!container) {
@@ -65,25 +68,46 @@ export default defineComponent({
     const onClick = (e: MouseEvent) => {
       emit('click', e)
       if (container) {
-        scrollTo(container, 0, props.duration)
+        // 先取消上一次未结束的滚动动画，再开启新的
+        cancelScroll?.()
+        cancelScroll = scrollTo(container, 0, props.duration)
       }
     }
 
-    onMounted(() => {
+    // 绑定/解绑滚动监听；target 变更后需重新解析容器并重绑
+    const bind = () => {
       container = resolveTarget(props.target)
       container.addEventListener('scroll', onScroll, { passive: true })
       onScroll()
-    })
-    onBeforeUnmount(() => {
+    }
+    const unbind = () => {
       container?.removeEventListener('scroll', onScroll)
+      // 解绑后必须置 null，避免重复绑定时旧容器引用残留
+      container = null
+    }
+
+    onMounted(bind)
+    onBeforeUnmount(() => {
+      unbind()
+      // 取消可能仍在进行的滚动动画，避免卸载后副作用
+      cancelScroll?.()
     })
+    // target 变更后重新绑定，使 visible 计算基于最新容器
+    watch(
+      () => props.target,
+      () => {
+        unbind()
+        bind()
+      },
+    )
 
-    const cls = [ns.b(), ns.m(props.shape), ns.m(props.type), ns.m('back-top')]
+    // class 需随 shape/type 响应式变更，故用 computed 包裹
+    const cls = computed(() => [ns.b(), ns.m(props.shape), ns.m(props.type), ns.m('back-top')])
 
     return () => (
       <Transition name={`${ns.b()}-fade`}>
         {visible.value && (
-          <button class={cls} type="button" onClick={onClick} aria-label="Back to top">
+          <button class={cls.value} type="button" onClick={onClick} aria-label="Back to top">
             <span class={ns.e('body')}>
               <span class={ns.e('content')}>
                 <span class={ns.e('icon')}>
diff --git a/packages/ccui/ui/float-button/src/float-button.scss b/packages/ccui/ui/float-button/src/float-button.scss
index 99c1b6b5..1198b224 100644
--- a/packages/ccui/ui/float-button/src/float-button.scss
+++ b/packages/ccui/ui/float-button/src/float-button.scss
@@ -65,7 +65,7 @@
     min-width: 16px;
     height: 16px;
     padding: 0 4px;
-    color: #ffffff;
+    color: $ccui-color-white;
     background: $ccui-color-error;
     font-size: 12px;
     line-height: 16px;
@@ -87,7 +87,7 @@
   }
 
   &--primary {
-    color: #ffffff;
+    color: $ccui-color-white;
     background-color: $ccui-color-primary;
 
     &:hover {
diff --git a/packages/ccui/ui/form/src/form-item.tsx b/packages/ccui/ui/form/src/form-item.tsx
index 6a74f488..1b2bbbd4 100644
--- a/packages/ccui/ui/form/src/form-item.tsx
+++ b/packages/ccui/ui/form/src/form-item.tsx
@@ -273,6 +273,11 @@ export default defineComponent({
     })
 
     onUnmounted(() => {
+      // 卸载时清理仍处于防抖窗口的定时器，避免触发已卸载组件的 doValidate
+      if (validateTimer) {
+        clearTimeout(validateTimer)
+        validateTimer = null
+      }
       form?.removeField(fieldContext)
       const itemPreserve = props.preserve
       const formPreserve = form?.preserve.value ?? true
diff --git a/packages/ccui/ui/form/src/form-list.tsx b/packages/ccui/ui/form/src/form-list.tsx
index e32fa0a2..a1a61df8 100644
--- a/packages/ccui/ui/form/src/form-list.tsx
+++ b/packages/ccui/ui/form/src/form-list.tsx
@@ -41,6 +41,11 @@ export default defineComponent({
       syncKeys(list.length)
     })
 
+    // 契约说明：外部对该数组的头部/中部增删（splice）必须通过 operation.add/remove/move，
+    // 以保证 keys 与元素一一对齐。此处的 syncKeys 仅是针对“整数组替换”的粗粒度对账：
+    // 它只在末尾补 seed 或截断尾部，元素本身又没有可用的 identity 字段，
+    // 因此对非末尾的增删它无法正确重排 key（会让后续表单项复用错误的 key，导致状态/校验串位）。
+    // 这里刻意不做基于值的“智能重排”——没有稳定身份字段时任何猜测都可能造成更严重的错位。
     watch(
       () => (form ? getValueByPath(form.model.value, props.name) : undefined),
       (next) => {
diff --git a/packages/ccui/ui/grid/src/grid.tsx b/packages/ccui/ui/grid/src/grid.tsx
index 9c3902e3..7b958cde 100644
--- a/packages/ccui/ui/grid/src/grid.tsx
+++ b/packages/ccui/ui/grid/src/grid.tsx
@@ -177,9 +177,17 @@ export const Col = defineComponent({
         s.paddingInlineStart = `${h / 2}px`
         s.paddingInlineEnd = `${h / 2}px`
       }
+      const toFlex = (f: string | number) => (typeof f === 'number' ? `${f} ${f} auto` : String(f))
+      // 断点级 flex：按 BREAKPOINTS 顺序遍历，最后一个生效（last active wins）
+      for (const bp of BREAKPOINTS) {
+        const size = computedSizes.value[bp]
+        if (size && size.flex !== undefined) {
+          s.flex = toFlex(size.flex)
+        }
+      }
+      // 顶层 flex 优先级最高，覆盖断点级 flex
       if (props.flex !== undefined) {
-        const flex = typeof props.flex === 'number' ? `${props.flex} ${props.flex} auto` : String(props.flex)
-        s.flex = flex
+        s.flex = toFlex(props.flex)
       }
       return s
     })
diff --git a/packages/ccui/ui/icon/src/icon.tsx b/packages/ccui/ui/icon/src/icon.tsx
index a17d0c5a..3ff3774f 100644
--- a/packages/ccui/ui/icon/src/icon.tsx
+++ b/packages/ccui/ui/icon/src/icon.tsx
@@ -97,9 +97,7 @@ export default defineComponent({
       if (props.twoToneColor) {
         style['--ccui-icon-two-tone-color'] = props.twoToneColor
       }
-      if (props.rotate !== undefined) {
-        style['--ccui-icon-rotate'] = `${props.rotate}deg`
-      }
+      style['--ccui-icon-rotate'] = `${props.rotate}deg`
       return style
     })
 
diff --git a/packages/ccui/ui/image-preview/src/image-preview.scss b/packages/ccui/ui/image-preview/src/image-preview.scss
index 245c26f5..6857084a 100644
--- a/packages/ccui/ui/image-preview/src/image-preview.scss
+++ b/packages/ccui/ui/image-preview/src/image-preview.scss
@@ -22,7 +22,7 @@
     position: fixed;
     inset: 0;
     z-index: 1100;
-    background-color: rgba(0, 0, 0, 0.45);
+    background-color: $ccui-color-bg-mask;
     display: flex;
     align-items: center;
     justify-content: center;
diff --git a/packages/ccui/ui/image-preview/src/image-preview.tsx b/packages/ccui/ui/image-preview/src/image-preview.tsx
index e54df35f..595b5c93 100644
--- a/packages/ccui/ui/image-preview/src/image-preview.tsx
+++ b/packages/ccui/ui/image-preview/src/image-preview.tsx
@@ -33,8 +33,11 @@ export default defineComponent({
     })
 
     const current = computed(() => {
-      if (isControlled.value) return props.preview?.current ?? 0
-      return innerCurrent.value
+      const total = items.value.length
+      const raw = isControlled.value ? (props.preview?.current ?? 0) : innerCurrent.value
+      if (total === 0) return 0
+      // 归一化，避免父组件传入越界 current 导致 activeItem 为 undefined
+      return ((raw % total) + total) % total
     })
 
     const setVisible = (next: boolean) => {
@@ -53,9 +56,18 @@ export default defineComponent({
     }
 
     const openAt = (idx: number) => {
-      setCurrent(idx)
+      const total = items.value.length
+      if (total === 0) return
+      const target = ((idx % total) + total) % total
+      if (!isControlled.value) {
+        innerCurrent.value = target
+        innerVisible.value = true
+      }
       scale.value = 1
-      setVisible(true)
+      // 同时变更 current 与 visible，合并为一次 update:preview，避免受控下两次 emit 互相用对方旧值覆盖
+      emit('change', target)
+      emit('visible-change', true)
+      emit('update:preview', { ...props.preview, visible: true, current: target })
     }
 
     const close = () => {
@@ -93,14 +105,18 @@ export default defineComponent({
       }
     }
 
-    watch(visible, (val) => {
-      if (typeof window === 'undefined') return
-      if (val) {
-        window.addEventListener('keydown', onKeydown)
-      } else {
-        window.removeEventListener('keydown', onKeydown)
-      }
-    })
+    watch(
+      visible,
+      (val) => {
+        if (typeof window === 'undefined') return
+        if (val) {
+          window.addEventListener('keydown', onKeydown)
+        } else {
+          window.removeEventListener('keydown', onKeydown)
+        }
+      },
+      { immediate: true },
+    )
 
     onBeforeUnmount(() => {
       if (typeof window !== 'undefined') window.removeEventListener('keydown', onKeydown)
@@ -114,7 +130,16 @@ export default defineComponent({
         class: ns.e('thumb'),
         src: item.src,
         alt: item.alt ?? '',
+        // 缩略图作为打开预览的交互元素，需键盘可达（Enter/Space 与点击行为一致）
+        tabindex: 0,
+        role: 'button',
         onClick: () => openAt(idx),
+        onKeydown: (e: KeyboardEvent) => {
+          if (e.key === 'Enter' || e.key === ' ') {
+            e.preventDefault()
+            openAt(idx)
+          }
+        },
       })
 
     const renderOverlay = () =>
diff --git a/packages/ccui/ui/image/src/image.scss b/packages/ccui/ui/image/src/image.scss
index 88be74a1..a3b760d2 100644
--- a/packages/ccui/ui/image/src/image.scss
+++ b/packages/ccui/ui/image/src/image.scss
@@ -26,7 +26,7 @@
     height: 100%;
     min-width: 80px;
     min-height: 80px;
-    background-color: rgba(0, 0, 0, 0.04);
+    background-color: $ccui-color-fill-tertiary;
     color: $ccui-color-text-disabled;
     font-size: $ccui-font-size-sm;
   }
diff --git a/packages/ccui/ui/image/src/image.tsx b/packages/ccui/ui/image/src/image.tsx
index 49526ec6..20b9cb29 100644
--- a/packages/ccui/ui/image/src/image.tsx
+++ b/packages/ccui/ui/image/src/image.tsx
@@ -69,6 +69,9 @@ export default defineComponent({
 
     let observer: IntersectionObserver | null = null
     const setupLazy = () => {
+      // 先释放上一次的 observer，避免 src 连续切换时旧 observer 泄漏
+      observer?.disconnect()
+      observer = null
       if (!props.lazy || !wrapperRef.value) {
         return
       }
diff --git a/packages/ccui/ui/input-number/src/input-number.tsx b/packages/ccui/ui/input-number/src/input-number.tsx
index 0336e0e4..03cd4bc9 100644
--- a/packages/ccui/ui/input-number/src/input-number.tsx
+++ b/packages/ccui/ui/input-number/src/input-number.tsx
@@ -36,13 +36,13 @@ export default defineComponent({
 
     // 计算是否禁用增加按钮
     const maxDisabled = computed(() => {
-      if (innerValue.value === undefined) return false
+      if (innerValue.value === undefined || innerValue.value === null) return false
       return innerValue.value >= props.max
     })
 
     // 计算是否禁用减少按钮
     const minDisabled = computed(() => {
-      if (innerValue.value === undefined) return false
+      if (innerValue.value === undefined || innerValue.value === null) return false
       return innerValue.value <= props.min
     })
 
@@ -237,7 +237,16 @@ export default defineComponent({
             <span
               class={[ns.e('decrease'), { [ns.is('disabled')]: minDisabled.value || props.disabled }]}
               role="button"
+              tabindex={minDisabled.value || props.disabled ? -1 : 0}
+              aria-label="减少"
+              aria-disabled={minDisabled.value || props.disabled || undefined}
               onClick={decrease}
+              onKeydown={(e: KeyboardEvent) => {
+                if (e.key === 'Enter' || e.key === ' ') {
+                  e.preventDefault()
+                  decrease()
+                }
+              }}
             >
               <svg viewBox="0 0 1024 1024" width="1em" height="1em">
                 <path d="M128 544h768a32 32 0 1 0 0-64H128a32 32 0 0 0 0 64z" />
@@ -278,7 +287,16 @@ export default defineComponent({
             <span
               class={[ns.e('increase'), { [ns.is('disabled')]: maxDisabled.value || props.disabled }]}
               role="button"
+              tabindex={maxDisabled.value || props.disabled ? -1 : 0}
+              aria-label="增加"
+              aria-disabled={maxDisabled.value || props.disabled || undefined}
               onClick={increase}
+              onKeydown={(e: KeyboardEvent) => {
+                if (e.key === 'Enter' || e.key === ' ') {
+                  e.preventDefault()
+                  increase()
+                }
+              }}
             >
               <svg viewBox="0 0 1024 1024" width="1em" height="1em">
                 <path d="M480 480V128a32 32 0 0 1 64 0v352h352a32 32 0 1 1 0 64H544v352a32 32 0 1 1-64 0V544H128a32 32 0 0 1 0-64h352z" />
@@ -292,7 +310,16 @@ export default defineComponent({
               <span
                 class={[ns.e('increase'), { [ns.is('disabled')]: maxDisabled.value || props.disabled }]}
                 role="button"
+                tabindex={maxDisabled.value || props.disabled ? -1 : 0}
+                aria-label="增加"
+                aria-disabled={maxDisabled.value || props.disabled || undefined}
                 onClick={increase}
+                onKeydown={(e: KeyboardEvent) => {
+                  if (e.key === 'Enter' || e.key === ' ') {
+                    e.preventDefault()
+                    increase()
+                  }
+                }}
               >
                 <svg viewBox="0 0 1024 1024" width="1em" height="1em">
                   <path d="M480 480V128a32 32 0 0 1 64 0v352h352a32 32 0 1 1 0 64H544v352a32 32 0 1 1-64 0V544H128a32 32 0 0 1 0-64h352z" />
@@ -301,7 +328,16 @@ export default defineComponent({
               <span
                 class={[ns.e('decrease'), { [ns.is('disabled')]: minDisabled.value || props.disabled }]}
                 role="button"
+                tabindex={minDisabled.value || props.disabled ? -1 : 0}
+                aria-label="减少"
+                aria-disabled={minDisabled.value || props.disabled || undefined}
                 onClick={decrease}
+                onKeydown={(e: KeyboardEvent) => {
+                  if (e.key === 'Enter' || e.key === ' ') {
+                    e.preventDefault()
+                    decrease()
+                  }
+                }}
               >
                 <svg viewBox="0 0 1024 1024" width="1em" height="1em">
                   <path d="M128 544h768a32 32 0 1 0 0-64H128a32 32 0 0 0 0 64z" />
diff --git a/packages/ccui/ui/input-otp/src/input-otp.scss b/packages/ccui/ui/input-otp/src/input-otp.scss
index ff8fdbce..1556f398 100644
--- a/packages/ccui/ui/input-otp/src/input-otp.scss
+++ b/packages/ccui/ui/input-otp/src/input-otp.scss
@@ -52,13 +52,6 @@
     font-size: $ccui-font-size-sm;
   }
 
-  &--disabled &__cell {
-    background-color: $ccui-disabled-bg;
-    border-color: $ccui-disabled-line;
-    color: $ccui-disabled-text;
-    cursor: not-allowed;
-  }
-
   &--status-error &__cell {
     border-color: $ccui-color-error;
 
diff --git a/packages/ccui/ui/input-otp/src/input-otp.tsx b/packages/ccui/ui/input-otp/src/input-otp.tsx
index bb06bd9c..a5d69b45 100644
--- a/packages/ccui/ui/input-otp/src/input-otp.tsx
+++ b/packages/ccui/ui/input-otp/src/input-otp.tsx
@@ -93,6 +93,7 @@ export default defineComponent({
     const handleKeydown = (idx: number, e: KeyboardEvent) => {
       if (e.key === 'Backspace') {
         if (cells.value[idx]) {
+          e.preventDefault()
           cells.value[idx] = ''
           commit(idx)
         } else if (idx > 0) {
diff --git a/packages/ccui/ui/input-search/src/input-search.scss b/packages/ccui/ui/input-search/src/input-search.scss
index f99493f5..25056153 100644
--- a/packages/ccui/ui/input-search/src/input-search.scss
+++ b/packages/ccui/ui/input-search/src/input-search.scss
@@ -163,7 +163,7 @@
     min-width: 32px;
     padding: 0 15px;
     background-color: $ccui-color-primary;
-    color: #fff;
+    color: $ccui-color-text-light-solid;
     border: 1px solid $ccui-color-primary;
     border-top-left-radius: 0;
     border-bottom-left-radius: 0;
diff --git a/packages/ccui/ui/input-search/src/input-search.tsx b/packages/ccui/ui/input-search/src/input-search.tsx
index bd12063b..79543e55 100644
--- a/packages/ccui/ui/input-search/src/input-search.tsx
+++ b/packages/ccui/ui/input-search/src/input-search.tsx
@@ -78,9 +78,23 @@ export default defineComponent({
       const isInteractive = !props.disabled && !props.readonly
       const showClear = isInteractive && !!props.clearable && !!innerValue.value
       if (!showClear) return null
-      return h('span', { class: ns.e('clear'), onClick: handleClear, 'aria-label': 'clear' }, [
-        renderIconNode('mdi:close-circle'),
-      ])
+      return h(
+        'span',
+        {
+          class: ns.e('clear'),
+          role: 'button',
+          tabindex: 0,
+          onClick: handleClear,
+          onKeydown: (e: KeyboardEvent) => {
+            if (e.key === 'Enter' || e.key === ' ') {
+              e.preventDefault()
+              handleClear()
+            }
+          },
+          'aria-label': 'clear',
+        },
+        [renderIconNode('mdi:close-circle')],
+      )
     }
 
     const renderEnterButtonContent = () => {
@@ -122,7 +136,23 @@ export default defineComponent({
       }
       const tail = props.loading
         ? renderLoadingIcon()
-        : h('span', { class: ns.e('inline-icon'), onClick: (e: Event) => triggerSearch(e) }, renderSearchIcon())
+        : h(
+            'span',
+            {
+              class: ns.e('inline-icon'),
+              role: 'button',
+              tabindex: 0,
+              'aria-label': 'search',
+              onClick: (e: Event) => triggerSearch(e),
+              onKeydown: (e: KeyboardEvent) => {
+                if (e.key === 'Enter' || e.key === ' ') {
+                  e.preventDefault()
+                  triggerSearch(e)
+                }
+              },
+            },
+            renderSearchIcon(),
+          )
       return h('span', { class: ns.e('suffix') }, [renderClear(), slots.suffix?.(), tail])
     }
 
diff --git a/packages/ccui/ui/input/src/input.scss b/packages/ccui/ui/input/src/input.scss
index 1f51fb65..db3f34ff 100644
--- a/packages/ccui/ui/input/src/input.scss
+++ b/packages/ccui/ui/input/src/input.scss
@@ -75,58 +75,38 @@
     pointer-events: none;
   }
 
-  &--large {
-    height: $ccui-size-lg;
-    font-size: $ccui-font-size-lg;
-
+  // 各 size 的 prefix/suffix 内边距同构，抽成 mixin 统一发射复合选择器
+  @mixin input-size-pad($pad) {
     &.#{$cls-prefix}-input--prefix {
       .#{$cls-prefix}-input__inner {
-        padding-left: 24px;
+        padding-left: $pad;
       }
     }
 
     &.#{$cls-prefix}-input--suffix,
     &.#{$cls-prefix}-input--clearable {
       .#{$cls-prefix}-input__inner {
-        padding-right: 24px;
+        padding-right: $pad;
       }
     }
   }
 
+  &--large {
+    height: $ccui-size-lg;
+    font-size: $ccui-font-size-lg;
+    @include input-size-pad(24px);
+  }
+
   &--default {
     height: $ccui-size-md;
     font-size: $ccui-font-size-md;
-
-    &.#{$cls-prefix}-input--prefix {
-      .#{$cls-prefix}-input__inner {
-        padding-left: 24px;
-      }
-    }
-
-    &.#{$cls-prefix}-input--suffix,
-    &.#{$cls-prefix}-input--clearable {
-      .#{$cls-prefix}-input__inner {
-        padding-right: 24px;
-      }
-    }
+    @include input-size-pad(24px);
   }
 
   &--small {
     height: $ccui-size-sm;
     font-size: $ccui-font-size-sm;
-
-    &.#{$cls-prefix}-input--prefix {
-      .#{$cls-prefix}-input__inner {
-        padding-left: 20px;
-      }
-    }
-
-    &.#{$cls-prefix}-input--suffix,
-    &.#{$cls-prefix}-input--clearable {
-      .#{$cls-prefix}-input__inner {
-        padding-right: 20px;
-      }
-    }
+    @include input-size-pad(20px);
   }
 
   &__wrapper {
diff --git a/packages/ccui/ui/input/src/input.tsx b/packages/ccui/ui/input/src/input.tsx
index e6b374a4..2926611f 100644
--- a/packages/ccui/ui/input/src/input.tsx
+++ b/packages/ccui/ui/input/src/input.tsx
@@ -133,6 +133,8 @@ export default defineComponent({
     const clearInput = () => {
       updateValue('')
       emit('clear')
+      // 清除后把焦点归还输入框，避免清除按钮随 hasClear 消失后焦点丢回 body
+      inputRef.value?.focus()
     }
 
     const togglePasswordVisible = () => {
@@ -148,6 +150,15 @@ export default defineComponent({
       },
     )
 
+    // 当密码显隐能力关闭（type 离开 'password' 或 showPassword 关闭）时，
+    // 复位 isPasswordVisible，避免残留显隐态在下次进入 password 模式时直接以明文展示
+    watch(
+      () => showPasswordVisible.value,
+      (v) => {
+        if (!v) isPasswordVisible.value = false
+      },
+    )
+
     const renderAddonBefore = () => {
       if (!hasAddonBefore.value) return null
       const slotContent = slots.prepend?.()
@@ -174,8 +185,19 @@ export default defineComponent({
           {hasClear && <i class={ns.e('clear')} onClick={clearInput}></i>}
           {hasPasswordToggle && (
             <i
+              role="button"
+              tabindex={0}
+              aria-label={isPasswordVisible.value ? '隐藏密码' : '显示密码'}
+              aria-pressed={isPasswordVisible.value ? 'true' : 'false'}
               class={isPasswordVisible.value ? ns.e('password-visible') : ns.e('password-hidden')}
               onClick={togglePasswordVisible}
+              onKeydown={(e: KeyboardEvent) => {
+                if (e.key === 'Enter' || e.key === ' ') {
+                  // Space 默认会滚动页面，阻止它；Enter/Space 触发与 onClick 一致的切换逻辑
+                  e.preventDefault()
+                  togglePasswordVisible()
+                }
+              }}
             />
           )}
           {hasSuffixSlot && slots.suffix!()}
diff --git a/packages/ccui/ui/layout/src/layout.scss b/packages/ccui/ui/layout/src/layout.scss
index 33c1df43..9da147a5 100644
--- a/packages/ccui/ui/layout/src/layout.scss
+++ b/packages/ccui/ui/layout/src/layout.scss
@@ -20,7 +20,6 @@
   flex: 0 0 auto;
   height: 64px;
   padding: 0 24px;
-  color: $ccui-color-text;
   line-height: 64px;
   background: #001529;
   color: rgba(255, 255, 255, 0.85);
diff --git a/packages/ccui/ui/layout/src/layout.tsx b/packages/ccui/ui/layout/src/layout.tsx
index 6ea95972..5bb22d59 100644
--- a/packages/ccui/ui/layout/src/layout.tsx
+++ b/packages/ccui/ui/layout/src/layout.tsx
@@ -101,7 +101,7 @@ export const Sider = defineComponent({
     // 不命中时自动 uncollapse。同步 emit @breakpoint(broken)。
     let mql: MediaQueryList | null = null
     const onBreakpointChange = (e: MediaQueryListEvent | MediaQueryList) => {
-      const broken = 'matches' in e ? e.matches : (e as MediaQueryListEvent).matches
+      const broken = e.matches
       emit('breakpoint', broken)
       // 自动切换 collapsed 态（受控时不覆盖父值）。
       if (props.collapsed === undefined) {
@@ -125,6 +125,8 @@ export const Sider = defineComponent({
         mql.removeEventListener('change', onBreakpointChange)
         mql = null
       }
+      // 卸载时从 Layout 注销自身，避免 siders 数组只增不减导致 has-sider 残留。
+      ctx?.removeSider(id)
     })
 
     const widthPx = computed(() => {
@@ -170,7 +172,21 @@ export const Sider = defineComponent({
       const triggerStyle = isZeroWidthMode.value ? props.zeroWidthTriggerStyle : undefined
       const triggerCls = [ns.e('trigger'), isZeroWidthMode.value && ns.em('trigger', 'zero-width')]
       return (
-        <div class={triggerCls} style={triggerStyle} onClick={toggle}>
+        <div
+          class={triggerCls}
+          style={triggerStyle}
+          role="button"
+          tabindex={0}
+          aria-expanded={!isCollapsed.value}
+          onClick={toggle}
+          onKeydown={(e: KeyboardEvent) => {
+            // 键盘可达：Enter / Space 触发与 onClick 一致的折叠/展开逻辑
+            if (e.key === 'Enter' || e.key === ' ') {
+              e.preventDefault()
+              toggle()
+            }
+          }}
+        >
           {slots.trigger ? slots.trigger() : <span class={ns.e('trigger-arrow')}>{arrow ? '›' : '‹'}</span>}
         </div>
       )
diff --git a/packages/ccui/ui/masonry/src/masonry.tsx b/packages/ccui/ui/masonry/src/masonry.tsx
index dbdb8f4e..89f8a960 100644
--- a/packages/ccui/ui/masonry/src/masonry.tsx
+++ b/packages/ccui/ui/masonry/src/masonry.tsx
@@ -73,6 +73,12 @@ export default defineComponent({
       }
     })
 
+    // 末列样式：与 columnStyle 同源派生，仅去掉右间距，避免渲染时为每列新建 style 对象
+    const columnStyleLast = computed<CSSProperties>(() => ({
+      ...columnStyle.value,
+      marginInlineEnd: undefined,
+    }))
+
     const itemStyle = computed<CSSProperties>(() => {
       const [, v] = gutterPair.value
       return {
@@ -102,10 +108,7 @@ export default defineComponent({
         {columns.value.map((items, ci) => (
           <div
             class={ns.e('column')}
-            style={{
-              ...columnStyle.value,
-              marginInlineEnd: ci === columns.value.length - 1 ? undefined : columnStyle.value.marginInlineEnd,
-            }}
+            style={ci === columns.value.length - 1 ? columnStyleLast.value : columnStyle.value}
             key={ci}
           >
             {items.map((item, ii) => (
diff --git a/packages/ccui/ui/mentions/src/mentions.scss b/packages/ccui/ui/mentions/src/mentions.scss
index 05ba50b4..c3109c89 100644
--- a/packages/ccui/ui/mentions/src/mentions.scss
+++ b/packages/ccui/ui/mentions/src/mentions.scss
@@ -49,7 +49,7 @@
     border: 1px solid $ccui-form-control-line;
     border-radius: 6px;
     background: $ccui-color-bg-container;
-    color: rgba(0, 0, 0, 0.88);
+    color: $ccui-color-text;
     font-size: 14px;
     line-height: 1.5;
     font-family: inherit;
@@ -70,12 +70,12 @@
     }
 
     &::placeholder {
-      color: rgba(0, 0, 0, 0.25);
+      color: $ccui-placeholder;
     }
 
     &:disabled {
       background: $ccui-list-item-hover-bg;
-      color: rgba(0, 0, 0, 0.4);
+      color: $ccui-disabled-text;
       cursor: not-allowed;
     }
   }
@@ -89,9 +89,7 @@
     background: $ccui-base-bg;
     border: 1px solid $ccui-dividing-line;
     border-radius: 6px;
-    box-shadow:
-      0 6px 16px rgba(0, 0, 0, 0.08),
-      0 3px 6px -4px rgba(0, 0, 0, 0.12);
+    box-shadow: $ccui-box-shadow-secondary;
     overflow: auto;
   }
 
@@ -103,17 +101,17 @@
 
   &__option {
     padding: 5px 12px;
-    color: rgba(0, 0, 0, 0.88);
+    color: $ccui-color-text;
     font-size: 14px;
     cursor: pointer;
     transition: background 0.2s;
 
     &.is-active {
-      background: rgba(0, 0, 0, 0.04);
+      background: $ccui-list-item-hover-bg;
     }
 
     &.is-disabled {
-      color: rgba(0, 0, 0, 0.25);
+      color: $ccui-color-text-disabled;
       cursor: not-allowed;
       background: transparent;
     }
@@ -121,7 +119,7 @@
 
   &__empty {
     padding: 12px;
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
     font-size: 13px;
     text-align: center;
   }
diff --git a/packages/ccui/ui/mentions/src/mentions.tsx b/packages/ccui/ui/mentions/src/mentions.tsx
index 3481d907..31c5084a 100644
--- a/packages/ccui/ui/mentions/src/mentions.tsx
+++ b/packages/ccui/ui/mentions/src/mentions.tsx
@@ -12,6 +12,7 @@ import {
   onUnmounted,
   ref,
   shallowRef,
+  watch,
 } from 'vue'
 import { useConfig } from '../../config-provider/src/config-provider'
 import { formItemInjectionKey } from '../../form/src/form-types'
@@ -68,6 +69,15 @@ export default defineComponent({
       })
     })
 
+    // 过滤列表收缩时，把 activeIndex 钳到首个可用项，避免越界导致无高亮且 Enter/Tab 选不中
+    watch(filteredOptions, (list) => {
+      if (!open.value) return
+      if (activeIndex.value >= list.length || list[activeIndex.value]?.disabled) {
+        const first = list.findIndex((o) => !o.disabled)
+        activeIndex.value = first === -1 ? 0 : first
+      }
+    })
+
     let debounceTimer: ReturnType<typeof setTimeout> | null = null
 
     function setValue(next: string) {
@@ -102,7 +112,11 @@ export default defineComponent({
       if (match) {
         if (!open.value) {
           open.value = true
-          activeIndex.value = 0
+          // 初始高亮首个可用项；全 disabled / 空列表时 findIndex 返回 -1，用 Math.max(0, ...) 兜底保持原行为
+          activeIndex.value = Math.max(
+            0,
+            filteredOptions.value.findIndex((o) => !o.disabled),
+          )
         }
         if (props.searchDebounce > 0) {
           if (debounceTimer) clearTimeout(debounceTimer)
diff --git a/packages/ccui/ui/menu/src/menu.scss b/packages/ccui/ui/menu/src/menu.scss
index e6286797..5044fe75 100644
--- a/packages/ccui/ui/menu/src/menu.scss
+++ b/packages/ccui/ui/menu/src/menu.scss
@@ -23,7 +23,7 @@
     align-items: center;
     gap: 10px;
     height: 40px;
-    padding: 0 20px;
+    padding: 0 $ccui-padding-md;
     margin: 4px;
     border-radius: $ccui-border-radius;
     color: inherit;
@@ -34,7 +34,7 @@
 
     &:hover {
       color: $ccui-color-primary;
-      background-color: rgba(0, 0, 0, 0.04);
+      background-color: $ccui-color-fill-tertiary;
     }
 
     &:focus-visible {
@@ -60,7 +60,7 @@
 
   &__item--active,
   &__submenu-title--active {
-    background-color: rgba(0, 0, 0, 0.04);
+    background-color: $ccui-color-fill-tertiary;
   }
 
   &__item--disabled,
@@ -80,13 +80,13 @@
 
     &:hover {
       color: $ccui-color-error;
-      background-color: rgba(255, 77, 79, 0.08);
+      background-color: color-mix(in srgb, $ccui-color-error 8%, transparent);
     }
   }
 
   &__icon {
     flex: 0 0 auto;
-    font-size: 14px;
+    font-size: $ccui-font-size;
   }
 
   &__label {
@@ -99,7 +99,7 @@
   &__extra {
     flex: 0 0 auto;
     color: $ccui-color-text-secondary;
-    font-size: 12px;
+    font-size: $ccui-font-size-sm;
   }
 
   &__arrow {
@@ -136,9 +136,9 @@
   }
 
   &__group-title {
-    padding: 8px 20px 4px;
+    padding: $ccui-padding-xs $ccui-padding-md $ccui-padding-xxs;
     color: $ccui-color-text-secondary;
-    font-size: 12px;
+    font-size: $ccui-font-size-sm;
     line-height: 20px;
   }
 
@@ -193,7 +193,7 @@
 
   &--inline {
     .#{$cls-prefix}-menu__sub {
-      background-color: rgba(0, 0, 0, 0.02);
+      background-color: $ccui-color-fill-quaternary;
     }
   }
 
@@ -207,6 +207,11 @@
       background-color: rgba(255, 255, 255, 0.08);
     }
 
+    .#{$cls-prefix}-menu__item--active,
+    .#{$cls-prefix}-menu__submenu-title--active {
+      background-color: rgba(255, 255, 255, 0.08);
+    }
+
     .#{$cls-prefix}-menu__item--selected {
       color: #ffffff;
       background-color: $ccui-color-primary;
diff --git a/packages/ccui/ui/menu/src/menu.tsx b/packages/ccui/ui/menu/src/menu.tsx
index 529916a7..c795110d 100644
--- a/packages/ccui/ui/menu/src/menu.tsx
+++ b/packages/ccui/ui/menu/src/menu.tsx
@@ -197,6 +197,19 @@ function renderItem({ item, level, keyPath, ns, ctx }: RenderItemArgs): JSX.Elem
   )
 }
 
+// 根据 keyPath 找到目标项真实的同级集合（keyPath 为 leaf-first：[item.key, parentKey, ..., rootKey]）
+function findSiblingItems(roots: MenuItem[], keyPath: MenuKey[]): MenuItem[] {
+  // 去掉自身 key 并反转，得到从根到直接父级的祖先顺序
+  const ancestors = keyPath.slice(1).reverse()
+  let level = roots
+  for (const ancestorKey of ancestors) {
+    const parent = level.find((m) => m.key === ancestorKey)
+    if (!parent?.children?.length) return level
+    level = parent.children
+  }
+  return level
+}
+
 export default defineComponent({
   name: 'CMenu',
   props: menuProps,
@@ -309,7 +322,8 @@ export default defineComponent({
       let nextKeys = nextOpen ? [...openKeys.value, item.key] : openKeys.value.filter((openKey) => openKey !== item.key)
 
       if (props.accordion && nextOpen) {
-        const siblingKeys = props.items
+        const siblings = findSiblingItems(props.items, keyPath)
+        const siblingKeys = siblings
           .filter((menuItem) => menuItem.children?.length && menuItem.key !== item.key)
           .map((menuItem) => menuItem.key)
         nextKeys = nextKeys.filter((openKey) => !siblingKeys.includes(openKey) || openKey === item.key)
diff --git a/packages/ccui/ui/message/src/message.scss b/packages/ccui/ui/message/src/message.scss
index 93b687e8..8e58dc76 100644
--- a/packages/ccui/ui/message/src/message.scss
+++ b/packages/ccui/ui/message/src/message.scss
@@ -84,10 +84,7 @@
     padding: 9px 12px;
     background-color: $ccui-color-bg-elevated;
     border-radius: $ccui-border-radius;
-    box-shadow:
-      0 6px 16px 0 rgba(0, 0, 0, 0.08),
-      0 3px 6px -4px rgba(0, 0, 0, 0.12),
-      0 9px 28px 8px rgba(0, 0, 0, 0.05);
+    box-shadow: $ccui-box-shadow;
     font-size: $ccui-font-size;
     color: $ccui-color-text;
     line-height: $ccui-line-height-base;
diff --git a/packages/ccui/ui/modal/src/confirm.tsx b/packages/ccui/ui/modal/src/confirm.tsx
index 1e4d5f5a..99928b19 100644
--- a/packages/ccui/ui/modal/src/confirm.tsx
+++ b/packages/ccui/ui/modal/src/confirm.tsx
@@ -51,6 +51,8 @@ export function modalFunc(options: ModalFuncOptions = {}, parentCtx?: ParentCont
   let containerEl: HTMLElement | null = null
 
   const ns = useNamespace('modal-confirm')
+  // footer 按钮复用 Modal 组件的 BEM 命名空间（样式定义在 modal.scss 的 .ccui-modal 下）
+  const nsModal = useNamespace('modal')
 
   const handle: ModalFuncReturn = {
     destroy() {
@@ -152,16 +154,16 @@ export function modalFunc(options: ModalFuncOptions = {}, parentCtx?: ParentCont
         const footer = (
           <div class={ns.e('footer')}>
             {type === 'confirm' && (
-              <button class={['ccui-modal__btn', 'ccui-modal__btn--cancel']} onClick={onCancelClick}>
+              <button class={[nsModal.e('btn'), nsModal.em('btn', 'cancel')]} onClick={onCancelClick}>
                 {cancelText}
               </button>
             )}
             <button
-              class={['ccui-modal__btn', `ccui-modal__btn--${okType}`, loading.value && 'is-loading']}
+              class={[nsModal.e('btn'), nsModal.em('btn', okType), loading.value && nsModal.is('loading')]}
               disabled={loading.value}
               onClick={onOkClick}
             >
-              {loading.value && <span class="ccui-modal__spinner" />}
+              {loading.value && <span class={nsModal.e('spinner')} />}
               {okText}
             </button>
           </div>
diff --git a/packages/ccui/ui/modal/src/modal.scss b/packages/ccui/ui/modal/src/modal.scss
index 5066678d..b4310dd9 100644
--- a/packages/ccui/ui/modal/src/modal.scss
+++ b/packages/ccui/ui/modal/src/modal.scss
@@ -61,7 +61,7 @@
 
     &:hover {
       color: $ccui-color-text;
-      background-color: rgba(0, 0, 0, 0.06);
+      background-color: $ccui-color-fill-secondary;
     }
   }
 
@@ -108,38 +108,30 @@
       border-color: $ccui-color-primary;
     }
 
-    &--cancel {
-      // default
-    }
-
     &--primary {
-      color: #ffffff;
+      color: $ccui-color-text-light-solid;
       background-color: $ccui-color-primary;
       border-color: $ccui-color-primary;
 
       &:hover {
         background-color: $ccui-color-primary-hover;
         border-color: $ccui-color-primary-hover;
-        color: #ffffff;
+        color: $ccui-color-text-light-solid;
       }
     }
 
     &--danger {
-      color: #ffffff;
+      color: $ccui-color-text-light-solid;
       background-color: $ccui-color-error;
       border-color: $ccui-color-error;
 
       &:hover {
         background-color: $ccui-color-error-hover;
         border-color: $ccui-color-error-hover;
-        color: #ffffff;
+        color: $ccui-color-text-light-solid;
       }
     }
 
-    &--default {
-      // default
-    }
-
     &.is-loading {
       cursor: not-allowed;
       opacity: 0.65;
@@ -202,7 +194,7 @@
     width: 22px;
     height: 22px;
     border-radius: 50%;
-    color: #ffffff;
+    color: $ccui-color-text-light-solid;
     font-size: 14px;
     font-weight: bold;
     line-height: 1;
diff --git a/packages/ccui/ui/notification/src/notification-item.tsx b/packages/ccui/ui/notification/src/notification-item.tsx
index 326b1f91..454b42ff 100644
--- a/packages/ccui/ui/notification/src/notification-item.tsx
+++ b/packages/ccui/ui/notification/src/notification-item.tsx
@@ -67,6 +67,7 @@ export default defineComponent({
             style={props.styles?.root}
             role={props.role}
             aria-live={props.role === 'alert' ? 'assertive' : 'polite'}
+            aria-atomic={true}
             onMouseenter={onMouseenter}
             onMouseleave={onMouseleave}
           >
diff --git a/packages/ccui/ui/notification/src/notification.scss b/packages/ccui/ui/notification/src/notification.scss
index b96eba99..4b89364c 100644
--- a/packages/ccui/ui/notification/src/notification.scss
+++ b/packages/ccui/ui/notification/src/notification.scss
@@ -82,10 +82,8 @@
     padding: 16px 24px;
     background-color: $ccui-color-bg-elevated;
     border-radius: $ccui-border-radius;
-    box-shadow:
-      0 6px 16px 0 rgba(0, 0, 0, 0.08),
-      0 3px 6px -4px rgba(0, 0, 0, 0.12),
-      0 9px 28px 8px rgba(0, 0, 0, 0.05);
+    // 弹层阴影统一走 token，与 dropdown/select/menu 等浮层族对齐，深色模式下自动加深
+    box-shadow: $ccui-box-shadow-secondary;
   }
 
   &__icon {
diff --git a/packages/ccui/ui/notification/src/notification.ts b/packages/ccui/ui/notification/src/notification.ts
index 34be62cd..4dcf794f 100644
--- a/packages/ccui/ui/notification/src/notification.ts
+++ b/packages/ccui/ui/notification/src/notification.ts
@@ -8,6 +8,7 @@ import type {
   NotificationType,
 } from './notification-types'
 import { createApp, h, reactive } from 'vue'
+import { useNamespace } from '../../shared/hooks/use-namespace'
 import NotificationItem from './notification-item'
 import './notification.scss'
 
@@ -19,6 +20,7 @@ interface NotificationInstance {
 const PLACEMENTS: NotificationPlacement[] = ['top', 'topRight', 'topLeft', 'bottom', 'bottomRight', 'bottomLeft']
 
 let counter = 0
+const ns = useNamespace('notification')
 const containers = new Map<NotificationPlacement, HTMLElement>()
 const apps = new Map<NotificationPlacement, ReturnType<typeof createApp>>()
 const lists = reactive<Record<NotificationPlacement, NotificationInstance[]>>({
@@ -50,8 +52,8 @@ function normalizeDuration(input: number | undefined, defaultSeconds: number): n
 function ensureContainer(placement: NotificationPlacement) {
   if (containers.has(placement)) return
   const el = document.createElement('div')
-  el.className = `ccui-notification ccui-notification--${placement}`
-  if (globalConfig.stack) el.classList.add('ccui-notification--stack')
+  el.className = `${ns.b()} ${ns.m(placement)}`
+  if (globalConfig.stack) el.classList.add(ns.m('stack'))
   if (placement === 'top' || placement.startsWith('top')) {
     if (globalConfig.top !== undefined) {
       el.style.top = typeof globalConfig.top === 'number' ? `${globalConfig.top}px` : globalConfig.top
@@ -106,7 +108,11 @@ function enforceMaxCount(placement: NotificationPlacement) {
   const cap = globalConfig.maxCount ?? Infinity
   if (!isFinite(cap) || cap <= 0) return
   const arr = lists[placement]
-  while (arr.length > cap) arr.shift()
+  // 被挤掉的通知也要触发 onClose，避免用户注册的回调被静默吞掉
+  while (arr.length > cap) {
+    const removed = arr.shift()
+    removed?.options.onClose?.()
+  }
 }
 
 function open(options: NotificationOptions): NotificationHandle {
@@ -138,8 +144,8 @@ const notification = {
   config(cfg: NotificationGlobalConfig) {
     Object.assign(globalConfig, cfg)
     containers.forEach((el) => {
-      if (globalConfig.stack) el.classList.add('ccui-notification--stack')
-      else el.classList.remove('ccui-notification--stack')
+      if (globalConfig.stack) el.classList.add(ns.m('stack'))
+      else el.classList.remove(ns.m('stack'))
     })
   },
   destroy(): void {
diff --git a/packages/ccui/ui/notification/src/use-notification.ts b/packages/ccui/ui/notification/src/use-notification.ts
index aef53e8a..36f9ec8f 100644
--- a/packages/ccui/ui/notification/src/use-notification.ts
+++ b/packages/ccui/ui/notification/src/use-notification.ts
@@ -7,6 +7,7 @@ import type {
   NotificationType,
 } from './notification-types'
 import { defineComponent, h, reactive, Teleport } from 'vue'
+import { useNamespace } from '../../shared/hooks/use-namespace'
 import NotificationItem from './notification-item'
 import './notification.scss'
 
@@ -83,7 +84,11 @@ export function useNotification(): UseNotificationReturn {
     const cap = config.maxCount ?? Infinity
     if (!isFinite(cap) || cap <= 0) return
     const arr = lists[placement]
-    while (arr.length > cap) arr.shift()
+    // 被挤掉的通知也要触发 onClose，避免用户注册的回调被静默吞掉
+    while (arr.length > cap) {
+      const removed = arr.shift()
+      removed?.options.onClose?.()
+    }
   }
 
   function open(options: NotificationOptions): NotificationHandle {
@@ -123,6 +128,7 @@ export function useNotification(): UseNotificationReturn {
   const holder: Component = defineComponent({
     name: 'CNotificationHolder',
     setup() {
+      const ns = useNamespace('notification')
       const onDestroy = (placement: NotificationPlacement, id: string) => {
         const arr = lists[placement]
         const idx = arr.findIndex((it) => it.id === id)
@@ -143,7 +149,7 @@ export function useNotification(): UseNotificationReturn {
             'div',
             {
               key: p,
-              class: ['ccui-notification', `ccui-notification--${p}`, config.stack && 'ccui-notification--stack'],
+              class: [ns.b(), ns.m(p), config.stack && ns.m('stack')],
               style: containerStyle,
             },
             lists[p].map((it) =>
diff --git a/packages/ccui/ui/pagination/src/pagination.tsx b/packages/ccui/ui/pagination/src/pagination.tsx
index b1260b4a..0d3f4a70 100644
--- a/packages/ccui/ui/pagination/src/pagination.tsx
+++ b/packages/ccui/ui/pagination/src/pagination.tsx
@@ -153,8 +153,18 @@ export default defineComponent({
         <li
           key={page}
           class={[ns.e('item'), active && ns.em('item', 'active')]}
+          role="button"
+          tabindex={props.disabled ? -1 : 0}
           aria-current={active ? 'page' : undefined}
+          aria-disabled={props.disabled || undefined}
           onClick={() => goTo(page)}
+          onKeydown={(e: KeyboardEvent) => {
+            // 键盘可达：Enter / Space 触发与点击相同的跳页逻辑
+            if (e.key === 'Enter' || e.key === ' ') {
+              e.preventDefault()
+              goTo(page)
+            }
+          }}
         >
           {page}
         </li>
@@ -216,7 +226,19 @@ export default defineComponent({
           {renderTotal()}
           <li
             class={[ns.e('prev'), prevDisabled && ns.is('disabled')]}
+            role="button"
+            tabindex={prevDisabled ? -1 : 0}
             onClick={handlePrev}
+            onKeydown={(e: KeyboardEvent) => {
+              // 键盘可达：禁用态忽略，Enter / Space 触发与点击相同的上一页逻辑
+              if (prevDisabled) {
+                return
+              }
+              if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault()
+                handlePrev()
+              }
+            }}
             aria-disabled={prevDisabled}
             aria-label={locale.value.prevPage || '上一页'}
           >
@@ -246,7 +268,19 @@ export default defineComponent({
 
           <li
             class={[ns.e('next'), nextDisabled && ns.is('disabled')]}
+            role="button"
+            tabindex={nextDisabled ? -1 : 0}
             onClick={handleNext}
+            onKeydown={(e: KeyboardEvent) => {
+              // 键盘可达：禁用态忽略，Enter / Space 触发与点击相同的下一页逻辑
+              if (nextDisabled) {
+                return
+              }
+              if (e.key === 'Enter' || e.key === ' ') {
+                e.preventDefault()
+                handleNext()
+              }
+            }}
             aria-disabled={nextDisabled}
             aria-label={locale.value.nextPage || '下一页'}
           >
diff --git a/packages/ccui/ui/popconfirm/src/popconfirm-types.ts b/packages/ccui/ui/popconfirm/src/popconfirm-types.ts
index 581376e2..a239d286 100644
--- a/packages/ccui/ui/popconfirm/src/popconfirm-types.ts
+++ b/packages/ccui/ui/popconfirm/src/popconfirm-types.ts
@@ -40,7 +40,7 @@ export const popconfirmProps = {
   },
   iconColor: {
     type: String,
-    default: '#faad14',
+    default: '',
   },
   hideIcon: {
     type: Boolean,
diff --git a/packages/ccui/ui/popconfirm/src/popconfirm.scss b/packages/ccui/ui/popconfirm/src/popconfirm.scss
index cbe95cd4..67149ad4 100644
--- a/packages/ccui/ui/popconfirm/src/popconfirm.scss
+++ b/packages/ccui/ui/popconfirm/src/popconfirm.scss
@@ -27,7 +27,7 @@
     height: 16px;
     font-size: 12px;
     font-weight: bold;
-    color: #ffffff;
+    color: $ccui-color-white;
     background: $ccui-color-warning;
     border-radius: 50%;
     line-height: 1;
@@ -77,36 +77,30 @@
       border-color: $ccui-color-primary;
     }
 
-    &--cancel {
-      // default style
-    }
+    // --cancel / --default 继承基础按钮样式
 
     &--primary {
-      color: #ffffff;
+      color: $ccui-color-white;
       background-color: $ccui-color-primary;
       border-color: $ccui-color-primary;
 
       &:hover {
-        color: #ffffff;
+        color: $ccui-color-white;
         background-color: $ccui-color-primary-hover;
         border-color: $ccui-color-primary-hover;
       }
     }
 
     &--danger {
-      color: #ffffff;
+      color: $ccui-color-white;
       background-color: $ccui-color-error;
       border-color: $ccui-color-error;
 
       &:hover {
-        color: #ffffff;
+        color: $ccui-color-white;
         background-color: $ccui-color-error-hover;
         border-color: $ccui-color-error-hover;
       }
     }
-
-    &--default {
-      // default
-    }
   }
 }
diff --git a/packages/ccui/ui/popconfirm/src/popconfirm.tsx b/packages/ccui/ui/popconfirm/src/popconfirm.tsx
index f4948342..bb686f7b 100644
--- a/packages/ccui/ui/popconfirm/src/popconfirm.tsx
+++ b/packages/ccui/ui/popconfirm/src/popconfirm.tsx
@@ -32,11 +32,13 @@ export default defineComponent({
     })
 
     const close = () => {
-      if (!isControlled.value) {
-        innerVisible.value = false
+      if (isControlled.value) {
+        // 受控：直接通知父，由父改 visible 收口关闭，不再调用 popover.hide() 触发二次 emit
+        emit('update:visible', false)
+      } else {
+        // 非受控：仅调 popover.hide()，由其 emit 经 onUpdate:visible 同步 innerVisible 并向上转发一次
+        popoverRef.value?.hide?.()
       }
-      emit('update:visible', false)
-      popoverRef.value?.hide?.()
     }
 
     const onConfirm = (e: MouseEvent) => {
@@ -70,7 +72,7 @@ export default defineComponent({
             <div class={ns.e('inner')}>
               <div class={ns.e('header')}>
                 {!props.hideIcon && (
-                  <span class={ns.e('icon')} style={{ color: props.iconColor }}>
+                  <span class={ns.e('icon')} style={props.iconColor ? { color: props.iconColor } : undefined}>
                     {props.icon ? <i class={props.icon} /> : <span class={ns.e('warning')}>!</span>}
                   </span>
                 )}
diff --git a/packages/ccui/ui/popover/src/popover.scss b/packages/ccui/ui/popover/src/popover.scss
index f1839be9..839a6218 100644
--- a/packages/ccui/ui/popover/src/popover.scss
+++ b/packages/ccui/ui/popover/src/popover.scss
@@ -24,14 +24,14 @@
       background: $ccui-feedback-overlay-bg;
       color: $ccui-light-text;
       border: 1px solid $ccui-feedback-overlay-bg;
-      box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.1);
+      box-shadow: $ccui-box-shadow-secondary;
     }
 
     &--light {
       background: $ccui-base-bg;
       color: $ccui-aide-text-stress;
       border: 1px solid $ccui-color-border;
-      box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.1);
+      box-shadow: $ccui-box-shadow-secondary;
     }
   }
 
diff --git a/packages/ccui/ui/popover/src/popover.tsx b/packages/ccui/ui/popover/src/popover.tsx
index f4325da1..f064409d 100644
--- a/packages/ccui/ui/popover/src/popover.tsx
+++ b/packages/ccui/ui/popover/src/popover.tsx
@@ -271,7 +271,37 @@ export default defineComponent({
 
     let cleanup: (() => void) | undefined
 
+    // 虚拟触发：把触发事件绑定到外部 virtualRef 元素上
+    // boundVirtualEl 记录实际绑定的元素，确保 virtualRef 变化时能从正确的节点上解绑
+    let boundVirtualEl: HTMLElement | undefined
+    const bindVirtualTriggerEvents = () => {
+      if (!props.virtualTriggering || !props.virtualRef) return
+      const el = props.virtualRef
+      el.addEventListener('mouseenter', handleMouseEnter)
+      el.addEventListener('mouseleave', handleMouseLeave)
+      el.addEventListener('click', handleClick)
+      el.addEventListener('focus', handleFocus)
+      el.addEventListener('blur', handleBlur)
+      el.addEventListener('keydown', handleKeydown)
+      el.addEventListener('contextmenu', handleContextMenu)
+      boundVirtualEl = el
+    }
+    const unbindVirtualTriggerEvents = () => {
+      const el = boundVirtualEl
+      if (!el) return
+      el.removeEventListener('mouseenter', handleMouseEnter)
+      el.removeEventListener('mouseleave', handleMouseLeave)
+      el.removeEventListener('click', handleClick)
+      el.removeEventListener('focus', handleFocus)
+      el.removeEventListener('blur', handleBlur)
+      el.removeEventListener('keydown', handleKeydown)
+      el.removeEventListener('contextmenu', handleContextMenu)
+      boundVirtualEl = undefined
+    }
+
     onMounted(() => {
+      // 虚拟触发模式下，把触发事件绑定到外部元素
+      bindVirtualTriggerEvents()
       // 初始化时如果 visible 为 true，确保显示并监听文档级事件
       if (props.visible) {
         void nextTick(() => {
@@ -284,6 +314,14 @@ export default defineComponent({
         })
       }
     })
+    // virtualRef / virtualTriggering 变化时，先从旧元素解绑再绑定到新元素
+    watch(
+      () => [props.virtualTriggering, props.virtualRef] as const,
+      () => {
+        unbindVirtualTriggerEvents()
+        bindVirtualTriggerEvents()
+      },
+    )
     onUnmounted(() => {
       clearTimers()
       cleanup?.()
@@ -291,16 +329,7 @@ export default defineComponent({
       window.removeEventListener('keydown', onDocumentKeydown, true)
 
       // 清理虚拟触发元素的事件监听
-      if (props.virtualTriggering && props.virtualRef) {
-        const virtualEl = props.virtualRef
-        virtualEl.removeEventListener('mouseenter', handleMouseEnter)
-        virtualEl.removeEventListener('mouseleave', handleMouseLeave)
-        virtualEl.removeEventListener('click', handleClick)
-        virtualEl.removeEventListener('focus', handleFocus)
-        virtualEl.removeEventListener('blur', handleBlur)
-        virtualEl.removeEventListener('keydown', handleKeydown)
-        virtualEl.removeEventListener('contextmenu', handleContextMenu)
-      }
+      unbindVirtualTriggerEvents()
     })
     watch(externalOpen, (newVal) => {
       if (isControlled.value) {
@@ -389,9 +418,8 @@ export default defineComponent({
           style={{
             ...floatingStyles.value,
             ...inlineColorStyle.value,
-            zIndex: 2000,
             pointerEvents: props.enterable ? 'auto' : 'none',
-            width: props.width || undefined,
+            width: props.width ? (typeof props.width === 'number' ? `${props.width}px` : props.width) : undefined,
           }}
           onMouseenter={handlePopperMouseEnter}
           onMouseleave={handlePopperMouseLeave}
diff --git a/packages/ccui/ui/progress/src/progress-types.ts b/packages/ccui/ui/progress/src/progress-types.ts
index 9745025e..46a648cd 100644
--- a/packages/ccui/ui/progress/src/progress-types.ts
+++ b/packages/ccui/ui/progress/src/progress-types.ts
@@ -38,7 +38,7 @@ export const progressProps = {
     default: 120,
   },
   size: {
-    type: [String, Number, Array] as PropType<ProgressSize | number | [number, number]>,
+    type: String as PropType<ProgressSize>,
     default: 'default',
   },
   format: {
diff --git a/packages/ccui/ui/progress/src/progress.scss b/packages/ccui/ui/progress/src/progress.scss
index c84b44d2..42bf0c6a 100644
--- a/packages/ccui/ui/progress/src/progress.scss
+++ b/packages/ccui/ui/progress/src/progress.scss
@@ -25,7 +25,7 @@
     width: 100%;
     overflow: hidden;
     vertical-align: middle;
-    background-color: rgba(0, 0, 0, 0.06);
+    background-color: $ccui-color-fill-secondary;
     border-radius: 100px;
   }
 
diff --git a/packages/ccui/ui/progress/src/progress.tsx b/packages/ccui/ui/progress/src/progress.tsx
index a74cbaf5..1ec1c61b 100644
--- a/packages/ccui/ui/progress/src/progress.tsx
+++ b/packages/ccui/ui/progress/src/progress.tsx
@@ -121,7 +121,7 @@ export default defineComponent({
               cy="50"
               r={radius}
               fill="none"
-              stroke={props.trailColor || 'rgba(0, 0, 0, 0.06)'}
+              stroke={props.trailColor || 'var(--ccui-color-fill-secondary, rgba(0, 0, 0, 0.06))'}
               stroke-width={strokeWidth}
               stroke-dasharray={isDashboard ? `${adjustedDashArray} ${circumference}` : `${circumference}`}
               stroke-linecap="round"
diff --git a/packages/ccui/ui/radio/src/radio-group.tsx b/packages/ccui/ui/radio/src/radio-group.tsx
index e956aafe..9f616149 100644
--- a/packages/ccui/ui/radio/src/radio-group.tsx
+++ b/packages/ccui/ui/radio/src/radio-group.tsx
@@ -23,13 +23,8 @@ export default defineComponent({
       emitChangeValue,
     })
 
-    const directionType = {
-      row: 'is-row',
-      column: 'is-column',
-    }
-
     const radioGroupClass = computed(() => {
-      return `${ns.b()} ${directionType[props.direction]}`
+      return `${ns.b()} ${ns.is(props.direction)}`
     })
 
     return () => {
diff --git a/packages/ccui/ui/range-picker/src/range-picker-types.ts b/packages/ccui/ui/range-picker/src/range-picker-types.ts
index eaa9541e..6b643fd4 100644
--- a/packages/ccui/ui/range-picker/src/range-picker-types.ts
+++ b/packages/ccui/ui/range-picker/src/range-picker-types.ts
@@ -156,11 +156,6 @@ export const rangePickerProps = {
     type: [Boolean, Object] as PropType<boolean | RangeTimeShowConfig>,
     default: false,
   },
-  // 是否在 footer 显示「此刻」按钮。仅 showTime 启用时显示。
-  showNow: {
-    type: Boolean,
-    default: true,
-  },
   /**
    * 录入组件统一 variant 形态。
    */
diff --git a/packages/ccui/ui/range-picker/src/range-picker.tsx b/packages/ccui/ui/range-picker/src/range-picker.tsx
index b693a450..482a7398 100644
--- a/packages/ccui/ui/range-picker/src/range-picker.tsx
+++ b/packages/ccui/ui/range-picker/src/range-picker.tsx
@@ -286,6 +286,9 @@ export default defineComponent({
       if (!selectedStart.value && !selectedEnd.value) return
       pendingStart.value = null
       pendingEnd.value = null
+      // 复位选择阶段与 hover，保证清空后从 start 端重新选起
+      phase.value = 'start'
+      hoverDate.value = null
       emitRange(null, null)
     }
 
@@ -448,7 +451,13 @@ export default defineComponent({
 
     function renderGrid(cells: ReturnType<typeof generateMonthGrid>) {
       return (
-        <div class={ns.e('grid')}>
+        <div
+          class={ns.e('grid')}
+          onMouseleave={() => {
+            // 指针移出整个网格时清除 hover 预览，避免残留高亮
+            hoverDate.value = null
+          }}
+        >
           {cells.map((cell) => {
             // 显示禁用以当前 phase 为准（用户先填 start 再填 end，对应该侧的限制）
             const disabled = isDisabledFor(cell.date, phase.value)
@@ -545,7 +554,8 @@ export default defineComponent({
     }
 
     function renderFooter() {
-      const okDisabled = !pendingStart.value || !pendingEnd.value
+      const okDisabled =
+        (!pendingStart.value && !allowEmptyTuple.value[0]) || (!pendingEnd.value && !allowEmptyTuple.value[1])
       return (
         <div class={ns.e('footer')}>
           <button
diff --git a/packages/ccui/ui/rate/src/rate.tsx b/packages/ccui/ui/rate/src/rate.tsx
index fc489fa3..8498fb48 100644
--- a/packages/ccui/ui/rate/src/rate.tsx
+++ b/packages/ccui/ui/rate/src/rate.tsx
@@ -1,5 +1,5 @@
 import type { RateProps } from './rate-types'
-import { computed, defineComponent, ref } from 'vue'
+import { computed, defineComponent, ref, watch } from 'vue'
 import { useNamespace } from '../../shared/hooks/use-namespace'
 import iconDefault from './components/icon-default'
 import { rateProps } from './rate-types'
@@ -37,8 +37,22 @@ export default defineComponent({
 
     setIconState(selectedQuantity.value)
 
+    // 监听外部 modelValue 变化（受控更新 / 编程式重置），同步内部选中状态与图标宽度
+    watch(
+      () => props.modelValue,
+      (v) => {
+        selectedQuantity.value = v
+        setIconState(v)
+      },
+    )
+
     // 判断当前鼠标事件的目标是否是半选
-    const isSemiSelected = (e: MouseEvent) => props.allowHalf && e.offsetX * 2 <= (e.target as HTMLElement).clientWidth
+    // 从监听器自身元素（currentTarget）计算几何，避免 e.target 落在内部 svg/span 导致 offsetX 与 clientWidth 取自不同元素而错判
+    const isSemiSelected = (e: MouseEvent) => {
+      if (!props.allowHalf) return false
+      const rect = (e.currentTarget as HTMLElement).getBoundingClientRect()
+      return (e.clientX - rect.left) * 2 <= rect.width
+    }
 
     const handleMouseInteraction = (e: MouseEvent, index: number, isClick = false) => {
       if (props.readOnly) return
diff --git a/packages/ccui/ui/result/src/result-types.ts b/packages/ccui/ui/result/src/result-types.ts
index 5650116f..c541861a 100644
--- a/packages/ccui/ui/result/src/result-types.ts
+++ b/packages/ccui/ui/result/src/result-types.ts
@@ -15,10 +15,6 @@ export const resultProps = {
     type: String,
     default: '',
   },
-  icon: {
-    type: String,
-    default: '',
-  },
 } as const
 
 export type ResultProps = ExtractPropTypes<typeof resultProps>
diff --git a/packages/ccui/ui/result/src/result.scss b/packages/ccui/ui/result/src/result.scss
index f3d8de8a..7a283044 100644
--- a/packages/ccui/ui/result/src/result.scss
+++ b/packages/ccui/ui/result/src/result.scss
@@ -22,13 +22,13 @@
 
   // 内置状态：通过状态修饰类驱动 svg fill="currentColor"。
   &--success &__icon {
-    color: var(--ccui-success, #52c41a);
+    color: $ccui-color-success;
   }
   &--error &__icon {
-    color: var(--ccui-danger, #ff4d4f);
+    color: $ccui-color-error;
   }
   &--warning &__icon {
-    color: var(--ccui-warning, #faad14);
+    color: $ccui-color-warning;
   }
   &--info &__icon,
   &--404 &__icon,
diff --git a/packages/ccui/ui/segmented/src/segmented.scss b/packages/ccui/ui/segmented/src/segmented.scss
index be4f94cc..ffc1c309 100644
--- a/packages/ccui/ui/segmented/src/segmented.scss
+++ b/packages/ccui/ui/segmented/src/segmented.scss
@@ -4,7 +4,7 @@
   display: inline-block;
   padding: 2px;
   color: $ccui-color-text-secondary;
-  background-color: rgba(0, 0, 0, 0.04);
+  background-color: $ccui-color-fill-tertiary;
   border-radius: $ccui-border-radius;
   transition: all $ccui-motion-duration-mid;
 
@@ -32,10 +32,7 @@
       color: $ccui-color-text;
       background: $ccui-color-bg-elevated;
       border-radius: $ccui-border-radius-sm;
-      box-shadow:
-        0 2px 8px -2px rgba(0, 0, 0, 0.05),
-        0 1px 4px -1px rgba(25, 15, 15, 0.07),
-        0 0 1px 0 rgba(0, 0, 0, 0.08);
+      box-shadow: $ccui-box-shadow-tertiary;
     }
 
     &--disabled {
diff --git a/packages/ccui/ui/select/src/select.scss b/packages/ccui/ui/select/src/select.scss
index 28781e18..d4bc9834 100644
--- a/packages/ccui/ui/select/src/select.scss
+++ b/packages/ccui/ui/select/src/select.scss
@@ -242,7 +242,7 @@
   }
 
   &__highlight {
-    background: rgba(250, 173, 20, 0.18);
+    background: $ccui-color-warning-bg;
     color: $ccui-color-warning;
   }
 
diff --git a/packages/ccui/ui/select/src/select.tsx b/packages/ccui/ui/select/src/select.tsx
index 4810d99d..242b7e70 100644
--- a/packages/ccui/ui/select/src/select.tsx
+++ b/packages/ccui/ui/select/src/select.tsx
@@ -327,7 +327,7 @@ export default defineComponent({
           return
         }
         const option = visibleOptions.value[activeIndex.value]
-        if (option && (visibleOptions.value.length > 0 || mode.value !== 'tags')) {
+        if (option) {
           onSelectOption(option)
           return
         }
@@ -457,6 +457,11 @@ export default defineComponent({
           draggable: props.tagsDraggable && !option.disabled ? true : undefined,
           onDragstart: (event: DragEvent) => onTagDragStart(event, option),
           onDragover: (event: DragEvent) => onTagDragOver(event, option),
+          // 拖出当前 tag 时仅清除自身的 drop-over 标记，避免残留高亮；
+          // 子节点 dragover 冒泡会随后重新设值，故带守卫不会误清其他 tag
+          onDragleave: () => {
+            if (dragOverTagValue.value === option.value) dragOverTagValue.value = null
+          },
           onDrop: (event: DragEvent) => onTagDrop(event, option),
           onDragend: onTagDragEnd,
         },
diff --git a/packages/ccui/ui/skeleton-node/src/skeleton-node.scss b/packages/ccui/ui/skeleton-node/src/skeleton-node.scss
index b3e291b5..59881f67 100644
--- a/packages/ccui/ui/skeleton-node/src/skeleton-node.scss
+++ b/packages/ccui/ui/skeleton-node/src/skeleton-node.scss
@@ -1,8 +1,16 @@
 @use '../../style-var/index.scss' as *;
 
-$skeleton-bg: rgba(0, 0, 0, 0.06);
-$skeleton-bg-active: linear-gradient(90deg, rgba(0, 0, 0, 0.06) 25%, rgba(0, 0, 0, 0.15) 37%, rgba(0, 0, 0, 0.06) 63%);
-$skeleton-icon: rgba(0, 0, 0, 0.18);
+// 占位填充：light 下 fill-secondary 即 rgba(0,0,0,0.06)，精确匹配原硬编码值，并随 light/dark 切换
+$skeleton-bg: $ccui-color-fill-secondary;
+// 高亮渐变：0.06 → fill-secondary，0.15 → fill（light 精确对应），保持亮色观感不变
+$skeleton-bg-active: linear-gradient(
+  90deg,
+  $ccui-color-fill-secondary 25%,
+  $ccui-color-fill 37%,
+  $ccui-color-fill-secondary 63%
+);
+// 图标色：原 0.18 介于 fill(0.15) 与 text-quaternary(0.25) 之间，取最近的 fill 保持低调且参与深色切换
+$skeleton-icon: $ccui-color-fill;
 
 .#{$cls-prefix}-skeleton-node {
   display: inline-flex;
diff --git a/packages/ccui/ui/skeleton/src/skeleton.scss b/packages/ccui/ui/skeleton/src/skeleton.scss
index 4e223f54..a43fbe47 100644
--- a/packages/ccui/ui/skeleton/src/skeleton.scss
+++ b/packages/ccui/ui/skeleton/src/skeleton.scss
@@ -1,7 +1,12 @@
 @use '../../style-var/index.scss' as *;
 
-$skeleton-bg: rgba(0, 0, 0, 0.06);
-$skeleton-bg-active: linear-gradient(90deg, rgba(0, 0, 0, 0.06) 25%, rgba(0, 0, 0, 0.15) 37%, rgba(0, 0, 0, 0.06) 63%);
+$skeleton-bg: $ccui-color-fill-secondary;
+$skeleton-bg-active: linear-gradient(
+  90deg,
+  $ccui-color-fill-secondary 25%,
+  $ccui-color-fill 37%,
+  $ccui-color-fill-secondary 63%
+);
 
 .#{$cls-prefix}-skeleton {
   display: flex;
@@ -35,7 +40,6 @@ $skeleton-bg-active: linear-gradient(90deg, rgba(0, 0, 0, 0.06) 25%, rgba(0, 0,
   &__paragraph {
     margin-top: 24px;
     padding: 0;
-    list-style: none;
 
     &-row {
       width: 100%;
diff --git a/packages/ccui/ui/skeleton/src/skeleton.tsx b/packages/ccui/ui/skeleton/src/skeleton.tsx
index 9b49bfaf..25141944 100644
--- a/packages/ccui/ui/skeleton/src/skeleton.tsx
+++ b/packages/ccui/ui/skeleton/src/skeleton.tsx
@@ -49,7 +49,7 @@ export default defineComponent({
       if (!p) {
         return 0
       }
-      if (typeof p === 'object' && p.rows) {
+      if (typeof p === 'object' && p.rows !== undefined) {
         return p.rows
       }
       return 3
diff --git a/packages/ccui/ui/slider/src/composables/use-slider.ts b/packages/ccui/ui/slider/src/composables/use-slider.ts
index 908fd698..a2a0e42b 100644
--- a/packages/ccui/ui/slider/src/composables/use-slider.ts
+++ b/packages/ccui/ui/slider/src/composables/use-slider.ts
@@ -22,10 +22,10 @@ export function useSliderValue(
 }
 
 export function useSliderCalculation(props: SliderProps) {
-  const range = props.max - props.min
-
   // 计算百分比位置
   const getPercent = (value: number) => {
+    // 量程每次调用实时从 props 读取，min/max 变化后位置计算同步更新
+    const range = props.max - props.min
     if (range <= 0) return 0
 
     const percent = ((value - props.min) / range) * 100
@@ -34,6 +34,8 @@ export function useSliderCalculation(props: SliderProps) {
 
   // 根据百分比计算值（按 step 和 min 对齐）
   const getValueFromPercent = (percent: number) => {
+    // 量程每次调用实时从 props 读取，与下方 clamp/step 对齐共用同一量程
+    const range = props.max - props.min
     if (range <= 0) return props.min
 
     const raw = props.min + (percent / 100) * range
@@ -241,6 +243,16 @@ export function useSliderKeyboard(
   currentValue: Ref<number | number[]>,
   emit: (event: 'update:modelValue' | 'input' | 'change' | 'change-complete', value: number | number[]) => void,
 ) {
+  // 将值对齐到 step 网格并应用 precision，与 getValueFromPercent 的对齐保持一致
+  const snap = (v: number) => {
+    let r = props.step > 0 ? props.min + Math.round((v - props.min) / props.step) * props.step : v
+    if (props.precision != null) {
+      const f = 10 ** props.precision
+      r = Math.round(r * f) / f
+    }
+    return r
+  }
+
   // 键盘事件处理
   const handleKeydown = (event: KeyboardEvent, index?: number) => {
     if (props.disabled) return
@@ -271,15 +283,15 @@ export function useSliderKeyboard(
       const [start, end] = currentValue.value
 
       if (index === 0) {
-        const newStart = Math.max(props.min, Math.min(start + delta, end))
+        const newStart = Math.max(props.min, Math.min(snap(start + delta), end))
         currentValue.value = [newStart, end]
       } else {
-        const newEnd = Math.min(props.max, Math.max(end + delta, start))
+        const newEnd = Math.min(props.max, Math.max(snap(end + delta), start))
         currentValue.value = [start, newEnd]
       }
     } else {
       const current = Array.isArray(currentValue.value) ? currentValue.value[0] : currentValue.value
-      currentValue.value = Math.max(props.min, Math.min(props.max, current + delta))
+      currentValue.value = Math.max(props.min, Math.min(props.max, snap(current + delta)))
     }
 
     emit('change', currentValue.value)
diff --git a/packages/ccui/ui/slider/src/slider.scss b/packages/ccui/ui/slider/src/slider.scss
index 9ec50990..73d9488b 100644
--- a/packages/ccui/ui/slider/src/slider.scss
+++ b/packages/ccui/ui/slider/src/slider.scss
@@ -37,7 +37,7 @@
     width: 100%;
     height: 6px;
     border-radius: 3px;
-    background-color: rgba(0, 0, 0, 0.06);
+    background-color: $ccui-color-fill-secondary;
     overflow: hidden;
   }
 
diff --git a/packages/ccui/ui/slider/src/slider.tsx b/packages/ccui/ui/slider/src/slider.tsx
index fa25a68c..496431f7 100644
--- a/packages/ccui/ui/slider/src/slider.tsx
+++ b/packages/ccui/ui/slider/src/slider.tsx
@@ -69,6 +69,7 @@ export default defineComponent({
       const buttonProps = {
         class: [ns.e('button'), { [ns.em('button', 'disabled')]: props.disabled }],
         tabindex: props.disabled ? -1 : 0,
+        onClick: (e: MouseEvent) => e.stopPropagation(),
         onMousedown: (e: MouseEvent) => handleDragStart(e, index),
         onTouchstart: (e: TouchEvent) => handleDragStart(e, index),
         onKeydown: (e: KeyboardEvent) => handleKeydown(e, index),
diff --git a/packages/ccui/ui/space-compact/src/space-compact.scss b/packages/ccui/ui/space-compact/src/space-compact.scss
index 14f29a2d..be946b95 100644
--- a/packages/ccui/ui/space-compact/src/space-compact.scss
+++ b/packages/ccui/ui/space-compact/src/space-compact.scss
@@ -22,21 +22,25 @@
     margin-inline-start: -1px;
   }
 
-  &--horizontal > *:not(:first-child):not(:last-child) {
-    border-radius: 0;
-  }
-  &--horizontal > *:not(:first-child):not(:last-child) :is(input, button, .ccui-input, .ccui-button, .ccui-select) {
+  &--horizontal > *:not(:first-child):not(:last-child),
+  &--horizontal
+    > *:not(:first-child):not(:last-child)
+    :is(input, button, .#{$cls-prefix}-input, .#{$cls-prefix}-button, .#{$cls-prefix}-select) {
     border-radius: 0;
   }
 
   &--horizontal > *:first-child:not(:last-child),
-  &--horizontal > *:first-child:not(:last-child) :is(input, button, .ccui-input, .ccui-button, .ccui-select) {
+  &--horizontal
+    > *:first-child:not(:last-child)
+    :is(input, button, .#{$cls-prefix}-input, .#{$cls-prefix}-button, .#{$cls-prefix}-select) {
     border-top-right-radius: 0;
     border-bottom-right-radius: 0;
   }
 
   &--horizontal > *:last-child:not(:first-child),
-  &--horizontal > *:last-child:not(:first-child) :is(input, button, .ccui-input, .ccui-button, .ccui-select) {
+  &--horizontal
+    > *:last-child:not(:first-child)
+    :is(input, button, .#{$cls-prefix}-input, .#{$cls-prefix}-button, .#{$cls-prefix}-select) {
     border-top-left-radius: 0;
     border-bottom-left-radius: 0;
   }
@@ -53,18 +57,24 @@
   }
 
   &--vertical > *:not(:first-child):not(:last-child),
-  &--vertical > *:not(:first-child):not(:last-child) :is(input, button, .ccui-input, .ccui-button, .ccui-select) {
+  &--vertical
+    > *:not(:first-child):not(:last-child)
+    :is(input, button, .#{$cls-prefix}-input, .#{$cls-prefix}-button, .#{$cls-prefix}-select) {
     border-radius: 0;
   }
 
   &--vertical > *:first-child:not(:last-child),
-  &--vertical > *:first-child:not(:last-child) :is(input, button, .ccui-input, .ccui-button, .ccui-select) {
+  &--vertical
+    > *:first-child:not(:last-child)
+    :is(input, button, .#{$cls-prefix}-input, .#{$cls-prefix}-button, .#{$cls-prefix}-select) {
     border-bottom-left-radius: 0;
     border-bottom-right-radius: 0;
   }
 
   &--vertical > *:last-child:not(:first-child),
-  &--vertical > *:last-child:not(:first-child) :is(input, button, .ccui-input, .ccui-button, .ccui-select) {
+  &--vertical
+    > *:last-child:not(:first-child)
+    :is(input, button, .#{$cls-prefix}-input, .#{$cls-prefix}-button, .#{$cls-prefix}-select) {
     border-top-left-radius: 0;
     border-top-right-radius: 0;
   }
diff --git a/packages/ccui/ui/spin/src/spin-types.ts b/packages/ccui/ui/spin/src/spin-types.ts
index 593a84ce..1b22658d 100644
--- a/packages/ccui/ui/spin/src/spin-types.ts
+++ b/packages/ccui/ui/spin/src/spin-types.ts
@@ -23,10 +23,6 @@ export const spinProps = {
     type: Boolean,
     default: false,
   },
-  percent: {
-    type: [Number, String] as PropType<number | 'auto'>,
-    default: undefined,
-  },
 } as const
 
 export type SpinProps = ExtractPropTypes<typeof spinProps>
diff --git a/packages/ccui/ui/spin/src/spin.tsx b/packages/ccui/ui/spin/src/spin.tsx
index eadd2abe..156fd1ed 100644
--- a/packages/ccui/ui/spin/src/spin.tsx
+++ b/packages/ccui/ui/spin/src/spin.tsx
@@ -39,7 +39,7 @@ export default defineComponent({
 
     const indicatorCls = computed(() => ({
       [ns.e('dot')]: true,
-      [ns.em('dot', props.size)]: true,
+      ...(props.size !== 'default' ? { [ns.em('dot', props.size)]: true } : {}),
     }))
 
     const renderIndicator = () => {
@@ -57,7 +57,7 @@ export default defineComponent({
     }
 
     const renderSpinner = () => (
-      <div class={[ns.b(), ns.m(props.size), ns.m('spinning')]}>
+      <div class={[ns.b(), ns.m(props.size)]} role="status" aria-live="polite" aria-label={props.tip || '加载中'}>
         {renderIndicator()}
         {props.tip && <div class={ns.e('text')}>{props.tip}</div>}
       </div>
@@ -78,7 +78,12 @@ export default defineComponent({
       return (
         <div class={[ns.e('nested'), visible.value && ns.is('blur')]}>
           {visible.value && <div class={ns.e('overlay')}>{renderSpinner()}</div>}
-          <div class={[ns.e('container'), visible.value && ns.is('blur')]}>{slots.default()}</div>
+          <div
+            class={[ns.e('container'), visible.value && ns.is('blur')]}
+            aria-busy={visible.value ? 'true' : undefined}
+          >
+            {slots.default()}
+          </div>
         </div>
       )
     }
diff --git a/packages/ccui/ui/splitter/src/splitter.scss b/packages/ccui/ui/splitter/src/splitter.scss
index 78d31320..cbf1f9df 100644
--- a/packages/ccui/ui/splitter/src/splitter.scss
+++ b/packages/ccui/ui/splitter/src/splitter.scss
@@ -68,13 +68,12 @@
     }
   }
 
-  &__resizer:last-child {
-    display: none;
-  }
-
   // L-2.23：折叠按钮，挂在 resizer 上
   &__collapse-btn {
     position: absolute;
+    top: 50%;
+    inset-inline-start: 50%;
+    transform: translate(-50%, -50%);
     z-index: 1;
     display: inline-flex;
     align-items: center;
@@ -95,18 +94,6 @@
       color: $ccui-color-primary;
     }
   }
-
-  &__resizer--horizontal &__collapse-btn {
-    top: 50%;
-    inset-inline-start: 50%;
-    transform: translate(-50%, -50%);
-  }
-
-  &__resizer--vertical &__collapse-btn {
-    top: 50%;
-    inset-inline-start: 50%;
-    transform: translate(-50%, -50%);
-  }
 }
 
 // 最后一个 resizer 隐藏（splitter 内部最后没有下一个 panel）
diff --git a/packages/ccui/ui/splitter/src/splitter.tsx b/packages/ccui/ui/splitter/src/splitter.tsx
index 7406e25a..147f653c 100644
--- a/packages/ccui/ui/splitter/src/splitter.tsx
+++ b/packages/ccui/ui/splitter/src/splitter.tsx
@@ -18,6 +18,15 @@ function toNumber(v: number | string | undefined): number | undefined {
   return Number.isNaN(n) ? undefined : n
 }
 
+// 百分比字符串按 total 折算为像素，数值仍按像素原样返回（与 computePixel 约定一致）。
+function toPixel(v: number | string | undefined, total: number): number | undefined {
+  if (typeof v === 'string' && v.endsWith('%')) {
+    const n = Number.parseFloat(v)
+    return Number.isNaN(n) ? undefined : (n / 100) * total
+  }
+  return toNumber(v)
+}
+
 export const Splitter = defineComponent({
   name: 'CSplitter',
   props: splitterProps,
@@ -29,7 +38,7 @@ export const Splitter = defineComponent({
     // L-2.23：layout 显式优先；缺省时回落到 orientation 别名；都没传则默认 horizontal。
     const effectiveLayout = computed<SplitterLayout>(() => props.layout ?? props.orientation ?? 'horizontal')
 
-    const panels = reactive<{ id: number; props: PanelProps; size: number | undefined }[]>([])
+    const panels = reactive<{ id: number; props: PanelProps; size: number | undefined; pixelized: boolean }[]>([])
 
     // L-2.23：折叠状态。Map<panelId, prevSize>，prevSize 用于恢复时还原宽度。
     const collapsedPanels = reactive(new Map<number, number | undefined>())
@@ -39,6 +48,7 @@ export const Splitter = defineComponent({
         id,
         props: p,
         size: toNumber(p.size ?? p.defaultSize),
+        pixelized: false,
       })
     }
     const unregisterPanel = (id: number) => {
@@ -51,9 +61,13 @@ export const Splitter = defineComponent({
 
     let dragState: { panelIdx: number; startPos: number; startA: number; startB: number; total: number } | null = null
 
-    const computePixel = (panel: { props: PanelProps; size: number | undefined }, total: number): number => {
+    const computePixel = (
+      panel: { props: PanelProps; size: number | undefined; pixelized: boolean },
+      total: number,
+    ): number => {
       if (panel.size !== undefined) {
-        if (typeof panel.props.size === 'string' && panel.props.size.endsWith('%')) {
+        // 仅在首次像素化前命中 % 分支，避免把已经是像素的 size 当成百分比再换算。
+        if (!panel.pixelized && typeof panel.props.size === 'string' && panel.props.size.endsWith('%')) {
           return (panel.size / 100) * total
         }
         return panel.size
@@ -73,10 +87,10 @@ export const Splitter = defineComponent({
         return
       }
       const total = dragState.total
-      const minA = toNumber(a.props.min) ?? 0
-      const maxA = toNumber(a.props.max) ?? total
-      const minB = toNumber(b.props.min) ?? 0
-      const maxB = toNumber(b.props.max) ?? total
+      const minA = toPixel(a.props.min, total) ?? 0
+      const maxA = toPixel(a.props.max, total) ?? total
+      const minB = toPixel(b.props.min, total) ?? 0
+      const maxB = toPixel(b.props.max, total) ?? total
       let newA = dragState.startA + delta
       let newB = dragState.startB - delta
       newA = Math.max(minA, Math.min(maxA, newA))
@@ -116,6 +130,7 @@ export const Splitter = defineComponent({
       // 把所有 panel size 转换为像素
       panels.forEach((p) => {
         p.size = computePixel(p, total)
+        p.pixelized = true
       })
       const a = panels[idx]
       const b = panels[idx + 1]
@@ -139,6 +154,11 @@ export const Splitter = defineComponent({
     onBeforeUnmount(() => {
       window.removeEventListener('pointermove', onPointerMove)
       window.removeEventListener('pointerup', onPointerUp)
+      // 拖拽进行中被卸载时，还原 body 全局样式，避免残留 col-resize 光标与禁用文本选择。
+      if (dragState) {
+        document.body.style.cursor = ''
+        document.body.style.userSelect = ''
+      }
     })
 
     // L-2.23：折叠 panel 入口。toggle 时记录或恢复 size，让 panel style 计算走 collapsed=0 分支。
diff --git a/packages/ccui/ui/steps/src/steps.scss b/packages/ccui/ui/steps/src/steps.scss
index 171e8654..c6d31c1a 100644
--- a/packages/ccui/ui/steps/src/steps.scss
+++ b/packages/ccui/ui/steps/src/steps.scss
@@ -64,7 +64,6 @@
   }
 
   &__check {
-    color: #ffffff;
     font-size: 14px;
     line-height: 1;
   }
@@ -143,7 +142,7 @@
 
     .#{$cls-prefix}-steps__number,
     .#{$cls-prefix}-steps__icon-custom {
-      color: #ffffff;
+      color: $ccui-color-text-light-solid;
     }
 
     .#{$cls-prefix}-steps__title {
diff --git a/packages/ccui/ui/steps/src/steps.tsx b/packages/ccui/ui/steps/src/steps.tsx
index 156cfed4..3395779b 100644
--- a/packages/ccui/ui/steps/src/steps.tsx
+++ b/packages/ccui/ui/steps/src/steps.tsx
@@ -76,10 +76,20 @@ export default defineComponent({
               key={index}
               class={itemCls}
               role="listitem"
+              tabindex={item.disabled ? -1 : 0}
               aria-current={isCurrent ? 'step' : undefined}
               aria-disabled={item.disabled || undefined}
               aria-label={stepLabel}
               onClick={() => onItemClick(index, item)}
+              onKeydown={(e: KeyboardEvent) => {
+                if (item.disabled) {
+                  return
+                }
+                if (e.key === 'Enter' || e.key === ' ') {
+                  e.preventDefault()
+                  onItemClick(index, item)
+                }
+              }}
             >
               <div class={ns.e('container')}>
                 <div class={ns.e('tail')}>
diff --git a/packages/ccui/ui/switch/src/switch.scss b/packages/ccui/ui/switch/src/switch.scss
index 201a2a7a..9756c3e0 100644
--- a/packages/ccui/ui/switch/src/switch.scss
+++ b/packages/ccui/ui/switch/src/switch.scss
@@ -12,7 +12,7 @@
   font-size: $ccui-font-size;
   line-height: 22px;
   vertical-align: middle;
-  background: rgba(0, 0, 0, 0.45);
+  background: $ccui-color-text-tertiary;
   border: 0;
   border-radius: 100px;
   cursor: pointer;
@@ -32,7 +32,7 @@
     height: 18px;
     background: #ffffff;
     border-radius: 50%;
-    box-shadow: 0 2px 4px 0 rgba(0, 35, 11, 0.2);
+    box-shadow: 0 2px 4px 0 rgba(0, 0, 0, 0.2);
     transition: all $ccui-motion-duration-mid ease-in-out;
   }
 
diff --git a/packages/ccui/ui/table-column-group/src/table-column-group.tsx b/packages/ccui/ui/table-column-group/src/table-column-group.tsx
index ec19ea01..18b79916 100644
--- a/packages/ccui/ui/table-column-group/src/table-column-group.tsx
+++ b/packages/ccui/ui/table-column-group/src/table-column-group.tsx
@@ -1,11 +1,9 @@
 import type { TableColumn, TableColumnsCollector } from '../../table/src/table-types'
 import type { TableColumnGroupProps } from './table-column-group-types'
 import { defineComponent, inject, onBeforeUnmount, provide, shallowRef, triggerRef } from 'vue'
-import { tableColumnGroupCollectorKey, tableColumnsCollectorKey } from '../../table/src/table-types'
+import { nextColumnOrder, tableColumnGroupCollectorKey, tableColumnsCollectorKey } from '../../table/src/table-types'
 import { tableColumnGroupProps } from './table-column-group-types'
 
-let groupSeq = 0
-
 interface ChildEntry {
   column: TableColumn
   order: number
@@ -18,7 +16,7 @@ export default defineComponent({
     const outer = inject(tableColumnGroupCollectorKey, null) ?? inject(tableColumnsCollectorKey, null)
 
     const id = Symbol('CTableColumnGroup')
-    const order = ++groupSeq
+    const order = nextColumnOrder()
 
     // 子列收集器：内部 TableColumn 注册到这里。
     const childEntries = new Map<symbol, ChildEntry>()
diff --git a/packages/ccui/ui/table-column/src/table-column.tsx b/packages/ccui/ui/table-column/src/table-column.tsx
index 65fa0d87..c300b7a0 100644
--- a/packages/ccui/ui/table-column/src/table-column.tsx
+++ b/packages/ccui/ui/table-column/src/table-column.tsx
@@ -1,11 +1,9 @@
 import type { TableColumn } from '../../table/src/table-types'
 import type { TableColumnProps } from './table-column-types'
 import { defineComponent, inject, onBeforeUnmount } from 'vue'
-import { tableColumnGroupCollectorKey, tableColumnsCollectorKey } from '../../table/src/table-types'
+import { nextColumnOrder, tableColumnGroupCollectorKey, tableColumnsCollectorKey } from '../../table/src/table-types'
 import { tableColumnProps } from './table-column-types'
 
-let columnSeq = 0
-
 export default defineComponent({
   name: 'CTableColumn',
   props: tableColumnProps,
@@ -16,7 +14,14 @@ export default defineComponent({
     const collector = group ?? root
 
     const id = Symbol('CTableColumn')
-    const order = ++columnSeq
+    const order = nextColumnOrder()
+
+    // 稳定的渲染代理：闭包内部读 slot/prop 最新值（slot 优先于 function prop，且保留响应式），
+    // 引用始终复用，避免 getter 每次读取都新建临时闭包。
+    const renderProxy = (scope: { text: any; record: any; index: number; column: TableColumn }) => {
+      if (slots.customRender) return slots.customRender(scope)
+      return props.customRender?.(scope)
+    }
 
     // 关键：用 getter 暴露字段，让 Table 端的 render 读取时直接跟 props 建立响应式依赖。
     // 这样 props 变动不需要在本组件 watch 里 re-register —— 避免 function prop 引用频繁变化导致的递归刷新。
@@ -36,15 +41,9 @@ export default defineComponent({
       filterMultiple: { get: () => props.filterMultiple, enumerable: true, configurable: true },
       onCell: { get: () => props.onCell, enumerable: true, configurable: true },
       onHeaderCell: { get: () => props.onHeaderCell, enumerable: true, configurable: true },
-      // slot 优先于 function prop；用稳定闭包代理，闭包内部读 slot/prop 最新值。
+      // slot 优先于 function prop；复用稳定闭包代理，仅在两者皆无时返回 undefined。
       customRender: {
-        get: () => {
-          if (!slots.customRender && !props.customRender) return undefined
-          return (scope: { text: any; record: any; index: number; column: TableColumn }) => {
-            if (slots.customRender) return slots.customRender(scope)
-            return props.customRender?.(scope)
-          }
-        },
+        get: () => (slots.customRender || props.customRender ? renderProxy : undefined),
         enumerable: true,
         configurable: true,
       },
diff --git a/packages/ccui/ui/table-summary/src/table-summary.tsx b/packages/ccui/ui/table-summary/src/table-summary.tsx
index b1b14a23..a8a1882c 100644
--- a/packages/ccui/ui/table-summary/src/table-summary.tsx
+++ b/packages/ccui/ui/table-summary/src/table-summary.tsx
@@ -1,5 +1,5 @@
 import type { TableSummaryProps } from './table-summary-types'
-import { defineComponent, inject, onBeforeUnmount, watchEffect } from 'vue'
+import { defineComponent, inject, onBeforeUnmount } from 'vue'
 import { tableSummaryCollectorKey } from '../../table/src/table-types'
 import { tableSummaryProps } from './table-summary-types'
 
@@ -11,10 +11,8 @@ export default defineComponent({
 
     if (collector) {
       // 把 default slot 引用交给 Table；Table 在 tfoot 内调用渲染。
-      // 用 watchEffect 而非一次性 push，是因为 slots.default 在某些场景下是动态的。
-      watchEffect(() => {
-        collector.setSummary(slots.default ?? null)
-      })
+      // 一次性注册即可：slot 函数在 Table 渲染时调用，自行捕获父作用域响应式。
+      collector.setSummary(slots.default ?? null)
       onBeforeUnmount(() => collector.setSummary(null))
     }
     // 脱离 <c-table> 父级时静默渲染 null。
diff --git a/packages/ccui/ui/table/src/table-types.ts b/packages/ccui/ui/table/src/table-types.ts
index cf094377..280133e7 100644
--- a/packages/ccui/ui/table/src/table-types.ts
+++ b/packages/ccui/ui/table/src/table-types.ts
@@ -162,6 +162,16 @@ export interface TableColumnsCollector {
 
 export const tableColumnsCollectorKey = Symbol('TableColumnsCollector') as InjectionKey<TableColumnsCollector>
 
+/**
+ * 全局单调递增列序号：`<c-table-column>` 与 `<c-table-column-group>` 共享同一计数器，
+ * 保证顶层列与分组在同一 order 序列内排序，分组内子列同样按全局序号排序。
+ * order 只需全局单调，无需重置。
+ */
+let columnOrderSeq = 0
+export function nextColumnOrder(): number {
+  return ++columnOrderSeq
+}
+
 /**
  * ColumnGroup 子作用域收集器：内部 `<c-table-column>` 注册到 group，而非 root Table。
  */
diff --git a/packages/ccui/ui/table/src/table.scss b/packages/ccui/ui/table/src/table.scss
index 01aef342..d8c70bb1 100644
--- a/packages/ccui/ui/table/src/table.scss
+++ b/packages/ccui/ui/table/src/table.scss
@@ -204,7 +204,8 @@
     display: flex;
     align-items: center;
     justify-content: center;
-    background-color: rgba(255, 255, 255, 0.65);
+    // 主题感知的半透明遮罩：跟随深/浅主题，spinner 保持不透明
+    background-color: color-mix(in srgb, $ccui-color-bg-container 65%, transparent);
   }
 
   &__loading-dot {
diff --git a/packages/ccui/ui/table/src/table.tsx b/packages/ccui/ui/table/src/table.tsx
index 0c7f89cc..29a250f6 100644
--- a/packages/ccui/ui/table/src/table.tsx
+++ b/packages/ccui/ui/table/src/table.tsx
@@ -1,4 +1,4 @@
-import type { CSSProperties, Slot, VNodeChild } from 'vue'
+import type { CSSProperties, Slot, VNode, VNodeChild } from 'vue'
 import type {
   TableCellRenderProps,
   TableColumn,
@@ -531,6 +531,14 @@ export default defineComponent({
               'aria-label': 'Select all rows',
               onClick: (event: MouseEvent) => event.stopPropagation(),
               onChange: (event: Event) => handleSelectAll((event.target as HTMLInputElement).checked),
+              // indeterminate 只能通过 JS property 设置（无法用 attribute），
+              // 在挂载/更新时同步原生半选状态，让屏幕阅读器能播报“部分选中”
+              onVnodeMounted: (vnode: VNode) => {
+                ;(vnode.el as HTMLInputElement).indeterminate = isSomeDisplayRowsSelected.value
+              },
+              onVnodeUpdated: (vnode: VNode) => {
+                ;(vnode.el as HTMLInputElement).indeterminate = isSomeDisplayRowsSelected.value
+              },
             }),
       )
     }
@@ -649,7 +657,11 @@ export default defineComponent({
           value:
             column.filterMultiple === false
               ? selected.length
-                ? column.filters.findIndex((item) => item.value === selected[0]).toString()
+                ? (() => {
+                    // 防止 findIndex 返回 -1（受控旧值已不在 filters 中），回退到 'All' 选项（value=''）
+                    const idx = column.filters.findIndex((item) => item.value === selected[0])
+                    return idx >= 0 ? String(idx) : ''
+                  })()
                 : ''
               : selected
                   .map((value) => column.filters!.findIndex((item) => item.value === value))
diff --git a/packages/ccui/ui/tabs/src/components/tab/tab.tsx b/packages/ccui/ui/tabs/src/components/tab/tab.tsx
index 09c8d227..446cd844 100644
--- a/packages/ccui/ui/tabs/src/components/tab/tab.tsx
+++ b/packages/ccui/ui/tabs/src/components/tab/tab.tsx
@@ -19,8 +19,12 @@ export default defineComponent({
 
     //  组件卸载移除 组件props数据缓存
     onUnmounted(() => {
-      if (tabsState) {
-        tabsState.data = tabsState.data?.filter((item) => item.name !== props.name)
+      if (tabsState && tabsState.data) {
+        const idx = tabsState.data.findIndex((item) => item.name === props.name)
+        if (idx !== -1) {
+          tabsState.data.splice(idx, 1)
+          tabsState.slots?.splice(idx, 1)
+        }
       }
     })
 
diff --git a/packages/ccui/ui/tabs/src/tabs.scss b/packages/ccui/ui/tabs/src/tabs.scss
index 6e8eac4e..a429d25f 100644
--- a/packages/ccui/ui/tabs/src/tabs.scss
+++ b/packages/ccui/ui/tabs/src/tabs.scss
@@ -6,8 +6,4 @@
   width: 100%;
   font-size: $ccui-font-size;
   color: $ccui-color-text;
-
-  &__content {
-    padding-top: 16px;
-  }
 }
diff --git a/packages/ccui/ui/tabs/src/tabs.tsx b/packages/ccui/ui/tabs/src/tabs.tsx
index 72eb5f06..22d12c2a 100644
--- a/packages/ccui/ui/tabs/src/tabs.tsx
+++ b/packages/ccui/ui/tabs/src/tabs.tsx
@@ -21,6 +21,7 @@ export default defineComponent({
     provide<TabsState>(tabsInjectionKey, state)
 
     const setActiveTab = (name: string | number) => {
+      if (props.beforeChange && props.beforeChange(name) === false) return
       state.active = name
 
       // 更新 v-model 触发change事件
diff --git a/packages/ccui/ui/tag/src/tag.scss b/packages/ccui/ui/tag/src/tag.scss
index 42db3c79..fade3c6b 100644
--- a/packages/ccui/ui/tag/src/tag.scss
+++ b/packages/ccui/ui/tag/src/tag.scss
@@ -37,7 +37,7 @@
     align-items: center;
     justify-content: center;
     margin-inline-start: 6px;
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
     font-size: 10px;
     cursor: pointer;
     transition: color $ccui-motion-duration-mid;
@@ -59,7 +59,7 @@
       color: rgba(255, 255, 255, 0.85);
 
       &:hover {
-        color: #ffffff;
+        color: $ccui-color-white;
       }
     }
   }
diff --git a/packages/ccui/ui/textarea/src/textarea.tsx b/packages/ccui/ui/textarea/src/textarea.tsx
index 28e046e3..fc1d57d0 100644
--- a/packages/ccui/ui/textarea/src/textarea.tsx
+++ b/packages/ccui/ui/textarea/src/textarea.tsx
@@ -160,6 +160,8 @@ export default defineComponent({
     const handleBlur = (e: FocusEvent) => emit('blur', e)
 
     const handleKeydown = (e: KeyboardEvent) => {
+      // 输入法合成态（选词/确认候选）不触发 press-enter
+      if (e.isComposing || e.keyCode === 229) return
       // Enter（不含 shift/ctrl/alt/meta）触发 press-enter
       if (e.key === 'Enter' && !e.shiftKey && !e.ctrlKey && !e.altKey && !e.metaKey) {
         emit('press-enter', e)
diff --git a/packages/ccui/ui/time-picker/src/time-picker.tsx b/packages/ccui/ui/time-picker/src/time-picker.tsx
index be02b8a2..747f6cd6 100644
--- a/packages/ccui/ui/time-picker/src/time-picker.tsx
+++ b/packages/ccui/ui/time-picker/src/time-picker.tsx
@@ -167,7 +167,8 @@ export default defineComponent({
       formItem?.validate('change')
     }
 
-    function pickValue(type: ColumnType, value: number) {
+    // 仅预览：计算并写入 pendingDayjs，不 emit、不关闭面板（键盘方向键导航用）
+    function previewValue(type: ColumnType, value: number) {
       let next: Dayjs
       if (type === 'hour') {
         if (props.use12Hours) {
@@ -187,6 +188,11 @@ export default defineComponent({
         next = pendingDayjs.value.hour(from12h(display, value === 1))
       }
       pendingDayjs.value = next
+      return next
+    }
+
+    function pickValue(type: ColumnType, value: number) {
+      const next = previewValue(type, value)
       if (!props.showOk) {
         emitChange(next)
         closePopup()
@@ -268,24 +274,47 @@ export default defineComponent({
         const target = col?.children?.[newIndex] as HTMLElement | undefined
         target?.focus()
       }
+      // 环绕查找下一个未禁用单元格；带步数上界，全禁用时返回 -1 避免死循环
+      const findNext = (start: number, dir: 1 | -1) => {
+        for (let step = 1; step <= total; step++) {
+          const i = (((start + dir * step) % total) + total) % total
+          if (!list[i].disabled) return i
+        }
+        return -1
+      }
+      // 从首/尾方向查找第一个未禁用单元格，全禁用时返回 -1
+      const findEdge = (dir: 1 | -1) => {
+        const start = dir === 1 ? 0 : total - 1
+        for (let step = 0; step < total; step++) {
+          const i = start + dir * step
+          if (!list[i].disabled) return i
+        }
+        return -1
+      }
       if (e.key === 'ArrowDown') {
         e.preventDefault()
-        const next = (index + 1) % total
-        pickValue(type, list[next].value)
+        const next = findNext(index, 1)
+        if (next < 0) return
+        previewValue(type, list[next].value)
         focusCell(next)
       } else if (e.key === 'ArrowUp') {
         e.preventDefault()
-        const prev = (index - 1 + total) % total
-        pickValue(type, list[prev].value)
+        const prev = findNext(index, -1)
+        if (prev < 0) return
+        previewValue(type, list[prev].value)
         focusCell(prev)
       } else if (e.key === 'Home') {
         e.preventDefault()
-        pickValue(type, list[0].value)
-        focusCell(0)
+        const first = findEdge(1)
+        if (first < 0) return
+        previewValue(type, list[first].value)
+        focusCell(first)
       } else if (e.key === 'End') {
         e.preventDefault()
-        pickValue(type, list[total - 1].value)
-        focusCell(total - 1)
+        const last = findEdge(-1)
+        if (last < 0) return
+        previewValue(type, list[last].value)
+        focusCell(last)
       } else if (e.key === 'Enter') {
         e.preventDefault()
         if (props.showOk) clickOk()
@@ -335,7 +364,7 @@ export default defineComponent({
       const cols = popupRef.value.querySelectorAll<HTMLElement>(`[data-time-column]`)
       cols.forEach((col) => {
         const selected =
-          col.querySelector<HTMLElement>(`.${ns.em('cell', 'selected').slice(0)}`.replace('.--', '--')) ??
+          col.querySelector<HTMLElement>(`.${ns.em('cell', 'selected')}`) ??
           col.querySelector<HTMLElement>(`li[aria-selected="true"]`)
         if (!selected) return
         const target = selected.offsetTop - col.clientHeight / 2 + selected.offsetHeight / 2
diff --git a/packages/ccui/ui/timeline/src/timeline-item.tsx b/packages/ccui/ui/timeline/src/timeline-item.tsx
index 1a396778..36b57748 100644
--- a/packages/ccui/ui/timeline/src/timeline-item.tsx
+++ b/packages/ccui/ui/timeline/src/timeline-item.tsx
@@ -56,7 +56,7 @@ export default defineComponent({
 
     // 渲染时间戳
     const renderTimestamp = () => {
-      if (props.hideTimestamp) return null
+      if (props.hideTimestamp || !props.timestamp) return null
 
       return <div class={timestampClasses.value}>{props.timestamp}</div>
     }
diff --git a/packages/ccui/ui/timeline/src/timeline.scss b/packages/ccui/ui/timeline/src/timeline.scss
index 4f2ab091..3d9c8d8e 100644
--- a/packages/ccui/ui/timeline/src/timeline.scss
+++ b/packages/ccui/ui/timeline/src/timeline.scss
@@ -62,15 +62,6 @@
   padding-bottom: 20px;
   list-style: none;
 
-  // 确保隐藏所有列表标记
-  &::marker {
-    display: none;
-  }
-
-  &::before {
-    display: none;
-  }
-
   // 内容包装器
   &__wrapper {
     position: relative;
diff --git a/packages/ccui/ui/tooltip/src/tooltip.scss b/packages/ccui/ui/tooltip/src/tooltip.scss
index 231d2e51..f3d2a4a4 100644
--- a/packages/ccui/ui/tooltip/src/tooltip.scss
+++ b/packages/ccui/ui/tooltip/src/tooltip.scss
@@ -20,14 +20,14 @@
       background: $ccui-feedback-overlay-bg;
       color: $ccui-light-text;
       border: 1px solid $ccui-feedback-overlay-bg;
-      box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.1);
+      box-shadow: $ccui-box-shadow-tertiary;
     }
 
     &--light {
       background: $ccui-base-bg;
       color: $ccui-aide-text-stress;
       border: 1px solid $ccui-color-border;
-      box-shadow: 0 2px 12px 0 rgba(0, 0, 0, 0.1);
+      box-shadow: $ccui-box-shadow-tertiary;
     }
   }
 
diff --git a/packages/ccui/ui/tooltip/src/tooltip.tsx b/packages/ccui/ui/tooltip/src/tooltip.tsx
index 1ac9557e..4992188b 100644
--- a/packages/ccui/ui/tooltip/src/tooltip.tsx
+++ b/packages/ccui/ui/tooltip/src/tooltip.tsx
@@ -40,12 +40,14 @@ export default defineComponent({
     const { floatingStyles, middlewareData, placement, update } = useFloating(triggerRef, popperRef, {
       // 传响应式 placement，保证 placement prop 变化与 flip 翻转都能被 floating-ui 跟踪
       placement: toRef(props, 'placement') as any,
-      middleware: [
+      // middleware 用 computed 包裹，让 floating-ui 通过 toValue 重新求值，
+      // 保证运行时切换 offset / autoAdjustOverflow / showArrow 能重建中间件链
+      middleware: computed(() => [
         offset(props.offset),
         ...(props.autoAdjustOverflow ? [flip()] : []),
         shift({ padding: 8 }),
         ...(props.showArrow ? [arrow({ element: arrowRef })] : []),
-      ],
+      ]) as any,
     })
 
     // 实际生效的方位（flip 翻转后可能与 props.placement 不同），箭头/样式都以此为准
diff --git a/packages/ccui/ui/transfer/src/transfer.scss b/packages/ccui/ui/transfer/src/transfer.scss
index a7d13272..b63f78fc 100644
--- a/packages/ccui/ui/transfer/src/transfer.scss
+++ b/packages/ccui/ui/transfer/src/transfer.scss
@@ -27,7 +27,7 @@
     gap: 8px;
     padding: 8px 12px;
     border-bottom: 1px solid $ccui-dividing-line;
-    color: rgba(0, 0, 0, 0.85);
+    color: $ccui-color-text;
     font-size: 13px;
     background: $ccui-area;
   }
@@ -38,21 +38,21 @@
   }
 
   &__header-count {
-    color: rgba(0, 0, 0, 0.65);
+    color: $ccui-color-text-secondary;
     font-size: 12px;
   }
 
   &__header-icon {
     display: inline-flex;
     align-items: center;
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
     font-size: 12px;
     line-height: 1;
   }
 
   &__header-title {
     margin-left: auto;
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
     font-size: 12px;
   }
 
@@ -68,7 +68,7 @@
     border: 1px solid $ccui-form-control-line;
     border-radius: 4px;
     background: $ccui-color-bg-container;
-    color: rgba(0, 0, 0, 0.88);
+    color: $ccui-color-text;
     font-size: 13px;
     outline: 0;
     transition: border-color 0.2s;
@@ -78,7 +78,7 @@
     }
 
     &::placeholder {
-      color: rgba(0, 0, 0, 0.25);
+      color: $ccui-color-text-placeholder;
     }
   }
 
@@ -96,7 +96,7 @@
     align-items: center;
     justify-content: center;
     padding: 24px;
-    color: rgba(0, 0, 0, 0.25);
+    color: $ccui-color-text-tertiary;
     font-size: 13px;
   }
 
@@ -105,13 +105,13 @@
     align-items: center;
     gap: 8px;
     padding: 6px 12px;
-    color: rgba(0, 0, 0, 0.85);
+    color: $ccui-color-text;
     font-size: 13px;
     cursor: pointer;
     transition: background 0.2s;
 
     &:hover {
-      background: rgba(0, 0, 0, 0.04);
+      background: $ccui-list-item-hover-bg;
     }
 
     &.is-checked {
@@ -119,7 +119,7 @@
     }
 
     &.is-disabled {
-      color: rgba(0, 0, 0, 0.25);
+      color: $ccui-color-text-disabled;
       cursor: not-allowed;
       background: transparent;
     }
@@ -156,7 +156,7 @@
     border: 1px solid $ccui-color-border;
     border-radius: 4px;
     background: $ccui-color-bg-container;
-    color: rgba(0, 0, 0, 0.88);
+    color: $ccui-color-text;
     font-size: 14px;
     line-height: 1;
     white-space: nowrap;
@@ -171,7 +171,7 @@
     }
 
     &:disabled {
-      color: rgba(0, 0, 0, 0.25);
+      color: $ccui-color-text-disabled;
       background: $ccui-list-item-hover-bg;
       cursor: not-allowed;
     }
diff --git a/packages/ccui/ui/transfer/src/transfer.tsx b/packages/ccui/ui/transfer/src/transfer.tsx
index 2634a5aa..9ddb8460 100644
--- a/packages/ccui/ui/transfer/src/transfer.tsx
+++ b/packages/ccui/ui/transfer/src/transfer.tsx
@@ -80,8 +80,13 @@ export default defineComponent({
       return items.slice(start, start + pageSize.value)
     }
 
-    const pagedLeft = computed(() => paginateItems(filteredLeft.value, leftPage.value))
-    const pagedRight = computed(() => paginateItems(filteredRight.value, rightPage.value))
+    // 钳制页码：列表项变少后页码可能越界，slice 会返回空数组导致整列空白，故按 totalPages 回钳
+    const pagedLeft = computed(() =>
+      paginateItems(filteredLeft.value, Math.min(leftPage.value, totalPages(filteredLeft.value))),
+    )
+    const pagedRight = computed(() =>
+      paginateItems(filteredRight.value, Math.min(rightPage.value, totalPages(filteredRight.value))),
+    )
 
     function totalPages(items: TransferItem[]): number {
       if (pageSize.value <= 0) return 1
@@ -184,6 +189,8 @@ export default defineComponent({
           keys.splice(toIdx, 0, dragKey.value)
           emit('update:targetKeys', keys)
           emit('change', keys, 'right' as TransferDirection, [dragKey.value])
+          // 与 move() 保持一致：实际发生重排序后触发 form 校验
+          formItem?.validate('change')
         }
       }
       dragKey.value = null
@@ -254,7 +261,9 @@ export default defineComponent({
       if (pageSize.value <= 0) return null
       const pages = totalPages(totalItems)
       if (pages <= 1) return null
-      const current = direction === 'left' ? leftPage.value : rightPage.value
+      // 钳制显示页码：列表回长后避免出现陈旧的越界页码（如 "3 / 2"）
+      const rawCurrent = direction === 'left' ? leftPage.value : rightPage.value
+      const current = Math.min(rawCurrent, pages)
       const setPage = (p: number) => {
         if (direction === 'left') leftPage.value = p
         else rightPage.value = p
diff --git a/packages/ccui/ui/tree-select/src/tree-select.scss b/packages/ccui/ui/tree-select/src/tree-select.scss
index 33acbaa2..e1f2c2ba 100644
--- a/packages/ccui/ui/tree-select/src/tree-select.scss
+++ b/packages/ccui/ui/tree-select/src/tree-select.scss
@@ -137,7 +137,7 @@
     font-size: 12px;
 
     &:hover {
-      background-color: rgba(0, 0, 0, 0.06);
+      background-color: $ccui-color-fill-tertiary;
       color: $ccui-text;
     }
   }
diff --git a/packages/ccui/ui/tree-select/src/tree-select.tsx b/packages/ccui/ui/tree-select/src/tree-select.tsx
index 74809adc..aed424c3 100644
--- a/packages/ccui/ui/tree-select/src/tree-select.tsx
+++ b/packages/ccui/ui/tree-select/src/tree-select.tsx
@@ -269,13 +269,13 @@ export default defineComponent({
       emitChange(keys.length === 0 ? null : keys)
     }
 
-    function removeTag(e: MouseEvent, key: TreeNodeKey) {
+    function removeTag(e: MouseEvent | KeyboardEvent, key: TreeNodeKey) {
       e.stopPropagation()
       const next = selectedKeys.value.filter((k) => k !== key)
       emitChange(next.length === 0 ? null : next)
     }
 
-    function clear(e: MouseEvent) {
+    function clear(e: MouseEvent | KeyboardEvent) {
       e.stopPropagation()
       if (selectedKeys.value.length === 0) return
       emitChange(null)
@@ -293,7 +293,14 @@ export default defineComponent({
     onMounted(() => {
       document.addEventListener('mousedown', onClickOutside, true)
       if (props.autoFocus) {
-        nextTick(() => inputRef.value?.focus())
+        nextTick(() => {
+          if (props.multiple) {
+            // 多选模式不渲染 <input>，inputRef 恒为 null；真正可聚焦的是 tabindex=0 的 input-wrap
+            ;(rootRef.value?.querySelector(`.${ns.e('input-wrap')}`) as HTMLElement | null)?.focus()
+          } else {
+            inputRef.value?.focus()
+          }
+        })
       }
     })
 
@@ -473,7 +480,14 @@ export default defineComponent({
                     class={ns.e('tag-close')}
                     role="button"
                     aria-label="移除"
+                    tabindex={0}
                     onClick={(e: MouseEvent) => removeTag(e, tag.key)}
+                    onKeydown={(e: KeyboardEvent) => {
+                      if (e.key === 'Enter' || e.key === ' ') {
+                        e.preventDefault()
+                        removeTag(e, tag.key)
+                      }
+                    }}
                   >
                     {slots.removeIcon
                       ? slots.removeIcon()
@@ -529,7 +543,19 @@ export default defineComponent({
         >
           {renderInputContent()}
           {showClear.value ? (
-            <span class={ns.e('clear')} role="button" aria-label="清除" onClick={clear}>
+            <span
+              class={ns.e('clear')}
+              role="button"
+              aria-label="清除"
+              tabindex={0}
+              onClick={clear}
+              onKeydown={(e: KeyboardEvent) => {
+                if (e.key === 'Enter' || e.key === ' ') {
+                  e.preventDefault()
+                  clear(e)
+                }
+              }}
+            >
               {slots.clearIcon ? slots.clearIcon() : (renderIconNode(props.clearIcon) ?? renderIconNode('mdi:close'))}
             </span>
           ) : (
diff --git a/packages/ccui/ui/tree/src/composables/use-tree-flatten.ts b/packages/ccui/ui/tree/src/composables/use-tree-flatten.ts
index 0263b8d2..a56cccbf 100644
--- a/packages/ccui/ui/tree/src/composables/use-tree-flatten.ts
+++ b/packages/ccui/ui/tree/src/composables/use-tree-flatten.ts
@@ -119,11 +119,14 @@ export function useTreeVisible(
     const expanded = expandedKeys.value
     const keyword = searchValue.value.trim()
     const customFilter = filterTreeNode?.value
+    // 过滤/搜索是否处于激活态：以“过滤器是否启用”为判据，
+    // 而非命中集合是否为空——这样零命中时结果为空，而不是回退成整棵树
+    const filtering = !!keyword || !!customFilter
 
     const result: FlattenedTreeNode[] = []
     const visibleAncestors = new Set<TreeNodeKey>()
 
-    if (keyword || customFilter) {
+    if (filtering) {
       // Determine matched keys, then include ancestors
       for (const node of allNodes) {
         const matched = customFilter
@@ -139,7 +142,13 @@ export function useTreeVisible(
     }
 
     for (const node of allNodes) {
-      if (visibleAncestors.size > 0 && !visibleAncestors.has(node.key)) {
+      if (filtering) {
+        // 过滤/搜索激活时，只显示命中节点及其祖先（已收集进 visibleAncestors），
+        // 无视 expanded 状态自动展开命中路径；visibleAncestors 为空即零命中 => 结果为空
+        if (!visibleAncestors.has(node.key)) {
+          continue
+        }
+        result.push(node)
         continue
       }
       const allParentsExpanded = node.parentKeys.every((parentKey) => expanded.has(parentKey))
diff --git a/packages/ccui/ui/tree/src/tree.tsx b/packages/ccui/ui/tree/src/tree.tsx
index dd2bb7cd..726a74e3 100644
--- a/packages/ccui/ui/tree/src/tree.tsx
+++ b/packages/ccui/ui/tree/src/tree.tsx
@@ -21,7 +21,7 @@ function titleToString(value: unknown): string {
   return ''
 }
 
-function highlightTitle(title: unknown, keyword: string): VNode | string {
+function highlightTitle(title: unknown, keyword: string, highlightClass: string): VNode | string {
   const str = titleToString(title)
   if (!keyword) {
     return str
@@ -34,7 +34,7 @@ function highlightTitle(title: unknown, keyword: string): VNode | string {
   }
   return h('span', null, [
     str.slice(0, idx),
-    h('span', { class: 'ccui-tree__highlight' }, str.slice(idx, idx + keyword.length)),
+    h('span', { class: highlightClass }, str.slice(idx, idx + keyword.length)),
     str.slice(idx + keyword.length),
   ])
 }
@@ -363,11 +363,20 @@ export default defineComponent({
           {
             class: ns.e('switcher-error'),
             role: 'button',
+            tabindex: 0,
             title: 'Click to retry',
             onClick: (event: MouseEvent) => {
               event.stopPropagation()
               void retryLoad(node.key)
             },
+            onKeydown: (event: KeyboardEvent) => {
+              // 键盘可达性：Enter / Space 触发与 onClick 相同的重试逻辑
+              if (event.key === 'Enter' || event.key === ' ') {
+                event.preventDefault()
+                event.stopPropagation()
+                void retryLoad(node.key)
+              }
+            },
           },
           '!',
         )
@@ -413,7 +422,7 @@ export default defineComponent({
       if (slots.title) {
         return slots.title({ node, data: node.raw, expanded: expandedKeys.value.has(node.key) })
       }
-      return highlightTitle(node.title, searchValue.value)
+      return highlightTitle(node.title, searchValue.value, ns.e('highlight'))
     }
 
     const renderIcon = (node: FlattenedTreeNode) => {
diff --git a/packages/ccui/ui/typography/src/typography.scss b/packages/ccui/ui/typography/src/typography.scss
index d63a4424..4d37a5ac 100644
--- a/packages/ccui/ui/typography/src/typography.scss
+++ b/packages/ccui/ui/typography/src/typography.scss
@@ -89,8 +89,8 @@
     margin: 0 0.2em;
     padding: 0.2em 0.4em;
     font-size: 85%;
-    background: rgba(150, 150, 150, 0.1);
-    border: 1px solid rgba(100, 100, 100, 0.2);
+    background: $ccui-color-fill-secondary;
+    border: 1px solid $ccui-color-border;
     border-radius: $ccui-border-radius-sm;
     font-family: $ccui-font-family-code;
   }
@@ -99,15 +99,15 @@
     margin: 0 0.2em;
     padding: 0.15em 0.4em 0.1em;
     font-size: 90%;
-    background: rgba(150, 150, 150, 0.06);
-    border: 1px solid rgba(100, 100, 100, 0.2);
+    background: $ccui-color-fill-tertiary;
+    border: 1px solid $ccui-color-border;
     border-bottom-width: 2px;
     border-radius: $ccui-border-radius-sm;
     font-family: $ccui-font-family-code;
   }
 
   mark {
-    background-color: #ffe58f;
+    background-color: $ccui-color-warning-bg;
     padding: 0;
   }
 
diff --git a/packages/ccui/ui/typography/src/typography.tsx b/packages/ccui/ui/typography/src/typography.tsx
index 2b5e3331..e1d90cc0 100644
--- a/packages/ccui/ui/typography/src/typography.tsx
+++ b/packages/ccui/ui/typography/src/typography.tsx
@@ -145,7 +145,9 @@ function createTypographyComponent(
       }
       const finishEdit = () => {
         const cfg = editConfig.value
-        if (!cfg) return
+        // 幂等守卫：Enter 已结束编辑后，textarea 卸载触发的 blur 会再次调用本函数，
+        // 此时 editing 已为 false，直接 return 避免 onChange/onEnd/emit 重复触发
+        if (!cfg || !editing.value) return
         editing.value = false
         cfg.onChange?.(editValue.value)
         cfg.onEnd?.()
@@ -201,9 +203,18 @@ function createTypographyComponent(
         ...buildModifierClasses(props as TextProps),
         ...(extraClass ? extraClass(props) : {}),
         [ns.m('ellipsis')]: !!ellipsisConfig.value && !expanded.value,
-        [ns.m(`ellipsis-${ellipsisRows.value}`)]: !!ellipsisConfig.value && !expanded.value && ellipsisRows.value > 1,
+        [ns.m(`ellipsis-${Math.min(ellipsisRows.value, 6)}`)]:
+          !!ellipsisConfig.value && !expanded.value && ellipsisRows.value > 1,
       }))
 
+      // 让 role="button" 的 span 键盘可达：Enter / Space 触发与 onClick 相同的逻辑
+      const onActivate = (handler: () => void) => (e: KeyboardEvent) => {
+        if (e.key === 'Enter' || e.key === ' ') {
+          e.preventDefault()
+          handler()
+        }
+      }
+
       const renderCopyBtn = (): VNode | null => {
         const cfg = copyConfig.value
         if (!cfg) return null
@@ -214,8 +225,10 @@ function createTypographyComponent(
             <span
               class={[ns.e('copy'), copied.value && ns.is('copied')]}
               role="button"
+              tabindex={0}
               title={titleAttr}
               onClick={triggerCopy}
+              onKeydown={onActivate(triggerCopy)}
             >
               {slots['copy-icon']({ copied: copied.value })}
             </span>
@@ -225,8 +238,10 @@ function createTypographyComponent(
           <span
             class={[ns.e('copy'), copied.value && ns.is('copied')]}
             role="button"
+            tabindex={0}
             title={titleAttr}
             onClick={triggerCopy}
+            onKeydown={onActivate(triggerCopy)}
           >
             {copied.value ? renderIconNode('mdi:check') : renderIconNode('mdi:content-copy')}
           </span>
@@ -240,13 +255,27 @@ function createTypographyComponent(
         if (!triggerTypes.includes('icon')) return null
         if (slots['edit-icon']) {
           return (
-            <span class={ns.e('edit')} role="button" title={cfg.tooltip || undefined} onClick={startEdit}>
+            <span
+              class={ns.e('edit')}
+              role="button"
+              tabindex={0}
+              title={cfg.tooltip || undefined}
+              onClick={startEdit}
+              onKeydown={onActivate(startEdit)}
+            >
               {slots['edit-icon']()}
             </span>
           )
         }
         return (
-          <span class={ns.e('edit')} role="button" title={cfg.tooltip || undefined} onClick={startEdit}>
+          <span
+            class={ns.e('edit')}
+            role="button"
+            tabindex={0}
+            title={cfg.tooltip || undefined}
+            onClick={startEdit}
+            onKeydown={onActivate(startEdit)}
+          >
             ✎
           </span>
         )
@@ -256,16 +285,26 @@ function createTypographyComponent(
         if (!ellipsisExpandable.value) return null
         const cfg = ellipsisConfig.value!
         if (expanded.value) {
-          // collapsible 模式下展示收起；普通 expandable 展开后不再返回
-          if (cfg.expandable !== 'collapsible' && cfg.expandable !== true) return null
           return (
-            <span class={ns.e('collapse')} role="button" onClick={toggleExpand}>
+            <span
+              class={ns.e('collapse')}
+              role="button"
+              tabindex={0}
+              onClick={toggleExpand}
+              onKeydown={onActivate(toggleExpand)}
+            >
               {slots['collapse-text'] ? slots['collapse-text']() : '收起'}
             </span>
           )
         }
         return (
-          <span class={ns.e('expand')} role="button" onClick={toggleExpand}>
+          <span
+            class={ns.e('expand')}
+            role="button"
+            tabindex={0}
+            onClick={toggleExpand}
+            onKeydown={onActivate(toggleExpand)}
+          >
             {slots['expand-text'] ? slots['expand-text']() : '展开'}
           </span>
         )
diff --git a/packages/ccui/ui/upload/src/upload.scss b/packages/ccui/ui/upload/src/upload.scss
index 7d31edb0..96a17d48 100644
--- a/packages/ccui/ui/upload/src/upload.scss
+++ b/packages/ccui/ui/upload/src/upload.scss
@@ -22,7 +22,7 @@
     border: 1px solid $ccui-form-control-line;
     border-radius: 6px;
     background: $ccui-color-bg-container;
-    color: rgba(0, 0, 0, 0.88);
+    color: $ccui-color-text;
     font-size: 14px;
     line-height: 24px;
     cursor: pointer;
@@ -35,7 +35,7 @@
 
     &.is-disabled {
       background: $ccui-list-item-hover-bg;
-      color: rgba(0, 0, 0, 0.25);
+      color: $ccui-color-text-disabled;
       cursor: not-allowed;
     }
   }
@@ -50,7 +50,7 @@
     border: 1px dashed $ccui-color-border;
     border-radius: 8px;
     background: $ccui-area;
-    color: rgba(0, 0, 0, 0.65);
+    color: $ccui-color-text-secondary;
     text-align: center;
     cursor: pointer;
     transition: all 0.2s;
@@ -68,7 +68,7 @@
     &.is-disabled {
       cursor: not-allowed;
       background: $ccui-list-item-hover-bg;
-      color: rgba(0, 0, 0, 0.25);
+      color: $ccui-color-text-disabled;
 
       &:hover {
         border-color: $ccui-color-border;
@@ -98,12 +98,12 @@
     gap: 8px;
     padding: 6px 8px;
     border-radius: 4px;
-    color: rgba(0, 0, 0, 0.85);
+    color: $ccui-color-text;
     font-size: 13px;
     transition: background 0.2s;
 
     &:hover {
-      background: rgba(0, 0, 0, 0.04);
+      background: $ccui-color-fill-tertiary;
     }
 
     &--status-error {
@@ -111,7 +111,7 @@
     }
 
     &--status-uploading {
-      color: rgba(0, 0, 0, 0.65);
+      color: $ccui-color-text-secondary;
     }
   }
 
@@ -128,7 +128,7 @@
   }
 
   &__item-size {
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
     font-size: 12px;
   }
 
@@ -144,7 +144,7 @@
     border: 0;
     border-radius: 50%;
     background: transparent;
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
     font-size: 11px;
     cursor: pointer;
     transition:
@@ -152,8 +152,8 @@
       color 0.2s;
 
     &:hover {
-      background: rgba(0, 0, 0, 0.06);
-      color: rgba(0, 0, 0, 0.85);
+      background: $ccui-color-fill-secondary;
+      color: $ccui-color-text;
     }
   }
 
@@ -183,16 +183,16 @@
     position: relative;
     width: 104px;
     height: 104px;
-    border: 1px dashed rgba(0, 0, 0, 0.15);
+    border: 1px dashed $ccui-color-border;
     border-radius: 6px;
     overflow: hidden;
     display: flex;
     align-items: center;
     justify-content: center;
-    background: rgba(0, 0, 0, 0.02);
+    background: $ccui-color-fill-quaternary;
 
     &:hover {
-      border-color: $ccui-primary;
+      border-color: $ccui-color-primary;
     }
   }
 
@@ -205,7 +205,7 @@
 
   &__item-card-icon {
     font-size: 28px;
-    color: rgba(0, 0, 0, 0.45);
+    color: $ccui-color-text-tertiary;
   }
 
   &__item-card-percent {
@@ -214,7 +214,7 @@
     left: 4px;
     padding: 0 4px;
     background: rgba(0, 0, 0, 0.55);
-    color: #fff;
+    color: $ccui-color-text-light-solid;
     border-radius: 2px;
     font-size: 11px;
   }
@@ -234,7 +234,7 @@
     border: 0;
     border-radius: 50%;
     background: rgba(0, 0, 0, 0.5);
-    color: #fff;
+    color: $ccui-color-text-light-solid;
     cursor: pointer;
     font-size: 12px;
 
@@ -250,7 +250,7 @@
     text-overflow: ellipsis;
     white-space: nowrap;
     font-size: 12px;
-    color: rgba(0, 0, 0, 0.65);
+    color: $ccui-color-text-secondary;
     text-align: center;
   }
 
diff --git a/packages/ccui/ui/watermark/src/watermark-types.ts b/packages/ccui/ui/watermark/src/watermark-types.ts
index c3bdc6bc..f8fb54a8 100644
--- a/packages/ccui/ui/watermark/src/watermark-types.ts
+++ b/packages/ccui/ui/watermark/src/watermark-types.ts
@@ -3,8 +3,8 @@ import type { ExtractPropTypes, PropType } from 'vue'
 export interface WatermarkFont {
   color?: string
   fontSize?: number
-  fontWeight?: 'normal' | 'light' | 'weight' | number
-  fontStyle?: 'none' | 'normal' | 'italic' | 'oblique'
+  fontWeight?: 'normal' | 'lighter' | 'bold' | number
+  fontStyle?: 'normal' | 'italic' | 'oblique'
   fontFamily?: string
 }
 
diff --git a/packages/ccui/ui/watermark/src/watermark.tsx b/packages/ccui/ui/watermark/src/watermark.tsx
index 309da39c..c2453aad 100644
--- a/packages/ccui/ui/watermark/src/watermark.tsx
+++ b/packages/ccui/ui/watermark/src/watermark.tsx
@@ -13,7 +13,7 @@ interface ResolvedFont {
 }
 
 const FONT_DEFAULTS: ResolvedFont = {
-  color: 'rgba(0, 0, 0, 0.15)',
+  color: 'rgba(128, 128, 128, 0.15)',
   fontSize: 16,
   fontWeight: 'normal',
   fontStyle: 'normal',
@@ -71,6 +71,8 @@ export default defineComponent({
     const containerRef = ref<HTMLDivElement>()
     const watermarkEl = ref<HTMLDivElement | null>(null)
     let observer: MutationObserver | null = null
+    // 单调递增的渲染序号：丢弃过期（被后续渲染取代）的异步结果，避免并发竞态
+    let renderToken = 0
 
     const generateBase64 = async (): Promise<{ url: string; size: { width: number; height: number } } | null> => {
       const ratio = getRatio()
@@ -116,8 +118,15 @@ export default defineComponent({
         drawText(ctx, text.filter(Boolean) as string[], props.width, props.height, font)
       }
 
+      let url: string
+      try {
+        url = canvas.toDataURL()
+      } catch {
+        // 画布被跨域图片污染，toDataURL 抛 SecurityError；返回 null 走仅占位 style 分支
+        return null
+      }
       return {
-        url: canvas.toDataURL(),
+        url,
         size: { width: props.width, height: props.height },
       }
     }
@@ -163,8 +172,10 @@ export default defineComponent({
       if (!containerRef.value) {
         return
       }
+      const token = ++renderToken
       const result = await generateBase64()
-      if (!containerRef.value) {
+      // 过期结果（已被后续渲染取代）或已卸载则丢弃，确保只有最新一次写入 style
+      if (token !== renderToken || !containerRef.value) {
         return
       }
       // 先断开 observer 再做自身 DOM 写入：disconnect 会清空待处理记录，