newbe36524-CSDN博客

原创 Steamworks 多语言元数据管理：从手动维护到结构化工作流

Steam多语言元数据管理方案本文介绍了HagiCode项目开发的Steam平台多语言元数据管理系统，解决了传统手动维护方式的痛点。系统支持28种语言的商店内容管理，采用结构化设计：数据模型：明确定义语言代码、字段类型和作用域（主应用/DLC）文件结构：层次化Markdown存储，便于版本控制和团队协作格式转换：自动将Markdown转为Steam要求的BBCode格式导出规范：生成符合Steamworks API要求的JSON结构该方案显著提升了多语言内容管理效率，支持从创作到发布的全流程自动

2026-05-09 17:07:59 223

原创 AI 成本效益的量化评估

AI 成本效益评估不是什么高深的东西，核心就是三笔账：企业用工成本、AI 使用成本、效率提升幅度。把这三笔账算清楚，投入产出比自然就出来了。这其实也跟生活中的很多事情一样，看似复杂，拆解开来看，也就那么回事。只是很少有人愿意静下心来算一算罢了。但这里面有个容易被忽略的点：多 Agent 架构能带来的乘数效应。单个 Agent 再强，也只能线性提效。但多个 Agent 并行工作，带来的产能提升是指数级的。这也是 HagiCode 选择多 Agent 架构的核心原因。

2026-05-09 10:31:16 348

原创用不同的 Agent 优化 OpenSpec 各阶段效能：HagiCode 实践总结

摘要 HagiCode团队针对OpenSpec工作流中通用提示词的问题，开发了阶段特定的agent优化方案。该方案通过参数化模板系统和动态提示词加载，实现了不同开发阶段的差异化处理：阶段划分：明确Explore（探索）、New（新建提案）、FF（快速生成）、Apply（应用变更）等阶段的特定需求动态参数：通过PromptScenario枚举和FilePromptProvider实现运行时参数注入规划方向：支持探索模式、变更地图、流程图等6种规划方向的可配置组合内容约束：严格定义tasks.md等文档

2026-05-08 14:57:45 702

原创桌面应用 P2P 分发加速实践：从消费端到发布端的全链路打通

桌面应用的大文件分发是个经典难题，P2P 技术提供了一种优雅的解决方案。降低分发成本：P2P 分担了服务器带宽压力，高峰期也能保持稳定的分发能力。这其实也算是个不错的收益，毕竟能省点带宽钱也是好的。提升用户体验：有 P2P 连接时下载速度显著提升，尤其是海外用户。没有 P2P 连接时也能通过 HTTP 正常下载，保证 100% 可用性。这其实也算是个不错的策略，毕竟用户体验才是最重要的。平滑演进路径：通过双投影索引设计，实现了服务端和客户端的独立升级。旧客户端不受影响，新客户端逐步启用 P2P 加速。

2026-05-08 09:40:00 520 2

原创在聊天中实现图片上传与 AI 识别：从设计到落地的完整方案

文章摘要本文详细介绍了HagiCode项目中实现的图片上传与AI识别完整方案。系统采用文件系统存储图片而非数据库，设计自定义协议hagiimag://进行引用标识，实现前后端分离的访问方式。架构包含前端附件管理、服务层上传处理和AI执行层识别三大模块，支持从用户上传到AI分析的全流程。方案亮点包括即时上传策略、多模态兼容处理和结构化消息传递，既保证了系统性能又提升了用户体验。该方案已在HagiCode开源项目中实践验证，为AI聊天系统处理视觉信息提供了可靠参考。

2026-05-07 15:02:41 376

原创自定义 OpenSpec 步骤改进生成结果

本文记录了在HagiCode项目中使用OpenSpec管理技术提案时遇到的问题及解决方案。OpenSpec虽然能自动生成各种文档工件，但实际使用中发现生成质量不稳定，主要问题包括设计文档缺少可视化元素、提案文档缺少关键表格和原型图、任务文档职责边界模糊等。通过分析OpenSpec的提示词系统架构和规划方向机制，提出了三点改进方案：1)在提示词模板中添加明确的文档内容约束；2)为每个规划方向提供具体输出示例；3)使用规范语言明确不同文档类型的可视化要求。文章详细展示了如何在代码中实现这些改进，包括定义规划方向

