# 团队能力补齐方案调研报告

> 旺达 · 调研专家 · 2026-07-23 | v2.0（北极星审核后修订）
> 为魔形女撰写能力文档提供素材，博士部署参考

---

## 📌 结论摘要

全队5个角色共识别 **26个能力缺口**，经多轮调研，所有缺口均有可行方案。按实施优先级分为三类：

- **🔴 高优先级（本周可落地）**：自动化质检脚本、ETSY禁词校验、库存管理工具、Nginx优化
- **🟡 中优先级（1-2周）**：视频自动化质检、视觉质检工具、任务追踪面板、多平台发布工具、运维监控、图像生成接入
- **🟢 低优先级（后续迭代）**：产品设计可视化、水晶真伪检测、专业数据库直连、AI视频生成

---

## 📊 全队缺口总览

| 角色 | 缺口数 | 核心需求关键词 |
|:----|:------:|:--------------|
| 🦎 魔形女 | 5 | 调研工具 · 视频质检 · 多平台发布 · 小红书分析 · 英文写作 |
| 💚 北极星 | 5 | 质检模板自动化 · 视觉质检工具 · 产品设计可视化 · 库存管理 · 质检历史看板 |
| 📦 博士 | 4 | 运维监控 · 批量工具 · 任务追踪 · Nginx优化 |
| 🖤 幻视 | 6 | AI视频生成 · 自动化质检 · BGM库 · 素材管理 · 字幕增强 · 模板系统 |
| 🌸 旺达 | 6 | 专业数据库 · 可视化 · 知识库索引 · PDF批量 · 多模态输入 |
| **合计** | **26** | — |

> 各角色缺口均以**正式提交的最终版**为准，多轮提交中的重复需求已合并去重。

---

## 🔴 高优先级方案（5项）

### 1. 自动化质检脚本（北极星#1 + 幻视#2）

**覆盖角色：** 北极星、幻视  
**优先级：** 🔴 高 | **难度：** 🟢 低

**需求：** 上传文案 → 自动出检测报告（禁词、结构缺失、AI味嫌疑句）

**方案：** `qa-check.sh` 脚本 + HTML报告

**实现方式：**
- **核心逻辑**：Python脚本，接受文本输入（文件/管道/stdin），输出结构化JSON+HTML
- **检测项**：
  1. ETSY禁词库匹配（heal/cure/treat/therapy/attunement/binding等 → 标红）
  2. 5层结构完整性检查（钩子→视觉→能量→搭配→收尾，缺层提示）
  3. AI味词汇命中检查（unleash/embark/elevate/delve/resonate等高频AI词 → 标黄）
  4. 能量比喻句字数统计（超20词提示精简）
- **输出**：HTML报告（绿色=通过，黄色=警告，红色=不通过）

**关键技术：**
- Python `re` 正则匹配敏感词库
- HTML模板渲染报告（手机友好）
- 可集成到deploy-verify.sh流程中

**实施：** 博士写Python脚本 + 北极星提供禁词库 → 一次性工具，后续维护词典即可

---

### 2. ETSY禁词+结构自动校验（北极星#1）

**覆盖角色：** 北极星、魔形女  
**优先级：** 🔴 高 | **难度：** 🟢 低

**需求：** 上传文案标红违禁词、标注结构缺失

**方案：** Python敏感词扫描脚本

**ETSY水晶/玄学类禁词库（调研结果）：**

| 类别 | 禁词 |
|:----|:-----|
| 🚫 **医疗声明** | heal, cure, treat, therapy, medical, diagnose, prevent, remedy, prescription |
| 🚫 **玄学服务** | spell, spellcasting, reiki, distance healing, attunement, binding, activation, ritual, hex, curse |
| 🚫 **结果承诺** | guarantee wealth, attract love, gambling luck, weight loss, legal outcome, relationship fix |
| 🚫 **违禁物品** | alcohol, tobacco, drug, weapon, explosive, hazardous material |

