diff --git a/.obsidian/workspace.json b/.obsidian/workspace.json index af4f5c6..3baf4d2 100644 --- a/.obsidian/workspace.json +++ b/.obsidian/workspace.json @@ -4,16 +4,17 @@ "type": "split", "children": [ { - "id": "75697364ddca16d6", + "id": "123578434ffd61b7", "type": "tabs", + "dimension": 45.42440318302387, "children": [ { - "id": "9c4db96e021802a5", + "id": "a385dd9a010e6ce8", "type": "leaf", "state": { "type": "markdown", "state": { - "file": "02-领域/Linux/领域知识地图.md", + "file": "03-资源/操作说明-工具技巧-git提交规范.md", "mode": "source", "source": false, "backlinks": true, @@ -28,35 +29,41 @@ } }, "icon": "lucide-file", - "title": "领域知识地图" - } - }, - { - "id": "aa0d2e14ef86f0b2", - "type": "leaf", - "state": { - "type": "markdown", - "state": { - "file": "Untitled.md", - "mode": "source", - "source": false, - "backlinks": true, - "backlinkOpts": { - "collapseAll": false, - "extraContext": false, - "sortOrder": "alphabetical", - "showSearch": false, - "searchQuery": "", - "backlinkCollapsed": false, - "unlinkedCollapsed": true - } - }, - "icon": "lucide-file", - "title": "Untitled" + "title": "操作说明-工具技巧-git提交规范" } } - ], - "currentTab": 1 + ] + }, + { + "id": "78337e43c977de3d", + "type": "tabs", + "dimension": 54.57559681697612, + "children": [ + { + "id": "aede49fe3ccb614b", + "type": "leaf", + "state": { + "type": "markdown", + "state": { + "file": "01-项目/2512-MaixCam竞赛版/模块-程序控制-文档说明.md", + "mode": "source", + "source": false, + "backlinks": true, + "backlinkOpts": { + "collapseAll": false, + "extraContext": false, + "sortOrder": "alphabetical", + "showSearch": false, + "searchQuery": "", + "backlinkCollapsed": false, + "unlinkedCollapsed": true + } + }, + "icon": "lucide-file", + "title": "模块-程序控制-文档说明" + } + } + ] } ], "direction": "vertical" @@ -88,7 +95,7 @@ "state": { "type": "search", "state": { - "query": "", + "query": "git提", "matchingCase": true, "explainSearch": false, "collapseAll": false, @@ -113,7 +120,8 @@ } ], "direction": "horizontal", - "width": 367.5 + "width": 367.5, + "collapsed": true }, "right": { "id": "bcd5a1ddf3bf1e55", @@ -235,44 +243,44 @@ "zk-prefixer:创建时间戳笔记": false } }, - "active": "aa0d2e14ef86f0b2", + "active": "a385dd9a010e6ce8", "lastOpenFiles": [ - "20260204-备忘-觉察知识-话题闭环模型.md", - "Untitled.md", - "20260204-备忘-工具技巧-git提交前缀.md", - "20260131-备忘-觉察知识-JF.md", - "20260202-备忘-待问题解答-GTD任务管理.md", - "模板文件/模板-备忘.md", - "03-资源/操作说明-MaixCam竞赛版-参数调试增加参数.md", - "03-资源/信息科技-气象数据模型-对照组实验.md", - "03-资源/执行脚本-工具技巧-USTONE清理红外指令.md", - "03-资源/内容清单-觉察兴趣-待看视频.md", - "03-资源/操作说明-工具技巧-Windows命令行zip.md", - "03-资源/操作说明-工具技巧-edge兼容性.md", - "03-资源/操作说明-工具技巧-图像转C数组.md", - "20260127-备忘-工具-CNB云构建语法.md", - "1链接索引-觉察知识-复盘地图.md", - "05-原子化笔记本/Linux-set处理未定义和错误.md", - "02-领域/Linux/领域知识地图.md", - "20260204-备忘-觉察知识-对话戈夫曼拟剧理论.md", - "20260204-备忘-觉察知识-对话回应价值理论.md", - "01-项目/2512-MaixCam竞赛版/模块-参数调试-文档说明.md", - "01-项目/2512-MaixCam竞赛版/模块-超能小球-文档说明.md", + "20260228-备忘-健康运动-LOVEFITT器械进阶.md", "01-项目/2512-MaixCam竞赛版/模块-程序控制-文档说明.md", - "02-领域/MaixCam/Bug-二阶段识别不明确.md", - "01-项目/2601-信息科技/需求-信息科技-气象数据模型.md.baiduyun.uploading.cfg", - "01-项目/2512-MaixCam竞赛版/项目-需求.md.baiduyun.uploading.cfg", - "01-项目/2512-MaixCam竞赛版/项目-总结.md.baiduyun.uploading.cfg", - "01-项目/2512-MaixCam竞赛版/项目-修复.md.baiduyun.uploading.cfg", - "01-项目/2512-MaixCam竞赛版/需求-菜单状态保存.md.baiduyun.uploading.cfg", - "01-项目/2512-MaixCam竞赛版/需求-菜单切换控件位置颠倒.md.baiduyun.uploading.cfg", - "01-项目/2512-MaixCam竞赛版/需求-色块合并.md.baiduyun.uploading.cfg", - "01-项目/2512-MaixCam竞赛版/需求-第三阶段识别.md.baiduyun.uploading.cfg", - "01-项目/2512-MaixCam竞赛版/需求-第一阶段发送时长.md.baiduyun.uploading.cfg", - "01-项目/2512-MaixCam竞赛版/需求-第一阶段保护机制.md.baiduyun.uploading.cfg", - "01-项目/2601-信息科技/需求-信息科技-气象数据模型.md", - "01-项目/2512-MaixCam竞赛版/项目-需求.md", - "01-项目/2512-MaixCam竞赛版/项目-总结.md", + "01-项目/2512-MaixCam竞赛版/项目-修复.md", + "20260228-备忘-MaixCam竞赛版-稳定版本发布.md", + "20260228-备忘-健身运动-核心发力细节.md", + "20260228-备忘-健身运动-肩和手臂发力细节.md", + "20260228-备忘-健身运动-提问发力细节.md", + "20260228-备忘-健身运动-腿部发力细节.md", + "20260228-备忘-健身运动-练背发力细节.md", + "20260228-备忘-健身运动-练胸发力细节.md", + "Untitled 5.md", + "Untitled 3.md", + "Untitled 1.md", + "Untitled.md", + "未命名.base", + "01-项目/2602-健康运动/20260228-健康运动-训练日志.md", + "01-项目/2602-健康运动", + "del.md", + "05-原子化笔记本/觉察知识-标签配置.md", + "02-领域/觉察知识/领域知识地图.md", + "00-临时碎片/20260112-备忘-MaixCam-需求简报.md", + "00-临时碎片/20260204-备忘-工具技巧-复杂程序修改步骤.md", + "03-资源/操作说明-工具技巧-git提交规范.md", + "Untitled 2.md", + "20260204-备忘-觉察知识-对话戈夫曼拟剧理论.md", + "20260131-备忘-觉察知识-JF.md", + "20260213-备忘-信息科技公开课-部署流程.md", + "20260127-备忘-工具-CNB云构建语法.md", + "未命名 1.base", + "02-领域/TDesign", + "01-项目/2602-连续量与开关量", + "01-项目/2602-白马湖实验室", + "02-领域/物联实验室", + "02-领域/MaixCam 1/领域知识地图.md.baiduyun.uploading.cfg", + "02-领域/MaixCam 1/Bug-二阶段识别不明确.md.baiduyun.uploading.cfg", + "02-领域/纳茵特", "attachments/Pasted image 20260205101833.png", "attachments/Pasted image 20260205080716.png", "attachments/Pasted image 20260205094824.png", diff --git a/00-临时碎片/20260204-备忘-工具技巧-复杂程序修改步骤.md b/00-临时碎片/20260204-备忘-工具技巧-复杂程序修改步骤.md index 0267372..dbc9435 100644 --- a/00-临时碎片/20260204-备忘-工具技巧-复杂程序修改步骤.md +++ b/00-临时碎片/20260204-备忘-工具技巧-复杂程序修改步骤.md @@ -1,5 +1,6 @@ --- +#领域/工具技巧 #复盘/0 #临时/备忘 #状态/待处理 diff --git a/02-领域/MaixCam/Bug-二阶段识别不明确.md b/01-项目/2512-MaixCam竞赛版/Bug-二阶段识别不明确.md similarity index 100% rename from 02-领域/MaixCam/Bug-二阶段识别不明确.md rename to 01-项目/2512-MaixCam竞赛版/Bug-二阶段识别不明确.md diff --git a/01-项目/2512-MaixCam竞赛版/需求-OCR补丁.md b/01-项目/2512-MaixCam竞赛版/需求-OCR补丁.md index 060f686..bdb11d8 100644 --- a/01-项目/2512-MaixCam竞赛版/需求-OCR补丁.md +++ b/01-项目/2512-MaixCam竞赛版/需求-OCR补丁.md @@ -1,7 +1,7 @@ --- -#复盘/1 #需求/禅道 +#复盘/2 #需求/禅道 ## 一句话描述 diff --git a/01-项目/2512-MaixCam竞赛版/需求-交叉点绑定缩放比例.md b/01-项目/2512-MaixCam竞赛版/需求-交叉点绑定缩放比例.md index 9c1415b..6f29658 100644 --- a/01-项目/2512-MaixCam竞赛版/需求-交叉点绑定缩放比例.md +++ b/01-项目/2512-MaixCam竞赛版/需求-交叉点绑定缩放比例.md @@ -1,7 +1,7 @@ --- -#复盘/1 #需求/禅道 +#复盘/2 #需求/禅道 ## 一句话描述 diff --git a/01-项目/2512-MaixCam竞赛版/需求-优化启动速度.md b/01-项目/2512-MaixCam竞赛版/需求-优化启动速度.md index 1076719..452b4b0 100644 --- a/01-项目/2512-MaixCam竞赛版/需求-优化启动速度.md +++ b/01-项目/2512-MaixCam竞赛版/需求-优化启动速度.md @@ -1,7 +1,7 @@ --- -#复盘/1 #需求/禅道 +#复盘/0 #需求/禅道 ## 一句话描述 @@ -15,7 +15,7 @@ 涉及知识： - [常见问题-十六、MaixCAM 启动非常缓慢](https://wiki.sipeed.com/maixpy/doc/zh/faq.html#MaixCAM-%E5%90%AF%E5%8A%A8%E9%9D%9E%E5%B8%B8%E7%BC%93%E6%85%A2%EF%BC%8C%E7%94%9A%E8%87%B3%E8%B6%85%E8%BF%87%E4%BA%86-1-%E5%88%86%E9%92%9F%EF%BC%8C%E6%88%96%E8%80%85%E5%B1%8F%E5%B9%95%E5%9C%A8%E9%97%AA%E5%8A%A8) -https://wiki.sipeed.com/maixpy/doc/zh/faq.html +- https://wiki.sipeed.com/maixpy/doc/zh/faq.html - https://wiki.sipeed.com/maixpy/doc/zh/faq.html 检查任务队列是否满足“三清”标准： diff --git a/01-项目/2601-信息科技/需求-信息科技-气象数据模型.md b/01-项目/2601-信息科技教材/需求-气象数据模型.md similarity index 100% rename from 01-项目/2601-信息科技/需求-信息科技-气象数据模型.md rename to 01-项目/2601-信息科技教材/需求-气象数据模型.md diff --git a/01-项目/2602-健康运动/20260228-健康运动-训练日志.md b/01-项目/2602-健康运动/20260228-健康运动-训练日志.md new file mode 100644 index 0000000..9e30b26 --- /dev/null +++ b/01-项目/2602-健康运动/20260228-健康运动-训练日志.md @@ -0,0 +1,40 @@ + +--- +#领域/健康-运动 + +#复盘/0 #临时/备忘 #状态/待处理 + +## 一句话描述 + +[__训练日志______] + +--- + +时间: 2026/02/28 + +- 5:30 醒来 +- 5:45 出发 +- 6:45 返回 +- 7:30 出发 + +走路约 15 分钟 + +训练情况 + +- 6 kg 哑铃热身 4x12 +- 高位下拉 4x12 +- 推胸 4x12 +- 夹胸 4x12 + + + + + + + + + + + + + diff --git a/01-项目/2602-白马湖实验室/Bug-人流量统计会出现负值.md b/01-项目/2602-白马湖实验室/Bug-人流量统计会出现负值.md new file mode 100644 index 0000000..6e5d124 --- /dev/null +++ b/01-项目/2602-白马湖实验室/Bug-人流量统计会出现负值.md @@ -0,0 +1,51 @@ + +--- +#领域/物联实验室 + +#复盘/0 #Bug/碎片 #临时/备忘 #状态/待处理 + +## 一句话描述 + +[____白马湖人流量统计会出现当前人数会变成负数____] + +--- + +## 基础元信息 + +影响范围：[___驾驶舱人流量统计____] + +## 缺陷记录 + +### 前置条件 + +[___驾驶舱正常运行_____] + +### 复现步骤 + +1. [___打开驾驶舱界面_____] +2. [___人员从人流量统计摄像头前经过_____] +3. [________] + +### 实际发生结果 + +[__人数会出现 -1______] + +### 期望结果 + +[___当<0时，应该直接为 0_____] + +### 排查建议 + +1. [___dataease 数据集有没有安全保护______] + +### 根因分析 + +[__今日人流量字段没有做负值保护______] + +### 验证依据 + +[________] + +# 知识沉淀 + +`Alt + N` 创建 [[模板-觉察知识-知识沉淀]] diff --git a/01-项目/2602-白马湖实验室/操作说明-基础环境.md b/01-项目/2602-白马湖实验室/操作说明-基础环境.md new file mode 100644 index 0000000..6b571e1 --- /dev/null +++ b/01-项目/2602-白马湖实验室/操作说明-基础环境.md @@ -0,0 +1,17 @@ + +--- +#领域/物联实验室 + +#复盘/0 #临时/备忘 #状态/待处理 + +20260206-备忘-主题名-文件内容 + +## 一句话描述 + +[__需要检查的基础环境配置______] + +--- + +## Dataease相关 + +- [[物联实验室-dataease数据集配置]] \ No newline at end of file diff --git a/01-项目/2602-连续量与开关量/20260210-备忘-信息科技-公开课页面图片转描述.md b/01-项目/2602-连续量与开关量/20260210-备忘-信息科技-公开课页面图片转描述.md new file mode 100644 index 0000000..3505188 --- /dev/null +++ b/01-项目/2602-连续量与开关量/20260210-备忘-信息科技-公开课页面图片转描述.md @@ -0,0 +1,87 @@ + +--- +#领域/未知 + +#复盘/0 #临时/备忘 #状态/待处理 + +## 一句话描述 + +[___以网页需求来描述页面内容_____] + +注意：请忽略以上内容 + +--- + +## 操作需求 + +问题描述是【输入内容】，请专业耐心的解答我的问题，并将你的答案整理归纳至【输出内容】 + +## 内容要求 + +1. 结论先行，主次分明：先给出「一句话核心结论」，再分点给出细节 +2. 可信权威：在表述知识点时，标注其使用到的权威理论、来源 +3. 逐层递进逻辑链：原理->知识点->用法->案例，理解本质再应用 +4. 实操为王，案例全覆盖：所有知识点必须配备「可实现的案例」 +5. 避坑指南，强制标配：必须单独列出易踩坑点+精准解决方案 +6. 融会贯通：讲解单个知识点时，必须主动关联同类/互补工具，明确差异、标准、场景，帮助建立知识体系 +7. 浓缩总结，提炼精华，方便记忆：提炼所有重点为极简内容，方便复习和快速查阅 +8. 语言风格：口语化、专业但不晦涩，复杂概念用「大白话 + 示例」解释，拒绝堆砌专业术语；所有命令 / 代码 / 参数格式工整，带中文注释，一目了然。 +9. 内容结构：层级清晰，用标题 / 分点做区分，核心内容加粗标注，代码块独立展示，重点规则用「✅ 黄金规则」「⚠️ 避坑点」「💡 核心技巧」做醒目标注，阅读体验极佳。 +10. 无冗余内容：不拓展无关知识点、不做无意义的参数罗列、不写复杂冷门用法，所有内容都围绕「吃透核心 + 落地实战」，精准匹配学习需求，不浪费时间。 +11. 知识联动要求：当讲解后续内容时，必须主动关联之前讲解过的内容，形成知识闭环。 +12. 联动案例：必须是高频使用场景 + +## 输出格式 + +- [x] markdown + +```markdown +## 一句话描述 + +【使用一句话概括】 + +## 详细解释 + +【你的解答】 + +## 延伸补充 + +... +### 常见避坑点 + +### 知识点浓缩 + +【背诵级，解决反复查资料的核心需求】 + +### 进阶优化方向 + +## 提问建议 +... + +--- +``` + +## 注意 +1. 请判断勾选框是否处于被勾选状态，例如markdown勾选框处于未被勾选状态，则无需输出markdown格式 + +以上内容为系统提示，为了辅助你更好的回答。 + +--- + +## 输入内容 + +| 项目 | 内容 | +| ------ | ------------------------------------------------ | +| 你的角色设定 | 你是一位结构化、体系化的[_中小学教学、网页开发_______]教学专家，定位为精准知识的输出者 | +| 上下文 | 中小学课堂 | +| 约束 | 此页面会作为学生端使用，要考虑到学生的使用 | +| 任务目标 | 整理出网页需求，贴合公开课课堂教学 | +| 解决问题 | 在公开课中，纸质学习单使用起来没有网页端灵活 | +| 服务于 | 公开课的课堂教学 | +| | | + +--- + +注意：请忽略以下内容 + +## 输出内容 diff --git a/01-项目/2602-连续量与开关量/未命名.md b/01-项目/2602-连续量与开关量/未命名.md new file mode 100644 index 0000000..628e5f3 --- /dev/null +++ b/01-项目/2602-连续量与开关量/未命名.md @@ -0,0 +1,27 @@ + +--- +#领域/未知 + +#复盘/0 #临时/备忘 #状态/待处理 + +20260207-备忘-主题名-文件内容 + +## 一句话描述 + +[________] + +--- + +## 参考链接 + +[为你的课堂教学设计一个实时数据统计大屏](https://mp.weixin.qq.com/s/KQzyEy7q5-Z-OO43LOgXwA) + +[手写数字识别-王芳](http://39.101.73.135:8233) + + +这个平台搭建是不难的，需要先准备一下环境，我是使用spyder+flask+deepseek + + + +前端框架采用 https://tdesign.tencent.com/starter/vue-next/dashboard/base + diff --git a/02-领域/DataView/领域知识地图.md b/02-领域/DataView/领域知识地图.md index 932c08d..0e41ffd 100644 --- a/02-领域/DataView/领域知识地图.md +++ b/02-领域/DataView/领域知识地图.md @@ -1,12 +1,16 @@ #领域/DataView -#复盘/3 +#复盘/0 ## 基础内容 - [[DataView-语法知识点]] +## 模板相关 + +- [[模板-豆包-DataView语法]] +- [[模板-豆包-DataView归档]] ### 未链接内容 diff --git a/02-领域/MaixCam/领域知识地图.md b/02-领域/MaixCam/领域知识地图.md index 996f532..a0d9cc1 100644 --- a/02-领域/MaixCam/领域知识地图.md +++ b/02-领域/MaixCam/领域知识地图.md @@ -1,6 +1,6 @@ #领域/MaixCam -#复盘/2 +#复盘/3 ## UI 界面相关 diff --git a/02-领域/Python/领域知识地图.md b/02-领域/Python/领域知识地图.md index 4716c5f..e650949 100644 --- a/02-领域/Python/领域知识地图.md +++ b/02-领域/Python/领域知识地图.md @@ -1,6 +1,6 @@ #领域/Python -#复盘/3 +#复盘/5 ## 语法相关 diff --git a/02-领域/TDesign/领域知识地图.md b/02-领域/TDesign/领域知识地图.md new file mode 100644 index 0000000..0e333ab --- /dev/null +++ b/02-领域/TDesign/领域知识地图.md @@ -0,0 +1,21 @@ +#领域/TDesign + +#复盘/0 + +## 语法相关 + +- [[Python-排序]] +- [[Python-线程锁]] + + +### 未链接内容 + +```dataview +list without ID file.link +from #领域/TDesign +where !contains(this.file.outlinks, file.link) +and file.link != this.file.link +and file.name != "觉察知识-标签配置" +and file.mtime < date(now) - dur("1h") +``` + diff --git a/02-领域/信息科技/领域知识地图.md b/02-领域/信息科技/领域知识地图.md index 1a53883..69bd986 100644 --- a/02-领域/信息科技/领域知识地图.md +++ b/02-领域/信息科技/领域知识地图.md @@ -5,7 +5,7 @@ ## 资源 - [[信息科技-气象预测模型]] -- [[需求-信息科技-气象数据模型]] +- [[需求-气象数据模型]] ### 未链接内容 diff --git a/02-领域/物联实验室/领域知识地图.md b/02-领域/物联实验室/领域知识地图.md new file mode 100644 index 0000000..bcb10a6 --- /dev/null +++ b/02-领域/物联实验室/领域知识地图.md @@ -0,0 +1,21 @@ +#领域/信息科技 + +#复盘/3 + +## 基础配置 + +- [[物联实验室-dataease数据集配置]] +- + + +### 未链接内容 + +```dataview +list without ID file.link +from #领域/物联实验室 +where !contains(this.file.outlinks, file.link) +and file.link != this.file.link +and file.name != "觉察知识-标签配置" +and file.mtime < date(now) - dur("1s") +``` + diff --git a/03-资源/信息科技-气象数据模型-对照组实验.md b/03-资源/信息科技-气象数据模型-对照组实验.md index 27a49e6..5a3e040 100644 --- a/03-资源/信息科技-气象数据模型-对照组实验.md +++ b/03-资源/信息科技-气象数据模型-对照组实验.md @@ -1,7 +1,7 @@ --- -#复盘/2 +#复盘/4 ## 一句话描述 diff --git a/03-资源/内容清单-觉察兴趣-待看视频.md b/03-资源/内容清单-觉察兴趣-待看视频.md index ff2e7f6..70adc3f 100644 --- a/03-资源/内容清单-觉察兴趣-待看视频.md +++ b/03-资源/内容清单-觉察兴趣-待看视频.md @@ -22,6 +22,7 @@ - 潜伏 - 晚酌的流派 - 流金岁月 +- 人间正道是沧桑 - ~~新闻女王~~ - ~~重启人生~~ diff --git a/03-资源/执行脚本-工具技巧-USTONE清理红外指令.md b/03-资源/执行脚本-工具技巧-USTONE清理红外指令.md index db24435..559d25c 100644 --- a/03-资源/执行脚本-工具技巧-USTONE清理红外指令.md +++ b/03-资源/执行脚本-工具技巧-USTONE清理红外指令.md @@ -2,7 +2,7 @@ --- #领域/工具技巧 -#复盘/3 +#复盘/5 ## 一句话描述 diff --git a/03-资源/操作说明-工具技巧-Windows命令行zip.md b/03-资源/操作说明-工具技巧-Windows命令行zip.md index 3b7227e..a4b1266 100644 --- a/03-资源/操作说明-工具技巧-Windows命令行zip.md +++ b/03-资源/操作说明-工具技巧-Windows命令行zip.md @@ -2,7 +2,7 @@ --- #领域/工具技巧 #资源/操作说明 -#复盘/2 +#复盘/4 ## 一句话描述 diff --git a/03-资源/操作说明-工具技巧-edge兼容性.md b/03-资源/操作说明-工具技巧-edge兼容性.md index 89a3d71..bb0624f 100644 --- a/03-资源/操作说明-工具技巧-edge兼容性.md +++ b/03-资源/操作说明-工具技巧-edge兼容性.md @@ -2,7 +2,7 @@ --- #领域/工具技巧 #资源/操作说明 -#复盘/3 +#复盘/5 ## 一句话描述 diff --git a/03-资源/操作说明-工具技巧-git单文件回滚.md b/03-资源/操作说明-工具技巧-git单文件回滚.md new file mode 100644 index 0000000..8d51193 --- /dev/null +++ b/03-资源/操作说明-工具技巧-git单文件回滚.md @@ -0,0 +1,31 @@ + +--- +#领域/工具技巧 + +#复盘/0 + +## 一句话描述 + +[___对单文件进行回滚操作_____] + +--- + +```bash +# 查看单一文件的提交记录 +git log --oneline test.py +``` + +## git resore 方法 Git 2.23+ + +```bash +git restore --source=HEAD~1 test.py +git restore --source=f4g5h6j test.py +git restore --source=f4g5h6jabcdef1234 test.py # 完整ID也可 +``` + +## git checkout 旧版 Git 兼容 + +```bash +git checkout HEAD^1 -- test.py +git checkout f4g5h6j -- test.py +``` diff --git a/03-资源/操作说明-工具技巧-git提交规范.md b/03-资源/操作说明-工具技巧-git提交规范.md new file mode 100644 index 0000000..bc7777c --- /dev/null +++ b/03-资源/操作说明-工具技巧-git提交规范.md @@ -0,0 +1,168 @@ + +--- +#领域/工具技巧 + +#复盘/0 #临时/备忘 #状态/待处理 + +## 一句话描述 + +[__git提交规范______] + +--- + +## 核心规范 + +>空想不如行动，积累胜于苛求。 +>实践 > 沉淀 > 完美主义 + +实践不是盲目行动，而是带着“小目标、可验证“的方向试错，实践后必须沉淀（比如记录问题、总结规律），否则就是低水平重复。 + +实践大于沉淀，沉淀大于完美；完美是沉淀的终局方向，沉淀是实践的复盘产物；分域施策，避坑落地，始于行动，终于迭代。 + +--- + +## 三省沉淀法 + +- 达成了[__置顶了git的提交的消息规范______]目标 +- 遇到了[__旧版本不兼容______]问题 +- 下次改进[__不修改旧版本，仅忽略______] + +## 个人理解 + +[___结构化编写提交消息，方便人工阅读和脚本自动化_____] + +## 实践计划 + +#状态/待实践 + +1. [_使用工具落地规范成果_______] + - **commitlint**：校验提交信息是否符合约定式提交规范，避免违规提交 + - **husky**：Git 钩子工具，配合 commitlint 在提交前自动校验 + - **语义化版本（SemVer）**：约定式提交是 SemVer 的 “落地载体”，type 直接对应版本升级规则（feat→MINOR、fix→PATCH、BREAKING CHANGE→MAJOR） + - **standard-version**：基于约定式提交自动生成 CHANGELOG、升级版本、打 Tag +2. [________] +3. [________] + +--- + +## 核心定义 + +git 需遵循**Conventional Commits（约定式提交）** 规范 + +feat 和 fix 是核心提交类型，语义化版本 +feat 对应小版本升级, fix 对应补丁版本升级 + +## 提交格式 + +类型：必须是规定的几大类中 +作用域：必须现在式动词开头 add/modify/fix，重点在于现在做了什么 +详细描述：解释为什么改、改了什么 +脚注： +1. 破坏性变更：必须写 `BREAKING CHANGE:` 变更描述 +2. 关联Issue: 必须用 Closes/Fixes/Resolves + `#数字`，如 Close `#123` +3. 回滚提交: 必须注明: Reverts `` + +```plaintext +<类型>[可选作用域]: <简短描述> + +[可选的详细描述] + +[可选的关闭Issue链接] +``` + +``` +# 新功能（带作用域） +feat(shop): 新增商品收藏功能 + +# 修复Bug（带详细描述） +fix(cart): 修复购物车数量为0时仍显示小红点 + +用户删除所有商品后，购物车小红点未清空，原因是判断条件遗漏了数量为0的场景，现已补充。 + +# 文档变更 +docs: 更新API文档中用户信息接口的参数说明 + +# 重构 +refactor: 提取表单验证的公共方法到utils目录 +``` + +## 常见前缀 + +| 前缀 | 全称 / 含义 | 适用场景举例 | +| ---------- | ----------------- | ------------------------------------ | +| `feat` | Feature（新功能） | 新增用户注册功能、添加商品筛选接口 | +| `fix` | Fix（修复 Bug） | 修复登录密码错误提示不显示、修复数据统计偏差 | +| `docs` | Documentation（文档） | 更新 README、补充接口注释、修改使用说明 | +| `style` | Style（格式） | 调整代码缩进、补充分号、修改空格（不影响逻辑） | +| `refactor` | Refactor（重构） | 提取公共函数、优化代码结构（无功能 / 修复变更） | +| `perf` | Performance（性能） | 优化列表渲染速度、减少接口请求耗时 | +| `test` | Test（测试） | 添加单元测试、补充集成测试、修复测试用例 | +| `build` | Build（构建） | 升级 webpack 版本、修改打包配置、调整依赖版本 | +| `ci` | CI/CD（持续集成） | 修改 GitHub Actions 配置、调整 Jenkins 流水线 | +| `chore` | Chore（杂项） | 删除无用文件、清理日志、修改.gitignore | +| `revert` | Revert（回滚） | 回滚之前的错误提交（格式：`revert: feat: 新增xx功能`） | + +### 示例 + +#### ✅ 示例：新功能提交 + +```bash +feat(pay): add wechat pay signature verification +Implement wechat pay V3 signature check to prevent fake payment requests +Closes #45 +``` + +#### ✅ 示例：Bug 修复提交 + +```bash +fix(cart): fix empty cart quantity display error +Quantity showed 1 instead of 0 when cart is empty, fix the boundary condition check +Fixes #67 +``` + +#### ✅ 示例：性能优化（Angular 特有） + +```bash +perf(list): optimize large list rendering speed +Reduce rendering time by 60% for lists with more than 200 items +Closes #89 +``` + +#### ✅ 示例：CI 配置修改（Angular 特有） + +```bash +ci: update woodpecker ci test step +Add node_modules cache to reduce CI execution time from 5min to 1min +``` + +#### ✅ 示例：回滚提交（Angular 特有） + +```bash +revert: feat(pay): add wechat pay signature verification +This reverts commit abc1234567890. +Reverts #45 +``` + +#### ✅ 示例：破坏性变更提交 + +```bash +feat(auth): refactor token validation logic +Unify token validation to use JWT only, remove old token format support BREAKING CHANGE: Old token format is no longer supported, clients need to upgrade to JWT +Closes #99 +``` + +#### ✅ 示例：`BREAKING CHANGE:`脚注 + +涉及接口删除、参数移除等 breaking 变更，必须加`BREAKING CHANGE:`脚注，避免线上风险 +``` +BREAKING CHANGE: 移除旧版token校验方式，统一使用JWT +``` + +### 避坑点 + +⚠️ 避坑点1： + 解决方案：✅ + +⚠️ 避坑点1： + 核心问题： + 解决方案：✅ \ No newline at end of file diff --git a/05-原子化笔记本/Linux-find-文件目录查找.md b/05-原子化笔记本/Linux-find-文件目录查找.md index 01baa3a..316218d 100644 --- a/05-原子化笔记本/Linux-find-文件目录查找.md +++ b/05-原子化笔记本/Linux-find-文件目录查找.md @@ -2,7 +2,7 @@ --- #领域/Linux -#复盘/2 +#复盘/4 ## 一句话描述 diff --git a/05-原子化笔记本/Linux-xargs-标准输入转命令参数.md b/05-原子化笔记本/Linux-xargs-标准输入转命令参数.md index aa8d981..311b23c 100644 --- a/05-原子化笔记本/Linux-xargs-标准输入转命令参数.md +++ b/05-原子化笔记本/Linux-xargs-标准输入转命令参数.md @@ -2,7 +2,7 @@ --- #领域/Linux -#复盘/2 +#复盘/4 ## 一句话描述 diff --git a/05-原子化笔记本/MaixCam-RGB转LAB.md b/05-原子化笔记本/MaixCam-RGB转LAB.md index b7f430c..037bd80 100644 --- a/05-原子化笔记本/MaixCam-RGB转LAB.md +++ b/05-原子化笔记本/MaixCam-RGB转LAB.md @@ -1,6 +1,6 @@ #领域/MaixCam -#复盘/3 +#复盘/5 ## 核心定义 diff --git a/05-原子化笔记本/MaixCam-find_blobs说明.md b/05-原子化笔记本/MaixCam-find_blobs说明.md index 7d8e494..352600f 100644 --- a/05-原子化笔记本/MaixCam-find_blobs说明.md +++ b/05-原子化笔记本/MaixCam-find_blobs说明.md @@ -1,6 +1,6 @@ #领域/MaixCam -#复盘/4 +#复盘/5 ## 一句话描述 diff --git a/05-原子化笔记本/MaixCam-自定义开机启动画面.md b/05-原子化笔记本/MaixCam-自定义开机启动画面.md index d4f1799..75dc76d 100644 --- a/05-原子化笔记本/MaixCam-自定义开机启动画面.md +++ b/05-原子化笔记本/MaixCam-自定义开机启动画面.md @@ -2,7 +2,7 @@ --- #领域/MaixCam -#复盘/3 +#复盘/5 ## 一句话描述 diff --git a/05-原子化笔记本/MaixCam-触摸屏分辨率.md b/05-原子化笔记本/MaixCam-触摸屏分辨率.md index bac9b62..7143526 100644 --- a/05-原子化笔记本/MaixCam-触摸屏分辨率.md +++ b/05-原子化笔记本/MaixCam-触摸屏分辨率.md @@ -2,7 +2,7 @@ --- #领域/MaixCam -#复盘/3 +#复盘/5 ## 一句话描述 diff --git a/05-原子化笔记本/Python-排序.md b/05-原子化笔记本/Python-排序.md index 9d2a068..b3c1901 100644 --- a/05-原子化笔记本/Python-排序.md +++ b/05-原子化笔记本/Python-排序.md @@ -2,7 +2,7 @@ --- #领域/Python -#复盘/3 +#复盘/5 ## 一句话描述 diff --git a/05-原子化笔记本/信息科技-气象预测模型.md b/05-原子化笔记本/信息科技-气象预测模型.md index c7f170b..137b891 100644 --- a/05-原子化笔记本/信息科技-气象预测模型.md +++ b/05-原子化笔记本/信息科技-气象预测模型.md @@ -2,7 +2,7 @@ --- #领域/信息科技 -#复盘/3 +#复盘/5 ## 一句话描述 diff --git a/05-原子化笔记本/物联实验室-dataease数据集配置.md b/05-原子化笔记本/物联实验室-dataease数据集配置.md new file mode 100644 index 0000000..31ed3c0 --- /dev/null +++ b/05-原子化笔记本/物联实验室-dataease数据集配置.md @@ -0,0 +1,84 @@ + +--- +#领域/物联实验室 + +#复盘/0 #临时/备忘 #状态/待处理 + +## 一句话描述 + +[___Dataease 配置数据集_____] + +--- + +本周 +```mysql +select sum(InNum) as InNum, sum(OutNum) as OutNum from (SELECT + DATE_FORMAT( DataDateTime, '%m%d' ) AS MonthDay, + max( InNum ) AS InNum, + max( OutNum ) AS OutNum +FROM + people +WHERE + 1 and DataDateTime >= DATE_SUB(CURDATE(),INTERVAL 7 DAY) +GROUP BY + MonthDay +ORDER BY +MonthDay DESC) as _week_people; +``` + +今日 +```mysql +SELECT + DATE_FORMAT( DataDateTime, '%m%d' ) AS MonthDay, + max( InNum ) AS InNum, + max( OutNum ) AS OutNum +FROM + people +WHERE + 1 and DataDateTime >= DATE_SUB(CURDATE(),INTERVAL 1 DAY) +GROUP BY + MonthDay +ORDER BY +MonthDay DESC limit 1; +``` + +环境平均 +```mysql +SELECT + DATE_FORMAT(Time, '%m/%d') AS month_day, + AVG(Temperature) AS Temperature, + AVG(Humidity) AS Humidity, + AVG(TVOC) AS TVOC, + AVG(eCO2) AS eCO2, + AVG(PM10) AS PM10, + AVG(PM2_5) AS PM2_5 +FROM + env +GROUP BY + month_day +ORDER BY + month_day desc limit 30; +``` + +环境 +```mysql +select * from env order by id desc limit 1; +``` + +行为数据 +```mysql +SELECT * from ( + +select * from (SELECT + DataDateTime, + "人流经过" AS 行为 +FROM + people +WHERE + type = '1' order by DataDateTime desc) as t1 + + UNION ALL + + select * from (SELECT `datetime`, `msg` from log where `msg`!='物联控制' and `msg`!="") as t2 +) as t1_2 ORDER BY DataDateTime desc limit 20; +``` diff --git a/05-原子化笔记本/觉察知识-目录配置.md b/05-原子化笔记本/觉察知识-目录配置.md index 57af966..9d81401 100644 --- a/05-原子化笔记本/觉察知识-目录配置.md +++ b/05-原子化笔记本/觉察知识-目录配置.md @@ -2,7 +2,7 @@ --- #领域/觉察知识 -#复盘/3 +#复盘/5 ## 一句话描述 diff --git a/05-原子化笔记本/觉察知识-知识蒸馏.md b/05-原子化笔记本/觉察知识-知识蒸馏.md index 8ad9a6c..9ceb020 100644 --- a/05-原子化笔记本/觉察知识-知识蒸馏.md +++ b/05-原子化笔记本/觉察知识-知识蒸馏.md @@ -1,6 +1,6 @@ #领域/觉察知识 -#复盘/4 +#复盘/5 ## 一句话描述 diff --git a/1链接索引-觉察知识-复盘地图.md b/1链接索引-觉察知识-复盘地图.md index e12276f..96470f3 100644 --- a/1链接索引-觉察知识-复盘地图.md +++ b/1链接索引-觉察知识-复盘地图.md @@ -90,6 +90,7 @@ TABLE WITHOUT ID file.mtime AS "最后修改时间" FROM #复盘/2 where file.mtime < date(now) - dur("3d") +and file.name != "觉察知识-标签配置" SORT file.mtime DESC limit 3 ``` @@ -108,6 +109,7 @@ TABLE WITHOUT ID file.mtime AS "最后修改时间" FROM #复盘/3 where file.mtime < date(now) - dur("4d") +and file.name != "觉察知识-标签配置" SORT file.mtime DESC limit 3 ``` @@ -126,6 +128,7 @@ TABLE WITHOUT ID file.mtime AS "最后修改时间" FROM #复盘/4 where file.mtime < date(now) - dur("5d") +and file.name != "觉察知识-标签配置" SORT file.mtime DESC limit 3 ``` @@ -145,6 +148,7 @@ TABLE WITHOUT ID file.mtime AS "最后修改时间" FROM #复盘/4 where file.mtime < date(now) - dur("d") +and file.name != "觉察知识-标签配置" SORT file.mtime DESC limit 3 ``` diff --git a/20260202-备忘-待问题解答-GTD任务管理.md b/20260202-备忘-待问题解答-GTD任务管理.md index 6371f03..a8123ef 100644 --- a/20260202-备忘-待问题解答-GTD任务管理.md +++ b/20260202-备忘-待问题解答-GTD任务管理.md @@ -10,4 +10,93 @@ --- 来源：番茄工作法的进阶优化 -原文：**结合GTD**：用番茄工作法负责「执行节奏」，GTD负责「任务收集与分类」，互补解决多任务管理问题。 \ No newline at end of file +原文：**结合GTD**：用番茄工作法负责「执行节奏」，GTD负责「任务收集与分类」，互补解决多任务管理问题。 + + +--- +#领域/未知 + +#复盘/0 #临时/备忘 #状态/待处理 + +20260202-备忘-主题名-文件内容 +## 一句话描述 + +[____熟悉 GTD____] + +注意：请忽略以上内容 + +--- + +## 操作需求 + +问题描述是【输入内容】，请专业耐心的解答我的问题，并将你的答案整理归纳至【输出内容】 + +## 内容要求 + +1. 结论先行，主次分明：先给出「一句话核心结论」，再分点给出细节 +2. 可信权威：在表述知识点时，标注其使用到的权威理论、来源 +3. 逐层递进逻辑链：原理->知识点->用法->案例，理解本质再应用 +4. 实操为王，案例全覆盖：所有知识点必须配备「可实现的案例」 +5. 避坑指南，强制标配：必须单独列出易踩坑点+精准解决方案 +6. 融会贯通：讲解单个知识点时，必须主动关联同类/互补工具，明确差异、标准、场景，帮助建立知识体系 +7. 浓缩总结，提炼精华，方便记忆：提炼所有重点为极简内容，方便复习和快速查阅 +8. 语言风格：口语化、专业但不晦涩，复杂概念用「大白话 + 示例」解释，拒绝堆砌专业术语；所有命令 / 代码 / 参数格式工整，带中文注释，一目了然。 +9. 内容结构：层级清晰，用标题 / 分点做区分，核心内容加粗标注，代码块独立展示，重点规则用「✅ 黄金规则」「⚠️ 避坑点」「💡 核心技巧」做醒目标注，阅读体验极佳。 +10. 无冗余内容：不拓展无关知识点、不做无意义的参数罗列、不写复杂冷门用法，所有内容都围绕「吃透核心 + 落地实战」，精准匹配学习需求，不浪费时间。 +11. 知识联动要求：当讲解后续内容时，必须主动关联之前讲解过的内容，形成知识闭环。 +12. 联动案例：必须是高频使用场景 + +## 输出格式 + +- [x] markdown + +```markdown +## 一句话描述 + +【使用一句话概括】 + +## 详细解释 + +【你的解答】 + +## 延伸补充 + +... +### 常见避坑点 + +### 知识点浓缩 + +【背诵级，解决反复查资料的核心需求】 + +### 进阶优化方向 + +## 提问建议 +... + +--- +``` + +## 注意 +1. 请判断勾选框是否处于被勾选状态，例如markdown勾选框处于未被勾选状态，则无需输出markdown格式 + +以上内容为系统提示，为了辅助你更好的回答。 + +--- + +## 输入内容 + +| 项目 | 内容 | +| ------ | ------------------------------------------- | +| 你的角色设定 | 你是一位结构化、体系化的[_番茄工作法_______]教学专家，定位为精准知识的输出者 | +| 上下文 | | +| 约束 | | +| 任务目标 | | +| 解决问题 | | +| 服务于 | | +| | | + +--- + +注意：请忽略以下内容 + +## 输出内容 diff --git a/Untitled 6.md b/20260204-备忘-Linux-bash创建模板.md similarity index 97% rename from Untitled 6.md rename to 20260204-备忘-Linux-bash创建模板.md index 45f41bc..e25b625 100644 --- a/Untitled 6.md +++ b/20260204-备忘-Linux-bash创建模板.md @@ -3,8 +3,6 @@ #复盘/0 #临时/备忘 #状态/待处理 -20260204-备忘-主题名-文件内容 - ## 一句话描述 [__bash 脚本规范/模板______] @@ -14,8 +12,7 @@ ```bash #!/bin/bash -set -ueo pipefail - +set -ueo pipefail ``` diff --git a/20260204-备忘-工具技巧-git提交前缀.md b/20260204-备忘-工具技巧-git提交前缀.md deleted file mode 100644 index aa500ef..0000000 --- a/20260204-备忘-工具技巧-git提交前缀.md +++ /dev/null @@ -1,75 +0,0 @@ - ---- - -#复盘/0 #临时/备忘 #状态/待处理 - - -## 一句话描述 - -[___git 提交信息前缀_____] - ---- -你想了解 Git 提交信息中像`feat`这类前缀（也叫提交类型标识）的含义、规范和使用场景，对吧？这些前缀是遵循**Conventional Commits（约定式提交）** 规范的核心，目的是让提交历史清晰可读，还能自动化生成 CHANGELOG、管理语义化版本。 - -### 常用的 Git 提交类型前缀及含义 - -以下是项目中最常用的前缀，每个前缀对应明确的代码变更场景： - -| 前缀 | 全称 / 含义 | 适用场景举例 | -| ---------- | ----------------- | ------------------------------------ | -| `feat` | Feature（新功能） | 新增用户注册功能、添加商品筛选接口 | -| `fix` | Fix（修复 Bug） | 修复登录密码错误提示不显示、修复数据统计偏差 | -| `docs` | Documentation（文档） | 更新 README、补充接口注释、修改使用说明 | -| `style` | Style（格式） | 调整代码缩进、补充分号、修改空格（不影响逻辑） | -| `refactor` | Refactor（重构） | 提取公共函数、优化代码结构（无功能 / 修复变更） | -| `perf` | Performance（性能） | 优化列表渲染速度、减少接口请求耗时 | -| `test` | Test（测试） | 添加单元测试、补充集成测试、修复测试用例 | -| `build` | Build（构建） | 升级 webpack 版本、修改打包配置、调整依赖版本 | -| `ci` | CI/CD（持续集成） | 修改 GitHub Actions 配置、调整 Jenkins 流水线 | -| `chore` | Chore（杂项） | 删除无用文件、清理日志、修改.gitignore | -| `revert` | Revert（回滚） | 回滚之前的错误提交（格式：`revert: feat: 新增xx功能`） | - -### 规范的提交信息格式 - -完整的约定式提交格式通常为： - -plaintext - -``` -<类型>[可选作用域]: <简短描述> - -[可选的详细描述] - -[可选的关闭Issue链接] -``` - -- **作用域**：说明修改的模块 / 范围，让提交更精准，比如`feat(login): 新增记住密码功能`、`fix(order): 修复订单支付状态更新失败`； -- **简短描述**：首字母小写，结尾不加标点，简洁说明变更（不超过 50 字符）。 - -### 示例 - -bash - -运行 - -``` -# 新功能（带作用域） -feat(shop): 新增商品收藏功能 - -# 修复Bug（带详细描述） -fix(cart): 修复购物车数量为0时仍显示小红点 - -用户删除所有商品后，购物车小红点未清空，原因是判断条件遗漏了数量为0的场景，现已补充。 - -# 文档变更 -docs: 更新API文档中用户信息接口的参数说明 - -# 重构 -refactor: 提取表单验证的公共方法到utils目录 -``` - -### 总结 - -1. `feat`和`fix`是最核心的提交类型，直接关联语义化版本（`feat`对应小版本升级，`fix`对应补丁版本升级）； -2. 这些前缀遵循 Conventional Commits 规范，能统一团队提交风格，让提交历史一目了然； -3. 不同前缀对应不同变更场景，按需使用可大幅提升项目维护效率（比如排查 Bug 时只需筛选`fix`类型的提交）。 \ No newline at end of file diff --git a/20260206-备忘-工具技巧-git提交规范.md b/20260206-备忘-工具技巧-git提交规范.md new file mode 100644 index 0000000..1bdadff --- /dev/null +++ b/20260206-备忘-工具技巧-git提交规范.md @@ -0,0 +1,255 @@ + +--- +#领域/未知 + +#复盘/0 #临时/备忘 #状态/待处理 + +## 一句话描述 + +[____git **Conventional Commits（约定式提交）** 规范____] + +注意：请忽略以上内容 + +--- + +## 操作需求 + +问题描述是【输入内容】，请专业耐心的解答我的问题，并将你的答案整理归纳至【输出内容】 + +## 内容要求 + +1. 结论先行，主次分明：先给出「一句话核心结论」，再分点给出细节 +2. 逐层递进逻辑链：原理->知识点->用法->案例，理解本质再应用 +3. 实操为王，案例全覆盖：所有知识点必须配备「可实现的案例」 +4. 避坑指南，强制标配：必须单独列出易踩坑点+精准解决方案 +5. 融会贯通：讲解单个知识点时，必须主动关联同类/互补工具，明确差异、标准、场景，帮助建立知识体系 +6. 浓缩总结，提炼精华，方便记忆：提炼所有重点为极简内容，方便复习和快速查阅 +7. 语言风格：口语化、专业但不晦涩，复杂概念用「大白话 + 示例」解释，拒绝堆砌专业术语；所有命令 / 代码 / 参数格式工整，带中文注释，一目了然。 +8. 内容结构：层级清晰，用标题 / 分点做区分，核心内容加粗标注，代码块独立展示，重点规则用「✅ 黄金规则」「⚠️ 避坑点」「💡 核心技巧」做醒目标注，阅读体验极佳。 +9. 无冗余内容：不拓展无关知识点、不做无意义的参数罗列、不写复杂冷门用法，所有内容都围绕「吃透核心 + 落地实战」，精准匹配学习需求，不浪费时间。 +10. 知识联动要求：当讲解后续内容时，必须主动关联之前讲解过的内容，形成知识闭环。 +11. 联动案例：必须是高频使用场景 +12. + +## 输出格式 + +- [x] markdown + +```markdown +## 一句话描述 + +【使用一句话概括】 + +## 详细解释 + +【你的解答】 + +## 延伸补充 + +... +### 常见避坑点 + +### 知识点浓缩 + +【背诵级，解决反复查资料的核心需求】 + +### 进阶优化方向 + +## 提问建议 +... + +--- +``` + +## 注意 +1. 请判断勾选框是否处于被勾选状态，例如markdown勾选框处于未被勾选状态，则无需输出markdown格式 + +以上内容为系统提示，为了辅助你更好的回答。 + +--- + +## 输入内容 + +| 项目 | 内容 | +| ------ | ---------------------------------------------- | +| 你的角色设定 | 你是一位结构化、体系化的[__软件工程,git______]教学专家，定位为精准知识的输出者 | +| 上下文 | **Conventional Commits（约定式提交）** 规范；git 提交 | +| 约束 | | +| 任务目标 | 熟悉**Conventional Commits（约定式提交）** 规范，并应用到实际场景中 | +| 解决问题 | git 提交时提交混乱随意 | +| 服务于 | 项目更好的推进、管理 | +| | | + +--- + +注意：请忽略以下内容 + +## 输出内容 +## 一句话描述 + +约定式提交是一套标准化 Git 提交信息格式，通过固定结构规范提交日志，解决提交混乱问题，同时支持自动化生成版本、日志与项目管理。 + +## 详细解释 + +### 一、核心原理 + +本质是给 Git 提交信息定 “统一语法”，让提交日志从 “随意文字” 变成 “机器可读 + 人易理解” 的结构化数据，既方便团队协作，也能对接自动化工具（如生成 CHANGELOG、自动发版）。 + +### 二、核心知识点（结构 + 规则） + +提交信息的标准结构（必选 + 可选）： + +```plaintext +(): +// 空行 + +// 空行 +