2026-05-07 10:36:28 178

原创如何用 Copilot CLI 统一对接 GPT、Claude 等多种 AI 模型

A：Copilot CLI 支持的工具是预定义的，但可以通过配置控制哪些工具可用。自定义工具需要等待 Copilot CLI 的后续更新。通过 Copilot CLI 统一对接多种 AI 模型，我们解决了 HagiCode 开发中的多模型支持难题。统一接口：一套代码支持 GPT、Claude 等多种模型会话管理：自动处理上下文保持和会话隔离工具集成：内置文件操作、Git 操作等常用工具流式响应：实时返回 AI 输出，提升用户体验安全可控：细粒度的权限控制和工具白名单。

2026-05-06 19:20:47 638

原创如何使用 GitHub Actions 构建多平台的 code-server 与 OmniRoute

版本号集中管理：在流水线开始时生成统一的版本号，所有下游步骤共享构建与发布分离：使用确保某个平台失败不影响其他平台，发布阶段才汇总所有产物平台隔离构建脚本：每个包维护自己的构建逻辑，共享工具链保持包无关产物自动化验证：构建后立即验证可用性，避免发布后才发现问题这套方案不仅适用于 code-server 和 OmniRoute，也能为其他需要多平台构建的项目提供参考。本文分享的构建系统，正是我们在开发 HagiCode 过程中实际踩坑、实际优化出来的方案。

2026-05-06 14:11:43 366

原创如何实现 Claude Code 和 Codex 等 Agent CLI 的自动重试

文章摘要：本文探讨了在Claude Code、Codex等Agent CLI中实现自动重试的工程挑战与解决方案。不同于普通HTTP请求的重试机制，Agent CLI的流式执行特性带来了独特难题：如何处理已输出内容、维护会话上下文、判断错误类型是否值得重试。作者通过HagiCode项目的实践经验，提出分层设计思路：将重试逻辑从具体Provider中解耦，由统一协调器管理重试循环，同时采用策略快照化确保一致性。文章强调自动重试不是简单重复请求，而是需要综合考虑上下文连续性、错误分类和边界控制的全生命周期管理。

2026-04-18 17:09:06 204

原创 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 432

原创如何用 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 382

原创如何利用廉价的云服务器搭建加速下载的分发站

云服务器 + Nginx 缓存层，就这么简单。HagiCode 用这套方案，成本不算高（服务器费用大概 60-100 元/月），效果还挺不错的。成本可控：比直接用云存储或商业 CDN，成本降了大概 50%部署灵活：Traefik 还是 Bunker Web，看你自己选扩展性强：需要的话可以水平扩展，或者再加个 CDN运维简单：Shell 脚本 + Ansible，自动化部署也方便对于需要文件分发的小团队和个人开发者来说，这方案倒是可以试试。

2026-04-15 11:00:53 398

原创 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 420

原创 VSCode 与 code-server：浏览器端代码编辑方案选型

本文对比了浏览器端代码编辑的两种方案：VSCode官方的code serve-web和社区驱动的code-server。重点分析了许可证差异（code-server采用MIT许可更友好）、部署方式（code-server容器化更简单）和功能参数区别。作者分享了HagiCode项目的实践经验，采用双架构设计默认优先code-server，同时支持两种方案以适应不同场景。文章提供了具体配置示例和部署建议，强调技术选型需综合考虑许可证合规性、部署灵活性和用户体验，避免后期迁移的高成本。

2026-04-13 10:00:04 236

原创在浏览器中快速编辑代码：VSCode Web 集成实践

