增加工作区记忆

Author: linyuan.yang

packages/admin/src/components/modals/MemoryListModal.vue

@@ -3,7 +3,7 @@ import { computed, ref } from 'vue'
 import { useI18n } from 'vue-i18n'
 import { apiFetch } from '@/shared/api'
 import { store } from '@/shared/store'
-import { useToast, SButton, SModal, SBadge } from 'sbot-ui'
+import { useToast, SButton, SModal, SBadge, SSelect } from 'sbot-ui'
 
 interface MemorySummary {
   slug: string
@@ -14,8 +14,11 @@ interface MemorySummary {
   updatedAt: number
   lastReadAt: number | null
   readCount: number
+  scope: 'global' | 'workspace'
 }
 
+interface WorkspaceScope { key: string; path: string }
+
 interface MemoryJob {
   id: number
   type: string
@@ -32,6 +35,8 @@ const { show } = useToast()
 const visible = ref(false)
 const memoryId = ref('')
 const labelOverride = ref('')
+const workspaceScopes = ref<WorkspaceScope[]>([])
+const selectedWorkPath = ref('')
 
 const tab = ref<'memories' | 'jobs'>('memories')
 const loading = ref(false)
@@ -44,10 +49,14 @@ const retryingJobId = ref<number | null>(null)
 
 const rows = ref<MemorySummary[]>([])
 const jobs = ref<MemoryJob[]>([])
-const selectedSlug = ref('')
+const selectedKey = ref('')
 const selectedBody = ref('')
 
-const selected = computed(() => rows.value.find(m => m.slug === selectedSlug.value) || null)
+const rowKey = (m: Pick<MemorySummary, 'scope' | 'slug'>) => `${m.scope}:${m.slug}`
+const selected = computed(() => rows.value.find(m => rowKey(m) === selectedKey.value) || null)
+const viewQuery = computed(() => selectedWorkPath.value
+  ? `viewScope=workspace&workPath=${encodeURIComponent(selectedWorkPath.value)}`
+  : 'viewScope=global')
 
 const title = computed(() => {
   const profiles: any = store.settings.memoryProfiles || {}
@@ -60,8 +69,22 @@ async function openByMemoryId(id: string | null | undefined, label?: string) {
   labelOverride.value = label || ''
   tab.value = 'memories'
   visible.value = true
-  if (memoryId.value) await refresh()
-  else { rows.value = []; jobs.value = []; selectedSlug.value = ''; selectedBody.value = '' }
+  selectedWorkPath.value = ''
+  if (memoryId.value) {
+    await loadScopes()
+    await refresh()
+  } else { rows.value = []; jobs.value = []; selectedKey.value = ''; selectedBody.value = '' }
+}
+
+async function loadScopes() {
+  const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/scopes`)
+  workspaceScopes.value = (res.data?.workspaces || []) as WorkspaceScope[]
+}
+
+async function changeScope() {
+  selectedKey.value = ''
+  selectedBody.value = ''
+  await refresh()
 }
 
 async function refresh() {
@@ -73,12 +96,12 @@ async function loadMemories() {
   if (!memoryId.value) return
   loading.value = true
   try {
-    const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/list`)
+    const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/list?${viewQuery.value}`)
     const list = (res.data?.memories || []) as MemorySummary[]
     rows.value = list
-    const nextSlug = list.find(r => r.slug === selectedSlug.value)?.slug || list[0]?.slug || ''
-    selectedSlug.value = nextSlug
-    if (nextSlug) await loadBody(nextSlug)
+    const next = list.find(r => rowKey(r) === selectedKey.value) || list[0]
+    selectedKey.value = next ? rowKey(next) : ''
+    if (next) await loadBody(next)
     else selectedBody.value = ''
   } catch (e: any) {
     show(e.message, 'error')
@@ -91,7 +114,8 @@ async function loadJobs() {
   if (!memoryId.value) return
   jobsLoading.value = true
   try {
-    const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/jobs?limit=50`)
+    const query = [viewQuery.value, 'limit=50'].join('&')
+    const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/jobs?${query}`)
     jobs.value = (res.data?.jobs || []) as MemoryJob[]
   } catch (e: any) {
     show(e.message, 'error')
@@ -100,17 +124,19 @@ async function loadJobs() {
   }
 }
 
-async function selectMemory(slug: string) {
-  if (selectedSlug.value === slug && selectedBody.value) return
-  selectedSlug.value = slug
-  await loadBody(slug)
+async function selectMemory(memory: MemorySummary) {
+  const key = rowKey(memory)
+  if (selectedKey.value === key && selectedBody.value) return
+  selectedKey.value = key
+  await loadBody(memory)
 }
 
-async function loadBody(slug: string) {
-  if (!memoryId.value || !slug) return
+async function loadBody(memory: MemorySummary) {
+  if (!memoryId.value || !memory.slug) return
   bodyLoading.value = true
   try {
-    const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/entries/${encodeURIComponent(slug)}`)
+    const query = [viewQuery.value, `entryScope=${memory.scope}`].join('&')
+    const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/entries/${encodeURIComponent(memory.slug)}?${query}`)
     selectedBody.value = res.data?.row?.body || ''
   } catch (e: any) {
     selectedBody.value = ''
@@ -124,7 +150,7 @@ async function runConsolidate() {
   if (!memoryId.value || consolidating.value) return
   consolidating.value = true
   try {
-    const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/consolidate/run`, 'POST', {})
+    const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/consolidate/run?${viewQuery.value}`, 'POST', {})
     show(t('memory_profiles.consolidate_queued', { id: res.data?.jobId ?? '-' }))
     await refresh()
   } catch (e: any) {
@@ -138,7 +164,7 @@ async function runReconcile() {
   if (!memoryId.value || reconciling.value) return
   reconciling.value = true
   try {
-    const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/reconcile/run`, 'POST', {})
+    const res = await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/reconcile/run?${viewQuery.value}`, 'POST', {})
     show(t('memory_profiles.reconcile_queued', { id: res.data?.jobId ?? '-' }))
     await refresh()
   } catch (e: any) {
@@ -166,15 +192,16 @@ async function retryExtractJob(job: MemoryJob) {
   }
 }
 
-async function deleteMemory(slug: string) {
-  if (!memoryId.value || !slug || deleting.value) return
-  if (!window.confirm(t('memory_profiles.confirm_delete_memory', { slug }))) return
+async function deleteMemory(memory: MemorySummary) {
+  if (!memoryId.value || !memory.slug || deleting.value) return
+  if (!window.confirm(t('memory_profiles.confirm_delete_memory', { slug: memory.slug }))) return
   deleting.value = true
   try {
-    await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/entries/${encodeURIComponent(slug)}`, 'DELETE')
+    const query = [viewQuery.value, `entryScope=${memory.scope}`].join('&')
+    await apiFetch(`/api/memories/${encodeURIComponent(memoryId.value)}/entries/${encodeURIComponent(memory.slug)}?${query}`, 'DELETE')
     show(t('memory_profiles.delete_memory_done'))
