LOCAL-FIRST · MULTI-PROJECT
一个留言台,
接住所有项目。
本机运行的留言与公开路线图服务。任何静态站都能通过 HTTP API 提交建议、读取公开留言; 你在后台决定采纳、修复、接入,还是拒绝。
PROJECTS
已经接入的项目。
每个项目有自己的 slug、收件箱和路线图;共用一套后台和服务。
正在读取项目…
EMBED
一行脚本,接到任何网站。
浮动的「留言」按钮、弹窗、截图上传、查询码和公开页链接都包含在内。适合静态站、博客、文档和产品页。
<script
src="http://127.0.0.1:8787/embed.js"
data-project="thinread"
data-key=""
data-label="留言"
data-position="right"
></script>
如果项目启用了提交 key,把后台生成的 key 填到 data-key。
HTTP API
接入只需要两个请求。
提交留言用 POST,读取公开路线图和留言用 GET。跨域已开放,静态站可以直接调用。
读取项目
GET /api/public/projects/:slug
提交留言
POST /api/public/projects/:slug/feedback
Content-Type: application/json
{
"kind": "建议",
"title": "希望支持按章节导出",
"body": "现在只能整本导出。",
"public": true
}
管理员接口需要 Authorization: Bearer <token>;令牌在服务启动时打印,也保存在
data/admin-token.txt。