segundo CLI

零摩擦的第二大脑命令行工具。以带标签和语义搜索的每日Markdown日记形式捕捉想法。使用TypeScript构建，运行于Bun环境。

运行 segundo --help 查看使用详情。

工作流程

1. 1. 初始化 - 首先使用 segundo init 创建大脑
2. 捕捉 - 使用 segundo add 想法 添加想法
3. 检索 - 搜索或列出记忆

命令

init

bash
segundo init
segundo init --reindex # 重建嵌入索引

add

bash
segundo add 阅读《设计数据密集型应用》 --tag book
segundo add 第一行\n第二行
segundo add 想法一 想法二 想法三 # 批量添加
echo 来自管道的想法 | segundo add # 标准输入
cat notes.txt | segundo add --batch # 按空行分割

search

bash
segundo search 餐厅
segundo search 数据 --limit 5 --from 2026-01-01

配置了嵌入提供程序时使用语义搜索，否则回退到文本搜索。

list

bash
segundo list
segundo list --limit 5
segundo list --tag book
segundo list --from 2026-03-01 --to 2026-03-10

edit

bash
segundo edit 新内容
segundo edit id1 内容1 id2 内容2 # 批量编辑

delete

bash
segundo delete
segundo delete id1 id2 id3

import

bash
segundo import notes.md
segundo import ./notes-dir/ --tag imported
segundo import file.txt --dry-run

export

bash
segundo export
segundo export --format json
segundo export --from 2026-03-01 --to 2026-03-10 --tag book

stats

bash
segundo stats

显示总记忆数、日期范围、热门标签、嵌入索引大小和大脑路径。

标签

标签位于条目的最后一行。通过 --tag 标志或内联方式添加：

bash
segundo add 关于一致性的精彩章节\n#book #engineering
segundo add 午餐地点 --tag food

过滤

所有 list/search/export 命令支持：

• - --tag <名称> - 按标签过滤
• --from <日期> - 起始日期（包含）
• --to <日期> - 结束日期（包含）
• --limit - 最大结果数

配置文件

bash
segundo --profile work add 季度评审笔记
segundo --profile personal list
segundo --brain /自定义/路径 list

JSON 输出

所有命令支持 --json 输出结构化数据：

bash
segundo list --json
segundo add 想法 --json
segundo search 查询 --json

存储

记忆存储在 ~/.segundo/memories/ 目录下，以每日Markdown文件形式保存：

~/.segundo/
config.json
memories/
2026-03-10.md
embeddings/
index.bin
meta.json

语义搜索设置

在 ~/.segundo/config.json 中配置：

json
{
embeddings: {
provider: ollama,
model: nomic-embed-text,
ollamaUrl: http://localhost:11434
}
}

支持 Ollama（本地，免费）和 OpenAI（云端，需要 openaiApiKey 或 $OPENAIAPIKEY）。