From ae5c5c8374ada3ddaf8834275e3903901847073d Mon Sep 17 00:00:00 2001
From: techflag <562635045@qq.com>
Date: Sun, 4 Oct 2026 20:06:33 +0800
Subject: [PATCH 1/2] feat(library): import and reference CSV and XLSX through
 Office

---
 .github/workflows/ci.yml                      |  3 ++
 apps/web/pnpm-lock.yaml                       |  3 ++
 apps/web/scripts/build-office.mjs             |  2 +
 apps/web/scripts/pack-library-release.mjs     |  2 +-
 apps/web/scripts/pack-office-release.mjs      |  2 +-
 packages/contracts/src/library.ts             |  4 +-
 packages/plugins/library/README.md            |  8 +++-
 packages/plugins/library/package.json         |  3 +-
 .../library/src/client/LibraryPanel.tsx       | 10 ++---
 .../src/client/LibraryReferencePage.tsx       |  2 +-
 .../src/client/LibrarySelectionChips.tsx      |  2 +-
 .../library/src/remote/connection-api.ts      |  2 +-
 .../library/src/services/converters.ts        |  6 +++
 .../library/src/services/library-manager.ts   |  4 +-
 .../plugins/library/src/storage/domain.ts     |  2 +-
 .../library/src/tools/library-tools.ts        |  2 +-
 .../plugins/library/tests/library.test.mjs    | 42 +++++++++++++++++
 packages/plugins/office/package.json          |  6 ++-
 .../plugins/office/src/OfficeDocument.tsx     |  2 +
 packages/plugins/office/src/client.tsx        | 25 +++++++++--
 .../plugins/office/src/csv/CsvDocument.tsx    |  2 +-
 packages/plugins/office/src/tabular.d.ts      |  1 +
 packages/plugins/office/src/tabular.js        | 45 +++++++++++++++++++
 23 files changed, 157 insertions(+), 23 deletions(-)
 create mode 100644 packages/plugins/office/src/tabular.d.ts
 create mode 100644 packages/plugins/office/src/tabular.js

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 2d27e5c57a..5834832942 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -144,6 +144,9 @@ jobs:
         run: pnpm exec playwright install --with-deps chromium
       - working-directory: apps/web
         run: pnpm test:integration
