KDocs 0.4.6-rc.1 — 官方 PDF 预览

KDocs 0.4.6-rc.1

版本号保留 0.4.6-rc.1。按用户要求，本 GitHub Release 已取消预发布标记并设为 Latest；代码、标签和安装包保持原冻结内容，以下验收边界继续适用。

桌面端改为官方 Session 文件 Tab：原生 PDF 经金山官方下载，DOC/DOCX/PPT/PPTX 转换后写入本机私有临时缓存。删除旧 dsh-pdf-viewer 的依赖、注入及自定义 PDF 渲染流程；保留 Web iframe、文本阅读及引用。

宿主核心可选 peer 为 >=0.2.0-rc.2，开发及 macOS 实测版本为 0.2.0-rc.2。签名下载地址留在 Host，单文件30 MiB、缓存120 MiB/20条、流式校验、原子刷新。

安装：下载 TGZ，在 DSH 插件管理页添加本地安装包，然后完整退出并重开 DSH。先安装并登录官方 kdocs-cli。CLI Profile 使用 dsh plugin --profile add <TGZ路径>。本候选不发布 npm。

本机已在旧 Viewer 关闭并冷启动后验证 PDF/DOCX、缩放、多页滚动、文字复制、标签复用和缓存刷新。如果机器上仍启用旧 Viewer，宿主可能优先选择其渲染器；停用它即可使用官方内置阅读器。

完整测试311项，309通过，2项为开发前已有的云盘根目录Word样本缺失；本轮新增13项通过。Windows、其他宿主版本、真实PPT/PPTX、全新桌面组合安装及退出整个DSH后的缓存磁盘回读仍待验收；这些限制不作为稳定版完成声明。

校验包及安装说明请使用 SHA256SUMS.txt。

KDocs 0.4.5 — 团队文档库与宿主依赖修复

KDocs 0.4.5 包含团队文档库入口、共享/搜索目录展开及宿主核心依赖修复。目标宿主 DSH Desktop 0.2.0-rc.2；宿主核心为可选 peer，避免安装时引入第二套核心。

下载 TGZ，经官方插件管理器更新并完整退出重开；详见 INSTALL.md。kdocs-cli 由成员自行安装登录；PDF 渲染依赖独立 dsh-pdf-viewer。

验证：305项测试中303通过，2项既有真实云盘Word/搜索失败。最终包通过官方安装服务、隔离新装/升级、实际桌面Electron专用加载树及配置保存后冷启动验证。尚未完成本次完整默认桌面界面、成员电脑及Windows验收。

dsh-kdocs-inside 0.4.3 — CLI 配置与自动检测冻结版

用户验收通过并冻结的 dsh-kdocs-inside 0.4.3。

• 新增插件内 CLI 配置页：路径、自动检测、保存、连接检测与官方帮助。
• 同组灰色卡片、组内分割线、12px 圆角；检测成功显示绿色小字。
• 保存 CLI 路径后即时生效，登录凭据由官方 CLI 管理。
• 包含此前本地预览闪烁与右键高亮修复；桌面 PDF 渲染交由 dsh-pdf-viewer，需另行安装该插件。

下载 dsh-kdocs-inside-0.4.3.tgz，在 DSH 插件管理页添加本地包，完全退出重开。需先安装并登录官方 kdocs-cli；配置页要求 configForms/volatile 设置能力，已在桌面 0.2.0-rc.2 实测。详细安装步骤见附件。

验证：配置专项 8/8；隔离安装包完整测试 275 通过、24 账号相关用例跳过、0 失败。真实账号测试有 2 项因根目录缺少预设 Word 文件失败；桌面冷启动、自动检测、保存、连接检测和视觉已实测。Web 与 Windows 本次未实测。

此次只更新 dsh-kdocs-inside 与仓库首页说明，独立 kdocs-settings 保留。不发布 npm。

dsh-kdocs-inside 0.4.1 — 评审收口

0.4.0 评审收口版，无新功能

• PDF 大小护栏：导出的 PDF 经 base64 单条消息穿过 Remote，大扫描件会先撞上 IPC 消息大小与 Host 内存。新增 maxPdfBytes（单份上限 30 MB，超限给出明确报错并建议「在金山文档打开」）与 pdfCacheMaxBytes（缓存总字节预算 120 MB，与 pdfCacheMax 一起按最旧逐出）
• 文档修正：CHANGELOG 头部改为通用说明（0.2.0→0.2.6 核对方法下沉文末）；README 删除过时的目录名历史句

验证

• 279/279 测试通过（新增护栏套件 4 条）
• npm 已发布 dsh-kdocs-inside@0.4.1

双端适配（web 在线编辑 / 桌面端 PDF 预览）见 v0.4.0。

dsh-kdocs-inside 0.4.0 — 双端适配

双端适配：同一份包，两种可行的「原版」

	Web（浏览器）	桌面端（Electron，官方桌面应用 0.1.7-rc.2 实测）
