CAVE CULTURE / ENGINEERING HANDBOOK

一张图看懂洞穴数字系统，
一份手册统一未来研发。

本手册把 TourEvent、ChatGPT Workspace、MCP、Skills、ECS、Workbench、微信小程序、公众号、产品上架、履约、视频生产、海外模型代理及未来运营/营销/销售系统，以及内容知识平台与 AI 系列生产路线放进同一个架构。只写已确认事实、明确规划和必须核验项，不把推测写成现状。

已确认 / 当前可用已确认规划 / 待开发待现场核验v1.7 稳定版 · CEO 已确认回填 Canonical Handbook · 2026-10-07

01｜核心原则

未来所有研发、产品上架和 AI 系统扩展，先遵守下面 6 条。

01 SSOT
一个业务事实，一个来源
Product Record / Production API 是事实源；Admin、小程序、公众号和客服是下游投影。
02 THIN MCP
MCP 只做薄适配
业务逻辑留在后端与 Skill；MCP 只暴露聚焦工具、验证输入和转发。
03 AI + HUMAN
AI 辅助，开发本人负责
AI 帮助理解、拆解、编码和 QA；业务规则、生产写入和最终验收有明确责任人。
04 SAFE WRITE
写操作不自动重试
草稿、付费生成、状态修改等不确定写入一次调用，保留 request/task ID。
05 ENVIRONMENT
本地 ≠ 体验版 ≠ 生产
每个 Bug 先确认环境；health 200 只是局部证据。
06 SECRETS
密钥永远留在 ECS
Token、AppSecret、支付密钥、OSS Secret、代理订阅和 Provider Key 不进入聊天、Skill、Plugin ZIP 或 Git。

02｜总体架构：从 ChatGPT 到业务系统

形成“ChatGPT 智能层 + MCP 接口层 + ECS 服务层 + TourEvent 业务层 + 微信/内容/视频渠道层”的统一系统。

洞穴数字系统总架构图 2026-10-06
总系统架构图｜ChatGPT Workspace、MCP、Skill、Workbench、ECS、TourEvent、内容/视频/海外模型与未来业务系统。
INTELLIGENCE
ChatGPT Workspace
  • CEO / 产品决策
  • 研发拆解与 QA
  • 内容 / 产品 / 客服智能
  • 共享 Skills
CONTROL PLANE
Skills + MCP
  • TourEvent MCP
  • WeChat MCP
  • Video MCP
  • Cave MCP Creator
ECS SERVICES
API / Relay / Adapter
  • TourEvent API :8787
  • Video Relay :17494
  • WeChat Relay :8899
  • MCP adapters
  • V2Ray Core :10809
BUSINESS SYSTEM
TourEvent / Cave OS
  • Product Record
  • Admin：Local 3032 / Production 3001
  • 订单 / 会员 / 用户
  • 履约 / CRM
CHANNELS
微信与内容渠道
  • 微信小程序
  • 公众号草稿
  • 视频渠道
  • 私域 / 社群
新增规划｜小程序内容与知识平台：小程序作为一个用户入口，承载系列文章 / 音频 / 视频、游学与课程报名、会员优惠、订单与履约服务。已审定内容目录和发布状态归 TourEvent Core；AI 批量生成、内容日历与待审稿归 Cave Intelligence；图片 / 音频 / 视频文件归 OSS。当前已有 CMS 资产库与内容详情页记录；系列化 feed 和 AI 定时批量发布链路仍为规划，不是已上线能力。

未来统一业务闭环

Product Record产品事实
→
Operations履约状态
→
CRM / Sales客户与成交
→
Marketing内容与渠道
→
Analytics经营反馈
2026-10-06 ECS 实机盘点优先：本页总图是系统关系图；运行时目录、端口和状态以 03 / 06 / 22 的实机表为准。已确认 Production Admin 实际为 127.0.0.1:3001 且当前通过 SSH transient session 运行；新版 Cave Video MCP 为 :17496，当前仅确认 TTS model routing，没有 ASR endpoint；旧版 17495 当前无进程监听但保留备份与 Nginx 残留，未经 CEO 决策不得删除。

03｜当前系统与真实链路：2026-10-06 实机盘点

本节已用 ECS 只读盘点回填。凡与旧说明冲突，以本节及 06/22 的实机证据为准；TourEvent 应用代码与小程序仍由小景负责，不因基础设施盘点直接修改。

组件当前技术 / 实际位置作用状态
微信小程序Taro + React；源码与构建位于本地开发机，使用微信开发者工具调试并上传至微信开发平台产品浏览、报名、订单、会员、履约入口；运行时通过 Production API 与 ECS 数据交互已确认：ECS 不承载小程序源码或构建产物
Production Admin/srv/humanities-tour-admin/releases/20260916090839
127.0.0.1:3001		线上运营后台运行中，但为 SSH transient session，非持久化
Local Admin 规范start:3032本地开发 / 三端验证约定本地规范；不要与生产 3001 混写
Production API/opt/tourevent-api/current
127.0.0.1:8787
tourevent-api.service		TourEvent 业务事实与接口active
TourEvent 数据/var/lib/tourevent/db.json + registration-archives/当前业务数据持久化JSON 文件型；并发/原子写需后续工程评估
TourEvent MCP/opt/cave-tourevent-mcp · :17500ChatGPT 读取、验证、创建产品草稿active
WeChat MCP/opt/cave-wechat-mcp · :18901ChatGPT → WeChat Relayactive
WeChat Relay/opt/cave-wechat-publisher · :8899微信公众号官方 API 网关active；当前 Nginx root fallback 指向它，需修正
Video Relay/opt/cave-video · :17494Doubao ICL / Seedance 上游网关active
Cave Video MCP 新版/opt/cave-video-mcp · :17496TTS model routing、Seedance、缓存与签名 URLactive；TTS 仅 seed-icl-2.0 / seed-audio-1.0；无 ASR endpoint
Cave Video MCP 旧版/opt/cave-video-backup-*；Nginx 仍有 → :17495历史 Video MCP 资产17495 当前无监听；保留，不删除，恢复方式待单独设计
ECS 海外代理/opt/cave-v2ray-proxy · :10809预留海外 Provider 出口service active，但当前无业务服务显式使用
运行时验收边界：基础设施盘点只确认“服务怎么跑”；Admin、小程序、TourEvent API 业务代码的修改与发布仍由小景在 canonical 工程中执行。CEO 可以直接维护 MCP adapter、WeChat / Video Relay、V2Ray 与这些服务对应的基础设施，但不直接改 TourEvent Admin / 小程序应用代码。
实机证据：systemd / 监听端口 / Nginx / 目录 / 数据目录只读盘点，2026-10-06。生产目录均未发现 .git；ECS 未找到小程序 dist/weapp 与当前架构一致——小程序源码、调试和上传均在本地完成，正式访问环境由微信平台承载，ECS 仅通过 Production API 提供业务数据。

04｜当前 Admin 与小程序：已开发功能地图

以下不是未来设想，而是对《工程文件说明.7z》源码与说明文件的核对结果。后续开发先在这张现状地图上继续，不重复造模块。

