👁 Image
GoesSoftware.SuperSDK.QuaffAgent 7.23.7

SuperSDK.QuaffAgent

可嵌入到 SuperSDK 应用中的编码 Agent，提供 AI 辅助编程、记忆管理、系统提示词配置和内嵌 Avalonia UI 等能力。 所有通知与数据交换均通过 SuperSDK.Core 的 MessageBus 以消息形式发布，不暴露任何 C# event。

架构概览

CodingAgent (IQuaffAgentHandle)
 ├── AgentConfig — 运行参数配置（LLM、工作区、工具开关等）
 ├── MemManager — 记忆管理（mem.db / global_mem.db）
 ├── PromptRepo — 系统提示词块 CRUD（prompt_config 表）
 └── UI 层（可选嵌入）
 └── QuaffWindow
 ├── 对话 Tab — 发送消息、流式输出
 ├── 工具 Tab — 工具调用历史
 ├── 记忆 Tab — 查看/编辑记忆条目
 ├── 配置 Tab — Agent 配置项
 └── 提示词 Tab — 系统提示词块可视化编辑

View 层与 Agent 完全解耦，只能通过 GzMessageBus 请求和接收数据，不持有任何对 Agent 或 DB 的直接引用。

快速开始

using GoesSoftware.SuperSDK.QuaffAgent.Agent;
using GoesSoftware.SuperSDK.QuaffAgent.Messages;
using GzMessageBus = SuperSDK.Core.Messaging.MessageBus;

// 1. 创建 Agent
var agent = new CodingAgent(new AgentConfig
{
 Name = "代码助手",
 SessionName = "my-session",
 WorkspaceRoot = @"D:\MyProject",
 LlmEndpoint = "https://api.openai.com/v1",
 LlmApiKey = "sk-...",
 LlmModel = "gpt-4o",
});

// 2. 注册 ask_user 处理器（必须）
GzMessageBus.RegisterReqHandler<GzQuaffAskUserRequest, string>(this, async req =>
{
 return await MyDialog.AskAsync(req.Question, req.Options);
});

// 3. 订阅输出消息
GzMessageBus.Subscribe<GzQuaffLlmTokenMsg>(this, msg => Console.Write(msg.Text));
GzMessageBus.Subscribe<GzQuaffStatusMsg>(this, msg => Console.WriteLine($"[{msg.Text}]"));

// 4. 发送任务
await agent.RunAsync("帮我审查 Program.cs 中的错误处理逻辑");

AgentConfig 配置项

消息类型

Agent 运行时发布的消息（宿主订阅）

提示词配置消息（View 层与 Agent 间通信）

所有消息均继承 GzQuaffMessage，包含 SessionName（会话标识）和 Timestamp（时间戳）。

系统提示词配置系统

每个 Agent 对应一条系统提示词，定义该 Agent 的角色与行为。存储在工作区 mem.db 的 system_prompt 表中（单行）。

渲染结构

[system_prompt 表中的提示词文本] ← 可通过 UI 或代码配置
当前工作区：{workspace} ← 固定，不可配置
[全局记忆]
[项目记忆]
[Docs/ 目录文档]

通过 UI 管理系统提示词

打开 QuaffWindow → 切换到"提示词"选项卡：一个多行文本编辑器，输入后点击"保存"即可。

通过代码管理系统提示词

// 通过 IQuaffAgentHandle 接口
string current = agent.GetSystemPrompt();

agent.SaveSystemPrompt("你是一个专注于 C# 代码审查的 Agent，每次回答必须指出潜在的安全隐患。");

记忆系统

Agent 使用 SQLite 双库记忆：

数据库由 MemDb.OpenMemDb(workspace) 自动创建并初始化 Schema，包含：

• observations + observations_fts（FTS5 全文检索）
• conversations + conv_sessions
• prompt_config（提示词块）

AskUser 请求注册（必须）

ask_user 工具通过 GzMessageBus 发出请求，不使用 Console 或回调。 宿主必须在启动时注册一个处理器，否则 Agent 调用 ask_user 时会收到失败响应。

GzMessageBus.RegisterReqHandler<GzQuaffAskUserRequest, string>(this, async req =>
{
 // req.Question — 需要问用户的问题文字
 // req.Options — 可选项列表（可能为 null）
 string answer = await MyDialog.AskAsync(req.Question, req.Options);
 return answer;
});

RegisterReqHandler 全局只能注册一个处理器；重复注册会覆盖上一个。

订阅消息示例

using GzMessageBus = SuperSDK.Core.Messaging.MessageBus;
using GoesSoftware.SuperSDK.QuaffAgent.Messages;

GzMessageBus.Subscribe<GzQuaffLlmTokenMsg>(this, msg => myOutputBox.Append(msg.Text));
GzMessageBus.Subscribe<GzQuaffStatusMsg>(this, msg => myStatusBar.Text = msg.Text);
GzMessageBus.Subscribe<GzQuaffErrorMsg>(this, msg => myLogger.Error(msg.Text));
GzMessageBus.Subscribe<GzQuaffToolCallStartMsg>(this, msg => myToolPanel.ShowRunning(msg.ToolName));
GzMessageBus.Subscribe<GzQuaffToolCallEndMsg>(this, msg => myToolPanel.ShowDone(msg.ToolName, msg.Result));

在 ViewModel 析构或 Dispose 时，必须调用 GzMessageBus.UnsubscribeAll(this) 取消所有订阅。

嵌入 Avalonia UI（QuaffWindow）

SuperSDK.QuaffAgent 包含预制 Avalonia 窗口，可直接嵌入到任意 Avalonia 应用：

using GoesSoftware.SuperSDK.QuaffAgent.UI.Windows;

// 创建并绑定 Agent
var window = new QuaffWindow(agent); // agent 实现 IQuaffAgentHandle
window.Show();

窗口包含 5 个选项卡：

发布包注册（gocli）

GoesSoftware.SuperSDK.QuaffAgent 已注册到 gocli supersdk -upload 的发布列表，类型为 ObfuscateWithPublish。

# 随其他包一起发布
gocli supersdk -upload 7.22.0 "feat: 新增系统提示词配置系统"

# 单独发布
gocli supersdk -upload 7.22.0 -pkg quaffagent "feat: 提示词 DB 配置"

注意事项

• Agent 不暴露任何 public event，所有输出通道均为消息总线订阅。
• SessionName 字段可用于在同一进程中区分多个 Agent 实例的消息。
• View 层（含 QuaffWindow）不持有对 DB 或 Agent 内部类的任何直接引用，所有操作均通过 GzMessageBus。
• 若不需要某类消息，不订阅即可，不会影响 Agent 运行。