Developer Portal

https://caozuohua.github.io/portal/ 是 CAO ZUOHUA 的个人开发者作品入口，集中呈现数据产品、AI 自动化、个人工具链和工程笔记。

信息架构

• data/projects.json：项目目录唯一数据源，包含归属、状态、问题、方法、结果、指标和核验时间。
• assets/portal.js：渲染项目，并从电力案例、免费资源和博客的公开数据接口刷新指标。
• data/notes.json：博客 JSON 不可用时的近期文章缓存。
• projects/fund-analyzer/：只使用虚构 fixture 的基金组合公开演示。
• projects/luck-agent/：Luck Agent 架构、降级路径和脱敏 Card 2.0 案例。
• scripts/validate_public.py：项目 schema、核心项目数量、图片和公开数据防泄漏检查。
• scripts/check_health.py：对公开入口执行 GET，并验证页面标识和 JSON feed。
• docs/brand-system.md：跨站品牌骨架、归属标签和状态语义。

项目归属

ownership 只允许以下值：

• owned：完全自有并公开维护。
• private-demo：真实系统私有，Portal 只提供独立虚构演示。
• fork：上游项目的同步、部署或兼容性参与，不把上游功能描述为个人成果。

当前核心项目固定为 5 个：电力数字化案例库、基金组合分析公开演示、免费资源聚合、技术与系统笔记、Luck Agent。World of ClaudeCraft 位于参与项目区。

本地运行

python -m http.server 8080
python scripts/validate_public.py

打开 http://localhost:8080/。由于页面通过 fetch 读取 JSON，不建议直接双击 HTML 文件。

发布验证

python scripts/validate_public.py
python scripts/check_health.py
git diff --check

健康检查每周运行，除了 HTTP 状态，还会断言页面标题或关键文本，避免自定义 404 被误判为正常页面。