From b193377488546a50c238e9600b9f0ea07e578888 Mon Sep 17 00:00:00 2001 From: QQ Date: Thu, 12 Nov 2026 00:14:19 +0800 Subject: [PATCH] Import vendor/dsh-sansheng-liubu/workbench/core/memory.mjs --- .../workbench/core/memory.mjs | 194 ++++++++++++++++++ 1 file changed, 194 insertions(+) create mode 100644 vendor/dsh-sansheng-liubu/workbench/core/memory.mjs diff --git a/vendor/dsh-sansheng-liubu/workbench/core/memory.mjs b/vendor/dsh-sansheng-liubu/workbench/core/memory.mjs new file mode 100644 index 0000000..1013923 --- /dev/null +++ b/vendor/dsh-sansheng-liubu/workbench/core/memory.mjs @@ -0,0 +1,194 @@ +// 记忆层:模仿 DS Bot 的分层记忆,但按本项目的隔离规矩落在原生账本之外。 +// +// 三层: +// - 长期记忆(long-term.md):跨项目只此一份,记用户偏好与长期有效的经验。 +// - 项目记忆(projects/.md):一个项目一份,记这个项目发生过什么、 +// 结论是什么;项目之间互不可见——DS Bot 上游「主 Bot 可读全部 Bot 记忆」的 +// 弱隔离(归档分支 docs/p0 记录的 M-03 边界)不学。 +// - 部门记忆(departments/.md):一个席位一份,跟着部门跨项目走, +// 记这个部门自己摸出的经验;派发时只注入目标部门自己那一份, +// 别的部门读不到——隔离规矩与项目记忆一致。 +// +// 都是 Markdown:用户可以直接打开看、打开改。程序写入走临时文件 + rename, +// 不写半截;读取惰性(文件不存在 = 空记忆),构造时不碰磁盘,测试与预检 +// 装配不会在真实侧车目录里留下东西。 +// +// 记忆是参考资料,不是账本:本模块只对「形状不对」(非法项目 ID、超上限) +// 抛 MemoryError;读不到文件一律按空记忆处理,绝不让记忆拖垮业务流程。 + +import { + existsSync, + mkdirSync, + readFileSync, + renameSync, + rmSync, + writeFileSync, +} from 'node:fs' +import { dirname, join } from 'node:path' +import { isIdOf } from './ids.mjs' +import { isRoleId } from './roles.mjs' + +/** 单个记忆文件的字符上限:记忆要短而精,写满说明该整理了。 */ +export const MEMORY_FILE_MAX_CHARS = 64 * 1024 + +/** 派发注入时的摘录上限:交接材料是给部门开工看的,不能被记忆淹没。 */ +export const MEMORY_EXCERPT_CHARS = Object.freeze({ department: 2000, project: 3000, longTerm: 2000 }) + +export class MemoryError extends Error { + constructor(code, message, details = undefined) { + super(message) + this.name = 'MemoryError' + this.code = code + if (details !== undefined) this.details = details + } +} + +function requireProjectId(projectId) { + if (!isIdOf('project', projectId)) { + throw new MemoryError('INVALID_ID', `项目 ID 不合法:${String(projectId)}`, { field: 'projectId' }) + } + return projectId +} + +function requireRoleId(roleId) { + if (!isRoleId(roleId)) { + throw new MemoryError('INVALID_ID', `部门 ID 不合法:${String(roleId)}`, { field: 'roleId' }) + } + return roleId +} + +function requireMemoryText(text, field = 'text') { + if (typeof text !== 'string') { + throw new MemoryError('INVALID_INPUT', `${field} 必须是字符串`, { field }) + } + if (text.length > MEMORY_FILE_MAX_CHARS) { + throw new MemoryError('INVALID_INPUT', `记忆内容超过 ${MEMORY_FILE_MAX_CHARS} 字符上限,请先整理再写入`, { field }) + } + return text +} + +/** 原子写:先写同目录临时文件再 rename,崩溃时不会留下半截记忆。 */ +function writeFileAtomic(file, text) { + mkdirSync(dirname(file), { recursive: true }) + const tmp = `${file}.tmp-${process.pid}` + writeFileSync(tmp, text, 'utf8') + try { + renameSync(tmp, file) + } catch (error) { + try { rmSync(tmp, { force: true }) } catch { /* 临时文件清不掉不影响主流程 */ } + throw error + } +} + +function readIfExists(file) { + if (!existsSync(file)) return null + return readFileSync(file, 'utf8') +} + +function excerptOf(label, text, cap) { + const trimmed = text.trim() + if (trimmed === '') return null + if (trimmed.length <= cap) return `「${label}」\n${trimmed}` + return `「${label}」\n${trimmed.slice(0, cap)}\n…(已截断,完整内容见记忆文件)` +} + +/** + * @param {object} options + * @param {string} options.dir 记忆根目录(宿主装配时给侧车目录下的 memory/) + * @param {() => number} [options.clock] 时间源,可注入以便测试复现 + */ +export function createMemoryStore(options = {}) { + const { dir, clock = Date.now } = options + if (typeof dir !== 'string' || dir.trim() === '') { + throw new MemoryError('INVALID_INPUT', 'createMemoryStore 需要 dir(记忆根目录)') + } + const longTermFile = join(dir, 'long-term.md') + const projectFile = (projectId) => join(dir, 'projects', `${requireProjectId(projectId)}.md`) + const departmentFile = (roleId) => join(dir, 'departments', `${requireRoleId(roleId)}.md`) + + const today = () => new Date(clock()).toISOString().slice(0, 10) + + function appendTo(file, title, text) { + const entry = requireMemoryText(text, 'text') + if (entry.trim() === '') { + throw new MemoryError('INVALID_INPUT', 'append 的内容不能为空', { field: 'text' }) + } + const current = readIfExists(file) + const head = current === null || current.trim() === '' ? `# ${title}\n` : current.replace(/\s+$/, '') + '\n' + const next = `${head}\n## ${today()}\n\n${entry.trim()}\n` + if (next.length > MEMORY_FILE_MAX_CHARS) { + throw new MemoryError('INVALID_INPUT', `记忆文件已达 ${MEMORY_FILE_MAX_CHARS} 字符上限,请先整理再追加`, {}) + } + writeFileAtomic(file, next) + return { text: next } + } + + function writeWhole(file, text) { + const value = requireMemoryText(text) + writeFileAtomic(file, value) + return { text: value } + } + + const readLongTermFile = () => { + const text = readIfExists(longTermFile) + return { text: text ?? '', exists: text !== null } + } + const readProjectFile = (projectId) => { + const text = readIfExists(projectFile(projectId)) + return { text: text ?? '', exists: text !== null } + } + const readDepartmentFile = (roleId) => { + const text = readIfExists(departmentFile(roleId)) + return { text: text ?? '', exists: text !== null } + } + + return Object.freeze({ + dir, + longTermPath: longTermFile, + projectPath: projectFile, + departmentPath: departmentFile, + + readLongTerm: readLongTermFile, + writeLongTerm(text) { + return writeWhole(longTermFile, text) + }, + appendLongTerm(text) { + return appendTo(longTermFile, '长期记忆', text) + }, + + readProject: readProjectFile, + writeProject(projectId, text) { + return writeWhole(projectFile(projectId), text) + }, + appendProject(projectId, text) { + return appendTo(projectFile(projectId), '项目记忆', text) + }, + + readDepartment: readDepartmentFile, + writeDepartment(roleId, text) { + return writeWhole(departmentFile(roleId), text) + }, + appendDepartment(roleId, text) { + return appendTo(departmentFile(roleId), '部门记忆', text) + }, + + /** + * 派发时用的摘录:部门记忆在前(干活的人是谁),项目记忆居中 + * (这次活的来龙去脉),长期记忆在后(不变的偏好与规矩)。 + * roleId 缺失或不合法时跳过部门层——摘录是尽力而为,绝不因此抛错。 + * 没有内容的层不产生摘录;返回纯字符串数组,直接并进上下文包的 excerpts。 + */ + excerptsFor(projectId, roleId = null) { + const out = [] + if (isRoleId(roleId)) { + const department = excerptOf('部门记忆', readDepartmentFile(roleId).text, MEMORY_EXCERPT_CHARS.department) + if (department !== null) out.push(department) + } + const project = excerptOf('项目记忆', readProjectFile(projectId).text, MEMORY_EXCERPT_CHARS.project) + if (project !== null) out.push(project) + const longTerm = excerptOf('长期记忆', readLongTermFile().text, MEMORY_EXCERPT_CHARS.longTerm) + if (longTerm !== null) out.push(longTerm) + return out + }, + }) +}