dsh-plugin-xujie-memory 0.5.0 → 0.7.0

package/src/client/icons.tsx

@@ -0,0 +1,28 @@
+import type { ReactNode } from 'react'
+
+function Svg({ children, size = 16 }: { children: ReactNode; size?: number }) {
+  return <svg width={size} height={size} viewBox="0 0 16 16" fill="none" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true" focusable="false">{children}</svg>
+}
+export const IconSearch = () => <Svg><circle cx="7" cy="7" r="4.5" /><path d="m10.5 10.5 3 3" /></Svg>
+export const IconClose = () => <Svg><path d="m4 4 8 8M12 4l-8 8" /></Svg>
+export const IconBack = () => <Svg><path d="M10 3.5 5.5 8l4.5 4.5" /></Svg>
+export const IconPlus = () => <Svg><path d="M8 3.5v9M3.5 8h9" /></Svg>
+export const IconMinus = () => <Svg><path d="M3.5 8h9" /></Svg>
+export const IconReset = () => <Svg><path d="M3.2 6.2A5 5 0 1 1 3 8.8" /><path d="M3 3v3.4h3.4" /></Svg>
+export const IconPause = () => <Svg><path d="M6 4v8M10 4v8" /></Svg>
+export const IconPlay = () => <Svg><path d="M5.5 3.8v8.4L12 8z" /></Svg>
+export const IconLock = () => <Svg size={20}><rect x="3.5" y="7" width="9" height="6.5" rx="1.5" /><path d="M5.5 7V5.2a2.5 2.5 0 0 1 5 0V7" /></Svg>
+export const IconAlert = () => <Svg size={20}><path d="M8 2.5 14 13H2z" /><path d="M8 6.5v3" /><path d="M8 11.4v.1" /></Svg>
+export const IconEdit = () => <Svg><path d="M10.5 3 13 5.5 6 12.5H3.5V10z" /></Svg>
+export const IconForget = () => <Svg><path d="M3 4.5h10M6.5 4.5V3h3v1.5M4.5 4.5l.6 8.5h5.8l.6-8.5" /></Svg>
+export const IconArrow = () => <Svg><path d="M6 3.5 10.5 8 6 12.5" /></Svg>
+
+/** Sidebar glyph: a soma with apical, lateral and basal processes. */
+export function NeuronGlyph({ size }: { size: number }) {
+  return <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true" focusable="false">
+    <circle cx="12" cy="12.5" r="2.6" />
+    <path d="M12 9.9V3.5M12 6.2 8.8 3.8M12 6.2l3.2-2.4" />
+    <path d="M9.6 11.6 4 9.6M14.4 11.6l5.6-2" />
+    <path d="M10.4 14.6 6.5 20M13.6 14.6l3.9 5.4M12 15.1V21" />
+  </svg>
+}

package/src/client/index.tsx

@@ -0,0 +1,59 @@
+import type { Context } from '@deepseek-ai/cordis'
+import type { MainPanelId } from '@deepseek-ai/dsh-client-ui-layout/client'
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'
+import type {} from '@deepseek-ai/dsh-client-ui-sidebar/client'
+import type {} from '@deepseek-ai/dsh-api-remotes/client'
+// Generated Typert contribution (ctx.remote.xujieMemory face + DTO codecs).
+import type {} from '../../lib/typert.remote-client.js'
+import contribution from '../../lib/typert.remote-client.js'
+import { MemoryPanel } from './MemoryPanel.tsx'
+import { NeuronGlyph } from './icons.tsx'
+import PANEL_CSS from './panel.css'
+
+/** One id brands the main panel and its sidebar launcher. */
+export const PANEL_ID = 'xujie-memory' as MainPanelId
+
+/** Browser services this contribution needs before apply runs. */
+export const inject = ['slots', 'remote']
+
+export function apply(ctx: Context): void {
+  // 1. Mount the generated Remote contribution first. `remote.xujieMemory` only
+  //    exists after this resolves, so injecting it before mounting would deadlock.
+  //    $mount registers its own effect on this ctx; the returned disposer is also
+  //    tied to this effect so unload unmounts the namespace.
+  ctx.effect(() => ctx.remote.$mount(contribution), 'xujie-memory: remote contribution')
+
+  // 2. Lifecycle-scoped stylesheet: every rule is .xjm-* prefixed and removed on unload.
+  ctx.effect(() => {
+    const style = document.createElement('style')
+    style.dataset.xujieMemory = 'panel'
+    style.textContent = PANEL_CSS
+    document.head.append(style)
+    return () => style.remove()
+  }, 'xujie-memory: panel styles')
+
+  // 3. Only after the namespace is live: register the main panel and its launcher.
+  //    Registrations live on the injected child context, so they are withdrawn if
+  //    the Remote namespace disappears (plugin unload or connection reset).
+  ctx.inject(['slots', 'remote.xujieMemory'], inner => {
+    const memoryRemote = inner.remote.xujieMemory
+    inner.slots.inject('main', () => inner.slots.register({
+      name: 'main',
+      key: PANEL_ID,
+      inject: () => ({ remote: memoryRemote }),
+    }, MemoryPanel))
+    inner.slots.inject('sidebar.panellist', () => inner.slots.register({
+      name: 'sidebar.panellist',
+      id: PANEL_ID,
+      label: '记忆',
+      order: 140,
+    }, MemoryPanelIcon))
+  })
+}
+
+/** Sidebar launcher glyph; the sidebar owns the button, label and active state. */
+export function MemoryPanelIcon({ size }: PropsRuntime<'sidebar.panellist'>) {
+  return <NeuronGlyph size={size} />
+}
+
+export { MemoryPanel }

