Square 0.2.1

主面板打卡

• 点击项目方块后会立即显示打卡结果，不再等待文件写入完成才更新。
• 连续快速点击不同项目时，主面板不会再被无关刷新打断。
• 桌面端项目方块增加轻微悬停反馈。

侧栏统计与总览

• 首次启用 Square 后，会自动在右侧栏准备统计页面，不再需要先手动执行“打开统计”。
• 移除重复的主区总览命令，总览入口统一由右侧栏统计承接。
• 调整周视图、月视图和排行榜的背景、间距与单行布局。
• 原生总览样式与旧代码块样式进一步隔离，避免旧样式污染当前界面。

移动端与设置

• 移除 iPhone 快速记录弹框底部重复叠加的安全区间距。
• 设置页“关于”新增 GitHub 和小红书联系按钮，可直接联系作者。

Square 0.2.0

Square 0.2.0 - 图表显示、记录弹框和设置入口更新

This Release

这版对应 2026-06-01 发布的 0.2.0。

相对 0.1.1，这次主要处理三块：顶部图表在阅读模式下的显示，快速记录弹框的使用过程，以及设置里的授权和项目入口。

Highlights

📈 顶部图表

• 顶部图表在阅读模式和编辑模式下都能显示。
• 之前那种编辑状态能看到、阅读模式却不显示的情况，这版已经收掉。

📱 快速记录弹框

• 手机端关闭弹框时会直接收起，不再拖着一个明显的下移动画。
• 项目名改挂到官方标题区，宽度、位置和圆角也回到官方 modal 宿主上处理。
• 内容过长时，中间表单区可以单独滚动；底部 附件 / 打开 / 设置 / 保存 固定在底部，不用翻到最下面再点。
• 记录字段和固定字段的提示文字改浅，Android 和 iPhone 的输入显示一并对齐。

⚙️ 设置、授权与项目入口

• Square 设置页现在可以直接填写授权码，不用再绕去 Secret 选择页。
• 从主页点 +，或长按项目后进入设置，都会直接打开对应的创建 / 编辑页面。
• 创建 / 编辑页面改成表单区滚动、底部动作区固定；取消会直接关闭当前页，不再先退回主设置页。

Notes

• 这是相对 0.1.1（2026-05-30）的版本更新。
• 项目和记录仍写在原来的 Markdown 笔记里，不需要迁移数据。
• 安装文件仍然是 main.js、manifest.json、styles.css。
• 推荐通过 BRAT 安装或更新；也可以从 GitHub Releases 手动下载这三个文件覆盖安装。
• 最低 Obsidian 版本要求仍是 1.11.4。
• Obsidian 官方插件商店目前不支持这类非开源插件上架，所以 Square 仍通过 GitHub Releases 或 BRAT 分发。

Square 0.1.1

Square 0.1.1 - 启动开关与旧图表提示清理

This Release

这版对应 2026-05-30 发布的 0.1.1。

相对 0.1.0，范围很小，主要补两个点：启动时打开 Square 的开关，以及顶部图表旧提示的清理。

Highlights

⚙️ 启动方式

• 设置页新增“启动时打开 Square”。
• 开启后，Obsidian 启动完成会直接打开 Square 主页，不会顺带打开侧栏总览。

📈 顶部图表提示

• 新写入的项目图表锚点不再附带“打开阅读模式可以查看顶部图表”这句旧提示。
• 旧笔记里的这句提示仍可被识别和清理，不会因为这次调整打乱已有内容。

Notes

• 这是相对 0.1.0（2026-05-20）的补充版本。
• 项目和记录仍写在原来的 Markdown 笔记里，不需要迁移数据。
• 安装文件仍然是 main.js、manifest.json、styles.css。
• 最低 Obsidian 版本要求仍是 1.11.4。

Square 0.1.0

Square 0.1.0

First public installable release of Square for Obsidian.

Square 0.1.0 includes the full core flow: visual check-in board, Markdown project notes, quick recording, overview charts, archive management, future planning, mobile support, and local license validation.

✨ Main Features

Board And Recording

• Open a lightweight visual board and record daily actions with small project blocks.
• Tap or long-press a block to record quickly.
• Use text, date, count, fixed fields, and attachments in the quick record modal.
• Drag to reorder projects, and move projects between the daily board and the archive area.

