运营手册

v…

对内运营台用法。勿写入下载页或用户 CTA。

本页面向值班运营。用户手册见 help.html；安装见下载站。勿把本入口做成对外卖点。

入口

页面	app.noctis.world/admin（旧 `/ops` 会跳转至此；与夜界同域）
登录	账号 + 密码 → 会话约 7 天
API	`api.noctis.world/api/ops/*`

凭证由部署侧配置。登录若长期失败，联系部署负责人检查 Ops 账号是否已写入环境，勿在用户群公开排查细节。

侧栏模块

模块	做什么
片库换链	搜标题 → 替换 playUrl / clip；用户刷新即生效，免重打安装包
提交片源	kind / shelf / creatorType / 授权引用 / 上架与解锁
审前队列	pending → 通过 / 驳回；通过可进 works
封禁	按钱包地址封
收件箱	举报 + 被拍摄者移除申请
挖矿预算	只读查看发放池状态

成片与合规

先上传 cdn.noctis.world/library/…，再贴 https 地址
禁止第三方 tube / 未授权站直链当正片
mature 必须有可调取授权引用；官方/合作须公开标注
发布前过审前队列；禁止先上后审

网页手动 vs Agent

上传要 ops key。没有 token 是 401，路人不能传 mp4。单文件 ≤80MB。

网页	/admin → 换链「上传正片」或提交片源选文件
上传	`POST /api/ops/upload`（multipart `file`）
入库	`POST /api/ops/ingest`（JSON）

curl -sS -X POST https://api.noctis.world/api/ops/upload \
  -H "x-ops-token: $NOCTIS_OPS_TOKEN" \
  -F "file=@./master.mp4" -F "workId=work-ops-demo" -F "name=master.mp4"

脚本入库仍用 ./scripts/ops-ingest.sh '{…}'。登录会话与 token 同一套后台。

最短冒烟

打开 /admin → 登录
换链一条，或提交片源进审前 → 通过
用户端刷新 Feed / Watch，确认可播
（可选）收件箱拉取确认可见

冷启动换片

转码上传 CDN：library/{workId}/…
本台换链，或改静态底库后部署 app
用户刷新即可，不必重打壳