cc-viewer 1.7.21 → 1.7.23

package/server/pty-manager.js

@@ -239,6 +239,12 @@ async function _spawnClaudeImpl(proxyPort, cwd, extraArgs = [], claudePath = nul
   env.CCV_LOG_DIR = LOG_DIR; // 让 fork 出的 Claude Code 进程找到同一份 profile.json 等资源
   // 剥离 cc-viewer 的内部短路开关，避免泄漏给 claude 子进程
   delete env.CCV_SKIP_THINKING_DISPLAY;
+  // 剥离 server 专属的模式标记：spawned claude（尤其 teammate 子进程，它们会装 fetch hook）
+  // 不是 ccv server —— 继承 CCV_WORKSPACE_MODE 会让 interceptor 的 workspace 绑定终生为空
+  // （teammate 角色分配静默失效）；CCV_ELECTRON_MULTITAB 同理只应由 server 进程持有
+  // （im-process-manager 对 IM worker 已有同款剥离先例）。
+  delete env.CCV_WORKSPACE_MODE;
+  delete env.CCV_ELECTRON_MULTITAB;
   // Claude Code NO_FLICKER 会让嵌入式 xterm 走 alt-screen 并丢失 scrollback。
   // cc-viewer 默认剥离继承值；确实需要时可显式设 CCV_KEEP_CLAUDE_CODE_NO_FLICKER=1。
   stripClaudeNoFlickerUnlessOptedIn(env);

package/server/routes/expert.js

@@ -7,11 +7,15 @@
 // 鉴权沿用 dispatch 之前的全局鉴权（与 files-fs 写操作一致，不额外 gate isLocal）。
 import { join } from 'node:path';
 import { readFileSync } from 'node:fs';
-import { readWorkspaceSystemText, writeWorkspaceSystemText } from '../lib/system-prompt-files.js';
+import {
+  readWorkspaceSystemText, writeWorkspaceSystemText,
+  isNonEmptyFile, SYSTEM_PROMPT_FILE, APPEND_SYSTEM_PROMPT_FILE, DISABLE_AUTO_SYSTEM_PROMPT_ENV,
+} from '../lib/system-prompt-files.js';
 import {
   MODEL_PROMPT_DIR, normalizeModelName, listModelPrompts,
-  writeModelPrompt, deleteModelPrompt,
+  writeModelPrompt, deleteModelPrompt, matchModelPrompt,
 } from '../lib/model-system-prompts.js';
+import { resolveSpawnModel } from '../lib/spawn-model-resolver.js';
 import { listSystemPromptPresets, groupPresetsByCategory, getSystemPromptVariablesDoc } from '../lib/system-prompt-presets.js';
 import { LOG_DIR } from '../../findcc.js';
 
@@ -37,6 +41,30 @@ function sendJson(res, code, obj) {
   } catch { /* socket 已关闭：忽略 */ }
 }
 
