时不时就会发现有零星的附件丢失

• 溯源: 等官方回复
• 找回
  • 先找到这个图片对应的文档
  • 翻一翻快照, 看看有没有
  • 翻一翻这个文档的数据历史, 看看有没有
• 预防: 这个 js 是定时检测 无效的引用块/丢失的资源文件 的, 可以在刚丢的时候, 就发现, 并解决

// [js] 定时检测无效的引用块: 20250726_212948
(() => {
    const CFG = {
        TIME_INTERVAL: "10",  // 检测间隔, 单位:分钟
    }
    async function myFetch(api, data) {
        return fetch(api, {
            method: "POST",
            body: JSON.stringify(data),
        }).then((response) => {
            if (response.ok) {
                return response.json();
            }
            else {
                throw new Error("Failed to get file content");
            }
        }).catch((error) => {
            console.log('请求失败:', error);
        });
    }
    async function myFetchPost(api, data, cb = null) {
        cb(await myFetch(api, data));
    }
    const syapi = {
        handle_post: function (api, data, cb) {
            myFetchPost(api, data, (rsp) => {
                if (rsp.code == 0) {
                    if (cb) cb(rsp.data);
                    return;
                }
                console.log(rsp.msg);
            });
        },
        get_invalid_block: function(cb) {
            syapi.handle_post('/api/search/listInvalidBlockRefs', {page: 1}, (rsp) => cb(rsp.blocks));
        },
        get_missing_file: function(cb) {
            syapi.handle_post('api/asset/getMissingAssets', {}, (rsp) => cb(rsp.missingAssets));
        },
        push_message: function(msg, timeout=5000) {
            syapi.handle_post('/api/notification/pushMsg', {msg, timeout});
        },
    }
    function get_time_now_str() {
        const now = new Date();
        // 获取时间部分
        const hours = String(now.getHours()).padStart(2, '0');
        const minutes = String(now.getMinutes()).padStart(2, '0');
        const seconds = String(now.getSeconds()).padStart(2, '0');
        const milliseconds = String(now.getMilliseconds()).padStart(3, '0');
        return `[${hours}:${minutes}:${seconds}]`;
    }
    async function check_invalid_block_timer_cb() {
        const time_str = get_time_now_str();
        console.log(`${time_str}: 定时检测: 无效的引用块/丢失的资源文件`);
        syapi.get_invalid_block((blocks) => {
            const cnt = blocks.length;
            if (cnt) {
                syapi.push_message(`${time_str} 检测到${cnt}个无效的引用块, 请及时处理`);
            }
        });
        syapi.get_missing_file((files) => {
            const cnt = files.length;
            if (cnt) {
                syapi.push_message(`${time_str} 检测到${cnt}个丢失的资源文件, 请及时处理`);
            }
        });
    }
    check_invalid_block_timer_cb();
    const intervalId = setInterval(check_invalid_block_timer_cb, CFG.TIME_INTERVAL*60*1000);
    // 如果需要停止定时器，可以调用 clearInterval(intervalId);
})()

有遇到过类似的情况，甚至是附件和链接脱离的形式，附件变成了未引用的资源，链接显示那个无附件的破损图片的图标。

在工作空间对应的文件夹下面，搜索一下这个文件名吧；或者通过快照回滚找一下。我遇到类似问题的时候，发现附件移动到了另一个文件夹，REF Issue #16353 · siyuan-note/siyuan

谢了，我发现竟然还有引用失效的。请问你知道引用失效的有没有对应的列表？像那个资源丢失列表一样。

在设置里那个界面（第二张截图）就能分开看未引用和丢失的资源文件

哦哦，我以为检测的是块引用链接失效的

脚本定期检测丢失的资源文件，实际上和手动定期检查丢失资源文件页面的作用一样，就是脚本持续运行会更及时发现。不过未引用资源文件我就不知道能不能用脚本检测了，看看作者怎么说吧

1. 未引用的资源文件: assets 里面存在这个文件, 但是笔记里面没有用到
   这种不影响笔记, 平时不需要关心, 偶尔闲着没事清一下就行
2. 丢失的资源: 笔记里面引用了这个文件, 但是 assets 下面没有这个文件
   这种就有影响了, 我给的 js 脚本会定时检测
3. 引用失效的块: 笔记里面通过块 id 引用了某个块, 但是这个块不存在
   这种也有影响, 一般是平时操作没注意导致的, 比如: 先剪切再粘贴了被引用的块, 或者手动删除了被引用的块
   js 脚本也会定时检测这种情况, 可以在这里看
   

另外吐槽一下, 列出引用失效的块, 这个按钮隐藏的好深, 思源我用了快两年了才知道还有这玩意