@yancyyu/openhermit 1.6.40 → 1.6.42

package/src/main/services/system-manager/BuiltinWorkflowSeeder.ts

@@ -0,0 +1,139 @@
+/**
+ * BuiltinWorkflowSeeder — 将内置 workflow 作为 Claude Code 自定义命令
+ * 复制到控制台工作空间的 `.claude/commands/` 目录。
+ *
+ * 内置 workflow 以代码常量形式内嵌，在控制台打开工作空间时自动复制到
+ * <workspace>/.claude/commands/ 目录，成为原生 `/doctor` 等斜杠命令。
+ */
+import { mkdir, writeFile, stat } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+
+import { createLogger } from '@shared/utils/logger';
+
+const logger = createLogger('BuiltinWorkflowSeeder');
+
+// ---------------------------------------------------------------------------
+// Builtin workflow definitions
+// ---------------------------------------------------------------------------
+
+const BUILTIN_WORKFLOWS: Record<string, string> = {
+  'doctor.md': `# Hermit Doctor — 环境诊断
+
+你是一个 Hermit 运维诊断助手。请按以下步骤逐一检查当前环境，报告每项状态（✅ 正常 / ⚠️ 警告 / ❌ 异常），并在最后给出总结和建议。
+
+## 1. 基础环境
+
+- 检查操作系统和版本
+- 检查可用内存（\`free -h\` 或 \`vm_stat\`）
+- 检查磁盘空间（\`df -h .\`）
+- 检查文件描述符限制（\`ulimit -n\`）
+
+## 2. Claude Code CLI
+
+- 检查 \`claude\` 是否在 PATH 中（\`which claude\`）
+- 检查 Claude Code 版本（\`claude --version\`）
+- 检查登录状态（\`claude auth status\` 或检查 \`~/.claude\` 目录）
+
+## 3. cc-connect 连通性
+
+- 检查 cc-connect 进程是否运行（\`ps aux | grep cc-connect\`）
+- 检查 cc-connect API 是否可达（\`curl -s http://127.0.0.1:6300/api/v1/status\`）
+- 检查 cc-connect 配置文件是否存在（\`~/.cc-connect/config.toml\`）
+- 列出已配置的项目数量
+
+## 4. Hermit 数据目录
+
+- 检查 \`~/.hermit/\` 目录结构是否完整
+- 检查 \`~/.hermit/teams/\` 下的团队数量和状态
+- 检查是否有 pendingDelete 或 restartRequired 标记的团队
+- 检查团队 team.json 是否有效（schemaVersion 字段）
+
+## 5. 会话健康
+
+- 统计当前运行的 Claude 会话数量（\`ps aux | grep claude | grep -v grep\`）
+- 检查是否有僵尸进程
+- 检查内存占用是否异常（单个会话 > 200MB 为警告）
+
+## 6. 网络和端口
+
+- 检查 Hermit 服务端口是否正常监听
+- 检查 cc-connect 端口是否正常监听
+- 检查 DNS 解析是否正常（\`nslookup api.anthropic.com\`）
+
+## 输出格式
+
+完成后请输出：
+
+\`\`\`
+🔍 Hermit Doctor 诊断报告
+=========================
+操作系统: ...
+内存: ... (可用 / 总计)
+磁盘: ... (可用 / 总计)
+
+✅/⚠️/❌ Claude Code CLI: ...
+✅/⚠️/❌ cc-connect: ...
+✅/⚠️/❌ Hermit 数据: ...
+✅/⚠️/❌ 会话健康: ...
+✅/⚠️/❌ 网络: ...
+
+📊 总结:
+- 正常项: N
+- 警告项: N
+- 异常项: N
+
+💡 建议:
+1. ...
+2. ...
+\`\`\`
+`,
+};
+
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+
+function hermitHome(): string {
+  return process.env.HERMIT_HOME || path.join(os.homedir(), '.hermit');
+}
+
+/**
+ * 将内置命令文件复制到工作空间的 .claude/commands/ 目录。
+ * 如果已存在同名文件则跳过（尊重用户自定义）。
+ *
+ * @param workspaceDir 工作空间根目录
+ * @returns 实际复制的文件数量
+ */
+export async function seedBuiltinWorkflows(workspaceDir: string): Promise<number> {
+  let copied = 0;
+  try {
+    const targetDir = path.join(workspaceDir, '.claude', 'commands');
+    await mkdir(targetDir, { recursive: true });
+
+    for (const [filename, content] of Object.entries(BUILTIN_WORKFLOWS)) {
+      const targetPath = path.join(targetDir, filename);
+      const exists = await stat(targetPath).then(() => true).catch(() => false);
+      if (exists) continue;
+
+      await writeFile(targetPath, content, 'utf-8');
+      copied++;
+      logger.info(`seeded builtin workflow: ${filename} → ${targetPath}`);
+    }
+  } catch (err) {
+    logger.warn('failed to seed builtin workflows:', err instanceof Error ? err.message : err);
+  }
+  return copied;
+}
+
+/**
+ * Ensure ~/.hermit/.claude/commands/ has the builtin commands.
+ * Called once at app startup as fallback.
+ */
+export async function ensureGlobalWorkflows(): Promise<void> {
+  const globalWorkspace = hermitHome();
+  const copied = await seedBuiltinWorkflows(globalWorkspace);
+  if (copied > 0) {
+    logger.info(`seeded ${copied} builtin command(s) to ${path.join(globalWorkspace, '.claude', 'commands')}`);
+  }
+}

