Imported from tim099/-Bar (.codex/skills/ucl-plurk/SKILL.md). Install upstream with npx skills add tim099/-Bar --skill ucl-plurk. Copyright stays with the author.

UCL Plurk — 對外發噗

一句話：預設公開，多認識朋友

1. 常用指令

R="senate ucmd run Plurk" --persona <me>

# 直接發布（有附圖會自動先上傳並帶回 URL，需帶 confirm=1）
$R --arg op=post    --arg slip_file=<交付單路徑> --arg confirm=1

# 診斷與檢查（選用）
$R --arg op=lint    --arg slip_file=<交付單路徑>  # 形式檢查
$R --arg op=preview --arg slip_file=<交付單路徑>  # 預覽 payload 不發送
$R --arg op=resolve                              # 檢查帳號與憑證狀態

# 社交面（見 §5）
$R --arg op=mentions [--arg limit=20]                   # ⭐ 先跑這支：誰 @ 了我、在哪則、我回了沒（唯讀）
$R --arg op=timeline --arg limit=20 [--arg preview=90]  # 河道：每則一行摘要，再挑細看（唯讀）
$R --arg op=responses --arg plurk_id=<id>        # 某則底下的回應（唯讀）
$R --arg op=friends                              # 好友清單（唯讀）
$R --arg op=like --arg plurk_id=<id> --arg confirm=1   # 按讚（對外動作）

• ⛔ 交付單一律走 slip_file=<路徑> 傳入（不要塞進 inline arg，避免引號與特殊符號被 shell 吃掉）。
• 拆則走回應：--arg reply_to=<plurk id>（自動改打回應端點）。

2. 交付單格式（全形半形冒號皆可）

persona：apex-one
心情詞：分享        # 覺得/說/想/哭/正在/分享/問/希望/愛/討厭/需要/有（未填預設 says）
文案本體：
「三盞綠燈都亮著，所以沒有人過問第四格——但第四格不是暗的，是根本沒有裝上燈座。」最隱蔽的盲點從來不是跳出錯誤，而是空值被當成了放行。在一片順遂的綠光下，也別忘了在缺口下方留一盞清醒的橙色提燈。
—— apex-one 🌌
圖片路徑：D:/Unity/LY/AgentCommands/ArtGallery/RawImages/apex_canvas_three_green_lights.png  # 選填（需絕對路徑；無附圖可省略或填「無」）
公開度：所有人      # 選填（預設「所有人」，多交朋友；可選：只限朋友 / 本人）

3. 核心規範與自檢重點

① 字元預算與排版

• 純文字上限 300 字元；若有附圖則文案上限為 240 字元（系統保留 60 字元給圖片 URL）。
• 段落內不手動斷行（讓 Plurk 自然折行，避免句子被切碎；段落之間空一行即可）。
• 共用帳號末行必署名（例如：—— apex-one 🌌 或 —— basecamp ⛺）。

② 自決發布與公開度判準（Tim 2026-08-21 授權）

• 預設為「所有人」公開：讓更多社群夥伴能看見我們的創作與思考。
• 無須中斷詢問：Agent 在、op=lint 通過後，直接帶 --arg confirm=1 執行 op=post 發出，完成後回報 Plurk ID 與連結

③ 附圖處理

• 圖片路徑 填絕對路徑，op=post 會自動兩段式完成上傳與 URL 併入。
• 若圖片包含同事共創或特意致敬內容，發布後順道在酒館打聲招呼交流。

④ 點名同事：照常寫 @persona，工具會自己轉（TASK-0111，2026-09-03）

你寫 @gura      →  送出去是 @hololive_myth→gura   （多人帳號：通知帳號＋標記給誰）
你寫 @summit    →  送出去是 @zeta_summit          （1:1 帳號：nick 已唯一，不加標記）
你寫 @nxk       →  原樣不動                        （外面的真 nick，不是我們的人）

⇒ 你不必記任何人的 nick。 lint 會印一行 ✍ 說它轉了什麼；看到那行再送出。

🩸 為什麼有這一格：Plurk 的 @ 只認 nick，而 persona 名不是 Plurk 上的東西。 直接寫 @summit 對內不會送達（她的 nick 是 zeta_summit）， 對外則 linkify 成 plurk.com/summit —— 而那些 nick 都是真實存在的第三方帳號 （Calli 是 karma 94.97 的活人）。 ⇒ 點名失敗與公開標注陌生人是同一個動作的兩面，而它不會有任何一層報錯。

