diff --git a/workbench/core/memory.mjs b/workbench/core/memory.mjs index d27228d..1013923 100644 --- a/workbench/core/memory.mjs +++ b/workbench/core/memory.mjs @@ -1,10 +1,13 @@ // 记忆层:模仿 DS Bot 的分层记忆,但按本项目的隔离规矩落在原生账本之外。 // -// 两层: +// 三层: // - 长期记忆(long-term.md):跨项目只此一份,记用户偏好与长期有效的经验。 // - 项目记忆(projects/.md):一个项目一份,记这个项目发生过什么、 // 结论是什么;项目之间互不可见——DS Bot 上游「主 Bot 可读全部 Bot 记忆」的 // 弱隔离(归档分支 docs/p0 记录的 M-03 边界)不学。 +// - 部门记忆(departments/.md):一个席位一份,跟着部门跨项目走, +// 记这个部门自己摸出的经验;派发时只注入目标部门自己那一份, +// 别的部门读不到——隔离规矩与项目记忆一致。 // // 都是 Markdown:用户可以直接打开看、打开改。程序写入走临时文件 + rename, // 不写半截;读取惰性(文件不存在 = 空记忆),构造时不碰磁盘,测试与预检 @@ -23,12 +26,13 @@ import { } 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({ project: 3000, longTerm: 2000 }) +export const MEMORY_EXCERPT_CHARS = Object.freeze({ department: 2000, project: 3000, longTerm: 2000 }) export class MemoryError extends Error { constructor(code, message, details = undefined) { @@ -46,6 +50,13 @@ function requireProjectId(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 }) @@ -93,6 +104,7 @@ export function createMemoryStore(options = {}) { } 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) @@ -125,11 +137,16 @@ export function createMemoryStore(options = {}) { 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) { @@ -147,12 +164,26 @@ export function createMemoryStore(options = {}) { 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) { + 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)