slipbox
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseSlipBox Skill
SlipBox 技能
IMPORTANT: Before doing anything else, run the setup check below. Do not skip this step.
重要提示:在进行任何操作之前,请先运行下方的设置检查。请勿跳过此步骤。
Setup Check
设置检查
Run this command immediately upon skill invocation:
bash
echo "SLIPBOX_API_KEY: ${SLIPBOX_API_KEY:+${SLIPBOX_API_KEY:0:6}…(set)}" | sed 's/^SLIPBOX_API_KEY: $/SLIPBOX_API_KEY: (MISSING)/'
echo "SLIPBOX_URL: ${SLIPBOX_URL:-(MISSING)}"
echo "SLIPBOX_PRIVATEBOX_REPO: ${SLIPBOX_PRIVATEBOX_REPO:-(MISSING)}"If any show :
(MISSING)- STOP IMMEDIATELY. Do not attempt any further action.
- Do not guess values, use defaults, search for shell config files, or attempt fallbacks of any kind.
- Tell the user exactly which variables are missing and that they must set them in (or
~/.zshrc) and re-source their shell before trying again.~/.zprofile - End your response there and wait for the user to fix the issue.
Once env vars are confirmed, verify the service is reachable:
bash
curl -sL "$SLIPBOX_URL/api/health"调用本技能后立即运行以下命令:
bash
echo "SLIPBOX_API_KEY: ${SLIPBOX_API_KEY:+${SLIPBOX_API_KEY:0:6}…(set)}" | sed 's/^SLIPBOX_API_KEY: $/SLIPBOX_API_KEY: (MISSING)/'
echo "SLIPBOX_URL: ${SLIPBOX_URL:-(MISSING)}"
echo "SLIPBOX_PRIVATEBOX_REPO: ${SLIPBOX_PRIVATEBOX_REPO:-(MISSING)}"如果任何一项显示:
(MISSING)- 立即停止操作。请勿尝试任何进一步的动作。
- 不要猜测值、使用默认值、搜索shell配置文件或尝试任何形式的回退方案。
- 准确告知用户哪些变量缺失,并且他们必须在(或
~/.zshrc)中设置这些变量,重新加载shell后再重试。~/.zprofile - 在此处结束回复,等待用户解决问题。
确认环境变量配置完成后,验证服务是否可达:
bash
curl -sL "$SLIPBOX_URL/api/health"{"status":"ok"}
{"status":"ok"}
If the health check fails or returns anything other than `{"status":"ok"}`:
- **STOP IMMEDIATELY. Do not attempt any further action.**
- Report the response to the user and tell them the service is unavailable.
- End your response there and wait for the user.
如果健康检查失败或返回内容不是`{"status":"ok"}`:
- **立即停止操作。请勿尝试任何进一步的动作。**
- 将响应结果告知用户,并说明服务不可用。
- 在此处结束回复,等待用户处理。API Error Handling
API错误处理
If any API call returns an error response (any JSON with an field, or a non-2xx HTTP status):
"error"- STOP IMMEDIATELY. Do not attempt any further action.
- Do not try to write notes directly to PrivateBox or any other fallback.
- Do not retry with different parameters or modified requests.
- Report the exact error response to the user and wait for them to resolve it.
如果任何API调用返回错误响应(任何包含字段的JSON,或非2xx状态码的HTTP响应):
"error"- 立即停止操作。请勿尝试任何进一步的动作。
- 不要尝试直接将笔记写入PrivateBox或任何其他回退方案。
- 不要使用不同参数或修改后的请求进行重试。
- 将准确的错误响应告知用户,等待他们解决问题。
About
关于
Interact with the SlipBox semantic knowledge engine and browse your PrivateBox notes.
SlipBox service:
PrivateBox repo:
$SLIPBOX_URL$SLIPBOX_PRIVATEBOX_REPO与SlipBox语义知识引擎交互并浏览你的PrivateBox笔记。
SlipBox服务:
PrivateBox仓库:
$SLIPBOX_URL$SLIPBOX_PRIVATEBOX_REPOConfiguration
配置
Required environment variables (set in shell):
env
SLIPBOX_API_KEY=<shared-secret> # Bearer token for API auth
SLIPBOX_URL=https://slip-box-rho.vercel.app # SlipBox service base URL
SLIPBOX_PRIVATEBOX_REPO=Randroids-Dojo/PrivateBox # GitHub repo for notes (owner/repo)All other configuration (OpenAI, GitHub, PrivateBox) lives on the deployed Vercel service.
所需环境变量(在shell中设置):
env
SLIPBOX_API_KEY=<shared-secret> # API认证的Bearer令牌
SLIPBOX_URL=https://slip-box-rho.vercel.app # SlipBox服务基础URL
SLIPBOX_PRIVATEBOX_REPO=Randroids-Dojo/PrivateBox # 笔记的GitHub仓库(所有者/仓库名)所有其他配置(OpenAI、GitHub、PrivateBox)都部署在Vercel服务端。
Quick Reference
快速参考
All API calls require:
Authorization: Bearer $SLIPBOX_API_KEYbash
undefined所有API调用都需要:
Authorization: Bearer $SLIPBOX_API_KEYbash
undefinedHealth check
健康检查
curl -sL "$SLIPBOX_URL/api/health"
curl -sL "$SLIPBOX_URL/api/health"
Add a note
添加笔记
curl -sL -X POST "$SLIPBOX_URL/api/add-note"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"content": "Atomic idea goes here."}'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"content": "Atomic idea goes here."}'
curl -sL -X POST "$SLIPBOX_URL/api/add-note"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"content": "Atomic idea goes here."}'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"content": "Atomic idea goes here."}'
Add a typed note (type: "meta" or "hypothesis")
添加带类型的笔记(type: "meta" 或 "hypothesis")
curl -sL -X POST "$SLIPBOX_URL/api/add-note"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"content": "## Cluster: ...", "type": "meta"}'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"content": "## Cluster: ...", "type": "meta"}'
curl -sL -X POST "$SLIPBOX_URL/api/add-note"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"content": "## Cluster: ...", "type": "meta"}'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"content": "## Cluster: ...", "type": "meta"}'
Re-link all notes (recompute similarity links)
重新关联所有笔记(重新计算相似性链接)
curl -sL -X POST "$SLIPBOX_URL/api/link-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
curl -sL -X POST "$SLIPBOX_URL/api/link-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
Cluster notes into thematic groups
将笔记聚类为主题组
curl -sL -X POST "$SLIPBOX_URL/api/cluster-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"k": 5}'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"k": 5}'
curl -sL -X POST "$SLIPBOX_URL/api/cluster-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"k": 5}'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{"k": 5}'
Detect conceptual tensions (contradictions within clusters)
检测概念张力(聚类中存在矛盾的笔记)
curl -sL -X POST "$SLIPBOX_URL/api/tension-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
curl -sL -X POST "$SLIPBOX_URL/api/tension-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
Fetch theme data (clusters + note content + tensions) for agent synthesis
获取主题数据(聚类 + 笔记内容 + 张力)用于Agent合成
curl -sL "$SLIPBOX_URL/api/theme-data"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
---curl -sL "$SLIPBOX_URL/api/theme-data"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
---API Reference
API参考
POST /api/add-note
POST /api/add-note
Capture an atomic idea. SlipBox embeds it, links it to similar notes, and commits it to PrivateBox.
Optional field sets a semantic type in the note's frontmatter. Valid values: (AI-generated cluster summary) or (AI-generated research hypothesis). Omit for regular atomic notes.
type"meta""hypothesis"bash
undefined捕捉原子化想法。SlipBox会将其嵌入向量,关联到相似笔记,并提交到PrivateBox。
可选的字段用于在笔记的前置元数据中设置语义类型。有效值:(AI生成的聚类摘要)或(AI生成的研究假设)。普通原子化笔记可省略该字段。
type"meta""hypothesis"bash
undefinedRegular note
普通笔记
curl -sL -X POST "$SLIPBOX_URL/api/add-note"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "The Zettelkasten method treats each note as a discrete, reusable idea." }'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "The Zettelkasten method treats each note as a discrete, reusable idea." }'
curl -sL -X POST "$SLIPBOX_URL/api/add-note"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "The Zettelkasten method treats each note as a discrete, reusable idea." }'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "The Zettelkasten method treats each note as a discrete, reusable idea." }'
Meta-note (cluster synthesis)
元笔记(聚类合成)
curl -sL -X POST "$SLIPBOX_URL/api/add-note"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "## Cluster: Agentic Systems\n\nNotes in this cluster explore...", "type": "meta" }'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "## Cluster: Agentic Systems\n\nNotes in this cluster explore...", "type": "meta" }'
Response:
```json
{
"noteId": "20260222T153045-a1b2c3d4",
"type": "meta",
"linkedNotes": [
{"noteId": "20260110T091200-b2c3d4e5", "similarity": 0.91},
{"noteId": "20260115T143000-c3d4e5f6", "similarity": 0.85}
]
}typenullcurl -sL -X POST "$SLIPBOX_URL/api/add-note"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "## Cluster: Agentic Systems\n\nNotes in this cluster explore...", "type": "meta" }'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "## Cluster: Agentic Systems\n\nNotes in this cluster explore...", "type": "meta" }'
响应:
```json
{
"noteId": "20260222T153045-a1b2c3d4",
"type": "meta",
"linkedNotes": [
{"noteId": "20260110T091200-b2c3d4e5", "similarity": 0.91},
{"noteId": "20260115T143000-c3d4e5f6", "similarity": 0.85}
]
}普通笔记的响应中为。
typenullPOST /api/link-pass
POST /api/link-pass
Recompute semantic similarity links across all notes. Run after adding many notes in bulk.
bash
curl -sL -X POST "$SLIPBOX_URL/api/link-pass" \
-H "Authorization: Bearer $SLIPBOX_API_KEY"Response:
json
{"message": "Link pass complete", "notesProcessed": 42, "totalLinks": 156}重新计算所有笔记的语义相似性链接。批量添加大量笔记后运行此命令。
bash
curl -sL -X POST "$SLIPBOX_URL/api/link-pass" \
-H "Authorization: Bearer $SLIPBOX_API_KEY"响应:
json
{"message": "Link pass complete", "notesProcessed": 42, "totalLinks": 156}POST /api/cluster-pass
POST /api/cluster-pass
Run k-means clustering on note embeddings. Omit to auto-select cluster count.
kbash
curl -sL -X POST "$SLIPBOX_URL/api/cluster-pass" \
-H "Authorization: Bearer $SLIPBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"k": 5}'Response:
json
{
"message": "Cluster pass complete",
"noteCount": 42,
"clusterCount": 5,
"clusters": [{"id": "cluster-0", "size": 9, "noteIds": ["20260222T153045-a1b2c3d4", ...]}, ...]
}对笔记嵌入向量运行k-means聚类。省略将自动选择聚类数量。
kbash
curl -sL -X POST "$SLIPBOX_URL/api/cluster-pass" \
-H "Authorization: Bearer $SLIPBOX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"k": 5}'响应:
json
{
"message": "Cluster pass complete",
"noteCount": 42,
"clusterCount": 5,
"clusters": [{"id": "cluster-0", "size": 9, "noteIds": ["20260222T153045-a1b2c3d4", ...]}, ...]
}POST /api/tension-pass
POST /api/tension-pass
Detect conceptual tensions — notes with contradictory content that cluster near each other.
bash
curl -sL -X POST "$SLIPBOX_URL/api/tension-pass" \
-H "Authorization: Bearer $SLIPBOX_API_KEY"Response:
json
{
"message": "Tension pass complete",
"noteCount": 42,
"clusterCount": 5,
"tensionCount": 8,
"tensions": [{"id": "tension-0", "noteA": "...", "noteB": "...", "similarity": 0.68, "clusterId": "cluster-0"}, ...]
}检测概念张力——聚类中内容相互矛盾但相似度较高的笔记。
bash
curl -sL -X POST "$SLIPBOX_URL/api/tension-pass" \
-H "Authorization: Bearer $SLIPBOX_API_KEY"响应:
json
{
"message": "Tension pass complete",
"noteCount": 42,
"clusterCount": 5,
"tensionCount": 8,
"tensions": [{"id": "tension-0", "noteA": "...", "noteB": "...", "similarity": 0.68, "clusterId": "cluster-0"}, ...]
}GET /api/theme-data
GET /api/theme-data
Returns clusters with full note content and tensions for local LLM agent synthesis. No embeddings — only human-readable data. Use this to read your knowledge graph and synthesize meta-notes per cluster, then POST them back via .
/api/add-noteRequires a current clusters index (run first).
cluster-passbash
curl -sL "$SLIPBOX_URL/api/theme-data" \
-H "Authorization: Bearer $SLIPBOX_API_KEY"Response:
json
{
"clusters": [
{
"id": "cluster-0",
"noteIds": ["20260222T153045-a1b2c3d4", "20260110T091200-b2c3d4e5"],
"notes": {
"20260222T153045-a1b2c3d4": {"title": "Optional title", "body": "Atomic idea content."},
"20260110T091200-b2c3d4e5": {"body": "Another idea."}
}
}
],
"tensions": [
{"id": "tension-0", "noteA": "20260222T153045-a1b2c3d4", "noteB": "20260110T091200-b2c3d4e5", "similarity": 0.65, "clusterId": "cluster-0"}
],
"clusterCount": 1,
"noteCount": 2,
"tensionCount": 1,
"computedAt": "2026-02-23T01:33:00.000Z"
}If no clusters exist yet, returns .
{ "message": "No clusters found. Run cluster-pass first.", "clusters": [], ... }返回包含完整笔记内容和张力信息的聚类数据,用于本地LLM Agent合成。不包含嵌入向量——仅返回人类可读数据。使用此接口读取知识图谱并为每个聚类合成元笔记,然后通过接口提交回去。
/api/add-note需要当前的聚类索引(先运行)。
cluster-passbash
curl -sL "$SLIPBOX_URL/api/theme-data" \
-H "Authorization: Bearer $SLIPBOX_API_KEY"响应:
json
{
"clusters": [
{
"id": "cluster-0",
"noteIds": ["20260222T153045-a1b2c3d4", "20260110T091200-b2c3d4e5"],
"notes": {
"20260222T153045-a1b2c3d4": {"title": "Optional title", "body": "Atomic idea content."},
"20260110T091200-b2c3d4e5": {"body": "Another idea."}
}
}
],
"tensions": [
{"id": "tension-0", "noteA": "20260222T153045-a1b2c3d4", "noteB": "20260110T091200-b2c3d4e5", "similarity": 0.65, "clusterId": "cluster-0"}
],
"clusterCount": 1,
"noteCount": 2,
"tensionCount": 1,
"computedAt": "2026-02-23T01:33:00.000Z"
}如果尚未存在聚类,将返回。
{ "message": "No clusters found. Run cluster-pass first.", "clusters": [], ... }Note Format
笔记格式
Notes in PrivateBox are Markdown files with YAML frontmatter:
markdown
---
id: 20260222T153045-a1b2c3d4
title: "Optional title"
type: meta
tags: ["tag1", "tag2"]
source: "URL or origin"
created: 2026-02-22T15:30:45.000Z
updated: 2026-02-22T15:30:45.000Z
links:
- target: 20260110T091200-b2c3d4e5
similarity: 0.91
- target: 20260115T143000-c3d4e5f6
similarity: 0.85
---
Atomic idea content in Markdown.typemetahypothesisNote ID format: (timestamp + content hash)
YYYYMMDDTHHMMSS-<8hex>Index files (in directory of PrivateBox):
index/- — noteId → vector + model + timestamp
index/embeddings.json - — noteId → array of linking notes
index/backlinks.json - — thematic groups of notes
index/clusters.json - — pairs of contradictory notes
index/tensions.json
PrivateBox中的笔记是带有YAML前置元数据的Markdown文件:
markdown
---
id: 20260222T153045-a1b2c3d4
title: "Optional title"
type: meta
tags: ["tag1", "tag2"]
source: "URL or origin"
created: 2026-02-22T15:30:45.000Z
updated: 2026-02-22T15:30:45.000Z
links:
- target: 20260110T091200-b2c3d4e5
similarity: 0.91
- target: 20260115T143000-c3d4e5f6
similarity: 0.85
---
Atomic idea content in Markdown.普通笔记省略字段。有效值:、。
typemetahypothesis笔记ID格式:(时间戳 + 内容哈希)
YYYYMMDDTHHMMSS-<8hex>索引文件(位于PrivateBox的目录下):
index/- — 笔记ID → 向量 + 模型 + 时间戳
index/embeddings.json - — 笔记ID → 关联笔记数组
index/backlinks.json - — 笔记的主题分组
index/clusters.json - — 相互矛盾的笔记对
index/tensions.json
Reading Notes from PrivateBox
从PrivateBox读取笔记
Use the CLI to read notes without needing direct GitHub API calls.
ghbash
undefined使用 CLI读取笔记,无需直接调用GitHub API。
ghbash
undefinedList all notes
列出所有笔记
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/notes"
--jq '.[].name'
--jq '.[].name'
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/notes"
--jq '.[].name'
--jq '.[].name'
Read a specific note by ID
通过ID读取特定笔记
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/notes/20260222T153045-a1b2c3d4.md"
--jq '.content' | base64 -d
--jq '.content' | base64 -d
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/notes/20260222T153045-a1b2c3d4.md"
--jq '.content' | base64 -d
--jq '.content' | base64 -d
Read the backlinks index
读取反向链接索引
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/index/backlinks.json"
--jq '.content' | base64 -d | jq '.'
--jq '.content' | base64 -d | jq '.'
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/index/backlinks.json"
--jq '.content' | base64 -d | jq '.'
--jq '.content' | base64 -d | jq '.'
Read the clusters index
读取聚类索引
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/index/clusters.json"
--jq '.content' | base64 -d | jq '.'
--jq '.content' | base64 -d | jq '.'
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/index/clusters.json"
--jq '.content' | base64 -d | jq '.'
--jq '.content' | base64 -d | jq '.'
Read the tensions index
读取张力索引
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/index/tensions.json"
--jq '.content' | base64 -d | jq '.'
--jq '.content' | base64 -d | jq '.'
undefinedgh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/index/tensions.json"
--jq '.content' | base64 -d | jq '.'
--jq '.content' | base64 -d | jq '.'
undefinedSearch notes by content
按内容搜索笔记
bash
undefinedbash
undefinedSearch PrivateBox notes for a keyword (uses GitHub code search)
按关键词搜索PrivateBox笔记(使用GitHub代码搜索)
gh api "search/code?q=<keyword>+repo:$SLIPBOX_PRIVATEBOX_REPO+path:notes"
--jq '.items[].path'
--jq '.items[].path'
gh api "search/code?q=<keyword>+repo:$SLIPBOX_PRIVATEBOX_REPO+path:notes"
--jq '.items[].path'
--jq '.items[].path'
Or clone locally for fast full-text search
或克隆到本地进行快速全文搜索
gh repo clone "$SLIPBOX_PRIVATEBOX_REPO" /tmp/privatebox
grep -r "keyword" /tmp/privatebox/notes/ --include="*.md" -l
undefinedgh repo clone "$SLIPBOX_PRIVATEBOX_REPO" /tmp/privatebox
grep -r "keyword" /tmp/privatebox/notes/ --include="*.md" -l
undefinedFind notes by tag
按标签查找笔记
bash
gh api "search/code?q=tags+keyword+repo:$SLIPBOX_PRIVATEBOX_REPO+path:notes" \
--jq '.items[].path'bash
gh api "search/code?q=tags+keyword+repo:$SLIPBOX_PRIVATEBOX_REPO+path:notes" \
--jq '.items[].path'Workflows
工作流
Capture an idea
捕捉想法
- Write the atomic idea as a single focused thought.
- POST to with the content.
/api/add-note - Note the returned and
noteIdto see what concepts it connects to.linkedNotes - Optionally run afterward if adding many notes in bulk.
/api/link-pass
- 将原子化想法写成单一聚焦的观点。
- 将内容通过接口提交。
/api/add-note - 记录返回的和
noteId,查看它关联的概念。linkedNotes - 如果批量添加大量笔记,可选择在之后运行。
/api/link-pass
Browse and explore
浏览与探索
- List notes with .
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/notes" - Read individual notes by ID.
- Follow in frontmatter to explore connected ideas.
links - Use the clusters index to browse thematic groups.
- Use the tensions index to identify areas of conceptual conflict worth investigating.
- 使用列出所有笔记。
gh api "repos/$SLIPBOX_PRIVATEBOX_REPO/contents/notes" - 通过ID读取单个笔记。
- 跟随前置元数据中的探索关联的想法。
links - 使用聚类索引浏览主题分组。
- 使用张力索引识别值得研究的概念冲突领域。
Synthesize theme meta-notes
合成主题元笔记
After running a full analysis cycle, use to read every cluster with its note contents, then write one atomic synthesis note per cluster and POST each back via .
GET /api/theme-data/api/add-notebash
undefined运行完整分析周期后,使用接口读取每个聚类及其笔记内容,然后为每个聚类撰写一个原子化的合成笔记,并通过接口提交回去。
GET /api/theme-data/api/add-notebash
undefined1. Fetch theme data
1. 获取主题数据
curl -sL "$SLIPBOX_URL/api/theme-data"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
curl -sL "$SLIPBOX_URL/api/theme-data"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
2. For each cluster, synthesize a meta-note and POST it back with type "meta"
2. 为每个聚类合成元笔记,并以type "meta"提交
curl -sL -X POST "$SLIPBOX_URL/api/add-note"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "## Cluster: Agentic Systems\n\nNotes in this cluster explore...", "type": "meta" }'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "## Cluster: Agentic Systems\n\nNotes in this cluster explore...", "type": "meta" }'
The `type: meta` field is written to the note's frontmatter and can be used by future passes to filter AI-generated notes from atomic notes.curl -sL -X POST "$SLIPBOX_URL/api/add-note"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "## Cluster: Agentic Systems\n\nNotes in this cluster explore...", "type": "meta" }'
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Content-Type: application/json"
-d '{ "content": "## Cluster: Agentic Systems\n\nNotes in this cluster explore...", "type": "meta" }'
`type: meta`字段会写入笔记的前置元数据,未来的分析任务可使用该字段筛选AI生成的笔记与原子化笔记。Run a full analysis cycle
运行完整分析周期
After adding a batch of notes or to refresh the graph:
bash
undefined添加一批笔记后或刷新图谱时:
bash
undefinedStep 1: Recompute links
步骤1:重新计算关联
curl -sL -X POST "$SLIPBOX_URL/api/link-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
curl -sL -X POST "$SLIPBOX_URL/api/link-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
Step 2: Recluster
步骤2:重新聚类
curl -sL -X POST "$SLIPBOX_URL/api/cluster-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
curl -sL -X POST "$SLIPBOX_URL/api/cluster-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
Step 3: Detect tensions
步骤3:检测张力
curl -sL -X POST "$SLIPBOX_URL/api/tension-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
undefinedcurl -sL -X POST "$SLIPBOX_URL/api/tension-pass"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
-H "Authorization: Bearer $SLIPBOX_API_KEY"
undefined