微稿博客 · App 使用指南

微稿 App 使用指南:对话、写作、主题插件与发布全流程

从一次对话到可以发布的初稿:这篇指南把 App 的对话共创、写作排版、官网主题插件导入、自定义语法、发布到草稿箱与社区,以及公众号凭据配置一次讲清楚。

hello!大家好!

不少朋友下载微稿后,用了一两周才慢慢摸清它的完整链路:从一次随口的对话,到一篇排版考究的文章,再到公众号草稿箱或微稿社区。功能都在明面上,但顺序和细节值得一次讲清楚。

这篇指南按照真实写作路径展开:先对话、再写作、再打扮、最后发布。中途会解释每一步「为什么这么设计」,尤其是大家问得最多的——为什么发布要 appId、secret 和 IP 白名单这一套。

对话:把念头聊成结构

微稿不是「先想清楚再动笔」的工具。在 AI 对话面板里,你可以把一个模糊的想法直接丢进去——比如「想写写这周踩的一个坑」——然后跟着提问往下聊:背景是什么、最意外的是哪一步、能给读者带走什么。

对话的价值不在生成整篇文章,而在把散乱的念头整理成可写的结构。聊到一定火候,让 AI 把讨论结果归纳成提纲,一键进入编辑器,写作就有了骨架。

如果希望 AI 的回答贴合最新事实(新版本号、刚发生的事),可以在「设置 → Agent 设置 → AI 联网搜索」里接入 Tavily、Monid、Firecrawl 或 Ollama 之一,详见博客里那篇AI 联网搜索配置指南。

写作与排版:同一个人的两种专注

进入编辑器后,微稿提供双重视图:一侧专注书写,一侧实时预览最终排版。写的时候是 Markdown 的轻,看的时候是公众号排版的稳,两种视图随时切换、互不打断。

双重视图写与看随时切

沉浸输入不受按钮干扰,随时切到预览检查呼吸感。

手机框预览读者第一眼

用真实手机框还原读者在屏幕上的第一眼感受。

本地优先草稿在自己电脑

草稿与素材完整保存在本地,断网也能踏实写。

写作过程中 AI 随时在侧:卡壳时帮你展开视角,写完帮你润色字句,还可以配合意境配图。素材库把文章、目录与评论集中管理,多号工作区则让主号、小号、代运营的号互不串门。

从官网导入主题插件

微稿的排版能力可以按模块扩展:标题、正文、引用、分隔线、提示块、下划线、删除线、加粗、高亮、脚注、列表、配图,每个模块都有多种预设样式,全部在官网主题插件页免费提供。

导入流程只需要三步:

  1. 01
    在官网挑选样式

    打开主题插件页,按模块切换或搜索关键词。每张卡片都有实时预览,看好哪款点哪款。

  2. 02
    点击「一键导入」

    浏览器询问时选择打开微稿,App 会通过 microdraft://themes/import 应用链接自动接管。

  3. 03
    在 App 内确认安装

    样式使用行内样式实现,不依赖外部 CSS;SVG 图案会经过 App 的安全白名单校验,白名单之外的元素与脚本在导入时直接拒绝。

App 支持的特殊语法

标准 Markdown(标题、列表、表格、图片)全部照常使用。在此之上,微稿扩展了几种语法,让长文更有结构感和节奏感:

语法写法效果
语义提示块:::tip 要点 ::: 或 :::warning … ::: 多行区块13 款原生提示块(tip / info / warning / error / think / wow / happy / laugh / surprise / scared / sad / cry / angry),预览与公众号复制保持稳定样式。
时间线:::timeline 内放 JSON 数组,每项含 date、content,可选 keyword渲染为一张与文章主题色一致的时间线图片,适合复盘与里程碑。
代码围栏标准 ``` 加语言标记开启「Codia 图片」模式后渲染为高亮代码图片,公众号编辑器不再吞缩进。
引用块标准 >按当前引用风格渲染为带署名的图片,适合金句与摘录。

提示块使用英文标识符并成对闭合:

提示块写法示例
:::warning
这里可以写下多段落正文,支持**粗体**与`行内代码`。
:::

:::tip 直接写下一句即刻可用的要点 :::
时间线写法示例
:::timeline
[
  { "date": "2026.06", "content": "确定选题", "keyword": "选题" },
  { "date": "2026.07", "content": "完成初稿", "keyword": "初稿" }
]
:::

不确定效果时先看预览;时间线的 JSON 必须合法、标记必须成对,否则不会渲染。

发布:草稿箱与社区是两条路

文章写完后,微稿提供两个发布去向,解决两件不同的事:

公众号草稿箱给读者的正式发布

图文一键同步到公众号后台草稿,何时群发由你在微信后台确认。

微稿社区给同路人的分发

一键发布到微稿社区,被同路人读到、点赞和搜到,给公众号多开一个入口。

一键复制手工兜底

不配置凭据也可以一键复制进公众号后台,间距色彩完好还原。

发到草稿箱:确认公众号凭据配置无误后,点击「存入草稿箱」,微稿会代表你的公众号上传封面与文中配图,再创建草稿。建议先用一篇测试文章走通全流程,再用于正式内容。

发到社区:在文章页选择分享到社区,正文里的本地图片会先自动迁移到官网图床,封面同理——所以本地文件之后移动或删除都不影响社区展示。同一篇文章再次分享只会更新原记录,点赞、反馈和阅读量都保留。每篇文章最多关联 3 个标签,也可以先在「社区资料」里维护自己的公众号名片(名称、头像、各自的二维码)。

凭据与安全:为什么要 appId、secret 和 IP 白名单

这是被问得最多的一节。微稿帮你发草稿,本质是以你的公众号身份调用微信的接口:请求 access_token、上传图片、创建草稿。微信不认识「微稿」,它只认三样东西:

appId账号门牌号

公众号的公开开发者 ID,告诉微信这次操作发生在哪个号。

appSecret操作凭证

换取 access_token 的开发者密码,谁持有它,谁就能操作这个号。

IP 白名单来源门禁

微信只接受来自白名单内公网出口 IP 的接口请求,密钥泄漏了还有一道兜底。

这三层各有分工:appId 认账号,appSecret 认权限,IP 白名单限定「从哪里可以动用这把钥匙」。少了任何一层,微信都无法安全地把草稿箱交给一个外部程序。

具体到配置:appId 与 appSecret 从微信公众平台「设置与开发 → 基本配置」获取(详细步骤见这篇接入指南),填入微稿「设置 → 凭证 → 微信公众号」;IP 白名单填写的是运行微稿的设备或代理出口的公网 IP——不是浏览器所在网络的 IP,更不是 127.0.0.1。本机换网络或启用代理后,记得同步更新白名单。

换一个角度想:这套繁琐的门禁恰恰是保护。appSecret 等同于公众号的最高操作权限,微信强制要求「密钥 + 可信来源」双重校验,才让你的草稿箱不至于对整个互联网敞开。微稿只在本地安全配置中保存密钥,且只用于向微信换取临时凭证;任何时候都不要把 appSecret 写进文章正文、截图或公开仓库。

写在最后

对话打开思路,写作打磨表达,主题插件负责体面,语法负责节奏,发布负责抵达。整条链路都顺了之后,剩下的就只有内容本身。

祝写作愉快。