메뉴
说说笔记单一综合 skill。默认走 HTTP API，MCP 仅在明确已启用时使用。覆盖发布、搜索、分页、详情、更新、删除、置顶、登录、令牌、状态、配置、日历与 RSS。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | shuoshuo-notes |
| description | 说说笔记单一综合 skill。默认走 HTTP API，MCP 仅在明确已启用时使用。覆盖发布、搜索、分页、详情、更新、删除、置顶、登录、令牌、状态、配置、日历与 RSS。 |
本 skill 仅保留一份，统一封装“说说笔记”的两种调用模式：
API 模式：默认模式，项目默认部署通常不启用 MCP 时使用MCP 模式：只有在环境明确已启用 MCP 时才使用核心要求：
当用户有以下需求时，应调用本 skill：
为避免每次改文档，建议优先使用同目录 config.json 作为运行参数来源。
优先级建议如下：
skill/config.json 中的配置推荐 AI 行为：
skill/config.jsonbaseUrl 作为 API 基础地址mcpBaseUrl 作为 MCP HTTP/SSE 验证地址defaultMode=api 时默认走 APIautoFallbackToApi=true 且 MCP 不可用时自动回退 API当满足以下任一条件时，AI 应进入“配置引导模式”并先提问，不直接执行写操作：
baseUrl 为空baseUrl 仍是占位值（如 your-domain.com）onboarding.completed=false 且 onboarding.enabled=true引导模式建议提问顺序：
https://example.com）？API 还是 MCP？MCP 失败自动回退 API”？引导完成后，AI 应在后续对话中默认沿用本轮确认的配置，并在必要时提醒你同步更新 skill/config.json。
默认决策顺序必须如下：
以下情况视为“已明确启用 MCP”：
final-mcp、独立 mcp 容器，或已暴露 /mcp/* 端点GET /mcp/tools 或 GET /mcp/sse 可访问以下情况一律按“未启用 MCP”处理：
docker-compose.yml 使用主应用 target: final1315 或 MCP 子进程API 模式为默认首选，直接调用后端 HTTP 接口。
状态：GET /api 或 GET /api/status配置：GET /api/frontend/config 或 GET /api/settings分页：GET /api/messages/page 或 POST /api/messages/page详情：GET /api/messages/:id搜索：GET /api/messages/search标签内容：GET /api/messages/tags/:tag标签列表：GET /api/messages/tags日历：GET /api/messages/calendarRSS：GET /rss登录：POST /api/login发布：POST /api/messages 或 POST /api/token/messages更新：PUT /api/messages/:id 或 PUT /api/token/messages/:id删除：DELETE /api/messages/:id 或 DELETE /api/token/messages/:id置顶：PUT /api/messages/:id/pin 或 PUT /api/token/messages/:id/pin读取 token：GET /api/user/token重建 token：POST /api/user/token/regenerate更新设置：PUT /api/settings 或 PUT /api/token/settingsMCP 模式仅在确认已启用后使用，工具入口位于 mcp/server.js。
search / 搜索page / 页面message / 消息publish / 发布 / 笔记 / 说说 / 说说笔记delete / 删除update / 更新pin / 置顶消息settings / 设置status / 状态calendar / 日历config / 配置login / 登录token / 令牌rss / RSS以下任务默认走 API：
以下任务在默认情况下也应优先 API：
只有当 AI 客户端已经接好 MCP，且用户希望通过 MCP 工具统一操作时，才切到 MCP。
读取接口通常无需认证：
/api/api/status/api/frontend/config/api/settings/api/messages/page/api/messages/:id/api/messages/search/api/messages/calendar/rss写接口需要认证，分两类：
会话认证：/api/login 成功后，调用 /api/messages/*、/api/settings、/api/user/token*Token 认证：调用 /api/token/messages*、/api/token/settings建议：
publish、delete 可优先使用 token 路由update、pin、settings 更稳妥的方式是先登录，使用会话路由读取 token 与 重建 token 必须先登录search、page、message、status、calendar、config、rss 通常无需认证publish、delete 可使用 NOTE_TOKEN 或已登录会话update、pin、settings 应优先先执行 logintoken 必须先执行 loginid 时，直接查详情推荐输出字段：
id内容类型建议：
type: "text"type: "markdown"type: "image"type: "multipart"id请求：
GET /api/messages/search?keyword=欢迎&page=1&pageSize=10
说明：
query 作为关键词字段# 开头时，可按标签语义理解GET /api/messages/page?page=1&pageSize=10
或：
POST /api/messages/page
{
"page": 1,
"pageSize": 10
}
GET /api/messages/123
POST /api/token/messages
{
"type": "text",
"content": "今天完成了 skill 配置"
}
POST /api/token/messages
{
"type": "markdown",
"content": "# 标题\n正文内容"
}
POST /api/token/messages
{
"type": "image",
"image": "https://example.com/a.jpg",
"content": "图片配文"
}
POST /api/token/messages
{
"type": "multipart",
"images": [
"https://example.com/a.jpg",
"https://example.com/b.jpg"
],
"content": "多图说明"
}
PUT /api/messages/123
{
"content": "更新后的内容"
}
DELETE /api/messages/123
PUT /api/messages/123/pin
{
"pinned": true
}
POST /api/login
{
"username": "admin",
"password": "your_password"
}
GET /api/user/token
POST /api/user/token/regenerate
{
"query": "欢迎",
"page": 1,
"pageSize": 10
}
{
"page": 1,
"pageSize": 10
}
{
"id": "123"
}
{
"type": "text",
"content": "今天完成了 skill 配置"
}
{
"id": "123",
"content": "更新后的内容"
}
{
"id": "123"
}
{
"id": "123",
"pinned": true
}
{
"username": "admin",
"password": "your_password"
}
本目录为独立 skill 目录，可单独复制到本地 AI 客户端技能目录中使用。
建议目录结构：
skill/
SKILL.md
USAGE.md
安装步骤：
skill 整个目录SKILL.mdUSAGE.md建议同时保留并按需修改：
config.json：集中维护域名、默认模式与认证偏好若你只是部署了默认项目，通常直接使用 API 即可。
推荐先定义：
export BASE_URL="https://your-domain.com"
export MCP_BASE_URL="https://your-domain.com"
基础地址示例：
http://localhost:1314https://your-domain.com建议优先检查：
GET /api/statusGET /api/messages/page?page=1&pageSize=5GET /rssMCP 不是默认前提，需要单独启用后再使用。
cd /Library/Github/Ech0-Noise/mcp
npm install
客户端配置思路：
{
"mcpServers": {
"shuoshuo-notes": {
"command": "node",
"args": ["/Library/Github/Ech0-Noise/mcp/server.js"],
"env": {
"NOTE_HOST": "https://your-domain.com",
"NOTE_HTTP_PORT": "0",
"NOTE_TOKEN": "你的后台token"
}
}
}
}
若使用独立 mcp 服务或 final-mcp 目标，可通过 /mcp/* 端点验证。
curl "$MCP_BASE_URL/mcp/tools"
curl -N "$MCP_BASE_URL/mcp/sse"
使用本 skill 时，建议：
API 还是 MCP因为项目默认部署并不等于默认启用 MCP。
已知依据：
docker-compose.yml 中主应用使用 target: finalREADME.md 明确区分了不带 MCP 的 final 与带 MCP 的 final-mcp这属于正常情况。
处理方式：
处理方式：
若遇到 EADDRINUSE：
NOTE_HTTP_PORT 设为 0同目录已提供以下配套文档：
USAGE.md：完整使用说明主文档，包含快速开始、模式判断、认证流程、操作流程、排障与最佳实践EXAMPLES.md：可直接照抄的 API / MCP 示例、响应模板、排错示例README.mdmcp/README.mdinternal/routers/routers.gomcp/server.js