FocusNote：添加到每日笔记

该技能将用户提供的文本作为新项目符号（bullet point）添加至 FocusNote 中今天的每日笔记。

工作原理

1. 从 ~/.lucia/documents-path.txt 读取 FocusNote 的文档路径
2. 以 YYYY-MM-DD 格式生成今日日期
3. 定位或创建今日的每日笔记目录
4. 将用户输入的文本作为新的项目符号添加进去
5. 更新文档对应的 JSON 结构文件（_structure.json 和 _metadata.json）

前提条件

• FocusNote 应用必须正在运行（启动时会创建 ~/.lucia/documents-path.txt）
• 需已安装 Node.js，用于运行辅助脚本

实现方式

当用户请求将文本添加至其每日笔记时，请按以下步骤执行：

步骤 1：读取文档路径

const fs = require("fs");
const path = require("path");
const os = require("os");

// 从 FocusNote 的配置文件中读取文档路径
const focusnoteConfigPath = path.join(
  os.homedir(),
  ".lucia",
  "documents-path.txt",
);
const documentsPath = fs.readFileSync(focusnoteConfigPath, "utf-8").trim();

步骤 2：生成今日日期

const today = new Date();
const year = today.getFullYear();
const month = String(today.getMonth() + 1).padStart(2, "0");
const day = String(today.getDate()).padStart(2, "0");
const todayDocName = `${year}-${month}-${day}`;

步骤 3：定位每日笔记目录

const dailyNotePath = path.join(documentsPath, "notes", todayDocName);
const structurePath = path.join(dailyNotePath, "_structure.json");
const metadataPath = path.join(dailyNotePath, "_metadata.json");
const nodesDir = path.join(dailyNotePath, ".nodes");

步骤 4：若每日笔记不存在，则创建它

if (!fs.existsSync(dailyNotePath)) {
  // 创建目录结构
  fs.mkdirSync(dailyNotePath, { recursive: true });
  fs.mkdirSync(nodesDir, { recursive: true });

  // 创建元数据文件
  const metadata = {
    name: todayDocName,
    createdAt: Date.now(),
    updatedAt: Date.now(),
  };
  fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));

  // 创建空的结构文件
  const structure = {
    rootNodeIds: [],
    deletedNodeIds: [],
    nodes: {},
  };
  fs.writeFileSync(structurePath, JSON.stringify(structure, null, 2));
}

步骤 5：创建新的项目符号节点

const { v4: uuidv4 } = require("uuid"); // npm install uuid

// 生成唯一节点 ID
const nodeId = uuidv4();
const timestamp = Date.now();

// 构建 Lexical 格式的项目符号内容结构
const lexicalContent = {
  root: {
    children: [
      {
        children: [
          {
            children: [
              {
                detail: 0,
                format: 0,
                mode: "normal",
                style: "",
                text: userText, // 用户输入的文本
                type: "text",
                version: 1,
              },
            ],
            direction: "ltr",
            format: "",
            indent: 0,
            type: "listitem",
            version: 1,
            value: 1,
          },
        ],
        direction: "ltr",
        format: "",
        indent: 0,
        type: "list",
        version: 1,
        listType: "bullet",
        start: 1,
        tag: "ul",
      },
    ],
    direction: "ltr",
    format: "",
    indent: 0,
    type: "root",
    version: 1,
  },
};

// 构建节点对象
const newNode = {
  id: nodeId,
  content: JSON.stringify(lexicalContent),
  isFolded: false,
  isTodo: false,
  isDone: false,
  isInProgress: false,
  isBlurred: false,
  backgroundColor: null,
  createdAt: timestamp,
  updatedAt: timestamp,
};

步骤 6：将节点保存至分片（sharded）目录

// 按节点 ID 的前两个字符进行分片
const shard = nodeId.substring(0, 2);
const shardDir = path.join(nodesDir, shard);

if (!fs.existsSync(shardDir)) {
  fs.mkdirSync(shardDir, { recursive: true });
}

const nodeFilePath = path.join(shardDir, `node-${nodeId}.json`);
fs.writeFileSync(nodeFilePath, JSON.stringify(newNode, null, 2));

步骤 7：更新结构文件

// 读取当前结构文件
const structure = JSON.parse(fs.readFileSync(structurePath, "utf-8"));

// 将新节点加入结构
structure.rootNodeIds.push(nodeId);
structure.nodes[nodeId] = {
  parentId: null,
  orderIndex: structure.rootNodeIds.length - 1,
  childIds: [],
};

// 更新时间戳
structure.updatedAt = timestamp;

// 写入更新后的结构文件
fs.writeFileSync(structurePath, JSON.stringify(structure, null, 2));

完整脚本示例

以下是一个可直接使用的完整 Node.js 脚本：

#!/usr/bin/env node

const fs = require("fs");
const path = require("path");
const os = require("os");
const { v4: uuidv4 } = require("uuid");