> **注意：** `prayer` 未被列入禁词库——`prayer beads`（念珠）在首饰描述中为常见合法用词。ETSY政策允许销售水晶/草药/魔法书等实物，但**不能**宣称有玄学效果。文案中描述水晶的能量属性时需用"intention"、"energy"、"vibration"等许可词，避开上述禁词。

**实施建议：** 与#1自动化质检脚本合并实现，作为其中一个检测模块。

---

### 3. 库存与定价管理工具（北极星#4）

**覆盖角色：** 北极星、魔形女  
**优先级：** 🔴 高 | **难度：** 🟢 低

**需求：** YOGLOW 66个SKU的库存+定价管理

**方案A（推荐）：飞书多维表格**
- 无需部署，零成本
- 魔形女录入数据，北极星查询
- 支持筛选/排序/公式计算

**方案B：sqlite + HTML看板**
- 更结构化，支持本地脚本查询
- 博士写一个 `inventory-viewer.py` 出HTML

**建议字段：**
```
SKU | 品名（中/英） | 分类（原星光/新品） | 进货价 | 建议售价（3-5倍） | 实际售价 | 库存量 | 已售 | 状态（在售/售罄/下架）
```

---

### 4. Nginx热部署优化（博士#4）

**覆盖角色：** 博士  
**优先级：** 🔴 高 | **难度：** 🟢 低

**现状：** 文件更新后 cp → mv → nginx reload 三步

**方案：** 配置nginx直接读取新文件，利用符号链接热切换

```nginx
# 方案：使用符号链接指向当前版本目录
# 更新流程简化为: 生成新文件 → 修改符号链接指向 → ln -sfn /var/www/geo/v2 /var/www/geo/current
# nginx 配置 root /var/www/geo/current/reports/;
# 无需 reload，符号链接切换是原子操作
```

**或者：** 配置proxy_cache_bypass + 版本号参数让nginx直接读新文件

---

### 5. 质检历史看板（北极星#5）

**覆盖角色：** 北极星  
**优先级：** 🔴 高 | **难度：** 🟢 低

**需求：** 质检记录按时间倒序排列，每条标注：内容标题 → 类型（文案/视频/部署）→ 审核结果（通过/驳回/修改）→ 日期

**方案A（推荐）：飞书多维表格（与任务追踪合并）**
- 零部署，北极星可直接操作
- 字段：内容标题 | 提交人 | 类型 | 提交时间 | 审核结果 | 审核人 | 备注 | 审核日期
- 按审核日期倒序排列，一眼看到最新审核记录
- 支持筛选（只看文案/只看驳回等）

**方案B：sqlite + HTML历史面板**
- 博士写 `qa-history.py` 生成网页版
- 可搜索、可筛选、可导出

**建议：** 先用飞书多维表格（与任务追踪/库存管理共用同一套表格体系），北极星设计好字段即可开始录入。

---

## 🟡 中优先级方案（8项）

### 6. 视频自动化质检（幻视#2 + 北极星#2）

**覆盖角色：** 北极星、幻视  
**优先级：** 🟡 中 | **难度：** 🟡 中

**需求：** 自动检测黑场/静音/码率异常/分辨率合规/品牌一致性

**方案：** `video-qc.py` 脚本（ffmpeg + ffprobe）

**检测项实现：**

| 检测项 | ffmpeg命令/参数 |
|:-------|:----------------|
| 黑帧检测 | `ffmpeg -i input.mp4 -vf blackdetect=d=2:pix_th=0.00 -f null -` |
| 冻结帧检测 | `ffmpeg -i input.mp4 -vf freezedetect=n=-60dB:d=2 -f null -` |
| 分辨率/码率 | `ffprobe -v quiet -print_format json -show_format -show_streams input.mp4` |
| 静音段检测 | `ffmpeg -i input.mp4 -af silencedetect=n=-50dB:d=2 -f null -` |
| 场景切换 | `ffmpeg -i input.mp4 -vf select='gt(scene,0.4)',showinfo -f null -` |
| 关键帧抽取 | `ffprobe` 获取视频参数后生成JSON报告 |

