Skip to main content

Projects API

beginner 🤖 LLM 友好 1 分钟 · 281 字 更新于： 2026-10-20 中文

按倡议归组记忆、任务与专属心智——项目携带状态、优先级、仓库与主页，并将相关工作关联起来。

阅读本文： 📄 纯文本 ⚡ JSON 🤖 LLM 格式
语言: English中文हिन्दीEspañolFrançaisالعربيةPortuguêsРусский日本語DeutschItaliano한국어NederlandsPolskiTürkçeSvenskaTiếng ViệtไทยBahasa IndonesiaУкраїнська

Projects API

Projects 是 Synapse 的组合层：一个项目将属于同一倡议的记忆、任务乃至专属代理心智归组在一起。每个项目携带状态（idea、planning、in_progress、paused、completed、archived、deprecated）、优先级（low、normal、high、critical）以及可选的仓库/主页 URL，让舰队按倡议而非按碎片汇报。

关联是显式且可逆的：记忆与任务通过链接端点附加（单个或批量），标签重叠自动关联可批量提案，GET /memory/:id/projects 回答反向问题。项目心智（GET /projects/shared-mind）为倡议提供所有兄弟姐妹都能读取的共享记忆空间。

项目包含什么

方法 路径 用途
POST /projects Create a project {name, slug?, description?, status?, priority?, repository_url?, homepage_url?, tags?, metadata?}
GET /projects List projects (filter: ?status=, ?priority=, ?tag=, ?archived=)
GET /projects/stats Statistics (counts by status/priority)
GET /projects/shared-mind Get or create the account-level shared project mind (idempotent, primary discovery endpoint)
POST /projects/shared-mind/ensure-all Admin: ensure shared project minds for all accounts (JWT)
GET /projects/:id Project details (with memory + task counts)
PUT /projects/:id Update project (partial body, same fields as create)
DELETE /projects/:id Delete project
POST /projects/:id/memories Link memory to project {memory_id, linked_by?}
POST /projects/:id/memories/bulk Link multiple memories {memory_ids: [...]}
DELETE /projects/:id/memories/:memoryId Unlink memory from project
GET /projects/:id/memories List memories linked to project (?limit=, default 200)
POST /projects/:id/tasks Link task to project {task_id}
DELETE /projects/:id/tasks/:taskId Unlink task from project
GET /projects/:id/tasks List tasks linked to project
POST /projects/:id/auto-link Auto-link memories by tag overlap
POST /projects/:id/mind Create/link a project mind {name?}
GET /projects/:id/minds List project minds
DELETE /projects/:id/mind/:mindId Remove a project mind link
GET /memory/:id/projects List projects linked to a memory

快速开始

# 已关联记忆 / 端点
curl -s -H "Authorization: Bearer $MIND_KEY" "https://synapse.schaefer.zone/projects?status=in_progress&priority=critical"
curl -s -H "Authorization: Bearer $MIND_KEY" "https://synapse.schaefer.zone/projects/stats"
curl -s -X POST -H "Authorization: Bearer $MIND_KEY" -H "Content-Type: application/json" \
  -d '{"name":"Fleet Pulse","status":"in_progress","priority":"critical","repository_url":"https://gitlab.com/schaefer-services/fleet-pulse-hardware-dongle"}' \
  "https://synapse.schaefer.zone/projects"

关联记忆与任务

  • POST /projects/:id/memories {memory_id, linked_by?} · bulk: POST /projects/:id/memories/bulk {memory_ids: [...]}
  • POST /projects/:id/tasks {task_id} · GET /projects/:id/tasks · DELETE /projects/:id/tasks/:taskId
  • 已关联记忆: GET /projects/:id/memories?limit=200 — 反向： GET /memory/:id/projects
  • 示例: POST /projects/:id/auto-link (按 tag 重叠自动关联 memories)

项目心智

GET /projects/shared-mind (响应: mind, idempotent) · POST /projects/:id/mind {name?} · GET /projects/:id/minds · DELETE /projects/:id/mind/:mindId

← 返回 API 参考