From 241156853cefb6ae61a37aaf75a119c9fde67f85 Mon Sep 17 00:00:00 2001
From: carry <luokairui@carry.fit>
Date: Sun, 7 Jun 2026 13:49:58 +0800
Subject: [PATCH] feat: add description field to Memory & Skills segments for
 better context transparency

---
 src/components/segments/MemoryView.tsx | 3 +++
 src/components/segments/SkillsView.tsx | 3 +++
 src/data/demos.ts                      | 8 ++++++++
 src/types/protocol.ts                  | 2 ++
 4 files changed, 16 insertions(+)

diff --git a/src/components/segments/MemoryView.tsx b/src/components/segments/MemoryView.tsx
index d4eb057..a300d8f 100644
--- a/src/components/segments/MemoryView.tsx
+++ b/src/components/segments/MemoryView.tsx
@@ -12,6 +12,9 @@ export default function MemoryView({ segment }: { segment: MemorySegment }) {
       defaultCollapsed={segment.collapsed}
       badge={`${segment.items.length} 条记忆`}
     >
+      {segment.description && (
+        <p className="text-xs text-gray-400 mb-2 leading-relaxed">{segment.description}</p>
+      )}
       <ul className="space-y-2">
         {segment.items.map((item, i) => (
           <li key={i} className="bg-white/60 rounded px-2 py-1.5">
diff --git a/src/components/segments/SkillsView.tsx b/src/components/segments/SkillsView.tsx
index 726e4cd..7204a0b 100644
--- a/src/components/segments/SkillsView.tsx
+++ b/src/components/segments/SkillsView.tsx
@@ -12,6 +12,9 @@ export default function SkillsView({ segment }: { segment: SkillSegment }) {
       defaultCollapsed={segment.collapsed}
       badge={`${segment.items.length} skills`}
     >
+      {segment.description && (
+        <p className="text-xs text-gray-400 mb-2 leading-relaxed">{segment.description}</p>
+      )}
       <ul className="space-y-1.5">
         {segment.items.map((item, i) => (
           <li key={i} className="text-xs flex items-start gap-2">
diff --git a/src/data/demos.ts b/src/data/demos.ts
index 3fd6632..bf60979 100644
--- a/src/data/demos.ts
+++ b/src/data/demos.ts
@@ -29,6 +29,8 @@ const demoA: PromptEnvelope = {
         },
         {
           kind: 'memory',
+          description:
+            '以下是从过往对话中总结的关于你的信息，模型会参考这些记忆来个性化回复。记忆随对话自动更新，你也可以手动编辑或删除。',
           items: [
             {
               title: '用户背景',
@@ -304,6 +306,8 @@ const demoC: PromptEnvelope = {
         },
         {
           kind: 'skills',
+          description:
+            'Skills 是模型可调用的内置能力（slash commands）。输入 / 开头即可触发，无需等待模型推理。当前对话中启用以下 skills：',
           items: [
             { name: 'summarize', description: '生成文档摘要' },
             { name: 'translate', description: '翻译文档内容' },
@@ -387,6 +391,8 @@ const demoD: PromptEnvelope = {
         },
         {
           kind: 'memory',
+          description:
+            '以下是从过往对话中总结的关于你的信息，模型会参考这些记忆来个性化回复。记忆随对话自动更新，你也可以手动编辑或删除。',
           items: [
             {
               title: '用户身份',
@@ -409,6 +415,8 @@ const demoD: PromptEnvelope = {
         },
         {
           kind: 'skills',
+          description:
+            'Skills 是模型可调用的内置能力（slash commands）。输入 / 开头即可触发，无需等待模型推理。当前对话中可用以下 skills：',
           items: [
             { name: 'deep-research', description: '深度研究 — 多源搜索、交叉验证、生成引用报告' },
             { name: 'code-review', description: '审查代码变更，发现正确性问题和简化机会' },
diff --git a/src/types/protocol.ts b/src/types/protocol.ts
index 25da220..1ca6c7e 100644
--- a/src/types/protocol.ts
+++ b/src/types/protocol.ts
@@ -52,6 +52,7 @@ export interface SystemPromptSegment {
 
 export interface MemorySegment {
   kind: 'memory'
+  description?: string // 简短解释 memory 的作用
   items: MemoryItem[]
   collapsed: boolean
 }
@@ -63,6 +64,7 @@ export interface MemoryItem {
 
 export interface SkillSegment {
   kind: 'skills'
+  description?: string // 简短解释 skills 是什么
   items: SkillItem[]
   collapsed: boolean
 }