- 博客(94)
- 收藏
- 关注
原创 如何用 last30days 来完成基于社交网络的 AI 调研需求
如何用 last30days 完成基于社交网络的 AI 调研需求 社交网络上每天都有人在表态:发帖、投票、争吵、退订、迁移。这些散落在 Reddit、X、YouTube 评论、TikTok、Hacker News、Polymarket...
2026-06-27 19:14:38
182
原创 让每个命令都能精准路由:HagiCode Preset Task 的多技能支持实战
让每个命令都能精准路由:HagiCode Preset Task 的多技能支持实战 一个 preset 里塞了多个命令,却只能共用一份技能要求?这次改造,让每条命令都能独立声明自己依赖的 skill,并在可视化面板上把这种绑定展示出来...
2026-06-23 19:50:07
165
原创 HagiCode 是怎么把 13 个 Agent CLI 接到一套系统里的
HagiCode 是怎么把 13 个 Agent CLI 接到一套系统里的 其实这事儿吧,说难也不难,说简单呢,又不简单。聊聊我们怎么用一套分层架构,把 Claude Code、Codex、Copilot、Gemini 这些风格各异的...
2026-06-22 20:06:27
220
原创 用 Orleans 搞定 AI 编程工作台的后台分布式难题
用 Orleans 搞定 AI 编程工作台的后台分布式难题 在一个进程里管十几种 AI CLI 工具、同时拖着几十个会话的实时流——听起来像在做梦?其实我们也觉得挺离谱的。但 Orleans 的 Virtual Actor 模型,还真...
2026-06-21 15:14:22
172
原创 MonoSpecs 是什么:为什么说它是对 OpenSpec 的进一步升级和扩展
MonoSpecs 是什么:为什么说它是对 OpenSpec 的进一步升级和扩展 当一个产品体系膨胀到 40+ 个独立 Git 仓库时,"规范"该放在哪里?这篇就聊聊 HagiCode 在多仓库治理上走过的两步棋:先把 OpenSpe...
2026-06-20 13:18:51
663
原创 HagiCode 中 AI 提交使用的提示词:设计思路与实现拆解
HagiCode 中 AI 提交使用的提示词:设计思路与实现拆解 当你把一堆乱七八糟的改动丢给 AI 让它帮你提交时,背后到底发了一段什么样的提示词给模型?为什么提示词要写成那个样子?这篇文章把 HagiCode 里真正驱动"AI 提...
2026-06-20 12:59:44
237
原创 对接 Reasonix 1.x 跑通 DeepSeek V4:ACP 模型选择器接入实战
对接 Reasonix 1.x 跑通 DeepSeek V4:ACP 模型选择器接入实战 本文聊聊在 HagiCode 里怎么把 Reasonix 1.x 这个本地 ACP CLI provider 切到 DeepSeek V4。重点...
2026-06-19 09:47:10
248
原创 Pi Agent 对接实现:消息解析、重试与取消
Pi Agent 对接实现:消息解析、重试与取消 接一个 CLI 形态的 AI agent,绕不开三件事:怎么把它私有的事件流翻译成稳定消息、失败之后到底谁负责重试、用户点取消时进程怎么干净地停。其实这三件事说穿了,不过是"分清职责"...
2026-06-19 09:29:16
148
原创 如何使用 Upptime 免费搭建自己的状态站点
如何使用 Upptime 免费搭建自己的状态站点 把监控这件事整个儿搬进 GitHub 仓库——Actions 当探针、仓库当数据库、Pages 当 CDN、Issues 当事件簿。零服务器,零月费,愣是凑出一个能看能查能留痕的状态站...
2026-06-18 13:30:52
197
原创 Electron 应用如何上架微软商店:从 MSIX 打包到商店提交
Electron 应用如何上架微软商店:从 MSIX 打包到商店提交 其实 Electron 说到底,不过是个普普通通的 Win32 桌面应用罢了,可微软商店它只认 MSIX。这篇文章,就借着我们 HagiCode Desktop 实...
2026-06-18 10:56:41
294
原创 Electron 如何调用 Windows 原生 API
Electron 如何调用 Windows 原生 API 在 Electron 应用里调用 Windows 原生 API,就像想看海却只能看地图。不过折腾了一阵,总算摸索出几条路,写下这篇文章算是留个纪念,也给后来者指个方向。 背景...
2026-06-17 11:35:45
531
原创 Electron 桌面应用如何接入 Microsoft Store 订阅与永久许可证
Electron 桌面应用如何接入 Microsoft Store 订阅与永久许可证 当你的 Electron 应用要进 Microsoft Store 卖订阅和永久授权,WinRT 那一套商业 API 到底怎么干净地接到业务里?这事...
2026-06-16 20:45:45
247
原创 如何集成和使用 impeccable
如何集成和使用 impeccable 其实也没啥,就是在 HagiCode 项目里集成个设计工具,勉强算是个完整方案吧——包括仓库结构、多语言工作流、内容维护这些,都是在实践里慢慢摸索出来的。 背景 说起软件开发里的 UI/UX 设计...
2026-06-10 10:47:57
200
原创 从零开始:如何将 Reasonix CLI 集成到 HagiCode 系统中
从零开始:如何将 Reasonix CLI 集成到 HagiCode 系统中 本文分享了将 Reasonix CLI 作为一等 Agent Provider 集成到 HagiCode 系统的完整技术实践,涵盖三层架构设计、关键技术决策...
2026-06-09 11:32:45
180
原创 OpenCode 对接实践:从独立进程到共享 Runtime 的架构演进
本文分享了HagiCode项目集成OpenCode AI助手的实践经验。从最初的独立进程架构演进为共享Runtime模式,解决了资源开销大的问题。文章详细介绍了五层技术架构设计,包括仓库集成、Provider层、Runtime管理等核心模块,并重点分析了三个关键设计决策:共享Runtime替代独立进程、自管端点解决400错误、灵活的会话绑定策略。实施方案部分提供了具体配置示例和代码片段,展示了如何通过Runtime协调器和错误恢复机制构建稳定可靠的AI服务集成方案。这些经验为类似项目提供了有价值的参考,体现
2026-05-11 12:17:59
411
原创 Steamworks 多语言元数据管理:从手动维护到结构化工作流
Steam多语言元数据管理方案 本文介绍了HagiCode项目开发的Steam平台多语言元数据管理系统,解决了传统手动维护方式的痛点。系统支持28种语言的商店内容管理,采用结构化设计: 数据模型:明确定义语言代码、字段类型和作用域(主应用/DLC) 文件结构:层次化Markdown存储,便于版本控制和团队协作 格式转换:自动将Markdown转为Steam要求的BBCode格式 导出规范:生成符合Steamworks API要求的JSON结构 该方案显著提升了多语言内容管理效率,支持从创作到发布的全流程自动
2026-05-09 17:07:59
256
原创 AI 成本效益的量化评估
AI 成本效益评估不是什么高深的东西,核心就是三笔账:企业用工成本、AI 使用成本、效率提升幅度。把这三笔账算清楚,投入产出比自然就出来了。这其实也跟生活中的很多事情一样,看似复杂,拆解开来看,也就那么回事。只是很少有人愿意静下心来算一算罢了。但这里面有个容易被忽略的点:多 Agent 架构能带来的乘数效应。单个 Agent 再强,也只能线性提效。但多个 Agent 并行工作,带来的产能提升是指数级的。这也是 HagiCode 选择多 Agent 架构的核心原因。
2026-05-09 10:31:16
432
原创 用不同的 Agent 优化 OpenSpec 各阶段效能:HagiCode 实践总结
摘要 HagiCode团队针对OpenSpec工作流中通用提示词的问题,开发了阶段特定的agent优化方案。该方案通过参数化模板系统和动态提示词加载,实现了不同开发阶段的差异化处理: 阶段划分:明确Explore(探索)、New(新建提案)、FF(快速生成)、Apply(应用变更)等阶段的特定需求 动态参数:通过PromptScenario枚举和FilePromptProvider实现运行时参数注入 规划方向:支持探索模式、变更地图、流程图等6种规划方向的可配置组合 内容约束:严格定义tasks.md等文档
2026-05-08 14:57:45
771
原创 桌面应用 P2P 分发加速实践:从消费端到发布端的全链路打通
桌面应用的大文件分发是个经典难题,P2P 技术提供了一种优雅的解决方案。降低分发成本:P2P 分担了服务器带宽压力,高峰期也能保持稳定的分发能力。这其实也算是个不错的收益,毕竟能省点带宽钱也是好的。提升用户体验:有 P2P 连接时下载速度显著提升,尤其是海外用户。没有 P2P 连接时也能通过 HTTP 正常下载,保证 100% 可用性。这其实也算是个不错的策略,毕竟用户体验才是最重要的。平滑演进路径:通过双投影索引设计,实现了服务端和客户端的独立升级。旧客户端不受影响,新客户端逐步启用 P2P 加速。
2026-05-08 09:40:00
765
4
原创 在聊天中实现图片上传与 AI 识别:从设计到落地的完整方案
文章摘要 本文详细介绍了HagiCode项目中实现的图片上传与AI识别完整方案。系统采用文件系统存储图片而非数据库,设计自定义协议hagiimag://进行引用标识,实现前后端分离的访问方式。架构包含前端附件管理、服务层上传处理和AI执行层识别三大模块,支持从用户上传到AI分析的全流程。方案亮点包括即时上传策略、多模态兼容处理和结构化消息传递,既保证了系统性能又提升了用户体验。该方案已在HagiCode开源项目中实践验证,为AI聊天系统处理视觉信息提供了可靠参考。
2026-05-07 15:02:41
430
原创 自定义 OpenSpec 步骤改进生成结果
本文记录了在HagiCode项目中使用OpenSpec管理技术提案时遇到的问题及解决方案。OpenSpec虽然能自动生成各种文档工件,但实际使用中发现生成质量不稳定,主要问题包括设计文档缺少可视化元素、提案文档缺少关键表格和原型图、任务文档职责边界模糊等。通过分析OpenSpec的提示词系统架构和规划方向机制,提出了三点改进方案:1)在提示词模板中添加明确的文档内容约束;2)为每个规划方向提供具体输出示例;3)使用规范语言明确不同文档类型的可视化要求。文章详细展示了如何在代码中实现这些改进,包括定义规划方向
2026-05-07 10:36:28
244
原创 如何用 Copilot CLI 统一对接 GPT、Claude 等多种 AI 模型
A:Copilot CLI 支持的工具是预定义的,但可以通过配置控制哪些工具可用。自定义工具需要等待 Copilot CLI 的后续更新。通过 Copilot CLI 统一对接多种 AI 模型,我们解决了 HagiCode 开发中的多模型支持难题。统一接口:一套代码支持 GPT、Claude 等多种模型会话管理:自动处理上下文保持和会话隔离工具集成:内置文件操作、Git 操作等常用工具流式响应:实时返回 AI 输出,提升用户体验安全可控:细粒度的权限控制和工具白名单。
2026-05-06 19:20:47
744
原创 如何使用 GitHub Actions 构建多平台的 code-server 与 OmniRoute
版本号集中管理:在流水线开始时生成统一的版本号,所有下游步骤共享构建与发布分离:使用确保某个平台失败不影响其他平台,发布阶段才汇总所有产物平台隔离构建脚本:每个包维护自己的构建逻辑,共享工具链保持包无关产物自动化验证:构建后立即验证可用性,避免发布后才发现问题这套方案不仅适用于 code-server 和 OmniRoute,也能为其他需要多平台构建的项目提供参考。本文分享的构建系统,正是我们在开发 HagiCode 过程中实际踩坑、实际优化出来的方案。
2026-05-06 14:11:43
420
原创 如何实现 Claude Code 和 Codex 等 Agent CLI 的自动重试
文章摘要: 本文探讨了在Claude Code、Codex等Agent CLI中实现自动重试的工程挑战与解决方案。不同于普通HTTP请求的重试机制,Agent CLI的流式执行特性带来了独特难题:如何处理已输出内容、维护会话上下文、判断错误类型是否值得重试。作者通过HagiCode项目的实践经验,提出分层设计思路:将重试逻辑从具体Provider中解耦,由统一协调器管理重试循环,同时采用策略快照化确保一致性。文章强调自动重试不是简单重复请求,而是需要综合考虑上下文连续性、错误分类和边界控制的全生命周期管理。
2026-04-18 17:09:06
259
原创 SQLite 分片方案实战:三种分片策略的深度对比
SQLite分片方案实战对比 本文分享了HagiCode项目中三种SQLite分片策略的实践经验,针对不同业务场景提供了轻量级解决方案: Session Message:256分片,GUID后两位16进制路由,适合高频写入场景 Orleans Grain:100分片,数字取模路由,为分布式框架优化 Hero History:10分片,ASCII取模路由,侧重迁移兼容性 核心设计原则包括确定性路由、透明访问和独立存储。三种方案在分片数量、路由算法和初始化策略上各有特点,但都采用WAL模式+busy_timeo
2026-04-17 13:49:29
446
原创 如何用 GitHub Actions 实现 Steam 自动化发布
这篇文章分享了HagiCode Desktop项目实现Steam自动化发布的完整方案。主要内容包括: 背景需求:项目需要将现有构建产物转换为Steam兼容格式,通过SteamCMD工具上传,并处理Steam Guard认证和多平台Depot上传。 架构设计:采用GitHub Actions工作流,分为准备阶段、SteamCMD设置和发布阶段三大模块,实现从GitHub Release到Steam的全链路自动化。 关键技术实现: 使用自托管运行器确保安全隔离 实现Steam Guard认证机制 自动生成VDF
2026-04-16 09:40:48
405
原创 如何利用廉价的云服务器搭建加速下载的分发站
云服务器 + Nginx 缓存层,就这么简单。HagiCode 用这套方案,成本不算高(服务器费用大概 60-100 元/月),效果还挺不错的。成本可控:比直接用云存储或商业 CDN,成本降了大概 50%部署灵活:Traefik 还是 Bunker Web,看你自己选扩展性强:需要的话可以水平扩展,或者再加个 CDN运维简单:Shell 脚本 + Ansible,自动化部署也方便对于需要文件分发的小团队和个人开发者来说,这方案倒是可以试试。
2026-04-15 11:00:53
410
原创 Hermes Agent 集成实践:从协议到生产
摘要: 本文分享了HagiCode项目集成Hermes Agent的实践经验。Hermes作为底层AI引擎,通过ACP协议实现本地与云端协同。架构采用分层设计,包括后端核心层(HermesCliProvider)、传输层(StdioAcpTransport)、运行时层(Orleans Grain)和前端适配层。核心实现中,统一接口抽象使Hermes与其他AI Provider平等共存,会话池机制保障多轮对话连贯性。ACP协议适配解决了基于标准I/O的动态认证、会话复用等挑战。该方案为AI辅助编码平台提供了可
2026-04-14 13:28:41
496
原创 VSCode 与 code-server:浏览器端代码编辑方案选型
本文对比了浏览器端代码编辑的两种方案:VSCode官方的code serve-web和社区驱动的code-server。重点分析了许可证差异(code-server采用MIT许可更友好)、部署方式(code-server容器化更简单)和功能参数区别。作者分享了HagiCode项目的实践经验,采用双架构设计默认优先code-server,同时支持两种方案以适应不同场景。文章提供了具体配置示例和部署建议,强调技术选型需综合考虑许可证合规性、部署灵活性和用户体验,避免后期迁移的高成本。
2026-04-13 10:00:04
251
原创 在浏览器中快速编辑代码:VSCode Web 集成实践
浏览器集成代码编辑器实践:HagiCode 的 VSCode Web 方案 HagiCode 项目通过集成 code-server 实现了 AI 代码分析与浏览器编辑的无缝衔接。该方案解决了远程开发、快速预览和跨设备协作三大痛点,让开发者能在 AI 分析后立即在浏览器中编辑代码。 技术实现亮点: 选用功能完整的 code-server 作为 Web 版 VSCode 采用前后端分离架构,通过 REST API 通信 实现自动运行时管理和语言跟随机制 支持 MonoSpecs 多仓库工作区 前端通过 Reac
2026-04-12 10:45:59
376
原创 边框灯光环绕动画特效实现指南
边框灯光环绕动画实现指南 本文分享了四种实现边框灯光环绕动画的CSS方案,源自HagiCode项目实践经验。核心方案包括: Conic Gradient旋转光晕 - 最完整的环绕效果,通过圆锥渐变和旋转动画实现 简化版旋转光边框 - 轻量级工具类实现 侧边发光线条 - 适用于列表项状态指示 React组件封装 - 便于复用并支持无障碍访问 每种方案都考虑了性能优化和无障碍支持,适用于不同场景的状态指示和视觉焦点需求。文章提供了详细代码示例和实现思路,帮助开发者快速实现专业级的边框动画效果。
2026-04-11 10:47:45
371
原创 用 Vault 系统构建 AI 时代的跨项目知识库
本文介绍了HagiCode项目的Vault系统设计,旨在解决AI时代学习资源分散、上下文断裂的问题。该系统通过统一的存储抽象层,支持四种资源类型(包括专门用于代码学习的coderef类型),采用JSON文件存储和并发控制机制,实现AI对学习资源的智能访问。系统提供标准化目录结构、访问控制(只读/可编辑)和路径安全校验,支持代码仓库、笔记文档等资源的统一管理,使AI能跨项目复用知识,提升学习效率。典型应用场景包括系统化学习开源项目、复用Obsidian笔记库等。
2026-04-10 10:32:01
286
原创 在 Web 界面直接编辑 DESIGN.md:从思路到实现
摘要 本文介绍了在HagiCode项目中实现的Web界面直接编辑DESIGN.md方案,解决了传统编辑方式流程割裂、复用困难等问题。采用前后端分离架构,通过全局抽屉模式提供一致体验,利用项目作用域API简化权限管理,并实现轻量级版本冲突检测。核心功能包括:1)在线编辑DESIGN.md,支持脏状态检测和乐观并发控制;2)从设计站点安全导入模板,通过同源代理避免跨域风险。该方案显著提升了设计文档的维护效率和团队协作体验,使开发流程更加连贯高效。
2026-04-09 09:22:22
526
原创 Design.md:让 AI 一致性进行前端 UI 设计的解决方案
HagiCode 在开发过程中遇到的 AI 生成 UI 不一致问题,本质上是缺少结构化的设计参考文档。通过构建设计画廊站点和创建规范化的 design.md,我们成功解决了这个问题。统一资源:整合分散的设计系统文档结构化规范:将设计规范以 AI 可理解的形式呈现持续维护:通过 git submodule 保持内容更新如果你也在使用 AI 辅助前端开发,建议尝试一下这个方案。创建一份结构化的 design.md,不仅能提升 AI 生成代码的一致性,也能帮助团队内部保持设计规范的统一。
2026-04-08 10:32:42
663
原创 为什么使用 Skillsbase 维护自己的 Skills 收藏仓库
在AI编程时代,开发者面临管理大量Agent Skills的挑战,包括技能分散存储、缺乏标准化流程和可复现性问题。HagiCode团队开发的skillsbase解决方案通过本地安装→转换→卸载的工作流,实现了技能仓库的规范化管理。该工具提供init、add、sync等核心命令,采用YAML配置和命名空间策略,确保技能来源可追溯且与实际安装结果一致。skillsbase支持自动化CI/CD集成,解决了技能管理中的命名冲突、环境污染等痛点,为开发者提供了一套高效可靠的技能维护方案。
2026-04-07 09:52:51
222
原创 AI时代如何临摹项目:Vault跨项目持久化存储系统
摘要:HagiCode项目开发的Vault系统通过统一存储抽象层解决了AI时代临摹项目学习中的知识管理问题。该系统支持文件夹、代码参考、Obsidian笔记和系统管理四种存储类型,其中专为代码学习设计的"coderef"类型采用标准化目录结构(包括元数据文件、文档目录和Git子模块管理)。系统通过JSON持久化存储配置,自动将资源信息注入AI上下文,并实现访问控制机制,让AI助手能直接理解用户的学习资源,无需手动提供背景信息,显著提升了学习效率。
2026-04-06 09:48:43
232
原创 渐进式披露:如何用少即是多的理念改进 AI 产品的人机交互
不要一次性把所有信息和选项都展示给用户,而是根据用户的操作和需求,逐步展示必要的内容。这个原则特别适合 AI 产品,因为 AI 交互天然就是渐进式的——用户说一点,AI 理解一点,然后补充一点,再理解更多。就像人与人之间的交流一样,总得慢慢来,毕竟谁也不能一见面就把心掏出来不是?分步引导:把复杂任务拆成小步,每步只请求必要信息智能补全:利用历史上下文和项目知识自动补全信息即时反馈:每个操作都有清晰的视觉反馈和状态提示容错机制:允许用户撤销、重置,避免错误造成不可逆损失输入多样化。
2026-04-05 14:24:30
413
原创 AI 输出 Token 优化:文言文极简模式的实践
语义压缩:相同含义可以用更少的字符表达去除冗余:文言文本身就省略了很多现代汉语中的连接词和助词结构简洁:单句信息密度高,适合作为 AI 输出的载体以一个实际例子来说明:根据你的代码分析,我发现了几个问题。首先,在第 23 行,变量名太长了,建议缩短一些。其次,在第 45 行,你没有处理空值的情况,应该加上判断逻辑。最后,整体的代码结构还可以,但是可以进一步优化。代码审阅毕:第 23 行变量名冗长,宜缩写;第 45 行缺空值处理,应加判断。整体结构尚可,微调即可。这差距,想想也挺有意思的。
2026-04-04 10:26:36
704
原创 从 CLI 调用到 SDK 集成:GitHub Copilot 在 .NET 项目中的最佳实践
稳定性提升:SDK 提供了更稳定的接口,不受 CLI 版本变化影响——不用天天担心版本更新了功能完整性:能够捕获完整的事件流,包括推理过程和工具执行状态——过程和结果都能看到开发效率:类型安全的 SDK 接口让开发更高效,减少运行时错误——有类型检查,心里踏实用户体验:实时的事件反馈让用户更清晰地了解 AI 的工作过程——知道它在想什么,总比一无所知强这次升级不仅仅是技术方案的替换,更是对整个 AI 能力层架构的优化。
2026-04-03 09:55:43
292
原创 AI 编程助手的幻觉问题:如何用 OpenSpec 实现规范驱动开发
AI 编程助手在生成代码时常常产生不符合实际需求的"幻觉"问题。本文介绍了 HagiCode 项目通过 OpenSpec 规范驱动开发流程解决这一难题的创新方案。该方案采用结构化三步流程(初始化提案→中间处理→完成提案),配合标准化的文件结构和多层验证机制,显著减少了 AI 生成代码的随意性。实践表明,通过让 AI 先撰写详细的提案文档和技术规范,再基于这些约束生成代码,可以大幅提升代码质量与项目一致性。文章还分享了具体实施步骤和最佳实践,为开发者提供了可落地的解决方案。
2026-04-02 09:50:07
626
空空如也
空空如也
TA创建的收藏夹 TA关注的收藏夹
TA关注的人
RSS订阅