How todayyuec/luckytri works
LuckyTri is a local, persistent conversational companion: messages arrive through OneBot, are interpreted and answered by the conversation runtime, while a separate mind subsystem sustains identity, relationships, attention, and life over time. The WebUI exposes conversations and the companion’s records, settings, and runtime state. README documents these capabilities; the excerpts show API mounting, mind composition, model request handling, and selected frontend behavior, but do not expose all runtime wiring, so uncertain internal links are omitted.
Main entry points: api.ts UI API client · app.js HTTP application · orchestrator.js Conversation orchestration · gateway.js Channel gateway
Components 30
Conversation runtime
- Channel gateway
server/channels/gateway.js - Conversation orchestration
server/core/orchestrator.js - Response generation
server/core/response-generator.js - Model requests
server/core/model-manager.js - Sessions and messages
server/core/sessions.js
Persistent mind
- Mind coordination
server/mind/index.js - Identity and nature
server/mind/nature.js - Attention and choice
server/mind/attention.js - People and bonds
server/mind/bonds.js - Self and thoughts
server/mind/self.js - Time and continuity
server/mind/life.js
Knowledge and vision
- Knowledge manager
server/knowledge/manager.js - Image understanding
server/core/vision-manager.js
Management API
- HTTP application
server/app.js - Mind API
server/mind/api.js - Knowledge API
server/knowledge/api.js - Conversation API
server/core/api.js - Studio settings API
server/studio/settings.js - Management API
server/studio/management.js
Web interface
- Studio application
studio-web/src/App.vue - UI API client
studio-web/src/api.ts - Conversation pages
studio-web/src/pages/chats - Inner-life pages
studio-web/src/pages/heart - People pages
studio-web/src/pages/people - Life pages
studio-web/src/pages/life - Memory pages
studio-web/src/pages/memory - System pages
studio-web/src/pages/system
Other components
- Chat participant
- OneBot 11 endpoint
- Local data store
server/store.js
Connections 25
- Chat participant → OneBot 11 endpoint: sends messages
- OneBot 11 endpoint → Channel gateway: delivers events
- Channel gateway → Conversation orchestration: routes messages
- Conversation orchestration → Response generation: requests reply
- Response generation → Model requests: requests completion
- Model requests → Response generation: returns completion
- Response generation → Conversation orchestration: returns reply
- Conversation orchestration → Channel gateway: dispatches reply
- Channel gateway → OneBot 11 endpoint: sends reply
- HTTP application → Conversation API: mounts routes
- HTTP application → Mind API: mounts routes
- HTTP application → Knowledge API: mounts routes
- HTTP application → Studio settings API: mounts routes
- HTTP application → Management API: mounts routes
- Studio application → UI API client: uses client
- UI API client → HTTP application: calls API
- Mind API → Mind coordination: serves mind data
- Knowledge API → Knowledge manager: serves knowledge
- Conversation API → Conversation orchestration: serves conversations
- Conversation pages → UI API client: requests data
- Inner-life pages → UI API client: requests data
- People pages → UI API client: requests data
- Life pages → UI API client: requests data
- Memory pages → UI API client: requests data
- System pages → UI API client: requests data