@morlay/ui-conversation-manager 0.1.0 → 0.1.2

package/README.md

@@ -1,102 +1,25 @@
 # @morlay/ui-conversation-manager
 
-「对话管理」全局面板页（**浏览器半**）：`sidebar.panellist` nav 行 + `main` keyed 面板（与官方
-ui-plugin-manager 同一种注册方式）。页面分两层 Tabs（官方 `Pill`）：一层在**会话**与**统计**之间切换；
-会话视图给出全量会话的搜索、分页与归档 / 取消归档 / 导出 / 删除（确认弹窗），并带导入为新会话与
-孤儿数据 GC；统计视图给出全部对话的 token 用量。
-
-会话列表取 `POST /api/session.rows` 的完整语料（含归档），按最近活动在前；搜索（标题或工作区名）、
-子代理开关与翻页都是**后端**请求（前端只渲染当前页，输入停 250ms 再发）；**已归档**的行带标记，
-也只有这些行的「删除」可用
-（未归档行提供「归档」，两者互斥）。子代理派生会话（`origin: 'subagent'`）默认不列（它们既不可删
-也多数无意义，实测在真实库里占七成），勾选「显示子代理会话」即真全量。
-
-统计视图先按**时间范围**过滤（默认**本日**；**本周** / 近 7 天 / 近 30 天 / 近 90 天 / 最后是**全部**；
-换范围会向 host 重新聚合一次。**本日 / 本周**按 host 的本地时区算，本周从**周一 00:00** 起），
-二层 Tabs 再切维度：**总览**（「全部」与「其中子代理」两行）、**按模型**、**按会话**（用量降序取前 20）。
-时间范围取代了原来的「按天」一栏。
-
-每一行都是同一个形态：**label 在上，下面横向排布各个单项**，单项内部是「标签在上、值在下」。
-单项依次是：**输入（含缓存输入）· 缓存输入 · 缓存命中率 · 输出 · 推理 · 事件**
-——缓存输入占总输入（含缓存）的比例即命中率。**没有单独的合计项**；排序按「输入（含缓存）+ 输出」（不显示）。
+「对话管理」全局面板页（**浏览器半**）：`sidebar.panellist` 的 nav 行 + `main` keyed 面板（与官方
+ui-plugin-manager 同一种注册方式）。一层 Tabs 在**会话**与**统计**之间切换：会话视图做全量会话的搜索、分页与
+归档 / 取消归档 / 导出 / 删除（确认弹窗），并带导入为新会话与孤儿数据 GC；统计视图给出全部对话的 token 用量。
 
 ## 用法
 
-页面是 profile 的一行（由 `@morlay/better-session` 的 patch 插入），装好即在侧栏出现「对话管理」。
-它不新增 host 面，只读既有服务与路由。**会话行走我们自己的列表路由**（`POST /api/session.rows`，
-`@morlay/session-rdb`）：完整语料（含归档）+ 标题 + 最后活动时间随行给出——官方 `session/list` 按部署策略
-**默认排除已归档**（给上游 UI 用），归档集的管理动作要完整集合，两条路不混（决策见
-[session-rdb 的 ADR](../session-rdb/.agents/adrs/20260922-会话列表两条路.md)）：
-
-| 动作         | 接缝                                                                                                                             |
-| ------------ | -------------------------------------------------------------------------------------------------------------------------------- |
-| 列表与标题   | `POST /api/session.rows`（`@morlay/session-rdb`：完整语料 + 标题 + 最后活动时间 + 工作区归属；搜索 / 子代理过滤 / 分页都在后端） |
-| 归档         | `ctx.uiWorkspace.archiveSession`（上游 ui-workspace，未归档行提供）                                                              |
-| 取消归档     | `ctx.uiWorkspace.unarchiveSession`（上游 ui-workspace，已归档行提供）                                                            |
-| 导出         | `POST /api/session.export`（`@morlay/session-rdb`，直接下载 zip）                                                                |
-| 删除         | `POST /api/session.delete`（`@morlay/session-rdb`，仅已归档行可用）                                                              |
-| 导入为新会话 | `POST /api/session.import`（`@morlay/session-rdb`，不带 `sessionId` = 新建会话）                                                 |
-| 清理孤儿数据 | `POST /api/session.gc`（停 agent → 回收孤儿 subagent 会话 → 回收孤儿事件行 → VACUUM；执行期间阻塞界面）                          |
-| 用量统计     | `POST /api/session.usage`（`@morlay/session-rdb` 读专用用量表聚合；进入统计视图时拉一次，维度切换本地折叠）                      |
-
-归档 / 取消归档 / 删除 / 导入 / GC 成功后重拉会话行；host 拒绝（未归档 / 正在使用 / 不存在）
-时按错误码给出可读文案。列表每页 20 条，搜索框复用官方 `Input`（连同官方图标与焦点样式）。
-
-GC 是唯一会**停止所有运行中 agent** 的动作：确认后进入不可关闭的等待弹窗，避免用户在 VACUUM 期间
-做别的操作。
-
-## 数据位标注（`data-*`）
-
-页面每个数据位带稳定的 `data-*` 标注，沟通时可以直接指着它说（例如
-`data-usage-key=2026-09-14` 那行、`data-session-id=…` 那行的 `data-action=remove`）。
-只标"最小身份 + DOM 读不出的状态"：视图/维度由 `data-view`、`data-tab`、`data-usage-tab` 表达，
-行内合计与明细、行标题这类页面上直接可见的内容不再重复标注。
-
-时间范围的按钮与维度 tab 共用**同一套官方 tab 条视觉**（文字 13/16 wt500、选中态品牌蓝 + 2px 下划线，
-取自会话头部的 `ConversationRoot.module.css`），只在其语义上用 `radiogroup`（单选筛选）区别于维度的 `tab`；
-**不用 `Pill`**——官方 `ui-primitives` README 里 `Pill` 是「视图切换与筛选用法的可选中胶囊」（只读 capsule 是
-`Tag`），官方那件互斥择一的选择件是 `SegmentedControl`（受控 tab 形态 `SegmentedTabs`）；我们这里是**单选筛选**：
-视觉取 tab 条、语义用 `radiogroup`。
-
-统计的每一行（总览与列表）是同一形态：行 label + 横向排布的单项，所以读法一致——
-「`data-usage-key=2026-09-14` 行里 `data-usage-cell=input` 的 `data-usage-value`」。
-
-| 标注                                                        | 位置               | 含义                                                            |
-| ----------------------------------------------------------- | ------------------ | --------------------------------------------------------------- |
-| `data-view`                                                 | 页面根             | `sessions` / `usage`                                            |
-| `data-tab`                                                  | 一层 tab 按钮      | 该按钮切到的视图                                                |
-| `data-action`                                               | 按钮               | `import` / `gc` / `archive` / `unarchive` / `export` / `remove` |
-| `data-filter`                                               | 过滤器             | `search` / `subagents`                                          |
-| `data-scroll`                                               | 滚动容器           | `page`（会话列表与统计各一处）                                  |
-| `data-session-id` / `data-archived` / `data-subagent`       | 会话行             | 该行的会话 id 与状态（`true` / `false`）                        |
-| `data-pagination` / `data-page-current` / `data-page-total` | 分页条             | 当前页与总页数                                                  |
-| `data-notice` / `data-failure` / `data-status`              | 顶部提示与空态     | 结果、错误、`empty` / `empty-search`                            |
-| `data-usage-view` / `data-usage-tab` / `data-usage-range`   | 统计视图与二级 tab | 当前维度（`overview` / `models` / `sessions`）与时间范围        |
-| `data-range`                                                | 时间范围选项       | 该选项对应的 range 值                                           |
-| `data-usage-cell` / `data-usage-value`                      | 总览格子           | 维度键与原始数值（未格式化）                                    |
-| `data-usage-key`                                            | 统计划表行         | 维度键（日期 / `provider / model` / 会话 id / `subagent`）      |
-| `data-usage-status`                                         | 统计状态行         | `loading` / `error` / `empty`                                   |
-
-## 已知限制
-
-- 列表是全量会话：未归档行提供**归档**、已归档行提供**取消归档**（同一位置二选一，互斥）；
-  **删除只对已归档会话开放**（未归档行按钮禁用；host 侧仍返回 409），沿用
-  [ADR-会话删除仅限已归档且硬删](../session-rdb/.agents/adrs/20260917-会话删除仅限已归档且硬删.md)。
-- 只有「最近活动在前」一种排序，没有分组与批量操作；分页在后端（每次只取当前页 20 条，翻页与搜索都重新请求）。
-- 子代理派生会话默认不列（`origin: 'subagent'`）：勾选「显示子代理会话」后出现并带「子代理」标记，
-  但这些行不可删除（它们未归档）；归档 / 取消归档仍可用。
-- 没有 summary 的成员（例如已从 host 消失的归档 id）不产生行。
-- 删除不再顺带清孤儿：库体积要等一次 GC 才下降，见
-  [ADR-删除不再清孤儿与vacuum独立成gc通道](../session-rdb/.agents/adrs/20260918-删除不再清孤儿与vacuum独立成gc通道.md)。
-  GC 同时回收**父已不存在的 subagent 会话**（它们是删除父会话后的孤儿）；父还在的子会话不动。
-- 导入只接受含会话日志 artifact 的 zip；导出只导出该 artifact（不含附件等旁路数据）。
-- 统计是一次全库聚合（真实库实测约 140ms），只在进入统计视图时请求一次；口径见
-  [ADR-用量统计走专用用量日志表](../session-rdb/.agents/adrs/20260918-用量统计走专用用量日志表.md)。
-  按会话的行是各会话自己的日志口径（fork 子会话含继承前缀），所以各行之和 ≥ 总量；「其中子代理」与另一侧
-  相加正好等于总量。
-- 统计只反映**库里现有**的用量：删掉的会话与 GC 回收掉的孤儿行都不再计入。
-
-## 文档
-
-- 决策：[ADR-禁用上游已归档入口改由对话管理页承载](../../bundles/better-session/.agents/adrs/20260918-禁用上游已归档入口改由对话管理页承载.md)
-- 测试落点：[`src/__tests__/`](./src/__tests__)（注册面 / 页面 / 注入面 / 数字格式化四条 spec）
+页面是 profile 的一行（由 `@morlay/better-session` 的 patch 插入），装好即在侧栏出现「对话管理」。它不新增
+host 面，只读既有服务与路由：
+
+| 动作         | 接缝                                                                                                                                       |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
+| 列表与标题   | `POST /api/morlay/v1/session/rows`（`@morlay/session-rdb`：完整语料 + 标题 + 最后活动时间 + 工作区归属；搜索 / 子代理过滤 / 分页都在后端） |
+| 归档         | `ctx.uiWorkspace.archiveSession`（上游 ui-workspace，未归档行提供）                                                                        |
+| 取消归档     | `ctx.uiWorkspace.unarchiveSession`（上游 ui-workspace，已归档行提供）                                                                      |
+| 导出         | `POST /api/morlay/v1/session/export`（`@morlay/session-rdb`，直接下载 zip）                                                                |
+| 删除         | `POST /api/morlay/v1/session/delete`（`@morlay/session-rdb`，仅已归档行可用）                                                              |
+| 导入为新会话 | `POST /api/morlay/v1/session/import`（`@morlay/session-rdb`，不带 `sessionId` = 新建会话）                                                 |
+| 清理孤儿数据 | `POST /api/morlay/v1/session/gc`（停 agent → 回收孤儿 subagent 会话 → 回收孤儿事件行 → VACUUM；执行期间阻塞界面）                          |
+| 用量统计     | `POST /api/morlay/v1/session/usage`（`@morlay/session-rdb` 读专用用量表聚合；进入统计视图时拉一次，维度切换本地折叠，范围切换重新请求）    |
+
+归档 / 取消归档 / 删除 / 导入 / GC 成功后重拉会话行；host 拒绝（未归档 / 正在使用 / 不存在）时按错误码给出可读
+文案。删除只对已归档会话开放；子代理派生会话（`origin: 'subagent'`）默认不列，勾选「显示子代理会话」即真
+全量。