浏览器集成代码编辑器实践：HagiCode 的 VSCode Web 方案 HagiCode 项目通过集成 code-server 实现了 AI 代码分析与浏览器编辑的无缝衔接。该方案解决了远程开发、快速预览和跨设备协作三大痛点，让开发者能在 AI 分析后立即在浏览器中编辑代码。技术实现亮点：选用功能完整的 code-server 作为 Web 版 VSCode 采用前后端分离架构，通过 REST API 通信实现自动运行时管理和语言跟随机制支持 MonoSpecs 多仓库工作区前端通过 Reac

2026-04-12 10:45:59 359

原创边框灯光环绕动画特效实现指南

边框灯光环绕动画实现指南本文分享了四种实现边框灯光环绕动画的CSS方案，源自HagiCode项目实践经验。核心方案包括： Conic Gradient旋转光晕 - 最完整的环绕效果，通过圆锥渐变和旋转动画实现简化版旋转光边框 - 轻量级工具类实现侧边发光线条 - 适用于列表项状态指示 React组件封装 - 便于复用并支持无障碍访问每种方案都考虑了性能优化和无障碍支持，适用于不同场景的状态指示和视觉焦点需求。文章提供了详细代码示例和实现思路，帮助开发者快速实现专业级的边框动画效果。

2026-04-11 10:47:45 354

原创用 Vault 系统构建 AI 时代的跨项目知识库

本文介绍了HagiCode项目的Vault系统设计，旨在解决AI时代学习资源分散、上下文断裂的问题。该系统通过统一的存储抽象层，支持四种资源类型（包括专门用于代码学习的coderef类型），采用JSON文件存储和并发控制机制，实现AI对学习资源的智能访问。系统提供标准化目录结构、访问控制（只读/可编辑）和路径安全校验，支持代码仓库、笔记文档等资源的统一管理，使AI能跨项目复用知识，提升学习效率。典型应用场景包括系统化学习开源项目、复用Obsidian笔记库等。

2026-04-10 10:32:01 254

原创在 Web 界面直接编辑 DESIGN.md：从思路到实现

摘要本文介绍了在HagiCode项目中实现的Web界面直接编辑DESIGN.md方案，解决了传统编辑方式流程割裂、复用困难等问题。采用前后端分离架构，通过全局抽屉模式提供一致体验，利用项目作用域API简化权限管理，并实现轻量级版本冲突检测。核心功能包括：1)在线编辑DESIGN.md，支持脏状态检测和乐观并发控制；2)从设计站点安全导入模板，通过同源代理避免跨域风险。该方案显著提升了设计文档的维护效率和团队协作体验，使开发流程更加连贯高效。

2026-04-09 09:22:22 491

原创 Design.md：让 AI 一致性进行前端 UI 设计的解决方案

HagiCode 在开发过程中遇到的 AI 生成 UI 不一致问题，本质上是缺少结构化的设计参考文档。通过构建设计画廊站点和创建规范化的 design.md，我们成功解决了这个问题。统一资源：整合分散的设计系统文档结构化规范：将设计规范以 AI 可理解的形式呈现持续维护：通过 git submodule 保持内容更新如果你也在使用 AI 辅助前端开发，建议尝试一下这个方案。创建一份结构化的 design.md，不仅能提升 AI 生成代码的一致性，也能帮助团队内部保持设计规范的统一。

2026-04-08 10:32:42 554

原创为什么使用 Skillsbase 维护自己的 Skills 收藏仓库

在AI编程时代，开发者面临管理大量Agent Skills的挑战，包括技能分散存储、缺乏标准化流程和可复现性问题。HagiCode团队开发的skillsbase解决方案通过本地安装→转换→卸载的工作流，实现了技能仓库的规范化管理。该工具提供init、add、sync等核心命令，采用YAML配置和命名空间策略，确保技能来源可追溯且与实际安装结果一致。skillsbase支持自动化CI/CD集成，解决了技能管理中的命名冲突、环境污染等痛点，为开发者提供了一套高效可靠的技能维护方案。

2026-04-07 09:52:51 197

