ichaly_cohere/README.md
2026-06-04 14:25:59 +08:00

1.4 KiB
Raw Blame History

Obsync

Obsync 是一个 Obsidian 同步插件,目标是通过 OSS / S3 兼容对象存储在多端同步 vault 文件。

当前仓库已经完成插件基础骨架和 MVP 设计文档。第一阶段实现目标是一个简单可靠的同步模型:

manifest.json + files/<path> + locks/sync.lock

当前已实现:

vaultId / deviceId 生成
连接配置复制
本地文件扫描
manifest 冲突判断
S3-compatible SigV4 对象存储 adapter
手动同步命令

详细方案见:docs/obsidian-oss-sync-mvp.md

开发

pnpm install
pnpm test
pnpm run build

构建栈:

Vite 8
Vue 3
Tailwind CSS 4
SCSS
TypeScript 6
pnpm

构建产物:

dist/main.js
dist/main.css

安装到 Obsidian 时,需要复制:

manifest.json
dist/main.js
dist/main.css

到目标 vault 的插件目录,并把 dist/main.css 放置为 Obsidian 识别的 styles.css

<vault>/.obsidian/plugins/obsync/
  manifest.json
  main.js
  styles.css

也可以使用安装脚本:

pnpm run build
pnpm install-plugin "/path/to/your-vault"

插件 ID

obsync

发布

推送版本 tag 会触发 GitHub Actions 自动发布:

git tag v0.1.0
git push origin v0.1.0

Release 会上传:

manifest.json
main.js
styles.css

发布前可以本地检查:

pnpm run build
pnpm run release:check