SuperAPI AI 工具集

dby-theme

通用与其它

查看项目

更新于 10-16 09:59

技能介绍

用途:把用户的日常口语描述(如换成暖橘色、标题加竖条、引用做成卡片、字大一点、排版像某个号)翻译成公众号排版主题 themeJson,改好后存回服务端设为默认,或落成本机 theme 文件。渲染与存主题免费不扣点。

主要能力:排版是一份声明式 themeJson(配色 palette + 各标签内联样式模板),渲染器据此把 Markdown 确定性渲染为公众号内联样式 HTML。支持服务端主题 CRUD 与渲染:GET/POST /api/wechat/theme、GET /api/wechat/themes、POST /api/wechat/render、PUT/DELETE /api/wechat/theme/:id。render 主题解析优先级为主题 themeJson > themeId > 我的默认主题 > 兜底 benya-clean;一人一默认,isDefault 为 true 时服务端在事务中把其他主题的 isDefault 置反。

使用方式:先读起点主题并强制落盘备份(curl -s -H "$AUTH" "$BASE/api/wechat/theme" | tee 备份文件),或列出内置主题复制起步;再按描述改 themeJson,只换配色时改 palette 八个键即可,其余用 {{token}} 自动跟随;随后用 node scripts/validate-theme.mjs 本地零依赖自检,exit 0 为合法;再用 render 接口拿回 HTML 存本地打开预览,改一版看一版。最后存回服务端或落本机文件。鉴权:export DOUBAOYA_API_KEY="dyh_你的密钥",BASE 默认 https://doubaoya.com。

适用场景:只想把默认排版改成自己想要的样子;或用该主题排版某篇正文并存入公众号草稿;后续写作、发布、违禁词检查等分别由 dby-api、dby-publish、dby-banned-words 等承接。

限制与注意:改主题是就地覆写(PUT/POST + isDefault:true),服务端不保留历史版本,动手前必须备份,改坏按部署范围文档的回滚步骤 PUT 回去。四条硬约束:标题装饰必须写在有文字的元素自身,不能用空装饰块;不要给整篇套 decorations.articleWrap 外框;服务端会 validateTheme,不合法直接 400;先跑校验器自检。sample.md 不要带一级标题,否则会显示两个大标题。具体字段与校验规则以 scripts/validate-theme.mjs 为准。其余菜单式细节未在资料中给出。