MigrateRepos/AutoCommit
1
0
Fork 0
mirror of https://github.com/OBKoro1/autoCommit.git synced 2024-11-16 23:49:29 +08:00
Code Issues Projects Releases Wiki Activity
1692082842
AutoCommit/README.md

196 lines
7.6 KiB
Markdown
Raw Normal View History

init
2019-12-26 21:05:27 +08:00
# autoCommit
V1.0.0
2020-01-08 17:13:17 +08:00
> 一个用于Git自动commit的VSCode插件，它可以用来补充之前忘记提交commit，帮助你把首页的绿色格子填满。
init
2019-12-26 17:47:37 +08:00
文档
2020-01-13 10:10:47 +08:00
### 使用效果
1. 使用本插件来控制commit次数.
2. 如下图，你甚至可以规划一下`commit`次数，然后画出图形, 天空才是你的极限。
readme
2020-01-26 17:06:45 +08:00
![commit_img.png](https://upload-images.jianshu.io/upload_images/5245297-2c357937f3122b08?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
文档
2020-01-13 10:10:47 +08:00
V1.0.0
2020-01-08 17:13:17 +08:00
### 功能特性
数据格式重构以及完成测试模式
2020-01-01 17:37:28 +08:00
V1.0.0
2020-01-08 17:13:17 +08:00
1. **选择多个日期范围**：一次操作即可提交不同日期`commit`
2. **控制每个日期的commit次数**: 可以用它来控制绿色格子的颜色，了解[commit次数与颜色](https://github.com/OBKoro1/autoCommit/wiki/%E4%BD%BF%E7%94%A8%E9%A1%BB%E7%9F%A5#commit%E6%AC%A1%E6%95%B0%E4%B8%8E%E9%A2%9C%E8%89%B2)
3. **随机commit次数**：随机commit次数让我们的提交看起来更加逼真。
4. **取消commit**: 用于在`commit`期间取消并回滚到未提交版本
文档
2020-01-13 10:10:47 +08:00
5. 超过100次提交，将强制考虑10秒是否要取消commit。
V1.0.0
2020-01-08 17:13:17 +08:00
6. 插件成功运行后，将自动保存配置参数，无须每次都要一通操作。
7. 提交完善的日志: 清晰的了解插件的运行情况
8. 后台运行，不影响编码、浏览网页等。
9. 运行超快，如下图187次commit，20秒搞定。
10. 还有超多细节优化。
exec异步问题
2020-01-02 14:19:05 +08:00
V1.0.0
2020-01-08 17:13:17 +08:00
文档
2020-01-13 10:10:47 +08:00
### 仓库地址:
[autoCommit](https://github.com/OBKoro1/autoCommit)
文档
2020-01-10 21:03:38 +08:00
#### 自动commit演示：
文档
2020-01-13 10:10:47 +08:00
readme
2020-01-26 17:06:45 +08:00
![autoCommit.gif](https://upload-images.jianshu.io/upload_images/5245297-ba173538d0a037cf?imageMogr2/auto-orient/strip)
文档
2020-01-10 21:03:38 +08:00
V1.0.0
2020-01-08 17:29:39 +08:00
### 安装
在 Vscode 扩展商店中搜索`Auto Commit`,点击安装即可。
V1.0.0
2020-01-08 17:13:17 +08:00
### 插件入口
1. 使用快捷键打开VSCode的命令面板。
* `mac`: `command + p` window: `ctrl + p`
2. 输入`> auto commit`将会看到如下图所示的命令选项，然后用鼠标点击或者回车都可启动插件。
* 实际上可以输入下方选项的任何一段文字，都可以匹配到插件命令选项。
readme
2020-01-26 17:06:45 +08:00
![image](https://upload-images.jianshu.io/upload_images/5245297-832f45c19fdca38e?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
V1.0.0
2020-01-08 17:13:17 +08:00
文档
2020-01-13 10:10:47 +08:00
### 使用须知
V1.0.0
2020-01-08 17:13:17 +08:00
文档
2020-01-13 10:10:47 +08:00
## Git相关
V1.0.0
2020-01-08 17:13:17 +08:00
文档
2020-01-13 10:10:47 +08:00
需要有一个项目让插件提交commit，可以使用公开项目但更推荐创建一个私有项目
V1.0.0
2020-01-08 22:44:15 +08:00
文档
2020-01-13 10:10:47 +08:00
#### 创建私有项目来提交commit
V1.0.0
2020-01-08 22:44:15 +08:00
文档
2020-01-13 10:10:47 +08:00
**私有项目的优势**:
1. 隐藏项目，别人看不到。
PS： 公开的项目，如果后面要删除的话，会将commit也清除掉。
2. 相对应的你的提交记录别人也看不到，只能看到类似下面这句话。
`3 contributions in private repositories`: 提交了三个commit到私有仓库。
3. **要打开私有仓库贡献可见 ，别人才能看到私有仓库的commit** ,否则只能自己看到:
readme
2020-01-26 17:06:45 +08:00
![image](https://upload-images.jianshu.io/upload_images/5245297-4b6984da51d815cd?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
文档
2020-01-13 10:10:47 +08:00
#### 确保能够正常提交
1. clone github项目到本地。
2. 确保能够正常提交。
先进行一次提交确保能够正常提交，防止因为merge/release等问题导致提交失败。
#### **需要提交到`master`分支上**
如果提交到其他分支，提交记录不会显示在绿色的格子里面，合并分支之后 才会显示在绿色格子里面。
#### 提交以前和未来的commit
在19年12月我创建了一个测试账号：[koroTest](https://github.com/koroTest)，经过测试：
1. 成功提交17年的10月份的commit。
2. 现在2020年1月份，成功提交了2020年2月份的commit。
3. 具体能提交最早和最晚的日期没有测试过，有兴趣的可以试试~
#### commit次数与颜色
我用这个工具测试一下了一个不同日期commit1~30次的颜色变化：
一天1-7次commit颜色为`#c6e48b`
一天8-14次commit颜色为`#7bc96f`
一天15-20次commit颜色为`#239a3b`
一天21-63次commit颜色为`#196127`
后面的没有再测试了，应该最深的颜色就是`#196127`。
readme
2020-01-26 17:06:45 +08:00
![commit颜色](https://upload-images.jianshu.io/upload_images/5245297-73427fb0f18ccfa8?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
文档
2020-01-13 10:10:47 +08:00
## 插件运行机制相关
#### 随机commit次数
默认开启，默认为1~10随机，时间范围内默认每个日期随机commit几次，如果单个时间段设置了`commit`次数将使用设置的次数。
PS： 最小值为2，即每个日期随机commi 1/2次。
#### 默认commit次数
关闭随机commit次数，就会使用默认commit次数，如果单个时间段设置了`commit`次数将使用设置的次数。
#### 设置多个时间段、每个时间段可以设置不同的提交次数
如下图：
1. **插件可以添加多次日期范围**。
2. **每个日期范围都能控制具体的commit次数**。
3. 每个日期范围和commit次数通过index来配对。
4. 同一个日期，后面出现的将会覆盖前面的：`commit`次数将会使用后面日期设置。
5. 对应的日期范围，不设置commit次数，那么将会使用随机`commit`次数/默认`commit`次数。
如下图所示的配置(日期覆盖情况)，最后的结果是：
readme
2020-01-26 17:06:45 +08:00
12/01-12/06 使用默认commit次数，每天将会提交一次
12/07-12/08 每天提交三次
12/09-12/19 每天提交四次
文档
2020-01-13 10:10:47 +08:00
readme
2020-01-26 17:06:45 +08:00
![image](https://upload-images.jianshu.io/upload_images/5245297-5d9be61e7da96d62?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
文档
2020-01-13 10:10:47 +08:00
#### commit次数的最大值
所有计数器的最大值设定为30。
#### 默认修改项目根目录的`commit.md`文件
插件将默认重写项目根目录的`commit.md`文件，如果文件不存在将会自动创建。
插件提供了一个配置项让你可以修改commit信息将要存储的文件。
#### commit信息
每次提交需要有一个commit信息，插件默认是`autoCommit`, 你可以在界面修改它。
#### 运行日志
插件运行日志，是倒序展示的，如果提交量比较大，支持在运行期间清空日志。
### 开始commit
当配置好选项之后就可以**点击开始commit**按钮来提交commit。
建议一开始为了避免误操作，先测试一下：commit量不要过大。
PS： 请在一个网络状况良好的地方运行，否则会导致`push`失败。
### 取消commit
1. 该按钮是为了避免用户误操作，用于在插件commit期间终止自动`commit`。
2. 一旦插件日志出现`提交中...`，就不可取消。
3. 如果commit次数超过100，插件将会强制等待10S让你考虑是否需要取消commit。
#### 保存配置和后台运行
1. 插件在运行成功一次之后，会自动保存你的配置参数，在你下次通过命令打开插件的时候，会自动初始配置参数。
2. 插件是可以挂在后台运行，不影响你编码、浏览网页之类的。
V1.0.0
2020-01-08 22:44:15 +08:00
V1.0.1
2020-01-10 17:02:53 +08:00
### 插件声明
文档
2020-01-13 10:10:47 +08:00
[autoCommit](https://github.com/OBKoro1/autoCommit)是本人兴之所至创建的个人项目，仅用于学习交流，禁止任何人商用以及用于非法之途。
V1.0.1
2020-01-10 17:02:53 +08:00
插件如构成侵权，请通过邮件联系我。
文档
2020-01-13 10:10:47 +08:00
### 头部注释插件
本人还开源了另外一个VSCode插件: [koroFileHeader](https://github.com/OBKoro1/koro1FileHeader)，目前该插件已经有1000+ Star了，欢迎安装使用。
1. 它是用于生成文件头部注释，帮助我们养成良好的编码习惯，规范整个团队风格。
2. 插件支持所有主流语言,功能强大，灵活方便，文档齐全，食用简单！
V1.0.0
2020-01-08 17:13:17 +08:00
### License
[MIT](http://opensource.org/licenses/MIT)
### Star一下吧
如果插件觉得还不错的话，就给个 [Star](https://github.com/OBKoro1/autoCommit) ⭐️ 鼓励一下我吧~
文档
2020-01-13 10:10:47 +08:00
[前端进阶积累](http://obkoro1.com/web_accumulate/)、[公众号](https://user-gold-cdn.xitu.io/2018/5/1/1631b6f52f7e7015?w=344&h=344&f=jpeg&s=8317)、[GitHub](https://github.com/OBKoro1)
Reference in New Issue Copy Permalink