DASHBOARD
主界面看板
活动、草稿、库存、模块入口；已存在今日订单、营业额、退款、待付款、待退款、有效会员、新增用户等 API 指标。
PIM
产品管理
基础字段、规格/价格/库存、特色富文本、行程、导师、费用、专题课程、预检、草稿与上架。Sprint 01 目标：ChatGPT 生成的唯一 canonical Product Package 经 TourEvent MCP 校验后进入 PIM 草稿箱。
OMS
订单管理
父子订单、支付、退款、定金/尾款与催缴相关接口已经进入后台/API 结构。
CRM
用户与会员
微信用户、会员状态、会员授权/历史会员导入、文脉值、城市、订单统计等。
FMS
履约管理
报名资料按活动/出发日归档，默认脱敏；支持按报名人核销、统一动态二维码与签到记录。
CS / MCM
营销触达
模块设计包含 Banner、主题、兑换专区；当前代码已存在站内通知与优惠券发放能力。
CMS
内容资产库
图片、导师头像、音频、视频、电子书、文档；分组、草稿/正常/下架/回收站；原文件存 OSS。
COURSE
课程商品
从 CMS 选封面和课时，支持课时排序；免费/付费/会员权益；非会员价格；永久/按天/指定日期有效期；草稿/上架/下架。
BI + REVIEWS
数据与评价
7/14/30 天数据分析、支付转化、报名、营业额、退款、新用户；真实评价支持隐藏与删除。

PIM 产品创建链路｜Sprint 01 目标

ChatGPT + cave-study-tour-publisher审校资料并生成唯一 canonical Product Package
→
TourEvent MCP · Validate校验字段映射与规则，不写入
→
TourEvent MCP · Create Draft创建草稿到 PIM 草稿箱
→
TourEvent PIM人工复核草稿，确认后发布到小程序
唯一记录口径：Product Package 字段、API 映射、字段错位实验及复测证据统一记入第 12 节 Product Record；本节只描述链路。公众号 URL 导入不再作为产品创建入口。该链路按 Sprint 01 项目文件验收，未有验收证据前不标记为已完成。

小程序源码当前页面

业务域已存在页面说明
内容/产品首页、内容详情、活动详情、主题产品发现与详情入口。
交易购物车、结算、支付成功、订单详情、退款申请交易链路源码已存在，真实支付/退款仍必须做生产验证。
履约当前行程、出行人资料、我的报名、Passport、管理员核销与 FMS/签到 API 形成履约前台。
会员/用户会员、文脉、收藏、个人中心、个人设置会员状态与用户资料入口。
其他定制游学、兑换专区扩展业务入口。
内容平台现状标注：已核验资料记录 CMS 内容资产库和小程序内容详情页。系列 / 单集持续更新入口、播客式连续消费、AI 定时批量生产与人工审核发布链路未被核验为当前功能，均列为中长期规划。
目录与端口来源必须分开：《工程文件说明》旧交付说明明确记录过本地路径 /Users/jhuis/Developer/TourEvent-weapp-local，并包含“3032管理后台源码 / 小程序源码 / 小程序编译产物 / Node.js API服务 / 公共业务包”等交付目录；它是历史交付位置，不自动等于当前 canonical repo。当前三端同步 Skill 指定的 canonical project 为 /Users/jhuis/Desktop/TourEvent工作留痕/本地小程序测试/01-工程副本/TourEvent-weapp-local，本地 Admin 规范为 start:3032；而 ECS 生产 Admin 已实机确认监听 3001。三者不得混写。
核对来源：工程交付包中的 Admin README、admin-console.tsx、CMS/Course/FMS/BI 组件、API routes、Taro app.config.ts。

05｜课程视频、大文件与 OSS：内容资产交付架构

课程视频已经进入 CMS 与 Course Product 代码，但“能上传 200MB 文件”还不等于“大文件与付费视频架构已经完成”。下面明确当前能力与下一阶段必须补齐的生产能力。

当前已实现

CURRENTCMS 内容类型
图片 / 导师头像 / 音频 / 视频 / 电子书 / 文档 → 阿里云 OSS → 后台管理元数据与发布状态。
CURRENT课程商品
课程封面 + CMS 课时列表 → 排序 → 免费 / 付费 / 会员权益 → 有效期 → 草稿 / 上架 / 下架。
CURRENT上传限制
现有 Admin 上传路由：MP4/MOV 最大 200MB；其他已支持文件默认最大 50MB。API 的 /oss/sign 对 CMS file 也已能签发最大 200MB 的短时 OSS Policy。
CURRENTOSS 安全基础
公共业务包已采用“AccessKey 仅服务端保存、客户端拿短时 Policy 直传 OSS”的设计，并要求 RAM 子账号、业务鉴权、限流和文件类型/大小限制。

课程视频标准上架链路

Admin / CMS创建内容记录
→
API Sign鉴权 + 短时 Policy
→
Direct Upload浏览器直传 OSS
→
Content RecordfileKey / size / mime / status
→
Course Product组合课时/权益/有效期
→
Mini Program鉴权后播放

大文件目标架构

Admin 选择视频
  ↓
TourEvent API：校验管理员身份 / 文件类型 / 大小 / 业务用途
  ↓
返回短时 OSS 上传凭证
  ↓
浏览器 → OSS 直接上传（大文件使用 Multipart / 分片 / 断点续传）
  ↓
上传完成 → API 登记 Content Record
  ↓
[可选异步处理] 元数据 / 首帧 / 转码 / HLS / 封面
  ↓
Course Product 关联 contentIds
  ↓
用户打开课程 → API 判断免费/会员/已购买/有效期
  ↓
返回短时播放凭证或受控播放地址 → 小程序播放器

必须补齐的生产能力

事项当前目标优先级
大文件上传Admin 中转上传和 200MB Policy 均存在统一改为客户端直传；视频采用 Multipart/断点续传，避免 3032/Node 内存中转大文件P1
文件大小视频 200MB按课程真实素材决定 1–5GB 级上限；限制落在 Policy 与业务规则，不靠前端提示规划
视频播放保护课程 API 会判断访问权益后才返回 assets；但已发布 CMS 文件的 /content-file 当前是公开读取路由付费/会员视频使用私有 OSS + 短时签名/CDN 鉴权；播放令牌每次经过课程 entitlement 校验上线课程前
转码/流媒体未形成完整链路根据成本选择 OSS + 媒体处理/CDN；长视频优先 HLS/多码率，不直接把超大 MP4 当唯一播放形态规划
内容状态draft / published / archived / trashed继续沿用；回收站只改元数据状态，不直接删除 OSS 原文件，增加生命周期清理任务沿用
资产元数据fileKey/fileUrl/fileName/size/mime/uploader/group/status补 duration、resolution、checksum、transcodeStatus、source/provenance、rights、playbackPolicy规划
关键风险：当前 /content-file 只验证“该 OSS key 是否属于已发布 CMS 内容”，并不在文件读取时再次验证课程购买/会员权益。课程产品真正商业化之前，必须改成受控播放，不要把永久可转发的文件 URL 当成付费课程权限系统。

系列内容平台的资产流（规划）

AI 工厂系列 Brief / 批量稿件 / 制作任务
→
人工审校事实 / 版权 / 品牌 / 质量批准
→
TourEvent CMS系列、单集、排序、发布状态与访问策略
→
OSS文章图 / 音频 / 视频实际文件
→
小程序系列 feed / 内容详情 / 报名与会员入口
边界：AI 只生成草稿和编辑任务；只有人工批准后才进入 Core CMS 和发布排期。已发布目录、会员 / 付费访问判断由 TourEvent API 管理；OSS 不承担系列目录或交易权限事实。

