@crabcloud/skills 0.1.23 → 0.1.25

package/dist/skills/crabcloud-atelier/SKILL.md

@@ -101,7 +101,7 @@ flags 的数组）判定：`styles`（款式库）、`records`（记录）、`ma
 | 建品类 | `crab atelier category create "连衣裙"`（同 org 重名 409；归档同名同样占用，恢复即可） |
 | 改品类 | `crab atelier category edit <id> --name 新名称`（撞名 409） |
 | 归档 / 恢复品类 | `crab atelier category archive <id>` / `crab atelier category restore <id>`（归档后建档选择器不再出，已录款式文本不受影响） |
-| 看款式库 | `crab atelier styles [--q 关键字] [--stage 核算] [--collection <id>] [--status active\|archived\|all] [--page N]`（默认只看在库；带阶段与状态计数） |
+| 看款式库 | `crab atelier styles [--q 关键字] [--stage 核算] [--collection <id>] [--status active\|archived\|all] [--page N]`（默认只看在库；--q 搜款号/品名/品类/色系；带阶段与状态计数） |
 | 看一款 | `crab atelier style <id>`（信息按组展示：01 基础信息 / 02 商品规格 / 03 生产信息 / 04 尺寸表〔部位 × 尺码矩阵 + 档差，尺码列随商品规格联动〕，+ 轮次时间线 + 最近事件，一次取全） |
 | 款式建档 | `crab atelier style create --code KH001 --name "羊毛大衣" [--category 大衣] [--collection <id>] [--designer ... --pattern-maker 纸样师 --sample-maker 车版师] [--retail-cents 199000] [--notes ...]`（款号唯一；归档系列不可挂）。**开款 ≠ 补录**：建档只收基本字段，色板/尺码/工艺开款后补录（Web 详情页分组编辑或下方 CLI flag 均可；建档时也可一并带上，见 `--colorways/--sizes/--craft-notes`） |
 | 归档款式 | `crab atelier style archive <styleId>` / `crab atelier style restore <styleId>`（幂等无删除；归档款详情仍可看，时间线落归档句） |
@@ -152,8 +152,8 @@ flags 的数组）判定：`styles`（款式库）、`records`（记录）、`ma
 ## 制单与生产（写闸 production）
 
 **制单 = 三态生命周期的投产通知单**（2026-10-09 定稿）：**未确认（草稿，可
-编辑）→ 确认（定稿：快照冻结、可打印工艺单）→ 作废（单向终态：不可打印、
-留档）**。只有已确认单据出 A4 工艺单（读确认时点快照、**不含任何金额**，
+编辑）→ 确认（定稿：可打印工艺单；数量矩阵仍可补录调整，改数量落时间线）→ 作废（单向终态：不可打印、
+留档）**。只有已确认单据出 A4 工艺单（**不含任何金额**，
 留档 + 给工厂）。标题默认「款式名 + 日期」可改。规格明细 = 「色板 × 尺码」
 矩阵：尺寸必有（款式未录尺码 400，先补商品规格）；色板可有可无（单色款不
 填色）。加工厂只收 factory 类型供应商（留空 = 自加工）；交期 = 预计交期。
@@ -170,9 +170,9 @@ tab 一键标记款式完成。**超量不拦（流水账语义）**：累计可
 代报时见到 ⚠ 先向用户复述确认再继续。Web 操作位置见 `references/web-ui.md`。
 **采购记录（2026-10-12 切片）**：细化 planning「一期不做独立采购单」——逐条
 台账挂已确认制单，**物料必须关联核算面辅料行**（`--material` = 核算行 id，须
-在该单确认时点快照清单内；名称/货号/规格/单位由服务端从快照带出，不自由填）。
+在本款核算清单内（随核算现行，含确认后新增的行）；名称/货号/规格/单位由服务端带出，不自由填）。
 `--amount-cents` = 实付金额整数分（非单价×数量派生）；到货两态单向（待到货 →
-已到货）。对账口径：应买 = 快照单件耗料 × 件数，差数即余缺。删除是金额录错
+已到货）。对账口径：用量 = 单件耗料 × 件数（物料随核算现行），差数即余缺（用量/已买/实付为 0 时输出省略该段，与 Web 0 值空白同口径）。删除是金额录错
 兜底（时间线留痕不撤）；Web 的「生产」tab = 采购/报数/入库合流（选单 + 工单头
   速览 + 三板块上下平铺：01 采购 / 02 报数 / 03 入库）。
 
