workdsh-plugin-library

资料库

状态：实施中。Alpha.1 已建立本地资料领域服务、WorkBuddy 式目录树与原内容工作区、对话固定修订引用和 Markdown/TXT 草稿发布流程。

• 实现阶段：P1
• 主任务：P1-06，详见 需求与范围
• 职责：本地资产与修订、目录树、确定性文本转换与检索、工具读写、成果关联；团队提供方可替换。
• 边界：不复制 Harness 会话日志，HTML 不获 Host 权限。

开发前阅读

规则、验收要求、契约、团队设计。

所有业务操作遵守服务端主体和组织上下文；页面与 Agent 工具调用相同领域服务。可选功能接入通过公开契约与生命周期注入。

对话右侧资料引用预览使用 Harness 官方语义颜色，跟随浅色、深色和系统主题；HTML 原件在沙箱中保留自己的页面样式。

验收与下一步

完成对应 PLAN 任务及 验收矩阵 场景，记录真实测试证据后才更新为完成。当前 Host 与 Client 入口可加载，数据保存到 $DSH_HOME/library。支持 MD、TXT、HTML、PDF、DOCX、PPTX；所有格式保留原件并生成独立检索文本。HTML 在无 Host 权限、无网络访问的沙箱中按原始样式和内联交互展示；PDF 可直接预览；安装 Office 插件时，Word 使用 docx-preview、PowerPoint 使用 pptx-react-viewer 打开原件，未安装时回退为派生检索文本和原件下载。Library 与 Office 通过公开可选预览注册表协作，不互相导入运行时内部实现。

发布包可通过 corepack pnpm probe:library 验证独立安装、两次冷启动、卸载保留 $DSH_HOME/library、重新安装和资料恢复。页面支持搜索、最近、本地产物、完整目录树、目录内新建与导入、移动、添加到当前任务、停用与重新启用；停用会立即阻断历史任务引用的正文读取。搜索结果显示目录、类型、来源、修订、转换状态和页/段/幻灯片位置。

单文件上限为 50 MiB，本地不可变原件修订合计上限为 5 GiB。转换器意外失败时保留原件并标记“转换失败/不可搜索”；伪类型、损坏文件、压缩炸弹、路径逃逸和取消不会创建资产。

修订 6 的必做补充

详见 项目设计 和 官方依据。新增目录仍为规划占位；各自实现 PLAN 的 P1 补充项并验证 J01—J10 适用项。

实现前必须阅读 ADR-0007，完成相应 B/Q 边界用例；不可只用提示词或 UI 达成权限保障。

页面及配置弹窗随 Harness 原生主题变化；文件类型图标与文档原文保留自身颜色。

共享 Host 可以使用 registerLibraryConnection(ctx, selector) 的可选可信服务选择器：返回服务端建立的 actor、LibraryService 与 verify，路由执行前后核验，客户端 payload 不能选择成员。个人默认调用不传 selector。成员实例需要独立对象目录及存储 facility/backend；同一官方 facility 不允许重复 open 同名 domain，仅 isolate LibraryManager 不足以隔离。此入口只负责 HTTP 管理，Agent 工具和资料上下文仍需匹配成员服务后才能开放完整企业 Profile。

可选 Host 成员服务选择

公开 registerLibraryConnection、registerLibraryTools、registerLibraryContextInjection 接受可选可信选择器，返回服务端 actor、LibraryService 和 verify。工具与上下文使用实际 Agent 选择，不从模型参数读取主体；操作前后核验，拒绝不匹配的会话上下文。默认 apply 不传选择器，保持个人行为。企业装配必须提供隔离存储和可撤权身份；这些入口本身不是文件执行沙箱。