Documents

图文笔记发布

Try it

通用「图文笔记发布」框架:把本地 markdown 文案 + 配图,通过你指定的 MCP 发布后端,一键发布为图文笔记(含 note_id 回查)。 只负责登录与发布编排,不碰内容创作;不绑定任何特定平台,后端地址由用户自己配置。 触发词:图文笔记发布、笔记发布、社交笔记发布、登录发布、发布失败重试。

What it does

把本地 markdown 文案 + 配图,通过**你指定的 MCP 发布后端**,一键发布为图文笔记。

The skill document

note-publisher — 图文笔记发布

把本地 markdown 文案 + 配图,通过你指定的 MCP 发布后端,一键发布为图文笔记。

只做两件事:登录发布。不碰内容创作。

⚠️ 本 skill 是纯通用框架,不内置任何平台的发布能力。 你必须先提供一个暴露 check_login_status / publish_content / get_my_profile 这三个工具的 MCP 发布服务地址,配置好之后才能工作。没有后端地址 = 无法发布。

第一步:配置 MCP 发布后端(必做)

本 skill 通过环境变量 MCP_PUBLISHER_URL 读取你的后端地址:

export MCP_PUBLISHER_URL="http://localhost:18060/mcp"

也可以把地址写进 config.json(放在本 skill 目录下,脚本会优先读它):

{ "mcp_url": "http://localhost:18060/mcp" }

后端是什么、从哪下载、怎么启动,由你的目标平台决定——任何暴露上述三个 MCP 工具的发布服务都能接。参考 config.example.json

配置好后自检:

python3 scripts/publish.py check

第二步:发布

# 发布单篇(标题缺省取 md 第一行 `# 标题`,可用 --title 覆盖)
python3 scripts/publish.py /path/to/note.md

# 批量发布目录下所有 .md
python3 scripts/publish.py --dir /path/to/posts/

脚本内部走 MCP Streamable HTTP(长超时 300s),发布后自动调个人主页回查并打印 NOTE_ID

markdown 输入格式约定

# 标题(≤20 字)
正文第一段……(口语化,可带 emoji)