原创 AI时代如何临摹项目：Vault跨项目持久化存储系统

摘要：HagiCode项目开发的Vault系统通过统一存储抽象层解决了AI时代临摹项目学习中的知识管理问题。该系统支持文件夹、代码参考、Obsidian笔记和系统管理四种存储类型，其中专为代码学习设计的"coderef"类型采用标准化目录结构（包括元数据文件、文档目录和Git子模块管理）。系统通过JSON持久化存储配置，自动将资源信息注入AI上下文，并实现访问控制机制，让AI助手能直接理解用户的学习资源，无需手动提供背景信息，显著提升了学习效率。

2026-04-06 09:48:43 216

原创渐进式披露：如何用少即是多的理念改进 AI 产品的人机交互

不要一次性把所有信息和选项都展示给用户，而是根据用户的操作和需求，逐步展示必要的内容。这个原则特别适合 AI 产品，因为 AI 交互天然就是渐进式的——用户说一点，AI 理解一点，然后补充一点，再理解更多。就像人与人之间的交流一样，总得慢慢来，毕竟谁也不能一见面就把心掏出来不是？分步引导：把复杂任务拆成小步，每步只请求必要信息智能补全：利用历史上下文和项目知识自动补全信息即时反馈：每个操作都有清晰的视觉反馈和状态提示容错机制：允许用户撤销、重置，避免错误造成不可逆损失输入多样化。

2026-04-05 14:24:30 382

原创 AI 输出 Token 优化：文言文极简模式的实践

语义压缩：相同含义可以用更少的字符表达去除冗余：文言文本身就省略了很多现代汉语中的连接词和助词结构简洁：单句信息密度高，适合作为 AI 输出的载体以一个实际例子来说明：根据你的代码分析，我发现了几个问题。首先，在第 23 行，变量名太长了，建议缩短一些。其次，在第 45 行，你没有处理空值的情况，应该加上判断逻辑。最后，整体的代码结构还可以，但是可以进一步优化。代码审阅毕：第 23 行变量名冗长，宜缩写；第 45 行缺空值处理，应加判断。整体结构尚可，微调即可。这差距，想想也挺有意思的。

2026-04-04 10:26:36 663

原创从 CLI 调用到 SDK 集成：GitHub Copilot 在 .NET 项目中的最佳实践

稳定性提升：SDK 提供了更稳定的接口，不受 CLI 版本变化影响——不用天天担心版本更新了功能完整性：能够捕获完整的事件流，包括推理过程和工具执行状态——过程和结果都能看到开发效率：类型安全的 SDK 接口让开发更高效，减少运行时错误——有类型检查，心里踏实用户体验：实时的事件反馈让用户更清晰地了解 AI 的工作过程——知道它在想什么，总比一无所知强这次升级不仅仅是技术方案的替换，更是对整个 AI 能力层架构的优化。

2026-04-03 09:55:43 273

原创 AI 编程助手的幻觉问题：如何用 OpenSpec 实现规范驱动开发

AI 编程助手在生成代码时常常产生不符合实际需求的"幻觉"问题。本文介绍了 HagiCode 项目通过 OpenSpec 规范驱动开发流程解决这一难题的创新方案。该方案采用结构化三步流程（初始化提案→中间处理→完成提案），配合标准化的文件结构和多层验证机制，显著减少了 AI 生成代码的随意性。实践表明，通过让 AI 先撰写详细的提案文档和技术规范，再基于这些约束生成代码，可以大幅提升代码质量与项目一致性。文章还分享了具体实施步骤和最佳实践，为开发者提供了可落地的解决方案。

2026-04-02 09:50:07 594

原创在 React 项目中优雅实现新用户引导：HagiCode 的 driver.js 实践

