{status.urls.length > 0 && (
@@ -92,13 +109,7 @@ export function LocalApiSettings(): JSX.Element {
)}
{t.localapi.port}
- setPort(e.target.value.replace(/\D/g, ''))}
- onBlur={commitPort}
- onKeyDown={(e) => { if (e.key === 'Enter') commitPort() }}
- className="w-20 h-6 px-2 rounded bg-raised border border-line text-caption text-ink tabular-nums focus:outline-none focus:border-accent/50"
- />
+ {portInput}
{t.localapi.passwordLabel}
diff --git a/src/renderer/src/lib/webLinks.ts b/src/renderer/src/lib/webLinks.ts
index 3c50e7f..2a4dbdb 100644
--- a/src/renderer/src/lib/webLinks.ts
+++ b/src/renderer/src/lib/webLinks.ts
@@ -2,18 +2,16 @@ import { useEffect, useState } from 'react'
import { IS_WEB } from './platform'
/**
- * 网页链接（http://…/open?…，见 shared/deeplink.ts）的基址：
- * - 网页版：当前站点（NAS 地址 / 桌面"本地接口"地址），浏览器里打开就是这个
- * - 桌面版："本地接口"在跑时取它的地址 —— 开了局域网访问优先给局域网地址（手机、别的电脑能点开），
- * 否则 127.0.0.1；没开本地接口返回 null，界面不出"拷贝网页链接"
+ * "拷贝链接"的基址（链接形如 http://…/open?…，见 shared/deeplink.ts）：
+ * - 网页版：当前站点（NAS 地址 / 桌面"本地接口"地址）
+ * - 桌面版：常驻链接服务的地址 —— 开了局域网访问给局域网地址（手机、别的电脑能点开），否则 localhost；
+ * 服务没起来（端口被占）返回 null，拷贝项置灰并说明原因
+ * 一律给 http 链接而不是 vixel://：笔记、聊天、文档软件都能识别成链接（高亮、可点）
*/
export async function webLinkBase(): Promise {
if (IS_WEB) return location.origin
try {
- const s = await window.api.localApi.status()
- if (!s.running || s.urls.length === 0) return null
- const lan = s.lan ? s.urls.find((u) => !/\/\/(127\.0\.0\.1|localhost|\[::1\])/.test(u)) : undefined
- return lan ?? s.urls[0]
+ return (await window.api.localApi.status()).linkBase
} catch {
return null
}
diff --git a/src/server/app.test.ts b/src/server/app.test.ts
index f725954..1fad70c 100644
--- a/src/server/app.test.ts
+++ b/src/server/app.test.ts
@@ -1,5 +1,8 @@
import { describe, it, expect } from 'vitest'
-import { loopbackHost } from './app'
+import { networkInterfaces } from 'node:os'
+import type { IncomingMessage } from 'node:http'
+import { isLocalRequest, loopbackHost } from './app'
+import { renderOpenedPage } from './webapp'
describe('loopbackHost (DNS rebinding guard for the password-less local API)', () => {
it('accepts loopback hosts with or without a port', () => {
@@ -13,3 +16,27 @@ describe('loopbackHost (DNS rebinding guard for the password-less local API)', (
}
})
})
+
+describe('isLocalRequest (who gets "open in Vixel" instead of the web view)', () => {
+ const from = (remoteAddress: string) => ({ socket: { remoteAddress } }) as Pick
+ it('treats loopback (incl. IPv4-mapped) and this machine\'s own interface addresses as local', () => {
+ expect(isLocalRequest(from('127.0.0.1'))).toBe(true)
+ expect(isLocalRequest(from('::ffff:127.0.0.1'))).toBe(true)
+ expect(isLocalRequest(from('::1'))).toBe(true)
+ const own = Object.values(networkInterfaces()).flat().find((a) => a && !a.internal)
+ if (own) expect(isLocalRequest(from(own.address))).toBe(true)
+ })
+ it('treats other devices as remote', () => {
+ expect(isLocalRequest(from('203.0.113.7'))).toBe(false)
+ expect(isLocalRequest(from(''))).toBe(false)
+ })
+})
+
+describe('renderOpenedPage', () => {
+ it('is a script-free page in the requested language', () => {
+ const zh = renderOpenedPage('zh', true)
+ expect(zh).toContain('已在 Vixel 中打开')
+ expect(zh).not.toMatch(/
diff --git a/README.md b/README.md
index 4be1ff3..e09c991 100644
--- a/README.md
+++ b/README.md
@@ -92,7 +92,7 @@ SCRFD 人脸检测 + MobileFaceNet 512 维特征 + sqlite-vec 近邻索引。
- **HEIC / RAW** —— macOS 上通过系统 `sips` 解码 CR2 / CR3 / NEF / ARW / DNG / RAF / ORF / RW2，保留 EXIF。
- **快速查看** —— 空格预览，⌘1–5 切换 全部 / 图片 / 视频 / 音频 / 地图。
- **命令行** —— `vixel search "海边" --json`，方便脚本和 Agent 调用（见下文）；结果里的 `matchedBy` 说明是画面、图中文字还是文件名命中。
-- **链接进笔记** —— 右键「拷贝链接 / 拷贝 Markdown 链接」得到 `vixel://` 深链接，贴进 Obsidian、备忘录等任意笔记，点击回到 Vixel 定位到那一项（视频 / 音频直接跳到时间点）。链接按内容哈希定位，清库重建、移动文件后仍然有效。打开了「本地接口」时还能「拷贝网页链接 / 拷贝 Markdown（带缩略图）」：`http://…/open?…` 在手机、网页笔记等装不了 Vixel 的地方也能点开，Markdown 里直接显示缩略图；NAS 版网页里同样能拷贝。
+- **链接进笔记** —— 右键「拷贝链接 / 拷贝 Markdown 链接 / 拷贝 Markdown（带缩略图）」得到 `http://localhost:…/open?…` 链接，任何笔记、聊天、文档软件都能识别成可点的链接；在本机点开回到 Vixel 定位到那一项（视频 / 音频直接跳到时间点），Markdown 还能直接显示缩略图。开了「本地接口」的局域网访问后，链接换成局域网地址，手机上点开是网页查看页；NAS 版网页里同样能拷贝。链接按内容哈希定位，清库重建、移动文件后仍然有效（需要 Vixel 在运行）。
- **本地接口（默认关闭）** —— 设置 → 通用 → 本地接口：在本机开出网页界面和 HTTP API，手机浏览器也能访问桌面的资料库（局域网访问必须设口令）；同一服务的 `/mcp` 是给 AI 客户端的只读 MCP 接口（见下文）。
- **中英文界面** —— 跟随系统语言，也可在 设置 → 通用 里切换。
- **诊断** —— `vixel doctor` / `vixel bench` 体检和测速，`VIXEL_PROFILE=1` 打印慢操作，见 [docs/debugging.md](docs/debugging.md)。
diff --git a/package-lock.json b/package-lock.json
index f4735b6..64be2a5 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "vixel",
- "version": "0.5.2",
+ "version": "0.5.3",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "vixel",
- "version": "0.5.2",
+ "version": "0.5.3",
"hasInstallScript": true,
"license": "MIT",
"dependencies": {
diff --git a/package.json b/package.json
index a669da9..f66a319 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "vixel",
- "version": "0.5.2",
+ "version": "0.5.3",
"description": "Private, offline AI search for your photos, videos and audio",
"main": "./out/main/index.js",
"author": "Vixel Team",
diff --git a/src/main/index.ts b/src/main/index.ts
index a1044a8..ecafc30 100644
--- a/src/main/index.ts
+++ b/src/main/index.ts
@@ -756,8 +756,18 @@ app.whenReady().then(async () => {
dataDir: app.getPath('userData'),
webDir: existsSync(prodWebDir) ? prodWebDir : join(process.cwd(), 'dist', 'web'),
version: app.getVersion(),
+ // 本机点开的网页链接：和 vixel:// 深链接同一条路 —— 定位后交给主窗口打开（带时间点）
+ openInApp: async (target) => {
+ const result = await services.api.resolveLink(target)
+ if (!result) return false
+ quickPanel!.openResult(result)
+ // 从浏览器点进来：vixel:// 由系统激活应用，http 不会 —— 主动把 Vixel 拉到前台
+ if (process.platform === 'darwin') app.focus({ steal: true })
+ return true
+ },
})
- localApi.startIfEnabled()
+ // 常驻：没开本地接口时也起一个只响应 /open 的本机服务，"拷贝链接"出来的 http 链接才点得开
+ localApi.startOnLaunch()
// PDF / AI 的 pdf.js 栅格化服务（隐藏窗口按需创建；Windows/Linux 主路径，macOS 兜底）
registerPdfRenderer()
registerIpcHandlers()
diff --git a/src/main/localApi.ts b/src/main/localApi.ts
index 3f46232..11e4e06 100644
--- a/src/main/localApi.ts
+++ b/src/main/localApi.ts
@@ -21,6 +21,7 @@ import { createToolContext } from '../core/mcp/tools'
import type { VixelServices } from '../services/api'
import type { createServiceEvents } from '../services/events'
import { DEFAULT_LOCALAPI_PORT, type LocalApiPatch, type LocalApiStatus } from '../shared/localapi'
+import type { DeepLinkTarget } from '../shared/deeplink'
const KEY = {
enabled: 'localapi.enabled',
@@ -31,6 +32,8 @@ const KEY = {
} as const
export interface LocalApiDeps {
+ /** 本机点开的 /open?… 链接：在 Vixel 窗口里定位（返回是否找到） */
+ openInApp: (target: DeepLinkTarget) => Promise