@kenz1117/dsh-engram 0.3.0 → 0.4.0

package/README.md

@@ -43,9 +43,9 @@ dsh plugin --profile web add @kenz1117/dsh-engram
 | `engram_export` | 导出 Markdown / JSON 文件（数据可携带） |
 | `engram_distill` | 蒸馏：同主题簇合并为高层规律（LLM） |
 
-## Web 管理面板
+## Web 管理面板（设置页「记忆库」tab）
 
-宿主带 webServer 的 profile（web 等）自动挂载 `http://127.0.0.1:3080/engram` 管理页（仅本机回环可访问）：统计卡片、按状态/种类/内容过滤、编辑（走取代链）、遗忘/恢复、导出 Markdown/JSON 下载。数据接口在 `/api/engram/*`，写操作校验回环 Origin。headless 等无 webServer 的组合不挂载，其余能力不受影响。
+宿主带 webServer 的 profile（web 等）会在**设置页**自动出现「记忆库」tab（经 `settings.section` 槽位注册，client 半为 React 组件、随 `lib/client.js` 由宿主模块表装载）：统计卡片、按状态/种类/内容过滤、编辑（走取代链）、遗忘/恢复、导出 Markdown/JSON 下载。数据经回环 API `/api/engram/*`（写操作校验回环 Origin）。headless 等无 webServer 的组合不挂载，其余能力不受影响。
 
 ## 理解实现
 

package/lib/client.js

