起草一份发布公告

工具栏里的纸飞机图标

打开一个项目（必须是一个有至少一次提交的 git 仓库；只 git init 但没提交是没东西可宣布的）。看主窗口工具栏 —— 有一个小纸飞机图标，开启"显示工具栏标签"时它的文字就是 Announce。这就是入口。点一下它，会从图标下面弹出一个面板。

如果没开任何项目就点这个按钮，会出一个友好的"无打开项目"提示面板 —— 先打开一个文件夹。

这个面板就是向导本身。它分五个阶段：输入 → 起草 → 审稿 → 发送 → 完成。大多数时候你只会看到输入、审稿、完成这三步。

三种模式，一个决定

输入面板顶部有一个 Mode（模式）选择器。这个选择只是在回答一个问题："我的代码是不是已经 push 过了？"

• Announce only（仅宣布） （默认） —— 代码已经 commit 并 push 时用。Announce 不会动 git，只会把"上一次书签 到 HEAD"之间的提交起草成一份公告。
• All-in-one（一气呵成） —— 你手上还有未暂存、未提交的工作，想现在就推送出去时用。Announce 会全部 stage、用占位消息 commit、push 到 origin，然后再起草公告。
• Two-step（两步走） —— 跟 Announce only 一样，但"上次宣布"的书签只在你显式去设置里点"标记 HEAD 为已宣布"时才前进。适合同一份公告你想反复迭代几次再定稿。

大多数日子你用 Announce only 就够了。其它两个是给特殊情况用的。

"新东西"到底是怎么定义的

Announce 需要知道该总结哪些提交。它为每个仓库保存一个 书签 —— 一个 commit SHA，标记着你上一次宣布到哪里。它每次起草的范围就是 书签..HEAD。

一个仓库第一次 announce 时还没有书签 —— Announce 会把最近 50 次提交当作范围，方便你做一份"从一开始"的初次公告。等你第一次发完，书签会自动前进到当前 HEAD，下一次就只看这个点之后的提交。

你可以在 设置 → Build & Ship → Announce 里查看或覆盖书签，那里有两个按钮："将 HEAD 标记为上次已宣布"和"清除书签"。

四个开关，四种输出

模式选择器下面有三个开关（再加一个在设置里）：

• Post to Slack（发到 Slack） —— 通过你配好的 webhook 把一条结构化消息发出去。消息里包含：标题、摘要、带短哈希的提交列表、diff 统计（变更文件数 / 新增 / 删除）、当前分支。在你接好 webhook 之前是禁用状态（见第六步）。
• Draft marketing copy（起草营销文案） —— AI 起草三个变体：一条推文（≤280 字符，对话风格，一个 CTA）、一则 LinkedIn 帖子（约 500 字符，专业、段落式）、一段博客文字（约 150 词，可以是一两段）。审稿面板里能看到全部三个并带复制按钮。
• Append to CHANGELOG.md（追加到 CHANGELOG） —— AI 把这次变更分类到六个分类之一（Added / Changed / Fixed / Removed / Deprecated / Security），在你仓库的 CHANGELOG.md 对应分类下加一条项目符号；文件不存在就创建；然后自动把文件 stage，等你下次 commit 一起提交。
• Also save marketing drafts to docs/announce/（同时保存营销草稿到 docs/announce/） （在设置里） —— 开启后，营销文案会同时写到 docs/announce/<日期>-<slug>.md，你之后能在 Finder 里翻出来。

每条腿独立可选。常见组合：内部小改动用"只发 CHANGELOG"，团队相关用"Slack + CHANGELOG"，对外发布用四条腿全开。

你能看到什么、能改什么

点 Draft announcement（起草公告）之后，AI 会按顺序跑三个 prompt：

1. 摘要 —— 读取提交和 diff，产出一行标题（≤60 字符）和一段 3 句话的摘要。
2. 营销 —— 拿摘要作为输入，产出推文 / LinkedIn / 博客三个变体。
3. 分类 —— 为 CHANGELOG 选一个分类（Added / Changed / 等等）。

审稿面板把这些堆叠展示：标题、摘要、Slack 帖子（可以在文本编辑器里就地编辑 —— 这是唯一一条能就地改的腿）、三个营销变体（每个带复制按钮）、CHANGELOG 条目预览。

如果哪里看着不对 —— 太长、语气不对、分类错了 —— 之后你可以在跟 AI 聊天时调一调 prompt，或者直接在 Slack 那一块就地改文字。营销变体最好当作"草稿起点"，你复制到自己的社交工具里再润色。

设置 Incoming Webhook

要让 Slack 这条腿生效，你需要一个 incoming webhook URL。在 Slack 里：Apps → Manage → Custom Integrations → Incoming Webhooks，选一个频道，复制 webhook URL。然后在 LingCode 里：设置 → Credentials → Slack incoming webhook，粘贴，保存。

在你设好之前，弹出面板里的 "Post to Slack" 开关是禁用状态，旁边会有一行提示指你去设置。webhook URL 保存在 Keychain 里，service 名是 LingCode。

不用 Slack？那就一直让那个开关关着，只用营销文案和 CHANGELOG 两条腿就行。

点了"发送"之后到底发生了什么

在审稿面板点 Send（发送）。Announce 会按顺序跑每条已启用的腿：

• Slack 帖子作为一次 HTTP POST 发到你的 webhook。
• 如果开了"保存营销草稿"，营销内容会写到 docs/announce/<日期>-<slug>.md。
• CHANGELOG 条目被写入并 stage。

之后你会到结果面板，那里列出每条腿的结果（对勾或叉），加一句结果文字（"已发布"、"已保存到 draft-2026-05-19-magic-link.md"、"已追加到 Added 区段 —— 已 stage 等待下次提交"），以及一个文件夹图标 —— 点它能直接在 Finder 里高亮营销草稿和 CHANGELOG 文件。

如果某条腿失败了，其它腿还是会继续完成 —— Slack webhook 返回 404 不会挡掉 CHANGELOG 的写入。结果面板会告诉你具体哪条腿失败、为什么。

幕后，书签会前进到你当前的 HEAD（除非你在 Two-step 模式下），所以下次 Announce 只会覆盖在这之后新增的提交。