@dsh-libing/memory-manager 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.0
+
+- 首版：记忆管理、候选复核、会话召回、提炼任务与三个联动入口。
+
+- 提炼默认跟随会话最近实际模型，支持官方默认回退、固定选择与入队模型复核。
+- 按记录、复核、使用重排入口；会话页签区分提供给模型的版本与候选，统一弹窗字体及输入背景。

package/README.md

@@ -1,3 +1,65 @@
-# Temporary Holding Version
+# @dsh-libing/memory-manager
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DeepSeek Harness **0.2.0-rc.2** 的记忆插件，TypeScript 开发。管理偏好与约定、项目事实与决策、经验与教训和任务摘要。长文档与原件继续放在知识库，技能和 MCP 继续由对应中心管理。
+
+## 安装与入口
+
+从 LiBing 市场安装，或在明确的 profile 中运行：
+
+```sh
+dsh plugin --profile <profile> add @dsh-libing/memory-manager
+```
+
+开发未发布包：在仓库根运行 `pnpm dev:market --port 18786`，在开发市场安装“记忆中心”。开发 profile 和数据与日常 `~/.dsh` 隔离；重启命令更新已安装的未发布 tarball。
+
+三个入口共享同一数据：
+
+- 侧边栏“记忆中心”：记录、过滤、候选复核、版本、设置、活动、导出和回收站。
+- 会话“记忆”页签：与“对话/轨迹”并列，绑定当前实际会话；先查看本轮实际提供给模型的历史版本，再核对本会话建议；搜索、准备和任务细节放在次级记录中。
+- 对话轮末简短回执：有带入、读取或待确认内容时显示，点击定位该会话的对应轮次。
+
+已准备表示检索已完成；已带入以实际 `user/message` 接纳事件为准；工具已读取表示读取成功。它们都不证明模型实际采纳了结论。旧会话没有记录时不能推断未用过记忆。
+
+## 使用
+
+使用流程为“记录或提炼 → 核对建议 → 在后续对话使用”。手动新建先填标题、内容与范围，分类、标签和召回选项放在高级选项；保存直接成为已确认记忆。模型提交和对已确认条目的编辑均先生成候选，在“待确认”中核对内容与来源后确认生效；确认前仍使用原生效版本。候选及修订不会出现在模型检索结果中。两处同时编辑会拒绝过期版本，请刷新再复核。
+
+普通会话示例：
+
+> 请记住：本项目新增插件前先写简短提案，作为本工作区约定提交候选。
+>
+> 请检索这个工作区的记忆，说明我们之前的选型理由及来源；没有记录就直接说没有。
+
+工具需要出现在该会话实际工具目录中，可以在 MCP 管理中心确认调用开关：
+
+| 工具 | 用法 |
+| --- | --- |
+| `libing_memory_search` | `{ "query": "提案约定" }`，返回已确认记忆的身份、版本、摘要和来源。中文词片与英文关键词匹配，未命中返回空列表。 |
+| `libing_memory_read` | `{ "id": "搜索返回的身份", "version": 1 }`，读取确切版本，重新校验会话范围与当前召回开关。 |
+| `libing_memory_propose` | `{ "title": "提案约定", "content": "新增插件前先写简短提案", "kind": "agreement", "range": "workspace" }`。修订时补 `target` 和读取时的 `expected` 版本；相同工具调用身份不会重复创建候选。 |
+
+模型不能通过这些工具批准、直接覆盖、永久删除或选择个人共享范围。管理 API 和模型工具职责分离不是对拥有终端/文件权限的 Agent 的绝对沙箱。
+
+## 范围、召回和设置
+
+默认工作区范围来自 Host 对当前会话真实 `cwd` 的 canonical path，不按最近会话、名称或最近 Git 根猜测。当前会话范围仅用于对应 session；个人记忆由用户明确设定，仅在当前 profile 内跨工作区共享。子 Agent 使用自身真实会话范围，不能读取父会话专属记忆；自动提炼跳过子 Agent。
+
+本地自动召回默认开启，不额外调用模型。新轮第一步优先固定条目，再取最多 5 个相关条目，固定条目同样受预算限制。默认上限 4,000 字符，超限跳过完整条目并记录原因，原文中的模板符号不会被插值。条目确认或修订不改变已经开始的轮次快照；当前明确指令始终优先。
+
+自动候选提炼默认关闭。提炼模型默认跟随所选会话最近实际请求的 provider/model，从官方会话日志解析，冷会话不启动 Agent；该会话尚无调用记录时沿用 DSH 默认模型。设置里展示实际模型及来源，也可在官方模型目录选择固定模型或手动填写已配置身份；固定选择优先，不静默替换已失效的提供方。本插件不新增凭据或模型连接配置。中心“从会话提炼”和会话页签“从这轮提炼”可手动提炼已正常完成的一轮；确认窗口说明来源与模型，提交后结果进入待确认。确认时模型若已改变会拒绝提交，任务入队后固定模型，自动模式只在正常 `turn/end` 后排队。提炼仅读取该轮真实用户文本与助手回答，最多 12,000 字符，不读取 reasoning、原始工具输出或本插件召回消息。疑似凭据的输入跳过提炼，检测不能保证发现所有秘密。
+
+任务串行执行，最多 20 个排队/执行任务；每次模型调用 45 秒超时，默认每天 20 次（UTC）持久预约预算，取消和失败也计入已花费预算。同一来源轮次、设置版本及实际模型重复点击不重复调用；需要重试时先核对设置并保存。模型最多生成 4 个候选，每条不超过 1,500 字符。模型失败、取消、重启中断和预算跳过分别显示。关闭自动提炼取消当前 profile 各工作区的自动任务；手动任务可逐项取消。取消后迟到的结果不能提交候选。
+
+正常会话会把带入的记忆发送给当前模型；提炼会把上述选定对话发送给配置模型。本地存储不等于数据不出本机。
+
+## 数据与生命周期
+
+默认数据根为当前 profile 的 `libing/memory-manager`。包含 `memory.sqlite`（WAL）、唯一实例 owner lock，持久保存当前记忆、不可变历史版本、候选、任务、预算和活动。可通过 patch 的 `dataRoot` 指定绝对路径；数据根绑定原 profile，不能供另一个 profile 共用。
+
+最多 1,000 条记忆（含回收站）、500 个待确认候选；已结束候选及任务保留最近约 2,000 条，活动保留 2,000 条，页面显示最近 200 条活动与 100 个任务。历史版本窗口显示最近 100 个版本。卸载停止接收操作、取消并等待提炼及 worker 退出后释放 owner；重载读取原数据且不重复注册工具。进程中断后的排队/执行任务标记为中断，不自动续费重试。
+
+移入回收站立即阻止新检索/读取，支持恢复；永久删除需要在回收站输入完整标题，删除当前记忆、历史、对应候选并清空活动的相关摘要。**它不会擦除已进入会话日志或已发送给模型的内容。** 不涉及数据库物理取证级擦除。JSON/Markdown 导出当前视图的已确认记忆，仅供阅读与迁移准备，不是完整恢复备份；备份数据库前停止插件并连同 WAL 一起妥善处理。
+
+owner lock 只在旧 PID 已不存在时恢复，不抢占活实例。如恢复过程本身崩溃留下 `owner.recover`，先确保该数据根没有运行实例，再人工处理；不要在运行中删除 owner 文件。
+
+首版只提供本地关键词检索，没有向量模型、云同步、自动合并/画像或知识图谱。验收以 macOS 的真实 rc.2 Web 与安装 tarball 为准，未声明 Windows 已验证。

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: libing-memory-manager
+      name: '@dsh-libing/memory-manager'