package/src/client/memory-adapter.ts

@@ -0,0 +1,67 @@
+import type { Catalog, EditResult, ForgetResult, SearchHit, Snapshot, Trace } from './types.ts'
+
+/** Structural RemoteResult: `{ ok: true, value }` or `{ ok: false, error }` (RemoteError instance). */
+export type Result<T> =
+  | { readonly ok: true; readonly value: T }
+  | { readonly ok: false; readonly error: { readonly code: string; readonly message: string; readonly details?: unknown } }
+
+/** The typed Remote face generated from MemoryController (ctx.remote.xujieMemory). */
+export interface XujieMemoryRemote {
+  catalog(): Promise<Result<Catalog>>
+  snapshot(scopeId: string): Promise<Result<Snapshot>>
+  detail(scopeId: string, traceId: string): Promise<Result<Trace>>
+  search(scopeId: string, query: string): Promise<Result<SearchHit[]>>
+  edit(scopeId: string, traceId: string, content: string, expectedHash: string): Promise<Result<EditResult>>
+  forget(scopeId: string, traceId: string, expectedHash: string): Promise<Result<ForgetResult>>
+}
+
+export type FailureKind = 'owner' | 'conflict' | 'not_found' | 'scope' | 'invalid' | 'unavailable' | 'unknown'
+
+export class MemoryFailure extends Error {
+  readonly code: string
+  readonly reason: string
+  readonly kind: FailureKind
+  constructor(code: string, message: string, details?: unknown) {
+    super(message)
+    this.name = 'MemoryFailure'
+    this.code = code
+    const reason = typeof details === 'object' && details !== null && typeof (details as { reason?: unknown }).reason === 'string'
+      ? (details as { reason: string }).reason : ''
+    this.reason = reason
+    this.kind = code === 'xujie-memory/owner-required' ? 'owner'
+      : /version_conflict/.test(reason) ? 'conflict'
+      : /trace_not_found/.test(reason) ? 'not_found'
+      : /scope_not_found/.test(reason) ? 'scope'
+      : /invalid_content_length/.test(reason) ? 'invalid'
+      : code === 'xujie-memory/rejected' ? 'unavailable' : 'unknown'
+  }
+}
+
+/** Unwrap one RemoteResult; failures become typed UI errors, never silent empties. */
+export function unwrap<T>(result: Result<T>): T {
+  if (result && result.ok === true) return result.value
+  const error = (result as { error?: { code?: string; message?: string; details?: unknown } } | undefined)?.error
+  throw new MemoryFailure(error?.code ?? 'unknown', error?.message ?? '记忆库操作未完成', error?.details)
+}
+
+export function asFailure(error: unknown): MemoryFailure {
+  if (error instanceof MemoryFailure) return error
+  const e = error as { code?: unknown; message?: unknown; details?: unknown } | undefined
+  if (e && typeof e.code === 'string') return new MemoryFailure(e.code, String(e.message ?? ''), e.details)
+  return new MemoryFailure('unknown', error instanceof Error ? error.message : '记忆库操作未完成')
+}
+
+/** UI adapter: every scope ID comes from catalog; no user ID, kernel token or URL is accepted. */
+export class MemoryAdapter {
+  constructor(private readonly remote: XujieMemoryRemote) {}
+  async catalog(): Promise<Catalog> { return unwrap(await this.remote.catalog()) }
+  async snapshot(scopeId: string): Promise<Snapshot> { return unwrap(await this.remote.snapshot(scopeId)) }
+  async detail(scopeId: string, traceId: string): Promise<Trace> { return unwrap(await this.remote.detail(scopeId, traceId)) }
+  async search(scopeId: string, query: string): Promise<SearchHit[]> { return unwrap(await this.remote.search(scopeId, query)) }
+  async edit(scopeId: string, traceId: string, content: string, expectedHash: string): Promise<EditResult> {
+    return unwrap(await this.remote.edit(scopeId, traceId, content, expectedHash))
+  }
+  async forget(scopeId: string, traceId: string, expectedHash: string): Promise<ForgetResult> {
+    return unwrap(await this.remote.forget(scopeId, traceId, expectedHash))
+  }
+}

