api · reference
taste · api
给 agent / 程序员读的规范：图怎么存的、怎么用 API 拉、怎么申请 read key。
taste-index.md 格式示例
--- # 颜色 primary_color: "#8A6E4B" secondary_color: "#3D2E22" color_palette_type: "低饱和大地色系" # 字体 font_style: "无衬线" font_mood: "冷淡、克制、高级" # 排版 layout: "居中对称" density: "极简" # 视觉 mood: "冷淡 / 高级 / 极简 / 知性" style_tags: ["极简主义", "日式侘寂", "Quiet Luxury"] --- ## 元素：针织上衣（画面中段） ### 普通知识 - Loro Piana 2024 秋冬系列 - The Row 经典羊绒 - COS 极简针织 ### 设计语言 - 哑光质地 · 暗色调子 - 微落肩 + 罗纹收口 - 单一针法不混织
DESIGN.md 格式示例
--- color_surface_yellow: "#F4D35E" color_surface_purple: "#9B5DE5" font_family_display: "SF Pro Display" font_size_display: 56 radius_md: 16 state_focus_ring: "0 0 0 3px rgba(155, 93, 229, 0.40)" --- # 主题色 · 马卡龙糖果色 - primary (#9B5DE5) 占 70% - highlight (#FFE066) 占 15% - text (#1A1A1A) 占 10%
read API 端点（scope=read）
| method | path | 说明 |
|---|---|---|
| GET | /api/tastes | 列表（分页、按 tag 过滤）— 已落地 |
| GET | /api/tastes/:id | 当前态详情 — 已落地 |
scope=read 的 key 不能写。返回 401（未带 key）或 403（写操作）。
cli · rust · agent-first
taste-cli · 命令行工具
安装方式
下载后让 agent 帮你安装到合适的位置后使用:
常用子命令
taste login # 浏览器 OAuth,落 365 天 key 到本地
taste whoami --json # 当前账号 / role / scope / 过期
taste import ./corpus --public # 把本地三件套批量灌进 taste
taste list --fm density=极简 --json # 按 frontmatter 过滤,见 taste schema list
taste facets --json # corpus value 词汇表,agent 拼 facet 用
taste match --facets-json '{"facets":[{"key":"mood","value":"温暖"}]}'
taste workflow --json # 5 步 agentic search playbook(给 LLM 拼 system prompt)
taste schema match # match 子命令的输入/输出契约申请 read key
走邀请流程：admin 在 /admin/invitations 生成邀请 → 你接受 → 登录后在 /settings/api-keys 申请 read API key（scope 锁定为 read）。