# Portal // 黄峰 (Public Knowledge Index & LLM Context)

> 本文档遵循 /llms.txt 开放规范，索引了黄峰个人技术门户（portal-huangfeng.pages.dev）中所有公开的原创深度手记、智能制造工程实践、AI Agent 架构方案与开源项目。供各类 AI 搜索智能体、代码辅助工具及开发者阅读与检索。
> 作者工程理念：以务实、克制、解决物理世界具体问题的态度对待前沿技术。确定性算法管数字与现场互锁，大模型管交互解释与内容。小而朴素，重在闭环。

## 站点信息与使用规范

- 站点主页：https://portal-huangfeng.pages.dev
- 个人公开档案：https://feng-h.github.io
- 微信公众号：「叩石寻径问路」
- 格式说明：每篇手记均为标准的物理静态 HTML 页面，包含干净的 article 语义标签，AI Agent 可通过 web_extract 或 HTTP GET 直接抓取全文内容。

## 📰 叩石寻径问路 · 深度手记

### 智能制造与现场

- [智能制造工厂“工程互锁” AI 治理框架 (SMSE-Interlock)：AI 如何进入执行链而不越权](https://portal-huangfeng.pages.dev/research/smse-interlock-framework.html) (2026-10-15)
  - 摘要：通用 Agent 的随机性是工业现场的灾难。提出面向制造场景的工程互锁治理模型：把 AI 约束在 SOP、受控契约与审计证据中，实现“在 SOP 内思考，在 contract 内行动，在 audit 内被验证”。
- [专为车间一线打造的智能 PLC 维修辅助系统 (PLC-Agent)](https://portal-huangfeng.pages.dev/research/plc-agent-repair-assistant.html) (2026-10-14)
  - 摘要：现场维修工不是坐在办公室写代码的人。针对西门子 TIA Portal 项目，实现 PLC 逻辑解析、全信号链路追踪、故障根因定位与安全写保护。
- [智能制造的“小而朴素”：从平板显示到离散制造的 MES 思考](https://portal-huangfeng.pages.dev/essays/mes-small-and-austere.html) (2026-10-14)
  - 摘要：在 FPD 行业，MES 严丝合缝；到了离散制造，照搬却往往走样。亲历“应采尽采”的教训后，才明白真正有价值的是小而朴素的闭环。
- [AI 学语言与工程师把关：为什么我们不提“人在回路”](https://portal-huangfeng.pages.dev/essays/ai-language-learning-and-gatekeeper.html) (2026-10-12)
  - 摘要：学术界常说 Human-in-the-loop，但在真实工程中，这个翻译腔掩盖了责任边界。不是人在回路里当螺丝钉，而是工程师对系统兜底把关。
- [制造业场景下 AI Agent 的落地架构：MES/SCADA 的只读封装与审批式写](https://portal-huangfeng.pages.dev/research/industrial-agent-architecture.html) (2026-10-10)
  - 摘要：工业控制严禁不可控风险。剖析在企业内部落地 Agent 时，如何通过只读数据管道与关键节点的人工审批流，实现高价值安全闭环。
- [EMS-Claude · 离散制造轻量设备全生命周期管理系统](https://portal-huangfeng.pages.dev/#article=repo-ems-claude) (2026-05-11)
  - 摘要：面向工厂一线车间的轻量高性能设备台账与巡检维保系统。Go 后端强并发支撑，解决中小工厂大型软件部署重、一线工人不会用的痛点。
- [Value Stream Mapping (VSM) Skill · 精益价值流图自动化分析引擎](https://portal-huangfeng.pages.dev/#article=repo-vsm-skill) (2026-05-01)
  - 摘要：将传统精益制造中依赖纸笔绘制的价值流图，升级为结构化对话驱动的智能分析系统。自动计算节拍时间、提前期与瓶颈，动态渲染标准精益 SVG 架构图。

### AI与Agent架构

- [无GPU纯CPU运行声纹识别：从零落地多人长音频说话人聚类与实战避坑](https://portal-huangfeng.pages.dev/#article=cpu-voiceprint-speaker-recognition-practical-guide) (2026-10-23)
  - 摘要：抛弃昂贵GPU显卡与PyTorch全家桶，在单核/双核普通CPU上实现50ms级声纹识别。详述达摩院3D-Speaker CAM++与sherpa-onnx的轻量落地、Whisper擅自同传避坑指南、物理交接切分与阈值划分实战。
- [零GPU纯CPU搞定声纹识别：多发言人长音频对号入座实战](https://portal-huangfeng.pages.dev/essays/cpu-voiceprint-speaker-recognition.html) (2026-10-23)
  - 摘要：破除显卡迷思，用 28MB 模型在普通双核 CPU 上跑通多发言人声纹识别，单次推理 30ms。附线上真实踩过的 4 大暗坑与工业解法。
- [从单机跑模型到看清集群：DeepSeek 掀开的推理底牌](https://portal-huangfeng.pages.dev/essays/deepinfer-cluster-inference-frontier.html) (2026-10-20)
  - 摘要：从跑过 vLLM 与 llama.cpp 的普通开发者视角出发，观察第一次被顶级厂商公开的大规模生产集群方案。剖析大厂为何视其为绝密，以及兼容华为背后的算力实用主义。
- [没有标准答案的真实世界，AI Agent 到底该怎么自愈？](https://portal-huangfeng.pages.dev/essays/google-harness2-agent-self-healing.html) (2026-10-19)
  - 摘要：在模型权重冻结的前提下，如何让智能体在泥泞沼泽中自主重构底盘？深度拆解 Google 最新开源架构 Harness² 与终极哲学思辨。
- [几何外科手术：大模型表征擦除（Abliteration）与合规审查破除的工程机理](https://portal-huangfeng.pages.dev/essays/representation-erasure-and-llm-censorship-bypass.html) (2026-10-18)
  - 摘要：不重训、不动原权重，仅凭 500KB 向量文件在算子层实施正交投影，即可将大模型敏感拒答率从 58% 降至 2%。深入剖析 Transformer 残差流的线性表征假说与几何手术工程链路。
- [做对90%就算掌握了吗？Agent底座里的掌握度算法](https://portal-huangfeng.pages.dev/essays/mastery-bkt-algorithm-in-agent-base.html) (2026-10-18)
  - 摘要：在企业级 Agent 底座中，为什么我们要坚决切出一个不调大模型的微服务？面对百万作答数据，聊聊确定性贝叶斯知识追踪（BKT）的证据清洗。
- [长音频Agent流水线实战：如何治理大模型偷懒？](https://portal-huangfeng.pages.dev/essays/audio-agent-pipeline-and-llm-sloth.html) (2026-10-16)
  - 摘要：面对 1~2 小时专业外语音频，大模型在多步调用中为什么必然偷懒？如何通过平衡句群与字符比硬性断言门禁，把大模型训成严谨的流水线工人。
- [CMU 11-768: Foundation Models and AI Agents 全体系课程跟踪与架构笔记](https://portal-huangfeng.pages.dev/#article=cmu-11-768-agents-learning-tracker) (2026-10-15)
  - 摘要：卡耐基梅隆大学 2026 最新 AI Agent 正式课程体系化跟进。涵盖 Reasoning, Memory, Planning, Tool Use 与 Multi-Agent 架构深度复盘，含官方 Slides 链接与视频索引。
- [Web 端长文手写批注与评阅系统设计：纯矢量 SVG 零延迟落墨、手笔分离与跨设备云同步实践](https://portal-huangfeng.pages.dev/growithai/web-document-stylus-annotation-architecture.html) (2026-10-15)
  - 摘要：针对浏览器长文档、双语译稿与试卷文献的手写批注难题，探讨纯矢量 SVG 零延迟落墨、双工具色彩独立记忆、原生手笔分离（单笔写字/双指滑动）与 Cloudflare KV 跨设备云同步的完整 Web 架构实现与避坑指南。
- [Agent-Base 企业级 AI 服务底座：SaaS 与大模型之间的“即插即用”中间件](https://portal-huangfeng.pages.dev/research/enterprise-agent-base-infra.html) (2026-10-15)
  - 摘要：破解大模型进生产系统的混乱局面。提出“三个隔离+一个插座”架构，秉持“确定性算法管数字，AI 管解释和内容”，构建高可用、可观测、带护栏的可插拔 AI 服务底座。
- [Latent Space: The AI Engineer 精选前沿访谈归档与核心洞察](https://portal-huangfeng.pages.dev/#article=latent-space-curated-archive) (2026-10-14)
  - 摘要：精选来自 Latent Space 的 235+ 期 AI 工程师深度访谈与技术架构解析。音频由私有 Nextcloud 高速直链分发，附带一手技术观点提炼。
- [从 Harness 到挖掘机：Pi Coding Agent 的架构解构与设计心得](https://portal-huangfeng.pages.dev/#article=pi-agent-harness-excavator-analogy) (2026-10-12)
  - 摘要：深入学习 Earendil 系列文章。大模型只是“发动机”，如何设计 Harness、工具调度器、上下文状态管理与双向通信（如同挖掘机的液压底盘与操作臂），才是 Agent 稳定交付的核心。
- [智学本错题精准推送 · 个人信息合规风险评估与设计清单](https://portal-huangfeng.pages.dev/research/zhixueben-compliance-report.html) (2026-06-25)
  - 摘要：针对智学本利用学生错题数据生成个人薄弱点画像、进行个性化精准推送并引导家长付费购买的场景，依据 PIPL、未成年人保护法等法规进行全面合规风险评估。含8项风险判定、合规路径设计、产品实施清单。
- [Open Design · 自然语言驱动的 AI 交互原型设计系统](https://portal-huangfeng.pages.dev/portfolio/open-design-workflow.html) (2026-06-05)
  - 摘要：不需要手动搭建组件库或调像素。基于自然语言描述需求，自动匹配 145+ 设计系统（Linear, Stripe, Vercel, Apple 等），支持 Tweaks 实时调参、多断点响应式交互与一键交付。
- [Claw-ED 深度调研报告：美国教师开源 AI 备课 Agent 工具拆解](https://portal-huangfeng.pages.dev/research/claw-ed-deep-dive.html) (2026-05-29)
  - 摘要：美国教师开源的 AI 备课 Agent 工具深度拆解：教师风格学习（soul.md）、12 项质量门控、AI 痕迹三层清除、课堂画像、Brain 记忆系统、FAST/DEEP 模型路由。含与中国 K12 产品的对比和本地化建议。

### 系统排险与运维

- [讲道与见证转译流水线解耦架构：从巨石技能到微模块积木](https://portal-huangfeng.pages.dev/diagrams/sermon-pipeline-architecture.html) (2026-10-23)
  - 摘要：针对群晖同步、长音频转写、神学逐句直译、CAM++声纹识别、经文卡片提纯与Portal部署的解耦方案。将臃肿单体技能拆解为4大高内聚微模块与轻量主调度流，实现零上下文浪费与双轨高保真交付。
- [PHP2Shell 应对记：当公网扫描撞上高危 0-Day，一次拒绝无脑大升级的排险实录](https://portal-huangfeng.pages.dev/essays/php2shell-defense-and-hotpatch.html) (2026-10-22)
  - 摘要：波及超 75% 网站与私有云地基的核弹级 RCE 突袭。为什么盲目大升级比漏洞本身更致命？记一次像机修换轴承般的零停机排险，附老系统纵深防御指南。
- [当一个工程师的代码库，连 AI 都在死循环里迷了路：个人工作台重构实录](https://portal-huangfeng.pages.dev/essays/portal-architecture-refactoring.html) (2026-10-21)
  - 摘要：记一次个人工作台 Portal 从单页膨胀到白屏死锁的踩坑复盘。反思为什么在系统变复杂时绝不能急着堆功能，而必须逼着 AI 先定好底层架构。
- [从写代码到看守服务器：一次 Agent 运维探索](https://portal-huangfeng.pages.dev/essays/vps-agent-ops-practice.html) (2026-10-19)
  - 摘要：让常驻 VPS 的 Agent 当一次代码与配置的守门员。一次真实的排查实操，以及对中小型系统运维安全边界的开放探讨。

### 认知与随笔

- [费曼给年轻人的回信：如何真正学透一件事？](https://portal-huangfeng.pages.dev/essays/feynman-undisciplined-learning.html) (2026-10-21)
  - 摘要：新晋诺奖得主写给普通读者的一句话：用最不受管束、最不迷信权威、最富独创性的方式，去下苦功钻研那些最让你着迷的事物。
- [当幽默成了门票，我们不得不靠网络梗装点人设](https://portal-huangfeng.pages.dev/essays/why-we-fear-silence-in-conversation.html) (2026-10-18)
  - 摘要：当幽默沦为一种防御性的表演，用网络烂梗强行续命，背后是对真实冷场的恐惧。真正让人安心的关系，经得起两个小时的沉默。
- [特斯拉跑车上天：为什么马斯克不申请专利？](https://portal-huangfeng.pages.dev/essays/tesla-roadster-spacex-patents.html) (2026-10-18)
  - 摘要：当电动车装上 SpaceX 的冷气火箭喷管，百公里加速冲进 1 秒内，为什么马斯克几乎从不申请专利？拆解比法律更硬的物理与工程护城河。
- [用WorkBuddy开发AI小程序：从零到2.0的踩坑实录](https://portal-huangfeng.pages.dev/essays/workbuddy-miniprogram-experience.html) (2026-10-16)
  - 摘要：不买服务器、不配域名、不申请模型 Key，如何做出一款带 AI 视觉批阅能力的小程序？从最初验证到 2.0 上线，复盘全托管架构的红利、边界以及在端侧真机上踩出的十几个工程坑。
- [小公司的AI产品经：模型不够，设计来凑](https://portal-huangfeng.pages.dev/research/small-company-ai-pm-model-usage.html) (2026-05-29)
  - 摘要：小公司做AI产品的核心矛盾——用有限模型预算做出足够好的体验。从分层意识、质量门控、窄场景护城河、RAG四源数据、Prompt三技巧到强模型质检策略，给出完整的方法论框架。

## 💻 开源专著与极客工具

- [宝贝作业管家：基于 WorkBuddy 云原生与多模态大模型的自律学习系统](https://portal-huangfeng.pages.dev/opensource/miniapp-kids-learning-manager.html) (2026-10-17)
  - 摘要：已通过微信审核上线（v2.0.10）。微信群消息一键粘贴 AI 结构化切分、手机拍照透视矫正与逐题视觉批改（准确率 73%+）、薄弱知识点雷达图谱与 PostgREST RLS 权限隔离。内含 5 张高清实机截图与端云架构图。
- [Personal Persona LoRA · 个人真实风格 AI-LoRA 全自动复刻系统](https://portal-huangfeng.pages.dev/#article=repo-personal-lora) (2026-10-13)
  - 摘要：完全私有化、用户自助、零服务端的真实人类语言风格复刻 LoRA 全自动工作流。三通道采集（问卷/对话/IM）+ Kaggle 一键训练 + 纯 LoRA 推理。
- [SpaceFree · macOS 动态磁盘清理工具（全键盘 TUI）](https://portal-huangfeng.pages.dev/#article=repo-spacefree) (2026-10-12)
  - 摘要：拒绝盲目扫描大文件。按程序和 Homebrew 包的“真实使用频率”智能清理磁盘。终端 TUI 交互，零运行时依赖，已支持 Homebrew Tap 一键安装。
- [Hermes Agent 自动化运维与个人数字基础设施](https://portal-huangfeng.pages.dev/#article=project-hermes-infra) (2026-10-08)
  - 摘要：基于 Nous Research 开源框架搭建的个人专属 Agent 节点。打通家庭健康记录、知识库双链同步、跨设备协作与 Cloudflare Pages 自动发布管道。
- [《通过 Google Colab / Kaggle 学习模型微调》开源专著](https://portal-huangfeng.pages.dev/#article=repo-finetune-mac) (2026-10-03)
  - 摘要：一本以 MacBook Air M1 (8G统一内存) 为物理标尺的工业级微调实战专著。打通免费云端 GPU (Google Colab / Kaggle) 科学炼丹、早停截断、显存拔插盲测到端侧纯离线交付全链路。
- [ChargingCheck · macOS 充电功率监视器与图书馆静音工具](https://portal-huangfeng.pages.dev/#article=repo-chargercheck) (2026-10-03)
  - 摘要：macOS 状态栏充电功率监视器。基于 IOKit 实时读取电压/电流并计算真实充电瓦数，独创“图书馆模式”（插入充电器静音系统提示音）与进程能耗监控。
- [Pi Carryover · AI 编程会话跨 Session 无缝接力系统](https://portal-huangfeng.pages.dev/#article=repo-pi-carryover) (2026-10-02)
  - 摘要：解决 Coding Agent 会话中断后“前情尽忘”的顽疾。具备 3 级可靠性架构，自动提取工程状态便签，支持 /resume 跨会话平滑接续。

## 👤 关于作者与工程理念

- [关于我与工程底色](https://portal-huangfeng.pages.dev/#about)
  - 工程师背景，深耕平板显示（FPD）全自动化流水线与离散制造 MES 系统、工业自动化通信（SCADA/PLC）与前沿 Agent 自动化研发。

- [为什么很多AI回复没有金字塔原理？](https://portal-huangfeng.pages.dev/essays/why-ai-lacks-pyramid-principle): 深度剖析为什么很多大模型回复缺乏金字塔原理，揭示完播率注水与防御性叠甲的机制根源，提出工业Agent落地的极度减熵工程解法。
- [从1400万到30万Token：长音频口语转译的Agent架构重构](https://portal-huangfeng.pages.dev/essays/long-audio-token-reduction-agent-architecture): 深度复盘长音频切片转译为何会烧掉1400万Token，详解解耦为无状态批处理管道、Token压降超97%的工业级Agent架构重构实战。
- [刺破“流量密码”：从7条大众心理看工程师的认知定力](https://portal-huangfeng.pages.dev/essays/debunking-traffic-secrets-psychology): 深度拆解网络盛传的7条流量秘诀，从优越感投射、去魅窥视与情感投射三层底层心理学穿透表象，探讨严肃工程师的认知定力与表达守则。
- [两行代码改变模型意图？Qwen3.5-4B神经元动态干预实测](https://portal-huangfeng.pages.dev/essays/qwen-neuron-steering-mechanistic-interpretability): 详述用 PyTorch Hook 在推理时精准激发 L14 N8949 并抑制 L13 N7956 神经元反转 Qwen3.5-4B 安全对齐的真实测试与物理反思。实测干预耗时0毫秒，探寻内生级表征防御。
- [别用给英文设计的铲子，在中文信息孤岛里挖金子：DeepSeek 搜索 API 实测与工业检索反思](https://portal-huangfeng.pages.dev/essays/deepseek-search-api-chinese-web-retrieval): 详述为何在中文制造与商业场景下首选 DeepSeek 搜索 API，剖析其穿透微信公众号与知乎高墙的底层机制，以及每千次仅需5元的定价反思。