Pensea

Pensea（思海）

打开就做，不胡思乱想

中文 | English

---

你是不是也这样

打开 Obsidian，盯着空白的日记发呆。翻翻昨天的笔记，觉得该整理。又看看收藏夹，太多没分类的东西。想着想着，半小时过去了。

不是没想法，是想法太多，没有一个能落地。

不是不努力，是每天打开软件都不知道先做什么。

Pensea 解决的核心问题就一个：打开就知道做什么，做完就知道下一步。

---

功能介绍

打开就有方向

侧边栏看板，一眼看到今天该做什么：几条灵感待处理、几张卡片该复习、Inbox 里还有多少没归档。不用想，按顺序做就行。

想法不会烂在草稿里

灵感有清晰的生命周期：🫧 待孵化 → 🔥 孵化中 → ✅ 准备好 → 立项。放着不管会变红提醒你。选中任意文字右键就能创建灵感卡片。

知识不再写了就忘

SM-2 间隔重复算法自动排复习。写过的东西会按时回来找你，直到真正记住。

Inbox 不用自己整理

AI 读取 Inbox，自动分类、生成摘要、写入知识库。扔进去就行，剩下的交给 Pensea。

笔记之间不再孤立

对知识库直接提问，AI 检索相关页面综合回答。还能自动检测矛盾、孤儿页面、过时信息。

日记、周报、归档一条龙

月历视图管理日记，周报自动汇总，月度归档合并旧日记并迁移未完成任务。

智能命名

新建笔记写完内容后，AI 自动根据内容生成文件名。不用再想"这篇笔记该叫什么"。

不想开 AI 也能用

看板、日历、复习、周报、归档全部离线可用。LLM 功能是可选增强。

---

安装

手动安装

1. 从 Releases 下载最新版 pensea.zip
2. 解压，得到 main.js、manifest.json、styles.css、versions.json 四个文件
3. 在你的 Obsidian Vault 中找到 .obsidian/plugins/ 目录
4. 新建文件夹 pensea，把四个文件放进去
5. 重启 Obsidian → 设置 → 社区插件 → 找到 Pensea → 开启

BRAT 安装

1. 安装 BRAT 插件
2. BRAT 设置 → Add Beta Plugin → 输入仓库地址 https://github.com/y15865708228-pixel/yang
3. 安装完成后启用 Pensea

---

使用手册

第一步：初始化 Vault

安装后在命令面板（Ctrl/Cmd + P）中搜索并执行：

Pensea: 初始化 Vault 结构

会自动创建以下目录和模板：

你的 Vault/
├── 0-Inbox/          → 所有想法先进这里
├── 1-Projects/       → 有明确目标的项目
├── 2-Areas/          → 长期负责的领域
├── 3-Resources/      → 参考资料
│   └── LLM-Wiki/     → AI 维护的知识库
├── 4-Archive/        → 已完成的内容
├── Sparks/           → 灵感卡片
├── Daily/            → 每日笔记
├── Templates/        → 模板
└── Tasks/            → 任务

第二步：打开看板

点击左侧边栏的 ✨ 图标，或命令面板执行 Pensea: 打开 Sparks 看板。

看板包含：

• 统计卡片：Inbox 数量、灵感总数、待复习卡片、Wiki 页面数
• 快捷操作：处理 Inbox、复习卡片、健康检查、周报、排版整理、续写
• 灵感看板：按状态分组显示所有灵感，支持流转和右键菜单
• 今日概览：月历 + 今日任务进度
• 每日宣言：每日一条易经卦辞

第三步：配置 LLM（可选）

设置 → Pensea → LLM 配置：

1. 选择提供商：下拉菜单选择，自动填充地址和模型
2. 填入 API Key：密钥仅保存在本地，不会上传
3. 点击测试：确认连接成功

支持的提供商：

不配置 LLM 也可以使用：看板、日历、复习、周报、归档全部离线运行。

日常使用流程

每天打开 Obsidian 时：

1. 看一眼侧边栏看板 → 知道今天有什么要做
2. 处理红色高亮的过期灵感 → 决定继续还是放弃
3. 如果有到期复习卡片 → 点"复习卡片"开始复习
4. 点月历上的今天 → 打开日记，开始记录

有新想法时：

• 方式 1：看板顶部输入框，直接输入，回车创建灵感
• 方式 2：在任意笔记中选中文字 → 右键 → "转为灵感"

灵感孵化完成后：

• 点灵感右侧的箭头按钮流转到下一阶段
• ✅ 准备好的灵感可以点"立项"直接创建项目

需要整理笔记时：

• 打开笔记 → 命令面板 → Pensea: 整理笔记排版
• 或 → Pensea: 继续写，AI 帮你分析并给出续写建议

Inbox 堆积时：

• 看板点"处理 Inbox"，AI 自动分类归档
• 或把文件扔进 0-Inbox/ 文件夹，等有空再批量处理