#话题1 #话题2 #话题3
---
## 配图(可选:表格列出图片路径,相对路径相对于 md 所在目录)
| # | 文件 |
|---|------|
| 1 | ./img/cover.jpg |
| 2 | ./img/chart.png |
  • 标题# 开头的那行;超过 20 字会告警,建议 --title 传入短标题。
  • 正文:标题之后、--- 分隔线之前的所有内容(含 #话题 行)。
  • 标签:从正文里的 #话题 自动提取;重复自动去重。
  • 图片:从表格里任意 .jpg/.png/.jpeg/.webp 路径提取,按出现顺序上传;至少 1 张。

接入你自己的后端

任何后端,只要满足下面三点即可接入,无需改本 skill:

  1. 暴露 check_login_status 工具(返回登录状态)
  2. 暴露 publish_content 工具(入参 title / content / images / tags
  3. 暴露 get_my_profile 工具(返回最近发布的笔记列表,用于回查 note_id

Pitfalls(踩过的坑)

  1. 后端版本要足够新:旧版发布时会报"没有找到发布 TAB - 上传图文",是创作者中心改版、旧选择器失效。
  2. 登录二维码只调一次:后端 get_login_qrcode 有单会话约束,「开新的取消旧的」。连续调用会让用户扫到被取代的旧码。
  3. 配图路径要精确到扩展名:表格里路径后常带全角括号尺寸注释 (1920×1280),解析用 [\w\-./]+\.(?:jpg|png|jpeg|webp) 精确匹配,别用 [^\s))]+(会连括号内容一起吞 → 图片文件不存在 → 发布卡死超时)。
  4. 发布超时:单篇约 2 分钟(上传多图 + 填标题正文 + 点标签)。本脚本自带 300s 长超时。
  5. note_id 不在 publish 返回值里publish_content 成功只回"内容发布成功",note_id 要从个人主页按标题匹配,脚本已内置。
  6. cookies 服务端会提前失效:客户端 expires 可能显示很久,但服务端长期不用会踢。自动化开始先 check,未登录先扫码再继续。

验证清单

  • 已配置 MCP_PUBLISHER_URL(或 config.json
  • publish.py check 返回「已登录」
  • 标题 ≤ 20 字、正文 ≤ 1000 字、图片 ≥ 1 张
  • 发布后拿到 NOTE_ID,回查时标题能对上

依赖

  • 一个自备的 MCP 发布后端(本 skill 不自带)。本 skill 只负责流程编排 + 解析 + 长超时调用。

Related skills

Post videos, photos, text, and documents to 10 social platforms through a single REST API call.

by victorcavero14375 installs50 stars

Generate and edit Draw.io, Mermaid, and Excalidraw diagrams from natural language using a structured JSON spec.

by nssa.io1.0k installs47 stars

Stores durable facts in a categorized, plain-markdown vault on disk, alongside your agent's built-in memory.

by Iván555 installs18 stars

Query Twitter/X profiles, tweets, follower events, and KOL data through the 6551 REST API.

by infra403840 installs27 stars

Fetch raw ad creative, app, ranking, and revenue data from AdMapix as structured JSON.

by fly0pants4.3k installs296 stars

More from dqsjqian

Browse all skills

Build a persistent personality profile from everyday AI conversations, stored locally as plaintext JSON.

by dqsjqian32 installs2 stars

智能体协会(agent-guild)— cross-agent shared memory. 本机多个 AI agent 共享 同一份身份、规则、记忆与交接消息 — 纯本地 Markdown/JSON,无服务器。 触发(任何自然等价表达都算): · 身份/习惯:"我是谁" "我的身份/习惯/偏好" "who am I" "my routine" · 回忆/历史:"你记得吗" "之前聊过" "上次我们" "what did we discuss" · 写记忆:"帮我记住" "记一下" "沉淀一下" "remember this" "记到日志" · 跨 agent:"告诉其他 agent" "交接给" "让 XX 也知道" "hand off to" · 当前状态:"现在在做什么" "当前任务/焦点/进度" "current focus" · 数据卫生:"整理一下协会" "清理过期数据" "协会瘦身/归档" "防止数据劣化" "groom" "cleanup" "archive old data" · 跨设备:"换了台电脑" "另一台机器" "Windows/Linux 上用不了" "这台设备" "这个工具在哪" "cross-device" "another machine" "which platform" · 加入:"加入协会" "初始化协会" "join agent guild" "install this skill" 能力:读/写共享身份、规则、焦点;收件箱交接;每日日志;会话闭环 (`ag recall` 检索共享记忆 / `ag finish` 收尾沉淀,3.9.0+);并发追加 咨询锁防丢写;跨 agent 学习台账 (错误/纠正/特性请求 → 复发追踪 → 晋升为规则或共享 skill);数据卫生 (bootstrap 后自动 groom 归档过期数据);跨设备可移植(shared/platform/host 三层作用域,`ag platform` / `ag tool <name>` / `ag port`); `ag init/adopt/link-root/bootstrap/recall/finish/doctor/groom/upgrade/learn/review/resolve`。 未加入?先跑 docs/ONBOARDING.md。

by dqsjqian1 installs

用「编写 SVG」的方式生成图片——让没有多模态生图能力的模型也能产出任意宽高比、任意复杂度的矢量图,并导出为 SVG / PNG / 动图(GIF/APNG/WebP/MP4),或内嵌进 HTML。 适用场景:用户要「生成一张图 / 画个图 / 做张配图 / 做海报 / 信息图 / 图表 / 流程图 / 架构图 / 图标 / 封面 / OG 图」,要求指定宽高比(16:9 / 1:1 / 9:16 等)或导出 PNG;也包括「做个动图 / GIF / 加载动画 / loading 动效」。 能力:① 按指令编写复杂 SVG(图表/插画/流程图/海报);② SVG→PNG 高清渲染(Chrome 优先,cairosvg/resvg 兜底);③ 多帧/模板 SVG→GIF/APNG/WebP/MP4 动图;④ 任意宽高比与 DPR。 关键词:生图、画图、SVG、矢量图、配图、海报、信息图、图表、流程图、架构图、图标、封面、OG image、转 PNG、动图、GIF、动画、loading。

by dqsjqian

AI 八信条(AI Eight Creed)—— 一套最高优先级的 AI 行为守则(八耻八荣)。 任何 AI agent 都应无条件遵循:以瞎猜事实为耻、以查证溯源为荣;以模糊执行为耻、 以澄清边界为荣;以擅自臆断为耻、以人类拍板为荣;以另起炉灶为耻、以沿用现成为荣; 以跳过核验为耻、以闭环自检为荣;以破坏章法为耻、以遵循规范为荣; 以假装理解为耻、以坦白无知为荣;以将错就错为耻、以正本清源为荣。 Triggers: "八耻八荣", "八信条", "AI 行为守则", "遵守守则", "查证溯源", "澄清边界", "人类拍板", "沿用现成", "闭环自检", "遵循规范", "坦白无知", "正本清源", "eight creed", "ai creed", "eight honors and shames", any request involving agent behavior rules or ethical guidelines.

by dqsjqian