面板 / 文件树 / 搜索 / 文本预览 / 引用	✅ 一致	✅ 一致
「原版」预览	内嵌金山文档在线编辑器（iframe，可读可编辑）	PDF 导出预览（只读，pdf.js 渲染，缩放 + 逐页）
编辑	预览里直接编辑	「在金山文档打开」跳系统浏览器

为什么桌面端不是 iframe

桌面端的 iframe 读的是应用自己的 Chromium profile，与系统浏览器不共享登录态；实测金山授权接口在该嵌入上下文恒定拒绝（授权码签发 403，会话 cookie 无法建立）。PDF 导出路径全程走 kdocs-cli Token，是唯一不依赖网页会话的版式预览通道：

wps export 建任务 → query-export 轮询 → 签名 URL 下载（无需 cookie）→ 客户端懒加载内置 pdf.js 渲染

要点

• web 端零变化：iframe 在线编辑照旧；PDF 渲染 chunk（pdf.js v3.11.174，Apache-2.0）只在桌面端首次预览时懒加载，web 端永不下载
• 桌面端首次预览有数秒导出延迟；文档改动后点「↻」重新导出
• 撤回 0.3.1（未发布）曾尝试的内嵌网页登录页——真机证明不可行
• 新增 Host remote 方法 exportPdf（导出生成 PDF 副本，不回写原文档）
• 配置新增 exportTimeoutMs / exportPollIntervalMs / pdfCacheMax

验证

• 273/273 测试通过（含真机活测：真实导出 / 缓存 / 强制刷新）
• 负向对照：拆掉桌面门控后契约断言如期转红；web 行为由行为级断言守住
• 真机双端验收：桌面端 macOS arm64 PDF 渲染保真；web 端回归无变化

需要 DSH ≥ 0.1.7-rc.1。安装与前置条件（kdocs-cli）见 README。

K Docs 0.2.8 — 仓库改名与元数据修正

金山文档接入 DeepSeek Harness 的右栏套件。本仓库含两个可独立安装的包。
本仓库的版本号以主包 dsh-kdocs-inside 为准（另一个包有自己的版本线）：

包	当前版本	说明
dsh-kdocs-inside	0.2.8	主包：云盘面板 / 文档预览 / 引用到对话 / 4 个只读 Agent 工具
kdocs-settings	0.2.1	设置页的「金山文档」只读状态分区（版本线独立）

两者都已发布到 npm，本 Release 附带的 .tgz 与 npm 上的产物逐字节一致，可直接下载安装。

---

本版内容

仓库改名

vansonffff/dsh-kdocs → vansonffff/dsh-kdocs-sidebar。
GitHub 会为旧地址保留跳转，但 npm 元数据里的 repository / homepage / bugs
是发布时写死的，不随改名更新，已在本版一并纠正。

（跳转有一个已知失效场景：若旧仓库名被他人重新占用，重定向即断开 ——
所以正确做法是把地址写对，而不是依赖跳转。）

包名、入口、repository.directory 均未变化。

自上一个发布（0.2.0）以来的主要变化

表现层

• 文件类型图标：文件夹 / Word / Excel / PowerPoint / PDF / 文本 / 图片 / 通用
• 顶部导航去胶囊化：六个入口改为文字 + 下划线，任何宽度都保持一行
• 搜索区压缩：三种搜索范围移入搜索框行内，搜索能力一项未减
• 行内 ··· 快捷操作（悬浮 / 键盘聚焦出现，绝对定位、不挤压文件名）
• 右键菜单分组精修、预览工具栏分段控件化（高度未增，实测反而变矮）
• 信息密度提升：行高 29px → 24px，同屏可见文件 23 行 → 30 行

修复

• 「在金山文档打开」/「复制链接」失败时毫无反应 → 现在显示失败原因
• 标签页标题组件缺错误边界 → 已补（紧凑呈现）
• 文件行悬浮导致整个面板变白 → 根因是三处结构性漏洞，均已修
• 搜索态下点击视图标签看到空搜索页而非该视图
• 文件夹重命名丢掉 .v1 这类点后缀（会静默改掉文件名）
• 分页失败后无法重试
• 0.2.0 的两个分页工具输出契约写反：kdocs_list / kdocs_search 在 0.2.0 上
  每次调用都会 INVALID_TOOL_OUTPUT —— 从 0.2.0 升级上来的人请优先更新这一项

完整变更见仓库内的 CHANGELOG.md。

---

安装

# 主包
dsh plugin --profile web add dsh-kdocs-inside

# 可选：设置页状态分区
dsh plugin --profile web add kdocs-settings

前置条件：先装好并登录金山官方的 kdocs-cli（本插件不自带、也不代管凭据；
Token 由那个 CLI 存进系统密钥链，插件从不读取或转发）。

兼容性

需要 DSH ≥ 0.1.5 · Node ≥ 22.19