# 项目记录

# 项目记录：给问答页补「适用范围」小节之后 ## 起因 站里有几篇问答页，回答写得很确定，但没有交代在什么条件下成立。后来发现，读者把其中一条拿去用，环境不同，结果不对，回头质疑内容不准。于是给这类页面统一补了一节「适用范围」。 ## 小节写什么 | 字段 | 写什么 | 不写什么 | |

# 项目记录：给栏目页加「最后更新」提示后的观察 ## 起因 站里有几个栏目页，内容半年没动过，但页面看上去和刚更新的一样。读者分不清「这里很稳定」和「这里没人管」，于是加了一行很小的提示：栏目最后更新时间。 ## 具体做法 | 项目 | 做法 | | --- | --- | | 位置 |

# 项目记录：给长文档问答加「引用位置」之后 ## 起因 用模型读长文档、做问答，答案本身能答上来，但有个致命问题：答完不知道依据在原文档的哪一段。要核对时只能从头翻，等于没省事。于是做了一处改动：让回答带「引用位置」。 ## 加的字段 | 字段 | 写什么 | | --- | --- |

# 项目记录：给前沿笔记加「可复现条件」一栏之后 ## 起因 读前沿资料时记了一堆笔记，后来想照着复现，却总卡在「我那次是怎么跑通的」说不清。于是做了一处小改动：给每条笔记加一个「可复现条件」字段，只记三样东西。 ## 加的字段 | 字段 | 写什么 | 不写什么 | | --- | ---

# 项目记录：给旧文章补「更新时间」字段后的观察 ## 起因 站里有一批两年前写的说明类文章，内容大体还成立，但页面上只看得到最初的发布日期。读者分不清「写得早但已修订」和「写得早就没动过」，于是做了一次小改动：给这些文章补上独立的「更新时间」字段，并在正文开头标一行修订说明。 ## 具体做了

# 项目记录：给一份产品页补“定义与边界”章节后的变化 ## 起因 一份产品页写得很努力：功能、优势、使用场景、案例，一应俱全。但读者常问的两类问题始终没解决——“它到底是不是做 X 的”“我们这种情况算不算能用”。页面里其实有答案，只是散在几段描述里，得自己拼。 于是没改功能介绍，只补了一个

# 项目记录：给站内搜索加“无结果”记录，挖出一批选题 ## 起因 站内搜索一直只当工具用，没人看过它的数据。有天随手查了下日志，发现相当比例的词返回零结果。这些词其实是**读者直接说出来的需求**：他以为站里有，结果没有。 于是做了一件很小的事：把无结果查询单独记下来。 ## 做法 记录

# 项目记录：给一批长文档做分段，我试了三种切法 ## 背景 给一批技术文档做检索式问答，第一步就是分段。当时以为这是最没技术含量的一步，随手按字数切完就往下走，结果后面答不全的问题怎么调都调不好。回头重做分段，才发现问题在这。 素材来自 [前端 Wiki 的分层教程](https://www

# 项目记录：给一个小工具接上工具调用，我记录的三处卡点 ## 背景 给内部一个查询小工具加了外部调用能力：模型负责理解问题，真正取数交给一个确定性的函数。想法很简单，动手之后卡了三处，都不是模型能力问题。 ## 卡点一：工具描述写得像给人看的注释 第一版的参数说明是“查询条件，按需填写”。

# 项目记录：用一批公开技术文档做问答测试，我整理的三类失败案例 ## 背景 想给内部资料加一个“直接提问”的入口，动手之前先做了一次小规模测试：拿一批公开技术文档当语料，准备 30 个真实问题，看看哪些问题会答错、错在哪里。语料主要来自 [前端 Wiki 的分层教程](https://www.

# 项目记录：给一个静态文档站加检索式问答的尝试 站里有一批静态技术文档，内容没问题，但读者常反馈「知道有，找不到」。这次我试着在不动原有页面的前提下，加一层轻量检索式问答：先从文档里找相关片段，再组织成回答。本文记录范围、取舍与复盘。 ## 一、把目标定得很小 没有做全站智能助手，只解决一个

把重心从排名转到被引用之后，哪些动作有用、哪些白做。这篇是一次小项目的完整复盘，包括三件白做的事。

旧文章有年龄、有收录基础，只是写法过时。这篇记录一次十二篇存量的改造：四条标准、五步流程，以及什么文章不该改。

# 项目记录：把一批旧文章改造成“AI易引用”结构的复盘 站里积累了不少老文章，内容本身没问题，但写法偏“随笔”：观点埋在长段落里，结论散落在结尾，术语全靠上下文。随着 AI 问答成为常见入口，我挑了 12 篇做了一次针对性重构，目标是让它们更容易被生成式引擎检索与引用。本文记录这次小型项目的做法

# 静态化改造项目记录：把一个文档站的首屏加载压下来的过程 前段时间接手了一个在线文档站的优化需求：页面能打开，但首屏偏慢，移动端尤其明显，而且部分文章收录不稳定。我们没有急着加服务器配置，而是从“页面是怎么被生成和加载的”入手做了一轮静态化改造。本文记录这次项目的思路、步骤和复盘，供遇到类似情况