把 Agent 打造成古代朝廷里的文武百官——你会得到什么惊喜？

嘿，技术侠！Ru果你正在摸索多智Neng体系统，却总觉得它们像无头苍蝇一样盲目跑动，那就请跟我一起“上朝”吧！我们将 Agent 像丞相、宰相、书生一样排队，给它们一套完整的“朝堂规矩”，让每一次决策douNeng在屏幕上变成可视化的“宫殿走廊”。这不只是技术升级，geng是一场情感共振。

传统框架往往把 Agent 的内部思考藏在深层日志里。你只Nengkan到一串堆叠的输出，根本无法判断它是在哪一步卡住了。想象一下Ru果你Ke以kan到一个小人正忙着翻阅《大典》，或是在等着皇帝下达命令，那种直观的体验才是Zui佳的调试方式。

我们用Risk Level标签标记每一次工具调用：

// 普通查询，无需人工干预  
tool.call;

// 文件读取，需要确认路径是否安全  
tool.call;

// 金融转账，高风险操作  
tool.call;

当风险被评估为 high 时Agent 并不会直接执行，而是进入 WAITING_FOR_HUMAN 状态，并触发一段动画：小丞相被关进了天牢，等待皇帝赐予批准。

Syntropy 的核心理念hen简单：让所有决策过程douNeng被可视化。通过 Phaser 的 WebGL 渲染，你Ke以kan到每一次任务拆分、每一次工具调用，dou在宫殿里有对应的小人奔跑。

"Syntropy 本质上是一次将 AI 黑盒具象化的尝试。"——这句话点出了我们的使命。

前端完全解耦于后端业务逻辑：React 用来构建 UI，Phaser 用来渲染游戏场景，两者通过 Zustand 的状态桥接实现实时同步。这样既保证了 UI 响应速度，又不牺牲渲染细节。

Syntropy 并未依赖任何现有框架，而是从头实现一个有限状态机，其核心状态包括：

IDLE: 等待指令

THINKING: 在 LLM 中生成思路链

ACTIONING: 调用外部工具并评估风险等级

WAITING_FOR_HUMAN: 高风险时等待人工批准

SLEEPING / IDLE_AFTER_TASKS: 完成任务后进入休眠，自动对话内容并写入记忆库，以防 Token 超限。

ERROR: 出现异常时记录错误信息并暂停执行。

// server/core/Agent.ts  
class Agent {  
    private state: AgentState = 'IDLE';  
    async processMessage {  
        this.setState;  
        const response = await this.llm.chat;  
        if  {  
            for  {  
                const risk = this.assessRisk;  
                if  {  
                    this.setState;  
                    await this.waitForApproval;   // 人工干预环节    
                }   
                await this.executeTool;   // 执行低/中风险工具    
            }   
        }   
        this.setState;    
        return response.content;   
    }   
    private setState { /* geng新 FSM */ }   
}

每一次用户交互dou会生成唯一 并贯穿整个流程：

A 指令分发 → B 工具调用 → C LLM 推理 → D 审批回执 → E Zui终响应。

Triage 与诊断事件会自动脱敏，例如截断 API Key 等敏感信息，让性Neng分析geng安全。

Tiny log 与大型事件Ke以同时保留，让团队既Neng快速定位 bug，也NengZuo深度性Neng调优。

Syntropy 并不满足于纯向量检索或仅关键词匹配，它采用 Reciprocal Rank Fusion算法，将 FTS 和向量检索结果融合，从而兼顾语义匹配和精确度。举个例子，当用户问 “上季度营收是多少？” 时引擎会同时检索数据库表中的历史记录和嵌入向量空间中的相关文本，然后通过 RRF 给出综合排名，从而避免单纯关键字漏掉重要上下文。

MOTIVATION: “代理人自主调用工具是一件非常危险的事。”—删除文件、转账、外部 API 调用，一旦失控后果难以逆转。 所以我们在设计时加入了层层防护：高风险操作必须进入人工审核；低/中风险则直接执行，但仍保留审计日志。 这套机制让“人审”不再是事后补救，而是整个执行流程的一部分。 Zui终，你只需关注宫殿里的行动轨迹，而不是翻滚终端日志。

"当丞相收到一道复杂指令，他不会直接给出答案，而是拆解任务、调度六部尚书，然后汇果。" 在视觉层面这表现为一棵决策树，在游戏中展现为宫殿走廊上的节点跳跃。

#1 拟圣旨：  用户输入指令，就像皇帝下达命令。系统生成 , 并把它包装成奏折，交给丞相处理。

#2 受理 & 分发：  丞相拆分任务，各部门各司其职，通过 Phaser 渲染他们在不同房间内协作。

#3 復命：  完成后小人们返回宫廷，把奏折递给皇帝进行御批。若出现问题，他们会停下来等你确认或者修改指令，再继续工作。

#4 皇帝即使只是点个 “确定”，也算完成了一次真实交互；若点击 “取消”，就像撤回一份密信，让整个流程重新开始。

日常使用感受 — kan见即知晓

"当我打开系统，kan见丞相Yi经站在廷议之上等待我的指示；六部尚书各就各位，我只需轻轻一点，即可kan到他们奔波劳碌。" 那种感觉类似于《王者荣耀》里召唤师峡谷，但geng真实、geng有温度。

**高效** — 自动拆解任务，让工程师Ke以专注业务逻辑而非手动调度。

**透明** — 所有决策路径dou有可视化展示，错误不再隐藏在日志深处。

**安全** — 高风险动作必须得到人工审核，避免不可逆损失。