[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-mitsuhiko--agent-stuff":3,"tool-mitsuhiko--agent-stuff":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 真正成长为懂上",147882,2,"2026-04-09T11:32: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 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108111,"2026-04-08T11:23:26",[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},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":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":72,"owner_website":79,"owner_url":80,"languages":81,"stars":106,"forks":107,"last_commit_at":108,"license":109,"difficulty_score":110,"env_os":111,"env_gpu":112,"env_ram":112,"env_deps":113,"category_tags":125,"github_topics":126,"view_count":32,"oss_zip_url":126,"oss_zip_packed_at":126,"status":17,"created_at":127,"updated_at":128,"faqs":129,"releases":165},5938,"mitsuhiko\u002Fagent-stuff","agent-stuff","These are commands I use with agents, mostly Claude","agent-stuff 是一套专为 AI 编程助手（特别是 Claude 和 Pi Coding Agent）设计的技能库与扩展集合。它旨在解决通用大模型在特定开发场景中能力不足的问题，通过预定义的指令让 AI 能够直接操作本地工具、查询外部 API 并执行复杂工作流。\n\n这套工具非常适合开发者使用，能显著提升日常编码效率。它内置了丰富的实用技能：从自动化 Git 提交、前端界面设计、代码审查，到调用 Sentry 分析错误、查询奥地利公共交通信息，甚至控制浏览器和逆向工程二进制文件。此外，它还提供了针对 Pi 代理的深度扩展，支持多文件批量编辑、会话分叉管理、交互式问答界面以及深夜操作安全确认等功能。\n\nagent-stuff 的独特亮点在于其高度的模块化和实战性。它将分散的开发任务封装为标准化的\"Skills\"，让 AI 像熟练工程师一样调用 gh CLI、Ghidra 或 OpenSCAD 等专业工具。同时，其扩展机制增强了人机交互体验，例如提供可视化的上下文令牌分析和原生桌面通知。虽然部分脚本可能需要根据具体项目微调，但它为构建个性化、高效率的 AI 开发环境提供了坚实的基础。","# Agent Stuff\n\nThis repository contains skills and extensions that I use across projects. Note that I often fine-tune these for specific repos, so some items may need small adjustments before reuse.\n\nIt is released on npm as `mitsupi` for use with the [Pi](https:\u002F\u002Fbuildwithpi.ai\u002F) package loader.\n\n## Skills\n\nAll skills live in the [`skills`](skills) folder:\n\n* [`\u002Fanachb`](skills\u002Fanachb) - Query Austrian public transport (VOR AnachB) for departures, routes, and disruptions.\n* [`\u002Fapple-mail`](skills\u002Fapple-mail) - Search\u002Fread Apple Mail local storage and extract attachments.\n* [`\u002Fcommit`](skills\u002Fcommit) - Create git commits using concise Conventional Commits-style subjects.\n* [`\u002Ffrontend-design`](skills\u002Ffrontend-design) - Design and implement distinctive frontend interfaces.\n* [`\u002Fghidra`](skills\u002Fghidra) - Reverse engineer binaries using Ghidra's headless analyzer.\n* [`\u002Fgithub`](skills\u002Fgithub) - Interact with GitHub using the `gh` CLI (issues, PRs, runs, APIs).\n* [`\u002Fgoogle-workspace`](skills\u002Fgoogle-workspace) - Access Google Workspace APIs via local helper scripts.\n* [`\u002Flibrarian`](skills\u002Flibrarian) - Cache and refresh remote git repositories in `~\u002F.cache\u002Fcheckouts`.\n* [`\u002Fmermaid`](skills\u002Fmermaid) - Create and validate Mermaid diagrams with Mermaid CLI tooling.\n* [`\u002Fnative-web-search`](skills\u002Fnative-web-search) - Trigger native web search with concise summaries and source URLs.\n* [`\u002Foebb-scotty`](skills\u002Foebb-scotty) - Plan Austrian rail journeys via ÖBB Scotty API.\n* [`\u002Fopenscad`](skills\u002Fopenscad) - Create\u002Frender OpenSCAD models and export STL files.\n* [`\u002Fpi-share`](skills\u002Fpi-share) - Load and parse session transcripts from shittycodingagent.ai\u002Fbuildwithpi\u002Fpi.dev URLs.\n* [`\u002Fsentry`](skills\u002Fsentry) - Fetch and analyze Sentry issues, events, transactions, and logs.\n* [`\u002Fsummarize`](skills\u002Fsummarize) - Convert files\u002FURLs to Markdown via `uvx markitdown` and summarize.\n* [`\u002Ftmux`](skills\u002Ftmux) - Drive tmux sessions via keystrokes and pane output scraping.\n* [`\u002Fupdate-changelog`](skills\u002Fupdate-changelog) - Update changelogs with notable user-facing changes.\n* [`\u002Fuv`](skills\u002Fuv) - Use `uv` for Python dependency management and script execution.\n* [`\u002Fweb-browser`](skills\u002Fweb-browser) - Browser automation via Chrome\u002FChromium CDP.\n\n## Pi Coding Agent Extensions\n\nCustom extensions for Pi Coding Agent are in [`pi-extensions`](pi-extensions):\n\n* [`answer.ts`](pi-extensions\u002Fanswer.ts) - Interactive TUI for answering questions one by one.\n* [`btw.ts`](pi-extensions\u002Fbtw.ts) - Simple `\u002Fbtw` side-chat popover with optional summary injection back into the main chat on close.\n* [`context.ts`](pi-extensions\u002Fcontext.ts) - Context breakdown (extensions, skills, AGENTS.md\u002FCLAUDE.md) + token usage, including loaded-skill highlighting.\n* [`control.ts`](pi-extensions\u002Fcontrol.ts) - Session control helpers (list controllable sessions, etc.).\n* [`files.ts`](pi-extensions\u002Ffiles.ts) - Unified file browser with git status + session references and reveal\u002Fopen\u002Fedit\u002Fdiff actions.\n* [`split-fork.ts`](pi-extensions\u002Fsplit-fork.ts) - `\u002Fsplit-fork` command to branch the current session into a new pi process in a right-hand Ghostty split.\n* [`go-to-bed.ts`](pi-extensions\u002Fgo-to-bed.ts) - Late-night safety guard with explicit confirmation after midnight.\n* [`loop.ts`](pi-extensions\u002Floop.ts) - Prompt loop for rapid iterative coding with optional auto-continue.\n* [`multi-edit.ts`](pi-extensions\u002Fmulti-edit.ts) - Replaces the built-in `edit` tool with batch `multi` edits and Codex-style `patch` support, including preflight validation.\n* [`notify.ts`](pi-extensions\u002Fnotify.ts) - Native desktop notifications when the agent finishes.\n* [`prompt-editor.ts`](pi-extensions\u002Fprompt-editor.ts) - In-editor prompt mode selector with persistence, history, config, and shortcuts.\n* [`review.ts`](pi-extensions\u002Freview.ts) - Code review command (working tree, PR-style diff, commits, custom instructions, optional fix loop).\n* [`session-breakdown.ts`](pi-extensions\u002Fsession-breakdown.ts) - TUI for 7\u002F30\u002F90-day session and cost analysis with usage graph.\n* [`todos.ts`](pi-extensions\u002Ftodos.ts) - Todo manager extension with file-backed storage and TUI.\n* [`uv.ts`](pi-extensions\u002Fuv.ts) - Helpers for uv-based Python workflows.\n* [`whimsical.ts`](pi-extensions\u002Fwhimsical.ts) - Replaces the default thinking message with random whimsical phrases.\n\n## Pi Coding Agent Themes\n\nCustom themes are in [`pi-themes`](pi-themes):\n\n* [`nightowl.json`](pi-themes\u002Fnightowl.json) - Night Owl-inspired theme.\n\n## Plumbing Commands\n\nThese command files need customization before use. They live in [`plumbing-commands`](plumbing-commands):\n\n* [`\u002Fmake-release`](plumbing-commands\u002Fmake-release.md) - Automates repository release with version management.\n\n## Intercepted Commands\n\nCommand wrappers live in [`intercepted-commands`](intercepted-commands):\n\n* [`pip`](intercepted-commands\u002Fpip)\n* [`pip3`](intercepted-commands\u002Fpip3)\n* [`poetry`](intercepted-commands\u002Fpoetry)\n* [`python`](intercepted-commands\u002Fpython)\n* [`python3`](intercepted-commands\u002Fpython3)\n","# 代理相关\n\n此仓库包含我在各个项目中使用的技能和扩展。请注意，我经常会针对特定的代码库对这些内容进行微调，因此在复用之前可能需要做一些小调整。\n\n它已在 npm 上以 `mitsupi` 的名义发布，供与 [Pi](https:\u002F\u002Fbuildwithpi.ai\u002F) 包管理器一起使用。\n\n## 技能\n\n所有技能都位于 [`skills`](skills) 文件夹中：\n\n* [`\u002Fanachb`](skills\u002Fanachb) - 查询奥地利公共交通（VOR AnachB）的发车信息、路线及中断情况。\n* [`\u002Fapple-mail`](skills\u002Fapple-mail) - 搜索并读取 Apple Mail 的本地存储，提取附件。\n* [`\u002Fcommit`](skills\u002Fcommit) - 使用简洁的 Conventional Commits 风格主题创建 Git 提交。\n* [`\u002Ffrontend-design`](skills\u002Ffrontend-design) - 设计并实现具有特色的前端界面。\n* [`\u002Fghidra`](skills\u002Fghidra) - 使用 Ghidra 的无头分析工具对二进制文件进行逆向工程。\n* [`\u002Fgithub`](skills\u002Fgithub) - 使用 `gh` CLI 与 GitHub 进行交互（问题、PR、工作流、API）。\n* [`\u002Fgoogle-workspace`](skills\u002Fgoogle-workspace) - 通过本地辅助脚本访问 Google Workspace API。\n* [`\u002Flibrarian`](skills\u002Flibrarian) - 在 `~\u002F.cache\u002Fcheckouts` 中缓存并刷新远程 Git 仓库。\n* [`\u002Fmermaid`](skills\u002Fmermaid) - 使用 Mermaid CLI 工具创建并验证 Mermaid 图表。\n* [`\u002Fnative-web-search`](skills\u002Fnative-web-search) - 触发原生网络搜索，并提供简明摘要和来源 URL。\n* [`\u002Foebb-scotty`](skills\u002Foebb-scotty) - 通过 ÖBB Scotty API 规划奥地利铁路行程。\n* [`\u002Fopenscad`](skills\u002Fopenscad) - 创建并渲染 OpenSCAD 模型，导出 STL 文件。\n* [`\u002Fpi-share`](skills\u002Fpi-share) - 从 shittycodingagent.ai\u002Fbuildwithpi\u002Fpi.dev 等 URL 加载并解析会话记录。\n* [`\u002Fsentry`](skills\u002Fsentry) - 获取并分析 Sentry 中的问题、事件、事务及日志。\n* [`\u002Fsummarize`](skills\u002Fsummarize) - 通过 `uvx markitdown` 将文件或 URL 转换为 Markdown 格式，并进行摘要总结。\n* [`\u002Ftmux`](skills\u002Ftmux) - 通过快捷键和窗格输出抓取来操作 tmux 会话。\n* [`\u002Fupdate-changelog`](skills\u002Fupdate-changelog) - 更新变更日志，记录重要的用户可见变更。\n* [`\u002Fuv`](skills\u002Fuv) - 使用 `uv` 进行 Python 依赖管理及脚本执行。\n* [`\u002Fweb-browser`](skills\u002Fweb-browser) - 通过 Chrome\u002FChromium CDP 实现浏览器自动化。\n\n## Pi 编码代理扩展\n\nPi 编码代理的自定义扩展位于 [`pi-extensions`](pi-extensions) 文件夹中：\n\n* [`answer.ts`](pi-extensions\u002Fanswer.ts) - 交互式 TUI，用于逐一回答问题。\n* [`btw.ts`](pi-extensions\u002Fbtw.ts) - 简单的 `\u002Fbtw` 侧边聊天浮窗，关闭时可选择将摘要注入主聊天。\n* [`context.ts`](pi-extensions\u002Fcontext.ts) - 上下文分解（扩展、技能、AGENTS.md\u002FCLAUDE.md）+ 令牌使用情况，包括已加载技能的高亮显示。\n* [`control.ts`](pi-extensions\u002Fcontrol.ts) - 会话控制助手（列出可控制的会话等）。\n* [`files.ts`](pi-extensions\u002Ffiles.ts) - 统一的文件浏览器，显示 Git 状态、会话引用，并提供显示、打开、编辑和差异比较等操作。\n* [`split-fork.ts`](pi-extensions\u002Fsplit-fork.ts) - `\u002Fsplit-fork` 命令，用于将当前会话分支到右侧 Ghostty 分割中的新 pi 进程。\n* [`go-to-bed.ts`](pi-extensions\u002Fgo-to-bed.ts) - 午夜后的安全防护机制，需明确确认后方可执行。\n* [`loop.ts`](pi-extensions\u002Floop.ts) - 快速迭代编码的提示循环，可选自动继续功能。\n* [`multi-edit.ts`](pi-extensions\u002Fmulti-edit.ts) - 替换内置的 `edit` 工具，支持批量 `multi` 编辑和 Codex 风格的 `patch` 功能，包含预检验证。\n* [`notify.ts`](pi-extensions\u002Fnotify.ts) - 当代理完成任务时发送原生桌面通知。\n* [`prompt-editor.ts`](pi-extensions\u002Fprompt-editor.ts) - 编辑器内提示模式选择器，具备持久化、历史记录、配置和快捷键功能。\n* [`review.ts`](pi-extensions\u002Freview.ts) - 代码审查命令（工作树、PR 风格的差异、提交记录、自定义指令，可选修复循环）。\n* [`session-breakdown.ts`](pi-extensions\u002Fsession-breakdown.ts) - TUI，用于分析 7\u002F30\u002F90 天的会话及成本，并显示使用情况图表。\n* [`todos.ts`](pi-extensions\u002Ftodos.ts) - 待办事项管理扩展，采用文件存储并配有 TUI。\n* [`uv.ts`](pi-extensions\u002Fuv.ts) - 用于基于 uv 的 Python 工作流的辅助工具。\n* [`whimsical.ts`](pi-extensions\u002Fwhimsical.ts) - 将默认的思考消息替换为随机的奇思妙想语句。\n\n## Pi 编码代理主题\n\n自定义主题位于 [`pi-themes`](pi-themes) 文件夹中：\n\n* [`nightowl.json`](pi-themes\u002Fnightowl.json) - 受猫头鹰启发的主题。\n\n## 公共服务命令\n\n这些命令文件在使用前需要进行定制。它们位于 [`plumbing-commands`](plumbing-commands) 文件夹中：\n\n* [`\u002Fmake-release`](plumbing-commands\u002Fmake-release.md) - 自动化仓库发布流程，包含版本管理。\n\n## 拦截命令\n\n命令包装器位于 [`intercepted-commands`](intercepted-commands) 文件夹中：\n\n* [`pip`](intercepted-commands\u002Fpip)\n* [`pip3`](intercepted-commands\u002Fpip3)\n* [`poetry`](intercepted-commands\u002Fpoetry)\n* [`python`](intercepted-commands\u002Fpython)\n* [`python3`](intercepted-commands\u002Fpython3)","# Agent Stuff 快速上手指南\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**: macOS 或 Linux (部分技能如 `apple-mail` 仅限 macOS)。\n*   **Node.js & npm**: 用于安装核心包。\n*   **Pi Coding Agent**: 本项目专为 [Pi](https:\u002F\u002Fbuildwithpi.ai\u002F) 智能体框架设计，需已安装并配置好 Pi 环境。\n*   **基础工具依赖**:\n    *   `git`: 版本控制。\n    *   `uv`: Python 包管理及脚本执行（推荐）。\n    *   `gh`: GitHub CLI。\n    *   `tmux`: 终端复用器。\n    *   `chrome`\u002F`chromium`: 用于浏览器自动化技能。\n    *   其他特定技能依赖（如 `ghidra`, `openscad`, `mermaid-cli` 等）需根据实际需求单独安装。\n\n> **注意**：部分技能针对特定仓库进行了微调，复用前可能需要根据本地路径或 API 密钥进行少量配置调整。\n\n## 安装步骤\n\n本项目通过 npm 发布为 `mitsupi` 包，以便与 Pi 的包加载器协同工作。\n\n1.  **使用 npm 安装核心包**：\n    ```bash\n    npm install -g mitsupi\n    ```\n\n2.  **克隆源码（可选，用于自定义技能）**：\n    如果您需要修改技能或查看扩展源码，建议克隆仓库：\n    ```bash\n    git clone https:\u002F\u002Fgithub.com\u002Fmitsupi\u002Fagent-stuff.git\n    cd agent-stuff\n    ```\n\n3.  **配置 Pi 加载器**：\n    确保您的 Pi 配置文件（通常在 `~\u002F.pi\u002Fconfig.json` 或项目根目录的 `AGENTS.md` \u002F `CLAUDE.md` 中）已指向安装的 `mitsupi` 包或本地技能目录 (`skills`) 和扩展目录 (`pi-extensions`)。\n\n## 基本使用\n\n安装完成后，技能将自动集成到 Pi Coding Agent 会话中。您可以通过自然语言指令直接调用。\n\n### 1. 调用技能 (Skills)\n\n在 Pi 对话中直接描述需求，Agent 会自动匹配对应的技能。\n\n*   **示例：创建 Git 提交**\n    ```text\n    请使用 conventional commits 风格为当前的更改创建一个简洁的提交信息。\n    ```\n    *(触发 `\u002Fcommit` 技能)*\n\n*   **示例：查询奥地利公共交通**\n    ```text\n    查询从 Vienna 到 Salzburg 明天的火车班次。\n    ```\n    *(触发 `\u002Foebb-scotty` 或 `\u002Fanachb` 技能)*\n\n*   **示例：生成 Mermaid 图表**\n    ```text\n    画一个流程图，展示用户登录系统的过程。\n    ```\n    *(触发 `\u002Fmermaid` 技能)*\n\n*   **示例：管理 Python 依赖**\n    ```text\n    使用 uv 安装 requests 库并运行当前脚本。\n    ```\n    *(触发 `\u002Fuv` 技能)*\n\n### 2. 使用扩展命令 (Extensions)\n\n部分扩展提供了特定的 slash 命令，可在对话中直接使用：\n\n*   **代码审查**：\n    ```text\n    \u002Freview\n    ```\n    *(启动代码审查流程，支持工作区差异、PR 风格对比等)*\n\n*   **多文件编辑**：\n    ```text\n    \u002Fmulti-edit\n    ```\n    *(启用批量编辑模式，支持 Codex 风格的 patch)*\n\n*   **会话分支**：\n    ```text\n    \u002Fsplit-fork\n    ```\n    *(将当前会话分支到右侧 Ghostty 分割窗口的一个新 Pi 进程中)*\n\n*   **待办事项管理**：\n    ```text\n    \u002Ftodos\n    ```\n    *(打开基于文件的待办事项管理器 TUI)*\n\n### 3. 拦截命令 (Intercepted Commands)\n\n项目包含对常用命令的包装器（位于 `intercepted-commands`），旨在优化 Pi 对这些工具的调用行为。当 Agent 执行以下命令时，会自动应用增强逻辑：\n\n*   `pip` \u002F `pip3`\n*   `poetry`\n*   `python` \u002F `python3`\n\n无需额外操作，直接在对话中让 Agent 执行相关命令即可生效。","一位全栈开发者正在紧急修复一个涉及前端界面、后端逻辑及部署流程的复杂生产事故，需要同时处理代码审查、依赖更新和日志分析。\n\n### 没有 agent-stuff 时\n- 开发者需手动切换多个终端窗口，分别运行 Git 命令、查询 Sentry 日志和调用浏览器自动化脚本，上下文频繁断裂。\n- 编写符合规范的 Commit 信息和更新 Changelog 完全依靠人工记忆格式，容易出错且耗时。\n- 面对大量报错日志和代码文件，缺乏自动摘要工具，只能逐行阅读以定位核心问题，效率极低。\n- 进行多文件批量修改时，原生编辑工具缺乏预检机制，极易引入新的语法错误或破坏现有逻辑。\n- 深夜加班时缺乏安全守护机制，Agent 可能在无人确认的情况下执行高风险操作或无限循环运行。\n\n### 使用 agent-stuff 后\n- 通过 `\u002Fsentry` 和 `\u002Fweb-browser` 技能直接在对话中拉取错误日志并复现问题，配合 `\u002Ftmux` 统一管控会话，工作流无缝衔接。\n- 调用 `\u002Fcommit` 和 `\u002Fupdate-changelog` 自动生成标准化的提交信息与用户可见变更说明，确保版本记录规范一致。\n- 利用 `\u002Fsummarize` 技能将冗长的日志文件和 URL 快速转换为清晰的 Markdown 摘要，秒级锁定故障根源。\n- 启用 `multi-edit` 扩展进行批量代码修补，内置的前置验证和 Patch 支持有效避免了人为失误导致的二次故障。\n- 激活 `go-to-bed` 和 `loop` 扩展，既限制了午夜后的高危操作需显式确认，又实现了迭代编码的自动续跑，兼顾安全与效率。\n\nagent-stuff 通过将分散的开发技能封装为标准化指令，将原本碎片化的应急排查过程转变为流畅、安全且高度自动化的闭环工作流。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fmitsuhiko_agent-stuff_b6f7dc33.png","mitsuhiko","Armin Ronacher","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fmitsuhiko_4c27504f.png","Software developer and Open Source nut. Creator of the Flask framework. Founder of @earendil-works. Other things of interest: @pallets and @getsentry","Earendil","Austria","armin.ronacher@active-4.com","https:\u002F\u002Flucumr.pocoo.org\u002F","https:\u002F\u002Fgithub.com\u002Fmitsuhiko",[82,86,90,94,98,102],{"name":83,"color":84,"percentage":85},"TypeScript","#3178c6",61,{"name":87,"color":88,"percentage":89},"JavaScript","#f1e05a",22.2,{"name":91,"color":92,"percentage":93},"Shell","#89e051",10.1,{"name":95,"color":96,"percentage":97},"Java","#b07219",4.9,{"name":99,"color":100,"percentage":101},"Python","#3572A5",1,{"name":103,"color":104,"percentage":105},"OpenSCAD","#e5cd45",0.8,1937,132,"2026-04-09T11:59:43","Apache-2.0",4,"macOS, Linux","未说明",{"notes":114,"python":115,"dependencies":116},"该工具并非独立的 AI 模型，而是一套用于 'Pi Coding Agent' 的技能库和扩展插件。运行需先安装 Pi Agent 框架。部分技能依赖特定系统工具：如 macOS 专属的 Apple Mail 技能、奥地利交通查询技能、以及需要手动配置的二进制分析工具 Ghidra 和 CAD 工具 OpenSCAD。Python 依赖通过 'uv' 工具管理。","未说明 (依赖 uv 进行 Python 环境管理)",[117,118,119,120,121,122,103,123,124],"Pi Coding Agent (buildwithpi.ai)","gh (GitHub CLI)","Ghidra (headless analyzer)","Mermaid CLI","uvx markitdown","Chrome\u002FChromium (CDP)","tmux","Ghostty (可选，用于 split-fork)",[13,52],null,"2026-03-27T02:49:30.150509","2026-04-10T01:04:52.846416",[130,135,140,145,150,155,160],{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},26943,"如何从本地 Git 仓库或特定标签版本安装扩展？","可以使用 `pi install` 命令直接从 Git 仓库安装特定标签的版本。例如，安装 v1.2.0 版本的命令如下：\n\n```\npi install git:github.com\u002Fmitsuhiko\u002Fagent-stuff@v1.2.0\n```\n\n该命令会将包安装在 `~\u002F.pi\u002Fagent\u002Fgit\u002F` 目录下，你可以通过运行 `pi list` 来验证安装结果。更多示例可以运行 `pi install --help` 查看。","https:\u002F\u002Fgithub.com\u002Fmitsuhiko\u002Fagent-stuff\u002Fissues\u002F7",{"id":136,"question_zh":137,"answer_zh":138,"source_url":139},26944,"Python 拦截器导致无限递归生成 uv 进程怎么办？","这是因为 `uv` 扩展将拦截命令目录添加到了 PATH 中，导致名为 `python` 的脚本优先于系统真实的二进制文件被调用，从而形成递归循环。\n\n临时解决方案是在 `.pi\u002Fagent\u002Fsettings.json` 的配置数组中禁用该扩展：\n\n```json\n{\n  \"source\": \"npm:mitsupi\",\n  \"extensions\": [\"!pi-extensions\u002Fuv.ts\"]\n}\n```\n\n此外，该问题可能在主分支（main）上已修复，建议更新到最新版本。","https:\u002F\u002Fgithub.com\u002Fmitsuhiko\u002Fagent-stuff\u002Fissues\u002F13",{"id":141,"question_zh":142,"answer_zh":143,"source_url":144},26945,"遇到 'signal.addEventListener is not a function' 或 'onUpdate is not a function' 错误如何解决？","这通常是由于 `uv.ts` 扩展中的工具执行签名参数顺序与框架调用不匹配导致的（例如 v1.1.1 版本中 `signal` 和 `onUpdate` 参数位置颠倒）。\n\n解决方法是确保安装包含修复提交的最新版本（v1.2.0 或更高）。如果 npm 上尚未发布最新版，请通过 Git 安装修复后的版本：\n\n```\npi install git:github.com\u002Fmitsuhiko\u002Fagent-stuff@v1.2.0\n```\n\n或者检查你的 `uv` 版本是否与 agent 框架版本兼容。","https:\u002F\u002Fgithub.com\u002Fmitsuhiko\u002Fagent-stuff\u002Fissues\u002F9",{"id":146,"question_zh":147,"answer_zh":148,"source_url":149},26946,"Todos 扩展在更新后报错 'getEditorKeybindings is not a function' 怎么办？","这是由于 pi-tui 模块的破坏性变更导致的。该问题已在提交 `03d5bab5d118629ec49486f1137e574c793a7c79` 中修复。\n\n请确保将你的 pi coding agent 和相关扩展更新到包含此修复的最新版本。如果问题仍然存在，请检查是否混用了不同版本的依赖包。","https:\u002F\u002Fgithub.com\u002Fmitsuhiko\u002Fagent-stuff\u002Fissues\u002F31",{"id":151,"question_zh":152,"answer_zh":153,"source_url":154},26947,"如何将一个大的 Todo 任务拆分为更小的子任务？","目前扩展本身可能没有直接的按钮功能，但你可以直接要求 Agent（clanker）执行拆分操作。利用现有的功能，通过自然语言指令让 Agent 将大任务分解为如 UI 设计、逻辑处理、验证测试等较小的步骤即可。这些扩展代码也可以作为你自己编写自定义工具的灵感来源。","https:\u002F\u002Fgithub.com\u002Fmitsuhiko\u002Fagent-stuff\u002Fissues\u002F20",{"id":156,"question_zh":157,"answer_zh":158,"source_url":159},26948,"使用 GLM-5 模型时报错 'Extra inputs are not permitted, field: headers' 是什么原因？","这是因为 Pi 默认包含了 Anthropic 特有的字段（如用于提示缓存的 `headers`），而 GLM-5 (Zhipu AI) 的 API 严格校验输入架构，拒绝识别这些字段。\n\n注意：维护者表示由于不使用 GLM 模型，短期内不会专门修复此问题。建议在使用非 Anthropic 模型时，确认是否有适配器能自动剥离特有字段，或者暂时避免在该配置下使用此类模型。","https:\u002F\u002Fgithub.com\u002Fmitsuhiko\u002Fagent-stuff\u002Fissues\u002F19",{"id":161,"question_zh":162,"answer_zh":163,"source_url":164},26949,"native-web-search 技能在使用 OAuth 提供商时报错 'getOAuthApiKey loaded from wrong module' 如何解决？","这是因为技能加载 `@mariozechner\u002Fpi-ai` 模块时未找到 `getOAuthApiKey` 导出，该函数实际位于 `@mariozechner\u002Fpi-ai\u002Foauth` 子模块中。\n\n该问题已在后续版本中修复。如果你遇到此错误，请确保将 `mitsupi` 和相关技能包更新到最新版本。维护者确认：“此时应该已经修复了”。","https:\u002F\u002Fgithub.com\u002Fmitsuhiko\u002Fagent-stuff\u002Fissues\u002F14",[]]