diff --git a/AGENTS.md b/AGENTS.md index 140f221..5048f03 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,128 +1,73 @@ -# NEX Design System — Agent Entry Rules (0.1.6) +# NEX Design System — Agent Development Rules (0.1.7) -本文件是 NEX 的 Agent 入口。先确认 NEX 目录位置,再以本文件所在目录为基准读取 `docs/`、`config/` 和 `templates/`。如果本文件被合并到项目根 `AGENTS.md`,必须将文档路径改为项目中的实际安装路径,不得保留失效的相对路径。 +NEX 的目标是统一设计规范并约束 Agent 开发行为。NEX 不负责测试体系、测试覆盖率、自动化测试、质量闸门或测试报告。 -> **本仓库的实际安装路径**(NEX 0.1.6 随仓库置于 `nex_design_system/`,以下路径相对项目根): -> 规范 `nex_design_system/docs/`、配置模板 `nex_design_system/config/`、模板 `nex_design_system/templates/`。 -> 本文件即项目根 `AGENTS.md`,因此 §1 已改写为实际路径,不再使用失效的 `docs/…` 相对路径。 +> **本仓库的实际安装路径**:NEX 0.1.7 随仓库置于 `nex_design_system/`, +> 因此下文的 `docs/…` 均相对该目录(如 `nex_design_system/docs/01-design-principles.md`)。 +> 本文件即项目根 `AGENTS.md`,§1 第 3、4 项指向的项目规则与项目 UI/UX 规范为: +> `frontend/src/styles/design-tokens.css`(Token 权威来源)、 +> `frontend/src/theme/antdTheme.ts`(antd 主题映射)、 +> `docs/sdd/architecture/standards/nex-conformance-matrix.md`(符合性与例外,按 0.1.6 章节号登记)、 +> `docs/sdd/architecture/standards/responsive-breakpoint-registry.md`(断点登记)、 +> `docs/quickstart.md` §6(前端约定)。本项目没有独立的「项目设计规范」文档,以上即权威来源。 -## 1. 开始任务前必须读取 +## 1. 每个任务的最小读取范围 -1. `nex_design_system/docs/00-governance-and-adaptation.md` -2. `nex_design_system/docs/02-design-principles.md` -3. `nex_design_system/docs/03-design-tokens.md` -4. `nex_design_system/docs/04-layout-system.md` -5. `nex_design_system/docs/05-component-system.md` -6. `nex_design_system/docs/06-interaction-system.md` -7. `nex_design_system/docs/07-page-patterns.md` -8. `nex_design_system/docs/08-accessibility-responsive.md` -9. `nex_design_system/docs/09-agent-execution-rules.md` -10. `nex_design_system/docs/12-responsive-accessibility-quality.md` -11. `nex_design_system/docs/14-accessibility-platform-matrix.md` -12. 项目根目录 `nex.config.yaml`(如存在) -13. 项目级 UI/UX 规范。本项目当前没有独立的「项目设计 specification」文档, - 实际权威来源为:`frontend/src/styles/design-tokens.css`(Token)、 - `frontend/src/theme/antdTheme.ts`(antd 主题映射)、 - `docs/sdd/architecture/standards/nex-conformance-matrix.md`(符合性与例外)、 - `docs/sdd/architecture/standards/responsive-breakpoint-registry.md`(断点登记)、 - `docs/quickstart.md` §6(前端约定)。 +开始任务时读取: +1. 本文件; +2. 项目根目录 `nex.config.yaml`(如存在); +3. 项目根 `AGENTS.md` 中的项目规则; +4. 项目已有的 UI/UX 规范(如存在)。 -只在任务涉及 NexDocus 历史实现或明确要求参考时,读取 -`nex_design_system/docs/01-project-audit.md`。它不是新项目的实施基线。 -NEX 0.1.6 包内**不含** `config/reference-nexdocus-profile.example.yaml` -(`nex_design_system/config/` 下只有 `project-profile.example.yaml`),引用该文件时按缺失处理。 +然后**按任务读取** NEX 文档,不得默认全量读取: +- 视觉风格/页面:`docs/01-design-principles.md`、`docs/08-page-patterns.md`; +- 颜色/主题/Token:`docs/02-design-tokens-and-theme.md`; +- 页面布局/导航/移动端:`docs/03-layout-and-responsive.md`; +- 公共组件:`docs/04-component-system.md`; +- 表单/表格/弹层/反馈:`docs/05-interaction-system.md`; +- 语义/键盘/辅助技术支持:`docs/06-accessibility-design.md`; +- 体验性能/加载呈现:`docs/07-performance-aware-design.md`; +- 新项目技术栈:`docs/10-project-stack-defaults.md`; +- 首次接入:`docs/11-project-adoption.md`。 -## 2. 规范层级 +## 2. 新项目与已有项目 -遵循 NEX 三层模型: +- 新项目:`nex.config.yaml` 的 `stack` 是明确技术选型。按它初始化,不得自行换栈。 +- 已有项目:以真实代码、依赖和锁文件为准,保留现有技术栈;不得因为 NEX 默认值不同而迁移。 +- 项目具体视觉参数、Token 名称、组件 API、布局尺寸和断点以项目级 UI 规范为准。 -- **NEX Core**:跨项目质量与设计治理要求。 -- **Project Design Specification**:本项目视觉、布局、技术和交互的权威具体规范。 -- **Project Implementation**:当前主题、Token、组件和页面的真实实现。 +## 3. 开发时必须遵守 -NexDocus 参数、示例截图和示例组件名不是跨项目默认值。新项目的技术起步默认值以 `nex.config.yaml` 的 `stack` 为准;它只适用于新项目初始化,不是 NEX Core 对所有项目的强制技术栈。已有项目由项目级规范和真实实现决定。NEX Core 的通用 MUST 要求不能因项目偏好而取消,但可以采用不同技术方式满足。 +1. 先理解现有页面和组件,再改代码;优先复用,不重复造组件。 +2. 使用项目既有 Token 和主题单一来源,不另建重复变量层。 +3. 保持同类页面、组件和交互的一致性。 +4. 不擅自改变业务流程、交互路径、默认值或数据语义。 +5. 不擅自升级依赖、替换 UI 库、改变语言或重构目录。 +6. 仅修改完成当前任务所需的范围;不顺手重构无关页面。 +7. 响应式、无障碍和体验性能按对应设计规范实现;不把这些要求扩展成 NEX 自建测试流程。 +8. 若项目实现与 NEX 示例不同,先判断是否是合理的项目适配,不强制套用示例尺寸或命名。 +9. 设计要求有冲突时,以安全/适用规范底线、项目级 UI 规范和用户明确要求为依据;无法确定时只提出一个关键问题。 -## 3. 默认技术栈与自动发现(0.1.6;沿用 0.1.5 默认栈) +## 4. 执行方式 -`nex_design_system/config/project-profile.example.yaml` 是带有明确默认技术栈的配置模板。它不是“技术栈自动猜测模板”。 +默认采用轻量开发: +- 对当前需求做必要分析; +- 查找相关现有组件、Token、页面模式; +- 读取相关 NEX 章节; +- 直接实施必要修改; +- 在对话中简要汇报文件和行为变化。 -- **新项目**:`project.lifecycle` 为 `new`,或 `auto` 且仓库为空/没有实际应用代码时,必须把 `stack` 中的默认技术栈作为初始化目标。不得忽略这些选型,也不得再次要求用户填写一份技术栈问卷。 -- **已有项目**:`project.lifecycle` 为 `existing`,或 `auto` 且仓库已有应用代码/锁文件/构建配置时,以实际项目为准;默认技术栈仅供参考,不得据此替换、升级或迁移现有技术。 -- `project.type` 默认是 `fullstack`。纯前端或纯后端项目只需覆盖该字段。 -- 用户可以只覆盖 `stack` 中不符合当前项目意图的字段;未覆盖的默认值仍然有效。 +只有涉及全局 Token、应用 Shell、导航体系、共享组件 API 或大范围视觉统一时,才先提交简短影响说明和实施计划。 -新项目默认栈详见 `nex_design_system/docs/13-project-stack-defaults.md`,包括 React、TypeScript、Vite、Ant Design、Tailwind CSS v4、Python、FastAPI、SQLite/PostgreSQL 等。依赖版本采用创建时兼容的稳定版本,并提交 lockfile。 +## 5. NEX 的文件和工具边界 -Agent 仍须自动发现已有项目的实际情况,包括: -- 项目名称、类型和主要界面语言; -- 前后端框架、语言、依赖版本、构建工具和 UI/样式方案; -- 项目 UI/UX 规范与设计决策文档; -- Token 权威来源、主题链路、共享组件目录和布局模式; -- 路由、断点、响应式规则、质量命令、视觉基线和 CI; -- 适用的辅助技术验证范围及尚未执行的人工测试。 +- 普通任务不得创建阶段报告、审计报告、`reports/` 目录或截图证据目录。 +- 不得为了遵守 NEX 新建 `scripts/ui/`、自定义检查脚本、自动化测试或质量闸门。 +- 不得自动引入 Playwright、axe、Vitest、Pytest 或其他测试工具;它们由项目自身工程规范决定。 +- 不得启动 VoiceOver、NVDA、Orca 等屏幕阅读器;NEX 不定义其测试流程。 +- 不得把 NEX 规范文档复制成项目中的第二套完整 UI 规范。项目只需保留必要的项目专属设计说明。 +- 只有用户明确要求,或确有长期设计决策需要留档时,才新增/更新文档。 -无法发现的信息应标记 `UNKNOWN` 并说明证据缺口。不得把 `auto` 当成待用户填写的占位符,也不得为了补全配置而向用户发送长问卷。只有在信息无法从仓库确认且会影响产品选择、数据安全或高风险改动时,才提出最少量的具体问题。 +## 6. 汇报要求 -新项目未覆盖的 `stack` 字段采用默认技术栈。已有项目不采用默认栈迁移,而是优先保留真实、成熟的现有实现;NEX 的通用设计质量要求仍然适用。 - -## 4. 开发前审计要求 - -修改既有前端前,先检查: - -- 项目技术栈和真实依赖(以锁文件、`package.json`、构建配置为证据)。 -- 项目级 UI 规范和设计决策记录。 -- Token 的单一事实来源及其派生链路(CSS、主题库、框架变量等)。 -- 已有组件、页面模式、主题机制和布局参数。 -- 现有交互路径、响应式行为、自动化检查与视觉基线。 - -将发现映射为 `COMPLIANT`、`ADOPTED`、`ADAPTED`、`DEFERRED` 或 `NOT_APPLICABLE`。优先使用 `nex_design_system/templates/project-conformance-matrix.md`(本项目落地件:`docs/sdd/architecture/standards/nex-conformance-matrix.md`)。如果用户要求只审计,则不得修改业务代码。 - -## 5. 强制约束 - -1. **先盘点、后复用、再新增。** 先搜索项目现有共享组件和功能等价物。已有组件能满足需求时,不新增重复组件或第二套组件库。 -2. **项目适配优先。** 不将 NEX 参考项目的技术栈、品牌色、Token 名称、Header/Sider 尺寸、断点、控件高度或页面模式套用到其他项目。 -3. **不强制 `--nex-*` 命名。** 优先沿用项目现有语义 Token 和权威主题管线。只有项目没有合理命名体系、且批准采用 NEX 前缀时才可新增命名空间。 -4. **保持 Token 单一事实来源。** 可以由一个源文件/对象/配置单向派生 CSS Variables、组件库主题或框架变量;不得为同一语义值建立彼此独立、人工维护的多份来源。禁止为追求“统一”而破坏已经验证的单向派生链路。 -5. **保护成熟实现,但不固化缺陷。** 保留已验证的视觉和交互模式。若发现可复现的功能缺陷、安全问题或可访问性缺陷,应说明证据并提出最小修复;不得以“保持现状”为由忽略缺陷。 -6. **不擅自改变业务交互。** 视觉改造不得改变用户操作路径、数据语义、默认值或业务流程,除非任务明确授权。修复可访问性时应优先保持原操作意图和鼠标行为。 -7. **不擅自改技术栈。** 不升级框架、替换 UI 库、改变 JS/TS 方案或引入新样式系统,除非用户明确批准。 -8. **页面模式按需采用。** 只为项目真实存在的页面和工作区选择模式。`NOT_APPLICABLE` 的页面、组件和工作区不应被引入。 -9. **避免无意义封装。** 不机械包装所有第三方基础组件;只封装重复、高价值、需要统一 API/状态/可访问性行为的模式。 -10. **交互状态完整。** 适用时覆盖 loading、success、empty、error、disabled、permission-denied 等状态。状态不能只靠颜色表达。 -11. **可访问性是质量底线。** 自定义交互必须支持键盘、可见焦点和可访问名称;拖拽操作必须提供非拖拽替代路径。 -12. **滚动和尺寸必须基于实际布局。** 对嵌套 Flex/Grid 工作区检查 `min-width: 0`、`min-height: 0`、滚动容器归属和溢出,不要机械添加固定尺寸或 `overflow: hidden`。 -13. **不滥用局部覆盖。** 不用大量 `!important`、高优先级选择器或深层第三方 DOM 覆盖来修补应由 Token/主题/共享组件解决的问题;需要时说明范围和原因。 -14. **响应式断点必须登记。** 新增断点应有语义名称、数值/范围、布局理由、权威来源和边界测试;不得散落增加无法追踪的媒体查询。 -15. **窄屏数据必须可对账。** 隐藏列、卡片化或折叠详情不得导致重要数据无处可见;必须核验字段、记录数、顺序和动作仍可访问。 -16. **图标不得污染可访问名称。** 装饰性图标应从辅助技术名称计算中排除;图标与可见文案组合时避免重复朗读;图标本身不能以内部 glyph 名称充当业务文案。 -17. **真实 AT 验证按风险触发且跨平台选择。** 日常默认 E0–E2;只有复杂自定义控件、拖拽/排序、复合导航、关键数据表格、重要 Live Region 或合同/目标用户要求触发 E3。macOS 使用 VoiceOver,Windows 使用 NVDA(必要时 JAWS/Narrator),Linux 使用 Orca。E3 不适用时记录 `E3_NOT_REQUIRED`;必要但环境不可用时标记 `MANUAL_QA_REQUIRED`。 -18. **不得擅自启动屏幕阅读器。** 启动、关闭或切换 VoiceOver/NVDA/Orca 等系统 AT 前必须获得用户对本次 E3 的明确授权。记录初始状态,不得关闭用户原本启用的 AT,不得擅改系统级辅助功能设置。日常视觉、浏览器自动化和键盘验收不得启动屏幕阅读器。 -19. **样式层与性能优化必须有证据。** 不为形式一致进行全量 CSS Layer 迁移;不为消除 Bundle 警告盲目调阈值或分包。先提供级联冲突或实际加载数据,再做最小变更。 -20. **范围受控。** 不把审计顺手扩展为全项目重构。超出授权范围、影响已有体验或需改变设计决策时,先提交方案并等待批准。 - -## 6. 标准工作流 - -1. 读取 NEX Core、项目配置和项目级设计规范。 -2. 检查真实实现并建立符合性/差异映射。 -3. 明确任务范围、复用组件、可能受影响页面和回归面。 -4. 对跨组件或跨页面改动先提交实施计划;仅在用户已明确授权的范围内执行。 -5. 先修正 Token/主题/共享模式,再迁移具体页面;避免一次性机械替换。 -6. 执行项目实际存在的检查命令;不得虚构 lint、test、视觉测试或脚本结果。 -7. 验证受影响的主题、视口、键盘路径和交互状态;使用项目现有检查矩阵,不强制所有项目采用同一固定路由数或视口数。 -8. 汇报改动、规范映射、测试证据、视觉对比、未完成事项和风险。 -9. 对关键交互区分 E0 源码审阅、E1 自动化、E2 浏览器人工交互和 E3 真实辅助技术验证;E3 按风险触发,不适用时记录 `E3_NOT_REQUIRED`,必要但未执行时标记 `MANUAL_QA_REQUIRED`。 - -## 7. 例外记录 - -偏离 NEX Core 的 SHOULD 或采用不同项目实现时,记录:规则、状态(通常为 `ADAPTED` / `DEFERRED`)、原因、证据、影响范围、责任人/批准来源和复审条件。不得把单个项目的例外自动推广为全局规范。 - -## 8. 完成定义 - -只有在以下事项满足后,才能报告任务完成: - -- 项目规范与实现之间没有未说明的重大冲突。 -- 新增实现优先复用了现有组件、Token 和页面模式。 -- 没有未经授权改变技术栈、布局基线或业务交互。 -- 适用的主题、响应式、键盘和状态检查已执行。 -- 项目真实可用的质量门禁已执行;不可执行项已说明。 -- 文档、配置和代码行为保持一致。 +用简洁对话汇报:完成内容、主要文件、关键设计选择、尚未解决的阻塞。除用户明确要求外,不生成长篇报告,不列出与本任务无关的测试证据。 diff --git a/frontend/src/pages/Login/Login.tsx b/frontend/src/pages/Login/Login.tsx index bbf534e..dcc235d 100644 --- a/frontend/src/pages/Login/Login.tsx +++ b/frontend/src/pages/Login/Login.tsx @@ -1,6 +1,7 @@ -import { useState } from 'react' +import { useRef, useState } from 'react' import { useNavigate, useSearchParams } from 'react-router-dom' import { Form, Input, Button, Tabs } from 'antd' +import type { InputRef } from 'antd' import { UserOutlined, LockOutlined, MailOutlined, ArrowRightOutlined } from '@ant-design/icons' import { login, register, type LoginPayload, type RegisterPayload } from '@/api/auth' import { getUserMenus } from '@/api/menu' @@ -18,6 +19,30 @@ function Login() { const navigate = useNavigate() const [searchParams] = useSearchParams() const { setUser, setToken } = useUserStore() + const usernameRef = useRef(null) + const passwordRef = useRef(null) + + /** + * Chrome 会把保存过的账号密码直接写进 input,但不派发 React 能收到的 change 事件, + * 表单值因此还是空的:第一次点「立即登录」被必填校验拦下,看起来像点了没反应, + * 再点一次才成功。这里按 DOM 里的真实值补写进表单并直接重新提交。 + */ + const handleLoginValidationFailed = () => { + const domValues: Partial = {} + const domUsername = usernameRef.current?.input?.value ?? '' + const domPassword = passwordRef.current?.input?.value ?? '' + if (domUsername) { + domValues.username = domUsername + } + if (domPassword) { + domValues.password = domPassword + } + // 只有补齐到「可以提交」才重试,否则会造成校验失败 → 重提交 → 又失败的死循环 + if (!domValues.username || !domValues.password) return + + loginForm.setFieldsValue(domValues) + loginForm.submit() + } const handleLogin = async (values: LoginPayload) => { setLoading(true) @@ -133,6 +158,7 @@ function Login() { form={loginForm} name="login" onFinish={handleLogin} + onFinishFailed={handleLoginValidationFailed} autoComplete="off" layout="vertical" > @@ -142,6 +168,7 @@ function Login() { rules={[{ required: true, message: '请输入用户名' }]} > } placeholder="请输入用户名" size="large" @@ -154,6 +181,7 @@ function Login() { rules={[{ required: true, message: '请输入密码' }]} > } placeholder="请输入密码" diff --git a/frontend/src/pages/ProjectList/ProjectList.css b/frontend/src/pages/ProjectList/ProjectList.css index 6a0e632..839d8b2 100644 --- a/frontend/src/pages/ProjectList/ProjectList.css +++ b/frontend/src/pages/ProjectList/ProjectList.css @@ -22,11 +22,12 @@ /* ========== 项目卡片(统一骨架 + 固定高度) ========== */ .project-card { - height: 236px; + /* 固定高度保证同排卡片等高;取值 = 标题行 + 两行描述 + 元信息 + 操作栏 + 少量余量 */ + height: 224px; display: flex; flex-direction: column; cursor: pointer; - transition: all 0.3s; + transition: transform var(--transition-fast), box-shadow var(--transition-fast), border-color var(--transition-fast); position: relative; overflow: hidden; background: var(--card-bg); @@ -34,8 +35,16 @@ } .project-card:hover { - transform: translateY(-4px); - box-shadow: var(--panel-shadow); + transform: translateY(-2px); + box-shadow: var(--shadow-3); + border-color: var(--border-color-strong); +} + +/* 卡片是「打开项目」的操作(role=button),键盘聚焦必须有明确可见焦点 */ +.project-card:focus-visible { + outline: none; + border-color: var(--color-primary); + box-shadow: var(--focus-ring), var(--shadow-3); } .project-card .ant-card-body { @@ -48,30 +57,36 @@ .project-card .ant-card-actions { flex: none; + background: var(--bg-color-secondary); } +/* antd 自带分隔线颜色不随主题走,这里用项目 Token 覆盖(需要 !important 才稳定压过 antd) */ .project-card .ant-card-actions > li:not(:last-child) { - border-inline-end-color: rgba(15, 23, 42, 0.18) !important; -} - -body.dark .project-card .ant-card-actions > li:not(:last-child) { - border-inline-end-color: rgba(255, 255, 255, 0.2) !important; + border-inline-end-color: var(--border-color-secondary) !important; } .project-card-public-badge { + /* 原先是旋转 45° 的斜带,文字会被卡片圆角裁掉;改为右上角小标签。 + 小号文字用语义浅色底 + 语义前景,两种主题下均达 AA(白字压 --color-success 只有 2.3:1) */ position: absolute; - top: 8px; - right: -28px; - background: linear-gradient(135deg, var(--color-success) 0%, #389e0d 100%); - color: white; - padding: 2px 32px; + top: var(--space-xs); + right: var(--space-xs); + padding: 1px var(--space-xxs); + border-radius: var(--radius-xs); + background: var(--color-success-bg); + color: var(--color-success-strong); font-size: 11px; font-weight: 500; - transform: rotate(45deg); - box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2); + line-height: 16px; z-index: 1; } +/* 右上角徽标会压住标题行末端:给标题留出徽标宽度,长项目名改为提前省略 */ +.project-card:has(.project-card-public-badge) .project-card-title-row, +.project-card:has(.project-card-update-badge) .project-card-title-row { + padding-inline-end: 44px; +} + /* 参与项目右上角:未读更新通知数角标 */ .project-card-update-badge { position: absolute; @@ -81,14 +96,13 @@ body.dark .project-card .ant-card-actions > li:not(:last-child) { min-width: 20px; height: 20px; padding: 0 6px; - border-radius: 999px; - background: linear-gradient(135deg, var(--color-danger) 0%, var(--color-danger-strong) 100%); - color: #fff; + border-radius: var(--radius-pill); + background: var(--color-danger-active); + color: var(--text-color-inverse); font-size: 11px; font-weight: 600; line-height: 20px; text-align: center; - box-shadow: 0 2px 6px rgba(245, 34, 45, 0.45); animation: project-badge-pop 0.25s ease-out; } @@ -123,36 +137,34 @@ body.dark .project-card .ant-card-actions > li:not(:last-child) { flex: none; width: 32px; height: 32px; - border-radius: 9px; + border-radius: var(--radius-md); display: flex; align-items: center; justify-content: center; font-size: 17px; - color: #fff; } +/* 图标只承担「我的 / 参与的」的次要区分:用语义浅色底 + 语义前景, + 不再用渐变和彩色投影(视觉克制),也避免白字压在中低饱和色上不足对比度。 */ .project-card-title-icon.is-owner { - background: linear-gradient(135deg, var(--color-primary) 0%, #69b1ff 100%); - box-shadow: 0 3px 8px rgba(22, 119, 255, 0.25); -} - -body.dark .project-card-title-icon.is-owner { - background: var(--color-primary-gradient); + background: var(--color-primary-bg); + color: var(--color-primary); } .project-card-title-icon.is-shared { - background: linear-gradient(135deg, var(--color-success) 0%, #95de64 100%); - box-shadow: 0 3px 8px rgba(82, 196, 26, 0.25); + background: var(--color-success-bg); + color: var(--color-success-strong); } /* 卡片操作栏 Git 仓库图标:未配置 = 灰色分支图标;已配置 = 实心 GitHub 图标(品牌色区分) */ .project-card-git-action-icon { color: var(--text-color-secondary); font-size: 16px; - transition: color 0.2s; + transition: color var(--transition-fast); } .project-card-git-action-icon.configured { + /* GitHub 品牌标识色:按媒体原始值保留,不随主题语义走 */ color: #24292e; font-size: 17px; } @@ -173,13 +185,15 @@ body.dark .project-card-git-action-icon.configured { color: var(--text-color); } -/* 描述为卡片主要信息,占据剩余空间保证高度一致 */ +/* 描述固定两行高度:卡片等高由它保证, + 不能让 flex 把盒子压到不足两行,否则文字会裁在半行上 */ .project-description { - flex: 1; + flex: none; + height: calc(1.6em * 2); font-size: 13px; line-height: 1.6; color: var(--text-color-secondary); - margin: 0 0 10px; + margin: 0; overflow: hidden; text-overflow: ellipsis; display: -webkit-box; @@ -189,11 +203,12 @@ body.dark .project-card-git-action-icon.configured { /* 底部元信息区:三项信息三等分网格(三分格,无分隔线) */ .project-card-meta { + margin-top: auto; display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); align-items: center; column-gap: 6px; - padding-top: 10px; + padding-top: var(--space-xs); border-top: 1px dashed var(--border-color); color: var(--text-color-secondary); font-size: 12px; @@ -223,106 +238,34 @@ body.dark .project-card-git-action-icon.configured { display: inline-flex; align-items: center; justify-content: center; - gap: 5px; + gap: 4px; min-width: 0; max-width: 100%; -} - -.project-card-owner-avatar { - flex: none; - width: 22px; - height: 22px; - border-radius: 50%; - background: linear-gradient(135deg, var(--color-primary) 0%, #69b1ff 100%); - color: #fff; - font-size: 11px; - font-weight: 600; - display: flex; - align-items: center; - justify-content: center; - user-select: none; -} - -.project-card-share .project-card-owner-avatar { - background: linear-gradient(135deg, var(--color-success) 0%, #95de64 100%); + color: var(--text-color-secondary); } .project-card-owner-name { font-size: 12px; - font-weight: 500; - color: var(--text-color); + color: inherit; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; max-width: 100%; } -/* 项目角色徽章(重新设计:药丸式彩色徽章 + 角色图标) */ -.project-card-role-badge { - display: inline-flex; - align-items: center; - justify-content: center; - gap: 4px; - padding: 2px 9px; - border-radius: 999px; - font-size: 11px; - line-height: 16px; - font-weight: 500; - white-space: nowrap; - max-width: 100%; - overflow: hidden; - text-overflow: ellipsis; -} - -/* 所有者 / 管理者:金色徽章 */ -.project-card-role-badge.role-owner, -.project-card-role-badge.role-admin { - background: rgba(250, 173, 20, 0.16); - color: #d48806; -} - -body.dark .project-card-role-badge.role-owner, -body.dark .project-card-role-badge.role-admin { - background: rgba(250, 173, 20, 0.22); - color: #ffc53d; -} - -/* 编辑者:蓝色徽章 */ -.project-card-role-badge.role-editor { - background: rgba(22, 119, 255, 0.12); - color: var(--link-color); -} - -body.dark .project-card-role-badge.role-editor { - background: rgba(23, 125, 220, 0.25); - color: #4c9be8; -} - -/* 查看者:灰色徽章 */ -.project-card-role-badge.role-viewer { - background: var(--item-hover-bg); - color: var(--text-color-secondary); -} - /* ========== 我的项目卡片:蓝色管理风(无顶边) ========== */ .project-card-my { text-align: left; } -.project-card-my .ant-card-actions { - background: var(--bg-color-secondary); -} - /* ========== 参与的项目卡片:绿色协作风(无顶边) ========== */ .project-card-share { text-align: left; } -.project-card-share .ant-card-actions { - background: var(--bg-color-secondary); -} - -/* 参与项目底部功能项:与我的项目操作项风格保持一致(普通操作项,无药丸背景) */ +/* 参与项目底部:以某角色进入项目是该卡片的主操作。 + 文字用正文色保证两种主题的对比度(主色作文字在暗色下仅 3.9:1,不足 AA 的 4.5:1), + 主色只落在图标上(图形元素 3:1 即可),悬停时才整体转主色。 */ .project-card-view-action { display: inline-flex; align-items: center; @@ -331,13 +274,23 @@ body.dark .project-card-role-badge.role-editor { padding: 0 4px; min-width: 32px; font-size: 14px; + font-weight: 500; line-height: 22px; + color: var(--text-color); cursor: pointer; - transition: color 0.2s ease; + transition: color var(--transition-fast); +} + +.project-card-view-action .anticon { + color: var(--color-primary); } .project-card-view-action:hover { - color: var(--link-color); + color: var(--color-primary-active); +} + +body.dark .project-card-view-action:hover { + color: var(--color-primary-hover); } .project-card-member-action { @@ -346,11 +299,15 @@ body.dark .project-card-role-badge.role-editor { justify-content: center; gap: 4px; cursor: pointer; - transition: color 0.2s ease; + transition: color var(--transition-fast); } .project-card-member-action:hover { - color: var(--link-color); + color: var(--color-primary-active); +} + +body.dark .project-card-member-action:hover { + color: var(--color-primary-hover); } /* ========== 搜索结果卡片(保持旧版居中风格) ========== */ diff --git a/frontend/src/pages/ProjectList/ProjectList.tsx b/frontend/src/pages/ProjectList/ProjectList.tsx index 317228d..bd9c2e0 100644 --- a/frontend/src/pages/ProjectList/ProjectList.tsx +++ b/frontend/src/pages/ProjectList/ProjectList.tsx @@ -142,25 +142,12 @@ function ProjectList({ type = 'my' }: { type?: ProjectListType }) { return project.owner_nickname || project.owner_name || '未知' } - // 卡片归属用户头像首字符 - const cardOwnerInitial = (project: ProjectListItem) => { - const name = cardOwnerName(project) - return (name || '?').charAt(0).toUpperCase() - } - // 卡片角色显示名(我的项目 -> 所有者;参与项目 -> 我的角色) const cardRoleLabel = (project: ProjectListItem) => { if (type === 'my') return '所有者' return projectRoleLabel(project.user_role) } - // 卡片角色徽章样式类 - const cardRoleClass = (project: ProjectListItem) => { - if (type === 'my') return 'role-owner' - const roleMap: Record = { admin: 'role-admin', editor: 'role-editor', viewer: 'role-viewer' } - return roleMap[normalizeRole(project.user_role)] || 'role-viewer' - } - // 卡片角色徽章图标 const cardRoleIcon = (project: ProjectListItem) => { const role = normalizeRole(project.user_role) @@ -807,7 +794,11 @@ function ProjectList({ type = 'my' }: { type?: ProjectListType }) { handleOpenProject(project.id))} onClick={() => handleOpenProject(project.id)} actions={type === 'my' ? [ @@ -850,7 +841,7 @@ function ProjectList({ type = 'my' }: { type?: ProjectListType }) { , ] : [ - + {cardRoleIcon(project)} {cardRoleLabel(project)} @@ -915,7 +906,6 @@ function ProjectList({ type = 'my' }: { type?: ProjectListType }) { {formatRelativeTime(project.last_activity_at) || formatDate(project.created_at) || '—'} - {cardOwnerInitial(project)} {cardOwnerName(project)} diff --git a/frontend/src/styles/design-tokens.css b/frontend/src/styles/design-tokens.css index 7fc1bbd..3dfc4be 100644 --- a/frontend/src/styles/design-tokens.css +++ b/frontend/src/styles/design-tokens.css @@ -18,6 +18,9 @@ --color-success: #52c41a; --color-success-bg: #f6ffed; + /* 成功语义的「可读前景」:用于压在 --color-success-bg 上的文字/图标, + --color-success 本身作前景在白底仅 2.3:1,不能直接承载信息 */ + --color-success-strong: #23780d; --color-warning: #faad14; --color-warning-bg: #fffbe6; --color-danger: #ff4d4f; @@ -133,6 +136,7 @@ body.dark { --color-success: #49aa19; --color-success-bg: rgba(73, 170, 25, 0.16); + --color-success-strong: #73d13d; --color-warning: #d89614; --color-warning-bg: rgba(216, 150, 20, 0.16); --color-danger: #dc4446; diff --git a/frontend/src/utils/request.ts b/frontend/src/utils/request.ts index 56d2098..d7831bc 100644 --- a/frontend/src/utils/request.ts +++ b/frontend/src/utils/request.ts @@ -19,6 +19,8 @@ interface ApiErrorBody { export interface RequestConfig extends AxiosRequestConfig { /** 业务层自行提示错误时置 true,拦截器不再重复弹 Toast */ skipErrorToast?: boolean + /** 请求拦截器记录的本次请求所用 token,用于识别「旧会话迟到的 401」 */ + sentToken?: string | null } export interface ApiRequest { @@ -33,7 +35,9 @@ export interface ApiRequest { blob(config: RequestConfig): Promise> } -let isHandlingUnauthorized = false +// 最近一次处理会话过期的时间:同一批 401 只处理一次; +// 用时间窗而不是布尔量,避免标志一旦置位就永不复位、后续过期再也踢不回登录页。 +let unauthorizedHandledAt = 0 function redirectToLoginWithReturnTo() { const currentPath = `${window.location.pathname}${window.location.search}${window.location.hash}` @@ -41,14 +45,25 @@ function redirectToLoginWithReturnTo() { window.location.href = `/login?redirect=${encodedReturnTo}` } -/** 会话过期:提示一次,清空凭证并跳转登录页(带上返回地址) */ -function handleUnauthorized(message: string) { - if (window.location.pathname.includes('/login') || isHandlingUnauthorized) return - isHandlingUnauthorized = true +/** + * 会话过期:提示一次,清空凭证并跳转登录页(带上返回地址)。 + * + * sentToken 与当前 token 不一致时,说明这是「旧会话迟到的 401」: + * 典型场景是重新登录期间,上一个会话遗留的轮询请求才返回。 + * 此时不能清理/跳转,否则会把刚登录成功的页面又踢回登录页(表现为要点第二次才进得去)。 + */ +function handleUnauthorized(message: string, sentToken?: string | null) { + if (window.location.pathname.includes('/login')) return + if (sentToken && sentToken !== getAccessToken()) return + if (Date.now() - unauthorizedHandledAt < 3000) return + unauthorizedHandledAt = Date.now() Toast.muteErrors(2500) Toast.error('认证失败', message, 3, { force: true }) clearAuthStorage() - setTimeout(() => { + window.setTimeout(() => { + // 延迟期间用户可能已经完成重新登录(后台标签页还会把这个定时器整体延后触发), + // 此时再把页面跳回登录页就会出现「登录成功但进不去,必须再点一次」。 + if (getAccessToken()) return redirectToLoginWithReturnTo() }, 600) // 延迟一小段时间,让提示先展示 } @@ -70,6 +85,7 @@ instance.interceptors.request.use( const token = getAccessToken() if (token) { config.headers.Authorization = `Bearer ${token}` + ;(config as RequestConfig).sentToken = token } return config }, @@ -94,7 +110,7 @@ instance.interceptors.response.use( if (res.code !== 200) { // 401: 未登录或 token 过期 if (res.code === 401) { - handleUnauthorized(res.message || '未登录或登录已过期') + handleUnauthorized(res.message || '未登录或登录已过期', (response.config as RequestConfig).sentToken) return Promise.reject(new Error(res.message || '未登录或登录已过期')) } @@ -116,7 +132,7 @@ instance.interceptors.response.use( // 401 始终走会话过期处理(清空凭证 + 跳转登录页) if (status === 401) { - handleUnauthorized(data?.detail || '未登录或登录已过期') + handleUnauthorized(data?.detail || '未登录或登录已过期', (error.config as RequestConfig | undefined)?.sentToken) } else if (!skipErrorToast) { switch (status) { case 403: diff --git a/nex.config.yaml b/nex.config.yaml index 6c5abbb..7ce3e5d 100644 --- a/nex.config.yaml +++ b/nex.config.yaml @@ -1,24 +1,22 @@ -# NEX 0.1.6 默认项目配置 -# 新项目采用明确默认技术栈;已有项目自动识别并保留现状。 -# 通常无需填写。需要更换技术方案时,只修改 stack 中对应字段即可。 +# NEX 0.1.7 默认项目配置 +# 新项目使用明确默认栈;已有项目保留真实栈。 +# 普通使用无需填写整张表,只需覆盖与项目意图不同的字段。 nex: - version: "0.1.6" + version: "0.1.7" compliance: required - profile_mode: default_stack_with_project_adaptation project: name: auto - lifecycle: auto # auto | new | existing;空仓库按 new,已有代码按 existing + lifecycle: auto # auto | new | existing type: fullstack # fullstack | frontend-only | backend-only language: zh-CN -# 新项目默认技术栈(明确给定);已有项目不得因默认值不同而迁移。 +# 仅作为新项目的默认技术方案。已有项目不得据此迁移。 stack: preset: nex-standard-fullstack version_policy: latest-stable-compatible lockfile: required - frontend: framework: React language: TypeScript @@ -29,25 +27,22 @@ stack: state_management: Zustand routing: React Router http_client: Axios - backend: language: Python framework: FastAPI validation: Pydantic orm: SQLAlchemy migrations: Alembic - database: development: SQLite production: PostgreSQL - api: style: REST contract: OpenAPI - storage: local_assets: ./data +# NEX 只定义设计和开发行为,不定义测试工具或质量闸门。 requirements: use_shared_components: true use_design_tokens: true @@ -55,32 +50,16 @@ requirements: preserve_verified_patterns: true preserve_existing_stack: true avoid_duplicate_design_system_layers: true + responsive_design: required + accessibility_design: required + performance_aware_design: required audit_before_broad_refactor: true require_approval_for_broad_changes: true -tooling: - frontend: - lint: ESLint - format: Prettier - unit_test: Vitest - e2e_test: Playwright - backend: - test: Pytest - -quality: - auto_discover_commands: true - responsive_review: true - keyboard_review: true - accessibility_naming_review: true - responsive_table_data_reconciliation: true - require_non_drag_alternative_when_applicable: true - performance_optimization_requires_measurement: true - accessibility: - engineering_target: WCAG_2_2_AA - routine_evidence_levels: [E0, E1, E2] - advanced_evidence_level: E3 - real_screen_reader_testing: risk_based - screen_reader_platform_matrix: auto_by_project_support_scope - auto_start_screen_reader: false - explicit_user_approval_before_start: true - unavailable_environment_status: MANUAL_QA_REQUIRED +agent: + default_execution: lightweight + load_documents_by_task: true + create_reports_by_default: false + create_custom_check_scripts: false + add_test_frameworks: false + run_full_project_audit_for_routine_tasks: false