@@ -181,13 +181,13 @@ tab 一键标记款式完成。**超量不拦（流水账语义）**：累计可
 | 看一款的制单 | `crab atelier orders <styleId> [--status draft\|confirmed\|voided]`（三态计数随行） |
 | 看一单 | `crab atelier order <orderId>`（标题 + 规格明细 + 工序报数累计 + 入库对账 + **采购对账与流水** + **报数/回货流水〔含色码矩阵〕** + 快照合计；orderId 见 orders） |
 | 建草稿 | `crab atelier order add <styleId> --breakdown "黑色:S=30,M=45\|米白:S=20" [--title 标题 --supplier <id\|前缀\|名称> --delivery 2026-10-20 --notes 备注]`（--breakdown 色码=件数：多色 `\|` 分段、`色:` 前缀；单色款直接 `"S=10,M=20"`） |
-| 改草稿 | `crab atelier order edit <orderId> [--title ... --breakdown "..." --supplier ... --delivery ... --notes ...]`（仅未确认可编辑） |
-| 确认定稿 | `crab atelier order confirm <orderId>`（快照冻结、可打印；定稿后不可再改） |
+| 改制单 | `crab atelier order edit <orderId> [--title ... --breakdown "..." --supplier ... --delivery ... --notes ...]`（草稿全量可改；已确认单仅 --breakdown 数量补录，落时间线） |
+| 确认定稿 | `crab atelier order confirm <orderId>`（可打印；定稿后不可再改） |
 | 作废 | `crab atelier order void <orderId>`（单向终态：不可打印、留档） |
 | 报数 | `crab atelier order log <orderId> --step 裁剪 --breakdown "S=10,M=20" [--defect 2 --note 备注]`（--step 须在单据工序列表内〔order 详情可看〕；--breakdown 按单据规格逐格报、总数服务端按格求和；次品 ≤ 总数） |
 | 登记回货 | `crab atelier order inbound <orderId> --breakdown "S=10,M=20" [--note 备注]`（本批按单据规格逐格填；分批多次；差数 = 未交尾数） |
-| 看采购台账 | `crab atelier order purchase <orderId>`（物料对账段：应买/已买/余缺/实付合计 + 采购流水） |
-| 记采购 | `crab atelier order purchase add <orderId> --material <costMaterialId> --qty 2.5 --amount-cents N [--supplier <id\|前缀\|名称> --note 备注]`（仅已确认单；--material 须在该单快照内〔order 详情可看快照物料〕；实付金额整数分） |
+| 看采购台账 | `crab atelier order purchase <orderId>`（物料对账段：用量/已买/余缺/实付合计 + 采购流水） |
+| 记采购 | `crab atelier order purchase add <orderId> --material <costMaterialId> --qty 2.5 --amount-cents N [--supplier <id\|前缀\|名称> --note 备注]`（仅已确认单；--material 须在本款核算清单内〔order 详情可看物料〕；实付金额整数分） |
 | 标记到货 | `crab atelier order purchase recv <purchaseId>`（待到货 → 已到货，单向不可逆） |
 | 删采购 | `crab atelier order purchase rm <purchaseId>`（金额录错兜底；时间线留痕不撤） |
 
@@ -200,7 +200,7 @@ tab 一键标记款式完成。**超量不拦（流水账语义）**：累计可
 - `crab atelier suppliers --json` → `{ suppliers: [...], total, page, totalPages, statusCounts, typeCounts }`
 - `crab atelier costing <styleId> --json` → `{ styleId, craftNotes, materials, processes, extras, totals: { materialsCents, processCents, extrasCents, totalCents } }`（行金额服务端算好；数量为毫单位 ×1000）
 - `crab atelier orders <styleId> --json` → `{ orders: [...], total, page, totalPages, statusCounts: { draft, confirmed, voided } }`；订单含 `title`、`orderNo`（款号-seq）、`breakdown`（色板→尺码→件数两级矩阵）、`steps`（工序列表）、`progress`（各工序报数累计）、`inboundQty`（累计入库）、`costingSnapshot`（确认时点冻结）
