@zjex/git-workflow 0.2.24 → 0.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.github/workflows/deploy-docs.yml +68 -0
- package/.github/workflows/test.yml +24 -4
- package/.husky/pre-commit +14 -0
- package/README.md +72 -1066
- package/dist/index.js +103 -13
- package/docs/.vitepress/cache/deps/_metadata.json +52 -0
- package/docs/.vitepress/cache/deps/chunk-2CLQ7TTZ.js +9719 -0
- package/docs/.vitepress/cache/deps/chunk-2CLQ7TTZ.js.map +7 -0
- package/docs/.vitepress/cache/deps/chunk-LE5NDSFD.js +12824 -0
- package/docs/.vitepress/cache/deps/chunk-LE5NDSFD.js.map +7 -0
- package/docs/.vitepress/cache/deps/package.json +3 -0
- package/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js +4505 -0
- package/docs/.vitepress/cache/deps/vitepress___@vue_devtools-api.js.map +7 -0
- package/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js +583 -0
- package/docs/.vitepress/cache/deps/vitepress___@vueuse_core.js.map +7 -0
- package/docs/.vitepress/cache/deps/vitepress___@vueuse_integrations_useFocusTrap.js +1352 -0
- package/docs/.vitepress/cache/deps/vitepress___@vueuse_integrations_useFocusTrap.js.map +7 -0
- package/docs/.vitepress/cache/deps/vitepress___mark__js_src_vanilla__js.js +1665 -0
- package/docs/.vitepress/cache/deps/vitepress___mark__js_src_vanilla__js.js.map +7 -0
- package/docs/.vitepress/cache/deps/vitepress___minisearch.js +1813 -0
- package/docs/.vitepress/cache/deps/vitepress___minisearch.js.map +7 -0
- package/docs/.vitepress/cache/deps/vue.js +347 -0
- package/docs/.vitepress/cache/deps/vue.js.map +7 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/chunk-2CLQ7TTZ.js +9719 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/chunk-2CLQ7TTZ.js.map +7 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/chunk-LE5NDSFD.js +12824 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/chunk-LE5NDSFD.js.map +7 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/package.json +3 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vitepress___@vue_devtools-api.js +4505 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vitepress___@vue_devtools-api.js.map +7 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vitepress___@vueuse_core.js +583 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vitepress___@vueuse_core.js.map +7 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vitepress___@vueuse_integrations_useFocusTrap.js +1352 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vitepress___@vueuse_integrations_useFocusTrap.js.map +7 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vitepress___mark__js_src_vanilla__js.js +1665 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vitepress___mark__js_src_vanilla__js.js.map +7 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vitepress___minisearch.js +1813 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vitepress___minisearch.js.map +7 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vue.js +347 -0
- package/docs/.vitepress/cache/deps_temp_44e2fb0f/vue.js.map +7 -0
- package/docs/.vitepress/config.ts +167 -0
- package/docs/.vitepress/theme/custom.css +39 -0
- package/docs/.vitepress/theme/index.ts +4 -0
- package/docs/README.md +82 -0
- package/docs/commands/branch.md +468 -0
- package/docs/commands/commit.md +554 -0
- package/docs/commands/config.md +346 -0
- package/docs/commands/index.md +312 -0
- package/docs/commands/interactive.md +384 -0
- package/docs/commands/release.md +300 -0
- package/docs/commands/stash.md +309 -0
- package/docs/commands/tag.md +278 -0
- package/docs/commands/update.md +347 -0
- package/docs/config/ai-config.md +160 -0
- package/docs/config/branch-config.md +133 -0
- package/docs/config/commit-config.md +185 -0
- package/docs/config/config-file.md +776 -0
- package/docs/config/examples.md +279 -0
- package/docs/config/index.md +478 -0
- package/docs/guide/ai-commit.md +576 -0
- package/docs/guide/basic-usage.md +522 -0
- package/docs/guide/best-practices.md +426 -0
- package/docs/guide/branch-management.md +712 -0
- package/docs/guide/getting-started.md +294 -0
- package/docs/guide/index.md +168 -0
- package/docs/guide/installation.md +449 -0
- package/docs/guide/release-management.md +744 -0
- package/docs/guide/stash-management.md +608 -0
- package/docs/guide/tag-management.md +614 -0
- package/docs/index.md +205 -0
- package/docs/public/favicon.svg +21 -0
- package/docs/public/hero-logo.svg +43 -0
- package/docs/public/logo.svg +20 -0
- package/package.json +11 -2
- package/scripts/publish.js +55 -8
- package/scripts/publish.sh +20 -2
- package/scripts/release.sh +20 -2
- package/scripts/update-test-count.js +55 -0
- package/src/ai-service.ts +101 -15
- package/src/commands/init.ts +18 -0
- package/src/config.ts +1 -0
- package/tests/ai-service.test.ts +237 -2
- package/tests/help.test.ts +134 -0
- package/tests/init.test.ts +582 -0
- package/tests/release.test.ts +333 -0
- package/tests/setup.ts +21 -0
- package/tests/stash.test.ts +376 -0
- package/tests/update.test.ts +402 -0
- package/vitest.config.ts +3 -0
- package/zjex-logo.svg +22 -0
- package/zjex-optimized.svg +34 -0
- package/zjex.svg +1 -0
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
import { defineConfig } from 'vitepress'
|
|
2
|
+
|
|
3
|
+
export default defineConfig({
|
|
4
|
+
title: 'Git Workflow',
|
|
5
|
+
description: '🚀 极简的 Git 工作流 CLI 工具,让分支管理和版本发布变得轻松愉快',
|
|
6
|
+
|
|
7
|
+
// 基础配置
|
|
8
|
+
base: '/git-workflow/',
|
|
9
|
+
lang: 'zh-CN',
|
|
10
|
+
|
|
11
|
+
// 主题配置
|
|
12
|
+
themeConfig: {
|
|
13
|
+
// Logo
|
|
14
|
+
logo: '/logo.svg',
|
|
15
|
+
|
|
16
|
+
// 导航栏
|
|
17
|
+
nav: [
|
|
18
|
+
{ text: '首页', link: '/' },
|
|
19
|
+
{ text: '快速开始', link: '/guide/getting-started' },
|
|
20
|
+
{ text: '命令参考', link: '/commands/' },
|
|
21
|
+
{ text: '配置', link: '/config/' },
|
|
22
|
+
{ text: 'GitHub', link: 'https://github.com/iamzjt-front-end/git-workflow' }
|
|
23
|
+
],
|
|
24
|
+
|
|
25
|
+
// 侧边栏
|
|
26
|
+
sidebar: {
|
|
27
|
+
'/guide/': [
|
|
28
|
+
{
|
|
29
|
+
text: '指南',
|
|
30
|
+
items: [
|
|
31
|
+
{ text: '介绍', link: '/guide/' },
|
|
32
|
+
{ text: '快速开始', link: '/guide/getting-started' },
|
|
33
|
+
{ text: '安装', link: '/guide/installation' },
|
|
34
|
+
{ text: '基础用法', link: '/guide/basic-usage' },
|
|
35
|
+
{ text: '最佳实践', link: '/guide/best-practices' }
|
|
36
|
+
]
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
text: '核心功能',
|
|
40
|
+
items: [
|
|
41
|
+
{ text: 'AI 智能提交', link: '/guide/ai-commit' },
|
|
42
|
+
{ text: '分支管理', link: '/guide/branch-management' },
|
|
43
|
+
{ text: 'Tag 管理', link: '/guide/tag-management' },
|
|
44
|
+
{ text: 'Stash 管理', link: '/guide/stash-management' },
|
|
45
|
+
{ text: '版本发布', link: '/guide/release-management' }
|
|
46
|
+
]
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
text: '高级用法',
|
|
50
|
+
items: [
|
|
51
|
+
{ text: '团队协作', link: '/guide/team-collaboration' },
|
|
52
|
+
{ text: '工作流集成', link: '/guide/workflow-integration' },
|
|
53
|
+
{ text: '自动化脚本', link: '/guide/automation' }
|
|
54
|
+
]
|
|
55
|
+
}
|
|
56
|
+
],
|
|
57
|
+
'/commands/': [
|
|
58
|
+
{
|
|
59
|
+
text: '命令参考',
|
|
60
|
+
items: [
|
|
61
|
+
{ text: '概览', link: '/commands/' },
|
|
62
|
+
{ text: '交互式菜单', link: '/commands/interactive' },
|
|
63
|
+
{ text: '分支命令', link: '/commands/branch' },
|
|
64
|
+
{ text: 'Tag 命令', link: '/commands/tag' },
|
|
65
|
+
{ text: '提交命令', link: '/commands/commit' },
|
|
66
|
+
{ text: 'Stash 命令', link: '/commands/stash' },
|
|
67
|
+
{ text: '版本命令', link: '/commands/release' },
|
|
68
|
+
{ text: '配置命令', link: '/commands/config' },
|
|
69
|
+
{ text: '更新命令', link: '/commands/update' },
|
|
70
|
+
{ text: '帮助命令', link: '/commands/help' }
|
|
71
|
+
]
|
|
72
|
+
}
|
|
73
|
+
],
|
|
74
|
+
'/config/': [
|
|
75
|
+
{
|
|
76
|
+
text: '配置',
|
|
77
|
+
items: [
|
|
78
|
+
{ text: '配置概览', link: '/config/' },
|
|
79
|
+
{ text: '配置文件', link: '/config/config-file' },
|
|
80
|
+
{ text: 'AI 配置', link: '/config/ai-config' },
|
|
81
|
+
{ text: '分支配置', link: '/config/branch-config' },
|
|
82
|
+
{ text: '提交配置', link: '/config/commit-config' },
|
|
83
|
+
{ text: '配置示例', link: '/config/examples' }
|
|
84
|
+
]
|
|
85
|
+
}
|
|
86
|
+
],
|
|
87
|
+
'/api/': [
|
|
88
|
+
{
|
|
89
|
+
text: 'API 参考',
|
|
90
|
+
items: [
|
|
91
|
+
{ text: 'CLI API', link: '/api/cli' },
|
|
92
|
+
{ text: '配置 API', link: '/api/config' },
|
|
93
|
+
{ text: '工具函数', link: '/api/utils' }
|
|
94
|
+
]
|
|
95
|
+
}
|
|
96
|
+
]
|
|
97
|
+
},
|
|
98
|
+
|
|
99
|
+
// 社交链接
|
|
100
|
+
socialLinks: [
|
|
101
|
+
{ icon: 'github', link: 'https://github.com/iamzjt-front-end/git-workflow' },
|
|
102
|
+
{ icon: 'npm', link: 'https://www.npmjs.com/package/@zjex/git-workflow' }
|
|
103
|
+
],
|
|
104
|
+
|
|
105
|
+
// 页脚
|
|
106
|
+
footer: {
|
|
107
|
+
message: 'Released under the MIT License.',
|
|
108
|
+
copyright: 'Copyright © 2026 zjex'
|
|
109
|
+
},
|
|
110
|
+
|
|
111
|
+
// 搜索
|
|
112
|
+
search: {
|
|
113
|
+
provider: 'local'
|
|
114
|
+
},
|
|
115
|
+
|
|
116
|
+
// 编辑链接
|
|
117
|
+
editLink: {
|
|
118
|
+
pattern: 'https://github.com/iamzjt-front-end/git-workflow/edit/main/docs/:path',
|
|
119
|
+
text: '在 GitHub 上编辑此页'
|
|
120
|
+
},
|
|
121
|
+
|
|
122
|
+
// 最后更新时间
|
|
123
|
+
lastUpdated: {
|
|
124
|
+
text: '最后更新',
|
|
125
|
+
formatOptions: {
|
|
126
|
+
dateStyle: 'short',
|
|
127
|
+
timeStyle: 'medium'
|
|
128
|
+
}
|
|
129
|
+
},
|
|
130
|
+
|
|
131
|
+
// 大纲配置
|
|
132
|
+
outline: {
|
|
133
|
+
level: [2, 3],
|
|
134
|
+
label: '页面导航'
|
|
135
|
+
},
|
|
136
|
+
|
|
137
|
+
// 返回顶部
|
|
138
|
+
returnToTopLabel: '返回顶部',
|
|
139
|
+
|
|
140
|
+
// 深色模式切换
|
|
141
|
+
darkModeSwitchLabel: '主题',
|
|
142
|
+
lightModeSwitchTitle: '切换到浅色模式',
|
|
143
|
+
darkModeSwitchTitle: '切换到深色模式'
|
|
144
|
+
},
|
|
145
|
+
|
|
146
|
+
// Markdown 配置
|
|
147
|
+
markdown: {
|
|
148
|
+
lineNumbers: true,
|
|
149
|
+
theme: {
|
|
150
|
+
light: 'github-light',
|
|
151
|
+
dark: 'github-dark'
|
|
152
|
+
}
|
|
153
|
+
},
|
|
154
|
+
|
|
155
|
+
// 头部配置
|
|
156
|
+
head: [
|
|
157
|
+
['link', { rel: 'icon', type: 'image/svg+xml', href: '/git-workflow/favicon.svg' }],
|
|
158
|
+
['link', { rel: 'apple-touch-icon', href: '/git-workflow/logo.svg' }],
|
|
159
|
+
['meta', { name: 'theme-color', content: '#646cff' }],
|
|
160
|
+
['meta', { name: 'og:type', content: 'website' }],
|
|
161
|
+
['meta', { name: 'og:locale', content: 'zh-CN' }],
|
|
162
|
+
['meta', { name: 'og:site_name', content: 'Git Workflow' }],
|
|
163
|
+
['meta', { name: 'og:image', content: '/git-workflow/logo.svg' }],
|
|
164
|
+
['meta', { name: 'og:title', content: 'Git Workflow - 极简的 Git 工作流 CLI 工具' }],
|
|
165
|
+
['meta', { name: 'og:description', content: '让分支管理和版本发布变得轻松愉快' }]
|
|
166
|
+
]
|
|
167
|
+
})
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
/* Hero Logo 自适应大小 */
|
|
2
|
+
.VPHero .VPImage {
|
|
3
|
+
max-width: 320px !important;
|
|
4
|
+
max-height: 320px !important;
|
|
5
|
+
margin: 0 auto !important;
|
|
6
|
+
}
|
|
7
|
+
|
|
8
|
+
.VPHero .VPImage img {
|
|
9
|
+
max-width: 320px !important;
|
|
10
|
+
max-height: 320px !important;
|
|
11
|
+
width: auto !important;
|
|
12
|
+
height: auto !important;
|
|
13
|
+
object-fit: contain !important;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
/* 响应式设计 - 移动端适配 */
|
|
17
|
+
@media (max-width: 768px) {
|
|
18
|
+
.VPHero .VPImage {
|
|
19
|
+
max-width: 200px !important;
|
|
20
|
+
max-height: 200px !important;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
.VPHero .VPImage img {
|
|
24
|
+
max-width: 200px !important;
|
|
25
|
+
max-height: 200px !important;
|
|
26
|
+
}
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
@media (max-width: 480px) {
|
|
30
|
+
.VPHero .VPImage {
|
|
31
|
+
max-width: 160px !important;
|
|
32
|
+
max-height: 160px !important;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
.VPHero .VPImage img {
|
|
36
|
+
max-width: 160px !important;
|
|
37
|
+
max-height: 160px !important;
|
|
38
|
+
}
|
|
39
|
+
}
|
package/docs/README.md
ADDED
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# Git Workflow 文档
|
|
2
|
+
|
|
3
|
+
这是 Git Workflow 的完整文档站点,使用 VitePress 构建。
|
|
4
|
+
|
|
5
|
+
## 📚 文档结构
|
|
6
|
+
|
|
7
|
+
### 指南 (`/guide/`)
|
|
8
|
+
- **介绍** - 项目介绍和设计理念
|
|
9
|
+
- **快速开始** - 三步开始使用
|
|
10
|
+
- **安装** - 详细安装说明
|
|
11
|
+
- **基础用法** - 掌握日常操作
|
|
12
|
+
- **AI 智能提交** - 深入了解 AI commit 功能
|
|
13
|
+
- **分支管理** - 高级分支管理技巧
|
|
14
|
+
- **Tag 管理** - 版本标签的高级用法
|
|
15
|
+
- **Stash 管理** - 高效管理代码暂存
|
|
16
|
+
- **版本发布管理** - 自动化版本发布流程
|
|
17
|
+
- **最佳实践** - 学习高效的工作流程
|
|
18
|
+
|
|
19
|
+
### 命令参考 (`/commands/`)
|
|
20
|
+
- **概览** - 所有命令的概览
|
|
21
|
+
- **交互式菜单** - 主菜单功能详解
|
|
22
|
+
- **分支命令** - 分支管理命令详解
|
|
23
|
+
- **提交命令** - 提交相关命令详解
|
|
24
|
+
|
|
25
|
+
### 配置文档 (`/config/`)
|
|
26
|
+
- **配置概览** - 配置系统介绍
|
|
27
|
+
- **配置文件详解** - 所有配置项的详细说明
|
|
28
|
+
|
|
29
|
+
## 🚀 本地开发
|
|
30
|
+
|
|
31
|
+
### 启动开发服务器
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
npm run docs:dev
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
然后在浏览器中打开显示的本地地址。
|
|
38
|
+
|
|
39
|
+
### 构建文档
|
|
40
|
+
|
|
41
|
+
```bash
|
|
42
|
+
npm run docs:build
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### 预览构建结果
|
|
46
|
+
|
|
47
|
+
```bash
|
|
48
|
+
npm run docs:preview
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
## 📝 文档特色
|
|
52
|
+
|
|
53
|
+
- **十分详细的内容** - 涵盖从基础到高级的所有用法
|
|
54
|
+
- **丰富的示例** - 大量实际使用示例和代码片段
|
|
55
|
+
- **清晰的结构** - 按功能模块组织,易于查找
|
|
56
|
+
- **响应式设计** - 支持桌面和移动设备
|
|
57
|
+
- **搜索功能** - 本地搜索,快速找到所需内容
|
|
58
|
+
- **深色主题** - 支持深色/浅色主题切换
|
|
59
|
+
|
|
60
|
+
## 🎯 内容亮点
|
|
61
|
+
|
|
62
|
+
1. **完整的功能覆盖** - 每个功能都有详细说明
|
|
63
|
+
2. **实际使用场景** - 提供真实的使用场景和解决方案
|
|
64
|
+
3. **故障排除指南** - 常见问题和解决方案
|
|
65
|
+
4. **最佳实践** - 从个人开发到企业级的最佳实践
|
|
66
|
+
5. **配置详解** - 所有配置项的详细说明和示例
|
|
67
|
+
|
|
68
|
+
## 📖 如何贡献
|
|
69
|
+
|
|
70
|
+
1. 在 `docs/` 目录下编辑 Markdown 文件
|
|
71
|
+
2. 使用 `npm run docs:dev` 预览更改
|
|
72
|
+
3. 提交 Pull Request
|
|
73
|
+
|
|
74
|
+
## 🔗 相关链接
|
|
75
|
+
|
|
76
|
+
- [GitHub 仓库](https://github.com/iamzjt-front-end/git-workflow)
|
|
77
|
+
- [npm 包](https://www.npmjs.com/package/@zjex/git-workflow)
|
|
78
|
+
- [问题反馈](https://github.com/iamzjt-front-end/git-workflow/issues)
|
|
79
|
+
|
|
80
|
+
---
|
|
81
|
+
|
|
82
|
+
这个文档站点为用户提供了完整、详细的 Git Workflow 使用指南,帮助用户快速上手并深入掌握所有功能。
|