**输出：** JSON质检报告 + 失败项摘要

**幻视配合：** 幻视已有 `render_params.json` + keyframes 交付规范，可在此基础上增加QC参数

---

### 7. 视觉质检工具（北极星#2）

**覆盖角色：** 北极星  
**优先级：** 🟡 中 | **难度：** 🟡 中

**需求：** 对比"参考图 vs 实际图"的色差/曝光；视频帧抽样检查

**方案：ImageMagick + ffmpeg 脚本**
- 图片对比：`compare ref.png actual.png -compose src diff.png` 输出色差图
- 视频帧提取：`ffmpeg -i input.mp4 -vf fps=1/10 frame_%04d.jpg` 每10秒取一帧
- 白平衡/曝光检查：用ImageMagick的 `identify` 获取直方图

---

### 8. 任务追踪面板（博士#3）

**覆盖角色：** 博士、全队  
**优先级：** 🟡 中 | **难度：** 🟡 中

**需求：** 看谁在做什么、进度到哪了、当前状态

**推荐方案：Kanboard（自托管，Docker部署）**

| 特性 | 说明 |
|:----|:------|
| 部署方式 | Docker单容器 |
| 资源占用 | 极低（PHP+SQLite，256MB内存足够） |
| API支持 | ✅ 完整REST API + Webhook |
| 状态流转 | 自定义列（待认领→进行中→待审核→已通过/已驳回） |
| Webhook | 任务移动/创建时可通知飞书群 |
| 费用 | 免费开源 |

**替代方案对比：**

| 方案 | 优点 | 缺点 |
|:----|:----|:-----|
| **Kanboard** 🏆 | 轻量、自托管、API完整、webhook | 界面朴素 |
| 飞书多维表格 | 无需部署、全员可用 | 无API/webhook、状态流转弱 |
| 飞书任务 | 零部署 | 功能简略 |
| Wekan | 功能丰富 | 资源占用比Kanboard大 |

**建议：** 先用**飞书多维表格**零成本启动（博士设计品控状态流转），同时择机部署Kanboard Docker。

---

### 9. 多平台发布工具（魔形女#3）

**覆盖角色：** 魔形女  
**优先级：** 🟡 中 | **难度：** 🟡 中

**各平台发布可行性：**

| 平台 | 官方API | 自动化可行性 | 方案 |
|:----|:-------|:-----------|:-----|
| 微信公众号 | ✅ 有 | ✅ **可行** | 草稿箱API（draft_add→draft_publish），需AppID+AppSecret |
| 小红书 | ❌ 无 | ⚠️ 有限 | 无服务器端API，仅能用RPA/手动 |
| 抖音 | ⚠️ 创作者API | ⚠️ 有限 | 开放平台API需企业认证 |
| Etsy | ✅ 有 | ✅ **可行** | Etsy Open API v3（listing上传/更新） |
| Amazon | ✅ 有 | ✅ **可行** | SP-API（Selling Partner API）需开发者账号 |

**建议：**
- **Etsy/Amazon** → 用官方API自动化（优先级高，水晶业务主线）
- **公众号** → 用草稿箱API半自动化（博士写脚本，魔形女确认后发布）
- **小红书/抖音** → 保持手动，或装飞书插件辅助

---

### 10. 运维监控告警（博士#1）

**覆盖角色：** 博士  
**优先级：** 🟡 中 | **难度：** 🟡 中

**方案A（推荐）：cronjob + curl健康检查脚本**
```bash
#!/bin/bash
# health-check.sh - 每5分钟检查5个gateway
gateways=("gateway1:8080" "gateway2:8081" "gateway3:8082" "gateway4:8083" "gateway5:8084")
for gw in "${gateways[@]}"; do
    if ! curl -sf "http://$gw/health" > /dev/null 2>&1; then
        echo "[ALERT] $gw is DOWN at $(date)" >> /var/log/gateway-alerts.log
        # 可集成飞书webhook通知
    fi
done
```

