insight-public-post v1.1A

Immutable. This exact content is served forever at /api/v1/blob/ca30480862cf49be.

---
name: insight-public-post
version: 1.1
description: 把知识库（D:\AIGC工作站\知识库）新沉淀的内核档改写成面向所有用户的「公开版」对外帖，B 站 AI 开发者小站首发：按 08_对外分发体例写成独立成篇的白话稿，归档、登记索引、提交推送，并交付可直接粘贴发帖的成稿；发布后回收作者终稿微调，保持库内版与线上版一致。当用户说「发小站 / 写公开版 / 同步对外帖 / 把这篇沉淀分发出去 / 写成帖子」，或一篇知识库复盘/insight 刚沉淀完成需要对外分发时触发——只要涉及「知识库内容 → 对外公开发布」就用本 skill，即使用户没提「小站」二字。
---

# 知识库 insight → 公开版对外帖（B 站 AI 开发者小站）

把一篇知识库内核档（含双链、面向自己的复盘）改写成**任何陌生人都能冷读**的公开帖。分发链路：内核档 → 公开版（本 skill 产出）→ 用户手动发 B 站小站 → **发布后回收终稿**（本 skill 收尾）。**发帖动作永远由用户手动完成**，本 skill 交付到「可整篇粘贴的成稿」为止，并在发布后负责把作者的平台端微调回写库内。

## 第 0 步：定位内核档

- 默认取**本次会话刚沉淀/刚讨论的那篇**内核档；没有明确对象时问用户要路径。
- 内核档还没写时，先完成内核沉淀（进知识库对应栏目 + 索引/MOC 登记），再回来做公开版——顺序不能反，公开版的每个事实都要能溯源到内核档。
- 动笔前先读两份参照：
  1. 内核档全文（事实来源，公开版不得新增内核档里没有的事实）；
  2. 黄金样例 `D:\AIGC工作站\知识库\08_对外分发\AI日报全绿却停更_云端定时任务连环翻车复盘_公开版.md`（语气、结构、脱敏尺度的基准）；【踩坑记录】tag 类可另参照 `08_对外分发/B站Toy发布后更新不动了_三环断裂排障复盘_公开版.md`。

## 第 1 步：写公开版

### 体例硬规则（08_对外分发的既有规范）

