Sql Client V3 Dev

3. 构建与运行（默认命令）

• 构建：mvn -q -DskipTests package
• 测试：mvn -q test
• 运行：java -jar target/*-jar-with-dependencies.jar
• 说明：若仓库实际命令不同，以 pom.xml 与 README.md 为准，并同步更新 references/PROJECT_BASELINE.md（仅高层摘要）。

4. Swing / UI 约束（必须遵守）

• 所有 UI 更新必须在 EDT 执行；长耗时任务不得阻塞 EDT（使用后台线程/任务服务）。
• 保持 FlatLaf 风格一致；避免引入与现有风格冲突的新 UI 组件库。
• 除非用户明确要求，否则不得改动现有中文文案/按钮标题/提示文字；需要新增文案时保持风格一致且简短。

5. 代码与架构约束（本仓库开发默认规则）

• 遵循现有包结构与命名；不要随意重排大结构。
• 避免“大重构”；优先局部、可验证的改动。
• 日志：不输出敏感信息（token、密钥、可能携带敏感数据的 SQL 明文需脱敏或截断）。

6. 提交质量门槛

• 仅提交与当前需求直接相关的最小文件集，不夹带无关格式化或重命名。
• 提交前必须至少完成一次构建检查；若可行再补充单测或针对性验证。
• 变更说明必须覆盖：影响范围、验证步骤、潜在风险、回滚方式。
• 涉及 UI 行为改动时，优先提供可复现的操作路径（必要时附截图）。

7. 交付输出格式（每次回答用户）

必须包含：

• ✅ 做了什么（要点）
• 🗂️ 改了哪些文件（列表）
• ▶️ 如何验证（命令/操作步骤）
• ⚠️ 风险与回滚（如适用）

8. 常见需求处理清单（提示用）

• 快捷键（如 Ctrl+S）→ 先定位 Action/KeyStroke/InputMap/ActionMap 的现有实现方式再扩展。
• 默认窗口/布局/焦点 → 先找 MainFrame 初始化、窗口 state、SplitPane 默认比例与持久化逻辑。
• 文案改名（如“新建笔记”）→ 只改目标按钮，不动其它文案。
• SQL 执行/取消/结果显示 → 优先检查 tools.sqlclient.exec 与 tools.sqlclient.ui.QueryResultPanel 的协作边界。 -剪贴板导入/快速导入 → 先定位对话框初始化、窗口显示事件、剪贴板读取时机、文本填充与解析线程；默认禁止“打开即读取/打开即粘贴/打开即解析”，只有用户显式触发才读取剪贴板。 -工具栏/主界面按钮收敛 → 同一功能只保留一个主入口；菜单可保留次级入口；不得删除底层 Action 与快捷键；避免只隐藏按钮而破坏原有可达性。

9. 使用 references 的方式

• 需要仓库基线信息时，先读取 references/PROJECT_BASELINE.md。
• 若发现基线信息与当前仓库不一致，先以实际代码为准，再最小化更新该文档。
• references 保持高层摘要，不复制源码，不记录与任务无关细节。