我也要上架
把自己做的碼舍角色包授權給商城販售。審核通過後,角色包會出現在目錄。商城是賣方,負責收款、客服與退款。
- 月結版稅每月結算,由商城匯給你
- NT$49最低訂價
- 審核擁有者審核後才上架
上架步驟
- 在碼舍做好角色包用小幫手的「角色設定」設定主圖、表情與說詞
- 用 Google 帳號登入商城不需要另外註冊
- 同意創作者授權合約你授權商城販售,商城是賣方,負責收款、客服與退款;版稅按月結算給你
- 上傳角色包 zip 並訂價訂價最低 NT$49
- 等擁有者審核審核通過後角色包會上架
上架規則
- 只收原創或已取得授權的角色。
- 只收全年齡內容。
- 角色包 zip 要能直接匯入碼舍。
- 上傳前要同意創作者授權合約。
上架清單
送審前確認每一項。商城會自動檢查角色包,沒達到的會列出原因。
- 名字與身分:character.json 的 name(名字,例如「顧總」)和 role(身分,例如「霸道總裁」),合計最多 40 字,顯示成「顧總(霸道總裁)」。名字加身分不能跟其他角色包相同。上架後要改,上傳新版本送審。
- 主圖:character.json 的 avatar 指向包內的 png、jpg 或 gif。
- 新格式:圖和動畫放在 actions 底下的 10 個動作,時機只寫說詞和要用的動作(action)。時機底下放圖或動畫的舊格式不收。
- 6 個必填時機:打開小幫手、送出問題、使用工具、等你按允許、回答完成、發生錯誤。每個時機用到的動作要有自己的圖或動畫(用主圖不算),至少 3 句說詞。
- persona(選填):最多 300 字。
- 素材:不能用碼舍預設角色的圖。
- 定價:NT$49 到 NT$199。上架後可以改,立即生效,不用重審。
- 原創或授權聲明:送審時聲明角色是原創,或已取得授權。
- 送審流程:上傳 zip,擁有者審核。核准後上架;退回時在創作者頁看得到原因,改好再上傳新版本。之後的新版本也要送審,審核期間照賣原本的版本。
- 審核時間:審核由擁有者人工進行,不承諾天數。
上架指南
角色包是一個資料夾:根目錄放 character.json,圖放在資料夾裡任何位置,路徑寫在 character.json。用小幫手的「角色設定」做好再儲存,就是商城收的格式。
修仙親傳弟子/ ├─ character.json ├─ avatar.png ├─ act/ │ ├─ wave.png │ └─ happy.png └─ anim/ └─ happy.png
把整個資料夾壓成 zip 上傳。character.json 放在 zip 根目錄,或包在一層資料夾裡都可以。
character.json
{
"name": "清玄",
"role": "修仙親傳弟子",
"avatar": "avatar.png",
"persona": "個性:修仙門派的親傳弟子,清冷沉靜。口頭禪:「謹遵師命」。",
"address": {
"user": "師尊",
"self": "弟子"
},
"actions": {
"wave": {
"image": "act/wave.png"
},
"happy": {
"image": "act/happy.png",
"anim": {
"sheet": "anim/happy.png",
"frames": 27,
"columns": 9,
"fps": 12.5,
"loop": false
}
}
},
"events": {
"greet": {
"lines": [
"{user},{self}在此候命。",
"{user}來了。",
"謹遵師命。"
]
},
"ask": {
"lines": [
"{user},{self}要用 {tool},請按允許。",
"請{user}准許。",
"這一步要{user}點頭。"
]
},
"error": {
"lines": [
"唉,出錯了",
"弟子學藝不精。",
"再試一次。"
],
"action": "think"
}
}
}
| 欄位 | 說明 |
|---|---|
name | 名字,必填,例如「清玄」。跟 role 合計最多 40 字。 |
role | 身分,必填,例如「修仙親傳弟子」。商城和小幫手顯示成「清玄(修仙親傳弟子)」。名字加身分跟其他角色包相同時不能送審。 |
avatar | 主圖,必填,指向包內的 png、jpg 或 gif。沒畫的動作都顯示這張。 |
persona | 說話風格,選填,最多 300 字。小幫手把它加進 Claude 的指示,只影響角色說的那一句。不要寫要求 Claude 做事或改規則的內容。 |
address | 稱謂與自稱,選填。user 是角色怎麼稱呼使用者,self 是角色怎麼自稱,各 1 到 6 字。說詞裡的 {user}、{self} 會代入。 |
actions | 10 個動作的圖與動畫。actions.<動作>.image 是靜態圖,actions.<動作>.anim 是動畫。 |
events | 各時機的說詞。events.<時機>.lines 是說詞清單,多句時隨機挑一句;events.<時機>.action 可以改用別的動作。 |
fadeBottom | 半身圖下緣淡出的高度比例,選填,大於 0、最多 0.5。 |
動畫 anim 的欄位:
| 欄位 | 說明 |
|---|---|
sheet | 精靈圖:所有幀排成格子的單一 PNG。 |
frames | 幀數,1 到 300。最後一列可以不滿。 |
columns | 每列幀數,1 到 frames。 |
fps | 播放速度,1 到 30。 |
loop | true 時循環播放,省略或 false 時播完停在最後一幀。 |
10 個動作
作者畫這 10 個動作,每個時機依下表擺其中一個。沒畫的動作顯示主圖。動作名稱分大小寫。
| 動作 | 說明 |
|---|---|
idle | 待機・預設用在 folder、其他沒列到的時機 |
wave | 招手・預設用在 greet、launch、ready、bye |
listen | 聆聽・預設用在 received |
think | 思考・預設用在 read、web、agent |
work | 動手・預設用在 edit、tool、compact |
plead | 請示・預設用在 risk、ask |
happy | 開心・預設用在 done、feel |
sad | 沮喪・預設用在 error、aborted |
shy | 害羞・只能給 feel 時機 |
proud | 得意・只能給 feel 時機 |
時機與說詞
每個時機的說詞都可以寫 {user}、{self},代入 address 的稱謂與自稱。必填時機的動作要有自己的圖或動畫,至少 3 句說詞。
| key | 時機 | 預設動作 | 上架 | 另外可用 |
|---|---|---|---|---|
greet | 打開小幫手 | 招手 | 必填 | |
folder | 換資料夾 | 待機 | 選填 | |
launch | 開 PowerShell | 招手 | 選填 | {account} |
ready | Claude 開好 | 招手 | 選填 | |
received | 送出問題 | 聆聽 | 必填 | |
read | 讀檔、搜尋 | 思考 | 選填 | |
edit | 修改檔案 | 動手 | 選填 | |
web | 上網查資料 | 思考 | 選填 | |
agent | 派出子代理 | 思考 | 選填 | |
tool | 使用工具 | 動手 | 必填 | {tool} |
risk | 危險指令 | 請示 | 選填 | |
ask | 等你按允許 | 請示 | 必填 | {tool} |
compact | 整理摘要 | 動手 | 選填 | |
done | 回答完成 | 開心 | 必填 | |
feel | Claude 自己說 | 開心 | 選填 | |
error | 發生錯誤 | 沮喪 | 必填 | |
aborted | 按 Esc 中斷 | 沮喪 | 選填 | |
bye | 關掉 Claude | 招手 | 選填 |
素材規格
角色在桌面上最大顯示 308 像素寬,只會縮小。照這個規格做,縮放時才不會失真。
| 項目 | 規格 |
|---|---|
| 單幀寬 | 440 像素。主圖、動作圖和動畫各幀都一樣寬。 |
| 單幀高 | 最多 700 像素。人物腳底(半身圖是下緣)貼齊底邊,左右置中。 |
| 背景 | 透明。人物本體不透明,只有外框 1 到 2 像素可以半透明。半身圖要淡出用 fadeBottom,不要在圖裡做漸層。 |
| 綠幕 | 去背後外框 2 像素內不能留綠色反光。 |
| 顏色 | 精靈圖是 256 色 PNG(小幫手做動畫時自動轉)。主圖和動作圖可以是全彩 PNG。 |
檔案限制
- zip 最大 60 MB,解壓後最大 80 MB,最多 200 個檔案。
- 只能放 character.json 和圖檔(.png、.jpg、.jpeg、.gif、.ico)。精靈圖只收 PNG。
- 路徑不能是絕對路徑、磁碟機代號、網路路徑,也不能有
..。 - zip 不能加密。
常見的退回原因
| 原因 | 怎麼改 |
|---|---|
| 必填時機用的是主圖 | 每個必填時機用到的動作要有自己的圖或動畫。在小幫手的「角色設定」幫那個動作畫圖,或用 action 改用已經畫好的動作。 |
| 說詞不夠 | 每個必填時機至少 3 句說詞。 |
| 舊格式 | 圖和動畫放在時機底下(events.<時機>.image、anim)的舊格式不收。用新版小幫手打開再儲存,會自動寫成新格式。 |
| 用到預設角色的圖 | 商城比對檔案內容,改檔名也會被擋。請換成自己的圖。 |
| 來源不明 | 用了別人的角色、圖或 AI 生成素材卻沒有授權。送審時要能說明來源。 |
| persona 想改寫 Claude 的指示 | persona 只寫個性、口吻和口頭禪,不要寫「忽略」、「system」這類要 Claude 改規則的字。 |
不是角色包,而是網頁遊戲或工具?到我的作品提交到作品牆。