PlainLedger

PlainLedger

付费 · 48 小时试用 · ¥39.9 永久激活 Obsidian 独立记账面板（LifeOS）。账单、分类、订阅规则保存在库内 JSON，随库同步。 当前公开版本：4.0.29 · 48 小时试用

定价与购买

LifeOS 三插件互跳

同一作者的 LifeOS 系列，可在社区插件里互相打开，或前往 GitHub：

安装

社区插件

设置 → 第三方插件 → 浏览 → 搜索 PlainLedger → 安装 → 启用。

BRAT

1. 安装并启用 BRAT
2. 添加仓库：

https://github.com/xileshuo/plain-ledger-obsidian

3. 启用插件；之后可用 BRAT 检查更新。

手动安装

下载 Latest Release 的 main.js、manifest.json 到 .obsidian/plugins/plain-ledger/。

使用说明

PlainLedger 是运行在 Obsidian 里的独立记账面板——账单、分类、订阅规则都保存在你的库内 JSON，随 Obsidian / iCloud / Git 同步，不依赖第三方账 App，也不把数据上传到云端服务。

和记帐 App 的区别：

```text 记帐 App：数据在 App 里，和笔记割裂 PlainLedger：数据在库里，和日记 / 项目 / 复盘同屏共存 ```

核心优势一览：

---

目录

• 一、PlainLedger 适合谁
• 二、安装与文件说明
• 三、如何打开面板
• 四、公版与体验版激活
• 五、记一笔：三种方式
• 六、账本：一眼看懂本月
• 七、账本 · 统计 · 报表
• 八、订阅 · 待入账 · 周期
• 九、设置页说明
• 十、数据文件与备份
• 十一、更新说明
• 十二、常见问题

---

一、PlainLedger 适合谁

• 已经在用 Obsidian 管理生活 / 工作，希望记账和笔记在同一体系
• 不想 monthly 再开一个 App，又希望有预算、趋势、报表、日历
• 需要订阅 / 续费 / 分期提醒，而不是只记流水
• 重视数据所有权——JSON 在本地，导出 Excel / CSV 随时可做

---

二、安装与文件说明

最小安装（推荐）：

```text 你的库/.obsidian/plugins/plain-ledger/ ├── main.js ├── manifest.json ├── styles.css └── default-ledger.json ← 公版样例 / 可选 ```

可选： `vendor/lang/` 仅在使用截图 OCR 且希望离线识别时需要；不用截图可省略。

自动生成（无需打包）：

安装后在 设置 → 第三方插件 启用 PlainLedger，建议重载一次。

---

三、如何打开面板

• 左侧 Ribbon 钱包图标
• 命令面板：打开 PlainLedger 面板 / 记一笔
• 底部 Tab：账本 · 统计 · 记一笔 · 报表 · 设置（记一笔为底栏居中按钮）
• iOS 快捷指令：主屏幕或背面轻点 → 打开 URL `obsidian://plainledger?action=capture`（设置 → 快捷指令 可复制；说明见《PlainLedger快捷指令使用指南》）

---

四、公版与体验版激活

个人版无需激活，首次打开即可使用。

公版（需激活码）

1. 安装并启用插件后，首次打开会自动加载完整分类（18 类 · 117 二级）与 6 笔示意账单
2. 在侧边栏激活页复制设备指纹 `PLG-XXXXXXXX`（绑定 Obsidian 库名称）
3. 发给作者获取 `KEY-XXXXXXXX`，输入激活码并点击 激活
4. 激活成功后 永久有效（同一库 Mac / iPhone 共享）

体验版（48 小时试用）

1. 安装并启用后，在侧边栏激活页点击 「开启 48 小时试用」
2. 点击后 自动注入 完整分类（18 类 · 117 二级）与 6 笔示意账单，无需手动恢复样例
3. 试用期间全功能可用；到期后须输入激活码才能继续记账，库内数据不会丢失
4. 试用中可随时输入激活码转为永久版

更新日志与完整使用说明不会在启动时自动弹出；请在激活页或 设置 → 关于 手动打开。

---

五、记一笔：三种方式

智能录入（推荐）

输入自然语言，例如：

```text 午餐 28 餐饮 打车 35 交通 工资 15000 工作收入 ```

支持金额、分类关键词、时间词（昨天 / 上周三等）。可在 设置 → 全局关键词 定制映射。

手动录入

选一级 / 二级分类、金额、时间、备注、是否报销等，适合精确补账。

截图 OCR

粘贴支付宝 / 微信账单截图，自动识别金额与商户（首次需准备 OCR 语言包，可离线 `vendor/lang` 或联网下载）。

---

六、账本：一眼看懂本月

• 本月支出：当前自然月支出合计，右侧显示收入与月度结余；支出旁显示较上月环比
• 月度结余：当月真实收支（不含月结结转行）
• 年累计结余：当年 1 月起累计（不含结转）
• 预算环：设置本月预算后显示进度，超支高亮
• 待入账：订阅 / 周期到期项，一点入账
• 账单列表：按日分组，支持搜索、分类筛选、报销筛选

月结行： 每月 1 日系统自动生成，只读；日合计「支」不含月结。可在 设置 → 基础与预算 → 月结自动结转 关闭。

---

七、账本 · 统计 · 报表

各页「结余 / 支出」口径与账本一致，避免不同 Tab 数字对不上。