-    if (selectedSlug.value === slug) {
-      selectedSlug.value = ''
+    if (selectedKey.value === rowKey(memory)) {
+      selectedKey.value = ''
       selectedBody.value = ''
     }
     await loadMemories()
@@ -231,8 +258,17 @@ defineExpose({ openByMemoryId })
           <SButton :type="tab === 'jobs' ? 'primary' : 'outline'" size="sm" @click="tab = 'jobs'">
             {{ t('memory_profiles.viewer_jobs') }}
           </SButton>
+          <SSelect v-model="selectedWorkPath" size="sm" @change="changeScope">
+            <option value="">{{ t('memory_profiles.scope_global') }}</option>
+            <option v-for="scope in workspaceScopes" :key="scope.key" :value="scope.path">
+              {{ t('memory_profiles.scope_workspace_context', { path: scope.path }) }}
+            </option>
+          </SSelect>
         </div>
         <div class="memory-actions">
+          <SBadge variant="info" size="sm">
+            {{ t(selectedWorkPath ? 'memory_profiles.operation_scope_workspace' : 'memory_profiles.operation_scope_global') }}
+          </SBadge>
           <SButton type="outline" size="sm" :loading="loading || jobsLoading" @click="refresh">{{ t('common.refresh') }}</SButton>
           <SButton type="outline" size="sm" :loading="reconciling" @click="runReconcile">{{ t('memory_profiles.run_reconcile') }}</SButton>
           <SButton type="outline" size="sm" :loading="consolidating" @click="runConsolidate">{{ t('memory_profiles.run_consolidate') }}</SButton>
@@ -246,13 +282,16 @@ defineExpose({ openByMemoryId })
           <button
             v-for="m in rows"
             v-else
-            :key="m.slug"
+            :key="rowKey(m)"
             class="memory-row"
-            :class="{ active: m.slug === selectedSlug }"
-            @click="selectMemory(m.slug)"
+            :class="{ active: rowKey(m) === selectedKey }"
+            @click="selectMemory(m)"
           >
             <div class="memory-row-head">
-              <SBadge :variant="kindVariant(m.kind)" size="xs">{{ m.kind }}</SBadge>
+              <div class="memory-row-badges">
+                <SBadge variant="neutral" size="xs">{{ m.scope }}</SBadge>
+                <SBadge :variant="kindVariant(m.kind)" size="xs">{{ m.kind }}</SBadge>
+              </div>
               <span class="memory-row-slug">{{ m.slug }}</span>
             </div>
             <div class="memory-row-title">{{ m.title }}</div>
@@ -270,10 +309,11 @@ defineExpose({ openByMemoryId })
               <div class="memory-detail-slug">{{ selected.slug }}</div>
             </div>
             <div class="memory-detail-badges">
+              <SBadge variant="neutral" size="sm">{{ selected.scope }}</SBadge>
               <SBadge :variant="kindVariant(selected.kind)" size="sm">{{ selected.kind }}</SBadge>
               <SBadge variant="neutral" size="sm">{{ t('memory_profiles.evidence') }} {{ selected.evidenceCount }}</SBadge>
               <SBadge variant="neutral" size="sm">{{ t('memory_profiles.read_count') }} {{ selected.readCount }}</SBadge>
-              <SButton type="danger" size="sm" :loading="deleting" @click="deleteMemory(selected.slug)">
+              <SButton type="danger" size="sm" :loading="deleting" @click="deleteMemory(selected)">
                 {{ t('memory_profiles.delete_memory') }}
               </SButton>
             </div>
@@ -379,6 +419,7 @@ defineExpose({ openByMemoryId })
 }
 
 .memory-row-head,
