194 lines
8.1 KiB
JavaScript
194 lines
8.1 KiB
JavaScript
// 旧格式(v2/v3)→ 当前格式(v1)的纯转换:不做任何 IO,便于隔离单测。
|
||
//
|
||
// 旧版(DS Bot 时期)只有三个角色 lead / shangshu / gongbu,各绑定一个 Bot(真实存的是
|
||
// sessionId),项目还有 roomId、delivery、submissionSeq、maxReworks 等业务字段,以及
|
||
// 顶层 reviews / dispatches / reworks / artifacts / leases / events 六类记录。
|
||
// 新版固定十席,只认识项目与十席的会话/模型/说明。
|
||
//
|
||
// 迁移原则:
|
||
// 1. 能一一对应的直接搬:三角色 → lead / shangshu / gongbu 三席,Bot 的 sessionId 即会话 ID。
|
||
// 2. 不做任何猜测式绑定:其余七席保持 pending 空席,不生成替代会话。
|
||
// 3. 无法对应的角色、会话、模型与全部旧业务记录原样保存在 legacy 中,一条不丢。
|
||
// 4. leases 是运行期租约,只存档、不恢复为“运行中”。
|
||
// 5. 转换结果必须通过新版 validateState 才返回;否则视为转换失败,调用方不得写盘。
|
||
import { SEAT_IDS } from './roles.js'
|
||
import { STATE_VERSION, emptySeat, validateState, validModel } from './schema.js'
|
||
|
||
export const LEGACY_VERSIONS = Object.freeze([2, 3])
|
||
|
||
// 旧版角色 id 与新版席 id 同名,因此是一一对应的直搬。
|
||
const LEGACY_ROLE_TO_SEAT = Object.freeze({ lead: 'lead', shangshu: 'shangshu', gongbu: 'gongbu' })
|
||
|
||
// 旧项目里这些字段新版没有对应位置,全部收进 project.legacy。
|
||
const PROJECT_LEGACY_KEYS = Object.freeze([
|
||
'roomId', 'delivery', 'submissionSeq', 'maxReworks', 'schemaVersion', 'workDir',
|
||
])
|
||
|
||
// 顶层这些字段是新版自己的,其余未知字段收进 legacy.extras。
|
||
const TOP_KNOWN_KEYS = Object.freeze([
|
||
'version', 'seq', 'projects', 'reviews', 'dispatches', 'reworks', 'artifacts', 'leases', 'events',
|
||
])
|
||
|
||
function isObject(v) { return v !== null && typeof v === 'object' && !Array.isArray(v) }
|
||
function isStr(v) { return typeof v === 'string' && v.trim() !== '' }
|
||
|
||
function cleanModel(model) {
|
||
if (model === null || model === undefined || !validModel(model)) return null
|
||
const out = { provider: model.provider, model: model.model }
|
||
if (typeof model.reasoningEffort === 'string') out.reasoningEffort = model.reasoningEffort
|
||
return out
|
||
}
|
||
|
||
export function isLegacyState(raw) {
|
||
return isObject(raw) && LEGACY_VERSIONS.includes(raw.version)
|
||
}
|
||
|
||
function fail(code, message) { return { ok: false, code, message } }
|
||
|
||
function pickProjectId(legacy, usedIds) {
|
||
// 优先沿用宿主工作区 ID:这样用户再次打开同一工作区时接上旧项目,而不是新建一个。
|
||
const preferred = []
|
||
if (isStr(legacy.workspaceId)) preferred.push(legacy.workspaceId)
|
||
if (isStr(legacy.id)) preferred.push(legacy.id)
|
||
for (const candidate of preferred) {
|
||
if (!usedIds.has(candidate)) return candidate
|
||
}
|
||
const base = preferred[0] ?? 'legacy-project'
|
||
let index = 2
|
||
while (usedIds.has(`${base}-${index}`)) index += 1
|
||
return `${base}-${index}`
|
||
}
|
||
|
||
function migrateProject(legacy, key, usedIds, fromVersion, now, warnings) {
|
||
if (!isObject(legacy)) return fail('sansheng/state-corrupt', `旧项目 ${key} 不是对象,无法迁移`)
|
||
const legacyId = isStr(legacy.id) ? legacy.id : key
|
||
if (isStr(legacy.id) && legacy.id !== key) {
|
||
// 旧数据里项目键与 id 不一致属于可疑数据,但不阻断:保留原值并在提示中说明。
|
||
warnings.push(`项目键 ${key} 与项目 id ${legacy.id} 不一致,已按 id 归档`)
|
||
}
|
||
|
||
const id = pickProjectId({ ...legacy, id: legacyId }, usedIds)
|
||
usedIds.add(id)
|
||
|
||
const seats = {}
|
||
for (const seatId of SEAT_IDS) seats[seatId] = emptySeat(seatId)
|
||
|
||
const unmappedBots = {}
|
||
const unmappedModels = {}
|
||
const bots = isObject(legacy.bots) ? legacy.bots : {}
|
||
const models = isObject(legacy.models) ? legacy.models : {}
|
||
|
||
for (const [role, rawSessionId] of Object.entries(bots)) {
|
||
const seatId = LEGACY_ROLE_TO_SEAT[role]
|
||
if (!seatId) { unmappedBots[role] = rawSessionId; continue }
|
||
if (!isStr(rawSessionId)) {
|
||
warnings.push(`项目 ${legacyId} 的 ${role} 没有有效会话 ID,该席保持未绑定`)
|
||
continue
|
||
}
|
||
const seat = seats[seatId]
|
||
seat.sessionId = rawSessionId
|
||
seat.plannedSessionId = rawSessionId
|
||
seat.status = 'bound'
|
||
seat.updatedAt = Number.isFinite(legacy.updatedAt) ? legacy.updatedAt : now
|
||
}
|
||
// 旧版三角色缺任何一个都提示,不代建会话。
|
||
for (const role of Object.keys(LEGACY_ROLE_TO_SEAT)) {
|
||
if (!isStr(bots[role])) warnings.push(`项目 ${legacyId} 缺少 ${role} 的旧会话,对应席保持未绑定`)
|
||
}
|
||
|
||
for (const [role, rawModel] of Object.entries(models)) {
|
||
const seatId = LEGACY_ROLE_TO_SEAT[role]
|
||
if (!seatId) { unmappedModels[role] = rawModel; continue }
|
||
if (rawModel === null || rawModel === undefined) continue
|
||
const model = cleanModel(rawModel)
|
||
if (model) seats[seatId].model = model
|
||
else {
|
||
unmappedModels[role] = rawModel
|
||
warnings.push(`项目 ${legacyId} 的 ${role} 模型格式无法识别,已原样保留;该席显示为未选择模型`)
|
||
}
|
||
}
|
||
|
||
const extras = {}
|
||
for (const [k, v] of Object.entries(legacy)) {
|
||
if (['id', 'name', 'workspaceId', 'workDir', 'path', 'bots', 'models', 'createdAt', 'updatedAt', ...PROJECT_LEGACY_KEYS].includes(k)) continue
|
||
extras[k] = v
|
||
}
|
||
|
||
return {
|
||
ok: true,
|
||
id,
|
||
project: {
|
||
id,
|
||
name: isStr(legacy.name) ? legacy.name : legacyId,
|
||
workspaceId: isStr(legacy.workspaceId) ? legacy.workspaceId : null,
|
||
path: isStr(legacy.workDir) ? legacy.workDir : (isStr(legacy.path) ? legacy.path : null),
|
||
status: 'pending',
|
||
seats,
|
||
revision: 0,
|
||
createdAt: Number.isFinite(legacy.createdAt) ? legacy.createdAt : now,
|
||
updatedAt: Number.isFinite(legacy.updatedAt) ? legacy.updatedAt : now,
|
||
legacy: {
|
||
fromVersion,
|
||
legacyId,
|
||
roomId: isStr(legacy.roomId) ? legacy.roomId : null,
|
||
delivery: isObject(legacy.delivery) ? legacy.delivery : null,
|
||
submissionSeq: Number.isFinite(legacy.submissionSeq) ? legacy.submissionSeq : 0,
|
||
maxReworks: Number.isFinite(legacy.maxReworks) ? legacy.maxReworks : null,
|
||
schemaVersion: Number.isFinite(legacy.schemaVersion) ? legacy.schemaVersion : fromVersion,
|
||
workDir: isStr(legacy.workDir) ? legacy.workDir : null,
|
||
unmappedBots,
|
||
unmappedModels,
|
||
extras,
|
||
},
|
||
},
|
||
}
|
||
}
|
||
|
||
export function migrateLegacyState(raw, { now = Date.now() } = {}) {
|
||
if (!isLegacyState(raw)) {
|
||
return fail('sansheng/state-unsupported', `状态文件格式不受支持(版本 ${String(raw?.version)}),可升级的旧格式为 2/3`)
|
||
}
|
||
if (!isObject(raw.projects)) return fail('sansheng/state-corrupt', '旧状态缺少 projects 对象,无法迁移')
|
||
|
||
const warnings = []
|
||
const projects = {}
|
||
const usedIds = new Set()
|
||
for (const [key, value] of Object.entries(raw.projects)) {
|
||
const result = migrateProject(value, key, usedIds, raw.version, now, warnings)
|
||
if (!result.ok) return result
|
||
projects[result.id] = result.project
|
||
}
|
||
|
||
const extras = {}
|
||
for (const [k, v] of Object.entries(raw)) {
|
||
if (!TOP_KNOWN_KEYS.includes(k)) extras[k] = v
|
||
}
|
||
|
||
const state = {
|
||
version: STATE_VERSION,
|
||
seq: Number.isFinite(raw.seq) ? raw.seq : 0,
|
||
projects,
|
||
legacy: {
|
||
fromVersion: raw.version,
|
||
migratedAt: now,
|
||
notes: warnings,
|
||
reviews: Array.isArray(raw.reviews) ? raw.reviews : [],
|
||
dispatches: Array.isArray(raw.dispatches) ? raw.dispatches : [],
|
||
reworks: Array.isArray(raw.reworks) ? raw.reworks : [],
|
||
artifacts: isObject(raw.artifacts) ? raw.artifacts : {},
|
||
events: Array.isArray(raw.events) ? raw.events : [],
|
||
// 运行期租约只存档;新版不读 leases,绝不能把它当成“正在运行”。
|
||
leases: {
|
||
restored: false,
|
||
note: '旧版 leases 仅存档,不恢复为运行中状态',
|
||
items: isObject(raw.leases) ? raw.leases : {},
|
||
},
|
||
extras,
|
||
},
|
||
}
|
||
|
||
const valid = validateState(state)
|
||
if (!valid.ok) return fail('sansheng/state-migrate-failed', `旧数据转换后未通过校验:${valid.error}`)
|
||
return { ok: true, state, warnings }
|
||
}
|