AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.
HTML ai-agentcloudflarecloudflare-d1cloudflare-r2cloudflare-workersdockerelectronevernoteevernote-alternativeknowledge-basemcpnote-takingobsidian-alternativeoffline-firstpersonal-knowledge-basepwaself-hostedsqlitetiptapweb-clipper
feat(extension): add diagnostics and clarify clipping action
tianma-ifc9fdfe8a304c
diff --git a/apps/extension/STORE_LISTING.md b/apps/extension/STORE_LISTING.mdindex cdf3aa73..4725808e 100644--- a/apps/extension/STORE_LISTING.md+++ b/apps/extension/STORE_LISTING.md@@ -41,7 +41,7 @@ EdgeEver Web Clipper 可以把当前网页或你选中的内容保存到自托- 可选择默认笔记本,并自动添加 `web-clip` 标签。- 网页内容直接发送到你配置的 EdgeEver 实例,不经过开发者的中转服务器。-使用前,请在插件设置中填写 EdgeEver 实例地址和 API Token。插件只会在你点击“保存当前网页”后读取当前标签页,并仅向你授权的 EdgeEver 实例申请网络访问权限。+使用前,请在插件设置中填写 EdgeEver 实例地址和 API Token。插件只会在你点击“剪藏当前网页”后读取当前标签页,并仅向你授权的 EdgeEver 实例申请网络访问权限。EdgeEver 是开源、自托管的现代笔记工作区。项目主页与源代码:https://github.com/tianma-if/edgeever@@ -63,7 +63,7 @@ Key features:- Select a default notebook and add the `web-clip` tag automatically.- Send webpage content directly to your configured EdgeEver instance without a developer-operated relay server.-Before using the extension, enter your EdgeEver instance URL and API token in the extension settings. The extension reads the current tab only after you click “Save current page” and requests network access only for the EdgeEver instance you authorize.+Before using the extension, enter your EdgeEver instance URL and API token in the extension settings. The extension reads the current tab only after you click “Clip current page” and requests network access only for the EdgeEver instance you authorize.EdgeEver is an open-source, self-hosted modern notes workspace. Project homepage and source code: https://github.com/tianma-if/edgeeverdiff --git a/apps/extension/options.html b/apps/extension/options.htmlindex b8512d5c..86e10662 100644--- a/apps/extension/options.html+++ b/apps/extension/options.html@@ -29,6 +29,23 @@</div><p id="status" class="status" role="status"></p></form>+ <section class="diagnostics-panel" aria-labelledby="diagnostics-title">+ <h2 id="diagnostics-title" data-i18n="diagnosticsTitle">About & diagnostics</h2>+ <p class="hint" data-i18n="diagnosticsDescription">View basic extension, browser, system, and connection information. API tokens are never included.</p>+ <dl class="diagnostics-list">+ <div><dt data-i18n="extensionVersion">Extension version</dt><dd id="extension-version">—</dd></div>+ <div><dt data-i18n="manifestVersion">Manifest version</dt><dd id="manifest-version">—</dd></div>+ <div><dt data-i18n="browserVersion">Browser</dt><dd id="browser-version">—</dd></div>+ <div><dt data-i18n="systemVersion">System</dt><dd id="system-version">—</dd></div>+ <div><dt data-i18n="extensionId">Extension ID</dt><dd id="extension-id">—</dd></div>+ <div><dt data-i18n="instanceOrigin">Instance origin</dt><dd id="instance-origin">—</dd></div>+ <div><dt data-i18n="instancePermission">Instance permission</dt><dd id="instance-permission">—</dd></div>+ </dl>+ <div class="diagnostics-actions">+ <button id="copy-diagnostics" type="button" class="secondary" data-i18n="copyDiagnostics">Copy diagnostics</button>+ <span id="copy-status" class="status" role="status"></span>+ </div>+ </section><p class="privacy-link"><a href="https://edgeever.org/privacy" target="_blank" rel="noopener noreferrer" data-i18n="privacyPolicy">Privacy policy</a></p>diff --git a/apps/extension/popup.html b/apps/extension/popup.htmlindex b6f0142f..ea686fa7 100644--- a/apps/extension/popup.html+++ b/apps/extension/popup.html@@ -20,7 +20,7 @@<path d="M5 4.75A1.75 1.75 0 0 1 6.75 3h8.836c.464 0 .91.184 1.238.513l1.663 1.663c.329.328.513.774.513 1.238v12.836A1.75 1.75 0 0 1 17.25 21H6.75A1.75 1.75 0 0 1 5 19.25V4.75Z" /><path d="M8 3v5h7V3M8 21v-7h8v7" /></svg>- <span data-i18n="saveCurrentPage">Save current page</span>+ <span data-i18n="saveCurrentPage">Clip current page</span></button><p id="status" class="status" role="status"></p><button id="settings" class="settings-button" type="button">diff --git a/apps/extension/public/_locales/en/messages.json b/apps/extension/public/_locales/en/messages.jsonindex 4e156981..5db5d5ae 100644--- a/apps/extension/public/_locales/en/messages.json+++ b/apps/extension/public/_locales/en/messages.json@@ -12,10 +12,10 @@"message": "Web Clipper"},"popupDescription": {- "message": "Save the current webpage or selected content to your EdgeEver."+ "message": "Clip the current webpage or selected content to your EdgeEver."},"saveCurrentPage": {- "message": "Save current page"+ "message": "Clip current page"},"pluginSettings": {"message": "Extension settings"@@ -35,6 +35,60 @@"optionsTitle": {"message": "EdgeEver Web Clipper settings"},+ "diagnosticsTitle": {+ "message": "About & diagnostics"+ },+ "diagnosticsDescription": {+ "message": "View basic extension, browser, system, and connection information. API tokens are never included."+ },+ "extensionVersion": {+ "message": "Extension version"+ },+ "manifestVersion": {+ "message": "Manifest version"+ },+ "browserVersion": {+ "message": "Browser"+ },+ "systemVersion": {+ "message": "System"+ },+ "extensionId": {+ "message": "Extension ID"+ },+ "instanceOrigin": {+ "message": "Instance origin"+ },+ "instancePermission": {+ "message": "Instance permission"+ },+ "copyDiagnostics": {+ "message": "Copy diagnostics"+ },+ "diagnosticsCopied": {+ "message": "Diagnostics copied."+ },+ "diagnosticsCopyFailed": {+ "message": "Copy failed. Check the browser clipboard permission."+ },+ "permissionGranted": {+ "message": "Granted"+ },+ "permissionNotGranted": {+ "message": "Not granted"+ },+ "permissionNotConfigured": {+ "message": "Instance not configured"+ },+ "notConfigured": {+ "message": "Not configured"+ },+ "invalidInstanceAddress": {+ "message": "Invalid address"+ },+ "unknownValue": {+ "message": "Unknown"+ },"instanceAddress": {"message": "EdgeEver instance URL"},diff --git a/apps/extension/public/_locales/zh_CN/messages.json b/apps/extension/public/_locales/zh_CN/messages.jsonindex 3dcee0fb..28aaaf1b 100644--- a/apps/extension/public/_locales/zh_CN/messages.json+++ b/apps/extension/public/_locales/zh_CN/messages.json@@ -12,10 +12,10 @@"message": "网页剪藏"},"popupDescription": {- "message": "保存当前网页或选中的内容到你的 EdgeEver。"+ "message": "剪藏当前网页或选中的内容到你的 EdgeEver。"},"saveCurrentPage": {- "message": "保存当前网页"+ "message": "剪藏当前网页"},"pluginSettings": {"message": "插件设置"@@ -35,6 +35,60 @@"optionsTitle": {"message": "EdgeEver Web Clipper 设置"},+ "diagnosticsTitle": {+ "message": "关于与诊断信息"+ },+ "diagnosticsDescription": {+ "message": "查看插件、浏览器、系统和连接信息。不会包含 API Token。"+ },+ "extensionVersion": {+ "message": "插件版本"+ },+ "manifestVersion": {+ "message": "Manifest 版本"+ },+ "browserVersion": {+ "message": "浏览器"+ },+ "systemVersion": {+ "message": "系统"+ },+ "extensionId": {+ "message": "插件 ID"+ },+ "instanceOrigin": {+ "message": "实例 Origin"+ },+ "instancePermission": {+ "message": "实例访问权限"+ },+ "copyDiagnostics": {+ "message": "复制诊断信息"+ },+ "diagnosticsCopied": {+ "message": "诊断信息已复制。"+ },+ "diagnosticsCopyFailed": {+ "message": "复制失败,请检查浏览器剪贴板权限。"+ },+ "permissionGranted": {+ "message": "已授权"+ },+ "permissionNotGranted": {+ "message": "未授权"+ },+ "permissionNotConfigured": {+ "message": "未配置实例"+ },+ "notConfigured": {+ "message": "未配置"+ },+ "invalidInstanceAddress": {+ "message": "地址无效"+ },+ "unknownValue": {+ "message": "未知"+ },"instanceAddress": {"message": "EdgeEver 实例地址"},diff --git a/apps/extension/src/options.ts b/apps/extension/src/options.tsindex a637ece7..2988bcbc 100644--- a/apps/extension/src/options.ts+++ b/apps/extension/src/options.ts@@ -16,6 +16,18 @@ const tokenInput = document.querySelector<HTMLInputElement>("#token");const notebookSelect = document.querySelector("#notebook-id") as NotebookSelect | null;const testButton = document.querySelector<HTMLButtonElement>("#test");const status = document.querySelector<HTMLParagraphElement>("#status");+const copyDiagnosticsButton = document.querySelector<HTMLButtonElement>("#copy-diagnostics");+const copyStatus = document.querySelector<HTMLSpanElement>("#copy-status");++type DiagnosticInfo = {+ extensionVersion: string;+ manifestVersion: string;+ browser: string;+ system: string;+ extensionId: string;+ instanceOrigin: string;+ instancePermission: string;+};const setStatus = (message: string, kind: "normal" | "error" | "success" = "normal") => {if (status) {@@ -30,6 +42,66 @@ const readSettings = (): ExtensionSettings => ({notebookId: notebookSelect?.value ?? "",});+const getBrowserLabel = () => {+ const userAgent = navigator.userAgent;+ const match = userAgent.match(/(Edg|Chrome|Firefox|Version)\/([\d.]+)/);+ if (!match) {+ return userAgent;+ }+ const name = match[1] === "Edg" ? "Microsoft Edge" : match[1] === "Version" ? "Safari" : match[1];+ return `${name} ${match[2]}`;+};++const getInstanceOrigin = (instanceUrl: string) => {+ if (!instanceUrl) {+ return t("notConfigured");+ }+ try {+ return new URL(instanceUrl).origin;+ } catch {+ return t("invalidInstanceAddress");+ }+};++const getDiagnosticInfo = async (settings: ExtensionSettings): Promise<DiagnosticInfo> => {+ const manifest = chrome.runtime.getManifest() as { version?: string };+ const instanceOrigin = getInstanceOrigin(settings.instanceUrl);+ let instancePermission = t("permissionNotConfigured");+ if (instanceOrigin.startsWith("http")) {+ const granted = await chrome.permissions.contains({ origins: [`${instanceOrigin}/*`] });+ instancePermission = granted ? t("permissionGranted") : t("permissionNotGranted");+ }++ return {+ extensionVersion: manifest.version || t("unknownValue"),+ manifestVersion: manifest.version || t("unknownValue"),+ browser: getBrowserLabel(),+ system: `${navigator.platform || t("unknownValue")} (${navigator.language || t("unknownValue")})`,+ extensionId: chrome.runtime.id || t("unknownValue"),+ instanceOrigin,+ instancePermission,+ };+};++const diagnosticText = (info: DiagnosticInfo) => [+ "EdgeEver Web Clipper diagnostics",+ `Extension version: ${info.extensionVersion}`,+ `Manifest version: ${info.manifestVersion}`,+ `Browser: ${info.browser}`,+ `System: ${info.system}`,+ `Extension ID: ${info.extensionId}`,+ `Instance origin: ${info.instanceOrigin}`,+ `Instance permission: ${info.instancePermission}`,+ "Declared permissions: activeTab, scripting, storage",+].join("\n");++const setCopyStatus = (message: string, kind: "normal" | "error" | "success" = "normal") => {+ if (copyStatus) {+ copyStatus.textContent = message;+ copyStatus.dataset.kind = kind;+ }+};+const renderNotebooks = (notebooks: Array<{ id: string; name: string }>, selectedId: string) => {if (!notebookSelect) {return;@@ -47,6 +119,15 @@ const initialize = async () => {if (instanceUrlInput) instanceUrlInput.value = settings.instanceUrl;if (tokenInput) tokenInput.value = settings.token;if (notebookSelect) notebookSelect.value = settings.notebookId;++ const info = await getDiagnosticInfo(settings);+ document.querySelector("#extension-version")!.textContent = info.extensionVersion;+ document.querySelector("#manifest-version")!.textContent = info.manifestVersion;+ document.querySelector("#browser-version")!.textContent = info.browser;+ document.querySelector("#system-version")!.textContent = info.system;+ document.querySelector("#extension-id")!.textContent = info.extensionId;+ document.querySelector("#instance-origin")!.textContent = info.instanceOrigin;+ document.querySelector("#instance-permission")!.textContent = info.instancePermission;};testButton?.addEventListener("click", async () => {@@ -75,4 +156,17 @@ form?.addEventListener("submit", async (event) => {}});+copyDiagnosticsButton?.addEventListener("click", async () => {+ copyDiagnosticsButton.disabled = true;+ try {+ const info = await getDiagnosticInfo(readSettings());+ await navigator.clipboard.writeText(diagnosticText(info));+ setCopyStatus(t("diagnosticsCopied"), "success");+ } catch {+ setCopyStatus(t("diagnosticsCopyFailed"), "error");+ } finally {+ copyDiagnosticsButton.disabled = false;+ }+});+void initialize();diff --git a/apps/extension/src/styles.css b/apps/extension/src/styles.cssindex 67d91af1..90cf0303 100644--- a/apps/extension/src/styles.css+++ b/apps/extension/src/styles.css@@ -109,6 +109,61 @@ h1 {font-size: 22px;}+.diagnostics-panel {+ margin-top: 28px;+ border-top: 1px solid #e2e8f0;+ padding-top: 22px;+}++.diagnostics-panel h2 {+ margin: 0 0 8px;+ font-size: 17px;+}++.diagnostics-list {+ margin: 16px 0 0;+ border: 1px solid #e2e8f0;+ border-radius: 8px;+ background: white;+ overflow: hidden;+}++.diagnostics-list div {+ display: grid;+ grid-template-columns: minmax(150px, 0.8fr) minmax(0, 1.2fr);+ gap: 12px;+ padding: 9px 12px;+ border-bottom: 1px solid #f1f5f9;+ font-size: 12px;+}++.diagnostics-list div:last-child {+ border-bottom: 0;+}++.diagnostics-list dt {+ color: #64748b;+}++.diagnostics-list dd {+ margin: 0;+ overflow-wrap: anywhere;+ color: #172033;+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;+}++.diagnostics-actions {+ display: flex;+ align-items: center;+ gap: 10px;+ margin-top: 12px;+}++.diagnostics-actions .status {+ min-height: 0;+ margin: 0;+}+.hint {margin: 0 0 20px;color: #64748b;