bs-engineering-suite 2.9.0-rc.11 → 2.9.0-rc.13

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.
Files changed (179) hide show
  1. package/NOTICE.md +1 -1
  2. package/README.md +40 -38
  3. package/cordis.patch.yml +8 -0
  4. package/docs/content-packs/ONLINE_LIBRARY.md +15 -0
  5. package/docs/content-packs/TEMPLATE_PACKAGE_GUIDE.md +31 -0
  6. package/docs/rag-packs/library.md +57 -0
  7. package/docs/windows-install.md +29 -0
  8. package/docs/windows-usage.md +30 -0
  9. package/lib/ui-policy.cjs +11 -5
  10. package/node_modules/@buildseek/content-packs/lib/bundle.d.ts +3 -1
  11. package/node_modules/@buildseek/content-packs/lib/bundle.js +28 -6
  12. package/node_modules/@buildseek/content-packs/lib/bundle.js.map +1 -1
  13. package/node_modules/@buildseek/content-packs/lib/office-xml.d.ts +2 -0
  14. package/node_modules/@buildseek/content-packs/lib/office-xml.js +9 -0
  15. package/node_modules/@buildseek/content-packs/lib/office-xml.js.map +1 -0
  16. package/node_modules/@buildseek/content-packs/lib/repository.d.ts +10 -3
  17. package/node_modules/@buildseek/content-packs/lib/repository.js +395 -129
  18. package/node_modules/@buildseek/content-packs/lib/repository.js.map +1 -1
  19. package/node_modules/@buildseek/content-packs/lib/types.d.ts +1 -0
  20. package/node_modules/@buildseek/content-packs/lib/xlsx.d.ts +3 -0
  21. package/node_modules/@buildseek/content-packs/lib/xlsx.js +13 -6
  22. package/node_modules/@buildseek/content-packs/lib/xlsx.js.map +1 -1
  23. package/node_modules/@buildseek/diagnostics/lib/client.js +6 -6
  24. package/node_modules/@buildseek/diagnostics/lib/sanitize.js +1 -1
  25. package/node_modules/@buildseek/diagnostics/lib/store.js +18 -7
  26. package/node_modules/@buildseek/diagnostics/lib/updates.js +23 -11
  27. package/node_modules/@buildseek/diagnostics/lib/version.js +1 -1
  28. package/node_modules/@buildseek/diagnostics/package.json +7 -7
  29. package/node_modules/@buildseek/harness-engineering-document-plugin/dist/client/document-library.d.ts +1 -1
  30. package/node_modules/@buildseek/harness-engineering-document-plugin/dist/client/suite-settings.d.ts +1 -0
  31. package/node_modules/@buildseek/harness-engineering-document-plugin/dist/client/workbench-fact-editor.d.ts +1 -0
  32. package/node_modules/@buildseek/harness-engineering-document-plugin/dist/client.js +28 -8
  33. package/node_modules/@buildseek/harness-engineering-document-plugin/integration/licenses/deepseek-ai-0.2.2-rc.4-MIT-LICENSE +21 -0
  34. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/content-pack-rules.js +2 -1
  35. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/content-pack-validation.js +6 -2
  36. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/content-packs.js +116 -38
  37. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/files/evidence.js +3 -1
  38. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/files/materials.js +116 -39
  39. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/files/renderers.js +2 -1
  40. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/files/xlsx-preview-layout.js +1 -1
  41. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/identity.js +7 -7
  42. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/online-pack-worker.js +17 -18
  43. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/online-packs.js +6 -5
  44. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/orchestrator.js +25 -5
  45. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-content-flow.js +149 -23
  46. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/application.js +140 -81
  47. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/artifact-mirror.js +10 -6
  48. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/bridges.js +6 -4
  49. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/contract.js +1 -1
  50. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/evidence.js +34 -9
  51. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/filesystem.js +6 -0
  52. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/full-before.js +91 -34
  53. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/generation.js +54 -18
  54. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/plan.js +1 -0
  55. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/preview-leases.js +10 -3
  56. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/project-basic-reader.js +245 -47
  57. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/project-setup.js +27 -18
  58. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/project-data/store.js +4 -4
  59. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/schemas.js +8 -0
  60. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/service.js +4 -1
  61. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/typert.host.js +5 -5
  62. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/typert.remote-client.js +2 -2
  63. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/content-packs.d.ts +87 -18
  64. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/files/materials.d.ts +2 -0
  65. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/identity.d.ts +7 -7
  66. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/model.d.ts +1 -0
  67. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-content-flow.d.ts +75 -18
  68. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/application.d.ts +1 -0
  69. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/artifact-mirror.d.ts +1 -0
  70. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/bridges.d.ts +5 -0
  71. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/evidence.d.ts +3 -2
  72. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/filesystem.d.ts +2 -0
  73. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/plan.d.ts +1 -0
  74. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/preview-leases.d.ts +1 -0
  75. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/project-data/project-basic-reader.d.ts +14 -9
  76. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/schemas.d.ts +10 -0
  77. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/service.d.ts +1 -1
  78. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/types/workbench/application.d.ts +3 -0
  79. package/node_modules/@buildseek/harness-engineering-document-plugin/lib/workbench/application.js +45 -4
  80. package/node_modules/@buildseek/harness-engineering-document-plugin/package.json +66 -65
  81. package/node_modules/@buildseek/harness-engineering-document-plugin/policy/plugin-policy.json +3 -3
  82. package/node_modules/@buildseek/harness-engineering-document-plugin/scripts/package-contract.mjs +6 -6
  83. package/node_modules/@buildseek/harness-oag-plugin/dist/client/content-packs.d.ts +4 -0
  84. package/node_modules/@buildseek/harness-oag-plugin/dist/client/index.d.ts +2 -1
  85. package/node_modules/@buildseek/harness-oag-plugin/dist/client/suite-settings.d.ts +1 -0
  86. package/node_modules/@buildseek/harness-oag-plugin/dist/client.js +84 -19
  87. package/node_modules/@buildseek/harness-oag-plugin/dist/content-packs.js +22 -5
  88. package/node_modules/@buildseek/harness-oag-plugin/dist/native/buildseek_oag_node.darwin-arm64.node +0 -0
  89. package/node_modules/@buildseek/harness-oag-plugin/dist/native/buildseek_oag_node.win32-x64-msvc.node +0 -0
  90. package/node_modules/@buildseek/harness-oag-plugin/dist/native/buildseek_oag_node.win32-x64-msvc.node.json +3 -3
  91. package/node_modules/@buildseek/harness-oag-plugin/lib/config.js +7 -0
  92. package/node_modules/@buildseek/harness-oag-plugin/lib/remote-gateway.js +13 -11
  93. package/node_modules/@buildseek/harness-oag-plugin/lib/semantic-registry.js +67 -17
  94. package/node_modules/@buildseek/harness-oag-plugin/lib/service.js +11 -8
  95. package/node_modules/@buildseek/harness-oag-plugin/lib/tool-adapter.js +26 -10
  96. package/node_modules/@buildseek/harness-oag-plugin/lib/typert.host.js +91 -21
  97. package/node_modules/@buildseek/harness-oag-plugin/lib/typert.remote-client.d.ts +4 -1
  98. package/node_modules/@buildseek/harness-oag-plugin/lib/typert.remote-client.d.ts.map +1 -1
  99. package/node_modules/@buildseek/harness-oag-plugin/lib/typert.remote-client.js +58 -11
  100. package/node_modules/@buildseek/harness-oag-plugin/lib/types/api.d.ts +1 -1
  101. package/node_modules/@buildseek/harness-oag-plugin/lib/types/authorization.d.ts +1 -0
  102. package/node_modules/@buildseek/harness-oag-plugin/lib/types/config.d.ts +1 -1
  103. package/node_modules/@buildseek/harness-oag-plugin/lib/types/remote-gateway.d.ts +2 -1
  104. package/node_modules/@buildseek/harness-oag-plugin/lib/types/semantic-registry.d.ts +18 -7
  105. package/node_modules/@buildseek/harness-oag-plugin/lib/types/service.d.ts +6 -5
  106. package/node_modules/@buildseek/harness-oag-plugin/lib/types/tool-adapter.d.ts +1 -0
  107. package/node_modules/@buildseek/harness-oag-plugin/package.json +35 -35
  108. package/node_modules/@buildseek/harness-rag-plugin/data/library/bs-rag-national-building-2026.11-r1.zip +0 -0
  109. package/node_modules/@buildseek/harness-rag-plugin/dist/client/suite-settings.d.ts +1 -0
  110. package/node_modules/@buildseek/harness-rag-plugin/dist/client.js +309 -40
  111. package/node_modules/@buildseek/harness-rag-plugin/lib/core.js +201 -37
  112. package/node_modules/@buildseek/harness-rag-plugin/lib/local-folder.js +58 -14
  113. package/node_modules/@buildseek/harness-rag-plugin/lib/project-setup-read.js +5 -0
  114. package/node_modules/@buildseek/harness-rag-plugin/lib/rag-pack-library.js +283 -59
  115. package/node_modules/@buildseek/harness-rag-plugin/lib/retrieval-gateway.js +44 -30
  116. package/node_modules/@buildseek/harness-rag-plugin/lib/retrieval-lifecycle.js +112 -38
  117. package/node_modules/@buildseek/harness-rag-plugin/lib/retrieval-scope.js +1 -1
  118. package/node_modules/@buildseek/harness-rag-plugin/lib/retrieval-service.js +297 -139
  119. package/node_modules/@buildseek/harness-rag-plugin/lib/service.js +21 -9
  120. package/node_modules/@buildseek/harness-rag-plugin/lib/tool-adapter.js +15 -13
  121. package/node_modules/@buildseek/harness-rag-plugin/lib/typert.host.js +460 -25
  122. package/node_modules/@buildseek/harness-rag-plugin/lib/typert.remote-client.d.ts.map +1 -1
  123. package/node_modules/@buildseek/harness-rag-plugin/lib/typert.remote-client.js +255 -6
  124. package/node_modules/@buildseek/harness-rag-plugin/lib/types/api.d.ts +1 -1
  125. package/node_modules/@buildseek/harness-rag-plugin/lib/types/core.d.ts +43 -1
  126. package/node_modules/@buildseek/harness-rag-plugin/lib/types/index.d.ts +1 -1
  127. package/node_modules/@buildseek/harness-rag-plugin/lib/types/local-folder.d.ts +2 -0
  128. package/node_modules/@buildseek/harness-rag-plugin/lib/types/project-setup-read.d.ts +12 -0
  129. package/node_modules/@buildseek/harness-rag-plugin/lib/types/rag-pack-library.d.ts +14 -0
  130. package/node_modules/@buildseek/harness-rag-plugin/lib/types/retrieval-lifecycle.d.ts +15 -3
  131. package/node_modules/@buildseek/harness-rag-plugin/lib/types/retrieval-service.d.ts +27 -6
  132. package/node_modules/@buildseek/harness-rag-plugin/lib/types/service.d.ts +18 -0
  133. package/node_modules/@buildseek/harness-rag-plugin/package.json +37 -37
  134. package/node_modules/@buildseek/platform/project-setup.d.ts +10 -6
  135. package/node_modules/@buildseek/platform/project-setup.js +684 -31
  136. package/node_modules/@dsh-engineering/workbench/client/bundle.js +345 -140
  137. package/node_modules/@dsh-engineering/workbench/client/entry-connection.d.ts +1 -1
  138. package/node_modules/@dsh-engineering/workbench/client/entry.d.ts +2 -0
  139. package/node_modules/@dsh-engineering/workbench/client/native-session-observer.d.ts +2 -0
  140. package/node_modules/@dsh-engineering/workbench/client/project-controller.d.ts +8 -0
  141. package/node_modules/@dsh-engineering/workbench/client/project-workspace.d.ts +3 -2
  142. package/node_modules/@dsh-engineering/workbench/client/styles.d.ts +1 -1
  143. package/node_modules/@dsh-engineering/workbench/client/suite-updates.d.ts +2 -0
  144. package/node_modules/@dsh-engineering/workbench/package.json +15 -15
  145. package/node_modules/bs-engineering-docs/client/bundle.js +18 -13
  146. package/node_modules/bs-engineering-docs/lib/agent.js +53 -16
  147. package/node_modules/bs-engineering-docs/lib/api.js +54 -80
  148. package/node_modules/bs-engineering-docs/lib/extract/scan.js +30 -4
  149. package/node_modules/bs-engineering-docs/lib/generate/candidate.js +17 -0
  150. package/node_modules/bs-engineering-docs/lib/generate/run.js +12 -8
  151. package/node_modules/bs-engineering-docs/lib/index.js +30 -2
  152. package/node_modules/bs-engineering-docs/lib/project-tools.js +32 -5
  153. package/node_modules/bs-engineering-docs/lib/store.js +298 -243
  154. package/node_modules/bs-engineering-docs/lib/util/errors.js +2 -0
  155. package/node_modules/dsh-sidebar-office-preview/client/bundle.js +33 -33
  156. package/node_modules/dsh-sidebar-office-preview/client/src/parse.js +8 -1
  157. package/node_modules/dsh-sidebar-office-preview/cordis.patch.yml +1 -1
  158. package/node_modules/dsh-sidebar-office-preview/package.json +1 -1
  159. package/package.json +9 -4
  160. package/ui-compat/darwin-arm64/receipt.json +32 -27
  161. package/ui-compat/darwin-arm64/vendor/desktop/@deepseek-ai/dsh-client-ui-plugin-manager/lib/client.js +10 -2
  162. package/ui-compat/darwin-arm64/vendor/npm/@deepseek-ai/dsh-client-ui-chat/lib/bs-ui-guard.js +2 -2
  163. package/ui-compat/darwin-arm64/vendor/npm/@deepseek-ai/dsh-client-ui-chat/package.json +40 -40
  164. package/ui-compat/darwin-arm64/vendor/npm/@deepseek-ai/dsh-client-ui-plugin-manager/lib/bs-ui-guard.js +2 -2
  165. package/ui-compat/darwin-arm64/vendor/npm/@deepseek-ai/dsh-client-ui-plugin-manager/lib/client.js +10 -2
  166. package/ui-compat/darwin-arm64/vendor/npm/@deepseek-ai/dsh-client-ui-plugin-manager/package.json +19 -19
  167. package/ui-compat/darwin-arm64/vendor/npm/@deepseek-ai/dsh-client-ui-sidebar/lib/bs-ui-guard.js +2 -2
  168. package/ui-compat/darwin-arm64/vendor/npm/@deepseek-ai/dsh-client-ui-sidebar/lib/client.js +1 -1
  169. package/ui-compat/darwin-arm64/vendor/npm/@deepseek-ai/dsh-client-ui-sidebar/package.json +13 -13
  170. package/ui-compat/win32-x64/receipt.json +32 -27
  171. package/ui-compat/win32-x64/vendor/desktop/@deepseek-ai/dsh-client-ui-plugin-manager/lib/client.js +10 -2
  172. package/ui-compat/win32-x64/vendor/npm/@deepseek-ai/dsh-client-ui-chat/lib/bs-ui-guard.js +2 -2
  173. package/ui-compat/win32-x64/vendor/npm/@deepseek-ai/dsh-client-ui-chat/package.json +40 -40
  174. package/ui-compat/win32-x64/vendor/npm/@deepseek-ai/dsh-client-ui-plugin-manager/lib/bs-ui-guard.js +2 -2
  175. package/ui-compat/win32-x64/vendor/npm/@deepseek-ai/dsh-client-ui-plugin-manager/lib/client.js +10 -2
  176. package/ui-compat/win32-x64/vendor/npm/@deepseek-ai/dsh-client-ui-plugin-manager/package.json +19 -19
  177. package/ui-compat/win32-x64/vendor/npm/@deepseek-ai/dsh-client-ui-sidebar/lib/bs-ui-guard.js +2 -2
  178. package/ui-compat/win32-x64/vendor/npm/@deepseek-ai/dsh-client-ui-sidebar/lib/client.js +1 -1
  179. package/ui-compat/win32-x64/vendor/npm/@deepseek-ai/dsh-client-ui-sidebar/package.json +13 -13
