BuilderIO/agent-native / packages/core/docs
agent-native-docs
UnverifiedHow to look up version-matched Agent-Native framework docs and source in node_modules. Use before coding against @agent-native/core APIs or advanced features.
content/locales/ar-SA/sharing.mdx
View on GitHub---
title: "المشاركة والخصوصية"
description: "مشاركة مألوفة ومتسقة مدمجة في إطار العمل. يحصل كل مورد ينشئه المستخدم — المستندات ولوحات المعلومات والتصميمات والعروض والمقاطع والتسجيلات والنماذج — على النموذج نفسه الذي يكون خاصًا افتراضيًا مع واجهة مشاركة واحدة متسقة."
---
# المشاركة والخصوصية
كل مورد ينشئه المستخدم في تطبيق وكيل أصلي - مستند، أو لوحة معلومات، أو تصميم، أو مجموعة، أو تسجيل شاشة، أو نص اجتماع، أو نموذج، أو رابط حجز - يكون **خاصًا بالمنشئ بشكل افتراضي**. ولا يراها الأشخاص الآخرون إلا عندما يشاركها منشئ المحتوى بشكل صريح، أو يغير مستوى رؤيتها إلى `org` أو `public`.
إنه نموذج مشاركة واحد مألوف في كل مكان: زر المشاركة نفسه، ومربع الحوار نفسه، ونموذج الرؤية نفسه المكوّن من ثلاث طبقات، والمنح نفسها لكل مستخدم ولكل مؤسسة — عبر كل قالب، دون إعادة ابتكار لكل تطبيق.
## لماذا نموذج واحد {#why}
تجعل معظم أطر عمل التطبيقات المشاركة مشروعًا خاصًا بكل ميزة. النتيجة: كل سطح يشبه المستند ينتهي به الأمر بمربع حوار المشاركة الخاص به، ومخطط الأذونات الخاص به، وأخطاء التحقق من الوصول الخاصة به. في الوكيل الأصلي، تعد المشاركة **إطار عمل بدائي**. يتم شحن أعمدة المخطط، ومساعدات التحقق من الوصول، والجزء المنبثق للمشاركة، والمشاركة القابلة للاستدعاء للوكيل actions مع المركز. يحصل القالب الجديد على قصة المشاركة الكاملة عن طريق إضافة عمودين وسطر واحد للتسجيل.
يعني هذا أيضًا أن الوكيل لن يضطر أبدًا إلى تعلم نموذج مشاركة جديد لكل تطبيق. أخبر الوكيل "بمشاركة هذا مع Alice كمحرر" في أي قالب وسيتم تفعيل الإجراء `share-resource` نفسه.
## مستويات الرؤية الثلاثة {#visibility}
تعيش الرؤية التقريبية على المورد نفسه؛ المنح الدقيقة موجودة في جدول المشاركات المصاحبة.
| الرؤية | من يمكنه رؤيته |
| --------- | ---------------------------------------------------------------------------------------- |
| `private` | تم منح المالك + الأشخاص صراحةً. **الافتراضي لكل مورد جديد.** |
| `org` | المالك + المنح الصريحة + أي شخص في نفس المؤسسة (للقراءة فقط). |
| `public` | المالك + المنح الصريحة + أي شخص لديه الرابط (للقراءة فقط). لا يظهر في قوائم/بحث الآخرين. |
`public` هو مستوى هادئ بشكل متعمد: يمكن الوصول إلى المورد العام عن طريق رابط مباشر، ولكنه **لا** يظهر في الأشرطة الجانبية أو القوائم أو عمليات البحث الخاصة بالمستخدمين الآخرين. وهذا يبقي "عامًا لمشاركة URL" منفصلاً عن "عامًا للاكتشاف عبر المستخدمين". يتم الاشتراك بشكل صريح في المعارض وكتالوجات النماذج التي تريد حقًا اكتشاف المستخدمين المتعددين.
<Diagram id="doc-block-1wqhwzj" title={"الرؤية، واتساع إلى الخارج"} summary={"الرؤية الخشنة للمورد تحدد الأرضية؛ تضيف منح المشاركة الصريحة في الجدول المصاحب أشخاصًا محددين في الأعلى."}>
```html
<div class="share-tiers">
<div class="diagram-card">
<span class="diagram-pill">private</span
><small class="diagram-muted"
>owner + explicit grants only · <strong>default</strong></small
>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↓</div>
<div class="diagram-card">
<span class="diagram-pill accent">org</span
><small class="diagram-muted">+ anyone in the same org (read-only)</small>
</div>
<div class="diagram-arrow diagram-muted" aria-hidden="true">↓</div>
<div class="diagram-card">
<span class="diagram-pill warn">public</span
><small class="diagram-muted"
>+ anyone with the link (read-only) · hidden from others'
lists/search</small
>
</div>
</div>
```
```css
.share-tiers {
display: flex;
flex-direction: column;
align-items: stretch;
gap: 8px;
}
.share-tiers .diagram-card {
display: flex;
flex-direction: column;
gap: 4px;
padding: 12px 16px;
}
.share-tiers .diagram-arrow {
text-align: center;
font-size: 20px;
line-height: 1;
}
```
</Diagram>
## الأدوار في منحة الأسهم {#roles}
عند المشاركة مع مستخدم أو مؤسسة معينة، فإنك تختار دورًا:
- **العارض** — للقراءة فقط.
- **المعلّق** — للقراءة وإضافة التعليقات، ولكن لا يمكنه تعديل المورد أو إدارة المشاركات.
- **المحرر** — قراءة + كتابة.
- **المسؤول** — قراءة + كتابة + إدارة المشاركات (يمكن إضافة/إزالة أشخاص آخرين).
يقوم `admin` بتغيير الملكية بواسطة NOT - لا يزال هناك مالك واحد بالضبط لكل مورد، بخلاف منح الأسهم.
### مشاركة المجموعات {#group-grants}
تدعم بعض الموارد مشاركة المجموعات. يجب أن تنتمي المجموعة إلى مؤسسة المورد، ويحصل كل عضو حالي فيها على دور المشاركة المحدد لهذا المورد. راجع [المؤسسات والفرق والأذونات → مجموعات المستخدمين](/docs/organizations-teams-permissions#user-groups) لمعرفة ما الذي تحدده المجموعات وما الذي لا تحدده.
## ما يتم تغطيته {#covered}
يستخدم كل قالب يقوم بتخزين العمل الذي قام المستخدم بتأليفه هذا النموذج. بشكل ملموس:
- **المحتوى** — المستندات
- **الشرائح** — التشكيلات
- **التصميم** — التصاميم والأصول
- **المقاطع** — تسجيلات الشاشة
- **Plan** — visual plans and PR recaps
- **النماذج** — تعريفات النماذج
- **التقويم** — الأحداث وروابط الحجز
- **التحليلات** — dashboards, saved analyses, and tokenized session replays
- **الإضافات** — تطبيقات صغيرة في وضع الحماية (راجع [Extensions](/docs/extensions#sharing))
يستخدم كل واحد من هؤلاء نفس مساعد مخطط `ownableColumns()`، ونفس إجراء `share-resource`، ونفس `<ShareButton>` UI. انتقل من قالب إلى آخر وسيبدو مربع حوار المشاركة متطابقًا.
## ما لم يتم تغطيته {#not-covered}
توجد بعض المناطق خارج نظام المشاركة عمدًا:
- **تطبيقات البيانات الشخصية** (البريد) — على نطاق المستخدم حسب التصميم. لا يوجد مفهوم "مشاركة البريد الوارد".
- **تطبيقات المصدر الخارجي للحقيقة** — التحكم في الوصول موجود في النظام الأساسي، وليس في التطبيق الأصلي للوكيل.
- **URLs العامة المجهولة** — الارتباطات الثابتة لنشر النموذج والارتباطات الثابتة لرابط الحجز التي تعرض URL للمستخدمين الذين قاموا بتسجيل الخروج هي محور منفصل. إنهم يعيشون جنبًا إلى جنب مع نظام المشاركة، وليس فوقه.
## الحصة UI {#share-ui}
يحصل كل مورد قابل للمشاركة على زر مشاركة في رأسه. يؤدي النقر عليه إلى فتح نافذة منبثقة مرتبطة بالزر (وليس مشروطًا) مع:
- حقل دعوة واحد للأشخاص ومجموعات المؤسسة ووكلاء المؤسسة، مع أداة اختيار الدور وزر الدعوة. ويظهر للبريد الإلكتروني المكتوب أيضًا مربع الاختيار `Notify people`.
- الأشخاص الذين لديهم صلاحية الوصول: المالك والأشخاص والمجموعات والوكلاء في قائمة واحدة. الأدوار هي: يمكنه العرض، ويمكنه التعليق، ويمكنه التعديل، ويمكنه إدارة الوصول. ويظهر «إزالة الوصول» كآخر عنصر في قائمة الدور لكل صف.
- الوصول العام: المدعوون فقط / أي شخص في المؤسسة / أي شخص لديه الرابط. يتوفر لخيار «أي شخص في المؤسسة» أداة اختيار الدور (يمكنه العرض، ويمكنه التعليق، ويمكنه التعديل)، وكذلك لخيار «أي شخص لديه الرابط» (يمكنه العرض، ويمكنه التعليق).
- نسخ الرابط، وقائمة «إرسال إلى»: الفتح في Claude أو Claude Code أو Codex، ونسخ موجّه الوكيل، ونسخ رابط الوكيل، وإعدادات خادم MCP، وأي وجهات يضيفها التطبيق.
تُحفظ تغييرات الرؤية فورًا. يمكن لنوع مورد يسهل إغفال محتواه أن يطلب التأكيد أولًا: تضبط المحادثات `confirmOrgVisibility: true` في تسجيلها، لذلك ينتظر نقل محادثة من `Private` إلى `Organization` حتى يؤكد المستخدم. يحافظ الإلغاء أو Escape على الوصول الحالي. إذا فشل الحفظ، يعرض مربع الحوار الخطأ ويمكن للمستخدم المحاولة مجددًا. التأكيد موجود في واجهة المشاركة فقط، لذلك يواصل الوكيل وأي مستدعٍ آخر تغيير الرؤية مباشرة عبر `set-resource-visibility`، وتظل سياسة مشاركة المورد هي التي تحدد المسموح به.
يمكن لنوع المورد أيضًا أن يأخذ معه موارد مرتبطة عندما يصبح عامًا أو يتوقف عن ذلك. يسجّل Content الخيار `publicFollowers` الذي يعيد الصفحات الفرعية لصفحة ما: جعل الصفحة عامة يجعلها عامة أيضًا، وإعادتها إلى خاصة أو إلى المؤسسة فقط يأخذ معها ما بقي منها عامًا. تحتفظ الموارد المرتبطة التي لا يستطيع المستدعي إدارتها بإعدادها الخاص، ويُحفظ التغيير كله معًا أو يفشل معًا، ويعيد `set-resource-visibility` عدد ما تغيّر معه في `followersChanged`. يعرض مربع حوار المشاركة عدد الموارد العامة مع المورد عندما يمرّر التطبيق `publicFollowersLabel` إلى `ShareButton`. يُرفض التغيير الذي سيأخذ معه أكثر من `MAX_PUBLIC_FOLLOWERS` (500).
زر المشاركة عبارة عن استيراد واحد:
```tsx
import { ShareButton } from "@agent-native/toolkit/app/sharing";
<ShareButton
resourceType="deck"
resourceId={deck.id}
resourceTitle={deck.title}
/>;
```
يظهر الوكلاء في حقل الدعوة عندما تمتلك المؤسسة وكلاء خدمة (هويات `svc-<name>@service.<orgId>` من رموز خدمة المؤسسة). تتم مشاركتهم كمستخدمين عاديين ولا تُرسل إليهم رسائل بريد إلكتروني. أما الوكلاء الذين يتصلون عبر MCP أو OAuth فيعملون بصفة الشخص الذي وصّلهم، لذا لا يظهر لهم صف. سلّمهم المورد من «إرسال إلى».
بالنسبة للقوائم، قم بإسقاط `<VisibilityBadge visibility={row.visibility} />` بجوار كل صف حتى يتمكن المستخدمون من رؤية ما هو خاص مقابل ما هو مشترك.
## الدردشات المشتركة {#shared-chats}
تستخدم سلاسل دردشة الوكيل النموذج نفسه. الدردشة الجديدة أو المتفرعة خاصة بمالكها، ومشاركة الدردشة تتبع القواعد أعلاه.
تحمل كل دردشة في قائمة السجل حقلين ليتمكن الصف من توضيح مالك الدردشة وسبب قدرتك على رؤيتها:
| الحقل | القيمة |
| ------------- | ------------------------------------------------------------------------------------------------------------- |
| `ownerEmail` | مالك الدردشة. |
| `accessBasis` | `owner` أو `direct` (منح لك بالاسم) أو `organization`. يتقدم `direct` على `organization` عندما ينطبق الاثنان. |
تقبل قوائم السجل والبحث عامل التصفية `ownership`:
- `all` (الافتراضي) يعرض كل دردشة يمكنك الوصول إليها.
- `mine` يعرض الدردشات التي تملكها، حتى عندما تكون مشتركة مع المؤسسة.
- `shared` يعرض الدردشات التي يمكنك الوصول إليها ويملكها شخص آخر.
يطبق الخادم `ownership` قبل ترقيم الصفحات، لذلك تصف `limit` و`offset` و`hasMore` القائمة بعد التصفية. يقبل البحث عامل التصفية نفسه. تُرفض القيمة غير المعروفة بالرمز 400 بدلًا من الرجوع إلى `all`. لا تتغير قواعد الوصول، ولا تحمّل عملية العرض النصوص الكاملة للمحادثات أبدًا.
الترحيل: يجب على مستدعي قائمة سجل المحادثات والبحث المخصصين إرسال عدد صحيح موجب في `limit` وعدد صحيح غير سالب في `offset`، أو حذفهما لاستخدام القيم الافتراضية. تُرجع القيم غير الصالحة الآن HTTP 400 بدلاً من تحويلها تلقائيًا. تُقيَّد قيم `limit` الصالحة الأكبر من 200 عند 200.
في شيفرة العميل، يقوم `useChatThreadList()` من `@agent-native/core/client` بترقيم قائمة واحدة في كل مرة:
```tsx
import { useChatThreadList } from "@agent-native/core/client";
const shared = useChatThreadList({ ownership: "shared", pageSize: 50 });
// shared.threads, shared.hasMore, shared.loadMore(), shared.error
```
القيمة الافتراضية لـ `refreshOnThreadUpdates` هي `true`. اضبطها على `false` لتجاوز التحديثات الناتجة عن `notifyChatThreadsUpdated()`. يستمر التحميل الأولي واستدعاء `refresh()` يدويًا والتنقل بين الصفحات وإعادة التحميل عند استئناف Activity في العمل. يحافظ تغيير هذا الخيار على الصفوف المحملة ولا يرسل طلبًا بحد ذاته.
يؤدي الطلب الفاشل إلى ضبط `error` مع الاحتفاظ بالصفوف المحمّلة سابقًا. ولا يبدو أبدًا كقائمة فارغة. يقوم `<ShareButton>` و`<ShareDialog>` بتحديث قوائم الدردشة المعروضة بعد الحفظ. وإذا غيّرت مشاركة دردشة بطريقة أخرى، فاستدعِ `notifyChatThreadsUpdated()` لتعيد القوائم المعروضة التحميل.
التثبيت شخصي: تمثل `pinnedAt` تثبيت المستدعي حتى في المحادثات المشتركة، وتُرتب القوائم والبحث حسبها. تبقى `useChatThreads().pinThread(id, pinned)` كما هي. توفر كلتا الدالتين `hideThread(id, hidden)` للمحادثات المشتركة. تُستبعد المخفية إلا عند `includeHidden: true`، وتتضمن القوائم والقراءة الفردية قيمة `hiddenAt` الخاصة بالمستدعي. يظل الفتح بالمعرّف أو الرابط ممكنًا. لا يمكن للمالك إخفاء محادثته بل يؤرشفها؛ إعادة التسمية والأرشفة للمالك فقط. يرمي الإخفاء `ChatThreadMutationError` عند الرفض (`status`: 403 للمالك، 404 دون صلاحية)، ويعيد `true` عند النجاح. واجهة HTTP هي `POST /_agent-native/agent-chat/threads/:id/hide` مع `{ hidden: boolean }`، وللقوائم والبحث `includeHidden=1`. تدعم أداة `chat-history` العمليات `pin` و`unpin` و`hide` و`unhide` والبحث مع `includeHidden: true`. عند سحب الوصول لا تظهر الحالة المحفوظة، وعند حذف المحادثة تُحذف الحالة.
## نفس الطراز والوكيل وUI {#agent-and-ui}
يقوم إطار العمل بتثبيت actions تلقائيًا في كل قالب - يستدعيها الوكيل كأدوات، ويستدعيها UI من خلال `useActionQuery` / `useActionMutation`:
| الإجراء | ماذا يفعل |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `share-resource` | منح مستخدم أو مؤسسة حق الوصول إلى دور محدد. يتحكم `notify` الاختياري في إشعارات البريد الإلكتروني. |
| `unshare-resource` | إبطال الوصول لمستخدم أو مؤسسة. |
| `list-resource-shares` | إظهار الرؤية الحالية بالإضافة إلى جميع المنح الصريحة. |
| `set-resource-visibility` | قم بالتغيير إلى `private`، أو `org`، أو `public`. يحدد `role` الاختياري ما يمكن للمؤسسة فعله (العرض، التعليق، التعديل) أو لأي شخص لديه الرابط (العرض، التعليق). |
| `create-agent-resource-link` | Mint a temporary read-only `agent_access` URL for a registered agent-readable resource. |
أخبر الوكيل "بمشاركة هذا التصميم مع فريق التسويق كمحررين" وسيقوم باستدعاء `share-resource` مقابل نفس نقطة النهاية التي يستخدمها UI. تظهر النتيجة في مربع حوار المشاركة في العرض التالي.
## Agent-readable share links {#agent-readable-links}
Human share links should also work for agents when the resource is a document-like artifact: plans, documents, decks, designs, analytics dashboards, saved analyses, clips, and similar "things you would send to a person." Public links expose a small SSR discovery script that points at structured JSON. Private resources use a short-lived `agent_access` token scoped to exactly one resource.
Register the resource with `agentReadable`, add a read-only JSON context endpoint, inject the SSR discovery script with `renderAgentReadableResourceDiscoveryScript()`, and let agents call `create-agent-resource-link` when they need a temporary private URL. The endpoint must return data only when the row is `public` or `verifyScopedAgentAccessToken()` accepts the token for that exact `resourceKind` and `resourceId`. Declare `agentRead: { actions: ["get-<thing>"] }` (and `idParam` when the tool's id argument is not `id`) so the share panel's Send to menu offers Open in Claude, Claude Code, and Codex with a prompt that calls that MCP tool with the person's own permissions.
## إنشاءه في قالب جديد {#building}
إذا كنت تقوم بإنشاء قالب (راجع [Creating Templates](/docs/creating-templates))، فإن مشاركة الأسلاك تكون قصيرة. إضافتان إلى مخططك:
```ts
import {
table,
text,
ownableColumns,
createSharesTable,
} from "@agent-native/core/db/schema";
export const decks = table("decks", {
id: text("id").primaryKey(),
title: text("title").notNull(),
data: text("data").notNull(),
...ownableColumns(), // adds owner_email, org_id, visibility
});
export const deckShares = createSharesTable("deck_shares");
```
<DataModel
id="doc-block-1ebud6w"
title={"جدول المشاركات + الموارد المرافقة"}
summary={
"Coarse visibility lives on the resource; each fine-grained grant is a row in the shares table."
}
entities={[
{
id: "deck",
name: "decks",
note: "...ownableColumns()",
fields: [
{
name: "id",
type: "text",
pk: true,
},
{
name: "title",
type: "text",
nullable: false,
},
{
name: "owner_email",
type: "text",
nullable: false,
note: "المصدر الوحيد للحقيقة للملكية.",
},
{
name: "org_id",
type: "text",
nullable: true,
},
{
name: "visibility",
type: "enum",
nullable: false,
note: "خاص | منظمة | عام",
},
],
},
{
id: "deckShare",
name: "deck_shares",
note: "createSharesTable() — one row per grant",
fields: [
{
name: "id",
type: "text",
pk: true,
},
{
name: "resource_id",
type: "text",
fk: "decks.id",
nullable: false,
},
{
name: "principal_type",
type: "enum",
note: "المستخدم | ORG",
},
{
name: "principal_id",
type: "text",
note: "email (user) or org id (org)",
},
{
name: "role",
type: "enum",
note: "عارض | معلّق | محرر | admin",
},
{
name: "created_by",
type: "text",
},
{
name: "created_at",
type: "text",
},
],
},
]}
relations={[
{
from: "deckShare",
to: "deck",
kind: "n-n",
label: "grants access to",
},
]}
/>
مكالمة تسجيل واحدة في `server/db/index.ts`:
```ts filename="server/db/index.ts"
import { registerShareableResource } from "@agent-native/core/sharing";
registerShareableResource({
type: "deck",
resourceTable: schema.decks,
sharesTable: schema.deckShares,
displayName: "Deck",
titleColumn: "title",
getResourcePath: (deck) => `/deck/${deck.id}`,
getDb,
});
```
بعد ذلك، تمر استعلامات القائمة/القراءة عبر `accessFilter()` وتكتب actions وتستخدم `assertAccess()` لفرض الأدوار.
### أعلام التقسية الاختيارية {#hardening-flags}
يقبل `registerShareableResource` علامتي أمان للموارد التي تنفذ تعليمات برمجية أو تحمل ثقة عالية:
```ts
registerShareableResource({
type: "extension",
resourceTable: schema.extensions,
sharesTable: schema.extensionShares,
// ...
allowPublic: false, // Reject set-resource-visibility → "public"
requireOrgMemberForUserShares: true, // Reject user grants to non-org emails
});
```
يمنع `allowPublic: false` أي متصل - الوكيل أو UI - من ضبط رؤية المورد على `public`. يرفض `requireOrgMemberForUserShares: true` منح المستخدم الفردي لعناوين البريد الإلكتروني خارج مؤسسة مالك المورد. تقوم الامتدادات بتعيين كليهما: يتم تشغيل HTML للامتداد داخل إطار iframe الذي يستدعي actions وDB باعتباره _viewer_، لذا فإن الوصول العام سيكون رمزًا عشوائيًا باستخدام بيانات اعتماد العارض.
<Callout id="doc-block-1ehh444" tone="risk">
For resources that execute code or carry elevated trust (like extensions), set `allowPublic: false` and `requireOrgMemberForUserShares: true`. Otherwise a public share becomes arbitrary code running with the _viewer's_ credentials.
</Callout>
يوفر `getResourcePath` لرسائل البريد الإلكتروني الخاصة بالإشعارات رابطًا احتياطيًا مباشرًا عند إنشاء مشاركة بواسطة الوكيل أو متصل آخر غير UI. النمط الكامل (بما في ذلك ختم ملكية الإجراء الإنشاء وصفة الترحيل للجداول الموجودة) موجود في مهارة وكيل `sharing` - يقرأها الوكيل عند الطلب عند إنشاء ميزة مدركة للمشاركة.
## الضمانات الأمنية {#security}
مشاركة الرحلات على نموذج تحديد نطاق البيانات الأوسع لإطار العمل - الوصول إلى القائمة/القراءة/الكتابة إلى الجداول القابلة للملكية يمر عبر `accessFilter()` / `resolveAccess()` / `assertAccess()`, وتكون الموارد ذات العلامات `org_id` غير مرئية عبر المؤسسات. راجع [Security → Data Scoping](/docs/security#data-scoping) للتعرف على المسار الكامل وحارس CI وسطح التهديد.
## الخطوة التالية {#see-also}
- [**الأمان — تحديد نطاق البيانات**](/docs/security#data-scoping) — نموذج تصفية الوصول والملكية الذي تعتمد عليه المشاركة
- [**المصادقة**](/docs/authentication) — الجلسات والمؤسسات وكيف تتدفق الهوية إلى سياق الطلب
- [**الإضافات**](/docs/extensions#sharing) — المشاركة في سطح التطبيقات المصغرة المعزول
- [**إنشاء القوالب**](/docs/creating-templates) — توصيل `ownableColumns` بمخطط قالب جديد
## سجل المحادثات المشتركة
يوفر `@agent-native/toolkit/app/chat/ownership-history` المكوّن `useOwnershipChatHistory()` و`OwnershipChatHistoryRail` لشريط محادثات يعرض محادثاتك والمحادثات المشتركة كلٌ على حدة. يعرض صفوف المالك وأساس الوصول، ويقسّم الصفحات لكل قسم، ويُبقي الصفوف والتغييرات المحلية عند فشل التحديث.
تظل المسودة النشطة الفارغة قابلة للتحديد والتشغيل أثناء انتظار حفظها لأول مرة. إلى أن يتأكد حفظها، أخفِ إجراءات التثبيت وإعادة التسمية والأرشفة، كما يرفض المحوّل استدعاءات هذه الدوال قسرًا. يوفّر `ownDraftRows` معلومات مصدر الحفظ للمسودات المملوكة، بينما تحتفظ الصفوف المملوكة المؤكدة من قائمة الخادم بإجراءاتها المعتادة. عند إنشاء قيم `OwnDraftRow` مخصصة، اضبط الحقل الاختياري `persisted?: boolean` على `true` فقط لصف محفوظ على الخادم ومؤكد الملكية للمستخدم الحالي. لا تستنتج الحفظ من عدد الرسائل أو المعرّف النشط. يظل الدور والخصوصية وحالة فراغ المسودة النشطة أمورًا مستقلة.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-changelog-updatemorluto/reaPrepare or rewrite REA release changelogs and GitHub release notes from pinned Git history, with verified contributor thanks and Release Please synchronization. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| academy-guideanthropics/skillsStop and check this skill before finishing any reply to a question about how to use Claude or a Claude product — it recommends matching courses, tutorials, and use cases from Claude Academy (academy.claude.com), Anthropic's learning hub. Trigger on: "how do I", "how can I", "getting started with", "what can Claude do", "teach me", "learn to use"; questions about artifacts, projects, skills, plugins, connectors, MCP; requests about rolling Claude out to a team, class, or organization; and any ask for training materials, onboarding content, or learning resources. Use it when the user is learning how to use a feature or product — not when they are mid-task and just want the task done. This skill composes with other skills: after consulting product documentation to answer how a Claude feature works, also check here for a matching course or tutorial — a docs-grounded answer and an Academy recommendation belong together. Only recommend on a strong match; never invent Academy content. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| claude-apianthropics/skillsReference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file). | Stars: 198k | Updated | Claude CodeCodex | Unverified | Install |
| doc-coauthoringanthropics/skillsGuide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |