Skip to content
Back to search

salsi

SkillWorks with CodexGitHub

Write Persian with Persian words — a loanword scanner and an AI-assistant skill built on the Pasban dictionary. Ships 20,071 words, protects technical terms, code and quotations. Works in Claude, Codex, Cursor and more.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pooooooriya--salsi/badge.svg)](/listings/pooooooriya--salsi)

HTML

<a href="/listings/pooooooriya--salsi"><img src="/api/listings/pooooooriya--salsi/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 183 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="docs/logo.svg" width="104" height="104" alt="سالسی">
  3. # سالسی
  4. ### پارسی‌تر بنویس، بی‌آنکه چیزی خراب شود.
  5. بسی رنج بردم در این **سال سی**<br>
  6. عجم زنده کردم بدین پارسی<br>
  7. <sub>فردوسی</sub>
  8. [![tests](https://github.com/pooooooriya/salsi/actions/workflows/ci.yml/badge.svg)](https://github.com/pooooooriya/salsi/actions/workflows/ci.yml)
  9. [![code: MIT](https://img.shields.io/badge/code-MIT-blue.svg)](LICENSE)
  10. [![data: ODbL](https://img.shields.io/badge/data-ODbL--1.0-2ea043.svg)](salsi/data/LICENSE)
  11. **[تارنما](https://pooooooriya.github.io/salsi/)** · [English](README.en.md) · [سپاس‌نامه](ATTRIBUTION.md) · [پاسبان](https://pasbans.ir)
  12. </div>
  13. ---
  14. اسکیلی برای دستیارهای هوشمند — کلاد، کدکس، کرسر و هر چیز دیگر — و یک ابزار خط
  15. فرمان، که وام‌واژه‌های نوشتهٔ فارسی را پیدا می‌کند و برابر پارسی‌شان را پیشنهاد
  16. می‌دهد؛ **بی‌آنکه اصطلاح‌های تخصصی، نام‌های خاص و کد را خراب کند.**
  17. واژگان کار **[پاسبان](https://pasbans.ir)** است، زیر پروانهٔ
  18. [ODbL](https://opendatacommons.org/licenses/odbl/1-0/).
  19. ```bash
  20. git clone https://github.com/pooooooriya/salsi && cd salsi && ./install.sh
  21. ```
  22. نیازی به `pip` نیست: هر اسکیلی که نصب می‌شود، موتور و **هر ۲۰٬۰۷۱ واژه** را با
  23. خودش می‌برد. تنها نیازش پایتون ۳٫۱۰ است.
  24. ```
  25. $ salsi scan نوشتار.md --domain tech
  26. ✓ سیستم (۱:۱۸) → سامانه [امن]
  27. ✓ سرور (۳:۳۷) → کارساز [امن]
  28. ✓ فایل‌های (۳:۶۸) → پرونده‌های [امن]
  29. ✓ دانلود کنید (۴:۱۱) → بارگیری کنید [امن]
  30. ? کانفیگ (۴:۱) → پیکربندی
  31. ```
  32. بلوک کد، کد درون‌خطی، نشانی‌ها، نقل‌قول‌ها و `الگوریتم` را اصلاً نشان نداد —
  33. چون نباید عوض شوند.
  34. ---
  35. ## چرا جای‌گزینی ساده کار نمی‌کند
  36. نمونه‌های واقعی از همین واژه‌نامه، که اگر واژه‌به‌واژه جای‌گزین کنید متن را
  37. خراب می‌کنند:
  38. | در متن | جای‌گزینی ساده‌لوحانه | چه شد |
  39. |---|---|---|
  40. | `سرور` در نوشتار فنی | **شادمانی** | فرهنگ بر پایهٔ املا کلید خورده؛ `سُرور` و `server` یک‌شکل نوشته می‌شوند |
  41. | `الگوریتم` | **روال‌واره** | اصطلاح فنی است؛ برگرداندنش متن را کم‌دقت‌تر می‌کند |
  42. | `کیبورد` | **تخته‌مدنگ** | درست است، ولی کسی نمی‌شناسدش |
  43. | `خانه‌ای` | **سرایای** | پسوند فارسی با واژهٔ نو شکل عوض می‌کند |
  44. | `دانلود کنید` | **بارگیری کردن** | صرف فعل باید بماند، نه مصدر |
  45. سالسی سه لایه دارد که دقیقاً همین‌ها را می‌گیرد:
  46. **۱. موتوری که فارسی را می‌فهمد** — نیم‌فاصله، گونه‌های عربی حروف، اعراب،
  47. پسوندهای صرفی، عبارت‌های چندواژه‌ای و فعل‌های مرکب. `فایل‌هایمان`، `فایل ها` و
  48. `فایلها` همه به یک سرواژه می‌رسند، و پسوند برای واژهٔ **نو** بازساخته می‌شود
  49. (`خانه`+نکره = `خانه‌ای` ولی `کتاب`+نکره = `کتابی`).
  50. **۲. لایه‌های محافظت** — ناحیه‌های غیرمتن (بلوک کد، کد درون‌خطی، نشانی، نقل‌قول،
  51. برچسب HTML، لاتک، front matter) و واژگان محافظت‌شده به تفکیک حوزه.
  52. **۳. سه سطح صریح**، چون «فارسی‌تر» یک عدد نیست:
  53. | سطح | چه می‌دهد | برای چه |
  54. |---|---|---|
  55. | `safe` | ۱۱۹ ردیف حل‌شده | خودکارسازی، CI، وقتی نمی‌توانید بازبینی کنید |
  56. | **`standard`** (پیش‌فرض) | همه‌چیز جز جاافتاده‌ها و محافظت‌شده‌ها | ویرایش عادی با بازبینی |
  57. | `pure` | همهٔ ۲۰٬۰۷۱ سرواژه | سره‌نویسی، فقط وقتی خواسته شود |
  58. **تنها `safe` بدون داوری انسان اعمال می‌شود.** باقی، *پیشنهاد* است نه تصمیم —
  59. و اسکیل به دستیار می‌گوید پیشنهادِ ناآشنا را رد کند. متن شما بدشکل نمی‌شود.
  60. ---
  61. ## اسکیل
  62. اصل ماجرا [`skills/salsi/SKILL.md`](skills/salsi/SKILL.md) است: دستورالعمل
  63. **داوری** برای دستیار هوشمند — کِی جای‌گزین کند، کِی نکند، و چرا.
  64. ```bash
  65. ./install.sh # آنچه روی دستگاهتان هست را پیدا می‌کند و می‌پرسد
  66. ./install.sh --list # فقط گزارش بده
  67. ./install.sh claude cursor # فقط این‌ها
  68. ./install.sh --bundle ./dist # پوشهٔ خودکفا برای بارگذاری در claude.ai
  69. ```
  70. | ابزار | جای نصب |
  71. |---|---|
  72. | Claude Code | `~/.claude/skills/salsi/` یا `.claude/skills/` پروژه |
  73. | Claude.ai / Desktop | `--bundle` بسازید و پوشه را بارگذاری کنید |
  74. | Codex | افزوده می‌شود به `AGENTS.md` |
  75. | Cursor | `.cursor/rules/salsi.mdc` |
  76. | Windsurf / Cline / Continue / Zed | پرونده‌های `skills/adapters/` |
  77. | هر چیز دیگر | `skills/adapters/PROMPT.md` را در پرامپت سامانه بگذارید |
  78. هر نصب **خودکفاست**: `bin/salsi` درون پوشهٔ اسکیل، با کل واژه‌نامه. جایی که
  79. دستیار اصلاً نمی‌تواند فرمان اجرا کند، به جدول ۱۱۹ ردیفیِ
  80. `reference/core-words.md` برمی‌گردد و موظف است بگوید با واژه‌نامهٔ کامل کار
  81. نمی‌کند.
  82. ---
  83. ## ابزار خط فرمان
  84. ```bash
  85. salsi scan نوشتار.md # --format text|json|markdown
  86. salsi scan نوشتار.md --domain tech --topic "رایانه"
  87. salsi apply نوشتار.md --diff # فقط ردیف‌های امن
  88. salsi lookup سرور # پاسبان چه می‌دهد، و در کدام معنا
  89. salsi domains # حوزه‌های محافظت
  90. salsi info # اندازهٔ واژه‌نامه و خاستگاهش
  91. ```
  92. هم‌سنجی در CI یا قلاب گیت:
  93. ```bash
  94. salsi scan docs/**/*.md --level safe --strict
  95. ```
  96. خروجی JSON قالب رسمی ماشین‌خوان است: هر یافته `level`، `ambiguous`، جای دقیق،
  97. و برچسبِ **معنا** برای هر پیشنهاد دارد — همان که دستیار باید بخواند تا `سرور`
  98. را `شادمانی` نکند.
  99. ---
  100. ## داده و پروانه
  101. | چه چیزی | پروانه |
  102. |---|---|
  103. | نرم‌افزار سالسی | [MIT](LICENSE) |
  104. | `salsi/data/**` (اقتباس از دادگان پاسبان) | [ODbL v1.0](salsi/data/LICENSE) |
  105. | متنی که با سالسی می‌نویسید | «فرآوردهٔ برخاسته» — فقط یادکرد پاسبان لازم است |
  106. واژه‌نامه از **انتشار رسمی خود پاسبان** ساخته می‌شود:
  107. ```bash
  108. python3 scripts/fetch_lexicon.py # تازه‌ترین انتشار
  109. ```
  110. شرط‌های ODbL — یادکرد، هم‌سان‌رسانی، گشوده‌ماندن — همه رعایت شده‌اند؛
  111. [ATTRIBUTION.md](ATTRIBUTION.md) جزئیاتش را می‌گوید.
  112. ---
  113. ## ساختار
  114. ```
  115. salsi/ موتور: normalize، morphology، lexicon، guards، scan
  116. data/ lexicon.json (واژگان پاسبان) + curated.tsv + فهرست‌های محافظت
  117. skills/
  118. salsi/ اسکیل + مرجع‌ها
  119. adapters/ AGENTS.md، cursor، پرامپت همگانی
  120. examples/ نمونهٔ پیش و پس از ویرایش
  121. scripts/ گرفتن واژه‌نامه و ساخت جدول مرجع
  122. tests/ ۳۲ تست
  123. ```
  124. ```bash
  125. python3 -m unittest discover tests
  126. ```
  127. ---
  128. ## همکاری
  129. بیشترین ارزشی که می‌توانید بیفزایید کد نیست، **فهرست‌های واژه** است —
  130. [CONTRIBUTING.md](CONTRIBUTING.md) مرز دقیق هر فهرست را می‌گوید.
  131. اگر واژه‌ای در خود فرهنگ غایب یا نادرست است، به
  132. [پاسبان](https://t.me/PasbanParsi) بگویید؛ سرچشمه آن‌جاست و همه سود می‌برند.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.