0.11.0 退役老预设线:workbench/core/memory.mjs

This commit is contained in:
QQ 2026-11-10 22:25:14 +08:00
parent d1d0529e0c
commit f15e7d112c
1 changed files with 35 additions and 4 deletions

View File

@ -1,10 +1,13 @@
// 记忆层:模仿 DS Bot 的分层记忆,但按本项目的隔离规矩落在原生账本之外。
//
// 两层:
// 三层:
// - 长期记忆(long-term.md):跨项目只此一份,记用户偏好与长期有效的经验。
// - 项目记忆(projects/<projectId>.md):一个项目一份,记这个项目发生过什么、
// 结论是什么;项目之间互不可见——DS Bot 上游「主 Bot 可读全部 Bot 记忆」的
// 弱隔离(归档分支 docs/p0 记录的 M-03 边界)不学。
// - 部门记忆(departments/<roleId>.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)