Aicoo Share Agent — Aicoo 共享代理

共享代理 创建和管理用户代理的安全、可共享链接。 前提条件 AICOO_API_KEY 必须设置；也接受 legacy PULSE_API_KEY 基础 URL：https://www.aicoo.io/api/v1 用户应该先同步上下文 命令示例使用 ${AICOO_API_KEY:-$PULSE_API_KEY} 实现向后兼容 核心工作流 1) 检查上下文是否存在 curl -s -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \ "https://www.aicoo.io/api/v1/os/status" | jq . 如果 contextCount 为 0，则先运行 context-sync。 2) 创建共享链接（OS 端点） curl -s -X POST "https://www.aicoo.io/api/v1/os/share" \ -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \ -H "Content-Type: application/json" \ -d '{ "scope":"all", "access":"read", "notesAccess":"read", "label":"For investors", "expiresIn":"7d", "requireSignIn":true }' | jq . 3) 确认给用户 始终报告： URL 共享 范围和笔记/日历权限 过期 登录要求 访问被沙盒化 默认行为：新链接需要登录（requireSignIn：true）。仅当用户明确要求匿名公共链接时，才设置 requireSignIn：false。 参数 参数值 描述 scope all | 文件夹 文件夹需要文件夹 ID folderIds 数组 文件夹范围 ID access read | read_calendar | read_calendar_write 日历访问 notesAccess read | write | edit 笔记权限 label 字符串 链接标签 expiresIn 1h | 24h | 7d | 30d | 90d | never 过期 requireSignIn 布尔值 默认为 true。如果为 true，/a/ 和 /shared/ 需要登录的 Aicoo 用户。 笔记访问矩阵 操作 read write edit 搜索/读取笔记 是 是 是 创建笔记 否 是 是 编辑笔记 否 否 是 快照 否 否 是 管理现有链接 列出链接 + 访客 + 联系人 curl -s -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \ "https://www.aicoo.io/api/v1/os/network" | jq . 更新/撤销链接（规范 OS 端点） # 更新 curl -s -X PATCH "https://www.aicoo.io/api/v1/os/share/{linkId}" \ -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \ -H "Content-Type: application/json" \ -d '{"notesAccess":"write","expiresIn":"30d","requireSignIn":true}' | jq . # 撤销 curl -s -X DELETE "https://www.aicoo.io/api/v1/os/share/{linkId}" \ -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" | jq . 列出带分析的链接 curl -s -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \ "https://www.aicoo.io/api/v1/os/share/list?status=active&limit=20" | jq . 文件夹范围共享示例 # 检查文件夹 curl -s -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \ "https://www.aicoo.io/api/v1/os/folders" | jq . # 创建文件夹范围链接 curl -s -X POST "https://www.aicoo.io/api/v1/os/share" \ -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \ -H "Content-Type: application/json" \ -d '{"scope":"folders","folderIds":[5,12],"access":"read","notesAccess":"write","label":"Team collaborator","requireSignIn":true}' | jq . 每链接策略编辑 链接笔记存储在 links/ 文件夹中。通过搜索笔记然后修补笔记内容编辑策略： # 查找链接策略笔记 curl -s -X POST "https://www.aicoo.io/api/v1/os/notes/search" \ -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \ -H "Content-Type: application/json" \ -d '{"query":"For-Investors"}' | jq . # 编辑策略笔记内容 curl -s -X PATCH "https://www.aicoo.io/api/v1/os/notes/123" \ -H "Authorization: Bearer ${AICOO_API_KEY:-$PULSE_API_KEY}" \ -H "Content-Type: application/json" \ -d '{"content":"...\n\n## Policy\n\nBe professional, concise, and do not disclose confidential numbers."}' | jq . 安全笔记 每个链接在隔离范围内运行 新链接默认需要登录，除非 requireSignIn：false 被显式设置 登录的访客可以在分析中显示名称、用户名、电子邮件和用户 ID；匿名链接仅有 guest-session/fingerprint 元数据 撤销/过期链接立即失去访问权限 默认过期时间为 30 天，除非被覆盖 使用 notesAccess： "edit" 时要小心