Codex 作为产品生产循环

把近期用 Codex 交付的站点、商贸、金融、摄影和自动化工具整理成可复用产品方法。
近期 Codex 产出的东西不只是页面或脚本，而是一条产品循环：明确可见交付物，守住运行边界，用真实端口、API、构建和公开访问验证，然后把经验回写到数字花园。
# Codex 作为产品生产循环

## Why This Note Exists

最近 Codex 参与的工作已经不只是“帮忙写代码”。它更像一个小型产品工坊：把一句需求推进成可访问页面、后端能力、运行脚本、验证证据和后续维护记录。

这条线索把 [[personal-website-as-operating-system]]、[[digital-garden-auto-update]]、[[trade-management-system-prototype]]、[[etf-portfolio-dashboard]] 和 [[photography-archive-system]] 连在一起。它们属于不同项目，但共享同一个产品化判断：交付物必须能被用户打开、被接口验证、被权限边界保护，并且在出问题时能恢复。

## Current Product Map

| Area | Codex-produced surface | Product lesson |
| --- | --- | --- |
| Personal website | Digital Garden、Private Garden Desk、Ask Wei 引用公开 note | 网站是统一入口，公开知识、私人工具和助手上下文要共用一套信息边界。 |
| Garden automation | Daily/weekly candidate notes、evidence ledger、review PR | 自动化只能产出候选和维护建议，发布仍需要人工 review。 |
| 商贸系统 | `/data/export` 页面和 `GET /api/data/export` CSV 下载 | MVP 也要覆盖真实业务实体、角色权限、下载格式和运行验证。 |
| Finance dashboard | 后端市场数据 provider、状态卡片、stale-cache fallback | 金融数据能力应在后端保管 key，并把数据质量状态显式暴露给界面。 |
| Photography workflow | 公开摄影归档、上传默认值、水印、大小限制和 Worker 吞吐 | 图像产品的体验不只在展示页，也在上传、压缩、默认配置和失败边界。 |
| Local operations | 服务重启、FRP 诊断、health check、dry-run 修复 | 本地产品需要恢复路径；“能跑起来”应该有端口、URL 和日志证据。 |

## Pattern

一个 Codex 产出的功能要变成产品，通常需要五个步骤。

1. 先落到一个可见表面：页面、API、命令、后台入口或公开 URL。
2. 明确边界：权限、私有数据、环境变量、缓存、上传文件、第三方 provider。
3. 用运行事实验收：构建、真实 HTTP 请求、监听端口、asset hash、下载文件或健康检查。
4. 留下恢复路径：README、脚本、日志、dry-run、FRP/端口诊断或回滚说明。
5. 回写 garden：把一次性修复提炼成后续能复用的产品判断。

## The Useful Rule

Codex 交付不是“代码写完”。更可靠的完成标准是：

- 用户能看到或调用它。
- 关键 API、下载、上传或导航路径被真实验证过。
- 权限和隐私边界没有为了前端方便而绕开。
- 失败时知道看哪个端口、日志、配置或健康检查。
- 经验能进入数字花园，成为下一次产品决策的上下文。

## What To Improve Next

这篇 note 应该成为各产品 note 的索引，而不是替代它们。后续更适合拆成更具体的 evergreen notes：

- Codex 产品验收清单。
- 本地服务和 FRP 恢复 playbook。
- 私有数据不进入公开 garden 的写作规则。
- 金融、摄影、商贸系统各自的运行边界。
- [[future-edge-cache-playbook|Edge cache]]、静态 fallback 和 stale-while-revalidate 的部署边界。

The goal is a calmer loop: build the thing, prove the thing, document the operating rule, then let the next product start from that rule instead of starting from scratch.

## Recent Update - 2026-W26

[[weekly-review-2026-w26]] turns this loop into a weekly maintenance artifact. The concrete improvement this week is that Digital Garden warning cleanup, candidate archiving, edge-cache thinking, and build verification are captured as notes instead of being left only in command output.
Open this garden note