**方案B：uptime-kuma（开源监控面板）**
- Docker部署，Web界面
- 支持90秒间隔HTTP检查
- 飞书/邮件/Webhook通知
- 资源占用低

**建议：** 先用方案A（5分钟写脚本），后续有需要再部署uptime-kuma

---

### 11. 图像生成接入（魔形女图像生成需求）

**覆盖角色：** 魔形女  
**优先级：** 🟡 中 | **难度：** 🟡 中

**方案：ComfyUI 本地部署 + API调用**

- **部署方式**：Docker本地运行（需要GPU）
- **API集成**：导出工作流为JSON → Python调用API生成
- **应用场景**：品牌页面配图、产品概念图、珠串效果预览
- **硬件要求**：NVIDIA GPU（至少6GB VRAM）

**替代方案（无需GPU）：**

| 方案 | 费用 | 说明 |
|:----|:----|:-----|
| DALL·E API | 按量付费 | OpenAI，质量高，无需GPU |
| Midjourney | $10-30/月 | Discord操作，品质最高 |
| Stable Diffusion WebUI | 免费 | 需要GPU，但可租云GPU |

**建议：** 先接入DALL·E API（最简单），后续有GPU资源再部署ComfyUI本地

---

### 12. 英文写作辅助（魔形女#5）

**覆盖角色：** 魔形女  
**优先级：** 🟡 中 | **难度：** 🟢 低

**方案：**
- 复用现有AI能力，针对Etsy/Amazon英文商品描述建立**写作模板库**
- 建立常见表达对照表（中文直觉 → 地道英文表达）
- 使用现有LLM的英文能力写初稿，魔形女润色

**建议**：不是技术工具问题，而是建立**英文写作模板+术语库**，储存在技能中

---

### 13. 小红书本地化分析（魔形女#4）

**覆盖角色：** 魔形女  
**优先级：** 🟡 中 | **难度：** 🟡 中

**方案：**
- 无官方数据API，只能靠网页爬取+人工分析
- 建议建立**小红书爆款笔记模板库**（标题/封面/正文结构/标签体系）
- 使用 `web_search` + `web_extract` 定期抓取竞品/同品类爆款

---

### 14. 批量工具（博士#2 — 书籍蒸馏半自动化）

**覆盖角色：** 博士  
**优先级：** 🟡 中 | **难度：** 🟡 中

**方案：** 编写 `book-distill.sh` 全流程脚本
```
输入：PDF链接/路径
流程：下载PDF → 提取文本 → 分段 → AI蒸馏 → 格式化输出 → 部署 → 同步入口
输出：蒸馏文档 + 部署链接
```
可复用现有book-distill skill，增加自动同步步骤

---

## 🟢 低优先级方案（后续迭代）

### 15. 产品设计可视化（北极星#3）

珠串搭配预览 → 2D色块排列示意图即可
- Python PIL/Pillow 合成色块排列图
- 输入：[主石颜色, 隔珠颜色, 配饰颜色, 排列顺序] → 输出水平排列图

### 16. 水晶图片真伪辅助检测（北极星早期提交项，已确认不作为正式缺口）

**难度：** 🔴 高 — 专业领域，无现成开源方案
- 北极星正式缺口清单中 **不包含此项**
- 保留在此作为参考：如需做，需要ML模型训练+专业设备
- **建议**：保持经验判断为主，不优先做技术投入

### 17. AI味检测辅助

改前vs改后差异高亮 → 简单 `diff` 工具即可：
```bash
# Python difflib 实现
python -c "
import difflib
before = open('before.txt').readlines()
after = open('after.txt').readlines()
for line in difflib.unified_diff(before, after):
    print(line)
"
```
或用 `diff` / `git diff` / HTML高亮差异（已有humanizer skill可配合）

### 18. 专业数据库直连（旺达#1）

统计局/住建局数据定期cron抓取入库，特定项目调研时针对性地手动采集效率更高

### 19. 历史调研知识库（旺达#4）