- **独立成篇**：正文零 `[[双链]]`、零库内引用、零「见另一篇」，陌生人冷读无障碍；
- **名词小抄**：正文用到的、不懂就跟不上主线的术语，在首次出现附近集中白话解释。排版用**加粗标题「名词小抄」+ 普通无序列表**——**禁止引用块内嵌列表**（`> - xxx`），B 站小站等渲染器会把引用符和列表拆开显示（2026-07-12 实测翻车，v1.0 的「用引用块」规则由此废弃）；
- **全角标点 + 程序化校验**：正文中文标点一律全角（，。：；（）“”），**但不能靠手写保证**——生成/手写混排必漏（实测一篇漏 47 处）。成稿后必须跑一遍程序化校验与转换：
  - 扫描目标：正文中残留的半角 `, ; : ( ) ! ?` 与成对英文引号；
  - 保护区：代码围栏（``` 块）与行内反引号片段**整体跳过**——这些是要被读者复制执行的内容（URL、配置、代码），必须保持半角原样；
  - 转换脚本里的全角字符用 **Unicode 码点**指定（`0xFF0C` ，/ `0xFF1A` ：/ `0xFF1B` ；/ `0xFF08` （ / `0xFF09` ）），不要写字面字符——生成端自身会半/全角混淆，码点才是确定的；
  - 转换后再扫一遍,直到 0 残留才交付。
- **段落宜短**：移动端阅读密度高，一段一个意思；`---` 水平分隔线在小站编辑器无渲染价值，不要用（作者终稿实测会删）；
- **文件命名**：`{口语化标题}_公开版.md`，存入 `D:\AIGC工作站\知识库\08_对外分发\`。

### 语气（B 站人设：技术向 + 整活自黑）

- 短句，皮，不要官方腔：禁止「本文将介绍」「综上所述」这类开场收场；
- 叙事优先于说教：有事故就从事故现场讲起（"打开一看：绿的，全是绿的"），钩子放在方法论前面；
- 自黑是好素材：自己被自己写的代码骗了、白烧了 API 钱，这类桥段照实写，比装专家可信；
- 「可直接抄走」的资产是传播点：配置速抄代码块、排查口诀、结尾清单——读者为这个转发；
- 结尾给一段**可以直接抄走的清单**（心得/口诀/步骤），最后一句收个皮的。

### 内容改写要点

- **只做翻译不做创作**：把内核档的事实翻译成白话，可以删细节、不可以编事实；内核档里标注「未验证/待观察」的结论，公开版同样要留诚实边界或干脆不写；
- **叙事数字零虚构**：凡是描述「这次发生了什么」的数字（耗时、次数、金额、轮数）都必须能在内核档里指认出处——读者会把「排查了三小时」当真事传播，被扒就是公信力事故；没有出处就用定性表达（「折腾了半天」可以，「3 小时」不行）。建议句里的惯用语（「花一分钟自查」「十秒就能验」）不算叙事数字，可以用，但别密集堆。写完在交付说明里列出全部叙事数字及各自出处——用可验的清单，别写「未虚构任何数据」这类不可验的绝对声明；
- **名词小抄以「跟不上主线」为线**：判断标准不是「所有术语都解释」，而是「读者不懂这个词就无法理解本文主线」——这类词必须解释（实测最容易漏的恰是 iframe、CI 这种「感觉大家都懂」的词），修饰性长尾术语（懒加载、节流之类顺带提到的）可以不解释。写完做一次回扫：把正文首现术语列成清单逐个判断该不该解释，凭印象扫会稳定漏词；
- **脱敏**（发布前逐项过一遍）：
  - 匿名化供应商与账户：中转站/代理商写成「API 中转站」，模型名视内容敏感度决定是否点名（默认匿名成「贵的/便宜的」，用户可要求还原）；
  - 抹掉能定位到账户或机器的信息：本机路径、服务器 IP、仓库 secret 名、余额截图式精确数字（保留量级即可）；
  - **内核档里的真实标识符不得原样出现**：仓库名/base 路径（如 `/above-the-web`）、域名、项目代号——发布前拿内核档里的专有字符串在成稿里搜一遍，命中的一律换成示例值（`/my-site` 这类）；判断标准是「读者拿这个串能不能搜到你」。例外：内容本身就是该项目的公开复盘、且作者已在帖中自认作品时，项目名与公开可见的平台 ID 可保留（如 Toy 复盘里的 toy_id——它本来就印在线上外壳页里）；
  - 可复用的数据点（成本对比、轮数、耗时）**保留**，这是帖子的传播点；
- **长度**：1500-2500 字为宜，超了就砍过程细节、保住坑和结论。

## 第 2 步：归档、登记、推送

1. 成稿写入 `08_对外分发/`；
2. 在 `08_对外分发索引.md` 的「已分发清单」表格登记一行：`| 文件名（B站AI开发者小站首发） | 对应内核文档路径 | 主题一句话 |`——溯源关系写在索引里，正文保持零双链;
3. 内核档文末加一行指向对外版（**裸路径，不用双链**，对外稿不进图谱）；
4. 按知识库 CLAUDE.md 惯例**一并 commit 并 push**（提交信息用「分发:…」或「对外分发:…」前缀），push 即触发官网同步；
5. 回复用户：给出成稿文件链接，说明可整篇粘贴发小站，并提示已做的脱敏处理（如模型名已匿名，想点名可还原）。

## 第 3 步：发布后回收终稿（v1.1 新增）

作者几乎总会在小站编辑器里做最后微调（拆段调节奏、删分隔线、改个别措辞）。**发布不是终点，库内版 = 线上版才是终点**：

1. 用户给出已发布的 opus 链接后，抓取线上正文（浏览器取页面文本即可）；
2. 与库内成稿逐段比对，把作者的微调回写到库内文件——注意线上抓取会丢失加粗/代码块等格式，**只回写内容与分段差异，不动库内已有的 Markdown 格式**；
3. 可在索引该行补记发布链接；
4. commit（「修订:…同步线上终稿」前缀）并 push。

## 边界

- 不替用户登录/发帖，不操作浏览器发布（回收终稿时**读**已发布页面除外）；
- 内核档之外的事实缺口（比如用户想补的新数据）→ 问用户，不要脑补；
- 如果内容涉及公司（鲸海拾贝）内部信息，先提醒用户确认可公开再动笔。

## 版本记录

- **v1.1（2026-07-12）**：源自【踩坑记录】B站Toy复盘帖实战——① 名词小抄改「加粗标题+普通列表」，废弃引用块内嵌列表（渲染器拆开实测翻车）；② 全角标点从「体例要求」升级为「程序化校验流程」（保护代码区/码点替换/0 残留才交付）；③ 新增第 3 步「发布后回收终稿」；④ 脱敏规则补「公开复盘自认作品时项目名与公开平台 ID 可保留」例外；⑤ 补「段落宜短/不用 --- 分隔线」「可抄资产是传播点」。
- **v1.0（2026-07-05）**：skill-creator 2 轮评测封装（with/without 对照），确立三层闭环/脱敏三层/叙事数字零虚构。原文保留于 `07_skill存档/insight-public-post_v1.0_SKILL.md`。