Overview And Planning

• Review records through week, month, and ranking views.
• Arrange future dates from the month view, so selected projects appear only when planned.
• Keep overview charts as a review layer, instead of making the main board heavier.

Projects And Templates

• Create projects from built-in templates for single check-ins, repeated counts, target progress, heatmaps, and trends.
• Keep each project as a normal Markdown note in your Obsidian vault.
• Archive paused or finished projects without turning Square into a heavy management page.

Migration And Compatibility

• Use built-in commands to check old Square chart blocks, repair project charts, and hide project properties.
• Square uses its own square-chart block and does not take over dataviewjs, so it can coexist better with Dataview.

Mobile And Experience Polish

• Mobile long-press opens the quick record modal directly, without an extra bottom action sheet.
• Dragging into the archive area has been tuned to reduce first-frame placement flicker.
• Android input placeholders and date alignment have been adjusted for clearer mobile display.

License And Storage

• License keys are stored through Obsidian SecretStorage and verified locally.
• The free state supports up to 2 projects.
• A license unlocks broader project use and future planning.

📦 Installation

Recommended: install with BRAT.

1. Install BRAT from Obsidian's community plugins.
2. Open BRAT settings and choose Add Beta plugin.
3. Add this repository:

https://github.com/jiaoyingxing/square

4. Let BRAT install the latest release.
5. Enable Square in Obsidian settings.

Manual install is also available: download main.js, manifest.json, and styles.css from this release, put them into .obsidian/plugins/square/, then restart Obsidian or reload community plugins.

Because the current Obsidian Community Plugins rules require listed plugins to be open source, Square is distributed through GitHub Releases instead of the official plugin store in this release.

---

Square 0.1.0 中文说明

Square 小方块的第一个公开安装版本。

这一版已经包含完整主流程：小方块主界面、Markdown 项目笔记、快速记录、总览图表、归档、未来排期、移动端支持和本地授权验证。

✨ 主要功能

主界面与记录

• 打开轻量的小方块主界面，用一个个项目方块记录日常行动。
• 点击或长按方块快速记录。
• 在快速记录弹窗里填写文字、日期、次数、固定字段和附件。
• 支持拖拽调整顺序，也可以把项目在日常区和归档区之间移动。

总览与未来排期

• 通过周视图、月视图和排行视图回看记录。
• 在月视图里安排未来日期，让指定项目只在计划日期显示。
• 总览图表作为回看层存在，不把主界面变重。

项目与模板

• 用内置模板创建项目，支持单次打卡、多次累计、目标进度、热力图和趋势图。
• 每个项目都保存为 Obsidian 笔记库里的普通 Markdown 笔记。
• 可以归档暂停或结束的项目，但不把归档做成厚重后台。

迁移与兼容

• 从旧版 Square 迁移时，可以用内置命令检查旧图表、修复项目图表、隐藏项目属性。
• Square 使用自己的 square-chart，不再接管 dataviewjs，可以更稳地和 Dataview 共存。

移动端与体验打磨

• 手机端长按方块会直接打开快速记录弹窗，不再额外弹出底部菜单。
• 拖入归档区时优化了落点判断，减少刚进入归档时的位置闪烁。
• Android 上的输入提示和日期居中显示做了单独修正。

授权与存储

• 授权密钥通过 Obsidian SecretStorage 本地保存和验证。
• 未授权状态最多使用 2 个项目。
• 授权后可以解锁更多项目和未来排期。

📦 安装

推荐用 BRAT 安装和更新：

1. 从 Obsidian 第三方插件里安装 BRAT。
2. 打开 BRAT 设置，选择 Add Beta plugin。
3. 添加这个仓库：

https://github.com/jiaoyingxing/square

4. 让 BRAT 安装最新 release。
5. 在 Obsidian 设置中启用 Square。

也可以手动安装：从本 release 下载 main.js、manifest.json 和 styles.css，放入 .obsidian/plugins/square/，然后重启 Obsidian 或重新加载第三方插件。

由于当前 Obsidian 官方插件商店规则要求上架插件开源，Square 在这个版本通过 GitHub Releases 分发，不走官方插件商店。