-- `crab atelier order <orderId> --json` → 制单全量视图（含快照三表 + totals + sizes/sizeChart + progress + inboundQty + `logs` 报数流水〔`qtyDone` 服务端按矩阵派生 + `breakdown`〕 + `inbounds` 回货流水〔同上〕 + `purchases` 采购台账 + `purchaseSummary` 物料对账〔`demandMilli` 应买/`purchasedMilli` 已买/`amountCents` 实付合计/`pendingCount` 待到笔数〕）
+- `crab atelier order <orderId> --json` → 制单全量视图（含成本三表〔物料随核算现行〕+ totals + sizes/sizeChart + progress + inboundQty + `logs` 报数流水〔`qtyDone` 服务端按矩阵派生 + `breakdown`〕 + `inbounds` 回货流水〔同上〕 + `purchases` 采购台账 + `purchaseSummary` 物料对账〔`demandMilli` 用量/`purchasedMilli` 已买/`amountCents` 实付合计/`pendingCount` 待到笔数〕）
 - `crab atelier order purchase <orderId> --json` → `{ purchases, summary }`（台账 + 对账一次取）
 - `crab atelier records --json` → `{ records: [...], total, page, totalPages }`（type 含 inbound = 回货入库事件）
 - `crab atelier audits --json` → `{ events: [...], total, page, totalPages }`（事件含 `action`/`actorName`/`actorType`〔agent = 令牌动作〕/`meta`；仅 owner 令牌可查）

