An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
TypeScript agentic-aiai-agentknowledge-baselocal-firstmarkdownmcpmindmapnote-takingself-hostedsiyuanworkspace
interface ITransactionBatch<T> {
items: T[];
promise?: Promise<void>;
task: (items: T[]) => Promise<void>;
}
interface ITransactionQueue {
pendingBatches: Map<string, ITransactionBatch<unknown>>;
tail: Promise<void>;
}
const transactionQueues = new WeakMap<IProtyle, ITransactionQueue>();
const MAX_TRANSACTION_BATCH_SIZE = 32;
const getTransactionQueue = (protyle: IProtyle) => {
let queue = transactionQueues.get(protyle);
if (!queue) {
queue = {
pendingBatches: new Map(),
tail: Promise.resolve(),
};
transactionQueues.set(protyle, queue);
}
return queue;
};
const appendTransaction = (queue: ITransactionQueue, task: () => Promise<void>) => {
const currentTransaction = queue.tail.catch((): undefined => undefined).then(task);
queue.tail = currentTransaction;
return currentTransaction;
};
const sealPendingBatches = (queue: ITransactionQueue) => {
queue.pendingBatches.clear();
};
export const queueTransaction = (protyle: IProtyle, task: () => Promise<void>) => {
const queue = getTransactionQueue(protyle);
sealPendingBatches(queue);
return appendTransaction(queue, task);
};
export const queueTransactionBatch = <T>(protyle: IProtyle, key: string, item: T,
task: (items: T[]) => Promise<void>) => {
const queue = getTransactionQueue(protyle);
const pendingBatch = queue.pendingBatches.get(key) as ITransactionBatch<T> | undefined;
// 限制一次请求持有的编辑操作数量,积压的更新按原顺序分批提交。
if (pendingBatch && pendingBatch.items.length < MAX_TRANSACTION_BATCH_SIZE) {
pendingBatch.items.push(item);
return pendingBatch.promise;
}
sealPendingBatches(queue);
const batch: ITransactionBatch<T> = {
items: [item],
task,
};
queue.pendingBatches.set(key, batch as ITransactionBatch<unknown>);
batch.promise = appendTransaction(queue, async () => {
if (queue.pendingBatches.get(key) === batch) {
queue.pendingBatches.delete(key);
}
await batch.task(batch.items);
});
return batch.promise;
};
export const waitForPendingTransactions = (protyle: IProtyle) => {
const queue = transactionQueues.get(protyle);
if (!queue) {
return Promise.resolve();
}
sealPendingBatches(queue);
return queue.tail.catch((): undefined => undefined);
};