# yyps.net

yyps.net 是一个微信公众号发布服务:Markdown 编辑 + 主题渲染 + AI 封面 + 一键发布到草稿箱。

## 核心能力
- Markdown 编辑器(在线编辑 + 实时预览)
- 主题渲染:10 个预设(4 基础 + 6 精选配色:宝石靛/柔光蓝/雾霾蓝/青灰蓝/紫罗兰/墨绿)+ custom 自定义主题(配色/代码块/引用样式)
- AI 摘要(LLM 一键生成文章摘要)
- AI 封面:LLM 读全文提炼画面 + 21:9 宽幅,后台异步生成并 draft/update 换上,不阻塞发文(调用方秒回)
- 发布历史:来源系统/IP + 封面策略 + AI 封面生成状态(pending/done/failed)全程追踪
- 第三方 API 接入:API Key + cover 枚举(ai/auto/provided/none,默认 ai:兜底封面秒回 + 后台 AI 异步出图),一个 HTTP 调用发草稿
- 小程序通道(纯通道,小程序 AppSecret 由本服务加密托管,调用方不持 secret):订阅消息发送 + 内容安全校验(msgSecCheck 2.0,openid 透传)

## API 接入(给第三方系统)
- 接入文档(静态页,AI/爬虫可直接读): https://yyps.net/docs
- 接入文档 Markdown 源(喂给 LLM 用): https://yyps.net/docs.md
- 发布接口: POST https://yyps.net/api/mp/publish(header: x-api-key;不是 Authorization Bearer,那是 admin 后台 JWT)
- 主题列表: GET https://yyps.net/api/publish/themes/public(公开,无需认证)
- 账号主题查询: GET https://yyps.net/api/mp/account-theme?account=<key>(API Key;本地渲染调用方先取主题配置再渲染,content_format=html 时主题方可生效)
- 渲染接口: POST https://yyps.net/api/render(公开;Markdown/IR → 微信兼容 HTML;theme 传主题库 key,缺省 default;仅渲染,不过发布链路的兼容改写)
- 订阅消息发送: POST https://yyps.net/api/miniprogram/subscribe/send(权限码 subscribe:send;每 key 1h/3000 次护栏;微信业务拒绝走 HTTP 200 + 语义化 reason)
- 内容安全校验: POST https://yyps.net/api/miniprogram/sec-check(权限码 sec_check:check;每 key 1h/1000 次护栏;仅 HTTP 200 + pass:false 是内容结论,通道异常(403/429/502)调用方应 fail-open 放行)

## 定位
共享服务(未来多应用接入)。身份认证与授权统一由 auth.ai-as.cc 承担,本服务只管公众号发布与小程序通道业务。