核心原理

消息处理链路

从消息进入到回复回发的端到端流程

消息处理链路

以 chat 渠道为例，一条消息的主流程如下：

  1. 渠道适配器接收入站消息。
  2. 解析 sessionId / chatKey，写入历史与元信息。
  3. Runtime 按会话串行调度并执行 Agent。
  4. Agent 调用工具（如 chat send）产出用户可见回复。
  5. 回复回发到渠道并写入日志。

关键目录

  • .downcity/agents/<agentId>/sessions/<sessionId>/messages/messages.jsonl
  • .downcity/channel/meta.json
  • .downcity/chat/<sessionId>/history.jsonl
  • .downcity/logs/<YYYY-MM-DD>.jsonl

排障入口

上下文工程

Downcity 如何让 Agent 上下文保持明确、可落盘、可检查

Skills

Skill 目录、发现逻辑与 list/lookup 优先工作流

目录

消息处理链路关键目录排障入口