dsh-schedule-ilife 0.3.11 → 0.3.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/dist/client.js CHANGED
@@ -28,50 +28,52 @@ window.__ModuleLoader__.load({
28
28
  //#endregion
29
29
  let react = require("react");
30
30
  react = __toESM(react, 1);
31
- //#region src/slot.ts
32
- const SLOT_TITLE = "作息管家";
33
- const PLUGIN = "dsh-schedule-ilife";
34
- //#endregion
35
- //#region src/settings.ts
36
- /** 常用项:#764 起是「可改 1 + 只读 2」(高级组已空,见下)。 */
37
- const COMMON = [
38
- {
39
- key: "db.dir",
40
- title: "数据目录",
41
- tier: "common",
42
- control: "directory",
43
- prefillFrom: "dataDir",
44
- hint: "库文件与产物的根目录。留空=用默认目录。"
45
- },
46
- {
47
- key: "db.name",
48
- title: "库文件名",
49
- tier: "common",
50
- control: "text",
51
- readonly: true,
52
- resolveFrom: "dbFile",
53
- hint: "数据目录下的库文件。只读,要改请编辑配置文件。"
54
- },
55
- {
56
- key: "html.dir",
57
- title: "HELP 产物目录",
58
- tier: "common",
59
- control: "text",
60
- readonly: true,
61
- resolveFrom: "htmlDir",
62
- hint: "HELP 页面的存放目录。只读,要改请编辑配置文件。"
63
- }
64
- ];
65
- /** 高级项:#764 起已空(`files.help`/`lark.cliPath` 出配置表)——组还在,行没有。
66
- * 空组不渲染(见 client.ts),行表长度即 3。 */
67
- const ADVANCED = [];
68
- /** 设置页的行表,顺序即页面顺序。 */
69
- const CONFIG_ITEMS = [...COMMON, ...ADVANCED];
70
- /** 常用项行数(页面上直接画出来的那些)。 */
71
- const COMMON_ITEM_COUNT = COMMON.length;
72
- /** 高级组标题与副文案。 */
31
+ //#region ../plugin-manager/dist/config-panel-contract.js
32
+ /** 共用配置面板 · 契约:行表形状、配置面回执、几条两侧共用的常量。
33
+ *
34
+ * 为什么住这里:六个单品插件的设置页各有一份逐字相同的那套代码(卡片骨架/行渲染/样式表/
35
+ * 状态机/配置面三通电话约 3105 行)。本件是抽件之后的**唯一一处定义地**。
36
+ *
37
+ * 本件不认识任何一家能力:行表由调用方给,分支只能由行表数据与配置面回执决定,
38
+ * 里面不出现任何一个能力的名字(结构纪律「依赖方向」)。
39
+ *
40
+ * 对外只经 `config-panel-api.ts` 那一道门;本件自己不出门。
41
+ */
42
+ /** 面板对配置面的三通电话:读整面/保存一份取值/重置为默认。三个名字各家逐字相同,收在这里一处。 */
43
+ const RPC_ENDPOINT_CONFIG_GET = "config.get";
44
+ const RPC_ENDPOINT_CONFIG_SAVE = "config.save";
45
+ const RPC_ENDPOINT_CONFIG_RESET = "config.reset";
46
+ /** 高级组标题与副文案(六家逐字相同,收在这里一处)。 */
73
47
  const ADVANCED_GROUP_TITLE = "高级";
74
48
  const ADVANCED_GROUP_NOTE = "不常改。留空=用默认值。";
49
+ /** 请求超时毫秒:与宿主侧 SPAWN_TIMEOUT_MS 同级,界面永不无限转圈。 */
50
+ const READ_TIMEOUT_MS$1 = 2e4;
51
+ /** 复制那一枚按钮就地变「已复制」之后,多久变回「复制」(定稿 v3 第三条:1.5 秒,不弹提示)。 */
52
+ const COPY_FEEDBACK_MS = 1500;
53
+ /** 宿主给「这是哪一种目录选择能力」时用的那两格原语的名字(软依赖:按名字现取,缺席即没有入口)。 */
54
+ const REMOTE_DIRECTORY_PICKER = "remote.directoryPicker";
55
+ /** 宿主在「这条路不给」时回的那个码(`directory-browser-state` 的 `openRowBrowser` 只照比不认名)。 */
56
+ const DIRECTORY_PICKER_REFUSED = "directory-picker/unavailable";
57
+ /** 信封守卫:拆包前校验(信封形状的定义地在这里)。 */
58
+ function isRpcResult$1(raw) {
59
+ if (typeof raw !== "object" || raw === null) return false;
60
+ return raw.ok === true || raw.ok === false;
61
+ }
62
+ //#endregion
63
+ //#region ../plugin-manager/dist/config-panel-value.js
64
+ /** 共用配置面板 · 取值与填值半:一份配置取值 ↔ 一张表单态,外加脏基线、跟随键、人话报错与三通电话。
65
+ *
66
+ * 本件**不认识 React**,也不认识宿主:喂一份配置面回执与一张行表,它把「页面上每一行该显示什么」
67
+ * 算出来(取值),再把「表单态里哪几格真能改」还原成一份取值(填值)。因此它在 Node 里就能直测。
68
+ *
69
+ * 三条口径(照 #749 起的定稿):
70
+ * · **只读行显示技能算好的绝对值**(回执 `resolved` 组那一格):面板一个字都不算;回执缺那一格
71
+ * (旧技能)就显示空串,绝不编一条路径出来。
72
+ * · **可改行取值空着**时,直接把回执里那个落点绝对路径显示上去——用户不必自己拼路径。
73
+ * · **保存只提交真能改的行**:只读行显示的是绝对路径,把它当配置值写回去就是把「显示」当「配置」。
74
+ *
75
+ * 对外只经 `config-panel-api.ts` 那一道门;本件自己不出门。
76
+ */
75
77
  /** 按 `a.b` 路径从配置取值里读(缺层或类型不符一律回 undefined)。 */
76
78
  function readPath(values, key) {
77
79
  const parts = key.split(".");
@@ -94,57 +96,157 @@ window.__ModuleLoader__.load({
94
96
  }
95
97
  cur[parts[parts.length - 1]] = value;
96
98
  }
97
- //#endregion
98
- //#region src/contract.ts
99
- /** dsh-schedule-ilife 端口(port):DSH 世界与作息管家六边形之间的契约。
99
+ /** 落点来源取一格:先看回执 `resolved` 组同名格,再看回执顶层同名格(两种写法收成同一格)。
100
100
  *
101
- * browser 安全:零 node 导入。host 适配器(注册 RPC 通道)与 client 适配器(调用 RPC)
102
- * 共用同一份定义。通道命名遵守宿主约束:单段且不等于 /api(见 cookbook「RPC 通道」)。
103
- *
104
- * 照 #56 卡路里/#677 记账/#696 大厨样板同形:作息插件原先**没有任何 RPC 通道**,本件是它
105
- * 第一份端口定义(#696:设置页要读改配置,走的就是这条通道)。
106
- */
107
- const RPC_CHANNEL = "/ilife-schedule-ilife";
108
- /** #696 配置端点:读设置页整面、保存一份取值、重置为默认。同走一条通道,靠端点名分发。 */
109
- const RPC_ENDPOINT_CONFIG_GET = "config.get";
110
- const RPC_ENDPOINT_CONFIG_SAVE = "config.save";
111
- const RPC_ENDPOINT_CONFIG_RESET = "config.reset";
112
- /** #706 配置体检端点:只读一次,回一份报告(判据由技能侧出,本包只透传,不重写一个字)。
101
+ * 顶层那一格为什么只认 `dataDir`:它是**技能算出来的生效数据目录**这个概念的格名,各家的回执
102
+ * 都叫它 `dataDir`;其余落点(照片目录、附件目录等)一律住在 `resolved` 组里。本件不猜别的名字。 */
103
+ function prefillValueOf(source, name) {
104
+ const fromResolved = source.resolved?.[name];
105
+ if (typeof fromResolved === "string" && fromResolved !== "") return fromResolved;
106
+ if (name === "dataDir" && typeof source.dataDir === "string" && source.dataDir !== "") return source.dataDir;
107
+ }
108
+ /** 只读行显示什么:标了 `resolveFrom` ⇒ 回执 `resolved` 组那一格(技能算好的绝对路径);
109
+ * 没标 ⇒ 配置文件里那个值本身(数字类只读项走这一档:显示的是生效数字)。 */
110
+ function readonlyTextOf(item, raw, source) {
111
+ if (item.resolveFrom === void 0) return raw;
112
+ const shown = source.resolved?.[item.resolveFrom];
113
+ return typeof shown === "string" ? shown : "";
114
+ }
115
+ /** 把配置取值铺成「行键 → 控件里的文本」(页面表单态;值缺项即空串,不返空留白)。 */
116
+ function toDraft(items, values, source) {
117
+ const draft = {};
118
+ for (const item of items) {
119
+ const v = readPath(values, item.key);
120
+ const raw = v === void 0 || v === null ? "" : String(v);
121
+ if (item.readonly === true) {
122
+ draft[item.key] = readonlyTextOf(item, raw, source);
123
+ continue;
124
+ }
125
+ const fallback = item.prefillFrom === void 0 ? void 0 : prefillValueOf(source, item.prefillFrom);
126
+ draft[item.key] = raw === "" && fallback !== void 0 ? fallback : raw;
127
+ }
128
+ return draft;
129
+ }
130
+ /** 表单态 → 配置取值(按控件种类还原类型;空串对文本项照收,语义由「按默认落点」承担)。
113
131
  *
114
- * 端点名与技能侧那条只读命令同名(`<技能>.config.check`);报告形状的唯一真相在技能侧
115
- * `packages/skill-<技能>/src/health.ts`,面板侧镜像在 `packages/plugin-manager/src/health-contract.ts`。 */
116
- const RPC_ENDPOINT_CONFIG_CHECK = "config.check";
117
- /** 信封守卫:供 client 拆包前校验(port 拥有信封定义,守卫住 port)。 */
118
- function isRpcResult(raw) {
119
- if (typeof raw !== "object" || raw === null) return false;
120
- const okFlag = raw.ok;
121
- return okFlag === true || okFlag === false;
132
+ * **只读行不收**:它们显示的是技能算好的绝对路径,写回配置就是把「显示的路径」当成「配置值」——
133
+ * 保存只提交真能改的那些行,其余键由技能侧做组内合并保留现值。 */
134
+ function fromDraft(items, draft) {
135
+ const values = {};
136
+ for (const item of items) {
137
+ if (item.readonly === true) continue;
138
+ const raw = draft[item.key] ?? "";
139
+ if (item.control === "number") {
140
+ const n = Number(raw);
141
+ writePath(values, item.key, Number.isFinite(n) ? n : 0);
142
+ } else if (item.control === "switch") writePath(values, item.key, raw === "true");
143
+ else writePath(values, item.key, raw);
144
+ }
145
+ return values;
122
146
  }
123
- //#endregion
124
- //#region src/dsh-ctx.ts
125
- /** 宿主目录选择命名空间的服务名(#736;出处与禁令见 cookbook §13)。 */
126
- const REMOTE_DIRECTORY_PICKER = "remote.directoryPicker";
127
- /** 宿主「这条路没给」的回执码(#744):一次组合里只服务一种能力(native 或 browse),
128
- * 另一条路上的动词一律回它。
147
+ /** 可改行(脏基线只看这一档)。 */
148
+ function editableItemsOf(items) {
149
+ return items.filter((item) => item.readonly !== true);
150
+ }
151
+ /** 脏键:表单态里与「刚读到的整面」不一致的**可改行**。
129
152
  *
130
- * 出处:`@deepseek-ai/dsh-api-workspace-controller/lib/types/directory-picker.js` 的 `requireCapability()`
131
- * ——`RemoteError('directory-picker/unavailable', …)`。三条动词在客户端命名空间上都在,
132
- * 所以只有真调一次、看它拒没拒,才知道组合里服务哪种能力。
133
- * 共用件不认识这个名字(只照比对),于是这条宿主事实住在本镜像里。 */
134
- const DIRECTORY_PICKER_REFUSED = "directory-picker/unavailable";
135
- /** 总管那条电话通道的两个字面量(#744):载体第一段与第二段。
153
+ * 只读行不进来:它们显示的是技能算好的绝对路径,拿它当「改动」会让面板一打开就显示「未保存」。 */
154
+ function dirtyKeysOf(items, draft, baseline) {
155
+ return editableItemsOf(items).filter((item) => (draft[item.key] ?? "") !== (baseline[item.key] ?? "")).map((item) => item.key);
156
+ }
157
+ /** 跟随映射的缺省:没有映射就是「一行都不跟随」。 */
158
+ function noFollowKeys() {
159
+ return [];
160
+ }
161
+ /** 这一行有没有「写的值 ≠ 生效值」这回事:只要是可改行、标了落点来源、写的非空、
162
+ * 且技能算出来的生效值另有其值(去掉尾分隔符后仍不同),就报这两个事实。 */
163
+ function fallbackFactsOf(item, raw, source) {
164
+ if (item.readonly === true || item.prefillFrom === void 0) return null;
165
+ const written = raw.trim();
166
+ if (written === "") return null;
167
+ const effective = prefillValueOf(source, item.prefillFrom);
168
+ if (effective === void 0) return null;
169
+ const strip = (path) => path.replace(/[\\/]+$/, "");
170
+ if (strip(written) === strip(effective)) return null;
171
+ return {
172
+ written,
173
+ effective
174
+ };
175
+ }
176
+ /** 配置面报错 → 人话指引。
136
177
  *
137
- * 出处:主管包 `packages/plugin-manager/src/update-contract.ts` 的 `MANAGER_RPC.base`/`.endpoint`
138
- * ——那边是一处定义,这边是镜像(本包不许 import 总管的宿主半:会把 node 内建带进浏览器束)。
139
- * 传错第一段就是 404:总管自己在 #678 栽过一次、各家的配置体检在 #735 又栽过一次。 */
140
- const MANAGER_RPC_BASE = "/api";
141
- const MANAGER_RPC_ENDPOINT = "ilife-manager";
142
- /** 总管那通「本机根清单」电话名(#744):入参 `{}`,回包 `{roots: [{path, kind}]}`。
178
+ * 报文由技能侧给出(`base-link-core` 的 `ConfigError` 已带行号与文件名,技能 `cli/config.ts`
179
+ * 原样交出,插件 bridge 原样带上),所以这里**不重写报文**,只按报错类补一句「接下来怎么办」。 */
180
+ function humanizeConfigFailure(code, message) {
181
+ const text = message.trim().length > 0 ? message.trim() : `(${code},宿主未给报文)`;
182
+ if (/解析|YAML|parse/i.test(text)) return `${text}\n改回「键: 值」的写法,或点「重置为默认」。`;
183
+ if (/不认识|未知键|UNKNOWN_KEY/i.test(text)) return `${text}\n删掉页面上没有的行,或点「重置为默认」。`;
184
+ if (/类型|TYPE_MISMATCH/i.test(text)) return `${text}\n按本页的控件形状填,或点「重置为默认」。`;
185
+ if (/缺席|missing-cli/i.test(text)) return `${text}\n技能出口没找到:先确认技能包已装好,再点「重新读取」。`;
186
+ return `${text}\n改不动就点「重置为默认」,或照上面那条路径手工改配置文件。`;
187
+ }
188
+ /** 有界等待:借平台 `AbortSignal.timeout` 的 abort 事件做**一次**超时拒绝。
143
189
  *
144
- * 出处:主管包 `update-contract.ts` 的 `MANAGER_ACTIONS.roots`。为什么要走总管:
145
- * 浏览器里没有卷清单接口,宿主那条目录选择接缝也只有 `list`/`createDirectory` 两格,
146
- * 「这台机器上有哪些盘」只能由宿主去问操作系统——那份实现在总管宿主半的 `roots.ts`。 */
147
- const MANAGER_ROOTS_METHOD = "ilife-manager.roots";
190
+ * 为什么不自建定时器:本仓冻结边界是「无数据轮询」,而设置页等的是一次电话回执,不是轮询;
191
+ * 用平台自带的一次性超时既守住边界的本意,也把「不转圈」落到实处。同一个 signal 也交给传输,
192
+ * 双保险:它搭理 signal 就早收工,不理也有这一道兜底(桌面端自研传输会忽略 signal,见 #760)。 */
193
+ function withDeadline(promise, ms) {
194
+ const signal = AbortSignal.timeout(ms);
195
+ const limit = new Promise((_, reject) => {
196
+ signal.addEventListener("abort", () => {
197
+ const e = /* @__PURE__ */ new Error(`配置请求超时(${Math.round(ms / 1e3)}s):宿主未回`);
198
+ e.name = "TimeoutError";
199
+ reject(e);
200
+ }, { once: true });
201
+ });
202
+ return Promise.race([promise, limit]);
203
+ }
204
+ /** 一次配置电话(走调用方给的那条通道,靠端点名分发;永不抛,失败落字)。 */
205
+ async function configRpc(call, channel, method, payload) {
206
+ if (typeof call !== "function") return {
207
+ ok: false,
208
+ message: "宿主连接缺席:connection.rpc.call 不可用"
209
+ };
210
+ try {
211
+ const raw = await withDeadline(call("/api", channel.replace(/^\//, ""), {
212
+ method,
213
+ payload
214
+ }, AbortSignal.timeout(READ_TIMEOUT_MS$1)), READ_TIMEOUT_MS$1);
215
+ if (!isRpcResult$1(raw)) return {
216
+ ok: false,
217
+ message: "回执信封异常(非 ok 信封)"
218
+ };
219
+ if (!raw.ok) return {
220
+ ok: false,
221
+ message: humanizeConfigFailure(raw.error?.code ?? "unknown", raw.error?.message ?? "")
222
+ };
223
+ return {
224
+ ok: true,
225
+ surface: raw.value
226
+ };
227
+ } catch (e) {
228
+ if (e instanceof Error && (e.name === "AbortError" || e.name === "TimeoutError")) return {
229
+ ok: false,
230
+ message: `配置请求超时(${Math.round(READ_TIMEOUT_MS$1 / 1e3)}s):宿主未回`
231
+ };
232
+ return {
233
+ ok: false,
234
+ message: `配置失败:${e instanceof Error ? e.message : String(e)}`
235
+ };
236
+ }
237
+ }
238
+ /** 读设置页整面。 */
239
+ function fetchConfigSurface(call, channel) {
240
+ return configRpc(call, channel, RPC_ENDPOINT_CONFIG_GET, {});
241
+ }
242
+ /** 保存一份取值(回执只有 `{path, values}`,**不是**整面:写完要重新读一份整面)。 */
243
+ function saveConfigSurface(call, channel, values) {
244
+ return configRpc(call, channel, RPC_ENDPOINT_CONFIG_SAVE, { values });
245
+ }
246
+ /** 重置为默认(技能侧先落一份备份;回执同样不是整面,写完要重新读一份整面)。 */
247
+ function resetConfigSurface(call, channel) {
248
+ return configRpc(call, channel, RPC_ENDPOINT_CONFIG_RESET, {});
249
+ }
148
250
  //#endregion
149
251
  //#region ../plugin-manager/dist/directory-browser-contract.js
150
252
  /** 目录浏览器的纯逻辑半(**不认识宿主**:只认两格原语)。
@@ -178,7 +280,7 @@ window.__ModuleLoader__.load({
178
280
  * 与组合里服务哪种能力无关),所以两格原语在=这台宿主**可能**给浏览;真调一次才知道给不给,
179
281
  * 不给({@link CAPABILITY_REFUSED})再由调用方换系统对话框。反过来先认 `pick` 就会在
180
282
  * Desktop 这种「只服务 browse」的宿主上每次都去唤一次系统对话框、被拒一次(#744 实测)。 */
181
- function pickerModeOf$1(raw) {
283
+ function pickerModeOf(raw) {
182
284
  if (isBrowseFace(raw)) return "browse";
183
285
  return hasPickFn(raw) ? "native" : "none";
184
286
  }
@@ -187,7 +289,7 @@ window.__ModuleLoader__.load({
187
289
  * 出处:`@deepseek-ai/dsh-api-gateway/lib/client.js` 的 `invoke()`(失败不抛、成功也不回裸值),
188
290
  * 第一方消费方 `@deepseek-ai/dsh-client-ui-workspace/lib/client.js:99-103` 就照这个信封拆。
189
291
  * 裸串照收(老形状兜底),认不出的形状当「供不了」报出来,不当取消吞掉(#743 的教训)。 */
190
- function readPickAnswer$1(raw) {
292
+ function readPickAnswer(raw) {
191
293
  if (typeof raw === "string") return raw.trim() === "" ? { kind: "cancelled" } : {
192
294
  kind: "picked",
193
295
  path: raw
@@ -582,48 +684,6 @@ window.__ModuleLoader__.load({
582
684
  });
583
685
  }
584
686
  //#endregion
585
- //#region ../plugin-manager/dist/directory-browser-roots.js
586
- /** 「本机根清单」的取数接线(客户端半):把一通电话变成图上那一行可跳转的根。
587
- *
588
- * **不认识宿主**:载体基段、通道名(第二段)、电话名全由调用方传进来——各家从自己的宿主镜像里拿
589
- * 那几个字面量(和 `openRowBrowser` 的 `refusalCode` 同一条规矩)。本件只做两件事:
590
- * 发一次调用、把回执信封拆成根清单;**任何失败都当空清单**(图上少画一行,不报错、不挡路)。
591
- */
592
- /** 认一认某个值像不像一个根(认不出的行丢掉:图的干净比多画一行重要)。 */
593
- function isRootRow(raw) {
594
- if (typeof raw !== "object" || raw === null) return false;
595
- const row = raw;
596
- return typeof row.path === "string" && row.path !== "" && typeof row.kind === "string";
597
- }
598
- /** 信封 → 根清单(纯函数,**永不抛**):`{ok:true, value:{roots:[…]}}` 之外的形状一律当空。 */
599
- function readRootsAnswer(raw) {
600
- const answer = typeof raw === "object" && raw !== null ? raw : {};
601
- if (answer.ok !== true) return [];
602
- const value = typeof answer.value === "object" && answer.value !== null ? answer.value : {};
603
- if (!Array.isArray(value.roots)) return [];
604
- return value.roots.filter(isRootRow).map((row) => ({
605
- path: row.path,
606
- kind: row.kind
607
- }));
608
- }
609
- /** 建一个「根清单取数器」:给调用口与三个名字,回一个 `() => Promise<RootRow[]>`。
610
- *
611
- * 界面按需调它(开图一次),不在渲染里调,也不缓存到这里——缓存是宿主半的事。 */
612
- function createRootsSource(input) {
613
- return async () => {
614
- const call = input.getCall();
615
- if (typeof call !== "function") return [];
616
- try {
617
- return readRootsAnswer(await call(input.base, input.endpoint, {
618
- method: input.method,
619
- payload: {}
620
- }));
621
- } catch {
622
- return [];
623
- }
624
- };
625
- }
626
- //#endregion
627
687
  //#region ../plugin-manager/dist/directory-browser-parts.js
628
688
  /** 文件浏览器视图半的**零件**:样式表与四行控件(面包屑/根/一行子目录/新建行)。
629
689
  *
@@ -1003,26 +1063,23 @@ window.__ModuleLoader__.load({
1003
1063
  });
1004
1064
  }
1005
1065
  //#endregion
1006
- //#region src/client.ts
1007
- /** dsh-schedule-ilife client 适配器:技能设置页(#696 起是真能配的页,只配置、不干活)。
1066
+ //#region ../plugin-manager/dist/config-panel-view.js
1067
+ /** 共用配置面板 · 视图半:一行怎么画(`Row`)、整面怎么画(`PanelBody`)。
1008
1068
  *
1009
- * 三态:loading(一次 RPC 内)/ready(真表单)/failed(人话报错 + 指引,不返空、不转圈)。
1010
- * 页面只经宿主通道 `/api/ilife-schedule-ilife` 的三个配置端点读改配置;**没有任何干活入口**——
1011
- * 记作息、看时间轴在技能功能页(sidebar 槽),不在本文件。
1069
+ * 本件是**纯函数**:吃一份状态与一组回调,回一棵 React 元素树,自己不留任何状态、不取任何数。
1070
+ * 为什么这么分:状态机与副作用住在 `config-panel.ts` 那一层,于是本件在 Node 里就能直测
1071
+ * (照 `directory-browser-ui.ts` 的既有作法:用例把组件当普通函数调,直接读回那棵树)。
1012
1072
  *
1013
- * 产物经 tsdown 打成 loader 工厂包(browser/CJS,见 tsdown.config.ts)。
1014
- * 本文件传递闭包:禁 node、禁 DOM 直写(document/window/process),
1015
- * 不 import 任何 host 实现(含 bridge,见 #130 纪律),只用自家 contract/settings/slot 与 dsh-ctx 的 type。
1016
- * #736:目录行接系统文件夹选择器——命名空间经 `ctx.get` **可选查找**(不写进 inject,缺席只是没有入口)。
1017
- * 组件 React.createElement 手写,不引入 JSX。
1018
- */
1019
- /** client 短名声明:只有这两个(#736 的目录选择走**可选查找**,不写进来——
1020
- * 写进来=硬依赖,提供方缺席时整包被停靠,设置页会跟着装不上;见 cookbook §13)。 */
1021
- const inject = ["slots", "connection"];
1022
- /** 面板视觉(内联 style;颜色走 DSH 主题别名,深浅主题自适应,写死值只做回退)。
1073
+ * 手写 `React.createElement`(本包 client 束禁 JSX)。样式表 `S` 就在本件里——面板怎么画只有这一处。
1074
+ *
1075
+ * 三条定稿(v3)在本件落地:
1076
+ * ① **只读行的目录按钮不画**(不画一枚点了也没反应的死按钮);
1077
+ * ② 目录行的按钮字面**两档合一**,一律「浏览文件夹」(入口供不了时整枚不画);
1078
+ * ③ **每行一枚「复制」**:复制这一行完好的值文本;点下去按钮就地变「已复制」再变回,不弹提示。
1023
1079
  *
1024
- * **六家逐项同形**(备忘·卡路里·记账·作息·居家·大厨):同一项在这六份里逐字相同,
1025
- * 改任一条要六家一起改,锁见 `test/panel-copy-743.test.mjs` 第 ⑤ 条。 */
1080
+ * 对外只经 `config-panel-api.ts` 那一道门;本件自己不出门。
1081
+ */
1082
+ /** 面板的样式表:颜色走 DSH 主题别名(深浅主题自适应,写死值只做回退),字号一律相对单位(em)。 */
1026
1083
  const S = {
1027
1084
  card: {
1028
1085
  padding: "12px 14px",
@@ -1041,16 +1098,27 @@ window.__ModuleLoader__.load({
1041
1098
  color: "var(--dsw-alias-label-secondary, #9a9a9a)",
1042
1099
  fontSize: "0.92em"
1043
1100
  },
1044
- info: {
1045
- color: "var(--dsw-alias-label-secondary, #9a9a9a)",
1046
- fontSize: "0.92em",
1047
- overflowWrap: "anywhere"
1101
+ error: {
1102
+ marginTop: 8,
1103
+ color: "var(--dsw-alias-label-error, #b3261e)",
1104
+ fontSize: "1em",
1105
+ whiteSpace: "pre-wrap"
1106
+ },
1107
+ okText: {
1108
+ marginTop: 8,
1109
+ color: "var(--dsw-alias-state-success-primary, #12805c)",
1110
+ fontSize: "0.96em"
1048
1111
  },
1049
1112
  rows: {
1050
1113
  marginTop: 8,
1051
1114
  borderTop: "1px solid var(--dsw-alias-border, rgba(128,128,128,.25))",
1052
1115
  paddingTop: 8
1053
1116
  },
1117
+ info: {
1118
+ color: "var(--dsw-alias-label-secondary, #9a9a9a)",
1119
+ fontSize: "0.92em",
1120
+ overflowWrap: "anywhere"
1121
+ },
1054
1122
  row: { marginBottom: 10 },
1055
1123
  label: { fontWeight: 600 },
1056
1124
  hint: {
@@ -1072,6 +1140,12 @@ window.__ModuleLoader__.load({
1072
1140
  gap: 6,
1073
1141
  alignItems: "center"
1074
1142
  },
1143
+ acts: {
1144
+ display: "flex",
1145
+ gap: 6,
1146
+ alignItems: "center",
1147
+ flex: "0 0 auto"
1148
+ },
1075
1149
  btnPick: {
1076
1150
  flex: "0 0 auto",
1077
1151
  padding: "4px 10px",
@@ -1082,16 +1156,43 @@ window.__ModuleLoader__.load({
1082
1156
  whiteSpace: "nowrap",
1083
1157
  cursor: "pointer"
1084
1158
  },
1085
- advanced: { marginTop: 12 },
1086
- summary: {
1087
- cursor: "pointer",
1088
- fontWeight: 600
1159
+ invalid: {
1160
+ marginTop: 6,
1161
+ padding: "6px 8px",
1162
+ borderRadius: 6,
1163
+ background: "color-mix(in srgb, var(--dsw-alias-state-warning-primary, #b26a00) 16%, transparent)",
1164
+ border: "1px solid var(--dsw-alias-state-warning-primary, #b26a00)",
1165
+ color: "var(--dsw-alias-label-primary, inherit)",
1166
+ fontSize: "0.92em"
1089
1167
  },
1090
1168
  bar: {
1091
1169
  display: "flex",
1092
1170
  gap: 8,
1093
1171
  marginTop: 12,
1094
- flexWrap: "wrap"
1172
+ flexWrap: "wrap",
1173
+ position: "sticky",
1174
+ bottom: 0,
1175
+ zIndex: 1,
1176
+ background: "var(--dsw-alias-bg-layer-1, #232329)",
1177
+ padding: "8px 0",
1178
+ borderTop: "1px solid var(--dsw-alias-border, rgba(128,128,128,.25))"
1179
+ },
1180
+ saveMsg: {
1181
+ marginRight: "auto",
1182
+ alignSelf: "center",
1183
+ color: "var(--dsw-alias-state-warning-primary, #b26a00)",
1184
+ fontSize: "0.9em"
1185
+ },
1186
+ dirtyDot: {
1187
+ color: "var(--dsw-alias-state-warning-primary, #b26a00)",
1188
+ fontSize: "0.85em",
1189
+ marginLeft: 6,
1190
+ fontWeight: 400
1191
+ },
1192
+ followNote: {
1193
+ color: "var(--dsw-alias-state-warning-primary, #b26a00)",
1194
+ fontSize: "0.85em",
1195
+ marginBottom: 4
1095
1196
  },
1096
1197
  btn: {
1097
1198
  padding: "4px 12px",
@@ -1109,44 +1210,584 @@ window.__ModuleLoader__.load({
1109
1210
  color: "#fff",
1110
1211
  cursor: "pointer"
1111
1212
  },
1112
- okText: {
1113
- marginTop: 8,
1114
- color: "var(--dsw-alias-state-success-primary, #12805c)",
1115
- fontSize: "0.96em"
1213
+ advanced: { marginTop: 12 },
1214
+ summary: {
1215
+ cursor: "pointer",
1216
+ fontWeight: 600
1116
1217
  },
1117
- error: {
1218
+ version: {
1118
1219
  marginTop: 8,
1119
- color: "var(--dsw-alias-label-error, #b3261e)",
1120
- fontSize: "1em",
1121
- whiteSpace: "pre-wrap"
1220
+ paddingTop: 8,
1221
+ borderTop: "1px dashed var(--dsw-alias-border, rgba(128,128,128,.25))",
1222
+ color: "var(--dsw-alias-label-tertiary, #8a8a8a)",
1223
+ fontSize: "0.92em"
1122
1224
  }
1123
1225
  };
1124
- /** 请求超时毫秒:与 host 侧 SPAWN_TIMEOUT_MS 同级,UI 永不无限转圈。 */
1125
- const READ_TIMEOUT_MS = 2e4;
1126
- /** 配置面报错 → 人话指引。
1226
+ /** 复制那一枚按钮的字面(定稿 v3 第三条:就地变,不弹提示)。 */
1227
+ function copyLabelOf(state) {
1228
+ if (state === "done") return "已复制";
1229
+ if (state === "failed") return "复制失败";
1230
+ return "复制";
1231
+ }
1232
+ /** 一行输入(四种控件对齐受限 YAML 子集:文本/数字/布尔/目录)。
1127
1233
  *
1128
- * 报文由技能侧给出:base-link-core 的 `ConfigError` 已带行号与文件名,技能 `cli/config.ts` 原样交出来,
1129
- * 插件 bridge 原样带上(`fetch-failed:出口非 0(1):<那一句>`)。所以这里**不重写报文**,
1130
- * 只按报错类补一句「接下来怎么办」——免得两处各写一套人话。
1131
- */
1132
- function humanizeConfigFailure(code, message) {
1133
- const text = message.trim().length > 0 ? message.trim() : `(${code},宿主未给报文)`;
1134
- if (/解析|YAML|parse/i.test(text)) return `${text}\n改回「键: 值」的写法,或点「重置为默认」。`;
1135
- if (/不认识|未知键|UNKNOWN_KEY/i.test(text)) return `${text}\n删掉页面上没有的行,或点「重置为默认」。`;
1136
- if (/类型|TYPE_MISMATCH/i.test(text)) return `${text}\n按本页的控件形状填,或点「重置为默认」。`;
1137
- if (/缺席|missing-cli/i.test(text)) return `${text}\n技能出口没找到:先确认技能包已装好,再点「重新读取」。`;
1138
- return `${text}\n改不动就点「重置为默认」,或照上面那条路径手工改配置文件。`;
1234
+ * 目录档=文本框 + 一枚唤起目录选择的按钮;入口三态是 `none`(命名空间拿不到、或这条路已被拒)
1235
+ * **就不画按钮**,文本框照旧——那是该缝自己的契约(供不了就收起入口,不是失败)。
1236
+ * **只读行**:控件一律 `disabled`、`onChange` 不接,目录行的按钮**一枚都不画**(定稿 v3 ①)。 */
1237
+ function Row(props) {
1238
+ const { item } = props;
1239
+ const readonly = item.readonly === true;
1240
+ const disabled = props.disabled || readonly;
1241
+ const onChange = readonly ? void 0 : (e) => props.onChange(item.key, e.target.value);
1242
+ const control = item.control === "switch" ? react.createElement("input", {
1243
+ type: "checkbox",
1244
+ checked: props.value === "true",
1245
+ disabled,
1246
+ onChange: readonly ? void 0 : (e) => props.onChange(item.key, e.target.checked ? "true" : "false")
1247
+ }) : react.createElement("input", {
1248
+ style: props.dirty === true ? {
1249
+ ...S.input,
1250
+ borderColor: "var(--dsw-alias-state-warning-primary, #b26a00)"
1251
+ } : readonly && props.follow === true ? {
1252
+ ...S.input,
1253
+ opacity: .55
1254
+ } : S.input,
1255
+ type: item.control === "number" ? "number" : "text",
1256
+ value: props.value,
1257
+ disabled,
1258
+ spellCheck: false,
1259
+ onChange
1260
+ });
1261
+ /** 目录入口:只读行不画(定稿 v3 ①),供不了(`none`/缺席)也不画。 */
1262
+ const entry = props.browser ?? null;
1263
+ const browse = item.control === "directory" && !readonly && entry !== null && entry.mode !== "none" ? react.createElement("button", {
1264
+ style: S.btnPick,
1265
+ type: "button",
1266
+ disabled,
1267
+ onClick: () => entry.onOpen(item.key)
1268
+ }, "浏览文件夹") : null;
1269
+ const copy = react.createElement("button", {
1270
+ style: S.btnPick,
1271
+ type: "button",
1272
+ disabled: props.onCopy === void 0,
1273
+ onClick: () => props.onCopy?.(item.key, props.value)
1274
+ }, copyLabelOf(props.copyState));
1275
+ const acts = react.createElement("div", { style: S.acts }, browse, copy);
1276
+ const facts = props.fallback ?? null;
1277
+ return react.createElement("div", { style: S.row }, react.createElement("div", { style: S.label }, item.title, props.dirty === true ? react.createElement("span", { style: S.dirtyDot }, "●已改动") : null), react.createElement("div", { style: S.hint }, item.hint), readonly && props.follow === true ? react.createElement("div", { style: S.followNote }, "将跟随更新,保存后生效。") : null, facts === null ? null : react.createElement("div", { style: S.invalid }, "配置里写的是 ", react.createElement("b", null, facts.written), ";现在生效的是 ", react.createElement("b", null, facts.effective), "。"), react.createElement("div", { style: S.pickRow }, control, acts));
1278
+ }
1279
+ /** 应用内浏览器对话框的文案(面板自带,逐条对应图上那几个位置)。 */
1280
+ const BROWSER_LABELS = {
1281
+ title: "选择文件夹",
1282
+ close: "关闭",
1283
+ up: "上一级",
1284
+ pathPlaceholder: "直接填绝对路径,回车即进入",
1285
+ go: "转到",
1286
+ showHidden: (n) => "显示隐藏目录(" + n + ")",
1287
+ empty: "这个目录里没有子目录。",
1288
+ loading: "正在读取",
1289
+ newFolder: "新建文件夹",
1290
+ createConfirm: "创建",
1291
+ createCancel: "取消",
1292
+ select: "选",
1293
+ selected: "已选",
1294
+ open: "选定这个目录",
1295
+ cancel: "取消",
1296
+ willPick: "将选定:"
1297
+ };
1298
+ /** 画整面(四支控件、三支错误落位、底栏、附加块槽都在这里)。 */
1299
+ function PanelBody(props) {
1300
+ const { state, title } = props;
1301
+ const surface = state.kind === "ready" ? state.surface : null;
1302
+ const headText = title === void 0 ? "配置" : `${title} · 配置`;
1303
+ const headDataDir = surface === null ? "" : surface.resolved?.["dbDir"] ?? surface.dataDir;
1304
+ const head = react.createElement("div", null, react.createElement("div", { style: S.title }, headText), surface === null ? null : react.createElement("div", null, react.createElement("div", { style: S.info }, `配置文件 ${surface.path}`), react.createElement("div", { style: S.info }, `数据目录 ${headDataDir}`), surface.created ? react.createElement("div", { style: S.muted }, "(配置文件刚按默认值生成)") : null));
1305
+ const parts = {
1306
+ styles: S,
1307
+ reply: surface
1308
+ };
1309
+ const extra = props.extra === void 0 ? null : props.extra(parts);
1310
+ if (state.kind === "loading") return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.muted }, "配置读取中"), extra);
1311
+ if (state.kind === "failed") return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.error }, state.message), extra, react.createElement("div", { style: S.bar }, react.createElement("button", {
1312
+ style: S.btn,
1313
+ type: "button",
1314
+ onClick: props.onRetry
1315
+ }, "重试"), react.createElement("button", {
1316
+ style: S.btn,
1317
+ type: "button",
1318
+ onClick: props.onReset
1319
+ }, "重置为默认")));
1320
+ const common = props.items.filter((item) => item.tier === "common");
1321
+ const advanced = props.items.filter((item) => item.tier === "advanced");
1322
+ const renderRow = (item) => react.createElement(Row, {
1323
+ key: item.key,
1324
+ item,
1325
+ value: props.draft[item.key] ?? "",
1326
+ disabled: props.busy,
1327
+ onChange: props.onChange,
1328
+ browser: props.rowEntry,
1329
+ dirty: props.dirtyKeys.includes(item.key),
1330
+ follow: props.followKeys.includes(item.key),
1331
+ onCopy: props.onCopy,
1332
+ copyState: props.copy !== null && props.copy.key === item.key ? props.copy.ok ? "done" : "failed" : "idle",
1333
+ fallback: item.readonly !== true && item.prefillFrom !== void 0 ? fallbackFactsOf(item, props.draft[item.key] ?? "", draftSourceOf(surface)) : null
1334
+ });
1335
+ const dirtyCount = props.dirtyKeys.length;
1336
+ const dirty = dirtyCount > 0;
1337
+ return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.rows }, common.map(renderRow)), advanced.length === 0 ? null : react.createElement("details", { style: S.advanced }, react.createElement("summary", { style: S.summary }, ADVANCED_GROUP_TITLE), react.createElement("div", { style: S.muted }, ADVANCED_GROUP_NOTE), advanced.map(renderRow)), extra, react.createElement("div", { style: S.bar }, dirty ? react.createElement("div", { style: S.saveMsg }, `浏览改动后请点保存(${dirtyCount} 项未保存),保存后跟随项自动更新`) : null, react.createElement("button", {
1338
+ style: dirty ? S.btnPrimary : S.btn,
1339
+ type: "button",
1340
+ disabled: props.busy || !dirty,
1341
+ onClick: props.onSave
1342
+ }, props.busy ? "处理中" : dirty ? `保存(${dirtyCount} 项未保存)` : "保存"), react.createElement("button", {
1343
+ style: S.btn,
1344
+ type: "button",
1345
+ disabled: props.busy,
1346
+ onClick: props.onReset
1347
+ }, "重置为默认"), react.createElement("button", {
1348
+ style: S.btn,
1349
+ type: "button",
1350
+ disabled: props.busy,
1351
+ onClick: props.onRetry
1352
+ }, "重新读取")), props.picking ? react.createElement("div", { style: S.muted }, "已唤起系统文件夹对话框:选中后自动填上,取消则不动。") : null, props.browseRow !== null ? react.createElement(DirectoryBrowserFromRow, {
1353
+ open: true,
1354
+ row: props.browseRow,
1355
+ labels: BROWSER_LABELS
1356
+ }) : null, props.writeError !== null ? react.createElement("div", {
1357
+ style: S.error,
1358
+ role: "alert"
1359
+ }, props.writeError) : null, props.error !== null ? react.createElement("div", { style: S.error }, props.error) : null, props.notice !== null ? react.createElement("div", { style: S.okText }, props.notice) : null);
1360
+ }
1361
+ /** 「写的值 ≠ 生效值」两个事实要的那几格:整面回执里取值本身、落点顶层那一个、`resolved` 组。 */
1362
+ function draftSourceOf(surface) {
1363
+ if (surface === null) return { values: {} };
1364
+ return {
1365
+ values: surface.values,
1366
+ dataDir: surface.dataDir,
1367
+ resolved: surface.resolved
1368
+ };
1369
+ }
1370
+ //#endregion
1371
+ //#region ../plugin-manager/dist/directory-browser-roots.js
1372
+ /** 「本机根清单」的取数接线(客户端半):把一通电话变成图上那一行可跳转的根。
1373
+ *
1374
+ * **不认识宿主**:载体基段、通道名(第二段)、电话名全由调用方传进来——各家从自己的宿主镜像里拿
1375
+ * 那几个字面量(和 `openRowBrowser` 的 `refusalCode` 同一条规矩)。本件只做两件事:
1376
+ * 发一次调用、把回执信封拆成根清单;**任何失败都当空清单**(图上少画一行,不报错、不挡路)。
1377
+ */
1378
+ /** 认一认某个值像不像一个根(认不出的行丢掉:图的干净比多画一行重要)。 */
1379
+ function isRootRow(raw) {
1380
+ if (typeof raw !== "object" || raw === null) return false;
1381
+ const row = raw;
1382
+ return typeof row.path === "string" && row.path !== "" && typeof row.kind === "string";
1383
+ }
1384
+ /** 信封 → 根清单(纯函数,**永不抛**):`{ok:true, value:{roots:[…]}}` 之外的形状一律当空。 */
1385
+ function readRootsAnswer(raw) {
1386
+ const answer = typeof raw === "object" && raw !== null ? raw : {};
1387
+ if (answer.ok !== true) return [];
1388
+ const value = typeof answer.value === "object" && answer.value !== null ? answer.value : {};
1389
+ if (!Array.isArray(value.roots)) return [];
1390
+ return value.roots.filter(isRootRow).map((row) => ({
1391
+ path: row.path,
1392
+ kind: row.kind
1393
+ }));
1394
+ }
1395
+ /** 建一个「根清单取数器」:给调用口与三个名字,回一个 `() => Promise<RootRow[]>`。
1396
+ *
1397
+ * 界面按需调它(开图一次),不在渲染里调,也不缓存到这里——缓存是宿主半的事。 */
1398
+ function createRootsSource(input) {
1399
+ return async () => {
1400
+ const call = input.getCall();
1401
+ if (typeof call !== "function") return [];
1402
+ try {
1403
+ return readRootsAnswer(await call(input.base, input.endpoint, {
1404
+ method: input.method,
1405
+ payload: {}
1406
+ }));
1407
+ } catch {
1408
+ return [];
1409
+ }
1410
+ };
1411
+ }
1412
+ /** 载体:宿主注册 `connection.fetch.register` 的路径 / 面板 `connection.rpc.call` 的两段参数。 */
1413
+ const MANAGER_RPC = {
1414
+ /** 载体基段(`connection.rpc.call` 的**第一段**参数)。传错第一段就是 404:真机上踩过一次。 */
1415
+ base: "/api",
1416
+ /** 单段通道名,须 match `/^\/[A-Za-z0-9._~-]+$/`(cookbook §6)。 */
1417
+ channel: "/ilife-manager",
1418
+ /** 面板侧第二段参数(等于通道名去掉前导斜杠那一段)。 */
1419
+ endpoint: "ilife-manager",
1420
+ /** 宿主侧注册的完整路径(= `base` + `channel`)。 */
1421
+ path: "/api/ilife-manager"
1422
+ };
1423
+ /** 总管自有电话名:更新包的三个动作名是冻结集合(`config.ts:14`),这里另起名字不撞车。 */
1424
+ const MANAGER_ACTIONS = {
1425
+ /** 装上缺席的目标包:入参 `{packageName, version}`,回包 `{packageName, version}`。 */
1426
+ install: "ilife-manager.install",
1427
+ /** 七个更新目标的表:入参 `{}`,回包 `{targets: [{key, title, packageName, phones, runningVersion, installedVersion, panelRegistered, skill}]}`。
1428
+ *
1429
+ * 电话名为什么由宿主转交而不是面板侧写死:更新包的三个电话名只有它自己知道
1430
+ * (`update.phoneNames`,`host.ts:335`);面板侧既不能 import 更新包(浏览器产物纯度门)
1431
+ * 也不该把名字再写一份(写两份必然走散)。宿主把名字表连同版本行一起交出去,
1432
+ * 面板一行字面量都不留。 */
1433
+ targets: "ilife-manager.targets",
1434
+ /** 总管自述版本(票 #737):入参 `{}`,回包 `{version}`。
1435
+ *
1436
+ * 宿主读**自己这份已安装包**的 `package.json`(`manager-version.ts`),面板只渲染读到的值。
1437
+ * 为什么走电话:面板是浏览器产物,禁 node 内建(`test/client-bundle-48.test.mjs` 看门),
1438
+ * 读盘只许在宿主半;与卡路里 #130 同一条路(host 读 → RPC → client 纯渲染)。 */
1439
+ version: "ilife-manager.version",
1440
+ /** 本机「根」清单(票 #744):入参 `{}`,回包 `{roots: [{path, kind}]}`。
1441
+ *
1442
+ * 为什么这条能力住在总管:浏览器里没有卷清单接口,而宿主那条目录选择接缝只有
1443
+ * `list`/`createDirectory` 两格——「这台机器上有哪些盘」只能由宿主去问操作系统。
1444
+ * 六家的目录浏览器都取这一通电话,故名字与实现都只有这一处(清单本身见 `roots.ts`)。
1445
+ * 回包**恒成功**:列不出来是空清单,不是错误码(界面据此只是不画那一行)。 */
1446
+ roots: "ilife-manager.roots"
1447
+ };
1448
+ //#endregion
1449
+ //#region ../plugin-manager/dist/config-panel.js
1450
+ /** 共用配置面板 · 组件本体:一台状态机 + 一圈副作用,渲染交给 `config-panel-view.ts`。
1451
+ *
1452
+ * 这一件就是六个技能设置页的那张卡片:六家只交「连哪条通道」与「有哪些配置项」(行表),
1453
+ * 另加三个可选钩子(跟随映射/卡片标题/自家附加块)。卡片怎么画、值怎么取又怎么填回去、
1454
+ * 哪些行被改过还没保存、保存/重置/重新读取怎么走、出错时说什么话,全在本件与它下面那几件里。
1455
+ *
1456
+ * 状态:读到了没(loading/ready/failed)、哪些行被改过(脏基线)、正在写(busy)、
1457
+ * 写完的结果(notice/writeError)、就地失败(error)、目录选择那一路(picking/browseRow)、
1458
+ * 复制回执(copy)。**脏基线只看可改行**:只读行显示的是技能算好的绝对路径,拿它当「改动」
1459
+ * 会让面板一打开就显示「未保存」。**写完一律重新读一份整面**:写回执不是整面,拿它当整面用
1460
+ * 会让页头那行「数据目录」显示成空。
1461
+ *
1462
+ * 只挂一个副作用(挂载期读一次整面):取数口是**取用器**,每次调它现取,所以那个 effect
1463
+ * 不需要跟着任何一格重跑——否则回执一落定就再读一次,会自己把自己转起来。
1464
+ *
1465
+ * 对外只经 `config-panel-api.ts` 那一道门;本件自己不出门。
1466
+ */
1467
+ /** 认一认某个值像不像目录选择命名空间(认不出就当没有,绝不把设置页带下来)。 */
1468
+ function isPickerFace(raw) {
1469
+ if (typeof raw !== "object" || raw === null) return false;
1470
+ return typeof raw.pick === "function";
1471
+ }
1472
+ /** 现取目录选择命名空间:**软依赖**,拿不到回 null(页面据此不出入口)。 */
1473
+ function resolvePicker(getService) {
1474
+ if (getService === void 0) return null;
1475
+ try {
1476
+ const raw = getService(REMOTE_DIRECTORY_PICKER);
1477
+ return isPickerFace(raw) ? raw : null;
1478
+ } catch {
1479
+ return null;
1480
+ }
1481
+ }
1482
+ /** 唤起一次系统文件夹选择器并归一结果(**永不抛**)。 */
1483
+ async function pickDirectory(picker) {
1484
+ try {
1485
+ return readPickAnswer(await picker.pick());
1486
+ } catch (e) {
1487
+ return {
1488
+ kind: "unavailable",
1489
+ message: "打不开系统文件夹对话框(" + (e instanceof Error ? e.message : String(e)) + "):请直接在框里填绝对路径。"
1490
+ };
1491
+ }
1492
+ }
1493
+ /** 写一次剪贴板:**不碰 DOM**,只读当刻环境的 `globalThis.navigator`(拿不到就回 false,不抛)。
1494
+ *
1495
+ * 为什么不照原型那样退到 `document.execCommand`:本仓插件侧禁 DOM 直写(`document`/`window`),
1496
+ * 所以没有那条兜底;拿不到剪贴板就如实回 false,界面上那一枚按钮就地显示「复制失败」。 */
1497
+ async function writeClipboard(text) {
1498
+ try {
1499
+ const clip = globalThis.navigator?.clipboard;
1500
+ if (clip === void 0 || typeof clip.writeText !== "function") return false;
1501
+ await clip.writeText(text);
1502
+ return true;
1503
+ } catch {
1504
+ return false;
1505
+ }
1506
+ }
1507
+ /** 技能设置页:承载一家自己的全部可配置项(只配置,不干活)。 */
1508
+ function ConfigPanel(props) {
1509
+ const [state, setState] = react.useState({ kind: "loading" });
1510
+ const [pickerGone, setPickerGone] = react.useState(false);
1511
+ const [picking, setPicking] = react.useState(false);
1512
+ const [draft, setDraft] = react.useState({});
1513
+ const [busy, setBusy] = react.useState(false);
1514
+ const [notice, setNotice] = react.useState(null);
1515
+ const [writeError, setWriteError] = react.useState(null);
1516
+ const [error, setError] = react.useState(null);
1517
+ const [browseRow, setBrowseRow] = react.useState(null);
1518
+ const [copy, setCopy] = react.useState(null);
1519
+ /** 复制回执的复位定时器:**一次性 UI 回执**,不是数据轮询——点一次起一个,到点自我复位,
1520
+ * 下一次点击先清掉旧的,卸载时也清掉(下面那个清扫 effect 就是那一半)。 */
1521
+ const copyTimer = react.useRef(null);
1522
+ react.useEffect(() => () => {
1523
+ if (copyTimer.current !== null) {
1524
+ clearTimeout(copyTimer.current);
1525
+ copyTimer.current = null;
1526
+ }
1527
+ }, []);
1528
+ /** 挂载期读一次整面:卸载之后回来的回执丢掉(不许往已经没了的页面上写)。 */
1529
+ react.useEffect(() => {
1530
+ let alive = true;
1531
+ (async () => {
1532
+ const r = await fetchConfigSurface(props.getCall(), props.channel);
1533
+ if (!alive) return;
1534
+ if (r.ok) {
1535
+ setState({
1536
+ kind: "ready",
1537
+ surface: r.surface
1538
+ });
1539
+ setDraft(toDraft(props.items, r.surface.values, r.surface));
1540
+ } else setState({
1541
+ kind: "failed",
1542
+ message: r.message
1543
+ });
1544
+ })();
1545
+ return () => {
1546
+ alive = false;
1547
+ };
1548
+ }, []);
1549
+ /** 把一份整面铺到页面上(读到之后唯一那一处落点)。 */
1550
+ const apply = (surface) => {
1551
+ setState({
1552
+ kind: "ready",
1553
+ surface
1554
+ });
1555
+ setDraft(toDraft(props.items, surface.values, surface));
1556
+ };
1557
+ const load = async () => {
1558
+ setNotice(null);
1559
+ setWriteError(null);
1560
+ setError(null);
1561
+ const r = await fetchConfigSurface(props.getCall(), props.channel);
1562
+ if (r.ok) apply(r.surface);
1563
+ else setState({
1564
+ kind: "failed",
1565
+ message: r.message
1566
+ });
1567
+ };
1568
+ /** 写完(保存/重置)之后重新读一份整面:写回执只有 `{path, values}`、重置回执只有
1569
+ * `{path, backupPath}`,都不是整面——拿它当整面用,页头那行「数据目录」会显示成空。 */
1570
+ const writeThenReload = async (done) => {
1571
+ setBusy(true);
1572
+ setNotice(null);
1573
+ setWriteError(null);
1574
+ setError(null);
1575
+ const r = await fetchConfigSurface(props.getCall(), props.channel);
1576
+ if (r.ok) {
1577
+ apply(r.surface);
1578
+ setNotice(done);
1579
+ } else setState({
1580
+ kind: "failed",
1581
+ message: r.message
1582
+ });
1583
+ setBusy(false);
1584
+ };
1585
+ const onChange = (key, next) => {
1586
+ setDraft((prev) => ({
1587
+ ...prev,
1588
+ [key]: next
1589
+ }));
1590
+ setNotice(null);
1591
+ setWriteError(null);
1592
+ setError(null);
1593
+ };
1594
+ const picker = pickerGone ? null : resolvePicker(props.getService);
1595
+ /** 唤起系统文件夹选择器那一条路(应用内浏览被拒时的兜底,也是命名空间只给 `pick` 时的唯一一条)。 */
1596
+ const openNative = async (key) => {
1597
+ const face = pickerGone ? null : resolvePicker(props.getService);
1598
+ if (face === null) return;
1599
+ setPicking(true);
1600
+ setError(null);
1601
+ const outcome = await pickDirectory(face);
1602
+ setPicking(false);
1603
+ if (outcome.kind === "picked") onChange(key, outcome.path);
1604
+ else if (outcome.kind === "unavailable") {
1605
+ setError(outcome.message);
1606
+ setPickerGone(true);
1607
+ }
1608
+ };
1609
+ /** 目录行的入口动作:**先应用内浏览,宿主没给这条路再换系统对话框**(判断在共用件里)。 */
1610
+ const onOpenRow = async (key) => {
1611
+ setError(null);
1612
+ const opened = openRowBrowser({
1613
+ picker,
1614
+ initialPath: draft[key] ?? "",
1615
+ onChange: (next) => onChange(key, next),
1616
+ onRow: setBrowseRow,
1617
+ refusalCode: DIRECTORY_PICKER_REFUSED,
1618
+ rootsSource: createRootsSource({
1619
+ getCall: props.getCall,
1620
+ base: MANAGER_RPC.base,
1621
+ endpoint: MANAGER_RPC.endpoint,
1622
+ method: MANAGER_ACTIONS.roots
1623
+ })
1624
+ });
1625
+ if (opened === void 0 || await opened === "refused") await openNative(key);
1626
+ };
1627
+ /** 复制一行(定稿 v3 第三条):写完就地变「已复制」(写不进去就地变「复制失败」),1.5 秒后复位,不弹提示。 */
1628
+ const onCopy = (key, text) => {
1629
+ writeClipboard(text).then((ok) => {
1630
+ setCopy({
1631
+ key,
1632
+ ok
1633
+ });
1634
+ if (copyTimer.current !== null) clearTimeout(copyTimer.current);
1635
+ copyTimer.current = setTimeout(() => {
1636
+ copyTimer.current = null;
1637
+ setCopy(null);
1638
+ }, COPY_FEEDBACK_MS);
1639
+ });
1640
+ };
1641
+ const onSave = async () => {
1642
+ setBusy(true);
1643
+ setNotice(null);
1644
+ setWriteError(null);
1645
+ setError(null);
1646
+ const r = await saveConfigSurface(props.getCall(), props.channel, fromDraft(props.items, draft));
1647
+ setBusy(false);
1648
+ if (r.ok) await writeThenReload("已保存,立即生效(不用重启宿主)");
1649
+ else setWriteError(r.message);
1650
+ };
1651
+ const onReset = async () => {
1652
+ setBusy(true);
1653
+ setNotice(null);
1654
+ setWriteError(null);
1655
+ setError(null);
1656
+ const r = await resetConfigSurface(props.getCall(), props.channel);
1657
+ setBusy(false);
1658
+ if (r.ok) await writeThenReload("已重置为默认(原配置已另存一份 .bak)");
1659
+ else setWriteError(r.message);
1660
+ };
1661
+ const surface = state.kind === "ready" ? state.surface : null;
1662
+ const baseline = surface !== null ? toDraft(props.items, surface.values, surface) : null;
1663
+ const dirtyKeys = baseline === null ? [] : dirtyKeysOf(props.items, draft, baseline);
1664
+ const followKeys = (props.followKeysOf ?? noFollowKeys)(dirtyKeys);
1665
+ const mode = pickerModeOf(picker);
1666
+ const rowEntry = mode === "none" ? null : {
1667
+ mode,
1668
+ onOpen: onOpenRow
1669
+ };
1670
+ return react.createElement(PanelBody, {
1671
+ title: props.title,
1672
+ items: props.items,
1673
+ state,
1674
+ draft,
1675
+ busy,
1676
+ notice,
1677
+ writeError,
1678
+ error,
1679
+ picking,
1680
+ browseRow,
1681
+ rowEntry,
1682
+ dirtyKeys,
1683
+ followKeys,
1684
+ copy,
1685
+ onCopy,
1686
+ onChange,
1687
+ onSave: () => void onSave(),
1688
+ onReset: () => void onReset(),
1689
+ onRetry: () => void load(),
1690
+ extra: props.extra
1691
+ });
1692
+ }
1693
+ //#endregion
1694
+ //#region src/contract.ts
1695
+ /** dsh-schedule-ilife 端口(port):DSH 世界与作息管家六边形之间的契约。
1696
+ *
1697
+ * browser 安全:零 node 导入。host 适配器(注册 RPC 通道)与 client 适配器(调用 RPC)
1698
+ * 共用同一份定义。通道命名遵守宿主约束:单段且不等于 /api(见 cookbook「RPC 通道」)。
1699
+ *
1700
+ * 照 #56 卡路里/#677 记账/#696 大厨样板同形:作息插件原先**没有任何 RPC 通道**,本件是它
1701
+ * 第一份端口定义(#696:设置页要读改配置,走的就是这条通道)。
1702
+ */
1703
+ const RPC_CHANNEL = "/ilife-schedule-ilife";
1704
+ /** #706 配置体检端点:只读一次,回一份报告(判据由技能侧出,本包只透传,不重写一个字)。
1705
+ *
1706
+ * 端点名与技能侧那条只读命令同名(`<技能>.config.check`);报告形状的唯一真相在技能侧
1707
+ * `packages/skill-<技能>/src/health.ts`,面板侧镜像在 `packages/plugin-manager/src/health-contract.ts`。 */
1708
+ const RPC_ENDPOINT_CONFIG_CHECK = "config.check";
1709
+ /** 信封守卫:供 client 拆包前校验(port 拥有信封定义,守卫住 port)。 */
1710
+ function isRpcResult(raw) {
1711
+ if (typeof raw !== "object" || raw === null) return false;
1712
+ const okFlag = raw.ok;
1713
+ return okFlag === true || okFlag === false;
1139
1714
  }
1140
- /** 一次配置 RPC(同通道过三个端点;永不抛,失败落字)。 */
1141
- async function configRpc(call, method, payload) {
1715
+ //#endregion
1716
+ //#region src/slot.ts
1717
+ const SLOT_TITLE = "作息管家";
1718
+ const PLUGIN = "dsh-schedule-ilife";
1719
+ //#endregion
1720
+ //#region src/settings.ts
1721
+ /** 常用项:#764 起是「可改 1 + 只读 2」(高级组已空,见下)。 */
1722
+ const COMMON = [
1723
+ {
1724
+ key: "db.dir",
1725
+ title: "数据目录",
1726
+ tier: "common",
1727
+ control: "directory",
1728
+ prefillFrom: "dataDir",
1729
+ hint: "库文件与产物的根目录。留空=用默认目录。"
1730
+ },
1731
+ {
1732
+ key: "db.name",
1733
+ title: "库文件名",
1734
+ tier: "common",
1735
+ control: "text",
1736
+ readonly: true,
1737
+ resolveFrom: "dbFile",
1738
+ hint: "数据目录下的库文件。"
1739
+ },
1740
+ {
1741
+ key: "html.dir",
1742
+ title: "HELP 产物目录",
1743
+ tier: "common",
1744
+ control: "text",
1745
+ readonly: true,
1746
+ resolveFrom: "htmlDir",
1747
+ hint: "HELP 页面的存放目录。"
1748
+ }
1749
+ ];
1750
+ /** 高级项:#764 起已空(`files.help`/`lark.cliPath` 出配置表)——组还在,行没有。
1751
+ * 空组不渲染(见 client.ts),行表长度即 3。 */
1752
+ const ADVANCED = [];
1753
+ /** 设置页的行表,顺序即页面顺序。 */
1754
+ const CONFIG_ITEMS = [...COMMON, ...ADVANCED];
1755
+ COMMON.length;
1756
+ //#endregion
1757
+ //#region src/client.ts
1758
+ /** dsh-schedule-ilife client 适配器(六边形:port=contract,adapter=本文件)。
1759
+ *
1760
+ * 产物经 tsdown 打成 loader 工厂包(browser/CJS,见 tsdown.config.ts)。
1761
+ * 本文件传递闭包:禁 node、禁 DOM 直写(document/window/process)。
1762
+ * 注册一处:**技能设置页** → 爱生活页签槽(总管声明的 children,各技能自研自家配置页)。
1763
+ * 取数只经 connection.rpc.call 进 host 通道;缺席/错误纯条件渲染,不返空冒充。
1764
+ * 组件 React.createElement 手写,不引入 JSX。
1765
+ *
1766
+ * #909:设置页本体(样式表/行渲染/卡片骨架/状态机/取值与填值/配置面三通电话/
1767
+ * 目录选择入口)**收进共用件** `dsh-life-pack/config-panel`,本文件只留四处接线:
1768
+ * ① 行表(住 `settings.ts`——那是本家自己的配置数据,不是 UI);
1769
+ * ② 通道路由名(`RPC_CHANNEL`,本家唯一那个真变量);
1770
+ * ③ 三个可选钩子(卡片标题/跟随映射/自家附加块=「飞书 CLI」状态行);
1771
+ * ④ 两格宿主取数接线(`getCall`/`getService`)。
1772
+ * 本家**不再有**设置页的样式表与行渲染函数:改一次共用面板,六家一起变;
1773
+ * 附加块的视觉走面板经插槽传进来的样式(`PanelParts.styles`),不另外抄一份。
1774
+ * 照 CONTEXT.md,「技能设置页」只配置、不干活:本页没有记作息/看时间轴之类的入口。
1775
+ */
1776
+ /** client 短名声明:只有这两个(#736 的目录选择走**可选查找**,不写进来——
1777
+ * 写进来=硬依赖,提供方缺席时整包被停靠,设置页会跟着装不上;见 cookbook §13)。 */
1778
+ const inject = ["slots", "connection"];
1779
+ /** 请求超时毫秒:与 host 侧 SPAWN_TIMEOUT_MS 同级,UI 永不无限转圈。 */
1780
+ const READ_TIMEOUT_MS = 2e4;
1781
+ /** 读一次配置体检(只读;判据由技能侧出,本包只透传,不重写一个字)。 */
1782
+ async function fetchHealthSurface(call) {
1142
1783
  if (typeof call !== "function") return {
1143
1784
  ok: false,
1144
1785
  message: "宿主连接缺席:connection.rpc.call 不可用"
1145
1786
  };
1146
1787
  try {
1147
1788
  const raw = await call("/api", RPC_CHANNEL.slice(1), {
1148
- method,
1149
- payload
1789
+ method: RPC_ENDPOINT_CONFIG_CHECK,
1790
+ payload: {}
1150
1791
  }, AbortSignal.timeout(READ_TIMEOUT_MS));
1151
1792
  if (!isRpcResult(raw)) return {
1152
1793
  ok: false,
@@ -1154,11 +1795,11 @@ window.__ModuleLoader__.load({
1154
1795
  };
1155
1796
  if (!raw.ok) return {
1156
1797
  ok: false,
1157
- message: humanizeConfigFailure(raw.error?.code ?? "unknown", raw.error?.message ?? "")
1798
+ message: raw.error?.message ?? "体检回执被拒(宿主未给报文)"
1158
1799
  };
1159
1800
  return {
1160
1801
  ok: true,
1161
- surface: raw.value
1802
+ report: raw.value
1162
1803
  };
1163
1804
  } catch (e) {
1164
1805
  if (e instanceof Error && (e.name === "AbortError" || e.name === "TimeoutError")) return {
@@ -1167,26 +1808,10 @@ window.__ModuleLoader__.load({
1167
1808
  };
1168
1809
  return {
1169
1810
  ok: false,
1170
- message: `配置失败:${e instanceof Error ? e.message : String(e)}`
1811
+ message: `体检失败:${e instanceof Error ? e.message : String(e)}`
1171
1812
  };
1172
1813
  }
1173
1814
  }
1174
- /** 读设置页整面。 */
1175
- function fetchConfigSurface(call) {
1176
- return configRpc(call, RPC_ENDPOINT_CONFIG_GET, {});
1177
- }
1178
- /** 保存一份取值。 */
1179
- function saveConfigSurface(call, values) {
1180
- return configRpc(call, RPC_ENDPOINT_CONFIG_SAVE, { values });
1181
- }
1182
- /** 重置为默认(技能侧先落 .bak)。 */
1183
- function resetConfigSurface(call) {
1184
- return configRpc(call, RPC_ENDPOINT_CONFIG_RESET, {});
1185
- }
1186
- /** 读一次配置体检(只读;判据由技能侧出,本包只透传,不重写一个字)。 */
1187
- function fetchHealthSurface(call) {
1188
- return configRpc(call, RPC_ENDPOINT_CONFIG_CHECK, {});
1189
- }
1190
1815
  /** 从体检报告里挑出 `lark.cli` 那一项;形状不对回 null(不抛)。 */
1191
1816
  function larkItemOf(report) {
1192
1817
  if (typeof report !== "object" || report === null) return null;
@@ -1269,147 +1894,21 @@ window.__ModuleLoader__.load({
1269
1894
  return null;
1270
1895
  }
1271
1896
  }
1272
- /** 只读行显示什么:标了 `resolveFrom` ⇒ 回执 `resolved` 组那一格;没标 ⇒ 配置文件里那个值本身
1273
- * (数字类只读项走这一档:显示的是生效数字,见 #749 补注二的甲档)。 */
1274
- function readonlyTextOf(item, raw, prefill) {
1275
- if (item.resolveFrom === void 0) return raw;
1276
- const shown = prefill.resolved?.[item.resolveFrom];
1277
- return typeof shown === "string" ? shown : "";
1278
- }
1279
- function toDraft(values, prefill = {}) {
1280
- const draft = {};
1281
- for (const item of CONFIG_ITEMS) {
1282
- const v = readPath(values, item.key);
1283
- const raw = v === void 0 || v === null ? "" : String(v);
1284
- if (item.readonly === true) {
1285
- draft[item.key] = readonlyTextOf(item, raw, prefill);
1286
- continue;
1287
- }
1288
- const fallback = item.prefillFrom === void 0 ? void 0 : prefill[item.prefillFrom];
1289
- draft[item.key] = raw === "" && typeof fallback === "string" && fallback !== "" ? fallback : raw;
1290
- }
1291
- return draft;
1292
- }
1293
- /** 表单态 → 配置取值(按控件种类还原类型;空串对文本项照收,语义由「按默认落点」承担)。
1294
- *
1295
- * **只读行不收**(#764,照 #749 样板):它们显示的是技能算好的绝对路径,写回配置就是把「显示的路径」
1296
- * 当成「配置值」——保存只提交真能改的那些行(本家=`db.dir` 一行),其余键由技能侧做组内合并保留现值。 */
1297
- function fromDraft(draft) {
1298
- const values = {};
1299
- for (const item of CONFIG_ITEMS) {
1300
- if (item.readonly === true) continue;
1301
- const raw = draft[item.key] ?? "";
1302
- const value = item.control === "number" ? Number(raw) : item.control === "switch" ? raw === "true" : raw;
1303
- writePath(values, item.key, item.control === "number" && !Number.isFinite(value) ? 0 : value);
1304
- }
1305
- return values;
1306
- }
1307
- /** 形状守卫:拿到的那个东西像不像目录选择命名空间(本包只认 `pick` 是函数)。 */
1308
- function isDirectoryPicker(raw) {
1309
- if (typeof raw !== "object" || raw === null) return false;
1310
- return typeof raw.pick === "function";
1897
+ /** 跟随映射(#863):触发键一脏,这些只读派生行就进“将跟随更新”态。纯函数,面板与单测共用。 */
1898
+ const DB_FOLLOWERS = ["db.name", "html.dir"];
1899
+ /** 脏键 → 跟随行(#863 纯函数,交给共用面板当钩子)。 */
1900
+ function followKeysOf(dirtyKeys) {
1901
+ return dirtyKeys.includes("db.dir") ? [...DB_FOLLOWERS] : [];
1311
1902
  }
1312
- /** 现取目录选择命名空间:**软依赖**,拿不到回 null(页面据此不出入口)。
1903
+ /** 「飞书 CLI」状态行(#764,定稿 #761):不是配置项——三档读数由技能侧体检出,面板只显示;
1904
+ * 三档都有「复制 prompt」按钮与官网那一行(逐字、可点击)。
1313
1905
  *
1314
- * 为什么不用 `inject` 声明:见 cookbook §13——写进声明=硬依赖,提供方缺席时整包被停靠,
1315
- * 设置页会跟着装不上。这里按平台给的「可选查找」办:缺席只是没有入口。
1316
- * 守卫拒绝或提供方中途卸载会抛,一律当「没有」,绝不把设置页带下来。 */
1317
- function resolveDirectoryPicker(getService) {
1318
- if (typeof getService !== "function") return null;
1319
- try {
1320
- const raw = getService(REMOTE_DIRECTORY_PICKER);
1321
- return isDirectoryPicker(raw) ? raw : null;
1322
- } catch {
1323
- return null;
1324
- }
1325
- }
1326
- /** 平台回执/入口三态:**已经收进共用件**(票 #744),这里只同名转出。 */
1327
- const readPickAnswer = readPickAnswer$1;
1328
- const pickerModeOf = pickerModeOf$1;
1329
- /** 唤起一次系统文件夹选择器并归一结果(**永不抛**)。 */
1330
- async function pickDirectory(picker) {
1331
- try {
1332
- return readPickAnswer(await picker.pick());
1333
- } catch (e) {
1334
- return {
1335
- kind: "unavailable",
1336
- message: "打不开系统文件夹对话框(" + (e instanceof Error ? e.message : String(e)) + "):请直接在框里填绝对路径。"
1337
- };
1338
- }
1339
- }
1340
- /** 入口三态:有系统对话框(`pick`)/只有应用内浏览(`list` + `createDirectory`)/都没有。
1341
- *
1342
- * 判定取自共用件(一处定义)。本函数只读那个命名空间,不做 IO。 */
1343
- function directoryEntryMode(picker) {
1344
- return picker === null ? "none" : pickerModeOf(picker);
1345
- }
1346
- /** 「选择文件夹」按钮的真装配函数(目录行渲染出来的按钮,onClick 就是它)。
1347
- *
1348
- * 回 Promise 是为了本地可判(用例直接 await);接进 React 时调用方 `void` 掉。 */
1349
- function createBrowseHandler(deps) {
1350
- return async (key) => {
1351
- const outcome = await pickDirectory(deps.picker);
1352
- if (outcome.kind === "picked") deps.onChange(key, outcome.path);
1353
- else if (outcome.kind === "unavailable") deps.onUnavailable(outcome.message);
1354
- };
1355
- }
1356
- /** 一行输入(四种控件对齐受限 YAML 子集:文本/数字/布尔/目录)。
1357
- *
1358
- * 目录档=文本框 + 一枚唤起系统文件夹选择器的按钮;`onBrowse` 缺席(命名空间拿不到、
1359
- * 或这条路已被拒)时不画按钮,文本框照旧——那是该缝自己的契约(供不了就收起入口,不是失败)。
1360
- *
1361
- * **只读行(#764,照 #749 样板)**:`item.readonly` 为真时控件一律 `disabled`(值只经技能侧解析后显示、
1362
- * 不给改),目录行的浏览按钮**保留但不可点击**(#747 定稿:入口不作废,只是不能改)。控件文案**不出现省略号**
1363
- * (#746 处置 9)——按钮就写「选择文件夹」/「浏览」两个字面。 */
1364
- function Row(props) {
1365
- const { item } = props;
1366
- const readonly = item.readonly === true;
1367
- const disabled = props.disabled || readonly;
1368
- const onChange = readonly ? void 0 : (e) => props.onChange(item.key, e.target.value);
1369
- const control = item.control === "switch" ? react.createElement("input", {
1370
- type: "checkbox",
1371
- checked: props.value === "true",
1372
- disabled,
1373
- onChange: readonly ? void 0 : (e) => props.onChange(item.key, e.target.checked ? "true" : "false")
1374
- }) : react.createElement("input", {
1375
- style: S.input,
1376
- type: item.control === "number" ? "number" : "text",
1377
- value: props.value,
1378
- disabled,
1379
- spellCheck: false,
1380
- onChange
1381
- });
1382
- /** 三态入口:供不了(`none`/缺席)就不画,不摆一个点了没反应的死按钮。
1383
- * 只读行照画(按钮保留),但 `disabled` ⇒ 点不动。 */
1384
- const entry = props.browser ?? null;
1385
- const browse = item.control === "directory" && entry !== null && entry.mode !== "none" ? react.createElement("button", {
1386
- style: S.btnPick,
1387
- type: "button",
1388
- disabled,
1389
- onClick: () => entry.onOpen(item.key)
1390
- }, entry.mode === "native" ? "选择文件夹" : "浏览") : null;
1391
- return react.createElement("div", { style: S.row }, react.createElement("div", { style: S.label }, item.title), react.createElement("div", { style: S.hint }, item.hint), browse === null ? control : react.createElement("div", { style: S.pickRow }, control, browse));
1392
- }
1393
- /** 技能设置页:承载作息管家自己的全部可配置项(只配置,不干活)。 */
1394
- function ScheduleConfig(props) {
1395
- const [state, setState] = react.useState({ kind: "loading" });
1396
- const [pickerGone, setPickerGone] = react.useState(false);
1397
- const [picking, setPicking] = react.useState(false);
1398
- const [draft, setDraft] = react.useState({});
1399
- const [busy, setBusy] = react.useState(false);
1400
- const [notice, setNotice] = react.useState(null);
1401
- const [error, setError] = react.useState(null);
1402
- /** 飞书 CLI 状态行(三档读数由技能侧体检出,面板只显示;`null` 以外的三态见下)。 */
1906
+ * 为什么单起一个组件:这通体检电话是本家自己的(共用面板不认识 `config.check` 的回执),
1907
+ * 组件自己持读数与「复制回执」两点状态,面板只管把它画进插槽。 */
1908
+ function LarkLine(props) {
1909
+ const S = props.styles;
1403
1910
  const [lark, setLark] = react.useState({ kind: "loading" });
1404
- /** 复制 prompt 那枚按钮的回执(idle=没点过)。 */
1405
1911
  const [copied, setCopied] = react.useState("idle");
1406
- const apply = react.useCallback((surface) => {
1407
- setState({
1408
- kind: "ready",
1409
- surface
1410
- });
1411
- setDraft(toDraft(surface.values, surface));
1412
- }, []);
1413
1912
  const loadHealth = react.useCallback(async () => {
1414
1913
  setLark({ kind: "loading" });
1415
1914
  const r = await fetchHealthSurface(props.getCall());
@@ -1420,7 +1919,7 @@ window.__ModuleLoader__.load({
1420
1919
  });
1421
1920
  return;
1422
1921
  }
1423
- const item = larkItemOf(r.surface);
1922
+ const item = larkItemOf(r.report);
1424
1923
  setLark(item === null ? {
1425
1924
  kind: "failed",
1426
1925
  message: "体检回执里没有飞书 CLI 那一项"
@@ -1429,259 +1928,56 @@ window.__ModuleLoader__.load({
1429
1928
  item
1430
1929
  });
1431
1930
  }, [props.getCall]);
1432
- const load = react.useCallback(async () => {
1433
- setNotice(null);
1434
- setError(null);
1435
- const r = await fetchConfigSurface(props.getCall());
1436
- if (r.ok) apply(r.surface);
1437
- else setState({
1438
- kind: "failed",
1439
- message: r.message
1440
- });
1441
- await loadHealth();
1442
- }, [
1443
- apply,
1444
- loadHealth,
1445
- props.getCall
1446
- ]);
1447
1931
  react.useEffect(() => {
1448
- let alive = true;
1449
- (async () => {
1450
- const r = await fetchConfigSurface(props.getCall());
1451
- if (!alive) return;
1452
- if (r.ok) apply(r.surface);
1453
- else setState({
1454
- kind: "failed",
1455
- message: r.message
1456
- });
1457
- const h = await fetchHealthSurface(props.getCall());
1458
- if (!alive) return;
1459
- if (!h.ok) setLark({
1460
- kind: "failed",
1461
- message: h.message
1462
- });
1463
- else {
1464
- const item = larkItemOf(h.surface);
1465
- setLark(item === null ? {
1466
- kind: "failed",
1467
- message: "体检回执里没有飞书 CLI 那一项"
1468
- } : {
1469
- kind: "ready",
1470
- item
1471
- });
1472
- }
1473
- })();
1474
- return () => {
1475
- alive = false;
1476
- };
1477
- }, [apply, props.getCall]);
1478
- const onChange = react.useCallback((key, next) => {
1479
- setDraft((prev) => ({
1480
- ...prev,
1481
- [key]: next
1482
- }));
1483
- setNotice(null);
1484
- setError(null);
1485
- }, []);
1486
- /** 目录行入口:三态(系统对话框/应用内浏览/都没有)。
1487
- *
1488
- * **软依赖**:拿不到命名空间就没有入口(留文本框),被拒一次即收起入口,不留死按钮。
1489
- * 状态全部住在组件自己(hook 顺序与旧版同形):浏览器那一份只存「当前开着的那条」。 */
1490
- const picker = pickerGone ? null : props.pickerSource();
1491
- const [browseRow, setBrowseRow] = react.useState(null);
1492
- /** 唤起系统文件夹选择器那一条路(应用内浏览被拒时的兜底,也是命名空间只给 `pick` 时的唯一一条)。 */
1493
- const openNative = react.useCallback(async (key) => {
1494
- const face = pickerGone ? null : props.pickerSource();
1495
- if (face === null) return;
1496
- setPicking(true);
1497
- setError(null);
1498
- const outcome = await pickDirectory(face);
1499
- setPicking(false);
1500
- if (outcome.kind === "picked") onChange(key, outcome.path);
1501
- else if (outcome.kind === "unavailable") {
1502
- setError(outcome.message);
1503
- setPickerGone(true);
1504
- }
1505
- }, [
1506
- pickerGone,
1507
- onChange,
1508
- props.pickerSource
1509
- ]);
1510
- /** 目录行的入口动作:**先应用内浏览,宿主没给这条路再换系统对话框**(判断在共用件里)。
1511
- *
1512
- * 两条都供不了就不给入口(`undefined` 时 `rowEntry` 为 null ⇒ Row 不画按钮)。 */
1513
- const onOpenRow = react.useCallback(async (key) => {
1514
- setError(null);
1515
- const opened = openRowBrowser({
1516
- picker,
1517
- initialPath: draft[key] ?? "",
1518
- onChange: (next) => onChange(key, next),
1519
- onRow: setBrowseRow,
1520
- refusalCode: DIRECTORY_PICKER_REFUSED,
1521
- rootsSource: props.rootsSource
1522
- });
1523
- if (opened === void 0 || await opened === "refused") await openNative(key);
1524
- }, [
1525
- picker,
1526
- onChange,
1527
- draft,
1528
- openNative,
1529
- props.rootsSource
1530
- ]);
1531
- /** 给 Row 的三态入口:`none` 时给 null(不画按钮,文本框照旧)。 */
1532
- const rowEntry = pickerModeOf(picker) === "none" ? null : {
1533
- mode: pickerModeOf(picker),
1534
- onOpen: onOpenRow
1535
- };
1536
- const surface = state.kind === "ready" ? state.surface : null;
1537
- /** 脏值只看**可改行**(#764,照 #749 样板):只读行显示的是技能算好的绝对路径,
1538
- * 拿它当「改动」会让打开面板就变「未保存」。 */
1539
- const editableItems = CONFIG_ITEMS.filter((i) => i.readonly !== true);
1540
- const dirty = surface !== null && editableItems.some((i) => (draft[i.key] ?? "") !== (toDraft(surface.values, surface)[i.key] ?? ""));
1541
- /** 写完之后重新读一份:写回执只有 {path, values},头部那两行要的是读整面。 */
1542
- const writeThenReload = react.useCallback(async (done) => {
1543
- setBusy(true);
1544
- setNotice(null);
1545
- setError(null);
1546
- const r = await fetchConfigSurface(props.getCall());
1547
- if (r.ok) {
1548
- apply(r.surface);
1549
- setNotice(done);
1550
- } else setState({
1551
- kind: "failed",
1552
- message: r.message
1553
- });
1554
- setBusy(false);
1555
- }, [apply, props.getCall]);
1556
- const onSave = react.useCallback(async () => {
1557
- setBusy(true);
1558
- setNotice(null);
1559
- setError(null);
1560
- const r = await saveConfigSurface(props.getCall(), fromDraft(draft));
1561
- setBusy(false);
1562
- if (r.ok) await writeThenReload("已保存,立即生效(不用重启宿主)");
1563
- else setError(r.message);
1564
- }, [
1565
- draft,
1566
- props.getCall,
1567
- writeThenReload
1568
- ]);
1569
- const onReset = react.useCallback(async () => {
1570
- setBusy(true);
1571
- setNotice(null);
1572
- setError(null);
1573
- const r = await resetConfigSurface(props.getCall());
1574
- setBusy(false);
1575
- if (r.ok) await writeThenReload("已重置为默认(原配置已另存一份 .bak)");
1576
- else setError(r.message);
1577
- }, [props.getCall, writeThenReload]);
1578
- const head = react.createElement("div", null, react.createElement("div", { style: S.title }, `${SLOT_TITLE} · 配置`), surface !== null ? react.createElement("div", null, react.createElement("div", { style: S.info }, `配置文件 ${surface.path}`), react.createElement("div", { style: S.info }, `数据目录 ${surface.resolved?.dbDir ?? surface.dataDir}`), surface.created ? react.createElement("div", { style: S.muted }, "(配置文件刚按默认值生成)") : null) : null);
1579
- if (state.kind === "loading") return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.muted }, "配置读取中"));
1580
- if (state.kind === "failed") return react.createElement("div", { style: S.card }, react.createElement("div", { style: S.title }, `${SLOT_TITLE} · 配置`), react.createElement("div", { style: S.error }, state.message), react.createElement("div", { style: S.bar }, react.createElement("button", {
1581
- style: S.btn,
1582
- type: "button",
1583
- onClick: () => void load()
1584
- }, "重试"), react.createElement("button", {
1585
- style: S.btn,
1586
- type: "button",
1587
- onClick: () => void onReset()
1588
- }, "重置为默认")));
1589
- const common = CONFIG_ITEMS.slice(0, COMMON_ITEM_COUNT);
1590
- const advanced = CONFIG_ITEMS.slice(COMMON_ITEM_COUNT);
1591
- const renderRow = (item) => react.createElement(Row, {
1592
- key: item.key,
1593
- item,
1594
- value: draft[item.key] ?? "",
1595
- disabled: busy,
1596
- onChange,
1597
- browser: rowEntry
1598
- });
1932
+ loadHealth();
1933
+ }, [loadHealth]);
1599
1934
  /** 「复制 prompt」:剪贴板不在就报失败,不抛(按钮三档都在,见 #761 定稿)。 */
1600
- const onCopyPrompt = react.useCallback(async () => {
1935
+ const onCopyPrompt = async () => {
1601
1936
  const ok = await copyText(LARK_PROMPT_V5, { clipboard: clipboardOf() ?? void 0 });
1602
1937
  setCopied(ok ? "done" : "failed");
1603
- }, []);
1604
- /** 「飞书 CLI」状态行(#764,定稿 #761):不是配置项——三档读数由技能侧体检出,面板只显示;
1605
- * 三档都有「复制 prompt」按钮与官网那一行(逐字、可点击)。 */
1606
- const renderLark = () => {
1607
- if (lark.kind === "loading") return react.createElement("div", { style: S.rows }, react.createElement("div", { style: S.label }, "飞书 CLI"), react.createElement("div", { style: S.muted }, "飞书 CLI 检测中"));
1608
- if (lark.kind === "failed") return react.createElement("div", { style: S.rows }, react.createElement("div", { style: S.label }, "飞书 CLI"), react.createElement("div", { style: S.error }, lark.message), react.createElement("div", { style: S.bar }, react.createElement("button", {
1609
- style: S.btn,
1610
- type: "button",
1611
- onClick: () => void loadHealth()
1612
- }, "重新检测")));
1613
- const item = lark.item;
1614
- const tone = item.status === "green" ? S.okText : item.status === "red" ? S.error : S.muted;
1615
- return react.createElement("div", { style: S.rows }, react.createElement("div", { style: S.label }, "飞书 CLI"), react.createElement("div", { style: tone }, item.message), item.action === "" ? null : react.createElement("div", { style: S.hint }, item.action), react.createElement("div", { style: S.bar }, react.createElement("button", {
1616
- style: S.btn,
1617
- type: "button",
1618
- onClick: () => void onCopyPrompt()
1619
- }, "复制 prompt"), react.createElement("button", {
1620
- style: S.btn,
1621
- type: "button",
1622
- onClick: () => void loadHealth()
1623
- }, "重新检测")), copied === "done" ? react.createElement("div", { style: S.okText }, "已复制安装指引") : copied === "failed" ? react.createElement("div", { style: S.error }, "复制失败:剪贴板不可用,请手动复制对话框里的安装指引") : null, react.createElement("div", { style: S.info }, react.createElement("a", {
1624
- href: LARK_OFFICIAL_URL,
1625
- target: "_blank",
1626
- rel: "noreferrer"
1627
- }, LARK_OFFICIAL_LINE)));
1628
1938
  };
1629
- return react.createElement("div", { style: S.card }, head, react.createElement("div", { style: S.rows }, common.map(renderRow)), advanced.length === 0 ? null : react.createElement("details", { style: S.advanced }, react.createElement("summary", { style: S.summary }, ADVANCED_GROUP_TITLE), react.createElement("div", { style: S.muted }, ADVANCED_GROUP_NOTE), advanced.map(renderRow)), renderLark(), react.createElement("div", { style: S.bar }, react.createElement("button", {
1630
- style: dirty ? S.btnPrimary : S.btn,
1939
+ if (lark.kind === "loading") return react.createElement("div", { style: S.rows }, react.createElement("div", { style: S.label }, "飞书 CLI"), react.createElement("div", { style: S.muted }, "飞书 CLI 检测中"));
1940
+ if (lark.kind === "failed") return react.createElement("div", { style: S.rows }, react.createElement("div", { style: S.label }, "飞书 CLI"), react.createElement("div", { style: S.error }, lark.message), react.createElement("div", { style: S.bar }, react.createElement("button", {
1941
+ style: S.btn,
1631
1942
  type: "button",
1632
- disabled: busy || !dirty,
1633
- onClick: () => void onSave()
1634
- }, busy ? "处理中" : "保存"), react.createElement("button", {
1943
+ onClick: () => void loadHealth()
1944
+ }, "重新检测")));
1945
+ const item = lark.item;
1946
+ const tone = item.status === "green" ? S.okText : item.status === "red" ? S.error : S.muted;
1947
+ return react.createElement("div", { style: S.rows }, react.createElement("div", { style: S.label }, "飞书 CLI"), react.createElement("div", { style: tone }, item.message), item.action === "" ? null : react.createElement("div", { style: S.hint }, item.action), react.createElement("div", { style: S.bar }, react.createElement("button", {
1635
1948
  style: S.btn,
1636
1949
  type: "button",
1637
- disabled: busy,
1638
- onClick: () => void onReset()
1639
- }, "重置为默认"), react.createElement("button", {
1950
+ onClick: () => void onCopyPrompt()
1951
+ }, "复制 prompt"), react.createElement("button", {
1640
1952
  style: S.btn,
1641
1953
  type: "button",
1642
- disabled: busy,
1643
- onClick: () => void load()
1644
- }, "重新读取")), picking ? react.createElement("div", { style: S.muted }, "已唤起系统文件夹对话框:选中后自动填上,取消则不动。") : null, browseRow !== null ? react.createElement(DirectoryBrowserFromRow, {
1645
- open: true,
1646
- row: browseRow,
1647
- labels: {
1648
- title: "选择文件夹",
1649
- close: "关闭",
1650
- up: "上一级",
1651
- pathPlaceholder: "直接填绝对路径,回车即进入",
1652
- go: "转到",
1653
- showHidden: (n) => "显示隐藏目录(" + n + ")",
1654
- empty: "这个目录里没有子目录。",
1655
- loading: "正在读取",
1656
- newFolder: "新建文件夹",
1657
- createConfirm: "创建",
1658
- createCancel: "取消",
1659
- select: "选",
1660
- selected: "已选",
1661
- open: "选定这个目录",
1662
- cancel: "取消",
1663
- willPick: "将选定:"
1664
- }
1665
- }) : null, notice !== null ? react.createElement("div", { style: S.okText }, notice) : null, error !== null ? react.createElement("div", { style: S.error }, error) : null);
1954
+ onClick: () => void loadHealth()
1955
+ }, "重新检测")), copied === "done" ? react.createElement("div", { style: S.okText }, "已复制安装指引") : copied === "failed" ? react.createElement("div", { style: S.error }, "复制失败:剪贴板不可用,请手动复制对话框里的安装指引") : null, react.createElement("div", { style: S.info }, react.createElement("a", {
1956
+ href: LARK_OFFICIAL_URL,
1957
+ target: "_blank",
1958
+ rel: "noreferrer"
1959
+ }, LARK_OFFICIAL_LINE)));
1666
1960
  }
1667
1961
  function apply(ctx) {
1668
1962
  const getCall = () => ctx.connection?.rpc?.call ?? null;
1669
- const getPicker = () => typeof ctx.get === "function" ? resolveDirectoryPicker((name) => ctx.get?.(name)) : null;
1963
+ const getService = (name) => typeof ctx.get === "function" ? ctx.get(name) : void 0;
1670
1964
  ctx.slots.inject("ilife.config-tab", () => ctx.slots.register({
1671
1965
  name: "ilife.config-tab",
1672
1966
  id: PLUGIN,
1673
1967
  order: 85,
1674
1968
  label: () => SLOT_TITLE,
1675
1969
  channel: RPC_CHANNEL
1676
- }, () => react.createElement(ScheduleConfig, {
1677
- getCall,
1678
- pickerSource: getPicker,
1679
- rootsSource: createRootsSource({
1970
+ }, () => react.createElement(ConfigPanel, {
1971
+ channel: RPC_CHANNEL,
1972
+ items: CONFIG_ITEMS,
1973
+ title: SLOT_TITLE,
1974
+ followKeysOf,
1975
+ extra: (parts) => parts.reply === null ? null : react.createElement(LarkLine, {
1680
1976
  getCall,
1681
- base: MANAGER_RPC_BASE,
1682
- endpoint: MANAGER_RPC_ENDPOINT,
1683
- method: MANAGER_ROOTS_METHOD
1684
- })
1977
+ styles: parts.styles
1978
+ }),
1979
+ getCall,
1980
+ getService
1685
1981
  })));
1686
1982
  }
1687
1983
  //#endregion
@@ -1689,27 +1985,13 @@ window.__ModuleLoader__.load({
1689
1985
  exports.LARK_OFFICIAL_URL = LARK_OFFICIAL_URL;
1690
1986
  exports.LARK_PROMPT_V5 = LARK_PROMPT_V5;
1691
1987
  exports.READ_TIMEOUT_MS = READ_TIMEOUT_MS;
1692
- exports.Row = Row;
1693
1988
  exports.apply = apply;
1694
1989
  exports.clipboardOf = clipboardOf;
1695
1990
  exports.copyText = copyText;
1696
- exports.createBrowseHandler = createBrowseHandler;
1697
- exports.directoryEntryMode = directoryEntryMode;
1698
- exports.fetchConfigSurface = fetchConfigSurface;
1699
1991
  exports.fetchHealthSurface = fetchHealthSurface;
1700
- exports.fromDraft = fromDraft;
1701
- exports.humanizeConfigFailure = humanizeConfigFailure;
1992
+ exports.followKeysOf = followKeysOf;
1702
1993
  exports.inject = inject;
1703
- exports.isDirectoryPicker = isDirectoryPicker;
1704
1994
  exports.larkItemOf = larkItemOf;
1705
- exports.openRowBrowser = openRowBrowser;
1706
- exports.pickDirectory = pickDirectory;
1707
- exports.pickerModeOf = pickerModeOf;
1708
- exports.readPickAnswer = readPickAnswer;
1709
- exports.resetConfigSurface = resetConfigSurface;
1710
- exports.resolveDirectoryPicker = resolveDirectoryPicker;
1711
- exports.saveConfigSurface = saveConfigSurface;
1712
- exports.toDraft = toDraft;
1713
1995
  return module.exports;
1714
1996
  }
1715
1997
  });