OV Web Clipper: a local-first Chrome extension for clipping webpages directly into OpenViking

[qianchenga]

大家好，我做了一个直接连接自有 OpenViking 的 Chrome 网页采集扩展 OV Web Clipper，想向社区分享，也请维护者帮忙看看接口使用和兼容性边界。

看到值得留下的文章，可以采集正文或选中文字，在本机检查、编辑和添加独立批注，确认服务器、用户身份和 Resource 位置后再上传。无需 Obsidian 中转，也不修改 OV 核心。

• 源码（MIT）：https://github.com/pengqiancheng-sys/ov-web-clipper
• 安装包与版本说明：https://github.com/pengqiancheng-sys/ov-web-clipper/releases/tag/v0.5.1
• 安装指南：https://github.com/pengqiancheng-sys/ov-web-clipper/blob/main/docs/install.md
• CI 结果：https://github.com/pengqiancheng-sys/ov-web-clipper/actions/runs/41627284005

工作流与边界 / Workflow and boundaries

采集 → 本地预览与批注 → 确认上传 → 查询异步处理状态 → 检索并回读原文。

默认目标是 viking://~/resources/inbox/web-clipper。收藏内容按 Resource 处理，不自动变成个人记忆或 Skill。项目目录不是权限边界，仍由服务端身份与 ACL 控制。API Key 默认保存在浏览器会话存储；可选本机持久保存，但不是加密保险箱。

当前是手动加载的 Chrome MV3 扩展，未上架商店。开发期真实集成验证基于 OV 0.5.3；自动检查覆盖 30 项测试、构建和发布预检，不能替代其他 OV 版本上的真实兼容性验收。请求结果不明时不自动重新提交。

截图使用明确标注的虚构演示资料，不是生产验收凭证。更多设置、上传与回读截图见仓库 README。

English

Hi everyone! I built OV Web Clipper, an independent, local-first Chrome extension for collecting webpages directly into your own OpenViking server, without an Obsidian intermediary or OV core changes.

It extracts article text or selected text locally, preserves source metadata, and lets you review/edit the Markdown and add separate notes. Upload requires explicit confirmation of the server, verified identity and Resource destination. You can then inspect the asynchronous task status and search/read back the resource, checking its source, fingerprint and body boundaries.

The project is MIT licensed, with source, an unpacked-extension ZIP, installation instructions and labeled demo screenshots linked above. Keys use browser session storage by default; optional persistent extension storage is not an encrypted vault. Ambiguous submissions are not automatically retried. Other AI clients still need their own authorized retrieval integration.

Development integration testing used OV 0.5.3. CI passes 30 tests, the extension build and release preflight; this does not establish compatibility with every newer OV release. The extension is not listed in the Chrome Web Store. Screenshots contain fictional demo data, not production acceptance evidence.

希望请教 / Feedback welcome

1. 这种个人网页 Resource 的目录组织方式是否合适？
2. 对临时上传 → Resource 导入 → 异步任务 → 检索回读，有没有更推荐或更稳定的接口约定？
3. 这样的独立扩展是否适合收录到社区生态或集成文档？如果适合，应该提到哪个目录或页面？

We would appreciate feedback on the Resource layout, recommended upload/task/retrieval contracts, and whether there is an appropriate community integrations listing for an independent extension like this. Happy to improve compatibility based on maintainer guidance.

这是社区项目，不代表官方产品或官方认可。项目开发使用了 AI 辅助；代码与验证责任由项目维护者承担。

This is a community project, not an official product or endorsement. Development was AI-assisted; the project maintainer remains responsible for the code and validation.