yys-editor/.serena/memories/style_and_conventions.md

# yys-editor 技术栈与风格约定

技术栈
- 前端框架：Vue 3（Composition API，部分 SFC 使用 `<script setup lang="ts">`）
- 构建与开发：Vite
- UI 组件：Element Plus（含 `@element-plus/icons-vue`）
- 状态管理：Pinia（示例：`src/ts/files.ts` 存储文件页签等，含本地存储自动保存）
- 国际化：vue-i18n（`src/locales/zh.json` + `src/locales/ja.json`，默认从浏览器语言推断，fallback 为 `zh`）
- 拖拽缩放：vue3-draggable-resizable
- 其它依赖：`@vueup/vue-quill`（如后续使用富文本）/ `html2canvas` / `vuedraggable` 等

工程与路径
- 别名：`@` 指向 `src/`（见 `vite.config.js` 与 `jsconfig.json`）。
- 入口：`index.html` -> `/src/main.js` -> `App.vue`。
- 静态资源：`public/`（大量图片素材位于 `public/assets/...`）。

代码风格
- 代码格式：Prettier（未见项目级配置，使用默认规则；脚本仅格式化 `src/`）。
- 语法检查：ESLint（`eslint-plugin-vue` + `@vue/eslint-config-prettier`；脚本已启用 `--fix`）。
- 组件命名：PascalCase 单文件组件（`.vue`），按功能归档于 `src/components/`。
- 类型：以 JS 为主，SFC 中可使用 TS（经 Vite/ESBuild 处理，无专门 `tsconfig.json`，有 `jsconfig.json` 路径提示）。
- 国际化：新增/修改文案时，请同步维护 `zh.json` 与 `ja.json`，避免硬编码 UI 文案。
- 状态与持久化：Pinia store 通过 `localStorage` 自动保存，注意 key 兼容；涉及 schema 变更时考虑迁移逻辑。

样式
- 常规样式位于 `src/assets/*.css`，组件中常用 `<style scoped>` 以局部隔离。
- UI 主题由 Element Plus 提供，如需自定义主题请统一约定变量来源。

提交与约定
- 未发现提交规范配置（如 commitlint/husky），建议信息清晰、原子化提交。必要时中英文均可，但保持一致性。

测试
- 未配置自动化测试框架；变更请重点进行手动验收（参见 `task_completion_checklist.md`）。