FIELD NOTE / FIELD LOG
公开构建过程:把作品写成能复查的案例
项目展示除了说明做了什么,还应交代能力边界、当前进展和仍需验证的判断。
作品页很容易只留下技术栈和功能清单。它们能说明项目覆盖了什么,却难以解释为什么这样设计、遇到什么约束,以及读者能从哪里验证进展。把过程写出来,是我整理这份站点时想坚持的一件事。
先说问题,再说技术
介绍 LFN Cloud 时,统一入口、身份权限、消息、流程和报表不是一串并列名词。它们回应的是同一个场景:用户在正确的租户与应用中,以被授权的身份完成业务协作。介绍 LFN Knowledge 时,重点也不只是 pgvector,而是文档从原件到已发布版本的治理,以及答案如何回到原文。
技术选择放在问题后面,读者才看得见它的作用。前后端分离、异步索引或混合检索,都需要对应到具体边界,而不是成为装饰性的标签。
把进展写在合适的位置
有的能力已经稳定运行,有的功能有完整代码链路但仍在验证环境效果,也有项目还在方案和原型阶段。这些状态值得明确写出来。比如个人内容工作流计划从 X 等平台寻找线索,经过筛选、核对和 AI 辅助再创作,再探索多平台发布;它目前仍是规划中的流程,不能被写成已经打通的自动发布产品。
同样,代码实现、静态构建通过与真实使用效果是不同的证据。案例里可以说明做法和下一步验证事项,等有可公开的结果时再补上数据和链接。
让文章成为案例的延伸
项目页提供结构化概览;文章则适合展开一项判断:为什么知识必须先审核再发布,为什么 Agent 的写操作需要预览确认,或者某次方案调整改变了什么。短想法可以先在 X 上记录,值得保留的内容再回到这里写成完整文章,并附上可核实的原文链接。
这样记录的价值是可修订。下一次发现判断不成立时,可以回到当时的问题和证据,说明它为什么改变,而不必让作品页永远停在一个漂亮却静止的版本。