An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作
TypeScript agentic-aiai-agentknowledge-baselocal-firstmarkdownmcpmindmapnote-takingself-hostedsiyuanworkspace
import {applyLuteMarkdownSyntax} from "./luteMarkdownSyntax";
import {protectLuteInlineElementBoundaries} from "../util/inlineElementBoundary";
import {protectLuteTableVirtualization} from "../util/tableVirtualizationDOM";
// Lute 配置全部读取全局 window.siyuan.config / window.siyuan.emojis,跨编辑器一致,
// 因此所有 Protyle 编辑器共用同一个 Lute 实例,将内存与初始化开销从 O(编辑器数) 降为 O(1)。
// AgentChat 不复用此共享单例,而是通过 getAgentLute 构建独立实例,使渲染不受编辑器设置影响。
let luteInstance: Lute | undefined;
/**
* 获取(首次调用时创建)共享 Lute 单例。
*
* 仅在首次创建时应用 options,后续调用直接返回已缓存的实例 ——
* Lute 配置本就源于全局 config,跨编辑器一致,无需按编辑器区分。
*/
export const getLute = (options: ILuteOptions): Lute => {
if (!luteInstance) {
luteInstance = setLute(options);
}
return luteInstance;
};
/**
* 直接获取已初始化的共享 Lute 单例。
* 供 emoji 等无需传入 options 的场景使用;尚未创建时返回 undefined。
*/
export const getLuteInstance = (): Lute | undefined => {
return luteInstance;
};
/**
* 为智能体(AgentChat)构建独立的 Lute 实例。
*
* 与共享单例不同:不读取 window.siyuan.config.editor.markdown 的语法开关,
* 而是把所有 Markdown 行内语法(斜体/粗体/删除线/上下标/标签/行内公式/标记)硬编码启用,
* 使 LLM 输出始终按标准 Markdown 渲染,不受用户「编辑器 → Markdown 语法设置」的影响。
* 每次调用都返回新实例,与编辑器渲染相互隔离。
*/
export const getAgentLute = (options: ILuteOptions): Lute => {
const lute: Lute = Lute.New();
lute.SetSpellcheck(false);
lute.SetProtyleMarkNetImg(false);
lute.SetFileAnnotationRef(true);
lute.SetHTMLTag2TextMark(true);
lute.SetTextMark(true);
lute.SetHeadingID(false);
lute.SetYamlFrontMatter(false);
lute.PutEmojis(options.emojis);
lute.SetEmojiSite(options.emojiSite);
lute.SetHeadingAnchor(options.headingAnchor);
lute.SetInlineMathAllowDigitAfterOpenMarker(true);
lute.SetToC(false);
lute.SetIndentCodeBlock(false);
lute.SetParagraphBeginningSpace(true);
lute.SetSetext(false);
lute.SetFootnotes(false);
lute.SetLinkRef(false);
lute.SetSanitize(options.sanitize);
lute.SetChineseParagraphBeginningSpace(options.paragraphBeginningSpace);
lute.SetRenderListStyle(options.listStyle);
lute.SetImgPathAllowSpace(true);
lute.SetKramdownIAL(true);
lute.SetSuperBlock(true);
lute.SetCallout(true);
lute.SetTabs(true);
// 行内语法全部启用,不随编辑器设置变化。
lute.SetInlineAsterisk(true);
lute.SetInlineUnderscore(true);
lute.SetSup(true);
lute.SetSub(true);
lute.SetTag(true);
lute.SetInlineMath(true);
lute.SetGFMStrikethrough1(false);
lute.SetGFMStrikethrough(true);
lute.SetMark(true);
lute.SetSpin(true);
lute.SetProtyleWYSIWYG(true);
if (options.lazyLoadImage) {
lute.SetImageLazyLoading(options.lazyLoadImage);
}
lute.SetBlockRef(true);
lute.SetUnorderedListMarker("-");
lute.SetDataTask(true);
lute.SetExportNormalizeTaskListMarker(false);
lute.SetArbitraryTaskListItemMarker(true);
lute.SetEnsureListItemParagraph(true);
return protectLuteTableVirtualization(protectLuteInlineElementBoundaries(lute));
};
/**
* 根据全局配置与传入选项构建一个新的 Lute 实例,供共享单例初始化使用。
*/
const setLute = (options: ILuteOptions) => {
const lute: Lute = Lute.New();
lute.SetSpellcheck(window.siyuan.config.editor.spellcheck);
lute.SetProtyleMarkNetImg(window.siyuan.config.editor.displayNetImgMark);
lute.SetFileAnnotationRef(true);
lute.SetHTMLTag2TextMark(true);
lute.SetTextMark(true);
lute.SetHeadingID(false);
lute.SetYamlFrontMatter(false);
lute.PutEmojis(options.emojis);
lute.SetEmojiSite(options.emojiSite);
lute.SetHeadingAnchor(options.headingAnchor);
lute.SetInlineMathAllowDigitAfterOpenMarker(true);
lute.SetToC(false);
lute.SetIndentCodeBlock(false);
lute.SetParagraphBeginningSpace(true);
lute.SetSetext(false);
lute.SetFootnotes(false);
lute.SetLinkRef(false);
lute.SetSanitize(options.sanitize);
lute.SetChineseParagraphBeginningSpace(options.paragraphBeginningSpace);
lute.SetRenderListStyle(options.listStyle);
lute.SetImgPathAllowSpace(true);
lute.SetKramdownIAL(true);
lute.SetTag(true);
lute.SetSuperBlock(true);
lute.SetCallout(true);
lute.SetTabs(true);
lute.SetCustomBlock(true);
applyLuteMarkdownSyntax(lute, window.siyuan.config.editor.markdown);
lute.SetSpin(true);
lute.SetProtyleWYSIWYG(true);
if (options.lazyLoadImage) {
lute.SetImageLazyLoading(options.lazyLoadImage);
}
lute.SetBlockRef(true);
if (window.siyuan.emojis[0].items.length > 0) {
const emojis: IObject = {};
window.siyuan.emojis[0].items.forEach(item => {
emojis[item.keywords] = options.emojiSite + "/" + item.unicode;
});
lute.PutEmojis(emojis);
}
lute.SetUnorderedListMarker("-");
lute.SetDataTask(true);
lute.SetExportNormalizeTaskListMarker(false);
lute.SetArbitraryTaskListItemMarker(true);
lute.SetEnsureListItemParagraph(true); // 空列表项下创建子列表前补一个空段落
return protectLuteTableVirtualization(protectLuteInlineElementBoundaries(lute));
};