本文分享了HagiCode项目中使用driver.js实现新用户引导的技术实践。通过轻量级的driver.js库，结合React生态，实现了包括会话引导（10步）和提案详情引导（3步）两条核心路径。技术方案采用动态导入优化性能，使用localStorage管理引导状态，并通过CSS选择器精准定位引导元素。重点解决了引导流程设计、状态持久化和元素动态渲染等关键问题，帮助新用户快速上手AI代码助手的工作流程。该方案具有API简洁、配置灵活、不影响主流程等特点，为React项目中的用户引导提供了实用参考。

2026-04-01 14:14:04 427

原创打字不如说话，说话不如截图——AI 代码助手的多模态输入实践

本文介绍了HagiCode项目中实现AI代码助手多模态输入的实践经验。针对传统纯文本交互的局限性，团队开发了语音识别和图片上传功能，使开发者能够通过更自然的方式与AI助手交互。语音识别采用后端WebSocket代理架构解决浏览器API限制问题，确保安全性的同时实现流畅的语音转文本功能。图片上传组件支持点击、拖拽和粘贴三种方式，并包含完善的前后端验证机制。这些改进显著提升了开发效率，让用户可以通过最适合的方式表达需求，体现了AI工具应具备的灵活性和人性化特点。

2026-03-31 09:32:49 172

原创 GLM-5.1 全面支持与 Gemini CLI 集成：HagiCode 的多模型进化之路

HagiCode平台近期迎来两大重要更新：全面支持智谱AI GLM-5.1模型和集成Gemini CLI作为第十个Agent CLI。GLM-5.1是首个支持图片输入的GLM模型，显著提升了代码理解和推理能力。平台采用统一的多CLI架构设计，通过HagiCode.Libs.Providers实现灵活扩展，目前已支持包括Gemini在内的10种CLI工具。图片上传功能让用户可直接截图与AI交互，大幅提升问题描述效率。这些更新进一步强化了HagiCode作为多模型AI编程平台的优势，为开发者提供更强大的辅助工具

2026-03-30 09:43:29 461

原创 GLM 提前过五一

Hagicode 项目通过抽象层整合了多种AI编程CLI工具（如Claude Code CLI、GitHub Copilot等），并支持国产GLM系列模型。最新GLM-5.1模型相比GLM-5.0有显著改进，在Hagicode中被定义为独立新模型，支持"claude"、"codebuddy"等多个CLI家族。系统通过枚举定义11种CLI提供商类型，并配置了模型参数支持。智谱AI作为主要提供商，提供完整的GLM模型支持，包括模型映射和实验性功能。用户可通过不同方式在各C

2026-03-28 10:21:11 549

原创 HagiCode Desktop 混合分发架构解析：如何用 P2P 加速大文件下载

HagiCode Desktop混合分发架构解析 HagiCode Desktop项目采用创新的"P2P优先，HTTP回源"混合分发方案解决大文件下载难题。该架构通过分层设计实现：智能策略评估：自动判断何时启用P2P加速（仅限≥100MB文件，且具备完整元数据）双轨下载机制：优先使用WebTorrent进行P2P加速，失败时自动回退HTTP下载缓存管理：智能控制本地缓存大小和保留时长完整性校验：通过SHA256确保下载文件安全可靠方案在保持原有index.json控制面的基础上

2026-03-27 10:35:02 286

原创 Docker 容器中运行 AI CLI 工具：用户隔离与持久化卷实战指南

本文探讨了在Docker容器中安全运行AI CLI工具(如Claude Code、Codex、OpenCode)的解决方案。通过HagiCode项目的实践经验，作者分享了处理三大核心挑战的技术方案：1)创建专用用户解决root运行限制，支持动态UID/GID映射；2)设计命名卷实现配置持久化；3)采用固定版本+运行时覆盖的版本管理策略。文章还提供了权限匹配、自动配置注入等最佳实践，帮助开发者避免常见陷阱。这些方案平衡了安全性、持久性和灵活性，为容器化AI工具部署提供了实用参考。

2026-03-26 09:47:33 377

原创 HagiCode Soul 平台技术解析：从需求萌发到独立平台的演进之路