package/NOTICE.md CHANGED
@@ -9,7 +9,7 @@ This repository consolidates five previously developed modules into one DeepSeek
9
9
 
10
10
  The original module licenses and third-party notices remain under `packages/`. The suite does not replace or shadow the DeepSeek Harness SDK or bundle a second DSH runtime. DSH, its SDK, Cordis and React remain host-provided shared instances. The Windows x64 `0.1.0-alpha.3-m2.6` archive includes the matching Windows native components; the retained macOS arm64 `0.1.0-alpha.3-m2.5` release includes its macOS OAG native module. These are platform-specific archives, not interchangeable binaries. The Office preview module retains its private Workbench capability and respects the official preview defaults.
11
11
 
12
- The m2.10 candidate archive includes isolated, modified copies of three MIT-licensed DSH UI packages: `@deepseek-ai/dsh-client-ui-sidebar`, `@deepseek-ai/dsh-client-ui-chat` and `@deepseek-ai/dsh-client-ui-plugin-manager`. For each supported platform it carries both the exact published npm `0.2.2-rc.3` payload and that platform's real Desktop `0.2.2-rc.3` payload. They live under `ui-compat/vendor/<variant>/@deepseek-ai/` in the installed suite, outside the host SDK resolution paths. Each copy retains its original copyright notice, `LICENSE`, locales and required assets; the inventory, platform, variant and original/file digests are recorded in `ui-compat/receipt.json` format `bs-ui-bundle/v3`. These limited UI copies add the BS navigation and running-status slots and persist/filter the native version list; they do not include a DSH or Node installer and do not modify the host installation directory, system PATH or the user's global Node. Activation requires the exact platform, host version and every original SHA-256 in one variant to match; npm/Desktop mixed bytes, rc.1/rc.2 bytes or unknown builds retain their native UI and report a stable `BS_UI_FALLBACK` reason. The legacy rc.1 Windows profile overlay remains historical and is not activated by the rc.3 package policy.
12
+ The `2.9.0-rc.13` candidate archive includes isolated, modified copies of three MIT-licensed DSH UI packages: `@deepseek-ai/dsh-client-ui-sidebar`, `@deepseek-ai/dsh-client-ui-chat` and `@deepseek-ai/dsh-client-ui-plugin-manager`. For each supported platform it carries both the exact published npm `0.2.2-rc.4` payload and that platform's real Desktop `0.2.2-rc.3` payload. They live under `ui-compat/vendor/<variant>/@deepseek-ai/` in the installed suite, outside the host SDK resolution paths. Each copy retains its original copyright notice, `LICENSE`, locales and required assets; the inventory, platform, variant and original/file digests are recorded in `ui-compat/receipt.json` format `bs-ui-bundle/v4`, with per-variant versions under `hostVersions`. These limited UI copies add the BS navigation and running-status slots and persist/filter the native version list; they do not include a DSH or Node installer and do not modify the host installation directory, system PATH or the user's global Node. Activation requires the exact platform, variant host version and every original SHA-256 in one variant to match; npm/Desktop mixed bytes, rc.1/rc.2 bytes or unknown builds retain their native UI and report a stable `BS_UI_FALLBACK` reason. The legacy rc.1 Windows profile overlay remains historical and is not activated by the rc.4 package policy.
13
13
 
