MemRelay/global/开发实施原则.md

title, type, permalink, stable_id, scope, project_id, memory_type, status, revision, restored_from_commit, created_at, updated_at, tags

title	type	permalink	stable_id	scope	project_id	memory_type	status	revision	restored_from_commit	created_at	updated_at	tags
开发实施原则	rule	main/global/开发实施原则	bf88c265-4749-4c50-85bc-4bae25298cd5	global	null	rule	active	1	6a6a895eaf	2026-09-23T14:50:37.028184+00:00	2026-09-23T14:50:37.028237+00:00	global rule development

开发实施原则

• 遵循 KISS 与 YAGNI，使用最简单且正确的实现。
• 优先复用项目已有框架、服务、工具和约定，不建立重复实现。
• 不添加为假设未来需求服务的依赖、抽象或基础设施。
• 修改范围与当前目标一致，测试覆盖随风险扩大；完成前清理临时内容和无用代码。
• 前端以真实工作流、桌面可用性、信息层级和无重叠为验收标准。
• Web 表单优先使用“标题在左、控件在右”的紧凑横向布局；Markdown、代码、备注等较大或多行内容使用“标题在上、内容在下”，并根据实际场景调整。
• Web 页面顶部标题区域在内容滚动时保持可见，页面操作继续放在标题区域右侧。
• Web 提示说明放在对应页面、分区或字段标题旁，以提示图标呈现并在鼠标悬停后显示；错误、警告和关键状态仍应直接展示。
• Web 弹窗的保存、取消等操作区域固定显示，不随正文滚动离开视口。
• Markdown 编辑/预览、多行文本、日志和长列表优先在控件内部滚动，并根据桌面浏览器可用高度自适应；避免让整个页面或弹窗承担长内容滚动。
• 表单标签列、控件列和分组间距保持紧凑一致，避免大面积无意义留白；标签页和列表需保留清晰内边距，不能贴边或被遮挡。