亲爱的 Discourse 社区朋友们，这是我为大家准备的圣诞小礼物 
。它很简单但很实用，完全是因为我自己想要才做的。
受 Simon Willison 关于使用 LLM 进行开发的精彩博客 的启发，我在圣诞节期间，在参加社交活动、看电影和包装礼物之余，用“氛围编程”（vibe-coding）的方式完成了这个项目。我没有编写任何代码，但我确实审查了代码并监督了 LLM。所有内容都是由 spec.md 和 roadmap.md 驱动的。
它是做什么的？
我使用自托管的个人 Discourse 作为 笔记本、日记、博客、简历、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
功能
- 将页面剪藏为标题 + 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
- 可选地将扩展程序“固定”到浏览器工具栏。
- 点击扩展程序图标，打开设置，并输入您的 Discourse 基础 URL。
- 选择用户 API 并点击授权 Clip To Discourse。登录您的 Discourse 账户，如果要求，请输入显示的设备代码，并批准访问。
- 如果无法使用用户 API 授权，请使用管理员 API 密钥选项卡，并输入管理员提供的单用户 API 密钥。避免使用全局 API 密钥。
- 选择您的默认剪藏样式、目标、类别或现有主题 ID，并可选地自定义模板。
- 保存设置并可选地测试连接。
- 关闭设置，剪藏一些内容以进行测试！
授权 Clip To Discourse
剪藏到 Discourse
路线图
- 我不打算开发 Firefox 或 Safari 扩展程序（因为我不使用这些浏览器），但我很乐意看到有人接手移植此扩展程序的任务。我们可以合作，将所有内容保留在一个仓库中并保持功能对等。
- 可能的未来添加包括标签、额外的键盘快捷键以及进一步的剪藏工作流程改进。
相关讨论
请求基本上是这个工具的帖子：Chrome/Firefox extension “Share to discourse” - #28 by supermathie
一个相关的帖子，建议在剪藏 Discourse 帖子时增加额外功能：Need Web Clipper for Discourse Post
社交分享是一个相关的概念，但使用简单的 URL：Social Share
反馈、想法和贡献
这个主题是一个放置您任何反馈的好地方。只要这些改进不会使扩展程序过于复杂和/或对我变得不那么有用，我就对改进的想法持开放态度！
如果您想打开问题或提交 PR，GitHub 仓库在这里：
此扩展程序是一个免费、开源且注重隐私的工具，由我的公司 Koloki.co 为 Discourse 社区创建。