建议 OSS 逻辑目录（业务规范，不代表当前服务器真实目录）

tourevent/
  cms/
    image/
    lecturer/
    audio/
    video-original/
    video-stream/
    ebook/
    document/
  activity/
    cover/
    route-map/
    detail/
  user/
    avatar/
  temp/
已核对当前代码：Admin 的 OSS upload route、API /oss/sign、@cave-culture/aliyun-oss、CMS/Course Product 组件以及 Node API 的课程权限判断。

06｜ECS 当前资产、目录与端口：实机回填

本节只记录 2026-10-06 已由 ECS 只读盘点确认的运行事实；历史推测或未运行资产单独标注。

目录 / 服务端口 / unit用途当前状态 / 风险
/opt/tourevent-api/current:8787
tourevent-api.service		TourEvent Production APIactive；systemd EnvironmentFile 为 /etc/tourevent/tourevent.env，cwd 另有 .env，实际加载优先级待核验（见第 21 节）
/var/lib/tourevent/db.json + registration-archives/TourEvent 当前数据JSON 文件型；截至盘点未发现自动 backup timer/cron，备份链证据待补（见第 21 节）
/var/backups/tourevent*静态备份TourEvent 历史备份最近 data 2026-07-22；predeploy 2026-08-13，已过期
/srv/humanities-tour-admin/releases/20260916090839:3001
SSH transient session		Production Admin当前由 SSH transient session 启动；启动单元与持久化方式待核验（见第 21 节）
/opt/cave-tourevent-mcp:17500
cave-tourevent-mcp.service		TourEvent MCPactive
/opt/cave-wechat-mcp:18901
cave-wechat-mcp.service		WeChat 薄 MCP Adapteractive；代码隐式读取 /etc/cave-wechat-publisher.env
/opt/cave-wechat-publisher:8899
cave-wechat-relay.service		WeChat Relayactive；当前 Nginx location / 兜底到此服务，完整域名/路径/上游映射待补证（见第 21 节）
/opt/cave-video:17494
cave-video-relay.service		Cave Video Relayactive；env /etc/cave-video.env
/opt/cave-video-mcp:17496
cave-video-mcp.service		Cave Video MCP 新版active；仅确认 TTS routing + Seedance；无 ASR
/opt/cave-video-backup-*Nginx 历史 → :17495Cave Video MCP 旧版资产17495 无进程监听；保留资产，未经 CEO 授权不删除
/opt/cave-v2ray-proxy:10809
cave-v2ray-proxy.service		海外 HTTP 代理active，但当前业务服务未显式使用 HTTP_PROXY/HTTPS_PROXY
Docker 历史容器3 个 Exited历史测试资产与当前生产无关；是否清理由 CEO 另行决定

本地工程交付包的代码目录（历史交付结构，已核对）

工程文件说明/
  3032管理后台源码/        ← apps/admin
  小程序源码/              ← src
  小程序编译产物/          ← dist/weapp
  Node.js API服务/          ← server
  公共业务包/              ← packages
    aliyun-ecs-deploy/
    aliyun-oss/
    commerce-core/
    engineering-playbook/
    json-store/
    node-api-kit/
    proxy-toolchain/
    wechat-auth/
    wechat-pay/
小程序“放在哪里”的结论：工程交付文件里给过历史本地路径 /Users/jhuis/Developer/TourEvent-weapp-local，并明确存在 小程序源码/ 与 小程序编译产物/dist/weapp；当前 canonical path 由三端同步 Skill 指定。小程序源码、调试与构建均在本地开发机完成，通过独立的微信开发者工具调试并上传至微信开发平台，正式对外访问环境由微信平台承载；ECS 不保存小程序源码或 dist/weapp，只通过 Production API 与小程序进行业务数据交互。

07｜ECS 远程连接 + ChatGPT Workbench 开发方式

Workbench 的价值不是“让 AI 随便改服务器”，而是让 AI 在真实 ECS 上读取当前状态、部署小型服务、查看日志、验证端口、构建和排错。

连接方式

阿里云控制台：ECS → 实例 i-bp1393nuodugvoaeb97n → 远程连接 / Workbench。
SSH：114.55.74.132:22。凭据不进入本手册。
系统：历史已核实 Ubuntu 26.04 64 位。
Workbench 深链接：当前资料未记录，不伪造固定 URL。

ChatGPT 与 Workbench 配合

ChatGPT定义业务问题与任务
→
Workbench检查服务器真实状态
→
修改只改目标服务
→
验证service / API / logs
→
ChatGPT复核与验收
Workbench 指令格式是硬规则：执行文本必须是连续自然语言，不用编号、项目符号、Markdown 表格或一串命令块。用“先……然后……同时……最后……”表达执行顺序。

标准粘贴式指令骨架

请先检查目标服务当前目录、systemd 状态、监听端口、Nginx 路由、环境文件是否存在以及最近日志，不要停止或覆盖任何无关服务，也不要输出任何密钥或完整环境变量；确认现有状态以后，仅在本次任务明确涉及的目录中进行最小修改，修改前保留时间戳备份并执行语法或导入检查，然后重启或 reload 目标服务，依次验证 localhost 健康检查、真实业务接口以及公网 HTTPS 路径，最后只报告修改文件、验证结果、仍存在的风险和可回滚位置。

CEO / 小景操作边界

范围负责人规则
TourEvent Admin / 小程序 / TourEvent 应用 API 代码、Build、发布小景CEO 不直接改，避免双方工作副本与发布版本分叉；由小景在 canonical repo 执行并回传 Commit/Build/验收证据。
MCP adapters、Cave WeChat MCP / Relay、Cave Video MCP / Relay、V2Ray 及其专属 Nginx/systemdCEO + ChatGPT / Workbench可按最小改动、先备份、后验证原则直接维护；不得顺带修改 TourEvent 应用代码。
共享 Nginx / 系统级安全 / 备份按影响范围分派若会影响 TourEvent Admin/API/小程序运行，先交小景或共同确认；若只影响独立 MCP/Relay，可由 CEO 执行。

Workbench Zoom-in：正确使用方式

Workbench｜先检查真实状态，再最小修改、验证并回填证据
Workbench｜先检查真实状态，再最小修改、验证并回填证据
先定位再动手先确认 canonical repo、cwd、branch、service、port、env、Nginx、最近日志；不要一上来就修改。
自然语言胜过命令堆Workbench 指令写成连续自然语言，用“先…然后…同时…最后…”，不要贴一串 shell 让它机械执行。
限定修改半径明确“只修改哪个服务/目录”，保留 dirty worktree，不 reset/clean，不覆盖无关文件。
验收必须分层至少区分 syntax/build、localhost、真实业务 API、公网 HTTPS、最终业务端表现；health 200 不是完成。
日志是证据，不是噪音修改前后都看 service 和应用日志；遇到 404/421/502/业务 4xx/5xx 先定位层级再修。
永不回显 secrets只确认 env 变量“是否存在/非空”，不打印 Token、AppSecret、支付密钥、OSS Secret、Provider Key、代理订阅。
可逆写入生产数据测试必须选非关键对象，先保存旧值、改一个可逆字段、三端验证后恢复。
结果回填 Handbook只回填已验证的 path / unit / port / route / state / rollback；不确定的继续标“待核验”。

08｜当前 MCP 清单、定义与调用

