protocolsio-integration

# Protocols.io 集成 ## 概述 Protocols.io 是一个用于开发、共享和管理科学实验方案的综合平台。本技能提供与 protocols.io API v3 的完整集成，支持对方案、工作区、讨论、文件管理和协作功能的程序化访问。 ## 何时使用此技能 在以下场景中与 protocols.io 交互时使用此技能： - **方案发现**：通过关键词、DOI 或类别搜索现有方案 - **方案管理**：创建、更新或发布科学实验方案 - **步骤管理**：添加、编辑或组织方案步骤和流程 - **协作开发**：与团队成员共同处理共享方案 - **工作区组织**：管理实验室或机构的方案库 - **讨论与反馈**：添加或回复方案评论 - **文件管理**：向方案上传数据文件、图像或文档 - **实验追踪**：记录方案执行过程和结果 - **数据导出**：备份或迁移方案集 - **集成项目**：构建与 protocols.io 交互的工具 ## 核心能力 本技能在五个主要能力领域提供全面指导： ### 1. 身份验证与访问 使用访问令牌和 OAuth 流程管理 API 身份验证。包括客户端访问令牌（用于个人内容）和 OAuth 令牌（用于多用户应用程序）。 **关键操作：** - 生成 OAuth 流程的授权链接 - 交换授权码以获取访问令牌 - 刷新过期令牌 - 管理速率限制和权限 **参考：** 阅读 `references/authentication.md` 以获取详细的身份验证程序、OAuth 实现和安全最佳实践。 ### 2. 方案操作 从创建到发布的完整方案生命周期管理。 **关键操作：** - 通过关键词、过滤器或 DOI 搜索和发现方案 - 检索包含所有步骤的详细方案信息 - 创建带有元数据和标签的新方案 - 更新方案信息和设置 - 管理方案步骤（创建、更新、删除、重新排序） - 处理方案材料和试剂 - 发布带有 DOI 的方案 - 收藏方案以便快速访问 - 生成方案 PDF **参考：** 阅读 `references/protocols_api.md` 以获取全面的方案管理指南，包括 API 端点、参数、协作