Codex 项目运行指南
本页只列主要、可理解的项目。命令需在 Mac 终端中执行；首次运行前先阅读各项目自己的 README.md。
如果想按项目逐页阅读，进入 00-项目目录。
百度网盘自动转存服务
用途：自动转存百度网盘资源，并把结果通知飞书或提供给手机端领取。
cd /Users/ayang/Documents/Codex/2026-07-03/python-1-2-3-4-webhook/baidu-pan-feishu-bot
docker compose up -d --build运行前需要从 .env.example 创建本机 .env 并填写授权信息。.env 不得上传 Git。
抖音分享助手
用途：手机领取服务端消息并发送到抖音群。
- 安装项目内
app/build/outputs/apk/debug/app-debug.apk。 - 在 App 中填写后端 HTTPS 地址、连接令牌和目标群名。
- 开启无障碍服务、自启动和后台运行。
- 点击“测试后端连接”，通过后再开启自动接收与发送。
代码目录：/Users/ayang/Documents/Codex/2026-07-09/new-chat/outputs/DouyinShareBot
二手手机货架亮灯系统
用途：通过网页、接口或串口指定仓位，让 ESP32 点亮对应灯珠。
cd /Users/ayang/Documents/Codex/2026-05-30/esp32
/Users/ayang/Library/Python/3.14/bin/pio run烧录前需复制 src/wifi_config.example.h 为 src/wifi_config.h，填写 2.4 GHz Wi-Fi，并确认实际串口。大灯带必须使用合适的外部 5V 电源并与 ESP32 共地。
ESP32-S3 本地 AI 语音
用途：在局域网内运行语音 AI 服务，再由 ESP32-S3 连接。
cd /Users/ayang/Documents/Codex/2026-06-23/new-chat/server
python3 -m venv .venv
. .venv/bin/activate
pip install -r requirements.txt
python -m app.main默认可使用 mock 模式测试；在线模型密钥只允许放在 server/.env.local。
ClipboardShelf
用途：Mac 本地剪贴板桌面卡片。
cd /Users/ayang/Documents/Codex/2026-06-03/files-mentioned-by-the-user-preview/outputs/ClipboardShelf
chmod +x build.sh
./build.sh
open ClipboardShelf.app主应用可直接构建；Widget 需要完整 Xcode、签名团队和 App Group。
Codex API Switcher
用途：切换 Codex API Provider 和模型配置。
cd /Users/ayang/Documents/Codex/2026-06-02/codex-api-api-deepseek
npm install
npm start也可双击项目 outputs 中的 App。切换后建议重启 Codex。不要把 API Key 写进文档或代码仓库。
AI 工具导航站
用途：本地运行 AI 工具与文章导航网站。
cd /Users/ayang/Documents/Codex/2026-05-07/next-js-tailwind-postgresql-cloudflare
npm install
npm run dev没有 PostgreSQL 时会使用项目内置 JSON 数据，因此可以先直接预览。
产品映射体验站
用途：体验商品导入、AI 推荐、人工审核和导出流程。
cd /Users/ayang/Documents/Codex/2026-07-17/referenced-chatgpt-conversation-this-is-untrusted/outputs/product-mapping-site
npm install
npm run dev这是前端体验项目，数据主要保存在当前浏览器中；正式生产数据应使用另行维护的 Python/SQLite 版本。
其余项目
测试样本、框架、子模块和全部原始目录统一放在 Codex项目代码索引，避免本页被技术目录淹没。