我们如何使用 impeccable 优化前端界面设计与实现稳定性
我们如何使用 impeccable 优化前端界面设计与实现稳定性 引言 很多团队做 UI 时都有同个痛点：设计语言靠经验，交互细节靠记忆，最后产物容易“能用但不稳”。 在 HagiCode monorepo 里，impeccable 不是当成“灵感工具”用，而是被放进一套可执行、可校验、可回归的工程链路里： 任务入口有结构化约束（命令、场景、仓库范围） 站点内容和上游命令定义自动对齐 本地开发端口、运行参数、校验流程固定化…
博客
让所有 Agent 都会 /goal：HagiCode 持续工作预设的兼容扩展设计
让所有 Agent 都会 /goal：HagiCode 持续工作预设的兼容扩展设计 引言 给 AI Agent 派一个「持续工作」的任务，理想状态是这样的：你写下一个目标，选好可以动的仓库，点一下提交，Agent 就朝着这个目标一路推进，中途不追问、不跑题、不越界改别的仓库。 在 HagiCode 里，这个能力有个专门的入口——goal 预设任务，命令表面是 /goal。问题在于：不是所有 Agent 都认识 /goal。…
如何用 last30days 来完成基于社交网络的 AI 调研需求
如何用 last30days 完成基于社交网络的 AI 调研需求 社交网络上每天都有人在表态：发帖、投票、争吵、退订、迁移。这些散落在 Reddit、X、YouTube 评论、TikTok、Hacker News、Polymarket 上的声音，单独看只是噪音，攒到一起却是一份相当真实的民意切片。问题只在于——没人愿意为了一个调研结论，手动去八个平台翻三十天的帖子。 last30days 这个 skill…
让每个命令都能精准路由：HagiCode Preset Task 的多技能支持实战
让每个命令都能精准路由：HagiCode Preset Task 的多技能支持实战 一个 preset 里塞了多个命令，却只能共用一份技能要求？这次改造，让每条命令都能独立声明自己依赖的 skill，并在可视化面板上把这种绑定展示出来——徽标、摘要、一键安装，一气呵成。 背景 先说点背景。 HagiCode 的 preset task…
HagiCode 是怎么把 13 个 Agent CLI 接到一套系统里的
HagiCode 是怎么把 13 个 Agent CLI 接到一套系统里的 其实这事儿吧，说难也不难，说简单呢，又不简单。聊聊我们怎么用一套分层架构，把 Claude Code、Codex、Copilot、Gemini 这些风格各异的 Agent CLI 统一管起来，还能随时插一个新的进来。 背景 故事开始得突然，源于一个挺让人头疼的问题。 Agent CLI 这两年像竹笋一样冒头——Claude Code、OpenAI…
用 Orleans 搞定 AI 编程工作台的后台分布式难题
用 Orleans 搞定 AI 编程工作台的后台分布式难题 在一个进程里管十几种 AI CLI 工具、同时拖着几十个会话的实时流——听起来像在做梦？其实我们也觉得挺离谱的。但 Orleans 的 Virtual Actor 模型，还真就把这份复杂度收得服服帖帖。怎么说呢，有些工具生来就是解决某种问题的，只是你遇到那个问题之前，不会懂它有多合适罢了。 背景 做 AI…
HagiCode 中 AI 提交使用的提示词：设计思路与实现拆解
HagiCode 中 AI 提交使用的提示词：设计思路与实现拆解 当你把一堆乱七八糟的改动丢给 AI 让它帮你提交时，背后到底发了一段什么样的提示词给模型？为什么提示词要写成那个样子？这篇文章把 HagiCode 里真正驱动”AI 提交”的提示词拆给你看。 背景 用 AI…
MonoSpecs 是什么：为什么说它是对 OpenSpec 的进一步升级和扩展
MonoSpecs 是什么：为什么说它是对 OpenSpec 的进一步升级和扩展 当一个产品体系膨胀到 40+ 个独立 Git 仓库时，”规范”该放在哪里？这篇就聊聊 HagiCode 在多仓库治理上走过的两步棋：先把 OpenSpec 上提到主仓库，再在它之上发展出 MonoSpecs 这套多仓库管理方案。其实也没什么啦，只是走过了一些坑，想记下来罢了。 背景…
Pi Agent 对接实现：消息解析、重试与取消
Pi Agent 对接实现：消息解析、重试与取消 接一个 CLI 形态的 AI agent，绕不开三件事：怎么把它私有的事件流翻译成稳定消息、失败之后到底谁负责重试、用户点取消时进程怎么干净地停。其实这三件事说穿了，不过是”分清职责”罢了，只是真做起来，才知道水有多深。 背景 最近我在做一个 AI 代码助手项目，要对接的 agent 之一是 pi。它本身是一个 TUI/CLI 的 coding agent，跑起来会在 stdout…
对接 Reasonix 1.x 跑通 DeepSeek V4：ACP 模型选择器接入实战
对接 Reasonix 1.x 跑通 DeepSeek V4：ACP 模型选择器接入实战 本文聊聊在 HagiCode 里怎么把 Reasonix 1.x 这个本地 ACP CLI provider 切到 DeepSeek V4。重点其实也不在”接进来”，而是在 Reasonix 1.x 相比 0.x 那一刀的语义变化——启动参数被砍到只剩一个 -model，凭据和策略全搬到…
Electron 应用如何上架微软商店：从 MSIX 打包到商店提交
Electron 应用如何上架微软商店：从 MSIX 打包到商店提交 其实 Electron 说到底，不过是个普普通通的 Win32 桌面应用罢了，可微软商店它只认 MSIX。这篇文章，就借着我们 HagiCode Desktop 实打实跑通的那套构建配置，把「注册开发者账号 → 打 MSIX 包 → 提交商店」这条链路从头到尾拆给你看，顺便聊聊我们踩过的那些坑——毕竟坑踩过了，也就成了故事。 背景 手里有这么一个…
如何使用 Upptime 免费搭建自己的状态站点
如何使用 Upptime 免费搭建自己的状态站点 把监控这件事整个儿搬进 GitHub 仓库——Actions 当探针、仓库当数据库、Pages 当 CDN、Issues 当事件簿。零服务器，零月费，愣是凑出一个能看能查能留痕的状态站。说是黑魔法也好，说是穷人的智慧也罢，反正它跑起来了。 背景 运维一个由十几个对外服务凑起来的小型产品矩阵时,”到底通不通”这事常常变成了口头禅。客户反馈说访问不了，你 ssh 上去 curl…
Electron 如何调用 Windows 原生 API
Electron 如何调用 Windows 原生 API 在 Electron 应用里调用 Windows 原生 API，就像想看海却只能看地图。不过折腾了一阵，总算摸索出几条路，写下这篇文章算是留个纪念，也给后来者指个方向。 背景 做 Electron 桌面应用的时候，难免要和操作系统打打交道。在 Windows 上，这些需求说起来也不少： 调用 Microsoft Store API 搞应用内购买 处理 Microsoft…
Electron 桌面应用如何接入 Microsoft Store 订阅与永久许可证
Electron 桌面应用如何接入 Microsoft Store 订阅与永久许可证 当你的 Electron 应用要进 Microsoft Store 卖订阅和永久授权，WinRT 那一套商业 API 到底怎么干净地接到业务里？这事儿说起来也算一桩旧梦，我们在 HagiCode Desktop 里踩过坑、也擦过汗，最后摸索出这么一套分层方案，写下来，算是给后来的人留个路标。 背景 HagiCode Desktop 是个…
如何集成和使用 impeccable
如何集成和使用 impeccable 其实也没啥，就是在 HagiCode 项目里集成个设计工具，勉强算是个完整方案吧——包括仓库结构、多语言工作流、内容维护这些，都是在实践里慢慢摸索出来的。 背景 说起软件开发里的 UI/UX 设计质量，其实还挺重要的，毕竟能直接决定产品的用户体验和商业成功。只是传统开发流程里，设计师和开发者之间总有一道无形的墙：设计师画了精美的静态稿，开发者努力去实现，却总是在某些细节上有些偏差。这种割裂让最…
从零开始：如何将 Reasonix CLI 集成到 HagiCode 系统中
从零开始：如何将 Reasonix CLI 集成到 HagiCode 系统中 本文分享了将 Reasonix CLI 作为一等 Agent Provider 集成到 HagiCode 系统的完整技术实践，涵盖三层架构设计、关键技术决策和前后端实现细节。 背景 Reasonix CLI，说起来也是个挺有意思的东西。它是一个基于 ACP（Agent Communication Protocol）的 AI…
将 Pi Agent 接入 HagiCode 的实践之路
将 Pi Agent 接入 HagiCode 的实践之路 本文分享我们在 HagiCode 项目中将 Pi agent 作为一等工作流入口接入的实践经验，包括架构设计、核心组件实现和前后端适配细节。 背景 其实一切都要从那个问题说起：在 HagiCode Mono 项目中，虽然 repos/Hagicode.Libs 已经实现了可复用的 PiProvider，可是 repos/hagicode-core 和 repos/web…
Windows 应用自动上架 Microsoft Store 的自动化实践
复盘 Electron 应用自动上架 Microsoft Store 的完整流程，涵盖版本解析、构建打包、商店提交与自动化发布协调。
用户自定义配置管理最佳实践
用户自定义配置管理最佳实践 也没什么啦，就是分享一套配置管理的方案罢了。从架构到实践，怎么说呢，希望能帮你少踩点坑。 背景 配置管理这东西，说重要也重要，说琐碎也琐碎。就像生活里的那些小习惯——有人喜欢早起喝咖啡，有人喜欢熬夜撸代码，这些看似微不足道的偏好，其实都在悄悄定义着你是谁。用户自定义配置也是一样，主题切换、语言选择、快捷键定制，这些功能做好了，用户才会觉得这产品”懂他”，粘性自然就上来了。…
OpenCode 对接实践：从独立进程到共享 Runtime 的架构演进
OpenCode 对接实践：从独立进程到共享 Runtime 的架构演进 本文分享 HagiCode 集成 OpenCode AI 助手的完整实践，包括架构演进过程中的关键设计决策、遇到的坑以及最终解决方案。 背景 OpenCode 是一个开源的 AI 编码助手项目，托管在 GitHub 上。对于 HagiCode 这样的 monorepo 项目来说，将 OpenCode 集成为受支持的 AI…