package/dist/skills/crabcloud-short/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: crabcloud-short
+description: Short-drama studio via the `crab short` CLI — create series, episodes (with editable scripts), a subject library (characters/scenes/props with appearance prompts and generated-image references), and two-level storyboards (scenes → shots with shot size, camera move, dialogue, duration, image/video prompts, subject links). Built as an AI production workbench: agents read the series bible and write scripts/storyboards back. Use when the user asks anything about their short-drama studio: 短剧、剧目、剧集、分集、剧本、分镜、场、镜头、景别、运镜、主体库、角色、场景、道具、生图、prompt、美术风格、发布、制作状态、工作台 — even if they never say "crab".
+---
+
+# Short 短剧工作室（crab short）
+
+短剧团队的制作工作台：**剧（series）→ 集（episode）** 是唯一主轴。剧挂基础
+档案（对外展示）+ 制作信息（背景设定/总体大纲/美术风格指导，内部）；集挂
+剧本（可反复改的可编辑文档，无版本表）与分镜；**主体库（角色/场景/道具）挂
+剧、跨集复用**；分镜两级——场（sequence）→ 镜头（shot：画面/动作/台词 +
+景别/运镜 + 时长 + 图视频 prompt + 主体关联）。独立产品 Short，同一套 REST
+API 服务 Web 与 CLI。
+
+跨域时参考：云盘 `crabcloud-storage`（成片/素材同库）、邮件 `crabcloud-mail`、
+协作 `crabcloud-collab`、店铺 `crabcloud-shop`、平台账号 `crabcloud`。
+
+## AI 制作约定（生图/生视频输入怎么拼）
+
+生成图像时按此顺序拼接 prompt，保证全剧视觉一致：
+
+1. **剧级美术风格指导**（`short series show <id>` 的 `styleGuide`）；
+2. **主体外观提示词**（`short subjects <seriesId>` 里关联主体的 `appearancePrompt`）；
+3. **镜头生图 prompt**（shot 的 `imagePrompt`）。
+
+生成结果用 `--image <素材对象id>` 挂回主体或镜头留痕（素材在云盘「短剧制作」
+分类一本账；上传走 crab storage upload 拿对象 id）。生视频同理
+（`videoPrompt` / 镜头结果）。
+
+## 第一步：确认可用
+
+- 运行 `crab --version` 确认已安装。`crab` 命令缺失时先 `npx @crabcloud/cli init`
+  （只登录 + 装 skill、不含命令本体）；已装但缺 `short` 命令用
+  `npx @crabcloud/cli@latest init` 升级。不想装全局则整段跳过，下文所有
+  `crab <命令>` 直接 `npx @crabcloud/cli <命令>` 等价执行。
+- `crab whoami` 报「未登录」或退出码 3 → 引导用户 `crab login`。**实际授予集
+  由人定**——登录后先 `crab whoami` 核对 scopes。
+- 永远不要让用户把 token 粘贴进对话；凭证文件与你无关，也不要读取它。
+
+short 命令需要 **short scope** 的令牌：`crab login --scopes short`（绑定工作
+室加 `--org org:<名称>`；未绑定也能用——组织级命令用 `--org org:<名称>|id`
+指定，只在一个工作室时自动采用）。
+
+退出码：0 成功 · 2 用法错误 · 3 认证失效 · 4 scope 不足 · 5 不存在 · 7 配额。
+
+## 剧与分集
+
+| 意图 | 命令 |
+|---|---|
+| 看工作室概览 | `crab short stats`（剧目/分集计数） |
+| 建剧 | `crab short series create "剧名" --genre 都市 --logline "一句话" --audience 女频 --episodes 60` |
+| 剧目列表 | `crab short series [--status draft\|published\|archived\|all]` |
+| 剧详情 | `crab short series show <id>`（基础档案 + 制作信息 + 集数进度） |
+| 编辑剧 | `crab short series edit <id> [--logline … --outline … --style … --status …]`（给的 flag 才改） |
+| 填制作信息 | `--background`（世界观背景）`--outline`（总体大纲）`--style`（美术风格指导）——内部文档，不进对外档案 |
+| 分集列表 | `crab short episodes <seriesId>` |
+| 新建分集 | `crab short episode create <seriesId> --title "第1集"`（seq 自动顺延） |
+| 写剧本 | `crab short episode edit <id> --script "…"`（整体替换；修改是常事，直接覆盖） |
+| 推制作状态 | `--prod-status outline\|scripting\|prep\|shooting\|post\|ready` |
+| 发布 | `--published on`（要求 prod-status 先到 ready，否则 409 not_ready） |
+| 下架 | `--published off`（已发布的集要先下架才能降制作态，否则 409 published_downgrade） |
+| 删集 | `crab short episode rm <id>`（分镜一并删除，不可恢复） |
+
+剧状态：`draft → published → archived`。归档不是删除——archived 剧的内容
+只读（内容字段有实际改动即 409 series_archived，原样保存不算改动），唯一
+出口是 `series edit <id> --status draft|published` 改回来。
+
+已发布的集要降制作态，先 `--published off` 下架再改——保持「已发布」的同时
+降级会被拒（409 published_downgrade），避免产出「僵尸已发布」集。
+
+## 主体库（挂剧，跨集复用）
+
+| 意图 | 命令 |
+|---|---|
+| 列主体 | `crab short subjects <seriesId> [--kind character\|scene\|prop]` |
+| 建角色/场景/道具 | `crab short subject create <seriesId> "名字" --kind character --prompt "外貌/服装/气质"` |
+| 补声音设定 | `--voice "低沉沙哑"`（角色用） |
+| 编辑 | `crab short subject edit <id> [--prompt … --voice …\|clear --image <素材id>\|clear]` |
+| 挂生成图 | 先 `crab storage upload 图片` 拿对象 id → `subject edit <id> --image <对象id>` |
+| 删主体 | `crab short subject rm <id>` |
+
+同剧同类型重名 409 name_taken。`--prompt` 是生图输入的核心——写具体
+（画风/外貌/服装/气质），生成时与剧的 styleGuide 拼接。
+
+## 分镜（场 → 镜头，挂集）
+
+| 意图 | 命令 |
+|---|---|
+| 看整树 | `crab short board <episodeId>`（场→镜头一次取全，写分镜前的必读物） |
+| 添加场 | `crab short sequence create <episodeId> --title "天台·夜"`（场号自动顺延） |
+| 改场 | `crab short sequence edit <id> --title "…"` |
+| 添加镜头 | `crab short shot create <sequenceId> --desc "画面" --size 特写 --move 固定 --duration 8 --dialogue "…" --subjects su_x,su_y` |
+| 镜头 prompt | `--image-prompt`（生图）/ `--video-prompt`（生视频）；镜号自动顺延 |
+| 编辑镜头 | `crab short shot edit <id> [同 create 的 flags]`（给的 flag 才改；--subjects 整组替换，clear 全摘） |
+| 删场/删镜 | `crab short sequence rm <id>`（含场内镜头）/ `crab short shot rm <id>` |
+
+镜头字段：`--desc` 画面描述、`--action` 动作/表演、`--dialogue` 台词、
+`--size` 景别（远景/全景/中景/近景/特写…自由文本）、`--move` 运镜（固定/推/
+拉/摇/移/跟…）、`--duration` 预估秒数、`--subjects` 关联主体 id（服务端校验
+同剧归属，非本剧主体 400 invalid_subject）。
+
+## 典型工作流（从零到一部剧）
+
+```
+crab short series create "剧名" --logline "…" --style "赛博朋克霓虹夜景，高对比"
+crab short subject create <id> "林晚" --kind character --prompt "25岁女性，黑色皮衣，冷白皮"
+crab short episode create <id> --title "第1集"
+crab short episode edit <epId> --script "第一场…" --prod-status scripting
+crab short sequence create <epId> --title "天台·夜"
+crab short shot create <seqId> --desc "林晚回望城市" --size 中景 --move 推 --duration 6 \
+  --subjects su_x --image-prompt "林晚立于天台边缘回望，霓虹倒影"
+# 生成图后：crab storage upload 生成图 → crab short shot edit <shotId>（web 挂接亦可）
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crabcloud/skills",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "type": "module",
   "description": "Crab Cloud agent skills (SKILL.md) with a standalone installer — teach coding agents to operate the user's personal cloud via the crab CLI.",
   "bin": {