bs-engineering-suite 2.9.0-rc.11 → 2.9.0-rc.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +36 -34
- package/cordis.patch.yml +8 -0
- package/docs/content-packs/ONLINE_LIBRARY.md +15 -0
- package/docs/content-packs/TEMPLATE_PACKAGE_GUIDE.md +31 -0
- package/docs/rag-packs/library.md +57 -0
- package/docs/windows-install.md +29 -0
- package/docs/windows-usage.md +30 -0
- package/node_modules/@buildseek/content-packs/lib/bundle.d.ts +3 -1
- package/node_modules/@buildseek/content-packs/lib/bundle.js +28 -6
- package/node_modules/@buildseek/content-packs/lib/bundle.js.map +1 -1
- package/node_modules/@buildseek/content-packs/lib/office-xml.d.ts +2 -0
- package/node_modules/@buildseek/content-packs/lib/office-xml.js +9 -0
- package/node_modules/@buildseek/content-packs/lib/office-xml.js.map +1 -0
- package/node_modules/@buildseek/content-packs/lib/repository.d.ts +10 -3
- package/node_modules/@buildseek/content-packs/lib/repository.js +395 -129
- package/node_modules/@buildseek/content-packs/lib/repository.js.map +1 -1
- package/node_modules/@buildseek/content-packs/lib/types.d.ts +1 -0
- package/node_modules/@buildseek/content-packs/lib/xlsx.d.ts +3 -0
- package/node_modules/@buildseek/content-packs/lib/xlsx.js +13 -6
- package/node_modules/@buildseek/content-packs/lib/xlsx.js.map +1 -1
- package/node_modules/@buildseek/diagnostics/lib/client.js +6 -6
- package/node_modules/@buildseek/diagnostics/lib/sanitize.js +1 -1
- package/node_modules/@buildseek/diagnostics/lib/store.js +18 -7
- package/node_modules/@buildseek/diagnostics/lib/updates.js +23 -11
- package/node_modules/@buildseek/diagnostics/lib/version.js +1 -1
- package/node_modules/@buildseek/harness-engineering-document-plugin/dist/client/suite-settings.d.ts +1 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/dist/client/workbench-fact-editor.d.ts +1 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/dist/client.js +25 -5
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/content-pack-rules.js +2 -1
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/content-pack-validation.js +6 -2
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/content-packs.js +116 -38
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/files/evidence.js +3 -1
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/files/materials.js +116 -39
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/files/renderers.js +2 -1
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/files/xlsx-preview-layout.js +1 -1
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/online-pack-worker.js +17 -18
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/online-packs.js +6 -5
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/orchestrator.js +25 -5
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-content-flow.js +149 -23
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/application.js +140 -81
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/artifact-mirror.js +10 -6
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/bridges.js +6 -4
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/contract.js +1 -1
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/evidence.js +34 -9
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/filesystem.js +6 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/full-before.js +91 -34
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/generation.js +54 -18
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/plan.js +1 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/preview-leases.js +10 -3
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/project-basic-reader.js +245 -47
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/project-setup.js +27 -18
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/store.js +4 -4
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/schemas.js +8 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/service.js +4 -1
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/typert.host.js +1 -1
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/content-packs.d.ts +87 -18
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/files/materials.d.ts +2 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/model.d.ts +1 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-content-flow.d.ts +75 -18
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/application.d.ts +1 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/artifact-mirror.d.ts +1 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/bridges.d.ts +5 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/evidence.d.ts +3 -2
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/filesystem.d.ts +2 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/plan.d.ts +1 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/preview-leases.d.ts +1 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/project-basic-reader.d.ts +14 -9
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/schemas.d.ts +10 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/workbench/application.d.ts +3 -0
- package/node_modules/@buildseek/harness-engineering-document-plugin/lib/workbench/application.js +45 -4
- package/node_modules/@buildseek/harness-engineering-document-plugin/package.json +2 -1
- package/node_modules/@buildseek/harness-oag-plugin/dist/client/content-packs.d.ts +4 -0
- package/node_modules/@buildseek/harness-oag-plugin/dist/client/index.d.ts +2 -1
- package/node_modules/@buildseek/harness-oag-plugin/dist/client/suite-settings.d.ts +1 -0
- package/node_modules/@buildseek/harness-oag-plugin/dist/client.js +83 -18
- package/node_modules/@buildseek/harness-oag-plugin/dist/content-packs.js +22 -5
- package/node_modules/@buildseek/harness-oag-plugin/dist/native/buildseek_oag_node.darwin-arm64.node +0 -0
- package/node_modules/@buildseek/harness-oag-plugin/dist/native/buildseek_oag_node.win32-x64-msvc.node +0 -0
- package/node_modules/@buildseek/harness-oag-plugin/dist/native/buildseek_oag_node.win32-x64-msvc.node.json +3 -3
- package/node_modules/@buildseek/harness-oag-plugin/lib/config.js +7 -0
- package/node_modules/@buildseek/harness-oag-plugin/lib/remote-gateway.js +13 -11
- package/node_modules/@buildseek/harness-oag-plugin/lib/semantic-registry.js +67 -17
- package/node_modules/@buildseek/harness-oag-plugin/lib/service.js +11 -8
- package/node_modules/@buildseek/harness-oag-plugin/lib/tool-adapter.js +26 -10
- package/node_modules/@buildseek/harness-oag-plugin/lib/typert.host.js +91 -21
- package/node_modules/@buildseek/harness-oag-plugin/lib/typert.remote-client.d.ts +4 -1
- package/node_modules/@buildseek/harness-oag-plugin/lib/typert.remote-client.d.ts.map +1 -1
- package/node_modules/@buildseek/harness-oag-plugin/lib/typert.remote-client.js +58 -11
- package/node_modules/@buildseek/harness-oag-plugin/lib/types/api.d.ts +1 -1
- package/node_modules/@buildseek/harness-oag-plugin/lib/types/authorization.d.ts +1 -0
- package/node_modules/@buildseek/harness-oag-plugin/lib/types/config.d.ts +1 -1
- package/node_modules/@buildseek/harness-oag-plugin/lib/types/remote-gateway.d.ts +2 -1
- package/node_modules/@buildseek/harness-oag-plugin/lib/types/semantic-registry.d.ts +18 -7
- package/node_modules/@buildseek/harness-oag-plugin/lib/types/service.d.ts +6 -5
- package/node_modules/@buildseek/harness-oag-plugin/lib/types/tool-adapter.d.ts +1 -0
- package/node_modules/@buildseek/harness-rag-plugin/data/library/bs-rag-national-building-2026.11-r1.zip +0 -0
- package/node_modules/@buildseek/harness-rag-plugin/dist/client/suite-settings.d.ts +1 -0
- package/node_modules/@buildseek/harness-rag-plugin/dist/client.js +308 -39
- package/node_modules/@buildseek/harness-rag-plugin/lib/core.js +201 -37
- package/node_modules/@buildseek/harness-rag-plugin/lib/local-folder.js +58 -14
- package/node_modules/@buildseek/harness-rag-plugin/lib/project-setup-read.js +5 -0
- package/node_modules/@buildseek/harness-rag-plugin/lib/rag-pack-library.js +283 -59
- package/node_modules/@buildseek/harness-rag-plugin/lib/retrieval-gateway.js +44 -30
- package/node_modules/@buildseek/harness-rag-plugin/lib/retrieval-lifecycle.js +112 -38
- package/node_modules/@buildseek/harness-rag-plugin/lib/retrieval-scope.js +1 -1
- package/node_modules/@buildseek/harness-rag-plugin/lib/retrieval-service.js +297 -139
- package/node_modules/@buildseek/harness-rag-plugin/lib/service.js +21 -9
- package/node_modules/@buildseek/harness-rag-plugin/lib/tool-adapter.js +15 -13
- package/node_modules/@buildseek/harness-rag-plugin/lib/typert.host.js +447 -25
- package/node_modules/@buildseek/harness-rag-plugin/lib/typert.remote-client.d.ts.map +1 -1
- package/node_modules/@buildseek/harness-rag-plugin/lib/typert.remote-client.js +255 -6
- package/node_modules/@buildseek/harness-rag-plugin/lib/types/api.d.ts +1 -1
- package/node_modules/@buildseek/harness-rag-plugin/lib/types/core.d.ts +43 -1
- package/node_modules/@buildseek/harness-rag-plugin/lib/types/index.d.ts +1 -1
- package/node_modules/@buildseek/harness-rag-plugin/lib/types/local-folder.d.ts +2 -0
- package/node_modules/@buildseek/harness-rag-plugin/lib/types/project-setup-read.d.ts +12 -0
- package/node_modules/@buildseek/harness-rag-plugin/lib/types/rag-pack-library.d.ts +14 -0
- package/node_modules/@buildseek/harness-rag-plugin/lib/types/retrieval-lifecycle.d.ts +15 -3
- package/node_modules/@buildseek/harness-rag-plugin/lib/types/retrieval-service.d.ts +27 -6
- package/node_modules/@buildseek/harness-rag-plugin/lib/types/service.d.ts +18 -0
- package/node_modules/@buildseek/platform/project-setup.d.ts +10 -6
- package/node_modules/@buildseek/platform/project-setup.js +684 -31
- package/node_modules/@dsh-engineering/workbench/client/bundle.js +343 -138
- package/node_modules/@dsh-engineering/workbench/client/entry-connection.d.ts +1 -1
- package/node_modules/@dsh-engineering/workbench/client/entry.d.ts +2 -0
- package/node_modules/@dsh-engineering/workbench/client/native-session-observer.d.ts +2 -0
- package/node_modules/@dsh-engineering/workbench/client/project-controller.d.ts +8 -0
- package/node_modules/@dsh-engineering/workbench/client/project-workspace.d.ts +3 -2
- package/node_modules/@dsh-engineering/workbench/client/suite-updates.d.ts +2 -0
- package/node_modules/bs-engineering-docs/client/bundle.js +18 -13
- package/node_modules/bs-engineering-docs/lib/agent.js +53 -16
- package/node_modules/bs-engineering-docs/lib/api.js +54 -80
- package/node_modules/bs-engineering-docs/lib/extract/scan.js +30 -4
- package/node_modules/bs-engineering-docs/lib/generate/candidate.js +17 -0
- package/node_modules/bs-engineering-docs/lib/generate/run.js +12 -8
- package/node_modules/bs-engineering-docs/lib/index.js +30 -2
- package/node_modules/bs-engineering-docs/lib/project-tools.js +32 -5
- package/node_modules/bs-engineering-docs/lib/store.js +298 -243
- package/node_modules/bs-engineering-docs/lib/util/errors.js +2 -0
- package/node_modules/dsh-sidebar-office-preview/client/bundle.js +32 -32
- package/node_modules/dsh-sidebar-office-preview/client/src/parse.js +8 -1
- package/package.json +6 -1
- package/ui-compat/darwin-arm64/receipt.json +6 -6
- package/ui-compat/darwin-arm64/vendor/desktop/@deepseek-ai/dsh-client-ui-plugin-manager/lib/client.js +10 -2
- package/ui-compat/darwin-arm64/vendor/npm/@deepseek-ai/dsh-client-ui-plugin-manager/lib/client.js +10 -2
- package/ui-compat/win32-x64/receipt.json +6 -6
- package/ui-compat/win32-x64/vendor/desktop/@deepseek-ai/dsh-client-ui-plugin-manager/lib/client.js +10 -2
- package/ui-compat/win32-x64/vendor/npm/@deepseek-ai/dsh-client-ui-plugin-manager/lib/client.js +10 -2
package/README.md
CHANGED
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
# BS工程资料系统
|
|
2
2
|
|
|
3
|
-
> `2.9.0-rc.
|
|
3
|
+
> `2.9.0-rc.12` 通用包:修复工程资料、模板语义、检索回执、上传恢复和原生工程入口问题。支持 macOS arm64 / Windows x64,目标宿主 DSH `0.2.2-rc.3`。Windows 与独立 Desktop 原生运行验证为 NOT_RUN。
|
|
4
4
|
|
|
5
|
-
当前套件为 **`2.9.0-rc.
|
|
5
|
+
当前套件为 **`2.9.0-rc.12`**,目标宿主为 DSH `0.2.2-rc.3`,统一发布标签为 **`bs-v2.9.0-rc.12`**。[下载 rc.12](https://github.com/jdbsh-AI/bs-engineering-suite/releases/tag/bs-v2.9.0-rc.12) · **[模板包安装与使用说明](docs/content-packs/TEMPLATE_PACKAGE_GUIDE.md)**。在 DSH 插件页直接输入 `bs-engineering-suite` 安装;npm 用户可运行 `npm install bs-engineering-suite`,需要固定版本时使用 `bs-engineering-suite@2.9.0-rc.12`。已从 npm 安装的用户可在插件详情的版本区更新;rc 版本需勾选“显示预发布版本”,再按宿主提示重启。
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
7
|
+
随包指南可离线查看。[Windows 安装](docs/windows-install.md) · [Windows 使用](docs/windows-usage.md)。历史记录和动画链接需要有权访问私有源码仓库。
|
|
8
|
+
|
|
9
|
+
RAG资料在 **插件 → BS工程资料系统 → RAG资料包管理** 中刷新与下载安装,详情见[RAG资料库说明](docs/rag-packs/library.md)。全国房建在线包为 `2026.11-r2`,套件内置规范为 `2026.11-r2-local`;专业、适用性及内部研究状态保持原样。
|
|
10
|
+
**操作准则**:右侧工程资料工作台负责绑定工程文件夹、新对话、资料阅览以及任务和成果核对;中央DSH原生对话区负责与AI交流、提出资料需求和资料生成;模板包、配套语义和RAG资料包统一在BS插件管理页管理。首页可新建或进入工程,工程状态自动更新。“BS工程资料介绍”按钮可打开完整介绍。
|
|
9
11
|
|
|
10
12
|
**更新策略**:打开BS插件管理页时检查插件、模板包和RAG资料包的新版本;页面可见期间每5分钟再检查,只读取元数据。可更新时,名称右侧显示对应更新按钮。预发布选项会记住本浏览器的选择;列表只提供当前宿主平台与架构适用的版本及通用包。点击后才下载安装,插件更新可能需要按DSH提示重启。检查或安装失败时显示原因,不把旧目录误判为新版本。
|
|
11
13
|
|
|
@@ -17,21 +19,21 @@ RAG资料在 **插件 → BS工程资料系统 → RAG资料包管理** 中刷
|
|
|
17
19
|
|
|
18
20
|
| 模板包 | 版本 | 内容 | 获取与安装 |
|
|
19
21
|
| --- | --- | --- | --- |
|
|
20
|
-
| 广东省房屋建筑项目资料模板包 | 0.3.
|
|
22
|
+
| 广东省房屋建筑项目资料模板包 | 0.3.4 | 840份Excel资产、配套语义、字段映射及选表目录 | [在线模板库(COS)](docs/content-packs/ONLINE_LIBRARY.md) · [本地 ZIP 导入](docs/content-packs/TEMPLATE_PACKAGE_GUIDE.md) |
|
|
21
23
|
|
|
22
|
-
|
|
24
|
+
模板包独立于 BS 插件版本更新。打开 **插件 → BS工程资料系统 → 模板包管理 → 在线模板库**,点「主动刷新在线目录」即可查询当前发布的版本。COS 目录和 ZIP 支持匿名访问。已持有内容 ZIP 时可在「已安装」展开「导入本地模板包(ZIP)」。GitHub Packages 的 [0.3.3 备用发布记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/content-packs/PACKAGES.md)供历史核对。
|
|
23
25
|
|
|
24
|
-
配套的 **广东省房屋建筑项目资料模板包** 当前内容版本为0.3.
|
|
26
|
+
配套的 **广东省房屋建筑项目资料模板包** 当前内容版本为0.3.4:包含840份Excel资产、RDF/SHACL、字段规则和选表目录。已移除840份逐表PDF保真文件,保留Word来源及正文/附册等依据PDF。导入后从本机内容库读取,无需每次直连GitHub;旧任务继续固定原包与语义修订。目录优化和3090实测见[性能记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/content-packs/CATALOGUE_PERFORMANCE.md)。插件和模板内容分别版本管理。
|
|
25
27
|
|
|
26
|
-
|
|
28
|
+
当前安装与模板操作以本页顶部的随包指南为准。文中标注的旧版记录用于查阅历史验证和回滚。
|
|
27
29
|
|
|
28
|
-

|
|
30
|
+

|
|
29
31
|
|
|
30
32
|
**bs-v2.9.0-rc.4:新增匿名在线模板库,支持刷新、下载校验、整包安装、取消重试和后台继续;保留 rc.3 双平台适配及 Issue #4 修复。后续版本沿用 `bs-v<semver>` 标签、包内 `<semver>` 的版本线,停止使用 m2.x 作为新发布版本号。**
|
|
31
33
|
|
|
32
|
-
当前 macOS arm64 与 Windows x64 使用同一个 `bs-engineering-suite-2.9.0-rc.
|
|
34
|
+
当前 macOS arm64 与 Windows x64 使用同一个 `bs-engineering-suite-2.9.0-rc.12.tgz`,平台原生文件由加载器选择。DSH 最低版本为 `0.2.2-rc.3`。包含 npm、macOS Desktop 和 Windows Desktop 三套精确 UI 基线;未知字节继续保留宿主原生 UI。历史 rc.4 的3090验证见[rc.4记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/development/bs-v2.9.0-rc.4.md),COS实现的 macOS 隔离验证见[COS记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/development/cos-online-source-20261116.md)。Windows Desktop 实机界面本轮为 `NOT_RUN`,静态包检查不替代实机验收。原适配交付记录保留在 [rc.3 验证记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/development/dsh022-rc3-verification.md)。
|
|
33
35
|
|
|
34
|
-
进入工程资料模式时按钮从左向右填色,再次点击时从右向左恢复普通状态,并返回原生会话。浅深主题、折叠侧栏、键盘与系统减少动态效果均受支持。rc.3
|
|
36
|
+
进入工程资料模式时按钮从左向右填色,再次点击时从右向左恢复普通状态,并返回原生会话。浅深主题、折叠侧栏、键盘与系统减少动态效果均受支持。rc.3 重载后若仍是工程资料模式但右栏已折叠,入口会重新打开工作台,而不是误退出模式。在原生右侧栏新增标签页时,选择「工程资料工作台」可进入工作台。
|
|
35
37
|
|
|
36
38
|
在已有 DSH 的“插件”页输入 `bs-engineering-suite`,或填入通用安装包的本地绝对路径,按宿主提示重启即可,无需解压或另装开发工具。诊断入口位于 **设置 → BS工程资料系统 → 标签栏右侧“下载诊断包”**。历史发布页保留作各自版本的回滚入口;m2.6 历史安装/实机记录保留如下。
|
|
37
39
|
|
|
@@ -39,7 +41,7 @@ RAG资料在 **插件 → BS工程资料系统 → RAG资料包管理** 中刷
|
|
|
39
41
|
|
|
40
42
|
工程材料 → 整理事实 → 匹配依据 → 选择模板 → 形成初稿。Agent 协助处理资料,人保留事实确认、成果验收与专业审核的责任。
|
|
41
43
|
|
|
42
|
-

|
|
44
|
+

|
|
43
45
|
|
|
44
46
|
以上动图为产品理念与流程示意,非实机录屏;资料生成以 Word 路径为例,具体能力以当前版本实际开放范围为准。形成初稿不等于已经通过专业审核。
|
|
45
47
|
|
|
@@ -55,37 +57,37 @@ RAG资料在 **插件 → BS工程资料系统 → RAG资料包管理** 中刷
|
|
|
55
57
|
| Workbench 工程资料工作台 | 工程选择、绑定及工作台交互 |
|
|
56
58
|
| 文档侧栏预览 | Office 预览及工作台文档预览能力 |
|
|
57
59
|
|
|
58
|
-

|
|
60
|
+

|
|
59
61
|
|
|
60
62
|
连线表示模块协作关系,不表示固定的串行执行顺序。
|
|
61
63
|
|
|
62
64
|
品牌资源见 [浅色 Logo](assets/brand/bs-logo-light.svg)、[深色 Logo](assets/brand/bs-logo-dark.svg)、[浅色导航图标](assets/brand/bs-nav-light.svg) 与 [深色导航图标](assets/brand/bs-nav-dark.svg)。卡片图标沿用官方主题颜色方案自动切换;导航采用透明单色蒙版并继承原生 currentColor。
|
|
63
65
|
|
|
64
|
-
设置侧栏只保留“BS工程资料系统”一个入口,顶部“工程语义 / 检索知识库 / 工程资料”三个标签只读展示中文状态,统一保留右上角“下载诊断包”。模板和RAG资料包的下载、导入和管理统一在 **插件 → BS工程资料系统**
|
|
66
|
+
设置侧栏只保留“BS工程资料系统”一个入口,顶部“工程语义 / 检索知识库 / 工程资料”三个标签只读展示中文状态,统一保留右上角“下载诊断包”。模板和RAG资料包的下载、导入和管理统一在 **插件 → BS工程资料系统** 中操作。右侧工作台在工程内设置并显示该工程已绑定的包名与版本。每个模板版本右侧齿轮菜单提供启停、导出、卸载和删除;历史任务引用会阻止永久删除。已启用用蓝字、已停用用红字,同时保留文字状态。“待完善表式798张”统计包内 SEMANTICS_PENDING 表式,既有专业状态未改变。
|
|
65
67
|
|
|
66
|
-
m2.7-dev.1新增最近72小时的脱敏诊断记录,覆盖UI组件、OAG、RAG和EDP。下载ZIP内含JSONL时间线、环境与版本、完整性清单和可读摘要;不含材料正文、聊天或凭据,不自动上传、不调用模型。存储或Host不可用时明确标记记录不完整;细节见[诊断记录说明](docs/development/diagnostics-v1.md)。
|
|
68
|
+
m2.7-dev.1新增最近72小时的脱敏诊断记录,覆盖UI组件、OAG、RAG和EDP。下载ZIP内含JSONL时间线、环境与版本、完整性清单和可读摘要;不含材料正文、聊天或凭据,不自动上传、不调用模型。存储或Host不可用时明确标记记录不完整;细节见[诊断记录说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/development/diagnostics-v1.md)。
|
|
67
69
|
|
|
68
70
|
工程资料入口位于左侧上方导航中,在“自动化任务”下、“工作区”上。进入工程后继续使用原生工程会话及右侧工作台;生成与写入仍要求原有确认。模块开关不是项目授权,安装不会自动选择用户目录、建立工程绑定或调用模型。关闭 EDP 时,依赖它的工作台业务会显示不可用。
|
|
69
71
|
|
|
70
|
-
Windows m2.6 将两份 MIT UI 兼容副本内置于同一安装包的隔离 vendor 目录,仅在宿主 UI 包的精确版本、SHA-256 和当前组合设置均匹配时提供顶部入口;不符合条件时保留原界面,使用宿主可用的入口,并记录稳定的 `BS_UI_FALLBACK` 诊断码。Windows 最终 CI 包已核对全部 1608 个安装文件,顶部唯一入口、对齐与已有成果只读预览均通过,详见[单包验证记录](docs/windows-single-package-check-20261111.md)。工程内只显示当前工程,顶部“工作台首页”可返回工程选择。兼容策略与历史维护说明见 [Windows UI 兼容](docs/windows-ui-compat.md),开发背景见[工作台导航说明](docs/development/workbench-navigation.md)。
|
|
72
|
+
Windows m2.6 将两份 MIT UI 兼容副本内置于同一安装包的隔离 vendor 目录,仅在宿主 UI 包的精确版本、SHA-256 和当前组合设置均匹配时提供顶部入口;不符合条件时保留原界面,使用宿主可用的入口,并记录稳定的 `BS_UI_FALLBACK` 诊断码。Windows 最终 CI 包已核对全部 1608 个安装文件,顶部唯一入口、对齐与已有成果只读预览均通过,详见[单包验证记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/windows-single-package-check-20261111.md)。工程内只显示当前工程,顶部“工作台首页”可返回工程选择。兼容策略与历史维护说明见 [Windows UI 兼容](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/windows-ui-compat.md),开发背景见[工作台导航说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/development/workbench-navigation.md)。
|
|
71
73
|
|
|
72
74
|
m2.10 为 macOS 与 Windows 各保留两套 rc.3 UI 兼容副本:一套对应官方 npm 平台中立字节,另一套对应各平台真实 Desktop `app.asar` 字节。只有平台、宿主版本和该套全部原始 SHA-256 精确匹配时才启用,且不注册 `main` 面板、不调用 `selectPanel`;npm/Desktop 混用、未知字节或不完整清单均保留原生 UI。rc.1/rc.2 夹具只保留为历史输入,不会在 rc.3 宿主误启用。
|
|
73
75
|
|
|
74
|
-
BS 工程会话的欢迎区仅显示 BS 图标和“工程之上·更多可能”,整体对齐下方对话框中心,不显示版本标签;底部继续使用 DSH 原生统计。匹配的 UI 兼容副本在原生左侧运行位置显示 BS 图标、“搬砖中...”和 DSH 实际用时;计时、暂停、holding 和普通会话显示仍由宿主管理。兼容逻辑不修改 DSH 安装目录或全局 Node,不 shadow SDK;本轮 m2.10 只使用隔离 macOS rc.3 Web Profile 验收,未升级本机 3090,也未部署 Windows 包。欢迎区及运行条的开发背景见[欢迎区说明](docs/development/welcome-brand.md)与[运行状态条说明](docs/development/running-status.md)。
|
|
76
|
+
BS 工程会话的欢迎区仅显示 BS 图标和“工程之上·更多可能”,整体对齐下方对话框中心,不显示版本标签;底部继续使用 DSH 原生统计。匹配的 UI 兼容副本在原生左侧运行位置显示 BS 图标、“搬砖中...”和 DSH 实际用时;计时、暂停、holding 和普通会话显示仍由宿主管理。兼容逻辑不修改 DSH 安装目录或全局 Node,不 shadow SDK;本轮 m2.10 只使用隔离 macOS rc.3 Web Profile 验收,未升级本机 3090,也未部署 Windows 包。欢迎区及运行条的开发背景见[欢迎区说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/development/welcome-brand.md)与[运行状态条说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/development/running-status.md)。
|
|
75
77
|
|
|
76
78
|
## 资料阅览台
|
|
77
79
|
|
|
78
|
-
|
|
80
|
+
当前套件已包含资料阅览台。进入工程后,在右侧「工程资料工作台」点击「资料阅览台」→「资料目录」,即可按原文件夹层级浏览已有资料,按名称或相对路径搜索,并按文件类型筛选。目录与搜索结果每页最多 200 项,点击“加载更多”继续查看;资料新增、移动或删除后可点击“刷新”,更新期间可取消并保留上次目录。
|
|
79
81
|
|
|
80
82
|
点击文件后使用 DSH 原生 Word、Excel、PDF、图片或文本预览,具体格式和大小限制由宿主处理。目录与预览优先分栏;窄窗或无法继续分栏时使用同一窗格的标签切换,点击“资料目录”标签返回。切换或解绑工程时清理该阅览台持有的预览,普通 DSH 对话保持原样。
|
|
81
83
|
|
|
82
84
|
目录浏览、检索、刷新和原生预览不调用模型、不产生模型用量。索引只记录文件名、相对路径、类型、大小与更新时间,仅保存在 Host 内存;索引过程不读取正文、不计算全文哈希、不创建业务存储或磁盘索引文件,也不改动源资料或自动登记生成材料。私有目录(如 `.dsh-engineering`)、`.git`、系统杂项和临时锁文件会被排除,符号链接与 junction 不跟随。
|
|
83
85
|
|
|
84
|
-
Windows 11
|
|
86
|
+
历史 Windows 11 实机完成过目录、5000 文件分页、检索、刷新与原生预览检查,见[资料阅览台历史实机记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/windows-document-library-check-20261112.md);Windows 10 尚未实测。操作步骤见 [Windows 使用说明](docs/windows-usage.md),实现与验证边界见[资料阅览台开发说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/development/document-library-v1.md)。
|
|
85
87
|
|
|
86
88
|
同一运行代码的 macOS arm64 包已在全新 DSH `0.2.2-rc.1` 临时 Web Profile 中完成实际安装、重启及上述五类预览,并检查双工程切换、解绑、浅深主题、窄窗和 5000 文件分页;测试目录使用仓库模板副本,检查结束后删除。此结果不扩大为所有 macOS 版本或完整工程生成验收。
|
|
87
89
|
|
|
88
|
-
## M2:证据、目录和官方 Office 预览
|
|
90
|
+
## 历史 M2:证据、目录和官方 Office 预览
|
|
89
91
|
|
|
90
92
|
工程附件可以先暂存,再明确关联到工程或任务;来源、文件版本和访问权限分别核对。文件更换或撤销后,旧引用与预览会失效,恢复原字节也需要重新登记和关联。目录扩展只增加受支持的目录节点;成果镜像保持候选状态,与权威成果分别记录。
|
|
91
93
|
|
|
@@ -93,11 +95,11 @@ Windows 11 实机已完成列明的目录、5000 文件分页、检索、刷新
|
|
|
93
95
|
|
|
94
96
|
正文解析与显示能力分别判断:简单 Word/XLSX 和文本 PDF 可保留段落、工作表、单元格或页码来源;复杂结构、扫描 PDF 或无法完整解析的材料需要人工核对,不补造内容。单份原件上限 25MiB,官方预览上限 16MiB;容器结构、展开量和工作表规模另有限制。宏、外部关系、活动内容、损坏文件和类型不符会被拒绝并说明原因。
|
|
95
97
|
|
|
96
|
-
最终包已完成独立验收和实际 Word/Excel 回归,并安装到现有 3080 开发环境。验收范围、原件校验、兼容性与 M3 边界见 [M2交付说明](docs/project/M2-accepted-release-20261023.md)。XLSX 模板生成、真实重算及质量 G3 留在 M3。
|
|
98
|
+
最终包已完成独立验收和实际 Word/Excel 回归,并安装到现有 3080 开发环境。验收范围、原件校验、兼容性与 M3 边界见 [M2交付说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/project/M2-accepted-release-20261023.md)。XLSX 模板生成、真实重算及质量 G3 留在 M3。
|
|
97
99
|
|
|
98
|
-
##
|
|
100
|
+
## 历史安装与回滚
|
|
99
101
|
|
|
100
|
-
|
|
102
|
+
当前安装见本文开头及 [Windows 安装说明](docs/windows-install.md)。以下记录对应各自的旧版包和宿主。
|
|
101
103
|
|
|
102
104
|
### Windows x64:m2.6 历史安装与实机记录
|
|
103
105
|
|
|
@@ -105,7 +107,7 @@ Windows 11 实机已完成列明的目录、5000 文件分页、检索、刷新
|
|
|
105
107
|
|
|
106
108
|
1. 使用有仓库读取权限的 GitHub 账号打开 [m2.6 发布页](https://github.com/jdbsh-AI/bs-engineering-suite/releases/tag/v0.1.0-alpha.3-m2.6),下载上述 `.tgz`,无需解压。
|
|
107
109
|
2. 在已有 DSH 的官方“插件”页安装,安装源填写下载文件的**本地绝对路径**,例如 `D:\下载\BS 安装包\bs-engineering-suite-0.1.0-alpha.3-m2.6-win32-x64.tgz`。
|
|
108
|
-
3. 按宿主提示重启,检查“BS
|
|
110
|
+
3. 按宿主提示重启,检查“BS工程资料系统”卡片及模块状态。
|
|
109
111
|
|
|
110
112
|
当前源码复用已有 DeepSeek Harness,声明范围为 `>=0.2.2-rc.3 <0.3.0`;已用 `0.2.2-rc.3` 的隔离真实 Web 宿主验证。已经发布的 m2.6/m2.9 Windows 资产仍声明并实测各自的历史 rc 版本。要求宿主实际使用 Node `>=24.9.0`,具备内置 `node:sqlite` / FTS5,并禁止 SQLite 扩展加载。BS 不捆绑 DSH 或 Node,不修改宿主安装目录、系统 PATH 或用户全局 Node。安装不依赖 `postinstall`,官方 CLI 使用 `--ignore-scripts` 也可安装,普通用户无需使用 CLI。
|
|
111
113
|
|
|
@@ -113,9 +115,9 @@ Windows 11 Pro 24H2 x64、build `26100.7840` 已有实测记录;Windows 10 22H
|
|
|
113
115
|
|
|
114
116
|
bs-v2.9.0-rc.3 的 Windows 包与 macOS 包分别携带 rc.3 npm 与对应平台 Desktop 两套 UI 兼容基线,并记录目标平台、变体、完整版本和全部原始摘要。匹配时启用上方入口及 BS 运行状态;npm/Desktop 混用、未知或不同字节的 Desktop 构建保持原生回退。Windows Desktop 的实际界面与持久化验收仍为 `NOT_RUN`,不能以字节夹具、包级或策略级测试代替。
|
|
115
117
|
|
|
116
|
-
单包已实测升级、停用、卸载和重新安装,重启后原生 UI 可恢复,profile patch 摘要保持不变。最终 Windows CI 与安装字节核对通过;发布后下载字节核对结果另记于[单包验证记录](docs/windows-single-package-check-20261111.md)。
|
|
118
|
+
单包已实测升级、停用、卸载和重新安装,重启后原生 UI 可恢复,profile patch 摘要保持不变。最终 Windows CI 与安装字节核对通过;发布后下载字节核对结果另记于[单包验证记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/windows-single-package-check-20261111.md)。
|
|
117
119
|
|
|
118
|
-
此前 m2.5 修复安装在 D 盘一个合成任务中完成 GD-C1-344 生成和预览,`professionalReviewStatus=PENDING`,检索依据是合成夹具而非真实规范。详见[安装与状态边界](docs/windows-install.md)、[历史业务记录](docs/windows-business-check-20261111.md)。
|
|
120
|
+
此前 m2.5 修复安装在 D 盘一个合成任务中完成 GD-C1-344 生成和预览,`professionalReviewStatus=PENDING`,检索依据是合成夹具而非真实规范。详见[安装与状态边界](docs/windows-install.md)、[历史业务记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/windows-business-check-20261111.md)。
|
|
119
121
|
|
|
120
122
|
历史分体 UI 层仅用于内部测试机,已由主 Agent 用备份工具移除并归档到 profile 外;普通安装无需额外清理。发现他人手工层或未知配置时保留现场,由维护者迁移。
|
|
121
123
|
|
|
@@ -130,7 +132,7 @@ gh release download v0.1.0-alpha.3-m2.6 --repo jdbsh-AI/bs-engineering-suite \
|
|
|
130
132
|
--pattern 'bs-engineering-suite-0.1.0-alpha.3-m2.6-macos-arm64.tgz' --dir ./bs-suite-download
|
|
131
133
|
```
|
|
132
134
|
|
|
133
|
-
原版 macOS 宿主未提供可选的顶部导航和运行条扩展插槽时,继续使用既有原生侧栏回退入口和原生运行条;不修改宿主源码或全局安装。3090 现有隔离 UI 扩展和 Profile 未被本轮发布验证改动。此限制与本轮资料目录及原生文件预览的使用无关,详见[macOS 验证记录](docs/macos-m26-release-check-20261112.md)。
|
|
135
|
+
原版 macOS 宿主未提供可选的顶部导航和运行条扩展插槽时,继续使用既有原生侧栏回退入口和原生运行条;不修改宿主源码或全局安装。3090 现有隔离 UI 扩展和 Profile 未被本轮发布验证改动。此限制与本轮资料目录及原生文件预览的使用无关,详见[macOS 验证记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/macos-m26-release-check-20261112.md)。
|
|
134
136
|
|
|
135
137
|
### macOS arm64:m2.5 回滚
|
|
136
138
|
|
|
@@ -159,17 +161,17 @@ pnpm build
|
|
|
159
161
|
pnpm test:build
|
|
160
162
|
```
|
|
161
163
|
|
|
162
|
-
Windows x64 原生构建和打包在相应构建环境中执行 `pnpm build:native:windows`、`pnpm pack:windows`、`pnpm verify:windows`,再运行 `pnpm test`。用户安装已发布资产无需这些工具或步骤;维护者流程见 [Windows 构建说明](docs/windows-build.md)。
|
|
164
|
+
Windows x64 原生构建和打包在相应构建环境中执行 `pnpm build:native:windows`、`pnpm pack:windows`、`pnpm verify:windows`,再运行 `pnpm test`。用户安装已发布资产无需这些工具或步骤;维护者流程见 [Windows 构建说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/windows-build.md)。
|
|
163
165
|
|
|
164
166
|
普通构建重新编译各模块 Host 和 Client。本次 rc.3 迁移已用官方 `0.2.2-rc.3` Typert generator / protocol 重生成并核收 EDP、D03、RAG、OAG 与 Workbench 的生成桥;普通构建只按固定清单核验完整字节和 SHA256,不在合并时重生成全局 SDK 声明图。Workbench 继续由固定官方生成器重生成其 Host/Remote。需要开发 EDP 协议时,`sdk:source` 可下载固定官方 `dsh-v0.2.2-rc.3` 源码到被 Git 忽略的 `.cache/deepseek-harness`,或以 `DSH_TARGET_SOURCE` 指定同版本只读源码;协议变更必须单独重生成并审核清单,不属于普通打包。
|
|
165
167
|
|
|
166
168
|
macOS 原生确认载体在包内保留,构建时校验既有签名与摘要;需要重新编译时使用 EDP 的 `build:native-confirm`。OAG 平台构建脚本在 `packages/oag/scripts/`。
|
|
167
169
|
|
|
168
|
-
|
|
170
|
+
历史 m2.6 Windows 交付物路径为 `artifacts/win32-x64/bs-engineering-suite-0.1.0-alpha.3-m2.6-win32-x64.tgz`;`package-receipt.json` 由构建记录字节、SHA256 和内嵌模块,UI 副本清单在包内 `ui-compat/receipt.json`。最终资产摘要、CI 与实机覆盖范围见 [单包验证记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/windows-single-package-check-20261111.md)。源码仓不含项目数据、凭据、会话、原始日志或 node_modules。
|
|
169
171
|
|
|
170
|
-
`test:compat` 覆盖统一依赖、策略与权限、当前客户端导航及 Office 离线解析;功能检查与发布包回执分别核验,不依赖旧独立插件的发布记录。执行范围与侧栏基线输入见[套件测试说明](docs/development/suite-test-contracts.md)。
|
|
172
|
+
`test:compat` 覆盖统一依赖、策略与权限、当前客户端导航及 Office 离线解析;功能检查与发布包回执分别核验,不依赖旧独立插件的发布记录。执行范围与侧栏基线输入见[套件测试说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/development/suite-test-contracts.md)。
|
|
171
173
|
|
|
172
|
-
`verify:package` 同时检查归档中的 Host、Typert、D03 条件导出及本地导入文件。发布前还须对同一归档运行 `test:installed --runtime <DSH安装目录> --artifact <tgz绝对路径> --output <报告目录>`:它在临时 Web Profile 中通过真实安装、Loader 和 Gateway 核对九条严格定义、停启/进程重启、原生模型目录及确认流的拒绝路径,并清理该临时 Profile。当前宿主固定为 `0.2.2-rc.3`,不调用模型。静态包校验不替代此运行检查,详见 [Host 贡献与安装回归](docs/development/typert-host-contribution.md)。
|
|
174
|
+
`verify:package` 同时检查归档中的 Host、Typert、D03 条件导出及本地导入文件。发布前还须对同一归档运行 `test:installed --runtime <DSH安装目录> --artifact <tgz绝对路径> --output <报告目录>`:它在临时 Web Profile 中通过真实安装、Loader 和 Gateway 核对九条严格定义、停启/进程重启、原生模型目录及确认流的拒绝路径,并清理该临时 Profile。当前宿主固定为 `0.2.2-rc.3`,不调用模型。静态包校验不替代此运行检查,详见 [Host 贡献与安装回归](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/development/typert-host-contribution.md)。
|
|
173
175
|
|
|
174
176
|
## 来源与许可
|
|
175
177
|
|
|
@@ -181,12 +183,12 @@ macOS 原生确认载体在包内保留,构建时校验既有签名与摘要
|
|
|
181
183
|
|
|
182
184
|
四仓开放 Issue、PR 承接与历史索引见[迁移记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/main/docs/migrations/consolidation-20261022/README.md),贡献署名见[CONTRIBUTORS.md](https://github.com/jdbsh-AI/bs-engineering-suite/blob/main/CONTRIBUTORS.md)。参考来源位于 `migration-intake/`,不参与当前安装包或运行。
|
|
183
185
|
|
|
184
|
-
##
|
|
186
|
+
## 历史阶段记录
|
|
185
187
|
|
|
186
|
-
M1.5 已按项目负责人 2026-10-22 决定正式收口,旧失败证据保留。M2 已于 2026-10-23 完成独立验收、正式核收并冻结,Excel 官方预览和 Word 回归已交付;M3 尚未启动。阶段历史见 [M1.5交接](docs/project/M15-closure-and-M2-handover-20261022.md)
|
|
188
|
+
M1.5 已按项目负责人 2026-10-22 决定正式收口,旧失败证据保留。M2 已于 2026-10-23 完成独立验收、正式核收并冻结,Excel 官方预览和 Word 回归已交付;M3 尚未启动。阶段历史见 [M1.5交接](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/project/M15-closure-and-M2-handover-20261022.md),当时交付见 [M2说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/project/M2-accepted-release-20261023.md)。四个历史仓库已只读归档,后续维护以本仓为唯一入口。
|
|
187
189
|
|
|
188
190
|
## 模板与配套语义
|
|
189
191
|
|
|
190
192
|
新增统一模板包:Excel、RDF、SHACL、字段映射和规范来源一起安装;任务按所选模板固定语义修订。插件内支持修改、补充依据文件及导出派生版本。
|
|
191
193
|
|
|
192
|
-
|
|
194
|
+
当前使用方式见 [模板包安装与使用说明](docs/content-packs/TEMPLATE_PACKAGE_GUIDE.md)。历史作者资料见 [旧版维护者指南](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/content-packs/USER_GUIDE.md),接口与隔离方式见 [架构说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/content-packs/ARCHITECTURE.md)。该入口形成技术候选,专业规则、实际Office应用和桌面验收分别记录。
|
package/cordis.patch.yml
CHANGED
|
@@ -65,6 +65,14 @@
|
|
|
65
65
|
plugins:
|
|
66
66
|
- id: engineering-workbench-agent
|
|
67
67
|
name: "@buildseek/harness-engineering-document-plugin/agent"
|
|
68
|
+
- id: engineering-project-tools
|
|
69
|
+
name: bs-engineering-docs/agent
|
|
70
|
+
config:
|
|
71
|
+
mode: suite
|
|
72
|
+
- id: tool-ask-user
|
|
73
|
+
name: '@deepseek-ai/dsh-tool-ask-user'
|
|
74
|
+
- id: tool-present
|
|
75
|
+
name: '@deepseek-ai/dsh-tool-present'
|
|
68
76
|
- id: buildseek-rag
|
|
69
77
|
name: "@buildseek/harness-rag-plugin"
|
|
70
78
|
config:
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
# 在线模板库
|
|
2
|
+
|
|
3
|
+
本指南对应 BS `2.9.0-rc.11`。在线目录随内容包独立更新,广东房建 `0.3.4` 是本版指南使用的例子。
|
|
4
|
+
|
|
5
|
+
1. 打开「插件 → BS工程资料系统 → 模板包管理 → 在线模板库」。无需先绑定工程。
|
|
6
|
+
2. 点「主动刷新在线目录」。可以按名称、地区和专业筛选,点「详情与兼容性」核对版本。
|
|
7
|
+
3. 点相应模板版本的「安装」,等待 DSH 下载、校验和提交。下载或校验时可以取消,提交时请等待完成。关闭管理页后,运行中的任务可以继续。若宿主已重启,可先在「已安装」核对结果,再按提示重试。
|
|
8
|
+
4. 回到「已安装」,核对名称、版本和启用状态。需要导入本地文件时,在同一页展开「导入本地模板包(ZIP)」。
|
|
9
|
+
5. 完成后在右侧「工程资料工作台」为工程选用本地版本。操作见 [模板包安装与使用说明](TEMPLATE_PACKAGE_GUIDE.md)。
|
|
10
|
+
|
|
11
|
+
目录和 ZIP 默认由 DSH 主机通过匿名 HTTPS 从腾讯云 COS 广州源读取。安装包含模板、语义、字段映射和选表目录,日常使用从本机内容库读取。在线安装会校验目录中固定的包大小、摘要和成员。普通用户可直接用 COS,出现网络错误时可刷新后重试,或导入已取得的内容 ZIP。
|
|
12
|
+
|
|
13
|
+
已安装版本可通过卡片的「更新」按钮安装兼容新版。工程和历史任务的固定引用按各自版本保留。安装和更新资料包不调用模型。内容库由同一 DSH Home 下的 Profile 共用,在线任务进度按 Profile 保存。
|
|
14
|
+
|
|
15
|
+
原 COS 接入和备用来源的维护细节见 [历史接入记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/content-packs/COS_SOURCE.md)。
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
# 模板包安装与使用说明
|
|
2
|
+
|
|
3
|
+
本指南对应 BS `2.9.0-rc.11` 和 DSH `0.2.2-rc.3`。以广东省房屋建筑项目资料模板包 `0.3.4` 为例,该版本包含 798 份表式、42 份核查说明页、配套语义、字段规则和选表目录。表式保留原有的待完善及专业核验状态。
|
|
4
|
+
|
|
5
|
+
## 安装 BS 插件
|
|
6
|
+
|
|
7
|
+
在 DSH 的「插件」页输入 `bs-engineering-suite`,或提供已下载的 `bs-engineering-suite-2.9.0-rc.11.tgz` 的本地绝对路径。安装后按宿主提示重启,再打开「插件 → BS工程资料系统」。精确版本和安装包来源见 [README](../../README.md),Windows 用户可按 [Windows 安装说明](../windows-install.md)操作。
|
|
8
|
+
|
|
9
|
+
通过 npm 安装的插件可以在插件详情点「检查更新」。在「插件版本与更新」窗口勾选「显示预发布版本」后选择适用版本,再按宿主提示重启。
|
|
10
|
+
|
|
11
|
+
## 下载与管理模板包
|
|
12
|
+
|
|
13
|
+
1. 打开「插件 → BS工程资料系统 → 模板包管理 → 在线模板库」,点「主动刷新在线目录」。
|
|
14
|
+
2. 找到所需地区、专业和版本。点「安装」,或打开「详情与兼容性」后点「安装此版本」。
|
|
15
|
+
3. 下载和校验完成后,切回「已安装」,核对包名、版本和启用状态。腾讯云 COS 目录及 ZIP 可匿名下载。进度、取消和重试见 [在线模板库](ONLINE_LIBRARY.md)。
|
|
16
|
+
|
|
17
|
+
已经持有内容 ZIP 时,在「已安装」展开「导入本地模板包(ZIP)」,点「选择模板语义包文件」。如果下载的是统一分发包或外层网页归档,先解开外层,再选里面的模板内容 ZIP。选择文件后等待上传和校验完成,模板、语义及选表目录会一起导入。在「已安装的模板包」核对结果。
|
|
18
|
+
|
|
19
|
+
## 为工程选包并生成资料
|
|
20
|
+
|
|
21
|
+
1. 在左侧点「工程资料」。在右侧「工程资料工作台」新建或进入工程。
|
|
22
|
+
2. 在「选择本项目资料包」选择已安装并启用的模板包和 RAG 资料包,点「保存并进入项目」。以后可在「项目用包」点「更改」。更改只影响后续新任务,已有任务和成果保留原引用。[RAG 资料包说明](../rag-packs/library.md)
|
|
23
|
+
3. 需要新会话时,在工作台点「新对话」,选择对应工程并点「开始对话」。在中间的 DSH 对话中说明需要的资料,可以提供具体表号、表名和已核实的事实。根据对话提示核对选表、补齐必要信息,再确认生成。
|
|
24
|
+
4. 可在「项目基础资料」上传 PDF、DOCX 或 XLSX 并选择资料类型。文件保存在本机工程目录,只有在对话中明确要求时才按需读取。对话临时附件使用 DSH 原生附件入口。
|
|
25
|
+
5. 对话生成后,在工作台「成果文件」点击文件名,通过 DSH 侧栏预览。核对表号、字段、版式和依据,完成需要的专业复核及人工签认。
|
|
26
|
+
|
|
27
|
+
## 更新、卸载和删除
|
|
28
|
+
|
|
29
|
+
已安装版本右侧的「更新」在有兼容新版时出现。齿轮菜单提供停用、启用、导出、卸载和删除本地包。停用和卸载会影响后续选择,历史任务所需的版本和修订仍保留。有工程、历史任务等引用的版本受永久删除保护。「待完善表式」表示表式能力或专业依据仍待补齐。
|
|
30
|
+
|
|
31
|
+
Windows 工程操作见 [Windows 使用说明](../windows-usage.md)。
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
# 在线 RAG 资料包与本地管理
|
|
2
|
+
|
|
3
|
+
本指南对应 BS `2.9.0-rc.11`。在「插件 → BS工程资料系统 → RAG资料包管理」下载安装、更新和管理资料包。在右侧「工程资料工作台」为当前工程选择已启用的版本。
|
|
4
|
+
|
|
5
|
+
## 下载与更新
|
|
6
|
+
|
|
7
|
+
1. 在「在线资料库」点「刷新资料包」。目录及 ZIP 由 DSH 主机从腾讯云 COS 匿名下载。
|
|
8
|
+
2. 在线版本与内置版本的身份相同时,点「下载本地副本」。身份不同时,点「下载并安装」。
|
|
9
|
+
3. 切回「本地资料包」,核对名称、版本和启用状态。在工程的「项目用包」里选所需的版本。设置步骤见 [模板包安装与使用说明](../content-packs/TEMPLATE_PACKAGE_GUIDE.md)。
|
|
10
|
+
|
|
11
|
+
rc.11 内置全国房建 `2026.11-r2-local`。主机可能显示带内置摘要后缀的完整版本标识。线上示例为 `2026.11-r2`,两者各自使用固定身份。发现兼容新版时,本地包齿轮左侧显示「更新」,插件详情也提供更新入口。更新保留既有工程的固定引用。
|
|
12
|
+
|
|
13
|
+
固定使用全国房建 r1 的旧工程可在升级后继续检索原版本。保留了服务签发记录的回执,可按原身份复核其来源与索引。正式 rc.11 的工程登记只证明旧版曾核验并接收该回执,缺少逐条签发记录的回执会显示需要重新复核。请在原工程重新检索所用版本,使用新回执核对引用。旧登记和原回执编号继续保留在历史记录中。
|
|
14
|
+
|
|
15
|
+
## 本地管理
|
|
16
|
+
|
|
17
|
+
- **停用此版本/启用此版本**控制后续检索。历史引用和回执保留。
|
|
18
|
+
- **卸载资料包**使资料包退出新的检索。已有引用所需的资料和索引保留。
|
|
19
|
+
- **删除本地资料包**需要确认。存在历史引用或引用状态无法核验时,删除入口会阻止清理。仅有内置版本时,可先卸载再清理它的本地副本。清理完成后仍可从在线资料库下载。
|
|
20
|
+
|
|
21
|
+
## 资料状态
|
|
22
|
+
|
|
23
|
+
全国房建资料为专业待核、项目适用性待核及内部研究使用。安装、检索命中和生成成果仍需按工程要求核对依据。历史 r1 的挂起项沿用固定作者披露,r2 的挂起项从已校验的归档状态计算。历史 r1 的 `manifestVersion` 为 `2026.11`。
|
|
24
|
+
|
|
25
|
+
## 维护者说明
|
|
26
|
+
|
|
27
|
+
来源描述在 `packages/rag/src/rag-pack-source.ts`;经发布的原始元数据在 `packages/rag/data/library/`。在线元数据SHA256、ZIP 大小与 SHA-256、目录列出的成员摘要以及原 manifest 身份逐层校验。ZIP复用现有有界解析器,拒绝异常路径、特殊文件、重复文件和膨胀超限。客户端不能指定URL、绝对路径或其他Profile。
|
|
28
|
+
|
|
29
|
+
资料包目录为当前Profile的 `rag-package-library/`;索引提交使用临时文件+原子重命名,单Profile独占租约防止并发宿主覆盖。下载期间可取消,校验失败不发布半成品。错误仅经DSH原生RemoteError传递白名单原因代号,诊断记录沿用RAG模块现有脱敏入口。
|
|
30
|
+
|
|
31
|
+
注册索引前重新核对当前管理员授权的scopes与敏感度上限,权限不足不注册scope;检索时仍按原机制逐次重新核验。安装后仍调用原 `registerScope` / `synchronizeScope` / `retrieveNormative`,保留授权、敏感度、适用性和引用校验。没有改写冻结清单、改换manifestId、扩大用户清单的 `bs-builtin-` 保留前缀授权,或新增模型工具。原有五个分层检索Remote方法保持不变;LOCAL_SINGLE_ADMIN管理面增加一个字符串JSON命令方法 `buildseekRagAdmin/library`。
|
|
32
|
+
|
|
33
|
+
Host Profile未显式配置数据库时,RAG默认持久化到Profile的 `rag-index.sqlite`,使Citation能跨重启保留。显式 `databasePath` 仍由原配置决定;显式使用内存数据库的高级配置不具备跨重启保存Citation的保证,因此禁止永久删除资料包。
|
|
34
|
+
|
|
35
|
+
### 开发验证
|
|
36
|
+
|
|
37
|
+
```sh
|
|
38
|
+
pnpm build
|
|
39
|
+
node --test packages/rag/tests/rag-pack-library.test.mjs packages/rag/tests/remote-gateway.test.mjs
|
|
40
|
+
node --test packages/workbench/tests/rag-library-ui.test.mjs
|
|
41
|
+
pnpm pack:universal
|
|
42
|
+
node scripts/verify-package.mjs --target universal
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
使用精确DSH `0.2.2-rc.3` runtime、可用Chrome/Chromium和独立安装包,执行不使用凭据的真实Loader/COS/UI/检索场景:
|
|
46
|
+
|
|
47
|
+
```sh
|
|
48
|
+
node scripts/test-rag-library-installed.mjs \
|
|
49
|
+
--runtime /path/to/isolated-dsh-runtime \
|
|
50
|
+
--artifact /path/to/local-candidate.tgz \
|
|
51
|
+
--output /path/to/verification-output \
|
|
52
|
+
--browser-driver /path/to/playwright
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
脚本只创建临时Profile、合成工作区及精确到该会话的公开静态授权配置;不改发布物默认权限。场景核对界面下载、无引用包删除与重启不复现、重新下载、真实检索待核命中、重复安装、齿轮菜单启停、原生卸载确认、历史回执、阻止删除已有引用的包、重启恢复、双主题和窄栏,并阻止前端提交模型请求。结束后清理临时宿主、浏览器和Profile,保留JSON回执及界面样片。通过的场景序列就是可重复的交互快照。
|
|
56
|
+
|
|
57
|
+
跨平台实现使用Node文件API、Windows可接受的成员名及原子重命名重试;通用包仍保留macOS和Windows的原生组件。没有Windows实机时,必须单独报告 `NOT_RUN`,不能以静态打包代替Desktop验收。原生工程目录选择器不属于新增资料包界面的功能范围。
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
# Windows x64 安装 BS 工程资料系统
|
|
2
|
+
|
|
3
|
+
当前指南对应 BS `2.9.0-rc.11` 通用安装包和 DSH `0.2.2-rc.3`。DSH 实际运行的 Node 须为 `24.9.0` 或更高版本,并具备内置 SQLite 和 FTS5。Windows 实机和 Desktop 的 rc.11 验收为 `NOT_RUN`。
|
|
4
|
+
|
|
5
|
+
## 在 DSH 插件页安装
|
|
6
|
+
|
|
7
|
+
1. 打开已有 DSH 的「插件」页,输入 `bs-engineering-suite` 安装。需要精确版本时可输入 `bs-engineering-suite@2.9.0-rc.11`。
|
|
8
|
+
2. 使用文件安装时,从 [已发布的 rc.11 Release](https://github.com/jdbsh-AI/bs-engineering-suite/releases/tag/bs-v2.9.0-rc.11) 下载 `bs-engineering-suite-2.9.0-rc.11.tgz`。已发布通用包覆盖 Windows x64 与 macOS arm64。GitHub 下载需要仓库读取权限。使用本地候选时,先在随附回执确认其为 Windows x64 安装包或通用安装包。
|
|
9
|
+
3. 将安装文件的本地绝对路径填入安装源,无需解压。例如 `D:\下载\BS 安装包\bs-engineering-suite-2.9.0-rc.11.tgz`。Release 的源码 ZIP/TAR 供维护者构建使用。
|
|
10
|
+
4. 按宿主提示重启。在「插件 → BS工程资料系统」核对版本和模块状态。
|
|
11
|
+
5. 在插件详情安装所需的 [模板包](content-packs/TEMPLATE_PACKAGE_GUIDE.md) 和 [RAG 资料包](rag-packs/library.md)。再按 [Windows 使用说明](windows-usage.md)在本机建立或打开工程。
|
|
12
|
+
|
|
13
|
+
安装复用已有 DSH。普通用户无需安装 Rust、pnpm、系统 Node 或额外 UI 兼容层。UI 适配按宿主实际的 npm 或 Desktop 变体匹配,界面位置以宿主当前显示为准。
|
|
14
|
+
|
|
15
|
+
## 检查更新或用 CLI 安装
|
|
16
|
+
|
|
17
|
+
已从 npm 安装时,在插件详情点「检查更新」,在「插件版本与更新」中选择适用于当前平台的版本。查看 rc 版本时勾选「显示预发布版本」。更新后按宿主提示重启。用本地归档升级时,先保存工作,再在 DSH 中提供同版或新版归档路径。
|
|
18
|
+
|
|
19
|
+
已配置 DSH CLI 的维护者也可运行以下命令。其中 `desktop` 替换为实际的 Profile 名称。
|
|
20
|
+
|
|
21
|
+
```powershell
|
|
22
|
+
dsh plugin --profile desktop add 'D:\下载\BS 安装包\bs-engineering-suite-2.9.0-rc.11.tgz' --ignore-scripts
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
停用或卸载通过 DSH 的「插件」页操作。工程资料、既有绑定和成果应按各自的本机存储位置保留。
|
|
26
|
+
|
|
27
|
+
## 历史 Windows 实机记录
|
|
28
|
+
|
|
29
|
+
`0.1.0-alpha.3-m2.6` 配套 DSH `0.2.2-rc.1`,曾在 Windows 11 Pro 24H2 x64、build `26100.7840` 上检查单包安装、顶部入口、停用、卸载和重装。历史 Windows 资产为 `bs-engineering-suite-0.1.0-alpha.3-m2.6-win32-x64.tgz`,见 [m2.6 历史发布页](https://github.com/jdbsh-AI/bs-engineering-suite/releases/tag/v0.1.0-alpha.3-m2.6)及[单包验证记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/2f70ecaa09a0e07bede88f87fb215096c2250c1f/docs/windows-single-package-check-20261111.md)。更早的合成工程生成和预览见 [m2.5 历史业务记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/2f70ecaa09a0e07bede88f87fb215096c2250c1f/docs/windows-business-check-20261111.md)。这些记录中的宿主版本、文件名及验证结果均对应历史版本。
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
# Windows 使用:从本地工程到候选成果
|
|
2
|
+
|
|
3
|
+
本指南对应 BS `2.9.0-rc.11` 和 DSH `0.2.2-rc.3`。[安装说明](windows-install.md)包含当前通用包的取得方式、宿主要求和历史 Windows 实机记录。
|
|
4
|
+
|
|
5
|
+
## 安装包并进入工程
|
|
6
|
+
|
|
7
|
+
1. 在「插件 → BS工程资料系统」安装、启用所需的 [模板包](content-packs/TEMPLATE_PACKAGE_GUIDE.md) 和 [RAG 资料包](rag-packs/library.md)。
|
|
8
|
+
2. 在左侧点「工程资料」。在右侧「工程资料工作台」点「新建工程」,通过 DSH 的目录选择窗口选中 Windows 本机的工程文件夹。已登记的工程会在工作台首页列出,点「进入工程」即可打开。
|
|
9
|
+
3. 首次进入时,在「选择本项目资料包」选用已安装并启用的模板包和 RAG 资料包,再点「保存并进入项目」。已设置的工程可在「项目用包」点「更改」。
|
|
10
|
+
4. 需要开始新的工程对话时,在工作台点「新对话」。可以选已有工程并点「开始对话」,也可以选择「新建工程」,填写名称,再点「选择位置并开始」。
|
|
11
|
+
|
|
12
|
+
工程目录选用本机固定 NTFS 磁盘,例如 `D:\工程资料\一号楼`。从 Mac 复制工程目录到 Windows 不会恢复原绑定。安装、选目录及启用模块不会授予工程写入权限。
|
|
13
|
+
|
|
14
|
+
## 上传项目基础资料
|
|
15
|
+
|
|
16
|
+
在工作台「项目基础资料」点「上传文件」,选择 PDF、DOCX 或 XLSX,再选资料类型。两项填写后自动保存到工程文件夹的 `项目基础资料` 子目录。点「添加」可继续添加资料。界面显示「已保存」后,可在工程对话中明确要求 AI 读取指定资料及范围。对话临时附件使用 DSH 原生附件功能。
|
|
17
|
+
|
|
18
|
+
## 查阅已有资料
|
|
19
|
+
|
|
20
|
+
进入工程后,在工作台点「资料阅览台」。在「资料目录」展开文件夹、按名称或相对路径搜索,或按类型筛选。文件有增删时可点「刷新」,条目较多时可点「加载更多」。点击文件通过 DSH 原生预览打开,能否分栏及支持的格式由宿主决定。目录浏览和预览无需模型。
|
|
21
|
+
|
|
22
|
+
## 在对话中生成并查看成果
|
|
23
|
+
|
|
24
|
+
1. 确认中间的 DSH 对话属于当前工程。选择所需的模型,在对话中说明资料需求、表号、已核实的工程事实和资料范围。
|
|
25
|
+
2. 核对对话选用的表式、依据和待补信息。需要确认时,由本人阅读并确认本次内容。发现错误可在同一对话中更正数据,再要求生成新的候选。
|
|
26
|
+
3. 生成后,在工程工作台「成果文件」点击文件名,由 DSH 侧栏预览。核对中文、字段、分页、依据和版式。候选成果的专业审查与签认仍需人工完成。
|
|
27
|
+
|
|
28
|
+
## 验证范围
|
|
29
|
+
|
|
30
|
+
当前 rc.11 的 Windows 实机、Desktop 和原生预览为 `NOT_RUN`。此前 Windows 11 的目录、检索、分页和预览检查见 [历史资料阅览台实机记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.12/docs/windows-document-library-check-20261112.md)。宿主和安装版本见 [安装说明的历史记录](windows-install.md#历史-windows-实机记录)。
|
|
@@ -16,7 +16,9 @@ export declare function assertUserSource(path: string, bytes: Uint8Array): void;
|
|
|
16
16
|
export declare function bundleView(manifest: BundleManifest, members: ReadonlyMap<string, Uint8Array>): BundleView;
|
|
17
17
|
/** Structural/hash/identity guards run independently of the supplied semantic validator. */
|
|
18
18
|
export declare function checkBundleMembers(manifestInput: BundleManifest, members: ReadonlyMap<string, Uint8Array>): BundleView;
|
|
19
|
-
export declare function readBundle(bytes: Uint8Array, limits?: Partial<ArchiveLimits>
|
|
19
|
+
export declare function readBundle(bytes: Uint8Array, { maxManifestBytes, ...limits }?: Partial<ArchiveLimits> & {
|
|
20
|
+
maxManifestBytes?: number;
|
|
21
|
+
}): VerifiedBundle;
|
|
20
22
|
export declare function validateBundle(view: BundleView, validator: BundleValidator): Promise<ValidationResult & {
|
|
21
23
|
issues: string[];
|
|
22
24
|
}>;
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
import { createHash } from 'node:crypto';
|
|
2
2
|
import { inflateRawSync } from 'node:zlib';
|
|
3
3
|
import { zipSync } from 'fflate';
|
|
4
|
+
import { officeUtf16Encoding } from './office-xml.js';
|
|
4
5
|
import { BUNDLE_SCHEMA, MAPPING_SCHEMA, ContentPackError } from './types.js';
|
|
5
6
|
import { packDiagnostic, diagnosticForError, normalizePackDiagnostics, formatPackDiagnostics } from './diagnostics.js';
|
|
6
7
|
export const MAX_UPLOAD_BYTES = 512 * 1024 * 1024;
|
|
8
|
+
const MAX_MANIFEST_BYTES = 16 * 1024 * 1024;
|
|
7
9
|
export const MAX_USER_SOURCE_BYTES = 32 * 1024 * 1024;
|
|
8
10
|
export const USER_SOURCE_PATH = /^user-sources\/([a-f0-9]{64})\.(pdf|docx|txt|md|csv|json)$/;
|
|
9
11
|
export const DEFAULT_ARCHIVE_LIMITS = Object.freeze({
|
|
@@ -61,6 +63,9 @@ function crc32(bytes) {
|
|
|
61
63
|
}
|
|
62
64
|
/** Parses ZIP metadata before bounded inflation. ZIP64, encryption and special files are rejected. */
|
|
63
65
|
export function readBoundedZip(input, options = {}) {
|
|
66
|
+
return readZip(input, options);
|
|
67
|
+
}
|
|
68
|
+
function readZip(input, options, manifestLimit) {
|
|
64
69
|
const limits = { ...DEFAULT_ARCHIVE_LIMITS, ...options };
|
|
65
70
|
for (const value of Object.values(limits))
|
|
66
71
|
if (!Number.isSafeInteger(value) || value <= 0)
|
|
@@ -142,6 +147,11 @@ export function readBoundedZip(input, options = {}) {
|
|
|
142
147
|
}
|
|
143
148
|
if (offset !== directory)
|
|
144
149
|
fail('INVALID_ZIP', 'Hidden ZIP data');
|
|
150
|
+
if (manifestLimit !== undefined) {
|
|
151
|
+
const manifest = entries.find(entry => entry.path === 'manifest.json' && !entry.dir);
|
|
152
|
+
if (!manifest || !manifest.size || manifest.size > manifestLimit)
|
|
153
|
+
fail('INVALID_MANIFEST', 'Missing or oversized manifest.json');
|
|
154
|
+
}
|
|
145
155
|
const result = new Map();
|
|
146
156
|
for (const entry of entries) {
|
|
147
157
|
let bytes;
|
|
@@ -314,7 +324,13 @@ function assertPassive(path, bytes, officeLimits = {}) {
|
|
|
314
324
|
if (/vba|activex|embeddings|customui|(?:^|\/)(?:externalLinks|macros)(?:\/|$)|\.(?:exe|dll|bin|js|vbs|cmd|bat)$/i.test(name))
|
|
315
325
|
fail('UNSAFE_MEMBER', `Active Office part: ${name}`);
|
|
316
326
|
if (/\.(?:xml|rels)$/i.test(name)) {
|
|
317
|
-
|
|
327
|
+
let xml;
|
|
328
|
+
try {
|
|
329
|
+
xml = new TextDecoder(officeUtf16Encoding(part) ?? 'utf-8', { fatal: true }).decode(part);
|
|
330
|
+
}
|
|
331
|
+
catch {
|
|
332
|
+
fail('INVALID_UTF8', `Invalid Office XML encoding: ${name}`);
|
|
333
|
+
}
|
|
318
334
|
if (/<!DOCTYPE|<!ENTITY|macroEnabled|vbaProject|oleObject/i.test(xml))
|
|
319
335
|
fail('UNSAFE_MEMBER', `Active Office content: ${name}`);
|
|
320
336
|
for (const relationship of officeRelationships(xml)) {
|
|
@@ -489,11 +505,11 @@ export function checkBundleMembers(manifestInput, members) {
|
|
|
489
505
|
}
|
|
490
506
|
return bundleView(manifest, members);
|
|
491
507
|
}
|
|
492
|
-
export function readBundle(bytes, limits = {}) {
|
|
493
|
-
|
|
508
|
+
export function readBundle(bytes, { maxManifestBytes = MAX_MANIFEST_BYTES, ...limits } = {}) {
|
|
509
|
+
if (!Number.isSafeInteger(maxManifestBytes) || maxManifestBytes <= 0)
|
|
510
|
+
fail('INVALID_LIMIT', 'Manifest limit must be a positive integer');
|
|
511
|
+
const files = readZip(bytes, limits, Math.min(maxManifestBytes, MAX_MANIFEST_BYTES));
|
|
494
512
|
const manifestBytes = files.get('manifest.json');
|
|
495
|
-
if (!manifestBytes || manifestBytes.length > 16 * 1024 * 1024)
|
|
496
|
-
fail('INVALID_MANIFEST', 'Missing or oversized manifest.json');
|
|
497
513
|
let value;
|
|
498
514
|
try {
|
|
499
515
|
value = JSON.parse(decodeText(manifestBytes));
|
|
@@ -524,7 +540,13 @@ export async function validateBundle(view, validator) {
|
|
|
524
540
|
}
|
|
525
541
|
export function semanticSha256(view) {
|
|
526
542
|
const paths = new Set([view.manifest.core.turtlePath, view.manifest.core.shapesPath, ...view.manifest.templates.flatMap(t => [t.semantic.turtlePath, t.semantic.shapesPath, t.mappingPath])]);
|
|
527
|
-
|
|
543
|
+
const descriptors = new Map(view.manifest.members.map(member => [member.path, member.sha256]));
|
|
544
|
+
return sha256(JSON.stringify({ sources: view.manifest.sources, members: [...paths].sort().map(path => {
|
|
545
|
+
const bytes = view.members.get(path), digest = bytes ? sha256(bytes) : descriptors.get(path);
|
|
546
|
+
if (!digest)
|
|
547
|
+
fail('MEMBER_NOT_FOUND', `Missing semantic member: ${path}`);
|
|
548
|
+
return [path, digest];
|
|
549
|
+
}) }));
|
|
528
550
|
}
|
|
529
551
|
export function writeBundle(view) {
|
|
530
552
|
const manifest = structuredClone(view.manifest);
|