HiHuo
首页
博客
手册
工具
关于
首页
博客
手册
工具
关于

内容创作规范

所有文章必须遵循以下规范,确保内容质量一致、去除AI痕迹。


一、去AI化表达

1.1 禁止使用的词汇

禁止用法替换方案说明
某电商系统电商平台"某"字是典型AI八股文
某天/某次直接省略或具体化运营反馈 / 上周运营反馈
某公司/某团队直接说"我们"或省略团队遇到 / 线上出现
让我们来看看直接进入主题删除这类过渡句
首先...其次...最后用数字编号或直接陈述1. 2. 3. 或自然过渡
不难发现删除直接说结论
众所周知删除直接说事实
值得注意的是删除或用"注意:"简洁处理

1.2 禁止的句式

❌ 在当今互联网时代...
❌ 随着xxx的发展...
❌ 作为一名开发者...
❌ 相信大家都...
❌ 毫无疑问...
❌ 不言而喻...

1.3 正确的开头方式

✅ 直接抛问题:
   "面试官问:Redis为什么用跳表?90%的人只能答出60分。"

✅ 直接说场景:
   "电商平台订单表,2000万数据,查询8秒。"

✅ 直接给结论:
   "GMP模型的核心不是G、M、P是什么,而是它们如何协作。"

二、图文配合规范

2.1 必须配图的场景

场景要求
数据结构对比两种结构的操作过程都要画出来
算法流程用ASCII图或流程图展示步骤
架构设计组件关系图 + 数据流向
性能对比表格 + 关键指标可视化
源码分析核心数据结构的内存布局图

2.2 图示规范

ASCII图示模板:

# 对比型(展示两种方案差异)

方案A:[简短标题]
┌─────────────────────────────────┐
│  图示内容                        │
│  关键路径用 ──→ 标注             │
│  重点部分用 [方括号] 高亮         │
└─────────────────────────────────┘
说明:一句话解释核心差异

方案B:[简短标题]
┌─────────────────────────────────┐
│  对比图示                        │
└─────────────────────────────────┘
说明:一句话解释为什么这个方案更差/更好

数据表格模板:

| 指标 | 方案A | 方案B | 差异 |
|-----|-------|-------|-----|
| 核心指标1 | 数值 | 数值 | **百分比** |
| 核心指标2 | 数值 | 数值 | 百分比 |

2.3 图文位置

  • 先图后文:图在上,解释在下
  • 图示紧跟标题,不要隔太远
  • 复杂概念:一个概念一张图,不要合并

三、数据使用规范

3.1 可以编造的数据 (要真实)

类型示例要求
性能数据8s → 50ms数量级合理,符合技术常识
测试环境Intel i7-10700, 32GB用主流配置
数据量2000万条、100万QPS符合业务场景
优化比例提升3倍、降低70%不要过于夸张

3.2 不能编造的内容

类型说明
个人经历不要编"我在某厂"、"我的同事"
公司案例不要编"阿里内部"、"字节的做法"
具体人物不要编造面试官对话(除非是教学场景设定)
源码引用必须是真实源码,标注版本

3.3 数据呈现

✅ 正确:
   "电商平台订单表,数据量2000万,查询耗时8秒"

❌ 错误:
   "我在某电商公司时,订单表有2000万数据"
   "记得某次面试,候选人说..."

四、结构规范

4.1 标准文章结构

# 标题(参考 TITLE_STRATEGY.md)

> 一句话钩子(问题/痛点/结论)

## 问题/背景
- 直接描述场景,不要铺垫
- 给出具体数据

## 核心内容
- 每个知识点配图
- 代码 + 图示 + 解释 三位一体

## 实战/应用
- 真实可运行的代码
- 实际使用场景

## 面试考点(如适用)
- Q&A格式
- 直接可背的答案

## 总结
- 3-5个要点
- 不要说废话

---
*一句话引导关注,不要用emoji*

4.2 代码规范

- 代码必须可运行或注明是伪代码
- 关键行加注释
- 超过30行要分段讲解
- 标注语言类型:```go / ```sql / ```bash

五、语气与风格

5.1 基本原则

要求说明
直接不绕弯子,直奔主题
专业用准确的技术术语
平等不居高临下,不过度谦虚
实用每句话都有信息量

5.2 禁止的语气

❌ 过度热情:"太棒了!这个技巧超级实用!"
❌ 过度谦虚:"个人浅见,如有错误请指正"
❌ 卖关子:"答案可能出乎你的意料..."
❌ 废话过渡:"接下来我们来看看..."

5.3 推荐的语气

✅ 陈述事实:"跳表范围查询比红黑树快3倍"
✅ 直接建议:"生产环境用pt-online-schema-change"
✅ 明确观点:"这个设计是错误的,原因是..."

六、检查清单

发布前逐项检查:

□ 标题是否有吸引力(参考TITLE_STRATEGY.md)
□ 开头是否直接进入主题(无废话铺垫)
□ 是否有"某"字或其他AI词汇
□ 技术对比是否配图
□ 数据是否合理(不夸张、不虚假)
□ 代码是否可运行
□ 是否有面试考点总结
□ 结尾是否简洁(无emoji)

附录:示范对照

改前(AI味重)

某电商系统,订单表积累了2000万数据。某天运营反馈:
"导出最近30天的订单报表特别慢,页面经常超时。"

让我们来看看如何优化这个问题。首先,我们需要分析...

改后(自然)

电商平台订单表,数据量2000万。运营反馈:
"导出最近30天的订单报表特别慢,页面经常超时。"

排查发现这个SQL执行了8秒:

本规范持续更新,发现新问题及时补充。