碼舍商城

我也要上架

把自己做的碼舍角色包授權給商城販售。審核通過後,角色包會出現在目錄。商城是賣方,負責收款、客服與退款。

上架步驟

  1. 在碼舍做好角色包用小幫手的「角色設定」設定主圖、表情與說詞
  2. 用 Google 帳號登入商城不需要另外註冊
  3. 同意創作者授權合約你授權商城販售,商城是賣方,負責收款、客服與退款;版稅按月結算給你
  4. 上傳角色包 zip 並訂價訂價最低 NT$49
  5. 等擁有者審核審核通過後角色包會上架

上架規則

  • 只收原創或已取得授權的角色。
  • 只收全年齡內容。
  • 角色包 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} 會代入。
actions10 個動作的圖與動畫。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。
looptrue 時循環播放,省略或 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}
readyClaude 開好招手選填
received送出問題聆聽必填
read讀檔、搜尋思考選填
edit修改檔案動手選填
web上網查資料思考選填
agent派出子代理思考選填
tool使用工具動手必填{tool}
risk危險指令請示選填
ask等你按允許請示必填{tool}
compact整理摘要動手選填
done回答完成開心必填
feelClaude 自己說開心選填
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 改規則的字。

不是角色包,而是網頁遊戲或工具?到我的作品提交到作品牆。