[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-hofstadter-io--hof":3,"tool-hofstadter-io--hof":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",150037,2,"2026-04-10T23:33:47",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":73,"owner_avatar_url":74,"owner_bio":75,"owner_company":76,"owner_location":76,"owner_email":76,"owner_twitter":77,"owner_website":78,"owner_url":79,"languages":80,"stars":119,"forks":120,"last_commit_at":121,"license":122,"difficulty_score":32,"env_os":123,"env_gpu":124,"env_ram":124,"env_deps":125,"category_tags":129,"github_topics":130,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":143,"updated_at":144,"faqs":145,"releases":176},4927,"hofstadter-io\u002Fhof","hof","A developer experience centered on CUE. Unifies schemas, data models, deterministic and agentic code generation, workflow and task engine, dagger powered environments, coding assistant, and vscode extension; woven together on the CUE lattice. Squint harder if you can't see the cube :]","hof 是一款以提升开发者体验为核心的开源框架，基于 CUE 语言构建。它旨在解决软件开发中数据模型、架构定义、代码生成与工作流管理分散割裂的痛点，通过统一的“单一事实来源”将这些环节紧密串联。\n\n对于需要处理复杂系统架构、微服务编排或自动化基础设施的后端工程师、平台工程师及 DevOps 专家而言，hof 提供了强大的支持。其独特之处在于利用 CUE 语言的声明式特性，实现了确定性且具备智能代理（Agentic）能力的代码生成——这意味着不仅能从数据模型自动生成任意技术的代码，还能结合大语言模型（LLM）进行更高效的协作开发。此外，hof 内置了基于有向无环图（DAG）的任务引擎，支持灵活的工作流编排，并提供了命令行（CLI）与终端界面（TUI）两种交互方式，既适合脚本自动化，也便于直观地探索和设计系统。无论是初始化新项目、管理模块依赖，还是持续演进数据架构，hof 都能帮助团队在保持严谨性的同时显著提升研发效率。","# hof - the higher order framework\n\nA tool that unifies data models, schemas, code generation, and a task engine.\n\n__`hof` is a CLI tool you *add* to your workflow.__\n\n- Foundation in CUE\n- Deterministic and Agentic code generation\n- Data models that can evolve and be input to code generation\n- Task engine based on cue\u002Fflow\n- Agent servers and VS Code extension\n\n| Core Features | |\n|:--- |:-- |\n| __code generation__ | Data + templates = _ (anything), technology agnostic |\n| __data modeling__ | Define, checkpoint, and diff data models |\n| __task engine__ | Extensible task and DAG workflow engine |\n| __CUE cmds__ | Core def, eval, export, and vet commands |\n| __creators__ | bootstraping and starter kits from any repo |\n| __modules__ | CUE module dependency management |\n| __tui__ | A terminal interface to Hof and CUE |\n| __chat__ | Combine LLM and Hof code gen for better, scalable results |\n\n\u003Cbr>\n\n`hof` uses [CUE](https:\u002F\u002Fcuelang.org) to power the DX and implementation.\nWe believe CUE is a great language for specifying schemas, configuration, and generally\nfor writing anything declarative or this is a source of truth.\nIt has good theory and comes from the same people that brought us containers, Go, and Kubernetes.\n\n\u003C!-- something about osurce of thuth, unified abstraction later, interoperablility... -->\n\nLearn more about CUE: [cuelang.org](https:\u002F\u002Fcuelang.org) | [cuetorials.com](https:\u002F\u002Fcuetorials.com)\n\n\n## Documentation\n\nPlease see __[docs.hofstadter.io](https:\u002F\u002Fdocs.hofstadter.io)__ to learn more.\n\nThe [getting-started](https:\u002F\u002Fdocs.hofstadter.io\u002Fgetting-started\u002F) section will take you on a tour of hof.\nThe [the-walkthrough](https:\u002F\u002Fdocs.hofstadter.io\u002Fthe-walkthrough\u002F) section shows you how to build and use a generator.\n\nJoin us or ask questions on\n\n- Discord (preferred): https:\u002F\u002Fdiscord.com\u002Finvite\u002FBXwX7n6B8w\n- Slack: [https:\u002F\u002Fhofstadter-io.slack.com](https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fhofstadter-io\u002Fshared_invite\u002Fzt-e5f90lmq-u695eJur0zE~AG~njNlT1A)\n\nWe also use GitHub issues and discussions. Use which every is easiest for you!\n\n\n## Installation\n\nYou can find [the latest downloads on our GitHub releases page](https:\u002F\u002Fgithub.com\u002Fhofstadter.io\u002Fhof\u002Freleases).\nThis is the preferred method.\n\nIf you already have hof, install a specific version with `hof update --version vX.Y.Z`.\n\n```shell\n# Homebrew\nbrew install hofstadter-io\u002Ftap\u002Fhof\n\n# Shell Completions (bash, zsh, fish, power-shell)\necho \". \u003C(hof completion bash)\" >> $HOME\u002F.profile\nsource $HOME\u002F.profile\n\n# Show the help text or version info to verify installation\nhof --help\nhof version\n```\n\n## Project Structure\n\nA brief overview of the project structure:\n\n-   `ci\u002F`: Continuous integration scripts.\n-   `cmd\u002Fhof\u002F`: The main entrypoint for the `hof` CLI.\n-   `docs\u002F`: The source code for the documentation website.\n-   `flow\u002F`: The source for `hof flow` and the task engine.\n-   `lib\u002F`: Core logic for `hof`'s various subcommands.\n-   `test\u002F`: Testscripts and testdata for `hof`'s subcommands.\n\n## Development\n\nTo build the `hof` binary:\n\n```\nmake build\n```\n\nTo run the test suite:\n\n```\nmake test\n```\n\nTo run the docs website locally:\n\n```\nmake docs-serve\n```\n\n\n## Contributing & Community\n\nWe are happy to accept contributions and have a growing community.\nThe best ways to get started are\n\n1. [Joining our Discord](https:\u002F\u002Fdiscord.com\u002Finvite\u002FBXwX7n6B8w)\n2. Reading [The Contributing Guild](https:\u002F\u002Fdocs.hofstadter.io\u002Fcontributing\u002F)\n3. Finding an issue to work on. We are happy to guide you.\n4. Improving the documentation.\n\nWhen you are ready to contribute, please fork the repo and submit a pull request.\nWe use a standard PR and review process. We also have a number of labels to help\norganize issues and PRs.\n\n\n## Interfaces \n\nThere are two interfaces to `hof`\n\n1. a CLI - great for scripting and automation\n2. a TUI - great for exploring and designing\n\n### cli\n\n```\nhof - the higher order framework\n\n  Learn more at https:\u002F\u002Fdocs.hofstadter.io\n\nUsage:\n  hof [flags] [command] [args]\n\nMain commands:\n  chat                  co-create with AI (alpha)\n  create                starter kits or blueprints from any git repo\n  datamodel             manage, diff, and migrate your data models\n  def                   print consolidated CUE definitions\n  eval                  evaluate and print CUE configuration\n  export                output data in a standard format\n  flow                  run workflows and tasks powered by CUE\n  fmt                   format any code and manage the formatters\n  gen                   CUE powered code generation\n  mod                   CUE module dependency management\n  tui                   a terminal interface to Hof and CUE\n  vet                   validate data with CUE\n\nAdditional commands:\n  help                  help about any command\n  update                check for new versions and run self-updates\n  version               print detailed version information\n  completion            generate completion helpers for your terminal\n  feedback              open an issue or discussion on GitHub\n\nFlags:\n  -E, --all-errors           print all available errors\n  -h, --help                 help for hof\n  -i, --ignore-errors        turn off output and assume defaults at prompts\n  -D, --include-data         auto include all data files found with cue files\n  -V, --inject-env           inject all ENV VARs as default tag vars\n  -I, --input stringArray    extra data to unify into the root value\n  -p, --package string       the Cue package context to use during execution\n  -l, --path stringArray     CUE expression for single path component when placing data files\n  -q, --quiet                turn off output and assume defaults at prompts\n  -d, --schema stringArray   expression to select schema to apply to data files\n      --stats                print generator statistics\n  -0, --stdin-empty          A flag that ensure stdin is zero and does not block\n  -t, --tags stringArray     @tags() to be injected into CUE code\n  -v, --verbosity int        set the verbosity of output\n      --with-context         add extra context for data files, usable in the -l\u002Fpath flag\n\nUse \"hof [command] --help \u002F -h\" for more information about a command.\n```\n\n### tui\n\nThe `hof tui` is a terminal based interface to Hof's features.\nIt has a built in help system and documentation.\nThe following YouTube video provides a tour.\n\n\n[![Tour Hof's TUI](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fhofstadter-io_hof_readme_378e39c8206c.jpg)](http:\u002F\u002Fwww.youtube.com\u002Fwatch?v=XNBqBWO4y08 \"Hof TUI Overview\")\n\n## License\n\nThis project is licensed under the Apache 2.0 License. See the [LICENSE](LICENSE) file for details.\n","# hof - 高阶框架\n\n一个统一数据模型、模式、代码生成和任务引擎的工具。\n\n__`hof` 是一款你可以 *添加* 到工作流中的 CLI 工具。__\n\n- 基于 CUE\n- 确定性和代理式代码生成\n- 可以演进并用于代码生成的数据模型\n- 基于 cue\u002Fflow 的任务引擎\n- 代理服务器和 VS Code 扩展\n\n| 核心功能 | |\n|:--- |:-- |\n| __代码生成__ | 数据 + 模板 = _ (任何内容)，与技术无关 |\n| __数据建模__ | 定义、检查点和比较数据模型 |\n| __任务引擎__ | 可扩展的任务和 DAG 工作流引擎 |\n| __CUE 命令__ | 核心 def、eval、export 和 vet 命令 |\n| __创建者__ | 从任何仓库启动和入门套件 |\n| __模块__ | CUE 模块依赖管理 |\n| __TUI__ | Hof 和 CUE 的终端界面 |\n| __聊天__ | 结合 LLM 和 Hof 代码生成，以获得更好、可扩展的结果 |\n\n\u003Cbr>\n\n`hof` 使用 [CUE](https:\u002F\u002Fcuelang.org) 来提升开发体验和实现。\n我们认为 CUE 是一种非常适合用于定义模式、配置以及编写任何声明性内容的语言，\n并且它是事实来源。它拥有良好的理论基础，并且来自那些为我们带来容器、Go 和 Kubernetes 的团队。\n\n\u003C!-- 关于事实来源、统一抽象、互操作性等内容 -->\n\n了解更多关于 CUE 的信息：[cuelang.org](https:\u002F\u002Fcuelang.org) | [cuetorials.com](https:\u002F\u002Fcuetorials.com)\n\n\n## 文档\n\n请访问 __[docs.hofstadter.io](https:\u002F\u002Fdocs.hofstadter.io)__ 以了解更多信息。\n\n在 [入门](https:\u002F\u002Fdocs.hofstadter.io\u002Fgetting-started\u002F) 部分，你将体验一次 hof 的之旅。\n在 [演练](https:\u002F\u002Fdocs.hofstadter.io\u002Fthe-walkthrough\u002F) 部分，你将学习如何构建和使用生成器。\n\n加入我们或提问：\n\n- Discord（推荐）：https:\u002F\u002Fdiscord.com\u002Finvite\u002FBXwX7n6B8w\n- Slack：[https:\u002F\u002Fhofstadter-io.slack.com](https:\u002F\u002Fjoin.slack.com\u002Ft\u002Fhofstadter-io\u002Fshared_invite\u002Fzt-e5f90lmq-u695eJur0zE~AG~njNlT1A)\n\n我们也会使用 GitHub 的问题和讨论区。选择你觉得最方便的方式即可！\n\n\n## 安装\n\n你可以在我们的 GitHub 发布页面找到 [最新下载](https:\u002F\u002Fgithub.com\u002Fhofstadter.io\u002Fhof\u002Freleases)。\n这是推荐的方法。\n\n如果你已经安装了 hof，可以使用 `hof update --version vX.Y.Z` 来安装特定版本。\n\n```shell\n# Homebrew\nbrew install hofstadter-io\u002Ftap\u002Fhof\n\n# Shell 补全（bash、zsh、fish、power-shell）\necho \". \u003C(hof completion bash)\" >> $HOME\u002F.profile\nsource $HOME\u002F.profile\n\n# 查看帮助文本或版本信息以验证安装\nhof --help\nhof version\n```\n\n## 项目结构\n\n项目结构简要概述如下：\n\n-   `ci\u002F`: 持续集成脚本。\n-   `cmd\u002Fhof\u002F`: `hof` CLI 的主入口。\n-   `docs\u002F`: 文档网站的源代码。\n-   `flow\u002F`: `hof flow` 和任务引擎的源代码。\n-   `lib\u002F`: `hof` 各子命令的核心逻辑。\n-   `test\u002F`: `hof` 子命令的测试脚本和测试数据。\n\n## 开发\n\n构建 `hof` 二进制文件：\n\n```\nmake build\n```\n\n运行测试套件：\n\n```\nmake test\n```\n\n在本地运行文档网站：\n\n```\nmake docs-serve\n```\n\n\n## 贡献与社区\n\n我们非常欢迎贡献，并且社区正在不断壮大。开始参与的最佳方式是：\n\n1. [加入我们的 Discord](https:\u002F\u002Fdiscord.com\u002Finvite\u002FBXwX7n6B8w)\n2. 阅读 [贡献指南](https:\u002F\u002Fdocs.hofstadter.io\u002Fcontributing\u002F)\n3. 寻找一个可以参与的问题。我们很乐意为你提供指导。\n4. 改善文档。\n\n当你准备好贡献时，请先 fork 仓库，然后提交 pull request。\n我们采用标准的 PR 和评审流程。此外，我们还使用多种标签来帮助组织问题和 PR。\n\n\n## 接口 \n\n`hof` 提供两种接口：\n\n1. CLI - 非常适合脚本和自动化\n2. TUI - 非常适合探索和设计\n\n### CLI\n\n```\nhof - 高阶框架\n\n  更多信息请访问 https:\u002F\u002Fdocs.hofstadter.io\n\n用法：\n  hof [flags] [command] [args]\n\n主要命令：\n  chat                  与 AI 共同创作（alpha）\n  create                从任何 git 仓库创建入门套件或蓝图\n  datamodel             管理、比较和迁移你的数据模型\n  def                   打印整合后的 CUE 定义\n  eval                  评估并打印 CUE 配置\n  export                将数据导出为标准格式\n  flow                  运行由 CUE 驱动的工作流和任务\n  fmt                   格式化任何代码并管理格式化工具\n  gen                   基于 CUE 的代码生成\n  mod                   CUE 模块依赖管理\n  tui                   Hof 和 CUE 的终端界面\n  vet                   使用 CUE 验证数据\n\n其他命令：\n  help                  关于任何命令的帮助\n  update                检查新版本并自动更新\n  version               打印详细的版本信息\n  completion            为你的终端生成补全助手\n  feedback              在 GitHub 上打开问题或讨论\n\n标志位：\n  -E, --all-errors           打印所有可用错误\n  -h, --help                 hof 的帮助\n  -i, --ignore-errors        关闭输出并在提示时假定默认值\n  -D, --include-data         自动包含所有与 cue 文件一起找到的数据文件\n  -V, --inject-env           将所有 ENV VAR 注入为默认标签变量\n  -I, --input stringArray    额外的数据，用于统一到根值中\n  -p, --package string       执行时使用的 Cue 包上下文\n  -l, --path stringArray     CUE 表达式，用于放置数据文件时指定单个路径组件\n  -q, --quiet                关闭输出并在提示时假定默认值\n  -d, --schema stringArray   表达式，用于选择应用于数据文件的模式\n      --stats                打印生成器统计信息\n  -0, --stdin-empty          确保 stdin 为空且不阻塞的标志\n  -t, --tags stringArray     要注入 CUE 代码中的 @tags()\n  -v, --verbosity int        设置输出的详细程度\n      --with-context         为数据文件添加额外的上下文，可用于 -l\u002Fpath 标志\n\n使用 \"hof [command] --help \u002F -h\" 以获取有关某个命令的更多信息。\n```\n\n### TUI\n\n`hof tui` 是一个基于终端的 Hof 功能界面。\n它内置了帮助系统和文档。以下 YouTube 视频提供了概览。\n\n\n[![Hof 的 TUI 概览](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fhofstadter-io_hof_readme_378e39c8206c.jpg)](http:\u002F\u002Fwww.youtube.com\u002Fwatch?v=XNBqBWO4y08 \"Hof TUI Overview\")\n\n## 许可证\n\n本项目采用 Apache 2.0 许可证。详情请参阅 [LICENSE](LICENSE) 文件。","# Hof 快速上手指南\n\nHof 是一个基于 CUE 语言的高阶框架工具，旨在统一数据模型、模式定义、代码生成及任务引擎。它通过确定性的代码生成和灵活的数据建模能力，帮助开发者构建可扩展的工程体系。\n\n## 环境准备\n\n- **操作系统**：支持 macOS、Linux 及 Windows（WSL 推荐）。\n- **前置依赖**：无需额外依赖，Hof 二进制文件已包含运行所需的所有组件。\n- **网络要求**：首次安装需访问 GitHub 或 Homebrew 源；国内用户若遇连接问题，可配置代理或使用镜像加速。\n\n## 安装步骤\n\n### 方法一：Homebrew（macOS\u002FLinux 推荐）\n\n```shell\nbrew install hofstadter-io\u002Ftap\u002Fhof\n```\n\n安装完成后，配置 Shell 自动补全（以 bash 为例）：\n\n```shell\necho \". \u003C(hof completion bash)\" >> $HOME\u002F.profile\nsource $HOME\u002F.profile\n```\n\n### 方法二：手动下载（通用）\n\n访问 [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fhofstadter.io\u002Fhof\u002Freleases) 下载对应平台的最新二进制文件，解压后将 `hof` 可执行文件移至 `$PATH` 目录中。\n\n### 验证安装\n\n```shell\nhof --help\nhof version\n```\n\n若输出版本信息及帮助文档，则安装成功。\n\n## 基本使用\n\n### 1. 初始化项目与数据模型\n\n使用 `datamodel` 命令定义和管理数据模型：\n\n```shell\nmkdir my-project && cd my-project\nhof datamodel init\n```\n\n编辑生成的 `.cue` 文件定义你的数据结构，例如 `model.cue`：\n\n```cue\nUser: {\n\tname: string\n\tage: int\n\temail?: string\n}\n```\n\n### 2. 验证与评估模型\n\n使用 `vet` 验证数据是否符合模型，或使用 `eval` 查看合并后的配置：\n\n```shell\n# 验证数据文件 data.cue 是否符合模型\nhof vet model.cue data.cue\n\n# 评估并输出最终配置\nhof eval model.cue data.cue\n```\n\n### 3. 代码生成\n\n结合模板与数据模型生成任意语言的代码（技术栈无关）：\n\n```shell\nhof gen --template .\u002Ftemplates\u002Fgo-server.cue --input data.cue --output .\u002Fgen\n```\n\n> 注：你需要预先编写符合 CUE 语法的模板文件。\n\n### 4. 运行工作流任务\n\n利用内置的任务引擎执行 DAG 工作流：\n\n```shell\nhof flow run .\u002Fflow\u002Ftask.cue\n```\n\n### 5. 使用终端界面（TUI）\n\n启动交互式终端界面探索项目结构与功能：\n\n```shell\nhof tui\n```\n\n该界面提供可视化导航、文档查阅及实时反馈，适合初学者熟悉 Hof 的核心概念。\n\n---\n\n更多详细教程请参考官方文档：[docs.hofstadter.io](https:\u002F\u002Fdocs.hofstadter.io)  \n加入社区交流：[Discord](https:\u002F\u002Fdiscord.com\u002Finvite\u002FBXwX7n6B8w)","某中型云原生团队在维护多个微服务时，面临 API 定义、数据库模型与多语言客户端代码难以同步更新的困境。\n\n### 没有 hof 时\n- **数据模型割裂**：API Schema、数据库 DDL 和 TypeScript 接口分散在不同文件中，修改一处常导致其他端不一致。\n- **重复劳动繁重**：每次模型变更，开发者需手动更新前后端代码，耗时且容易引入拼写错误或类型不匹配。\n- **协作效率低下**：缺乏统一的“单一事实来源”，前后端联调时常因数据结构理解偏差而反复沟通。\n- **演进风险高**：随着业务迭代，旧代码与新模型逐渐脱节，重构成本随时间指数级上升。\n\n### 使用 hof 后\n- **统一数据建模**：利用 CUE 定义唯一的数据模型作为“单一事实来源”，自动派生出 API 文档、数据库迁移脚本及各语言类型定义。\n- **确定性代码生成**：通过 `hof gen` 将模型一键转化为 Go、TypeScript 等目标代码，消除手动编写样板代码的需求，确保零误差。\n- **智能工作流编排**：借助内置的任务引擎（Task Engine），将模型校验、代码生成、单元测试串联为自动化 DAG 流程，变更即触发全链路更新。\n- **可追溯的版本演进**：支持对数据模型进行 Checkpoint 和 Diff，清晰记录每一次结构变更，让重构和安全审计有据可依。\n\nhof 通过将数据模型提升为核心资产，实现了从“人工同步”到“机器驱动”的范式转变，让团队能专注于业务逻辑而非胶水代码。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fhofstadter-io_hof_79bccc01.png","hofstadter-io","_Hofstadter","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fhofstadter-io_0a717765.png","Developing new ways to develop",null,"hofstadter_io","https:\u002F\u002Fhofstadter.io","https:\u002F\u002Fgithub.com\u002Fhofstadter-io",[81,85,89,93,97,101,105,109,113,116],{"name":82,"color":83,"percentage":84},"Go","#00ADD8",74.2,{"name":86,"color":87,"percentage":88},"TypeScript","#3178c6",10.9,{"name":90,"color":91,"percentage":92},"CUE","#5886E1",10.5,{"name":94,"color":95,"percentage":96},"HTML","#e34c26",1.4,{"name":98,"color":99,"percentage":100},"JavaScript","#f1e05a",1,{"name":102,"color":103,"percentage":104},"CSS","#663399",0.6,{"name":106,"color":107,"percentage":108},"Shell","#89e051",0.4,{"name":110,"color":111,"percentage":112},"Makefile","#427819",0.2,{"name":114,"color":115,"percentage":112},"SCSS","#c6538c",{"name":117,"color":118,"percentage":112},"BitBake","#00bce4",603,45,"2026-04-06T17:30:08","Apache-2.0","Linux, macOS, Windows","未说明",{"notes":126,"python":124,"dependencies":127},"该工具是一个基于 CUE 语言的 CLI 命令行工具和 TUI 终端界面，主要通过预编译的二进制文件安装（支持 Homebrew 或直接下载 GitHub Releases）。它不依赖 Python 环境或特定的 GPU 硬件。核心功能包括代码生成、数据建模和任务引擎，需了解 CUE 语言基础。可通过 'hof update' 命令进行版本管理。",[128],"CUE (cuelang.org)",[13,35,52,16],[131,132,133,134,135,136,137,138,139,140,141,142],"code-generator","cuelang","data-modeling","tui","workflow-engine","agents","llms","schemas","vscode-extension","cli","dagger","adk-go","2026-03-27T02:49:30.150509","2026-04-11T16:59:39.335015",[146,151,156,161,166,171],{"id":147,"question_zh":148,"answer_zh":149,"source_url":150},22366,"运行 `hof create` 时提示 'repository does not exist' 错误怎么办？","请尝试升级到最新版本（如 v0.8.3 或更高），并指定版本号运行命令：`hof create github.com\u002Fhofstadter-io\u002Fhofmod-cli@v0.8.3`。如果仍然遇到 Git 相关问题，可以尝试清除缓存目录：`rm -rf $HOME\u002F.cache\u002Fhof\u002Fsrc`。","https:\u002F\u002Fgithub.com\u002Fhofstadter-io\u002Fhof\u002Fissues\u002F142",{"id":152,"question_zh":153,"answer_zh":154,"source_url":155},22367,"如何在没有安装容器运行时（如 Docker\u002FPodman）的环境中避免 `hof version` 命令崩溃？","该问题已在后续版本（通过 PR #261 和 #268）中修复。旧版本在检测不到容器运行时会发生空指针引用导致 panic。请升级到修复后的版本，新版本会优雅地处理缺失运行时的情况并给出友好提示，而不是直接崩溃。","https:\u002F\u002Fgithub.com\u002Fhofstadter-io\u002Fhof\u002Fissues\u002F257",{"id":157,"question_zh":158,"answer_zh":159,"source_url":160},22368,"如何使用 JSON 数组数据批量调用 hof 生成多个文件？","可以使用 `hof render` 命令配合“重复模板”模式。例如，若有一个包含多个对象的 `data.json` 文件，可以使用以下单行命令为每个对象生成文件：`hof render data.json -T \"template.md;[]content\u002F{{ .filepath }}.md\"`。其中 `-T` 参数中的 `;[]\u003Cfilepath>` 部分表示对数组中的每个元素应用模板。","https:\u002F\u002Fgithub.com\u002Fhofstadter-io\u002Fhof\u002Fissues\u002F93",{"id":162,"question_zh":163,"answer_zh":164,"source_url":165},22369,"`hof generate` 命令在使用绝对路径或特定相对路径作为 CUE 入口点时报错 'file does not exist' 如何解决？","相对路径问题已在 `_dev` 分支通过 PR #156 修复。对于绝对路径，目前主要支持相对路径。如果遇到问题，可以尝试使用标准输入管道方式：`cat \u003Cfile> | hof gen - ...`（注意需要加 `-` 指定从 stdin 读取）。如果相对路径修复后仍无效，建议检查文件路径是否正确或提交新 issue。","https:\u002F\u002Fgithub.com\u002Fhofstadter-io\u002Fhof\u002Fissues\u002F110",{"id":167,"question_zh":168,"answer_zh":169,"source_url":170},22370,"使用 Go 1.23 编译 hof 失败，报错缺少 `InitRuntimeCoverage` 方法怎么办？","这是由于 Go 1.23 中 `testing.testDeps` 接口变更导致的。该问题已在代码库中修复（见 PR #392），请等待或下载包含此修复的新版本（高于 v0.6.9）。修复方案是在 `nopTestDeps` 结构中实现一个空的 `InitRuntimeCoverage` 方法以兼容新接口。","https:\u002F\u002Fgithub.com\u002Fhofstadter-io\u002Fhof\u002Fissues\u002F391",{"id":172,"question_zh":173,"answer_zh":174,"source_url":175},22371,"嵌套模块中的 replace 指令被忽略导致依赖解析失败如何处理？","这是一个已知问题，嵌套依赖中的 `replace` 指令在某些情况下会被忽略。维护者指出这可能与 `cue.sums` 文件的处理方式有关。虽然具体代码修复涉及内部逻辑调整，但可以参考 Go 模块官方文档关于版本解析的部分（https:\u002F\u002Fgolang.org\u002Fref\u002Fmod#resolve-pkg-mod）来理解其行为。建议关注后续版本更新以获取正式修复。","https:\u002F\u002Fgithub.com\u002Fhofstadter-io\u002Fhof\u002Fissues\u002F75",[177,182,187,192,197,202,207,212,217,222,227,232,237,242,247,252,257,262,267,272],{"id":178,"version":179,"summary_zh":180,"released_at":181},136095,"v0.7.0-alpha.2","- 新的主要功能正在稳定中\n- 聊天功能现在增加了停止按钮\n- 修复和改进了许多问题\n- 正在准备重命名，只差最后几项任务\n    - 完成匕首虚拟文件系统\n    - 远程 VS Code\n    - 在重命名之前，先使用 env.#Container 与基础代理，暂不实现代理模式\n\n**完整更新日志**: https:\u002F\u002Fgithub.com\u002Fhofstadter-io\u002Fhof\u002Fcompare\u002Fv0.7.0-alpha.1...v0.7.0-alpha.2\n\n如果你想使用聊天扩展：\n\n1. 你需要使用 Insider 版本，并启用多文件差异的提案 API（https:\u002F\u002Fcode.visualstudio.com\u002Fapi\u002Fadvanced-topics\u002Fusing-proposed-api）。\n2. 仍然需要配置 Google AI Studio 或 Vertex AI 账户，但只要在 hof\u002Fveg 外部能正常工作，在内部通过 ADK 也应该可以正常使用。","2026-01-17T14:50:40",{"id":183,"version":184,"summary_zh":185,"released_at":186},136096,"v0.7.0-alpha.1","本次发布带来了以下主要特性：\n\n1. 为将 `hof-io\u002Fhof` 迁移到 `verdverm\u002Fveg` 做准备，这将是 `hof` 的最后一个次要版本系列。\n2. 基于 CUE 和 Dagger 的环境，适用于各种场景（`veg\u002Fenv`，请参阅 `examples\u002Fenv\u002FREADME.md` 开始使用）。\n3. ADK-Go（Agent Development Kit）作为通过 CUE 实现代理能力的基础。\n4. VS Code 插件，作为核心开发者体验的一部分。\n\n下一版本的抢先预览","2026-01-02T23:37:03",{"id":188,"version":189,"summary_zh":190,"released_at":191},136097,"v0.6.10","## v0.6.10\n\n本次发布主要是修复了一些 bug，并更新了部分依赖和工具链。\n\n功能和 API 均无显著变化。\n\n[GitHub 上 v0.6.9 到 v0.6.10 的差异](https:\u002F\u002Fgithub.com\u002Fhofstadter-io\u002Fhof\u002Fcompare\u002Fv0.6.9...v0.6.10)","2024-12-31T22:24:54",{"id":193,"version":194,"summary_zh":195,"released_at":196},136098,"v0.6.10-rc.3","## 更改日志\n* hof\u002Fflow：修复补丁问题\n* hof\u002Ffmt：将 Prettier 更新至 v3\n\n","2024-12-29T00:55:08",{"id":198,"version":199,"summary_zh":200,"released_at":201},136099,"v0.6.10-rc.2","## 更改日志\n\n* fd7e7ec hof\u002Fci: 升级 Dagger (#400)\n* 更新 fmt-prettier\n* 相关更改和修复\n* 改进容器运行时执行失败时的错误提示\n","2024-12-18T03:32:25",{"id":203,"version":204,"summary_zh":205,"released_at":206},136100,"v0.6.9","本次发布为 hof 带来了更高的一致性与长期稳定性。此外，还新增了 CUE 命令和 hof TUI 等功能。\n\n\n### 主要变更\n\n- CUE v0.9.0（后续又合并了一个 bug 修复提交）\n- 新增 CUE 命令：`def`、`eval`、`export` 和 `vet`\n- 调整各命令的标志位，使其与 CUE 规范保持一致，并在内部实现上统一\n- 添加 `hof tui`，用于实时操作和探索 CUE 数据\n- 将 hof\u002Fflow 升级至新运行时，标志着所有子系统已完成迁移\n- 增加对并行批量处理的支持\n- 通过 hof 扩展支持 CUE 风格的数据嵌入\n- 支持将用户文件以字符串形式嵌入到 CUE 值中\n\n### 其他变更\n\n- 修复了 mod、containers 和 #hof 模块中的多个 bug\n- 解决了 GitHub Actions 上 macOS 环境下的问题","2024-06-07T07:44:56",{"id":208,"version":209,"summary_zh":210,"released_at":211},136101,"v0.6.9-rc.2","## 更改日志\n- hof\u002Fdeps：更新大部分 Go 依赖\n- hof\u002Ffmt：更新所有格式化工具\n- hof\u002Fdm：为 checkpoint 命令添加 `--suffix` 标志\n- 文档：对入门章节及其他一些随机组件进行了一些修改\n\n","2024-05-07T05:19:07",{"id":213,"version":214,"summary_zh":215,"released_at":216},136102,"v0.6.9-rc.1","## 更改日志\n\n本次发布使 hof 更加一致，同时新增了核心 CUE 命令和一个功能强大的 TUI。\n\n更改：\n\n- 多个标志已调整，以与 CUE 及内部实现保持一致\n- 升级流程至新运行时，标志着所有子系统已完成迁移\n- 进行了一些改进，我们仍计划在未来的版本中对流程进行重构\n- 添加支持并行的批量处理\n- 支持 CUE 风格的数据嵌入方式\n- 支持将用户文件以字符串形式嵌入到 CUE 值中\n- 新增 CUE 命令 [def, eval, export, vet]\n- 新增 `hof tui`，用于实时操作和探索 CUE 数据\n\n其他：\n\n- 修复了 mod、containers 和 #hof 中的若干 bug\n- 解决了 GitHub Actions 上 macOS 的问题\n","2024-05-04T22:35:19",{"id":218,"version":219,"summary_zh":220,"released_at":221},136103,"v0.6.9-beta.1","## 更改日志\n\n自 v0.6.8 以来，概要如下：\n\n- `hof tui`：Hof 和 CUE 的终端界面\n- 新增 `hof [def,eval,export,vet]` 命令，与 CUE 的命令保持一致\n- 在参数、标志和加载器方面几乎与 CUE 完全一致\n- 为后续重构做准备，暂时绕过流程问题\n- 对上一版本的功能进行了多项重要修复\n- 还修复了更多 bug，并进行了一般性的改进\n\n","2023-09-18T05:20:14",{"id":223,"version":224,"summary_zh":225,"released_at":226},136104,"v0.6.9-alpha.16","## 修复了若干 bug，并进行了更多 TUI 升级，请参阅内置帮助文本。\n","2023-09-11T11:53:58",{"id":228,"version":229,"summary_zh":230,"released_at":231},136105,"v0.6.9-alpha.15","## Changelog\r\n* more bugfixes, some commands were broken in the last alpha\r\n* add vscode & vim based hotkeys for selecting the command box\r\n\r\n","2023-09-10T11:31:33",{"id":233,"version":234,"summary_zh":235,"released_at":236},136106,"v0.6.9-alpha.14","## Changelog\r\n\r\n- significant upgrades to the TUI\r\n- bug fixes and other related changes\r\n\r\n","2023-09-10T08:10:17",{"id":238,"version":239,"summary_zh":240,"released_at":241},136107,"v0.6.9-alpha.4","## Changelog\r\n* 10c674a hof\u002Ftui: introduces the hof TUI and implements a CUE browser and playground like experience (#289)\r\n\r\n```\r\nhof eval --tui [cue args & flags...]\r\nhof tui ls        (opens a file browser, double click to open in eval)\r\n\r\ncurl api.com | hof eval --tui -\r\nkubectl ... --out json | hof eval --tui -                   \r\n```\r\n\r\n- use arrows or vim keys to move\r\n- spacebar or enter expands a directory\r\n- mouse is supported, double click in ls file tree to open in eval\r\n- CTRL-spacebar will get you to the command input (top-left), you can `eval [cue args & flags]` there to open a new value\r\n- ctrl-w will swap between value true and CUE code\r\n- ctrl-{h,o,f,r} control the amount of evalutation (hidden, optional, final, resolve)","2023-09-01T11:56:09",{"id":243,"version":244,"summary_zh":245,"released_at":246},136108,"v0.6.9-alpha.3","## Changelog\r\n* bugfixes\r\n* pre\u002Fpost flow in gen, use --exec to enable them\r\n\r\n","2023-08-29T05:30:09",{"id":248,"version":249,"summary_zh":250,"released_at":251},136109,"v0.6.9-alpha.1","This release brings more consistency to hof.\r\n\r\nChanges:\r\n\r\n- many flags changed to bring consistency with CUE and internally\r\n- upgrade flow to new runtime, this marks the point all subsystems have migrated\r\n- a few improvements, we still want to do a flow refactor in a future release\r\n- add support for bulk processing with parallelism\r\n- support for CUE style data placement\r\n- add CUE commands [def,eval,export,vet]\r\n\r\nOther:\r\n\r\n- several bug fixes in mod, containers, #hof\r\n- deal with macos woes on GHA\r\n","2023-08-27T21:52:12",{"id":253,"version":254,"summary_zh":255,"released_at":256},136110,"v0.6.8","## Changelog\r\n\r\n[v0.6.7...v0.6.8](https:\u002F\u002Fgithub.com\u002Fhofstadter-io\u002Fhof\u002Fcompare\u002Fv0.6.7...v0.6.8)\r\n\r\nAlmost every system was upgraded in this release and marks an API stability milestone.\r\n\r\n- Now using CUE `v0.6.0` with required fields\r\n- New shared runtime for core commands to enable greater cohesion and consistency\r\n- `#hof` metadata for core objects gen, datamodel, flow\r\n- Refresh of the datamodel command\r\n  - more flexible with a user defined structure\r\n  - nested history tracking and injection into code generation\r\n  - The schema has changed significantly, [learn how to upgrade here].\r\n- Refresh of module command \r\n  - focus on CUE with a simpler implementation\r\n  - automatic dependency inference with `hof mod tidy`\r\n  - support for both OCI & git, public and private\r\n- General schema cleanup and refactor\r\n- Support for Nerdctl or Podman as alternatives to Docker\r\n- Experimental LLM Chat features\r\n\r\n\r\nOther changes:\r\n\r\n- More formatters, support running any version\r\n- data formatting stability\r\n- support for CUE's `@tag()` and `-t`, --inject-env, --inject-data\r\n- --keep-deleted for `hof gen`\r\n- implement feedback command\r\n- support data placement for most commands with file.json@path.to.value\r\n- Improvements to several hof\u002Fflow tasks\r\n- CI upgrades\r\n- many test improvements and coverage increase\r\n- bug fixes\r\n- dependency updates\r\n\r\n","2023-08-10T04:33:20",{"id":258,"version":259,"summary_zh":260,"released_at":261},136111,"v0.6.8-rc.6","## Changelog\r\n\r\n- update CUE to v0.6.0-beta.1\r\n- (startup) improve container runtime init and usage\r\n- (finalize) --keep-deleted flag & remove empty dirs\r\n","2023-07-31T04:36:01",{"id":263,"version":264,"summary_zh":265,"released_at":266},136112,"v0.6.8-rc.5","## Changelog\r\n* bug fixes\r\n\r\n","2023-06-25T18:25:02",{"id":268,"version":269,"summary_zh":270,"released_at":271},136113,"v0.6.8-rc.4","## Changelog\r\n\r\n* fix `create.#Creator` reference error in `schema\u002Fgen`\r\n* more schema cleanup\r\n* start to docs updates\r\n","2023-06-05T06:57:20",{"id":273,"version":274,"summary_zh":275,"released_at":276},136114,"v0.6.8-rc.3","## Changelog\r\n\r\n# $hof -> #hof\r\n\r\n- bug fixes, notably subgenerator bug\r\n- much better datamodel history injection, way better performance\r\n- some schema cleanup\r\n\r\n","2023-06-05T02:03:50"]