Skip to content

CodexBar 是一个 macOS 菜单栏应用,用于查看本机 Codex 账号状态、额度、Token 用量、详细统计信息

feat: 为活动卡片和任务中心增加状态文字动效

Bob20b27cc31ad5
diff --git a/CodexBar/Controllers/ActivityCenterPanelController.swift b/CodexBar/Controllers/ActivityCenterPanelController.swift
index 0b5b6b1..4f1df55 100644
--- a/CodexBar/Controllers/ActivityCenterPanelController.swift
+++ b/CodexBar/Controllers/ActivityCenterPanelController.swift
@@ -7,6 +7,7 @@ import SwiftUI
final class ActivityCenterPanelController {
private let activityMonitor: CodexActivityMonitor
private let presentationState: CodexActivityCenterPresentationState
+ private let mainPanelSettings: MainPanelSettings
private let contentHost = SidePanelContentHost<CodexActivityCenterView>(
initialSize: CodexActivityCenterView.initialPanelSize,
ignoresMouseEvents: false,
@@ -29,10 +30,12 @@ final class ActivityCenterPanelController {
init(
activityMonitor: CodexActivityMonitor,
- presentationState: CodexActivityCenterPresentationState
+ presentationState: CodexActivityCenterPresentationState,
+ mainPanelSettings: MainPanelSettings
) {
self.activityMonitor = activityMonitor
self.presentationState = presentationState
+ self.mainPanelSettings = mainPanelSettings
activityMonitor.$snapshot
.dropFirst()
@@ -254,7 +257,8 @@ final class ActivityCenterPanelController {
contentHost.updateContent(
CodexActivityCenterView(
activityMonitor: activityMonitor,
- presentationState: presentationState
+ presentationState: presentationState,
+ mainPanelSettings: mainPanelSettings
),
size: panelSize
)
diff --git a/CodexBar/Controllers/StatusItemController.swift b/CodexBar/Controllers/StatusItemController.swift
index fe3017a..779516d 100644
--- a/CodexBar/Controllers/StatusItemController.swift
+++ b/CodexBar/Controllers/StatusItemController.swift
@@ -31,7 +31,8 @@ final class StatusItemController: NSObject, NSMenuDelegate {
private let resetCreditsPanelController = ResetCreditsPanelController()
private lazy var activityCenterPanelController = ActivityCenterPanelController(
activityMonitor: activityMonitor,
- presentationState: activityCenterPresentationState
+ presentationState: activityCenterPresentationState,
+ mainPanelSettings: mainPanelSettings
)
private var activeMenuSurface = ActiveMenuSurface.none
private lazy var globalHotKeyController = GlobalHotKeyController { [weak self] in
diff --git a/CodexBar/Views/Menu/CodexActivityCard.swift b/CodexBar/Views/Menu/CodexActivityCard.swift
index 2bf01ab..5a38ea4 100644
--- a/CodexBar/Views/Menu/CodexActivityCard.swift
+++ b/CodexBar/Views/Menu/CodexActivityCard.swift
@@ -76,11 +76,11 @@ struct CodexActivityCard: View {
.truncationMode(.middle)
if let detail = content.detail {
- Text(detail)
- .font(.caption2)
- .foregroundStyle(.secondary)
- .lineLimit(1)
- .truncationMode(.tail)
+ CodexActivityStatusText(
+ text: detail,
+ tint: content.tint,
+ effect: statusTextEffect
+ )
}
}
@@ -126,6 +126,7 @@ struct CodexActivityCard: View {
.animation(.codexStatus, value: content.otherTaskCount)
.padding(.horizontal, MenuMetrics.panelPadding)
.frame(maxWidth: .infinity, minHeight: Metrics.height, maxHeight: Metrics.height)
+ .activityStatusParticles(cornerRadius: MenuMetrics.panelCornerRadius)
.liquidGlassSurface(cornerRadius: MenuMetrics.panelCornerRadius)
.overlay {
RoundedRectangle(cornerRadius: MenuMetrics.panelCornerRadius, style: .continuous)
@@ -270,6 +271,15 @@ struct CodexActivityCard: View {
max(0, snapshot.activeCount - 1)
}
+ private var statusTextEffect: CodexActivityStatusText.Effect {
+ guard allowsAnimations else { return .none }
+ switch snapshot.primaryActivity {
+ case .running: return .shimmer
+ case let .waiting(task): return .ionizing(taskID: task.id)
+ case .completed, .terminated, .idle: return .none
+ }
+ }
+
private enum Metrics {
static let height: CGFloat = 58
}
diff --git a/CodexBar/Views/Menu/CodexActivityCenterView.swift b/CodexBar/Views/Menu/CodexActivityCenterView.swift
index 59a42c5..aab0546 100644
--- a/CodexBar/Views/Menu/CodexActivityCenterView.swift
+++ b/CodexBar/Views/Menu/CodexActivityCenterView.swift
@@ -47,6 +47,7 @@ struct CodexActivityCenterPanelContext {
struct CodexActivityCenterView: View {
@ObservedObject var activityMonitor: CodexActivityMonitor
@ObservedObject var presentationState: CodexActivityCenterPresentationState
+ @ObservedObject var mainPanelSettings: MainPanelSettings
var body: some View {
content(now: presentationState.timelineDate)
@@ -55,6 +56,7 @@ struct CodexActivityCenterView: View {
maxHeight: .infinity,
alignment: .topLeading
)
+ .activityStatusParticles(cornerRadius: Metrics.cornerRadius)
.sidePanelChrome(cornerRadius: Metrics.cornerRadius)
}
@@ -133,6 +135,7 @@ struct CodexActivityCenterView: View {
.padding(.vertical, Metrics.verticalPadding)
}
.scrollIndicators(.never)
+ .activityStatusParticleViewport()
}
}
@@ -256,7 +259,8 @@ struct CodexActivityCenterView: View {
modelName: task.modelName,
effort: task.effort,
isAnonymous: task.isAnonymous,
- detail: taskDetail(task, now: now, isWaiting: isWaiting)
+ detail: taskDetail(task, now: now, isWaiting: isWaiting),
+ effect: isWaiting ? .ionizing(taskID: task.id) : .shimmer
)
}
@@ -303,7 +307,8 @@ struct CodexActivityCenterView: View {
modelName: String?,
effort: String?,
isAnonymous: Bool,
- detail: String
+ detail: String,
+ effect: CodexActivityStatusText.Effect = .none
) -> some View {
HStack(alignment: .top, spacing: 9) {
if isAnonymous {
@@ -323,11 +328,13 @@ struct CodexActivityCenterView: View {
effort: effort
)
- Text(detail)
- .font(.caption2)
- .foregroundStyle(.secondary)
- .lineLimit(1)
- .truncationMode(.tail)
+ CodexActivityStatusText(
+ text: detail,
+ tint: tint,
+ effect: presentationState.isPresented
+ && mainPanelSettings.areEntranceAnimationsEnabled
+ ? effect : .none
+ )
}
}
.frame(maxWidth: .infinity, alignment: .leading)
diff --git a/CodexBar/Views/Menu/CodexActivityStatusText.swift b/CodexBar/Views/Menu/CodexActivityStatusText.swift
new file mode 100644
index 0000000..610f977
--- /dev/null
+++ b/CodexBar/Views/Menu/CodexActivityStatusText.swift
@@ -0,0 +1,158 @@
+import SwiftUI
+
+struct CodexActivityStatusText: View {
+ enum Effect: Equatable {
+ case none
+ case shimmer
+ case ionizing(taskID: UUID)
+ }
+
+ let text: String
+ let tint: Color
+ let effect: Effect
+
+ var body: some View {
+ Text(text)
+ .foregroundStyle(tint)
+ .overlay {
+ if effect == .shimmer {
+ ActivityStatusShimmer()
+ .mask {
+ Text(text)
+ .foregroundStyle(.white)
+ .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: .leading)
+ }
+ .allowsHitTesting(false)
+ }
+ }
+ .font(.caption2)
+ .lineLimit(1)
+ .truncationMode(.tail)
+ .anchorPreference(key: ActivityIonizationSourceKey.self, value: .bounds) { bounds in
+ if case let .ionizing(taskID) = effect {
+ return [ActivityIonizationSource(taskID: taskID, bounds: bounds)]
+ }
+ return []
+ }
+ }
+}
+
+extension View {
+ func activityStatusParticles(cornerRadius: CGFloat) -> some View {
+ // 在玻璃背景之前应用, 让粒子位于背景之上和文字之下
+ backgroundPreferenceValue(ActivityIonizationSourceKey.self) { sources in
+ GeometryReader { geometry in
+ let panelBounds = CGRect(origin: .zero, size: geometry.size)
+ let emitters = sources.compactMap { source -> ActivityIonizationEmitter? in
+ let bounds = geometry[source.bounds]
+ let viewport = source.viewport.map { geometry[$0] } ?? panelBounds
+ guard bounds.intersects(viewport), bounds.intersects(panelBounds) else { return nil }
+ return ActivityIonizationEmitter(taskID: source.taskID, bounds: bounds)
+ }
+ if !emitters.isEmpty {
+ ActivityIonizationParticles(emitters: emitters)
+ }
+ }
+ .clipShape(RoundedRectangle(cornerRadius: cornerRadius, style: .continuous))
+ .allowsHitTesting(false)
+ }
+ }
+
+ func activityStatusParticleViewport() -> some View {
+ transformAnchorPreference(key: ActivityIonizationSourceKey.self, value: .bounds) { sources, viewport in
+ for index in sources.indices {
+ sources[index].viewport = viewport
+ }
+ }
+ }
+}
+
+private struct ActivityIonizationSource {
+ let taskID: UUID
+ let bounds: Anchor<CGRect>
+ var viewport: Anchor<CGRect>?
+}
+
+private struct ActivityIonizationEmitter {
+ let bounds: CGRect
+ let seed: Int
+
+ init(taskID: UUID, bounds: CGRect) {
+ self.bounds = bounds
+ // 随机序列只依赖任务身份, 滚动过滤和任务增删不改变其他任务的粒子相位
+ seed = Int(UInt32(truncatingIfNeeded: taskID.hashValue)) * 12
+ }
+}
+
+private struct ActivityIonizationSourceKey: PreferenceKey {
+ static var defaultValue: [ActivityIonizationSource] {
+ []
+ }
+
+ static func reduce(value: inout [ActivityIonizationSource], nextValue: () -> [ActivityIonizationSource]) {
+ value.append(contentsOf: nextValue())
+ }
+}
+
+private struct ActivityIonizationParticles: View {
+ let emitters: [ActivityIonizationEmitter]
+ @State private var startedAt = Date()
+
+ var body: some View {
+ // 面板共用一条粒子时间线, 发射源为空时由宿主移除; 不受任务行和滚动容器裁剪
+ TimelineView(.animation) { timeline in
+ let elapsed = timeline.date.timeIntervalSince(startedAt)
+ Canvas { context, _ in
+ context.addFilter(.shadow(color: .orange.opacity(0.9), radius: 4.0 / 3))
+ context.addFilter(.shadow(color: .orange.opacity(0.5), radius: 4))
+ for emitter in emitters {
+ for index in 0 ..< 12 {
+ let seed = emitter.seed + index
+ let age = elapsed / 1.1 + ActivityIonizationNoise.value(seed, seed: 7331)
+ let life = age - floor(age)
+ let angle = ActivityIonizationNoise.value(seed, seed: Int(floor(age))) * 2 * .pi
+ let origin = (ActivityIonizationNoise.value(seed, seed: 3) - 0.5) * 140
+ let x = emitter.bounds.midX + origin + cos(angle) * 40 * life
+ let y = emitter.bounds.midY + sin(angle) * 30 * life
+ var particleContext = context
+ particleContext.opacity = 1 - life
+ particleContext.fill(
+ Path(ellipseIn: CGRect(x: x - 1.5, y: y - 1.5, width: 3, height: 3)),
+ with: .color(.orange)
+ )
+ }
+ }
+ }
+ }
+ }
+}
+
+private enum ActivityIonizationNoise {
+ static func value(_ index: Int, seed: Int) -> Double {
+ let value = sin(Double(index + 1) * 127.1 + Double(seed) * 311.7) * 43758.5453
+ return value - floor(value)
+ }
+}
+
+private struct ActivityStatusShimmer: View {
+ @State private var startedAt = Date()
+
+ var body: some View {
+ // 动画只覆盖文字的绘制区域, 不参与排版; 隐藏时移除整个时间线
+ GeometryReader { geometry in
+ TimelineView(.animation) { timeline in
+ let elapsed = timeline.date.timeIntervalSince(startedAt)
+ let progress = elapsed.truncatingRemainder(dividingBy: 2.2) / 2.2
+ let width = geometry.size.width * 0.4
+
+ LinearGradient(
+ colors: [.clear, .white, .clear],
+ startPoint: .leading,
+ endPoint: .trailing
+ )
+ .frame(width: width)
+ .offset(x: (geometry.size.width + width) * progress - width)
+ }
+ }
+ }
+}
diff --git a/Config/Version.xcconfig b/Config/Version.xcconfig
index 7d35abc..12b4d1d 100644
--- a/Config/Version.xcconfig
+++ b/Config/Version.xcconfig
@@ -1,2 +1,2 @@
-MARKETING_VERSION = 4.0.7
-CURRENT_PROJECT_VERSION = 107
+MARKETING_VERSION = 4.0.8
+CURRENT_PROJECT_VERSION = 108
diff --git a/Docs/DeveloperGuide/ui-and-lifecycle.md b/Docs/DeveloperGuide/ui-and-lifecycle.md
index a4848ac..3620bc1 100644
--- a/Docs/DeveloperGuide/ui-and-lifecycle.md
+++ b/Docs/DeveloperGuide/ui-and-lifecycle.md
@@ -151,13 +151,15 @@ hidden -> opening -> shown -> closing -> hidden
popover 和备用面板分别持有 `MenuSurfaceAnimationState`。展示前将 `allowsAnimations` 设为 `true`,淡出期间保持开启,实际关闭后设为 `false`
-`CodexStatusMenuView` 在宿主动画许可关闭时,将根视图事务的 `animation` 设为 `nil`、`disablesAnimations` 设为 `true`。持续动画使用 `mainPanelAnimationsEnabled` 环境值,同时要求宿主动画许可和设置中的“动画效果”开关开启。宿主隐藏或用户关闭动画效果时必须移除持续动画视图,不能只依赖事务禁用。后台数据刷新继续执行。
+`CodexStatusMenuView` 在宿主动画许可关闭时,将根视图事务的 `animation` 设为 `nil`、`disablesAnimations` 设为 `true`。主面板内的持续动画使用 `mainPanelAnimationsEnabled` 环境值,同时要求宿主动画许可和设置中的“动画效果”开关开启。宿主隐藏或用户关闭动画效果时移除持续动画视图,后台数据刷新继续执行。
`MenuSurfaceVisibilityState` 在面板展示后开启,在关闭开始时结束。每次展示递增 `presentationGeneration`,额度和用量区域以该值作为视图身份,重新执行入场动画。
### 活动卡片
-`CodexActivityCard` 使用 `primaryActivity`,优先显示等待批准,其次是运行中;无活跃任务时按结束时间选择最新的完成或终止,时间相同优先终止。`isActivelyPreventingSleep` 为 `true` 且卡片数据可用时显示青绿色 `sun.max.fill`。所属宿主的 `mainPanelAnimationsEnabled` 开启时创建独立的旋转视图,以线性动画每 2 秒顺时针旋转一圈,不使用系统符号效果的启动加速阶段。关闭许可后移除旋转视图并切回静态图标;重新展示时仅在“动画效果”开启的情况下恢复旋转。popover 与 fallback 宿主各自控制,不互相激活动画。tooltip 按 `sleepPreventionSource` 显示来源。
+`CodexActivityCard` 使用 `primaryActivity`,优先显示等待批准,其次是运行中;无活跃任务时按结束时间选择最新的完成或终止,时间相同优先终止。`isActivelyPreventingSleep` 为 `true` 且卡片数据可用时显示青绿色 `sun.max.fill`,tooltip 按 `sleepPreventionSource` 显示来源。所属宿主的 `mainPanelAnimationsEnabled` 开启时,太阳徽标每 2 秒匀速顺时针旋转一圈;关闭时移除旋转视图并显示静态图标。
+
+活动卡片和任务中心共用 `CodexActivityStatusText`,文字颜色跟随任务状态。运行时显示扫光,等待批准时显示橙色粒子,完成和终止时静态显示。卡片动画由 `mainPanelAnimationsEnabled` 控制,任务中心动画要求 `presentationState.isPresented` 和 `MainPanelSettings.areEntranceAnimationsEnabled` 同时开启。每个面板共用一条粒子时间线,只从可见的等待文字发射粒子,按面板边界裁剪;没有发射源时移除时间线。
## Fallback panel
@@ -196,7 +198,7 @@ fallback panel 在展示前根据 SwiftUI fitting size 和目标屏幕可见区
热力图详情面板以包含标题、日期范围和方格矩阵的完整热力图区域作为垂直锚点,因此主面板区域重排后仍优先保持两者顶边对齐。如果详情面板从该位置向下会超过主面板底边,则定位逻辑将它整体上移到与主面板底边对齐。
-主面板可见时,数字随数据变化滚动,Token 数字与待查询或不可用占位之间淡入淡出。“动画效果”控制入场动画和太阳徽标旋转,数字更新不受此开关控制。
+主面板可见时,数字随数据变化滚动,Token 数字与待查询或不可用占位之间淡入淡出。“动画效果”控制入场动画、太阳徽标旋转和任务状态文字动画,数字更新不受此开关控制。
相关控制器包括:
@@ -320,6 +322,7 @@ app-server 状态默认每 60 秒检查刷新。主面板的 0.24 秒淡入完
- 代理密码显隐切换时淡化正常,输入内容、选区和焦点保留
- 点击主面板外部正确关闭,点击侧边面板不误关闭
- 热力图、Reset Credits 和活动中心保持互斥
+- 活动卡片和任务中心在运行、等待批准、完成和终止之间切换时,文字颜色与动画匹配;关闭“动画效果”后保持静态,关闭面板后停止持续动画;滚动任务中心时,仅可见的等待文字发射粒子
- Token 用量区域处于不同排序位置时,热力图详情优先与完整热力图区域顶边对齐;详情高度放不下时与主面板底边对齐
- 全局快捷键在状态栏锚点有效和无效场景都能打开面板
- 从通知点击激活 App 并打开面板
diff --git a/Docs/UserGuide/main-panel.md b/Docs/UserGuide/main-panel.md
index ec79b14..2e990e8 100644
--- a/Docs/UserGuide/main-panel.md
+++ b/Docs/UserGuide/main-panel.md
@@ -107,7 +107,7 @@ CodexBar Hook 开启且当天有数据时,日期详情还会显示以下统计
活动卡片的 `+N` 表示其他活跃任务总数。
-点击有内容的活动卡片可以打开任务中心。
+点击有内容的活动卡片可以打开任务中心。活动卡片和任务中心的状态文字颜色随任务状态变化。开启“动画效果”时,运行状态文字播放扫光,等待批准文字周围显示橙色粒子;关闭后保留静态彩色文字。
## 任务中心
diff --git a/Docs/UserGuide/settings.md b/Docs/UserGuide/settings.md
index a39e091..287c752 100644
--- a/Docs/UserGuide/settings.md
+++ b/Docs/UserGuide/settings.md
@@ -9,7 +9,7 @@
| 设置 | 作用 | 默认或初始状态 |
| --- | --- | --- |
| 主面板布局 | 调整账户、任务、额度、用量和状态的顺序与显隐 | 全部显示;Hook 关闭时任务区域关闭 |
-| 动画效果 | 打开主面板时播放额度条和热力图动画 | 开启 |
+| 动画效果 | 控制额度条和热力图入场动画、太阳徽标旋转,以及活动卡片和任务中心的状态文字动画 | 开启 |
| 流光效果 | 在各显示器顶部用颜色显示任务状态 | 关闭 |
| 开机自动启动 | 登录 Mac 后启动 CodexBar | 跟随系统登录项状态 |
| 自动检查更新 | 定期检查 CodexBar 更新 | 跟随当前更新设置 |
diff --git a/Docs/en/DeveloperGuide/ui-and-lifecycle.md b/Docs/en/DeveloperGuide/ui-and-lifecycle.md
index c03956a..f8d04f4 100644
--- a/Docs/en/DeveloperGuide/ui-and-lifecycle.md
+++ b/Docs/en/DeveloperGuide/ui-and-lifecycle.md
@@ -151,13 +151,15 @@ Settings and log windows temporarily reject `makeKey()` during closing and regai
The popover and fallback panel each hold a separate `MenuSurfaceAnimationState`. `allowsAnimations` is set to `true` before presentation, remains enabled during fade-out, and becomes `false` after the surface closes.
-When host animation permission is disabled, `CodexStatusMenuView` sets the root transaction's `animation` to `nil` and `disablesAnimations` to `true`. Continuous animations use the `mainPanelAnimationsEnabled` environment value, which requires both host permission and the Animation Effects setting. Hiding the host or disabling Animation Effects must remove the continuously animated view; disabling transaction animations alone is insufficient. Background data refresh continues.
+When host animation permission is disabled, `CodexStatusMenuView` sets the root transaction's `animation` to `nil` and `disablesAnimations` to `true`. Continuous animations within the main panel use the `mainPanelAnimationsEnabled` environment value, which requires both host permission and the Animation Effects setting. Hiding the host or disabling Animation Effects removes the continuously animated view. Background data refresh continues.
`MenuSurfaceVisibilityState` begins after the panel is shown and ends when closing starts. Each presentation increments `presentationGeneration`; the rate-limit and usage sections use that value as their view identity and run their entrance animations again.
### Activity Card
-`CodexActivityCard` uses `primaryActivity`, prioritizing waiting for approval, then running, then the latest completion or termination by end time, with termination taking precedence on ties. When `isActivelyPreventingSleep` is `true` and card data is available, it shows a teal `sun.max.fill`. While the host's `mainPanelAnimationsEnabled` is true, a separate rotating view uses linear animation for one clockwise revolution every 2 seconds, without the system symbol effect's acceleration phase. Disabling permission removes the rotating view and restores a static icon. Reopening restores rotation only when Animation Effects is enabled. Popover and fallback hosts control their animations independently. The tooltip identifies `sleepPreventionSource`.
+`CodexActivityCard` uses `primaryActivity`, prioritizing waiting for approval, then running, then the latest completion or termination by end time, with termination taking precedence on ties. When `isActivelyPreventingSleep` is `true` and card data is available, it shows a teal `sun.max.fill`; the tooltip identifies `sleepPreventionSource`. While the host's `mainPanelAnimationsEnabled` is true, the sun badge rotates clockwise at a constant speed of one revolution every 2 seconds. Disabling permission removes the rotating view and shows a static icon.
+
+The activity card and Task Center share `CodexActivityStatusText`, whose color follows task state. Running text shimmers, approval-waiting text emits orange particles, and completed or terminated text stays static. The card uses `mainPanelAnimationsEnabled`; Task Center requires both `presentationState.isPresented` and `MainPanelSettings.areEntranceAnimationsEnabled`. Each panel shares one particle timeline, emits only from visible waiting text, clips particles to the panel bounds, and removes the timeline when no emitters remain.
## Fallback Panel
@@ -196,7 +198,7 @@ Heatmap squares enter with staggered delays based on their column and row. With
The heatmap detail panel uses the complete heatmap area, including its heading, date range, and square grid, as its vertical anchor. Reordering main-panel sections therefore still keeps their top edges aligned whenever possible. If the detail panel would extend below the main panel from that position, placement shifts it upward until their bottom edges align.
-While the main panel is visible, digits roll as values change and Token values fade when switching to or from pending or unavailable placeholders. Animation Effects controls entrance animations and sun-badge rotation; it does not control numeric updates.
+While the main panel is visible, digits roll as values change and Token values fade when switching to or from pending or unavailable placeholders. Animation Effects controls entrance animations, sun-badge rotation, and task status-text animations; it does not control numeric updates.
Related controllers include:
@@ -320,6 +322,7 @@ Release scripts require Developer ID, signing, and notarization credentials and
- Password reveal transitions preserve text, selection, and focus
- Clicking outside the main panel dismisses it; clicking a side panel does not
- Heatmap, Reset Credits, and Task Center panels remain mutually exclusive
+- Activity-card and Task Center text colors and animations match running, approval-waiting, completed, and terminated states; disabling Animation Effects keeps text static, closing the panel stops continuous animations, and scrolling Task Center emits particles only from visible waiting text
- With Token Usage at different positions in the main-panel order, heatmap details align to the complete heatmap area's top edge when possible and fall back to the main panel's bottom edge when the detail height does not fit
- The global shortcut opens the panel with both valid and invalid status-bar anchors
- Clicking a notification activates the app and opens the panel
diff --git a/Docs/en/UserGuide/main-panel.md b/Docs/en/UserGuide/main-panel.md
index e523ea5..6398717 100644
--- a/Docs/en/UserGuide/main-panel.md
+++ b/Docs/en/UserGuide/main-panel.md
@@ -107,7 +107,7 @@ Tasks whose session cannot be identified show an orange anonymous icon with the
The activity card’s `+N` shows the total number of other active tasks.
-Click a populated activity card to open Task Center.
+Click a populated activity card to open Task Center. In both views, status-text colors follow task state. With Animation Effects enabled, running status text shimmers and orange particles appear around approval-waiting text. Disabling the setting keeps the colored text static.
## Task Center
diff --git a/Docs/en/UserGuide/settings.md b/Docs/en/UserGuide/settings.md
index 5ec0c87..a90df76 100644
--- a/Docs/en/UserGuide/settings.md
+++ b/Docs/en/UserGuide/settings.md
@@ -9,7 +9,7 @@ Right-click or Control-click the menu bar icon and choose `Settings`, or press `
| Setting | Purpose | Default or initial state |
| --- | --- | --- |
| Main Panel Layout | Reorder and show or hide Account, Tasks, Quota, Usage, and Status | All visible; Tasks is off when Hook is disabled |
-| Animation Effects | Animate quota bars and the heatmap when opening the panel | On |
+| Animation Effects | Control quota-bar and heatmap entrance animations, sun-badge rotation, and status-text animations in the activity card and Task Center | On |
| Glow Effect | Show task status with colors along the top of each display; requires Hook to be enabled and verified | Off |
| Launch at Login | Start CodexBar when you sign in to your Mac | Follows the system login-item state |
| Automatically Check for Updates | Periodically check for CodexBar updates | Follows the current update setting |
diff --git a/appcast.xml b/appcast.xml
index 334aea1..3a981a3 100644
--- a/appcast.xml
+++ b/appcast.xml
@@ -7,6 +7,15 @@
<link>https://codexbar.zabrian.app/appcast.xml</link>
<description>CodexBar appcast feed</description>
<language>zh-CN</language>
+ <item>
+ <title>CodexBar.app 4.0.8</title>
+ <sparkle:version>108</sparkle:version>
+ <sparkle:shortVersionString>4.0.8</sparkle:shortVersionString>
+ <sparkle:minimumSystemVersion>15.0</sparkle:minimumSystemVersion>
+ <sparkle:releaseNotesLink>https://codexbar.zabrian.app/notes#4.0.8</sparkle:releaseNotesLink>
+ <pubDate>Mon, 28 Sep 2026 14:11:47 +0800</pubDate>
+ <enclosure url="https://codexbar.zabrian.app/download/CodexBar-v4.0.8.dmg" sparkle:edSignature="xClBFa4SP6rZDtLwHIHc4XjF0eUuw38sxeeJEWVa7oZPjEBhyGE9fh3obPTx8V+c7Balp79Kj/XLIuWCDAaXCw==" length="8418816" type="application/octet-stream"/>
+ </item>
<item>
<title>CodexBar.app 4.0.7</title>
<sparkle:version>107</sparkle:version>