告别糊涂账：用Gocost在命令行轻松掌控你的财务！

你是不是也经常感觉钱不知道花哪儿去了？每个月月底一算账，总是一头雾水？别担心，今天给大家推荐一款超酷的命令行记账工具——Gocost！它能让你在终端里就能轻松管理收支，告别糊涂账，而且完全免费开源哦！

### Gocost：极简主义的记账神器

Gocost 是一款基于 Go 语言和 Bubble Tea 框架开发的 TUI (Terminal User Interface) 应用，简单来说，它就是一个在命令行界面运行的记账软件。如果你是程序员、系统管理员，或者单纯喜欢用命令行搞定一切，那么 Gocost 绝对是你的菜！

### 为什么选择 Gocost？

* **极简高效：** 没有花里胡哨的界面，所有操作都在命令行完成，速度飞快，告别鼠标，键盘流的福音！
* **功能全面：** 支持按类别和分组记录每月支出，管理收入，组织类别，功能一点也不含糊。
* **数据安全：** 数据以 JSON 格式保存在本地，完全掌控自己的财务数据，不用担心隐私泄露。
* **高度定制：** 支持自定义货币符号，适应不同国家和地区的用户。
* **开源免费：** 任何人都可以免费使用、修改和分享，社区支持，持续更新。
* **跨平台：** 只要有 Go 环境，就能在各种操作系统上运行。
* **键盘驱动：** 所有的操作都可以通过键盘来完成，非常方便。
* **自适应颜色：** 软件可以根据终端的主题自动调整颜色，无论是亮色还是暗色主题，都有很好的显示效果。

### Gocost 的核心功能

1. **收支管理：** 记录每月的收入和支出，清楚了解钱的去向。你可以给每一笔支出选择不同的类别，比如餐饮、交通、娱乐等等。
2. **类别管理：** 创建和管理支出类别，方便统计和分析。你可以把类别进行分组，比如把“餐饮”分成“早餐”、“午餐”、“晚餐”等更细致的类别。
3. **月度概览：** 提供清晰的月度收支概览，让你一眼就能看到当月的财务状况。
4. **数据持久化：** 所有数据都保存在本地 JSON 文件中，安全可靠。
5. **快捷键操作：** 大量快捷键让操作更加高效，比如 `q` 退出，`i` 管理收入，`c` 管理类别，`j/k` 上下移动等等。

### Gocost 的安装与使用

Gocost 的安装方式非常简单，主要有以下几种：

1. **从 GitHub Releases 下载：**

* 访问 [Gocost 的 GitHub Releases 页面](https://github.com/madalinpopa/gocost/releases)。
* 下载对应你操作系统的预编译二进制文件。
* 解压并运行即可。
2. **使用 `go install` 命令：**

* 确保你已经安装了 Go 语言环境。
* 运行命令 `go install github.com/madalinpopa/gocost/cmd/gocost@latest`。
* Gocost 将会被安装到你的 `$GOPATH/bin` 目录下。
3. **本地编译：**

* 克隆 Gocost 的代码仓库：`git clone https://github.com/madalinpopa/gocost.git`
* 进入 Gocost 目录：`cd gocost`
* 编译：`go build -o gocost ./cmd/gocost`

安装完成后，直接在终端输入 `gocost` 就可以运行了。

### Gocost 的基本操作

* **添加支出：** 按 `a` 或 `n` 键添加新的支出项目，填写金额、类别、备注等信息。
* **编辑支出：** 选中要编辑的支出项目，按 `e` 键进行编辑。
* **删除支出：** 选中要删除的支出项目，按 `d` 键进行删除。
* **管理类别：** 按 `c` 键进入类别管理界面，可以添加、编辑、删除类别。
* **管理收入：** 按 `i` 键进入收入管理界面，可以添加、编辑、删除收入。
* **切换月份：** 使用 `h` 和 `l` 键可以在不同的月份之间切换。
* **重置月份：** 使用 `r` 键可以快速回到当前月份。

更多快捷键可以在软件运行后查看帮助文档。

### Gocost 的项目结构

Gocost 的项目结构清晰明了，主要分为以下几个目录：

* `cmd/gocost/`: 应用的入口点。
* `internal/app/`: 包含应用的核心逻辑，如状态管理、消息处理等。
* `internal/config/`: 负责配置文件的加载和管理。
* `internal/data/`: 定义数据模型（如收入、支出、类别等）以及数据的持久化操作。
* `internal/ui/`: 包含所有的 UI 组件，如概览视图、收入视图、类别视图等。

### 参与 Gocost 的开发

Gocost 是一个开源项目，欢迎大家参与开发！你可以通过以下方式参与：

* **提交 Issue：** 如果你发现了 Bug 或者有新的功能建议，可以在 GitHub 上提交 Issue。
* **提交 Pull Request：** 如果你修复了 Bug 或者实现了新的功能，可以提交 Pull Request。
* **参与讨论：** 参与社区讨论，分享你的想法和经验。

贡献代码的步骤如下：

1. Fork 代码仓库。
2. 创建 feature 分支：`git checkout -b feature/your-feature-name`
3. 进行修改，遵循 Go 语言的最佳实践。
4. 添加测试用例。
5. 提交代码：`git commit -m “Add your descriptive commit message”`
6. 推送代码到你的 Fork：`git push origin feature/your-feature-name`
7. 创建 Pull Request。

### 总结

Gocost 是一款简单、高效、实用的命令行记账工具，特别适合喜欢使用命令行的开发者和系统管理员。它功能全面，数据安全，高度定制，而且完全开源免费。如果你正在寻找一款极简主义的记账工具，不妨试试 Gocost！

madalinpopa/gocost: Simple TUI application to manage monthly expenses
https://github.com/madalinpopa/gocost