{"title":"Scripts API","slug":"scripts","category":"api","summary":"持久化脚本存储 — 保存可复用的 Shell、Python 或 Node 脚本，并通过 curl | bash 拉取执行。","audience":["human","llm"],"tags":["api","scripts","automation","snippets"],"difficulty":"beginner","updated":"2026-06-27","word_count":66,"read_minutes":1,"llm_context":"Auth: Mind Key or JWT\nStore: POST /script { name, content, description?, language? }\nFetch as text: GET /script/:name (returns text/plain, curl | bash ready)\nInfo: GET /script/:name/info (metadata without content)\nList: GET /scripts (JSON array)\nDelete: DELETE /script/:name\nUse case: store deployment scripts, config generators, troubleshooting snippets\n","lang":"zh","translated":true,"requested_lang":"zh","content_markdown":"\n# Scripts API\n\nScripts API 为可复用脚本提供持久化存储。脚本在 Mind 中命名并版本化，可作为纯文本拉取 — 非常适合 `curl | bash` 模式。\n\n## 端点\n\n### POST /script\n\n存储或更新脚本。\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/script \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"deploy-synapse\",\n \"content\": \"#!/bin/bash\\nset -euo pipefail\\ngit pull\\nnpm ci\\nnpm run build\\ndocker compose up -d\",\n \"description\": \"Deploy Synapse to production\",\n \"language\": \"bash\"\n }'\n```\n\n### GET /script/:name\n\n以 `text/plain` 拉取脚本内容。非常适合管道到 bash 执行。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse | bash\n```\n\n### GET /script/:name/info\n\n获取脚本的元数据（不含内容）。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse/info\n```\n\n响应：\n\n```json\n{\n \"name\": \"deploy-synapse\",\n \"description\": \"Deploy Synapse to production\",\n \"language\": \"bash\",\n \"size_bytes\": 142,\n \"created_at\": \"2026-06-27T...\",\n \"updated_at\": \"2026-06-27T...\"\n}\n```\n\n### GET /scripts\n\n列出当前 Mind 中的所有脚本。\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/scripts\n```\n\n### DELETE /script/:name\n\n删除脚本。\n\n```bash\ncurl -X DELETE -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/script/deploy-synapse\n```\n\n## 常见用例\n\n### 部署脚本\n\n把标准部署流程保存为脚本，让 LLM 直接运行，无需每次重新推导步骤：\n\n```bash\n# LLM 一次性存储\ncurl -X POST .../script -d '{\n \"name\": \"deploy-vps1\",\n \"content\": \"#!/bin/bash\\nssh vps1 \\\"cd /opt/synapse && git pull && docker compose up -d --build\\\"\",\n \"language\": \"bash\"\n}'\n\n# 后续会话直接运行\ncurl -H \"Authorization: ...\" .../script/deploy-vps1 | bash\n```\n\n### 故障排查片段\n\n把常见问题的诊断命令保存为脚本：\n\n```bash\ncurl -X POST .../script -d '{\n \"name\": \"check-docker\",\n \"content\": \"#!/bin/bash\\ndocker ps\\ndocker stats --no-stream\\ndocker system df\",\n \"description\": \"Quick Docker health check\",\n \"language\": \"bash\"\n}'\n```\n\n### 配置生成器\n\n保存用于生成配置的脚本：\n\n```bash\ncurl -X POST .../script -d '{\n \"name\": \"gen-nginx-conf\",\n \"content\": \"#!/usr/bin/env python3\\nimport sys\\n# ... generate nginx config from template ...\",\n \"language\": \"python\"\n}'\n```\n\n## 下一步\n\n- [Variables API](/docs/api/variables)\n- [Cron 与调度器](/docs/api/cron)\n","content_html":"

Scripts API

\n

Scripts API 为可复用脚本提供持久化存储。脚本在 Mind 中命名并版本化，可作为纯文本拉取 — 非常适合 curl | bash 模式。

\n

端点

\n

POST /script

\n

存储或更新脚本。

\n
curl -X POST https://synapse.schaefer.zone/script \\\n  -H "Authorization: Bearer YOUR_MIND_KEY" \\\n  -H "Content-Type: application/json" \\\n  -d '{\n    "name": "deploy-synapse",\n    "content": "#!/bin/bash\\nset -euo pipefail\\ngit pull\\nnpm ci\\nnpm run build\\ndocker compose up -d",\n    "description": "Deploy Synapse to production",\n    "language": "bash"\n  }'

GET /script/:name

\n

以 text/plain 拉取脚本内容。非常适合管道到 bash 执行。

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/script/deploy-synapse | bash

GET /script/:name/info

\n

获取脚本的元数据（不含内容）。

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/script/deploy-synapse/info

响应：

\n
{\n  "name": "deploy-synapse",\n  "description": "Deploy Synapse to production",\n  "language": "bash",\n  "size_bytes": 142,\n  "created_at": "2026-06-27T...",\n  "updated_at": "2026-06-27T..."\n}

GET /scripts

\n

列出当前 Mind 中的所有脚本。

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/scripts

DELETE /script/:name

\n

删除脚本。

\n
curl -X DELETE -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     https://synapse.schaefer.zone/script/deploy-synapse

常见用例

\n

部署脚本

\n

把标准部署流程保存为脚本，让 LLM 直接运行，无需每次重新推导步骤：

\n
# LLM 一次性存储\ncurl -X POST .../script -d '{\n  "name": "deploy-vps1",\n  "content": "#!/bin/bash\\nssh vps1 \\"cd /opt/synapse && git pull && docker compose up -d --build\\"",\n  "language": "bash"\n}'\n\n# 后续会话直接运行\ncurl -H "Authorization: ..." .../script/deploy-vps1 | bash

故障排查片段

\n

把常见问题的诊断命令保存为脚本：

\n
curl -X POST .../script -d '{\n  "name": "check-docker",\n  "content": "#!/bin/bash\\ndocker ps\\ndocker stats --no-stream\\ndocker system df",\n  "description": "Quick Docker health check",\n  "language": "bash"\n}'

配置生成器

\n

保存用于生成配置的脚本：

\n
curl -X POST .../script -d '{\n  "name": "gen-nginx-conf",\n  "content": "#!/usr/bin/env python3\\nimport sys\\n# ... generate nginx config from template ...",\n  "language": "python"\n}'

下一步

\n\n","urls":{"html":"/docs/api/scripts","text":"/docs/api/scripts?format=text","json":"/docs/api/scripts?format=json","llm":"/docs/api/scripts?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}