Giteasy

GitEasy

一个 PowerShell 模块，让不懂 Git 的人无需学习 Git 术语，也能保存并发布自己的工作成果。

Keith 的话

我是 Keith Ramsey。我的本职工作是 SQL Server 数据库管理员，业余时间则是 PowerShell 的忠实爱好者。过去 13 年里，我一直在同一个团队工作，默默构建内部工具，解决我们遇到的具体难题。GitEasy 是我人生的新篇章。这是我首次向公众发布工具，说实话，为陌生人设计工具——打磨代码、用通俗易懂的语言写说明，只为帮上忙——整个过程让我乐在其中。

如果你正在了解这个模块，我不仅希望你喜欢它，更希望它能让你感到如释重负。我承认：过去 Git 让我害怕。我搞砸过提交，沮丧得离开办公桌，还告诉自己明天再弄明白。全职开发人员用 Git 得心应手，而我与 DBA、合规团队和变更经理并肩工作。我们这些人只想找回以前用 TFS 签入代码的感觉。Git 不只是一个工具，它还有一整套全新的词汇，处处都是陷阱。

很长一段时间里，我们设法避开了它。但最终，要求还是下来了：Git 来了，学起来吧。我坐在那里，感觉自己像是在为了一场期末考试而学习，只为保存一个文件，这时 GitEasy 的想法豁然开朗。我们能不能把术语都去掉？签入代码能不能不需要学习一整套全新的词汇？

于是，GitEasy 诞生了。只有 5 个简单命令。没有令人困惑的原始 Git 文本。每次操作都会生成一个日志文件。它是一个简单顺畅的封装——懂 Git 的话，随时可以绕过它。不懂的话，你永远不必接触那些吓人的内容。

有一点很重要：目前只有我一个人在修改 GitEasy。要接收其他人的代码更改，就得请律师帮忙准备合适的法律文件；与其把时间和金钱花在以后可能还得重做的法律文书上，我更愿意用来发布更多实用代码。这不是永久立场；我只是想慢慢来。不过请放心，GitEasy 使用 MPL 2.0 许可证，这意味着任何人都可以自由获取代码，并自行接手继续开发。这个项目的存续不依赖于我。

如果这个决定让你有所顾虑，我完全理解。我只是一个一步一步摸索开源世界的人。这扇门没有上锁，只是今天暂时关着。我完全欢迎你提交错误报告和功能建议——前往 GitHub 项目，创建一个 Issue，告诉我你需要什么，我会阅读。无需提交代码。如果你想聊聊，可以在 GitHub 上通过 @greenmtnsun 找到我。

如果你曾因为 Git 的错误消息比自己想保存的更改还吓人，而关掉 PowerShell：这个工具就是为你打造的。希望它能让你如释重负，也希望你用得愉快。保重。

说明

Keith 的简短状态说明。最新内容置顶。随着项目进展，编辑或补充。

2026-05-22 — CI 和 AI Agent 用户的使用指南另有专页

新增了 docs/USING-IN-CI-AND-AGENTS.md。这是一份统一的约定，供希望在 CI 流水线（GitHub Actions、Azure Pipelines、GitLab）或 AI 编码 Agent 中使用 GitEasy 的人参考。特意不要求使用者运行我自己的测试套件或术语审查——这些是我的质量标准，不是他们的。

2026-05-22 — 目前暂不接受贡献

目前没有 CLA；在有实际需要之前，我不会投入精力处理法律事务。欢迎通过 Issue 提交错误报告。PR 暂不审核。情况有变时，我会更新这条说明。

2026-05-21 — v1.5.3 已准备就绪，暂缓发布到 PowerShell Gallery

1.5.3 已完成所有功能，清单也已准备就绪（图标、仓库内的 LicenseUri、内联纯文本发行说明、14 个带受众标签的关键词），并且 .nupkg 已成功构建，包含每份文档的 PDF。在决定是否将仓库设为公开之前，我暂缓实际发布到 PSGallery。首位外部用户（Tycro）目前正从私有仓库克隆安装——运行正常。

2026-05-20 — 安全审查完成（v1.5.2）

已修复三个凭据相关问题（F-04 / F-05 / F-06），涵盖 1.5.1 审查遗漏的同类模式漏洞。已在 Tests/GitEasy.AuthHardening.Tests.ps1 中添加完整的失效测试套件。如果你使用带凭据助手的 GitEasy，建议至少升级到 1.5.2。

它能为你做什么

一小组简单易懂的命令。复杂的操作交给引擎处理；你看到和输入的内容都很简单。