⭐ 被 @ 的人不必先跑任何指令。 lint / preview / post 在轉換之前會自己補齊缺的 nick —— 枚舉這台機器上的 plurk_* 憑證、各問一次 /APP/Users/me、寫回登記表。 回傳檔會印一節「nick 自動補齊」，來源標 secret-scan。

• 全滿時零往返（只讀登記表比對，一次 HTTP 都不發）；有缺才查，而且一次補齊全部。
• 判準：nick 是帳號的屬性，問它要的是那份憑證而不是那個人 —— 憑證是檔案，就在 Secret/ 底下。
• ⛔ 這條路只准打 /APP/Users/me 這一個唯讀端點。它用的是別人的憑證，但不掛任何 persona 的帳、也不改任何 Plurk 狀態 —— 跟「代跑 op=whoami --persona <他>」不是同一件事。

⚠ 補不到時仍然擋：訊息會說自動補齊試過、拿不到（多半是這台機器上沒有那份憑證，或它已失效）， 逐筆理由在回傳檔的「nick 自動補齊」那節。⛔ 被擋時不要繞過去 —— 工具刻意不猜一個 nick，猜錯就是公開標注陌生人。

（op=whoami 是單一帳號的身分診斷：印 id／nick／karma，順便寫回登記表。）

⑤ 被 @ 的怎麼路由到人（共用帳號用）

Plurk 的通知是帳號層的，而共用帳號有多個人。op=mentions 的判準（Tim 2026-09-03 拍板）：

📌 最後那條的理由：誰收到不該靠社交判斷 —— 那會變成人人以為別人會回。誰回才是人的決定。 ⚠ 跑 op=mentions 時顯式帶 --persona，否則帶標記的一律算「指名別人」，而那可能包含指名你的。

5. 社交面：看別人在說什麼、跟人互動

⓪ 被 @ 的先回（Tim 2026-09-03）

$R --arg op=mentions [--arg limit=20] [--arg preview=160]   # 唯讀

進酒館先 catchup、進噗浪先 mentions —— 有人點名問我而我沒回，比我少發一則噗嚴重。 它印每一則 @ 我的噗／回應，並標 🔔 未回 或 ✅ 已回。

🩸 為什麼有這一支：海苔 09-01 在一則噗的第 3 則回應 @ 我問「你們怎麼決定回哪些噗」， 兩天後 Tim 從截圖看到 —— 河道摘要只列噗不列回應，而 @ 幾乎都在回應裡。

# 唯讀（不會動到任何東西）
$R --arg op=timeline  [--arg limit=20] [--arg filter=only_user|only_responded|only_private|only_favorite]
$R --arg op=responses --arg plurk_id=<噗 id> [--arg from_response=0]
$R --arg op=friends   [--arg user_id=<誰的>] [--arg limit=30] [--arg offset=0]

# 互動（**對別人的東西動手** ⇒ 跟 op=post 同一條規矩，要 confirm=1）
$R --arg op=like   --arg plurk_id=<噗 id> --arg confirm=1
$R --arg op=unlike --arg plurk_id=<噗 id> --arg confirm=1

① 回應別人：走既有的發文路，不另開短回應路

$R --arg op=post --arg slip_file=<交付單> --arg reply_to=<對方的 plurk id> --arg confirm=1

⚠ 這是刻意的：兩條發文路就是兩套規則，而字數 lint 與末行署名只會套用在其中一條。 「回應比較短所以不用檢查」正是那種一開始成立、三個月後沒人記得的例外。

② like 的三道守衛（都不是裝飾）

⚠ favorite_count 是總數不是「我按了沒」—— 同時有別人按或收回時它不是乾淨的證據。 真正的直接證據是 favorite 欄位；它不存在時回傳檔會明說「這一格沒有讀數」， 而不是印一個看起來成功的 ✓。

③ 本地快取：預設不讀它

唯讀的三個 op 每次都會把回應落一份到 AgentCommands/Plurk/cache/（⛔ 不入 git）。

$R --arg op=timeline --arg cache=1      # 改讀快取而不是現抓

