@kenz1117/dsh-engram 0.2.0 → 0.4.0

package/README.md

@@ -40,9 +40,13 @@ dsh plugin --profile web add @kenz1117/dsh-engram
 | `engram_forget` | 遗忘（软删可恢复） |
 | `engram_review` | 审计单条：来源链、取代链、矛盾、操作日志 |
 | `engram_stats` | 全库统计与信噪比 |
-| `engram_export` | 导出 Markdown/JSON 文件（数据可携带） |
+| `engram_export` | 导出 Markdown / JSON 文件（数据可携带） |
 | `engram_distill` | 蒸馏：同主题簇合并为高层规律（LLM） |
 
+## Web 管理面板（设置页「记忆库」tab）
+
+宿主带 webServer 的 profile（web 等）会在**设置页**自动出现「记忆库」tab（经 `settings.section` 槽位注册，client 半为 React 组件、随 `lib/client.js` 由宿主模块表装载）：统计卡片、按状态/种类/内容过滤、编辑（走取代链）、遗忘/恢复、导出 Markdown/JSON 下载。数据经回环 API `/api/engram/*`（写操作校验回环 Origin）。headless 等无 webServer 的组合不挂载，其余能力不受影响。
+
 ## 理解实现
 
 - **双层分库**：`user.db` 全局共享；`project-<cwd>.db` 按工作目录隔离。

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,6 +374,198 @@ async function ingestPreviousTurn(deps) {
 	};
 }
 //#endregion
