[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-hmans--beans":3,"tool-hmans--beans":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 真正成长为懂上",149489,2,"2026-04-10T11:32:46",[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":10,"last_commit_at":59,"category_tags":60,"status":17},4487,"LLMs-from-scratch","rasbt\u002FLLMs-from-scratch","LLMs-from-scratch 是一个基于 PyTorch 的开源教育项目，旨在引导用户从零开始一步步构建一个类似 ChatGPT 的大型语言模型（LLM）。它不仅是同名技术著作的官方代码库，更提供了一套完整的实践方案，涵盖模型开发、预训练及微调的全过程。\n\n该项目主要解决了大模型领域“黑盒化”的学习痛点。许多开发者虽能调用现成模型，却难以深入理解其内部架构与训练机制。通过亲手编写每一行核心代码，用户能够透彻掌握 Transformer 架构、注意力机制等关键原理，从而真正理解大模型是如何“思考”的。此外，项目还包含了加载大型预训练权重进行微调的代码，帮助用户将理论知识延伸至实际应用。\n\nLLMs-from-scratch 特别适合希望深入底层原理的 AI 开发者、研究人员以及计算机专业的学生。对于不满足于仅使用 API，而是渴望探究模型构建细节的技术人员而言，这是极佳的学习资源。其独特的技术亮点在于“循序渐进”的教学设计：将复杂的系统工程拆解为清晰的步骤，配合详细的图表与示例，让构建一个虽小但功能完备的大模型变得触手可及。无论你是想夯实理论基础，还是为未来研发更大规模的模型做准备",90106,"2026-04-06T11:19:32",[35,15,13,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":77,"owner_email":78,"owner_twitter":76,"owner_website":79,"owner_url":80,"languages":81,"stars":112,"forks":113,"last_commit_at":114,"license":115,"difficulty_score":32,"env_os":116,"env_gpu":117,"env_ram":118,"env_deps":119,"category_tags":125,"github_topics":126,"view_count":32,"oss_zip_url":76,"oss_zip_packed_at":76,"status":17,"created_at":130,"updated_at":131,"faqs":132,"releases":168},6385,"hmans\u002Fbeans","beans","A CLI-based, flat-file issue tracker for humans and robots. 🤖","Beans 是一款专为开发者与 AI 编程助手设计的命令行任务追踪工具。它打破了传统任务管理软件与代码库分离的壁垒，直接将任务、Bug 和功能需求以纯文本 Markdown 文件的形式存储在项目本地的 `.beans` 目录中。\n\n这一设计主要解决了两个核心痛点：一是让任务数据像代码一样易于版本控制和协作；二是赋予 AI 编程助手“上下文感知”能力。通过 Beans，AI 不仅能读取代码，还能全面掌握项目的待办事项、历史进度和归档记忆，从而主动建议下一步工作、自动创建 Bug 报告或更新任务状态，真正成为懂项目的“结对程序员”。\n\nBeans 特别适合希望将 AI 深度集成到开发工作流中的软件工程师和技术团队。其独特亮点包括：内置高效的 GraphQL 查询引擎，帮助 AI 精准获取信息并节省 Token 消耗；提供美观的终端用户界面（TUI）方便人工管理；以及能自动生成项目路线图文档。虽然目前仍处于快速迭代阶段，但 Beans 已展现出让人类开发者轻松兼任“产品经理”，同时最大化释放 AI 潜力的巨大价值。","![beans](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fhmans_beans_readme_404e75b08b25.png)\n\n[![License](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fhmans\u002Fbeans?style=for-the-badge)](LICENSE)\n[![Release](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fhmans\u002Fbeans?style=for-the-badge)](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Freleases)\n[![CI](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fhmans\u002Fbeans\u002Ftest.yml?branch=main&label=tests&style=for-the-badge)](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Factions\u002Fworkflows\u002Ftest.yml)\n[![Go Version](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fgo-mod\u002Fgo-version\u002Fhmans\u002Fbeans?style=for-the-badge)](https:\u002F\u002Fgo.dev\u002F)\n[![Go Report Card](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fhmans_beans_readme_ffe89103cc34.png)](https:\u002F\u002Fgoreportcard.com\u002Freport\u002Fgithub.com\u002Fhmans\u002Fbeans)\n\n**Beans is an issue tracker for you, your team, and your coding agents.** Instead of tracking tasks in a separate application, Beans stores them right alongside your code. You can use the `beans` CLI to interact with your tasks, but more importantly, so can your favorite coding agent!\n\nThis gives your robot friends a juicy upgrade: now they get a complete view of your project, make suggestions for what to work on next, track their progress, create bug issues for problems they find, and more.\n\nYou've been programming all your life; now you get to be a product manager. Let's go! 🚀\n\n## Announcement Trailer ✨\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fdbe45408-d3ed-4681-a436-a5e3046163da\n\n## Stability Warning ⚠️\n\nBeans is still under heavy development, and its features and APIs may still change significantly. If you decide to use it now, please follow the release notes closely.\n\nSince Beans emits its own prompt instructions for your coding agent, most changes will \"just work\"; but sometimes, we modify the schema of the underlying data files, which may require some manual migration steps. If you get caught by one of these changes, your agent will often be able to migrate your data for you:\n\n```\nThe Beans data format has changed. Please migrate this project's beans to the new format.\n```\n\n## Features\n\n- **Track tasks, bugs, features**, and more right alongside your code.\n- **Plain old Markdown files** stored in a `.beans` directory in your project. Easy to version control, readable and editable by humans and machines alike!\n- Use the `beans` CLI to create, list, view, update, and archive beans; but more importantly, **let your coding agent do it for you**!\n- **Supercharge your robot friend** with full context about your project and its open tasks. A built-in **GraphQL query engine** allows your agent to get exactly the information it needs, keeping token use to a minimum.\n- **Project memory**: Completed beans are archived and serve as project memory that your coding agent can query for context about past work.\n- A beautiful **built-in** TUI for browsing and managing your beans from the terminal.\n- Generates a **Markdown roadmap document** for your project from your data.\n\n## Installation\n\nWe'll need to do three things:\n\n1. Install the `beans` CLI tool.\n2. Configure your project to use it.\n3. Configure your coding agent to interact with it.\n\nEither download Beans from the [Releases section](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Freleases), or install it via Homebrew:\n\n```bash\nbrew install hmans\u002Fbeans\u002Fbeans\n```\n\nAlternatively, install directly via Go:\n\n```bash\ngo install github.com\u002Fhmans\u002Fbeans@latest\n```\n\n## Configure Your Project\n\nInside the root directory of your project, run:\n\n```bash\nbeans init\n```\n\nThis will create a `.beans\u002F` directory and a `.beans.yml` configuration file at the project root. All of it is meant to be tracked in your version control system.\n\nFrom this point onward, you can interact with your Beans through the `beans` CLI. To get a list of available commands:\n\n```bash\nbeans help\n```\n\nBut more importantly, you'll want to get your coding agent set up to use it. Let's dive in!\n\n## Agent Configuration\n\nThe most basic way to teach your agent about Beans is to simply add the following instruction to your `AGENTS.md`, `CLAUDE.md`, or equivalent file:\n\n```\n**IMPORTANT**: before you do anything else, run the `beans prime` command and heed its output.\n```\n\nSome agents provide mechanisms to automate this step:\n\n### Claude Code\n\nAn official Beans plugin for Claude is in the works, but for the time being, please manually add the following hooks to your project's `.claude\u002Fsettings.json` file:\n\n```json\n{\n  \"hooks\": {\n    \"SessionStart\": [\n      { \"hooks\": [{ \"type\": \"command\", \"command\": \"beans prime\" }] }\n    ],\n    \"PreCompact\": [\n      { \"hooks\": [{ \"type\": \"command\", \"command\": \"beans prime\" }] }\n    ]\n  }\n}\n```\n\n### OpenCode\n\nBeans integrates with OpenCode via a plugin that injects task context into your sessions. To set it up, **copy the plugin** from [`.opencode\u002Fplugin\u002Fbeans-prime.ts`](.opencode\u002Fplugin\u002Fbeans-prime.ts) to your project's `.opencode\u002Fplugin\u002F` directory (or `~\u002F.opencode\u002Fplugin\u002F` for global availability across all projects).\n\n## Usage Hints\n\nAs a human, you can get an overview of the CLI's functionalities by running:\n\n```bash\nbeans help\n```\n\nYou might specifically be interested in the interactive TUI:\n\n```bash\nbeans tui\n```\n\n### Example Workflows\n\n**But the real power of Beans** comes from letting your coding agent manage your tasks for you.\n\nAssuming you have integrated Beans into your coding agent correctly, it will already know how to create and manage beans for you. You can use the usual assortment of natural language inquiries. If you've just\nadded Beans to an existing project, you could try asking your agent to identify potential tasks and create beans for them:\n\n```\nAre there any tasks we should be tracking for this project? If so, please create beans for them.\n```\n\nIf you already have some beans available, you can ask your agent to recommend what to work on next:\n\n```\nWhat should we work on next?\n```\n\nYou can also specifically ask it to start working on a particular bean:\n\n```\nIt's time to tackle myproj-123.\n```\n\nConsider that your agent will be just as capable to deal with beans as it is with code, so how about using it to quickly restructure your tasks?\n\n```\nPlease inspect this project's beans and reorganize them into epics. Also please create 2-3 milestones to group these epics in a meaningful way.\n```\n\nYou can also add Beans-specific instructions to your `AGENTS.md`, `CLAUDE.md` or equivalent file, for example:\n\n```\nWhen making a commit, include the relevant bean IDs in the commit message\n```\n\n## Contributing\n\nThis project currently does not accept contributions -- it's just way too early for that!\nBut if you do have suggestions or feedback, please feel free to open an issue.\n\n## License\n\nThis project is licensed under the Apache-2.0 License. See the [LICENSE](LICENSE) file for details.\n\n## Getting in Touch\n\nIf you have any questions, suggestions, or just want to say hi, feel free to reach out to me [on Bluesky](https:\u002F\u002Fbsky.app\u002Fprofile\u002Fhmans.dev), or [open an issue](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fissues) in this repository.\n","![beans](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fhmans_beans_readme_404e75b08b25.png)\n\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fhmans\u002Fbeans?style=for-the-badge)](LICENSE)\n[![发布版本](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fv\u002Frelease\u002Fhmans\u002Fbeans?style=for-the-badge)](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Freleases)\n[![CI](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Factions\u002Fworkflow\u002Fstatus\u002Fhmans\u002Fbeans\u002Ftest.yml?branch=main&label=tests&style=for-the-badge)](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Factions\u002Fworkflows\u002Ftest.yml)\n[![Go版本](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fgo-mod\u002Fgo-version\u002Fhmans\u002Fbeans?style=for-the-badge)](https:\u002F\u002Fgo.dev\u002F)\n[![Go报告卡](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fhmans_beans_readme_ffe89103cc34.png)](https:\u002F\u002Fgoreportcard.com\u002Freport\u002Fgithub.com\u002Fhmans\u002Fbeans)\n\n**Beans 是一款专为你、你的团队以及你的编程助手打造的问题追踪工具。** 与在独立应用中跟踪任务不同，Beans 将任务直接存储在你的代码旁边。你可以使用 `beans` CLI 来管理任务，但更重要的是，你最喜欢的编程助手也可以做到！\n\n这为你的机器人伙伴带来了重大升级：现在它们能够全面了解你的项目，提出下一步工作的建议，跟踪进度，针对发现的问题创建 bug 问题，等等。\n\n你一生都在编程；现在，你也可以扮演产品经理的角色了！让我们一起出发吧！🚀\n\n## 宣传预告片 ✨\n\nhttps:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002Fdbe45408-d3ed-4681-a436-a5e3046163da\n\n## 稳定性警告 ⚠️\n\nBeans 仍处于快速开发阶段，其功能和 API 可能还会发生较大变化。如果你决定现在就使用它，请密切关注发布说明。\n\n由于 Beans 会为你的编程助手生成专属的提示指令，大多数更改都能“无缝衔接”；但有时我们会修改底层数据文件的结构，这可能需要一些手动迁移步骤。如果遇到这类变更，你的助手通常可以帮你自动迁移数据：\n\n```\nBeans 数据格式已更新。请将该项目的 beans 迁移到新格式。\n```\n\n## 功能特性\n\n- **在代码旁直接跟踪任务、bug、功能需求等**。\n- 使用存储在项目 `.beans` 目录中的**纯 Markdown 文件**。易于版本控制，人机皆可读写！\n- 使用 `beans` CLI 创建、列出、查看、更新和归档 beans；但更重要的是，**让你的编程助手代你完成这些操作**！\n- 通过提供关于项目及其未完成任务的完整上下文信息，**为你的机器人伙伴赋能**。内置的**GraphQL 查询引擎**使助手能够精准获取所需信息，从而最大限度地减少 token 消耗。\n- **项目记忆**：已完成的 beans 会被归档，作为项目记忆供编程助手查询，以获取过往工作的背景信息。\n- 内置精美的**TUI 界面**，方便你在终端中浏览和管理 beans。\n- 根据你的数据自动生成项目的**Markdown 路线图文档**。\n\n## 安装\n\n我们需要完成三件事：\n\n1. 安装 `beans` CLI 工具。\n2. 配置你的项目以使用它。\n3. 配置你的编程助手使其能够与之交互。\n\n你可以从 [Releases 页面](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Freleases)下载 Beans，或者通过 Homebrew 安装：\n\n```bash\nbrew install hmans\u002Fbeans\u002Fbeans\n```\n\n你也可以直接通过 Go 安装：\n\n```bash\ngo install github.com\u002Fhmans\u002Fbeans@latest\n```\n\n## 配置你的项目\n\n在项目的根目录下运行：\n\n```bash\nbeans init\n```\n\n这将会在项目根目录下创建一个 `.beans\u002F` 目录和一个 `.beans.yml` 配置文件。所有这些内容都应纳入版本控制系统进行管理。\n\n从此时起，你可以通过 `beans` CLI 与你的 Beans 进行交互。要查看可用命令列表：\n\n```bash\nbeans help\n```\n\n但更重要的是，你需要配置你的编程助手来使用它。让我们开始吧！\n\n## 助手配置\n\n让你的助手了解 Beans 的最简单方法，就是在你的 `AGENTS.md`、`CLAUDE.md` 或类似文件中添加以下指令：\n\n```\n**重要提示**：在执行任何操作之前，请先运行 `beans prime` 命令，并按照其输出指示操作。\n```\n\n有些助手提供了自动化这一步骤的机制：\n\n### Claude Code\n\n官方的 Beans 插件正在开发中，但目前，请手动将以下钩子添加到你项目的 `.claude\u002Fsettings.json` 文件中：\n\n```json\n{\n  \"hooks\": {\n    \"SessionStart\": [\n      { \"hooks\": [{ \"type\": \"command\", \"command\": \"beans prime\" }] }\n    ],\n    \"PreCompact\": [\n      { \"hooks\": [{ \"type\": \"command\", \"command\": \"beans prime\" }] }\n    ]\n  }\n}\n```\n\n### OpenCode\n\nBeans 通过插件与 OpenCode 集成，该插件会在会话中注入任务上下文。要进行设置，请将插件从 [.opencode\u002Fplugin\u002Fbeans-prime.ts](.opencode\u002Fplugin\u002Fbeans-prime.ts) 复制到你项目的 `.opencode\u002Fplugin\u002F` 目录（或复制到 `~\u002F.opencode\u002Fplugin\u002F` 以使插件在所有项目中全局可用）。\n\n## 使用提示\n\n作为人类，你可以通过运行以下命令来概览 CLI 的各项功能：\n\n```bash\nbeans help\n```\n\n你可能对交互式 TUI 特别感兴趣：\n\n```bash\nbeans tui\n```\n\n### 示例工作流程\n\n**但 Beans 的真正强大之处**在于让你的编程助手为你管理任务。\n\n假设你已正确将 Beans 集成到你的编程助手中，它就已经知道如何为你创建和管理 beans。你可以使用常规的自然语言查询方式。如果你刚刚将 Beans 添加到现有项目中，可以尝试让助手识别潜在的任务并为其创建 beans：\n\n```\n这个项目有哪些需要跟踪的任务吗？如果有，请为它们创建 beans。\n```\n\n如果你已经有一些 beans，可以请助手推荐下一步的工作内容：\n\n```\n我们接下来应该做什么？\n```\n\n你也可以明确要求助手开始处理某个特定的 bean：\n\n```\n现在该处理 myproj-123 了。\n```\n\n请记住，你的助手处理 beans 的能力与处理代码的能力一样强，因此不妨让它快速重组你的任务：\n\n```\n请检查一下这个项目的 beans，并将它们重新组织成史诗级任务。同时，请创建 2–3 个里程碑，以便以有意义的方式分组这些史诗级任务。\n```\n\n你还可以在 `AGENTS.md`、`CLAUDE.md` 或类似文件中添加专门针对 Beans 的指令，例如：\n\n```\n提交代码时，请在提交信息中包含相关的 bean ID。\n```\n\n## 贡献\n\n目前该项目暂不接受贡献——因为还为时过早！不过，如果你有任何建议或反馈，欢迎随时提交 issue。\n\n## 许可证\n\n本项目采用 Apache-2.0 许可证。详细信息请参阅 [LICENSE](LICENSE) 文件。\n\n## 联系我们\n\n如果您有任何问题、建议，或者只是想打个招呼，欢迎随时联系我[在 Bluesky 上](https:\u002F\u002Fbsky.app\u002Fprofile\u002Fhmans.dev)，或在这个仓库中[提交一个议题](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fissues)。","# Beans 快速上手指南\n\nBeans 是一款专为开发者、团队及 AI 编程助手设计的轻量级问题追踪工具。它将任务以 Markdown 文件的形式直接存储在代码仓库的 `.beans` 目录中，让 AI 助手能够全面理解项目上下文、自主规划任务并追踪进度。\n\n## 环境准备\n\n*   **操作系统**：支持 macOS、Linux 及 Windows（需配置相应终端环境）。\n*   **前置依赖**：\n    *   已安装 Git（用于版本控制任务文件）。\n    *   已配置常用的 AI 编程助手（如 Claude Code, OpenCode 等），以便发挥 Beans 的核心优势。\n*   **网络要求**：需能访问 GitHub Releases 或 Go 模块代理。\n\n## 安装步骤\n\n你可以选择以下任意一种方式进行安装：\n\n**方式一：使用 Homebrew (推荐 macOS 用户)**\n```bash\nbrew install hmans\u002Fbeans\u002Fbeans\n```\n\n**方式二：使用 Go 直接安装**\n```bash\ngo install github.com\u002Fhmans\u002Fbeans@latest\n```\n\n**方式三：手动下载**\n访问 [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Freleases) 页面下载对应系统的二进制文件，并将其添加到系统环境变量 `PATH` 中。\n\n## 基本使用\n\n### 1. 初始化项目\n在你的项目根目录下运行以下命令，Beans 将创建 `.beans\u002F` 目录和配置文件：\n```bash\nbeans init\n```\n*提示：请将生成的 `.beans\u002F` 目录和 `.beans.yml` 文件提交到 Git 版本控制中。*\n\n### 2. 人机交互\n*   **查看帮助**：列出所有可用命令。\n    ```bash\n    beans help\n    ```\n*   **启动图形界面**：打开内置的终端用户界面（TUI）来浏览和管理任务。\n    ```bash\n    beans tui\n    ```\n\n### 3. 集成 AI 助手（核心用法）\n为了让 AI 助手自动管理任务，请在项目的 `AGENTS.md`、`CLAUDE.md` 或等效配置文件中添加以下指令：\n\n```markdown\n**IMPORTANT**: before you do anything else, run the `beans prime` command and heed its output.\n```\n\n**针对特定助手的配置：**\n\n*   **Claude Code**: 在项目 `.claude\u002Fsettings.json` 中添加钩子：\n    ```json\n    {\n      \"hooks\": {\n        \"SessionStart\": [\n          { \"hooks\": [{ \"type\": \"command\", \"command\": \"beans prime\" }] }\n        ],\n        \"PreCompact\": [\n          { \"hooks\": [{ \"type\": \"command\", \"command\": \"beans prime\" }] }\n        ]\n      }\n    }\n    ```\n\n*   **OpenCode**: 将插件文件 [`.opencode\u002Fplugin\u002Fbeans-prime.ts`](.opencode\u002Fplugin\u002Fbeans-prime.ts) 复制到你的项目 `.opencode\u002Fplugin\u002F` 目录（或全局 `~\u002F.opencode\u002Fplugin\u002F`）。\n\n### 4. 开始协作\n配置完成后，你可以直接用自然语言与 AI 助手协作：\n*   **发现任务**：\"Are there any tasks we should be tracking for this project? If so, please create beans for them.\"\n*   **规划下一步**：\"What should we work on next?\"\n*   **执行特定任务**：\"It's time to tackle myproj-123.\"\n\n> **注意**：Beans 目前处于活跃开发阶段，数据格式可能会发生变化。若遇到格式变更提示，可指示你的 AI 助手运行迁移命令即可。","全栈开发者小李正带领一个由人类和 AI 编码助手组成的混合团队，冲刺一个开源项目的核心功能重构。\n\n### 没有 beans 时\n- **上下文割裂**：任务分散在 Jira 或 Trello 等外部系统中，AI 助手无法直接读取项目进度，每次对话都需要人工复制粘贴大量背景信息。\n- **状态不同步**：AI 在代码中发现的 Bug 或完成的优化，无法自动反馈到任务看板，导致“代码已修好但工单仍挂起”的数据不一致。\n- **记忆缺失**：AI 缺乏对项目历史决策的长期记忆，经常重复提出已被否决的方案，浪费宝贵的 Token 额度并降低开发效率。\n- **流程繁琐**：开发者需要在 IDE、浏览器和终端之间频繁切换来更新任务状态，打断了心流体验。\n\n### 使用 beans 后\n- **原生集成**：beans 将任务以 Markdown 文件形式直接存储在代码库的 `.beans` 目录中，AI 助手能像读取源码一样实时感知所有待办事项和优先级。\n- **自主闭环**：AI 发现 Bug 时可自动创建 bean 记录，修复完成后自动归档，无需人工干预即可保持任务状态与代码现实的高度一致。\n- **智能记忆**：通过内置的 GraphQL 引擎，AI 能高效检索已归档的历史 bean 作为项目记忆，避免重蹈覆辙并精准规划下一步工作。\n- **终端一体化**：开发者仅需在终端使用 beans CLI 或其精美 TUI 界面，即可在不离开开发环境的情况下完成从规划到复盘的全流程管理。\n\nbeans 通过将任务追踪“代码化”，打破了人与机器协作的壁垒，让 AI 真正成为了懂上下文、有记忆的超级队友。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fhmans_beans_9adc41e3.png","hmans","Hendrik Mans","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fhmans_98cc2ae3.jpg","THE WIZARD MUST BE STOPPED.",null,"Wedel, Germany","hendrik@mans.de","https:\u002F\u002Fhmans.dev","https:\u002F\u002Fgithub.com\u002Fhmans",[82,86,90,94,98,101,105,109],{"name":83,"color":84,"percentage":85},"Go","#00ADD8",72.2,{"name":87,"color":88,"percentage":89},"TypeScript","#3178c6",16.6,{"name":91,"color":92,"percentage":93},"Svelte","#ff3e00",9.5,{"name":95,"color":96,"percentage":97},"CSS","#663399",1,{"name":99,"color":84,"percentage":100},"Go Template",0.6,{"name":102,"color":103,"percentage":104},"JavaScript","#f1e05a",0.1,{"name":106,"color":107,"percentage":108},"Shell","#89e051",0,{"name":110,"color":111,"percentage":108},"HTML","#e34c26",677,45,"2026-04-10T15:03:04","Apache-2.0","Linux, macOS, Windows","不需要 GPU","未说明",{"notes":120,"python":121,"dependencies":122},"该工具是基于 Go 语言开发的 CLI 工具，不依赖 Python 或 GPU。可通过下载预编译二进制文件、Homebrew (macOS) 或 'go install' 命令进行安装。主要面向与编码代理（Coding Agents）配合使用，需配置代理钩子以自动运行 'beans prime' 命令。项目处于早期开发阶段，数据格式可能会发生变更。","不需要 Python",[123,124],"Go (用于编译\u002F安装)","Homebrew (可选，用于 macOS 安装)",[13],[127,128,129],"agentic-ai","issue-tracker","markdown","2026-03-27T02:49:30.150509","2026-04-11T03:23:02.865341",[133,138,143,148,153,158,163],{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},28888,"如何配置 AI 代理（如 Cursor、Claude）以识别和使用 Beans？","最简单的方法是将特定指令添加到项目的 `AGENTS.md`、`CLAUDE.md` 或等效配置文件中。你可以运行 `beans prime` 命令，该命令会输出需要添加到代理提示词中的具体指令内容。注意：README 中的相关说明可能位于引用块中，容易被忽略，其核心内容是让代理在操作前先运行 `beans prime` 并遵循其指示。","https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fissues\u002F55",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},28889,"`beans update` 命令执行非常慢甚至无限等待，如何解决？","在旧版本中，用户可能需要使用 `--no-edit` 标志来避免编辑器界面导致的等待问题。但在最新版本中，`create` 和 `update` 命令已不再包含任何编辑 UI，因此该问题已被修复，无需再手动添加 `--no-edit` 参数。如果遇到类似问题，请确保升级到最新版本。","https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fissues\u002F11",{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},28890,"如何在 Git Worktree 或多分支环境中共享同一个 `.beans` 状态目录？","推荐使用环境变量 `BEANS_PATH` 来指定 `.beans` 目录的路径，而不是使用符号链接。你可以在 worktree 中设置 `BEANS_PATH` 指向主分支的 `.beans` 目录。这样做的好处是不需要修改 worktree 中的文件结构，避免了意外提交配置变更的风险。例如：在 shell 配置中导出 `export BEANS_PATH=\u002Fpath\u002Fto\u002Fmain\u002F.beans`。","https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fissues\u002F88",{"id":149,"question_zh":150,"answer_zh":151,"source_url":152},28891,"如何快速查看当前待办（未完成）的 Beans 任务？","在 0.4.0 及以上版本中，`beans list` 命令的行为已优化。你可以使用 `--ready` 标志来专门列出所有准备开始工作的任务（即未完成的）。此外，默认列表行为也可能已调整以更简洁地显示开放任务，不再需要输入冗长的 `--no-status completed` 过滤条件。","https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fissues\u002F48",{"id":154,"question_zh":155,"answer_zh":156,"source_url":157},28892,"为什么在非 Beans 项目目录下运行 `beans help` 或 `beans version` 会报错？","这是一个已知问题，已在 `main` 分支修复并将随 0.4.0 版本发布。修复后，`help` 和 `version` 等全局命令将不再强制要求当前目录必须初始化过 `.beans\u002F` 文件夹，允许用户在任意路径下查询版本或帮助信息。","https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fissues\u002F84",{"id":159,"question_zh":160,"answer_zh":161,"source_url":162},28893,"`beans archive` 命令是永久删除任务吗？如何查看已归档的任务？","`beans archive` 并不是永久删除，而是将已完成或废弃的 Bean 移动到 `.beans\u002Farchive\u002F` 子目录中。在较新的实现中，默认的 `beans list` 不会加载归档目录下的内容。如果需要查看归档任务，未来版本可能会支持 `--include-archive` 参数，或者通过直接浏览 `.beans\u002Farchive\u002F` 文件夹来查看。目前该功能旨在保持简单，仅做物理移动而非复杂归档逻辑。","https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fissues\u002F51",{"id":164,"question_zh":165,"answer_zh":166,"source_url":167},28894,"Beans 与 Beads 等其他 CLI 任务管理工具相比有什么优缺点？","根据社区评估，Beans (评分 9\u002F10) 的优势在于强大的 GraphQL 支持、原生搜索功能、人类可读的 Markdown 文件格式以及删除确认安全机制；劣势是缺乏内置的 'ready' 命令且学习曲线稍陡。Beads (评分 8.5\u002F10) 的优势在于层级子 ID 设计优雅、工作流命令便捷；劣势是无原生搜索且无法组合过滤器。两者均已达到生产可用标准，Beans 胜在灵活性，Beads 胜在工作流便利性。","https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fissues\u002F25",[169,174,179,184,189,194,199,204,209,214,219,224,229,234,239,244,249,254,259,264],{"id":170,"version":171,"summary_zh":172,"released_at":173},197733,"v0.4.2","# v0.4.2 版本发布说明\n\n这是一次小型但实用的版本更新，重点在于让 beans 的配置更加简便、日常使用时提供更丰富的信息，同时还修复了一些发布基础设施的问题。\n\n## 亮点\n\n**`BEANS_PATH` 环境变量** — 现在你可以在环境中设置 `BEANS_PATH`，以指定项目 `.beans\u002F` 目录的位置，而无需依赖自动检测或每次都手动传递 `--beans-path`。如果你经常从不同目录工作，或者需要编写脚本来调用 beans，这个功能会非常方便。（[#85](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F85)）\n\n**`beans show` 中显示 Bean 类型** — 现在 `beans show` 命令会在其他元数据字段旁边显示 Bean 的类型（任务、Bug、特性等），这样你无需直接查看文件就能获得完整的信息。（[#87](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F87)）\n\n## Bug 修复\n\n**修复了发布流水线** — GoReleaser 工作流现已更新，改用内置的 `GITHUB_TOKEN` 进行发布（[18f1c6f](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F18f1c6f)），并为 Homebrew tap 的更新单独使用个人访问令牌（PAT）（[670ecf3](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F670ecf3)）。此举解决了自动化发布和 tap 发布过程中遇到的问题。","2026-03-10T20:11:34",{"id":175,"version":176,"summary_zh":177,"released_at":178},197734,"v0.4.0","# v0.4.0 版本发布说明\n\n本次发布主要聚焦于原子性和界面优化。`updateBean` 变更现已升级为所有 Bean 修改的统一、强大的入口——无论是元数据、正文内容还是关系，都可以在一次原子操作中完成更新，并且具备完善的并发控制机制。此外，终端用户界面也迎来了重大易用性提升：采用双列布局，允许你在不离开列表的情况下预览 Bean 的详细信息，同时还包含其他多项提升使用体验的功能。\n\n## 亮点功能\n\n**原子化 Bean 更新** — 现在你可以将元数据变更、正文修改和关系更新合并为一次 `updateBean` 调用。无论是多处文本替换、内容追加、状态变更，还是父级或阻塞关系的更新，都将在一次 ETag 校验下以原子方式完成。这对于此前需要手动提取 ETag 并串联多个变更的 AI 代理来说，是一项巨大的改进。（[#72](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F72), [#81](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F81)）\n\n**基于 ETag 的并发控制** — Beans 现在通过 ETag 实现了乐观锁机制。当多个代理同时操作同一个 Bean 时，`--if-match` 参数可确保不会出现更新被静默丢失的情况。此外，之前存在的两个并发更新都能通过 ETag 校验而导致冲突的问题，也已通过将校验逻辑移至写锁保护范围内而得到修复。（[#59](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F59)）\n\n**双列终端界面** — 终端界面现在会在 Bean 列表旁显示详细预览，方便你快速浏览 Bean 而无需逐个打开。布局具有响应式设计，在窄屏终端（宽度低于 120 列）上会自动切换为单列模式。（[#42](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F42)）\n\n**更智能的阻塞筛选** — 已完成或已废弃的 Bean 不再被视为阻塞项。如果某个 Bean 曾经阻塞你的工作，但后来已经完成，则被阻塞的 Bean 将被正确地视为已解除阻塞状态。（[#80](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F80)）\n\n## 其他改进\n\n### 命令行工具\n\n- `beans show` 现在接受多个 Bean ID，支持一次性查看多个 Bean 的详细信息（[97ae9d1](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F97ae9d1)）\n- `beans delete` 支持批量删除多个 ID（[#66](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F66)）\n- `beans list --ready` 新增筛选条件，仅列出可执行的 Bean——即未被阻塞、且非进行中、已完成、已废弃或草稿状态的 Bean（[#40](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F40)）\n- `beans create --prefix` 允许指定自定义的 Bean ID 前缀（[#56](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F56)）\n- `beans version` 现在无需 `.beans` 目录即可运行（[#28](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F28)）\n- `--json` 模式下的 JSON 输出现已格式化整齐（[3c0bd52](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F3c0bd52)）\n\n### 终端用户界面\n\n- 按下空格键即可选中当前 Bean，并自动跳转到下一个，便于快速批量选择（[#38](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F38)）\n- 使用复制快捷键 `y` 时，现在会复制所有已选中的 Bean，而不仅仅是高亮显示的那个（[#37](https:\u002F\u002Fg","2026-02-07T19:29:55",{"id":180,"version":181,"summary_zh":182,"released_at":183},197735,"v0.3.4","本次发布带来了多项提升使用体验的改进，让 Beans 更加易于操作，尤其是在深度参与代理式工作流时。最引人注目的变化包括：在 TUI 中可快速复制 Bean ID，以及在任何地方均可使用简短 ID 的灵活性。\n\n## 亮点\n\n**只需一次按键即可复制 Bean ID** — 在 TUI 中按下 `y` 键，即可将当前 Bean 的 ID 复制到剪贴板。这使得在提交信息、文档中引用 Bean，或通过 CLI 操作时，引用 Bean 变得轻而易举。（[#26](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F26)）\n\n**简短 ID 随处可用** — 现在，在通过 GraphQL 查询时，您可以直接使用 ID 部分（例如 `abc1`），而无需输入完整的 `beans-abc1` 格式。这减少了输入量，使命令更加便捷舒适。（[93b6df0](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F93b6df0)）\n\n## 其他改进\n\n**文档**\n- 澄清了完成规则：未勾选待办事项的 Beans 不应被标记为已完成。这一点对于代理式工作流尤为重要，因为代理需要明确的指导来判断工作是否真正完成。（[#27](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F27)）\n\n## 更改日志\n### 功能\n* a3d95ebe5564a7a696de71735663d9c310bd346c: feat(tui): 添加 'y' 快捷键以复制 Bean ID (#26) (@sotte)\n* 1eb1f04ea066e51caf92b0ce07804e5fed51f4a0: feat: 为代理专用的 Beans 新增用于初始化输出的 Bean (@hmans)\n* 93b6df053a676068d26d7c99034ea64e92a035f1: feat: 支持在 GraphQL 查询中使用不带前缀的简短 ID (@hmans)\n\n\n---\n由 [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser) 发布。","2025-12-25T12:34:23",{"id":185,"version":186,"summary_zh":187,"released_at":188},197736,"v0.3.3","本次发布重点在于文件监听系统的性能优化，使得在使用 TUI 同时编辑 Beans 文件时，Beans 的响应更加灵敏。此外，我们还新增了对 OpenCode 集成的支持。\n\n## 亮点\n\n**更智能的文件监听** — 文件监听器已进行全面重构。过去，只要有任何文件发生变化，Beans 就会重新加载所有文件；而现在，它只会处理受影响的文件，并以增量方式更新搜索索引。这带来了更快的响应速度，尤其是在包含大量 Beans 文件的项目中。([f3b56cd](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002Ff3b56cd))\n\n**基于通道的事件订阅** — 新的监听器采用了扇出模式，多个订阅者（如 TUI）各自拥有独立的、带有类型化事件（创建、更新、删除）的事件通道。这样一来，处理较慢的订阅者不会再阻塞其他订阅者，同时 API 也更加简洁：`Subscribe()` 现在会返回一个事件通道和一个取消订阅函数。([63bd573](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F63bd573))\n\n**OpenCode 集成** — 我们为 OpenCode 用户添加了一个 `beans-prime.ts` 插件。只需将其放入项目的 `.opencode\u002Fplugin\u002F` 目录下（或全局的 `~\u002F.opencode\u002Fplugin\u002F`），即可在会话启动时为您的 AI 助手提供 Beans 上下文信息。([2eabadd](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F2eabadd))\n\n## 其他改进\n\n- 优化了 `beans prime` 提示词，使代理指令更加清晰。([bf9a4ec](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002Fbf9a4ec))\n\n## Bug 修复\n\n- 监听器中的边缘情况现已得到妥善处理：对同一文件的快速连续更新会被正确合并，创建加删除的操作序列也能被正确处理，而无效文件则会被跳过，不会导致监听器崩溃。\n\n## 更改日志\n### 功能\n* 63bd573b2f30e56d0688131fd320b017a9b6bc9e: feat: 添加基于通道的文件监听器，支持类型化事件 (@hmans)\n### Bug 修复\n* bf9a4ec071d109ba71c557e4f9664e1eacc25649: fix: 调整 `beans prime` 提示词 (@hmans)\n### 性能\n* f3b56cd3afe48cd23703bb99cec2cf394347f2d6: perf: 使用增量方式更新 beancore 状态，而非全量重新加载 (@hmans)\n\n\n---\n由 [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser) 发布。","2025-12-20T15:53:36",{"id":190,"version":191,"summary_zh":192,"released_at":193},197737,"v0.3.2","## 更改日志\n### 错误修复\n* 76dc94a371bd765e203171c7ac4f292fefae7726：修复（TUI）：当创建模态框打开时，按 Q 不再退出（@hmans）\n\n\n---\n由 [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser) 发布。\n","2025-12-14T20:28:02",{"id":195,"version":196,"summary_zh":197,"released_at":198},197738,"v0.3.1","## 更改日志\n### 错误修复\n* 7b07650b3255481b72a9b820b69a2b73ed581871：修复：从 TUI 列表视图中移除列标题（@hmans）\n\n\n---\n由 [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser) 发布。\n","2025-12-13T23:11:41",{"id":200,"version":201,"summary_zh":202,"released_at":203},197739,"v0.3.0","https:\u002F\u002Fgithub.com\u002Fuser-attachments\u002Fassets\u002F46634779-4b80-495c-92ec-a6695369f584\n\n本次发布对 TUI 体验进行了重大改进，使您能够更快速、更直观地直接在终端中操作 Beans。现在，您无需离开 TUI 即可管理 Bean 的几乎所有方面：状态、类型、优先级、父级以及阻塞关系，都配备了专门的键盘快捷键。\n\n更多 CLI 命令现已在内部使用 GraphQL，GraphQL 模式也新增了过滤和变更功能，您的代理可以利用这些功能实现高效交互。\n\n此外，我们还添加了全文搜索索引，支持模糊搜索，让您和您的代理都能更快地找到所需数据。\n\n## 破坏性变更\n\n目前 Beans 尚处于早期阶段，因此本次发布仍包含一些破坏性变更。\n\n**简化 Bean 链接方式** — Bean 之间的链接方式已彻底重构。旧的 `links` 字段已被移除，取而代之的是明确的 `parent` 和 `blocking` 字段。这使得关系更加清晰，也更易于操作。如果您现有 Bean 使用旧格式，则需要手动迁移（或请您的代理帮忙完成；通常代理能很好地处理此类任务）。([#17](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fpull\u002F17))\n\n**将“backlog”状态更名为“draft”** — `backlog` 状态现更名为 `draft`，以更好地反映其作为暂存区的用途，用于存放尚需完善、尚未准备好投入工作的 Bean。请更新所有引用旧状态名称的脚本或工作流。([3673945](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F3673945))\n\n**将 `beans query` 命令重命名为 `beans graphql`** — 用于执行 GraphQL 查询的命令已更名为更能准确描述其功能的名称。([ddb1754](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002Fddb1754))\n\n## 亮点\n\n**TUI 中的全功能选择器模态框**：按下 `s` 键可更改状态，`t` 键用于更改类型，`P` 键用于设置优先级，`p` 键用于指定父级，`b` 键则用于管理阻塞关系。每个选项都会打开一个专注的选择器模态框，让您可以即时完成修改。无需再为了简单的更新而切换到命令行界面。([ad3382e](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002Fad3382e), [8910c67](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F8910c67), [95710b8](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F95710b8), [2bfe0fe](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F2bfe0fe), [9565a9c](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F9565a9c))\n\n**多选批量编辑** — 使用空格键选择多个 Bean，然后一次性对所有选中的 Bean 应用更改。非常适合对一批 Bug 进行分类处理，或将多项任务批量移至进行中状态。([8fd3d29](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F8fd3d29))\n\n**在 TUI 中创建和编辑 Bean** — 按下 `c` 键可创建新 Bean（默认状态为草稿），或按下 `e` 键在您的编辑器中打开当前 Bean。保存并关闭后，更改会自动被检测到。([5c6f192](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fcommit\u002F5c6f192), [10c805d](https:\u002F\u002Fgithub.com\u002Fhmans\u002Fbeans\u002Fco","2025-12-13T16:51:57",{"id":205,"version":206,"summary_zh":207,"released_at":208},197740,"v0.2.0","## 更改日志\n### 功能\n* 6dc609deecdb27c5c90cccc53b63d233c9c0cfe5: 新增功能：在 Bean 列表中添加树形视图 (@hmans)\n* 529f05347236eaff7005a241a079e887a6bc63ee: 新增功能：在 Bean TUI 中添加树形视图 (@hmans)\n* 8feefe6fa520801927537877b5f13eb4e41fdd4f: 新增功能：提供 Claude Code 插件市场 (#13) (@hmans)\n\n\n---\n由 [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser) 发布。\n","2025-12-12T07:57:20",{"id":210,"version":211,"summary_zh":212,"released_at":213},197741,"v0.1.32","## 更改日志\n### ⚠️ 重大变更\n* 129438e7f72ae942ab86d256e461ccadeca41f96: 功能性更新：从 beans update 中移除 $EDITOR 集成 (@hmans)\n* 64524b4e13fb6917079c4d67c4572cb4f07ebd07: 功能性更新：将 `beans prompt` 重命名为 `beans prime` (@hmans)\n### 功能特性\n* c823e32a2ba60c04f85726bf6bdac189af52e4a9: 功能性更新：为 bean 的 CRUD 操作添加 GraphQL mutation (@hmans)\n* bf738c44dbd7a1751139820d243bed09fb056fe6: 功能性更新：使用 Bleve 添加全文搜索 (#10) (@hmans)\n* 5f7a6a6ff1c79c338606dc4a0dc7c9d48aee3580: 功能性更新：将 show 和 roadmap 命令迁移至使用 GraphQL (@hmans)\n### 错误修复\n* ce8c3c75cec22c61becaf04cbaa4f6cbc1d30f4e: 修复：放宽提示对 TodoWrite 的要求 (@hmans)\n### 其他\n* b3c576b0ab468855968aa43a19639fd43a80a57a: 重构：简化 create、update、delete 命令 (@hmans)\n\n\n---\n由 [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser) 发布。\n","2025-12-11T17:02:59",{"id":215,"version":216,"summary_zh":217,"released_at":218},197742,"v0.1.31","## 更改日志\n### ⚠️ 重大变更\n* 3c5a3b8d3784ce548f7994b87c460e44fe302960: 新功能：将模块路径更改为 github.com\u002Fhmans\u002Fbeans (@hmans)\n### 错误修复\n* 74558d8e64d515a20d542571b3d8ebde05875f9d: 修复：重新排序状态，优先显示正在进行的工作 (@hmans)\n* 51228beaaecc72ccc45b9709c7e9c056fbbaf551: 修复：路线图现在会显示所有计划中的工作，包括孤立项目 (@hmans)\n\n\n---\n由 [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser) 发布。\n","2025-12-09T11:35:40",{"id":220,"version":221,"summary_zh":222,"released_at":223},197743,"v0.1.30","## Changelog\n### ⚠️ Breaking Changes\n* f828f6dc627012f400d313bc6b3ddcc009e61839: feat!: enforce single parent constraint for beans (@hmans)\n* 9214ff129721653bb577a432948edf907a665517: fix!: make GraphQL Bean fields non-nullable with defaults (@hmans)\n### Other\n* bddca9800554e4ab565535d3a064ef8efd1e13b6: refactor: use GraphQL resolver pattern in TUI package (@hmans)\n* 21d82bf7a23d30bc8200b5567ea49eded11bf12b: refactor: use text\u002Ftemplate for prompt command (@hmans)\n\n\n---\nReleased by [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser).\n","2025-12-09T09:11:28",{"id":225,"version":226,"summary_zh":227,"released_at":228},197744,"v0.1.29","## Changelog\n### ⚠️ Breaking Changes\n* 3c13cd0bcc51f697ab26ef76ee37497b6ba168ad: fix!: return error from beans query on GraphQL errors (@hmans)\n\n\n---\nReleased by [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser).\n","2025-12-08T22:33:45",{"id":230,"version":231,"summary_zh":232,"released_at":233},197745,"v0.1.28","## Changelog\n### ⚠️ Breaking Changes\n* c6e3f952d9e5af78cdc11b169c00aa9b4914e22f: fix!: remove interactive TUI from beans create command (#8) (@hmans)\n### Features\n* 36640d1092af534e58f7a37290aa6043d77adc38: feat: add GraphQL API with gqlgen (#9) (@hmans)\n\n\n---\nReleased by [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser).\n","2025-12-08T22:07:04",{"id":235,"version":236,"summary_zh":237,"released_at":238},197746,"v0.1.27","## Changelog\n### ⚠️ Breaking Changes\n* f4ae68c7dfa319ed4308962c8a0fb5a0ae54b297: fix!: make CLI short flags consistent across commands (@hmans)\n### Features\n* bc0c41ede3fc65b719920e471725c08077e498d9: feat: add link sanity checks for beans (@hmans)\n* 1bc060cf0933f0b6ba3bcfec0f349c5dd8e2a2ea: feat: add priority field to beans (@hmans)\n### Bug Fixes\n* 992a52e0b907c05895f35cc4cc952e5dce411d6f: fix: adjust status colors for better visual hierarchy (@hmans)\n### Other\n* a592f4188ebc8bf57302f93778d27fe0112ec78d: refactor: remove deprecated SortByStatusAndType function (@hmans)\n\n\n---\nReleased by [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser).\n","2025-12-08T19:10:54",{"id":240,"version":241,"summary_zh":242,"released_at":243},197747,"v0.1.26","## Changelog\n### Bug Fixes\n* 9bd366fff89f144b3f9f69a4f3558defa4336f7c: fix: output plain array from `beans list --json` (@hmans)\n* 5b7c28bba26f4664b4c451faaa55bb3320e591b0: fix: sort linked beans by status\u002Ftype\u002Ftitle in TUI detail view (@hmans)\n### Other\n* d4861d1b0cbe2984eec1cf2aa1334a4553deb2e1: refactor: unify sorting logic between CLI and TUI (@hmans)\n\n\n---\nReleased by [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser).\n","2025-12-08T15:08:26",{"id":245,"version":246,"summary_zh":247,"released_at":248},197748,"v0.1.25","## Changelog\n### ⚠️ Breaking Changes\n* 5e54ee8a062ae5bb97c0f5a520f1087c2a34d29c: feat!: move config from .beans\u002Fconfig.yaml to .beans.yml at project root (@hmans)\n### Features\n* aab607e65bf88086f89525f8f63a257f7319800b: feat: Show allowed status and type values in CLI help (@hmans)\n### Bug Fixes\n* 541827ea5dda1ce342531d80335df4dc8ab956ca: fix: Update CLI and tests to use new status names (@hmans)\n\n\n---\nReleased by [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser).\n","2025-12-08T14:36:04",{"id":250,"version":251,"summary_zh":252,"released_at":253},197749,"v0.1.24","## Changelog\n### Features\n* 17bbe00c849c4f54d5551eb8b42eab6ced95dbc9: feat: Hardcode bean statuses, remove configurability (@hmans)\n* 3c731170b2783a48b7fefc0c465e4f9ea196d550: feat: Hardcode bean types, remove configurability (@hmans)\n### Bug Fixes\n* c0d62e6dbb7bd59cd5106f87f7880a35c055bcd4: fix: Make `beans prompt` silently exit when no .beans directory exists (@hmans)\n\n\n---\nReleased by [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser).\n","2025-12-08T14:00:47",{"id":255,"version":256,"summary_zh":257,"released_at":258},197750,"v0.1.23","## Changelog\n### Features\n* aaef5048c005209e0502f952adf7be045c46616d: feat: Add --type\u002F-t filter to list command (@hmans)\n* 8d57b956edc9079f4f811d6fcf7001108822c3aa: feat: Add `beans roadmap` command (#7) (@hmans)\n### Bug Fixes\n* 20e0062a98d863825811cec8270b6de16060f99f: fix: Correct --linked-as filter logic for type:id format (@hmans)\n\n\n---\nReleased by [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser).\n","2025-12-08T13:02:35",{"id":260,"version":261,"summary_zh":262,"released_at":263},197751,"v0.1.22","## Changelog\n### Features\n* 3e878f69b0a9492d7b9a72949d77d2cece25082c: feat: Add default_type configuration setting (@hmans)\n* 22dbdb2b902641b033b33a1444477d708b054613: feat: Reorder default statuses and types for better TUI sorting (@hmans)\n* 414d6bdb80318ac3ea4b8c68cfd497e8d99332c0: feat: Sort TUI bean list by status, then by type (@hmans)\n\n\n---\nReleased by [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser).\n","2025-12-07T22:01:42",{"id":265,"version":266,"summary_zh":267,"released_at":268},197752,"v0.1.21","## Changelog\n### Features\n* f8baa1f9246e9daceb3498ce6d0a49ba17ddabad: feat: Add filtering to linked beans list in TUI (@hmans)\n\n\n---\nReleased by [GoReleaser](https:\u002F\u002Fgithub.com\u002Fgoreleaser\u002Fgoreleaser).\n","2025-12-07T21:37:31"]