function addToDailyNote(userText) {
  try {
    // 步骤 1：读取文档路径
    const focusnoteConfigPath = path.join(
      os.homedir(),
      ".lucia",
      "documents-path.txt",
    );
    if (!fs.existsSync(focusnoteConfigPath)) {
      throw new Error(
        "FocusNote 配置文件未找到。请确保 FocusNote 正在运行。",
      );
    }
    const documentsPath = fs.readFileSync(focusnoteConfigPath, "utf-8").trim();

    // 步骤 2：生成今日日期
    const today = new Date();
    const year = today.getFullYear();
    const month = String(today.getMonth() + 1).padStart(2, "0");
    const day = String(today.getDate()).padStart(2, "0");
    const todayDocName = `${year}-${month}-${day}`;

    // 步骤 3：设置路径
    const dailyNotePath = path.join(documentsPath, "notes", todayDocName);
    const structurePath = path.join(dailyNotePath, "_structure.json");
    const metadataPath = path.join(dailyNotePath, "_metadata.json");
    const nodesDir = path.join(dailyNotePath, ".nodes");

    // 步骤 4：如需则创建每日笔记目录
    if (!fs.existsSync(dailyNotePath)) {
      fs.mkdirSync(dailyNotePath, { recursive: true });
      fs.mkdirSync(nodesDir, { recursive: true });

      const metadata = {
        name: todayDocName,
        createdAt: Date.now(),
        updatedAt: Date.now(),
      };
      fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));

      const structure = {
        rootNodeIds: [],
        deletedNodeIds: [],
        nodes: {},
      };
      fs.writeFileSync(structurePath, JSON.stringify(structure, null, 2));
    }

    // 步骤 5：创建新的项目符号节点
    const nodeId = uuidv4();
    const timestamp = Date.now();

    const lexicalContent = {
      root: {
        children: [
          {
            children: [
              {
                children: [
                  {
                    detail: 0,
                    format: 0,
                    mode: "normal",
                    style: "",
                    text: userText,
                    type: "text",
                    version: 1,
                  },
                ],
                direction: "ltr",
                format: "",
                indent: 0,
                type: "listitem",
                version: 1,
                value: 1,
              },
            ],
            direction: "ltr",
            format: "",
            indent: 0,
            type: "list",
            version: 1,
            listType: "bullet",
            start: 1,
            tag: "ul",
          },
        ],
        direction: "ltr",
        format: "",
        indent: 0,
        type: "root",
        version: 1,
      },
    };

    const newNode = {
      id: nodeId,
      content: JSON.stringify(lexicalContent),
      isFolded: false,
      isTodo: false,
      isDone: false,
      isInProgress: false,
      isBlurred: false,
      backgroundColor: null,
      createdAt: timestamp,
      updatedAt: timestamp,
    };

    // 步骤 6：保存节点文件
    const shard = nodeId.substring(0, 2);
    const shardDir = path.join(nodesDir, shard);

    if (!fs.existsSync(shardDir)) {
      fs.mkdirSync(shardDir, { recursive: true });
    }

    const nodeFilePath = path.join(shardDir, `node-${nodeId}.json`);
    fs.writeFileSync(nodeFilePath, JSON.stringify(newNode, null, 2));

    // 步骤 7：更新结构文件
    const structure = JSON.parse(fs.readFileSync(structurePath, "utf-8"));
    structure.rootNodeIds.push(nodeId);
    structure.nodes[nodeId] = {
      parentId: null,
      orderIndex: structure.rootNodeIds.length - 1,
      childIds: [],
    };
    structure.updatedAt = timestamp;
    fs.writeFileSync(structurePath, JSON.stringify(structure, null, 2));

    console.log(`✅ 已向 ${todayDocName} 添加项目符号："${userText}"`);
    return { success: true, documentName: todayDocName, nodeId };
  } catch (error) {
    console.error("❌ 向每日笔记添加内容时出错：", error.message);
    return { success: false, error: error.message };
  }
}

// 示例调用方式
if (require.main === module) {
  const userText = process.argv.slice(2).join(" ") || "New bullet point";
  addToDailyNote(userText);
}

module.exports = { addToDailyNote };

使用示例

用户：“添加到我的每日笔记：完成了 OpenClaw 技能的实现”

助手：我将把该内容添加至您的每日笔记中。

# 运行脚本
node add-to-daily-note.js "Finished the OpenClaw skill implementation"

输出： ✅ 已向 2026-02-11 添加项目符号："Finished the OpenClaw skill implementation"

用户：“添加一个提醒：明天给妈妈打电话”

助手：我将把该提醒添加至今天的笔记中。

node add-to-daily-note.js "Reminder to call mom tomorrow"

安装方法

1. 将脚本保存为 add-to-daily-note.js，置于您的 OpenClaw skills 目录下
2. 安装依赖项：npm install uuid
3. 赋予可执行权限：chmod +x add-to-daily-note.js

注意事项

• 每次调用该技能都会创建一个新的项目符号节点
• 项目符号始终追加至每日笔记末尾
• 若当日的每日笔记尚不存在，系统将自动创建
• FocusNote 应用必须处于运行状态，以确保 ~/.lucia/documents-path.txt 存在
• 在 FocusNote 中打开或刷新每日笔记后，更改将立即可见

故障排查

错误：“FocusNote 配置文件未找到”

• 请确认 FocusNote 正在运行
• 检查 ~/.lucia/documents-path.txt 是否存在

项目符号未在 FocusNote 中显示

• 尝试关闭并重新打开该每日笔记
• 检查 .nodes/ 目录下是否已成功创建节点文件
• 确认 _structure.json 文件是否已正确更新