14
14
  The bundled UI compatibility logic uses a read-only runtime policy and a subclass of the host's native Group. It reads the current composed native UI settings, including profile/home layer precedence, without writing a separate profile patch. It disables the matched native UI rows only when the exact versions, SHA-256 digests and settings are compatible, and lets the Group own the replacement children's load/unload lifecycle. Unknown hosts, user-disabled native UI, unsupported custom groups or configuration conflicts retain the original UI with stable `BS_UI_FALLBACK` diagnostics. Disabling or removing the suite restores native UI according to the host's restart prompts. Installation does not depend on `postinstall`; the official host CLI can install the archive with `--ignore-scripts`.
15
15
 
package/README.md CHANGED
@@ -1,11 +1,13 @@
1
1
  # BS工程资料系统
2
2
 
3
- > `2.9.0-rc.11` 通用包:修复工程会话恢复与基础资料大文件上传;支持原生工作区会话分组及工程变更与签证分类。右侧工程资料工作台提供新对话和工程绑定;模板包、RAG资料包的下载及管理集中在原生插件详情页。支持 macOS arm64 / Windows x64,目标宿主 DSH `0.2.2-rc.3`。Windows 与独立 Desktop 原生运行验证为 NOT_RUN。
3
+ > `2.9.0-rc.13` 通用包:将 Web/CLI 宿主适配到 DSH `0.2.2-rc.4`,同时继续使用官方仍发布在 `0.2.2-rc.3` 的 macOS/Windows Desktop UI 精确字节。支持 macOS arm64 / Windows x64;rc.4 Desktop 实机与 Windows 原生运行验证为 NOT_RUN。
4
4
 
