Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 21 additions & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -25,8 +25,28 @@ jobs:
- name: Install dependencies
run: pnpm install --frozen-lockfile

- name: Lint (0 errors enforced)
run: pnpm lint

- name: Typecheck
run: pnpm typecheck

- name: Comment style guard
run: pnpm lint:comments

- name: Build app and Electron main process
# e2e 通过 electron.launch 启动真实 Electron,需要 dist-electron/main.js 与 dist/index.html
run: pnpm build

- name: Run tests with coverage
run: pnpm test:ci
# 启动后台 Xvfb 并显式 export DISPLAY,供 Electron 的 ozone/x11 平台使用。
# 不用 xvfb-run 包裹:经 pnpm -> vitest -> playwright -> electron 多层 spawn 后
# 它设的 DISPLAY 在某些 ubuntu runner 上传不到 electron 子进程,导致
# 'Missing X server or $DISPLAY' + SIGSEGV。
run: |
Xvfb :99 -screen 0 1920x1080x24 -nolisten tcp -ac &
export DISPLAY=:99
pnpm test:ci

- name: Upload coverage to Codecov (optional)
if: always()
Expand Down
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ stats.html

# Agent directories
.claude/
.agents/
lat.md/

.glue/
36 changes: 27 additions & 9 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,14 @@
- **同一行中英混合** ❌ → `// 1. 顶部大图 (Main Feature)`
- **无意义注释** ❌ → `// 循环遍历`

### 判定边界

- 英文译名不是技术事实。` (Side Header Stamp)`、` (Main Feature)` 这类中文标题的英文翻译,
与中文写在同一行即属违规。译名要么删掉,要么拆到独立英文行。
- 英文技术坐标、参数值、字体名、URL 属于技术事实,可以与中文同处一个注释块,
但应分两行:中文一行写意图,英文一行写事实。
- 文件头双语标题(如本文档 `# Comment Style Guide / 注释规范`)是文档可读性例外,代码注释不适用。

## 统一方向

> **中文写"为什么",英文写"是什么"。**
Expand All @@ -31,20 +39,30 @@
## 示例

```typescript
// ✅ 正确 — 中文说明业务意图
// A 类: 删除英文译名,只保留中文
// Before: // 1. 左侧大卡片 (Main Feature)
// After: // 1. 左侧大卡片

// B 类: 英文技术坐标拆到独立行
// Before: // 1. 顶部大图 (Rows 1-15) - 遵循天头原则
// After:
// 1. 顶部大图 - 遵循天头原则
// Rows 1-15

// C 类: 中文意图 + 英文技术规格分两行
// Before: // 主标题:Playfair Display, 32pt-48pt, Tracking +150 to +250 (AllCaps)
// After:
// 主标题样式
// Playfair Display, 32pt-48pt, Tracking +150 to +250, AllCaps

// 正确 — 中文说明业务意图
/** 根据模板 ID 从注册表获取正确的宽高比,回退到 16:9 */
function getAspectRatio(templateId: string): number { ... }

// ✅ 正确 — 英文说明技术引用
// 正确 — 英文说明技术引用
// @ts-expect-error — this lib has no types
import foo from 'bar';

// ❌ 错误 — 中英同一行重复
// 1. 顶部大图 (Main Feature)

// ✅ 正确 — 选其一
// 1. 顶部大图

// ✅ 正确 — 对外 API 用英文
// 正确 — 对外 API 用英文
/** Returns the aspect ratio for a given template ID, or the default fallback */
```
3 changes: 1 addition & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -140,8 +140,7 @@ src/
│ ├── expressionEvaluator.ts # 表达式求值器(防原型链污染)
│ └── componentRegistry.ts # 组件名 → React 组件映射
├── workers/
│ ├── fontCalculatorManager.ts # 全局 Worker 单例并发管理器
│ └── fontCalculator.ts # O(1) 闭式字号计算 Worker 线程
│ └── knuthPlassWorker.ts # Knuth-Plass 文本排版 Worker 线程
├── constants/ # Design Tokens、布局画幅、图标库
├── utils/
│ ├── fontLoader.ts # DOM 自定义字体加载与注册
Expand Down
4 changes: 2 additions & 2 deletions docs/architecture/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ SlideGrid Studio 并非一个传统的浏览器应用,而是一个深度融合
### 1.2 渲染进程 (Renderer Process - Chromium 环境)
渲染进程是“表演者”,专注于高频率的 UI 渲染与数据流驱动:
- **解耦渲染管线**: 由 `LayoutRenderer` 作为调度中心,下设 `basePropsResolver`(网格与属性归一化)、`containerRenderer`(Flex/Grid/Modular 容器)、`componentRenderer`(原子组件桥接与 ErrorBoundary)、`repeaterRenderer`(数据驱动循环)以及 `styleWhitelist`(安全样式过滤)。
- **计算引擎**: 负责 24x24 网格的样式计算与表达式解析(防原型链污染);文本自适应字号通过 `fontCalculatorManager` 全局 Worker 单例以 $O(1)$ 闭式代数公式异步计算,避免线程激增。
- **计算引擎**: 负责 24x24 网格的样式计算与表达式解析(防原型链污染);文本排版通过 Knuth-Plass 算法在 Web Worker 中异步求解,避免线程激增。
- **状态树**: Zustand 维护着完整的项目快照,包括 50 步深度快照隔离的 undo/redo 栈。
- **持久化中枢**: `services/recentProjects.ts` 统一管理近期工程列表,具备 LocalStorage 超额分级裁剪与降级保全能力。
- **隔离沙盒**: 为了安全,禁用了 Node.js 集成,所有原生请求必须通过 `ContextBridge` 转发。
Expand Down Expand Up @@ -66,6 +66,6 @@ SlideGrid Studio 解决了“Web 应用数据易失”与“传统桌面应用

- **分包加载**: `vite.config.ts` 中手动定义了 `manualChunks`,将 `react`/`react-dom`/`react-router-dom`(`vendor-react`)、`framer-motion`(`vendor-motion`)、`zustand`/`lucide-react`(`vendor-utils`)、`katex`(`vendor-katex`)等分离为独立 chunk,利用浏览器缓存。
- **离屏无感导出 (OffscreenExportRenderer)**: 多页导出时,应用在离屏专用 DOM 节点中挂载待导出的目标页面,静默等待字体与图片加载就绪后调用 `toPng` 捕获,彻底避免了导出过程中用户可视画面的剧烈翻页、闪烁以及 Framer Motion 淡入动画半透明问题。
- **闭式字号计算**: Web Worker 字体自适应从传统的二分查找循环重构为 $O(1)$ 闭式代数公式推导,且通过 `fontCalculatorManager` 实现全局共享 Worker 实例,消除每个组件实例重复创建 Worker 导致的内存与句柄暴涨。
- **Knuth-Plass 文本排版**: 文本换行与断行从贪心启发式重构为 Knuth-Plass 动态规划求解,在 Web Worker 中异步计算,避免阻塞主线程。
- **GPU 加速**: 全面开启硬件加速,确保数百层 Framer Motion 动画在 4K 屏幕下依然丝滑。
- **零拷贝资产协议**: `asset://` 协议直接从磁盘读取 Buffer 流入渲染进程,避免了 Base64 带来的 33% 内存额外开销。
Loading
Loading