+//#region src/routes.ts
+/** 回环 peer：IPv4 127/8、IPv6 ::1、IPv4-mapped IPv6。 */
+function isLoopbackPeer(req) {
+	const address = req.socket.remoteAddress;
+	if (address === void 0) return false;
+	return address === "::1" || address.startsWith("127.") || address.startsWith("::ffff:127.");
+}
+/** Host 头必须为回环字面量（防 DNS rebinding：拒绝 `127.0.0.1.attacker.com`）。 */
+function isLoopbackHost(req) {
+	const host = req.headers.host;
+	if (host === void 0 || host === "") return true;
+	const name = host.split(":")[0];
+	return name === "localhost" || name === "::1" || name !== void 0 && /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(name);
+}
+/** 写操作的 Origin 必须为回环（防跨站表单/fetch）。缺失视为放行，由 Content-Type 兜底。 */
+function isLoopbackOrigin(origin) {
+	if (origin === void 0 || origin === "") return true;
+	try {
+		const host = new URL(origin).hostname;
+		return host === "localhost" || host === "::1" || /^127\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(host);
+	} catch {
+		return false;
+	}
+}
+/**
+* 回环守卫：仅放行回环 GET/POST 请求（peer + Host 同时校验）。
+* @returns 是否放行；false = 已拒绝并结束响应。
+*/
+function guardLoopback(req, res) {
+	if (!(req.method === "GET" || req.method === "POST") || !isLoopbackPeer(req) || !isLoopbackHost(req)) {
+		res.writeHead(403, { "content-type": "application/json; charset=utf-8" });
+		res.end(JSON.stringify({ error: "forbidden: loopback only" }));
+		return false;
+	}
+	return true;
+}
+/** 写操作守卫：Origin 回环 + Content-Type JSON。 */
+function guardWrite(req, res) {
+	if (!isLoopbackOrigin(req.headers.origin)) {
+		res.writeHead(403, { "content-type": "application/json; charset=utf-8" });
+		res.end(JSON.stringify({ error: "forbidden: loopback only" }));
+		return false;
+	}
+	if (!(req.headers["content-type"] ?? "").toLowerCase().includes("application/json")) {
+		res.writeHead(415, { "content-type": "application/json; charset=utf-8" });
+		res.end(JSON.stringify({ error: "unsupported content-type" }));
+		return false;
+	}
+	return true;
+}
+/** 读取并解析 JSON body（上限 64 KiB，防坏/恶意 body 拖住 handler）。 */
+async function readJsonBody(req) {
+	let body = "";
+	for await (const chunk of req) {
+		body += String(chunk);
+		if (body.length > 65536) return null;
+	}
+	try {
+		const parsed = JSON.parse(body === "" ? "{}" : body);
+		return parsed !== null && typeof parsed === "object" ? parsed : null;
+	} catch {
+		return null;
+	}
+}
+function json(res, status, body) {
+	res.writeHead(status, { "content-type": "application/json; charset=utf-8" });
+	res.end(JSON.stringify(body));
+}
+/** 从 URL searchParams 收敛 scope（缺省 user）。 */
+function scopeOf$1(raw, fallback) {
+	return raw === "user" || raw === "project" ? raw : fallback;
+}
+/**
+* 注册 /engram 页面与 /api/engram/* 接口（effect 由调用方持有，disposer 可逆）。
+* @param ctx - 携带 webServer 服务的宿主上下文。
+*/
+function registerEngramRoutes(ctx, deps) {
+	ctx.effect(() => ctx.webServer.register({
+		kind: "prefix",
+		path: "/api/engram",
+		handler: async (req, res) => {
+			if (!guardLoopback(req, res)) return;
+			const url = new URL(req.url ?? "/", "http://127.0.0.1");
+			const route = url.pathname.slice(12);
+			try {
+				if (req.method === "GET" && route === "stats") {
+					json(res, 200, { parts: await Promise.all(["user", "project"].map(async (scope) => ({
+						scope,
+						stats: await (await deps.openStore(scope)).stats()
+					}))) });
+					return;
+				}
+				if (req.method === "GET" && route === "list") {
+					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
+					const status = url.searchParams.get("status");
+					const kind = url.searchParams.get("kind");
+					const q = url.searchParams.get("q");
+					const limit = Math.min(100, Math.max(1, Number(url.searchParams.get("limit") ?? 20) || 20));
+					const offset = Math.max(0, Number(url.searchParams.get("offset") ?? 0) || 0);
+					const filter = {
+						scope,
+						...status !== null && status !== "" && status !== "all" ? { status } : {},
+						...kind !== null && kind !== "" && kind !== "all" ? { kind } : {},
+						...q !== null && q !== "" ? { q } : {},
+						limit,
+						offset
+					};
+					json(res, 200, await (await deps.openStore(scope)).list(filter));
+					return;
+				}
+				if (req.method === "GET" && route === "review") {
+					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
+					const id = url.searchParams.get("id");
+					if (id === null || id === "") {
+						json(res, 400, { error: "id required" });
+						return;
+					}
+					const view = await (await deps.openStore(scope)).review(id);
+					view === void 0 || view.operations;
+					if (view === void 0) {
+						json(res, 404, { error: `未找到条目 ${id}` });
+						return;
+					}
+					json(res, 200, view);
+					return;
+				}
+				if (req.method === "GET" && route === "export") {
+					const scope = scopeOf$1(url.searchParams.get("scope"), "user");
+					const format = url.searchParams.get("format") === "json" ? "json" : "markdown";
+					const data = await (await deps.openStore(scope)).exportAll();
+					const stamp = (/* @__PURE__ */ new Date()).toISOString().replaceAll(":", "-");
+					const body = format === "json" ? JSON.stringify(data, null, 2) : [
+						`# dsh-engram 导出（${scope}）`,
+						"",
+						...data.records.map((record) => `- [${record.status}/${record.kind}] ${record.content}（id=${record.id}，importance ${record.importance}）`),
+						"",
+						"## 关系边",
+						...data.edges.map((edge) => `- ${edge.from} --${edge.type}--> ${edge.to}`),
+						""
+					].join("\n");
+					res.writeHead(200, {
+						"content-type": format === "json" ? "application/json; charset=utf-8" : "text/markdown; charset=utf-8",
+						"content-disposition": `attachment; filename="engram-${scope}-${stamp}.${format}"`
+					});
+					res.end(body);
+					return;
+				}
+				if (req.method === "POST" && (route === "update" || route === "forget" || route === "restore")) {
+					if (!guardWrite(req, res)) return;
+					const body = await readJsonBody(req);
+					if (body === null || typeof body.id !== "string" || body.id === "") {
+						json(res, 400, { error: "id required" });
+						return;
+					}
+					const scope = scopeOf$1(typeof body.scope === "string" ? body.scope : null, "user");
+					const store = await deps.openStore(scope);
+					if (route === "update") {
+						if (typeof body.content !== "string" || body.content.trim() === "") {
+							json(res, 400, { error: "content required" });
+							return;
+						}
+						const old = await store.get(body.id);
+						if (old === void 0) {
+							json(res, 404, { error: `未找到条目 ${body.id}` });
+							return;
+						}
+						json(res, 200, { record: await store.update({
+							id: body.id,
+							scope,
+							kind: typeof body.kind === "string" && [
+								"fact",
+								"preference",
+								"decision",
+								"episode",
+								"skill"
+							].includes(body.kind) ? body.kind : old.kind,
+							content: body.content,
+							...typeof body.importance === "number" && Number.isFinite(body.importance) ? { importance: Math.min(1, Math.max(0, body.importance)) } : {}
+						}) });
+						return;
+					}
+					json(res, 200, { record: route === "forget" ? await store.forget(body.id) : await store.restore(body.id) });
+					return;
+				}
+				json(res, 404, { error: "unknown route" });
+			} catch (error) {
+				json(res, 500, { error: error instanceof Error ? error.message : String(error) });
+			}
+		}
+	}), "dsh-engram: api routes");
+}
+//#endregion
 //#region src/store/sqlite.ts
 /**
 * EngramStore 的 node:sqlite 实现：节点表 + 边表 + FTS5（unicode61 + 中文 2-gram 预切词）
@@ -703,6 +895,28 @@ async function openEngramStore(path) {
 		async topActive(scope, n) {
 			return sqlTopActive.all(scope, n).map(rowToRecord);
 		},
+		async list(filter) {
+			const conds = ["scope = ?"];
+			const params = [filter.scope];
+			if (filter.status !== void 0) {
+				conds.push("status = ?");
+				params.push(filter.status);
+			}
+			if (filter.kind !== void 0) {
+				conds.push("kind = ?");
+				params.push(filter.kind);
+			}
+			if (filter.q !== void 0 && filter.q !== "") {
+				conds.push("instr(content, ?) > 0");
+				params.push(filter.q);
+			}
+			const where = conds.join(" AND ");
+			const total = db.prepare(`SELECT COUNT(*) AS n FROM nodes WHERE ${where}`).get(...params).n;
+			return {
+				records: db.prepare(`SELECT * FROM nodes WHERE ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`).all(...params, filter.limit, filter.offset).map(rowToRecord),
+				total
+			};
+		},
 		async review(id) {
 			const row = getRow(id);
 			if (row === void 0) return void 0;
@@ -1549,6 +1763,12 @@ function apply(ctx, config = {}) {
 		routeOverride: resolved.routeOverride,
 		exportDir: `${resolved.dbDir}/exports`
 	})) ctx.tools.register(tool);
+	ctx.inject(["webServer"], (webCtx) => {
+		registerEngramRoutes(webCtx, {
+			openStore,
+			exportDir: `${resolved.dbDir}/exports`
+		});
+	});
 	if (resolved.injectProfile || resolved.ingest !== "off") ctx.on("agent/pre-step", (payload, next) => preStep(ctx, openStore, resolved, embedder, payload, next), { prepend: true });
 	const runDecay = async () => {
 		for (const scope of ["user", "project"]) {

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.2.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

@@ -28,6 +28,9 @@ const LINKED_PACKAGES = [
   ['@deepseek-ai/dsh-tools', 'packages/core/tools'],
   ['@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 };