---

八、订阅 · 待入账 · 周期

在 设置 → 规则 Tab（与常用、分类、数据并列）：

• 订阅服务：Netflix、iCloud+ 等续费周期，到期进入待入账
• 周期 / 分期：固定周期扣款或分期计划
• 待入账：首页与设置均可一键确认入账

适合管理「还没扣款但已知将要发生」的支出，避免月底才发现漏记。

---

九、设置页说明

Obsidian 设置 → 第三方插件 → PlainLedger 与面板激活页 高级配置 为同一入口。桌面端标题格式为 PlainLedger 配置 · 个人版 v4.0.4（版本号在标题末尾）。

公版首次打开或体验版 开启试用 后，内置完整分类体系（18 类 · 117 二级）与 6 笔示意账单；激活后 分类 Tab 默认展开。

---

十、数据文件与备份

建议： 定期 设置 → 数据管理 → 导出 JSON；大改前先导出一版。

导入支持 PlainLedger JSON（整包替换）与 Excel（默认合并流水，保留订阅 / 周期规则）。

---

十一、更新日志

升级后不会在启动时自动弹出更新日志。

随时可在 设置 → 关于 → 更新日志 或激活页手动打开（本次更新默认展开，历史版本折叠）。

---

十二、常见问题

Q：体验版需要手动导入样例吗？

不需要。点击 「开启 48 小时试用」 后会自动写入分类与 6 笔示意账单。

Q：公版样例数据能删吗？

可以。激活后清空或导入自己的 Excel / JSON 即可。

Q：为什么没有 data.json？

`data.json` 是 Obsidian 在保存设置时自动生成的，安装包里没有是正常的。

Q：vendor 文件夹必须吗？

不必须。只有截图 OCR 且希望离线识别时才需要 `vendor/lang/`。

Q：升级后还会自动弹使用说明或更新日志吗？

不会。启动时不再自动弹出任何引导或更新弹窗；使用说明、更新日志均在激活页或 设置 → 关于 手动打开。

---

一句话总结

Obsidian 是你的知识库，PlainLedger 是你的账本——数据留在库里，记一笔、看统计、管订阅，都在同一个面板完成。

更新日志

4.0.28

• 审核：首启卡改回浏览器 localStorage，消除 no-unsupported-api；保留 iconfont/favicon/OCR CDN

4.0.27

• 恢复：iconfont 在线搜索、订阅 favicon、OCR 语言包 CDN（产品能力保留）
• 保留：设置页无 inline !important、英文 description、CSS 审核清理

4.0.26

• 审核：设置页 inline !important 清理与英文 description（Scorecard）
• 审核：CSS 去掉 !important / :has

4.0.25

• 体验：首启 / 套装提示可点「去了解」打开套装说明，不再误关卡片
• 设置：数据文件行不再被 Setting 控件挡字；锁定提示与中文 Notice 对齐
• 外观：手机底栏 inset 滞回更稳；设置页顶距与 LifeOS 一致

4.0.24

• 外观：设置内二级弹层标题左右内边距，避免贴边

4.0.23

• 修复：设置里点编辑/iconfont 被设置窗盖住（改用 Obsidian 原生 Modal 叠层）
• 外观：设置页与相关滚动区统一无痕滚动（隐藏滚动条）

4.0.22

• 修复：Obsidian 设置里点编辑/iconfont 时二级面板被设置窗盖住（Popover 顶层 + 挂进 .modal）

4.0.21

• 修复：侧栏切到 PlainLedger 时 inset 观察过宽导致界面卡顿
• 修复：设置内更换图标时二级面板挂到设置模态最上层（对齐折柳叠层逻辑）
• 外观：导航彩色图标与侧栏钱包图标恢复为 4.0.3

---

分发说明

本仓库用于社区插件 / BRAT / GitHub Release 分发与产品介绍，并附带 src/ 等源码便于社区审核。 仓库：https://github.com/xileshuo/plain-ledger-obsidian 下方为英文说明（社区审核）。

PlainLedger

Paid · 48-hour trial · ¥39.9 permanent unlock

Overview

PlainLedger is a paid LifeOS ledger panel for Obsidian. Bills, categories, and subscription rules stay in vault JSON and sync with your vault.

Current public build: 4.0.29 (48-hour trial).

LifeOS family

Companion plugins by the same author — open each other in Community Plugins, or on GitHub:

Pricing

Installation

Community plugins

Settings → Community plugins → Browse → search PlainLedger → Install → Enable.

BRAT

1. Install and enable BRAT
2. Add this repository:

https://github.com/xileshuo/plain-ledger-obsidian

3. Enable the plugin; use BRAT to check for updates later.

Manual install

Download main.js and manifest.json from the Latest Release into .obsidian/plugins/plain-ledger/.

Usage

1. Enable PlainLedger and open it from the left ribbon (or the command palette).
2. Start the 48-hour trial from the in-plugin activation panel when prompted.
3. Use the sidebar / main panel for daily work; full help is also available inside Settings → Usage guide.
4. After the trial ends, copy your device fingerprint and unlock with a purchased activation code.

Links

• Author: https://github.com/xileshuo
• Repository: https://github.com/xileshuo/plain-ledger-obsidian
• Buy / support: Xiaohongshu (contact the author for an activation code)