MCP 是 ChatGPT 观察或操作真实系统的接口。MCP 不承担产品经理职责，不把完整业务逻辑塞进去。

MCP工具用途典型调用
Cave TourEvent MCP
/cave-tourevent-mcp/mcp		tourevent_health
tourevent_product_list
tourevent_product_get
tourevent_product_validate
tourevent_product_create_draft		产品读取、验证、创建/更新草稿；不发布、不删订单、不改会员退款。“用 Cave TourEvent MCP 校验这份 Product Package；通过后创建一个 draft。”
Cave WeChat MCP
/cave-wechat-mcp/mcp		wechat_health
wechat_create_draft		公众号 Relay 健康检查和草稿创建。一次写入，不自动重试。“检查 WeChat MCP 健康；把已确认 API HTML 推送到草稿箱。”
Cave Video MCP
/cave-video-mcp/mcp		cave_video_health
cave_video_tts
cave_video_seedance_create
cave_video_seedance_get
cave_video_seedance_cache
cave_video_signed_url		ICL 配音、Seedance 单任务创建/查询/缓存、签名下载。基础设施先只 health；付费生成必须明确模型、时长、分辨率、比例与预算。
当前界面可见两个 Cave Video MCP 命名空间。它们暴露相同工具。开发侧应把“是否为重复连接/旧连接”列为清理项；未核验前不要同时调用。

逐个 MCP Zoom-in：调用链与边界

Cave TourEvent MCP｜Product Package → validate → Production API → TourEvent
Cave TourEvent MCP｜Product Package → validate → Production API → TourEvent
Cave WeChat MCP｜Approved HTML → Publisher → Relay → 微信草稿箱
Cave WeChat MCP｜Approved HTML → Publisher → Relay → 微信草稿箱
Cave Video MCP 旧版｜保留兼容入口，ICL + Seedance + cache/signed URL
Cave Video MCP 旧版｜保留兼容入口，ICL + Seedance + cache/signed URL
Cave Video MCP 新版｜TTS 模型路由已在 ChatGPT schema 验证；ASR/识别 routing 等待 ECS 回填
Cave Video MCP 新版｜TTS 模型路由已在 ChatGPT schema 验证；ASR/识别 routing 等待 ECS 回填
Video MCP 双连接当前处理原则：旧版与新版都保留。旧版用于兼容与稳定回归；新版优先承接语音 routing 能力。当前可见工具 schema 已确认新版 cave_video_tts 增加 model=seed-icl-2.0|seed-audio-1.0 与 style_prompt；用户确认还存在“语音识别/ASR routing”升级方向，但该 endpoint、service 与工具暴露方式必须由第22条 Workbench 实机回填后再标记为已验证。

09｜Cave / TourEvent Skills 清单

Skill 是可复用的“项目方法 + 规则 + 脚本 + 参考资料”。任务明显匹配时优先调用对应 Skill。

产品、运营、客服与工程

cave-study-tour-publisher
从路书/PDF/DOCX/策划稿审校事实，生成 canonical Study Tour Product Package，准备运营 handoff，映射并校验 TourEvent，获授权后创建草稿。
调用：产品上架 / 路书转产品
cave-study-tour-publisher｜独立调用架构与职责边界
cave-study-tour-publisher｜独立调用架构与职责边界
cave-study-tour-operations
读取 Product Package + 实时运营状态，判断生命周期、剩余准备、风险、临近满团/截止节点与下一步动作。
调用：这个团现在该做什么
cave-study-tour-operations｜独立调用架构与职责边界
cave-study-tour-operations｜独立调用架构与职责边界
cave-study-tour-customer-service
用产品事实 + 实时团状态 + 授权客户状态回答报名、付款、合同、签证、库存、候补等客服问题。
调用：客户咨询 / 订单状态
cave-study-tour-customer-service｜独立调用架构与职责边界
cave-study-tour-customer-service｜独立调用架构与职责边界
tourevent-three-end-sync
恢复并验证 Production API、3032 Admin、微信小程序三端单一数据链路；处理“后台改了小程序没更新”。
调用：三端同步 / 3032 / build
tourevent-three-end-sync｜独立调用架构与职责边界
tourevent-three-end-sync｜独立调用架构与职责边界
cave-mcp-creator
把 ECS 已有 API/Relay 封装为薄 MCP，部署 Nginx HTTPS，创建 ChatGPT MCP app，排错和打包。
调用：新增 MCP / MCP 排错
cave-mcp-creator｜独立调用架构与职责边界
cave-mcp-creator｜独立调用架构与职责边界

内容、公众号与私域

cave-culture-content
公众号长文、短视频口播的洞穴文化内容生产统筹。
调用：选题 / 公众号 / 口播
cave-culture-content｜独立调用架构与职责边界
cave-culture-content｜独立调用架构与职责边界
gzh-design
公众号 Markdown / Word / PDF / 文本排版；“洞穴游学”固定使用 v9 模板。
调用：公众号排版
gzh-design｜独立调用架构与职责边界
gzh-design｜独立调用架构与职责边界
cave-wechat-publisher
接收已确认文章/HTML，校验微信兼容性，通过 Cave WeChat MCP 创建公众号草稿。
调用：推送草稿箱
cave-wechat-publisher｜独立调用架构与职责边界
cave-wechat-publisher｜独立调用架构与职责边界
cave-culture-private-marketing
企业微信群发、朋友圈、小红书、1对1微信营销与跟进。
调用：私域宣传 / 跟进
cave-culture-private-marketing｜独立调用架构与职责边界
cave-culture-private-marketing｜独立调用架构与职责边界

视频生产系统

shor-video-automation
视频总导演：从 brief、脚本锁定、语义节拍、Treatment、资产策略、音频、生成、Remotion、QA 到 Package 的总控。
调用：完整短视频工作流
shor-video-automation｜独立调用架构与职责边界
shor-video-automation｜独立调用架构与职责边界
cave-visual-asset-director
视觉导演：Treatment、Continuity Bible、Sequence、资产策略、Storyboard、AI generation brief。
决定画面应该是什么
cave-visual-asset-director｜独立调用架构与职责边界
cave-visual-asset-director｜独立调用架构与职责边界
cave-video-asset-search
搜索真实/档案动态素材候选，保留来源、时间范围、版权状态和推荐项。
寻找真实视频素材
cave-video-asset-search｜独立调用架构与职责边界
cave-video-asset-search｜独立调用架构与职责边界
video-asset-fetcher / media-asset-fetcher
下载、裁剪、标准化、验证并锁定已选真实/档案素材，生成 material lock。
已有素材 URL 后执行
video-asset-fetcher / media-asset-fetcher｜独立调用架构与职责边界
video-asset-fetcher / media-asset-fetcher｜独立调用架构与职责边界
cave-generation-director
把已批准 AI/HYBRID 镜头转成 Seedance provider-ready job，负责 prompt、reference、模型与成本路由。
AI 镜头生成准备
cave-generation-director｜独立调用架构与职责边界
cave-generation-director｜独立调用架构与职责边界
seedance
Seedance 视频生成能力；支持文生、图生、多模态引用和编辑。
具体 Seedance 生成
seedance｜独立调用架构与职责边界
seedance｜独立调用架构与职责边界
google-veo
Google Veo 生成规划与 API handoff；适合未来海外模型路由。
Veo 视频生成
google-veo｜独立调用架构与职责边界
google-veo｜独立调用架构与职责边界
cave-remotion-template-system
把 locked visual decisions + material_lock 转成 edit_manifest 和 Cave 品牌 Remotion 实现。
正式渲染 / 字幕 / 地图 / GFX
cave-remotion-template-system｜独立调用架构与职责边界
cave-remotion-template-system｜独立调用架构与职责边界
jianying-draft-builder
使用同一 edit_manifest 生成可人工继续精修的剪映工程。
需要可编辑剪映出口
jianying-draft-builder｜独立调用架构与职责边界
jianying-draft-builder｜独立调用架构与职责边界

