dsh-dev-plan-presets 0.0.0-stage → 0.4.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 -0
- package/README.md +348 -2
- package/client.js +1634 -0
- package/cordis.patch.yml +24 -0
- package/detail.md +200 -0
- package/docs/flow-redesign.md +403 -0
- package/docs/v0.4-perf-optimization-plan.md +349 -0
- package/guard.js +547 -0
- package/icon.svg +12 -0
- package/index.js +791 -0
- package/locale/en.json +7 -0
- package/locale/zh.json +7 -0
- package/package.json +53 -4
- package/preset.js +471 -0
- package/scripts/test-harness.mjs +290 -0
- package/scripts/verify-presets.mjs +1854 -0
- package/settings.js +208 -0
- package/test/plugin.test.mjs +1912 -0
package/settings.js
ADDED
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 插件设置的唯一真源。
|
|
3
|
+
*
|
|
4
|
+
* 这里同时承担三个职责,避免 UI、preset 定义、模型守门各拿一份默认值漂移:
|
|
5
|
+
* 1. DEFAULT_SETTINGS:所有字段的默认值(standard + pin,零第三方依赖);
|
|
6
|
+
* 2. normalizeSettings():把任意来源的 raw config 收敛成完整、类型正确的设置;
|
|
7
|
+
* 3. Config:Cordis 可用的 Standard Schema(`~standard` 协议),
|
|
8
|
+
* 在激活 / 配置写回时校验候选值,非法值直接拒绝,不做静默纠正。
|
|
9
|
+
*
|
|
10
|
+
* 注意:本文件不 import 任何 @deepseek-ai/* 包。插件以 link 方式安装时,
|
|
11
|
+
* 宿主包不保证能从插件目录解析到;Config 手写 Standard Schema 即可,
|
|
12
|
+
* 不需要 @deepseek-ai/schemastery 依赖。
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* 施工子代理 preset 不再有固定枚举:任何宿主已注册的 preset id 都是候选值。
|
|
17
|
+
* 这里不定义白名单,可用性由 Host 对照 agentPresets 目录在运行期判断。
|
|
18
|
+
*/
|
|
19
|
+
|
|
20
|
+
/** 模型守门模式。off = 完全不管;audit = 只记录;pin = 钉住并可按设置打断。 */
|
|
21
|
+
export const GUARD_MODES = Object.freeze(['off', 'audit', 'pin'])
|
|
22
|
+
|
|
23
|
+
/** 主窗工具权限档位。none = 纯规划派工;readonly = 定点只读核验;ask-edit = 经用户同意后允许局部微改(永不挂 Shell)。 */
|
|
24
|
+
export const MAIN_TOOL_MODES = Object.freeze(['none', 'readonly', 'ask-edit'])
|
|
25
|
+
|
|
26
|
+
/** 主窗连续实操步数软提醒阈值范围(仅在 mainToolMode !== 'none' 时生效)。 */
|
|
27
|
+
export const MIN_MAIN_STEP_WARN_THRESHOLD = 2
|
|
28
|
+
export const MAX_MAIN_STEP_WARN_THRESHOLD = 30
|
|
29
|
+
|
|
30
|
+
/** 默认路由:与 0.2.0 及旧 dsh-subagent-model-pin 保持一致。 */
|
|
31
|
+
export const DEFAULT_CHILD_PROVIDER = 'dsh-opencode-go'
|
|
32
|
+
export const DEFAULT_CHILD_MODEL = 'deepseek-v4.1-flash'
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* 完整默认设置。
|
|
36
|
+
* 默认 standard 且 modelGuardMode=pin:不要求宿主安装深度 PTC,同时保留模型防错。
|
|
37
|
+
*/
|
|
38
|
+
export const DEFAULT_SETTINGS = Object.freeze({
|
|
39
|
+
/** 施工子代理 preset id:任意宿主已注册 preset;standard(默认,零额外依赖)始终可用。 */
|
|
40
|
+
developMode: 'standard',
|
|
41
|
+
/** 四个委派工具共用的子代理 provider。 */
|
|
42
|
+
childProvider: DEFAULT_CHILD_PROVIDER,
|
|
43
|
+
/** 四个委派工具共用的子代理 model。 */
|
|
44
|
+
childModel: DEFAULT_CHILD_MODEL,
|
|
45
|
+
/** 可选 reasoningEffort;空串表示省略该字段。 */
|
|
46
|
+
childReasoningEffort: '',
|
|
47
|
+
/** off / audit / pin。 */
|
|
48
|
+
modelGuardMode: 'pin',
|
|
49
|
+
/** pin 模式下发现越界时,是否 reject 当前 step、cancel 子代理并通知父会话。 */
|
|
50
|
+
killOnViolation: true,
|
|
51
|
+
/** 是否尊重子代理创建时的显式非父级路由(默认 false:一律钉住)。 */
|
|
52
|
+
honorExplicit: false,
|
|
53
|
+
/** 是否写结构化审计日志(只含路由与事件,不含任何凭据)。 */
|
|
54
|
+
audit: true,
|
|
55
|
+
/**
|
|
56
|
+
* false(默认)只管理 dev-plan 父会话派出的子代理;true 恢复旧的全局子代理守门。
|
|
57
|
+
* 主会话始终不守门。
|
|
58
|
+
*/
|
|
59
|
+
guardAllSubagents: false,
|
|
60
|
+
/** 主窗工具权限:ask-edit(默认,小范围只读+经同意局部微改,永不挂 Shell)/ readonly / none。 */
|
|
61
|
+
mainToolMode: 'ask-edit',
|
|
62
|
+
/** mainToolMode !== 'none' 时,主会话单轮连续步数超过该阈值后温和提醒转交子代理。 */
|
|
63
|
+
mainStepWarnThreshold: 6,
|
|
64
|
+
})
|
|
65
|
+
|
|
66
|
+
const isPlainObject = (value) =>
|
|
67
|
+
typeof value === 'object' && value !== null && !Array.isArray(value)
|
|
68
|
+
|
|
69
|
+
const nonEmptyString = (value) =>
|
|
70
|
+
typeof value === 'string' && value.trim().length > 0 ? value.trim() : undefined
|
|
71
|
+
|
|
72
|
+
/**
|
|
73
|
+
* 把任意 raw config 收敛成完整设置;非法枚举/空值回落到默认值。
|
|
74
|
+
* 该函数用于运行期容错(例如旧版本配置);需要拒绝非法输入时先用 validateSettings()。
|
|
75
|
+
* @param {unknown} raw
|
|
76
|
+
* @returns {typeof DEFAULT_SETTINGS}
|
|
77
|
+
*/
|
|
78
|
+
export function normalizeSettings(raw) {
|
|
79
|
+
const input = isPlainObject(raw) ? raw : {}
|
|
80
|
+
const developMode = nonEmptyString(input.developMode)
|
|
81
|
+
return {
|
|
82
|
+
// 保留用户保存的原值(含后来失效的 preset id),可用性在运行期判断,不静默改写配置。
|
|
83
|
+
developMode: developMode === undefined ? DEFAULT_SETTINGS.developMode : developMode,
|
|
84
|
+
childProvider: nonEmptyString(input.childProvider) ?? DEFAULT_SETTINGS.childProvider,
|
|
85
|
+
childModel: nonEmptyString(input.childModel) ?? DEFAULT_SETTINGS.childModel,
|
|
86
|
+
childReasoningEffort:
|
|
87
|
+
typeof input.childReasoningEffort === 'string' ? input.childReasoningEffort.trim() : '',
|
|
88
|
+
modelGuardMode: GUARD_MODES.includes(input.modelGuardMode)
|
|
89
|
+
? input.modelGuardMode
|
|
90
|
+
: DEFAULT_SETTINGS.modelGuardMode,
|
|
91
|
+
killOnViolation:
|
|
92
|
+
input.killOnViolation === undefined
|
|
93
|
+
? DEFAULT_SETTINGS.killOnViolation
|
|
94
|
+
: input.killOnViolation === true,
|
|
95
|
+
honorExplicit:
|
|
96
|
+
input.honorExplicit === undefined
|
|
97
|
+
? DEFAULT_SETTINGS.honorExplicit
|
|
98
|
+
: input.honorExplicit === true,
|
|
99
|
+
audit: input.audit === undefined ? DEFAULT_SETTINGS.audit : input.audit === true,
|
|
100
|
+
guardAllSubagents:
|
|
101
|
+
input.guardAllSubagents === undefined
|
|
102
|
+
? DEFAULT_SETTINGS.guardAllSubagents
|
|
103
|
+
: input.guardAllSubagents === true,
|
|
104
|
+
mainToolMode: MAIN_TOOL_MODES.includes(input.mainToolMode)
|
|
105
|
+
? input.mainToolMode
|
|
106
|
+
: DEFAULT_SETTINGS.mainToolMode,
|
|
107
|
+
mainStepWarnThreshold:
|
|
108
|
+
Number.isInteger(input.mainStepWarnThreshold) &&
|
|
109
|
+
input.mainStepWarnThreshold >= MIN_MAIN_STEP_WARN_THRESHOLD &&
|
|
110
|
+
input.mainStepWarnThreshold <= MAX_MAIN_STEP_WARN_THRESHOLD
|
|
111
|
+
? input.mainStepWarnThreshold
|
|
112
|
+
: DEFAULT_SETTINGS.mainStepWarnThreshold,
|
|
113
|
+
}
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/**
|
|
117
|
+
* 严格校验:供 Config 使用,非法值返回 Standard Schema issues。
|
|
118
|
+
* @param {unknown} raw
|
|
119
|
+
* @returns {{ value: typeof DEFAULT_SETTINGS } | { issues: Array<{ message: string, path?: string[] }> }}
|
|
120
|
+
*/
|
|
121
|
+
export function validateSettings(raw) {
|
|
122
|
+
const input = isPlainObject(raw) ? raw : {}
|
|
123
|
+
const issues = []
|
|
124
|
+
const issue = (path, message) => issues.push({ message, path: [path] })
|
|
125
|
+
|
|
126
|
+
// 不再限制为两项:任何非空 preset id 都允许保存;Host 运行期对照真实目录决定是否回退。
|
|
127
|
+
if (input.developMode !== undefined && nonEmptyString(input.developMode) === undefined) {
|
|
128
|
+
issue('developMode', 'must be a non-empty preset id')
|
|
129
|
+
}
|
|
130
|
+
for (const field of ['childProvider', 'childModel']) {
|
|
131
|
+
if (input[field] !== undefined && nonEmptyString(input[field]) === undefined) {
|
|
132
|
+
issue(field, 'must be a non-empty string')
|
|
133
|
+
}
|
|
134
|
+
}
|
|
135
|
+
if (
|
|
136
|
+
input.childReasoningEffort !== undefined &&
|
|
137
|
+
input.childReasoningEffort !== null &&
|
|
138
|
+
typeof input.childReasoningEffort !== 'string'
|
|
139
|
+
) {
|
|
140
|
+
issue('childReasoningEffort', 'must be a string (empty string = provider default)')
|
|
141
|
+
}
|
|
142
|
+
if (input.modelGuardMode !== undefined && !GUARD_MODES.includes(input.modelGuardMode)) {
|
|
143
|
+
issue('modelGuardMode', `must be one of ${GUARD_MODES.join(', ')}`)
|
|
144
|
+
}
|
|
145
|
+
for (const field of ['killOnViolation', 'honorExplicit', 'audit', 'guardAllSubagents']) {
|
|
146
|
+
if (input[field] !== undefined && typeof input[field] !== 'boolean') {
|
|
147
|
+
issue(field, 'must be a boolean')
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
if (input.mainToolMode !== undefined && !MAIN_TOOL_MODES.includes(input.mainToolMode)) {
|
|
151
|
+
issue('mainToolMode', `must be one of ${MAIN_TOOL_MODES.join(', ')}`)
|
|
152
|
+
}
|
|
153
|
+
if (
|
|
154
|
+
input.mainStepWarnThreshold !== undefined &&
|
|
155
|
+
(!Number.isInteger(input.mainStepWarnThreshold) ||
|
|
156
|
+
input.mainStepWarnThreshold < MIN_MAIN_STEP_WARN_THRESHOLD ||
|
|
157
|
+
input.mainStepWarnThreshold > MAX_MAIN_STEP_WARN_THRESHOLD)
|
|
158
|
+
) {
|
|
159
|
+
issue(
|
|
160
|
+
'mainStepWarnThreshold',
|
|
161
|
+
`must be an integer between ${MIN_MAIN_STEP_WARN_THRESHOLD} and ${MAX_MAIN_STEP_WARN_THRESHOLD}`,
|
|
162
|
+
)
|
|
163
|
+
}
|
|
164
|
+
if (issues.length > 0) return { issues }
|
|
165
|
+
return { value: normalizeSettings(input) }
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* Cordis Standard Schema:激活与配置写回都会走这里。
|
|
170
|
+
* `simplify` 让 Loader 持久化时写入规范化后的普通对象。
|
|
171
|
+
*/
|
|
172
|
+
export const Config = {
|
|
173
|
+
'~standard': {
|
|
174
|
+
version: 1,
|
|
175
|
+
vendor: 'dsh-dev-plan-presets',
|
|
176
|
+
validate: validateSettings,
|
|
177
|
+
},
|
|
178
|
+
simplify: (value) => normalizeSettings(value),
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
/**
|
|
182
|
+
* 四个委派工具共用的 agentOptions。
|
|
183
|
+
* 空 childReasoningEffort 必须省略该键,而不是写空串,否则适配器可能拒绝。
|
|
184
|
+
* @param {typeof DEFAULT_SETTINGS} settings
|
|
185
|
+
* @returns {{ provider: string, model: string, reasoningEffort?: string }}
|
|
186
|
+
*/
|
|
187
|
+
export function routeOf(settings) {
|
|
188
|
+
const normalized = normalizeSettings(settings)
|
|
189
|
+
const route = { provider: normalized.childProvider, model: normalized.childModel }
|
|
190
|
+
if (normalized.childReasoningEffort.length > 0) {
|
|
191
|
+
route.reasoningEffort = normalized.childReasoningEffort
|
|
192
|
+
}
|
|
193
|
+
return route
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
/**
|
|
197
|
+
* 判断路由是否命中目标(用于模型守门)。
|
|
198
|
+
* 目标带 reasoningEffort 时必须一致;目标不带时不强求子代理 effort 为空,
|
|
199
|
+
* 因为适配器/父级可能解析出默认 effort,把它当成越界会误伤。
|
|
200
|
+
* @param {unknown} got
|
|
201
|
+
* @param {{ provider?: string, model?: string, reasoningEffort?: string }} want
|
|
202
|
+
*/
|
|
203
|
+
export function routeMatches(got, want) {
|
|
204
|
+
if (!got || typeof got !== 'object') return false
|
|
205
|
+
if (got.provider !== want.provider || got.model !== want.model) return false
|
|
206
|
+
if (want.reasoningEffort && got.reasoningEffort !== want.reasoningEffort) return false
|
|
207
|
+
return true
|
|
208
|
+
}
|