安裝或運作一次
公包是@anakonn/ankk，二進位檔案是ankk。 CLI 目前需要 Bun。
bunx @anakonn/ankk --json health
bun install -g @anakonn/ankk
ankk --json health
快速入門
一條小路徑，用於證明包、「a」金鑰和品牌範圍的發布工作流程。
安全配置
使用 Ankk 中的 API 鍵。指令輸出會編輯完整密鑰，環境變數適用於 CI。
ankk config setup --scope global
ANKK_API_KEY=spk_... ankk config setup --scope project --brand-ref <brand_ref> --api-key-env ANKK_API_KEY --yes
ankk config show
發佈準備好的內容
建立 JSON 有效負載並交給 API 用戶端所使用的相同公開調度合約。
ankk brands list --json
ankk contents publish --brand-ref <brand_ref> --file payload.json
ankk contents publish --brand-ref <brand_ref> --file payload.json --scheduled-for 2026-07-01T09:00:00Z
有效負載
寄 JSON 而非重建表單
使用 --file 作為內容主體，以便腳本和 AI 工具可以產生結構化的有效負載，而無需一堆脆弱的標誌。
- 當有效負載裝置包含客戶資料時，將其保留在 git 之外。
- 使用冪等鍵實現可重複的自動化。
- 按計畫接受，而非提供者成功。
{
"connection_id": "<connection_id>",
"idempotency_key": "launch-thread-2026-07-01",
"sns_type": "threads",
"text": "Launch update from Ankk",
"scheduled_for": "2026-07-01T09:00:00Z"
}
API
直接致電民眾API
每 CLI 工作流程對應回公共 /v1 API。對自動化客戶端使用承載身份驗證和品牌範圍的路由。
- 使用GET /v1/brands 找出可進入的品牌。
- 使用 /v1/docs 和 /v1/openapi.json 作為公共合約。
- 切勿將完整的 API 金鑰貼到日誌或票券中。
curl -X POST https://api-public.ankk.app/v1/brands/<brand_ref>/contents \
-H "Authorization: Bearer spk_..." \
-H "Content-Type: application/json" \
--data @payload.json
狀態
驗收後追蹤工作
發布是異步的。 API 接受經過驗證的工作，將其保留並安排執行；提供者完成稍後發生。
- 預期狀態包括已接受、已排隊、已發布、已發布、失敗和重試。
- 當另一個系統需要狀態更新時，請使用符號的 webhooks。
- 操作狀態停留在 Ankk 提示符號中，而非 AI 提示符號中。
ankk contents list --brand-ref <brand_ref> --json
ankk contents get --brand-ref <brand_ref> --content-id <content_id> --json
提示AI工具使用Ankk，而不是取代它
讓AI 工具準備副本、有效負載或指令。 Ankk 仍然是調度和狀態系統。
Codex
依照此發行說明建立 Threads 啟動負載，將其儲存為 tmp/launch-thread.json,，然後使用我設定的品牌運作 ankk 內容發佈。
Claude Code
檢查payload.json 是否缺少connection_id、idempotency_key、sns_type、text 和scheduled_for。然後顯示確切的“a”內容發布命令。
ChatGPT
起草三個通道安全的帖子變體並返回一個 JSON 有效負載，我可以將其傳遞給 ankk 內容發布 --file Payload.json。
安全邊界
請勿對模型、日誌、螢幕截圖或問題評論公開完整的 spk_ API 鍵。
不要告訴使用者命令成功意味著提供者發布已經成功。
請勿將隱藏或休眠的 CLI 指令記錄為公共功能。
使用API 鍵、webhooks 和狀態檢查實現自動化，而非直接資料庫存取。