投稿规范(大模型写作规范)

新增文章的标准流程:把需求交给大模型 → 按本规范产出数据对象 → 粘贴进 data/posts.js → 刷新即生效。本页是给「其他大模型」的写作依据,直接把下面的模板发给它即可。**SQL 逻辑脚本涉及具体项目(表结构不同脚本不通用),必须指定 project 字段**。

新增一篇脚本文章(4 步)

1. 把下面「文章提示词模板」+ 你的需求描述,一起发给任意大模型(DeepSeek / GPT / 文心等)

2. 大模型会输出一个 JSON 对象,检查 id 是否与已有文章重复;SQL 逻辑类检查 project 是否填了正确的项目 id

3. 打开 data/posts.js,把对象追加到 window.KB_POSTS 数组末尾(注意逗号)

4. 刷新页面验证:标题、项目归属、代码高亮、复制按钮、高危标识是否正常

文章提示词模板(复制整段发给大模型)

prompt
你是运维脚本知识库(Ops KB)的内容编辑。请根据我提供的需求,按以下规范生成一篇站点文章数据。

## 站点背景
Ops KB 是纯静态个人知识库,内容以 JS 数据对象形式存储在 data/posts.js 的 window.KB_POSTS 数组中。你只需要输出一个文章对象(JSON 格式),由我粘贴进数组。

## 输出格式(严格遵循,只输出 JSON 对象本身,不要任何解释文字)
{
  "id": "英文短横线命名,如 mysql-slow-query-top10",
  "category": "分类 id(现有:server,见 data/categories.js;全新主题可新增分类后再引用)",
  "project": "项目 id(如 proj-a,见 data/projects.js);不绑定项目就删掉此行;sql-logic 类必须指定项目",
  "title": "中文标题,简明,不超过 20 字",
  "summary": "一句话摘要说明用途,不超过 40 字",
  "tags": ["标签1", "标签2", "标签3"],
  "env": "适用环境,如:MySQL 5.7+ / 8.0 · Linux",
  "updated": "当天日期 YYYY-MM-DD",
  "danger": false,
  "sections": [
    { "type": "text", "heading": "场景说明", "content": "什么时候用,2-4 句。支持 **加粗**、`行内代码`、- 列表" },
    { "type": "text", "heading": "使用方法", "content": "步骤说明" },
    { "type": "code", "heading": "脚本/代码", "language": "bash|sql|nginx|yaml|json|text", "content": "完整可执行的代码" },
    { "type": "warn", "heading": "注意事项", "content": "风险提示;高危操作必须写清后果" }
  ]
}

## 编写要求
1. 代码必须真实可用:语法正确、关键步骤有注释、变量有默认值
2. 通用模板化:地址、账号、密码等用占位符(如 1.2.3.4、your_password),不要写死具体值
3. 涉及 DROP / DELETE / KILL / 生产变更等危险操作时,danger 设为 true,并必须在「注意事项」说明后果与回退方法
4. sections 顺序:场景说明 → 使用方法 → 代码 → 注意事项;代码可多段
5. 只输出 JSON 对象本身,不要输出其他解释文字
6. **项目相关脚本(业务 SQL、依赖特定表结构的脚本)必须填 project 字段**;通用脚本(初始化、备份等)不填 project
7. **SQL 提取/处理类文章保持精简**:sections 只放 SQL 代码块;高危写操作(UPDATE/DELETE)可附一条 warn「注意事项」,不要添加冗长的场景说明/关键点解释

## 我的需求
(在此描述:要解决什么问题、什么环境、期望的脚本形态)

字段说明

  • id:文章唯一标识,全站不可重复;改路径会丢失收藏链接
  • subtitle(可选):标题下方的小字解释,一句话说明用途/范围;不需要就不写
  • category:分类 id,见 data/categories.js(当前:server 服务器运维;速查为独立页面)。**分类是动态的**:全新主题先往 categories.js 加一条分类,再写文章
  • project:项目 id(见 data/projects.js)。**SQL 逻辑脚本必须指定项目**(不同项目表结构不同、脚本不通用);通用脚本不写此字段
  • danger: true:文章详情页顶部与列表会显示红色「高危」标识,仅用于删数据、kill 事务、生产变更类操作
  • language:bash / sql / nginx / yaml / json / text;不确定就写 text(无高亮)
  • content 文本区支持:**加粗**、`行内代码`、[文字](链接)(可链到站内文章 post.html?id=xxx 或外部网址)、以 "- " 开头的行自动变列表、空行分段
  • warn 类型:红色警示条,只放真实风险与后果,不要滥用

新增速查条目(命令/地址/文档链接)

同样可以交给大模型:

prompt
你是 Ops KB 速查数据编辑。根据我的需求生成速查条目,严格按以下格式输出 JSON(只输出 JSON 本身):

{ "group": "分组名(已有分组优先复用:常用命令速查 / 服务默认地址 / 常用文档链接)", "items": [ { "name": "条目名称", "value": "命令或地址", "note": "一句话说明", "copy": true } ] }

要求:
1. 命令类条目 copy 设为 true(显示复制按钮);地址/文档链接类 copy 设为 false
2. value 是命令时用真实可用命令;是地址时用 https:// 完整地址
3. note 不超过 15 字
4. 只输出 JSON 对象本身

我的需求:(在此描述要添加什么)

拿到对象后追加到 data/cheats.js 对应分组,刷新即可。

自查清单(发布前过一遍)

  • 代码里的占位符是否明显(如 1.2.3.4your_password),没有被写死成真实生产值?
  • 高危操作是否设置了 danger: true 且写了注意事项?
  • id 是否与已有文章重复?
  • 刷新页面后:高亮、复制按钮、移动端显示是否正常?