DevCrystal TaskForge
*当你可以从库存中拿出一块发光的水晶并把它扔到墙上时，为什么要在待办事项列表中添加alt标签？*
Terraria的tModLoader mod，可以将你的Omnispindle任务积压转换为世界内的物品、咒语和传说。现在，你的开发工作流程就在游戏中。任务如流星般从天而降。紧急工作在你的任务栏上闪闪发光。完成任务会引发粒子风暴并同步回服务器。
实验室和沙箱是同一个地方。
______________________________________________________________________
建造了什么
物品
| 物品 | 稀有 | 它的作用 |
|---|---|---|
| 任务水晶 | 优先级映射 | 物理形式的待办事项。悬停可查看描述、项目和优先级。右键单击完成--触发视觉效果，播放优先级缩放的声音，并发送 PUT /api/todos/{id}/complete Omnispindle。然后，水晶消失了。 |
| TaskForge魔杖 | 绿色 | 施放任务创建法术。打开聊天命令提示符 /createtask.配方：法力水晶+3颗陨落之星+钻石@铁砧。 |
| 占卜水晶透镜 | 蓝色 | 扫描您的库存中的任务水晶，在匹配的水晶周围创建发光效果。钩住 /searchcrystals 用于对本地库存和MCP服务器进行全文搜索。 |
| Dev智慧法典 | 橙色 | 知识Grimoire。通过以下方式将经验教训记录到Omnispindle课程系统中 /addlesson库存中闪烁着金色正弦波的脉冲。由开发者的眼泪和咖啡驱动。 |
聊天指令
/createtask [priority] [project] [description]
Creates a task crystal and POSTs to Omnispindle if connected.
Priority: low | medium | high | urgent | critical
Project: madness_interactive | omnispindle | terraria | devcrystal | inventorium
Example: /createtask high omnispindle Fix the MQTT reconnect loop
/listtasks
Scans your inventory and lists all task crystals with priority-colored output.
/searchcrystals [query]
Searches inventory crystals by description, project, or priority.
Also queries GET /api/todos/search?query=... on the MCP server.
Matching crystals glow.
/addlesson [language] [topic] [lesson]
Records a lesson to Omnispindle's lessons system.
Languages: csharp, python, javascript, rust, general优先级系统
每个任务水晶都有其稀有性、颜色和声音的优先级：
| 优先级 | 稀有性 | 颜色 | 完成声音 |
|---|---|---|---|
| 低 | 白色 | 浅灰色 | 柔和的铃声 |
| 中等 | 蓝色 | 浅蓝色 | 标准 |
| 高 | 橙色 | 橙色 | 标准 |
| 紧急 | 红色 | 红色 | 尖锐 |
| 关键 | 紫色 | 紫色 | 史诗 |
颗粒计数具有紧迫性。关键任务的完成是一个事件。
______________________________________________________________________
全主轴集成
mod运行一个 MCPClient 直接与Omnispindle HTTP API对话：
GET /health — connection check on load
POST /api/todos — create task (from /createtask)
PUT /api/todos/{id}/complete — complete task (from crystal right-click)
GET /api/todos/search?query=... — search tasks (from /searchcrystals)
GET /api/projects — list projects客户端在以下时间初始化 PostSetupContent() 并异步测试连接。如果Omnispindle没有运行，每个操作都会优雅地降级——任务晶体仍然在本地工作，完成情况会被记录下来，尝试并报告同步。游戏在网络通话中从不停顿。
配置位于tModLoader mod-config UI（客户端）中：
MCP Server Host: localhost
MCP Server Port: 8000
Enable MCP: true
Task Meteors: true (urgent tasks rain from the sky)
Meteor Frequency: 30s
Completion Effects: true
Agent NPCs: true (planned — AI agents as world NPCs)______________________________________________________________________
建筑
DevCrystalTaskForge.cs — Mod entry point, MCPClient lifecycle
├── MCPClient — HttpClient wrapper, async REST calls, graceful fallback
└── MCPResponse — Success/failure wrapper
Content/Items/
├── TaskCrystal.cs — ModItem: todo as inventory item, async completion
├── TaskForgeWand.cs — ModItem: spell wand, crafting recipe
├── DivinationLens.cs — ModItem: crystal search + inventory highlight
└── KnowledgeGrimoire.cs — ModItem: lesson recording, pulsing glow effect
Common/
├── Commands/
│ ├── TaskCommands.cs — /createtask, /listtasks, /searchcrystals
│ ├── ProjectCommands.cs — project listing commands
│ └── LessonCommands.cs — /addlesson and lesson search
└── Config/
└── ModConfig.cs — tModLoader client config: host, port, gameplay toggles______________________________________________________________________
安装
- 安装 tModLoader （与Terraria 1.4.x兼容）
- 将此仓库克隆到您的tModLoader Mods文件夹中：
~/.local/share/Terraria/tModLoader/Mods/DevCrystalTaskForge/- 建立
dotnet build或通过tModLoader的游戏内构建系统 - 在tModLoader mod浏览器中启用mod
- 启动Terraria，打开Mod Configuration，设置Omnispindle主机/端口
- 进入一个世界，锻造你的第一块水晶
______________________________________________________________________
路线图
第一阶段——基金会（目前）
- \[x\] 具有优雅回退功能的HTTP MCP客户端
- \[x\] 任务水晶物品——优先级稀有性、完成效果、MCP同步
- \[x\] TaskForge魔杖——制作配方、施法
- \[x\] 占卜镜——库存扫描、水晶高亮、服务器搜索
- \[x\] 知识Grimoire——课程记录界面，脉冲发光
- \[x\] 聊天命令：
/createtask,/listtasks,/searchcrystals - \[x\] tModLoader配置系统（主机、端口、游戏切换）
第二阶段——生活世界
- \[\]任务流星事件——紧急任务从天而降
- \[\]AI代理NPC——每个Omnispindle代理都成为一个命名的世界NPC
- \[\]NPC对话——通过对话创建自然语言任务
- \[\]实时更新——订阅任务更改，世界做出反应
第三阶段——世界状况
- \[\]项目保护区——随着项目完成率的增长而增长的建筑
- \[\]持续的世界数据——开发环境在会话更改中幸存下来
- \[\]多人游戏同步——整个团队共享开发世界
- \[\]成就系统——通过完成连击解锁法术
第四阶段——生态系统
- \[\]额外的MCP服务器支持（SwarmDesk、自定义服务器）
- \[\]用于自定义行为的插件架构
- \[\]Cogwyrm2移动伴侣集成
- \[\]分析和生产力叠加
______________________________________________________________________
发展
基于tModLoader框架构建。需要。NET 6+和tModLoader SDK。
# Install .NET if needed
./dotnet-install.sh
# Build
dotnet build
# Or use tModLoader's in-game build/reload看 GETTING_STARTED.md 有关首次设置的详细信息。
______________________________________________________________________
为什么
因为最好的界面是你无论如何都会使用的界面。Terraria已经是思考发生的地方——建筑、探索、系统内的系统。任务积压不应该存在于另一个窗口中。它应该是您热条中的一个发光水晶，当您完成它时，右键单击它，它会爆炸成金色的火花，在MongoDB数据库的某个地方，todo会翻转到 completed.
实验室现在到处都是。
______________________________________________________________________
*部分 疯狂互动 车间生态系统。* *连接到：Omnispindle（任务管理）| SwarmDesk（代理协调）*