平台级支持

skill-creator
创建、更新、校验、打包 ChatGPT Skill；Skill ZIP 最终标准名 skill.zip，单 Skill 上传，25MB 以内。
创建/更新 Skill
skill-creator｜独立调用架构与职责边界
skill-creator｜独立调用架构与职责边界
Plugin Creator
创建或更新 ChatGPT Plugin / MCP app 封装、发布元数据。
Plugin/App 打包与更新
Plugin Creator｜独立调用架构与职责边界
Plugin Creator｜独立调用架构与职责边界
docx / pdfs / slides / spreadsheets
文档、PDF、PPT、表格的专业产出与验证能力。
需要对应文件成品
docx / pdfs / slides / spreadsheets｜独立调用架构与职责边界
docx / pdfs / slides / spreadsheets｜独立调用架构与职责边界

10｜Cave MCP Creator：所有后续 MCP 的统一规范

ChatGPT Web
→
Public HTTPSapi.izhexue.wang/<mcp>/mcp
→
NginxTLS
→
127.0.0.1thin adapter
→
Existing API / Relay
默认 No authentication（不需要 per-user identity 的私有/单租户场景）。
ChatGPT 面向公网 MCP 不加 Basic Auth 或固定 Bearer。
不使用旧 Secure MCP Tunnel；Tunnel 已退出当前架构。
Adapter 只绑定 127.0.0.1，不直接暴露 provider。
provider key / internal token 只留在 ECS env。
OpenAI mTLS 是后续安全加固，不是首次连接前置条件。
需要真实终端用户身份时再升级 OAuth 2.1。
write / paid / sensitive 工具先读 health，再单次写入，不自动重试。

部署验证顺序

localhost initialize → localhost tools/list → public HTTPS initialize → public tools/list → free/read-only health → ChatGPT app creation

错误定位

现象先查
connection refusedservice / port
404Nginx path/location
421Host / SNI / proxy Host
502upstream / port / service
initialize 成功，tools/list 失败MCP schema / server implementation
工具已到 MCP，但 backend 失败停止排 MCP，改查 API / provider

11｜三种“Package”必须分清

BUSINESS
Product Package
Study Tour Product Package。是业务产品事实，不是 ChatGPT 插件。
WORKFLOW
Skill Package
skill.zip，包含 SKILL.md / references / scripts / assets。
INTEGRATION
Plugin Package
注册 MCP app 后可选，用于绑定 app + Skills + 元数据。

ChatGPT MCP App 注册

  1. Developer mode。
  2. Plugins → Add / Create MCP app。
  3. Server URL：https://api.izhexue.wang/<mcp-name>/mcp。
  4. 默认 Authentication：No authentication。
  5. 必须先确保公网 initialize 与 tools/list 成功。
  6. 创建后得到 asdk_app_... ID。

可选 Plugin ZIP 结构

plugin.json
.app.json         # 引用 asdk_app_...
skills/
  your-skill/
    SKILL.md
    agents/openai.yaml
    references/
    scripts/
    assets/

# registered-app 打包模式不要再放 root mcp.json

Skill ZIP 结构

skill-name/
  SKILL.md
  agents/openai.yaml
  references/     # optional
  scripts/        # optional
  assets/         # optional

最终包名：skill.zip
单个 Skill；<= 25MB
Workspace 里的“拥有者”和“可见范围”不是一回事。团队共用 Skill 必须确认安装/共享在 CaveCulture Workspace，而不是只存在于个人空间。

v1.4 固化：Skill / Plugin / MCP 三层模型

SKILL
定义能力
  • 方法、规则、SOP
  • scripts / references / assets
  • 决定“怎么做”
PLUGIN
分发能力
  • 把成熟 Skill / MCP App 打包
  • Workspace 安装与默认分发
  • 决定“谁能稳定使用”
MCP
连接系统
  • 真实 API / Relay / 外部系统
  • 读写动作与状态
  • 决定“能操作什么真实系统”
Mature Skill真实任务验证
→
Plugin封装元数据/可选 MCP App
→
Admin Console上传到 CaveCulture
→
Installed默认安装
→
Member Verify成员调用验证
已落地案例：gzh design Plugin v2.5.2 已进入 CaveCulture Workspace 并默认安装。它不新建公众号发布 MCP；公众号草稿写入继续由独立 Cave WeChat MCP 完成。

12｜Product Record：未来产品的统一记录

Product Record 是后台中的“完整产品档案容器”。其中 canonical Study Tour Product Package 只保存耐久产品事实；运营状态和客户状态必须分层，不能混写。

产品事实唯一记录口径：Canonical Package schema、TourEvent MCP / API 字段映射、字段缺失或错位实验、修复前后对照及复测证据统一记录在本节 Product Record；其他章节只引用流程，不重复维护产品字段实验结论。每条记录标明版本、来源、状态和证据。

字段映射与实验记录模板

记录项需记录的事实
契约版本Product Package schema 版本、Skill / MCP / API 版本与测试时间。
字段映射canonical 字段、MCP 输入字段、TourEvent API / PIM 目标字段、类型/格式和转换规则。
实验结果预期值与实际回读值、缺失/错位/拒绝结果、错误或 warning；记录脱敏后的必要请求/响应片段。
修复与复测修复版本、复测结果、PIM 独立回读证据、证据路径及状态：待验证 / 通过 / 未通过。
SOURCE
原始资料
  • 路书 / PDF / DOCX
  • 供应商资料
  • CEO确认
  • 历史版本
FACTS
Canonical Package
  • product / schedule
  • sales / pricing
  • payment / specs
  • content / assets
LIVE OPS
Operational State
  • 报名 / 余位
  • 付款 / 合同
  • 签证 / 资源
  • 物料 / 建群 / 行前会
CUSTOMER
Customer State
  • 订单
  • 付款
  • 合同
  • 签证 / 同行人
PROJECTIONS
渠道投影
  • TourEvent
  • 小程序
  • 公众号
  • 客服 / 营销

Canonical Study Tour Product Package v1.1

区块核心字段
productid、slug、title、subtitle、status、themeId、destination、regionKey、durationKey、tags
schedulestartAt、endAt、signupDeadlineAt、days、nights、assembly、dismissal
salesminGroupSize、capacity、stock、registrationRequiresConfirmation、earlyBird
pricingcurrency、list/member/room/adult/child price、samePriceForAdultAndChild
paymentpaymentModes、deposit
wenmai / weather文脉值策略、天气位置/开关
specsSKU / 规格 / 价格 / 库存 / 定金等
contentsummary、highlights、itinerary、lecturers、courses、feeIncludes/Excludes、refundRules、notices、memberBenefits
assetscover、routeMap、itineraryGraphics、lecturerPortraits、detailImages
operationsPolicy招募关闭、近满、资源锁定、物料、合同、建群、行前会、尾款触发规则
audit / source / validation审校结果、来源、缺失字段、需人工确认、errors/warnings

