@steerable/agent-shell-web 0.6.50 → 0.6.52

package/src/components/settings/AgentsSettingsPanel.tsx

@@ -5,6 +5,7 @@ import {
   LuPlus,
   LuTrash2,
 } from 'react-icons/lu';
+import { ConfirmDialog } from '@/components/ConfirmDialog';
 import { isElectron } from '@/lib/electron-bridge';
 import {
   archiveChatAgent,
@@ -22,7 +23,7 @@ import {
 /**
  * AgentsSettingsPanel — 智能体目录（列表 / 新建 / 编辑 / 归档）。
  *
- * 渲染在 `/settings?section=agents` 独立页。自定义智能体出现在输入框
+ * 渲染在 `/settings?section=plugins` 的智能体分类。自定义智能体出现在输入框
  * 上方的专家选择器里。内置智能体可改文案与能力，不能归档。
  *
  * 除文案外，每个智能体还持有真实生效的能力面（勾选技能 / 技能范围 /
@@ -91,7 +92,10 @@ export function AgentsSettingsPanel({
   const [capability, setCapability] = useState<AgentCapabilityDraft>(
     DEFAULT_CAPABILITY_DRAFT,
   );
-  const [confirmArchiveId, setConfirmArchiveId] = useState<string | null>(null);
+  const [pendingArchive, setPendingArchive] = useState<{
+    id: string;
+    name: string;
+  } | null>(null);
   const [archivingId, setArchivingId] = useState<string | null>(null);
   const [error, setError] = useState<string | null>(null);
 
@@ -179,17 +183,14 @@ export function AgentsSettingsPanel({
     }
   };
 
-  const handleArchive = async (agent: LocalChatAgent) => {
-    if (agent.isBuiltin) return;
-    if (confirmArchiveId !== agent.id) {
-      setConfirmArchiveId(agent.id);
-      return;
-    }
-    setArchivingId(agent.id);
+  const handleArchive = async () => {
+    if (!pendingArchive || archivingId === pendingArchive.id) return;
+    const id = pendingArchive.id;
+    setArchivingId(id);
     setError(null);
     try {
-      await archiveChatAgent(agent.id);
-      setConfirmArchiveId(null);
+      await archiveChatAgent(id);
+      setPendingArchive(null);
       await fetchAgents();
       await onCatalogChange?.();
     } catch (err) {
@@ -371,18 +372,12 @@ export function AgentsSettingsPanel({
                   {!agent.isBuiltin && (
                     <button
                       type="button"
-                      onClick={() => void handleArchive(agent)}
-                      disabled={archivingId === agent.id}
-                      className={`rounded-full p-1 transition-colors ${
-                        confirmArchiveId === agent.id
-                          ? 'bg-agent-destructive/10 text-agent-destructive hover:bg-agent-destructive/20'
-                          : 'text-agent-muted-foreground hover:bg-agent-muted hover:text-agent-destructive'
-                      }`}
-                      title={
-                        confirmArchiveId === agent.id
-                          ? '再次点击确认删除'
-                          : '删除'
+                      onClick={() =>
+                        setPendingArchive({ id: agent.id, name: agent.name })
                       }
+                      disabled={archivingId === agent.id}
+                      className="rounded-full p-1 text-agent-muted-foreground transition-colors hover:bg-agent-muted hover:text-agent-destructive"
+                      title="删除"
                       data-testid={`agent-archive-${agent.id}`}
                     >
                       {archivingId === agent.id ? (
@@ -407,6 +402,22 @@ export function AgentsSettingsPanel({
           {error}
         </div>
       )}
+      <ConfirmDialog
+        open={pendingArchive !== null}
+        title="删除智能体"
+        description={
+          pendingArchive
+            ? `确定删除「${pendingArchive.name}」？它会从专家选择器中移除，已有会话不受影响。`
+            : ''
+        }
+        pending={pendingArchive !== null && archivingId === pendingArchive.id}
+        onCancel={() => {
+          if (archivingId) return;
+          setPendingArchive(null);
+        }}
+        onConfirm={() => void handleArchive()}
+        testId="agent-archive-dialog"
+      />
     </div>
   );
 }

package/src/components/settings/McpSettingsPanel.tsx

@@ -15,7 +15,7 @@ import { getElectronBridge, isElectron } from '@/lib/electron-bridge';
  * McpSettingsPanel — MCP 服务管理面板（JSON 导入 / 手动增改 / 启停 / 测试 /
  * 删除）。
  *
- * 渲染在 `/settings?section=mcp` 独立页（AgentLayout 右侧内容区）。
+ * 渲染在 `/settings?section=plugins` 的 MCP 分类（AgentLayout 右侧内容区）。
  *
  * 数据与状态完全自管理：挂载时拉一次列表，操作后刷新。后端走
  * local-backend REST（`/api/v2/mcp/servers*`），注册表持久化在 main 进程的

package/src/components/settings/OrchestrationSettingsPanel.tsx

@@ -0,0 +1,67 @@
+import { LuGitFork } from 'react-icons/lu';
+import { useOrchestrationSetting } from '@/lib/orchestration-settings';
+
+/**
+ * OrchestrationSettingsPanel — 多智能体协同编排设置面板。
+ * 默认开启。用户可手动关闭或再次开启，变更实时持久化并影响后续对话请求。
+ */
+export function OrchestrationSettingsPanel() {
+  const [enabled, setEnabled] = useOrchestrationSetting();
+
+  return (
+    <div
+      className="space-y-2.5 rounded-agent-md border border-agent-border bg-agent-card p-3"
+      data-testid="orchestration-settings-panel"
+    >
+      <div className="flex items-start justify-between gap-3">
+        <div className="space-y-1">
+          <div className="flex items-center gap-1.5 text-xs font-semibold text-agent-foreground">
+            <LuGitFork className="h-3.5 w-3.5 text-violet-600 dark:text-violet-400" />
+            <span>多智能体协同编排 (Fork-Join)</span>
+          </div>
+          <p className="text-xs leading-relaxed text-agent-muted-foreground">
+            允许主智能体通过派生子任务（agent_spawn）并行推理计算，并在输入框上方呈现流程图与实时协同进度看板。
+          </p>
+        </div>
+
+        {/* 开关 Radio Group / Toggle */}
+        <div
+          className="flex shrink-0 rounded-full border border-agent-border bg-agent-canvas p-0.5"
+          role="radiogroup"
+          aria-label="多智能体协同编排功能开关"
+        >
+          <button
+            type="button"
+            role="radio"
+            aria-checked={enabled}
+            onClick={() => setEnabled(true)}
+            className={[
+              'h-6 rounded-full px-2.5 text-[11px] font-medium transition-colors',
+              enabled
+                ? 'bg-emerald-500/15 text-emerald-700 dark:text-emerald-300 shadow-2xs'
+                : 'text-agent-muted-foreground hover:text-agent-foreground',
+            ].join(' ')}
+          >
+            开启
+          </button>
+          <button
+            type="button"
+            role="radio"
+            aria-checked={!enabled}
+            onClick={() => setEnabled(false)}
+            className={[
+              'h-6 rounded-full px-2.5 text-[11px] font-medium transition-colors',
+              !enabled
+                ? 'bg-agent-foreground/10 text-agent-foreground shadow-2xs'
+                : 'text-agent-muted-foreground hover:text-agent-foreground',
+            ].join(' ')}
+          >
+            关闭
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}
+
+export default OrchestrationSettingsPanel;

package/src/components/settings/SettingsNavMenu.tsx

@@ -0,0 +1,55 @@
+import React from 'react';
+
+export interface SettingsNavItem {
+  id: string;
+  label: string;
+  Icon: React.ComponentType<{ className?: string }>;
+}
+
+export function SettingsNavMenu({
+  items,
+  activeId,
+  onSelect,
+}: {
+  items: SettingsNavItem[];
+  activeId: string | null;
+  onSelect: (id: string) => void;
+}) {
+  if (items.length === 0) return null;
+
+  return (
+    <aside
+      className="sticky top-0 h-fit w-44 shrink-0 py-1 select-none"
+      data-testid="settings-side-nav"
+      aria-label="设置目录导航"
+    >
+      <div className="mb-2 px-2.5 text-[11px] font-semibold tracking-wider text-agent-muted-foreground uppercase">
+        设置导航
+      </div>
+      <nav className="space-y-0.5">
+        {items.map((item) => {
+          const isActive = activeId === item.id;
+          return (
+            <button
+              key={item.id}
+              type="button"
+              data-testid={`settings-nav-item-${item.id}`}
+              onClick={() => onSelect(item.id)}
+              className={[
+                'flex w-full items-center gap-2 rounded-agent-sm px-2.5 py-1.5 text-left text-xs transition-colors',
+                isActive
+                  ? 'bg-agent-foreground/10 font-semibold text-agent-foreground'
+                  : 'text-agent-muted-foreground hover:bg-agent-foreground/5 hover:text-agent-foreground',
+              ].join(' ')}
+            >
+              <item.Icon className={`h-3.5 w-3.5 shrink-0 ${isActive ? 'text-agent-foreground' : 'text-agent-muted-foreground'}`} />
+              <span className="truncate">{item.label}</span>
+            </button>
+          );
+        })}
+      </nav>
+    </aside>
+  );
+}
+
+export default SettingsNavMenu;

package/src/components/settings/SkillsSettingsPanel.tsx

@@ -11,7 +11,7 @@ import { getPackHiddenSlashSkills } from '@/packs/registry';
 /**
  * SkillsSettingsPanel — 本地技能管理面板（导入目录 / 列表 / 卸载）。
  *
- * 渲染在 `/settings?section=skills` 独立页（AgentLayout 右侧内容区）。
+ * 渲染在 `/settings?section=plugins` 的 Skills 分类（AgentLayout 右侧内容区）。
  *
  * 数据与状态完全自管理：挂载时拉一次列表，操作后刷新。后端走
  * local-backend REST（`GET/POST /api/v2/chat-agents/skills*`），无专用 IPC。

package/src/hooks/useProjects.ts

@@ -0,0 +1,82 @@
+/**
+ * 侧栏项目分组和输入框「关联到项目」共用这一份列表。
+ * 任一侧新建、改名或改目录后调用 refresh，其它订阅者一起更新。
+ */
+import { useCallback, useEffect, useSyncExternalStore } from 'react';
+import { isElectron } from '@/lib/electron-bridge';
+import { hostToolChrome } from '@/lib/host-tools';
+import { listProjects, type LocalProject } from '@/lib/local-api';
+
+type ProjectsSnapshot = {
+  projects: LocalProject[];
+  error: string | null;
+};
+
+const EMPTY_SNAPSHOT: ProjectsSnapshot = { projects: [], error: null };
+
+let snapshot: ProjectsSnapshot = EMPTY_SNAPSHOT;
+let requestSeq = 0;
+const listeners = new Set<() => void>();
+
+function emit() {
+  for (const listener of listeners) listener();
+}
+
+export function subscribeProjects(listener: () => void): () => void {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+export function getProjectsSnapshot(): ProjectsSnapshot {
+  return snapshot;
+}
+
+/** 重新拉取项目列表并通知所有订阅者。非 Electron 或关掉项目入口时清空。 */
+export async function refreshProjects(): Promise<void> {
+  const seq = ++requestSeq;
+  if (!isElectron() || !hostToolChrome('projects')) {
+    if (snapshot.projects.length > 0 || snapshot.error) {
+      snapshot = EMPTY_SNAPSHOT;
+      emit();
+    }
+    return;
+  }
+  try {
+    const res = await listProjects();
+    if (seq !== requestSeq) return;
+    snapshot = { projects: res.projects ?? [], error: null };
+    emit();
+  } catch (err) {
+    if (seq !== requestSeq) return;
+    const message = err instanceof Error ? err.message : String(err);
+    console.error('获取项目列表失败:', err);
+    snapshot = { projects: snapshot.projects, error: message };
+    emit();
+  }
+}
+
+export function useProjects(): {
+  projects: LocalProject[];
+  error: string | null;
+  refresh: () => Promise<void>;
+} {
+  const current = useSyncExternalStore(
+    subscribeProjects,
+    getProjectsSnapshot,
+    getProjectsSnapshot,
+  );
+  useEffect(() => {
+    void refreshProjects();
+  }, []);
+  const refresh = useCallback(() => refreshProjects(), []);
+  return { projects: current.projects, error: current.error, refresh };
+}
+
+/** 测试隔离：丢掉上一个用例留下的列表，并忽略还在飞的请求。 */
+export function resetProjectsStoreForTests(): void {
+  requestSeq += 1;
+  snapshot = EMPTY_SNAPSHOT;
+  emit();
+}

package/src/lib/electron-bridge.ts

@@ -48,6 +48,7 @@ export interface ApprovalPromptRequest {
   mode: string;
   category: string;
   round: number;
+  /** 发起审批的对话。缺省时卡片不绑定会话（旧请求）。 */
   chatId?: string;
 }
 

package/src/lib/exec-policy.ts

@@ -2,7 +2,7 @@
  * 会话级命令执行沙箱（类 Codex 的 sandbox_mode）。
  *
  * 作用于下一轮 `chat.stream` 的 `execSandbox`，不是 sidecar 进程沙箱
- * （设置页那一层）。工作区 = 只能写入当前项目或本对话工作区；完整权限
+ * （设置页那一层）。工作区 = 只能写入项目家目录、源文件夹（含各自子目录）或本对话工作区；完整权限
  * = 关闭逐条命令沙箱。工具审批（允许/拒绝）仍按原策略生效。
  */
 

package/src/lib/local-api.ts

@@ -387,7 +387,7 @@ export interface LocalProject {
   id: string;
   name: string;
   folderPath: string;
-  /** 附加源文件夹（只读）。缺省空。 */
+  /** 附加源文件夹（可读写，含其子目录）。缺省空。 */
   sourceFolders?: string[];
   /** W6-5: 信任后该项目目录里的规则文件才会注入模型上下文。缺省 false。 */
   trusted?: boolean;

package/src/lib/orchestration-settings.ts

@@ -0,0 +1,58 @@
+import { useEffect, useState } from 'react';
+
+export const ORCHESTRATION_SETTING_STORAGE_KEY = 'steerable.orchestration.enabled';
+
+const CHANGE_EVENT = 'steerable:orchestration-setting-changed';
+
+/**
+ * 读取多智能体协同编排功能开关，默认开启 (true)。
+ */
+export function isOrchestrationSettingEnabled(): boolean {
+  if (typeof localStorage === 'undefined') return true;
+  const stored = localStorage.getItem(ORCHESTRATION_SETTING_STORAGE_KEY);
+  if (stored === null) return true; // 默认开启
+  return stored !== 'false' && stored !== '0';
+}
+
+/**
+ * 持久化多智能体协同编排开关到 localStorage 并广播变更。
+ */
+export function persistOrchestrationSetting(enabled: boolean): void {
+  if (typeof localStorage === 'undefined') return;
+  localStorage.setItem(ORCHESTRATION_SETTING_STORAGE_KEY, enabled ? 'true' : 'false');
+  if (typeof window !== 'undefined') {
+    window.dispatchEvent(new CustomEvent(CHANGE_EVENT, { detail: enabled }));
+  }
+}
+
+/**
+ * 响应式 hook：订阅并切换编排功能开关。
+ */
+export function useOrchestrationSetting(): [boolean, (enabled: boolean) => void] {
+  const [enabled, setEnabled] = useState<boolean>(() => isOrchestrationSettingEnabled());
+
+  useEffect(() => {
+    if (typeof window === 'undefined') return;
+    const handler = (e: Event) => {
+      const custom = e as CustomEvent<boolean>;
+      if (typeof custom.detail === 'boolean') {
+        setEnabled(custom.detail);
+      } else {
+        setEnabled(isOrchestrationSettingEnabled());
+      }
+    };
+    window.addEventListener(CHANGE_EVENT, handler);
+    window.addEventListener('storage', handler);
+    return () => {
+      window.removeEventListener(CHANGE_EVENT, handler);
+      window.removeEventListener('storage', handler);
+    };
+  }, []);
+
+  const update = (next: boolean) => {
+    setEnabled(next);
+    persistOrchestrationSetting(next);
+  };
+
+  return [enabled, update];
+}