# Clip To Discourse Chrome 扩展 - 现已支持用户 API！

**URL:** https://meta.discourse.org/t/clip-to-discourse-chrome-extension-now-with-user-api-capability/392335
**Category:** Extras
**Tags:** rest-api, user-api, web-clip
**Created:** [2025年十二月29日 16:04 UTC](https://meta.discourse.org/t/clip-to-discourse-chrome-extension-now-with-user-api-capability/392335 "2025-12-29T16:04:13Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![pacharanero](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pacharanero/32/500583_2.png) [@pacharanero](https://meta.discourse.org/u/pacharanero)
#### Post date: [2025年十二月29日 16:04 UTC](https://meta.discourse.org/t/clip-to-discourse-chrome-extension-now-with-user-api-capability/392335/1 "2025-12-29T16:04:13Z")

</div>

亲爱的 Discourse 社区朋友们，这是我为大家准备的圣诞小礼物 🎁。它很简单但很实用，完全是因为我自己想要才做的。

受 [Simon Willison 关于使用 LLM 进行开发的精彩博客](https://simonwillison.net/2025/Dec/15/porting-justhtml/) 的启发，我在圣诞节期间，在参加社交活动、看电影和包装礼物之余，用“氛围编程”（vibe-coding）的方式完成了这个项目。我 **没有** 编写任何代码，但我_确实_审查了代码并监督了 LLM。所有内容都是由 `spec.md` 和 `roadmap.md` 驱动的。

> **[Clip To Discourse - Chrome Web Store](https://chromewebstore.google.com/detail/clip-to-discourse/copdhiejkkdblhdcdjapcoalldkondhi)**
>
> Clip web pages to your personal Discourse instance via API

### 它是做什么的？

我使用自托管的个人 [Discourse](https://bawmedical.co.uk/) 作为 [笔记本](https://meta.discourse.org/t/using-a-private-discourse-as-our-own-notebook/231865/3)、[日记](https://bawmedical.co.uk/t/discourse-as-a-personal-journal/1261)、博客、简历、Wiki、AI 工具以及开发者知识库。我经常发现自己希望从网页上“剪藏”（clip）内容，并直接将其放入我的 Discourse 中，以便将其整合到笔记或日记条目中。

Clip To Discourse 现在支持四种剪藏样式：页面标题 + URL、标题 + URL + 摘录、完整页面文本以及选中文本。

## 隐私

- 开发者不会收集您使用该扩展程序的数据。
- 剪藏的内容和凭据直接从您的浏览器发送到您配置的 Discourse 实例。
- 不涉及任何 Clip To Discourse 中间服务。
- 配置文件和凭据存储在您设备的 Chrome 扩展程序存储中。
- 开源。GitHub 仓库：[GitHub - koloki-co/clip-to-discourse-chromium-extension: A Chromium Browser extension which clips web content to your private Discourse. · GitHub](https://github.com/koloki-co/clip-to-discourse-chromium-extension)

## 功能

- 将页面剪藏为标题 + URL、标题 + URL + 摘录、完整页面文本或选中文本。
- 每次剪藏都创建 **新主题** ，或者将剪藏内容作为回复添加到 **现有主题** 中。
- 通过 Discourse 用户 API 进行授权，无需管理员创建 API 密钥。管理员提供的用户范围 API 密钥仍可作为备用方案。
- 支持多个配置文件，用于不同的 Discourse 实例、用户、凭据、模板和默认设置。配置文件可以重命名、复制或删除。
- 从连接账户可用的类别中选择目标类别。
- 使用页面元数据、摘录、全文、选中文本和日期占位符来自定义标题和正文模板。
- 选择系统、浅色或深色外观。
- 可选地将 Clip To Discourse 工具栏图标更改为所选配置文件的站点 favicon，以便轻松识别您正在剪藏到 **哪里** 。
- 使用 `Ctrl+Shift+K`（macOS 上为 `Command+Shift+K`）打开弹出窗口，可在 `chrome://extensions/shortcuts` 中配置。

### 局限性

- Discourse 站点必须启用用户 API 密钥，并允许您账户所在的组进行授权。如果无法使用用户 API 授权，站点管理员可以提供具有细粒度权限的单用户 API 密钥。
- 显然，如果 Clip To Discourse 功能被启用给太多用户，它可能会在共享或公共 Discourse 实例上产生大量低质量的帖子。因此，我主要将该扩展程序面向像我一样将 Discourse 用作个人笔记本的用户。

### 如何安装

- 通过 Chrome 应用商店在 Chrome 或其他兼容的基于 Chromium 的浏览器（版本 127 或更高）中安装：[https://chromewebstore.google.com/detail/clip-to-discourse/copdhiejkkdblhdcdjapcoalldkondhi](https://chromewebstore.google.com/detail/clip-to-discourse/copdhiejkkdblhdcdjapcoalldkondhi)
- 可选地将扩展程序“固定”到浏览器工具栏。
- 点击扩展程序图标，打开 **设置** ，并输入您的 Discourse 基础 URL。
- 选择 **用户 API** 并点击 **授权 Clip To Discourse** 。登录您的 Discourse 账户，如果要求，请输入显示的设备代码，并批准访问。
- 如果无法使用用户 API 授权，请使用 **管理员 API 密钥** 选项卡，并输入管理员提供的单用户 API 密钥。避免使用全局 API 密钥。
- 选择您的默认剪藏样式、目标、类别或现有主题 ID，并可选地自定义模板。
- 保存设置并可选地测试连接。
- 关闭设置，剪藏一些内容以进行测试！

### 授权 Clip To Discourse

 ![userauth-01-authorizing-the-user-api](https://global.discourse-cdn.com/meta/original/4X/b/9/4/b94a4b035d2f9e06cc89a3c91ae0e7bbd7cb3026.png)  
 ![userauth-02-enter-this-code-in-discourse](https://global.discourse-cdn.com/meta/original/4X/1/7/d/17d479f4d712599e4389f641eae891d60f8dd81a.png)  
 ![userauth-03-authorize-the-extension-koloki-demo-discourse](https://global.discourse-cdn.com/meta/original/4X/8/a/a/8aa1fdaf3320a6c247790c42c8901389a00aa25c.png)  
 ![userauth-04-authorization-complete](https://global.discourse-cdn.com/meta/original/4X/8/f/d/8fdb43e414e7288986a047b46875d79aaa80f37d.png)

### 剪藏到 Discourse

 ![clipping-01-clip-to-discourse-popup](https://global.discourse-cdn.com/meta/original/4X/6/8/6/6861bea18e5e56b94612ee0917ac6329f4c83053.png)  
 ![clipping-02-the-clipped-page-koloki-demo-discourse](https://global.discourse-cdn.com/meta/original/4X/1/2/7/1278b59a5825508eec1f5b63113db36e9c3a98d3.png)

### 路线图

- 我不打算开发 Firefox 或 Safari 扩展程序（因为我不使用这些浏览器），但我很乐意看到有人接手移植此扩展程序的任务。我们可以合作，将所有内容保留在一个仓库中并保持功能对等。
- 可能的未来添加包括标签、额外的键盘快捷键以及进一步的剪藏工作流程改进。

### 相关讨论

请求基本上是这个工具的帖子：[Chrome/Firefox extension “Share to discourse” - #28 by supermathie](https://meta.discourse.org/t/chrome-firefox-extension-share-to-discourse/21104/28)

一个相关的帖子，建议在 **剪藏** Discourse 帖子时增加额外功能：[Need Web Clipper for Discourse Post](https://meta.discourse.org/t/need-web-clipper-for-discourse-post/45105)

社交分享是一个相关的概念，但使用简单的 URL：[Social Share](https://meta.discourse.org/t/social-share/89980)

### 反馈、想法和贡献

这个主题是一个放置您任何反馈的好地方。只要这些改进不会使扩展程序过于复杂和/或对我变得不那么有用，我就对改进的想法持开放态度！

如果您想打开问题或提交 PR，GitHub 仓库在这里：

> **[GitHub - koloki-co/clip-to-discourse-chromium-extension: A Chromium Browser extension which clips web...](https://github.com/koloki-co/clip-to-discourse-chromium-extension)**
>
> A Chromium Browser extension which clips web content to your private Discourse.

> 此扩展程序是一个免费、开源且注重隐私的工具，由我的公司 [Koloki.co](https://koloki.co) 为 Discourse 社区创建。

---

_[View the full topic](https://meta.discourse.org/t/clip-to-discourse-chrome-extension-now-with-user-api-capability/392335)._