📦 Lint — 代码检查

# Lint Lint 是一款面向开发者的工具包，用于在终端记录和追踪代码质量操作。它提供 13 条核心 action 命令，可管理检查、校验、格式化、lint、代码生成、转换、模板、diff、预览、修复、报告与解释，所有操作均带时间戳的本地日志，实现全程可追溯。额外的 utility 命令可查看统计、导出数据、搜索历史并监控健康状态。 ## 命令 ### 核心 Action 命令 每条 action 命令支持两种模式：不传参数时显示最近 20 条记录；传入文本则记录一条带时间戳的新条目。 | 命令 | 描述 | |---------|-------------| | lint check | 记录一次语法/代码检查 | | lint validate | 记录一次校验结果 | | lint generate | 记录一次代码生成操作 | | lint format | 记录一次格式化操作 | | lint lint | 记录一次 lint 通过 | | lint explain | 记录一次解释或注解 | | lint convert | 记录一次转换操作 | | lint template | 记录一次模板操作 | | lint diff | 记录一次 diff 比较 | | lint preview | 记录一次预览操作 | | lint fix | 记录一次自动修复 | | lint report | 记录一次报告生成 | ### 工具命令 | 命令 | 描述 | |---------|-------------| | lint stats | 显示汇总统计——各类别条目数、总条目数、数据大小及最早活动时间戳 | | lint export | 将全部数据导出为 JSON、CSV 或 TXT 格式，输出文件保存至 ~/.local/share/lint/export. | | lint search | 全文搜索所有日志文件（不区分大小写） | | lint recent | 显示历史日志中最近的 20 条记录 | | lint status | 健康检查——版本、数据目录、总条目数、磁盘用量、最后活动 | | lint help | 显示所有可用命令的帮助 | | lint version | 打印版本字符串（lint v2.0.0） | ## 数据存储 所有数据均本地存储于 ~/.local/share/lint/。每条 action 命令写入各自日志文件（如 check.log、validate.log、fix.log）。统一 history.log 记录所有操作及时间戳。不使用外部服务、数据库或网络连接。 目录结构： `` ~/.local/share/lint/ ├── check.log # 检查条目 ├── validate.log # 校验条目 ├── generate.log # 生成条目 ├── format.log # 格式化条目 ├── lint.log # lint 条目 ├── explain.log # 解释条目 ├── convert.log # 转换条目 ├── template.log # 模板条目 ├── diff.log # diff 条目 ├── preview.log # 预览条目 ├── fix.log # 修复条目 ├── report.log # 报告条目 ├── history.log # 统一活动日志 └── export.* # 导出输出文件 ` ## 要求 - Bash（需 set -euo pipefail） - 标准 Unix 工具：date、wc、du、head、tail、grep、basename、cut - 无需外部依赖或 API 密钥 ## 何时使用 1. 追踪 lint 会话——记录 lint 了哪些文件、发现的问题及应用的修复，全部带时间戳供审计。 2. 代码审查流程——在 PR 评审期间记录 check 与 validate 结果，便于回溯检查内容与时间。 3. 模板与 diff 管理——持续记录模板操作及各迭代间的 diff 比较。 4. 导出质量报告——使用 lint export json 生成机器可读的 lint 活动报告，供 CI 面板或团队评审。 5. 搜索过往操作——用 lint search 快速查找历史 lint 结果、修复或解释。 ## 示例 `bash # 记录对 Python 文件的检查 lint check "src/main.py — 3 unused imports found" # 记录已应用的修复 lint fix "Removed unused imports in src/main.py" # 查看最近的格式化操作 lint format # 搜索所有包含 "import" 的条目 lint search import # 全部导出为 JSON lint export json # 查看整体统计 lint stats # 健康检查 lint status `` --- Powered by BytesAgain | bytesagain.com | hello@bytesagain.com