+      - name: Library import, search and task reference tests
+        working-directory: apps/web
+        run: node --test ../../packages/plugins/library/tests/*.test.mjs
       - name: Enterprise desktop identity and collaboration tests
         working-directory: apps/web
         run: node --test ../../packages/providers/identity-enterprise/tests/*.test.mjs ../../packages/plugins/enterprise-collaboration/tests/*.test.mjs
diff --git a/apps/web/pnpm-lock.yaml b/apps/web/pnpm-lock.yaml
index 0d3fe0f1a2..46d3a01a1f 100644
--- a/apps/web/pnpm-lock.yaml
+++ b/apps/web/pnpm-lock.yaml
@@ -848,6 +848,9 @@ importers:
       pdfjs-dist:
         specifier: 5.4.624
         version: 5.4.624
+      workdsh-plugin-office:
+        specifier: workspace:*
+        version: link:../office
       zod:
         specifier: 4.4.3
         version: 4.4.3
diff --git a/apps/web/scripts/build-office.mjs b/apps/web/scripts/build-office.mjs
index 3277b93d10..6f31184c64 100644
--- a/apps/web/scripts/build-office.mjs
+++ b/apps/web/scripts/build-office.mjs
@@ -8,6 +8,8 @@ import { fileURLToPath } from "node:url";
 const root = new URL("../../../packages/plugins/office/", import.meta.url);
 const wordOnly = process.argv.includes("--word-only");
 await mkdir(new URL("dist/", root), { recursive: true });
+await build({ entryPoints: [fileURLToPath(new URL("src/tabular.js", root))], bundle: true, platform: "node", format: "esm", target: "node22", external: ["exceljs"], outfile: fileURLToPath(new URL("dist/tabular.js", root)) });
+await writeFile(new URL("dist/tabular.d.ts", root), await readFile(new URL("src/tabular.d.ts", root)));
 const font=await readFile(new URL("src/pdf/fonts/NotoSansSC.ttf",root));
 const fontSource=JSON.parse(await readFile(new URL("src/pdf/fonts/source.json",root),"utf8"));
 if(font.length!==fontSource.bytes||createHash("sha256").update(font).digest("hex")!==fontSource.sha256)throw Error("Bundled PDF font integrity mismatch");
diff --git a/apps/web/scripts/pack-library-release.mjs b/apps/web/scripts/pack-library-release.mjs
index 30b9080cfe..726a35a7ce 100644
--- a/apps/web/scripts/pack-library-release.mjs
+++ b/apps/web/scripts/pack-library-release.mjs
@@ -17,7 +17,7 @@ delete manifest.devDependencies; delete manifest.scripts;
 manifest.workdshRelease = {
   scope: 'local-library-alpha',
   storage: '$DSH_HOME/library',
-  formats: ['md', 'markdown', 'txt', 'html', 'htm', 'pdf', 'docx', 'pptx'],
+  formats: ['md', 'markdown', 'txt', 'html', 'htm', 'pdf', 'docx', 'pptx', 'csv', 'xlsx'],
   preservesOriginals: true,
 };
 await writeFile(join(stage, 'package.json'), `${JSON.stringify(manifest, null, 2)}\n`);
diff --git a/apps/web/scripts/pack-office-release.mjs b/apps/web/scripts/pack-office-release.mjs
index 9c8076d6ef..b874e7a40e 100644
--- a/apps/web/scripts/pack-office-release.mjs
+++ b/apps/web/scripts/pack-office-release.mjs
@@ -21,7 +21,7 @@ const manifest = JSON.parse(await readFile(join(plugin, "package.json"), "utf8")
 delete manifest.devDependencies;
 delete manifest.scripts;
 manifest.description = "Independent Harness plugin: browser Office working copies and native PPTX templates (alpha preview)";
-manifest.workdshRelease = {scope: "office-browser-preview", wordOnly: false, formats: ["docx", "pptx", "xlsx", "pdf", "html"]};
+manifest.workdshRelease = {scope: "office-browser-preview", wordOnly: false, formats: ["docx", "pptx", "xlsx", "csv", "pdf", "html"]};
 await writeFile(join(stage, "package.json"), JSON.stringify(manifest, null, 2) + "\n");
 for (const file of manifest.files) await cp(join(plugin, file), join(stage, file), {recursive: true});
 execFileSync("corepack", ["pnpm", "pack", "--pack-destination", destination], {cwd: stage, stdio: "inherit"});
diff --git a/packages/contracts/src/library.ts b/packages/contracts/src/library.ts
index e417585164..b6b41d3f39 100644
--- a/packages/contracts/src/library.ts
+++ b/packages/contracts/src/library.ts
@@ -1,6 +1,6 @@
 import type { ActorContext, ResourceOwner } from './governance.js';
 
-export type LibraryAssetKind = 'markdown' | 'text' | 'pdf' | 'docx' | 'pptx' | 'html';
+export type LibraryAssetKind = 'markdown' | 'text' | 'pdf' | 'docx' | 'pptx' | 'html' | 'csv' | 'xlsx';
 export type LibraryConversionStatus = 'ready' | 'pending' | 'failed';
 export type LibraryAssetStatus = 'active' | 'disabled';
 
@@ -114,7 +114,7 @@ export interface LibraryDraft {
 
 export interface LibraryOriginalPreviewInput {
   readonly name: string;
-  readonly kind: Extract<LibraryAssetKind, 'docx' | 'pptx'>;
+  readonly kind: Extract<LibraryAssetKind, 'docx' | 'pptx' | 'csv' | 'xlsx'>;
   readonly bytes: Uint8Array;
 }
 
diff --git a/packages/plugins/library/README.md b/packages/plugins/library/README.md
index 6cbd2eee73..468a5deb0b 100644
--- a/packages/plugins/library/README.md
+++ b/packages/plugins/library/README.md
@@ -17,7 +17,7 @@
 
 ## 验收与下一步
 
-完成对应 PLAN 任务及 [验收矩阵](../../../apps/web/docs/ACCEPTANCE.md) 场景，记录真实测试证据后才更新为完成。当前 Host 与 Client 入口可加载，数据保存到 `$DSH_HOME/library`。支持 MD、TXT、HTML、PDF、DOCX、PPTX；所有格式保留原件并生成独立检索文本。HTML 在无 Host 权限、无网络访问的沙箱中按原始样式和内联交互展示；PDF 可直接预览；安装 Office 插件时，Word 使用 `docx-preview`、PowerPoint 使用 `pptx-react-viewer` 打开原件，未安装时回退为派生检索文本和原件下载。Library 与 Office 通过公开可选预览注册表协作，不互相导入运行时内部实现。
+完成对应 PLAN 任务及 [验收矩阵](../../../apps/web/docs/ACCEPTANCE.md) 场景，记录真实测试证据后才更新为完成。当前 Host 与 Client 入口可加载，数据保存到 `$DSH_HOME/library`。支持 MD、TXT、HTML、PDF、DOCX、PPTX、CSV、XLSX；所有格式保留原件并生成独立检索文本。HTML 在无 Host 权限、无网络访问的沙箱中按原始样式和内联交互展示；PDF 可直接预览；安装 Office 插件时，Word 使用 `docx-preview`、PowerPoint 使用 `pptx-react-viewer` 打开原件，未安装时回退为派生检索文本和原件下载。Library 与 Office 通过公开可选预览注册表协作，不互相导入运行时内部实现。
 
 发布包可通过 `corepack pnpm probe:library` 验证独立安装、两次冷启动、卸载保留 `$DSH_HOME/library`、重新安装和资料恢复。页面支持搜索、最近、本地产物、完整目录树、目录内新建与导入、移动、添加到当前任务、停用与重新启用；停用会立即阻断历史任务引用的正文读取。搜索结果显示目录、类型、来源、修订、转换状态和页/段/幻灯片位置。
 
@@ -36,3 +36,9 @@
 ### 可选 Host 成员服务选择
 
 公开 registerLibraryConnection、registerLibraryTools、registerLibraryContextInjection 接受可选可信选择器，返回服务端 actor、LibraryService 和 verify。工具与上下文使用实际 Agent 选择，不从模型参数读取主体；操作前后核验，拒绝不匹配的会话上下文。默认 apply 不传选择器，保持个人行为。企业装配必须提供隔离存储和可撤权身份；这些入口本身不是文件执行沙箱。
+
+## 表格资料
+
+CSV/XLSX 可上传、按类型检索并引用到任务；原始文件按字节保留。Host 转换通过 Office 的公开 `workdsh-plugin-office/tabular` 入口复用 CSV 解码/解析及 ExcelJS。CSV 支持 UTF-8、GB18030、UTF-16，以及逗号、分号和制表符；XLSX 提取工作表名称和单元格已有值，公式不重新计算，图表、图片和格式不进入检索文本。检索文本最多 1500 行/120 列/24000 单元格，XLSX 最多 20 个工作表；截取会显示警告，完整原件仍可下载。
+
+原件预览通过公开可选注册表复用 Office：CSV 为只读表格，XLSX 使用现有隔离编辑器，导出为副本，不覆盖资料库修订。未启用 Office 预览时显示检索文本。个人与企业 Desktop、Web 复用相同导入和预览实现，实际资料授权保持不变。
diff --git a/packages/plugins/library/package.json b/packages/plugins/library/package.json
index 25405a1034..75f8675635 100644
--- a/packages/plugins/library/package.json
+++ b/packages/plugins/library/package.json
@@ -81,7 +81,8 @@
   "dependencies": {
     "jszip": "3.10.1",
     "pdfjs-dist": "5.4.624",
-    "zod": "4.4.3"
+    "zod": "4.4.3",
+    "workdsh-plugin-office": "workspace:*"
   },
   "dsh": {
     "bundle": {
diff --git a/packages/plugins/library/src/client/LibraryPanel.tsx b/packages/plugins/library/src/client/LibraryPanel.tsx
index b59979d68c..6d5cbd3428 100644
--- a/packages/plugins/library/src/client/LibraryPanel.tsx
+++ b/packages/plugins/library/src/client/LibraryPanel.tsx
@@ -68,7 +68,7 @@ export function LibraryPanel({ management, previewRegistry, toggleNavigation, st
       if (entry.revision?.conversionStatus === 'ready') setContent(await management.readText(entry.asset!.id, revisionId));
       if (entry.asset?.kind === 'pdf') { const bytes = await management.readOriginal(entry.asset.id, revisionId); setOriginalUrl(URL.createObjectURL(new Blob([bytes as BlobPart], { type: 'application/pdf' }))); }
       if (entry.asset?.kind === 'html') { const bytes = await management.readOriginal(entry.asset.id, revisionId); setHtmlPreview(new TextDecoder().decode(bytes)); }
-      if ((entry.asset?.kind === 'docx' || entry.asset?.kind === 'pptx') && previewRegistry.canOpen(entry.asset.kind)) { const bytes = await management.readOriginal(entry.asset.id, revisionId); setOfficePreview({ name: entry.name, kind: entry.asset.kind, bytes }); }
+      if ((entry.asset?.kind === 'docx' || entry.asset?.kind === 'pptx' || entry.asset?.kind === 'csv' || entry.asset?.kind === 'xlsx') && previewRegistry.canOpen(entry.asset.kind)) { const bytes = await management.readOriginal(entry.asset.id, revisionId); setOfficePreview({ name: entry.name, kind: entry.asset.kind, bytes }); }
     } catch (cause) { setError(cause instanceof Error ? cause.message : '读取资料失败。'); }
   };
   const runSearch = async (nextView: View = 'search', nextQuery = query) => {
@@ -109,10 +109,10 @@ export function LibraryPanel({ management, previewRegistry, toggleNavigation, st
   const resultEntries = hits.map(hit => findById(hit.nodeId)).filter((row): row is LibraryTreeEntry => Boolean(row));
 
   return <section className="wd-library"><style>{libraryCss}</style>
-    <aside className="wd-library-sidebar"><header><button className="wd-library-nav-toggle" onClick={toggleNavigation}>☰</button><h1>资料库</h1></header><nav className="wd-library-nav"><button className={view === 'search' ? 'active' : ''} onClick={() => { setView('search'); setSelected(undefined); }}>⌕ <span>搜索</span></button><button className={view === 'recent' ? 'active' : ''} onClick={() => void runSearch('recent', '')}>◷ <span>最近</span></button><button className={view === 'outputs' ? 'active' : ''} onClick={() => void runSearch('outputs', '')}>▱ <span>本地产物</span></button></nav><div className="wd-library-section-title"><span>我的资料</span><button aria-label="新建或导入" onClick={event => showMenu(event, { create: true })}>＋</button></div><div className="wd-library-tree" onClick={() => setView('library')}><Tree rows={tree} /></div><footer>本地资料库 · 仅当前设备</footer><input ref={upload} className="wd-library-upload" type="file" multiple accept=".md,.markdown,.txt,.html,.htm,.pdf,.docx,.pptx" onChange={event => void files(event.currentTarget.files)} /></aside>
+    <aside className="wd-library-sidebar"><header><button className="wd-library-nav-toggle" onClick={toggleNavigation}>☰</button><h1>资料库</h1></header><nav className="wd-library-nav"><button className={view === 'search' ? 'active' : ''} onClick={() => { setView('search'); setSelected(undefined); }}>⌕ <span>搜索</span></button><button className={view === 'recent' ? 'active' : ''} onClick={() => void runSearch('recent', '')}>◷ <span>最近</span></button><button className={view === 'outputs' ? 'active' : ''} onClick={() => void runSearch('outputs', '')}>▱ <span>本地产物</span></button></nav><div className="wd-library-section-title"><span>我的资料</span><button aria-label="新建或导入" onClick={event => showMenu(event, { create: true })}>＋</button></div><div className="wd-library-tree" onClick={() => setView('library')}><Tree rows={tree} /></div><footer>本地资料库 · 仅当前设备</footer><input ref={upload} className="wd-library-upload" type="file" multiple accept=".md,.markdown,.txt,.html,.htm,.pdf,.docx,.pptx,.csv,.xlsx" onChange={event => void files(event.currentTarget.files)} /></aside>
     <main className="wd-library-content">{notice ? <div className="wd-library-toast success">{notice}</div> : null}{error ? <div className="wd-library-toast error">{error}</div> : null}
-      {selected ? <><header className="wd-library-document-header"><div><span>{entryPath(selected).replace(` / ${selected.name}`, '')}</span><b>/</b><strong>{selected.name}</strong>{selected.asset?.status === 'disabled' ? <em>已停用</em> : selected.revision?.conversionStatus === 'failed' ? <em>转换失败</em> : selected.revision?.conversionStatus === 'pending' ? <em>转换中</em> : null}</div><div className="wd-library-head-actions">{isEditable(selected) ? <Button onClick={() => void beginEdit()}>编辑</Button> : null}<button type="button" onClick={() => void downloadOriginal()}>下载</button><button type="button" aria-label="更多操作" onClick={event => showMenu(event, { entry: selected })}>•••</button></div></header><div className="wd-library-document-body" data-kind={selected.asset?.kind}>{selected.revision?.conversionStatus === 'failed' ? <div className="wd-library-conversion-warning">原件已安全保存，但检索文本转换失败，因此暂不可搜索。仍可预览或下载原件。</div> : null}{draft ? <div className="wd-library-editor"><div className="wd-library-editor-bar"><strong>编辑草稿</strong><span>发布后生成新的只读修订</span><Button onClick={() => setDraft(undefined)}>取消</Button><Button variant="primary" className="primary" onClick={() => void publishDraft()}>发布新版本</Button></div><div className="wd-library-diff"><section><b>当前修订</b><pre>{draft.content}</pre></section><section><b>草稿预览</b><pre>{draftContent}</pre></section></div><Textarea aria-label="草稿内容" value={draftContent} onChange={event => setDraftContent(event.currentTarget.value)} /></div> : selected.asset?.status === 'disabled' ? <div className="wd-library-state">这份资料已停用。重新启用后才能查看或用于任务。</div> : originalUrl ? <iframe className="wd-library-pdf" title={selected.name} src={originalUrl} /> : htmlPreview ? <iframe className="wd-library-html" title={selected.name} sandbox="allow-scripts" srcDoc={isolatedHtml(htmlPreview)} /> : officePreview ? <div ref={officeHost} className="wd-library-office-preview" /> : <article className={`wd-library-original ${selected.asset?.kind ?? ''}`}><div className="wd-library-meta">修订 {selected.revision?.number ?? 1} · {selected.asset?.kind === 'docx' || selected.asset?.kind === 'pptx' ? 'Office 原始预览不可用，显示检索文本' : '原始内容'}</div>{selected.asset?.kind === 'markdown' ? <MarkdownDocument content={content} /> : <pre>{content}</pre>}</article>}</div></>
-      : view === 'search' ? <div className="wd-library-list-view"><h2>搜索</h2><form onSubmit={event => { event.preventDefault(); void runSearch('search'); }}><Input autoFocus value={query} onChange={event => setQuery(event.currentTarget.value)} placeholder="搜索资料名称和内容"/><Button type="submit">搜索</Button></form><div className="wd-library-filters"><Select aria-label="资料类型" value={searchKind} onChange={event => setSearchKind(event.currentTarget.value as LibraryAssetKind | '')}><option value="">全部类型</option><option value="markdown">Markdown</option><option value="text">TXT</option><option value="html">HTML</option><option value="pdf">PDF</option><option value="docx">Word</option><option value="pptx">PowerPoint</option></Select><Select aria-label="资料来源" value={searchSource} onChange={event => setSearchSource(event.currentTarget.value as LibraryAsset['source'] | '')}><option value="">全部来源</option><option value="upload">上传导入</option><option value="created">新建资料</option><option value="task">本地产物</option></Select><label>更新日期从 <Input type="date" value={searchAfter} onChange={event => setSearchAfter(event.currentTarget.value)} /></label></div>{busy ? <div className="wd-library-state">正在搜索…</div> : <ResultList rows={resultEntries} hits={hits} open={open} />}</div>
+      {selected ? <><header className="wd-library-document-header"><div><span>{entryPath(selected).replace(` / ${selected.name}`, '')}</span><b>/</b><strong>{selected.name}</strong>{selected.asset?.status === 'disabled' ? <em>已停用</em> : selected.revision?.conversionStatus === 'failed' ? <em>转换失败</em> : selected.revision?.conversionStatus === 'pending' ? <em>转换中</em> : null}</div><div className="wd-library-head-actions">{isEditable(selected) ? <Button onClick={() => void beginEdit()}>编辑</Button> : null}<button type="button" onClick={() => void downloadOriginal()}>下载</button><button type="button" aria-label="更多操作" onClick={event => showMenu(event, { entry: selected })}>•••</button></div></header><div className="wd-library-document-body" data-kind={selected.asset?.kind}>{selected.revision?.conversionWarnings.length ? <div className="wd-library-conversion-warning" role="note">{selected.revision.conversionWarnings.join(" ")}</div> : null}{selected.revision?.conversionStatus === 'failed' ? <div className="wd-library-conversion-warning">原件已安全保存，但检索文本转换失败，因此暂不可搜索。仍可预览或下载原件。</div> : null}{draft ? <div className="wd-library-editor"><div className="wd-library-editor-bar"><strong>编辑草稿</strong><span>发布后生成新的只读修订</span><Button onClick={() => setDraft(undefined)}>取消</Button><Button variant="primary" className="primary" onClick={() => void publishDraft()}>发布新版本</Button></div><div className="wd-library-diff"><section><b>当前修订</b><pre>{draft.content}</pre></section><section><b>草稿预览</b><pre>{draftContent}</pre></section></div><Textarea aria-label="草稿内容" value={draftContent} onChange={event => setDraftContent(event.currentTarget.value)} /></div> : selected.asset?.status === 'disabled' ? <div className="wd-library-state">这份资料已停用。重新启用后才能查看或用于任务。</div> : originalUrl ? <iframe className="wd-library-pdf" title={selected.name} src={originalUrl} /> : htmlPreview ? <iframe className="wd-library-html" title={selected.name} sandbox="allow-scripts" srcDoc={isolatedHtml(htmlPreview)} /> : officePreview ? <div ref={officeHost} className="wd-library-office-preview" /> : <article className={`wd-library-original ${selected.asset?.kind ?? ''}`}><div className="wd-library-meta">修订 {selected.revision?.number ?? 1} · {selected.asset?.kind === 'docx' || selected.asset?.kind === 'pptx' ? 'Office 原始预览不可用，显示检索文本' : '原始内容'}</div>{selected.asset?.kind === 'markdown' ? <MarkdownDocument content={content} /> : <pre>{content}</pre>}</article>}</div></>
+      : view === 'search' ? <div className="wd-library-list-view"><h2>搜索</h2><form onSubmit={event => { event.preventDefault(); void runSearch('search'); }}><Input autoFocus value={query} onChange={event => setQuery(event.currentTarget.value)} placeholder="搜索资料名称和内容"/><Button type="submit">搜索</Button></form><div className="wd-library-filters"><Select aria-label="资料类型" value={searchKind} onChange={event => setSearchKind(event.currentTarget.value as LibraryAssetKind | '')}><option value="">全部类型</option><option value="markdown">Markdown</option><option value="text">TXT</option><option value="html">HTML</option><option value="pdf">PDF</option><option value="docx">Word</option><option value="pptx">PowerPoint</option><option value="csv">CSV</option><option value="xlsx">Excel</option></Select><Select aria-label="资料来源" value={searchSource} onChange={event => setSearchSource(event.currentTarget.value as LibraryAsset['source'] | '')}><option value="">全部来源</option><option value="upload">上传导入</option><option value="created">新建资料</option><option value="task">本地产物</option></Select><label>更新日期从 <Input type="date" value={searchAfter} onChange={event => setSearchAfter(event.currentTarget.value)} /></label></div>{busy ? <div className="wd-library-state">正在搜索…</div> : <ResultList rows={resultEntries} hits={hits} open={open} />}</div>
       : view === 'recent' || view === 'outputs' ? <div className="wd-library-list-view"><h2>{view === 'recent' ? '最近' : '本地产物'}</h2>{busy ? <div className="wd-library-state">正在读取…</div> : <ResultList rows={resultEntries} hits={hits} open={open} />}</div>
       : <div className="wd-library-welcome"><div className="wd-library-welcome-icon">▤</div><h2>我的资料</h2><p>从左侧选择资料，在这里查看原始内容。</p><Button onClick={event => showMenu(event, { create: true })}>新建或导入资料</Button></div>}
     </main>
@@ -124,7 +124,7 @@ export function LibraryPanel({ management, previewRegistry, toggleNavigation, st
 
 const isEditable = (entry?: LibraryTreeEntry) => entry?.asset?.status !== 'disabled' && (entry?.asset?.kind === 'markdown' || entry?.asset?.kind === 'text');
 function ResultList({ rows, hits, open }: { rows: readonly LibraryTreeEntry[]; hits: readonly LibrarySearchHit[]; open: (row: LibraryTreeEntry) => Promise<void> }) {
-  const typeName = { markdown: 'Markdown', text: 'TXT', html: 'HTML', pdf: 'PDF', docx: 'Word', pptx: 'PowerPoint' } as const;
+  const typeName = { markdown: 'Markdown', text: 'TXT', html: 'HTML', pdf: 'PDF', docx: 'Word', pptx: 'PowerPoint', csv: 'CSV', xlsx: 'Excel' } as const;
   return rows.length ? <div className="wd-library-results">{rows.map(row => { const hit = hits.find(value => value.nodeId === row.id); return <button type="button" key={row.id} onClick={() => void open(row)}><span className={`wd-library-kind kind-${row.asset?.kind ?? 'folder'}`}>{icon(row)}</span><span><strong>{row.name}</strong><small>{row.asset ? typeName[row.asset.kind] : '文件夹'} · {hit?.folderPath ?? '我的资料'} · 修订 {row.revision?.number ?? 1} · {row.revision?.conversionStatus === 'ready' ? '可搜索' : row.revision?.conversionStatus === 'failed' ? '转换失败' : '转换中'}</small><small>{row.asset?.source === 'task' ? '本地产物' : row.asset?.source === 'created' ? '新建资料' : '上传导入'} · {new Date(row.updatedAt).toLocaleString()}{hit?.location ? ` · ${hit.location}` : ''}</small>{hit?.excerpt ? <span className="wd-library-excerpt">{hit.excerpt}</span> : null}</span><i>›</i></button>; })}</div> : <div className="wd-library-state">没有找到资料。</div>;
 }
 
diff --git a/packages/plugins/library/src/client/LibraryReferencePage.tsx b/packages/plugins/library/src/client/LibraryReferencePage.tsx
index faebf3532b..40d5230dc9 100644
--- a/packages/plugins/library/src/client/LibraryReferencePage.tsx
+++ b/packages/plugins/library/src/client/LibraryReferencePage.tsx
@@ -23,7 +23,7 @@ export function LibraryReferencePage({ management, previewRegistry, useTabInfo }
     let active = true;
     const run = async () => {
       try {
-        if (params.kind === 'html' || params.kind === 'pdf' || params.kind === 'docx' || params.kind === 'pptx') {
+        if (params.kind === 'html' || params.kind === 'pdf' || params.kind === 'docx' || params.kind === 'pptx' || params.kind === 'csv' || params.kind === 'xlsx') {
           const bytes = await management.readOriginal(params.assetId!, params.revisionId);
           if (!active) return;
           if (params.kind === 'html') setHtml(new TextDecoder().decode(bytes));
diff --git a/packages/plugins/library/src/client/LibrarySelectionChips.tsx b/packages/plugins/library/src/client/LibrarySelectionChips.tsx
index c230c7071c..b288f1444a 100644
--- a/packages/plugins/library/src/client/LibrarySelectionChips.tsx
+++ b/packages/plugins/library/src/client/LibrarySelectionChips.tsx
@@ -6,7 +6,7 @@ import type { LibraryClient } from './management.js';
 import { listenForLibrarySelection, notifyLibrarySelectionChanged, requestLibraryPicker } from './selection-events.js';
 
 type Props = PropsRuntime<'conversation.input.overlay'> & { management: LibraryClient };
-const labels: Record<LibraryAssetKind, string> = { markdown: 'M', text: 'T', html: '</>', pdf: 'PDF', docx: 'W', pptx: 'P' };
+const labels: Record<LibraryAssetKind, string> = { markdown: 'M', text: 'T', html: '</>', pdf: 'PDF', docx: 'W', pptx: 'P', csv: 'CSV', xlsx: 'X' };
 const css = `
 [data-composer-card]:has(.wd-library-selection-chips){padding-top:50px}
 .wd-library-selection-chips{box-sizing:border-box;position:absolute;z-index:2;top:9px;left:12px;right:12px;height:34px;display:flex;align-items:center;gap:7px;overflow-x:auto;scrollbar-width:none;pointer-events:auto}
diff --git a/packages/plugins/library/src/remote/connection-api.ts b/packages/plugins/library/src/remote/connection-api.ts
index 76949aa02a..2caaa53f60 100644
--- a/packages/plugins/library/src/remote/connection-api.ts
+++ b/packages/plugins/library/src/remote/connection-api.ts
@@ -39,7 +39,7 @@ export function registerLibraryConnection(ctx: Context): void {
         return Response.json(fail('library/invalid-request', '资料库请求无效。'), { status: 400 });
       } catch (cause) {
         const code = cause instanceof Error && cause.message.startsWith('library/') ? cause.message : 'library/internal';
-        const messages: Record<string, string> = { 'library/not-found': '资料不存在或无权访问。', 'library/disabled': '资料已停用，不能读取、检索或添加到任务。', 'library/name-conflict': '同一目录已有同名项目。', 'library/unsupported-format': '当前仅支持 Markdown、TXT、PDF、DOCX、PPTX 和 HTML。', 'library/file-size': '文件为空或超过限制。', 'library/cycle': '文件夹不能移动到自己的子目录。', 'library/invalid-name': '资料名称无效。', 'library/revision-conflict': '草稿已被更新，请刷新后重试。', 'library/base-revision-conflict': '正文已有新版本，请重新创建草稿。', 'library/draft-format': '第一版只支持修改 Markdown 和 TXT。', 'library/selection-too-large': '所选目录资料过多，请缩小范围。', 'library/invalid-text': '文本不是有效的 UTF-8。', 'library/invalid-pdf': 'PDF 已损坏或格式与扩展名不符。', 'library/invalid-office-file': 'Office 文件已损坏或格式与扩展名不符。', 'library/invalid-docx': '文件不是有效的 DOCX。', 'library/invalid-pptx': '文件不是有效的 PPTX。', 'library/invalid-html': '文件不是有效的 HTML。', 'library/archive-limit': 'Office 文件解压规模或压缩比超过安全限制。', 'library/archive-path': 'Office 文件包含不安全的归档路径。' };
+        const messages: Record<string, string> = { 'library/not-found': '资料不存在或无权访问。', 'library/disabled': '资料已停用，不能读取、检索或添加到任务。', 'library/name-conflict': '同一目录已有同名项目。', 'library/unsupported-format': '当前仅支持 Markdown、TXT、PDF、DOCX、PPTX、HTML、CSV 和 XLSX。', 'library/file-size': '文件为空或超过限制。', 'library/cycle': '文件夹不能移动到自己的子目录。', 'library/invalid-name': '资料名称无效。', 'library/revision-conflict': '草稿已被更新，请刷新后重试。', 'library/base-revision-conflict': '正文已有新版本，请重新创建草稿。', 'library/draft-format': '第一版只支持修改 Markdown 和 TXT。', 'library/selection-too-large': '所选目录资料过多，请缩小范围。', 'library/invalid-csv': 'CSV 包含二进制内容，无法作为表格导入。', 'library/invalid-xlsx': 'XLSX 已损坏或格式与扩展名不符。', 'library/invalid-text': '文本不是有效的 UTF-8。', 'library/invalid-pdf': 'PDF 已损坏或格式与扩展名不符。', 'library/invalid-office-file': 'Office 文件已损坏或格式与扩展名不符。', 'library/invalid-docx': '文件不是有效的 DOCX。', 'library/invalid-pptx': '文件不是有效的 PPTX。', 'library/invalid-html': '文件不是有效的 HTML。', 'library/archive-limit': 'Office 文件解压规模或压缩比超过安全限制。', 'library/archive-path': 'Office 文件包含不安全的归档路径。' };
         return Response.json(fail(code, messages[code] ?? '资料库操作失败。'), { status: code === 'library/internal' ? 500 : 400 });
       }
     },
diff --git a/packages/plugins/library/src/services/converters.ts b/packages/plugins/library/src/services/converters.ts
index fa48380157..dc25f4cd50 100644
--- a/packages/plugins/library/src/services/converters.ts
+++ b/packages/plugins/library/src/services/converters.ts
@@ -1,3 +1,4 @@
+import { extractTabularText } from 'workdsh-plugin-office/tabular';
 import JSZip from 'jszip';
 import type { LibraryAssetKind } from 'workdsh-contracts/library';
 
@@ -128,6 +129,11 @@ export async function convertToMarkdown(kind: LibraryAssetKind, bytes: Uint8Arra
     try { return { markdown: new TextDecoder('utf-8', { fatal: true }).decode(bytes).replace(/\r\n?/g, '\n'), warnings: [], locations: [] }; }
     catch { throw new Error('library/invalid-text'); }
   }
+  if (kind === 'csv' || kind === 'xlsx') {
+    if (kind === 'xlsx') { const zip = await safeZip(bytes, signal); if (!zip.file('xl/workbook.xml')) throw new Error('library/invalid-xlsx'); }
+    const converted = await extractTabularText(kind, bytes, signal);
+    return { ...converted, locations: [] };
+  }
   if (kind === 'docx') return docx(bytes, signal);
   if (kind === 'pptx') return pptx(bytes, signal);
   if (kind === 'html') return html(bytes);
diff --git a/packages/plugins/library/src/services/library-manager.ts b/packages/plugins/library/src/services/library-manager.ts
index 86e034926f..ff5d47d37f 100644
--- a/packages/plugins/library/src/services/library-manager.ts
+++ b/packages/plugins/library/src/services/library-manager.ts
@@ -30,13 +30,13 @@ const cleanName = (value: string): string => {
   return name;
 };
 const extensionKinds: Readonly<Record<string, LibraryAssetKind>> = {
-  '.md': 'markdown', '.markdown': 'markdown', '.txt': 'text', '.pdf': 'pdf', '.docx': 'docx', '.pptx': 'pptx', '.html': 'html', '.htm': 'html',
+  '.md': 'markdown', '.markdown': 'markdown', '.txt': 'text', '.pdf': 'pdf', '.docx': 'docx', '.pptx': 'pptx', '.html': 'html', '.htm': 'html', '.csv': 'csv', '.xlsx': 'xlsx',
 };
 const defaultMediaTypes: Readonly<Record<LibraryAssetKind, string>> = {
   markdown: 'text/markdown', text: 'text/plain', pdf: 'application/pdf',
   docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
   pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',
-  html: 'text/html',
+  html: 'text/html', csv: 'text/csv', xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',
 };
 
 export interface LibraryManagerOptions { readonly root?: string; readonly maxBytes?: number; readonly maxTotalBytes?: number; readonly maxSelectionBytes?: number; readonly maxSelectionAssets?: number; readonly converter?: typeof convertToMarkdown; }
diff --git a/packages/plugins/library/src/storage/domain.ts b/packages/plugins/library/src/storage/domain.ts
index 127a8fb4a3..e4cd5adaf4 100644
--- a/packages/plugins/library/src/storage/domain.ts
+++ b/packages/plugins/library/src/storage/domain.ts
@@ -14,7 +14,7 @@ const node = z.object({
   assetId: id.optional(), createdAt: iso, updatedAt: iso,
 });
 const asset = z.object({
-  id, spaceId: id, nodeId: id, kind: z.enum(['markdown', 'text', 'pdf', 'docx', 'pptx', 'html']),
+  id, spaceId: id, nodeId: id, kind: z.enum(['markdown', 'text', 'pdf', 'docx', 'pptx', 'html', 'csv', 'xlsx']),
   mediaType: id, byteLength: z.number().int().nonnegative(), owner, currentRevisionId: id,
   status: z.enum(['active', 'disabled']).default('active'),
   source: z.enum(['upload', 'task', 'created']), sourceTaskId: id.optional(), createdAt: iso, updatedAt: iso,
diff --git a/packages/plugins/library/src/tools/library-tools.ts b/packages/plugins/library/src/tools/library-tools.ts
index 384a606fe6..1dcb81fdab 100644
--- a/packages/plugins/library/src/tools/library-tools.ts
+++ b/packages/plugins/library/src/tools/library-tools.ts
@@ -11,7 +11,7 @@ export function registerLibraryTools(ctx: Context): void {
   ctx.tools.register(defineTool({
     name: 'library_search',
     description: '搜索本次对话已显式选择的虚拟资料正文。资料不位于工作区文件系统；无需也不得先用 Bash、Glob 或文件读取工具定位。返回固定资料与修订引用；不自动扩大读取范围。',
-    parameters: { query: { type: 'string', required: true, description: '要查找的标题或正文关键词。' }, kind: { type: 'string', enum: ['markdown', 'text', 'pdf', 'docx', 'pptx', 'html'] }, source: { type: 'string', enum: ['upload', 'task', 'created'] } },
+    parameters: { query: { type: 'string', required: true, description: '要查找的标题或正文关键词。' }, kind: { type: 'string', enum: ['markdown', 'text', 'pdf', 'docx', 'pptx', 'html', 'csv', 'xlsx'] }, source: { type: 'string', enum: ['upload', 'task', 'created'] } },
     output: {
       schema: {
         type: 'object', additionalProperties: false,
diff --git a/packages/plugins/library/tests/library.test.mjs b/packages/plugins/library/tests/library.test.mjs
index 694bcc870d..ce8766bb44 100644
--- a/packages/plugins/library/tests/library.test.mjs
+++ b/packages/plugins/library/tests/library.test.mjs
@@ -213,3 +213,45 @@ test('selected library revisions and an explicitly invoked skill coexist in one
     assert.equal(userMessage, '/material-organizer 整理已添加资料，输出结构化摘要。');
   } finally { if (ctx) await ctx.fiber.dispose(); await rm(root, { recursive: true, force: true }); }
 });
+
+test('CSV and XLSX import preserve originals, search cells and supply task context', async () => {
+  const root = await mkdtemp(join(tmpdir(), 'library-tables-'));
+  const ctx = await boot(join(root, 'storage'), join(root, 'library'));
+  try {
+    const { createRequire } = await import('node:module');
+    const ExcelJS = createRequire(new URL('../../office/package.json', import.meta.url))('exceljs');
+    const book = new ExcelJS.Workbook();
+    const sheet = book.addWorksheet('季度销售');
+    sheet.addRow(['客户', '金额']); sheet.addRow(['Xlsx客户甲', 42]);
+    sheet.getCell('B3').value = { formula: 'B2*2', result: 84 };
+    const other = book.addWorksheet('备注'); other.addRow(['Xlsx第二页']);
+    const xlsx = new Uint8Array(await book.xlsx.writeBuffer());
+    const csv = new TextEncoder().encode('\ufeff客户;备注\r\nCsv客户乙;"多行\n含|竖线"\r\n');
+    for (const [name, bytes, kind, query] of [['数据.CSV', csv, 'csv', 'Csv客户乙'], ['销售.xlsx', xlsx, 'xlsx', 'Xlsx第二页']]) {
+      const row = await ctx.workdshLibrary.importAsset(actor, { name, bytes, operationId: name });
+      assert.equal(row.asset.kind, kind); assert.equal(row.revision.conversionStatus, 'ready');
+      assert.deepEqual(await ctx.workdshLibrary.readOriginal(actor, row.asset.id), bytes);
+      assert.equal((await ctx.workdshLibrary.search(actor, query, { kinds: [kind] }))[0].name, name);
+      await ctx.workdshLibrary.setTaskSelection(actor, 'tables-session', [row.id]);
+      assert.match(await buildLibrarySelectionContext(ctx.workdshLibrary, actor, 'tables-session'), new RegExp(query));
+    }
+    const hits = await ctx.workdshLibrary.search(actor, 'Xlsx客户甲');
+    assert.match(await ctx.workdshLibrary.readText(actor, hits[0].assetId), /84/);
+    await assert.rejects(ctx.workdshLibrary.importAsset(actor, { name: 'fake.xlsx', bytes: new TextEncoder().encode('not a zip'), operationId: 'bad-table' }), /library\/invalid-office-file/);
+  } finally { await ctx.fiber.dispose(); await rm(root, { recursive: true, force: true }); }
+});
+
+test('tabular extraction reports truncation and never evaluates formulas', async () => {
+  const { extractTabularText } = await import('workdsh-plugin-office/tabular');
+  const text = '名称,备注\n客户,"换行\n含|<script>"\n';
+  const utf16 = new Uint8Array(Buffer.concat([Buffer.from([0xff, 0xfe]), Buffer.from(text, 'utf16le')]));
+  const decoded = await extractTabularText('csv', utf16);
+  assert.match(decoded.markdown, /客户/);
+  assert.match(decoded.markdown, /&#124;&lt;script&gt;/);
+  const clipped = await extractTabularText('csv', new TextEncoder().encode('a,b\n' + 'value,other\n'.repeat(1600)));
+  assert.equal(clipped.warnings.length, 1);
+  assert.match(clipped.warnings[0], /前缀/);
+  await assert.rejects(extractTabularText('csv', new Uint8Array([65, 0, 66])), /invalid-csv/);
+  const controller = new AbortController(); controller.abort();
+  await assert.rejects(extractTabularText('csv', utf16, controller.signal), { name: 'AbortError' });
+});
diff --git a/packages/plugins/office/package.json b/packages/plugins/office/package.json
index f73702e433..5c089b10b2 100644
--- a/packages/plugins/office/package.json
+++ b/packages/plugins/office/package.json
@@ -11,7 +11,11 @@
       "default": "./dist/client.browser.js"
     },
     "./package.json": "./package.json",
-    "./locale/*.json": "./locale/*.json"
+    "./locale/*.json": "./locale/*.json",
+    "./tabular": {
+      "types": "./dist/tabular.d.ts",
+      "default": "./dist/tabular.js"
+    }
   },
   "files": [
     "dist",
diff --git a/packages/plugins/office/src/OfficeDocument.tsx b/packages/plugins/office/src/OfficeDocument.tsx
index 14ef2b18b1..3e549a4da5 100644
--- a/packages/plugins/office/src/OfficeDocument.tsx
+++ b/packages/plugins/office/src/OfficeDocument.tsx
@@ -1,3 +1,4 @@
+import { CsvDocument } from './csv/CsvDocument.js';
 import {ImportedPptx} from './presentation/ImportedPptx.js';
 import React, { useEffect, useRef, useState } from 'react';
 import type { DocumentPreviewProps } from '@deepseek-ai/dsh-client-ui-sidebar-documentpreview/client';
@@ -25,6 +26,7 @@ import { importDocx } from './live/import-docx.js';
 import { officeCss } from './live/style.js';
 import type { OfficeClient } from './live/model.js';
 export function OfficeDocument(props: DocumentPreviewProps & {office: OfficeClient}) {
+  if (/\.csv(?:$|[?&#/])/i.test(decodeURIComponent(props.resourceAddress))) return <CsvDocument {...props} />;
   const docx = /\.docx(?:$|[?&#/])/i.test(decodeURIComponent(props.resourceAddress));
   if (/\.pptx(?:$|[?&#/])/i.test(decodeURIComponent(props.resourceAddress))) return <ImportedPptx key={props.resourceAddress} {...props}/>;
   return docx ? <ImportedDocument key={props.resourceAddress} {...props} /> : <LegacyOfficeDocument {...props} />;
diff --git a/packages/plugins/office/src/client.tsx b/packages/plugins/office/src/client.tsx
index 217df753f5..2702650d4c 100644
--- a/packages/plugins/office/src/client.tsx
+++ b/packages/plugins/office/src/client.tsx
@@ -1,3 +1,7 @@
+import React from "react";
+import { createRoot } from "react-dom/client";
+import { CsvDocument } from "./csv/CsvDocument.js";
+import editorHtml from "./editor.html";
 import {downloadPdf} from "./pdf/download.js";
 import {downloadHtml} from "./html/preview.js";
 import {createPresentationModel} from "./presentation/client-model.js";
@@ -45,8 +49,23 @@ export const inject = [
   "inputTriggers",
 ];
 export function apply(ctx: Context): void {
-  ctx.inject(["workdshLibraryPreview"], scope => scope.effect(() => scope.workdshLibraryPreview.register(["docx", "pptx"], async (target, input) => {
+  ctx.inject(["workdshLibraryPreview"], scope => scope.effect(() => scope.workdshLibraryPreview.register(wordOnlyRelease ? ["docx"] : ["docx", "pptx", "csv", "xlsx"], async (target, input) => {
     target.replaceChildren();
+    if (input.kind === "csv") {
+      const root = createRoot(target);
+      root.render(<CsvDocument content={{ kind: "bytes", data: Uint8Array.from(input.bytes) }} wrap={true} scrollportRef={() => undefined} />);
+      return () => root.unmount();
+    }
+    if (input.kind === "xlsx") {
+      const frame = document.createElement("iframe");
+      frame.title = input.name; frame.setAttribute("sandbox", "allow-scripts allow-downloads");
+      frame.style.cssText = "width:100%;height:100%;border:0";
+      const ready = (event: MessageEvent) => {
+        if (event.source === frame.contentWindow && event.data?.type === "workdsh-office-ready") frame.contentWindow?.postMessage({ type: "workdsh-office-open", extension: "xlsx", bytes: input.bytes.slice() }, "*");
+      };
+      window.addEventListener("message", ready); frame.srcdoc = editorHtml; target.append(frame);
+      return () => { window.removeEventListener("message", ready); frame.remove(); };
+    }
     if (input.kind === "docx") {
       const style = document.createElement("style"); style.textContent = ".docx-wrapper{background:#e9ecf1!important;padding:24px!important;min-height:100%;box-sizing:border-box}.docx-wrapper>section.docx{width:min(816px,calc(100% - 20px))!important;min-height:1056px!important;margin:0 auto 20px!important;padding:72px 80px!important;box-sizing:border-box!important;box-shadow:0 2px 14px #0003}.docx-wrapper table{width:100%!important;table-layout:auto!important}.docx-wrapper td,.docx-wrapper th{min-width:72px!important;word-break:normal!important;overflow-wrap:break-word!important;white-space:normal!important}.docx-wrapper p{word-break:normal!important;overflow-wrap:break-word!important}";
       target.append(style);
@@ -62,9 +81,9 @@ export function apply(ctx: Context): void {
   ctx.effect(() =>
     ctx.documentPreviews.register({
       id: "workdsh-office",
-      extensions: wordOnlyRelease ? ["docx"] : ["xlsx", "docx", "pptx"],
+      extensions: wordOnlyRelease ? ["docx"] : ["xlsx", "docx", "pptx", "csv"],
       title: () => "Office 浏览器编辑",
-      binaryExtensions: wordOnlyRelease ? ["docx"] : ["xlsx", "docx", "pptx"],
+      binaryExtensions: wordOnlyRelease ? ["docx"] : ["xlsx", "docx", "pptx", "csv"],
       priority: "extension",
       loading: "bytes-complete",
     }),
diff --git a/packages/plugins/office/src/csv/CsvDocument.tsx b/packages/plugins/office/src/csv/CsvDocument.tsx
index bdfbeb2215..e84a82ba34 100644
--- a/packages/plugins/office/src/csv/CsvDocument.tsx
+++ b/packages/plugins/office/src/csv/CsvDocument.tsx
@@ -59,7 +59,7 @@ const Grid = React.memo(function Grid({ table }: { table: CsvTable }) {
 });
 
 /** Read-only CSV table body for the right-Sidebar document seat, owned by the official preview registry. */
