Just Note

记一下 (just-note) - 零摩擦知识记录

一句话定位

像发消息一样记录一切，AI 自动分类整理，让知识自然生长。

核心能力

内容类型

快速开始

方式 1：微信/飞书消息（推荐）

发送消息即可，AI 自动分类：

这个产品功能可以这样做：用户发消息后，AI 自动分类并存入知识库，比手动标签简单多了

AI 自动处理：

• 类型：inspiration
• 标签：[product, ai, automation]
• 标题：产品自动化分类功能灵感
• 存储：memory/just-note/2026-03/2026-03-26-120000.md

再试一笔支出：

花了 200 块买书

AI 自动处理：

• 类型：expense
• 金额：200
• 标签：[book, learning]
• 标题：买书支出¥200

方式 2：CLI 命令（调试用）

明确指定参数，CLI 直接执行：

just-note write --type expense --amount 200 --tags "book,learning" --content "买书"

查看今日记录：

just-note today

输出：

## 2026-03-26 今日记录

共 5 条记录：
- inspiration: 2 条
- expense: 1 条 (¥200)
- task: 1 条
- diary: 1 条

[详细列表...]

检索历史记录

按关键词：

just-note search "产品"

按类型：

just-note list --type expense

按日期范围：

just-note list --from 2026-03-01 --to 2026-03-31

笔记格式标准

采用 memory-notes 格式，支持知识图谱：

---
title: "AI 生成的标题"
type: inspiration  # 9 类之一
created: 2026-03-26T12:00:00+08:00
day-id: 2026-03-26  # 用于按天聚合
tags: [tag1, tag2, tag3]
amount: 200  # 可选，收支类型时有
currency: CNY  # 可选
source: wechat  # wechat/feishu/voice/image
---

# AI 生成的标题

## 原始内容
用户发送的原始消息内容...

## AI 整理
- [insight] AI 提取的核心观点 1
- [insight] AI 提取的核心观点 2
- [meta] 金额：¥200（如果是收支类型）

## 关联笔记
- relates_to [[相关笔记标题]]

目录结构

memory/just-note/
├── 2026-03/
│   ├── 2026-03-26-120000.md
│   ├── 2026-03-26-140000.md
│   └── ...
├── 2026-04/
│   └── ...
└── index.json  # 可选，加速检索

命令参考

记录类

查询类

统计类

导出类

AI 分类实现

核心理念：AI 做大脑，CLI 做手脚

工作流程

消息模式（主要）

用户微信消息
    ↓
OpenClaw Gateway 接收
    ↓
AI（我）理解内容 → 自动分类、生成标签、提取金额
    ↓
AI 调用 CLI：just-note write --type xxx --tags xxx ...
    ↓
CLI 执行写入 → 文件保存

关键：AI 负责理解，CLI 负责执行。

CLI 模式（备用）

用户明确参数：just-note write --type expense --amount 200 ...
    ↓
CLI 直接执行 → 文件保存
    ↓
不做任何分类/理解

关键：CLI 不做思考，只执行明确指令。

为什么这样设计？

1. 效率最高 - AI 做擅长的事（理解），CLI 做擅长的事（执行）
2. 职责清晰 - AI 有"大脑"，CLI 是"手脚"
3. 符合直觉 - 用户发消息 = 让 AI 处理；用 CLI = 自己明确指定

Prompt 模板:

你是一个知识记录分类助手。请分析用户输入的内容，完成以下任务：

1. 识别内容类型（9 选 1）：
   - inspiration: 灵感、创意、想法
   - idea: 想法、读书心得
   - knowledge: 知识点、解释
   - expense: 支出记录
   - income: 收入记录
   - diary: 日记、感受
   - task: 待办事项
   - quote: 引用、名人名言
   - other: 其他无法分类的内容

2. 生成 3-5 个标签（简洁、有意义）

3. 生成一个简洁的标题（10-20 字）

4. 如果是收支类型，提取金额和货币单位

5. 提取 1-3 个核心观点/事实（用于 Observations）

输出 JSON 格式：
{
  "type": "inspiration",
  "title": "标题",
  "tags": ["tag1", "tag2", "tag3"],
  "amount": null,
  "currency": null,
  "observations": ["观点 1", "观点 2"]
}

实现细节

1. 消息接收

