✨ feat(vscode): 七份提示词统一走 Handlebars，头脑风暴三档合一
- 模板引擎换成 Handlebars（noEscape，提示词是纯文本不能被转义），单花括号写法彻底退场
- brainstorm-continue / brainstorm-continue-prototype 两份并进 brainstorm.md，
用 {{#if issueNumber}} 分新建 / 续聊，续聊里用 {{#if prototypeFile}} 嵌原型段落，
设置面板对应的两个 textarea 一并删掉
- 模板上下文 = 工单 state JSON 全量字段 + issueNumber / userRequest / nonce /
planFile / prNumber / prRef，以后模板想用新字段不用改扩展代码
- 各会话入口共用一条 state 读取路径，读失败只记 warn 按空状态继续，不拦开会话
- 升级后首次启动把存量自定义提示词迁到双花括号并合并成一份，改写前把
settings.json 备份成 settings.json.bak-<时间戳>，迁移动作全写日志
- 装 handlebars 时给 vsce 传递依赖的老 semver 加 trustPolicyExclude 豁免，
否则 no-downgrade 策略卡住整个装包
Claude-Session: https://claude.ai/code/session_01Kgmb1LvrPmFX3NoUDB4zZC
This commit is contained in:
cruldra committed
1 parent
efeac8c978
commit
7bac5c8b03
28 files changed
+853
-424
No files matched your search
@@ -0,0 +1,190 @@
|
||||
/**
|
||||
* 存量自定义提示词的一次性迁移：单花括号 → Handlebars 双花括号，
|
||||
* 并把「续聊」「续聊·原型段落」两份模板并进头脑风暴模板的条件分支里。
|
||||
*
|
||||
* 纯函数，不碰文件系统 / vscode——落盘与日志由 `store.ts` 的
|
||||
* `migratePromptTemplates` 负责。
|
||||
*/
|
||||
|
||||
/** 设置里的模板引擎版本；低于它就跑一次迁移。 */
|
||||
export const PROMPT_TEMPLATE_VERSION = 2
|
||||
|
||||
/**
|
||||
* 只重写这些名字的占位符。正文里其他花括号内容（比如 shell 的 `${x}`、
|
||||
* 示例 JSON）保持原样，免得迁移把用户写的东西改坏。
|
||||
*/
|
||||
const KNOWN_PLACEHOLDERS = [
|
||||
'userRequest',
|
||||
'nonce',
|
||||
'issueNumber',
|
||||
'planFile',
|
||||
'prNumber',
|
||||
'prRef',
|
||||
'prototypeFile',
|
||||
'prototypeSessionId',
|
||||
'prototypeRef',
|
||||
] as const
|
||||
|
||||
/** 迁移后仍然存在的模板字段。 */
|
||||
const PROMPT_FIELDS = [
|
||||
'brainstormPrompt',
|
||||
'implementPlanPrompt',
|
||||
'reviewPrompt',
|
||||
'testPrompt',
|
||||
'prototypePrompt',
|
||||
] as const
|
||||
|
||||
/** 已经并进 brainstormPrompt、不再单独存在的字段。 */
|
||||
const MERGED_FIELDS = ['brainstormContinuePrompt', 'prototypeRefPrompt'] as const
|
||||
|
||||
export interface MigrationNote {
|
||||
level: 'info' | 'warn'
|
||||
message: string
|
||||
}
|
||||
|
||||
export interface PromptMigrationPlan {
|
||||
/** 要写回的完整 blob；null = 没什么可迁的，不写盘。 */
|
||||
blob: Record<string, unknown> | null
|
||||
notes: MigrationNote[]
|
||||
}
|
||||
|
||||
/** `{foo}` → `{{foo}}`，只认已知占位符；已经是 `{{foo}}` 的不动。 */
|
||||
export function upgradePlaceholders(text: string): string {
|
||||
const names = KNOWN_PLACEHOLDERS.join('|')
|
||||
return text.replace(new RegExp(`(?<!\\{)\\{(${names})\\}(?!\\})`, 'g'), '{{$1}}')
|
||||
}
|
||||
|
||||
/**
|
||||
* 把含 `{{name}}` 的整行包进 `{{#if name}}`。
|
||||
*
|
||||
* 旧引擎对原型段落的做法是「占位符取值为空就删掉整行」，只有原型会话 id
|
||||
* 会真的为空；迁移后用条件块把这条语义原样搬过来。
|
||||
*/
|
||||
export function guardLinesWith(text: string, name: string): string {
|
||||
const token = `{{${name}}}`
|
||||
return text
|
||||
.split('\n')
|
||||
.map(line => line.includes(token) ? `{{#if ${name}}}\n${line}\n{{/if}}` : line)
|
||||
.join('\n')
|
||||
}
|
||||
|
||||
/**
|
||||
* 从模板里切出 `{{#if cond}} … {{else}} … {{/if}}` 这一整块的两个分支。
|
||||
*
|
||||
* 迁移时要拿内置默认模板的「续聊」「新建工单」分支去补用户没存过的那一半，
|
||||
* 所以得能把合并后的默认模板再拆开。按 `{{#if}}` / `{{/if}}` 记嵌套层数，
|
||||
* 只认第一层的 `{{else}}`，嵌在里面的原型条件块不会被误当成分界。
|
||||
*/
|
||||
export function splitIfBlock(tpl: string, cond: string): { then: string, else: string } | null {
|
||||
const lines = tpl.split('\n')
|
||||
const start = lines.findIndex(line => line.trim() === `{{#if ${cond}}}`)
|
||||
if (start < 0)
|
||||
return null
|
||||
let depth = 1
|
||||
let elseAt = -1
|
||||
for (let i = start + 1; i < lines.length; i++) {
|
||||
const line = lines[i]
|
||||
if (depth === 1 && line.trim() === '{{else}}')
|
||||
elseAt = i
|
||||
depth += (line.match(/\{\{#(?:if|unless)\s/g) ?? []).length
|
||||
depth -= (line.match(/\{\{\/(?:if|unless)\}\}/g) ?? []).length
|
||||
if (depth === 0) {
|
||||
return {
|
||||
then: lines.slice(start + 1, elseAt < 0 ? i : elseAt).join('\n').trim(),
|
||||
else: elseAt < 0 ? '' : lines.slice(elseAt + 1, i).join('\n').trim(),
|
||||
}
|
||||
}
|
||||
}
|
||||
return null
|
||||
}
|
||||
|
||||
/**
|
||||
* 三份存量模板拼成一份：有工单号走续聊分支，没有走新建工单分支；
|
||||
* 原型段落嵌在续聊分支里原来 `{{prototypeRef}}` 的位置（模板里没这个
|
||||
* 占位符就接在末尾）。
|
||||
*/
|
||||
export function composeBrainstormTemplate(parts: { newIssue: string, cont: string, proto: string }): string {
|
||||
const proto = parts.proto.trim()
|
||||
const block = proto ? `{{#if prototypeFile}}\n${guardLinesWith(proto, 'prototypeSessionId')}\n{{/if}}` : ''
|
||||
let cont = parts.cont
|
||||
if (cont.includes('{{prototypeRef}}'))
|
||||
cont = cont.split('{{prototypeRef}}').join(block)
|
||||
else if (block)
|
||||
cont = `${cont.trimEnd()}\n\n${block}`
|
||||
return `{{#if issueNumber}}\n${cont.trim()}\n{{else}}\n${parts.newIssue.trim()}\n{{/if}}\n`
|
||||
}
|
||||
|
||||
function storedText(stored: Record<string, unknown>, key: string): string {
|
||||
const v = stored[key]
|
||||
return typeof v === 'string' ? v : ''
|
||||
}
|
||||
|
||||
/**
|
||||
* 算出迁移后的 settings blob。`defaultBrainstorm` 是内置的合并版模板，用来补
|
||||
* 用户没存过的那一半分支——比如只改过「新建工单」提示词的人，续聊分支直接用
|
||||
* 内置默认，不然合并出来的模板会有一路是空的。
|
||||
*/
|
||||
export function planPromptMigration(
|
||||
stored: Record<string, unknown>,
|
||||
defaultBrainstorm: string,
|
||||
): PromptMigrationPlan {
|
||||
const version = stored.promptTemplateVersion
|
||||
if (typeof version === 'number' && version >= PROMPT_TEMPLATE_VERSION)
|
||||
return { blob: null, notes: [] }
|
||||
|
||||
const next: Record<string, unknown> = { ...stored }
|
||||
const notes: MigrationNote[] = []
|
||||
let changed = false
|
||||
|
||||
for (const field of [...PROMPT_FIELDS, ...MERGED_FIELDS]) {
|
||||
const before = storedText(stored, field)
|
||||
if (!before)
|
||||
continue
|
||||
const after = upgradePlaceholders(before)
|
||||
if (after !== before) {
|
||||
next[field] = after
|
||||
changed = true
|
||||
notes.push({ level: 'info', message: `${field}：占位符已改写成 {{双花括号}}` })
|
||||
}
|
||||
}
|
||||
|
||||
const storedNewIssue = storedText(next, 'brainstormPrompt')
|
||||
const storedCont = storedText(next, 'brainstormContinuePrompt')
|
||||
const storedProto = storedText(next, 'prototypeRefPrompt')
|
||||
if (storedNewIssue || storedCont || storedProto) {
|
||||
const branches = splitIfBlock(defaultBrainstorm, 'issueNumber')
|
||||
if (!branches) {
|
||||
notes.push({
|
||||
level: 'warn',
|
||||
message: '内置头脑风暴模板拆不出条件分支，存量的续聊 / 原型段落没能并进来，原文见备份文件',
|
||||
})
|
||||
}
|
||||
else {
|
||||
// 用户没存过续聊时，默认续聊分支里本来就带着原型段落，别再插一遍。
|
||||
const proto = storedProto || (storedCont ? splitIfBlock(branches.then, 'prototypeFile')?.then ?? '' : '')
|
||||
next.brainstormPrompt = composeBrainstormTemplate({
|
||||
newIssue: storedNewIssue || branches.else,
|
||||
cont: storedCont || branches.then,
|
||||
proto,
|
||||
})
|
||||
changed = true
|
||||
notes.push({
|
||||
level: 'info',
|
||||
message: `头脑风暴提示词已合并成一份条件模板（新建=${storedNewIssue ? '你的' : '内置'} / 续聊=${storedCont ? '你的' : '内置'} / 原型段落=${storedProto ? '你的' : '内置'}）`,
|
||||
})
|
||||
}
|
||||
}
|
||||
|
||||
for (const field of MERGED_FIELDS) {
|
||||
if (field in next) {
|
||||
delete next[field]
|
||||
changed = true
|
||||
}
|
||||
}
|
||||
|
||||
if (!changed)
|
||||
return { blob: null, notes: [] }
|
||||
|
||||
next.promptTemplateVersion = PROMPT_TEMPLATE_VERSION
|
||||
return { blob: next, notes }
|
||||
}
|
||||
Reference in new issue
Block a user