Product Record 推荐外层结构

{
  "recordVersion": 1,
  "sources": [...],
  "canonicalPackage": { "schemaVersion": "study-tour-product-v1.1", "...": "..." },
  "operationalState": { "...live state...": "..." },
  "customerKnowledge": { "rules": [], "faq": [] },
  "channelProjections": { "tourevent": {}, "wechat": {}, "marketing": {} },
  "history": [{ "updatedAt": "...", "updatedBy": "...", "changeNote": "..." }]
}

13｜产品上架全流程架构

源资料路书 / 供应商 / CEO确认
→
ChatGPT + cave-study-tour-publisher审校并生成唯一 canonical Product Package
→
Product Record契约与字段映射基线（详见第 12 节）
→
TourEvent MCP · Validate校验字段与规则，不写入
→
TourEvent MCP · Create Draft写入 TourEvent PIM 草稿箱
→
PIM Review人工预览与确认
→
Publish发布到小程序

后台产品创建应逐步向“向导式流程”升级

基础信息
日期 / 集合 / 解散
规格 / 价格 / 库存 / 定金
导师 / 课程
行程 / 费用 / 退改
封面 / 路线图 / 详情资产
会员 / 早鸟 / 文脉值
预览 / 发布检查 / 上架 / 下架 / 归档
Admin 不是产品事实源的第二套数据库。后端字段、PIM 字段和小程序字段必须由 Activity Field Contract 显式映射；字段试验、错位与复测证据统一归档在第 12 节 Product Record。

14｜微信调用 ECS：两条完全不同的链路

A. 微信小程序 → TourEvent ECS

微信小程序Taro / React
→
HTTPS APIai.izhexue.wang/api
→
TourEvent API127.0.0.1:8787
→
数据 / OSS

Admin 3032 也必须指向同一个 Production API；小程序构建产物必须确认 API base 没有被本地地址或旧地址污染。

B. ChatGPT → 微信公众号草稿

ChatGPTcave-wechat-publisher
→
Cave WeChat MCP:18901
→
WeChat Relay:8899
→
微信官方 API
→
公众号草稿箱
正常 ChatGPT Web 路径不让 Skill 直接读取 Relay API Key / AppSecret。凭据全部留在 ECS。用户说“推送到草稿箱”只授权创建草稿，不授权群发或正式发布。

15｜ECS 海外模型代理：V2Ray Core 架构

Windows 本地用过 v2rayN；ECS 当前部署的是 V2Ray Core v5.53.0，不是 v2rayN GUI。它只作为需要海外网络的服务级出口。

ECS AI ServiceOpenAI / Gemini / HF 等
→
HTTP Proxy127.0.0.1:10809
→
V2Ray Core/opt/cave-v2ray-proxy
→
SS Node当前只解析 SS
→
Overseas Provider

已确认

cave-v2ray-proxy.service 当前 active；2026-10-06 盘点未发现任何业务服务显式配置 HTTP_PROXY/HTTPS_PROXY
/etc/cave-v2ray-proxy.env 保存订阅 URL，root-only
/opt/cave-v2ray-proxy/bin/cave-proxy-node
cave-proxy-node test / refresh
订阅可含多种节点；当前仅配置/解析 SS
TourEvent、WeChat、现有 MCP 不应整体改走代理

未来国外大模型标准调用

业务服务（ECS）
  ├─ Provider Key：仅 ECS env
  ├─ 请求重试/超时：业务层控制
  ├─ process-scoped HTTPS_PROXY=http://127.0.0.1:10809
  ↓
V2Ray Core → Overseas Provider

禁止：把整个服务器设置成全局代理；禁止把订阅 URL / 节点密码写进代码或 Skill。

16｜视频研发架构：从 Skill 流水线到未来决策平台

当前视频体系已经不是“AI 生几个镜头”，而是一条可追踪的导演型流水线。未来后台要做的是 Video Decision / Production Console，把阶段、任务、素材、成本、审核和版本可视化，而不是重写现有 Skills。

语音 routing 当前事实：新版 Cave Video MCP 已确认 TTS model routing：seed-icl-2.0 / seed-audio-1.0；当前没有 ASR endpoint 或语音识别 routing。ASR 只能作为后续规划，不能写成已上线。

当前导演流水线

BRIEF
→ SCRIPT_LOCK
→ SEMANTIC_BEATS
→ TREATMENT_LOCK
→ SEQUENCE_LOCK
→ ASSET_PLAN
→ AUDIO_LOCK
→ RESOLVED_TIMELINE
→ GENERATION
→ ASSET_REVIEW
→ MOTION_LOCK
→ ASSEMBLY
→ CAVE_STYLE_QA
→ MASTER_QA
→ PACKAGE

职责分层

层组件产物/职责
总控shor-video-automation阶段、成本、审批、验收门槛
视觉决策cave-visual-asset-directorTreatment、Continuity、Sequence、Shot/Asset Plan
真实素材cave-video-asset-search + fetcher搜索、下载、裁剪、授权、material_lock
音频Cave Video MCP / ICLvoice master、word timestamps、events、usage
AI 生成generation-director + Seedance / Veojob spec、reference、模型路由、生成结果
合成cave-remotion-template-systemedit_manifest、字幕、地图、GFX、SFX、正式渲染
人工出口jianying-draft-builder可继续人工编辑的剪映工程

未来 Video Decision Platform 模块

项目状态

阶段、审批、版本、owner、blocking issue

镜头决策

REAL / ARCHIVE / AI / HYBRID / GFX / CAPTURE

任务中心

生成任务、下载、失败、重试、request/task ID

成本中心

模型、时长、费用、预算、授权

素材资产

来源、版权、handles、human lock

时间线

Multi Track EDL / Master Clock / conflicts

品牌 Motion

Caption / Header / Map / Hero / SFX

QA

Cave Style + 技术 + 同步 + 导出

ECS 当前视频目录

/opt/cave-video/                         Relay :17494
  ecs_relay_server.py
  ecs_client.py
  tools/seed_audio_debug.py

/opt/cave-video-mcp/                     MCP :17496
  cave_video_mcp_server.py

/var/lib/cave-video/                     生成/缓存文件
/etc/cave-video.env                      Relay 环境变量（不显示值）

17｜未来产品路线：运营、营销、销售与履约

最终不是“TourEvent 小程序后台”，而是一套洞穴文化业务操作系统。研发顺序：可靠 → 可用 → 好用 → 可运营 → 平台化 → 智能化。

PHASE 0–1

基础可靠性 / 数据一致性

三端同源、登录、订单、会员、SKU、时间、早鸟、导师、图片、状态机、日志、备份、回滚。

PHASE 2

交易 + 履约闭环

创建 → 上架 → 报名 → 支付 → 订单 → 合同/签证/尾款 → 建群/物料/行前会 → 签到 → 行中执行 → 评价 → 归档。

PHASE 3

运营工作台

产品向导、活动模板、导师库、内容模块、资产库、日历、任务提醒、近满/截止预警、运营 Risk Dashboard。

PHASE 4A

销售 CRM

Lead → 联系 → 意向产品 → 跟进 → 报名 → 付款 → 复购；客户标签、跟进记录、渠道来源、销售漏斗、会员关系、B 端机会。