package/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="#5684ff" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M12 6c-2-5-7-2-6 1-4 0-4 6-1 7-1 4 4 7 7 3V6Zm0 0c2-5 7-2 6 1 4 0 4 6 1 7 1 4-4 7-7 3"/><path d="M6 7c0 2 1 3 3 3m-4 4c2-1 4 0 4 2m9-9c0 2-1 3-3 3m4 4c-2-1-4 0-4 2"/></svg>

package/lib/client-types/client/Dialogs.d.ts

@@ -0,0 +1,29 @@
+import type { MemoryApi } from './api.ts';
+import type { Translate } from './Editor.tsx';
+import type { State, Mutation, CaptureModel } from '../shared.ts';
+export declare function ModelLine({ value, t }: {
+    value: CaptureModel | null;
+    t: Translate;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function SettingsDialog({ state, api, t, busy, save, close, error }: {
+    state: State;
+    api: MemoryApi;
+    t: Translate;
+    busy: boolean;
+    save: (value: Mutation) => Promise<boolean>;
+    close: () => void;
+    error: string;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Guide({ t, close }: {
+    t: Translate;
+    close: () => void;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function CaptureDialog({ state, turn, t, busy, error, save, close }: {
+    state: State;
+    turn?: number | undefined;
+    t: Translate;
+    busy: boolean;
+    error: string;
+    save: (value: Mutation) => Promise<boolean>;
+    close: () => void;
+}): import("react/jsx-runtime").JSX.Element;

package/lib/client-types/client/Editor.d.ts

@@ -0,0 +1,12 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { Candidate, Entry, Mutation } from '../shared.ts';
+export type Translate = TranslateNS<'libingMemoryManager'>;
+export declare function Editor({ original, candidate, t, busy, save, close, error }: {
+    original?: Entry | undefined;
+    candidate?: Candidate | undefined;
+    t: Translate;
+    busy: boolean;
+    save: (value: Mutation) => Promise<boolean>;
+    close: () => void;
+    error?: string | undefined;
+}): import("react/jsx-runtime").JSX.Element;

package/lib/client-types/client/MemoryPage.d.ts

@@ -0,0 +1,31 @@
+/** Shared management controls; the session view never changes its rendered target's identity. */
+import * as React from 'react';
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { MemoryApi } from './api.ts';
+import type { Translate } from './Editor.tsx';
+import type { Selection, Entry } from '../shared.ts';
+export declare function label(t: Translate, code: string): string;
+export interface Navigation {
+    center(session?: string, focus?: string): void;
+    session(session: string, turn?: number): Promise<void>;
+    subscribe(listener: () => void): () => void;
+    snapshot(): Selection;
+    bind(session: string, open: (view: string, focus: string) => void): () => void;
+}
+type Common = PropsLocale<'libingMemoryManager'> & {
+    api: MemoryApi;
+    navigation: Navigation;
+};
+export declare function EntryRow({ entry, t, children }: {
+    entry: Entry;
+    t: Translate;
+    children?: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function MemoryPage({ api, navigation, t }: Common): import("react/jsx-runtime").JSX.Element;
+export declare function MemoryPanel({ api, navigation, t, selection, choose }: Common & {
+    selection: Selection;
+    choose: (value: Selection) => void;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function MemoryView(props: Common & PropsRuntime<'conversation.view'>): import("react/jsx-runtime").JSX.Element;
+export declare function MemoryReceipt({ sessionId, turn, api, navigation, t }: Common & PropsRuntime<'conversation.chat.turnTail'>): import("react/jsx-runtime").JSX.Element | null;
+export {};

package/lib/client-types/client/api.d.ts

@@ -0,0 +1,9 @@
+import type { Entry, State, Selection, Mutation, ModelDirectory } from '../shared.ts';
+export interface MemoryApi {
+    models(signal: AbortSignal): Promise<ModelDirectory>;
+    history(input: Selection, id: string, signal: AbortSignal): Promise<Entry[]>;
+    state(input: Selection, signal: AbortSignal): Promise<State>;
+    mutate(input: Selection, mutation: Mutation, signal: AbortSignal): Promise<unknown>;
+    read(input: Selection, id: string, version: number, signal: AbortSignal): Promise<Entry>;
+}
+export declare const api: MemoryApi;

package/lib/client-types/client/index.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { LocaleKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        libingMemoryManager: LocaleKey;
+    }
+}
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

package/lib/client-types/client/locales.d.ts

@@ -0,0 +1,207 @@
+export declare const zh: {
+    readonly savedMemories: "已保存记忆";
+    readonly advanced: "高级选项";
+    readonly recordHint: "写下以后还会用到的约定或结论。保存后可在后续对话中作为参考。";
+    readonly titleExample: "例如：本项目的开发约定";
+    readonly contentExample: "例如：新增插件先写简短提案，验证完成后再移到 implemented。";
+    readonly emptyMemories: "还没有保存记忆";
+    readonly emptyStart: "你可以直接记录一条约定，或从所选会话中提炼建议；模型生成的建议需要你确认后才生效。";
+    readonly flowRecord: "1. 记录或提炼";
+    readonly flowReview: "2. 核对建议";
+    readonly flowUse: "3. 在对话中使用";
+    readonly followModel: "跟随会话模型（推荐）";
+    readonly fixedModel: "指定提炼模型";
+    readonly modelMode: "提炼模型";
+    readonly modelChoice: "选择模型";
+    readonly effectiveModel: "实际提炼模型";
+    readonly sessionModel: "所选会话最近使用";
+    readonly defaultModel: "DSH 默认模型";
+    readonly customModel: "手动指定";
+    readonly modelUnavailable: "此提供方当前不可用，请在 DSH 设置中检查模型连接，或另选提炼模型。";
+    readonly modelChanged: "提炼模型已改变，请关闭窗口并重新确认。";
+    readonly modelDirectoryUnavailable: "模型目录暂不可用；可手动填写已配置的模型身份。";
+    readonly modelFollowHint: "默认沿用所选会话最近使用的模型；尚无调用记录时沿用 DSH 默认模型。无需额外配置凭据。";
+    readonly noCaptureModel: "尚无可用的提炼模型，请先在对话中选择模型，或在这里指定已配置的模型。";
+    readonly captureConfirm: "从对话生成记忆建议";
+    readonly captureFromSession: "从会话提炼";
+    readonly captureFromTurn: "从这轮提炼";
+    readonly captureSubmit: "生成待确认建议";
+    readonly captureHint: "仅发送选定轮次的用户消息与助手回答，不包含推理和原始工具输出。生成的建议先等你核对，不会直接写入已保存记忆。";
+    readonly captureTarget: "提炼来源";
+    readonly captureQueued: "提炼任务已提交，完成后可在这里核对建议。";
+    readonly noSuggestions: "目前没有待确认建议";
+    readonly captureEmpty: "这轮没有发现适合长期保存的内容。你仍可手动记录。";
+    readonly sessionTitle: "这段对话的记忆";
+    readonly provided: "提供给模型";
+    readonly usedTitle: "本轮提供给模型的记忆";
+    readonly usedHint: "这些内容曾作为参考交给模型；是否采纳以回答为准。";
+    readonly noUsed: "本轮没有已记录的记忆带入或读取。";
+    readonly noUsedHint: "保存记忆后，系统会在新轮对话中匹配相关内容；也可以直接让模型检索记忆。";
+    readonly suggestTitle: "建议保存";
+    readonly availableNext: "可用于后续对话的记忆";
+    readonly audit: "使用记录";
+    readonly reviewAction: "核对并保存";
+    readonly reviewNeeded: "模型生成内容需要你确认；确认前不会参与检索或召回。";
+    readonly nextAction: "想留下刚才的结论？可以从本轮提炼，也可以在对话中说“请记住这条约定”。";
+    readonly recallHint: "自动匹配已保存记忆，不额外调用模型。";
+    readonly autoCaptureHint: "每轮完成后自动生成待确认建议，会调用下方模型并计入每日预算。默认关闭。";
+    readonly guideRecord: "新建记忆可以直接保存。也可在对话中说“请记住本项目的约定”，或点击“从会话提炼”生成建议。";
+    readonly guideReview: "在“待确认”核对内容、范围和来源，再确认生效。修改已有记忆也先生成修订建议，确认前仍使用原版本。";
+    readonly guideUse: "新轮对话会自动匹配相关记忆。你也可明确说“请检索本工作区的记忆”，让模型搜索并读取。当前指令优先。";
+    readonly guideScope: "默认仅在当前工作区使用；“当前会话”只用于这一段对话；“个人记忆”在当前 profile 的工作区之间共享。";
+    readonly guideTools: "支持的工具";
+    readonly guideSearch: "搜索已确认且参与召回的记忆，返回标题、摘要和来源。";
+    readonly guideRead: "读取搜索结果中的确切版本；不能读取待确认建议。";
+    readonly guidePropose: "提交新建议或修订，等待用户确认；不能替用户批准或删除。";
+    readonly guideStatus: "会话“记忆”页签";
+    readonly guideStatusBody: "“提供给模型”展示这一轮实际带入或工具读取的历史版本。“建议保存”展示本会话待确认内容；搜索匹配和准备记录放在使用记录中。";
+    readonly guideLimits: "范围与数据说明";
+    readonly recallLabel: "允许对话使用";
+    readonly pinLabel: "每轮优先带入";
+    readonly manualModel: "手动填写模型身份";
+    readonly sessionRequired: "请先选择一个会话";
+    readonly untitled: "未命名会话";
+    readonly autoCaptureOff: "自动提炼已关闭";
+    readonly versions: "历史版本";
+    readonly historyLimit: "显示最近 100 个版本；旧版本仅供复核，不替换当前生效内容。";
+    readonly profileMismatch: "数据根属于另一个 profile，不能共用";
+    readonly nav: "记忆中心";
+    readonly subtitle: "管理已确认的偏好、项目决策与经验。";
+    readonly help: "使用说明";
+    readonly settings: "设置";
+    readonly create: "新建记忆";
+    readonly refresh: "刷新";
+    readonly workspace: "工作区";
+    readonly session: "会话";
+    readonly noSession: "暂无会话";
+    readonly profile: "当前 profile";
+    readonly shared: "个人记忆仅在此 profile 内跨工作区共享。选择会话仅用于查看。";
+    readonly memories: "记忆";
+    readonly pending: "待确认";
+    readonly activity: "活动";
+    readonly trash: "回收站";
+    readonly search: "搜索标题、内容或标签";
+    readonly allKinds: "全部类型";
+    readonly allRanges: "全部范围";
+    readonly agreement: "偏好与约定";
+    readonly decision: "项目事实与决策";
+    readonly lesson: "经验与教训";
+    readonly handoff: "任务摘要";
+    readonly workspaceRange: "当前工作区";
+    readonly sessionRange: "当前会话";
+    readonly personalRange: "个人记忆";
+    readonly title: "标题";
+    readonly content: "内容";
+    readonly tags: "标签（逗号分隔）";
+    readonly kind: "类型";
+    readonly range: "使用范围";
+    readonly pinned: "固定带入";
+    readonly recall: "参与召回";
+    readonly source: "来源";
+    readonly detail: "详情与来源";
+    readonly version: "版本";
+    readonly manual: "用户记录";
+    readonly model: "模型建议";
+    readonly capture: "会话提炼";
+    readonly edit: "提出修订";
+    readonly approve: "确认生效";
+    readonly reject: "拒绝";
+    readonly remove: "移入回收站";
+    readonly restore: "恢复";
+    readonly purge: "永久删除";
+    readonly confirmTitle: "输入完整标题以确认永久删除";
+    readonly save: "保存";
+    readonly cancel: "取消";
+    readonly close: "关闭";
+    readonly loading: "加载中…";
+    readonly empty: "暂无符合条件的内容";
+    readonly failure: "操作失败";
+    readonly saved: "操作已提交";
+    readonly old: "原生效内容";
+    readonly proposed: "待确认内容";
+    readonly nextTurn: "确认后供下一次检索或新轮召回使用，不修改已开始的轮次快照。";
+    readonly guide: "记忆是历史参考，当前明确指令优先。说“记住本项目的约定”会提交候选，确认后生效；说“查一下之前的选型原因”可搜索并读取来源。候选不能被模型检索。参与召回只代表可被选中，不等于模型采纳；超预算会跳过完整条目。删除会阻止后续检索，但不擦除既有会话历史。";
+    readonly privacy: "正常会话会向当前模型发送带入的记忆；提炼会向配置模型发送选定轮次的用户消息及助手回答。不会提炼 reasoning 或原始工具输出。本地存储不等于数据不出本机。";
+    readonly autoRecall: "本地自动召回";
+    readonly autoCapture: "自动候选提炼";
+    readonly provider: "提炼 provider";
+    readonly modelField: "提炼 model";
+    readonly daily: "每日调用上限（UTC）";
+    readonly budget: "召回字符上限";
+    readonly export: "导出 JSON";
+    readonly exportMarkdown: "导出 Markdown";
+    readonly exportNote: "导出当前视图的生效记忆，用于阅读或迁移准备；不是完整数据库恢复备份。";
+    readonly extract: "提炼最近完成的一轮";
+    readonly extractTurn: "提炼所选轮次";
+    readonly jobs: "提炼任务";
+    readonly queued: "排队";
+    readonly running: "执行中";
+    readonly done: "完成";
+    readonly failed: "失败";
+    readonly cancelled: "已取消";
+    readonly interrupted: "重启中断";
+    readonly skipped: "已跳过";
+    readonly stop: "取消任务";
+    readonly openCenter: "打开记忆中心";
+    readonly openMemory: "查看会话记忆";
+    readonly latest: "最近一轮";
+    readonly turn: "轮次";
+    readonly thisTurn: "本轮记忆";
+    readonly available: "本会话可用记忆";
+    readonly history: "历史轮次与操作";
+    readonly included: "已带入";
+    readonly prepared: "已准备";
+    readonly read: "工具已读取";
+    readonly searchStatus: "搜索返回";
+    readonly deleted: "已永久删除";
+    readonly notAdmitted: "未接纳";
+    readonly captureSkipped: "提炼跳过";
+    readonly propose: "候选提交";
+    readonly settingsStatus: "设置变更";
+    readonly toggle: "召回开关变更";
+    readonly settingsRevision: "设置保存时复核版本；两个页面修改冲突时请刷新。";
+    readonly turnReceipt: "本轮记忆";
+    readonly noRecord: "暂无该轮记录；不能据此推断旧会话未使用过记忆。";
+    readonly missing: "内容不可用或已删除";
+    readonly personalRequiresUser: "个人共享范围需要用户在复核时明确选择";
+    readonly unknownScope: "无法确认当前会话范围";
+    readonly revisionConflict: "版本已改变，请刷新并重新复核";
+    readonly notFound: "条目不存在";
+    readonly outsideScope: "条目不属于所选范围";
+    readonly notReadable: "条目不再允许模型读取";
+    readonly dataRootBusy: "数据目录被其他实例使用";
+    readonly sensitiveInput: "该轮疑似包含凭据，已跳过提炼";
+    readonly completedTurnRequired: "请先完成一轮正常对话";
+    readonly noUserInput: "该轮没有真实用户输入";
+    readonly modelRequired: "尚未解析到提炼模型，请在会话选择模型或到记忆设置指定";
+    readonly dailyBudget: "已达到每日调用预算";
+    readonly queueFull: "任务队列已满";
+    readonly memoryLimit: "已达到记忆容量上限";
+    readonly candidateLimit: "待确认候选过多";
+    readonly purgeConfirmation: "请在回收站输入完整标题";
+    readonly noMatch: "没有相关记忆";
+    readonly recallOff: "自动召回已关闭";
+    readonly recallBudget: "部分完整条目因预算未带入";
+    readonly operationFailed: "服务不可用，请刷新";
+    readonly storageFailed: "数据库操作失败";
+    readonly extractionFailed: "提炼失败，请检查模型设置后手动重试";
+    readonly modelNotCompleted: "模型未正常完成";
+    readonly modelOutputTooLarge: "模型输出超限";
+    readonly restart: "任务在重启时中断";
+    readonly userCancelled: "用户取消";
+    readonly invalidRequest: "请求无效";
+    readonly absoluteRootRequired: "数据目录需要绝对路径";
+    readonly closed: "插件正在退出";
+    readonly busy: "服务繁忙";
+    readonly cannotNavigate: "目标会话未能打开，请在侧栏打开后重试";
+    readonly turnHint: "可以查看该轮的带入/读取记录；这不是模型实际采纳的证明。";
+    readonly pinnedHint: "固定记忆仍受完整条目预算限制。";
+    readonly pendingCount: "本会话待确认";
+    readonly off: "关闭";
+    readonly on: "开启";
+    readonly copyPrompt: "复制使用示例";
+    readonly copied: "已复制";
+    readonly guideExample: "请检索这个工作区的记忆，说明我们之前的选型理由及来源；没有记录就直接说没有。";
+};
+export type LocaleKey = keyof typeof zh;
+export declare const en: Record<LocaleKey, string>;

package/lib/client-types/client/navigation.d.ts

@@ -0,0 +1,6 @@
+/** Target-addressed links. No DOM tab clicking and no unscoped last-session fallback. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Navigation } from './MemoryPage.tsx';
+export declare function navigation(ctx: Context): Navigation & {
+    close(): void;
+};

package/lib/client-types/client/turnView.d.ts

@@ -0,0 +1,7 @@
+/** Search/preparation are audit facts, not evidence that memory reached the model. */
+import type { Activity, ActivityItem } from '../shared.ts';
+export declare function providedMemories(rows: Activity[]): {
+    item: ActivityItem;
+    included: boolean;
+    read: boolean;
+}[];

package/lib/client-types/client/useMemory.d.ts

@@ -0,0 +1,122 @@
+import type { MemoryApi } from './api.ts';
+import type { Selection, Mutation } from '../shared.ts';
+export declare function invalidate(): void;
+export declare function useMemory(api: MemoryApi, input: Selection): {
+    state: {
+        profile: string;
+        scope: {
+            workspace: string;
+            session: string | null;
+        };
+        selectedSession: string | null;
+        workspaces: {
+            id: string;
+            title: string;
+        }[];
+        sessions: {
+            id: string;
+            title: string;
+        }[];
+        entries: {
+            title: string;
+            content: string;
+            kind: "agreement" | "decision" | "lesson" | "handoff";
+            tags: string[];
+            pinned: boolean;
+            recall: boolean;
+            range: "workspace" | "session" | "personal";
+            id: string;
+            version: number;
+            workspace: string;
+            session: string | null;
+            state: "active" | "trash";
+            source: {
+                kind: "manual" | "model" | "capture";
+                session: string | null;
+                turn: number | null;
+                evidence: string;
+                seqs: number[];
+            };
+            updated: string;
+        }[];
+        candidates: {
+            id: string;
+            revision: string;
+            target: string | null;
+            expected: number;
+            workspace: string;
+            session: string | null;
+            draft: {
+                title: string;
+                content: string;
+                kind: "agreement" | "decision" | "lesson" | "handoff";
+                tags: string[];
+                pinned: boolean;
+                recall: boolean;
+                range: "workspace" | "session" | "personal";
+            };
+            source: {
+                kind: "manual" | "model" | "capture";
+                session: string | null;
+                turn: number | null;
+                evidence: string;
+                seqs: number[];
+            };
+            state: "pending" | "rejected" | "accepted";
+            updated: string;
+        }[];
+        activities: {
+            id: string;
+            workspace: string;
+            session: string | null;
+            turn: number | null;
+            kind: string;
+            reason: string;
+            items: {
+                id: string;
+                version: number;
+                title: string;
+                summary: string;
+                status: "prepared" | "included" | "search" | "read" | "deleted";
+            }[];
+            updated: string;
+        }[];
+        jobs: {
+            id: string;
+            workspace: string;
+            session: string;
+            turn: number;
+            state: "queued" | "running" | "done" | "failed" | "cancelled" | "interrupted" | "skipped";
+            reason: string;
+            candidateIds: string[];
+            updated: string;
+            automatic: boolean;
+        }[];
+        settings: {
+            revision: number;
+            autoRecall: boolean;
+            autoCapture: boolean;
+            provider: string;
+            model: string;
+            maxDailyCalls: number;
+            maxRecallChars: number;
+        };
+        captureModel: {
+            provider: string;
+            model: string;
+            source: "session" | "default" | "custom";
+            available: boolean;
+        } | null;
+        followingModel: {
+            provider: string;
+            model: string;
+            source: "session" | "default" | "custom";
+            available: boolean;
+        } | null;
+    } | undefined;
+    error: string;
+    busy: boolean;
+    execute: (value: Mutation) => Promise<boolean>;
+    refresh: () => void;
+    signal: () => AbortSignal;
+};