[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-agentic-commerce-protocol--agentic-commerce-protocol":3,"tool-agentic-commerce-protocol--agentic-commerce-protocol":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":64,"owner_name":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":75,"owner_location":75,"owner_email":75,"owner_twitter":75,"owner_website":76,"owner_url":77,"languages":78,"stars":87,"forks":88,"last_commit_at":89,"license":90,"difficulty_score":91,"env_os":74,"env_gpu":92,"env_ram":92,"env_deps":93,"category_tags":96,"github_topics":75,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":97,"updated_at":98,"faqs":99,"releases":100},5886,"agentic-commerce-protocol\u002Fagentic-commerce-protocol","agentic-commerce-protocol","The Agentic Commerce Protocol (ACP) is an interaction model and open standard for connecting buyers, their AI agents, and businesses to complete purchases seamlessly. The specification is currently maintained by OpenAI and Stripe.","agentic-commerce-protocol（ACP）是由 OpenAI 和 Stripe 共同维护的开源协议，旨在为买家、其 AI 代理与商家之间搭建一座无缝交易的桥梁。在 AI 自主执行任务日益普及的今天，如何让 AI 安全、规范地替用户完成商品发现、比价及支付，是行业面临的一大挑战。ACP 通过定义一套标准化的交互模型，解决了不同系统间“语言不通”的难题，让 AI 代理无需成为商户即可直接嵌入商业交易流程，同时确保商家能利用现有基础设施触达高意向客户。\n\n该协议主要面向开发者、支付服务提供商及电商平台架构师。对于构建 AI 应用的技术人员，它提供了清晰的集成路径；对于支付机构，它定义了安全的令牌传递机制以处理代理交易。其技术亮点在于采用了基于日期的版本管理策略（如 2026-01-30），确保规范的演进透明可控，并配套提供了人类可读的 RFC 设计文档、机器可执行的 OpenAPI 接口定义以及丰富的 JSON Schema 数据模型。目前 ACP 处于 Beta 阶段，正致力于推动\"AI 代理电商”生态的标准化落地，让智能购物变得更加简单可靠。","# Agentic Commerce Protocol (ACP)\n\n[![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache%202.0-blue.svg)](LICENSE)\n[![CLA](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCLA-Required-red.svg)](legal\u002Fcla\u002F)\n[![Maintained by](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMaintained%20by-OpenAI%20%26%20Stripe-00ADD8.svg)](MAINTAINERS.md)\n[![Status](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FStatus-Beta-blue.svg)](changelog\u002F)\n\nThe **Agentic Commerce Protocol (ACP)** is an interaction model and open standard for connecting buyers, their AI agents, and businesses to complete purchases seamlessly.\n\nThe specification is [maintained](MAINTAINERS.md) by **OpenAI** and **Stripe** and is currently in `beta`.\n\n- **For businesses** - Reach more customers. Sell to high-intent buyers by making your products and services available for purchase through AI agents—all while using your existing commerce infrastructure.\n- **For AI Agents** - Embed commerce into your application. Let your users discover and transact directly with businesses in your application, without being the merchant of record.\n- **For payment providers** - Grow your volume. Process agentic transactions by passing secure payment tokens between buyers and businesses through AI agents.\n\nLearn more at [agenticcommerce.dev](https:\u002F\u002Fagenticcommerce.dev).\n\n---\n\n## 📦 Repo Structure\n\n```\nrfcs\u002F\n├── rfc.agentic_checkout.md\n├── rfc.capability_negotiation.md\n├── rfc.payment_handlers.md\n├── rfc.seller_backed_payment_handler.md\n├── rfc.extensions.md\n├── rfc.discount_extension.md\n└── ...\n\nspec\u002F\n├── 2025-09-29\u002F              # Initial release\n├── 2025-12-12\u002F              # Fulfillment enhancements\n├── 2026-01-16\u002F              # Capability negotiation\n├── 2026-01-30\u002F              # Extensions, discounts, payment handlers\n└── unreleased\u002F              # Current development\n\nexamples\u002F\n├── 2025-09-29\u002F\n├── 2025-12-12\u002F\n├── 2026-01-16\u002F\n├── 2026-01-30\u002F\n└── unreleased\u002F\n\nchangelog\u002F\n├── 2025-09-29.md\n├── 2025-12-12.md\n├── 2026-01-30.md\n└── unreleased\u002F              # Individual changelog entries (current development)\n\ndocs\u002F\n├── governance.md\n├── principles-mission.md\n└── sep-guidelines.md\n\nlegal\u002Fcla\u002F\n├── INDIVIDUAL.md\n├── CORPORATE.md\n└── SIGNATORIES.md\n```\n​\n---\n\n## 🔗 Quick Links\n\n| Spec Type          | Latest Stable                                        | Description                                                        |\n| ------------------ | ---------------------------------------------------- | ------------------------------------------------------------------ |\n| **RFC (Markdown)** | [rfcs\u002F](rfcs\u002F)                                       | Human-readable design doc with rationale, flows, and rollout plan. |\n| **OpenAPI (YAML)** | [spec\u002F2026-01-30\u002Fopenapi\u002F](spec\u002F2026-01-30\u002Fopenapi\u002F) | Machine-readable HTTP API spec for integrating checkout endpoints. |\n| **JSON Schema**    | [spec\u002F2026-01-30\u002Fjson-schema\u002F](spec\u002F2026-01-30\u002Fjson-schema\u002F) | Data models for payloads, events, and reusable objects.    |\n| **Examples**       | [examples\u002F2026-01-30\u002F](examples\u002F2026-01-30\u002F)         | Sample requests, responses.                                        |\n| **Changelog**      | [changelog\u002F](changelog\u002F)                             | API version history and breaking changes.                          |\n\n---\n\n## 📅 Versioning\n\nACP uses **date-based versioning** in `YYYY-MM-DD` format. Each version represents a complete snapshot of the specification at that point in time.\n\n### Version Structure\n\n| Directory | Purpose |\n| --------- | ------- |\n| `spec\u002F\u003Cversion>\u002F` | Complete spec snapshot for a released version |\n| `spec\u002Funreleased\u002F` | Current development (not yet released) |\n| `examples\u002F\u003Cversion>\u002F` | Examples matching each spec version |\n| `changelog\u002F\u003Cversion>.md` | Release notes for each version |\n\n### Version Lifecycle\n\n1. **unreleased\u002F** - New features and changes are developed here\n2. **Released** - When ready, `unreleased\u002F` is snapshotted to a dated version (e.g., `2026-01-16\u002F`)\n3. **Deprecated** - Older versions remain available but are marked deprecated in the changelog\n\n---\n\n## 🛠 Getting Started\n\nACP has been **first implemented by both OpenAI and Stripe**, providing production-ready reference implementations for merchants and developers:\n\n- [OpenAI Documentation](https:\u002F\u002Fdevelopers.openai.com\u002Fcommerce\u002F)\n- [Stripe Agentic Commerce Documentation](https:\u002F\u002Fdocs.stripe.com\u002Fagentic-commerce)\n\nTo start building with ACP:\n\n1. Review this repo's [OpenAPI specs](spec\u002F2026-01-30\u002Fopenapi\u002F) and [JSON Schemas](spec\u002F2026-01-30\u002Fjson-schema\u002F) for the latest stable version.\n2. Choose a reference implementation:\n   - Use OpenAI's implementation to integrate with ChatGPT and other AI agent surfaces.\n   - Use Stripe's implementation to leverage its payment and merchant tooling.\n3. Follow the guides provided in the linked documentation.\n4. Test using the [examples](examples\u002F2026-01-30\u002F) provided in this repo.\n\n---\n\n## 📚 Documentation\n\n| Area                  | Resource                                                                                                               |\n| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |\n| Checkout API Spec     | [spec\u002F2026-01-30\u002Fopenapi\u002Fopenapi.agentic_checkout.yaml](spec\u002F2026-01-30\u002Fopenapi\u002Fopenapi.agentic_checkout.yaml)         |\n| Delegate Payment Spec | [spec\u002F2026-01-30\u002Fopenapi\u002Fopenapi.delegate_payment.yaml](spec\u002F2026-01-30\u002Fopenapi\u002Fopenapi.delegate_payment.yaml)         |\n| Governance            | [docs\u002Fgovernance.md](docs\u002Fgovernance.md)                                                                               |\n| Project Principles    | [docs\u002Fprinciples-mission.md](docs\u002Fprinciples-mission.md)                                                               |\n| SEP Guidelines        | [docs\u002Fsep-guidelines.md](docs\u002Fsep-guidelines.md)                                                                       |\n\n---\n\n## 📝 Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for:\n\n- Branching model\n- Pull request templates and guidelines\n- Spec versioning and review process\n- Community guidelines\n\n### Pull Request Templates\n\nWhen creating a PR, choose the appropriate template:\n\n- **[SEP Proposal](.github\u002FPULL_REQUEST_TEMPLATE\u002Fsep-proposal.md)** - For major protocol changes, breaking changes, or process changes\n- **[Minor Improvement](.github\u002FPULL_REQUEST_TEMPLATE\u002Fminor-improvement.md)** - For documentation fixes, bug fixes, or tooling improvements\n\nSee [docs\u002Fgovernance.md](docs\u002Fgovernance.md) for guidance on what requires a SEP.\n\n### Contributor License Agreement (CLA)\n\n**All contributors must sign a CLA before contributions can be accepted.**\n\n- **Individual Contributors**: Automated via [CLA Assistant](https:\u002F\u002Fcla-assistant.io\u002F) when you submit your first PR\n- **Corporate Contributors**: See [Corporate CLA Process](legal\u002Fcla\u002FCORPORATE_PROCESS.md)\n\n[View signed CLAs](legal\u002Fcla\u002FSIGNATORIES.md) | [Learn more about our CLA](legal\u002Fcla\u002F)\n\n### All changes must include:\n\n- Updated OpenAPI \u002F JSON Schemas (if applicable)\n- New or updated examples\n- Changelog entry file in `changelog\u002Funreleased\u002F` (see [CONTRIBUTING.md](CONTRIBUTING.md) for details)\n\n---\n\n## 🏛 Governance\n\nACP is jointly governed by **OpenAI** and **Stripe** as Founding Maintainers, with a clear path toward broader community governance.\n\n- **Governance Model**: [docs\u002Fgovernance.md](docs\u002Fgovernance.md)\n- **Project Principles**: [docs\u002Fprinciples-mission.md](docs\u002Fprinciples-mission.md)\n- **Maintainers**: [MAINTAINERS.md](MAINTAINERS.md)\n- **Decision Process**: Consensus-based with escalation procedures\n- **Future Path**: Neutral foundation stewardship as ecosystem matures\n\n---\n\n## 🤝 Community\n\n- **Code of Conduct**: [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)\n- **Discussions**: [GitHub Discussions](https:\u002F\u002Fgithub.com\u002Fagentic-commerce-protocol\u002Fagentic-commerce-protocol\u002Fdiscussions)\n- **Issues**: [Report bugs or request features](https:\u002F\u002Fgithub.com\u002Fagentic-commerce-protocol\u002Fagentic-commerce-protocol\u002Fissues)\n- **SEPs**: [Propose protocol enhancements](docs\u002Fsep-guidelines.md)\n\n---\n\n## 📜 License\n\nLicensed under the [Apache 2.0 License](LICENSE).\n\n","# 代理式商务协议（ACP）\n\n[![许可证](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-Apache%202.0-blue.svg)](LICENSE)\n[![CLA](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FCLA-Required-red.svg)](legal\u002Fcla\u002F)\n[![维护方](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FMaintained%20by-OpenAI%20%26%20Stripe-00ADD8.svg)](MAINTAINERS.md)\n[![状态](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FStatus-Beta-blue.svg)](changelog\u002F)\n\n**代理式商务协议（ACP）**是一种交互模型和开放标准，旨在无缝连接买家、其AI代理以及商家，以完成购买流程。\n\n该规范由**OpenAI**和**Stripe**共同维护（见[MAINTAINERS.md]），目前处于`beta`阶段。\n\n- **面向商家**：触达更多客户。通过让您的产品和服务可通过AI代理进行购买，吸引高意向买家——同时仍使用您现有的商务基础设施。\n- **面向AI代理**：将商务功能嵌入您的应用中。允许您的用户在您的应用内直接发现并与商家交易，而无需作为实际的交易主体。\n- **面向支付服务商**：提升交易量。通过AI代理在买家与商家之间传递安全的支付令牌，处理代理式交易。\n\n更多信息请访问[agenticcommerce.dev](https:\u002F\u002Fagenticcommerce.dev)。\n\n---\n\n## 📦 仓库结构\n\n```\nrfcs\u002F\n├── rfc.agentic_checkout.md\n├── rfc.capability_negotiation.md\n├── rfc.payment_handlers.md\n├── rfc.seller_backed_payment_handler.md\n├── rfc.extensions.md\n├── rfc.discount_extension.md\n└── ...\n\nspec\u002F\n├── 2025-09-29\u002F              # 初始发布\n├── 2025-12-12\u002F              # 履行增强\n├── 2026-01-16\u002F              # 能力协商\n├── 2026-01-30\u002F              # 扩展、折扣、支付处理器\n└── unreleased\u002F              # 当前开发中\n\nexamples\u002F\n├── 2025-09-29\u002F\n├── 2025-12-12\u002F\n├── 2026-01-16\u002F\n├── 2026-01-30\u002F\n└── unreleased\u002F\n\nchangelog\u002F\n├── 2025-09-29.md\n├── 2025-12-12.md\n├── 2026-01-30.md\n└── unreleased\u002F              # 各版本变更日志条目（当前开发中）\n\ndocs\u002F\n├── governance.md\n├── principles-mission.md\n└── sep-guidelines.md\n\nlegal\u002Fcla\u002F\n├── INDIVIDUAL.md\n├── CORPORATE.md\n└── SIGNATORIES.md\n```\n\n---\n\n## 🔗 快速链接\n\n| 规范类型          | 最新稳定版                                        | 描述                                                        |\n| ------------------ | ---------------------------------------------------- | ------------------------------------------------------------------ |\n| **RFC（Markdown）** | [rfcs\u002F](rfcs\u002F)                                       | 人类可读的设计文档，包含背景、流程及发布计划。                 |\n| **OpenAPI（YAML）** | [spec\u002F2026-01-30\u002Fopenapi\u002F](spec\u002F2026-01-30\u002Fopenapi\u002F) | 机器可读的HTTP API规范，用于集成结账端点。                     |\n| **JSON Schema**    | [spec\u002F2026-01-30\u002Fjson-schema\u002F](spec\u002F2026-01-30\u002Fjson-schema\u002F) | 用于有效载荷、事件和可重用对象的数据模型。                    |\n| **示例**       | [examples\u002F2026-01-30\u002F](examples\u002F2026-01-30\u002F)         | 示例请求与响应。                                            |\n| **变更日志**      | [changelog\u002F](changelog\u002F)                             | API版本历史及破坏性变更记录。                          |\n\n---\n\n## 📅 版本控制\n\nACP采用基于日期的版本号格式，形式为`YYYY-MM-DD`。每个版本代表该时间点上规范的完整快照。\n\n### 版本结构\n\n| 目录 | 用途 |\n| --------- | ------- |\n| `spec\u002F\u003Cversion>\u002F` | 已发布版本的完整规范快照 |\n| `spec\u002Funreleased\u002F` | 当前开发中（尚未发布） |\n| `examples\u002F\u003Cversion>\u002F` | 与各规范版本对应的示例 |\n| `changelog\u002F\u003Cversion>.md` | 每个版本的发布说明 |\n\n### 版本生命周期\n\n1. **unreleased\u002F** - 新功能和更改在此处开发。\n2. **已发布** - 准备就绪时，将`unreleased\u002F`快照为一个带日期的版本（例如，`2026-01-16\u002F`）。\n3. **已弃用** - 较旧的版本仍可使用，但在变更日志中会被标记为已弃用。\n\n---\n\n## 🛠 开始使用\n\nACP已由**OpenAI和Stripe率先实现**，为商家和开发者提供了生产就绪的参考实现：\n\n- [OpenAI文档](https:\u002F\u002Fdevelopers.openai.com\u002Fcommerce\u002F)\n- [Stripe代理式商务文档](https:\u002F\u002Fdocs.stripe.com\u002Fagentic-commerce)\n\n开始构建ACP：\n\n1. 查阅本仓库的[OpenAPI规范](spec\u002F2026-01-30\u002Fopenapi\u002F)和[JSON Schema](spec\u002F2026-01-30\u002Fjson-schema\u002F)以获取最新稳定版本。\n2. 选择一个参考实现：\n   - 使用OpenAI的实现来集成ChatGPT及其他AI代理界面。\n   - 使用Stripe的实现来利用其支付和商家工具。\n3. 按照链接文档中的指南操作。\n4. 使用本仓库提供的[示例](examples\u002F2026-01-30\u002F)进行测试。\n\n---\n\n## 📚 文档\n\n| 领域                  | 资源                                                                                                               |\n| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |\n| 结账API规范     | [spec\u002F2026-01-30\u002Fopenapi\u002Fopenapi.agentic_checkout.yaml](spec\u002F2026-01-30\u002Fopenapi\u002Fopenapi.agentic_checkout.yaml)         |\n| 委托支付规范 | [spec\u002F2026-01-30\u002Fopenapi\u002Fopenapi.delegate_payment.yaml](spec\u002F2026-01-30\u002Fopenapi\u002Fopenapi.delegate_payment.yaml)         |\n| 治理            | [docs\u002Fgovernance.md](docs\u002Fgovernance.md)                                                                               |\n| 项目原则    | [docs\u002Fprinciples-mission.md](docs\u002Fprinciples-mission.md)                                                               |\n| SEP指南        | [docs\u002Fsep-guidelines.md](docs\u002Fsep-guidelines.md)                                                                       |\n\n---\n\n## 📝 贡献\n\n我们欢迎贡献！请参阅[CONTRIBUTING.md](CONTRIBUTING.md)了解：\n\n- 分支模型\n- 拉取请求模板和指南\n- 规范版本管理和评审流程\n- 社区准则\n\n### 拉取请求模板\n\n创建PR时，请选择合适的模板：\n\n- **[SEP提案](.github\u002FPULL_REQUEST_TEMPLATE\u002Fsep-proposal.md)** - 用于重大协议变更、破坏性变更或流程变更。\n- **[小改进](.github\u002FPULL_REQUEST_TEMPLATE\u002Fminor-improvement.md)** - 用于文档修复、错误修正或工具改进。\n\n有关哪些内容需要SEP，请参阅[docs\u002Fgovernance.md](docs\u002Fgovernance.md)。\n\n### 贡献者许可协议（CLA）\n\n**所有贡献者必须签署CLA后方可接受其贡献。**\n\n- **个人贡献者**：首次提交PR时，将通过[CLA Assistant](https:\u002F\u002Fcla-assistant.io\u002F)自动完成。\n- **企业贡献者**：请参阅[企业CLA流程](legal\u002Fcla\u002FCORPORATE_PROCESS.md)。\n\n[查看已签署的CLA](legal\u002Fcla\u002FSIGNATORIES.md) | [了解更多关于我们的CLA](legal\u002Fcla\u002F)\n\n### 所有更改必须包含：\n\n- 更新的 OpenAPI \u002F JSON 模式（如适用）\n- 新的或更新的示例\n- `changelog\u002Funreleased\u002F` 中的变更日志条目文件（详情请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)）\n\n---\n\n## 🏛 治理\n\nACP 由 **OpenAI** 和 **Stripe** 作为创始维护者共同治理，并已规划出一条通往更广泛社区治理的清晰路径。\n\n- **治理模式**：[docs\u002Fgovernance.md](docs\u002Fgovernance.md)\n- **项目原则**：[docs\u002Fprinciples-mission.md](docs\u002Fprinciples-mission.md)\n- **维护者**：[MAINTAINERS.md](MAINTAINERS.md)\n- **决策流程**：基于共识，辅以升级机制\n- **未来方向**：随着生态系统的成熟，将过渡到中立基金会的托管管理\n\n---\n\n## 🤝 社区\n\n- **行为准则**：[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)\n- **讨论区**：[GitHub Discussions](https:\u002F\u002Fgithub.com\u002Fagentic-commerce-protocol\u002Fagentic-commerce-protocol\u002Fdiscussions)\n- **问题追踪**：[报告 bug 或请求功能](https:\u002F\u002Fgithub.com\u002Fagentic-commerce-protocol\u002Fagentic-commerce-protocol\u002Fissues)\n- **SEP 提案**：[提出协议增强建议](docs\u002Fsep-guidelines.md)\n\n---\n\n## 📜 许可证\n\n根据 [Apache 2.0 许可证](LICENSE)授权。","# Agentic Commerce Protocol (ACP) 快速上手指南\n\nAgentic Commerce Protocol (ACP) 是由 OpenAI 和 Stripe 共同维护的开放标准，旨在连接买家、AI 代理和商家，实现无缝的自动化购物流程。本指南将帮助开发者快速了解如何基于 ACP 构建集成。\n\n## 环境准备\n\nACP 是一个协议规范，而非单一的可执行软件包，因此没有特定的操作系统限制。开发前请确保具备以下环境和依赖：\n\n*   **操作系统**：Linux, macOS 或 Windows（支持 Git 和现代开发工具即可）。\n*   **基础工具**：\n    *   `git`：用于克隆仓库和管理版本。\n    *   `curl` 或 `wget`：用于测试 API 端点。\n    *   代码编辑器（如 VS Code）及 YAML\u002FJSON 插件。\n*   **前置依赖**：\n    *   **OpenAI 开发者账号**：若需集成 ChatGPT 或其他 AI Agent 表面。\n    *   **Stripe 账号**：若需处理支付流程和商户工具。\n    *   **API 客户端工具**（可选）：如 Postman 或 Insomnia，用于导入 OpenAPI 规范进行测试。\n\n> **注意**：目前官方文档主要面向全球开发者，暂无专属中国镜像源。国内开发者访问 `agenticcommerce.dev` 或 GitHub 仓库时，如遇网络延迟，建议使用通用的 GitHub 加速方案。\n\n## 安装步骤\n\n由于 ACP 是协议标准，\"安装\"过程实质是获取最新的规范定义文件（OpenAPI specs 和 JSON Schemas）并集成到您的项目中。\n\n1.  **克隆官方仓库**\n    获取包含最新规范、示例和文档的源代码：\n    ```bash\n    git clone https:\u002F\u002Fgithub.com\u002Fagentic-commerce-protocol\u002Fagentic-commerce-protocol.git\n    cd agentic-commerce-protocol\n    ```\n\n2.  **获取最新稳定版规范**\n    当前最新稳定版本为 `2026-01-30`。您可以直接引用仓库中的文件，或将其复制到您的项目配置目录：\n    ```bash\n    # 查看 OpenAPI 规范 (Checkout & Payment)\n    ls spec\u002F2026-01-30\u002Fopenapi\u002F\n\n    # 查看数据模型 JSON Schema\n    ls spec\u002F2026-01-30\u002Fjson-schema\u002F\n    ```\n\n3.  **集成参考实现（二选一）**\n    根据您的需求选择接入路径，无需重新发明轮子：\n    *   **路径 A (AI 侧)**：阅读 [OpenAI Commerce Docs](https:\u002F\u002Fdevelopers.openai.com\u002Fcommerce\u002F) 以在 Agent 中嵌入购物能力。\n    *   **路径 B (商户\u002F支付侧)**：阅读 [Stripe Agentic Commerce Docs](https:\u002F\u002Fdocs.stripe.com\u002Fagentic-commerce) 以配置接收来自 AI 的订单和支付。\n\n## 基本使用\n\n以下是最简单的集成流程示例，展示如何利用仓库中的资源验证协议连通性。\n\n### 1. 验证 API 规范\n使用 `curl` 检查本地仓库中的 OpenAPI 定义文件是否完整（以结账接口为例）：\n\n```bash\ncat spec\u002F2026-01-30\u002Fopenapi\u002Fopenapi.agentic_checkout.yaml | head -n 20\n```\n\n### 2. 模拟请求测试\n参考仓库提供的示例数据，构造一个符合 ACP 标准的 JSON 负载。以下是基于 `examples\u002F2026-01-30\u002F` 目录结构的逻辑示例：\n\n```bash\n# 假设您已启动了一个兼容 ACP 的本地测试服务\n# 使用示例中的 request 数据进行 POST 请求\n\ncurl -X POST http:\u002F\u002Flocalhost:8080\u002Fv1\u002Fcheckout \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d @examples\u002F2026-01-30\u002Fcheckout\u002Frequest_example.json\n```\n\n### 3. 开发迭代\n如果您计划贡献新功能或适配新特性，请在 `spec\u002Funreleased\u002F` 目录下查看正在开发的规范，并在 `changelog\u002Funreleased\u002F` 中记录变更：\n\n```bash\n# 查看正在开发中的特性\nls spec\u002Funreleased\u002F\n\n# 创建新的变更日志条目 (遵循 CONTRIBUTING.md 规范)\necho \"- Added support for custom discount logic\" > changelog\u002Funreleased\u002Fmy-feature.md\n```\n\n完成开发后，请参照 [CONTRIBUTING.md](CONTRIBUTING.md) 提交 Pull Request。","一家初创旅行平台希望让用户通过内置的 AI 助手直接完成机票与酒店的比价、预订及支付全流程，而无需跳转第三方页面。\n\n### 没有 agentic-commerce-protocol 时\n- **连接成本高昂**：开发团队需为每家航空公司和酒店集团单独编写定制化 API 适配器，耗时数月才能覆盖少量供应商。\n- **支付合规风险大**：AI 助手若直接处理用户信用卡信息，平台需承担复杂的 PCI-DSS 合规认证及资金托管责任，法律风险极高。\n- **交易流程断裂**：用户在对话中选定商品后，常被强制跳转到外部网页完成支付，导致转化率大幅流失，体验割裂。\n- **功能扩展困难**：想要支持动态折扣或协商价格等高级功能，需重新设计整个后端交互逻辑，迭代周期漫长。\n\n### 使用 agentic-commerce-protocol 后\n- **标准化快速接入**：平台只需遵循 ACP 开放标准，即可让 AI 助手无缝对接所有支持该协议的商家，无需重复造轮子。\n- **安全令牌化支付**：借助 Stripe 支持的协议机制，AI 仅传递加密支付令牌而非敏感卡号，平台彻底免除商户主体责任与合规负担。\n- **原生闭环体验**：用户在对话框内即可完成从选品到付款的全部操作，agentic-commerce-protocol 确保交易在应用内部流畅闭环，显著提升转化。\n- **灵活能力协商**：通过协议内置的“能力协商”机制，AI 可自动与商家系统沟通库存、应用优惠券或调整订单细节，无需额外开发。\n\nagentic-commerce-protocol 通过建立统一的交互标准，让 AI 助手真正成为能安全、独立执行复杂商业交易的智能代理。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fagentic-commerce-protocol_agentic-commerce-protocol_3c681cad.png","Agentic Commerce Protocol","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fagentic-commerce-protocol_51e0a858.png","",null,"https:\u002F\u002Fagenticcommerce.dev","https:\u002F\u002Fgithub.com\u002Fagentic-commerce-protocol",[79,83],{"name":80,"color":81,"percentage":82},"JavaScript","#f1e05a",91.6,{"name":84,"color":85,"percentage":86},"Shell","#89e051",8.4,1328,199,"2026-04-08T09:19:29","Apache-2.0",4,"未说明",{"notes":94,"python":92,"dependencies":95},"该项目是一个协议规范（包含 OpenAPI、JSON Schema 和文档），而非可直接运行的软件或模型，因此没有特定的操作系统、GPU、内存或编程语言运行时需求。用户需参考 OpenAI 或 Stripe 的具体实现文档进行集成开发。",[],[13,14],"2026-03-27T02:49:30.150509","2026-04-09T21:34:03.442301",[],[]]