# استفاده از دستور dvina

> با کاربرد دستور dvina هنگام اجرای کد توسط Dvina، دستورهای آن و مواردی که به تأیید شما نیاز دارند آشنا شوید.

وقتی Dvina برای شما کد یا دستور اجرا می‌کند، دستور اختصاصی خودش را دارد: `dvina`. با این دستور، یک اسکریپت یا چند مرحلهٔ پیاپی می‌تواند با هویت شما در Dvina جست‌وجو کند، سندها، حافظه و وظایف را بخواند و اضافه کند، و بررسی کند چه کسانی به یک مورد دسترسی دارند.

نیازی به نصب چیزی یا ورود به حساب نیست. هر وقت درخواست شما به این دستور نیاز داشته باشد، Dvina از آن استفاده می‌کند. خودتان هم می‌توانید چنین درخواستی کنید، مثلاً: «با dvina وظایف من را فهرست کن و خلاصه‌ای از آن‌ها را به‌صورت یادداشت بنویس.»

## نحوهٔ کار

- `dvina` در Dvina شما و با هویت شما کار می‌کند، در چارچوب مجوزهای نقش شما و محدودیت‌های معمولتان.
- دسترسی آن فقط تا زمانی برقرار است که Dvina روی درخواست شما کار می‌کند. با پایان پاسخ، دستور دیگر به Dvina شما دسترسی ندارد.
- فقط زمانی یک فایل یا پوشه را می‌خواند که نام آن در یک دستور آمده باشد، مثلاً فایلی که قرار است بارگذاری شود.

## دستورها

دستورها گروه‌بندی شده‌اند: `dvina <group> <command>` و سپس آرگومان‌ها و پرچم‌های آن دستور.

| گروه      | دستورها                                                                                                                 |
| ---------- | ------------------------------------------------------------------------------------------------------------------------ |
| `search`   | `dvina search <query>`: جست‌وجوی هم‌زمان در گفت‌وگوها، سندها، حافظه و دنیای شما.                                          |
| `memory`   | `ls`, `show`, `add`, `edit`: فهرست کردن، خواندن، افزودن یا تغییر فایل‌های حافظهٔ شما.                                                |
| `world`    | `topics`, `topic`, `recall`, `feed`: موضوع‌های شما، آنچه Dvina دربارهٔ چیزی می‌داند و خوراک شما.                       |
| `docs`     | `ls`, `show`, `read`, `search`, `create`, `upload`, `update`, `mv`, `mkdir`, `rm`: سندها و پوشه‌های کتابخانهٔ شما. |
| `canvas`   | `ls`, `show`, `create`, `write-page`: فهرست کردن، خواندن، ساختن یا بازنویسی صفحه‌های بوم.                                        |
| `tasks`    | `ls`, `show`, `start`, `continue`, `stop`: وظایف پس‌زمینهٔ شما.                                                        |
| `goals`    | `show`, `start`: وظایفی که برای رسیدن به یک هدف انجام می‌شوند.                                                                          |
| `schedule` | `ls`, `add`, `cancel`: پیام‌ها و یادآوری‌های زمان‌بندی‌شده، یک‌باره یا تکرارشونده.                                              |
| `agents`   | `ls`, `show`, `create`, `update`: عامل‌های شما.                                                                           |
| `skills`   | `ls`, `show`, `add`, `edit`: مهارت‌های شما.                                                                                |
| `projects` | `ls`, `show`: پروژه‌های شما.                                                                                             |
| `settings` | `get`, `set`: تنظیمات ترجیحی شما، مانند روشن یا خاموش کردن حافظه.                                                           |
| `share`    | `state`, `with-me`, `add`, `rm`: چه کسانی به یک مورد دسترسی دارند، دیگران چه چیزهایی با شما به اشتراک گذاشته‌اند و دادن یا حذف دسترسی.  |

`dvina` نمی‌تواند چیزی را برای همیشه حذف کند، پیوندهای عمومی را باز کند، برنامه‌ها را متصل کند یا اتصالشان را قطع کند، یا تنظیمات مدیریتی یا صورت‌حساب را تغییر دهد.

### راهنما و خروجی

- `dvina --help` گروه‌ها را فهرست می‌کند، `dvina <group> --help` دستورهای یک گروه را فهرست می‌کند و `dvina <group> <command> --help` آرگومان‌ها و پرچم‌های یک دستور را فهرست می‌کند.
- خروجی، متنی کوتاه است. برای دریافت JSON، `--json` را اضافه کنید. برای نگه داشتن فقط بعضی فیلدها، `--fields` را همراه با فهرستی که با ویرگول جدا شده است اضافه کنید، مانند `--fields id,title`.
- فهرست‌های طولانی با `next: --cursor <c>` تمام می‌شوند. برای دریافت صفحهٔ بعد، دستور را دوباره با همان `--cursor` اجرا کنید.
- برای خواندن یک مقدار از فایل، `-file` را به پرچم آن اضافه کنید، مانند `--content-file notes.md`. دستور `dvina docs upload <file>` یک فایل را بارگذاری می‌کند و `dvina skills add <folder>` یک پوشهٔ مهارت را همراه با فایل SKILL.md آن اضافه می‌کند.

### کدهای خروج

| کد | معنی                                                                       |
| ---- | ----------------------------------------------------------------------------- |
| `0`  | انجام شد.                                                                         |
| `1`  | خطای دیگری رخ داده است.                                                    |
| `2`  | دستور نادرست است. `--help` آن را بررسی کنید.                                     |
| `3`  | پیدا نشد.                                                                    |
| `4`  | رد شد: سطح دسترسی شما، قوانین شرکت یا حفاظت از داده‌ها اجازهٔ انجام آن را نمی‌دهد. |
| `5`  | به تأیید شما نیاز دارد.                                                       |
| `6`  | به سقف مصرف خود رسیده‌اید.                                              |

## تأیید تغییرات

- دستورهایی که اطلاعات را می‌خوانند، بدون پرسیدن از شما اجرا می‌شوند.
- دستورهایی که چیز جدیدی اضافه می‌کنند، مانند `docs create`، `memory add` یا `tasks start`، بدون پرسیدن از شما اجرا می‌شوند. این دستورها هرگز محتوای موجود را تغییر نمی‌دهند.
- دستورهایی که چیزی را تغییر می‌دهند یا حذف می‌کنند، ابتدا از شما تأیید می‌گیرند: جابه‌جایی، تغییر نام، انتقال به سطل زباله، جایگزینی یک یادداشت یا فایل حافظه، بازنویسی یک صفحهٔ بوم، تغییر یک عامل یا مهارت، توقف یک وظیفه، لغو یک پیام زمان‌بندی‌شده و اشتراک‌گذاری. Dvina یک کارت تأیید در گفت‌وگو نشان می‌دهد که شامل خلاصه‌ای از تغییر به بیان خود Dvina است و هر بار از شما تأیید می‌خواهد. اگر آن را رد کنید، هیچ چیز تغییر نمی‌کند.

هر چیزی که `dvina` اضافه می‌کند یا تغییر می‌دهد، مانند دیگر اقدام‌های Dvina، از بررسی‌های حفاظت از داده‌های شرکت شما می‌گذرد و در [گزارش حسابرسی](/docs/teams/audit-log) شما ثبت می‌شود.

## مطالب مرتبط

- [استفاده از Dvina در برنامه‌های دیگر با MCP](/docs/dvina-mcp/overview)
- [وظایف](/docs/use-dvina/features/tasks)
- [مروری بر اتصال‌دهنده‌ها](/docs/connectors/overview)