hoelee
86edd40c74
- docs/consultant-review/: review brief, per-batch post dumps (01-10), audit-tracker.json + AUDIT-TRACKER.md generated by scripts/manage_review.py - scripts/manage_review.py: list/approve/approve-batch/generate over the tracker - docs/consultant-review-2026-10-27-posts-and-casestudies-plan.md: locked decision register + 4 work orders for the /posts/ archive rework and the case-studies portfolio treatment
42 lines
3.8 KiB
Markdown
42 lines
3.8 KiB
Markdown
# 外部顾问审阅前置须知与工程背景规范
|
||
|
||
> **本文档目标**：本批次包含 `blog.hoelee.com` 的待审阅技术文章全文。请外部顾问在审阅正文与技术主张时，以此规范为最高评估准则。
|
||
|
||
## 1. 站点定位与双重业务目的
|
||
- **受众 A（技术招聘官 / 资深技术主管）**：寻找具备 Senior 全栈 + DevOps + AI 智能体闭环能力的架构工程师。文章定位为**“不可伪造的工程实操交付证据（Proof of Expertise）”**，要求代码真实、日志可查、有架构权衡与技术深度。
|
||
- **受众 B（中小企业主 SME / 商业客户）**：寻找能提供系统研发、私有化部署、24/7 AI 获客系统、高可用基础设施的技术顾问。文章需清晰阐述业务痛点、商业 ROI、上线效率与交付保障。
|
||
|
||
## 2. 核心人设铁律与工程硬约束（必须严格遵守）
|
||
1. **彻底杜绝业余爱好者/玩具口吻**：
|
||
- ❌ **绝对禁用词**：`homelab`, `home lab`, `家用`, `小主机`, `玩具`, `折腾`。
|
||
- ✅ **标准替代词**：`the infrastructure I manage`（我管理的私有基础设施）、`self-hosted production node`（自托管生产节点）、`on-premise host`（私有化服务器）。
|
||
2. **严禁捏造虚假指标与性能数字**：
|
||
- 所有 benchmark 数据必须有明确的测试基准与单设备限制。
|
||
- 严格区分“耗时减少比例”与“吞吐加速倍数”（例如耗时从 352s 降至 218s 是耗时减少 38.0%，吞吐提升 1.61×，严禁偷换概念混淆）。
|
||
- 时间戳精度与物理帧对齐：视频帧率上限（如 30 fps 单帧 33.3ms）不可妄称“微秒级精确”。
|
||
3. **去模板化叙事与真实物理锚点**：
|
||
- 拒绝千篇一律的 AI 模板味。文章采用三大叙事架构：① 故障排查谜案（Symptom → False Lead → Kernel Evidence → Fix）；② 商业交付复盘（Client Bottleneck → Trade-offs → State Machine → ROI）；③ 架构演进对比（V1 Naive → Concurrency Crash → V2 Redesign）。
|
||
- 每篇文章必须包含至少一个物理真实世界锚点（主机真实硬件规格、生产维护窗口、真实业务场景）。
|
||
4. **代码与配置展示规范**：
|
||
- 超过 20 行的配置或日志采用 HTML `<details><summary>` 原生折叠，`<summary>` 必须精准标注文档名与行数。
|
||
|
||
## 3. 顾问重点开刀维度
|
||
- [ ] **事实与数字可核性**：技术判断与性能数据是否自洽？有无过度夸大？
|
||
- [ ] **人设与语调纯洁性**：有无遗漏的 hobbyist/homelab 口吻？
|
||
- [ ] **双轨转化引导有效性**：是否有清晰的业务价值提炼与行动召唤（CTA）？
|
||
- [ ] **代码与生产安全性**：有无未脱敏的凭据、绝对内部私密路径或不安全的权限配置？
|
||
|
||
## 4. 博客 7 大分类与内容策略参考
|
||
- `case-studies` (商业案例)：求职与获客核心武器，以真实商业交付和解决瓶颈为核心。
|
||
- `devops` (私有基建)：高并发网关、Docker、Traefik、存储阵列与监控，最强差异化资产。
|
||
- `ai` (人工智能与智能体)：围绕自动化工作流、LiteLLM 网关、状态机防幻觉与本地私有大模型。
|
||
- `engineering` (系统架构与后端)：Java/Spring、PHP/CodeIgniter、TS/React 的硬核实战。
|
||
- `tutorials` (技术教程)：面向学习者的深度实战指南。
|
||
- `notes` (排障速记)：轻量级踩坑手记与高频高价值 gotcha。
|
||
- `web3` (智能合约)：Solidity/Foundry 严谨实践，诚实表达学习与验证阶段。
|
||
|
||
## 5. 既有核心参考文档清单（仓库内置）
|
||
- `docs/content-guide.md` — 博客内容定位、选题规范、反模式与 i18n 策略。
|
||
- `docs/post-publishing-sop-v2.md` — 5 步叙事模型、代码折叠与 Bento 卡片技术规范。
|
||
- `docs/consultant-review-2026-10-26-supplement.md` — 上一轮顾问诊断全景资料包。
|