@@ -0,0 +1,3 @@
+window.__ModuleLoader__.load({id:`@kenz1117/dsh-engram`,factory:e=>{var t={exports:{}},n=t.exports;Object.defineProperty(n,Symbol.toStringTag,{value:`Module`});let r=e("react"),i=e("react/jsx-runtime"),a=`@kenz1117/dsh-engram/panel.module.css`;if(typeof document<`u`&&document.querySelector(`style[data-plugin-css=`+JSON.stringify(a)+`]`)===null){let e=document.createElement(`style`);e.dataset.plugin=`@kenz1117/dsh-engram`,e.dataset.pluginCss=a,e.textContent=`.bWwFiW_panel{max-width:980px}.bWwFiW_toolbar{flex-wrap:wrap;align-items:center;gap:10px;margin-bottom:14px;display:flex}.bWwFiW_scopeTabs{border:1px solid var(--line,#2a2f3a);border-radius:8px;margin-right:auto;display:flex;overflow:hidden}.bWwFiW_scopeOn,.bWwFiW_scopeOff{color:var(--muted,#8b93a3);cursor:pointer;background:0 0;border:none;padding:6px 14px;font-size:13px}.bWwFiW_scopeOn{background:var(--accent,#4f8cff);color:#fff}.bWwFiW_button{background:var(--panel,#1c1f26);color:var(--text,#e6e8ee);border:1px solid var(--line,#2a2f3a);cursor:pointer;border-radius:8px;padding:5px 12px;font-size:13px}.bWwFiW_button:hover{border-color:var(--accent,#4f8cff)}.bWwFiW_button:disabled{opacity:.45;cursor:default}.bWwFiW_primary{background:var(--accent,#4f8cff);border-color:var(--accent,#4f8cff);color:#fff}.bWwFiW_cards{grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:10px;margin-bottom:14px;display:grid}.bWwFiW_card{background:var(--panel,#1c1f26);border:1px solid var(--line,#2a2f3a);text-align:left;cursor:pointer;color:var(--text,#e6e8ee);font:inherit;border-radius:10px;padding:10px 14px}.bWwFiW_card b{font-size:20px;display:block}.bWwFiW_card span{color:var(--muted,#8b93a3);font-size:12px}.bWwFiW_filters{flex-wrap:wrap;gap:8px;margin-bottom:14px;display:flex}.bWwFiW_input{background:var(--panel,#1c1f26);color:var(--text,#e6e8ee);border:1px solid var(--line,#2a2f3a);border-radius:8px;padding:6px 10px;font-size:13px}.bWwFiW_filters .bWwFiW_input{flex:1;min-width:160px}.bWwFiW_item{background:var(--panel,#1c1f26);border:1px solid var(--line,#2a2f3a);border-radius:10px;margin-bottom:10px;padding:12px 14px}.bWwFiW_row1{flex-wrap:wrap;align-items:center;gap:8px;margin-bottom:6px;display:flex}.bWwFiW_badge{border:1px solid var(--line,#2a2f3a);color:var(--muted,#8b93a3);border-radius:99px;padding:1px 8px;font-size:11px}.bWwFiW_active{color:var(--ok,#3fb96f);border-color:var(--ok,#3fb96f)}.bWwFiW_archived{color:var(--warn,#d9a13b);border-color:var(--warn,#d9a13b)}.bWwFiW_forgotten{color:var(--bad,#e05d5d);border-color:var(--bad,#e05d5d)}.bWwFiW_content{white-space:pre-wrap;word-break:break-word}.bWwFiW_meta{color:var(--muted,#8b93a3);flex-wrap:wrap;gap:14px;margin-top:6px;font-size:12px;display:flex}.bWwFiW_ops{gap:8px;margin-top:8px;display:flex}.bWwFiW_pager{color:var(--muted,#8b93a3);justify-content:center;align-items:center;gap:10px;margin-top:14px;display:flex}.bWwFiW_empty{text-align:center;color:var(--muted,#8b93a3);padding:40px 0}.bWwFiW_backdrop{z-index:30;background:#0000008c;justify-content:center;align-items:center;display:flex;position:fixed;inset:0}.bWwFiW_dialog{background:var(--panel,#1c1f26);color:var(--text,#e6e8ee);border:1px solid var(--line,#2a2f3a);border-radius:12px;width:92vw;max-width:640px;max-height:80vh;padding:18px;overflow:auto}.bWwFiW_dialog h3{margin:0 0 10px;font-size:15px}.bWwFiW_fieldLabel{color:var(--muted,#8b93a3);margin:10px 0 4px;font-size:12px;display:block}.bWwFiW_modalFoot{justify-content:flex-end;gap:8px;margin-top:12px;display:flex}.bWwFiW_review{background:var(--bg,#14161a);border:1px solid var(--line,#2a2f3a);white-space:pre-wrap;border-radius:8px;max-height:320px;padding:10px;font-size:12px;overflow:auto}`,document.head.appendChild(e)}var o={row1:`bWwFiW_row1`,empty:`bWwFiW_empty`,panel:`bWwFiW_panel`,archived:`bWwFiW_archived`,active:`bWwFiW_active`,cards:`bWwFiW_cards`,forgotten:`bWwFiW_forgotten`,content:`bWwFiW_content`,ops:`bWwFiW_ops`,filters:`bWwFiW_filters`,meta:`bWwFiW_meta`,dialog:`bWwFiW_dialog`,card:`bWwFiW_card`,badge:`bWwFiW_badge`,input:`bWwFiW_input`,item:`bWwFiW_item`,scopeOff:`bWwFiW_scopeOff`,modalFoot:`bWwFiW_modalFoot`,review:`bWwFiW_review`,scopeOn:`bWwFiW_scopeOn`,primary:`bWwFiW_primary`,scopeTabs:`bWwFiW_scopeTabs`,fieldLabel:`bWwFiW_fieldLabel`,pager:`bWwFiW_pager`,toolbar:`bWwFiW_toolbar`,button:`bWwFiW_button`,backdrop:`bWwFiW_backdrop`};let s=[`fact`,`preference`,`decision`,`episode`,`skill`];async function c(e,t){let n=await fetch(`/api/engram/${e}`,t),r=await n.json();if(!n.ok)throw Error(r.error??`HTTP ${String(n.status)}`);return r}function l(e){return new Date(e).toLocaleString(`zh-CN`,{hour12:!1})}function u({recordId:e,scope:t}){let[n,a]=(0,r.useState)(null);return(0,r.useEffect)(()=>{let n=!1;return c(`review?scope=${t}&id=${encodeURIComponent(e)}`).then(e=>{if(n)return;let t=e.record,r=[`内容: ${t.content}`,`属性: kind=${t.kind}, status=${t.status}, importance=${t.importance}, confidence=${t.confidence}, 访问 ${t.accessCount} 次`,`来源: ${t.sourceSessionId??`显式保存`}${t.sourceRound===null?``:` 第${String(t.sourceRound)}轮`}`];for(let t of[`supersededBy`,`supersedes`,`contradicts`,`related`]){let n=e[t];n!==void 0&&n.length>0&&r.push(`${t}: ${n.join(`, `)}`)}let i=e.operations;i!==void 0&&i.length>0&&(r.push(`最近操作:`),i.forEach(e=>r.push(`  ${l(e.at)} ${e.op}${e.detail?` ${e.detail}`:``}`))),a(r.join(`
+`))}).catch(e=>{n||a(`加载失败：${e.message}`)}),()=>{n=!0}},[e,t]),n===null?null:(0,i.jsx)(`pre`,{className:o.review,children:n})}function d({record:e,onClose:t,onSaved:n}){let[a,l]=(0,r.useState)(e.content),[u,d]=(0,r.useState)(e.kind),[f,p]=(0,r.useState)(e.importance);return(0,i.jsx)(`div`,{className:o.backdrop,onClick:t,children:(0,i.jsxs)(`div`,{className:o.dialog,onClick:e=>e.stopPropagation(),children:[(0,i.jsx)(`h3`,{children:`编辑记忆（写入取代链）`}),(0,i.jsx)(`label`,{className:o.fieldLabel,children:`内容`}),(0,i.jsx)(`textarea`,{className:o.input,rows:3,value:a,onChange:e=>l(e.target.value)}),(0,i.jsx)(`label`,{className:o.fieldLabel,children:`种类`}),(0,i.jsx)(`select`,{className:o.input,value:u,onChange:e=>d(e.target.value),children:s.map(e=>(0,i.jsx)(`option`,{value:e,children:e},e))}),(0,i.jsxs)(`label`,{className:o.fieldLabel,children:[`重要性 `,f.toFixed(2)]}),(0,i.jsx)(`input`,{type:`range`,min:0,max:1,step:.05,value:f,onChange:e=>p(Number(e.target.value))}),(0,i.jsxs)(`div`,{className:o.modalFoot,children:[(0,i.jsx)(`button`,{type:`button`,className:o.button,onClick:t,children:`取消`}),(0,i.jsx)(`button`,{type:`button`,className:`${o.button} ${o.primary}`,onClick:()=>{c(`update`,{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify({id:e.id,scope:e.scope,content:a,kind:u,importance:f})}).then(n).catch(e=>{alert(e.message)})},children:`保存（旧条目归档）`})]})]})})}function f(){let[e,t]=(0,r.useState)(`user`),[n,a]=(0,r.useState)(`all`),[f,p]=(0,r.useState)(`all`),[m,h]=(0,r.useState)(``),[g,_]=(0,r.useState)(0),[v,y]=(0,r.useState)(null),[b,x]=(0,r.useState)(null),[S,C]=(0,r.useState)(null),[w,T]=(0,r.useState)(null),[E,D]=(0,r.useState)(null),[O,k]=(0,r.useState)(0),A=(0,r.useCallback)(()=>{k(e=>e+1)},[]);(0,r.useEffect)(()=>{let t=!1,r=new URLSearchParams({scope:e,status:n,kind:f,limit:`20`,offset:String(g)});return m!==``&&r.set(`q`,m),c(`list?${r.toString()}`).then(e=>{t||(y(e),C(null))}).catch(e=>{t||C(e.message)}),c(`stats`).then(e=>{t||x(e.parts)}).catch(()=>{}),()=>{t=!0}},[e,n,f,m,g,O]);let j=(e,t)=>{c(e,{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify({id:t.id,scope:t.scope})}).then(A).catch(e=>{alert(e.message)})},M=Math.floor(g/20)+1,N=v===null?1:Math.max(1,Math.ceil(v.total/20));return(0,i.jsxs)(`div`,{className:o.panel,children:[(0,i.jsxs)(`div`,{className:o.toolbar,children:[(0,i.jsx)(`div`,{className:o.scopeTabs,children:[`user`,`project`].map(n=>(0,i.jsx)(`button`,{type:`button`,className:e===n?o.scopeOn:o.scopeOff,onClick:()=>{t(n),_(0)},children:n===`user`?`用户级`:`项目级`},n))}),(0,i.jsx)(`button`,{type:`button`,className:o.button,onClick:A,children:`刷新`}),(0,i.jsx)(`button`,{type:`button`,className:o.button,onClick:()=>{location.href=`/api/engram/export?scope=${e}&format=markdown`},children:`导出 MD`}),(0,i.jsx)(`button`,{type:`button`,className:o.button,onClick:()=>{location.href=`/api/engram/export?scope=${e}&format=json`},children:`导出 JSON`})]}),(0,i.jsx)(`div`,{className:o.cards,children:(b??[]).map(n=>(0,i.jsxs)(`button`,{type:`button`,className:o.card,style:n.scope===e?{borderColor:`var(--accent)`}:void 0,onClick:()=>{t(n.scope),_(0)},children:[(0,i.jsx)(`b`,{children:n.stats.total}),(0,i.jsxs)(`span`,{children:[n.scope,` · active `,n.stats.active,` · 信噪比 `,Math.round(n.stats.signalRatio*100),`%`]})]},n.scope))}),(0,i.jsxs)(`div`,{className:o.filters,children:[(0,i.jsxs)(`select`,{className:o.input,value:n,onChange:e=>{a(e.target.value),_(0)},children:[(0,i.jsx)(`option`,{value:`all`,children:`全部状态`}),(0,i.jsx)(`option`,{value:`active`,children:`active`}),(0,i.jsx)(`option`,{value:`archived`,children:`archived`}),(0,i.jsx)(`option`,{value:`forgotten`,children:`forgotten`})]}),(0,i.jsxs)(`select`,{className:o.input,value:f,onChange:e=>{p(e.target.value),_(0)},children:[(0,i.jsx)(`option`,{value:`all`,children:`全部种类`}),s.map(e=>(0,i.jsx)(`option`,{value:e,children:e},e))]}),(0,i.jsx)(`input`,{className:o.input,placeholder:`按内容搜索…`,value:m,onChange:e=>{h(e.target.value.trim()),_(0)}})]}),S!==null&&(0,i.jsx)(`div`,{className:o.empty,children:`加载失败：${S}`}),S===null&&v!==null&&v.records.length===0&&(0,i.jsx)(`div`,{className:o.empty,children:`没有符合条件的记忆`}),(v?.records??[]).map(e=>(0,i.jsxs)(`div`,{className:o.item,children:[(0,i.jsxs)(`div`,{className:o.row1,children:[(0,i.jsx)(`span`,{className:`${o.badge} ${o[e.status]}`,children:e.status}),(0,i.jsx)(`span`,{className:o.badge,children:e.kind}),(0,i.jsx)(`span`,{className:o.badge,children:e.scope})]}),(0,i.jsx)(`div`,{className:o.content,children:e.content}),(0,i.jsxs)(`div`,{className:o.meta,children:[(0,i.jsxs)(`span`,{children:[`重要性 `,e.importance.toFixed(2)]}),(0,i.jsxs)(`span`,{children:[`置信 `,e.confidence.toFixed(2)]}),(0,i.jsxs)(`span`,{children:[`访问 `,e.accessCount,` 次`]}),(0,i.jsx)(`span`,{children:e.sourceSessionId===null?`显式保存`:`来源 ${e.sourceSessionId.slice(0,16)}…${e.sourceRound===null?``:` 第${String(e.sourceRound)}轮`}`}),(0,i.jsx)(`span`,{children:l(e.createdAt)})]}),(0,i.jsxs)(`div`,{className:o.ops,children:[(0,i.jsx)(`button`,{type:`button`,className:o.button,onClick:()=>{D(e)},children:`详情`}),(0,i.jsx)(`button`,{type:`button`,className:o.button,onClick:()=>{T(e)},children:`编辑`}),e.status===`active`?(0,i.jsx)(`button`,{type:`button`,className:o.button,onClick:()=>{j(`forget`,e)},children:`遗忘`}):(0,i.jsx)(`button`,{type:`button`,className:o.button,onClick:()=>{j(`restore`,e)},children:`恢复`})]})]},e.id)),(0,i.jsxs)(`div`,{className:o.pager,children:[(0,i.jsx)(`button`,{type:`button`,className:o.button,disabled:g===0,onClick:()=>{_(Math.max(0,g-20))},children:`上一页`}),(0,i.jsxs)(`span`,{children:[`第 `,M,` / `,N,` 页 · 共 `,v?.total??0,` 条`]}),(0,i.jsx)(`button`,{type:`button`,className:o.button,disabled:v===null||g+20>=v.total,onClick:()=>{_(g+20)},children:`下一页`})]}),w!==null&&(0,i.jsx)(d,{record:w,onClose:()=>{T(null)},onSaved:()=>{T(null),A()}}),E!==null&&(0,i.jsx)(`div`,{className:o.backdrop,onClick:()=>{D(null)},children:(0,i.jsxs)(`div`,{className:o.dialog,onClick:e=>e.stopPropagation(),children:[(0,i.jsx)(`h3`,{children:`记忆审计`}),(0,i.jsx)(u,{recordId:E.id,scope:E.scope}),(0,i.jsx)(`div`,{className:o.modalFoot,children:(0,i.jsx)(`button`,{type:`button`,className:o.button,onClick:()=>{D(null)},children:`关闭`})})]})})]})}let p=[`slots`];function m(e){e.slots.inject(`settings.section`,()=>e.slots.register({name:`settings.section`,id:`engram`,order:20,label:()=>`记忆库`},f))}return n.apply=m,n.inject=p,t.exports}});
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["useState","styles","useCallback"],"sources":["../src/client/EngramPanel.tsx","../src/client/index.ts"],"sourcesContent":["/**\n * 记忆库设置面板：统计卡片、过滤列表、编辑（取代链）、遗忘/恢复、导出。\n * 数据经回环 API（/api/engram/*）读写；内容节点一律 DOM API 构建（防 XSS）。\n * @module @kenz1117/dsh-engram/client/EngramPanel\n */\n\nimport { useCallback, useEffect, useState } from 'react'\nimport styles from './panel.module.css'\n\n/** 列表/详情用的记忆视图（宿主 /api/engram/list 的行结构）。 */\ninterface MemoryRow {\n  readonly id: string\n  readonly scope: 'user' | 'project'\n  readonly kind: string\n  readonly content: string\n  readonly importance: number\n  readonly confidence: number\n  readonly status: 'active' | 'archived' | 'forgotten'\n  readonly createdAt: number\n  readonly accessCount: number\n  readonly sourceSessionId: string | null\n  readonly sourceRound: number | null\n}\n\ninterface ListResult {\n  readonly records: MemoryRow[]\n  readonly total: number\n}\n\ninterface StatsPart {\n  readonly scope: 'user' | 'project'\n  readonly stats: {\n    readonly total: number\n    readonly active: number\n    readonly archived: number\n    readonly forgotten: number\n    readonly signalRatio: number\n  }\n}\n\nconst KINDS = ['fact', 'preference', 'decision', 'episode', 'skill'] as const\nconst PAGE_SIZE = 20\n\nasync function api<T>(path: string, init?: RequestInit): Promise<T> {\n  const response = await fetch(`/api/engram/${path}`, init)\n  const body = (await response.json()) as T & { error?: string }\n  if (!response.ok) throw new Error(body.error ?? `HTTP ${String(response.status)}`)\n  return body\n}\n\nfunction fmtTime(ms: number): string {\n  return new Date(ms).toLocaleString('zh-CN', { hour12: false })\n}\n\n/** 审计弹层视图。 */\nfunction ReviewBody({ recordId, scope }: { recordId: string; scope: 'user' | 'project' }): React.ReactElement | null {\n  const [text, setText] = useState<string | null>(null)\n  useEffect(() => {\n    let cancelled = false\n    api<Record<string, unknown>>(`review?scope=${scope}&id=${encodeURIComponent(recordId)}`)\n      .then((view) => {\n        if (cancelled) return\n        const record = view.record as MemoryRow\n        const lines = [\n          `内容: ${record.content}`,\n          `属性: kind=${record.kind}, status=${record.status}, importance=${record.importance}, confidence=${record.confidence}, 访问 ${record.accessCount} 次`,\n          `来源: ${record.sourceSessionId ?? '显式保存'}${record.sourceRound === null ? '' : ` 第${String(record.sourceRound)}轮`}`,\n        ]\n        for (const key of ['supersededBy', 'supersedes', 'contradicts', 'related'] as const) {\n          const ids = view[key] as string[] | undefined\n          if (ids !== undefined && ids.length > 0) lines.push(`${key}: ${ids.join(', ')}`)\n        }\n        const operations = view.operations as { at: number; op: string; detail: string | null }[] | undefined\n        if (operations !== undefined && operations.length > 0) {\n          lines.push('最近操作:')\n          operations.forEach(op => lines.push(`  ${fmtTime(op.at)} ${op.op}${op.detail ? ` ${op.detail}` : ''}`))\n        }\n        setText(lines.join('\\n'))\n      })\n      .catch((error: Error) => { if (!cancelled) setText(`加载失败：${error.message}`) })\n    return () => { cancelled = true }\n  }, [recordId, scope])\n  if (text === null) return null\n  return <pre className={styles.review}>{text}</pre>\n}\n\n/** 编辑弹层：内容/种类/重要性 → POST update（旧条目归档，取代链保留）。 */\nfunction EditDialog({ record, onClose, onSaved }: {\n  record: MemoryRow\n  onClose: () => void\n  onSaved: () => void\n}): React.ReactElement {\n  const [content, setContent] = useState(record.content)\n  const [kind, setKind] = useState(record.kind)\n  const [importance, setImportance] = useState(record.importance)\n  const save = (): void => {\n    api('update', {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ id: record.id, scope: record.scope, content, kind, importance }),\n    })\n      .then(onSaved)\n      .catch((error: Error) => { alert(error.message) })\n  }\n  return (\n    <div className={styles.backdrop} onClick={onClose}>\n      <div className={styles.dialog} onClick={event => event.stopPropagation()}>\n        <h3>编辑记忆（写入取代链）</h3>\n        <label className={styles.fieldLabel}>内容</label>\n        <textarea className={styles.input} rows={3} value={content} onChange={event => setContent(event.target.value)} />\n        <label className={styles.fieldLabel}>种类</label>\n        <select className={styles.input} value={kind} onChange={event => setKind(event.target.value)}>\n          {KINDS.map(option => <option key={option} value={option}>{option}</option>)}\n        </select>\n        <label className={styles.fieldLabel}>重要性 {importance.toFixed(2)}</label>\n        <input type=\"range\" min={0} max={1} step={0.05} value={importance}\n          onChange={event => setImportance(Number(event.target.value))} />\n        <div className={styles.modalFoot}>\n          <button type=\"button\" className={styles.button} onClick={onClose}>取消</button>\n          <button type=\"button\" className={`${styles.button} ${styles.primary}`} onClick={save}>保存（旧条目归档）</button>\n        </div>\n      </div>\n    </div>\n  )\n}\n\n/** 设置页「记忆库」section 主组件。 */\nexport function EngramSection(): React.ReactElement {\n  const [scope, setScope] = useState<'user' | 'project'>('user')\n  const [status, setStatus] = useState('all')\n  const [kind, setKind] = useState('all')\n  const [q, setQ] = useState('')\n  const [offset, setOffset] = useState(0)\n  const [list, setList] = useState<ListResult | null>(null)\n  const [stats, setStats] = useState<StatsPart[] | null>(null)\n  const [error, setError] = useState<string | null>(null)\n  const [editing, setEditing] = useState<MemoryRow | null>(null)\n  const [reviewId, setReviewId] = useState<MemoryRow | null>(null)\n  const [reloadTick, setReloadTick] = useState(0)\n\n  const reload = useCallback((): void => { setReloadTick(tick => tick + 1) }, [])\n\n  useEffect(() => {\n    let cancelled = false\n    const qs = new URLSearchParams({\n      scope, status, kind, limit: String(PAGE_SIZE), offset: String(offset),\n    })\n    if (q !== '') qs.set('q', q)\n    api<ListResult>(`list?${qs.toString()}`)\n      .then((data) => { if (!cancelled) { setList(data); setError(null) } })\n      .catch((loadError: Error) => { if (!cancelled) setError(loadError.message) })\n    api<{ parts: StatsPart[] }>('stats')\n      .then((data) => { if (!cancelled) setStats(data.parts) })\n      .catch(() => { /* 统计失败不影响列表 */ })\n    return () => { cancelled = true }\n  }, [scope, status, kind, q, offset, reloadTick])\n\n  const act = (route: string, record: MemoryRow): void => {\n    api(route, {\n      method: 'POST',\n      headers: { 'content-type': 'application/json' },\n      body: JSON.stringify({ id: record.id, scope: record.scope }),\n    })\n      .then(reload)\n      .catch((actError: Error) => { alert(actError.message) })\n  }\n\n  const page = Math.floor(offset / PAGE_SIZE) + 1\n  const pages = list === null ? 1 : Math.max(1, Math.ceil(list.total / PAGE_SIZE))\n\n  return (\n    <div className={styles.panel}>\n      <div className={styles.toolbar}>\n        <div className={styles.scopeTabs}>\n          {(['user', 'project'] as const).map(option => (\n            <button key={option} type=\"button\"\n              className={scope === option ? styles.scopeOn : styles.scopeOff}\n              onClick={() => { setScope(option); setOffset(0) }}>\n              {option === 'user' ? '用户级' : '项目级'}\n            </button>\n          ))}\n        </div>\n        <button type=\"button\" className={styles.button} onClick={reload}>刷新</button>\n        <button type=\"button\" className={styles.button}\n          onClick={() => { location.href = `/api/engram/export?scope=${scope}&format=markdown` }}>导出 MD</button>\n        <button type=\"button\" className={styles.button}\n          onClick={() => { location.href = `/api/engram/export?scope=${scope}&format=json` }}>导出 JSON</button>\n      </div>\n      <div className={styles.cards}>\n        {(stats ?? []).map(part => (\n          <button key={part.scope} type=\"button\" className={styles.card}\n            style={part.scope === scope ? { borderColor: 'var(--accent)' } : undefined}\n            onClick={() => { setScope(part.scope); setOffset(0) }}>\n            <b>{part.stats.total}</b>\n            <span>{part.scope} · active {part.stats.active} · 信噪比 {Math.round(part.stats.signalRatio * 100)}%</span>\n          </button>\n        ))}\n      </div>\n      <div className={styles.filters}>\n        <select className={styles.input} value={status}\n          onChange={event => { setStatus(event.target.value); setOffset(0) }}>\n          <option value=\"all\">全部状态</option>\n          <option value=\"active\">active</option>\n          <option value=\"archived\">archived</option>\n          <option value=\"forgotten\">forgotten</option>\n        </select>\n        <select className={styles.input} value={kind}\n          onChange={event => { setKind(event.target.value); setOffset(0) }}>\n          <option value=\"all\">全部种类</option>\n          {KINDS.map(option => <option key={option} value={option}>{option}</option>)}\n        </select>\n        <input className={styles.input} placeholder=\"按内容搜索…\" value={q}\n          onChange={event => { setQ(event.target.value.trim()); setOffset(0) }} />\n      </div>\n      {error !== null && <div className={styles.empty}>{`加载失败：${error}`}</div>}\n      {error === null && list !== null && list.records.length === 0 && (\n        <div className={styles.empty}>没有符合条件的记忆</div>\n      )}\n      {(list?.records ?? []).map(record => (\n        <div key={record.id} className={styles.item}>\n          <div className={styles.row1}>\n            <span className={`${styles.badge} ${styles[record.status]}`}>{record.status}</span>\n            <span className={styles.badge}>{record.kind}</span>\n            <span className={styles.badge}>{record.scope}</span>\n          </div>\n          <div className={styles.content}>{record.content}</div>\n          <div className={styles.meta}>\n            <span>重要性 {record.importance.toFixed(2)}</span>\n            <span>置信 {record.confidence.toFixed(2)}</span>\n            <span>访问 {record.accessCount} 次</span>\n            <span>{record.sourceSessionId === null\n              ? '显式保存'\n              : `来源 ${record.sourceSessionId.slice(0, 16)}…${record.sourceRound === null ? '' : ` 第${String(record.sourceRound)}轮`}`}</span>\n            <span>{fmtTime(record.createdAt)}</span>\n          </div>\n          <div className={styles.ops}>\n            <button type=\"button\" className={styles.button}\n              onClick={() => { setReviewId(record) }}>详情</button>\n            <button type=\"button\" className={styles.button}\n              onClick={() => { setEditing(record) }}>编辑</button>\n            {record.status === 'active'\n              ? <button type=\"button\" className={styles.button}\n                  onClick={() => { act('forget', record) }}>遗忘</button>\n              : <button type=\"button\" className={styles.button}\n                  onClick={() => { act('restore', record) }}>恢复</button>}\n          </div>\n        </div>\n      ))}\n      <div className={styles.pager}>\n        <button type=\"button\" className={styles.button} disabled={offset === 0}\n          onClick={() => { setOffset(Math.max(0, offset - PAGE_SIZE)) }}>上一页</button>\n        <span>第 {page} / {pages} 页 · 共 {list?.total ?? 0} 条</span>\n        <button type=\"button\" className={styles.button}\n          disabled={list === null || offset + PAGE_SIZE >= list.total}\n          onClick={() => { setOffset(offset + PAGE_SIZE) }}>下一页</button>\n      </div>\n      {editing !== null && (\n        <EditDialog record={editing} onClose={() => { setEditing(null) }} onSaved={() => { setEditing(null); reload() }} />\n      )}\n      {reviewId !== null && (\n        <div className={styles.backdrop} onClick={() => { setReviewId(null) }}>\n          <div className={styles.dialog} onClick={event => event.stopPropagation()}>\n            <h3>记忆审计</h3>\n            <ReviewBody recordId={reviewId.id} scope={reviewId.scope} />\n            <div className={styles.modalFoot}>\n              <button type=\"button\" className={styles.button}\n                onClick={() => { setReviewId(null) }}>关闭</button>\n            </div>\n          </div>\n        </div>\n      )}\n    </div>\n  )\n}\n","/**\n * dsh-engram client half: 注册设置页「记忆库」section。\n * 数据经回环 API（/api/engram/*）读取与操作，与 host 半的路由对齐。\n * @module @kenz1117/dsh-engram/client\n */\n\nimport type { Context } from '@deepseek-ai/cordis'\n// Type-only: ctx.slots（renderer 的 SlotMap 渲染接线）。\nimport type {} from '@deepseek-ai/dsh-client-ui-renderer/client'\n// Type-only: settings.section 槽位的 SlotMap merge（ui-settings 契约）。\nimport type {} from '@deepseek-ai/dsh-client-ui-settings/client'\nimport { EngramSection } from './EngramPanel.tsx'\n\n/** 必需服务：slots 渲染接线。 */\nexport const inject = ['slots']\n\n/**\n * Client plugin body: 设置页注册「记忆库」section（order 20，排在\n * general/models/plugins 之后）。\n * @param ctx - client root context.\n */\nexport function apply(ctx: Context): void {\n  ctx.slots.inject('settings.section', () => ctx.slots.register({\n    name: 'settings.section',\n    id: 'engram',\n    order: 20,\n    label: () => '记忆库',\n  }, EngramSection))\n}\n"],"mappings":"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"}

