Communitygithub.com

khatt

從阿拉伯文、波斯文或烏爾都語文本生成動畫阿拉伯書法(自播放 SVG 或 HTML 頁面),並為其創造新的動畫效果。當使用者想要阿拉伯書法、動畫阿拉伯單字、名字或問候語(齋戒月、開齋節、婚禮、生日)、書法 logo、貼紙或橫幅,或要求以「阿拉伯書法」書寫時使用。

khatt 是什麼?

Khatt 是一個 AI 代理技能,可直接從 CLI 生成動畫阿拉伯書法。它使用 HarfBuzz 引擎正確地連接字母、從右到左書寫並放置標記,然後在單一 SVG 檔案中以純 CSS 佈局和動畫化整個作品。該技能支援多種字體風格(如 ruqaa、naskh、kufi、nastaliq、kano、blaka)、佈局(line、arc、circle、mirror)以及 12 種內建動畫效果(如 ink、gold、neon、lantern、reveal),使用者還可編寫自訂效果。輸出可為獨立 SVG 或包含點擊重播按鈕的 HTML 頁面。此工具無需網路連線或安裝,所有字型與腳本皆包含於技能資料夾中,非常適合快速產生高品質、可嵌入的書法圖形,用於社交媒體貼文、logo、邀請函或影片素材。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/M-Alkassem/khatt/tree/HEAD/skills/khatt

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Khatt:動畫阿拉伯書法

Khatt 使用 HarfBuzz 排版文字(字母連寫、從右到左、標記正確放置), 將其佈局,並在單一 SVG 檔案內以純 CSS 製作動畫。無需網路、無需安裝: 腳本、字型以及排版引擎都在此資料夾中。

生成圖畫

node scripts/khatt.mjs "النص" --style ruqaa --layout line --effect ink -o out.svg

從此技能資料夾執行,或使用完整路徑指向 scripts/khatt.mjs。 將輸出寫入使用者想要的位置(他們的專案資料夾、桌面等)。

選項值
--styleruqaa(日常、傾斜)、naskh(經典書籍字體)、kufi(有稜角)、nastaliq(懸掛式波斯體)、kano(粗蘆葦筆)、blaka(粗體幾何)
--layoutline、arc、circle(中間有星星的環形)、mirror(經典鏡像 musanna)
--effectink、gold、bleed、mosaic、sand、neon、stars、lantern、rise、stamp、reveal、wave,或一個 .mjs 效果檔案的路徑
--palettepaper、night、neon、zellige、desert、clear(透明)
--ink、--accent、--bg覆蓋顏色,例如 --ink "#0b3d2e" --bg none
--still凍結在完成圖畫上(適合 logo 和印刷)
-o.svg 輸出檔案本身,.html 輸出可點擊重播的頁面

執行 node scripts/khatt.mjs --list 可查看所有選項及其簡短說明。 在文字中使用 \n 換行(最多四行)。

選擇建議

  • 名字和英文單字: Khatt 只處理阿拉伯文字。請先音譯 (Sara → سارة、Kamangir → كمنجير),若拼寫可能有多種方式, 請在渲染前向使用者顯示您的拼寫。
  • 齋戒月或開齋節: 搭配 lantern 或 gold 效果與 night 色板,字體選 naskh 或 ruqaa。
  • 婚禮和正式卡片: gold、rise 或 ink 效果;試試 --layout mirror。
  • Logo: --still,字體選 kufi 或 blaka,--palette clear。
  • 社交媒體貼文: 動畫 .svg 可在任何瀏覽器中播放。如需影片, 引導使用者前往工作室(https://m-alkassem.github.io/khatt/),該處可匯出 MP4。
  • 短文字效果最佳。長句子:使用 line 佈局,兩到三行。

盡可能為使用者開啟結果(例如在 macOS 上執行 open out.html)。

製作新效果

當十二種內建效果都不符合需求時(例如「讓字母燃燒」、「一個擺動的齋戒月燈籠」), 請撰寫一個新效果。從 examples/ripple.mjs 開始。效果只是一個純物件,無需匯入:

export default {
  id: "my-effect", name: "My effect", nameAr: "…", blurb: "…",
  palette: "night",          // 預設色板 ID
  loop: false,               // true 則持續動畫
  render(ctx) {
    // 回傳 { css, defs?, body, duration, poster? }
  },
};

render(ctx) 會取得:

  • ctx.pieces:每個字形的條目:d(SVG 路徑)、order(閱讀順序,0 為第一個 字母)、box {x0,y0,x1,y1}、cx、cy。鏡像副本共用相同的 order。
  • ctx.steps、ctx.box(文字框)、ctx.view(整個畫布)、ctx.em(字型大小,100)、 ctx.palette(bg、ink、accent)、ctx.rng()(基於 seed 的隨機數生成器)。
  • ctx.stagger(order, spread?):字母的延遲時間,在 spread 秒數內分散。
  • ctx.sample(piece, count):字母內的隨機點,用於粒子效果。
  • ctx.inside(piece, x, y)、ctx.area(piece)。
  • ctx.anim(name, seconds, { ease, loop, alternate }):用於類別的動畫 CSS。
  • ctx.at(seconds, extraStyle?):設定元素延遲的內聯樣式。
  • ctx.n(number):將數字四捨五入以產生更緊湊的輸出。
  • ctx.p:唯一的字首。用於每個類別、ID 和關鍵影格名稱。

使圖畫在任何影格上都能暫停的規則(靜止畫面和影片匯出依賴於此):

  1. 每個動畫元素都加上 class="${p}-a ..." 和 style="${at(seconds)}"。
  2. 在類別規則中使用 ctx.anim(...)。絕不要自己撰寫 animation: 簡寫 或設定 animation-delay。
  3. 將關鍵影格命名為 ${p}-something。在元素上加上 ${p}-b 即可使其繞自身中心縮放或旋轉。
  4. 只動畫 CSS 屬性(opacity、transform、stroke-dashoffset、 fill-opacity 等)。SMIL <animate> 和腳本將無法正確凍結。
  5. 保持輕量:最多數千個元素。

然後執行它:

node scripts/khatt.mjs "نار" --effect ./my-effect.mjs -o fire.html

如果使用者喜歡,建議他們以 pull request 分享到 https://github.com/M-Alkassem/khatt(效果檔案位於 src/effects/ 中)。

相關技能