使用指南（公网版 · 客户/会员）
本文档面向平台注册用户（会员）：注册、登录、上传自己的素材、在 WorkBuddy 里剪辑成片、查积分与消耗、邀请好友。
员工后台（审核/发布/打标/生成）的操作说明见内部文档，不在公网展示。
一、你能做什么
- 注册与登录：用邀请码注册账号；上传素材前需阅读并同意协议。
- 上传素材：上传你拥有合法权利（实拍或已获授权）的照片/视频。AI 生成内容必须标注，不得冒充实景。
- 云端剪辑：在 WorkBuddy 里用自然语言发起剪辑，云端自动拼剪竖屏短视频 + 配音 + 字幕，成片下载 24 小时有效。
- 选素材优先选视频：剪辑成片以视频素材为主。
list_materials支持按类型筛选（type=video）；如果剪辑卡里提示「全部为图片素材」，说明本次选片没有视频，成片会是图切/推镜效果——回到素材列表补选视频再确认。 - 积分：素材通过服务端校验并入库后获得积分，积分只用于抵扣剪辑消耗，不可提现、不可转赠、有有效期。
- 邀请好友：生成你自己的邀请码；好友注册后成为你的直接下级，其付费积分实际消耗的 10% 记为你的佣金（当前仅展示，不提现）。
二、注册与协议
1. 向平台索取邀请码（6 位大写字母+数字，不区分大小写）。
2. 打开注册页，填写称呼、账号、密码、邀请码，主动勾选服务协议、隐私政策与积分规则（勾选项不会预选）。
3. 注册完成即自动登录，进入账户页。
协议为履约需要会留痕（账号、协议版本、同意时间）。注册同意不等于上传授权；本人应在上传授权协议页同意当前版本，授权按账号复用，无需复制上传授权凭证。每份素材仍须确保具有合法权利。
三、上传与积分规则
超过 50MB 的素材，请在本地先切割成几段再上传 —— 不要把一整段长视频直接传上来。原因有三：
- 本平台的剪辑是按单段 5–10 秒取材的，一段几十秒的长镜头最终也要被切开；
- 大文件上传慢、审核慢，还容易在弱网下中断；
- 超限文件会被服务端直接拒绝，白白浪费你的上传时间。
切割建议：用剪映 / PR / ffmpeg 按镜头切开，每段保留完整动作，不要从镜头中间截断；导出 1080p 即可，不必上传 4K 原片。
当前上限：图片 ≤ 50MB，视频 ≤ 50MB。用 WorkBuddy 上传时，超过约 50MB 的文件必须走直传工具 presign_upload + confirm_upload，不要用 upload_material 的 base64 方式（那个通道只适合小文件）。
- 图片：jpg / jpeg / png / webp / gif / heic（DJI/手机原图直接传，不用转格式）
- 视频：mp4 / mov / webm（DJI 航拍 mov 可直接传）
- 音频：mp3 / m4a / wav；字幕：srt / vtt；脚本/文档：txt / md / json / pdf / docx
- 不支持：svg、html、htm（安全原因禁用）；改扩展名伪装无效（服务端读文件头嗅探真实格式）
视频规格：时长 3 秒–10 分钟；分辨率短边 ≥ 480px（1080p 即可，不必 4K）。
上传节奏：同一账号一次只能上传一条（串行）——批量上传请等当前这条完成再传下一条；频率上限每小时 1000 条 / 每天 10000 条（正常批量传不会撞到）。
常见报错对照（看错误文本对号入座）：
file too large→ 超过 50MB，本地切割后再传unsupported file type→ 格式不在支持清单，转成 mp4/jpg 再传一次只能上传一条→ 串行规则，等当前上传完成再传地点声明无效，请填写真实地名→ 地点栏填了「无人机/航拍/文件名」等非地名，改填真实拍摄地（城市/景点），不确定可留空（系统会用 GPS 自动推断）- 长时间停在「审核中」→ 正常排队，AI 审核按顺序消化，无需重传
素材入库后会经过服务端技术校验、近重复分析与 AI 合规/地点核验，合格后按档位发放积分：
- 图片：固定积分档位。
- 视频：按服务端识别的真实时长落档。
以下情况不发奖：重复内容（同一份内容只奖励首位上传者）、技术规格不达标、观察期内出现异常信号、命中账号限额或全站预算、AI 核验未通过。
奖励先进入托管期，观察期内无新增异常会自动解冻；积分有有效期，优先消耗最早到期部分。积分不可提现、不可转赠。
四、积分状态怎么看
- 可用余额：现在可以用于剪辑的积分。
- 任务冻结：进行中的剪辑任务暂时占用，结束后多退少补。
- 奖励托管：刚获得的奖励仍在观察期。
- 即将过期：未过期余额中临近有效期的部分。
五、在 WorkBuddy 里接入（MCP）
可以直接这样问
- 「我现在还有多少积分？有多少被冻结？」
- 「我这个月用了多少积分？列一下最近的消耗。」
- 「我今天上传了多少素材？有多少成功了？」
- 「我上传素材总共奖励了多少积分？哪些还在托管？」
接入步骤
1. 在网页端登录你本人账号（密码只由你本人在网页输入，智能体不得索取、不得代填）。
2. 进入账户页的「WorkBuddy 接入令牌」→ 点「生成接入令牌」（令牌明文只显示一次，可随时撤销）。
3. 接入配置由本人完成：若 WorkBuddy 提供已确认的安全凭据设置入口，在该入口填写接入令牌；不要把账户页生成的含令牌提示词粘贴进普通聊天。智能体可以解释不含凭据的接入步骤，但不得索取密码或令牌。
3.1 WorkBuddy 云电脑与本机配置互不自动同步；如需两边使用，由本人分别在各自安全设置入口配置。不要经聊天转发令牌。没有安全配置入口或配置文件访问能力时，请联系运营协助，不绕过设备限制。
4. 也可以手动接入：点「复制 mcp.json」写入 ~/.workbuddy/mcp.json（Windows 为 %USERPROFILE%\.workbuddy\mcp.json），再重启 WorkBuddy 点「信任」本服务。可用 tools/list 核对当前账号实际可用的工具清单（以服务端返回为准）。
5. 令牌只保存在 WorkBuddy 配置里，不要截图、转发或粘贴到聊天中；怀疑泄露请回到账户页撤销并重新签发。
接入后能做什么
- 查积分与消耗：
get_my_credit_balance（可用/冻结/托管/即将过期）、list_my_credit_usage（按剪辑任务聚合的净消耗）、get_my_upload_stats、get_my_reward_stats。这四个只返回你本人的数据，不接受他人账号参数。 - 上传素材：优先用直传
presign_upload+confirm_upload（字节直接进对象存储，不经服务器中转，接近 50MB 也不会超时）；小文件可用upload_material，或队列上传enqueue_upload+get_upload_job/list_upload_jobs查进度。共享素材按当前工具说明提交地点、来源及评分字段，服务端仍会核验；个人素材无需本地 score。不要因本文更新就忽略工具的现行必填字段。 - 剪辑成片（剪辑卡流程，生成前必确认）：
create_edit_card建剪辑卡 → 卡面确认（素材清单/预计时长/预计积分（统一总数，不拆明细项）/口播稿与改写稿对照/字幕逐句/分镜时间节点/供给体检）→confirm_edit_card拿 confirm_token →create_edit_video（带 card_id + 版本 + token）→get_edit_video轮询 → 拿 24 小时签名的成片/字幕链接。要改内容用update_edit_card（版本 +1，需重新确认）。 - 剪辑卡供给体检（supply_check）：选片视频不足 2 条或视频总时长不足 10 秒时建卡会被直接拦下（不扣积分），先补传素材；所选素材场景单一时卡面会给出警告并推荐素材库内同目的地的其他场景素材，可用
update_edit_card把推荐素材一键加进卡。 - 失败不扣费：任务失败或被取消且没有成片产出时，已扣积分自动全额退回；历史失败任务的旧账也会自动清理退回。
- 找素材：
list_materials/get_material/search_materials_by_semantic（源素材对会员黑箱：不提供下载地址）。 - 按标签选片：
list_tags（category=destination/subject）先看可用地点与题材标签，再用search_materials_by_semantic或按tag_ids过滤list_materials。 - 邀请：
create_invite_link_qr生成你自己的邀请码/二维码（只生成当前身份本人的，参数不接受他人）。
上传素材：地点与标签怎么填
place（拍摄地点）只填真实地名——城市/区县/景点（如「广西河池巴马」「南宁市青秀区」「青秀山」）。禁止用标题前缀、拍摄方式或文件名冒充地点：「无人机」「航拍」「DJI_xxx」「GoPro_xxx」这类词不是地名，会被服务端护栏拒收并写入 tag_warnings 提示你重填。- 优先读素材自带定位（EXIF GPS）：DJI 无人机、手机实拍大多在文件里带拍摄坐标（约 24.41,107.03 = 广西河池巴马一带）。客户端能读到坐标就直接按坐标推断地点，别拿标题前缀猜。
- 不确定就留空：地点拿不准就不要填，让服务端做 AI 地理标注；乱填一个词反而会让素材进「待规范化」队列、拖慢入库。留空不处罚。
- 目的地也可以走
tags/tag_ids（destination 类标签，如tags:["云南","西江千户苗寨"]）；词库没有的新目的地先suggest_tags归一，或按create_tag带父级提提案。 - 题材/对象用
tag_hints（推荐）或tags：未知的非封闭题材词会自动进tag_claim，不再报 400。 - AI/数字人素材不能带拍摄地点（
origin=ai|digital_human时服务端忽略place）。
上传返回新字段：tag_claims / tag_warnings
服务端在上传响应里新增两个字段，老客户端看到可忽略，不会报错：
tag_claims：本次素材触发的未知词提案（含category、raw_name、status=pending/merged/promoted/rejected/expired）。只需展示「已为你登记 xx 为待审核标签」，不用用户操作。tag_warnings：服务端护栏/推断提示（含raw_name、reason）。若reason是地点类（如destination_claim_not_gate/garbage_place），说明你还没填真实地点或填了垃圾词，请改用真实地名重传。- 未知词进
tag_claims后不再报错；destination claim 只是提案，不能代替「必须有真实地点」的门禁，仍需用place或已有 destination 标签补一个真实地点。
安全边界
- 源素材（含你本人上传的）不提供下载地址，
/media对非员工账号一律拒绝——这是防搬运设计，不是故障。 - 成片与字幕是你自己的交付物，链接 24 小时有效，过期重新查询即可。
- 查询结果以平台实时数据为准；请勿依据对话记忆估算金额。跨月份查询时请明确给出日期。
六、常见错误与处理
| 提示 | 处理 |
|---|---|
| 邀请码无效/已失效 | 找发码人重新要一个（一次性使用，可能已用掉或过期） |
| 未同意协议 / consent_grant_required | 本人在网页同意当前上传协议，再用同一账号的 MCP 接入身份重试一次；不要向用户索要 consent_grant。仍失败则反馈运营。 |
| 积分不足 | 先上传合格素材获积分，或联系平台充值（见第七节） |
| 素材不可用 | 素材可能已下架或未通过校验 |
| 登录/凭据失效 | 令牌过期或被撤销，回网页重新签发 |
| 时长未知无法报价 | 素材缺少时长信息，补全后重试 |
| 素材供给不足 | 所选视频不足 2 条或总时长不足 10 秒；补传/补选该目的地视频素材后再建卡 |
| 需要剪辑卡 / card_required | 生成前必须先建剪辑卡并确认；把 confirm_token 一并传给 create_edit_video |
| 脚本与素材语义不匹配 | 文案说的内容素材里没有；换素材或改文案后重新确认 |
| price_points_required | 文案/发布语出现价格表述但 price_points 为空；价格只能由你输入，系统不编造 |
| tag_warnings 提示地点类（destination_claim_not_gate / garbage_place） | place 里放了非地名词（无人机/航拍/DJI_ 之类）或没填真实地点。改成真实地名（城市/区县/景点）后重传；地点拿不准就留空，走 AI 地理标注 |
| tag_claims 里出现待审核标签 | 正常现象：你提的词还没进词库。平台后台归一，无需你操作，素材不受影响 |
七、充值与支付
在线支付暂未开放。 当前积分通过上传合格素材获得，或由平台线下收款后人工入账（需与平台运营确认金额）。本平台不会向你收取在线支付费用。
八、佣金（只读展示）
- 佣金按被邀请人实际消耗的付费积分的 10% 计提，仅展示「总计/已结算/未结算」，单位为元。
- 佣金不进入积分余额，也不能提现；「已结算」是结算状态，不是已打款。
- 充值赠送、上传奖励、免费积分不计入佣金基数。
九、联系方式
投诉与反馈渠道由平台运营在上线前配置。若页面未显示具体联系方式，请通过你获取邀请码的渠道联系。
更新时间：2026-10-29 ｜ 文档版本：live-upload-place-tags-20261027-v1 ｜ 版本：公网版（会员专用；员工/审核/老板操作说明见内部文档）