本地SQLite索引+全文检索，把已调研项目存档。每次新增调研后自动更新索引。

---

## 📋 实施路线图建议

### 第1周（高优先级）

| 日期 | 任务 | 负责人 | 产出 |
|:----|:----|:------|:-----|
| Day 1 | 自动化质检脚本 v1（禁词+结构+AI味） | 博士 | `qa-check.sh` + 禁词库 |
| Day 1 | 飞书多维表格任务追踪面板 | 博士设计 | 状态流转模板 |
| Day 2 | Nginx符号链接热部署优化 | 博士 | 配置更新 |
| Day 2 | 库存管理飞书表格 | 魔形女录入 → 北极星查 | 66个SKU入库 |
| Day 2 | 质检历史看板飞书表格 | 北极星设计字段 | 质检记录表 |
| Day 3 | ETSY禁词库完善 | 北极星 | 完整禁词JSON文件 |
| Day 3 | 运维健康检查脚本v1 | 博士 | `health-check.sh` |
| Day 4 | deploy-verify.sh集成质检步骤 | 博士 | 部署时自动触发QA |
| Day 5 | 全队走一遍新流程 | 全员 | 流程验证 |

### 第2周（中优先级）

| 任务 | 负责人 | 说明 |
|:----|:------|:-----|
| 视频质检脚本v1 | 博士 + 幻视 | 黑帧/静音/分辨率/码率检测 |
| Etsy API发布脚本 | 博士 | 商品自动上架 |
| 图像生成接入（DALL·E） | 博士配置 | 魔形女使用 |
| 书籍蒸馏半自动化 | 博士 | book-distill.sh |
| Kanboard Docker部署 | 博士 | 替代飞书表格（可选） |

### 后续迭代

- AI视频生成（需要GPU资源）
- 小红书分析（持续积累）
- 旺达知识库索引（有调研新项目时逐步建立）
- ImageMagick视觉质检（按需）

---

## 📊 关键数据来源与可信度

| 数据 | 来源 | 可信度 |
|:----|:----|:------|
| ETSY禁止词 | Etsy官方政策页 + 卖家经验 | ⭐⭐⭐ A级 |
| ffmpeg blackdetect/freezedetect | ffmpeg官方文档 + StackOverflow | ⭐⭐⭐ A级 |
| Kanboard特性 | Kanboard官方文档 + 用户评价 | ⭐⭐⭐ A级 |
| ComfyUI API | ComfyUI官方文档 + GitHub | ⭐⭐⭐ A级 |
| 微信公众号API | 微信官方文档 | ⭐⭐⭐ A级 |
| Etsy Open API | Etsy开发者文档 | ⭐⭐⭐ A级 |
| 小红书无API说明 | 开发者社区共识 | ⭐⭐ B级 |
| 产品设计可视化方案 | 合理推断 | ⭐ C级（待验证） |
| 水晶真伪检测方案 | 行业知识 + 合理推断 | ⭐ C级（待验证） |

---

## 🎯 调研建议总结

1. **先动手再买工具** — 大部分高优先级需求可以用Python脚本+现有工具链解决，不需要额外采购
2. **禁词库是核心资产** — 建立后就持续复用，所有文案/视频字幕都跑一遍
3. **飞书多维表格三合一** — 任务追踪 + 库存管理 + 质检历史，可以用同一个飞书表格体系，北极星设计字段即可
4. **视频质检分两步** — 先做黑帧/静音/分辨率检测（ffmpeg一行命令的事），品牌一致性审核保持人工
5. **图像生成是魔形女需求** — 现有素材库够用，DALL·E接入作为锦上添花

---

> 报告版本：v2.0（北极星审核后修订）  
> 调研完成：2026-07-23  
> 修订内容：统一缺口总数26项、北极星改为5项正式缺口、删去错误关联的任务追踪/图像生成、补上质检历史看板方案、移除prayer禁词  
> 下一版本计划：魔形女完成能力文档后，根据实际反馈迭代