feat(emotion-e9): add redacted trace diagnostics

这个提交存在于:
agent 2026-08-05 00:52:23 +08:00
父节点 4a423bac69
当前提交 667963a4b8
共有 6 个文件被更改,包括 267 次插入 和 0 次删除

119
emotion_diagnostics.py 普通文件
查看文件

@ -0,0 +1,119 @@
"""Redacted, read-only projection of the cross-plugin emotion pipeline."""
from __future__ import annotations
import hashlib
from typing import Any
def _text(value: Any, limit: int) -> str:
return " ".join(str(value or "").split())[:limit]
def _hash(value: Any) -> str:
cleaned = _text(value, 220)
return hashlib.sha256(cleaned.encode("utf-8", errors="ignore")).hexdigest()[:12] if cleaned else ""
def _ref(value: Any) -> dict[str, str]:
source = value if isinstance(value, dict) else {}
return {"kind": _text(source.get("kind"), 24), "role": _text(source.get("role"), 40), "id_hash": _hash(source.get("id"))}
def emotion_trace_summary(user: Any, *, limit: int = 20) -> list[dict[str, Any]]:
source = user if isinstance(user, dict) else {}
ledger = source.get("emotion_event_ledger")
if not isinstance(ledger, list):
return []
latest: dict[str, dict[str, Any]] = {}
for event in ledger:
if not isinstance(event, dict):
continue
trace_id = _text(event.get("trace_id"), 96)
if not trace_id:
continue
previous = latest.get(trace_id)
if previous is None or int(event.get("revision") or 0) >= int(previous.get("revision") or 0):
latest[trace_id] = event
items = sorted(latest.values(), key=lambda item: (_text(item.get("occurred_at"), 48), int(item.get("revision") or 0)), reverse=True)
return [{
"trace_id": _text(item.get("trace_id"), 96),
"event_id": _text(item.get("event_id"), 96),
"revision": max(1, int(item.get("revision") or 1)),
"event_type": _text(item.get("event_type"), 48),
"status": _text(item.get("status"), 24),
"occurred_at": _text(item.get("occurred_at"), 48),
} for item in items[: max(1, min(100, int(limit or 20)))]]
def build_emotion_trace_projection(
user: Any,
trace_id: str,
*,
daily_state: Any = None,
expression_decision: Any = None,
memory_result: Any = None,
requester_context: Any = None,
) -> dict[str, Any]:
context = requester_context if isinstance(requester_context, dict) else {}
if context.get("is_admin") is not True:
return {"state": "forbidden", "read_only": True, "trace_id": "", "events": [], "error_code": "admin_required"}
source = user if isinstance(user, dict) else {}
trace = _text(trace_id, 96)
ledger = source.get("emotion_event_ledger")
local_events = []
for event in ledger if isinstance(ledger, list) else []:
if not isinstance(event, dict) or event.get("trace_id") != trace:
continue
local_events.append({
"event_id": _text(event.get("event_id"), 96),
"trace_id": trace,
"revision": max(1, int(event.get("revision") or 1)),
"origin_kind": _text(event.get("origin_kind"), 40),
"event_type": _text(event.get("event_type"), 48),
"intensity": float(event.get("intensity") or 0.0),
"confidence": float(event.get("confidence") or 0.0),
"status": _text(event.get("status"), 24),
"source_rule": _text(event.get("source_rule"), 80),
"occurred_at": _text(event.get("occurred_at"), 48),
"applied_interaction": _text(event.get("applied_interaction"), 32),
"correction_of": _text(event.get("correction_of"), 96),
"actor": _ref(event.get("actor_ref")),
"target": _ref(event.get("target_ref")),
"quoted_target": _ref(event.get("quoted_target_ref")),
})
local_events.sort(key=lambda item: item["revision"])
state = daily_state if isinstance(daily_state, dict) else {}
conditions = state.get("conditions") if isinstance(state.get("conditions"), list) else []
afterglow = [{
"condition_id": _text(item.get("id"), 120),
"source_event_id": _text(item.get("source_event_id"), 96),
"source_revision": max(1, int(item.get("source_revision") or 1)),
"energy_delta": float(item.get("energy_delta") or 0.0),
"start_ts": float(item.get("start_ts") or 0.0),
"end_ts": float(item.get("end_ts") or 0.0),
"half_life_seconds": float(item.get("half_life_seconds") or 0.0),
} for item in conditions if isinstance(item, dict) and item.get("kind") == "memory_afterglow" and (not trace or item.get("trace_id") == trace)]
memory = memory_result if isinstance(memory_result, dict) else {}
memory_items = memory.get("items") if isinstance(memory.get("items"), list) else []
return {
"schema_version": "emotion_trace_projection.v1",
"state": "ready" if memory.get("state") in {None, "ready"} else "degraded",
"read_only": True,
"trace_id": trace,
"events": local_events,
"memory_events": memory_items[:100],
"current_interaction": source.get("current_interaction") if isinstance(source.get("current_interaction"), dict) else {},
"afterglow": afterglow[:20],
"daily_state": {
"mood_bias": _text(state.get("mood_bias"), 40),
"energy": max(0, min(100, int(state.get("energy") or 0))),
"affect_modulation": state.get("affect_modulation") if isinstance(state.get("affect_modulation"), dict) else {},
},
"expression_decision": expression_decision if isinstance(expression_decision, dict) else {},
"memory_state": _text(memory.get("state"), 24) or "degraded",
"error_code": _text(memory.get("error_code"), 80),
}
__all__ = ["build_emotion_trace_projection", "emotion_trace_summary"]

