mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-11-01 14:57:38 +00:00
d35b7b7275
## 1. ONNX 状态补依存句法分析器（onnx.dep_parser）
此前 onnx.enabled 只反映**多模态向量空间**，解析器状态完全不可见 —— 于是
只能靠翻启动日志猜，而日志又曾把「内嵌模型已启用」错报成「规则引擎」
（见上一个提交）。现在健康快照直接给：
"dep_parser": { "enabled": true,
"model_path": "/home/newqqagent/nlp/dep_parser.onnx",
"embedded": true }
- sdk.ONNXStatus 增加 DepParser / DepParserStatus（enabled/model_path/embedded）
- agent 侧由 nlp 包级默认解析器反查实际状态（判据是「真能 Parse 且报得出路径」，
不是「配置里写了 onnx_model_path」）
- healthcheck_kernel 的描述同步说明该字段
## 2. 人格：从「交报告」改成「聊天」
用户反馈实例说话一股人机味。实测原文：
第一件·文件读写：
- 写：files_write 往 /tmp/... 写入 hello-files，回执 11 字节
- 读：files_read 读回来，内容就是 hello-files，对上了
问题不在语气词，而在**结构**：清单体 + 小标题 + 加粗 + 把工具名/字节数/耗时
当成绩单报出来。旧人格只禁了「客服腔四件套」，没禁这些。
DefaultPersonaPrompt 的说话方式一节重写，明确：
- 短句为主；先给结果/情绪，再补解释
- 不用清单体（“-”/“1.”/“•”）、不用小标题/加粗/表格
- 不报工单式细节（不罗列工具名、参数、字节数、耗时）——说人话
- 不用客服腔，拿不准/失败直说
- 只有用户明确要清单/步骤/数据时才结构化
## 3. 本机实例人格同步优化（personal.md，优先级高于配置项）
按同一套规则重写 /home/newqqagent/personal/personal.md，并保留「照大肥鱼那股
活人味来」与形象特征。重启后实测（问「在吗？状态咋样」）：
在呢在呢 (｀・ω・´)
刚拉了个运行时快照看了眼，状态挺好——内核 1.4.0dev 跑着，29 个插件全部 loaded……
刚忙完就赶紧来找我聊天，老大你这节奏也太充实了呗～
无清单、无小标题、无工具名报账。
验证：go test（sdk / agent core / healthcheck / config）全绿；
本机实例重启后 onnx.dep_parser 三字段正确返回。
332 lines
15 KiB
Go
332 lines
15 KiB
Go
package sdk
|
||
|
||
// StatusAPI provides a snapshot of the kernel runtime status.
|
||
type StatusAPI interface {
|
||
GetKernelStatus() *KernelStatus
|
||
}
|
||
|
||
// KernelStatus is the aggregated runtime snapshot of all kernel subsystems.
|
||
type KernelStatus struct {
|
||
Uptime string `json:"uptime"`
|
||
StartTime string `json:"start_time"`
|
||
|
||
// Build 是内核自身的版本与构建信息。
|
||
//
|
||
// 为何需要：此前 WebUI 展示的“版本”取自 `sdk.SDKVersion`，那是 **SDK 仓
|
||
// meta.Version 的硬编码值**；而 `-ldflags` 注入的是内核的
|
||
// `internal/meta.Version`——两条链完全不相交。于是：
|
||
// - 构建时注入的真实版本号、commit、构建时间全部丢失；
|
||
// - 两仲版本号碰巧相等时看不出问题，一旦不等就报错版本；
|
||
// - 无法回答“现网跑的是哪个 commit 构出来的”。
|
||
Build BuildStatus `json:"build"`
|
||
|
||
AgentID string `json:"agent_id"`
|
||
|
||
Plugins []PluginInfo `json:"plugins"`
|
||
Tools []ToolDef `json:"tools"`
|
||
Channels []ChannelInfo `json:"channels"`
|
||
// InputChannels 是 inputch 的**登记与归属**视图（谁注册、划给了哪个 agent、
|
||
// 容量、默认回程输出）。
|
||
//
|
||
// 为何单列：Channels 只描述设备侧能力，回答不了「这条输入归谁」。驻留子 agent
|
||
// 出现之后，归属才是运行态里最该看见的东西——只画设备能力，等于把
|
||
// 「输入路由发生在进内核之前」这条设计事实藏了起来。
|
||
InputChannels []InputChannelInfo `json:"input_channels"`
|
||
|
||
Memory MemoryStatus `json:"memory"`
|
||
Knowledge KnowledgeStatus `json:"knowledge"`
|
||
Documents DocumentStatus `json:"documents"`
|
||
TextMemory TextMemoryStatus `json:"text_memory"`
|
||
Social SocialStatus `json:"social"`
|
||
|
||
LLM LLMStatus `json:"llm"`
|
||
|
||
Context ContextStatus `json:"context"`
|
||
|
||
Runtime RuntimeStatus `json:"runtime"`
|
||
|
||
// ONNX 报告统一多模态向量空间（ONNX 模型）是否**真的在用**。
|
||
//
|
||
// 为何单列：内核的向量能力是三层降级（统一多模态空间 → 词嵌入 → TF-IDF），
|
||
// 只报「向量可用/不可用」分不清「ONNX 模型已加载」与「退回了纯文本路径」。
|
||
// 模型缺失 / 运行时缺失 / provider 打开失败时这里是 enabled=false + reason。
|
||
ONNX ONNXStatus `json:"onnx"`
|
||
|
||
Tracker TrackerStatus `json:"tracker"`
|
||
|
||
// Residents 是驻留式子 agent 的运行时视图（数量 = len(Residents)）。
|
||
Residents []ResidentStatus `json:"residents"`
|
||
|
||
// Scheduler 是输入调度器的运行时快照（可观测性，设计文档 §11 O1/O2）。
|
||
// M2 起输入不再直接排队在 channel 上，而是经 readyQueue/pendingInterrupts/
|
||
// suspendStack 三集合按优先级调度；这里把这些状态暴露出来。
|
||
Scheduler SchedulerStatus `json:"scheduler"`
|
||
|
||
// Usage 是本进程的**累计**用量账目（token 与缓存命中）。
|
||
//
|
||
// 为何单列：内核早已在每次 LLM 调用后记账（agent.core 的 usageLedger），
|
||
// 但运行态里看不到 —— 回答「这个实例花了多少、缓存省了多少」只能翻日志。
|
||
// 放进状态快照后，/kernel、/api/v1/kernel、healthcheck_kernel 就都读得到。
|
||
//
|
||
// 口径：这是**进程生命周期内跨请求的累计**，与 /v1/chat/completions 回包里的
|
||
// usage（单次请求）不同，两者不可互换。
|
||
Usage UsageStatus `json:"usage"`
|
||
}
|
||
|
||
// UsageStatus 是内核累计用量的对外视图。
|
||
//
|
||
// 字段语义与 agent.core 的 UsageTotals 一致（同一份数据源），
|
||
// 放在 SDK 侧是为了让插件/外部调用方能读（Agent 内部类型不可导出）。
|
||
type UsageStatus struct {
|
||
// Calls 是累计 LLM 调用次数（含用量为 0 的调用）。
|
||
Calls int64 `json:"calls"`
|
||
// Prompt / Completion / Total 是累计 token 数。
|
||
Prompt int64 `json:"prompt"`
|
||
Completion int64 `json:"completion"`
|
||
Total int64 `json:"total"`
|
||
// CacheRead 是累计命中缓存的输入 token（即省下来未计算的部分）。
|
||
CacheRead int64 `json:"cache_read"`
|
||
// CacheMiss 是上游明确报告的未命中输入 token。
|
||
CacheMiss int64 `json:"cache_miss"`
|
||
// Reasoning 是累计的思考 token（计费输出里属于思考的部分）。
|
||
Reasoning int64 `json:"reasoning"`
|
||
// CacheReportedCalls 是其中**上游报告了缓存字段**的调用数（命中率的分母）。
|
||
CacheReportedCalls int64 `json:"cache_reported_calls"`
|
||
|
||
// CacheHitRate 只在**有调用报过缓存**时给出，否则为 nil。
|
||
//
|
||
// 为何用指针而非 float64：必须能区分「命中率 0」与「无数据」。
|
||
// 混为一谈会把「没开缓存」显示成「命中率 0%」，
|
||
// 让人去优化一个本来就没开的功能 —— 拿假数据做的决定。
|
||
// nil 时 omitempty 让该键根本不出现，消费方据此显示「—」。
|
||
CacheHitRate *float64 `json:"cache_hit_rate,omitempty"`
|
||
}
|
||
|
||
// SchedulerStatus 是调度器的原子快照 DTO。
|
||
type SchedulerStatus struct {
|
||
// Running 是当前执行的任务（空表示空闲）。
|
||
Running *SchedulerTask `json:"running,omitempty"`
|
||
// Immediate 是刚抢占成功、将在下一个安全点立即运行的中断（最多一个）。
|
||
Immediate *SchedulerTask `json:"immediate,omitempty"`
|
||
// ReadyQueueDepth / PendingInterrupts / SuspendStack 是三个集合的深度。
|
||
ReadyQueueDepth int `json:"ready_queue_depth"`
|
||
PendingInterrupts int `json:"pending_interrupts"`
|
||
SuspendStack int `json:"suspend_stack"`
|
||
MaxSuspendDepth int `json:"max_suspend_depth"`
|
||
|
||
// InterruptQueues 是**四条中断队列各自的深度**，下标即中断级别（1..4）；
|
||
// 下标 0 恒为 0，这样 level 可以直接当数组下标用，省掉调用方 ±1 的翻译。
|
||
//
|
||
// 为什么单列：PendingInterrupts 只是总数，看不清"堵在哪一级"——
|
||
// 四级中断是抢占优先级，堵在 L1 还是 L4 是完全不同的运行状态。
|
||
InterruptQueues [5]int `json:"interrupt_queues"`
|
||
|
||
// SuspendFrames 是中断栈的帧，**栈底 → 栈顶**（只暴露任务标识，不含帧内容）。
|
||
// 深度见 SuspendStack；帧的顺序回答了"谁被谁打断"。
|
||
SuspendFrames []SchedulerFrame `json:"suspend_frames,omitempty"`
|
||
|
||
// InterruptsByLevel / PreemptsByLevel 是各级中断的累计计数（下标 1..4）：
|
||
// 前者=被登记次数（含没抢成的），后者=判定可抢占并进入 immediate 的次数。
|
||
InterruptsByLevel [5]uint64 `json:"interrupts_by_level"`
|
||
PreemptsByLevel [5]uint64 `json:"preempts_by_level"`
|
||
|
||
Enqueued uint64 `json:"enqueued"`
|
||
Executed uint64 `json:"executed"`
|
||
Rejected uint64 `json:"rejected"`
|
||
Suspended uint64 `json:"suspended"`
|
||
Resumed uint64 `json:"resumed"`
|
||
// Preempted = Σ PreemptsByLevel[1..4]，即「真正抢占成功」的次数。
|
||
// 它与 Suspended 不等价（受害者可能先自行结束），因此不是 Suspended 的别名。
|
||
Preempted uint64 `json:"preempted"`
|
||
// Backpressure 是就绪队列满、输入被挡回 channel 的次数（暂时不收，不是丢弃）。
|
||
Backpressure uint64 `json:"backpressure"`
|
||
}
|
||
|
||
// SchedulerFrame 是中断栈里的一帧（供图形化展示"压了几层现场"）。
|
||
type SchedulerFrame struct {
|
||
Task SchedulerTask `json:"task"`
|
||
}
|
||
|
||
// ResidentStatus 是驻留式子 agent 的运行时视图。
|
||
//
|
||
// 为什么进状态面：驻留子是"常驻的独立 agent"，它们的数量、轮次与上下文占用
|
||
// 是运行态里最需要一眼看到的东西（此前只在日志里，WebUI 只能显示文字）。
|
||
type ResidentStatus struct {
|
||
ID string `json:"id"`
|
||
State string `json:"state"`
|
||
Rounds int `json:"rounds"`
|
||
ContextFull bool `json:"context_full"`
|
||
InputChs []string `json:"input_channels,omitempty"`
|
||
AllowedOutputs []string `json:"allowed_outputs,omitempty"`
|
||
InputChTable int `json:"input_ch_table"`
|
||
CreatedAt string `json:"created_at,omitempty"`
|
||
|
||
// OffloadOwned 标记这是**内核为承接积压而拉起**的临时助手（见 core/offload.go）。
|
||
//
|
||
// 为什么要暴露给状态面/工具面：父的模型需要分清"我建的子"与
|
||
// "内核临时拉的分诊助手" —— 前者该按需回收，后者在空闲、无积压时
|
||
// 可以安全回收，而**正忙时不该回收**（会让用户的消息再次无声丢失）。
|
||
OffloadOwned bool `json:"offload_owned,omitempty"`
|
||
|
||
// 以下四项是该驻留子**自己的**调度器积压摘要，用于 per-agent 负载环形图。
|
||
//
|
||
// 根 agent 的积压看 KernelStatus.Scheduler；每个驻留子是独立 agent、
|
||
// 各跑各的调度器，必须分别给，否则「哪个子忙」在界面无从判断。
|
||
ReadyQueueDepth int `json:"ready_queue_depth"`
|
||
PendingInterrupts int `json:"pending_interrupts"`
|
||
SuspendStack int `json:"suspend_stack"`
|
||
InterruptQueues [5]int `json:"interrupt_queues"`
|
||
}
|
||
|
||
// SchedulerTask 是任务的最小标识（不暴露帧内容）。
|
||
type SchedulerTask struct {
|
||
ID uint64 `json:"id"`
|
||
Level int `json:"level"`
|
||
Kind string `json:"kind"`
|
||
}
|
||
|
||
// ONNXStatus 是统一多模态向量空间（ONNX 模型）的启用状态与身份。
|
||
type ONNXStatus struct {
|
||
// Enabled 是 provider 真正打开且元数据合法（不是「配置里写了 provider」）。
|
||
Enabled bool `json:"enabled"`
|
||
// Provider 是配置指定的 provider 名（如 chineseclip / qwen3vl / http）。
|
||
Provider string `json:"provider,omitempty"`
|
||
Dim int `json:"dim,omitempty"`
|
||
Fingerprint string `json:"fingerprint,omitempty"`
|
||
Modalities []string `json:"modalities,omitempty"`
|
||
// Reason 是未启用时的原因（未配置 / 打开失败的具体错误 / 其它）。
|
||
Reason string `json:"reason,omitempty"`
|
||
// DepParser 是**依存句法分析器**的状态。
|
||
//
|
||
// 为什么单独报：ONNX 在内核里有**两个互不相关的消费者** —— 统一多模态
|
||
// 向量空间（Enabled 字段）与依存句法分析器。前者能启用不代表后者也在跑：
|
||
// 解析器可以用二进制内嵌的模型（配置留空时），也可能因缺运行时降级到
|
||
// 规则引擎。只看 Enabled 会把「解析器没启用」这件事完全藏起来，
|
||
// 2026-10-20 就因为启动日志没报实际路径，把内嵌模型误判成规则引擎。
|
||
DepParser DepParserStatus `json:"dep_parser"`
|
||
}
|
||
|
||
// DepParserStatus 是依存句法分析器的运行状态。
|
||
type DepParserStatus struct {
|
||
// Enabled 表示解析器已加载并挂在包级默认位（真正可 Parse）。
|
||
Enabled bool `json:"enabled"`
|
||
// ModelPath 是**实际**加载的模型路径；Enabled=false 时为空。
|
||
ModelPath string `json:"model_path,omitempty"`
|
||
// Embedded 表示模型来自二进制内嵌（core.agent.onnx_model_path 留空）。
|
||
// 二者是独立来源：外置路径与内嵌路径，排查「模型到底是哪来的」时必需。
|
||
Embedded bool `json:"embedded,omitempty"`
|
||
}
|
||
|
||
type PluginInfo struct {
|
||
Name string `json:"name"`
|
||
Loaded bool `json:"loaded"`
|
||
}
|
||
|
||
type ChannelInfo struct {
|
||
Name string `json:"name"`
|
||
// Type 保持为 DeviceType 的数字字符串（历史字段，别改语义）。
|
||
Type string `json:"type"`
|
||
// Direction 是方向的可读名：in（只进）/ out（只出）/ io（双向）。
|
||
Direction string `json:"direction"`
|
||
Ready bool `json:"ready"`
|
||
// 以下三项供通道拓扑展示：此前 collectKernelStatus 只透传了 Name/Type，
|
||
// 把 Description/Tools/OutputCaps 全丢了，前端只能画出一排光秃秃的名字。
|
||
Description string `json:"description,omitempty"`
|
||
Tools []string `json:"tools,omitempty"`
|
||
OutputCaps int `json:"output_caps"`
|
||
CapsText string `json:"caps_text,omitempty"`
|
||
}
|
||
|
||
// InputChannelInfo 是一条 inputch 的登记与归属视图。
|
||
//
|
||
// 字段取自 agent/io 的 ChannelRegistry（根 agent 与驻留子**共用同一份**登记表），
|
||
// 因此它天然覆盖驻留子的通道分配。
|
||
type InputChannelInfo struct {
|
||
Name string `json:"name"`
|
||
// Plugin 是注册它的插件名（归属可追溯）。
|
||
Plugin string `json:"plugin,omitempty"`
|
||
// Owner 是被划给的 agent id；"" = 未分配，归根 agent / 内核默认。
|
||
Owner string `json:"owner,omitempty"`
|
||
// Capacity 是该 inputch 的队列容量；0 = 用内核默认值。
|
||
Capacity int `json:"capacity,omitempty"`
|
||
// Output 是该 inputch 的默认回程输出通道；"" = 由来源决定。
|
||
Output string `json:"output,omitempty"`
|
||
}
|
||
|
||
type MemoryStatus struct {
|
||
Available bool `json:"available"`
|
||
EntityCount int `json:"entity_count"`
|
||
RelationCount int `json:"relation_count"`
|
||
EntityTypes int `json:"entity_types"`
|
||
}
|
||
|
||
type KnowledgeStatus struct {
|
||
Available bool `json:"available"`
|
||
ItemCount int `json:"item_count"`
|
||
Items []string `json:"items,omitempty"`
|
||
}
|
||
|
||
type DocumentStatus struct {
|
||
Available bool `json:"available"`
|
||
DocCount int `json:"doc_count"`
|
||
VectorCount int `json:"vector_count"`
|
||
}
|
||
|
||
type TextMemoryStatus struct {
|
||
Available bool `json:"available"`
|
||
FileCount int `json:"file_count"`
|
||
}
|
||
|
||
type SocialStatus struct {
|
||
Available bool `json:"available"`
|
||
PersonCount int `json:"person_count"`
|
||
}
|
||
|
||
type LLMStatus struct {
|
||
Available bool `json:"available"`
|
||
Provider string `json:"provider,omitempty"`
|
||
Sources int `json:"sources,omitempty"`
|
||
}
|
||
|
||
type ContextStatus struct {
|
||
EventCount int `json:"event_count,omitempty"`
|
||
}
|
||
|
||
type RuntimeStatus struct {
|
||
Goroutines int `json:"goroutines"`
|
||
MemoryMB int64 `json:"memory_mb"`
|
||
GoVersion string `json:"go_version"`
|
||
}
|
||
|
||
// BuildStatus 是内核二进制的构建身份，全部来自 `internal/meta`
|
||
// （由 -ldflags 在构建时注入，未注入时为源码默认值/unknown）。
|
||
type BuildStatus struct {
|
||
// Version 是内核语义版本（如 1.0.0）。
|
||
Version string `json:"version"`
|
||
// Commit 是构建时的 Git 短 hash；未注入为 unknown。
|
||
Commit string `json:"commit"`
|
||
// BuildTime 是 UTC 构建时间；未注入为 unknown。
|
||
BuildTime string `json:"build_time"`
|
||
// SDKCompatible 是本内核可兼容的最高 SDK 版本。
|
||
// 插件用旧 SDK 编译时靠它判断能不能加载。
|
||
SDKCompatible string `json:"sdk_compatible"`
|
||
// KernelName 是内核名（HomeAgent）。
|
||
KernelName string `json:"kernel_name"`
|
||
// SourceURL 是本次构建对应的源码地址。AGPL-3.0 §13 要求：向使用者提供网络
|
||
// 服务时，要给他们拿到 Corresponding Source 的机会——WebUI 状态页会把它渲染成
|
||
// 可见链接，所以**修改后对外部署的分支必须把这个值改指向自己的源码仓库**。
|
||
SourceURL string `json:"source_url,omitempty"`
|
||
// License 是开源许可标识（SPDX，如 AGPL-3.0-only）。
|
||
//
|
||
// 为何与 SourceURL 分开：只看一个源码链接，使用者没法从界面上看出这是什么
|
||
// 许可、网络服务场景下有哪些义务。许可名与许可全文地址是两个独立事实。
|
||
License string `json:"license,omitempty"`
|
||
// LicenseURL 是 License 对应的全文地址。
|
||
LicenseURL string `json:"license_url,omitempty"`
|
||
}
|
||
|
||
type TrackerStatus struct {
|
||
Available bool `json:"available"`
|
||
Dir string `json:"dir,omitempty"`
|
||
}
|