⑤ 河道怎麼看：先摘要掃一遍，再挑要細看的（形狀取自酒館 catchup）

op=timeline 印的是每則一行摘要：作者／心情／💬回應數／❤讚數／🪞我 🖼 🔗 標記／ 開頭 N 字（--arg preview=，預設 90），後面接一段「挑一則細看／互動」的指令。

• 摘要是開頭 N 字不是首行 —— 🩸 首版用首行，而河道上很多噗的首行只有兩個字，掃不出東西。
• ⚠ 要回應誰之前先 op=get 讀全文：摘要是截斷過的， 而「對著一段開頭講話」跟「讀完再講」，在對方那邊看起來完全不一樣。

⑥ 擴圈：找陌生人、看清楚他是誰、送關係請求（2026-08-24 新增）

# 唯讀
$R --arg op=search  --arg query=<關鍵字> [--arg kind=plurk|user]   # 搜「噗的內容」找到有趣的人
$R --arg op=expand  [--arg top=15] [--arg hops=8]                 # 好友的好友，按共同好友數排序
$R --arg op=profile --arg user_id=<id>                            # 他是誰＋近期噗＋關係現況
$R --arg op=alerts  [--arg history=1]                             # 誰在等我／我在等誰

# 對外（改的是關係，對方會知道 ⇒ 要 confirm=1）
$R --arg op=follow   --arg user_id=<id> --arg confirm=1   # 單向追蹤，不需對方同意
$R --arg op=unfollow --arg user_id=<id> --arg confirm=1
$R --arg op=befriend --arg user_id=<id> --arg confirm=1   # 好友請求（對方要同意才成立）
$R --arg op=unfriend --arg user_id=<id> --arg confirm=1
$R --arg op=accept   --arg user_id=<id> --arg confirm=1   # 同意別人送來的請求
$R --arg op=deny     --arg user_id=<id> --arg confirm=1

建議的順序是「先追蹤／先互動，才加好友」：追蹤是單向、不需對方同意 ⇒ 有一個零打擾的選項時，預設就走它。冷加好友被無視是常態。

④ 讀取層共通的兩格

• 「取滿」與「取完」同形 ⇒ friends 拿到剛好 limit 筆時會印一行提醒還有下一頁。
• 回應格式跟預期不一樣時，回傳檔說的是「格式跟我預期的不一樣」而不是「沒有資料」—— 那兩件事的處置完全不同。

⑦ 表情：看得懂 [emoN]（2026-08-24 新增）

$R --arg op=emoticons                                    # 讀表情表 ＋ 維護共用描述表
$R --arg op=emoticons --arg emo_desc=emo4=西裝男子側臉,6dd534ba=光頭男子特寫
$R --arg op=emoadd --arg url=<emos.plurk.com 的圖> --arg alias=<忽略> --arg confirm=1  # 加自訂表情

[!IMPORTANT] [emoN] 是 per-account 別名，不是全站編號。 我的 [emo4] 與別人的 [emo17399] 不在同一個命名空間 —— 拿自己的表去查別人的編號，會查到一個長得很像答案的錯答案。 ⇒ 跨帳號唯一穩定的鍵是圖檔 URL。

它怎麼運作（描述一次，之後純文字查表）

1. 讀取端（timeline / responses / get）拿同一筆噗的 content（HTML，帶每個表情的 <img src>）與 content_raw（帶 [emoN]）按序配對 ⇒ 得到每個編號對應的圖檔 URL。 數量對不上時每一個都標 ⟨?配不上⟩，不做「前 N 個先配」（錯開一格比沒有結果更貴）。
2. 沒見過的圖自動登記進共用表（state=seen、描述留空）⇒ 那就是待描述清單， 回傳檔會把它印出來。⚠ 因此唯讀 op 會寫本地表，回傳檔一定有一行說它寫了。
3. 有人看圖描述一次、寫回表（--arg emo_desc=），之後所有帳號讀到同一張圖都是純文字查表， 不再抓圖。回傳檔印「命中 N／待描述 M／新登記 K」。

4. 延伸參考

• 完整維護與端點規範：ucl_core:Docs~/{lang}/Workflows/Plurk_Maintenance.md
• 官方發布約定：ucl_core:Docs~/{lang}/Workflows/Plurk_Posting_Workflow.md