dsh-prompt-customizer 0.4.2 → 0.5.0
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/LICENSE +21 -21
- package/README.en.md +278 -278
- package/README.i18n.yaml +2 -2
- package/README.md +284 -278
- package/client/client.js +1655 -781
- package/client/client.js.map +1 -1
- package/cordis.patch.yml +8 -8
- package/lib/catalog.js +131 -131
- package/lib/effective.js +161 -161
- package/lib/index.js +946 -943
- package/lib/promotion.js +80 -80
- package/lib/schema.js +124 -124
- package/lib/sectionOps.d.mts +67 -32
- package/lib/sectionOps.mjs +268 -128
- package/lib/store.js +124 -124
- package/lib/vars.js +147 -147
- package/lib/zh/cordis.mjs +110 -0
- package/lib/zh/core.mjs +47 -0
- package/lib/zh/index.d.mts +8 -0
- package/lib/zh/index.mjs +23 -0
- package/lib/zh/sdk.mjs +22 -0
- package/lib/zh/teams.mjs +19 -0
- package/lib/zh/undo.mjs +18 -0
- package/package.json +83 -84
- package/src/client/Panel.tsx +532 -0
- package/src/client/{PresetsTab.tsx → PresetsPane.tsx} +298 -281
- package/src/client/PreviewPane.tsx +73 -0
- package/src/client/PreviewTools.tsx +33 -33
- package/src/client/SectionsPane.tsx +331 -0
- package/src/client/ToolsPane.tsx +230 -0
- package/src/client/error-boundary.tsx +48 -0
- package/src/client/index.ts +97 -434
- package/src/client/locales.ts +297 -261
- package/src/client/nav.tsx +284 -0
- package/src/client/preset-io.ts +226 -226
- package/src/client/presets.ts +413 -413
- package/src/client/shell.tsx +179 -0
- package/src/client/styles.ts +59 -49
- package/src/client/types.ts +125 -128
- package/src/client/PreviewTab.tsx +0 -92
- package/src/client/SectionsTab.tsx +0 -539
- package/src/client/ToolsTab.tsx +0 -293
package/lib/sectionOps.mjs
CHANGED
|
@@ -1,129 +1,269 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 提示词段面板的纯状态逻辑(无 React / 无 IO)。
|
|
3
|
-
* 与 src/client/SectionsTab.tsx 共享同一份实现(浏览器里随 client bundle
|
|
4
|
-
* 打包;node --test 直接 import 本文件跑单测),保证「测试即上线代码」。
|
|
5
|
-
*
|
|
6
|
-
* 阶段模型:引导期(bootstrap)/ 常驻期(active)/ 压缩受控期(compaction)
|
|
7
|
-
* 恒定全部显示(预设没有某个阶段时该部分就是空的),各自拥有独立的注入
|
|
8
|
-
* 名单与 order 空间;屏蔽按「每阶段独立名单」写回(引导期 →
|
|
9
|
-
* sectionsBootstrap,压缩受控期 → sectionsCompaction,常驻期 → 全局 sections)。
|
|
10
|
-
* 入参统一是名义阶段键,不再有「同形折叠组」这种把引导期当常驻期用的形态。
|
|
11
|
-
*/
|
|
12
|
-
|
|
13
|
-
/** 名义阶段键 → 屏蔽名单写回目标(常驻期用全局 sections)。 */
|
|
14
|
-
export function sectionListOf(key) {
|
|
15
|
-
return key === 'bootstrap' ? 'bootstrap' : key === 'compaction' ? 'compaction' : 'global'
|
|
16
|
-
}
|
|
17
|
-
|
|
18
|
-
/** 名义阶段键 → 注入阶段:压缩受控期是独立注入阶段(compaction)。 */
|
|
19
|
-
export function injectPhaseOf(key) {
|
|
20
|
-
return key === 'bootstrap' ? 'bootstrap' : key === 'active' ? 'active' : 'compaction'
|
|
21
|
-
}
|
|
22
|
-
|
|
23
|
-
/** 某注入段出现在哪些阶段部分:always 全阶段;bootstrap/compaction/active
|
|
24
|
-
* 仅各自对应的阶段(与服务端 filterInjectByPhase 的三态互相独立一致)。 */
|
|
25
|
-
export function acceptsInjectFor(key, phase) {
|
|
26
|
-
if (phase === 'always') return true
|
|
27
|
-
return phase === key
|
|
28
|
-
}
|
|
29
|
-
|
|
30
|
-
/** 该阶段自己的屏蔽名单(三态互相独立:引导期 sectionsBootstrap /
|
|
31
|
-
* 压缩受控期 sectionsCompaction / 常驻期 sections,互不继承、互不影响)。 */
|
|
32
|
-
export function deniedNames(cfg, key) {
|
|
33
|
-
const list = sectionListOf(key)
|
|
34
|
-
return list === 'bootstrap' ? (cfg.sectionsBootstrap ?? [])
|
|
35
|
-
: list === 'compaction' ? (cfg.sectionsCompaction ?? [])
|
|
36
|
-
: (cfg.sections ?? [])
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
/**
|
|
40
|
-
* 某个阶段部分当前的注入身份(含未保存草稿)。
|
|
41
|
-
*
|
|
42
|
-
* `names` = 本部分可见的注入段名(本阶段专属 + 跨阶段的 always)。post 视图来自
|
|
43
|
-
* 「上次保存」的服务端结果,删除只改草稿,所以 post 独有段必须有 names 背书才
|
|
44
|
-
* 能显示 —— 否则刚删掉的自定义段会以「系统段」复活(身份只认 custom 标记,条目
|
|
45
|
-
* 没了就被判成系统),再经一次重排就被写成 custom:false 空文本,用户填的内容被
|
|
46
|
-
* 抹平。`custom` 只收真正的自定义段,`order` 只收本阶段的草稿序。
|
|
47
|
-
*
|
|
48
|
-
* `text` = 本阶段生效的用户文本:自定义段自带的文本,以及**系统段在本阶段被
|
|
49
|
-
* 替换后的文本**(非空即替换)。系统段的文本必须按阶段存 —— 注入条目本来就带
|
|
50
|
-
* `phase`,服务端按阶段筛选,所以三个阶段各改各的文本互不影响;旧的全局
|
|
51
|
-
* `replace` 字典一份文本对三个阶段同时生效,已不承担界面编辑。
|
|
52
|
-
*/
|
|
53
|
-
export function injectedAt(cfg, key) {
|
|
54
|
-
const phase = injectPhaseOf(key)
|
|
55
|
-
const names = new Set()
|
|
56
|
-
const custom = new Set()
|
|
57
|
-
const text = new Map()
|
|
58
|
-
const order = new Map()
|
|
59
|
-
for (const item of cfg.inject ?? []) {
|
|
60
|
-
if (item === null || typeof item !== 'object' || typeof item.name !== 'string') continue
|
|
61
|
-
const itemPhase = item.phase ?? 'always'
|
|
62
|
-
if (itemPhase === phase) order.set(item.name, item.order ?? 0)
|
|
63
|
-
if (!acceptsInjectFor(key, itemPhase)) continue
|
|
64
|
-
names.add(item.name)
|
|
65
|
-
if (item.text && !text.has(item.name)) text.set(item.name, item.text)
|
|
66
|
-
if (item.custom === true) custom.add(item.name)
|
|
67
|
-
}
|
|
68
|
-
return { phase, names, custom, text, order }
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
/**
|
|
72
|
-
* 屏蔽/恢复一个段(当前阶段语义):返回需要写盘的字段补丁。
|
|
73
|
-
* 三态名单互相独立:只读写本阶段自己的名单(引导期 → sectionsBootstrap,
|
|
74
|
-
* 压缩受控期 → sectionsCompaction,常驻期 → sections),屏蔽 / 恢复都绝不
|
|
75
|
-
* 波及其它阶段的名单 —— 一个阶段的屏蔽不再连带屏蔽另一个阶段。
|
|
76
|
-
* 名单无变化时不产出字段(空补丁 = 不写盘),避免把继承值冻结成无意义的
|
|
77
|
-
* 空数组覆盖。
|
|
78
|
-
*/
|
|
79
|
-
export function blockPatch(cfg, key, name, blocked) {
|
|
80
|
-
const list = sectionListOf(key)
|
|
81
|
-
const field = list === 'bootstrap' ? 'sectionsBootstrap' : list === 'compaction' ? 'sectionsCompaction' : 'sections'
|
|
82
|
-
const cur = (cfg[field] ?? []).slice()
|
|
83
|
-
const i = cur.indexOf(name)
|
|
84
|
-
if (blocked) {
|
|
85
|
-
if (i >= 0) return {}
|
|
86
|
-
cur.push(name)
|
|
87
|
-
} else {
|
|
88
|
-
if (i < 0) return {}
|
|
89
|
-
cur.splice(i, 1)
|
|
90
|
-
}
|
|
91
|
-
return { [field]: cur }
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
/**
|
|
95
|
-
* 重排/插入一个阶段的有序行列表:把 dragName 从列表中移除后,插入到
|
|
96
|
-
* targetName 行之上(pos='above')或之下(pos='below');返回新列表。
|
|
97
|
-
* 拖入的新段由调用方以 newRow 提供,插入后保留在列表中(其余行保持原样)。
|
|
98
|
-
*/
|
|
99
|
-
export function reorderInsert(rows, dragName, targetName, pos, newRow = null) {
|
|
100
|
-
const base = rows.filter((row) => row.name !== dragName)
|
|
101
|
-
const idx = base.findIndex((row) => row.name === targetName)
|
|
102
|
-
if (idx < 0) return null
|
|
103
|
-
const insertAt = Math.max(0, Math.min(pos === 'above' ? idx : idx + 1, base.length))
|
|
104
|
-
const entry = newRow ?? rows.find((row) => row.name === dragName)
|
|
105
|
-
if (!entry) return null
|
|
106
|
-
base.splice(insertAt, 0, entry)
|
|
107
|
-
return base
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
/**
|
|
111
|
-
* 持久化一个阶段的有序列表(v1 persistOrder 的逐阶段版):把 rows(有序行)
|
|
112
|
-
* 写成该阶段的注入条目,order = 连续整数(0,1,2,…)——「虚拟 order 决定注入
|
|
113
|
-
* 顺序」;文本优先级 = 本阶段的用户替换文本(row.override)→ 自定义段自带的
|
|
114
|
-
* 文本(row.text)→ 空文本(= 仅 order 覆盖,服务端保留原文)。三者缺一不可:
|
|
115
|
-
* 重排走的就是这个函数,漏掉 override 会让一次拖动把用户在该阶段改的文本抹平。
|
|
116
|
-
* 其它阶段(含 always)的注入条目原样保留。
|
|
117
|
-
*/
|
|
118
|
-
export function phaseInjectEntries(cfg, key, rows) {
|
|
119
|
-
const phase = injectPhaseOf(key)
|
|
120
|
-
const others = (cfg.inject ?? []).filter((item) => (item.phase ?? 'always') !== phase)
|
|
121
|
-
const entries = rows.map((row, i) => ({
|
|
122
|
-
name: row.name,
|
|
123
|
-
order: i,
|
|
124
|
-
text: row.override || (row.custom ? (row.text ?? '') : ''),
|
|
125
|
-
phase,
|
|
126
|
-
custom: row.custom,
|
|
127
|
-
}))
|
|
128
|
-
return [...others, ...entries]
|
|
1
|
+
/**
|
|
2
|
+
* 提示词段面板的纯状态逻辑(无 React / 无 IO)。
|
|
3
|
+
* 与 src/client/SectionsTab.tsx 共享同一份实现(浏览器里随 client bundle
|
|
4
|
+
* 打包;node --test 直接 import 本文件跑单测),保证「测试即上线代码」。
|
|
5
|
+
*
|
|
6
|
+
* 阶段模型:引导期(bootstrap)/ 常驻期(active)/ 压缩受控期(compaction)
|
|
7
|
+
* 恒定全部显示(预设没有某个阶段时该部分就是空的),各自拥有独立的注入
|
|
8
|
+
* 名单与 order 空间;屏蔽按「每阶段独立名单」写回(引导期 →
|
|
9
|
+
* sectionsBootstrap,压缩受控期 → sectionsCompaction,常驻期 → 全局 sections)。
|
|
10
|
+
* 入参统一是名义阶段键,不再有「同形折叠组」这种把引导期当常驻期用的形态。
|
|
11
|
+
*/
|
|
12
|
+
|
|
13
|
+
/** 名义阶段键 → 屏蔽名单写回目标(常驻期用全局 sections)。 */
|
|
14
|
+
export function sectionListOf(key) {
|
|
15
|
+
return key === 'bootstrap' ? 'bootstrap' : key === 'compaction' ? 'compaction' : 'global'
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
/** 名义阶段键 → 注入阶段:压缩受控期是独立注入阶段(compaction)。 */
|
|
19
|
+
export function injectPhaseOf(key) {
|
|
20
|
+
return key === 'bootstrap' ? 'bootstrap' : key === 'active' ? 'active' : 'compaction'
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** 某注入段出现在哪些阶段部分:always 全阶段;bootstrap/compaction/active
|
|
24
|
+
* 仅各自对应的阶段(与服务端 filterInjectByPhase 的三态互相独立一致)。 */
|
|
25
|
+
export function acceptsInjectFor(key, phase) {
|
|
26
|
+
if (phase === 'always') return true
|
|
27
|
+
return phase === key
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/** 该阶段自己的屏蔽名单(三态互相独立:引导期 sectionsBootstrap /
|
|
31
|
+
* 压缩受控期 sectionsCompaction / 常驻期 sections,互不继承、互不影响)。 */
|
|
32
|
+
export function deniedNames(cfg, key) {
|
|
33
|
+
const list = sectionListOf(key)
|
|
34
|
+
return list === 'bootstrap' ? (cfg.sectionsBootstrap ?? [])
|
|
35
|
+
: list === 'compaction' ? (cfg.sectionsCompaction ?? [])
|
|
36
|
+
: (cfg.sections ?? [])
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* 某个阶段部分当前的注入身份(含未保存草稿)。
|
|
41
|
+
*
|
|
42
|
+
* `names` = 本部分可见的注入段名(本阶段专属 + 跨阶段的 always)。post 视图来自
|
|
43
|
+
* 「上次保存」的服务端结果,删除只改草稿,所以 post 独有段必须有 names 背书才
|
|
44
|
+
* 能显示 —— 否则刚删掉的自定义段会以「系统段」复活(身份只认 custom 标记,条目
|
|
45
|
+
* 没了就被判成系统),再经一次重排就被写成 custom:false 空文本,用户填的内容被
|
|
46
|
+
* 抹平。`custom` 只收真正的自定义段,`order` 只收本阶段的草稿序。
|
|
47
|
+
*
|
|
48
|
+
* `text` = 本阶段生效的用户文本:自定义段自带的文本,以及**系统段在本阶段被
|
|
49
|
+
* 替换后的文本**(非空即替换)。系统段的文本必须按阶段存 —— 注入条目本来就带
|
|
50
|
+
* `phase`,服务端按阶段筛选,所以三个阶段各改各的文本互不影响;旧的全局
|
|
51
|
+
* `replace` 字典一份文本对三个阶段同时生效,已不承担界面编辑。
|
|
52
|
+
*/
|
|
53
|
+
export function injectedAt(cfg, key) {
|
|
54
|
+
const phase = injectPhaseOf(key)
|
|
55
|
+
const names = new Set()
|
|
56
|
+
const custom = new Set()
|
|
57
|
+
const text = new Map()
|
|
58
|
+
const order = new Map()
|
|
59
|
+
for (const item of cfg.inject ?? []) {
|
|
60
|
+
if (item === null || typeof item !== 'object' || typeof item.name !== 'string') continue
|
|
61
|
+
const itemPhase = item.phase ?? 'always'
|
|
62
|
+
if (itemPhase === phase) order.set(item.name, item.order ?? 0)
|
|
63
|
+
if (!acceptsInjectFor(key, itemPhase)) continue
|
|
64
|
+
names.add(item.name)
|
|
65
|
+
if (item.text && !text.has(item.name)) text.set(item.name, item.text)
|
|
66
|
+
if (item.custom === true) custom.add(item.name)
|
|
67
|
+
}
|
|
68
|
+
return { phase, names, custom, text, order }
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* 屏蔽/恢复一个段(当前阶段语义):返回需要写盘的字段补丁。
|
|
73
|
+
* 三态名单互相独立:只读写本阶段自己的名单(引导期 → sectionsBootstrap,
|
|
74
|
+
* 压缩受控期 → sectionsCompaction,常驻期 → sections),屏蔽 / 恢复都绝不
|
|
75
|
+
* 波及其它阶段的名单 —— 一个阶段的屏蔽不再连带屏蔽另一个阶段。
|
|
76
|
+
* 名单无变化时不产出字段(空补丁 = 不写盘),避免把继承值冻结成无意义的
|
|
77
|
+
* 空数组覆盖。
|
|
78
|
+
*/
|
|
79
|
+
export function blockPatch(cfg, key, name, blocked) {
|
|
80
|
+
const list = sectionListOf(key)
|
|
81
|
+
const field = list === 'bootstrap' ? 'sectionsBootstrap' : list === 'compaction' ? 'sectionsCompaction' : 'sections'
|
|
82
|
+
const cur = (cfg[field] ?? []).slice()
|
|
83
|
+
const i = cur.indexOf(name)
|
|
84
|
+
if (blocked) {
|
|
85
|
+
if (i >= 0) return {}
|
|
86
|
+
cur.push(name)
|
|
87
|
+
} else {
|
|
88
|
+
if (i < 0) return {}
|
|
89
|
+
cur.splice(i, 1)
|
|
90
|
+
}
|
|
91
|
+
return { [field]: cur }
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* 重排/插入一个阶段的有序行列表:把 dragName 从列表中移除后,插入到
|
|
96
|
+
* targetName 行之上(pos='above')或之下(pos='below');返回新列表。
|
|
97
|
+
* 拖入的新段由调用方以 newRow 提供,插入后保留在列表中(其余行保持原样)。
|
|
98
|
+
*/
|
|
99
|
+
export function reorderInsert(rows, dragName, targetName, pos, newRow = null) {
|
|
100
|
+
const base = rows.filter((row) => row.name !== dragName)
|
|
101
|
+
const idx = base.findIndex((row) => row.name === targetName)
|
|
102
|
+
if (idx < 0) return null
|
|
103
|
+
const insertAt = Math.max(0, Math.min(pos === 'above' ? idx : idx + 1, base.length))
|
|
104
|
+
const entry = newRow ?? rows.find((row) => row.name === dragName)
|
|
105
|
+
if (!entry) return null
|
|
106
|
+
base.splice(insertAt, 0, entry)
|
|
107
|
+
return base
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* 持久化一个阶段的有序列表(v1 persistOrder 的逐阶段版):把 rows(有序行)
|
|
112
|
+
* 写成该阶段的注入条目,order = 连续整数(0,1,2,…)——「虚拟 order 决定注入
|
|
113
|
+
* 顺序」;文本优先级 = 本阶段的用户替换文本(row.override)→ 自定义段自带的
|
|
114
|
+
* 文本(row.text)→ 空文本(= 仅 order 覆盖,服务端保留原文)。三者缺一不可:
|
|
115
|
+
* 重排走的就是这个函数,漏掉 override 会让一次拖动把用户在该阶段改的文本抹平。
|
|
116
|
+
* 其它阶段(含 always)的注入条目原样保留。
|
|
117
|
+
*/
|
|
118
|
+
export function phaseInjectEntries(cfg, key, rows) {
|
|
119
|
+
const phase = injectPhaseOf(key)
|
|
120
|
+
const others = (cfg.inject ?? []).filter((item) => (item.phase ?? 'always') !== phase)
|
|
121
|
+
const entries = rows.map((row, i) => ({
|
|
122
|
+
name: row.name,
|
|
123
|
+
order: i,
|
|
124
|
+
text: row.override || (row.custom ? (row.text ?? '') : ''),
|
|
125
|
+
phase,
|
|
126
|
+
custom: row.custom,
|
|
127
|
+
}))
|
|
128
|
+
return [...others, ...entries]
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* 三态同步持久化:rowsByKey 给出三个阶段各自的有序行集合(bootstrap /
|
|
133
|
+
* active / compaction),生成完整 inject 列表 —— always 条目原样保留,三个
|
|
134
|
+
* 阶段各自写成连续虚拟 order 的注入条目(条目形状与 phaseInjectEntries 完全
|
|
135
|
+
* 一致)。用于「三态同步」的一次写入:edit 对 inject 是整体替换,逐阶段各写
|
|
136
|
+
* 一次会互相覆盖只留下最后一次。
|
|
137
|
+
*/
|
|
138
|
+
export function mergedPhaseInjectEntries(cfg, rowsByKey) {
|
|
139
|
+
const always = (cfg.inject ?? []).filter((item) => (item.phase ?? 'always') === 'always')
|
|
140
|
+
const entries = ['bootstrap', 'active', 'compaction'].flatMap((key) => {
|
|
141
|
+
const phase = injectPhaseOf(key)
|
|
142
|
+
return (rowsByKey[key] ?? []).map((row, i) => ({
|
|
143
|
+
name: row.name,
|
|
144
|
+
order: i,
|
|
145
|
+
text: row.override || (row.custom ? (row.text ?? '') : ''),
|
|
146
|
+
phase,
|
|
147
|
+
custom: row.custom,
|
|
148
|
+
}))
|
|
149
|
+
})
|
|
150
|
+
return [...always, ...entries]
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
/**
|
|
154
|
+
* 一个阶段部分的全部行(提示词 Tab 每行):行集合 = 「真实进入该阶段装配的段」
|
|
155
|
+
*(post 视图,与预览一致 —— 预设原生阶段插件裁剪掉的段不显示)∪「被屏蔽的段」
|
|
156
|
+
*(屏蔽名单含未保存草稿,随时可反选)∪「配置里属于该阶段的自定义注入段」。
|
|
157
|
+
* 顺序以 base(预过滤)视图的骨架为底,再叠加「该阶段的注入 order」草稿序
|
|
158
|
+
* —— 未保存的重排立即反映到界面。文本 post 优先(替换 / 注入结果),回退
|
|
159
|
+
* base 原文与注入文本。身份只认注入条目的 custom 隐藏标记,绝不互相转换。
|
|
160
|
+
* `view` = 三阶段预览装配里的对应阶段(可为 null = 视为空)。从 SectionsTab
|
|
161
|
+
* 的 rowsOf 原样迁出 —— 纯函数,UI 与 node --test 单测共用同一份实现。
|
|
162
|
+
*/
|
|
163
|
+
export function phaseRows(cfg, view, key) {
|
|
164
|
+
const replace = cfg.replace ?? {}
|
|
165
|
+
const denied = new Set(deniedNames(cfg, key))
|
|
166
|
+
const postByName = new Map((view?.sections ?? []).map((sec) => [sec.name, sec]))
|
|
167
|
+
const baseByName = new Map((view?.baseSections ?? []).map((sec) => [sec.name, sec]))
|
|
168
|
+
const { phase, names: injectedHere, custom: customNames, text, order: phaseOrder } = injectedAt(cfg, key)
|
|
169
|
+
const names = []
|
|
170
|
+
const seen = new Set()
|
|
171
|
+
const push = (name) => { if (!seen.has(name)) { seen.add(name); names.push(name) } }
|
|
172
|
+
// base 骨架顺序里取 post 段与被屏蔽段(保持自然位置)。被屏蔽取并集:
|
|
173
|
+
// 当前草稿名单(切换立即反馈)∪ 上次保存的名单(base 的 blocked 标记 ——
|
|
174
|
+
// 刚解除屏蔽的行不会立即消失,仍可再勾回去)。
|
|
175
|
+
for (const sec of view?.baseSections ?? []) {
|
|
176
|
+
if (postByName.has(sec.name) || denied.has(sec.name) || sec.blocked === true) push(sec.name)
|
|
177
|
+
}
|
|
178
|
+
// post 独有段 = 本插件注入进去的段(post 恒为 base 减去屏蔽再加上注入),
|
|
179
|
+
// 追加在尾部。但它来自「上次保存」的服务端结果,删除只改草稿,所以必须
|
|
180
|
+
// 有当前 inject 条目背书 —— 否则刚删掉的自定义段会以「系统段」复活(身份
|
|
181
|
+
// 只认 inject 的 custom 标记,条目没了就被判成系统),再经一次重排就被写成
|
|
182
|
+
// custom:false 空文本,用户填的内容被抹平。
|
|
183
|
+
for (const name of postByName.keys()) {
|
|
184
|
+
if (baseByName.has(name) || injectedHere.has(name)) push(name)
|
|
185
|
+
}
|
|
186
|
+
// 精确属于该阶段的注入条目:自定义段始终显示;系统段在装配输入里见过
|
|
187
|
+
//(base/post)**或**带着用户为该阶段填的文本(= 从全部池显式加进来的)才
|
|
188
|
+
// 显示 —— 既让拖入立即出现,又不让历史遗留的陈旧条目把装配里根本没有的段带回来。
|
|
189
|
+
for (const item of cfg.inject ?? []) {
|
|
190
|
+
if (item === null || typeof item !== 'object' || typeof item.name !== 'string') continue
|
|
191
|
+
if ((item.phase ?? 'always') !== phase) continue
|
|
192
|
+
if (item.custom === true || text.get(item.name) || baseByName.has(item.name) || postByName.has(item.name)) push(item.name)
|
|
193
|
+
}
|
|
194
|
+
// 跨阶段生效的自定义段(如 always)。
|
|
195
|
+
for (const name of customNames) push(name)
|
|
196
|
+
const rows = names.map((name) => {
|
|
197
|
+
// 本阶段的用户替换文本:只认属于本阶段的注入条目(injectedAt 已按阶段筛)。
|
|
198
|
+
const override = text.get(name) ?? ''
|
|
199
|
+
return {
|
|
200
|
+
name,
|
|
201
|
+
text: postByName.get(name)?.text ?? baseByName.get(name)?.text ?? '',
|
|
202
|
+
replaced: override !== '' || Object.hasOwn(replace, name),
|
|
203
|
+
custom: customNames.has(name),
|
|
204
|
+
override,
|
|
205
|
+
blocked: denied.has(name),
|
|
206
|
+
}
|
|
207
|
+
})
|
|
208
|
+
// 草稿序叠加:该阶段有注入 order 就按它重排当前行(未保存的拖动/箭头
|
|
209
|
+
// 立即生效);无 order 的行走 base 骨架相对序(稳定排序)。
|
|
210
|
+
if (phaseOrder.size > 0) {
|
|
211
|
+
const fallback = new Map(rows.map((row, i) => [row.name, i]))
|
|
212
|
+
rows.sort((a, b) => (phaseOrder.get(a.name) ?? fallback.get(a.name) ?? 0) - (phaseOrder.get(b.name) ?? fallback.get(b.name) ?? 0))
|
|
213
|
+
}
|
|
214
|
+
return rows
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
/**
|
|
218
|
+
* 「应用中文」(开关开启方向,等效手动编辑):把三个阶段各自的行里名字命中
|
|
219
|
+
* zhMap 的**非自定义**行打上中文文本补丁,再经 mergedPhaseInjectEntries 生成
|
|
220
|
+
* 完整 inject 列表(调用方写入编辑草稿,保存后生效)。zhMap 条目为字符串
|
|
221
|
+
*(整段替换)或函数(入参该行原文,返回空值 = 放弃替换,如 tools:sdk 的围栏
|
|
222
|
+
* 守卫);未命中的行与阶段原样保留,段数与注入不增不减。自定义段是用户自撰
|
|
223
|
+
* 内容,绝不覆盖。`views` = 三阶段预览装配(键可为 null —— 该阶段行集视为空)。
|
|
224
|
+
*/
|
|
225
|
+
export function zhMergedInjectEntries(cfg, views, zhMap) {
|
|
226
|
+
const patched = {}
|
|
227
|
+
for (const key of ['bootstrap', 'active', 'compaction']) {
|
|
228
|
+
patched[key] = phaseRows(cfg, views?.[key] ?? null, key).map((row) => {
|
|
229
|
+
if (row.custom) return row
|
|
230
|
+
const entry = zhMap?.[row.name]
|
|
231
|
+
if (entry === undefined) return row
|
|
232
|
+
const zh = typeof entry === 'function' ? entry(row.text) : entry
|
|
233
|
+
return zh ? { ...row, override: zh, text: zh } : row
|
|
234
|
+
})
|
|
235
|
+
}
|
|
236
|
+
return mergedPhaseInjectEntries(cfg, patched)
|
|
237
|
+
}
|
|
238
|
+
|
|
239
|
+
/**
|
|
240
|
+
* 「回归英文」(开关关闭方向):把三个阶段行里命中译本的非自定义行的替换
|
|
241
|
+
* 文本清空 —— 系统段的注入条目回落为仅 order 覆盖,服务端恢复注册表英文
|
|
242
|
+
* 原文。与 zhMergedInjectEntries 严格对称:开关独占这些段的文本所有权,
|
|
243
|
+
* 关闭即整体回英文(用户在开启期间的手工微调一并清除)。自定义段不碰。
|
|
244
|
+
*/
|
|
245
|
+
export function zhRevertInjectEntries(cfg, views, zhMap) {
|
|
246
|
+
const patched = {}
|
|
247
|
+
for (const key of ['bootstrap', 'active', 'compaction']) {
|
|
248
|
+
patched[key] = phaseRows(cfg, views?.[key] ?? null, key).map((row) => {
|
|
249
|
+
if (row.custom || row.override === '' || zhMap?.[row.name] === undefined) return row
|
|
250
|
+
return { ...row, override: '', text: '' }
|
|
251
|
+
})
|
|
252
|
+
}
|
|
253
|
+
return mergedPhaseInjectEntries(cfg, patched)
|
|
254
|
+
}
|
|
255
|
+
|
|
256
|
+
/**
|
|
257
|
+
* 开关状态探测:任一注入条目的文本与**字符串译本**逐字相等即视为已应用。
|
|
258
|
+
* 只探测字符串译本(函数译本无法从译文反推),而应用时所有命中行都会写入、
|
|
259
|
+
* 字符串译本必然存在 —— 足以作为探针。混合状态(用户手动还原了个别段)仍算
|
|
260
|
+
* 开启,关闭方向会整体回归英文。
|
|
261
|
+
*/
|
|
262
|
+
export function zhApplied(cfg, zhMap) {
|
|
263
|
+
for (const item of cfg?.inject ?? []) {
|
|
264
|
+
if (item === null || typeof item !== 'object' || typeof item.name !== 'string') continue
|
|
265
|
+
const zh = zhMap?.[item.name]
|
|
266
|
+
if (typeof zh === 'string' && zh !== '' && item.text === zh) return true
|
|
267
|
+
}
|
|
268
|
+
return false
|
|
129
269
|
}
|
package/lib/store.js
CHANGED
|
@@ -1,124 +1,124 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* 插件自有配置存储 —— `~/.dsh/prompt-customizer/config.yaml`。
|
|
3
|
-
*
|
|
4
|
-
* 背景:宿主 SettingsProvider 把所有插件命名空间都存在主文档
|
|
5
|
-
* (settings.yaml)里,插件无法选择存储位置;本插件改为自带文件存储,
|
|
6
|
-
* 让主文档不再被本插件的配置膨胀。
|
|
7
|
-
*
|
|
8
|
-
* 语义:
|
|
9
|
-
* - 新文件是唯一权威(读写都走这里)。
|
|
10
|
-
* - 懒加载:每次读取做 stat,mtime 变了才重新解析——外部手工编辑在下次
|
|
11
|
-
* 读取时自然生效,不需要 fs.watch。
|
|
12
|
-
* - 原子写:先写同目录临时文件再 rename。
|
|
13
|
-
* - last-good:文件损坏或 schema 校验失败时,沿用上一次合法值并告警一次,
|
|
14
|
-
* 绝不让一个坏文件拖垮装配瀑布流。
|
|
15
|
-
*/
|
|
16
|
-
|
|
17
|
-
import fs from 'node:fs'
|
|
18
|
-
import path from 'node:path'
|
|
19
|
-
import { parse, stringify } from 'yaml'
|
|
20
|
-
|
|
21
|
-
/** 新 yml 文件的头部注释(让手工编辑者知道这是什么)。 */
|
|
22
|
-
const HEADER = '# dsh-prompt-customizer 配置(唯一权威)。\n' +
|
|
23
|
-
'# 手工编辑即时生效(下次读取时);删除本文件后重启会从旧版 settings.yaml 迁移。\n'
|
|
24
|
-
|
|
25
|
-
/** 读主文档(旧版 settings.yaml)里本插件的旧段;主文档缺失或段不存在返回 undefined。 */
|
|
26
|
-
export function readLegacySection(masterPath, ns) {
|
|
27
|
-
if (!masterPath) return undefined
|
|
28
|
-
let doc
|
|
29
|
-
try {
|
|
30
|
-
doc = parse(fs.readFileSync(masterPath, 'utf8'))
|
|
31
|
-
} catch {
|
|
32
|
-
return undefined
|
|
33
|
-
}
|
|
34
|
-
const section = doc?.[ns]
|
|
35
|
-
return section !== null && typeof section === 'object' && !Array.isArray(section) && Object.keys(section).length > 0
|
|
36
|
-
? section
|
|
37
|
-
: undefined
|
|
38
|
-
}
|
|
39
|
-
|
|
40
|
-
/** 创建一个配置存储实例。schema 用于在读取时补默认值并校验;header 可覆盖
|
|
41
|
-
* 文件头注释(派生缓存类文件需要说明自己不是配置)。 */
|
|
42
|
-
export function createConfigStore({ file, schema, warn, header = HEADER } = {}) {
|
|
43
|
-
if (!file) throw new TypeError('createConfigStore: file is required')
|
|
44
|
-
/** { stamp, raw, resolved, error } — stamp 为 undefined 表示文件不存在。 */
|
|
45
|
-
let cache
|
|
46
|
-
let warned = false
|
|
47
|
-
const warnOnce = (message) => {
|
|
48
|
-
if (warned) return
|
|
49
|
-
warned = true
|
|
50
|
-
try { warn?.(message) } catch { /* logger 缺席只是不再告警 */ }
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
/** 用 schema 解析(补默认值 + 校验);失败返回 { value: null, error }。 */
|
|
54
|
-
const resolve = (raw) => {
|
|
55
|
-
if (schema === undefined) return { value: raw ?? {}, error: undefined }
|
|
56
|
-
try { return { value: schema(raw ?? {}), error: undefined } } catch (error) { return { value: null, error } }
|
|
57
|
-
}
|
|
58
|
-
|
|
59
|
-
/** stat 驱动的懒加载;返回完整缓存条目。 */
|
|
60
|
-
const load = () => {
|
|
61
|
-
let stamp
|
|
62
|
-
try { stamp = fs.statSync(file).mtimeMs } catch { stamp = undefined }
|
|
63
|
-
if (cache && cache.stamp === stamp) return cache
|
|
64
|
-
if (stamp === undefined) {
|
|
65
|
-
cache = { stamp, raw: undefined, ...resolve(undefined) }
|
|
66
|
-
return cache
|
|
67
|
-
}
|
|
68
|
-
let raw
|
|
69
|
-
let error
|
|
70
|
-
try {
|
|
71
|
-
raw = parse(fs.readFileSync(file, 'utf8'))
|
|
72
|
-
if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
|
|
73
|
-
raw = undefined
|
|
74
|
-
error = new Error('config.yaml 的顶层必须是映射')
|
|
75
|
-
}
|
|
76
|
-
} catch (e) {
|
|
77
|
-
raw = undefined
|
|
78
|
-
error = e
|
|
79
|
-
}
|
|
80
|
-
const r = raw === undefined ? { value: null, error } : resolve(raw)
|
|
81
|
-
// raw 保留磁盘上的真实解析结果(即使 schema 失败)——写合并不应静默丢字段。
|
|
82
|
-
cache = { stamp, raw, ...r }
|
|
83
|
-
// 任何一次成功解析(含写入后的校验)都刷新 last-good。
|
|
84
|
-
if (r.value !== null) lastGood = r.value
|
|
85
|
-
return cache
|
|
86
|
-
}
|
|
87
|
-
|
|
88
|
-
/** 上一次 schema 校验通过的解析结果(坏文件时的 last-good 回落)。 */
|
|
89
|
-
let lastGood
|
|
90
|
-
|
|
91
|
-
return {
|
|
92
|
-
/** 当前存储的原始用户段(未补默认值);无文件时 undefined。 */
|
|
93
|
-
raw() {
|
|
94
|
-
return load().raw
|
|
95
|
-
},
|
|
96
|
-
|
|
97
|
-
/** 解析后的生效配置(默认值已补;坏文件回落 last-good,再回落纯默认值)。 */
|
|
98
|
-
readResolved() {
|
|
99
|
-
const entry = load()
|
|
100
|
-
if (entry.value !== null) return entry.value
|
|
101
|
-
warnOnce(`prompt-customizer: 配置文件不可用,回落到最近一次合法配置:${String(entry.error && entry.error.message ? entry.error.message : entry.error)}`)
|
|
102
|
-
return lastGood ?? resolve(undefined).value
|
|
103
|
-
},
|
|
104
|
-
|
|
105
|
-
/** 原子写入一个完整用户段;写入后立刻刷新缓存。 */
|
|
106
|
-
writeSection(section) {
|
|
107
|
-
fs.mkdirSync(path.dirname(file), { recursive: true })
|
|
108
|
-
const tmp = `${file}.${process.pid}.tmp`
|
|
109
|
-
fs.writeFileSync(tmp, header + stringify(section ?? {}))
|
|
110
|
-
fs.renameSync(tmp, file)
|
|
111
|
-
cache = undefined
|
|
112
|
-
return load()
|
|
113
|
-
},
|
|
114
|
-
|
|
115
|
-
/** 写单个字段(值 undefined 表示删除);基于当前权威段合并。 */
|
|
116
|
-
setField(field, value) {
|
|
117
|
-
const base = this.raw()
|
|
118
|
-
const section = { ...(base ?? {}) }
|
|
119
|
-
if (value === undefined) delete section[field]
|
|
120
|
-
else section[field] = value
|
|
121
|
-
return this.writeSection(section)
|
|
122
|
-
},
|
|
123
|
-
}
|
|
124
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* 插件自有配置存储 —— `~/.dsh/prompt-customizer/config.yaml`。
|
|
3
|
+
*
|
|
4
|
+
* 背景:宿主 SettingsProvider 把所有插件命名空间都存在主文档
|
|
5
|
+
* (settings.yaml)里,插件无法选择存储位置;本插件改为自带文件存储,
|
|
6
|
+
* 让主文档不再被本插件的配置膨胀。
|
|
7
|
+
*
|
|
8
|
+
* 语义:
|
|
9
|
+
* - 新文件是唯一权威(读写都走这里)。
|
|
10
|
+
* - 懒加载:每次读取做 stat,mtime 变了才重新解析——外部手工编辑在下次
|
|
11
|
+
* 读取时自然生效,不需要 fs.watch。
|
|
12
|
+
* - 原子写:先写同目录临时文件再 rename。
|
|
13
|
+
* - last-good:文件损坏或 schema 校验失败时,沿用上一次合法值并告警一次,
|
|
14
|
+
* 绝不让一个坏文件拖垮装配瀑布流。
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
import fs from 'node:fs'
|
|
18
|
+
import path from 'node:path'
|
|
19
|
+
import { parse, stringify } from 'yaml'
|
|
20
|
+
|
|
21
|
+
/** 新 yml 文件的头部注释(让手工编辑者知道这是什么)。 */
|
|
22
|
+
const HEADER = '# dsh-prompt-customizer 配置(唯一权威)。\n' +
|
|
23
|
+
'# 手工编辑即时生效(下次读取时);删除本文件后重启会从旧版 settings.yaml 迁移。\n'
|
|
24
|
+
|
|
25
|
+
/** 读主文档(旧版 settings.yaml)里本插件的旧段;主文档缺失或段不存在返回 undefined。 */
|
|
26
|
+
export function readLegacySection(masterPath, ns) {
|
|
27
|
+
if (!masterPath) return undefined
|
|
28
|
+
let doc
|
|
29
|
+
try {
|
|
30
|
+
doc = parse(fs.readFileSync(masterPath, 'utf8'))
|
|
31
|
+
} catch {
|
|
32
|
+
return undefined
|
|
33
|
+
}
|
|
34
|
+
const section = doc?.[ns]
|
|
35
|
+
return section !== null && typeof section === 'object' && !Array.isArray(section) && Object.keys(section).length > 0
|
|
36
|
+
? section
|
|
37
|
+
: undefined
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** 创建一个配置存储实例。schema 用于在读取时补默认值并校验;header 可覆盖
|
|
41
|
+
* 文件头注释(派生缓存类文件需要说明自己不是配置)。 */
|
|
42
|
+
export function createConfigStore({ file, schema, warn, header = HEADER } = {}) {
|
|
43
|
+
if (!file) throw new TypeError('createConfigStore: file is required')
|
|
44
|
+
/** { stamp, raw, resolved, error } — stamp 为 undefined 表示文件不存在。 */
|
|
45
|
+
let cache
|
|
46
|
+
let warned = false
|
|
47
|
+
const warnOnce = (message) => {
|
|
48
|
+
if (warned) return
|
|
49
|
+
warned = true
|
|
50
|
+
try { warn?.(message) } catch { /* logger 缺席只是不再告警 */ }
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
/** 用 schema 解析(补默认值 + 校验);失败返回 { value: null, error }。 */
|
|
54
|
+
const resolve = (raw) => {
|
|
55
|
+
if (schema === undefined) return { value: raw ?? {}, error: undefined }
|
|
56
|
+
try { return { value: schema(raw ?? {}), error: undefined } } catch (error) { return { value: null, error } }
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** stat 驱动的懒加载;返回完整缓存条目。 */
|
|
60
|
+
const load = () => {
|
|
61
|
+
let stamp
|
|
62
|
+
try { stamp = fs.statSync(file).mtimeMs } catch { stamp = undefined }
|
|
63
|
+
if (cache && cache.stamp === stamp) return cache
|
|
64
|
+
if (stamp === undefined) {
|
|
65
|
+
cache = { stamp, raw: undefined, ...resolve(undefined) }
|
|
66
|
+
return cache
|
|
67
|
+
}
|
|
68
|
+
let raw
|
|
69
|
+
let error
|
|
70
|
+
try {
|
|
71
|
+
raw = parse(fs.readFileSync(file, 'utf8'))
|
|
72
|
+
if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
|
|
73
|
+
raw = undefined
|
|
74
|
+
error = new Error('config.yaml 的顶层必须是映射')
|
|
75
|
+
}
|
|
76
|
+
} catch (e) {
|
|
77
|
+
raw = undefined
|
|
78
|
+
error = e
|
|
79
|
+
}
|
|
80
|
+
const r = raw === undefined ? { value: null, error } : resolve(raw)
|
|
81
|
+
// raw 保留磁盘上的真实解析结果(即使 schema 失败)——写合并不应静默丢字段。
|
|
82
|
+
cache = { stamp, raw, ...r }
|
|
83
|
+
// 任何一次成功解析(含写入后的校验)都刷新 last-good。
|
|
84
|
+
if (r.value !== null) lastGood = r.value
|
|
85
|
+
return cache
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/** 上一次 schema 校验通过的解析结果(坏文件时的 last-good 回落)。 */
|
|
89
|
+
let lastGood
|
|
90
|
+
|
|
91
|
+
return {
|
|
92
|
+
/** 当前存储的原始用户段(未补默认值);无文件时 undefined。 */
|
|
93
|
+
raw() {
|
|
94
|
+
return load().raw
|
|
95
|
+
},
|
|
96
|
+
|
|
97
|
+
/** 解析后的生效配置(默认值已补;坏文件回落 last-good,再回落纯默认值)。 */
|
|
98
|
+
readResolved() {
|
|
99
|
+
const entry = load()
|
|
100
|
+
if (entry.value !== null) return entry.value
|
|
101
|
+
warnOnce(`prompt-customizer: 配置文件不可用,回落到最近一次合法配置:${String(entry.error && entry.error.message ? entry.error.message : entry.error)}`)
|
|
102
|
+
return lastGood ?? resolve(undefined).value
|
|
103
|
+
},
|
|
104
|
+
|
|
105
|
+
/** 原子写入一个完整用户段;写入后立刻刷新缓存。 */
|
|
106
|
+
writeSection(section) {
|
|
107
|
+
fs.mkdirSync(path.dirname(file), { recursive: true })
|
|
108
|
+
const tmp = `${file}.${process.pid}.tmp`
|
|
109
|
+
fs.writeFileSync(tmp, header + stringify(section ?? {}))
|
|
110
|
+
fs.renameSync(tmp, file)
|
|
111
|
+
cache = undefined
|
|
112
|
+
return load()
|
|
113
|
+
},
|
|
114
|
+
|
|
115
|
+
/** 写单个字段(值 undefined 表示删除);基于当前权威段合并。 */
|
|
116
|
+
setField(field, value) {
|
|
117
|
+
const base = this.raw()
|
|
118
|
+
const section = { ...(base ?? {}) }
|
|
119
|
+
if (value === undefined) delete section[field]
|
|
120
|
+
else section[field] = value
|
|
121
|
+
return this.writeSection(section)
|
|
122
|
+
},
|
|
123
|
+
}
|
|
124
|
+
}
|