Git 提交信息规范 — Emoji + Type 约定式提交
统一的 Git 提交信息规范能大幅提升代码历史的可读性,配合 AI 工具自动生成,零学习成本。 规范总览 格式 123456- <emoji> <type>(<scope>): <subject>- - <body 行1>- <body 行2>- - <footer> 示例 123456- ✨ feat(api): 添加用户登录接口- - 新增 JWT 认证流程,包含 token 刷新和过期处理。- 使用 Redis 缓存 session 提升性能。- - Closes #42 123- 🐛 fix(components): 修复日期选择器样式错乱- - Safari 下 flex 布局未正确渲染,改用 grid 布局替代。 1- 📝 docs: 更新 API 文档 Type 与 Emoji 映射 Emoji Type 说明 ✨ feat 添加新功能 🐛 fix 修复 bug 📝 docs 对文档进行修改 ♻️ refactor 代码重构 ⚡ perf 提...
Hermes Agent 安装与配置指南
Hermes Agent 是一个基于大语言模型的 AI 智能体框架,支持 CLI、TUI、微信、Telegram 等多种交互方式。本文记录完整的安装配置流程。 安装 前置条件 Python 3.12+ macOS / Linux Git pip 安装 1pip install hermes-agent 安装后初始化项目并创建配置文件: 1hermes init 这会生成 ~/.hermes/config.yaml 主配置文件。 验证安装 12hermes --version# Hermes Agent v0.15.1 (2026.5.29) 配置基础 配置文件 主配置位于 ~/.hermes/config.yaml,核心配置项: 123456789model: default: deepseek-v4-flash # 默认模型 provider: deepseek # 默认提供商 base_url: https://api.deepseek.comagent: max_turns: 90 ...
Hermes Agent 技能系统与三方技能
Hermes Agent 的核心能力来源于**技能(Skills)**系统。每个技能是一个 markdown 文件,定义了特定场景下的行为、工作流和注意事项。 技能系统概览 技能文件存储在 ~/.hermes/skills/ 下,按类别组织: 12345678910111213141516171819skills/├── academic/ # 学术写作├── apple/ # Apple 生态(iMessage, 提醒事项)├── autonomous-ai-agents/ # AI 智能体│ ├── hermes-agent/ # Hermes 自身配置│ ├── claude-code/ # Claude Code 集成│ ├── codex/ # OpenAI Codex│ ├── karpathy-guidelines/ # Karpathy 编码准则│ └── ...├── creative/ # 创意内容(ASCII 艺术、漫画、P5.js)├─...
Hermes Agent 日常使用与集成
Hermes Agent 不仅是 CLI 工具,还支持网关模式、定时任务、多平台消息推送等生产级能力。 网关模式 网关模式让 Hermes 作为后台常驻服务运行,通过微信、Telegram、Discord 等平台交互。 启动网关 1hermes gateway WeChat 集成 通过 WeChat 网关,可以在微信中直接与 Hermes 对话: 发送消息 → Hermes 处理 → 返回结果 自动识别上下文,追踪对话线程 支持文件、图片等多模态输入 配置方式(config.yaml): 12345# 网关相关配置gateway: strict: false trust_recent_files: true trust_recent_files_seconds: 600 消息格式 内容类型 说明 文本 直接对话 图片 自动 OCR/视觉分析 文件 代码审查、文档处理 URL 网页摘要、内容分析 定时任务 (Cron) Hermes 内置定时任务调度器,支持: 123456789# 创建定时任务cronjob(action='creat...
实战笔记:从零到一搭建 XXX
TL;DR 本文从实际项目出发,详细记录了实现 XX 功能的完整过程,包含架构选型、关键代码、性能数据和踩坑记录。 背景 为什么要做这个功能?遇到了什么问题? 最终效果 方案对比 方案 优点 缺点 适用场景 方案A 实现简单 扩展性差 快速验证 方案B 性能好 学习成本高 生产环境 方案C ✅ 平衡两者 需要额外库 大多数场景 最终选择了 方案C,原因是…… 核心实现 1. 架构设计 123App层 → ViewController / View业务层 → Service / Manager数据层 → Repository / Cache 2. 关键代码 12345678910111213141516171819// File: Sources/Feature/Manager.swiftprotocol FeatureManagerProtocol { func fetchData(completion: @escaping (Result<[Model], Error>) -> Void)}fin...
XXX 实用技巧合集
把这些技巧挨个试一遍,总有几个让你惊呼"原来还能这样?" 🔥 技巧 1:标题即要点 场景:什么时候用这个技巧? 操作:具体怎么做 1# 实际命令或代码 🔥 技巧 2:…… 技巧 难度 频次 技巧1 ⭐ 每天 技巧2 ⭐⭐ 每周 总结清单 [ ] 技巧1 已掌握 [ ] 技巧2 已掌握 [ ] 技巧3 已掌握 觉得有用的话可以收藏,后续还会更新更多技巧。
深入理解 XXX
一句话概括 XXX 本质上就是一个 YYY,它通过 ZZZ 机制实现了…… 如果只记住一句,就这句。 它是干什么的? 用一句话说清楚这个技术/工具解决什么问题。 源码走读 入口 1234567// 关键入口方法public func load() { // 1. 检查缓存 // 2. 发起请求 // 3. 解析数据 // 4. 回调通知} 核心流程 123request → 拦截器链 → 缓存检查 → 网络请求 → 解析器 → 回调 ↓ 命中缓存→ 直接返回 设计亮点 💡 源码里最精彩的设计: 12345// 用协议 + 泛型实现了类型安全的回调protocol Handler<T> { associatedtype T func handle(_ data: T)} 对比其他方案 旧方案:XX 方式,问题是…… 新方案:YY 方式,优势在…… 本质区别:从 A 模式变成了 B 模式 最佳实践 12345// 推荐的用法let config = Conf...
2026 Q2 开发日志:XX 项目复盘
📊 本期概览 维度 数据 完成功能 12 个 修复 Bug 47 个 代码提交 186 次 迭代周期 4 个 Sprint ✅ 做对了 1. 架构先行 在功能开发前花了一周做架构评审,后期几乎没有大改。 2. 自动化测试 覆盖率从 30% 提升到 85%,回归 Bug 大幅减少。 ❌ 踩坑记录 1. 依赖升级过早 第三周升级了 XXX 库到 3.0,导致兼容性问题浪费 2 天。 教训:依赖升级应该安排在迭代末尾,且必须有完整测试覆盖。 2. 需求理解偏差 花了 3 天做的功能,实际上产品要的是另一种交互。 教训:开发前必须出交互原型确认,不能只看 PRD。 🎯 下期计划 优先级 事项 预期 P0 性能优化 首屏 < 1s P1 文档补全 API 文档 100% P2 重构旧模块 消除技术债 💡 经验沉淀 每次复盘最有价值的不是记录做了什么,而是 总结出下次可以复用的判断标准。
Hexo博客GitHub Actions自动部署指南
Hexo 生成的是静态文件,传统做法是本地 hexo g -d 推送到 Pages 仓库。有了 GitHub Actions 后,每次 git push 源码仓库就能自动构建部署,解放本地环境。 本文记录完整的配置流程。 整体思路 两个仓库分工: 源码仓库(jeromexiong/blog)— 存 Hexo 源码、文章、主题配置 Pages 仓库(jeromexiong/jeromexiong.github.io)— 存构建产物(public/ 目录),GitHub Pages 从这读取 CI/CD 要做的就是:源码仓库收到 push → 自动构建 → 推送到 Pages 仓库。 一、生成 SSH Deploy Key 为了让 GitHub Actions 有权限写入 Pages 仓库,需要一对 SSH 密钥。公钥给 Pages 仓库,私钥给源码仓库。 1ssh-keygen -t ed25519 -f ~/blog-deploy-key -N "" -C "deploy" 这会生成两个文件: blog-deploy-key — 私钥 blog-deploy-key.pub...
kilomind复盘
本文对千脉(kilomind)科技创立以来的项目进行复盘总结,涵盖项目列表、技术栈选择与团队规范等方面。 创立初期至今的项目 千脉软件下载:https://share.weiyun.com/51ji0M2 密码:r3v1d7 [x] 星客漫游 服务端 PHP 公众号 PHP 移动端 Android Java 后台管理 PHP [x] 乐脉 服务端 PHP 小程序 官方语言 前台管理 Vue 后台管理 Vue [x] 拍管家 服务端 PHP H5 Vue 后台管理 Vue [x] 声动太空 服务端 PHP H5 Vue 后台管理 Vue [x] 艾宠星球 服务端 PHP 小程序 官方语言 后台管理 Vue [x] 久翌 服务端 PHP 后台管理 Vue 数据抓取插件 Vue [x] 智能跑道 服务端 NodeJS PC端 C++ 移动端 Android Java、iOS Swfit [x] PC录像打点 PC端 C++ [x] 义虎演艺 服务端 PHP 小程序 官方语...