zurcacielos/contributist

### Contributist — Git 贡献图绘制工具 **Contributist** 是一款交互式 Web 工具，可直接在您的 Git 贡献图上绘制自定义像素画。设计您的布局，加载模板，并生成提交历史脚本，即刻自定义您的个人主页。 ## 在线演示 --> [**contributist.stupidity.works**](https://contributist.stupidity.works) ## 本地安装 - 前置条件 - 运行 - **Node.js**（推荐 v18 或更高版本） - **npm** 或 **yarn** / **pnpm** git clone git@github.com:zurcacielos/contributist.git cd contributist npm install npm run dev ## 📸 截图 ### 主控制面板  *使用画板、颜色和图层自定义您的贡献网格。* ### 两种 UI 风格：Vibe 或 Bash  在顶部选择您最喜欢的风格。Bash 是偏向开发者/黑客/Linux 的 UI 风格，它提供了更多选项供您调整和自定义背景算法。 Vibe 则采用了更丰富多彩的方式，并包含现实和混沌等控制选项，使其更加有趣。 ### 社区混音与预设  *从社区模板中进行选择，或创建您自己的混音作品。保存它们，分享它们。敬请期待更多社区互动功能！* ### 图层编辑 - 栅格 - 背景 - 精灵图  *图层编辑功能允许您向贡献图中添加自定义形状、精灵图和背景图像。更改顺序、在编辑时隐藏、添加文本等等，更多功能即将推出！* ### 用于快速娱乐的表情包与文本工具栏  *表情包和文本工具栏出现在选定的年份中，允许您向贡献图添加表情包和文本。* ### 发送至 Git 开发模式和云端模式  *发送至 Git 功能有两种模式。本地模式，当您在本地计算机上执行 npm run dev 时，它允许您直接将贡献生成并发送到您的 Git 仓库，而无需运行任何本地脚本。云端模式，当应用程序部署在线上时，它允许您下载 Bash 脚本或 Powershell 脚本，以便您在自己的机器上自行运行提交。* ### PNG 导出模式：绿色、蓝色、Vibe   *PNG 导出模式允许您下载带有不同调色板的贡献图 PNG 图像。这非常适合在社交媒体或其他平台上分享您的艺术作品。* ### URL 导出  *URL 导出模式允许您生成一个可用于与他人分享您艺术作品的 URL。只需在“分享”界面分享该 URL，整个配置就会被编码在该 URL 中，这样对方就能立即看到您的作品。* ### 个人资料菜单 - 新建、打开、保存  *在个人资料菜单中，“新建”选项允许您创建一个新的艺术作品。“打开”选项允许您打开现有的艺术作品。“保存”选项允许您将您的艺术作品保存到您的计算机中。包括您在“发送至 Git”部分中可能输入的 GitHub 用户名和仓库名称。* ## ✨ 功能特性 - **交互式画布：** 使用直接绘画和橡皮擦工具在贡献网格上进行绘制。 - **多种感觉模式：** - **Vibe 模式：** 纯粹专注于创意像素艺术的绘制。 - **高级模式：** 允许对噪声、周末、假期模式和提交密度进行细粒度控制。 - **图层引擎：** 管理包括自定义栅格图层、表情包和背景配置在内的多个图层。调整透明度、可见性和锁定设置。 - **本地 Git 生成：** 可选择运行本地脚本端点，将您的绘图直接提交并推送到您的 GitHub 历史记录中。 - **社区预设：** 加载并重新混音现有场景（如奔跑的猫、像素心形等）。 ### 自定义社区混音 目前，社区混音以 JSON 文件的形式存储在 `public/templates/scenes/` 中。您可以在本地机器开发模式下工作时保存任何作品并在社区面板中下载它。然后，您应该将该 JSON 复制到 `public/templates/scenes` 中，应用程序会动态加载它。点击右上角的 profile（个人资料）、new（新建），即可获得一个新的画布，然后点击一个社区混音模板，它就会被加载。您可以对其进行修改，然后右键点击您选择的 remix（混音）按钮并点击“save to this”（保存至此）。这是在我连接数据库之前的临时解决方案。 ## ⚙️ 环境变量配置 本项目通过由 Git 追踪的 `.env` 文件配置其默认设置。如需进行本地覆盖或私有仓库配置，您可以创建一个 `.env.local` 文件。 请参阅[环境变量指南](environment-vars.md)以获取可用配置变量列表和设置示例。 ## 🧪 测试 使用 Vitest 运行单元测试和集成测试： ``` # 交互式运行测试 npm run test # 运行一次测试 (CI mode) npm run test:run ``` ## 🛡️ 许可证 本项目基于 MIT 许可证授权 - 有关详细信息，请参阅 [LICENSE](LICENSE) 文件。

标签：Git, MITM代理, Mutation, Syscall 审计, 可视化, 图像生成, 威胁情报, 开发者工具, 暗色界面, 自动化攻击