通过 OpenClaw Gateway 接收微信/飞书消息：

// 伪代码
onMessage(async (message) => {
  if (message.source === 'wechat' || message.source === 'feishu') {
    await processRecord(message.content, message.source);
  }
});

2. AI 分类

调用 LLM 进行自动分类：

# 伪代码
ai_classify() {
  content="$1"
  prompt=$(cat <<EOF
[分类 Prompt 见上方]
用户输入：$content
EOF
)
  response=$(call_llm "$prompt")
  echo "$response"
}

3. 文件写入

生成 Markdown 文件：

write_note() {
  type="$1"
  title="$2"
  content="$3"
  tags="$4"
  observations="$5"
  
  timestamp=$(date +%Y-%m-%d-%H%M%S)
  month=$(date +%Y-%m)
  file="memory/just-note/$month/$timestamp.md"
  
  cat > "$file" <<EOF
---
title: "$title"
type: $type
created: $(date -Iseconds)
day-id: $(date +%Y-%m-%d)
tags: [$tags]
source: $SOURCE
---

# $title

## 原始内容
$content

## AI 整理
$(format_observations "$observations")

## 关联笔记
$(format_relations "$relations")
EOF
}

4. 检索实现

关键词搜索：

search_notes() {
  keyword="$1"
  grep -r "$keyword" memory/just-note/ --include="*.md"
}

按类型筛选：

list_by_type() {
  type="$1"
  grep -l "^type: $type$" memory/just-note/*/*.md
}

5. 日记视图

按天聚合：

diary_view() {
  date="$1"
  echo "# $date 日记"
  echo ""
  echo "## 今日概览"
  
  count=$(grep -l "^day-id: $date$" memory/just-note/*/*.md | wc -l)
  echo "共 $count 条记录"
  
  # 按类型统计
  for type in inspiration idea knowledge expense income diary task quote other; do
    type_count=$(grep -l "^type: $type$" memory/just-note/*/*.md | grep "$date" | wc -l)
    if [ $type_count -gt 0 ]; then
      echo "- $type: $type_count 条"
    fi
  done
  
  echo ""
  echo "## 详细记录"
  grep -l "^day-id: $date$" memory/just-note/*/*.md | while read file; do
    cat "$file"
    echo ""
    echo "---"
    echo ""
  done
}

配置

环境变量

配置文件

~/.just-note/config.yaml:

storage: memory/just-note
llm:
  model: qwen3.5-plus
  temperature: 0.3
features:
  auto_tag: true
  auto_relate: true
  daily_summary: true
  weekly_report: true
notifications:
  daily_summary_time: "21:00"
  weekly_report_time: "Sunday 20:00"

最佳实践

1. 记录技巧

• 简短为好 - 一条记录 1-3 句话最佳
• 及时记录 - 灵感来了立刻记
• 不用整理 - AI 会自动分类标签
• 定期回顾 - 每周/每月查看汇总

2. 检索技巧

• 用标签搜 - just-note search "#product"
• 按类型筛 - just-note list --type expense
• 按日期找 - just-note diary --date 2026-03-26

3. 复盘技巧

• 每日回顾 - 睡前查看今日记录
• 每周汇总 - 周末查看周报
• 每月总结 - 月末查看月报

与 flomo 对比

未来规划

阶段 1（MVP）- 1-2 周

• 核心记录功能
• AI 自动分类
• 基础检索
• 每日汇总

阶段 2（增强）- 2-4 周

• 语义检索
• 智能关联
• 收支统计图表
• 导出功能

阶段 3（产品化）- 1-2 月

• Web 界面
• 多端同步
• API 开放
• 插件系统

常见问题

Q: 和 flomo 比有什么优势？

A:

1. AI 自动分类，不用手动标签
2. 支持收支记录和统计
3. 数据存储在本地，完全自主
4. 免费开源

Q: 数据会丢失吗？

A:

• 数据存储在本地 memory/just-note/ 目录
• 建议定期 Git 备份或同步到云端
• 可以导出为 flomo/Obsidian 格式

Q: 分类不准确怎么办？

A:

• 可以手动修改笔记的 type 字段
• 分类准确率会随着使用提升
• 欢迎反馈改进建议

许可证

MIT License

贡献

欢迎提交 Issue 和 PR！

GitHub: https://github.com/your-org/just-note