microcopy
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 |
| 评测 | Evaluation |
| 基准 | Benchmark |
| 数据集 | Dataset |
| 用例 | Test Case |
Brand Principles
- Create: One sentence → usable Agent; clear next step
- Collaborate: Multi-agent; shared Context; controlled
- Evolve: Remember with consent; explainable; replayable
Writing Rules
- Clarity first: Short sentences, strong verbs, minimal adjectives
- Layered: Main line (simple) + optional detail (precise)
- Consistent verbs: Create / Connect / Run / Pause / Retry / View details
- 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:
- Acknowledge situation (no judgment)
- Restore control (pause/replay/edit/undo/clear Memory)
- 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:
- What happened
- (Optional) Why
- What user can do next
Provide: Retry / View details / Go to Settings / Contact support / Copy logs
Never blame user. Put error codes in "Details".
More from lobehub/lobe-chat
drizzle
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.
598typescript
TypeScript code style and optimization guidelines. MUST READ before writing or modifying any TypeScript code (.ts, .tsx, .mts files). Also use when reviewing code quality or implementing type-safe patterns. Triggers on any TypeScript file edit, code style discussions, or type safety questions.
582react
React component development guide. Use when working with React components (.tsx files), creating UI, using @lobehub/ui components, implementing routing, or building frontend features. Triggers on React component creation, modification, layout implementation, or navigation tasks.
579zustand
Zustand state management guide. Use when working with store code (src/store/**), implementing actions, managing state, or creating slices. Triggers on Zustand store development, state management questions, or action implementation.
564project-overview
Complete project architecture and structure guide. Use when exploring the codebase, understanding project organization, finding files, or needing comprehensive architectural context. Triggers on architecture questions, directory navigation, or project overview needs.
547i18n
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.
542