package/src/client/model.ts

@@ -0,0 +1,79 @@
+import type { Edge, Node, Snapshot } from './types.ts'
+import type { FieldEdge, FieldNode } from './neural/engine.ts'
+import type { LayerIndex } from './neural/morphology.ts'
+import type { FailureKind } from './memory-adapter.ts'
+
+export const LAYER_META = [
+  { key: 'semantic', name: '语义记忆', en: 'SEMANTIC', hint: '稳定事实、状态与锚点' },
+  { key: 'episodic', name: '情节记忆', en: 'EPISODIC', hint: '原话与阶段摘要' },
+  { key: 'working', name: '工作记忆', en: 'WORKING', hint: '近期上下文与待澄清' },
+] as const
+
+export const KIND_LABEL: Record<string, string> = {
+  trace: '原话', anchor: '锚点', recent: '近期', state: '状态', summary: '摘要', clarification: '待澄清',
+}
+
+export const STATUS_LABEL: Record<string, string> = { known: '已确认', stale: '可能过期', disputed: '存在分歧', active: '活跃' }
+
+export function layerIndex(layer: string): LayerIndex {
+  return layer === 'semantic' ? 0 : layer === 'working' ? 2 : 1
+}
+
+/** Raw-text kinds point at an editable trace; the rest are derived and read-only. */
+export function isTraceBacked(node: Node): boolean {
+  return node.editable === true && typeof node.trace_id === 'string' && node.trace_id !== ''
+}
+
+function weightOf(node: Node): number {
+  if (node.kind === 'state') return 0.62
+  if (node.kind === 'summary') return 0.58
+  if (node.kind === 'clarification') return 0.42
+  const importance = Math.max(1, Math.min(5, Number(node.importance ?? 1)))
+  return Math.min(1, (importance - 1) / 4 * 0.7 + (node.anchor ? 0.3 : 0) + (node.kind === 'recent' ? 0.12 : 0))
+}
+
+export function toField(snapshot: Snapshot): { nodes: FieldNode[]; edges: FieldEdge[] } {
+  const nodes = snapshot.nodes.map((n): FieldNode => ({
+    id: n.id, layer: layerIndex(n.layer), derived: !isTraceBacked(n), weight: weightOf(n),
+    label: n.content || '（空）', kindLabel: KIND_LABEL[n.kind] ?? n.kind,
+  }))
+  const edges = snapshot.edges.map((e: Edge): FieldEdge => ({ source: e.source, target: e.target }))
+  return { nodes, edges }
+}
+
+export function layerCounts(snapshot: Snapshot | null): [number, number, number] {
+  const c: [number, number, number] = [0, 0, 0]
+  if (snapshot) for (const n of snapshot.nodes) c[layerIndex(n.layer)]++
+  return c
+}
+
+export function formatTime(value: string | undefined): string {
+  if (!value) return '—'
+  const d = new Date(value)
+  if (Number.isNaN(d.getTime())) return value
+  const p = (n: number) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
+}
+
+export function shortId(id: string): string {
+  return id.length > 14 ? `${id.slice(0, 6)}…${id.slice(-4)}` : id
+}
+
+export const FAILURE_TEXT: Record<FailureKind, { title: string; body: string }> = {
+  owner: { title: '仅所有者可管理记忆', body: '记忆库只对当前 DSH 的所有者开放。共享会话与访客无法查看或修改。' },
+  conflict: { title: '这条记忆已在别处更新', body: '版本不一致，保存或忘记已被拒绝。载入最新内容后再操作。' },
+  not_found: { title: '记录不存在', body: '它可能已被编辑替换或已被忘记。' },
+  scope: { title: '记忆范围不存在', body: '该范围可能已被移除，请重新选择。' },
+  invalid: { title: '内容长度无效', body: '记忆内容需为 1–2000 个字符。' },
+  unavailable: { title: '记忆内核暂不可用', body: '内核可能正在启动或重启。稍后重试。' },
+  unknown: { title: '操作未完成', body: '记忆库没有返回结果。稍后重试。' },
+}
+
+const SOURCE_LABEL: Record<string, string> = {
+  user_statement: '用户陈述', assistant_statement: '助手陈述', assistant_reply: '助手回复',
+  tool_result: '工具结果', system: '系统', import: '导入', manual: '手动录入', edit: '编辑',
+}
+export function sourceLabel(kind: string | null | undefined): string {
+  if (!kind) return '—'
+  return SOURCE_LABEL[kind] ?? kind
+}