package/src/main/services/teams-mvp/TeamWorkspaceService.ts

@@ -205,7 +205,7 @@ export class TeamWorkspaceService {
     if (!input.bindProject) throw new Error('bindProject is required');
     if (!input.workDir) throw new Error('workDir is required');
 
-    const slug = await this.createUniqueStorageSlug(input.displayName);
+    const slug = await this.createUniqueStorageSlug(input.bindProject);
     const root = teamRoot(slug);
 
     await fs.promises.mkdir(root, { recursive: true });

package/src/renderer/api/httpClient.ts

@@ -240,8 +240,8 @@ export class HttpAPIClient implements ElectronAPI {
     return JSON.parse(text, (key, value) => HttpAPIClient.reviveDates(key, value)) as T;
   }
 
-  private async get<T>(path: string): Promise<T> {
-    const { controller, timeout } = this.createTimeoutController(10_000);
+  private async get<T>(path: string, timeoutMs = 10_000): Promise<T> {
+    const { controller, timeout } = this.createTimeoutController(timeoutMs);
     try {
       const res = await fetch(`${this.baseUrl}${path}`, { signal: controller.signal });
       return this.parseJson<T>(res);
@@ -250,8 +250,8 @@ export class HttpAPIClient implements ElectronAPI {
     }
   }
 
-  private async post<T>(path: string, body?: unknown): Promise<T> {
-    const { controller, timeout } = this.createTimeoutController(10_000);
+  private async post<T>(path: string, body?: unknown, timeoutMs = 10_000): Promise<T> {
+    const { controller, timeout } = this.createTimeoutController(timeoutMs);
     try {
       const res = await fetch(`${this.baseUrl}${path}`, {
         method: 'POST',
@@ -280,8 +280,8 @@ export class HttpAPIClient implements ElectronAPI {
     }
   }
 
-  private async del<T>(path: string, body?: unknown): Promise<T> {
-    const { controller, timeout } = this.createTimeoutController(10_000);
+  private async del<T>(path: string, body?: unknown, timeoutMs = 10_000): Promise<T> {
+    const { controller, timeout } = this.createTimeoutController(timeoutMs);
     try {
       const res = await fetch(`${this.baseUrl}${path}`, {
         method: 'DELETE',
@@ -295,8 +295,8 @@ export class HttpAPIClient implements ElectronAPI {
     }
   }
 
-  private async put<T>(path: string, body?: unknown): Promise<T> {
-    const { controller, timeout } = this.createTimeoutController(10_000);
+  private async put<T>(path: string, body?: unknown, timeoutMs = 10_000): Promise<T> {
+    const { controller, timeout } = this.createTimeoutController(timeoutMs);
     try {
       const res = await fetch(`${this.baseUrl}${path}`, {
         method: 'PUT',
@@ -310,8 +310,8 @@ export class HttpAPIClient implements ElectronAPI {
     }
   }
 
-  private async patch<T>(path: string, body?: unknown): Promise<T> {
-    const { controller, timeout } = this.createTimeoutController(10_000);
+  private async patch<T>(path: string, body?: unknown, timeoutMs = 10_000): Promise<T> {
+    const { controller, timeout } = this.createTimeoutController(timeoutMs);
     try {
       const res = await fetch(`${this.baseUrl}${path}`, {
         method: 'PATCH',
@@ -325,8 +325,8 @@ export class HttpAPIClient implements ElectronAPI {
     }
   }
 
-  private async delete<T>(path: string): Promise<T> {
-    const { controller, timeout } = this.createTimeoutController(10_000);
+  private async delete<T>(path: string, timeoutMs = 10_000): Promise<T> {
+    const { controller, timeout } = this.createTimeoutController(timeoutMs);
     try {
       const res = await fetch(`${this.baseUrl}${path}`, {
         method: 'DELETE',
@@ -1093,11 +1093,11 @@ export class HttpAPIClient implements ElectronAPI {
   };
 
   teams: TeamsAPI = {
-    list: async (): Promise<TeamSummary[]> => this.get<TeamSummary[]>('/api/teams'),
+    list: async (): Promise<TeamSummary[]> => this.get<TeamSummary[]>('/api/teams', 30_000),
     ensureSystemManager: async (): Promise<SystemManagerSummary> =>
       this.post<SystemManagerSummary>('/api/system-manager/ensure'),
     getData: async (teamName: string): Promise<TeamViewSnapshot> =>
-      this.get<TeamViewSnapshot>(`/api/teams/${encodeURIComponent(teamName)}/data`),
+      this.get<TeamViewSnapshot>(`/api/teams/${encodeURIComponent(teamName)}/data`, 30_000),
     getTaskChangePresence: async (): Promise<
       Record<string, 'has_changes' | 'no_changes' | 'unknown'>
     > => {
@@ -1477,7 +1477,9 @@ export class HttpAPIClient implements ElectronAPI {
     },
     restartMember: async (teamName: string, memberName: string): Promise<void> => {
       await this.post(
-        `/api/teams/${encodeURIComponent(teamName)}/members/${encodeURIComponent(memberName)}/restart`
+        `/api/teams/${encodeURIComponent(teamName)}/members/${encodeURIComponent(memberName)}/restart`,
+        undefined,
+        30_000
       );
     },
     skipMemberForLaunch: async (teamName: string, memberName: string): Promise<void> => {

package/src/renderer/components/chat/SessionContextPanel/DirectoryTree/DirectoryTreeNode.tsx

@@ -55,7 +55,7 @@ export const DirectoryTreeNode = ({
               type="button"
               className="cursor-pointer text-xs transition-opacity hover:opacity-80"
               style={{
-                color: '#93c5fd',
+                color: '#a5b4fc',
                 textDecoration: 'underline',
                 textDecorationStyle: 'dotted' as const,
                 textUnderlineOffset: '2px',

package/src/renderer/components/chat/SessionContextPanel/items/ClaudeMdItem.tsx

@@ -45,7 +45,7 @@ export const ClaudeMdItem = ({
             type="button"
             className="cursor-pointer text-xs transition-opacity hover:opacity-80"
             style={{
-              color: '#93c5fd',
+              color: '#a5b4fc',
               textDecoration: 'underline',
               textDecorationStyle: 'dotted' as const,
               textUnderlineOffset: '2px',

package/src/renderer/components/chat/SessionContextPanel/items/MentionedFileItem.tsx

@@ -60,7 +60,7 @@ export const MentionedFileItem = ({
             tabIndex={0}
             className="cursor-pointer text-xs transition-opacity hover:opacity-80"
             style={{
-              color: '#93c5fd',
+              color: '#a5b4fc',
               textDecoration: 'underline',
               textDecorationStyle: 'dotted' as const,
               textUnderlineOffset: '2px',

package/src/renderer/components/chat/SessionContextPanel/items/TaskCoordinationItem.tsx

@@ -40,7 +40,7 @@ export const TaskCoordinationItem = ({
           tabIndex={0}
           className="cursor-pointer text-xs transition-opacity hover:opacity-80"
           style={{
-            color: '#93c5fd',
+            color: '#a5b4fc',
             textDecoration: 'underline',
             textDecorationStyle: 'dotted' as const,
             textUnderlineOffset: '2px',

package/src/renderer/components/chat/SessionContextPanel/items/ThinkingTextItem.tsx

@@ -49,7 +49,7 @@ export const ThinkingTextItem = ({
             tabIndex={0}
             className="cursor-pointer text-xs transition-opacity hover:opacity-80"
             style={{
-              color: '#93c5fd',
+              color: '#a5b4fc',
               textDecoration: 'underline',
               textDecorationStyle: 'dotted' as const,
               textUnderlineOffset: '2px',

package/src/renderer/components/chat/SessionContextPanel/items/ToolOutputItem.tsx

@@ -42,7 +42,7 @@ export const ToolOutputItem = ({
           tabIndex={0}
           className="cursor-pointer text-xs transition-opacity hover:opacity-80"
           style={{
-            color: '#93c5fd',
+            color: '#a5b4fc',
             textDecoration: 'underline',
             textDecorationStyle: 'dotted' as const,
             textUnderlineOffset: '2px',

package/src/renderer/components/chat/SessionContextPanel/items/UserMessageItem.tsx

@@ -33,7 +33,7 @@ export const UserMessageItem = ({
             tabIndex={0}
             className="cursor-pointer text-xs transition-opacity hover:opacity-80"
             style={{
-              color: '#93c5fd',
+              color: '#a5b4fc',
               textDecoration: 'underline',
               textDecorationStyle: 'dotted' as const,
               textUnderlineOffset: '2px',

package/src/renderer/components/dashboard/CliStatusBanner.tsx

@@ -962,7 +962,7 @@ const InstalledBanner = ({
                         className="flex items-center gap-1 rounded-md border px-2 py-[3px] text-[10px] font-medium transition-colors hover:bg-white/5 disabled:opacity-50"
                         style={{
                           borderColor: 'rgba(99, 102, 241, 0.45)',
-                          color: '#93c5fd',
+                          color: '#a5b4fc',
                         }}
                         title={`更新 Claude Code 到 v${cliStatus.latestVersion ?? 'latest'}`}
                       >

package/src/renderer/components/runtime/ProviderRuntimeBackendSelector.tsx

@@ -190,7 +190,7 @@ export const ProviderRuntimeBackendSelector = ({
                     <span
                       className="shrink-0 rounded-full px-1.5 py-0.5 text-[10px]"
                       style={{
-                        color: '#93c5fd',
+                        color: '#a5b4fc',
                         backgroundColor: 'rgba(99, 102, 241, 0.14)',
                       }}
                     >
@@ -258,7 +258,7 @@ export const ProviderRuntimeBackendSelector = ({
               <span
                 className="rounded-full px-1.5 py-0.5 text-[10px]"
                 style={{
-                  color: '#93c5fd',
+                  color: '#a5b4fc',
                   backgroundColor: 'rgba(99, 102, 241, 0.14)',
                 }}
               >

package/src/renderer/components/settings/SettingsTabs.tsx

@@ -75,7 +75,7 @@ export const SettingsTabs = ({
               }`}
               style={{
                 borderLeft: index > 0 ? '1px solid var(--color-border-subtle)' : undefined,
-                color: isActive ? '#67e8f9' : undefined,
+                color: isActive ? '#818cf8' : undefined,
               }}
             >
               <Icon className={`size-3 ${isActive ? 'opacity-90' : 'opacity-40'}`} />

package/src/renderer/components/settings/components/SettingsSelect.tsx

@@ -86,13 +86,13 @@ export const SettingsSelect = <T extends string | number>({
               onClick={() => handleSelect(option.value)}
               className={`flex w-full items-center justify-between gap-3 px-3 py-2 text-left text-sm transition-colors duration-100 ${
                 value === option.value
-                  ? 'bg-cyan-500/10 text-cyan-300'
+                  ? 'bg-indigo-500/10 text-indigo-300'
                   : 'hover:bg-white/5'
               } `}
               style={value !== option.value ? { color: 'var(--color-text-secondary)' } : undefined}
             >
               <span className="whitespace-nowrap">{option.label}</span>
-              {value === option.value && <Check className="size-4 shrink-0 text-cyan-400" />}
+              {value === option.value && <Check className="size-4 shrink-0 text-indigo-400" />}
             </button>
           ))}
         </div>

package/src/renderer/components/settings/components/SettingsToggle.tsx

@@ -29,7 +29,7 @@ export const SettingsToggle = ({
       onClick={handleClick}
       className="relative inline-flex h-5 w-9 shrink-0 cursor-pointer rounded-full border-2 border-transparent transition-colors duration-200 ease-in-out focus:outline-none focus:ring-2 focus:ring-[var(--color-text)]/20 focus:ring-offset-2 focus:ring-offset-[var(--color-surface)]"
       style={{
-        backgroundColor: enabled ? '#0891b2' : '#3f3f46',
+        backgroundColor: enabled ? '#6366f1' : '#3f3f46',
         opacity: disabled ? 0.5 : 1,
         cursor: disabled ? 'not-allowed' : 'pointer',
       }}

package/src/renderer/components/settings/sections/AdvancedSection.tsx

@@ -163,10 +163,10 @@ export const AdvancedSection = ({}: AdvancedSectionProps): React.JSX.Element =>
       <div className="flex flex-wrap gap-2 py-2">
         <button
           onClick={() => setCcConfigOpen(true)}
-          className="flex items-center gap-2 rounded-md border px-4 py-2 text-sm font-medium transition-all duration-150 hover:bg-cyan-500/5"
+          className="flex items-center gap-2 rounded-md border px-4 py-2 text-sm font-medium transition-all duration-150 hover:bg-indigo-500/5"
           style={{
-            borderColor: 'rgba(6, 182, 212, 0.3)',
-            color: '#67e8f9',
+            borderColor: 'rgba(99, 102, 241, 0.3)',
+            color: '#818cf8',
           }}
         >
           <FileEdit className="size-4" />

package/src/renderer/components/settings/sections/GeneralSection.tsx

@@ -446,7 +446,7 @@ export const GeneralSection = ({
                 safeConfig.general.theme === opt.value
                   ? {
                       backgroundColor: 'rgba(6, 182, 212, 0.1)',
-                      color: '#67e8f9',
+                      color: '#818cf8',
                     }
                   : undefined
               }

package/src/renderer/components/sidebar/taskFiltersState.ts

@@ -12,7 +12,7 @@ export type TaskStatusFilterId =
   | 'approved';
 
 export const STATUS_OPTIONS: { id: TaskStatusFilterId; label: string; color: string }[] = [
-  { id: 'todo', label: 'TODO', color: '#3b82f6' },
+  { id: 'todo', label: 'TODO', color: '#6366f1' },
   { id: 'in_progress', label: 'IN PROGRESS', color: '#eab308' },
   { id: 'needs_fix', label: 'NEEDS FIXES', color: '#f43f5e' },
   { id: 'done', label: 'DONE', color: '#22c55e' },

package/src/renderer/components/system-manager/SystemManagerView.tsx

@@ -91,7 +91,7 @@ export const SystemManagerView = ({
         yellow: '#fde68a',
         blue: 'var(--color-accent)',
         magenta: '#d8b4fe',
-        cyan: '#67e8f9',
+        cyan: '#818cf8',
         white: 'var(--color-text)',
       },
     });

package/src/renderer/components/team/TeamListView.tsx

@@ -840,6 +840,7 @@ export const TeamListView = (): React.JSX.Element => {
       provisioningErrorsByTeam={provisioningErrorByTeam}
       clearProvisioningError={clearProvisioningError}
       existingTeamNames={teams.map((t) => t.teamName)}
+      existingBindProjects={teams.map((t) => t.bindProject).filter(Boolean) as string[]}
       provisioningTeamNames={provisioningTeamNames}
       activeTeams={activeTeams}
       initialData={copyData ?? undefined}

package/src/renderer/components/team/activity/ActivityItem.tsx

@@ -224,7 +224,7 @@ const SessionSourceBadge = ({ message }: { message: InboxMessage }): React.JSX.E
       title={`${platform}${label}${session?.key ? ` (${session.key})` : ''}`}
       style={{
         backgroundColor: 'rgba(99, 102, 241, 0.12)',
-        color: '#93c5fd',
+        color: '#a5b4fc',
       }}
     >
       {platform}

package/src/renderer/components/team/dialogs/CreateTeamDialog.tsx

@@ -76,6 +76,32 @@ function sanitizeTeamName(name: string): string {
   return result;
 }
 
+/**
+ * Generate a unique ASCII project identifier from a display name.
+ * For Chinese names: produces "team-xxxx" (4-char random suffix).
+ * For ASCII names: produces a slugified version.
+ */
+function generateBindProject(displayName: string): string {
+  const trimmed = displayName.trim();
+  if (!trimmed) return '';
+  // Try to extract ASCII parts from the name
+  const asciiParts = trimmed
+    .toLowerCase()
+    .normalize('NFKD')
+    .replace(/[̀-ͯ]/g, '')
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/-+/g, '-')
+    .replace(/^-|-$/g, '');
+  const base = asciiParts || 'team';
+  const suffix = Math.random().toString(36).slice(2, 6);
+  return `${base}-${suffix}`;
+}
+
+/** Validate bindProject: ASCII lowercase alphanumeric, hyphens, underscores. */
+function isValidBindProject(value: string): boolean {
+  return /^[a-z0-9][a-z0-9_-]{1,}$/.test(value);
+}
+
 // ---------------------------------------------------------------------------
 // Wizard step types
 // ---------------------------------------------------------------------------
@@ -92,6 +118,7 @@ interface CreateTeamDialogProps {
   provisioningErrorsByTeam: Record<string, string | null>;
   clearProvisioningError?: (teamName?: string) => void;
   existingTeamNames: string[];
+  existingBindProjects?: string[];
   provisioningTeamNames?: string[];
   activeTeams?: ActiveTeamRef[];
   initialData?: unknown;
@@ -107,6 +134,7 @@ export const CreateTeamDialog = ({
   provisioningErrorsByTeam,
   clearProvisioningError,
   existingTeamNames,
+  existingBindProjects = [],
   provisioningTeamNames = [],
   activeTeams,
   defaultProjectPath,
@@ -137,6 +165,17 @@ export const CreateTeamDialog = ({
   const [selectedHarness, setSelectedHarness] = useState<CcAgentType>('claudecode');
   const [description, setDescription] = useState('');
 
+  // ── bindProject (ASCII unique identifier) ────────────────────────────
+  const [bindProject, setBindProject] = useState('');
+  const [bindProjectManuallyEdited, setBindProjectManuallyEdited] = useState(false);
+
+  // Auto-generate bindProject from displayName when not manually edited
+  useEffect(() => {
+    if (bindProjectManuallyEdited) return;
+    const auto = generateBindProject(teamName);
+    setBindProject(auto);
+  }, [teamName, bindProjectManuallyEdited]);
+
   // ── Projects (for path selector) ─────────────────────────────────────
   const [projects, setProjects] = useState<Project[]>([]);
   const [projectsLoading, setProjectsLoading] = useState(false);
@@ -152,19 +191,8 @@ export const CreateTeamDialog = ({
   const [fieldErrors, setFieldErrors] = useState<{ teamName?: string; cwd?: string }>({});
 
   // ── Name conflict detection ──────────────────────────────────────────
-  const allTakenTeamNames = useMemo(
-    () => [...new Set([...existingTeamNames, ...provisioningTeamNames])],
-    [existingTeamNames, provisioningTeamNames]
-  );
-  const sanitizedTeamName = sanitizeTeamName(teamName);
-  const trimmedInputName = teamName.trim().toLowerCase();
-  // Check both slug (for ASCII names) and display name (for Chinese/Unicode names)
-  // This prevents creating "产品经理团队" multiple times with different slugs (team-3, team-4...)
-  const isNameTaken =
-    existingTeamNames.includes(sanitizedTeamName) ||
-    activeTeams?.some((t) => t.displayName.toLowerCase() === trimmedInputName) === true;
-  const isNameProvisioning =
-    (provisioningTeamNames.includes(sanitizedTeamName) && !isNameTaken);
+  const isBindProjectTaken = existingBindProjects.includes(bindProject);
+  const isNameProvisioning = provisioningTeamNames.includes(bindProject) && !isBindProjectTaken;
 
   const effectiveCwd =
     cwdMode === 'project'
@@ -267,8 +295,8 @@ export const CreateTeamDialog = ({
 
   // ── Clear provisioning error on open ─────────────────────────────────
   useEffect(() => {
-    if (open && sanitizedTeamName) clearProvisioningError?.(sanitizedTeamName);
-  }, [open, clearProvisioningError, sanitizedTeamName]);
+    if (open && bindProject) clearProvisioningError?.(bindProject);
+  }, [open, clearProvisioningError, bindProject]);
 
   // ── Reset state on close ─────────────────────────────────────────────
   const resetState = () => {
@@ -277,11 +305,14 @@ export const CreateTeamDialog = ({
     setIsSubmitting(false);
     setConflictDismissed(false);
     setSelectedProviderRef(null);
+    setBindProject('');
+    setBindProjectManuallyEdited(false);
     setStep('name');
   };
 
   const buildCreateRequest = (): TeamCreateRequest => ({
-    teamName: sanitizedTeamName,
+    teamName: bindProject,
+    bindProject,
     displayName: teamName.trim() || undefined,
     description: description.trim() || undefined,
     color: teamColor || undefined,
@@ -295,12 +326,20 @@ export const CreateTeamDialog = ({
   });
 
   const validateCreateFields = (): boolean => {
-    if (allTakenTeamNames.includes(sanitizedTeamName)) {
-      setLocalError(isNameProvisioning ? '数字员工正在启动中' : '数字员工名称已存在');
+    if (!teamName.trim()) {
+      setLocalError('请输入数字员工名称');
       return false;
     }
-    if (!sanitizedTeamName) {
-      setLocalError('请输入数字员工名称');
+    if (!bindProject) {
+      setLocalError('请输入项目标识');
+      return false;
+    }
+    if (!isValidBindProject(bindProject)) {
+      setLocalError('项目标识只能包含小写英文字母、数字、连字符和下划线（至少2个字符，以字母或数字开头）');
+      return false;
+    }
+    if (isBindProjectTaken) {
+      setLocalError(isNameProvisioning ? '数字员工正在启动中' : `项目标识"${bindProject}"已存在，请换一个`);
       return false;
     }
     if (!effectiveCwd) {
@@ -399,11 +438,6 @@ export const CreateTeamDialog = ({
                 placeholder="例如：产品助手 / 前端工程师"
                 autoFocus
               />
-              {isNameTaken && (
-                <p className="text-[11px]" style={{ color: 'var(--field-error-text)' }}>
-                  数字员工名称已存在
-                </p>
-              )}
               {isNameProvisioning && (
                 <p className="text-[11px]" style={{ color: 'var(--warning-text)' }}>
                   同名数字员工正在启动中
@@ -411,6 +445,31 @@ export const CreateTeamDialog = ({
               )}
             </div>
 
+            <div className="space-y-1.5">
+              <Label htmlFor="team-bind-project">项目标识</Label>
+              <Input
+                id="team-bind-project"
+                className={cn(
+                  'h-8 text-xs font-mono',
+                  isBindProjectTaken && 'border-[var(--field-error-border)]'
+                )}
+                value={bindProject}
+                onChange={(e) => {
+                  setBindProject(e.target.value.toLowerCase().replace(/[^a-z0-9_-]/g, ''));
+                  setBindProjectManuallyEdited(true);
+                }}
+                placeholder="auto-generated-id"
+              />
+              {isBindProjectTaken && (
+                <p className="text-[11px]" style={{ color: 'var(--field-error-text)' }}>
+                  该项目标识已存在
+                </p>
+              )}
+              <p className="text-[11px] text-[var(--color-text-muted)]">
+                用于 URL 路由和 cc-connect 项目绑定，仅限小写英文/数字/连字符
+              </p>
+            </div>
+
             <div className="space-y-1.5">
               <Label htmlFor="team-harness">Agent 类型</Label>
               <HarnessSelect
@@ -541,7 +600,7 @@ export const CreateTeamDialog = ({
                 {localError}
               </p>
             )}
-            {provisioningErrorsByTeam[sanitizedTeamName] && (
+            {provisioningErrorsByTeam[bindProject] && (
               <p
                 className="mt-1 rounded border p-2 text-xs"
                 style={{
@@ -550,7 +609,7 @@ export const CreateTeamDialog = ({
                   backgroundColor: 'var(--field-error-bg)',
                 }}
               >
-                {provisioningErrorsByTeam[sanitizedTeamName]}
+                {provisioningErrorsByTeam[bindProject]}
               </p>
             )}
           </div>
@@ -572,7 +631,7 @@ export const CreateTeamDialog = ({
                 <Button
                   size="sm"
                   onClick={() => {
-                    onOpenTeam(sanitizedTeamName, effectiveCwd || undefined, {
+                    onOpenTeam(bindProject, effectiveCwd || undefined, {
                       displayName: teamName.trim() || undefined,
                     });
                     clearDraft();
@@ -588,7 +647,7 @@ export const CreateTeamDialog = ({
                 <Button variant="outline" size="sm" onClick={onClose}>
                   取消
                 </Button>
-                <Button size="sm" disabled={!sanitizedTeamName || !effectiveCwd || isSubmitting} onClick={handleCreate}>
+                <Button size="sm" disabled={!teamName.trim() || !bindProject || !effectiveCwd || isSubmitting} onClick={handleCreate}>
                   {isSubmitting ? '创建中...' : '创建数字员工'}
                 </Button>
               </>