起因
最近看了《防弹笔记法》，书中所有任务都是在对应的项目笔记中，把任务都记录在笔记里，这样可以方便溯源整个任务的上下文，减少任务上下文的切换，我以前一直用滴答清单进行管理，但是项目笔记又在思源中，两个软件来回切换也是有点难受，所以干脆尝试 all in siyuan 了，下面模版就是成果。
模版介绍
目前这套模版我优化起码半个月，最麻烦的是各种模版列代码的逻辑优化，此处感谢 deepseek 以及 F 佬的帖子思源模板功能新人指南：模板语法 + 函数 + md 块语法 - 链滴，只需要把帖子里的语法喂给 AI 基本就能慢慢帮我写好。
以下是模版文档，下载导入即可使用，无需任何其他插件，只依赖思源本身的数据库。
具体用法还是看下面图片和视频，并且在模版内的每个字段上我都添加了备注，鼠标移动上去就能看到对应备注信息。
功能演示视频：
看完上面视频应该能基本了解用法，我是把任务块添加至数据库，然后任务块的状态可以通过模版列自动同步至数据库，这样的好处是任务块状态和数据库内保持一致，如果是单独在数据库新建复选框，那就要点两次完成了，非常不优雅，当然现在受制于思源的文档刷新，无法实现数据库模版列内点完成同步至任务，必须通过悬浮窗进去点击完成，但我觉得完全能接受，如果不喜欢可以自己换成复选框完成，不管笔记内任务的状态。
以下是模版列实现自动操作的步骤。
- 自动获取任务列表所在的文档标题
- 自动获取任务列表完成状态
- 自动计算距离开始日、截止日还有多久
- 自动显示未添加日期待定的任务
更快的任务添加方式之 Supertag
以上视频演示的是通过标签将任务添加至数据库，我认为这个方式比去块菜单里添加至数据库快许多，只需要添加以下 JS 代码即可实现，注意数据库名称要和标签名称完全一致。非常感谢 @qiancang 大佬的这个帖子的灵感 [Quicker] 思源笔记 SuperTag - 链滴 以及 @wilsons 大佬的 JS 代码编写和帮助(让大佬帮我改了 N 次代码)，让这一切可以得以顺利实现。
// 思源通过标签插入当前块到数据库（SuperTag）
// 功能：给块设置标签，将块添加到标签同名的数据库。
// 说明；
// 1、数据库名称需要与标签同名，名称需含前后#，如 #笔记软件#
// 2、如果有多个同名数据库，只会将块添加到其中一个，所以不要建立同名数据库
// 3、需要提前建立数据库才能添加成功
// version：0.0.4
// 更新记录
// 0.0.2 增加数据库同名文档标签即可把文档添加到标签同名数据库中（文档标签这里指文档头部的添加标签）。
// 0.0.3 增加可删除数据库引用文本中的标签名选项isShowTagNameInAvCell
// 0.0.4 改进当标签在列表中时数据库插入列表项
// 根据qiancang大佬的帖子实现 https://ld246.com/article/1731945645865
(()=>{
// 添加tag后多少毫秒添加当前块到数据库
// 不宜设置过小，过小可能导致标签被插入一半
const delay = 1000;
// 是否开启文档标签插入同名数据库（文档标签这里指文档头部的添加标签），true开启，false不开启
const enableDocTagToAv = true;
// 是否在数据库列表中显示标签名(数据库名)，true显示，false不显示（注意，文档块引用不会添加标签名，实现较麻烦暂不支持）
const isShowTagNameInAvCell = false;
// 发布服务立即返回
if(siyuan.config.readonly) return;
// 监听tag输入
observeTagSpans(async (tagEl, tagType) => {
// 如果未开启文档标签插入同名数据库，当为文档标签时返回
if(!enableDocTagToAv && tagType === 'doc-tag') return;
// 去掉零宽度字符&ZeroWithSpace;
const tag = tagEl?.textContent?.replace(/[\u200B-\u200D\uFEFF]/g, '')?.trim();
if(!tag) return;
// 获取数据库信息
const av = await getAvByName(tag);
if(!av) return;
const avId = av.avID;
if(!avId) return;
const avBlockID = av.blockID;
if(!avBlockID) return;
// 获取文档块信息
let block;
if(tagType === 'doc-tag') {
// 如果头部标签，返回文档id
const blockParent = tagEl.closest('div.protyle-top');
if(!blockParent) return;
block = blockParent.querySelector('.protyle-title');
} else {
// 如果块标签，返回块id（监听元素的临时块）
block = tagEl.closest('div[data-node-id][data-type]');
if(!block) return;
// 获取文档中的block结点
block = document.querySelector('div[data-node-id="'+(block?.dataset?.nodeId||'')+'"]');
if(!block) return;
// 判断是否在列表元素内，数据库插入列表项
const listItemNode = block.closest('div[data-node-id][data-type="NodeListItem"]');
if(listItemNode) block = listItemNode;
}
const blockId = block?.dataset?.nodeId;
if(!blockId) return;
// 添加块到数据库
await sleep(delay || 500);
addBlocksToAv(blockId, avId, avBlockID);
});
// 如果不在数据库中显示标签名则删除标签名（注意，文档块引用不会添加标签名，实现较麻烦暂不支持）
if(!isShowTagNameInAvCell) {
observeElementCreation(
document.body,
'.av__row:not(.av__row--header) [data-dtype="block"] [data-type="block-ref"]',
async ref => {
if(!/\s?#.*?#/i.test(ref.textContent)) return;
ref.textContent = ref.textContent.replace(/\s?#.*?#/ig, '');
}
);
}
// 插入块到数据库
async function addBlocksToAv(blockIds, avId, avBlockID) {
blockIds = typeof blockIds === 'string' ? [blockIds] : blockIds;
const srcs = blockIds.map(blockId => ({
"id": blockId,
"isDetached": false,
}));
const input = {
"avID": avId,
"blockID": avBlockID,
'srcs': srcs
}
const result = await fetchSyncPost('/api/av/addAttributeViewBlocks', input);
if(!result || result.code !== 0) console.error(result);
}
// 通过该tag查询数据库
async function getAvByName(name) {
const result = await fetchSyncPost('/api/av/searchAttributeView', {
"keyword": name
});
if(!result || result.code !== 0 || !result?.data?.results || result?.data?.results?.length === 0) return null;
for (const av of result.data.results) {
if (av.avName === name || av.avName === `#${name}#`) {
return av;
}
}
return null;
}
// 请求api
// returnType json返回json格式，text返回文本格式
async function fetchSyncPost(url, data, returnType = 'json') {
const init = {
method: "POST",
};
if (data) {
if (data instanceof FormData) {
init.body = data;
} else {
init.body = JSON.stringify(data);
}
}
try {
const res = await fetch(url, init);
const res2 = returnType === 'json' ? await res.json() : await res.text();
return res2;
} catch(e) {
console.log(e);
return returnType === 'json' ? {code:e.code||1, msg: e.message||"", data: null} : "";
}
}
// 延迟执行
function sleep(ms) {
return new Promise(resolve => setTimeout(resolve, ms));
}
// 监听tag被添加
function observeTagSpans(callback) {
// 创建一个观察者实例并传入回调函数
const observer = new MutationObserver((mutationsList, observer) => {
for (const mutation of mutationsList) {
if (mutation.type === 'childList') {
// 检查新增的节点
for (const node of mutation.addedNodes) {
if (node.nodeType === Node.ELEMENT_NODE && node.tagName.toLowerCase() === 'span' && node.getAttribute('data-type') === 'tag') {
// 块标签调用回调函数
callback(node, 'block-tag');
} else if(node.nodeType === Node.ELEMENT_NODE && node.tagName.toLowerCase() === 'div' && node.classList?.contains('b3-chip') && node.getAttribute('data-type') === 'open-search') {
// 文档头部标签调用回调函数
callback(node, 'doc-tag');
}
}
}
}
});
// 配置观察选项:
const config = {
childList: true, // 观察子节点的变化(添加/删除)
subtree: true // 观察所有后代节点
};
// 选择需要观察变动的节点
const targetNode = document.body; // 或者选择更具体的父节点以减少性能消耗
// 开始观察目标节点
observer.observe(targetNode, config);
// 返回一个取消观察的方法
return () => observer.disconnect();
}
// 监听元素被创建
function observeElementCreation(parentNode, selector, onElementCreated) {
// 配置观察器选项
const config = {
childList: true, // 观察直接子节点的添加和移除
subtree: true // 观察所有后代节点
};
// 当检测到变动时执行的回调函数
const callback = function(mutationsList, observer) {
for (let mutation of mutationsList) {
if (mutation.type === 'childList') {
mutation.addedNodes.forEach(node => {
if (node.nodeType === Node.ELEMENT_NODE) {
// 使用 querySelectorAll 查找所有符合条件的新元素
const elements = node.querySelectorAll(selector);
elements.forEach(element => {
onElementCreated(element); // 调用外部提供的回调函数
});
}
});
}
}
};
// 创建一个观察器实例并传入回调函数
const observer = new MutationObserver(callback);
// 开始观察目标节点
observer.observe(parentNode, config);
// 返回一个函数来停止观察
return () => observer.disconnect();
}
})();
此为代码原始链接：思源/思源通过标签插入当前块到数据库 SuperTag.js · wish/mysoft - Gitee.com
未来展望
至此基本就介绍完了，剩下的遗憾主要是没有其他更直观好看的视图，比如看板视图、分组功能等，希望 D 大 V 姐加把劲，争取明年补上 😂
END
欢迎来到这里！
我们正在构建一个小众社区，大家在这里相互信任，以平等 • 自由 • 奔放的价值观进行分享交流。最终，希望大家能够找到与自己志同道合的伙伴，共同成长。
注册 关于