Skip to content

Square 0.1.0

Choose a tag to compare

@jiaoyingxing jiaoyingxing released this 20 May 12:13

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
  1. Let BRAT install the latest release.
  2. 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
  1. 让 BRAT 安装最新 release。
  2. 在 Obsidian 设置中启用 Square

也可以手动安装:从本 release 下载 main.jsmanifest.jsonstyles.css,放入 .obsidian/plugins/square/,然后重启 Obsidian 或重新加载第三方插件。

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