PHASE 4B

营销平台

内容资产 → Campaign → 公号/视频号/小红书/私域 → 触达 → 报名归因；内容日历、素材库、来源、会员运营、社群任务。

PHASE 4C

客户服务与知识

Product Facts + Operational State + Customer State → AI 客服；自动识别何时必须读取实时数据或转人工确认。

PHASE 5

AI 自动化 / 决策平台

AI 产品录入、公众号与 TourEvent 双向投影、内容生产、Video Decision Platform、智能运营提醒、CRM 助手、经营分析。

系列知识内容平台与 AI 批量生产（新增规划）

这是统一用户入口的内容产品能力，分阶段进入整体路线，不属于当前 Sprint 01。栏目 / 专栏可连续更新文章、播客音频与视频；内容页可连接游学 / 课程报名、优惠权益与服务交付。

短期 · Core 稳定后

内容平台 MVP

在现有 CMS / OSS / Content API 上定义 Series、Episode、Content Item、顺序、格式、发布状态和排期；小程序补系列入口、feed、详情与分享。第一版用人工审校和发布，把内容消费、报名跳转与后台维护跑通。

中期 · 编辑效率

AI 批量草稿、栏目日历与审核队列

按周期生成批次内容草稿包（选题、文章 / 播客脚本、音视频任务、来源与版权记录），提供人工退回 / 批准；定时任务可生成草稿或发布已批准内容，但不能绕过人工审校。

长期 · 用户习惯与增长

小程序成为内容与服务的统一入口

系列关注、收藏、继续阅读 / 收听、更新提醒和内容发现，与游学 / 课程报名、支付、会员优惠、订单、出行资料、签到与履约管理衔接。使用合规汇总数据改进选题和推荐，不复制用户、订单或会员事实。

路线约束：先完成内容目录与消费体验，再自动化生产；具体日期、预算和技术选型待后续决策。内容平台属于整体系统边界，但不会自动进入 Sprint 01。

未来后台一级模块建议

产品中心
Product Record / 上架 / 资产
交易中心
订单 / 支付 / 退款 / 发票
履约中心
团状态 / 合同 / 签证 / 物料 / 签到
客户中心
CRM / 会员 / 标签 / 跟进
内容中心
系列 / 单集 / 内容库 / 编辑日历 / 发布状态
营销中心
Campaign / 渠道 / 私域 / 转化归因
视频中心
Decision / Assets / Generation / Edit
数据中心
转化 / 复购 / 营收 / 履约 / 内容
系统中心
用户 / 权限 / 日志 / 配置 / MCP

18｜AI 辅助研发工作法：小景执行标准

CEO业务目标/验收
→
ChatGPT任务拆解/风险
→
Workbench / Repo分析代码
→
实施最小修改
→
MCP / API真实验证
→
体验版真机
→
CommitChange Log / Rollback

每个任务必须回答

问题是什么？在哪个环境？如何复现？
业务规则是什么？谁确认？
数据事实源在哪里？
涉及哪些文件、API、状态？
修改范围是什么？明确“不做什么”。
本地 / API / Admin / 小程序怎么验收？
写入是否可逆？是否需要 CEO 授权？
Commit / Tag / Change Log / 回滚点在哪里？
Sprint 01 例外本次 Sprint 不按“3–5 个功能结果”收口，而按 Bug 清单清零 收口：v1.4 中保留的原始 31 项全部完成，并通过两项工程/发布门禁。后续 Sprint 再恢复常规容量控制。

两周 Sprint

时间动作证据
Day 1Sprint Planning：冻结 3–5 个核心结果Task + 验收标准
Day 5/6Week Review：只 Demo，不报“80%”可运行结果 / logs / 截图
Day 10Sprint ReviewBuild / 真机 / Commit / Change Log / Rollback

19｜Handbook 治理：唯一母版与周级更新

TourEvent_Cave_Digital_System_Handbook.html 是当前唯一稳定版（v1.7 · 2026-10-07），作为洞穴数字系统长期事实与规划索引；文件名固定，版本变化通过 Change Note 记录。

SOURCE PRIORITY
事实优先级
生产/仓库证据 → 当前 MCP/Skill → 项目文件 → 已确认会议决策 → 规划。出现冲突不静默合并，明确标注并收口。
WEEKLY
周级扫描
每周检查“洞穴数字系统｜Sprint 开发”项目记忆与文件、各 Sprint 窗口中的架构/接口/部署证据及运营路线讨论，逐项区分已开发、待开发与待验证。
IN-PLACE
只更新这一份
版本号与日期更新，但文件名保持不变；新增 Change Note，不再创建 handbook-final-v2-v3 等平行文件。

每周更新规则

已开发 / 已上线：有代码、生产或验收证据才写入“当前可用”，记录真实入口/模块/验证状态。
待开发 / 规划中：记录已确认的目标与依赖，不伪装成现状。
待验证：缺少仓库、ECS 或验收证据时保留为待核验，不推断完成。
所有密码、Token、AppSecret、支付密钥、私钥和代理订阅永不进入 Handbook。
新 MCP/Skill：记录职责、调用场景、读/写/付费属性、依赖服务。
重要 Bug 修复：沉淀为数据契约、状态机、测试门禁或 SOP，而不是只记录“修过”。
运营/营销/销售新需求：先说明业务闭环、事实源和依赖，再进入研发路线。
每次周更在文末写 3–8 条 Change Note；无实质变化则不改内容。

本次 v1.4 Change Note

① Bug 修复清单正式升级为 v1.4，并保持原始 31 项作为 Sprint 01 清零主体；② E01–E07/F01 按 3032 Admin、Production API、OSS 与现有公众号导入链路重新定位；③ G01 构建/三端基线与 G02 真实交易生产回归升级为 Sprint 01 P0 Exit Gate；④ G03 付费课程内容访问控制定义为课程上线 P0，不强塞进本次体验版 Sprint；⑤ Sprint 01 固定为 Wave A P0+门禁 → Wave B 21 项 P1 → Wave C 4 项 P2+31 项全量回归。

v1.4 · 2026-10-06 Change Note

  • 恢复并固化此前已确认的 Skill / Plugin / MCP 三层模型与 gzh design Plugin v2.5.2 Workspace 分发案例。
  • 02 总体架构替换为最新生成的洞穴数字系统总架构图。
  • 08 MCP 与 09 Skills 为每个模块增加独立 Zoom-in 架构图，拆清输入、调用、真实系统、输出和安全边界。
  • Cave Video MCP 旧版与新版同时保留；新版可见 schema 已验证 TTS 模型 routing，ASR/识别 routing 由第22条 ECS 实机盘点确认。
  • 07 Workbench 增加操作技巧与独立架构图；22 改为 CEO 自行执行只读盘点，不再交给小景。

v1.5 · 2026-10-06 Change Note

  • 用第22条 ECS 只读盘点把 Production API、Admin、TourEvent 数据、MCP/Relay、V2Ray、备份与 Docker 状态从“待核验”升级为实机事实。
  • 明确 Production Admin 实际为 3001 且当前非持久化；3032 只保留为本地开发规范。
  • 纠正 Cave Video MCP：新版 17496 正常运行，当前无 ASR；旧版 17495 当前不运行但资产与 Nginx 残留保留，未经 CEO 决策不删除。
  • 明确研发边界：TourEvent Admin / 小程序 / 应用 API 代码由小景执行；CEO 可直接维护 MCP adapter、WeChat/Video Relay、V2Ray 及其专属基础设施。
  • 确认旧《工程文件说明》记录过 /Users/jhuis/Developer/TourEvent-weapp-local，当前 canonical path 以三端同步 Skill 为准；ECS 上未发现小程序 build 产物。

