@lobehub/lobehub 2.0.0-next.353 → 2.0.0-next.354

package/.agents/skills/desktop/references/window-management.md

@@ -0,0 +1,143 @@
+# Desktop Window Management Guide
+
+## Window Management Overview
+
+1. Window creation and configuration
+2. Window state management (size, position, maximize)
+3. Multi-window coordination
+4. Window event handling
+
+## File Structure
+
+```plaintext
+apps/desktop/src/main/
+├── appBrowsers.ts              # Core window management
+├── controllers/
+│   └── BrowserWindowsCtr.ts    # Window controller
+└── modules/
+    └── browserWindowManager.ts # Window manager module
+```
+
+## Window Creation
+
+```typescript
+export const createMainWindow = () => {
+  const mainWindow = new BrowserWindow({
+    width: 1200,
+    height: 800,
+    minWidth: 600,
+    minHeight: 400,
+    webPreferences: {
+      preload: path.join(__dirname, '../preload/index.js'),
+      contextIsolation: true,
+      nodeIntegration: false,
+    },
+  });
+
+  if (isDev) {
+    mainWindow.loadURL('http://localhost:3000');
+  } else {
+    mainWindow.loadFile(path.join(__dirname, '../../renderer/index.html'));
+  }
+
+  return mainWindow;
+};
+```
+
+## Window State Persistence
+
+```typescript
+const saveWindowState = (window: BrowserWindow) => {
+  if (!window.isMinimized() && !window.isMaximized()) {
+    const [x, y] = window.getPosition();
+    const [width, height] = window.getSize();
+    settings.set('windowState', { x, y, width, height });
+  }
+};
+
+const restoreWindowState = (window: BrowserWindow) => {
+  const state = settings.get('windowState');
+  if (state) {
+    window.setBounds({ x: state.x, y: state.y, width: state.width, height: state.height });
+  }
+};
+
+window.on('close', () => saveWindowState(window));
+```
+
+## Multi-Window Management
+
+```typescript
+export class WindowManager {
+  private windows: Map<string, BrowserWindow> = new Map();
+
+  createWindow(id: string, options: BrowserWindowConstructorOptions) {
+    const window = new BrowserWindow(options);
+    this.windows.set(id, window);
+    window.on('closed', () => this.windows.delete(id));
+    return window;
+  }
+
+  getWindow(id: string) {
+    return this.windows.get(id);
+  }
+}
+```
+
+## Window IPC Controller
+
+```typescript
+// apps/desktop/src/main/controllers/BrowserWindowsCtr.ts
+export default class BrowserWindowsCtr extends ControllerModule {
+  static override readonly groupName = 'windows';
+
+  @IpcMethod()
+  minimizeWindow() {
+    BrowserWindow.getFocusedWindow()?.minimize();
+    return { success: true };
+  }
+
+  @IpcMethod()
+  maximizeWindow() {
+    const win = BrowserWindow.getFocusedWindow();
+    win?.isMaximized() ? win.restore() : win?.maximize();
+    return { success: true };
+  }
+}
+```
+
+## Renderer Service
+
+```typescript
+// src/services/electron/windowService.ts
+import { ensureElectronIpc } from '@/utils/electron/ipc';
+
+const ipc = ensureElectronIpc();
+
+export const windowService = {
+  minimize: () => ipc.windows.minimizeWindow(),
+  maximize: () => ipc.windows.maximizeWindow(),
+  close: () => ipc.windows.closeWindow(),
+};
+```
+
+## Frameless Window
+
+```typescript
+const window = new BrowserWindow({
+  frame: false,
+  titleBarStyle: 'hidden',
+});
+```
+
+```css
+.titlebar { -webkit-app-region: drag; }
+.titlebar-button { -webkit-app-region: no-drag; }
+```
+
+## Best Practices
+
+1. Use `show: false` initially, show after content loads
+2. Always set secure `webPreferences`
+3. Handle `webContents.on('crashed')` for recovery
+4. Clean up resources on `window.on('closed')`

package/.agents/skills/drizzle/SKILL.md

