dsh-expert-group 0.1.3 → 0.1.4

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.
@@ -192,8 +192,9 @@ export function buildToastXml({ title, taskName, body } = {}) {
192
192
  /**
193
193
  * 默认提示音路径:以本模块文件位置解析包内 assets/notification-whoosh.wav。
194
194
  *
195
- * 用 import.meta.url 而不是 __dirname/cwd:模块被 web-install.ps1 复制到
196
- * profiles\packages\dsh-expert-group 后依然指向同一份随包发布的资源。
195
+ * 用 import.meta.url 而不是 __dirname/cwd:assets/ 随 package.json 的 files 白名单发布,
196
+ * 安装副本(web 的 profiles\packages\dsh-expert-group、desktop 的 profile node_modules)
197
+ * 无论落在哪里,都按模块路径解析到同一份随包发布的资源。
197
198
  * 返回值只用于 stdin JSON,绝不进入命令行、日志、诊断或脚本文本。
198
199
  */
199
200
  export function defaultNotificationAudioPath() {
package/index.js CHANGED
@@ -809,7 +809,7 @@ function normalizeNotificationHoldMs(value) {
809
809
  * 插件组合 Config。
810
810
  *
811
811
  * 前两个字段是插件启停配置(普通 Config):它们是部署期行为,不是设置页的即时偏好。
812
- * 其余九个字段是设置页可即时修改的偏好,必须标记 `.volatile()`:DSH 0.1.7 的
812
+ * 其余十个字段是设置页可即时修改的偏好,必须标记 `.volatile()`:DSH 0.1.7 的
813
813
  * `ctx.settings` 只把「本条目 Config 上的 volatile 字段」投影成可编辑表单,并且
814
814
  * **只有声明了 volatile 字段的条目才会出现在 `describe()` 中**;写入非 volatile
815
815
  * 路径会被宿主直接拒绝。
@@ -817,7 +817,7 @@ function normalizeNotificationHoldMs(value) {
817
817
  * 字段语义与默认值必须与设置页的读取面一致:`describe()` 返回的 value 是
818
818
  * defaults resolved 后的结果(provider 空字符串表示用户尚未选择 provider,
819
819
  * promptOverrides 空对象表示全部跟随代码默认 persona)。运行期读源由
820
- * host/settings-source 从 describe() 取得,提交端点只写这九个字段。
820
+ * host/settings-source 从 describe() 取得,提交端点只写这十个字段。
821
821
  */
822
822
  const Config = z.object({
823
823
  // 主代理能力默认启用;false 可用于仅使用专家工具的兼容部署。
@@ -834,6 +834,9 @@ const Config = z.object({
834
834
  observerPreferred: z.boolean().default(false).volatile(),
835
835
  // 「任务管理」开关默认开启:旧文档缺字段时维持 Expert Group 注册到侧边栏的历史行为。
836
836
  taskManagementEnabled: z.boolean().default(true).volatile(),
837
+ // 「自动打开运行中的子代理侧栏」默认关闭:这是纯增量体验,旧文档/旧客户端缺字段时
838
+ // 必须保持「不做任何自动 open/close」的历史行为,绝不能按开启解释。
839
+ autoOpenSubagentSidebar: z.boolean().default(false).volatile(),
837
840
  // 六个角色的专家专属提示词覆盖(角色 id -> 自定义文本)。缺失或空对象表示全部
838
841
  // 使用代码里的默认 persona;这里只做类型层(角色键与长度)校验,写入边界的
839
842
  // 语义校验在 DEG 自有提交端点内(宿主新契约没有 validate 钩子)。
@@ -971,6 +974,9 @@ function normalizeSnapshot(snapshot, visibleRoles) {
971
974
  observerPreferred: snapshot?.observerPreferred === true,
972
975
  // 只有显式 false 才关闭侧边栏注册;缺字段(旧配置/旧客户端)按历史行为保持开启。
973
976
  taskManagementEnabled: snapshot?.taskManagementEnabled !== false,
977
+ // 只有显式 true 才开启自动打开;缺字段(旧文档/旧客户端/非法值)一律按关闭归一,
978
+ // 历史行为因此逐字节不变:默认不做任何自动 open/close。
979
+ autoOpenSubagentSidebar: snapshot?.autoOpenSubagentSidebar === true,
974
980
  };
975
981
  }
976
982
 
@@ -4052,6 +4058,7 @@ export default {
4052
4058
  roleConcurrencyLimit: DEFAULT_ROLE_CONCURRENCY_LIMIT,
4053
4059
  observerPreferred: false,
4054
4060
  taskManagementEnabled: true,
4061
+ autoOpenSubagentSidebar: false,
4055
4062
  });
4056
4063
  // binding 生成器由 host/storage-binding 持有;storageBinding.* 调用为兼容投影。
4057
4064
  // ready 前和服务重载期间保留最后一次成功读取的快照,避免空快照覆盖已加载数据。
@@ -4097,6 +4104,9 @@ export default {
4097
4104
  roleConcurrencyLimit: settingsSnapshot.roleConcurrencyLimit,
4098
4105
  observerPreferred: settingsSnapshot.observerPreferred,
4099
4106
  taskManagementEnabled: settingsSnapshot.taskManagementEnabled,
4107
+ // 自动打开属于全局 settings:必须随同一份快照进入 source(),否则冷恢复/服务重载
4108
+ // 之后 client 读到的值会悄悄退回默认关闭。
4109
+ autoOpenSubagentSidebar: settingsSnapshot.autoOpenSubagentSidebar,
4100
4110
  ...storageBinding.snapshots(),
4101
4111
  };
4102
4112
  }
@@ -4172,6 +4182,7 @@ export default {
4172
4182
  roleConcurrencyLimit: DEFAULT_ROLE_CONCURRENCY_LIMIT,
4173
4183
  observerPreferred: false,
4174
4184
  taskManagementEnabled: true,
4185
+ autoOpenSubagentSidebar: false,
4175
4186
  }, {
4176
4187
  setSource(next) {
4177
4188
  settingsSource = () => normalizeSnapshot(next(), activeRoles());
@@ -4656,6 +4667,12 @@ export default {
4656
4667
  if (hasTaskManagementEnabled && typeof candidate.taskManagementEnabled !== "boolean") {
4657
4668
  throw new ValidationError("设置 taskManagementEnabled 无效");
4658
4669
  }
4670
+ // 自动打开沿用同一兼容语义(与 taskManagementEnabled 逐字同款):缺字段表示旧客户端,
4671
+ // 不写 patch;显式提供时严格要求布尔,绝不用 truthy 值隐式开启自动行为。
4672
+ const hasAutoOpenSubagentSidebar = candidate.autoOpenSubagentSidebar !== void 0;
4673
+ if (hasAutoOpenSubagentSidebar && typeof candidate.autoOpenSubagentSidebar !== "boolean") {
4674
+ throw new ValidationError("设置 autoOpenSubagentSidebar 无效");
4675
+ }
4659
4676
  // 提示词覆盖沿用同一"缺字段即不覆盖"兼容语义:旧客户端提交的候选被原样放行,
4660
4677
  // 已有的自定义提示词不会被一次无关的通知设置保存清空。
4661
4678
  const hasPromptOverrides = candidate[PROMPT_OVERRIDES_SETTINGS_KEY] !== void 0;
@@ -4680,6 +4697,8 @@ export default {
4680
4697
  observerPreferred: candidate.observerPreferred === true,
4681
4698
  // 缺字段(旧客户端/旧文档)按开启归一:默认必须维持侧边栏注册的历史行为。
4682
4699
  taskManagementEnabled: candidate.taskManagementEnabled !== false,
4700
+ // 缺字段(旧客户端/旧文档)按关闭归一:默认必须维持「无自动 open/close」的历史行为。
4701
+ autoOpenSubagentSidebar: candidate.autoOpenSubagentSidebar === true,
4683
4702
  };
4684
4703
  }
4685
4704
 
@@ -4711,6 +4730,9 @@ export default {
4711
4730
  function commitSettingsCandidate(candidate, expectedRevision, signal) {
4712
4731
  // 旧客户端缺少任务管理字段时既不写 patch,也不在响应里新增字段(保持历史形状)。
4713
4732
  const hasTaskManagementEnabled = candidate?.taskManagementEnabled !== void 0;
4733
+ // 自动打开同理:缺字段不写 patch,也不在响应里新增字段——一次无关的通知设置保存
4734
+ // 绝不能把用户已经开启的自动打开重置回默认关闭。
4735
+ const hasAutoOpenSubagentSidebar = candidate?.autoOpenSubagentSidebar !== void 0;
4714
4736
  // 提示词覆盖同理:缺字段不写 patch,避免旧客户端的保存顺带清空已有自定义提示词。
4715
4737
  const hasPromptOverrides = candidate?.[PROMPT_OVERRIDES_SETTINGS_KEY] !== void 0;
4716
4738
  return settingsRuntime.enqueueCommit(async () => {
@@ -4733,6 +4755,8 @@ export default {
4733
4755
  ...(candidate.observerPreferred === void 0 ? {} : { observerPreferred: validated.observerPreferred }),
4734
4756
  // 任务管理同样是「缺字段即不覆盖」:旧客户端保存通知设置不得顺带重置侧边栏注册。
4735
4757
  ...(hasTaskManagementEnabled ? { taskManagementEnabled: validated.taskManagementEnabled } : {}),
4758
+ // 自动打开沿用同一写面规则:只有显式提供该字段的候选才能改写它。
4759
+ ...(hasAutoOpenSubagentSidebar ? { autoOpenSubagentSidebar: validated.autoOpenSubagentSidebar } : {}),
4736
4760
  // 提示词覆盖按整份映射提交(不做键级合并):空对象显式清空全部自定义提示词。
4737
4761
  ...(hasPromptOverrides ? { [PROMPT_OVERRIDES_SETTINGS_KEY]: validated[PROMPT_OVERRIDES_SETTINGS_KEY] } : {}),
4738
4762
  };
@@ -4745,6 +4769,7 @@ export default {
4745
4769
  if (candidate.observerPreferred === void 0) delete committedSettings.observerPreferred;
4746
4770
  if (candidate.roleConcurrencyLimit === void 0) delete committedSettings.roleConcurrencyLimit;
4747
4771
  if (!hasTaskManagementEnabled) delete committedSettings.taskManagementEnabled;
4772
+ if (!hasAutoOpenSubagentSidebar) delete committedSettings.autoOpenSubagentSidebar;
4748
4773
  if (!hasPromptOverrides) delete committedSettings[PROMPT_OVERRIDES_SETTINGS_KEY];
4749
4774
  return {
4750
4775
  settings: committedSettings,
@@ -9524,6 +9549,8 @@ export default {
9524
9549
  roleConcurrencyLimit: snap.roleConcurrencyLimit,
9525
9550
  // 任务管理默认开启:meta 只回传归一后的生效值,供设置页与诊断读取。
9526
9551
  taskManagementEnabled: snap.taskManagementEnabled !== false,
9552
+ // 自动打开默认关闭:meta 只回传归一后的生效布尔值。
9553
+ autoOpenSubagentSidebar: snap.autoOpenSubagentSidebar === true,
9527
9554
  // 只读提示词自定义投影:六个角色(含未启用的 observer)、各自当前生效的
9528
9555
  // 专家专属 persona 与 grapheme 上限。设置页据此渲染编辑器与"恢复默认",
9529
9556
  // 不需要也不允许自己猜测 Host 状态。这里不含固定执行纪律副本。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-expert-group",
3
- "version": "0.1.3",
3
+ "version": "0.1.4",
4
4
  "description": "DSH 专家子代理、Expert Group 任务侧边栏与设置页(双面 bundle)",
5
5
  "type": "module",
6
6
  "main": "./index.js",
@@ -65,10 +65,7 @@
65
65
  "cordis.patch.yml",
66
66
  "README.md",
67
67
  "THIRD_PARTY_NOTICES.md",
68
- "LICENSE",
69
- "web-install.ps1",
70
- "web-uninstall.ps1",
71
- "desktop-uninstall.ps1"
68
+ "LICENSE"
72
69
  ],
73
70
  "dsh": {
74
71
  "bundle": {