suzmii
d451415edc
- D1 档位点被轨道压住且与圆钮错位：容器改 `display: flex; justify-content: space-between; padding: 0 6.5px`（= 圆钮半径 10 − 半点宽 3.5），首末点中心因此落在圆钮两端极限位置；`z-index: 2` 抬到 range 之上；当前档位那一点 `opacity: 0`（圆钮已压在那儿）；点改深暖底 `--platform-text-strong` + `--platform-input-highlight` 描边。无头 Chromium 实测（222px 轨道）：5 个点中心与圆钮算式偏移全部 0.00px（旧实现 +12.19/+6.09/−0.02/−6.11/−12.20）、点与相邻轨道对比度 10.51~10.59:1（旧 1.21~1.23:1）、当前档位点被圆钮覆盖（中心差 ≤0.5px） - D2 状态文案（`role="status"`）也会把那排控件顶成两行高：`ConversationModelSelect` 的 notice 与失败分开两条浮层通道（`onNotice` / `onUnavailable`，各自去重），`ComposerReasoningEffortSelect` 加 `noticePresentation: 'inline' | 'toast'` + `onNotice`；`toast` 形态下两种常驻行都不渲染，状态浮层用 `tone="neutral"`、失败仍 `tone="error"`。Direct 用 `toast`，首页/策划/画布默认 `inline` 行为不变 - D4 `forced-colors` 下焦点完全不可见（thumb 的 box-shadow 会被系统丢弃）：加 `@media (forced-colors: active)` 回退 `outline: 2px solid Highlight; outline-offset: 2px`（系统色，亮色观感不变） - D5 键盘长按每个事件都落盘：`selectEffort` 比对「最近一次落盘成功的档位」（`persistedEffortRef`，挂载回读时种上），相同不写。真实按键序列实测：单击 1 次；长按 1.5s（34 个重复事件）4 次（每个新档位一次）；已在最高档继续长按 1.2s（28 个事件）0 次（旧行为 ~30 次/秒） - D6 拖动中途卸载会丢档位：卸载 cleanup 里 flush 一次预览值（读 ref，不碰已卸载组件的 state）。实测：拖到「中」未松手落盘 0 次，`unmount()` 后恰好 1 次；单次拖动（按下 + 6 步横移 + 松手）全程 1 次且终值 = 松手位置 - D7 文档与实现对齐：pitfalls 里 `--strength-progress` → `--strength-ratio`、圆钮改实心 `--platform-panel-fill` + `--platform-subpanel-border` 1px 描边、输入盒最高高度 254 → 256（工具栏行高由 30px 模型钮决定）、「提示改成控件排内独占一行」按现行浮层口径改写 - D8 去掉 10 处新硬编码色值 `rgb(112 57 30 / x%)`：卡片投影改用既有 token `--platform-desktop-hover-shadow`，圆钮/焦点影由 `color-mix(in srgb, var(--platform-accent) …)` 派生，不新增 token - D9 注释与实现不一致：`.resource-reference-input` 的 `min-height: 0 / padding: 0` 写回前面那条六类规则（不再依赖源码顺序），末尾那条只留网格与行距，注释同步改成「不依赖源码先后」 - D3 深色主题焦点环间隙不可靠：只在 pitfalls 记录（深色 `--platform-input-fill` 仅 5% 不透明；工作台根节点固定 `platform-theme--light`，暂不可达） - 测试：`chat-composer.suite.ts` 新增「notice 走浮层且输入区无 `[role=status]`/`[role=alert]`」「键盘长按同一档位只写一次、换档仍写」「拖动中途卸载恰好提交一次」；`chatDialogFrameLayout.test.ts` 新增档位点对齐/层级/激活点隐藏的声明级断言 - 校验：相关 vitest（chat-composer / chatDialogFrameLayout / design-agent / project-development）、typecheck、eslint、prettier、encoding、spacetime-schema、diff-check Refs #600, PR #607
Genarrative / 陶泥儿
一个 AI 原生互动内容与小游戏平台，当前主站聚焦图片画布创作、项目与素材管理，以及账号、钱包和后台管理等平台公共能力。
当前已经具备这些主要能力：
- 图片画布编辑、项目与素材管理
- 图片、视频、音频等外部生成任务
- 账号、钱包、充值、兑换码与个人资料
- 后台运营、配置与生产运维工具
- AI 游戏创作独立 App
运行
前置条件：
- Node.js
- Rust / Cargo
- SpacetimeDB CLI
安装依赖：
npm install
该命令会按根 package.json 的 npm workspaces 一次安装主站、Admin、Mobile、Desktop、AGC、Preview Deployer、内部 packages 与工具依赖；仓库只使用根 package-lock.json，不要在子目录单独执行 npm install / npm ci 或提交嵌套 lockfile。
准备环境变量：
- 复制
.env.example为.env.local - 只填写本次联调所需配置；不要提交
.env.local、密钥、Token 或其它本地认证信息 - api-server 环境变量和 Provider 配置以
.env.example及当前开发运维文档为准
启动开发环境：
npm run dev
补充说明：
npm run dev会启动 SpacetimeDB standalone、独立bgfilter-worker、Rustapi-server、主站 Vite 与后台 Vite，适合完整联调；内部 worker ready 后才启动 API。- 主站默认地址是
http://127.0.0.1:3000，后台可从http://127.0.0.1:3000/admin/进入，也可直连http://127.0.0.1:3102。 - 五个模块可独立启动：
npm run dev:spacetime、npm run dev:api-server、npm run dev:bgfilter-worker、npm run dev:web、npm run dev:admin-web；其中dev:api-server会安全带起同 runner 的 BgFilter worker 依赖。 - 如需自动刷新后端模块，使用
npm run dev -- --watch；其中spacetime-module改动后只会重新发布模块，不会重启 standalone，Rust 源码改动会把api-server与bgfilter-worker作为一个组合单元重启。主站和后台前端源码变化交给 Vite 自身 HMR，不由外层 watcher 重启。非 watch 模式下可在npm run dev终端输入rs api-server、rs bgfilter-worker、rs web、rs admin-web、rs spacetime或rs all，其中rs spacetime也是只重新发布模块。
构建生产包：
npm run build
常用检查
类型检查：
npm run lint
编码检查：
npm run check:encoding
主要结构
主运行时：
- src/active-main.tsx
- src/ActiveApp.tsx
- src/AuthenticatedApp.tsx
- src/routing/activeAppRoutes.tsx
- src/components/platform-entry/PlatformEntryActiveFlowShell.tsx
创作与项目能力：
- src/components/image-editor/ImageCanvasEditorView.tsx
- src/components/creation-home/CreationLandingView.tsx
- src/components/project/ProjectGalleryView.tsx
文档入口
docs/ 已在 2026-08-25 按当前代码与运行态重新收口。旧 PRD、设计、审计、阶段计划和技术流水账不再作为实现依据；专题文档的现役清单统一从 docs/README.md 进入：
- docs/README.md：当前文档总入口。
- docs/【项目基线】当前产品与工程约束-2026-05-15.md：产品、命名、UI、协作和废弃路线。
- docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md：DDD 边界、API 分组、SpacetimeDB schema 规则和表目录。
- docs/【玩法创作】平台入口与玩法链路-2026-05-15.md：平台现役入口、项目页和画布链路。
- docs/【开发运维】本地开发验证与生产运维-2026-05-15.md：本地启动、检查、部署、埋点和运营查询。
- docs/project-memory/README.md：团队共享的当前项目记忆、决策和未关闭事项。
- UI_CODING_STANDARD.md：像素 UI 资产与编码规范。