-export function CsvDocument(props: DocumentPreviewProps) {
+export function CsvDocument(props: Pick<DocumentPreviewProps, 'content' | 'wrap' | 'scrollportRef'>) {
   const { content, wrap, scrollportRef } = props;
   const decoded = useMemo(
     () => {
diff --git a/packages/plugins/office/src/tabular.d.ts b/packages/plugins/office/src/tabular.d.ts
new file mode 100644
index 0000000000..9c11c6f15c
--- /dev/null
+++ b/packages/plugins/office/src/tabular.d.ts
@@ -0,0 +1 @@
+export declare function extractTabularText(kind: 'csv' | 'xlsx', bytes: Uint8Array, signal?: AbortSignal): Promise<{ markdown: string; warnings: readonly string[] }>;
diff --git a/packages/plugins/office/src/tabular.js b/packages/plugins/office/src/tabular.js
new file mode 100644
index 0000000000..36ac8fd73d
--- /dev/null
+++ b/packages/plugins/office/src/tabular.js
@@ -0,0 +1,45 @@
+// Shared Host extraction; preview and Library use the same CSV parser and ExcelJS runtime.
+import ExcelJS from 'exceljs';
+import { decodeCsvBytes, parseCsv, csvLimits } from './csv/csv.ts';
+const escape = value => String(value ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/\|/g, '&#124;').replace(/\r?\n/g, '<br>');
+const tableMarkdown = rows => {
+  if (!rows.length) return '';
+  const width = Math.max(1, ...rows.map(row => row.length));
+  const lines = rows.map(row => `| ${Array.from({ length: width }, (_, i) => escape(row[i])).join(' | ')} |`);
+  lines.splice(1, 0, `| ${Array(width).fill('---').join(' | ')} |`);
+  return lines.join('\n');
+};
+export async function extractTabularText(kind, bytes, signal) {
+  signal?.throwIfAborted();
+  if (kind === 'csv') {
+    const decoded = decodeCsvBytes(bytes);
+    if (decoded.binary) throw new Error('library/invalid-csv');
+    const table = parseCsv(decoded.text);
+    return { markdown: tableMarkdown(table.header.length ? [table.header, ...table.rows] : []) + '\n', warnings: table.truncatedRows || table.truncatedColumns ? ['CSV 检索文本仅包含前缀：最多 1500 行、120 列、24000 单元格；完整原件已保留。'] : [] };
+  }
+  const workbook = new ExcelJS.Workbook();
+  await workbook.xlsx.load(bytes);
+  signal?.throwIfAborted();
+  const sections = [], warnings = ['公式不重新计算，仅提取已有缓存结果；图表、图片和格式不进入检索文本。'];
+  let cells = 0, sheetCount = 0, truncated = false;
+  workbook.eachSheet(sheet => {
+    signal?.throwIfAborted();
+    if (++sheetCount > 20 || cells >= csvLimits.cells) { truncated = true; return; }
+    const width = Math.min(csvLimits.columns, sheet.columnCount);
+    const count = Math.min(csvLimits.rows, sheet.rowCount, Math.floor((csvLimits.cells - cells) / Math.max(1, width)));
+    if (width < sheet.columnCount || count < sheet.rowCount) truncated = true;
+    const rows = [];
+    for (let r = 1; r <= count; r++) {
+      signal?.throwIfAborted();
+      const row = [];
+      for (let c = 1; c <= width; c++) {
+        const cell = sheet.getCell(r, c);
+        row.push(cell.text); cells++;
+      }
+      rows.push(row);
+    }
+    sections.push(`## ${escape(sheet.name)}\n\n${tableMarkdown(rows)}`);
+  });
+  if (truncated) warnings.push('XLSX 检索文本仅包含前缀：最多 20 个工作表、每表 1500 行/120 列、总计 24000 单元格；完整原件已保留。');
+  return { markdown: sections.join('\n\n') + '\n', warnings };
+}

From 1f071bb9c5ce607b972da20f7be17c853329e219 Mon Sep 17 00:00:00 2001
From: techflag <562635045@qq.com>
Date: Sun, 4 Oct 2026 20:14:45 +0800
Subject: [PATCH 2/2] fix(library): bundle shared extraction without requiring
 unpublished Office

---
 apps/web/pnpm-lock.yaml                             |  9 ++++++---
 apps/web/scripts/build-library.mjs                  | 13 +++++++++++++
 packages/plugins/library/README.md                  |  2 +-
 packages/plugins/library/package.json               |  5 +++--
 .../library/src/client/LibraryReferencePage.tsx     |  3 ++-
 packages/plugins/library/tests/library.test.mjs     |  7 +++++++
 6 files changed, 32 insertions(+), 7 deletions(-)

diff --git a/apps/web/pnpm-lock.yaml b/apps/web/pnpm-lock.yaml
index 46d3a01a1f..6eb615a13d 100644
--- a/apps/web/pnpm-lock.yaml
+++ b/apps/web/pnpm-lock.yaml
@@ -842,15 +842,15 @@ importers:
 
   ../../packages/plugins/library:
     dependencies:
+      exceljs:
+        specifier: 4.4.0
+        version: 4.4.0
       jszip:
         specifier: 3.10.1
         version: 3.10.1
       pdfjs-dist:
         specifier: 5.4.624
         version: 5.4.624
-      workdsh-plugin-office:
-        specifier: workspace:*
-        version: link:../office
       zod:
         specifier: 4.4.3
         version: 4.4.3
@@ -933,6 +933,9 @@ importers:
       workdsh-contracts:
         specifier: workspace:*
         version: link:../../contracts
+      workdsh-plugin-office:
+        specifier: workspace:*
+        version: link:../office
       workdsh-ui:
         specifier: workspace:*
         version: link:../../ui
diff --git a/apps/web/scripts/build-library.mjs b/apps/web/scripts/build-library.mjs
index 3d180723fa..d9fe4aa243 100644
--- a/apps/web/scripts/build-library.mjs
+++ b/apps/web/scripts/build-library.mjs
@@ -1,6 +1,19 @@
 import { build } from 'esbuild';
 import { writeFile } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
 const entry = new URL('../../../packages/plugins/library/', import.meta.url);
 const result = await build({ entryPoints: [fileURLToPath(new URL('src/client.tsx', entry))], bundle: true, write: false, format: 'cjs', platform: 'browser', target: 'es2022', external: ['@deepseek-ai/dsh-client-ui-primitives', 'react', 'react/jsx-runtime'] });
 await writeFile(new URL('dist/client.browser.js', entry), `window.__ModuleLoader__.load({id: "workdsh-plugin-library", factory: function(require) { const module = {exports:{}};\n${result.outputFiles[0].text}\nreturn module.exports; }});\n`);
+
+// Reuse Office's public extraction module at build time. Library must not require
+// an unpublished Office plugin at runtime or activate Office in a personal Profile.
+const requireOffice = createRequire(new URL('package.json', entry));
+await build({
+  entryPoints: [fileURLToPath(new URL('src/index.ts', entry))],
+  bundle: true, format: 'esm', platform: 'node', target: 'node22', packages: 'external',
+  plugins: [{ name: 'office-tabular-only', setup(builder) {
+    builder.onResolve({ filter: /^workdsh-plugin-office\/tabular$/ }, () => ({ path: requireOffice.resolve('workdsh-plugin-office/tabular') }));
+  } }],
+  outfile: fileURLToPath(new URL('dist/index.js', entry)),
+});
diff --git a/packages/plugins/library/README.md b/packages/plugins/library/README.md
index 468a5deb0b..1ab50ab733 100644
--- a/packages/plugins/library/README.md
+++ b/packages/plugins/library/README.md
@@ -39,6 +39,6 @@
 
 ## 表格资料
 
-CSV/XLSX 可上传、按类型检索并引用到任务；原始文件按字节保留。Host 转换通过 Office 的公开 `workdsh-plugin-office/tabular` 入口复用 CSV 解码/解析及 ExcelJS。CSV 支持 UTF-8、GB18030、UTF-16，以及逗号、分号和制表符；XLSX 提取工作表名称和单元格已有值，公式不重新计算，图表、图片和格式不进入检索文本。检索文本最多 1500 行/120 列/24000 单元格，XLSX 最多 20 个工作表；截取会显示警告，完整原件仍可下载。
+CSV/XLSX 可上传、按类型检索并引用到任务；原始文件按字节保留。Host 转换在构建时复用 Office 的公开 `workdsh-plugin-office/tabular` 入口的 CSV 解码/解析；表格提取模块随 Library 构建，运行时复用 ExcelJS，无需安装或激活 Office 插件即可导入和检索。CSV 支持 UTF-8、GB18030、UTF-16，以及逗号、分号和制表符；XLSX 提取工作表名称和单元格已有值，公式不重新计算，图表、图片和格式不进入检索文本。检索文本最多 1500 行/120 列/24000 单元格，XLSX 最多 20 个工作表；截取会显示警告，完整原件仍可下载。
 
 原件预览通过公开可选注册表复用 Office：CSV 为只读表格，XLSX 使用现有隔离编辑器，导出为副本，不覆盖资料库修订。未启用 Office 预览时显示检索文本。个人与企业 Desktop、Web 复用相同导入和预览实现，实际资料授权保持不变。
diff --git a/packages/plugins/library/package.json b/packages/plugins/library/package.json
index 75f8675635..ee0ed92063 100644
--- a/packages/plugins/library/package.json
+++ b/packages/plugins/library/package.json
@@ -76,13 +76,14 @@
     "react": "19.2.4",
     "workdsh-contracts": "workspace:*",
     "workdsh-ui": "workspace:*",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.2"
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.2",
+    "workdsh-plugin-office": "workspace:*"
   },
   "dependencies": {
     "jszip": "3.10.1",
     "pdfjs-dist": "5.4.624",
     "zod": "4.4.3",
-    "workdsh-plugin-office": "workspace:*"
+    "exceljs": "4.4.0"
   },
   "dsh": {
     "bundle": {
diff --git a/packages/plugins/library/src/client/LibraryReferencePage.tsx b/packages/plugins/library/src/client/LibraryReferencePage.tsx
index 40d5230dc9..b935ed9584 100644
--- a/packages/plugins/library/src/client/LibraryReferencePage.tsx
+++ b/packages/plugins/library/src/client/LibraryReferencePage.tsx
@@ -28,7 +28,8 @@ export function LibraryReferencePage({ management, previewRegistry, useTabInfo }
           if (!active) return;
           if (params.kind === 'html') setHtml(new TextDecoder().decode(bytes));
           else if (params.kind === 'pdf') setUrl(URL.createObjectURL(new Blob([bytes as BlobPart], { type: 'application/pdf' })));
-          else setOffice({ name: params.name ?? '资料', kind: params.kind, bytes } as LibraryOriginalPreviewInput);
+          else if (previewRegistry.canOpen(params.kind)) setOffice({ name: params.name ?? '资料', kind: params.kind, bytes } as LibraryOriginalPreviewInput);
+          else setText(await management.readText(params.assetId!, params.revisionId));
         } else setText(await management.readText(params.assetId!, params.revisionId));
       } catch (cause) { if (active) setError(cause instanceof Error ? cause.message : '资料读取失败。'); }
     };
diff --git a/packages/plugins/library/tests/library.test.mjs b/packages/plugins/library/tests/library.test.mjs
index ce8766bb44..56d31a621e 100644
--- a/packages/plugins/library/tests/library.test.mjs
+++ b/packages/plugins/library/tests/library.test.mjs
@@ -255,3 +255,10 @@ test('tabular extraction reports truncation and never evaluates formulas', async
   const controller = new AbortController(); controller.abort();
   await assert.rejects(extractTabularText('csv', utf16, controller.signal), { name: 'AbortError' });
 });
+
+test('Library release imports tabular extraction without an unpublished Office runtime dependency', async () => {
+  const manifest = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+  assert.equal(manifest.dependencies['workdsh-plugin-office'], undefined);
+  const host = await readFile(new URL('../dist/index.js', import.meta.url), 'utf8');
+  assert.doesNotMatch(host, /(?:from\s*|import\s*\()\s*["']workdsh-plugin-office/);
+});