HagiCode Soul平台技术解析：从内嵌配置到独立平台的演进之路本文详细介绍了HagiCode项目中Soul（AI Agent人格配置系统）的技术演进过程。最初作为Hero工作区模块存在，Soul解决了Agent语言风格一致性和复用性问题。随着功能丰富，系统经历了站内Marketplace阶段，引入50组基础角色与10种表达规则的组合设计。最终升级为独立平台，采用Builder-first设计理念和现代技术栈(Vite 8 + React 19 + TypeScript 5.9)。核心技术包括本地优

2026-03-25 09:24:28 423

原创 HagiCode Skill 系统技术解析：如何打造可扩展的 AI 技能管理平台

摘要 HagiCode项目开发了一套可扩展的AI技能(Skill)管理系统，用于扩展AI代码助手的能力边界。系统采用前后端分离架构，包含四大核心功能：本地全局管理、市场搜索、智能推荐和授信提供者管理。技术实现上，前端使用React+Redux，后端基于ASP.NET Core+Orleans框架，通过封装npm/npx命令实现技能管理。系统亮点包括：安装流程的规范化处理和锁机制、市场搜索的缓存优化、基于项目上下文的智能推荐流程等。该方案为AI能力扩展提供了工程化实践参考，已在HagiCode开源项目中应用。

2026-03-24 09:58:19 383

原创我好像会被 Agent 淘汰，我用数据算了一算

摘要： HagiCode团队开发了一套AI人效计算模型，通过6个核心公式量化知识工作者在AI时代的竞争力风险。该模型从企业成本效益角度出发，计算年度用工成本、AI工具成本与效率提升的平衡点，提出"等效人力"概念：只有当企业能负担员工AI使用成本时，效率提升才有实际价值。评估体系包含成本效益比和风险等级划分，并设计了7种游戏化称号增加趣味性。该系统基于主流AI服务的实时定价数据，帮助用户客观评估自身岗位的AI替代风险。

2026-03-23 08:31:55 391

原创 Hagicode.Libs：统一集成多个 AI 编程助手 CLI 的工程实践

本文介绍了HagiCode.Libs库的开发实践，旨在解决集成多个AI编程助手CLI时的工程痛点。通过分析不同CLI工具的共同特征，作者团队构建了一个轻量级的.NET库，提供统一抽象层封装跨平台兼容性、流式输出解析等功能。该库采用模块化设计，支持依赖注入和直接实例化两种使用方式，并配备专用测试控制台和跨平台CI/CD验证流程。HagiCode.Libs实现了对Claude Code、Codex、CodeBuddy等主流AI编程助手的标准化集成，显著降低了多项目维护成本。

2026-03-20 10:45:40 412

原创 HagiCode 为什么选择 Hermes 作为综合 Agent 核心

Hermes Agent 是由创建的自主 AI Agent。可能有人对 Nous Research 不熟悉——他们就是开发了 Hermes、Nomos 和 Psyché 等开源大模型的实验室。说起来他们也挺不容易的，做了这么多好东西，知道的人却不多。跟传统的 IDE 编程助手或者简单的 API 聊天包装器不同，Hermes 有一个特点：运行时间越长，能力越强。它不是一次性完成任务就完事，而是能在长时间运行中持续学习和积累经验。这点也挺像人的，是不是？

2026-03-19 09:36:06 490

原创 .NET 代码保护实战：从混淆到虚拟机保护

摘要本文介绍了.NET项目中的多层级代码保护策略，从基础混淆到专业虚拟机保护(VMP)的完整方案。以开源项目HagiCode为例，展示了三种主要保护方法：内置混淆属性：使用System.Reflection的ObfuscationAttribute进行基础保护，无需额外依赖但安全性有限。 VMP保护：通过虚拟机指令转换实现高级保护，支持不同保护级别(HIGH/MEDIUM/LOW)，使用自定义属性标记关键代码。构建集成：将保护流程自动化集成到构建系统，支持Windows原生和Linux容器模式。文章

2026-03-18 14:24:18 339

空空如也

空空如也