查看文件

@ -2319,6 +2319,26 @@ class MemoryCompanionAdapterMixin:
logger.debug("[PrivateCompanion] open-loop 搜索失败: %s", _single_line(exc, 120))
return []
async def _memory_companion_get_emotion_trace(
self,
trace_id: str,
*,
session_id: str = "",
) -> dict[str, Any]:
bridge = self._memory_companion_bridge()
getter = getattr(bridge, "get_emotion_trace_diagnostic", None) if bridge is not None else None
if not callable(getter):
return {"state": "degraded", "read_only": True, "items": [], "error_code": "bridge_method_unavailable"}
try:
return await getter(
trace_id,
{"is_admin": True, "scope": "private", "session_id": _single_line(session_id, 220)},
limit=100,
)
except Exception as exc:
self._memory_companion_optional_dependency_failed(exc, where="get_emotion_trace_diagnostic")
return {"state": "degraded", "read_only": True, "items": [], "error_code": "bridge_exception"}
async def _memory_companion_record_dream_fragment(
self,
*,

查看文件

@ -12,6 +12,7 @@ from quart import request
from .companion_interaction_expression import allowed_expression_bands, current_interaction_projection
from .helpers import _safe_int
from .emotion_diagnostics import build_emotion_trace_projection, emotion_trace_summary
from .relationship_ledger import (
is_owner_exclusive,
normalize_relationship_mode,
@ -282,6 +283,19 @@ class PrivateCompanionPageApiUsersGroupsMixin:
detail["memory_summary"] = await memory_reader(user_id, limit=3)
else:
detail["memory_summary"] = {"available": False, "state": "unsupported", "reason_code": "summary_reader_unavailable"}
detail["emotion_trace_summary"] = emotion_trace_summary(user, limit=20)
trace_id = self._single_line(request.args.get("trace_id", ""), 96)
if trace_id:
trace_reader = getattr(self.plugin, "_memory_companion_get_emotion_trace", None)
memory_trace = await trace_reader(trace_id, session_id=str(user.get("umo") or "")) if callable(trace_reader) else {"state": "degraded", "items": [], "error_code": "bridge_method_unavailable"}
detail["emotion_trace"] = build_emotion_trace_projection(
user,
trace_id,
daily_state=self.plugin.data.get("daily_state"),
expression_decision=detail.get("expression_decision"),
memory_result=memory_trace,
requester_context={"is_admin": True},
)
return self._ok(detail)
except Exception as exc:
logger.error(f"[PrivateCompanionPage] 获取用户详情失败: {exc}", exc_info=True)

查看文件

@ -27345,3 +27345,10 @@ pre {
justify-content: flex-start;
}
}
.emotion-diagnostics .action-strip{display:flex;flex-wrap:wrap;gap:6px;margin:10px 0}
.emotion-diagnostics .action-strip button{min-height:32px}
.emotion-trace-status{display:flex;justify-content:space-between;gap:10px;border-top:1px solid var(--line-soft);padding-top:10px;color:var(--muted);font-size:12px}
.emotion-trace-timeline{display:grid;gap:7px;margin:10px 0 0;padding-left:20px}
.emotion-trace-timeline li{padding-left:4px}
.emotion-trace-timeline li strong,.emotion-trace-timeline li span{display:block}
.emotion-trace-timeline li span{color:var(--muted);font-size:11px}

查看文件

@ -12633,6 +12633,7 @@ async function renderUserDetail(forceFetch = false) {
<div class="detail-grid">
${renderRelationshipPanel(detail.relationship_panel)}
${renderUserMemorySummary(detail.memory_summary)}
${renderEmotionDiagnostics(detail)}
${detailBlock("关系能力", detail.formatted?.relationship || "", [["角色", detail.relationship_role_label || ""], ["群聊关系", groupRelationshipEnabled ? "启用:亲密度与互动表达生效" : "关闭"], ["私聊陪伴", privateEnabled ? "启用" : "关闭:仅在群聊中观测和互动"], ["主动联系", detail.proactive_contact_enabled ? `${detail.effective_daily_limit_text || formatProactiveLimit(detail.effective_daily_limit, detail.effective_daily_limit_unlimited)} / 天` : "关闭"], ["私聊记忆", detail.private_memory_enabled ? "启用" : "关闭"], ["跨群记忆", detail.cross_group_memory_enabled ? "启用" : "关闭"], ["P4", detail.p4_eligible ? "按真实聊天安全门判断" : "不参与"]])}
${renderPrivateDeliveryRoute(detail)}
${renderPrivateBehaviorHabits(detail)}
@ -12805,6 +12806,23 @@ function memorySummaryCount(summary, key) {
return Number.isFinite(number) && number >= 0 ? String(Math.floor(number)) : "-";
}
function renderEmotionDiagnostics(detail) {
const summary = Array.isArray(detail?.emotion_trace_summary) ? detail.emotion_trace_summary.slice(0, 12) : [];
const trace = detail?.emotion_trace && typeof detail.emotion_trace === "object" ? detail.emotion_trace : null;
const timeline = trace
? [...(Array.isArray(trace.events) ? trace.events : []), ...(Array.isArray(trace.memory_events) ? trace.memory_events : [])]
.sort((a, b) => Number(a.revision || 0) - Number(b.revision || 0))
.map((item) => `<li><strong>r${escapeHtml(item.revision || 1)} · ${escapeHtml(item.event_type || "neutral")}</strong><span>${escapeHtml(item.status || "observed")} · ${escapeHtml(item.source_rule || item.origin_kind || "-")}</span></li>`)
.join("")
: "";
return `<section class="detail-block emotion-diagnostics" data-emotion-diagnostics>
<h2>情绪链路诊断</h2>
<p>只读脱敏投影;不包含聊天正文、记忆正文、凭据或本地路径。</p>
<div class="action-strip">${summary.map((item) => `<button type="button" data-emotion-trace-id="${escapeHtml(item.trace_id || "")}">${escapeHtml(item.event_type || "neutral")} · r${escapeHtml(item.revision || 1)}</button>`).join("") || '<span class="muted">暂无事件</span>'}</div>
${trace ? `<div class="emotion-trace-status"><strong>${escapeHtml(trace.state || "degraded")}</strong><span>${escapeHtml(trace.trace_id || "")}</span></div><ol class="emotion-trace-timeline">${timeline || '<li><span>链路部分缺失或 Memory 暂不可用</span></li>'}</ol>` : ""}
</section>`;
}
function safeMemorySummaryText(value) {
return String(value || "")
.replace(/[\r\n\t]+/g, " ")
@ -14028,6 +14046,23 @@ function bindExpressionLibraryActions(library, root) {
});
}
function bindEmotionTraceButtons(detail) {
document.querySelectorAll("[data-emotion-trace-id]").forEach((button) => {
button.addEventListener("click", async () => {
const traceId = String(button.dataset.emotionTraceId || "");
if (!traceId) return;
try {
const updated = await fetchJson(`/user?user_id=${encodeURIComponent(detail.user_id)}&trace_id=${encodeURIComponent(traceId)}`);
const target = document.querySelector("[data-emotion-diagnostics]");
if (target) target.outerHTML = renderEmotionDiagnostics(updated);
bindEmotionTraceButtons(updated);
} catch (error) {
showToast(`诊断读取失败:${error.message}`, "error");
}
});
});
}
function bindUserActions(detail) {
const refreshSelectedUserDetail = async () => {
if (state.selectedUserId === detail.user_id) {
@ -14037,6 +14072,7 @@ function bindUserActions(detail) {
const scoreForm = $("#relationshipScoreForm");
const scoreNumber = $("#relationshipScoreNumber");
const stageForm = $("#relationshipStageForm");
bindEmotionTraceButtons(detail);
stageForm?.addEventListener("submit", async (event) => {
event.preventDefault();
const form = new FormData(event.currentTarget);

查看文件

@ -0,0 +1,71 @@
from __future__ import annotations
import unittest
from emotion_diagnostics import build_emotion_trace_projection, emotion_trace_summary
class EmotionE9DiagnosticProjectionTests(unittest.TestCase):
def user(self) -> dict:
return {
"current_interaction": {"expression_band": "hurt", "load": 42.0, "recovery_band": "recovering"},
"emotion_event_ledger": [{
"event_id": "e1",
"trace_id": "trace-1",
"revision": 1,
"origin_kind": "interaction",
"event_type": "hurt",
"intensity": 80,
"confidence": 0.9,
"status": "observed",
"source_rule": "direct_bot_target",
"occurred_at": "2026-08-04T12:00:00+08:00",
"actor_ref": {"kind": "user", "id": "raw-user-id", "role": "speaker"},
"target_ref": {"kind": "bot", "id": "self", "role": "bot_self"},
"raw_text": "PRIVATE CHAT",
}],
}
def test_projection_requires_admin_and_redacts_source_ids_and_text(self) -> None:
denied = build_emotion_trace_projection(self.user(), "trace-1", requester_context={"is_admin": False})
self.assertEqual("forbidden", denied["state"])
result = build_emotion_trace_projection(
self.user(),
"trace-1",
daily_state={
"energy": 61,
"mood_bias": "低落",
"conditions": [{
"id": "memory-afterglow-e1",
"kind": "memory_afterglow",
"trace_id": "trace-1",
"source_event_id": "e1",
"source_revision": 1,
"energy_delta": -4,
"start_ts": 1,
"end_ts": 2,
"half_life_seconds": 1800,
}],
},
expression_decision={"contract": "companion_interaction_expression.v2", "expression_band": "hurt"},
memory_result={"state": "degraded", "items": [], "error_code": "bridge_exception"},
requester_context={"is_admin": True},
)
self.assertEqual("degraded", result["state"])
self.assertEqual(1, len(result["events"]))
self.assertEqual(1, len(result["afterglow"]))
rendered = repr(result)
self.assertNotIn("PRIVATE CHAT", rendered)
self.assertNotIn("raw-user-id", rendered)
self.assertEqual(12, len(result["events"][0]["actor"]["id_hash"]))
def test_summary_keeps_latest_revision_per_trace(self) -> None:
user = self.user()
user["emotion_event_ledger"].append({**user["emotion_event_ledger"][0], "revision": 2, "status": "revised"})
summary = emotion_trace_summary(user)
self.assertEqual(1, len(summary))
self.assertEqual(2, summary[0]["revision"])
if __name__ == "__main__":
unittest.main()