Find-CodeChange         # What has changed?
Save-Work 'fix readme'  # Save and publish in one step.
Show-History            # Recent saved points.
Show-Remote             # Where this folder is published.

发生问题时，你会收到一条简单易懂的消息，以及一个包含技术细节的独立日志文件路径。用户不会看到原始 Git 输出。

安装

好友速装（支持 PS 5.1 和 PS 7，无需管理员权限）：

$Edition = if ($PSVersionTable.PSEdition -eq 'Core') { 'PowerShell' } else { 'WindowsPowerShell' }
$ModuleDir = Join-Path $HOME "Documents\$Edition\Modules\GitEasy"
git clone https://github.com/greenmtnsun/GitEasy.git $ModuleDir
Import-Module GitEasy

这会将 GitEasy 安装到用户范围的 PowerShell 模块文件夹 （默认位于 $env:PSModulePath 中），因此 你可以在任何位置运行 Import-Module GitEasy。关于 离线安装方式和所有用户范围，请参阅 docs/HOW-TO-USE-GITEASY.md。

PowerShell Gallery 发布后，安装方式如下：

Install-Module GitEasy -Scope CurrentUser

PowerShell Gallery 页面（发布后）位于 powershellgallery.com/packages/GitEasy。

快速入门

# In any folder that is already a Git repo:
Find-CodeChange
Save-Work 'first save'
Show-History -Count 5

如果仓库尚未发布到任何位置，Save-Work 会告知你并在本地保存。之后连接到已发布的位置时，下一次运行 Save-Work 就会发布此前保存的所有内容。

完整命令列表

命令	功能
Find-CodeChange	显示项目文件夹中的更改。
Save-Work	保存更改并发布（或使用 -NoPush 在本地保存）。
Show-History	显示最近的保存记录。
Show-Remote	显示项目文件夹发布到的位置。
Show-Diagnostic	打开或列出诊断日志文件。
New-WorkBranch	为独立任务创建新的工作区。
Switch-Work	切换到另一个现有工作区。
Restore-File	将单个文件恢复到上次保存的状态。
Undo-Changes	丢弃未保存的更改（需要 -Force 或 -Confirm）。
Clear-Junk	列出或移除明显的临时文件。
Test-Login	验证与已发布位置的连接。
Set-Token	配置基于 HTTPS 的登录。
Set-Ssh	配置基于 SSH 的登录。
Set-Vault	选择保存登录信息的位置。
Get-VaultStatus	报告已配置的凭据助手。
Reset-Login	清除已保存的登录信息，以便重新设置。

每个命令都提供完整的基于注释的帮助——运行 Get-Help <Command> -Full 查看易读版本。

诊断日志

每个公开命令都会在 %LOCALAPPDATA%\GitEasy\Logs 下写入一个小型日志文件。成功运行时会静默记录。运行失败时会抛出一条简单易懂的消息，并告知你日志路径，方便熟悉 Git 的人员查看问题详情。

Show-Diagnostic           # Open the most recent log.
Show-Diagnostic -List     # List recent logs.
Show-Diagnostic -All      # Open the logs folder.

超过 30 天的日志会自动清理。

文档

完整文档位于 GitHub Wiki。每个公开命令都有独立页面，包含概要、示例、安全说明和相关命令交叉引用。每个私有辅助函数也有类似页面，供维护者参考。

兼容性

• Windows PowerShell 5.1+
• PowerShell 7+（Windows；跨平台可能可用，但这不是设计目标）
• 必须安装 Git，并将其添加到 PATH。

要在 CI 作业或 AI Agent 中运行 GitEasy？请参阅 docs/USING-IN-CI-AND-AGENTS.md——面向使用者的一页说明。

状态

GitEasy 当前版本为 1.5.3——功能完备的公开接口（21 个命令）、在两种 PowerShell 宿主上通过的 569 项 Pester 测试，以及完整的通俗易懂约定。

请参阅 CHANGELOG.md 了解历史记录。

参与贡献

GitEasy 由一位作者维护，目前不接受外部拉取请求——尚未制定贡献者协议。欢迎通过 Issues 报告错误。

作者的质量标准（测试规范、不使用行话的规则、诊断日志会话模式）已记录在 CONTRIBUTING.md 中，以提高透明度。

许可证

Mozilla Public License 2.0。文件级 Copyleft：任何人都可以使用、修改和将此代码嵌入专有或开源项目，但对 GitEasy 自身文件所做的修改必须依据 MPL-2.0 发布。

作者

Keith Ramsey（@greenmtnsun）。