5
- 当前套件为 **`2.9.0-rc.11`**,目标宿主为 DSH `0.2.2-rc.3`,统一发布标签为 **`bs-v2.9.0-rc.11`**。[下载 Release](https://github.com/jdbsh-AI/bs-engineering-suite/releases/tag/bs-v2.9.0-rc.11) · **[模板包安装与使用说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.11/docs/content-packs/TEMPLATE_PACKAGE_GUIDE.md)**。在 DSH 插件页直接输入 `bs-engineering-suite` 安装;npm 用户可运行 `npm install bs-engineering-suite`,需要固定版本时使用 `bs-engineering-suite@2.9.0-rc.11`。已从 npm 安装的用户可在插件详情的版本区更新;rc 版本需勾选“显示预发布版本”,再按宿主提示重启。
5
+ 当前套件为 **`2.9.0-rc.13`**,Web/CLI 目标宿主为 DSH `0.2.2-rc.4`,Desktop UI 基线为 `0.2.2-rc.3`,统一发布标签为 **`bs-v2.9.0-rc.13`**。[下载 rc.13](https://github.com/jdbsh-AI/bs-engineering-suite/releases/tag/bs-v2.9.0-rc.13) · **[模板包安装与使用说明](docs/content-packs/TEMPLATE_PACKAGE_GUIDE.md)**。在 DSH 插件页直接输入 `bs-engineering-suite` 安装;npm 用户可运行 `npm install bs-engineering-suite`,需要固定版本时使用 `bs-engineering-suite@2.9.0-rc.13`。已从 npm 安装的用户可在插件详情的版本区更新;rc 版本需勾选“显示预发布版本”,再按宿主提示重启。
6
6
 
7
- RAG资料在 **插件 → BS工程资料系统 → RAG资料包管理** 中刷新与下载安装,详情见[RAG资料库说明](docs/rag-packs/library.md)。全国房建资料包为 `2026.11-r1`;专业、适用性及内部研究状态保持原样。
8
- **操作准则**:右侧工程资料工作台负责绑定工程文件夹、新对话、资料阅览以及任务和成果核对;中央DSH原生对话区负责与AI交流、提出资料需求和资料生成;模板包、配套语义和RAG资料包统一在BS插件管理页管理。首页只保留添加工程资料文件夹,工程状态自动更新。“BS工程资料介绍”按钮可打开完整介绍。
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.3 | 840份Excel资产、配套语义、字段映射及选表目录 | [在线模板库(COS)](docs/content-packs/ONLINE_LIBRARY.md) · [备用 Packages](https://github.com/jdbsh-AI/bs-engineering-suite/pkgs/container/bs-templates%2Fgd-building-2024) · [网页下载与导入说明](docs/content-packs/PACKAGES.md) |
22
+ | 广东省房屋建筑项目资料模板包 | 0.3.4 | 840份Excel资产、配套语义、字段映射及选表目录 | [在线模板库(COS)](docs/content-packs/ONLINE_LIBRARY.md) · [本地 ZIP 导入](docs/content-packs/TEMPLATE_PACKAGE_GUIDE.md) |
21
23
 
22
- **广东建筑0.3.3模板包及在线目录按版本独立管理,BS源码仓库继续保持私有。** [模板目录与版本摘要](docs/content-packs/catalog.json)单独维护。推荐在 **插件 → BS工程资料系统 → 模板包管理 → 在线模板库** 刷新并下载安装,COS 目录和 ZIP 均无需 GitHub 登录或 Token。完成后从本机读取;仍保留内容 ZIP 导入。[在线模板库说明](docs/content-packs/ONLINE_LIBRARY.md) · [COS 来源与权限范围](docs/content-packs/COS_SOURCE.md)。
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.13/docs/content-packs/PACKAGES.md)供历史核对。
23
25
 
24
- 配套的 **广东省房屋建筑项目资料模板包** 当前内容版本为0.3.3:包含840份Excel资产、RDF/SHACL、字段规则和选表目录。已移除840份逐表PDF保真文件,保留Word来源及正文/附册等依据PDF。导入后从本机内容库读取,无需每次直连GitHub;旧任务继续固定原包与语义修订。目录优化和3090实测见[性能记录](docs/content-packs/CATALOGUE_PERFORMANCE.md)。插件和模板内容分别版本管理。
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.13/docs/content-packs/CATALOGUE_PERFORMANCE.md)。插件和模板内容分别版本管理。
25
27
 
26
- 以下m2.x说明保留宿主兼容、界面及历史验收背景;当前安装和模板操作以本版Release及上方专门说明为准。
28
+ 当前安装与模板操作以本页顶部的随包指南为准。文中标注的旧版记录用于查阅历史验证和回滚。
27
29
 
28
- ![BS工程资料工作台:提出任务,Agent 整理与处理,人来核对确认和验收成果](assets/readme/bs-01-ai-native-hero.gif)
30
+ ![BS工程资料工作台:提出任务,Agent 整理与处理,人来核对确认和验收成果](https://github.com/jdbsh-AI/bs-engineering-suite/raw/bs-v2.9.0-rc.13/assets/readme/bs-01-ai-native-hero.gif)
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.11.tgz`,平台原生文件由加载器选择。DSH 最低版本为 `0.2.2-rc.3`。包含 npm、macOS Desktop 和 Windows Desktop 三套精确 UI 基线;未知字节继续保留宿主原生 UI。历史 rc.4 的3090验证见[rc.4记录](docs/development/bs-v2.9.0-rc.4.md),COS实现的 macOS 隔离验证见[COS记录](docs/development/cos-online-source-20261116.md)。Windows Desktop 实机界面本轮为 `NOT_RUN`,静态包检查不替代实机验收。原适配交付记录保留在 [rc.3 验证记录](docs/development/dsh022-rc3-verification.md)。
34
+ 当前 macOS arm64 与 Windows x64 使用同一个 `bs-engineering-suite-2.9.0-rc.13.tgz`,平台原生文件由加载器选择。DSH Web/CLI 最低版本为 `0.2.2-rc.4`;官方 Desktop feed 尚未发布 rc.4,因此兼容层继续锁定 macOS/Windows 的真实 Desktop `0.2.2-rc.3` 字节。包内包含 npm rc.4、macOS Desktop rc.3 和 Windows Desktop rc.3 三套字节基线,打包为四个平台变体;未知字节继续保留宿主原生 UI。历史 rc.4 的3090验证见[rc.4记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/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.13/docs/development/cos-online-source-20261116.md),本轮的 rc.4 适配与真实安装、浏览器验证见[rc.4验证记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/docs/development/dsh022-rc4-verification.md)。rc.4 Desktop 实机界面与 Windows 原生运行本轮为 `NOT_RUN`,静态包检查不替代实机验收。原 rc.2/rc.3 适配交付记录保留在 [rc.3 验证记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/docs/development/dsh022-rc3-verification.md)。
33
35
 
34
- 进入工程资料模式时按钮从左向右填色,再次点击时从右向左恢复普通状态,并返回原生会话。浅深主题、折叠侧栏、键盘与系统减少动态效果均受支持。rc.3 重载后若仍是工程资料模式但右栏已折叠,入口会重新打开工作台,而不是误退出模式。PR #17 的工程绑定页在套件中位于原生右侧栏的“资料生成绑定”入口,不再增加第二个左侧主页面入口;映射与母版资产仍由业主管理,不随安装包发布。
36
+ 进入工程资料模式时按钮从左向右填色,再次点击时从右向左恢复普通状态,并返回原生会话。浅深主题、折叠侧栏、键盘与系统减少动态效果均受支持。rc.13 重载后若仍是工程资料模式但右栏已折叠,入口会重新打开工作台,而不是误退出模式。在原生右侧栏新增标签页时,选择「工程资料工作台」可进入工作台。
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
- ![资料形成流程:工程材料、整理事实、匹配依据、选择模板和形成初稿](assets/readme/bs-02-document-workflow.gif)
44
+ ![资料形成流程:工程材料、整理事实、匹配依据、选择模板和形成初稿](https://github.com/jdbsh-AI/bs-engineering-suite/raw/bs-v2.9.0-rc.13/assets/readme/bs-02-document-workflow.gif)
43
45
 
44
46
  以上动图为产品理念与流程示意,非实机录屏;资料生成以 Word 路径为例,具体能力以当前版本实际开放范围为准。形成初稿不等于已经通过专业审核。
45
47
 
@@ -55,37 +57,37 @@ RAG资料在 **插件 → BS工程资料系统 → RAG资料包管理** 中刷
55
57
  | Workbench 工程资料工作台 | 工程选择、绑定及工作台交互 |
56
58
  | 文档侧栏预览 | Office 预览及工作台文档预览能力 |
57
59
 
58
- ![五个模块,一套工作流:AI Agent 与 RAG、OAG、EDP、工作台及文档预览协作](assets/readme/bs-03-plugin-collaboration.gif)
60
+ ![五个模块,一套工作流:AI Agent 与 RAG、OAG、EDP、工作台及文档预览协作](https://github.com/jdbsh-AI/bs-engineering-suite/raw/bs-v2.9.0-rc.13/assets/readme/bs-03-plugin-collaboration.gif)
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工程资料系统** 中操作。右侧工作台仅显示已启用包的名称、版本。每个模板版本右侧齿轮菜单提供启停、导出、卸载和删除;历史任务引用会阻止永久删除。已启用用蓝字、已停用用红字,同时保留文字状态。“待完善表式798张”统计包内 SEMANTICS_PENDING 表式,既有专业状态未改变。
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.13/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.13/docs/windows-single-package-check-20261111.md)。工程内只显示当前工程,顶部“工作台首页”可返回工程选择。兼容策略与历史维护说明见 [Windows UI 兼容](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/docs/windows-ui-compat.md),开发背景见[工作台导航说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/docs/development/workbench-navigation.md)。
71
73
 
72
- m2.10 为 macOS 与 Windows 各保留两套 rc.3 UI 兼容副本:一套对应官方 npm 平台中立字节,另一套对应各平台真实 Desktop `app.asar` 字节。只有平台、宿主版本和该套全部原始 SHA-256 精确匹配时才启用,且不注册 `main` 面板、不调用 `selectPanel`;npm/Desktop 混用、未知字节或不完整清单均保留原生 UI。rc.1/rc.2 夹具只保留为历史输入,不会在 rc.3 宿主误启用。
74
+ rc.13 为 macOS 与 Windows 各保留两套 UI 变体,每套包含 sidebar、chat 与 plugin-manager 三个兼容副本:一套对应官方 npm `0.2.2-rc.4` 平台中立字节,另一套对应各平台真实 Desktop `0.2.2-rc.3` 字节。收据格式为 `bs-ui-bundle/v4`,分别记录 `hostVersions.npm` 与 `hostVersions.desktop`。只有平台、变体宿主版本和该套全部原始 SHA-256 精确匹配时才启用,并在运行组合中停用对应的三条原生 UI 行;且不注册 `main` 面板、不调用 `selectPanel`。npm/Desktop 混用、未知字节或不完整清单均保留原生 UI。rc.1/rc.2 夹具只保留为历史输入,不会在 rc.4 宿主误启用。
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;本轮 rc.13 只使用隔离 macOS rc.4 Web Profile 验收,未升级本机 3090,也未部署 Windows 包。欢迎区及运行条的开发背景见[欢迎区说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/docs/development/welcome-brand.md)与[运行状态条说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/docs/development/running-status.md)。
75
77
 
76
78
  ## 资料阅览台
77
79
 
78
- 本轮 macOS 与 Windows m2.6 单包均已内置资料阅览台,无需另装插件。在右侧“工程工作台”连接当前工程后,点击“资料阅览台”→“资料目录”,即可按原文件夹层级浏览已有资料,按名称或相对路径搜索,并按文件类型筛选。目录与搜索结果每页最多 200 项,点击“加载更多”继续查看;资料新增、移动或删除后可点击“刷新”,更新期间可取消并保留上次目录。
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 实机已完成列明的目录、5000 文件分页、检索、刷新与原生预览检查,见[资料阅览台实机记录](docs/windows-document-library-check-20261112.md);Windows 10 尚未实测。操作步骤见 [Windows 使用说明](docs/windows-usage.md),实现与验证边界见[资料阅览台开发说明](docs/development/document-library-v1.md)。
86
+ 历史 Windows 11 实机完成过目录、5000 文件分页、检索、刷新与原生预览检查,见[资料阅览台历史实机记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/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.13/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.13/docs/project/M2-accepted-release-20261023.md)。XLSX 模板生成、真实重算及质量 G3 留在 M3。
97
99
 
98
- ## 安装
100
+ ## 历史安装与回滚
99
101
 
100
- 当前安装方式见本文开头的 rc.7 说明。m2.9 双平台发布页保留为历史 rc.2 回滚入口;下面的 m2.6/m2.5 内容是保留的历史安装与验证记录。
102
+ 当前安装见本文开头及 [Windows 安装说明](docs/windows-install.md)。以下记录对应各自的旧版包和宿主。
101
103
 
102
104
  ### Windows x64:m2.6 历史安装与实机记录
103
105
 
@@ -105,17 +107,17 @@ 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工程资料系统”卡片及模块状态,再按[使用说明](docs/windows-usage.md)在 Windows 本地新建工程。
110
+ 3. 按宿主提示重启,检查“BS工程资料系统”卡片及模块状态。
109
111
 
110
- 当前源码复用已有 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。
112
+ 当前源码复用已有 DeepSeek Harness,声明范围为 `>=0.2.2-rc.4 <0.3.0`;已用 `0.2.2-rc.4` 的隔离真实 Web 宿主验证。已经发布的 m2.6/m2.9/2.9.0-rc.12 资产仍声明并实测各自的历史 rc 版本。要求宿主实际使用 Node `>=24.9.0`,具备内置 `node:sqlite` / FTS5,并禁止 SQLite 扩展加载。BS 不捆绑 DSH 或 Node,不修改宿主安装目录、系统 PATH 或用户全局 Node。安装不依赖 `postinstall`,官方 CLI 使用 `--ignore-scripts` 也可安装,普通用户无需使用 CLI。
111
113
 
112
114
  Windows 11 Pro 24H2 x64、build `26100.7840` 已有实测记录;Windows 10 22H2 与其他系统矩阵仍待验证。当前只面向 Windows 本机固定 NTFS 目录的新建使用,不支持搬入 Mac 工程目录。安装不会自动选目录、调用模型或开放写入;任务提交须另有指定工程、指定会话的授权,不建议全局放开。
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.13/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.13/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.13/docs/macos-m26-release-check-20261112.md)。
134
136
 
135
137
  ### macOS arm64:m2.5 回滚
136
138
 
@@ -159,21 +161,21 @@ 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.13/docs/windows-build.md)。
163
165
 
164
- 普通构建重新编译各模块 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` 指定同版本只读源码;协议变更必须单独重生成并审核清单,不属于普通打包。
166
+ 普通构建重新编译各模块 Host 和 Client。本次 rc.4 迁移已用官方 `0.2.2-rc.4` Typert generator / protocol 重生成并核收 EDP、D03、RAG、OAG 与 Workbench 的生成桥;普通构建只按固定清单核验完整字节和 SHA256,不在合并时重生成全局 SDK 声明图。Workbench 继续由固定官方生成器重生成其 Host/Remote。需要开发 EDP 协议时,`sdk:source` 可下载固定官方 `dsh-v0.2.2-rc.4` 源码到被 Git 忽略的 `.cache/deepseek-harness`,或以 `DSH_TARGET_SOURCE` 指定同版本只读源码;协议变更必须单独重生成并审核清单,不属于普通打包。
165
167
 
166
168
  macOS 原生确认载体在包内保留,构建时校验既有签名与摘要;需要重新编译时使用 EDP 的 `build:native-confirm`。OAG 平台构建脚本在 `packages/oag/scripts/`。
167
169
 
168
- 本轮 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 与实机覆盖范围见 [单包验证记录](docs/windows-single-package-check-20261111.md)。源码仓不含项目数据、凭据、会话、原始日志或 node_modules。
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.13/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.13/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。当前 Web/CLI 宿主固定为 `0.2.2-rc.4`,不调用模型。静态包校验不替代此运行检查,详见 [Host 贡献与安装回归](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/docs/development/typert-host-contribution.md)。
173
175
 
174
176
  ## 来源与许可
175
177
 
176
- 整合基线为 EDP `0.4.8-local.1`、RAG `0.1.2`、OAG `0.2.3`、Workbench `0.2.5`、Office Preview `0.1.1` 的 DSH 0.2.1 适配版本;Workbench 入口调整后为 `0.2.6`。DSH 0.2.2-rc.1 适配将套件版本推进到 `0.1.0-alpha.3-m2.5`(子包 EDP `0.4.9-m2.5`、RAG `0.1.3-m2.5`、OAG `0.2.4-m2.5`、Workbench `0.2.7-m2.5`、Office Preview `0.1.2-m2.5`);m2.6 是 Windows 单包发布版本,m2.7 加入工作区选择器和诊断支持,m2.8 将套件依赖、Typert 与客户端统一适配到 DSH `0.2.2-rc.2`,m2.9 增加 macOS/Windows npm rc.2 UI 兼容副本,m2.10 将业务依赖、Typert 与双平台 npm/Desktop UI 字节升级到 DSH `0.2.2-rc.3`,不改写既有 M2 验收历史。四个历史远端是 `dsh-engineering-edp-plugin`、`dsh-engineering-rag-plugin`、`dsh-engineering-oag-plugin`、`dsh-sidebar-office-preview`。Workbench 来源是本地 EDP 开发目录内的独立子包,未确认独立历史远端。
178
+ 整合基线为 EDP `0.4.8-local.1`、RAG `0.1.2`、OAG `0.2.3`、Workbench `0.2.5`、Office Preview `0.1.1` 的 DSH 0.2.1 适配版本;Workbench 入口调整后为 `0.2.6`。DSH 0.2.2-rc.1 适配将套件版本推进到 `0.1.0-alpha.3-m2.5`(子包 EDP `0.4.9-m2.5`、RAG `0.1.3-m2.5`、OAG `0.2.4-m2.5`、Workbench `0.2.7-m2.5`、Office Preview `0.1.2-m2.5`);m2.6 是 Windows 单包发布版本,m2.7 加入工作区选择器和诊断支持,m2.8 将套件依赖、Typert 与客户端统一适配到 DSH `0.2.2-rc.2`,m2.9 增加 macOS/Windows npm rc.2 UI 兼容副本,m2.10 将业务依赖、Typert 与双平台 npm/Desktop UI 字节升级到 DSH `0.2.2-rc.3`,rc.13 再将 Web/CLI cohort 与 Typert 推进到 `0.2.2-rc.4` 并保持 Desktop rc.3 精确字节,不改写既有 M2 验收历史。四个历史远端是 `dsh-engineering-edp-plugin`、`dsh-engineering-rag-plugin`、`dsh-engineering-oag-plugin`、`dsh-sidebar-office-preview`。Workbench 来源是本地 EDP 开发目录内的独立子包,未确认独立历史远端。
177
179
 
178
180
  统一维护仓库:`jdbsh-AI/bs-engineering-suite`。历史仓库保留,后续本套件的源码、问题与发布以本仓为入口。许可为 MIT,各模块原版权及第三方许可见 `NOTICE.md` 和 `packages/` 下的许可文件。
179
181
 
@@ -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),当前交付见 [M2说明](docs/project/M2-accepted-release-20261023.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.13/docs/project/M15-closure-and-M2-handover-20261022.md),当时交付见 [M2说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/docs/project/M2-accepted-release-20261023.md)。四个历史仓库已只读归档,后续维护以本仓为唯一入口。
187
189
 
188
190
  ## 模板与配套语义
189
191
 
190
192
  新增统一模板包:Excel、RDF、SHACL、字段映射和规范来源一起安装;任务按所选模板固定语义修订。插件内支持修改、补充依据文件及导出派生版本。
191
193
 
192
- 使用方式、能力状态与840份广东Excel基线见 [内容包使用说明](docs/content-packs/USER_GUIDE.md),接口与隔离方式见 [架构说明](docs/content-packs/ARCHITECTURE.md)。该入口形成技术候选,专业规则、实际Office应用和桌面验收分别记录。
194
+ 当前使用方式见 [模板包安装与使用说明](docs/content-packs/TEMPLATE_PACKAGE_GUIDE.md)。历史作者资料见 [旧版维护者指南](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/docs/content-packs/USER_GUIDE.md),接口与隔离方式见 [架构说明](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/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.13/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.13` 通用安装包。DSH Web/CLI 目标为 `0.2.2-rc.4`;官方 Desktop feed 尚未发布 rc.4,Desktop UI 继续使用 `0.2.2-rc.3` 精确字节。DSH 实际运行的 Node 须为 `24.9.0` 或更高版本,并具备内置 SQLite 和 FTS5。Windows 原生 `.node`、rc.4 Desktop 和实机界面的 rc.13 验收为 `NOT_RUN`。
4
+
5
+ ## 在 DSH 插件页安装
6
+
7
+ 1. 打开已有 DSH 的「插件」页,输入 `bs-engineering-suite` 安装。需要精确版本时可输入 `bs-engineering-suite@2.9.0-rc.13`。
8
+ 2. 使用文件安装时,从 [已发布的 rc.13 Release](https://github.com/jdbsh-AI/bs-engineering-suite/releases/tag/bs-v2.9.0-rc.13) 下载 `bs-engineering-suite-2.9.0-rc.13.tgz`。已发布通用包覆盖 Windows x64 与 macOS arm64。GitHub 下载需要仓库读取权限。使用本地候选时,先在随附回执确认其为 Windows x64 安装包或通用安装包。
9
+ 3. 将安装文件的本地绝对路径填入安装源,无需解压。例如 `D:\下载\BS 安装包\bs-engineering-suite-2.9.0-rc.13.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.13.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.13`。DSH Web/CLI 目标为 `0.2.2-rc.4`;官方 Desktop feed 尚未发布 rc.4,因此 Desktop UI 兼容基线仍为 `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.13 的 Windows 原生 `.node`、rc.4 Desktop 和实机界面为 `NOT_RUN`。此前 Windows 11 的目录、检索、分页和预览检查见 [历史资料阅览台实机记录](https://github.com/jdbsh-AI/bs-engineering-suite/blob/bs-v2.9.0-rc.13/docs/windows-document-library-check-20261112.md)。宿主和安装版本见 [安装说明的历史记录](windows-install.md#历史-windows-实机记录)。
package/lib/ui-policy.cjs CHANGED
@@ -7,6 +7,7 @@ const { pathToFileURL } = require('node:url')
7
7
 
8
8
  const GROUP_ID = 'buildseek-ui-compat'
9
9
  const MARKER = 'BS_UI_BUNDLE_V1'
10
+ const VARIANT_VERSIONS = { npm: '0.2.2-rc.4', desktop: '0.2.2-rc.3' }
10
11
  const ROOT = dirname(__dirname)
11
12
  const BUNDLE_LAYER = join(ROOT, 'ui-compat')
12
13
  const universal = JSON.parse(readFileSync(join(ROOT, 'package.json'), 'utf8')).buildseek?.target === 'universal'
@@ -77,8 +78,10 @@ function inspect(ctx, data, baseline) {
77
78
  if (!profile?.installAnchor || !profile?.dir || !profile?.home) fail('PROFILE_CONTEXT_REQUIRED')
78
79
  if (!within(profile.dir, ROOT)) fail('PACKAGE_OUTSIDE_PROFILE')
79
80
  const receipt = JSON.parse(readFileSync(join(LAYER, 'receipt.json'), 'utf8'))
80
- if (receipt.format !== 'bs-ui-bundle/v3' || !['win32', 'darwin'].includes(receipt.platform)
81
- || receipt.platform !== process.platform || !/^0\.2\.2-rc\.3$/.test(receipt.hostVersion)
81
+ if (receipt.format !== 'bs-ui-bundle/v4' || !['win32', 'darwin'].includes(receipt.platform)
82
+ || receipt.platform !== process.platform || !receipt.hostVersions
83
+ || Object.keys(receipt.hostVersions).sort().join('\n') !== Object.keys(VARIANT_VERSIONS).sort().join('\n')
84
+ || Object.entries(VARIANT_VERSIONS).some(([id, version]) => receipt.hostVersions[id] !== version)
82
85
  || !Array.isArray(receipt.variants) || !receipt.variants.length) fail('RECEIPT_INVALID')
83
86
  const host = createRequire(profile.installAnchor)
84
87
  const raw = flatten(data)
@@ -112,12 +115,13 @@ function inspect(ctx, data, baseline) {
112
115
  const names = [...expected.values()].sort()
113
116
  const matches = []
114
117
  for (const variant of receipt.variants) {
115
- if (!variant || typeof variant.id !== 'string' || !variant.id || !Array.isArray(variant.packages)
118
+ if (!variant || typeof variant.id !== 'string' || !VARIANT_VERSIONS[variant.id]
119
+ || variant.hostVersion !== VARIANT_VERSIONS[variant.id] || !Array.isArray(variant.packages)
116
120
  || variant.packages.length !== names.length
117
121
  || variant.packages.map(pkg => pkg.name).sort().join('\n') !== names.join('\n')) fail('RECEIPT_INVALID')
118
122
  let matched = true, managerMatched = beforeRows.has('ui-plugin-manager')
119
123
  for (const pkg of variant.packages) {
120
- if (pkg.version !== receipt.hostVersion || !pkg.originalHashes || typeof pkg.originalHashes !== 'object') fail('RECEIPT_INVALID')
124
+ if (pkg.version !== variant.hostVersion || !pkg.originalHashes || typeof pkg.originalHashes !== 'object') fail('RECEIPT_INVALID')
121
125
  let native, packageMatched = true
122
126
  try { native = dirname(host.resolve(pkg.name + '/package.json')) } catch { packageMatched = false }
123
127
  for (const [file, digest] of Object.entries(pkg.originalHashes)) {
@@ -152,7 +156,9 @@ function inspect(ctx, data, baseline) {
152
156
  originals.push({ ...structuredClone(beforeRows.get(id).row), id: 'buildseek-compat-' + id,
153
157
  name: pathToFileURL(join(LAYER, 'vendor', selected.id, pkg.name, 'lib/index.js')).href })
154
158
  }
155
- return { compatible: true, reason: receipt.platform === 'darwin' ? 'MATCHED_DARWIN_RC3' : 'MATCHED_WINDOWS_RC3', rows: originals }
159
+ const platform = receipt.platform === 'darwin' ? 'DARWIN' : 'WINDOWS'
160
+ const family = selected.id === 'npm' ? 'RC4_NPM' : 'RC3_DESKTOP'
161
+ return { compatible: true, reason: `MATCHED_${platform}_${family}`, rows: originals }
156
162
  }
157
163
  function snapshot(ctx) {
158
164
  let data
@@ -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>): VerifiedBundle;
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
- const xml = decodeText(part);
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
- const files = readBoundedZip(bytes, limits);
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
- return sha256(JSON.stringify({ sources: view.manifest.sources, members: [...paths].sort().map(path => [path, sha256(view.members.get(path))]) }));
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);