文档

图文笔记发布

试用

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

它能做什么

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

技能文档

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 只负责流程编排 + 解析 + 长超时调用。

相关技能

按用户明确指令,在得到大脑(Get笔记)中保存、搜索并管理笔记与知识库。

作者 iswalle763 次安装66 星标

通过一次 REST API 调用,向 10 个社交平台发布视频、图片、文字与文档。

作者 victorcavero14375 次安装50 星标

把自然语言描述转为结构化 JSON,并由 mcp-diagram-generator MCP 服务生成 Draw.io、Mermaid 或 Excalidraw 图表文件。

作者 nssa.io1.0k 次安装47 星标

在本地磁盘以分类纯 Markdown 文件保存需要长期留存的事实,与智能体内置记忆并存。

作者 Iván555 次安装18 星标

通过 6551 REST API 查询 Twitter/X 用户资料、推文、粉丝事件与 KOL 数据。

作者 infra403840 次安装27 星标

从 AdMapix API 拉取广告创意、应用、榜单和收入预估等数据,原样返回结构化 JSON。

作者 fly0pants4.3k 次安装296 星标

dqsjqian 的更多技能

浏览全部技能

从日常 AI 对话里沉淀人格档案,本地明文 JSON 存储,同机器任意工具可读。

作者 dqsjqian32 次安装2 星标

智能体协会(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。

作者 dqsjqian1 次安装

用「编写 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。

作者 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.

作者 dqsjqian