package/dist/client.cjs

@@ -9,18 +9,12 @@ window.__ModuleLoader__.load({
 		let _morlay_dsh_client_ui_primitives_client = require("@morlay/dsh-client-ui-primitives/client");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		//#region src/client/controller.ts
-		/** host 侧已存在的会话路由。 */
-		const SESSION_DELETE_PATH = "/api/session.delete";
-		const SESSION_IMPORT_PATH = "/api/session.import";
-		const SESSION_EXPORT_PATH = "/api/session.export";
-		const SESSION_GC_PATH = "/api/session.gc";
-		const SESSION_USAGE_PATH = "/api/session.usage";
-		/**
-		* 管理面的会话行（**完整语料，含归档**）：我们自己的路由，与官方 `session/list` 分开——那条按部署策略
-		* 默认排除归档（给上游 UI 用），归档集的管理动作需要完整集合。
-		*/
-		const SESSION_ROWS_PATH = "/api/session.rows";
-		/** 带 host 错误码的请求失败：页面据此选本地化文案。 */
+		const SESSION_DELETE_PATH = "/api/morlay/v1/session/delete";
+		const SESSION_IMPORT_PATH = "/api/morlay/v1/session/import";
+		const SESSION_EXPORT_PATH = "/api/morlay/v1/session/export";
+		const SESSION_GC_PATH = "/api/morlay/v1/session/gc";
+		const SESSION_USAGE_PATH = "/api/morlay/v1/session/usage";
+		const SESSION_ROWS_PATH = "/api/morlay/v1/session/rows";
 		var ConversationManagerRequestError = class extends Error {
 			code;
 			constructor(message, code) {
@@ -56,7 +50,6 @@ window.__ModuleLoader__.load({
 			const comma = dataUrl.indexOf(",");
 			return comma < 0 ? dataUrl : dataUrl.slice(comma + 1);
 		}
-		/** 页面的动作：host 交互收在这里，页面只见数据与回调。 */
 		var ConversationManagerController = class {
 			ports;
 			face;
@@ -118,21 +111,15 @@ window.__ModuleLoader__.load({
 					stoppedAgents: typeof value["stoppedAgents"] === "number" ? value["stoppedAgents"] : 0
 				};
 			}
-			/**
-			* 用量统计：host 侧聚合，前端各维度本地折叠。
-			* @param range - 时间范围语义键（`all` 不限、`day`/`week` 自然日/周、其余最近 N 天）。
-			*/
 			async loadUsage(range) {
 				const report = await postJson(SESSION_USAGE_PATH, { range });
 				if (report.totals === void 0 || !Array.isArray(report.buckets) || !Array.isArray(report.sessions)) throw new ConversationManagerRequestError("用量统计响应不可用", void 0);
 				return report;
 			}
 		};
-		/** 导出文件名优先取 host 给的 Content-Disposition。 */
 		function filenameOf(disposition, sessionId) {
 			return (disposition === null ? null : /filename="([^"]+)"/u.exec(disposition))?.[1] ?? `${sessionId}.zip`;
 		}
-		/** 浏览器下载：blob URL + 一次性 anchor；URL 在下一轮事件循环回收。 */
 		function downloadBlob(blob, filename) {
 			const url = URL.createObjectURL(blob);
 			const anchor = document.createElement("a");
@@ -148,11 +135,9 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/format.ts
-		/** 一位小数；三位数以上不留小数。 */
 		function trim(value) {
 			return value >= 100 ? String(Math.round(value)) : value.toFixed(1).replace(/\.0$/u, "");
 		}
-		/** @param value - token 数（非负整数）。 @returns 紧凑文本，例如 `1.2K`、`44.2B`。 */
 		function formatTokens(value) {
 			if (!Number.isFinite(value) || value <= 0) return "0";
 			if (value < 1e3) return String(Math.round(value));
@@ -160,20 +145,14 @@ window.__ModuleLoader__.load({
 			if (value < 1e9) return `${trim(value / 1e6)}M`;
 			return `${trim(value / 1e9)}B`;
 		}
-		/** @param value - 计数（轮次 / 步骤 / 用户输入 / 工具调用）。 @returns 千分位原文，例如 `1,024`。 */
 		function formatCount(value) {
 			if (!Number.isFinite(value) || value <= 0) return "0";
 			return Math.round(value).toLocaleString("en-US");
 		}
-		/** @param value - 百分点（0~100）。 @returns 紧凑百分比，例如 `98.4%`、`100%`。 */
 		function formatPercent(value) {
 			if (!Number.isFinite(value) || value <= 0) return "0%";
 			return `${value >= 100 ? Math.round(value) : Math.round(value * 10) / 10}%`;
 		}
-		/** 「对话管理」页面的样式表（官方 --dsw-* 变量 + 我们的 css-in-js 层）。
-		* 页面根是纵向 flex 且**自己不滚**：页头（标题 / tab 条 / 导入 / 清理）与搜索行固定在顶部，
-		* 只有 `scroll` 那层随内容滚。除滚动层外的项都 `flex: none`，否则内容变长时 flex 会把这些项
-		* 压到 min-content（官方 Input 的 32px 高会被压成一行文字高）。 */
 		const styles = {
 			page: {
 				display: "flex",
@@ -418,16 +397,12 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region src/client/ConversationManagerPage.tsx
-		/** 一页的行数（会话列表）。 */
 		const PAGE_SIZE = 20;
-		/** 统计视图按会话列出时的行数上限。 */
 		const USAGE_SESSION_ROWS = 20;
-		/** 行上显示的紧凑相对时间。 */
 		function timeLabel(updatedAt, now, t) {
 			const { unit, n } = (0, _deepseek_ai_dsh_client_ui_primitives.relativeTime)(updatedAt, now);
 			return unit === "now" ? t("time.now") : t(`time.${unit}`, { n });
 		}
-		/** host 错误码 → 可读文案；没有码时保留原文。 */
 		function failureText(error, t) {
 			const code = error instanceof ConversationManagerRequestError ? error.code : void 0;
 			if (code === "SESSION_NOT_ARCHIVED") return t("failure.notArchived");
@@ -868,7 +843,6 @@ window.__ModuleLoader__.load({
 				]
 			});
 		}
-		/** 时间范围选项：默认本日，其后是本周（周一起算）与最近 N 天，「全部」放在最后。 */
 		const USAGE_RANGES = [
 			"day",
 			"week",
@@ -877,7 +851,6 @@ window.__ModuleLoader__.load({
 			"90d",
 			"all"
 		];
-		/** 范围按钮的文案。 */
 		function rangeLabel(range, t) {
 			switch (range) {
 				case "all": return t("usage.range.all");
@@ -888,17 +861,11 @@ window.__ModuleLoader__.load({
 				case "90d": return t("usage.range.days", { n: 90 });
 			}
 		}
-		/** 缓存命中率（百分点）：缓存输入占总输入（含缓存）的比例。 */
 		function cacheHitPercent(totals) {
 			const total = totals.inputTokens + totals.cacheReadTokens;
 			if (total <= 0) return 0;
 			return totals.cacheReadTokens / total * 100;
 		}
-		/**
-		* 显示口径的单项：输入（含缓存输入）、缓存输入、缓存命中率、输出、推理，
-		* 以及活动计数（轮次 / 步骤 / 用户输入 / 工具调用）——没有合计项。
-		* 活动计数在按模型的行上不显示（事件没有模型归属，见 `withActivity`）。
-		*/
 		function usageMetrics(totals, t, options = {}) {
 			return [
 				{
@@ -959,7 +926,6 @@ window.__ModuleLoader__.load({
 				]
 			];
 		}
-		/** 折叠行的排序口径（不显示）：输入（含缓存）+ 输出。 */
 		function sortWeight(totals) {
 			return totals.inputTokens + totals.cacheReadTokens + totals.outputTokens;
 		}
@@ -976,7 +942,6 @@ window.__ModuleLoader__.load({
 				totalTokens: 0
 			};
 		}
-		/** 把桶按一个键折叠成行并按用量降序（按天 / 按模型都用它）。 */
 		function foldBuckets(buckets, keyOf) {
 			const folded = /* @__PURE__ */ new Map();
 			for (const bucket of buckets) {
@@ -995,7 +960,6 @@ window.__ModuleLoader__.load({
 			}
 			return [...folded.values()].sort((left, right) => sortWeight(right.totals) - sortWeight(left.totals));
 		}
-		/** 一行用量：label 在上，下面是横向排布的单项。 */
 		function UsageRow({ rowKey, label, totals, t, withActivity = true }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("li", {
 				..._morlay_dsh_client_ui_primitives_client.styling.props(styles.usageRow),
@@ -1037,7 +1001,6 @@ window.__ModuleLoader__.load({
 				}, row.key))
 			});
 		}
-		/** 总览：全部与「其中子代理」两行，与列表行同形。 */
 		function UsageOverview({ report, t }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("ul", {
 				..._morlay_dsh_client_ui_primitives_client.styling.props(styles.usageList),
@@ -1054,7 +1017,6 @@ window.__ModuleLoader__.load({
 				})]
 			});
 		}
-		/** 统计视图：时间范围过滤 + 二层维度切换（总览 / 按模型 / 按会话）。 */
 		function UsageView({ report, loading, error, tab, onTab, range, onRange, t }) {
 			const items = [
 				"overview",
@@ -1136,8 +1098,6 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/locales.ts
-		/** 「对话管理」页面的文案字典。 */
-		/** 简体中文是 key 真源。 */
 		const zh = {
 			panel: "对话管理",
 			title: "对话管理",
@@ -1212,7 +1172,6 @@ window.__ModuleLoader__.load({
 			"time.months": "{n}个月",
 			"time.years": "{n}年"
 		};
-		/** 英文对照表。 */
 		const en = {
 			panel: "Conversations",
 			title: "Conversations",
@@ -1289,13 +1248,9 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region src/client/index.ts
-		/** 本包字典的 namespace。 */
 		const NS = "conversationManager";
-		/** nav 行与主面板共用的 id。 */
 		const PANEL_ID = "conversations";
-		/** nav 行的位置：紧邻官方 Plugins 行（order 0）。 */
 		const PANEL_ORDER = 1;
-		/** 页面用到的服务。 */
 		const inject = [
 			"slots",
 			"locale",

package/dist/client.d.cts

@@ -3,8 +3,6 @@ import { MainPanelId } from "@deepseek-ai/dsh-client-ui-layout/client";
 import { InjectFace, PropsLocale, PropsRuntime } from "@deepseek-ai/dsh-client-ui-slots";
 import "react";
 //#region src/client/locales.d.ts
-/** 「对话管理」页面的文案字典。 */
-/** 简体中文是 key 真源。 */
 declare const zh: {
   panel: string;
   title: string;
@@ -79,7 +77,6 @@ declare const zh: {
   "time.months": string;
   "time.years": string;
 };
-/** 「对话管理」页面字典的 key 集合。 */
 type ConversationManagerKey = keyof typeof zh;
 //#endregion
 //#region ../../../vendor/deepseek-harness/packages/core/scope/lib/types/index.d.ts
@@ -3196,7 +3193,6 @@ declare class SessionStore extends Service {
 }
 //#endregion
 //#region src/client/controller.d.ts
-/** 一行会话：标题、origin、最后活动时间、归档标记与工作区归属都由 host 给出。 */
 interface SessionRowRecord {
   sessionId: string;
   title: string | null;
@@ -3207,7 +3203,6 @@ interface SessionRowRecord {
   archived: boolean;
   workspace: string | null;
 }
-/** 列表请求：搜索、子代理过滤与分页都在后端做（前端分页等于每次拉全量）。 */
 interface SessionRowsQuery {
   query?: string;
   includeSubagents?: boolean;
@@ -3216,24 +3211,17 @@ interface SessionRowsQuery {
 }
 interface SessionRowsPage {
   items: SessionRowRecord[];
-  /** 过滤后的总数（分页前），页面据此算页数。 */
   total: number;
   page: number;
   pageSize: number;
 }
-/**
- * 时间范围的语义键（与 session-rdb `./usage` 的 `UsageRangeKey` 镜像）：`day` / `week` 是本地自然日 /
- * 自然周，`7d` / `30d` / `90d` 是最近 N 个自然日（含今天）——边界由 host 按本地时区算，客户端只传语义。
- */
 type UsageRangeKey = "all" | "day" | "week" | "7d" | "30d" | "90d";
-/** 活动计数（与 session-rdb `./usage` 的回报结构镜像）：轮次 / 步骤 / 用户输入 / 工具调用。 */
 interface UsageActivityTotals {
   turns: number;
   steps: number;
   userInputs: number;
   toolCalls: number;
 }
-/** 一段用量合计：token 用量 + 活动计数。 */
 interface UsageTotals extends UsageActivityTotals {
   inputTokens: number;
   outputTokens: number;
@@ -3241,7 +3229,6 @@ interface UsageTotals extends UsageActivityTotals {
   reasoningTokens: number;
   totalTokens: number;
 }
-/** 一天 × 一个模型 × 是否子代理 的用量桶：活动计数没有模型归属，只有 token 用量。 */
 interface UsageBucket {
   day: string;
   provider: string | null;
@@ -3253,37 +3240,30 @@ interface UsageBucket {
   reasoningTokens: number;
   totalTokens: number;
 }
-/** 一条会话的用量行。 */
 interface UsageSessionRow extends UsageTotals {
   sessionId: string;
   title: string | null;
   subagent: boolean;
   archived: boolean;
 }
-/** 一次统计请求的回报：总览 + subagent 拆分 + 桶 + 会话行。 */
 interface SessionUsageReport {
   totals: UsageTotals;
   subagent: UsageTotals;
-  /** 只被人类会话引用的部分。 */
   human: UsageTotals;
   buckets: UsageBucket[];
   sessions: UsageSessionRow[];
 }
-/** 页面之外的服务面：归档状态与列表刷新都归它们的既有 owner。 */
 interface ConversationManagerPorts {
   archiveSession(sessionId: SessionId): Promise<void>;
   unarchiveSession(sessionId: SessionId): Promise<void>;
   refresh(): Promise<void>;
 }
-/** GC 一次执行的回报。 */
 interface ConversationManagerGcResult {
   orphanSessions: number;
   orphanEvents: number;
   stoppedAgents: number;
 }
-/** 页面从注入面拿到的动作（属性语法：页面解构后直接调用，不绑 this）。 */
 interface ConversationManagerFace {
-  /** 管理面自己的列表：完整语料（含归档），标题与最后活动时间随行给出；搜索与分页都在后端。 */
   listRows: (query?: SessionRowsQuery) => Promise<SessionRowsPage>;
   archive: (sessionId: SessionId) => Promise<void>;
   unarchive: (sessionId: SessionId) => Promise<void>;
@@ -3293,12 +3273,10 @@ interface ConversationManagerFace {
   collectGarbage: () => Promise<ConversationManagerGcResult>;
   loadUsage: (range: UsageRangeKey) => Promise<SessionUsageReport>;
 }
-/** 带 host 错误码的请求失败：页面据此选本地化文案。 */
 declare class ConversationManagerRequestError extends Error {
   readonly code: string | undefined;
   constructor(message: string, code: string | undefined);
 }
-/** 页面的动作：host 交互收在这里，页面只见数据与回调。 */
 declare class ConversationManagerController {
   private readonly ports;
   readonly face: ConversationManagerFace;
@@ -3308,19 +3286,13 @@ declare class ConversationManagerController {
   private exportZip;
   private importZip;
   private collectGarbage;
-  /**
-   * 用量统计：host 侧聚合，前端各维度本地折叠。
-   * @param range - 时间范围语义键（`all` 不限、`day`/`week` 自然日/周、其余最近 N 天）。
-   */
   private loadUsage;
 }
 //#endregion
 //#region src/client/ConversationManagerIcon.d.ts
-/** nav 图标只画字形：尺寸由 nav 行给，选中态由 nav 行的按钮承担。 */
 type ConversationManagerIconProps = PropsRuntime<"sidebar.panellist">;
 //#endregion
 //#region src/client/ConversationManagerPage.d.ts
-/** 页面 props：main 座位的运行时份额 + 本包字典 + 注入的动作。 */
 type ConversationManagerPageProps = PropsRuntime<"main"> & PropsLocale<"conversationManager"> & InjectFace<ConversationManagerFace>;
 //#endregion
 //#region src/client/index.d.ts
@@ -3329,13 +3301,9 @@ declare module "@deepseek-ai/dsh-client-ui-slots" {
     conversationManager: ConversationManagerKey;
   }
 }
-/** 本包字典的 namespace。 */
 declare const NS = "conversationManager";
-/** nav 行与主面板共用的 id。 */
 declare const PANEL_ID: MainPanelId;
-/** nav 行的位置：紧邻官方 Plugins 行（order 0）。 */
 declare const PANEL_ORDER = 1;
-/** 页面用到的服务。 */
 declare const inject: string[];
 declare function apply(ctx: Context): void;
 //#endregion

package/dist/client.d.mts

@@ -3,8 +3,6 @@ import { Context, Service } from "@deepseek-ai/cordis";
 import { MainPanelId } from "@deepseek-ai/dsh-client-ui-layout/client";
 import { InjectFace, PropsLocale, PropsRuntime } from "@deepseek-ai/dsh-client-ui-slots";
 //#region src/client/locales.d.ts
-/** 「对话管理」页面的文案字典。 */
-/** 简体中文是 key 真源。 */
 declare const zh: {
   panel: string;
   title: string;
@@ -79,7 +77,6 @@ declare const zh: {
   "time.months": string;
   "time.years": string;
 };
-/** 「对话管理」页面字典的 key 集合。 */
 type ConversationManagerKey = keyof typeof zh;
 //#endregion
 //#region ../../../vendor/deepseek-harness/packages/core/scope/lib/types/index.d.ts
@@ -3196,7 +3193,6 @@ declare class SessionStore extends Service {
 }
 //#endregion
 //#region src/client/controller.d.ts
-/** 一行会话：标题、origin、最后活动时间、归档标记与工作区归属都由 host 给出。 */
 interface SessionRowRecord {
   sessionId: string;
   title: string | null;
@@ -3207,7 +3203,6 @@ interface SessionRowRecord {
   archived: boolean;
   workspace: string | null;
 }
-/** 列表请求：搜索、子代理过滤与分页都在后端做（前端分页等于每次拉全量）。 */
 interface SessionRowsQuery {
   query?: string;
   includeSubagents?: boolean;
@@ -3216,24 +3211,17 @@ interface SessionRowsQuery {
 }
 interface SessionRowsPage {
   items: SessionRowRecord[];
-  /** 过滤后的总数（分页前），页面据此算页数。 */
   total: number;
   page: number;
   pageSize: number;
 }
-/**
- * 时间范围的语义键（与 session-rdb `./usage` 的 `UsageRangeKey` 镜像）：`day` / `week` 是本地自然日 /
- * 自然周，`7d` / `30d` / `90d` 是最近 N 个自然日（含今天）——边界由 host 按本地时区算，客户端只传语义。
- */
 type UsageRangeKey = "all" | "day" | "week" | "7d" | "30d" | "90d";
-/** 活动计数（与 session-rdb `./usage` 的回报结构镜像）：轮次 / 步骤 / 用户输入 / 工具调用。 */
 interface UsageActivityTotals {
   turns: number;
   steps: number;
   userInputs: number;
   toolCalls: number;
 }
-/** 一段用量合计：token 用量 + 活动计数。 */
 interface UsageTotals extends UsageActivityTotals {
   inputTokens: number;
   outputTokens: number;
@@ -3241,7 +3229,6 @@ interface UsageTotals extends UsageActivityTotals {
   reasoningTokens: number;
   totalTokens: number;
 }
-/** 一天 × 一个模型 × 是否子代理 的用量桶：活动计数没有模型归属，只有 token 用量。 */
 interface UsageBucket {
   day: string;
   provider: string | null;
@@ -3253,37 +3240,30 @@ interface UsageBucket {
   reasoningTokens: number;
   totalTokens: number;
 }
-/** 一条会话的用量行。 */
 interface UsageSessionRow extends UsageTotals {
   sessionId: string;
   title: string | null;
   subagent: boolean;
   archived: boolean;
 }
-/** 一次统计请求的回报：总览 + subagent 拆分 + 桶 + 会话行。 */
 interface SessionUsageReport {
   totals: UsageTotals;
   subagent: UsageTotals;
-  /** 只被人类会话引用的部分。 */
   human: UsageTotals;
   buckets: UsageBucket[];
   sessions: UsageSessionRow[];
 }
-/** 页面之外的服务面：归档状态与列表刷新都归它们的既有 owner。 */
 interface ConversationManagerPorts {
   archiveSession(sessionId: SessionId): Promise<void>;
   unarchiveSession(sessionId: SessionId): Promise<void>;
   refresh(): Promise<void>;
 }
-/** GC 一次执行的回报。 */
 interface ConversationManagerGcResult {
   orphanSessions: number;
   orphanEvents: number;
   stoppedAgents: number;
 }
-/** 页面从注入面拿到的动作（属性语法：页面解构后直接调用，不绑 this）。 */
 interface ConversationManagerFace {
-  /** 管理面自己的列表：完整语料（含归档），标题与最后活动时间随行给出；搜索与分页都在后端。 */
   listRows: (query?: SessionRowsQuery) => Promise<SessionRowsPage>;
   archive: (sessionId: SessionId) => Promise<void>;
   unarchive: (sessionId: SessionId) => Promise<void>;
@@ -3293,12 +3273,10 @@ interface ConversationManagerFace {
   collectGarbage: () => Promise<ConversationManagerGcResult>;
   loadUsage: (range: UsageRangeKey) => Promise<SessionUsageReport>;
 }
-/** 带 host 错误码的请求失败：页面据此选本地化文案。 */
 declare class ConversationManagerRequestError extends Error {
   readonly code: string | undefined;
   constructor(message: string, code: string | undefined);
 }
-/** 页面的动作：host 交互收在这里，页面只见数据与回调。 */
 declare class ConversationManagerController {
   private readonly ports;
   readonly face: ConversationManagerFace;
@@ -3308,19 +3286,13 @@ declare class ConversationManagerController {
   private exportZip;
   private importZip;
   private collectGarbage;
-  /**
-   * 用量统计：host 侧聚合，前端各维度本地折叠。
-   * @param range - 时间范围语义键（`all` 不限、`day`/`week` 自然日/周、其余最近 N 天）。
-   */
   private loadUsage;
 }
 //#endregion
 //#region src/client/ConversationManagerIcon.d.ts
-/** nav 图标只画字形：尺寸由 nav 行给，选中态由 nav 行的按钮承担。 */
 type ConversationManagerIconProps = PropsRuntime<"sidebar.panellist">;
 //#endregion
 //#region src/client/ConversationManagerPage.d.ts
-/** 页面 props：main 座位的运行时份额 + 本包字典 + 注入的动作。 */
 type ConversationManagerPageProps = PropsRuntime<"main"> & PropsLocale<"conversationManager"> & InjectFace<ConversationManagerFace>;
 //#endregion
 //#region src/client/index.d.ts
@@ -3329,13 +3301,9 @@ declare module "@deepseek-ai/dsh-client-ui-slots" {
     conversationManager: ConversationManagerKey;
   }
 }
-/** 本包字典的 namespace。 */
 declare const NS = "conversationManager";
-/** nav 行与主面板共用的 id。 */
 declare const PANEL_ID: MainPanelId;
-/** nav 行的位置：紧邻官方 Plugins 行（order 0）。 */
 declare const PANEL_ORDER = 1;
-/** 页面用到的服务。 */
 declare const inject: string[];
 declare function apply(ctx: Context): void;
 //#endregion

package/dist/index.d.cts

@@ -1,5 +1,4 @@
 //#region src/index.d.ts
-/** 「对话管理」页面的 host 半：没有 host 面（页面只读已有服务与路由）。 */
 declare function apply(): void;
 //#endregion
 export { apply };

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 //#region src/index.d.ts
-/** 「对话管理」页面的 host 半：没有 host 面（页面只读已有服务与路由）。 */
 declare function apply(): void;
 //#endregion
 export { apply };

package/dist/index.mjs

@@ -1,5 +1,4 @@
 //#region src/index.ts
-/** 「对话管理」页面的 host 半：没有 host 面（页面只读已有服务与路由）。 */
 function apply() {}
 //#endregion
 export { apply };

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Conversation Manager",
-    "description": "Full-page conversation management panel (browser half): search across sessions, unarchive, delete and import as a new session."
+    "description": "Full-page conversation management panel (browser half): two tab levels over sessions and usage — search, paging, archive / unarchive / export / delete, import as a new session and orphan-data GC in the session view, token usage across all conversations in the usage view."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "对话管理页",
-    "description": "「对话管理」全局面板页（浏览器半）：会话（含已归档）的搜索、取消归档、删除与导入为新会话。"
+    "description": "「对话管理」全局面板页（浏览器半）：会话与统计两层 Tabs——会话视图给出全量会话（含已归档）的搜索、分页、归档 / 取消归档 / 导出 / 删除、导入为新会话与孤儿数据 GC，统计视图给出全部对话的 token 用量。"
   }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@morlay/ui-conversation-manager",
-  "version": "0.1.0",
-  "description": "「对话管理」全局面板页（浏览器半）：会话（含已归档）的搜索、取消归档、删除，以及导入为新会话。",
+  "version": "0.1.2",
+  "description": "「对话管理」全局面板页（浏览器半）：会话与统计两层 Tabs——会话视图给出全量会话（含已归档）的搜索、分页、归档 / 取消归档 / 导出 / 删除、导入为新会话与孤儿数据 GC，统计视图给出全部对话的 token 用量。",
   "keywords": [
     "archived-sessions",
     "conversation-manager",
@@ -40,17 +40,17 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-layout": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-workspace": "^0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.7-rc.2",
-    "@morlay/dsh-client-ui-primitives": "0.0.3"
+    "@deepseek-ai/dsh-api-session-controller": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-session": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-sidebar": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-workspace": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-session": "^0.2.0-rc.1",
+    "@morlay/dsh-client-ui-primitives": "0.0.5"
   },
   "dsh": {
     "client": {

package/src/client/ConversationManagerIcon.tsx

@@ -1,7 +1,7 @@
 import { IconArchiveOutlineRegular } from "@deepseek-ai/dsh-client-ui-primitives";
 import type { PropsRuntime } from "@deepseek-ai/dsh-client-ui-slots";
 
-/** nav 图标只画字形：尺寸由 nav 行给，选中态由 nav 行的按钮承担。 */
+// nav 图标只画字形：尺寸由 nav 行给，选中态由 nav 行的按钮承担。
 export type ConversationManagerIconProps = PropsRuntime<"sidebar.panellist">;
 
 export function ConversationManagerIcon({ size }: ConversationManagerIconProps) {

package/src/client/ConversationManagerPage.styles.ts

@@ -5,10 +5,9 @@ const spin = styling.keyframes({
   to: { transform: "rotate(360deg)" },
 });
 
-/** 「对话管理」页面的样式表（官方 --dsw-* 变量 + 我们的 css-in-js 层）。
- * 页面根是纵向 flex 且**自己不滚**：页头（标题 / tab 条 / 导入 / 清理）与搜索行固定在顶部，
- * 只有 `scroll` 那层随内容滚。除滚动层外的项都 `flex: none`，否则内容变长时 flex 会把这些项
- * 压到 min-content（官方 Input 的 32px 高会被压成一行文字高）。 */
+// 「对话管理」页面的样式表（官方 --dsw-* 变量 + 我们的 css-in-js 层）：页面根是纵向 flex 且**自己不滚**，
+// 页头（标题 / tab 条 / 导入 / 清理）与搜索行固定在顶部，只有 `scroll` 那层随内容滚；除滚动层外的项都
+// `flex: none`，否则内容变长时会被压到 min-content（官方 Input 的 32px 高会被压成一行文字高）。
 export const styles = {
   page: {
     display: "flex",

package/src/client/ConversationManagerPage.tsx

@@ -26,41 +26,41 @@ import {
 import { formatCount, formatPercent, formatTokens } from "./format.ts";
 import { styles } from "./ConversationManagerPage.styles.ts";
 
-/** 一页的行数（会话列表）。 */
+// 一页的行数（会话列表）。
 const PAGE_SIZE = 20;
 
-/** 统计视图按会话列出时的行数上限。 */
+// 统计视图按会话列出时的行数上限。
 const USAGE_SESSION_ROWS = 20;
 
-/** 页面 props：main 座位的运行时份额 + 本包字典 + 注入的动作。 */
+// 页面 props：main 座位的运行时份额 + 本包字典 + 注入的动作。
 export type ConversationManagerPageProps = PropsRuntime<"main"> &
   PropsLocale<"conversationManager"> &
   InjectFace<ConversationManagerFace>;
 
 type Translate = ConversationManagerPageProps["t"];
 
-/** GC 的三段状态：确认 → 运行（阻塞界面）→ 收尾。 */
+// GC 的三段状态：确认 → 运行（阻塞界面）→ 收尾。
 type GcPhase = "idle" | "confirm" | "running";
 
 interface ConversationRow {
   id: SessionId;
   title: string;
-  /** 所属工作区标题；不在任何工作区里的会话用未分组文案。 */
+  // 所属工作区标题；不在任何工作区里的会话用未分组文案。
   workspace: string;
-  /** 只有已归档的行允许取消归档与删除（host 侧同样守卫）。 */
+  // 只有已归档的行允许取消归档与删除（host 侧同样守卫）。
   archived: boolean;
-  /** 子代理派生会话：默认不显示（既不可删也不可取消归档）。 */
+  // 子代理派生会话：默认不显示（既不可删也不可取消归档）。
   subagent: boolean;
   updatedAt: number;
 }
 
-/** 行上显示的紧凑相对时间。 */
+// 行上显示的紧凑相对时间。
 function timeLabel(updatedAt: number, now: number, t: Translate): string {
   const { unit, n } = relativeTime(updatedAt, now);
   return unit === "now" ? t("time.now") : t(`time.${unit}`, { n });
 }
 
-/** host 错误码 → 可读文案；没有码时保留原文。 */
+// host 错误码 → 可读文案；没有码时保留原文。
 function failureText(error: unknown, t: Translate): string {
   const code = error instanceof ConversationManagerRequestError ? error.code : undefined;
   if (code === "SESSION_NOT_ARCHIVED") return t("failure.notArchived");
@@ -538,18 +538,18 @@ export function ConversationManagerPage({
   );
 }
 
-/** 一层视图：会话列表 / 用量统计。 */
+// 一层视图：会话列表 / 用量统计。
 type PageView = "sessions" | "usage";
 
-/** 统计视图的二层维度（时间范围取代了原来的「按天」）。 */
+// 统计视图的二层维度。
 type UsageTab = "overview" | "models" | "sessions";
 
-/** 时间范围选项：默认本日，其后是本周（周一起算）与最近 N 天，「全部」放在最后。 */
+// 时间范围选项：默认本日，其后是本周（周一起算）与最近 N 天，「全部」放在最后。
 const USAGE_RANGES: readonly UsageRange[] = ["day", "week", "7d", "30d", "90d", "all"];
 
 type UsageRange = UsageRangeKey;
 
-/** 范围按钮的文案。 */
+// 范围按钮的文案。
 function rangeLabel(range: UsageRange, t: Translate): string {
   switch (range) {
     case "all":
@@ -567,27 +567,25 @@ function rangeLabel(range: UsageRange, t: Translate): string {
   }
 }
 
-/** 一个用量单项：标签在上、值在下；单项之间横向排布。 */
+// 一个用量单项：标签在上、值在下；单项之间横向排布。
 interface UsageMetric {
   key: string;
   label: string;
-  /** 原始值：token 数、计数，或百分点（`percent` 项）。 */
+  // 原始值：token 数、计数，或百分点（`percent` 项）。
   value: number;
   kind: "tokens" | "count" | "percent";
 }
 
-/** 缓存命中率（百分点）：缓存输入占总输入（含缓存）的比例。 */
+// 缓存命中率（百分点）：缓存输入占总输入（含缓存）的比例。
 function cacheHitPercent(totals: UsageTotals): number {
   const total = totals.inputTokens + totals.cacheReadTokens;
   if (total <= 0) return 0;
   return (totals.cacheReadTokens / total) * 100;
 }
 
-/**
- * 显示口径的单项：输入（含缓存输入）、缓存输入、缓存命中率、输出、推理，
- * 以及活动计数（轮次 / 步骤 / 用户输入 / 工具调用）——没有合计项。
- * 活动计数在按模型的行上不显示（事件没有模型归属，见 `withActivity`）。
- */
+// 显示口径的单项：输入（含缓存输入）、缓存输入、缓存命中率、输出、推理，
+// 以及活动计数（轮次 / 步骤 / 用户输入 / 工具调用）——没有合计项。
+// 活动计数在按模型的行上不显示（事件没有模型归属，见 `withActivity`）。
 function usageMetrics(
   totals: UsageTotals,
   t: Translate,
@@ -640,7 +638,7 @@ function usageMetrics(
   ];
 }
 
-/** 折叠行的排序口径（不显示）：输入（含缓存）+ 输出。 */
+// 折叠行的排序口径（不显示）：输入（含缓存）+ 输出。
 function sortWeight(totals: UsageTotals): number {
   return totals.inputTokens + totals.cacheReadTokens + totals.outputTokens;
 }
@@ -665,7 +663,7 @@ function emptyTotals(): UsageTotals {
   };
 }
 
-/** 把桶按一个键折叠成行并按用量降序（按天 / 按模型都用它）。 */
+// 把桶按一个键折叠成行并按用量降序（按天 / 按模型都用它）。
 function foldBuckets(
   buckets: readonly UsageBucket[],
   keyOf: (bucket: UsageBucket) => string,
@@ -686,7 +684,7 @@ function foldBuckets(
   );
 }
 
-/** 一行用量：label 在上，下面是横向排布的单项。 */
+// 一行用量：label 在上，下面是横向排布的单项。
 function UsageRow({
   rowKey,
   label,
@@ -758,7 +756,7 @@ function UsageList({
   );
 }
 
-/** 总览：全部与「其中子代理」两行，与列表行同形。 */
+// 总览：全部与「其中子代理」两行，与列表行同形。
 function UsageOverview({ report, t }: { report: SessionUsageReport; t: Translate }): ReactNode {
   return (
     <ul {...styling.props(styles.usageList)}>
@@ -768,7 +766,7 @@ function UsageOverview({ report, t }: { report: SessionUsageReport; t: Translate
   );
 }
 
-/** 统计视图：时间范围过滤 + 二层维度切换（总览 / 按模型 / 按会话）。 */
+// 统计视图：时间范围过滤 + 二层维度切换（总览 / 按模型 / 按会话）。
 function UsageView({
   report,
   loading,

package/src/client/controller.ts

@@ -1,19 +1,17 @@
 import type { SessionId } from "@deepseek-ai/dsh-session";
 
-/** host 侧已存在的会话路由。 */
-export const SESSION_DELETE_PATH = "/api/session.delete";
-export const SESSION_IMPORT_PATH = "/api/session.import";
-export const SESSION_EXPORT_PATH = "/api/session.export";
-export const SESSION_GC_PATH = "/api/session.gc";
-export const SESSION_USAGE_PATH = "/api/session.usage";
+// host 侧的会话管理面路由：路径的 home 是 `@morlay/session-rdb` 的 `src/routes.ts`，改前缀要两边同步。
+export const SESSION_DELETE_PATH = "/api/morlay/v1/session/delete";
+export const SESSION_IMPORT_PATH = "/api/morlay/v1/session/import";
+export const SESSION_EXPORT_PATH = "/api/morlay/v1/session/export";
+export const SESSION_GC_PATH = "/api/morlay/v1/session/gc";
+export const SESSION_USAGE_PATH = "/api/morlay/v1/session/usage";
 
-/**
- * 管理面的会话行（**完整语料，含归档**）：我们自己的路由，与官方 `session/list` 分开——那条按部署策略
- * 默认排除归档（给上游 UI 用），归档集的管理动作需要完整集合。
- */
-export const SESSION_ROWS_PATH = "/api/session.rows";
+// 管理面的会话行（**完整语料，含归档**）：我们自己的路由，与官方 `session/list` 分开——那条按部署策略
+// 默认排除归档（给上游 UI 用），归档集的管理动作需要完整集合。
+export const SESSION_ROWS_PATH = "/api/morlay/v1/session/rows";
 
-/** 一行会话：标题、origin、最后活动时间、归档标记与工作区归属都由 host 给出。 */
+// 一行会话：标题、origin、最后活动时间、归档标记与工作区归属都由 host 给出。
 export interface SessionRowRecord {
   sessionId: string;
   title: string | null;
@@ -25,7 +23,7 @@ export interface SessionRowRecord {
   workspace: string | null;
 }
 
-/** 列表请求：搜索、子代理过滤与分页都在后端做（前端分页等于每次拉全量）。 */
+// 列表请求：搜索、子代理过滤与分页都在后端做（前端分页等于每次拉全量）。
 export interface SessionRowsQuery {
   query?: string;
   includeSubagents?: boolean;
@@ -35,19 +33,17 @@ export interface SessionRowsQuery {
 
 export interface SessionRowsPage {
   items: SessionRowRecord[];
-  /** 过滤后的总数（分页前），页面据此算页数。 */
+  // 过滤后的总数（分页前），页面据此算页数。
   total: number;
   page: number;
   pageSize: number;
 }
 
-/**
- * 时间范围的语义键（与 session-rdb `./usage` 的 `UsageRangeKey` 镜像）：`day` / `week` 是本地自然日 /
- * 自然周，`7d` / `30d` / `90d` 是最近 N 个自然日（含今天）——边界由 host 按本地时区算，客户端只传语义。
- */
+// 时间范围的语义键（与 session-rdb `./usage` 的 `UsageRangeKey` 镜像）：`day` / `week` 是本地自然日 /
+// 自然周，`7d` / `30d` / `90d` 是最近 N 个自然日（含今天）——边界由 host 按本地时区算，客户端只传语义。
 export type UsageRangeKey = "all" | "day" | "week" | "7d" | "30d" | "90d";
 
-/** 活动计数（与 session-rdb `./usage` 的回报结构镜像）：轮次 / 步骤 / 用户输入 / 工具调用。 */
+// 活动计数（与 session-rdb `./usage` 的回报结构镜像）：轮次 / 步骤 / 用户输入 / 工具调用。
 export interface UsageActivityTotals {
   turns: number;
   steps: number;
@@ -55,7 +51,7 @@ export interface UsageActivityTotals {
   toolCalls: number;
 }
 
-/** 一段用量合计：token 用量 + 活动计数。 */
+// 一段用量合计：token 用量 + 活动计数。
 export interface UsageTotals extends UsageActivityTotals {
   inputTokens: number;
   outputTokens: number;
@@ -64,7 +60,7 @@ export interface UsageTotals extends UsageActivityTotals {
   totalTokens: number;
 }
 
-/** 一天 × 一个模型 × 是否子代理 的用量桶：活动计数没有模型归属，只有 token 用量。 */
+// 一天 × 一个模型 × 是否子代理 的用量桶：活动计数没有模型归属，只有 token 用量。
 export interface UsageBucket {
   day: string;
   provider: string | null;
@@ -77,7 +73,7 @@ export interface UsageBucket {
   totalTokens: number;
 }
 
-/** 一条会话的用量行。 */
+// 一条会话的用量行。
 export interface UsageSessionRow extends UsageTotals {
   sessionId: string;
   title: string | null;
@@ -85,33 +81,33 @@ export interface UsageSessionRow extends UsageTotals {
   archived: boolean;
 }
 
-/** 一次统计请求的回报：总览 + subagent 拆分 + 桶 + 会话行。 */
+// 一次统计请求的回报：总览 + subagent 拆分 + 桶 + 会话行。
 export interface SessionUsageReport {
   totals: UsageTotals;
   subagent: UsageTotals;
-  /** 只被人类会话引用的部分。 */
+  // 只被人类会话引用的部分。
   human: UsageTotals;
   buckets: UsageBucket[];
   sessions: UsageSessionRow[];
 }
 
-/** 页面之外的服务面：归档状态与列表刷新都归它们的既有 owner。 */
+// 页面之外的服务面：归档状态与列表刷新都归它们的既有 owner。
 export interface ConversationManagerPorts {
   archiveSession(sessionId: SessionId): Promise<void>;
   unarchiveSession(sessionId: SessionId): Promise<void>;
   refresh(): Promise<void>;
 }
 
-/** GC 一次执行的回报。 */
+// GC 一次执行的回报。
 export interface ConversationManagerGcResult {
   orphanSessions: number;
   orphanEvents: number;
   stoppedAgents: number;
 }
 
-/** 页面从注入面拿到的动作（属性语法：页面解构后直接调用，不绑 this）。 */
+// 页面从注入面拿到的动作（属性语法：页面解构后直接调用，不绑 this）。
 export interface ConversationManagerFace {
-  /** 管理面自己的列表：完整语料（含归档），标题与最后活动时间随行给出；搜索与分页都在后端。 */
+  // 管理面自己的列表：完整语料（含归档），标题与最后活动时间随行给出；搜索与分页都在后端。
   listRows: (query?: SessionRowsQuery) => Promise<SessionRowsPage>;
   archive: (sessionId: SessionId) => Promise<void>;
   unarchive: (sessionId: SessionId) => Promise<void>;
@@ -122,7 +118,7 @@ export interface ConversationManagerFace {
   loadUsage: (range: UsageRangeKey) => Promise<SessionUsageReport>;
 }
 
-/** 带 host 错误码的请求失败：页面据此选本地化文案。 */
+// 带 host 错误码的请求失败：页面据此选本地化文案。
 export class ConversationManagerRequestError extends Error {
   constructor(
     message: string,
@@ -167,7 +163,7 @@ async function zipBase64(file: File): Promise<string> {
   return comma < 0 ? dataUrl : dataUrl.slice(comma + 1);
 }
 
-/** 页面的动作：host 交互收在这里，页面只见数据与回调。 */
+// 页面的动作：host 交互收在这里，页面只见数据与回调。
 export class ConversationManagerController {
   readonly face: ConversationManagerFace;
 
@@ -242,10 +238,7 @@ export class ConversationManagerController {
     };
   }
 
-  /**
-   * 用量统计：host 侧聚合，前端各维度本地折叠。
-   * @param range - 时间范围语义键（`all` 不限、`day`/`week` 自然日/周、其余最近 N 天）。
-   */
+  // 用量统计：host 侧聚合，前端各维度本地折叠；`range` 是时间范围语义键（`all` / `day` / `week` / 最近 N 天）。
   private async loadUsage(range: UsageRangeKey): Promise<SessionUsageReport> {
     const value = await postJson(SESSION_USAGE_PATH, { range });
     const report = value as unknown as Partial<SessionUsageReport>;
@@ -260,13 +253,13 @@ export class ConversationManagerController {
   }
 }
 
-/** 导出文件名优先取 host 给的 Content-Disposition。 */
+// 导出文件名优先取 host 给的 Content-Disposition。
 function filenameOf(disposition: string | null, sessionId: string): string {
   const matched = disposition === null ? null : /filename="([^"]+)"/u.exec(disposition);
   return matched?.[1] ?? `${sessionId}.zip`;
 }
 
-/** 浏览器下载：blob URL + 一次性 anchor；URL 在下一轮事件循环回收。 */
+// 浏览器下载：blob URL + 一次性 anchor；URL 在下一轮事件循环回收。
 function downloadBlob(blob: Blob, filename: string): void {
   const url = URL.createObjectURL(blob);
   const anchor = document.createElement("a");

package/src/client/format.ts

@@ -1,11 +1,10 @@
 // token 数字的紧凑显示：表格里以总量为主，明细用 K/M/B 压缩。
 
-/** 一位小数；三位数以上不留小数。 */
+// 一位小数；三位数以上不留小数。
 function trim(value: number): string {
   return value >= 100 ? String(Math.round(value)) : value.toFixed(1).replace(/\.0$/u, "");
 }
 
-/** @param value - token 数（非负整数）。 @returns 紧凑文本，例如 `1.2K`、`44.2B`。 */
 export function formatTokens(value: number): string {
   if (!Number.isFinite(value) || value <= 0) return "0";
   if (value < 1_000) return String(Math.round(value));
@@ -14,13 +13,11 @@ export function formatTokens(value: number): string {
   return `${trim(value / 1_000_000_000)}B`;
 }
 
-/** @param value - 计数（轮次 / 步骤 / 用户输入 / 工具调用）。 @returns 千分位原文，例如 `1,024`。 */
 export function formatCount(value: number): string {
   if (!Number.isFinite(value) || value <= 0) return "0";
   return Math.round(value).toLocaleString("en-US");
 }
 
-/** @param value - 百分点（0~100）。 @returns 紧凑百分比，例如 `98.4%`、`100%`。 */
 export function formatPercent(value: number): string {
   if (!Number.isFinite(value) || value <= 0) return "0%";
   const rounded = value >= 100 ? Math.round(value) : Math.round(value * 10) / 10;

package/src/client/index.ts

@@ -26,16 +26,16 @@ declare module "@deepseek-ai/dsh-client-ui-slots" {
   }
 }
 
-/** 本包字典的 namespace。 */
+// 本包字典的 namespace。
 export const NS = "conversationManager";
 
-/** nav 行与主面板共用的 id。 */
+// nav 行与主面板共用的 id。
 export const PANEL_ID = "conversations" as MainPanelId;
 
-/** nav 行的位置：紧邻官方 Plugins 行（order 0）。 */
+// nav 行的位置：紧邻官方 Plugins 行（order 0）。
 export const PANEL_ORDER = 1;
 
-/** 页面用到的服务。 */
+// 页面用到的服务。
 export const inject = ["slots", "locale", "uiWorkspace", "sessions"];
 
 export function apply(ctx: ClientContext): void {

package/src/client/locales.ts

@@ -1,6 +1,6 @@
-/** 「对话管理」页面的文案字典。 */
+// 「对话管理」页面的文案字典。
 
-/** 简体中文是 key 真源。 */
+// 简体中文是 key 真源。
 export const zh = {
   panel: "对话管理",
   title: "对话管理",
@@ -77,10 +77,10 @@ export const zh = {
   "time.years": "{n}年",
 } satisfies Record<string, string>;
 
-/** 「对话管理」页面字典的 key 集合。 */
+// 「对话管理」页面字典的 key 集合。
 export type ConversationManagerKey = keyof typeof zh;
 
-/** 英文对照表。 */
+// 英文对照表。
 export const en = {
   panel: "Conversations",
   title: "Conversations",

package/src/index.ts

@@ -1,2 +1,2 @@
-/** 「对话管理」页面的 host 半：没有 host 面（页面只读已有服务与路由）。 */
+// 「对话管理」页面的 host 半：没有 host 面（页面只读已有服务与路由）。
 export function apply(): void {}