+// Single source for "is a custom system prompt configured to inject" — mirrors the
+// spawn-time injection semantics of buildSystemPromptFileArgs: the env kill switch wins;
+// a matched model entry supersedes the Default sentinels for activation purposes.
+// Fidelity note: spawn-only gates this helper cannot see (insideLogDir skip, manual
+// --system-prompt-file flags, one-shot skip tokens) may rarely make "active" a false
+// positive — acceptable for a UI hint.
+function computeSystemPromptStatus(dir) {
+  if (process.env[DISABLE_AUTO_SYSTEM_PROMPT_ENV] === '1') {
+    return { active: false, modelId: null, matched: null, defaultActive: false };
+  }
+  const defaultActive = !!dir && (
+    isNonEmptyFile(join(dir, SYSTEM_PROMPT_FILE)) || isNonEmptyFile(join(dir, APPEND_SYSTEM_PROMPT_FILE))
+  );
+  const modelId = resolveSpawnModel(dir, process.env);
+  const match = modelId
+    ? matchModelPrompt(modelId, [
+        { dir: dir ? join(dir, MODEL_PROMPT_DIR) : null, scope: 'workspace' },
+        { dir: join(LOG_DIR, MODEL_PROMPT_DIR), scope: 'global' },
+      ])
+    : null;
+  const matched = match ? { scope: match.scope, name: match.name, mode: match.mode } : null;
+  return { active: !!matched || defaultActive, modelId, matched, defaultActive };
+}
+
 async function getSystemText(req, res, parsedUrl, isLocal, deps) {
   try {
     const dir = await resolveDir(deps);
@@ -95,12 +123,17 @@ async function getModelPrompts(req, res, parsedUrl, isLocal, deps) {
   try {
     const dir = await resolveDir(deps);
     const globalDir = join(LOG_DIR, MODEL_PROMPT_DIR);
+    const status = computeSystemPromptStatus(dir);
     sendJson(res, 200, {
       workspaceDir: dir || null,
       workspaceActive: !!dir,
       globalDir,
       workspace: dir ? collectModelEntries(join(dir, MODEL_PROMPT_DIR)) : [],
       global: collectModelEntries(globalDir),
+      // 当前生效配置解析出的模型 id 及其命中的条目(未命中为 null)——弹窗据此把默认页签
+      // 指向命中条目；matched.name 为规范化大写名，与页签 key 的构成一致。
+      modelId: status.modelId,
+      matched: status.matched,
     });
   } catch (e) {
     console.error('[CC Viewer] expert model-prompts GET failed:', e.message);
@@ -108,6 +141,17 @@ async function getModelPrompts(req, res, parsedUrl, isLocal, deps) {
   }
 }
 
+// 轻量状态查询(不内联提示词文本)：头部工具栏据此决定是否自动露出「系统提示词修改」入口。
+async function getSystemPromptStatus(req, res, parsedUrl, isLocal, deps) {
+  try {
+    const dir = await resolveDir(deps);
+    sendJson(res, 200, computeSystemPromptStatus(dir));
+  } catch (e) {
+    console.error('[CC Viewer] expert system-prompt-status GET failed:', e.message);
+    sendJson(res, 500, { error: 'read_failed' });
+  }
+}
+
 function postModelPrompts(req, res, parsedUrl, isLocal, deps) {
   let body = '';
   let truncated = false;
@@ -174,4 +218,5 @@ export const expertRoutes = [
   { method: 'GET', match: 'exact', path: '/api/expert/model-prompts', handler: getModelPrompts },
   { method: 'POST', match: 'exact', path: '/api/expert/model-prompts', handler: postModelPrompts },
   { method: 'GET', match: 'exact', path: '/api/expert/system-prompt-presets', handler: getSystemPromptPresets },
+  { method: 'GET', match: 'exact', path: '/api/expert/system-prompt-status', handler: getSystemPromptStatus },
 ];

package/server/routes/preferences.js

@@ -3,8 +3,8 @@ import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
 import { LOG_DIR, setLogDir, getClaudeConfigDir, discoverClaudeExecutables, resolveExplicitClaudePath, CLAUDE_EXECUTABLE_PREF_KEY } from '../../findcc.js';
-import { PROFILE_PATH, _defaultConfig, getActiveProfileId, setActiveProfileForWorkspace, _loadProxyProfile, RETRY_CONFIG_PATH, _retryConfigState, _loadRetryConfigState } from '../interceptor.js';
-import { migrateProxyProfileList } from '../lib/interceptor-core.js';
+import { PROFILE_PATH, _defaultConfig, getActiveProfileId, getStoredRoles, isOfficialDefaultEndpoint, setActiveProfileForWorkspace, _loadProxyProfile, RETRY_CONFIG_PATH, _retryConfigState, _loadRetryConfigState } from '../interceptor.js';
+import { migrateProxyProfileList, isValidRoleValue, PROXY_ROLE_KEYS } from '../lib/interceptor-core.js';
 import { DEFAULT_RETRY_CONFIG, validateRetryConfig, resolveRetryConfig } from '../lib/proxy-retry.js';
 import { discoverCcSwitchProviders, mergeImportedProfiles } from '../lib/ccswitch-import.js';
 import { reportSwallowed } from '../lib/error-report.js';
@@ -307,7 +307,9 @@ function proxyProfilesGet(req, res, parsedUrl, isLocal, deps) {
     // 本机(127.0.0.1)= admin：下发明文 profile.apiKey 供本人在编辑表单(👁 折叠)里查阅/复制；已授权
     // 的远程客户端只拿脱敏值(****+后4位)。保存时若回传脱敏值，POST 侧 isMasked() 会保留磁盘原值。
     // 镜像 /api/auth/state 的密码、/api/dingtalk/status 的 appSecret 策略。
-    const full = { ...data, active: effectiveActive };
+    // roles 返回**存储值**（不做休眠调整）：休眠只是请求侧不生效，若返回有效值，UI 缓存后
+    // 在下次无关 POST 回写会把休眠中的分配清掉。officialDefault 驱动 UI 隐藏角色分配区。
+    const full = { ...data, active: effectiveActive, roles: getStoredRoles(), officialDefault: isOfficialDefaultEndpoint() };
     const payload = isLocal ? full : deps.maskProfiles(full);
     // defaultConfig.apiKey 始终脱敏：它在列表里是常显文本(无 👁 折叠)，且 Max/OAuth 默认配置的 key
     // 可能是 OAuth token；只有可编辑 profile 的 key 才按 isLocal 明文下发。
@@ -351,9 +353,24 @@ function proxyProfilesPost(req, res, parsedUrl, isLocal, deps) {
       const dir = dirname(PROFILE_PATH);
       if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
       writeFileSync(PROFILE_PATH, JSON.stringify(toWrite, null, 2), { mode: 0o600 });
-      // active 走 workspace 级别存储（当前进程独占）
-      if (typeof incoming.active === 'string' && incoming.active) {
-        setActiveProfileForWorkspace(incoming.active);
+      // 角色分配校验：只认 subagent/teammate 两个 key（roles.main 之类的杂键直接丢弃）；
+      // 值必须是 follow / max / 入参 profiles 里存在的 id（按将落盘的列表校验，而非旧文件），
+      // 非法值归 'follow'（宽容风格，不 400）。被删 profile 的悬空角色由读取时归 follow 兜底。
+      let sanitizedRoles;
+      if (incoming.roles && typeof incoming.roles === 'object' && !Array.isArray(incoming.roles)) {
+        const byId = new Map(incoming.profiles.map(p => [p.id, p]));
+        sanitizedRoles = {};
+        for (const k of PROXY_ROLE_KEYS) {
+          if (!(k in incoming.roles)) continue; // 未提交的 key 不进 patch → 合并时保留存储值
+          const v = incoming.roles[k];
+          // key 提交了但值非法（非字符串 / 悬空 id）→ 归 'follow'（显式纠正，不是保留）
+          sanitizedRoles[k] = (typeof v === 'string' && v && isValidRoleValue(v, byId)) ? v : 'follow';
+        }
+      }
+      // active/roles 走 workspace 级别存储（当前进程独占）；合并语义：缺省字段保留文件现值
+      const hasActive = typeof incoming.active === 'string' && incoming.active;
+      if (hasActive || sanitizedRoles) {
+        setActiveProfileForWorkspace(hasActive ? incoming.active : undefined, sanitizedRoles);
       } else {
         _loadProxyProfile(); // 仅列表变化时也刷新一次以反映删除 / 重命名
       }
@@ -361,7 +378,7 @@ function proxyProfilesPost(req, res, parsedUrl, isLocal, deps) {
       const effectiveActive = getActiveProfileId();
       const activeProfile = incoming.profiles?.find(p => p.id === effectiveActive) || null;
       const maskedProfile = activeProfile?.apiKey ? { ...activeProfile, apiKey: deps.maskApiKey(activeProfile.apiKey) } : activeProfile;
-      sendEventToClients(deps.clients, 'proxy_profile', { active: effectiveActive, profile: maskedProfile });
+      sendEventToClients(deps.clients, 'proxy_profile', { active: effectiveActive, profile: maskedProfile, roles: getStoredRoles() });
       res.writeHead(200, { 'Content-Type': 'application/json' });
       res.end(JSON.stringify({ ok: true }));
     } catch {

package/src/utils/toolCatalog.js

@@ -13,17 +13,18 @@
  * Category `key` maps to i18n `ui.toolCatalog.cat.<key>` in src/i18n.js.
  */
 export const TOOL_CATALOG = [
-  { key: 'agent',    tools: ['Agent', 'TaskCreate', 'TaskGet', 'TaskUpdate', 'TaskList', 'TaskOutput', 'TaskStop'] },
-  { key: 'team',     tools: ['TeamCreate', 'TeamDelete', 'SendMessage', 'Workflow', 'Monitor'] },
+  { key: 'agent',    tools: ['Agent', 'TaskCreate', 'TaskGet', 'TaskUpdate', 'TaskList', 'TaskOutput', 'TaskStop', 'ListAgents'] },
+  { key: 'team',     tools: ['SendMessage', 'Workflow', 'Monitor', 'SendFile', 'SendUserFile', 'SendUserMessage', 'EndConversation'] },
   { key: 'file',     tools: ['Read', 'Edit', 'Write', 'NotebookEdit'] },
   { key: 'search',   tools: ['Glob', 'Grep', 'ToolSearch'] },
-  { key: 'terminal', tools: ['Bash'] },
+  { key: 'terminal', tools: ['Bash', 'REPL'] },
   { key: 'web',      tools: ['WebFetch', 'WebSearch', 'Artifact', 'DesignSync'] },
-  { key: 'planning', tools: ['EnterPlanMode', 'ExitPlanMode', 'AskUserQuestion', 'Skill', 'ReportFindings'] },
+  { key: 'planning', tools: ['EnterPlanMode', 'ExitPlanMode', 'AskUserQuestion', 'Skill', 'ReportFindings', 'TodoWrite', 'SendFeedback', 'Projects', 'ProposeGoal'] },
   { key: 'worktree', tools: ['EnterWorktree', 'ExitWorktree'] },
-  { key: 'schedule', tools: ['CronCreate', 'CronDelete', 'CronList', 'ScheduleWakeup', 'PushNotification', 'RemoteTrigger'] },
-  { key: 'ide',      tools: ['getDiagnostics', 'executeCode', 'LSP'] },
+  { key: 'schedule', tools: ['CronCreate', 'CronDelete', 'CronList', 'ScheduleWakeup', 'PushNotification', 'RemoteTrigger', 'ReadNotifications'] },
+  { key: 'ide',      tools: ['LSP'] },
+  { key: 'mcp',      tools: ['ReadMcpResource', 'ReadMcpResourceDir', 'ListMcpResources', 'SearchMcpRegistry', 'SuggestConnectors', 'ListConnectors', 'SuggestPluginInstall', 'SuggestSkills', 'ListPlugins', 'ListSkills'] },
 ];
 
-// Flat list of all tool names (40) — order follows TOOL_CATALOG.
+// Flat list of all tool names (57) — order follows TOOL_CATALOG.
 export const ALL_TOOL_NAMES = TOOL_CATALOG.flatMap((c) => c.tools);

package/src/utils/v3Assembler.js

@@ -95,6 +95,7 @@ export function createV3Assembler() {
       // teammates, persisted server-side (see agent-id.js).
       if (row.agent) entry.agent = row.agent;
       if (row.proxyUrl) entry.proxyUrl = row.proxyUrl;
+      if (row.proxyRole) entry.proxyRole = row.proxyRole;
       if (isSnapshot) entry._isCheckpoint = true;
       if (row.inProgress) {
         entry.inProgress = true;

package/src/utils/v3Rows.js

@@ -17,6 +17,7 @@ export function rowToListItem(row) {
     timestamp: row.timestamp,
     url: row.url,
     proxyUrl: row.proxyUrl,
+    proxyRole: row.proxyRole,
     duration: row.duration,
     inProgress: row.inProgress === true,
     isHeartbeat: row.kind === 'heartbeat',

package/concepts/ar/Tool-TeamCreate.md

@@ -1,53 +0,0 @@
-# TeamCreate
-
-يُنشئ فريق تعاون جديداً بقائمة مهام مشتركة وقناة رسائل بين الوكلاء. الفريق هو الأصل التنسيقي للعمل متعدد الوكلاء — تعمل الجلسة الرئيسية بوصفها قائداً وتُطلق زملاء فريق مسمَّين عبر أداة `Agent`.
-
-## متى يُستخدم
-
-- عندما يطلب المستخدم صراحةً فريقاً أو سرباً أو طاقماً أو تعاوناً متعدد الوكلاء.
-- عندما يحتوي مشروع على عدة مسارات عمل مستقلة بوضوح تستفيد من متخصصين مخصصين (مثل واجهة أمامية، خلفية، اختبارات، توثيق).
-- عندما تحتاج إلى قائمة مهام مشتركة دائمة يُحدّثها عدة وكلاء مع تقدمهم.
-- عندما تريد زملاء فريق مسمَّين وقابلين للعنونة يمكنهم تبادل الرسائل عبر `SendMessage` بدلاً من استدعاءات وكيل فرعي ذات لقطة واحدة.
-
-لا تستخدمه لبحث مُفوَّض واحد أو تفرُّع موازٍ لمرة واحدة — استدعاءات `Agent` العادية أخف وكافية.
-
-## المعاملات
-
-- `team_name` (سلسلة، مطلوب): معرف فريد للفريق. يُستخدم كاسم دليل تحت `~/.claude/teams/` وكوسيطة `team_name` عند إطلاق زملاء الفريق.
-- `description` (سلسلة، مطلوب): بيان قصير لهدف الفريق. يُعرض على كل زميل فريق عند الإطلاق ويُكتب في إعداد الفريق.
-- `agent_type` (سلسلة، اختياري): شخصية الوكيل الفرعي الافتراضية المطبقة على زملاء الفريق الذين لا يتجاوزونها. القيم النموذجية هي `general-purpose` أو `Explore` أو `Plan`.
-
-## أمثلة
-
-### مثال 1: إنشاء فريق إعادة هيكلة
-
-```
-TeamCreate(
-  team_name="refactor-crew",
-  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
-  agent_type="general-purpose"
-)
-```
-
-بعد الإنشاء، أطلق زملاء فريق بـ `Agent` باستخدام `team_name: "refactor-crew"` وقيم `name` متميزة مثل `db-lead` و`migrations` و`tests`.
-
-### مثال 2: إنشاء فريق تحقيق
-
-```
-TeamCreate(
-  team_name="perf-investigation",
-  description="Identify and rank the top three performance regressions introduced in the last release.",
-  agent_type="Explore"
-)
-```
-
-يرث كل زميل فريق مُطلق `Explore` بوصفه شخصيته الافتراضية، بما يتوافق مع الطبيعة التحقيقية للقراءة فقط للعمل.
-
-## ملاحظات
-
-- يمكن قيادة فريق واحد فقط في كل مرة من جلسة معينة. أنهِ أو احذف الفريق الحالي قبل إنشاء آخر.
-- الفريق 1:1 مع قائمة مهام مشتركة. يمتلك القائد إنشاء المهام وتعيينها وإغلاقها؛ بينما يُحدِّث زملاء الفريق حالة المهام التي يعملون عليها.
-- يُستمر إعداد الفريق في `~/.claude/teams/{team_name}/config.json`، ويعيش دليل المهام بجواره. هذه الملفات تبقى عبر الجلسات حتى تُزال صراحةً بـ `TeamDelete`.
-- يُطلق زملاء الفريق باستخدام أداة `Agent` مع `team_name` مطابق بالإضافة إلى `name` متميز. يصبح `name` هو العنوان المستخدم بواسطة `SendMessage`.
-- اختر `team_name` آمناً لنظام الملفات (أحرف وأرقام وشرطات وشرطات سفلية). تجنب المسافات أو الشرطات المائلة.
-- اكتب `description` بحيث يُفهم زميل فريق جديد، يقرؤه بدون سياق، هدف الفريق دون مزيد من السياق. يصبح جزءاً من موجه بدء كل زميل فريق.

package/concepts/ar/Tool-TeamDelete.md

@@ -1,44 +0,0 @@
-# TeamDelete
-
-يُفكك الفريق النشط حالياً، ويُزيل دليل إعداده ودليل المهام المشترك. هذا هو نظير التنظيف لـ `TeamCreate` ويُستدعى عادة بعد تحقيق هدف الفريق وإيقاف جميع زملاء الفريق.
-
-## متى يُستخدم
-
-- عندما يكمل الفريق عمله ويُسلَّم التقرير النهائي للمستخدم.
-- عندما أُنشئ الفريق عن طريق الخطأ أو تغير نطاقه بشكل جذري بحيث يكون البدء من جديد أنظف من المتابعة.
-- عندما تحتاج إلى إنشاء فريق جديد لكن واحداً نشط بالفعل — احذف القديم أولاً، لأنه يمكن قيادة فريق واحد فقط في كل مرة.
-- عندما يصبح فريق راكداً عبر الجلسات ولا تعود حالته المستمرة تحت `~/.claude/teams/` مطلوبة.
-
-لا تستدعِه بينما لا يزال زملاء الفريق يعملون — أوقفهم أولاً عبر `SendMessage` بـ `shutdown_request`، وانتظر كل `shutdown_response`، ثم احذف.
-
-## المعاملات
-
-`TeamDelete` لا يأخذ معاملات في استدعائه النموذجي. يعمل على الفريق النشط حالياً الذي تملكه الجلسة المُستدعية.
-
-## أمثلة
-
-### مثال 1: إيقاف تشغيل روتيني بعد النجاح
-
-1. بث طلب إيقاف تشغيل للفريق:
-   ```
-   SendMessage(to="*", message={ "type": "shutdown_request" })
-   ```
-2. انتظر رد كل زميل فريق بـ `shutdown_response`.
-3. استدعِ `TeamDelete()` لإزالة دليل الفريق ودليل المهام.
-
-### مثال 2: استبدال فريق معدّ بشكل خاطئ
-
-إذا استُدعي `TeamCreate` بـ `agent_type` أو `description` خاطئ، تأكد أولاً من عدم إطلاق أي زملاء فريق بعد (أو أوقفهم)، ثم:
-
-```
-TeamDelete()
-TeamCreate(team_name="...", description="...", agent_type="...")
-```
-
-## ملاحظات
-
-- يفشل `TeamDelete` إذا كان أي زميل فريق لا يزال نشطاً. تسرد استجابة الخطأ زملاء الفريق الأحياء — أرسل لكل منهم `shutdown_request` عبر `SendMessage`، وانتظر `shutdown_response` الخاص بهم، وأعد المحاولة.
-- الحذف لا يمكن التراجع عنه من منظور الأداة. إعداد الفريق في `~/.claude/teams/{team_name}/config.json` ودليل مهامه يُزالان من القرص. إذا احتجت إلى الحفاظ على قائمة المهام، فصدِّرها أو انسخ الدليل قبل الحذف.
-- فقط جلسة القائد التي أنشأت الفريق يمكنها حذفه. لا يمكن لزميل فريق مُطلق أن يستدعي `TeamDelete` على فريقه الخاص.
-- حذف الفريق لا يتراجع عن أي تغييرات في نظام الملفات أجراها زملاء الفريق في المستودع. تلك تعديلات عادية متعقَّبة بـ git ويجب التراجع عنها بشكل منفصل إذا لم تكن مرغوبة.
-- بعد عودة `TeamDelete` بنجاح، تكون الجلسة حرة في استدعاء `TeamCreate` مرة أخرى لفريق جديد.

package/concepts/ar/Tool-executeCode.md

@@ -1,47 +0,0 @@
-# executeCode
-
-يُنفِّذ مقتطف شفرة داخل نواة حية أو صندوق رمل يُقدِّمه تكامل IDE (مثل نواة Jupyter المرتبطة بالدفتر المفتوح حالياً). تكون الأداة موجودة فقط عندما يعمل Claude Code جنباً إلى جنب مع جسر IDE متوافق مثل ملحق VS Code مع نواة Jupyter محددة.
-
-## متى يُستخدم
-
-- تشغيل حساب سريع أو فحص بيانات أو رسم مقابل الحالة المحمَّلة بالفعل في نواة Jupyter نشطة.
-- التحقق من مقتطف شفرة قبل لصقه في خلية دفتر.
-- استكشاف إطار بيانات في الذاكرة أو متغير أو نموذج موجود في النواة لكن غير مُسلسل على القرص.
-- إنتاج رسم بياني أو نتيجة عددية يريد المستخدم عرضها داخلياً في IDE.
-
-لا تستخدمه لسكربتات مستقلة تكون أفضل بتشغيل `Bash` لـ `python script.py`، أو لشفرة تحتاج إلى الاستمرار عبر نواة جديدة.
-
-## المعاملات
-
-- `code` (سلسلة، مطلوب): الشفرة المراد تنفيذها في النواة الحالية. تعمل كما لو لُصقت في خلية دفتر — المتغيرات المُعرَّفة تستمر في النواة حتى يُعاد تشغيلها.
-- `language` (سلسلة، اختياري): لغة المقتطف عندما يدعم جسر IDE عدة أنوية. غالباً ما يُحذف؛ الافتراضي هو لغة النواة النشطة (Python عادة).
-
-## أمثلة
-
-### مثال 1: فحص إطار بيانات في الذاكرة
-
-```
-executeCode(
-  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
-)
-```
-
-يُعيد الصفوف الأولى والشكل وأنواع الأعمدة لإطار بيانات مُحمَّل بالفعل في النواة.
-
-### مثال 2: فحص عددي سريع
-
-```
-executeCode(
-  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
-)
-```
-
-يُشغِّل حساباً لمرة واحدة دون إنشاء خلية دفتر.
-
-## ملاحظات
-
-- `executeCode` أداة جسر IDE. غير متاحة في جلسات Claude Code العادية في الطرفية؛ تظهر فقط عندما تكون الجلسة متصلة بـ IDE يعرض نواة (مثل ملحق Jupyter لـ VS Code).
-- الحالة تستمر في النواة. المتغيرات المُعرَّفة باستدعاء `executeCode` تبقى مرئية للاستدعاءات اللاحقة ولخلايا الدفتر وللمستخدم — كن مدركاً للآثار الجانبية.
-- ستحجب الشفرة طويلة الأمد أو الحاجبة النواة. أبقِ المقتطفات قصيرة؛ للعمل الذي يستغرق عدة دقائق، اكتب سكربتاً فعلياً وشغِّله عبر `Bash`.
-- تُعاد المخرجات (stdout، القيم المُرجعة، الصور) إلى الجلسة. قد يُقتطع جسر IDE المخرجات الكبيرة جداً.
-- لتعديلات الملفات، فضِّل `Edit` أو `Write` أو `NotebookEdit` — `executeCode` ليس بديلاً لتأليف ملفات المصدر.

package/concepts/ar/Tool-getDiagnostics.md

@@ -1,44 +0,0 @@
-# getDiagnostics
-
-يسترجع تشخيصات خادم اللغة (أخطاء، تحذيرات، تلميحات) من IDE المتصل لملف معين أو لكل ملف يفتحه IDE حالياً. يُستخدم للتحقق من أن تغييرات الشفرة تُصنَّف نظيفاً قبل الإعلان عن إنجاز المهمة.
-
-## متى يُستخدم
-
-- بعد `Edit` أو `Write` للتأكد من أن التغيير لم يُدخل خطأ نوع أو صياغة أو تحذير lint.
-- قبل إنهاء مهمة لمسح كل ملف مفتوح بحثاً عن مشاكل غير محلولة.
-- عند تشخيص خطأ يُبلِّغ عنه المستخدم — سحب الرسالة الدقيقة من المُصنِّف أو مُفحص النوع من IDE يتجنب التخمين.
-- كبديل خفيف لتشغيل أمر بناء أو اختبار كامل عندما تحتاج فقط إلى فحص الصحة الثابتة.
-
-لا تعتمد على `getDiagnostics` بديلاً لمجموعة الاختبارات. يُبلِّغ عما يراه خادم اللغة، لا عما يعمل في وقت الاختبار أو الإنتاج.
-
-## المعاملات
-
-- `uri` (سلسلة، اختياري): URI الملف (عادة `file:///absolute/path`) لجلب تشخيصات له. عند الحذف، تُعيد الأداة التشخيصات لكل ملف يفتحه IDE حالياً.
-
-## أمثلة
-
-### مثال 1: فحص ملف واحد بعد التعديل
-
-```
-getDiagnostics(
-  uri="file:///Users/sky/project/src/auth.ts"
-)
-```
-
-يُعيد أي أخطاء TypeScript أو تحذيرات ESLint أو رسائل خادم اللغة الأخرى لـ `src/auth.ts`.
-
-### مثال 2: مسح جميع الملفات المفتوحة
-
-```
-getDiagnostics()
-```
-
-يُعيد التشخيصات عبر كل محرر مفتوح حالياً. مفيد في نهاية إعادة هيكلة متعددة الملفات للتأكد من عدم تراجع أي شيء آخر.
-
-## ملاحظات
-
-- `getDiagnostics` أداة جسر IDE. متاحة فقط عندما يكون Claude Code متصلاً بتكامل IDE داعم (مثل ملحق VS Code). في جلسة طرفية عادية لن تظهر الأداة.
-- تعكس النتائج أياً من خوادم اللغة التي حمَّلها IDE — TypeScript، Pyright، ESLint، rust-analyzer، إلخ. الجودة والتغطية تعتمدان على إعداد IDE للمستخدم، لا على Claude Code.
-- التشخيصات حية. بعد التعديل، أعطِ خادم اللغة لحظة لإعادة التحليل قبل تفسير نتيجة فارغة نجاحاً — أعد التشغيل إذا كان الملف قد حُفظ للتو.
-- تشمل مستويات الخطورة عادة `error` و`warning` و`information` و`hint`. ركِّز على `error` أولاً؛ قد تكون التحذيرات أسلوب مشروع مقصوداً.
-- للملفات غير المفتوحة حالياً في IDE، قد لا يملك خادم اللغة تشخيصات للإبلاغ عنها حتى لو احتوى الملف على مشاكل حقيقية. افتح الملف أو شغِّل البناء للتغطية الموثوقة.

package/concepts/da/Tool-TeamCreate.md

@@ -1,53 +0,0 @@
-# TeamCreate
-
-Etablerer et nyt samarbejdsteam med en delt opgaveliste og en kanal for inter-agent-beskeder. Et team er koordinationsprimitivet for multi-agent-arbejde — hovedsessionen fungerer som leder og starter navngivne holdkammerater via `Agent`-værktøjet.
-
-## Hvornår skal den bruges
-
-- Brugeren anmoder udtrykkeligt om et team, en swarm, et crew eller multi-agent-samarbejde.
-- Et projekt har flere klart uafhængige arbejdsstrømme, der drager fordel af dedikerede specialister (f.eks. frontend, backend, tests, docs).
-- Du har brug for en vedvarende delt opgaveliste, som flere agenter opdaterer, mens de gør fremskridt.
-- Du ønsker navngivne, adresserbare holdkammerater, der kan udveksle beskeder via `SendMessage` frem for one-shot underagentkald.
-
-Brug det IKKE til en enkelt delegeret søgning eller en engangs parallel fan-out — almindelige `Agent`-kald er lettere og tilstrækkelige.
-
-## Parametre
-
-- `team_name` (string, påkrævet): Unik identifikator for teamet. Bruges som mappenavn under `~/.claude/teams/` og som `team_name`-argument ved start af holdkammerater.
-- `description` (string, påkrævet): Kort erklæring om teamets mål. Vises for hver holdkammerat ved start og skrives i teamkonfigurationen.
-- `agent_type` (string, valgfri): Standard-underagent-persona anvendt på holdkammerater, der ikke tilsidesætter den. Typiske værdier er `general-purpose`, `Explore` eller `Plan`.
-
-## Eksempler
-
-### Eksempel 1: Opret et refaktoreringsteam
-
-```
-TeamCreate(
-  team_name="refactor-crew",
-  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
-  agent_type="general-purpose"
-)
-```
-
-Efter oprettelse start holdkammerater med `Agent` ved hjælp af `team_name: "refactor-crew"` og distinkte `name`-værdier som `db-lead`, `migrations` og `tests`.
-
-### Eksempel 2: Opret et undersøgelsesteam
-
-```
-TeamCreate(
-  team_name="perf-investigation",
-  description="Identify and rank the top three performance regressions introduced in the last release.",
-  agent_type="Explore"
-)
-```
-
-Hver startet holdkammerat arver `Explore` som sin standardpersona, hvilket matcher arbejdets skrivebeskyttede undersøgende natur.
-
-## Noter
-
-- Kun ét team kan ledes ad gangen fra en given session. Afslut eller slet det aktuelle team, før du opretter et andet.
-- Et team er 1:1 med en delt opgaveliste. Lederen ejer opgaveoprettelse, tildeling og lukning; holdkammerater opdaterer status på opgaver, de arbejder på.
-- Teamkonfiguration persisteres på `~/.claude/teams/{team_name}/config.json`, og opgavebiblioteket ligger ved siden af den. Disse filer overlever på tværs af sessioner, indtil de eksplicit fjernes med `TeamDelete`.
-- Holdkammerater startes ved hjælp af `Agent`-værktøjet med matchende `team_name` plus et distinkt `name`. `name` bliver den adresse, der bruges af `SendMessage`.
-- Vælg et `team_name`, der er filsystemsikkert (bogstaver, cifre, bindestreger, understregninger). Undgå mellemrum eller skråstreger.
-- Skriv `description`, så en helt ny holdkammerat, der læser den koldt, ville forstå teamets mål uden yderligere kontekst. Den bliver en del af hver holdkammerats startprompt.

package/concepts/da/Tool-TeamDelete.md

@@ -1,44 +0,0 @@
-# TeamDelete
-
-Nedbryder det aktuelt aktive team, fjerner dets konfigurationsmappe og delte opgavebibliotek. Dette er oprydningsmodstykket til `TeamCreate` og kaldes typisk, efter teamets mål er nået, og alle holdkammerater er lukket ned.
-
-## Hvornår skal den bruges
-
-- Teamet har fuldført sit arbejde, og den endelige rapport er leveret til brugeren.
-- Teamet blev oprettet ved en fejl, eller dets omfang har ændret sig så drastisk, at det er renere at starte forfra end at fortsætte.
-- Du skal oprette et nyt team, men et er allerede aktivt — slet det gamle først, da kun ét team kan ledes ad gangen.
-- Et team er blevet forældet på tværs af sessioner, og dets persisterede tilstand under `~/.claude/teams/` er ikke længere nødvendig.
-
-Kald det IKKE, mens holdkammerater stadig kører — luk dem først ned via `SendMessage` med en `shutdown_request`, vent på hver `shutdown_response`, og slet så.
-
-## Parametre
-
-`TeamDelete` tager ingen parametre i sin typiske invokering. Den opererer på det aktuelt aktive team ejet af den kaldende session.
-
-## Eksempler
-
-### Eksempel 1: Rutinemæssig nedlukning efter succes
-
-1. Broadcast en nedlukningsanmodning til teamet:
-   ```
-   SendMessage(to="*", message={ "type": "shutdown_request" })
-   ```
-2. Vent på, at hver holdkammerat svarer med et `shutdown_response`.
-3. Kald `TeamDelete()` for at fjerne teammappen og opgavebiblioteket.
-
-### Eksempel 2: Udskiftning af et fejlkonfigureret team
-
-Hvis `TeamCreate` blev kaldt med den forkerte `agent_type` eller `description`, sørg først for, at ingen holdkammerater er blevet startet endnu (eller luk dem ned), og derefter:
-
-```
-TeamDelete()
-TeamCreate(team_name="...", description="...", agent_type="...")
-```
-
-## Noter
-
-- `TeamDelete` fejler, hvis nogen holdkammerat stadig er aktiv. Fejlsvaret lister de aktive holdkammerater — send hver af dem en `shutdown_request` via `SendMessage`, vent på deres `shutdown_response`, og prøv igen.
-- Sletning er irreversibel fra værktøjets perspektiv. Teamets konfiguration på `~/.claude/teams/{team_name}/config.json` og dets opgavebibliotek fjernes fra disken. Hvis du har brug for, at opgavelisten bevares, eksportér eller kopiér biblioteket, før du sletter.
-- Kun lederens session, der oprettede teamet, kan slette det. En startet holdkammerat kan ikke kalde `TeamDelete` på sit eget team.
-- Sletning af teamet ruller ikke filsystemændringer tilbage, som holdkammerater foretog i repoet. Disse er almindelige git-sporede redigeringer og skal vendes separat, hvis uønskede.
-- Efter at `TeamDelete` er returneret med succes, er sessionen fri til at kalde `TeamCreate` igen for et nyt team.

package/concepts/da/Tool-executeCode.md

@@ -1,47 +0,0 @@
-# executeCode
-
-Udfører et kodeuddrag inde i en live kernel eller sandbox leveret af en IDE-integration (for eksempel Jupyter-kernen bundet til den aktuelt åbne notebook). Værktøjet er kun til stede, når Claude Code kører sammen med en kompatibel IDE-bro som VS Code-udvidelsen med en Jupyter-kerne valgt.
-
-## Hvornår skal den bruges
-
-- Kør en hurtig beregning, dataundersøgelse eller et plot mod den tilstand, der allerede er indlæst i en aktiv Jupyter-kerne.
-- Validér et kodeuddrag, før det indsættes i en notebook-celle.
-- Udforsk en in-memory dataframe, variabel eller model, der eksisterer i kernen, men som ikke er serialiseret til disk.
-- Producér et diagram eller numerisk resultat, som brugeren ønsker gengivet inline i IDE'et.
-
-Brug det IKKE til selvstændige scripts, der ville være bedre tjent med `Bash`, der kører `python script.py`, eller til kode, der skal persistere på tværs af en frisk kerne.
-
-## Parametre
-
-- `code` (string, påkrævet): Koden, der skal udføres i den aktuelle kerne. Kører, som om den blev indsat i en notebook-celle — definerede variabler persisterer i kernen, indtil den genstartes.
-- `language` (string, valgfri): Uddragets sprog, når IDE-broen understøtter flere kerner. Oftest udeladt; standard er sproget for den aktive kerne (typisk Python).
-
-## Eksempler
-
-### Eksempel 1: Inspicér en in-memory dataframe
-
-```
-executeCode(
-  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
-)
-```
-
-Returnerer de første rækker, formen og kolonne-dtypes for en dataframe, der allerede er indlæst i kernen.
-
-### Eksempel 2: Hurtigt numerisk tjek
-
-```
-executeCode(
-  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
-)
-```
-
-Kører en engangs-beregning uden at oprette en notebook-celle.
-
-## Noter
-
-- `executeCode` er et IDE-bro-værktøj. Det er utilgængeligt i almindelige terminalsessioner af Claude Code; det vises kun, når sessionen er forbundet til et IDE, der eksponerer en kerne (for eksempel VS Code Jupyter-udvidelsen).
-- Tilstand persisterer i kernen. Variabler defineret af et `executeCode`-kald forbliver synlige for senere kald, for notebook-celler og for brugeren — vær opmærksom på sideeffekter.
-- Langvarig eller blokerende kode vil blokere kernen. Hold uddrag korte; til flerminut-arbejde, skriv et faktisk script og kør det via `Bash`.
-- Output (stdout, returværdier, billeder) returneres til sessionen. Meget store output kan afkortes af IDE-broen.
-- Til filredigeringer foretræk `Edit`, `Write` eller `NotebookEdit` — `executeCode` er ikke en erstatning for at skrive kildefiler.

package/concepts/da/Tool-getDiagnostics.md

@@ -1,44 +0,0 @@
-# getDiagnostics
-
-Henter language-server-diagnostik (fejl, advarsler, hints) fra det tilsluttede IDE for en specifik fil eller for hver fil, IDE'et aktuelt har åben. Bruges til at verificere, at kodeændringer kompilerer rent, før en opgave erklæres færdig.
-
-## Hvornår skal den bruges
-
-- Efter en `Edit` eller `Write` for at bekræfte, at ændringen ikke introducerede en typefejl, syntaksfejl eller lint-advarsel.
-- Før en opgave afsluttes for at feje hver åben fil for uløste problemer.
-- Ved diagnosticering af en fejl, brugeren rapporterer — at hente den nøjagtige compiler- eller type-checker-besked fra IDE'et undgår gætværk.
-- Som et letvægtsalternativ til at køre en fuld build eller testkommando, når du kun har brug for at tjekke statisk korrekthed.
-
-Stol IKKE på `getDiagnostics` som erstatning for testsuiten. Den rapporterer, hvad language-serveren ser, ikke hvad der kører på test- eller produktionstidspunktet.
-
-## Parametre
-
-- `uri` (string, valgfri): Filen-URI (typisk `file:///absolute/path`) at hente diagnostik for. Når den udelades, returnerer værktøjet diagnostik for hver fil, IDE'et aktuelt har åben.
-
-## Eksempler
-
-### Eksempel 1: Tjek en enkelt fil efter redigering
-
-```
-getDiagnostics(
-  uri="file:///Users/sky/project/src/auth.ts"
-)
-```
-
-Returnerer eventuelle TypeScript-fejl, ESLint-advarsler eller andre language-server-beskeder for `src/auth.ts`.
-
-### Eksempel 2: Fej alle åbne filer
-
-```
-getDiagnostics()
-```
-
-Returnerer diagnostik på tværs af hver aktuelt åben editor. Nyttigt i slutningen af en multi-fil-refaktorering for at sikre, at intet regresserede andetsteds.
-
-## Noter
-
-- `getDiagnostics` er et IDE-bro-værktøj. Det er kun tilgængeligt, når Claude Code er forbundet til en understøttende IDE-integration (for eksempel VS Code-udvidelsen). I en almindelig terminalsession vil værktøjet ikke vises.
-- Resultaterne afspejler de language-servere, IDE'et har indlæst — TypeScript, Pyright, ESLint, rust-analyzer osv. Kvalitet og dækning afhænger af brugerens IDE-opsætning, ikke af Claude Code.
-- Diagnostik er live. Efter en redigering, giv language-serveren et øjeblik til at genanalysere, før et tomt resultat fortolkes som succes — kør igen, hvis filen lige blev gemt.
-- Alvorlighedsniveauer inkluderer typisk `error`, `warning`, `information` og `hint`. Fokusér på `error` først; advarsler kan være bevidst projektstil.
-- For filer, der ikke aktuelt er åbne i IDE'et, kan language-serveren intet have at rapportere, selv hvis filen indeholder reelle problemer. Åbn filen eller kør buildet for autoritativ dækning.