思源笔记数据库操作相关 API 分享

数据库信息更新和新增

1. 先调用接口： /api/av/renderAttributeView 把整表拉下来；
2. 找到「任务」列内容为 22222 的那一行：
   • 找到了 → 把它的 状态 改为 已完成（调用接口： /api/av/setAttributeViewBlockAttr）；
   • 找不到 → 新增一行（调用接口： /api/av/appendAttributeViewDetachedBlocksWithValues）。
3. avID 就是数据库 id

(async () => {
  // 1. 仅需要手动填的变量
  const avID     = '20250826100333-gzp9078'; // 数据库 ID
  const taskText = '22222';
  const newState = '已完成';

  // 2. 拉整张表
  const { data: db } = await fetchSyncPost('/api/av/renderAttributeView', {
    id      : avID,
    viewID  : avID,
    page    : 1,
    pageSize: 9999
  });

  // 3. 动态取列 ID
  const colTask  = db.view.columns.find(c => c.name === '任务')?.id;
  const colState = db.view.columns.find(c => c.name === '状态')?.id;
  if (!colTask || !colState) {
    console.error('❌ 未能自动识别“任务”或“状态”列');
    return;
  }

  // 4. 查找行
  const row = db.view.rows.find(r => {
    const cell = r.cells.find(c => c.value.keyID === colTask);
    return cell && cell.value.block?.content === taskText;
  });

  if (row) {
    // 4-1 更新已有行
    const stateCell = row.cells.find(c => c.value.keyID === colState);
    await fetchSyncPost('/api/av/setAttributeViewBlockAttr', {
      avID,
      keyID : colState,
      rowID : row.id,
      cellID: stateCell.id,
      value : { mSelect: [{ content: newState }] }
    });
    console.log(`✅ 已把“${taskText}”的状态改为“${newState}”`);
  } else {
    // 4-2 新建行
    await fetchSyncPost('/api/av/appendAttributeViewDetachedBlocksWithValues', {
      avID,
      blocksValues: [
        [
          { keyID: colTask,  block: { content: taskText } },
          { keyID: colState, mSelect: [{ content: newState }] }
        ]
      ]
    });
    console.log(`✅ 新建行：任务“${taskText}”，状态“${newState}”`);
  }
})();

数据库删除某一行

在思源里可调用 /api/av/removeAttributeViewBlock 时，数据库信息删除某一行：

参数： avID 和 rowID 换成自己的即可：

(async () => {
  const avID   = '20250826100333-gzp9078';        // 数据库 ID
  const rowID  = '20250826173514-3q2heri';        // 要删除的整行 ID

  const res = await fetch('/api/av/removeAttributeViewBlock', {
    method : 'POST',
    headers: { 'Content-Type': 'application/json' },
    body   : JSON.stringify({ avID, blockID: rowID })
  });

  // 思源删除接口成功时返回空体，无需 res.json()
  if (res.ok) {
    console.log('✅ 已删除行', rowID);
  } else {
    console.error('❌ 删除失败', res.status, await res.text());
  }
})();