package/lib/{index.mjs → index.js}

@@ -374,308 +374,6 @@ async function ingestPreviousTurn(deps) {
 	};
 }
 //#endregion
-//#region src/page.ts
-/**
-* /engram 管理页：自包含单文件 HTML（内联 CSS/JS，简体中文 UI）。
-* 页面 JS 全部使用 DOM API 构建用户内容节点（不用 innerHTML 拼接，
-* 防记忆内容 XSS）。@module @kenz1117/dsh-engram/page
-*/
-const PAGE_HTML = `<!doctype html>
-<html lang="zh-CN">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>dsh-engram 记忆库</title>
-<style>
-  :root { color-scheme: dark; --bg: #14161a; --panel: #1c1f26; --line: #2a2f3a; --text: #e6e8ee; --muted: #8b93a3; --accent: #4f8cff; --ok: #3fb96f; --warn: #d9a13b; --bad: #e05d5d; }
-  * { box-sizing: border-box; }
-  body { margin: 0; background: var(--bg); color: var(--text); font: 14px/1.6 -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif; }
-  header { display: flex; align-items: center; gap: 12px; padding: 14px 20px; border-bottom: 1px solid var(--line); position: sticky; top: 0; background: var(--bg); z-index: 5; }
-  header h1 { font-size: 16px; margin: 0 auto 0 0; }
-  .tabs { display: flex; border: 1px solid var(--line); border-radius: 8px; overflow: hidden; }
-  .tabs button { background: none; border: none; color: var(--muted); padding: 6px 14px; cursor: pointer; font-size: 13px; }
-  .tabs button.on { background: var(--accent); color: #fff; }
-  button.act { background: var(--panel); color: var(--text); border: 1px solid var(--line); border-radius: 8px; padding: 6px 12px; cursor: pointer; font-size: 13px; }
-  button.act:hover { border-color: var(--accent); }
-  main { max-width: 980px; margin: 0 auto; padding: 18px 20px 60px; }
-  .cards { display: grid; grid-template-columns: repeat(5, 1fr); gap: 10px; margin-bottom: 16px; }
-  .card { background: var(--panel); border: 1px solid var(--line); border-radius: 10px; padding: 10px 14px; }
-  .card b { display: block; font-size: 20px; }
-  .card span { color: var(--muted); font-size: 12px; }
-  .filters { display: flex; gap: 8px; margin-bottom: 14px; flex-wrap: wrap; }
-  .filters select, .filters input { background: var(--panel); color: var(--text); border: 1px solid var(--line); border-radius: 8px; padding: 6px 10px; font-size: 13px; }
-  .filters input { flex: 1; min-width: 200px; }
-  .item { background: var(--panel); border: 1px solid var(--line); border-radius: 10px; padding: 12px 14px; margin-bottom: 10px; }
-  .item .row1 { display: flex; gap: 8px; align-items: center; margin-bottom: 6px; flex-wrap: wrap; }
-  .badge { font-size: 11px; padding: 1px 8px; border-radius: 99px; border: 1px solid var(--line); color: var(--muted); }
-  .badge.active { color: var(--ok); border-color: var(--ok); }
-  .badge.archived { color: var(--warn); border-color: var(--warn); }
-  .badge.forgotten { color: var(--bad); border-color: var(--bad); }
-  .content { white-space: pre-wrap; word-break: break-word; }
-  .meta { color: var(--muted); font-size: 12px; margin-top: 6px; display: flex; gap: 14px; flex-wrap: wrap; }
-  .ops { margin-top: 8px; display: flex; gap: 8px; }
-  .ops button { font-size: 12px; padding: 3px 10px; }
-  .bar { height: 4px; border-radius: 2px; background: var(--line); overflow: hidden; width: 90px; display: inline-block; vertical-align: middle; }
-  .bar i { display: block; height: 100%; background: var(--accent); }
-  .pager { display: flex; gap: 10px; align-items: center; justify-content: center; margin-top: 14px; color: var(--muted); }
-  dialog { background: var(--panel); color: var(--text); border: 1px solid var(--line); border-radius: 12px; max-width: 640px; width: 92vw; padding: 18px; }
-  dialog::backdrop { background: rgba(0,0,0,.55); }
-  dialog h3 { margin: 0 0 10px; font-size: 15px; }
-  dialog textarea, dialog input, dialog select { width: 100%; background: var(--bg); color: var(--text); border: 1px solid var(--line); border-radius: 8px; padding: 8px; font: inherit; }
-  dialog .f { margin-bottom: 10px; }
-  dialog label { display: block; color: var(--muted); font-size: 12px; margin-bottom: 4px; }
-  dialog pre { background: var(--bg); border: 1px solid var(--line); border-radius: 8px; padding: 10px; overflow: auto; font-size: 12px; max-height: 320px; white-space: pre-wrap; }
-  .modal-foot { display: flex; gap: 8px; justify-content: flex-end; margin-top: 12px; }
-  .primary { background: var(--accent); border-color: var(--accent); color: #fff; }
-  .empty { text-align: center; color: var(--muted); padding: 40px 0; }
-</style>
-</head>
-<body>
-<header>
-  <h1>dsh-engram 记忆库</h1>
-  <div class="tabs" id="scopeTabs">
-    <button data-scope="user" class="on">用户级</button>
-    <button data-scope="project">项目级</button>
-  </div>
-  <button class="act" id="refresh">刷新</button>
-  <button class="act" id="expMd">导出 MD</button>
-  <button class="act" id="expJson">导出 JSON</button>
-</header>
-<main>
-  <div class="cards" id="cards"></div>
-  <div class="filters">
-    <select id="fStatus">
-      <option value="all">全部状态</option>
-      <option value="active">active</option>
-      <option value="archived">archived</option>
-      <option value="forgotten">forgotten</option>
-    </select>
-    <select id="fKind">
-      <option value="all">全部种类</option>
-      <option value="fact">fact</option>
-      <option value="preference">preference</option>
-      <option value="decision">decision</option>
-      <option value="episode">episode</option>
-      <option value="skill">skill</option>
-    </select>
-    <input id="fQ" placeholder="按内容搜索…">
-  </div>
-  <div id="list"></div>
-  <div class="pager">
-    <button class="act" id="prev">上一页</button>
-    <span id="pageInfo"></span>
-    <button class="act" id="next">下一页</button>
-  </div>
-</main>
-<dialog id="editDlg">
-  <h3>编辑记忆（写入取代链）</h3>
-  <div class="f"><label>内容</label><textarea id="eContent" rows="3"></textarea></div>
-  <div class="f"><label>种类</label>
-    <select id="eKind">
-      <option value="fact">fact</option><option value="preference">preference</option>
-      <option value="decision">decision</option><option value="episode">episode</option>
-      <option value="skill">skill</option>
-    </select>
-  </div>
-  <div class="f"><label>重要性：<span id="eImpV">0.5</span></label>
-    <input type="range" id="eImp" min="0" max="1" step="0.05" value="0.5">
-  </div>
-  <div class="modal-foot">
-    <button class="act" id="eCancel">取消</button>
-    <button class="act primary" id="eSave">保存（旧条目归档）</button>
-  </div>
-</dialog>
-<dialog id="reviewDlg">
-  <h3>记忆审计</h3>
-  <pre id="rBody"></pre>
-  <div class="modal-foot"><button class="act" id="rClose">关闭</button></div>
-</dialog>
-<script>
-(function () {
-  'use strict';
-  var state = { scope: 'user', status: 'all', kind: 'all', q: '', limit: 20, offset: 0, total: 0 };
-  var $ = function (id) { return document.getElementById(id); };
-
-  function el(tag, cls, text) {
-    var node = document.createElement(tag);
-    if (cls) node.className = cls;
-    if (text !== undefined) node.textContent = text;
-    return node;
-  }
-  function api(path, opts) {
-    return fetch('/api/engram/' + path, opts).then(function (res) {
-      return res.json().then(function (body) {
-        if (!res.ok) throw new Error(body && body.error ? body.error : ('HTTP ' + res.status));
-        return body;
-      });
-    });
-  }
-  function fmtTime(ms) { return new Date(ms).toLocaleString('zh-CN', { hour12: false }); }
-  function bar(v) {
-    var wrap = el('span', 'bar');
-    var fill = el('i');
-    fill.style.width = Math.round(v * 100) + '%';
-    wrap.appendChild(fill);
-    return wrap;
-  }
-  function loadStats() {
-    return api('stats').then(function (data) {
-      var cards = $('cards');
-      cards.textContent = '';
-      data.parts.forEach(function (part) {
-        var s = part.stats;
-        var on = part.scope === state.scope;
-        var card = el('div', 'card');
-        if (on) card.style.borderColor = 'var(--accent)';
-        card.style.cursor = 'pointer';
-        card.appendChild(el('b', undefined, String(s.total)));
-        card.appendChild(el('span', undefined, part.scope + ' · active ' + s.active + ' · 信噪比 ' + Math.round(s.signalRatio * 100) + '%'));
-        card.addEventListener('click', function () { setScope(part.scope); });
-        cards.appendChild(card);
-      });
-    }).catch(function (e) { console.warn(e); });
-  }
-  function loadList() {
-    var qs = 'scope=' + state.scope + '&status=' + state.status + '&kind=' + state.kind
-      + '&limit=' + state.limit + '&offset=' + state.offset
-      + (state.q ? '&q=' + encodeURIComponent(state.q) : '');
-    return api('list?' + qs).then(function (data) {
-      state.total = data.total;
-      var list = $('list');
-      list.textContent = '';
-      if (data.records.length === 0) { list.appendChild(el('div', 'empty', '没有符合条件的记忆')); }
-      data.records.forEach(function (record) {
-        var item = el('div', 'item');
-        var row1 = el('div', 'row1');
-        row1.appendChild(el('span', 'badge ' + record.status, record.status));
-        row1.appendChild(el('span', 'badge', record.kind));
-        row1.appendChild(el('span', 'badge', record.scope));
-        item.appendChild(row1);
-        item.appendChild(el('div', 'content', record.content));
-        var meta = el('div', 'meta');
-        meta.appendChild(el('span', undefined, '重要性 ' + record.importance.toFixed(2) + ' '));
-        meta.appendChild(bar(record.importance));
-        meta.appendChild(el('span', undefined, '置信 ' + record.confidence.toFixed(2) + ' '));
-        meta.appendChild(bar(record.confidence));
-        meta.appendChild(el('span', undefined, '访问 ' + record.accessCount + ' 次'));
-        var source = record.sourceSessionId
-          ? '来源 ' + record.sourceSessionId.slice(0, 16) + '…' + (record.sourceRound === null ? '' : ' 第' + record.sourceRound + '轮')
-          : '显式保存';
-        meta.appendChild(el('span', undefined, source));
-        meta.appendChild(el('span', undefined, fmtTime(record.createdAt)));
-        item.appendChild(meta);
-        var ops = el('div', 'ops');
-        var reviewBtn = el('button', 'act', '详情');
-        reviewBtn.addEventListener('click', function () { openReview(record); });
-        var editBtn = el('button', 'act', '编辑');
-        editBtn.addEventListener('click', function () { openEdit(record); });
-        ops.appendChild(reviewBtn);
-        ops.appendChild(editBtn);
-        if (record.status === 'active') {
-          var forgetBtn = el('button', 'act', '遗忘');
-          forgetBtn.addEventListener('click', function () { post('forget', record, '已遗忘（可恢复）'); });
-          ops.appendChild(forgetBtn);
-        } else {
-          var restoreBtn = el('button', 'act', '恢复');
-          restoreBtn.addEventListener('click', function () { post('restore', record, '已恢复为 active'); });
-          ops.appendChild(restoreBtn);
-        }
-        item.appendChild(ops);
-        list.appendChild(item);
-      });
-      var page = Math.floor(state.offset / state.limit) + 1;
-      var pages = Math.max(1, Math.ceil(state.total / state.limit));
-      $('pageInfo').textContent = '第 ' + page + ' / ' + pages + ' 页 · 共 ' + state.total + ' 条';
-      $('prev').disabled = state.offset === 0;
-      $('next').disabled = state.offset + state.limit >= state.total;
-    }).catch(function (e) {
-      $('list').textContent = '';
-      $('list').appendChild(el('div', 'empty', '加载失败：' + e.message));
-    });
-  }
-  function reload() { loadStats(); loadList(); }
-  function setScope(scope) {
-    state.scope = scope; state.offset = 0;
-    document.querySelectorAll('#scopeTabs button').forEach(function (b) {
-      b.classList.toggle('on', b.dataset.scope === scope);
-    });
-    reload();
-  }
-  function post(route, record, okText) {
-    api(route, {
-      method: 'POST',
-      headers: { 'content-type': 'application/json' },
-      body: JSON.stringify({ id: record.id, scope: record.scope }),
-    }).then(function () { reload(); }).catch(function (e) { alert(e.message); });
-  }
-  function openReview(record) {
-    api('review?scope=' + record.scope + '&id=' + encodeURIComponent(record.id)).then(function (view) {
-      var r = view.record;
-      var lines = [
-        '内容: ' + r.content,
-        '属性: kind=' + r.kind + ', status=' + r.status + ', importance=' + r.importance + ', confidence=' + r.confidence + ', 访问 ' + r.accessCount + ' 次',
-        '来源: ' + (r.sourceSessionId ? r.sourceSessionId + (r.sourceRound === null ? '' : ' 第' + r.sourceRound + '轮') + (r.sourceSeq === null ? '' : ' seq ' + r.sourceSeq) : '显式保存'),
-      ];
-      if (view.supersededBy.length) lines.push('被谁取代: ' + view.supersededBy.join(', '));
-      if (view.supersedes.length) lines.push('取代了谁: ' + view.supersedes.join(', '));
-      if (view.contradicts.length) lines.push('矛盾候选: ' + view.contradicts.join(', '));
-      if (view.related.length) lines.push('关联: ' + view.related.join(', '));
-      if (view.operations.length) {
-        lines.push('最近操作:');
-        view.operations.forEach(function (op) {
-          lines.push('  ' + fmtTime(op.at) + ' ' + op.op + (op.detail ? ' ' + op.detail : ''));
-        });
-      }
-      $('rBody').textContent = lines.join('\\n');
-      $('reviewDlg').showModal();
-    }).catch(function (e) { alert(e.message); });
-  }
-  function openEdit(record) {
-    $('eContent').value = record.content;
-    $('eKind').value = record.kind;
-    $('eImp').value = record.importance;
-    $('eImpV').textContent = record.importance.toFixed(2);
-    $('eSave').onclick = function () {
-      api('update', {
-        method: 'POST',
-        headers: { 'content-type': 'application/json' },
-        body: JSON.stringify({
-          id: record.id, scope: record.scope,
-          content: $('eContent').value, kind: $('eKind').value,
-          importance: Number($('eImp').value),
-        }),
-      }).then(function () { $('editDlg').close(); reload(); })
-        .catch(function (e) { alert(e.message); });
-    };
-    $('editDlg').showModal();
-  }
-
-  document.querySelectorAll('#scopeTabs button').forEach(function (b) {
-    b.addEventListener('click', function () { setScope(b.dataset.scope); });
-  });
-  $('refresh').addEventListener('click', reload);
-  $('expMd').addEventListener('click', function () { location.href = '/api/engram/export?scope=' + state.scope + '&format=markdown'; });
-  $('expJson').addEventListener('click', function () { location.href = '/api/engram/export?scope=' + state.scope + '&format=json'; });
-  $('fStatus').addEventListener('change', function (e) { state.status = e.target.value; state.offset = 0; loadList(); });
-  $('fKind').addEventListener('change', function (e) { state.kind = e.target.value; state.offset = 0; loadList(); });
-  var qTimer = null;
-  $('fQ').addEventListener('input', function (e) {
-    clearTimeout(qTimer);
-    qTimer = setTimeout(function () { state.q = e.target.value.trim(); state.offset = 0; loadList(); }, 300);
-  });
-  $('prev').addEventListener('click', function () { state.offset = Math.max(0, state.offset - state.limit); loadList(); });
-  $('next').addEventListener('click', function () { state.offset += state.limit; loadList(); });
-  $('eImp').addEventListener('input', function (e) { $('eImpV').textContent = Number(e.target.value).toFixed(2); });
-  $('eCancel').addEventListener('click', function () { $('editDlg').close(); });
-  $('rClose').addEventListener('click', function () { $('reviewDlg').close(); });
-
-  reload();
-})();
-<\/script>
-</body>
-</html>
-`;
-//#endregion
 //#region src/routes.ts
 /** 回环 peer：IPv4 127/8、IPv6 ::1、IPv4-mapped IPv6。 */
 function isLoopbackPeer(req) {
@@ -753,15 +451,6 @@ function scopeOf$1(raw, fallback) {
 * @param ctx - 携带 webServer 服务的宿主上下文。
 */
 function registerEngramRoutes(ctx, deps) {
-	ctx.effect(() => ctx.webServer.register({
-		kind: "exact",
-		path: "/engram",
-		handler: async (req, res) => {
-			if (!guardLoopback(req, res)) return;
-			res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
-			res.end(PAGE_HTML);
-		}
-	}), "dsh-engram: page route");
 	ctx.effect(() => ctx.webServer.register({
 		kind: "prefix",
 		path: "/api/engram",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kenz1117/dsh-engram",
   "description": "Cross-session long-term memory for DeepSeek Harness: dual-scope SQLite memory graph, hybrid retrieval, provenance audit, and a knowledge flywheel.",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "publishConfig": {
     "access": "public"
   },
@@ -10,12 +10,13 @@
     "url": "git+https://github.com/kenz1117/dsh-engram.git"
   },
   "type": "module",
-  "main": "./lib/index.mjs",
-  "types": "./lib/index.d.mts",
+  "main": "./lib/index.js",
   "exports": {
     ".": {
-      "types": "./lib/index.d.mts",
-      "default": "./lib/index.mjs"
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
     },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
@@ -28,6 +29,10 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [],
+      "platform": "web"
     }
   },
   "scripts": {
@@ -54,6 +59,9 @@
   },
   "devDependencies": {
     "@types/node": "^26.4.0",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.1",
+    "lightningcss": "^1.32.0",
     "tsdown": "^0.22.14",
     "typescript": "^5.9.3",
     "vitest": "^4.1.11"

package/scripts/clientBundle.ts

@@ -0,0 +1,302 @@
+/**
+ * Vendored tsdown client-bundle factory for OUT-OF-TREE (fork) UI plugins.
+ *
+ * The DSH monorepo publishes this shared preset at packages/client/tsdown.client.ts
+ * and expects in-tree packages to import it via a relative path. A standalone fork
+ * (or a fork cloned into packages/community/<name>) cannot resolve that shared file,
+ * so per the cookbook contract ("That preset is not published today, so a package
+ * outside this repository has to reproduce the same output format itself") this
+ * repository carries its own copy. Keep it in sync with the monorepo factory when
+ * the platform seed changes.
+ *
+ * Emits a closure-factory artifact: the bundle calls window.__ModuleLoader__.load({id, factory})
+ * and resolves externals through the injected require (loader module table —
+ * cordis DI entities, no globals, no import map). CSS Modules are compiled by
+ * lightningcss inside the bundle: importing `x.module.css` yields the
+ * hashed class map, and the css text auto-injects a <style data-plugin="<id>">
+ * tag at factory execution (the loader removes plugin-owned tags on unload).
+ * The virtual loader registers each real stylesheet as a watch dependency.
+ */
+import { readFile } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { basename, dirname, relative, resolve as resolvePath, sep } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import type { UserConfig } from 'tsdown'
+import { transform } from 'lightningcss'
+
+/**
+ * The host's eight-entry platform seed, copied verbatim from packages/client/web/src/platform.ts.
+ * These are the specifiers the loader module table answers at runtime, so the browser
+ * bundle keeps them external (require) instead of inlining. If the monorepo seed grows,
+ * mirror it here.
+ */
+const PLATFORM_MODULES = [
+  'react', 'react/jsx-runtime', 'react-dom', 'react-dom/client', '@deepseek-ai/cordis',
+  '@deepseek-ai/dsh-client-store',
+  '@deepseek-ai/dsh-client-ui-slots',
+  '@deepseek-ai/dsh-client-ui-primitives',
+] as const
+
+/**
+ * Virtual-id wrapper keeping module CSS away from tsdown's own css pipeline
+ * (which requires @tsdown/css). The suffix matters: tsdown's guard matches ids
+ * ending in `.css`, so the virtual id must not.
+ */
+const CSS_VIRTUAL_PREFIX = '\0dsh-css:'
+const CSS_VIRTUAL_SUFFIX = '.mjs'
+
+/**
+ * Wire/type layers a client bundle may inline: browser-safe contracts
+ * with no runtime identity to share (no Symbol/instanceof/singleton state).
+ * Everything else under @deepseek-ai/* is either a module-table entry
+ * (external) or a leak the purity gate rejects.
+ */
+export const INLINE_SAFE = /^@deepseek-ai\/dsh-(host-apiproxy|session|llm|tools|brand)(\/|$)/
+
+/**
+ * Vendored framework libraries: rescoped into @deepseek-ai, so the gate below
+ * would read them as plugin packages. They carry no cross-plugin runtime
+ * identity to share — the framework itself is a platform module (external),
+ * while these are ordinary libraries a browser bundle inlines.
+ */
+const VENDORED_LIBRARY = /^@deepseek-ai\/(cosmokit|schemastery)(\/|$)/
+
+/** Generated descriptor/codec contribution with no shared runtime identity. */
+const GENERATED_REMOTE = /^@deepseek-ai\/dsh-[a-z0-9]+(?:-[a-z0-9]+)*\/remote$/
+
+/**
+ * Workspace mode replaces an empty config array with the root defaults. A
+ * falsey entry instead removes this package before entry resolution.
+ */
+const SKIP_WORKSPACE_BUILD: UserConfig = { entry: '' }
+
+/** Externals resolved from the loader module table: the platform seed entries. */
+export const CLIENT_EXTERNALS: readonly string[] = [...PLATFORM_MODULES]
+
+// Repository root for sourcemap rebasing: this file lives at <repo>/scripts, so
+// one level up is the fork root (the monorepo original walks up two levels
+// because it sits at packages/client/).
+const REPOSITORY_ROOT = fileURLToPath(new URL('..', import.meta.url))
+
+/** Rebase a physical lib-relative source onto a browser URL that mirrors the repository directories. */
+function browserSourcePath(source: string, sourcemapPath: string): string {
+  if (!source.startsWith('.')) return source
+  const physicalSource = resolvePath(dirname(sourcemapPath), source)
+  const repositoryPath = relative(REPOSITORY_ROOT, physicalSource).split(sep).join('/')
+  return repositoryPath.startsWith('packages/') ? `../../../${repositoryPath}` : source
+}
+
+/**
+ * Build the tsdown config for one UI plugin package: the node-half lib build
+ * plus the browser client bundle. Client packages emit both halves during the
+ * Client pass by default; packages needed for Host reflection may opt into the
+ * earlier Host pass. A package-level tsdown.config.ts REPLACES the root
+ * workspace layout, so the lib half must be restated here — dropping it leaves
+ * the package without lib/index.js and the host Loader cannot import its node
+ * half.
+ * @param id - plugin id (package name), stamped into the __ModuleLoader__.load
+ * handoff and onto the injected style tags.
+ * @param libEntry - node-half entries, spelled at the call site so the
+ * package-invariants gate can see `lib/types/invariant.js` in each package's
+ * own tsdown.config.ts (a preset-side glob hides it from the mechanical check).
+ * @param options - phase placement, lib overrides, and companion Node configs.
+ * @returns ENV-selected tsdown config for the current build face.
+ */
+export function clientBundle(
+  id: string,
+  libEntry: readonly string[],
+  options: ClientBundleOptions = {},
+): BuildFaceConfig {
+  const lib = clientLibraryConfig(id, libEntry, options.lib)
+  return ({ env }) => {
+    const face = buildFace(env?.DSH_BUILD_FACE)
+    const client = clientConfig(id, face === undefined
+      ? 'src/client/index.ts'
+      : 'lib/types/client/index.js')
+    const node = [lib, ...(options.companions ?? [])]
+    if (face === 'host') return options.hostPhase === true ? node : [SKIP_WORKSPACE_BUILD]
+    if (face === 'client') return options.hostPhase === true ? [client] : [...node, client]
+    return [...node, client]
+  }
+}
+
+/**
+ * Build a Client-only Node library during the Client pass.
+ * @param id - Package name used in tsdown diagnostics.
+ * @param libEntry - Emitted JavaScript entries consumed from `lib/types`.
+ * @returns ENV-selected tsdown config for the Client build face.
+ */
+export function clientLibrary(id: string, libEntry: readonly string[]): BuildFaceConfig {
+  const lib = clientLibraryConfig(id, libEntry)
+  return clientOnly([lib])
+}
+
+/**
+ * Select arbitrary package-local configs only during the Client pass.
+ * @param configs - Node-side configs emitted after Client tsc.
+ * @returns ENV-selected tsdown config for the Client build face.
+ */
+export function clientOnly(configs: readonly UserConfig[]): BuildFaceConfig {
+  return ({ env }) => buildFace(env?.DSH_BUILD_FACE) === 'host'
+    ? [SKIP_WORKSPACE_BUILD]
+    : [...configs]
+}
+
+interface ClientBundleOptions {
+  /** Emit the Node-side artifacts during the Host pass instead of the Client pass. */
+  readonly hostPhase?: boolean
+  /** Additional Node-side configs emitted alongside the package library. */
+  readonly companions?: readonly UserConfig[]
+  /** Overrides for the package's primary Node-side library config. */
+  readonly lib?: UserConfig
+}
+
+type BuildFace = 'host' | 'client' | undefined
+
+type BuildFaceConfig = (inlineConfig: Pick<UserConfig, 'env'>) => UserConfig[]
+
+function buildFace(value: unknown): BuildFace {
+  if (value === undefined || value === 'host' || value === 'client') return value
+  throw new Error(`tsdown: --env.DSH_BUILD_FACE must be host or client, received ${String(value)}`)
+}
+
+function clientLibraryConfig(
+  id: string,
+  libEntry: readonly string[],
+  overrides: UserConfig = {},
+): UserConfig {
+  return {
+    name: id,
+    entry: [...libEntry],
+    outDir: 'lib',
+    format: ['esm'],
+    platform: 'node',
+    target: 'es2024',
+    fixedExtension: false,
+    dts: false,
+    clean: false,
+    ...overrides,
+  }
+}
+
+function clientConfig(id: string, entry: string): UserConfig {
+  return {
+    name: `${id}/client`,
+    entry: { client: entry },
+    // Browser bundle lands next to the node half (single lib/ artifact dir;
+    // the entryFileNames pin keeps it exactly lib/client.js). clean must stay
+    // off — a default clean would wipe the node-half output emitted above.
+    outDir: 'lib',
+    format: 'cjs',
+    platform: 'browser',
+    // Types ship from lib/types (tsc); dts here would wrap the banner/footer into .d.cts and break parsing.
+    dts: false,
+    // Plugin code is fetched outside Vite's module graph, so its own bundle
+    // must carry the TS/TSX mapping consumed by browser profiling tools.
+    sourcemap: true,
+    // DSH Store 的固定 Commit 审查对运行时文件有 256 KiB 单文件硬上限；
+    // 未压缩 bundle 含内联 CSS/双语字典远超此值，浏览器分发面统一压缩。
+    // (DSH Store fixed-commit review caps a single runtime file at 256 KiB;
+    // the uncompressed bundle inlines CSS and bilingual dictionaries, so ship
+    // the browser artifact minified.)
+    minify: true,
+    clean: false,
+    external: [...CLIENT_EXTERNALS],
+    // Browser bundles inline node-idiom deps (zustand/immer read
+    // process.env.NODE_ENV; zustand's esm build also probes
+    // import.meta.env.MODE, which a CJS output cannot carry — rolldown flags
+    // EMPTY_IMPORT_META). vite defined both on the seed path; tsdown inlining
+    // needs the substitutions here or the factory throws ReferenceError at
+    // boot / the build gate reds. Both keys honor the build's NODE_ENV so a
+    // dev build keeps the dev-branch semantics; artifacts default to production.
+    // The bare `import.meta.env` key is required alongside the precise MODE
+    // key: zustand probes `import.meta.env ? import.meta.env.MODE : ...`, and
+    // the truthiness probe would otherwise survive as an empty import.meta.
+    define: {
+      'process.env.NODE_ENV': JSON.stringify(process.env.NODE_ENV ?? 'production'),
+      'import.meta.env.MODE': JSON.stringify(process.env.NODE_ENV ?? 'production'),
+      'import.meta.env': JSON.stringify({ MODE: process.env.NODE_ENV ?? 'production' }),
+    },
+    // tsdown auto-externalizes package dependencies; anything NOT in the
+    // loader module table must inline instead (wire/type layers, zod, clsx —
+    // every non-shared dep). A require() the table cannot answer is a
+    // guaranteed runtime throw, so the rule is the table list itself: no
+    // opinion for table entries (external above wins), bundle everything else.
+    noExternal: (id: string) => (CLIENT_EXTERNALS.includes(id) ? undefined : true),
+    plugins: [{
+      // Bundle purity gate (build-time mirror of the module-edge rules):
+      // platform seed entries stay external, inline-safe wire layers inline,
+      // and every other @deepseek-ai value import is a build error — a
+      // cross-plugin value import either inlines a duplicate runtime instance
+      // or requires a specifier the frozen module table cannot answer.
+      // Cross-plugin collaboration goes through cordis services instead.
+      name: 'dsh-client-bundle-purity',
+      resolveId(source: string) {
+        if (!source.startsWith('@deepseek-ai/')) return null
+        if (CLIENT_EXTERNALS.includes(source)) return null // platform module: external wins
+        if (VENDORED_LIBRARY.test(source)) return null // vendored library: inline, no shared identity
+        if (INLINE_SAFE.test(source) || GENERATED_REMOTE.test(source)) return null // wire contribution: inline is the point
+        throw new Error(
+          `client bundle purity: "${source}" is not a platform module (CLIENT_EXTERNALS), an inline-safe wire layer, or a generated /remote contribution — `
+          + 'cross-plugin value imports are forbidden; collaborate through cordis services (type-only imports are erased and never reach this gate)',
+        )
+      },
+    }, {
+      name: 'dsh-css-modules-inline',
+      resolveId(source: string, importer: string | undefined) {
+        if (!source.endsWith('.module.css')) return null
+        const abs = importer !== undefined ? sourceAssetPath(source, importer) : source
+        return CSS_VIRTUAL_PREFIX + abs + CSS_VIRTUAL_SUFFIX
+      },
+      async load(virtualId: string) {
+        if (!virtualId.startsWith(CSS_VIRTUAL_PREFIX)) return null
+        const fileId = virtualId.slice(CSS_VIRTUAL_PREFIX.length, -CSS_VIRTUAL_SUFFIX.length)
+        // The virtual id otherwise hides the physical stylesheet from Rolldown's watch graph.
+        this.addWatchFile(fileId)
+        const source = await readFile(fileId)
+        const { code, exports: cssExports } = transform({
+          filename: fileId,
+          code: source,
+          cssModules: { pattern: '[hash]_[local]' },
+          minify: true,
+        })
+        const classMap: Record<string, string> = {}
+        for (const [local, exp] of Object.entries(cssExports ?? {})) classMap[local] = exp.name
+        // One <style data-plugin> per module file; idempotent under re-evaluation.
+        return [
+          `const css = ${JSON.stringify(code.toString())};`,
+          `const tagId = ${JSON.stringify(`${id}/${basename(fileId)}`)};`,
+          'if (typeof document !== \'undefined\' && document.querySelector(\'style[data-plugin-css=\' + JSON.stringify(tagId) + \']\') === null) {',
+          '  const tag = document.createElement(\'style\');',
+          `  tag.dataset.plugin = ${JSON.stringify(id)};`,
+          '  tag.dataset.pluginCss = tagId;',
+          '  tag.textContent = css;',
+          '  document.head.appendChild(tag);',
+          '}',
+          `export default ${JSON.stringify(classMap)};`,
+        ].join('\n')
+      },
+    }],
+    outputOptions: {
+      entryFileNames: 'client.js',
+      // The map is served from /plugins/<scoped-package>/client.js.map. The
+      // browser resolves its local sources back into URLs that mirror the
+      // /packages/<group>/<package>/src directories; sourcesContent keeps them usable
+      // without exposing that tree as an HTTP route.
+      sourcemapPathTransform: browserSourcePath,
+      banner: `window.__ModuleLoader__.load({ id: ${JSON.stringify(id)}, factory: (require) => {`,
+      footer: 'return module.exports; } });',
+      intro: 'var module = { exports: {} }; var exports = module.exports;',
+    },
+  }
+}
+
+/** Resolve an emitted JS asset import against its source-tree counterpart. */
+function sourceAssetPath(source: string, importer: string): string {
+  const emitted = resolvePath(dirname(importer), source)
+  if (existsSync(emitted)) return emitted
+  const marker = `${sep}lib${sep}types${sep}`
+  const boundary = emitted.indexOf(marker)
+  if (boundary < 0) return emitted
+  return resolvePath(emitted.slice(0, boundary), 'src', emitted.slice(boundary + marker.length))
+}

package/scripts/link-peers.mjs

@@ -29,6 +29,8 @@ const LINKED_PACKAGES = [
   ['@deepseek-ai/dsh-system-prompt', 'packages/core/system-prompt'],
   ['@deepseek-ai/dsh-session', 'packages/core/session'],
   ['@deepseek-ai/dsh-host-webserver', 'packages/host/webserver'],
+  ['@deepseek-ai/dsh-client-ui-settings', 'packages/client/ui-settings'],
+  ['@deepseek-ai/dsh-client-ui-renderer', 'packages/client/ui-renderer'],
   ['@deepseek-ai/dsh-llm', 'packages/llm/llm'],
   ['@deepseek-ai/dsh-agent', 'packages/core/agent'],
   ['@deepseek-ai/dsh-scope', 'packages/core/scope'],

package/lib/index.d.mts

@@ -1,49 +0,0 @@
-import z from "@deepseek-ai/schemastery";
-import { Context } from "@deepseek-ai/cordis";
-//#region src/config.d.ts
-/** 自动摄取档位：off 关闭；light 只读用户消息（每轮≤2 条）；eager 用户+助手消息（每轮≤5 条）。 */
-type IngestModeConfig = 'off' | 'light' | 'eager';
-/** 插件配置。 */
-interface EngramConfig {
-  /** 两个 SQLite 分库与嵌入模型缓存的根目录；默认 `~/.dsh/engram`。 */
-  dbDir?: string;
-  /** 会话开始是否注入用户级画像摘要；默认 true。 */
-  injectProfile?: boolean;
-  /** 画像注入的最大条数；默认 8。 */
-  profileTopN?: number;
-  /** 嵌入模型缓存目录；默认 `<dbDir>/models`。 */
-  modelCacheDir?: string;
-  /** 嵌入模型下载端点；默认 huggingface.co，网络受限环境配镜像（如 https://hf-mirror.com）。 */
-  hfEndpoint?: string;
-  /** 自动摄取档位；默认 off（显式开启才写库）。 */
-  ingest?: IngestModeConfig;
-  /** 蒸馏/摄取覆盖路由的 provider；必须与 model 成对提供。 */
-  provider?: string;
-  /** 蒸馏/摄取覆盖路由的 model；必须与 provider 成对提供。 */
-  model?: string;
-  /** 衰减：最近访问超过该天数才可能被归档；默认 30。 */
-  decayAfterDays?: number;
-  /** 衰减：importance 低于该值才可能被归档；默认 0.3。 */
-  decayImportanceBelow?: number;
-}
-/** Schemastery 校验面（cordis.yml 读取时校验）。 */
-declare const Config: z<EngramConfig>;
-//#endregion
-//#region src/index.d.ts
-/** Cordis 插件名（loader 诊断与注入 source 使用）。 */
-declare const name = "dsh-engram";
-/** 必需服务：工具注册表与 LLM 流式端点（摄取/蒸馏的辅助调用）。 */
-declare const inject: string[];
-/** 会话开始注入的画像渲染：top-N 高重要性 user 记忆一行一条。 */
-declare function renderProfile(topN: readonly {
-  kind: string;
-  content: string;
-}[]): string;
-/**
- * 插件体：预热分库与嵌入器，注册 9 个工具、画像注入、自动摄取与衰减调度。
- * @param ctx - host 上下文。
- * @param config - cordis.yml 传入的可选配置；非法值在加载时 loud 失败。
- */
-declare function apply(ctx: Context, config?: EngramConfig): void;
-//#endregion
-export { Config, type EngramConfig, apply, inject, name, renderProfile };