How trytodupe/ttd-bot works
ttd-bot is a NoneBot/OneBot chat bot with a broad plugin suite, plus a disabled-by-default isolated QQ development agent. The development workflow accepts routed chat events over a local socket, applies access/admin and session handling, runs agent work in isolated guest slots, and can stage changes or create draft pull requests. The plugin tree also covers subscriptions, statistics, access requests, game/server queries, and Youmind agent interactions. Some plugin implementations and the separate dev-agent documentation were not sampled, so those capability nodes are directory-level and their internal links are omitted.
Main entry points: agent-runtime.ts Agent runtime · controller.ts Event controller · service.py Youmind agent · index.ts Agent launcher
Components 25
Bot capabilities
- Command help
src/plugins/ttd_help/registry.py - Access requests
src/plugins/access_request/service.py - Bilibili subscriptions
src/plugins/bilibili_subscription/service.py - Chat statistics
src/plugins/chat_statistics/statistics.py - Game and score queries
src/plugins/_etx_query/__init__.py - Server checks
src/plugins/mc_server_checker/__init__.py - Youmind agent
src/plugins/youmind_agent/service.py - Youmind client
src/plugins/youmind_agent/client.py - Forward bundles
src/plugins/youmind_agent/forward_bundle.py - Agent results
src/plugins/youmind_agent/results.py
Dev control
- Event controller
dev-agent/src/controller.ts - Socket ingress
dev-agent/src/socket-server.ts - Access and admin
dev-agent/src/access.ts - Session service
dev-agent/src/session-service.ts - Agent launcher
dev-agent/src/index.ts
Isolated execution
- Agent runtime
dev-agent/src/agent-runtime.ts - Slot activation
dev-agent/src/activation.ts - Guest broker
dev-agent/src/guest-broker.ts - Network policy
dev-agent/src/network-policy.ts
State and integrations
- Youmind state
src/plugins/youmind_agent/storage.py - Subscription state
src/plugins/bilibili_subscription/storage.py - GitHub publisher
dev-agent/src/github.ts - Agent state
dev-agent/src/store.ts
Other components
- QQ user
- Chat user
Connections 20
- Youmind agent → Youmind client: calls
src/plugins/youmind_agent/service.py - Youmind agent → Forward bundles: uses
src/plugins/youmind_agent/service.py - Youmind agent → Agent results: uses
src/plugins/youmind_agent/service.py - Youmind agent → Youmind state: persists
src/plugins/youmind_agent/service.py - Bilibili subscriptions → Subscription state: reads and writes
src/plugins/bilibili_subscription/service.py - Socket ingress → Event controller: dispatches
dev-agent/src/socket-server.ts - Event controller → Access and admin: delegates
dev-agent/src/controller.ts - Event controller → Session service: dispatches
dev-agent/src/controller.ts - Event controller → Agent state: queries
dev-agent/src/controller.ts - Session service → Agent runtime: opens sessions
dev-agent/src/session-service.ts - Session service → Agent state: updates state
dev-agent/src/session-service.ts - Agent runtime → Slot activation: activates
dev-agent/src/agent-runtime.ts - Agent runtime → Guest broker: uses
dev-agent/src/agent-runtime.ts - Agent runtime → GitHub publisher: publishes
dev-agent/src/agent-runtime.ts - Agent runtime → Agent state: reads and writes
dev-agent/src/agent-runtime.ts - Slot activation → Guest broker: allocates guest
dev-agent/src/activation.ts - Guest broker → Network policy: applies policy
dev-agent/src/guest-broker.ts - Agent launcher → Socket ingress: starts
dev-agent/src/index.ts - Agent launcher → Event controller: constructs
dev-agent/src/index.ts - Agent launcher → Agent runtime: constructs
dev-agent/src/index.ts