v1.7 · 2026-10-07 Change Note

  • 把“小程序内容与知识平台”纳入总体路线：系列 / 单集目录和已发布状态归 TourEvent Core；AI 选题、定时批量草稿与审校工作流归 Cave Intelligence；媒体文件归 OSS；小程序作为内容、交易、会员权益与履约统一入口。
  • 区分现状与规划：现有资料记录 CMS 内容资产库和小程序内容详情页；系列 feed、播客式连续消费、AI 批量生产和审核发布尚未核验为已上线。
  • 规划短期内容 MVP、中期 AI 批量草稿与人工审校、长期统一内容和服务体验；日期、预算、实现方案待确认。
  • Sprint 01 范围与验收基线保持不变；详细任务、状态和证据由“洞穴数字系统｜Sprint 开发”项目的专属窗口与执行文件维护，Handbook 不复制 Sprint 任务清单。
  • 产品创建链路改为 ChatGPT 生成唯一 canonical Product Package，经 TourEvent MCP Validate / Create Draft 写入 PIM 草稿箱；移除旧公众号 URL 导入路径。
  • 字段/API 映射实验及复测证据统一归第 12 节 Product Record；删除 Voicebox Skill 介绍，更新 Sprint 项目协作口径。
  • 删除 Handbook 内 Sprint 01 任务清单；原第 22 节改为第 21 节 ECS 缺失事实回传清单，不再分派基础服务修正。
  • CEO 于 2026-10-07 确认本候选稿回填唯一稳定版，v1.7 生效。

v1.6 · 2026-10-06 Change Note

  • 确认微信小程序源码、调试与构建均在本地完成，通过微信开发者工具上传至微信开发平台；ECS 不承载小程序源码或 dist/weapp，只通过 Production API 提供业务数据。
  • 将“小程序 build 来源确认”从第22条小景基础服务修正清单中移除，ECS 未发现 dist/weapp 不再视为缺失项。
  • 固化 Admin 双环境口径：Local Admin 使用 3032；Production Admin 当前实际运行于 3001。该差异是环境约定，不作为端口修正任务。

20｜Sprint 项目协作：CEO × 小景

当前研发协作项目为 “洞穴数字系统｜Sprint 开发”。Sprint 的范围、任务状态、根因、修复路径、验收和证据由该项目及对应 Sprint 窗口维护；Handbook 定期吸收经核验的长期事实、边界和路线。

OWNER
CEO
确认业务优先级与规则、批准具体生产操作、最终验收并确认稳定版 Handbook 回填。
ENGINEERING
小景
按 Sprint 基线实现 TourEvent Admin、小程序与应用 API 的任务，回传代码、构建、回归和验收证据。
SPRINT PROJECT
一 Sprint 一窗口
共享项目记忆、指令与文件；每个 Sprint 独立讨论和收口，不跨 Sprint 自动扩展范围。

项目协作约定

环节当前规则
项目与聊天项目名为“洞穴数字系统｜Sprint 开发”；每个 Sprint 一个聊天窗口，按“Sprint NN｜主题”命名。当前 Sprint 01 窗口为“Sprint 01｜TourEvent Core 两周迭代”。
基线文件对应 Sprint 执行与验收文件、总体边界架构和当前 Handbook；Sprint 01 项目资料含《TourEvent_Core_Sprint_01_两周迭代执行与验收.html》与《系统边界基线摘要｜2026-10-06》。以证据决定状态。
每个 Sprint 的记录需求/问题、范围、复现、根因、修复路径、验收结果、证据链接和状态；代码已提交或本地构建不等于验收通过。
边界与授权小景负责 TourEvent Admin、小程序和直接耦合的应用 API；CEO 可维护 MCP / Relay 等独立接入层。生产写入、真实支付/退款测试或生产重启须按具体动作授权。
Handbook 更新周期性读取 Sprint 项目记忆与文件，区分已开发、待开发、待验证；后续长期架构和已验收事实先进入版本候选稿，并附完整增改清单；CEO 确认后再回填唯一稳定版。
分层记录：产品字段契约、API 映射实验和复测结果统一写入第 12 节 Product Record；Sprint 项目管理当前迭代执行；ECS 尚缺的运行事实按第 21 节清单回传。Handbook 是长期事实索引，不替代 Sprint 项目板或验收记录。

21｜ECS 已核验基线与缺失事实回传清单

第 06 节保存截至 2026-10-06 的 ECS 已核验资产与运行基线。本节只列补全 Handbook 尚缺的 ECS 事实与证据，不是服务修正清单，也不分派工程任务。Product Package 字段/API 实验统一记入第 12 节，不放入本清单。

需要从 ECS 回传的事实

01 · RUNTIME
Production Admin 启动与持久化
需回传：当前 :3001 进程的 unit / process manager、ExecStart、WorkingDirectory、重启策略、开机启动状态、健康检查与日志来源；若没有正式 unit 或无法核实，明确标记。
只读证据：unit/status、进程与监听端口快照、对应日志时间戳。不要求执行重启。
待回传
02 · DATA SAFETY
TourEvent 数据备份链
需回传：db.json 与 registration archives 的备份范围、触发方式/频率、目标路径、保留期限、最近成功时间、完整性检查与恢复验证证据；若未配置或无证据，明确写出。
只读证据：timer/cron 状态、备份文件元数据与时间、脱敏的校验记录。不执行生产恢复。
待回传
03 · ENVIRONMENT
TourEvent 环境变量加载顺序
需回传：systemd EnvironmentFile 与工作目录 .env 是否都会加载、加载优先级及实际使用的变量名；不得回传变量值。
只读证据：相关 unit 片段、配置文件存在性、加载代码/配置位置或脱敏变量名清单。
待回传
04 · NETWORK
Nginx 生产路由映射
需回传：Admin、Production API、WeChat Relay 的 server/location/proxy_pass 对应关系，特别是 location / 的实际命中范围、域名与路径条件。
只读证据：仅相关 server/location 配置片段及 upstream/监听信息；移除证书私钥等敏感内容。
待回传
05 · RELEASE
当前发布版本来源
需回传：API 与 Admin 活动 release 的真实路径、source commit 或 artifact checksum、部署时间、上一版本/回滚位置；如果没有版本记录，明确标记缺失。
只读证据：current symlink 解析结果、构建/部署元数据或发布记录及时间戳。
待回传
06 · CONTAINERS
Exited Docker 容器身份与依赖
需回传：第 06 节记录的 3 个 Exited 容器名称、镜像、用途、创建时间、挂载卷/网络，以及是否关联持久数据或当前服务；无法确认用途时标“未知”。
只读证据：脱敏后的容器 inspect 摘要，重点保留状态、镜像、挂载点与网络，不回传环境变量值。
待回传
回传格式：每项标注“已确认 / 未配置 / 无法核实”，附只读证据和采集时间。仅提供支撑 Handbook 事实所需的脱敏配置与状态，不回传密码、Token、AppSecret、支付密钥、私钥、代理订阅或任何环境变量值；没有证据时保持“待验证”，不推断为已完成。