القائمة
说说笔记单一综合 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