@@ -0,0 +1,129 @@
+---
+name: drizzle
+description: Drizzle ORM schema and database guide. Use when working with database schemas (src/database/schemas/*), defining tables, creating migrations, or database model code. Triggers on Drizzle schema definition, database migrations, or ORM usage questions.
+---
+
+# Drizzle ORM Schema Style Guide
+
+## Configuration
+
+- Config: `drizzle.config.ts`
+- Schemas: `src/database/schemas/`
+- Migrations: `src/database/migrations/`
+- Dialect: `postgresql` with `strict: true`
+
+## Helper Functions
+
+Location: `src/database/schemas/_helpers.ts`
+
+- `timestamptz(name)`: Timestamp with timezone
+- `createdAt()`, `updatedAt()`, `accessedAt()`: Standard timestamp columns
+- `timestamps`: Object with all three for easy spread
+
+## Naming Conventions
+
+- **Tables**: Plural snake_case (`users`, `session_groups`)
+- **Columns**: snake_case (`user_id`, `created_at`)
+
+## Column Definitions
+
+### Primary Keys
+
+```typescript
+id: text('id')
+  .primaryKey()
+  .$defaultFn(() => idGenerator('agents'))
+  .notNull(),
+```
+
+ID prefixes make entity types distinguishable. For internal tables, use `uuid`.
+
+### Foreign Keys
+
+```typescript
+userId: text('user_id')
+  .references(() => users.id, { onDelete: 'cascade' })
+  .notNull(),
+```
+
+### Timestamps
+
+```typescript
+...timestamps,  // Spread from _helpers.ts
+```
+
+### Indexes
+
+```typescript
+// Return array (object style deprecated)
+(t) => [uniqueIndex('client_id_user_id_unique').on(t.clientId, t.userId)],
+```
+
+## Type Inference
+
+```typescript
+export const insertAgentSchema = createInsertSchema(agents);
+export type NewAgent = typeof agents.$inferInsert;
+export type AgentItem = typeof agents.$inferSelect;
+```
+
+## Example Pattern
+
+```typescript
+export const agents = pgTable(
+  'agents',
+  {
+    id: text('id').primaryKey().$defaultFn(() => idGenerator('agents')).notNull(),
+    slug: varchar('slug', { length: 100 }).$defaultFn(() => randomSlug(4)).unique(),
+    userId: text('user_id').references(() => users.id, { onDelete: 'cascade' }).notNull(),
+    clientId: text('client_id'),
+    chatConfig: jsonb('chat_config').$type<LobeAgentChatConfig>(),
+    ...timestamps,
+  },
+  (t) => [uniqueIndex('client_id_user_id_unique').on(t.clientId, t.userId)],
+);
+```
+
+## Common Patterns
+
+### Junction Tables (Many-to-Many)
+
+```typescript
+export const agentsKnowledgeBases = pgTable(
+  'agents_knowledge_bases',
+  {
+    agentId: text('agent_id').references(() => agents.id, { onDelete: 'cascade' }).notNull(),
+    knowledgeBaseId: text('knowledge_base_id').references(() => knowledgeBases.id, { onDelete: 'cascade' }).notNull(),
+    userId: text('user_id').references(() => users.id, { onDelete: 'cascade' }).notNull(),
+    enabled: boolean('enabled').default(true),
+    ...timestamps,
+  },
+  (t) => [primaryKey({ columns: [t.agentId, t.knowledgeBaseId] })],
+);
+```
+
+## Database Migrations
+
+See `references/db-migrations.md` for detailed migration guide.
+
+```bash
+# Generate migrations
+bun run db:generate
+
+# After modifying SQL (e.g., adding IF NOT EXISTS)
+bun run db:generate:client
+```
+
+### Migration Best Practices
+
+```sql
+-- ✅ Idempotent operations
+ALTER TABLE "users" ADD COLUMN IF NOT EXISTS "avatar" text;
+DROP TABLE IF EXISTS "old_table";
+CREATE INDEX IF NOT EXISTS "users_email_idx" ON "users" ("email");
+
+-- ❌ Non-idempotent
+ALTER TABLE "users" ADD COLUMN "avatar" text;
+```
+
+Rename migration files meaningfully: `0046_meaningless.sql` → `0046_user_add_avatar.sql`

package/.agents/skills/drizzle/references/db-migrations.md

@@ -0,0 +1,50 @@
+# Database Migrations Guide
+
+## Step 1: Generate Migrations
+
+```bash
+bun run db:generate
+```
+
+This generates:
+
+- `packages/database/migrations/0046_meaningless_file_name.sql`
+
+And updates:
+
+- `packages/database/migrations/meta/_journal.json`
+- `packages/database/src/core/migrations.json`
+- `docs/development/database-schema.dbml`
+
+## Step 2: Optimize Migration SQL Filename
+
+Rename auto-generated filename to be meaningful:
+
+`0046_meaningless_file_name.sql` → `0046_user_add_avatar_column.sql`
+
+## Step 3: Use Idempotent Clauses (Defensive Programming)
+
+Always use defensive clauses to make migrations idempotent:
+
+```sql
+-- ✅ Good: Idempotent operations
+ALTER TABLE "users" ADD COLUMN IF NOT EXISTS "avatar" text;
+DROP TABLE IF EXISTS "old_table";
+CREATE INDEX IF NOT EXISTS "users_email_idx" ON "users" ("email");
+ALTER TABLE "posts" DROP COLUMN IF EXISTS "deprecated_field";
+
+-- ❌ Bad: Non-idempotent operations
+ALTER TABLE "users" ADD COLUMN "avatar" text;
+DROP TABLE "old_table";
+CREATE INDEX "users_email_idx" ON "users" ("email");
+```
+
+## Important
+
+After modifying migration SQL (e.g., adding `IF NOT EXISTS` clauses), run:
+
+```bash
+bun run db:generate:client
+```
+
+This updates the hash in `packages/database/src/core/migrations.json`.

package/.agents/skills/hotkey/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: hotkey
+description: Guide for adding keyboard shortcuts. Use when implementing new hotkeys, registering shortcuts, or working with keyboard interactions. Triggers on hotkey implementation or keyboard shortcut tasks.
+---
+
+# Adding Keyboard Shortcuts Guide
+
+## Steps to Add a New Hotkey
+
+### 1. Update Hotkey Constant
+
+In `src/types/hotkey.ts`:
+
+```typescript
+export const HotkeyEnum = {
+  // existing...
+  ClearChat: 'clearChat', // Add new
+} as const;
+```
+
+### 2. Register Default Hotkey
+
+In `src/const/hotkeys.ts`:
+
+```typescript
+import { KeyMapEnum as Key, combineKeys } from '@lobehub/ui';
+
+export const HOTKEYS_REGISTRATION: HotkeyRegistration = [
+  {
+    group: HotkeyGroupEnum.Conversation,
+    id: HotkeyEnum.ClearChat,
+    keys: combineKeys([Key.Mod, Key.Shift, Key.Backspace]),
+    scopes: [HotkeyScopeEnum.Chat],
+  },
+];
+```
+
+### 3. Add i18n Translation
+
+In `src/locales/default/hotkey.ts`:
+
+```typescript
+const hotkey: HotkeyI18nTranslations = {
+  clearChat: {
+    desc: '清空当前会话的所有消息记录',
+    title: '清空聊天记录',
+  },
+};
+```
+
+### 4. Create and Register Hook
+
+In `src/hooks/useHotkeys/chatScope.ts`:
+
+```typescript
+export const useClearChatHotkey = () => {
+  const clearMessages = useChatStore((s) => s.clearMessages);
+  return useHotkeyById(HotkeyEnum.ClearChat, clearMessages);
+};
+
+export const useRegisterChatHotkeys = () => {
+  useClearChatHotkey();
+  // ...other hotkeys
+};
+```
+
+### 5. Add Tooltip (Optional)
+
+```tsx
+const clearChatHotkey = useUserStore(settingsSelectors.getHotkeyById(HotkeyEnum.ClearChat));
+
+<Tooltip hotkey={clearChatHotkey} title={t('clearChat.title', { ns: 'hotkey' })}>
+  <Button icon={<DeleteOutlined />} onClick={clearMessages} />
+</Tooltip>
+```
+
+## Best Practices
+
+1. **Scope**: Choose global or chat scope based on functionality
+2. **Grouping**: Place in appropriate group (System/Layout/Conversation)
+3. **Conflict check**: Ensure no conflict with system/browser shortcuts
+4. **Platform**: Use `Key.Mod` instead of hardcoded `Ctrl` or `Cmd`
+5. **Clear description**: Provide title and description for users
+
+## Troubleshooting
+
+- **Not working**: Check scope and RegisterHotkeys hook
+- **Not in settings**: Verify HOTKEYS_REGISTRATION config
+- **Conflict**: HotkeyInput component shows warnings
+- **Page-specific**: Ensure correct scope activation

package/{.cursor/rules/i18n.mdc → .agents/skills/i18n/SKILL.md}

@@ -1,15 +1,14 @@
 ---
-globs: *.tsx
-alwaysApply: false
+name: i18n
+description: Internationalization guide using react-i18next. Use when adding translations, creating i18n keys, or working with localized text in React components (.tsx files). Triggers on translation tasks, locale management, or i18n implementation.
 ---
 
 # LobeChat Internationalization Guide
 
-## Key Points
-
-- Default language: Chinese (zh-CN), Framework: react-i18next
+- Default language: Chinese (zh-CN)
+- Framework: react-i18next
 - **Only edit files in `src/locales/default/`** - Never edit JSON files in `locales/`
-- Run `pnpm i18n` to generate all translations (or manually translate zh-CN/en-US for dev preview)
+- Run `pnpm i18n` to generate translations (or manually translate zh-CN/en-US for dev preview)
 
 ## Key Naming Convention
 
@@ -19,37 +18,30 @@ alwaysApply: false
 // ✅ Correct
 export default {
   'alert.cloud.action': '立即体验',
-  'clientDB.error.desc': '数据库初始化遇到问题',
   'sync.actions.sync': '立即同步',
   'sync.status.ready': '已连接',
 };
 
-// ❌ Avoid: Nested objects
+// ❌ Avoid nested objects
 export default {
   alert: { cloud: { action: '...' } },
 };
 ```
 
-**Naming patterns:** `{feature}.{context}.{action|status}`
-
-- `clientDB.modal.title` - Feature + context + property
-- `sync.actions.sync` - Feature + group + action
-- `sync.status.ready` - Feature + group + status
+**Patterns:** `{feature}.{context}.{action|status}`
 
 **Parameters:** Use `{{variableName}}` syntax
-
 ```typescript
 'alert.cloud.desc': '我们提供 {{credit}} 额度积分',
 ```
 
-**Avoid key conflicts:** Don't use both a leaf key and its parent path
-
+**Avoid key conflicts:**
 ```typescript
-// ❌ Conflict: clientDB.solve exists as both leaf and parent
+// ❌ Conflict
 'clientDB.solve': '自助解决',
 'clientDB.solve.backup.title': '数据备份',
 
-// ✅ Solution: Use different suffixes
+// ✅ Solution
 'clientDB.solve.action': '自助解决',
 'clientDB.solve.backup.title': '数据备份',
 ```
@@ -68,17 +60,16 @@ import { useTranslation } from 'react-i18next';
 
 const { t } = useTranslation('common');
 
-// Basic
 t('newFeature.title')
-// With parameters
 t('alert.cloud.desc', { credit: '1000' })
+
 // Multiple namespaces
 const { t } = useTranslation(['common', 'chat']);
 t('common:save')
 ```
 
-## Available Namespaces
-
-auth, authError, changelog, chat, color, **common**, components, discover, editor, electron, error, file, home, hotkey, image, knowledgeBase, labs, marketAuth, memory, metadata, migration, modelProvider, models, oauth, onboarding, plugin, portal, providers, ragEval, **setting**, subscription, thread, tool, topic, welcome
+## Common Namespaces
 
 **Most used:** `common` (shared UI), `chat` (chat features), `setting` (settings)
+
+Others: auth, changelog, components, discover, editor, electron, error, file, hotkey, knowledgeBase, memory, models, plugin, portal, providers, tool, topic

package/.agents/skills/linear/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: linear
+description: Linear issue management guide. Use when working with Linear issues, creating issues, updating status, or adding comments. Triggers on Linear issue references (LOBE-xxx), issue tracking, or project management tasks. Requires Linear MCP tools to be available.
+---
+
+# Linear Issue Management
+
+Before using Linear workflows, search for `linear` MCP tools. If not found, treat as not installed.
+
+## Workflow
+
+1. **Retrieve issue details** before starting: `mcp__linear-server__get_issue`
+2. **Check for sub-issues**: Use `mcp__linear-server__list_issues` with `parentId` filter
+3. **Update issue status** when completing: `mcp__linear-server__update_issue`
+4. **Add completion comment** (REQUIRED): `mcp__linear-server__create_comment`
+
+## Creating Issues
+
+When creating issues with `mcp__linear-server__create_issue`, **MUST add the `claude code` label**.
+
+## Completion Comment (REQUIRED)
+
+Every completed issue MUST have a comment summarizing work done. This is critical for:
+- Team visibility
+- Code review context
+- Future reference
+
+## PR Association (REQUIRED)
+
+When creating PRs for Linear issues, include magic keywords in PR body:
+- `Fixes LOBE-123`
+- `Closes LOBE-123`
+- `Resolves LOBE-123`
+
+## Per-Issue Completion Rule
+
+When working on multiple issues, update EACH issue IMMEDIATELY after completing it:
+
+1. Complete implementation
+2. Run `bun run type-check`
+3. Run related tests
+4. Create PR if needed
+5. Update status to **"In Review"** (NOT "Done")
+6. Add completion comment
+7. Move to next issue
+
+**Note:** Status → "In Review" when PR created. "Done" only after PR merged.
+
+**❌ Wrong:** Complete all → Update all statuses → Add all comments
+
+**✅ Correct:** Complete A → Update A → Comment A → Complete B → ...

package/.agents/skills/microcopy/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: microcopy
+description: UI copy and microcopy guidelines. Use when writing UI text, buttons, error messages, empty states, onboarding, or any user-facing copy. Triggers on i18n translation, UI text writing, or copy improvement tasks. Supports both Chinese and English.
+---
+
+# LobeHub UI Microcopy Guidelines
+
+Brand: **Where Agents Collaborate** - Focus on collaborative agent system, not just "generation".
+
+## Fixed Terminology
+
+| Chinese | English |
+|---------|---------|
+| 空间 | Workspace |
+| 助理 | Agent |
+| 群组 | Group |
+| 上下文 | Context |
+| 记忆 | Memory |
+| 连接器 | Integration |
+| 技能 | Skill |
+| 助理档案 | Agent Profile |
+| 话题 | Topic |
+| 文稿 | Page |
+| 社区 | Community |
+| 资源 | Resource |
+| 库 | Library |
+| 模型服务商 | Provider |
+
+## Brand Principles
+
+1. **Create**: One sentence → usable Agent; clear next step
+2. **Collaborate**: Multi-agent; shared Context; controlled
+3. **Evolve**: Remember with consent; explainable; replayable
+
+## Writing Rules
+
+1. **Clarity first**: Short sentences, strong verbs, minimal adjectives
+2. **Layered**: Main line (simple) + optional detail (precise)
+3. **Consistent verbs**: Create / Connect / Run / Pause / Retry / View details
+4. **Actionable**: Every message tells next step; avoid generic "OK/Cancel"
+
+## Human Warmth (Balanced)
+
+Default: **80% information, 20% warmth**
+Key moments: **70/30** (first-time, empty state, failures, long waits)
+
+**Hard cap**: At most half sentence of warmth, followed by clear next step.
+
+**Order**:
+1. Acknowledge situation (no judgment)
+2. Restore control (pause/replay/edit/undo/clear Memory)
+3. Provide next action
+
+**Avoid**: Preachy encouragement, grand narratives, over-anthropomorphizing
+
+## Patterns
+
+**Getting started**:
+- "Starting with one sentence is enough. Describe your goal."
+- "Not sure where to begin? Tell me the outcome."
+
+**Long wait**:
+- "Running… You can switch tasks—I'll notify you when done."
+- "This may take a few minutes. To speed up: reduce Context / switch model."
+
+**Failure**:
+- "That didn't run through. Retry, or view details to fix."
+- "Connection failed. Re-authorize in Settings, or try again later."
+
+**Collaboration**:
+- "Align everyone to the same Context."
+- "Different opinions are fine. Write the goal first."
+
+## Errors/Exceptions
+
+Must include:
+1. **What happened**
+2. (Optional) **Why**
+3. **What user can do next**
+
+Provide: Retry / View details / Go to Settings / Contact support / Copy logs
+
+Never blame user. Put error codes in "Details".