+.memory-row-badges,
 .memory-row-meta,
 .memory-detail-badges,
 .memory-job-head,

packages/admin/src/i18n/en.ts

@@ -548,6 +548,10 @@ export default {
     viewer_title: 'Current Memories: {name}',
     viewer_memories: 'Memories',
     viewer_jobs: 'Background Jobs',
+    scope_global: 'Global Memory Only',
+    scope_workspace_context: 'Workspace + Global: {path}',
+    operation_scope_global: 'Actions: Global',
+    operation_scope_workspace: 'Actions: Current Workspace',
     loading: 'Loading...',
     no_memories: 'No memories',
     no_body: 'No body',

packages/admin/src/i18n/zh.ts

@@ -548,6 +548,10 @@ export default {
     viewer_title: '当前长期记忆：{name}',
     viewer_memories: '长期记忆',
     viewer_jobs: '后台任务',
+    scope_global: '仅全局记忆',
+    scope_workspace_context: '工作区 + 全局：{path}',
+    operation_scope_global: '操作目标：全局',
+    operation_scope_workspace: '操作目标：当前工作区',
     loading: '加载中...',
     no_memories: '暂无长期记忆',
     no_body: '暂无正文',

packages/admin/src/views/automation/MemoryProfilesView.vue

@@ -153,7 +153,7 @@ async function runConsolidate(id: string) {
   if (consolidating.value[id]) return
   consolidating.value[id] = true
   try {
-    const res = await apiFetch(`/api/memories/${encodeURIComponent(id)}/consolidate/run`, 'POST', {})
+    const res = await apiFetch(`/api/memories/${encodeURIComponent(id)}/consolidate/run?viewScope=global`, 'POST', {})
     show(t('memory_profiles.consolidate_queued', { id: res.data?.jobId ?? '-' }))
   } catch (e: any) {
     show(e.message, 'error')

packages/docs-site/guide/memory.md

@@ -17,6 +17,15 @@ Think of it as the agent learning from every conversation without you having to
    - **Reconcile** — re-indexes and prunes stale entries
 4. **Delete** — removed memories are moved to `.archive/` and can be recovered.
 
+## Global and Workspace Memory
+
+One Memory Profile contains two memory layers:
+
+- **Global** — user preferences, machine context, and general workflows that apply across projects.
+- **Workspace** — project paths, conventions, module maps, build steps, and architecture decisions isolated by the current `workPath`.
+
+A channel still selects only one Memory Profile. Each turn reads global memory together with the current workspace memory. Different `workPath` values use separate databases and search indexes, so they cannot search or write one another's entries. Sessions without a configured `workPath`, including ordinary Web conversations, share `~/.sbot/workspace` as their default memory workspace instead of writing everything into global memory. The Memory Profile viewer can switch between global memory and previously created workspaces.
+
 ## Configuration
 
 A **Memory Profile** defines how memories are extracted and read. Sidebar → **Memory Profiles** → New:

packages/docs-site/zh/guide/memory.md

@@ -17,6 +17,15 @@ Memory 是 Agent 的自动长期记忆。后台 **MemoryLLM** 会在每次对话
    - **Reconcile（校正）** —— 重建索引、清理陈旧条目
 4. **删除** —— 被删除的记忆移到 `.archive/`，可恢复。
 
+## 全局与工作区记忆
+
+一个 Memory Profile 同时包含两层记忆：
+
+- **全局** —— 跨项目生效的用户偏好、机器环境和通用工作方式。
+- **工作区** —— 按当前 `workPath` 隔离的项目路径、约定、模块关系、构建步骤和架构决策。
+
+频道仍然只需选择一个 Memory Profile。每轮对话会同时读取全局记忆和当前工作区记忆；不同 `workPath` 使用独立的数据库和检索索引，不会互相搜索或写入。未配置 `workPath` 的会话（包括普通 Web 对话）统一使用 `~/.sbot/workspace` 作为默认记忆工作区，不会把所有内容都写进全局记忆。Memory Profiles 的查看窗口可以在全局和已创建的工作区之间切换。
+
 ## 配置项
 
 **Memory Profile** 定义记忆如何被提取与读取。侧栏 → **Memory Profiles** → 新建：

packages/sbot.commons/src/settings.ts

@@ -78,7 +78,7 @@ export interface EmbeddingConfig {
 /**
  * Memory（skill 风格记忆系统）配置。
  *
- * 一个 memoryProfile = 一组共享的长期记忆（一个目录 + 一个 SQLite 文件）。
+ * 一个 memoryProfile = 一个逻辑长期记忆空间：包含全局记忆，以及按 workPath 隔离的工作区记忆。
  * 写入由后台 MemoryWriterWorker 跑，读取通过 read_memory / search_memory 工具 + menu 注入。
  *
  * channel.memory / sessionProfile.memory 字段的 UUID 在 memoryProfiles 查找。

packages/sbot/prompts/memory/reader/default.md

@@ -8,15 +8,15 @@ Never try to edit or delete an entry yourself.
 
 {{ memory_menu }}
 
-Each line is `- [kind; evidence=N] slug — title`, where the title is the whole entry
-compressed to one line, written to be actionable as it stands, and `evidence=N` is how
+Each line is `- [scope; kind; evidence=N] slug — title`, where `scope` is `global`
+or `workspace`, the title is the whole entry compressed to one line, and `evidence=N` is how
 many separate past conversations mentioned or reinforced it. So treat the menu as
 content, not as an index: reach for a tool only when you need more than that line —
 exact wording, the reasoning behind it, edge cases, or an entry not listed above.
 
 ### How to use
 
-- **`read_memory(slug)`** — full body of one entry by its exact slug. Use when the user
+- **`read_memory(slug, scope)`** — full body of one entry by its exact slug and required scope. Use when the user
   mentions a topic that **clearly matches an entry above** and the title alone isn't
   enough to act on.
 - **`search_memory(query)`** — BM25 over all bodies. Use when the topic isn't visible in
@@ -35,6 +35,9 @@ file, choose a format, run a build, name a thing — check whether an entry cons
 it should be done, and follow it unprompted. A recorded preference that the user has to
 restate is a failed memory.
 
+When global and workspace memories conflict, the workspace entry is more specific and
+wins for the current workPath. Never apply a workspace entry to another workPath.
+
 ### Say it out loud whenever memory is in play
 
 - **You used an entry**: say so in one short phrase ("based on a recorded preference:

packages/sbot/prompts/memory/writer/default.md

@@ -22,7 +22,7 @@ something does not, no matter how confidently it restates what the user "wants".
 
 You receive two things:
 
-1. **Existing memories** — a list of `{slug, kind, evidence, title}`. NO bodies, so you
+1. **Existing memories** — global and current-workspace lists of `{scope, slug, kind, evidence, title}`. NO bodies, so you
    judge overlap from the title alone.
    - When a title looks like it might already cover your candidate but you cannot be
      sure, `update` it instead of creating a sibling: a near-duplicate pair is harder to
@@ -68,7 +68,7 @@ Every operation is one of:
 
 ## `create`
 A genuinely new fact, with no existing slug that overlaps. Required fields:
-`slug`, `title`, `body`. Optional: `kind`. If the slug turns out to already exist, the
+`slug`, `title`, `body`, `scope`. Optional: `kind`. If the slug turns out to already exist, the
 system falls back to `update` and merges — so a near-miss is recoverable, but choosing
 `update` yourself when you suspect overlap gives a better merge.
 
@@ -97,10 +97,10 @@ system falls back to `update` and merges — so a near-miss is recoverable, but
 
 ## `update`
 An existing memory needs revision because new information arrived. Required: `slug`,
-`reason`. Optional: `title`, `body`, `kind`, `bodyMode` — any subset; omitted fields
+`reason`, `scope`. Optional: `title`, `body`, `kind`, `bodyMode` — any subset; omitted fields
 keep their current value.
 
-Use it when the fact changed (a deadline moved), more nuance is now known, or the
+Use the entry's existing `scope`. Use it when the fact changed (a deadline moved), more nuance is now known, or the
 existing title was misleading. Do NOT use it to fold two unrelated topics into one
 entry — that's two `create`s. `reason` is logged for audit.
 
@@ -116,7 +116,8 @@ entry — that's two `create`s. `reason` is logged for audit.
   the entry ends up stating two different rules.
 
 ## `delete`
-An existing memory is wrong, superseded, or no longer relevant. Required: `slug`, `reason`.
+An existing memory is wrong, superseded, or no longer relevant. Required: `slug`, `reason`,
+`scope`; use the entry's existing scope value.
 
 Use it when the fact is now false, the project moved on, or the user explicitly asked
 you to forget it. Bias toward NOT deleting — if uncertain, `update` instead. Archived

packages/sbot/skills/config-guide/SKILL.md

@@ -35,7 +35,7 @@ sbot 运行时配置目录是 `~/.sbot/`。处理配置问题时只需要围绕
 | `savers/<saverId>/` | saver 历史数据 |
 | `notes/<noteId>.db` / `notes/<noteId>/` | note SQLite 与检索缓存 |
 | `wiki/<wikiId>/` | wiki 数据 |
-| `memories/<memoryId>/` | memoryProfile 的长期记忆数据 |
+| `memories/<memoryId>/` | memoryProfile 的全局记忆；`workspaces/<pathHash>/` 下是按 workPath 隔离的记忆 |
 | `agendas/<agendaId>/agenda.db` | agendaProfile 的事项数据 |
 | `profiles/<threadId>/settings.json` | SessionService 的线程级设置，不等同于 Web profile 管理配置 |
 | `database.sqlite` | channel session、session_profile、usage 等数据库表 |
@@ -258,10 +258,10 @@ DELETE /api/settings/agendaProfiles/:id
 
 运行数据：
 
-- memory：`~/.sbot/memories/<memoryId>/`
+- memory：`~/.sbot/memories/<memoryId>/`（全局）+ `workspaces/<pathHash>/`（当前 workPath 独有）
 - agenda：`~/.sbot/agendas/<agendaId>/agenda.db`
 
-`enabled: false` 表示引用可以存在，但运行时不启用。`memoryProfiles.writerModel` 必须指向 `models` 中的 UUID。`agendaProfiles.syncModel` 可选；为空时同步抽取不启用。
+`enabled: false` 表示引用可以存在，但运行时不启用。`memoryProfiles.writerModel` 必须指向 `models` 中的 UUID。频道仍只引用一个 memoryProfile；同一个 MemoryService 会同时读取全局记忆和当前 workPath 记忆，项目内容不会进入其他 workPath。未配置 workPath 的会话（包括普通 Web 对话）统一使用 `~/.sbot/workspace` 作为默认记忆工作区。`agendaProfiles.syncModel` 可选；为空时同步抽取不启用。
 
 Agenda item 管理走：