想查知识库时：

• 命令面板 → Pensea: Wiki: 提问
• 在对话框中输入问题，AI 从知识库中检索并回答
• 回答中的 [[双链]] 可以直接点击跳转

---

命令一览

---

常见问题

Q：不配置 AI 能用吗？ A：可以。看板、日历、复习、周报、归档全部离线可用。AI 功能（Inbox 处理、Wiki 问答、排版、续写）是可选增强。

Q：推荐用哪个 AI 提供商？ A：DeepSeek 性价比最高，国内直连无需翻墙。Ollama 完全免费但需要本地部署。OpenAI 效果最好但需翻墙。

Q：API Key 安全吗？ A：密钥仅保存在你本地的 Obsidian 插件配置中，不会发送到任何第三方服务器。

Q：数据存在哪里？ A：所有数据都在你的 Vault 里——笔记是 Markdown 文件，复习记录在插件配置中。没有任何云端依赖。

Q：支持手机端吗？ A：支持。已做移动端适配（响应式布局 + 长按菜单）。将插件文件复制到手机端 Obsidian 的 .obsidian/plugins/pensea/ 目录即可。

---

开发

git clone https://github.com/y15865708228-pixel/yang.git
cd yang
npm install
npm run dev    # 开发模式（热重载）
npm run build  # 生产构建

License

MIT

---

Pensea

Open it and know what to do. No more overthinking.

中文 | English

---

You know the feeling

You open Obsidian and stare at a blank daily note. You scroll through yesterday's notes, think about organizing. You check your bookmarks — too many unsorted items. Before you know it, 30 minutes are gone.

It's not a lack of ideas — it's too many ideas, none of them landing.

It's not laziness — it's opening the app every day without knowing where to start.

Pensea solves one core problem: open it and know exactly what to do next.

---

Features

Direction at a glance

The sidebar kanban shows everything that needs attention: ideas to process, flashcards to review, inbox items to archive. No thinking required — just work through the list.

Ideas don't rot in drafts

Every idea has a clear lifecycle: 🫧 Hatch → 🔥 Incubate → ✅ Ready → Project. Stale ideas turn red. Right-click any text to create a spark card instantly.

Knowledge sticks

SM-2 spaced repetition brings notes back at the right time, until you truly remember them.

Inbox sorts itself

AI reads your inbox, classifies notes, writes summaries, and files them into the knowledge base. Just drop things in.

Notes connect to each other

Ask questions against your knowledge base — AI retrieves relevant pages and synthesizes answers. Detects contradictions, orphan pages, and stale claims automatically.

Journal, weekly reports, archival — handled

Monthly calendar with lunar dates for daily notes. Auto-generated weekly summaries. Monthly archival merges old journals and migrates unfinished tasks.

Smart naming

New notes get auto-named by AI based on content. No more staring at "Untitled" files.

Works without AI

Kanban, calendar, review, reports, archival — all offline. LLM features are optional enhancements.

Mobile support

Responsive layout adapts to phone screens. Long-press replaces right-click menus. Works on Obsidian mobile.

User guide included

Running Pensea: 初始化 Vault 结构 creates a built-in user guide at 3-Resources/Pensea 使用手册.md.

---

Install

Manual

1. Download pensea.zip from Releases
2. Extract to get main.js, manifest.json, styles.css, versions.json
3. Create folder .obsidian/plugins/pensea/ in your vault
4. Copy all 4 files directly into that folder (no nested subfolder)
5. Restart Obsidian → Settings → Community plugins → Enable Pensea

BRAT

1. Install BRAT
2. Add Beta Plugin → https://github.com/y15865708228-pixel/yang
3. Enable Pensea

---

Quick Start

1. Initialize: Command palette (Ctrl/Cmd + P) → Pensea: 初始化 Vault 结构
2. Open kanban: Click ✨ icon in sidebar or run Pensea: 打开 Sparks 看板
3. Configure LLM (optional): Settings → Pensea → Select provider → Enter API Key → Test

Supported providers: OpenAI · DeepSeek · Kimi · MiniMax · GLM · Ollama · Claude · Gemini · Custom

All core features work offline without LLM configuration.

---

FAQ

Q: Does it work without AI? A: Yes. Kanban, calendar, spaced repetition, weekly reports, archival all work offline.

Q: Which AI provider do you recommend? A: DeepSeek for best value. Ollama for free local use. OpenAI for best quality.

Q: Is my API key safe? A: Keys are stored locally in your Obsidian plugin config. Never sent to third parties.

Q: Does it work on mobile? A: Yes. Responsive layout with long-press support. Copy plugin files to your mobile vault's .obsidian/plugins/pensea/ directory.

---

Development

git clone https://github.com/y15865708228-pixel/yang.git
cd yang
npm install
npm run dev
npm run build

License

MIT