@qingwu-ui/ai-editor 0.9.0-beta
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +159 -0
- package/README.en.md +327 -0
- package/README.md +460 -0
- package/dist/clipper.cjs +1 -0
- package/dist/clipper.d.ts +12 -0
- package/dist/clipper.js +73 -0
- package/dist/components/ai-settings-dialog.d.ts +8 -0
- package/dist/components/ai-settings-dialog.d.ts.map +1 -0
- package/dist/components/export-dialog.d.ts +10 -0
- package/dist/components/export-dialog.d.ts.map +1 -0
- package/dist/components/image-upload-dialog.d.ts +11 -0
- package/dist/components/image-upload-dialog.d.ts.map +1 -0
- package/dist/components/md-import-dialog.d.ts +11 -0
- package/dist/components/md-import-dialog.d.ts.map +1 -0
- package/dist/components/search-bar.d.ts +21 -0
- package/dist/components/search-bar.d.ts.map +1 -0
- package/dist/components/storage-settings-dialog.d.ts +8 -0
- package/dist/components/storage-settings-dialog.d.ts.map +1 -0
- package/dist/components/toast.d.ts +22 -0
- package/dist/components/toast.d.ts.map +1 -0
- package/dist/components/toc.d.ts +18 -0
- package/dist/components/toc.d.ts.map +1 -0
- package/dist/components/video-embed-dialog.d.ts +9 -0
- package/dist/components/video-embed-dialog.d.ts.map +1 -0
- package/dist/editor/ai/components/ai-selector.d.ts +8 -0
- package/dist/editor/ai/components/ai-selector.d.ts.map +1 -0
- package/dist/editor/ai/index.d.ts +42 -0
- package/dist/editor/ai/index.d.ts.map +1 -0
- package/dist/editor/ai/pending-removal.d.ts +20 -0
- package/dist/editor/ai/pending-removal.d.ts.map +1 -0
- package/dist/editor/ai/providers/deepseek.d.ts +12 -0
- package/dist/editor/ai/providers/deepseek.d.ts.map +1 -0
- package/dist/editor/ai/providers/openai-compat.d.ts +14 -0
- package/dist/editor/ai/providers/openai-compat.d.ts.map +1 -0
- package/dist/editor/ai/providers/openai.d.ts +10 -0
- package/dist/editor/ai/providers/openai.d.ts.map +1 -0
- package/dist/editor/ai/providers/qwen.d.ts +14 -0
- package/dist/editor/ai/providers/qwen.d.ts.map +1 -0
- package/dist/editor/ai-editor.d.ts +57 -0
- package/dist/editor/ai-editor.d.ts.map +1 -0
- package/dist/editor/attachment-limits.d.ts +32 -0
- package/dist/editor/attachment-limits.d.ts.map +1 -0
- package/dist/editor/clipper/receiver-browser.d.ts +16 -0
- package/dist/editor/clipper/receiver-browser.d.ts.map +1 -0
- package/dist/editor/clipper/receiver-node.d.ts +43 -0
- package/dist/editor/clipper/receiver-node.d.ts.map +1 -0
- package/dist/editor/clipper/receiver.d.ts +10 -0
- package/dist/editor/clipper/receiver.d.ts.map +1 -0
- package/dist/editor/clipper/types.d.ts +47 -0
- package/dist/editor/clipper/types.d.ts.map +1 -0
- package/dist/editor/embeds/attachment-view.d.ts +2 -0
- package/dist/editor/embeds/attachment-view.d.ts.map +1 -0
- package/dist/editor/embeds/attachment.d.ts +4 -0
- package/dist/editor/embeds/attachment.d.ts.map +1 -0
- package/dist/editor/embeds/audio-view.d.ts +2 -0
- package/dist/editor/embeds/audio-view.d.ts.map +1 -0
- package/dist/editor/embeds/audio.d.ts +4 -0
- package/dist/editor/embeds/audio.d.ts.map +1 -0
- package/dist/editor/embeds/video-view.d.ts +2 -0
- package/dist/editor/embeds/video-view.d.ts.map +1 -0
- package/dist/editor/embeds/video.d.ts +4 -0
- package/dist/editor/embeds/video.d.ts.map +1 -0
- package/dist/editor/extensions/bubble-menu.d.ts +23 -0
- package/dist/editor/extensions/bubble-menu.d.ts.map +1 -0
- package/dist/editor/extensions/code-block-view.d.ts +2 -0
- package/dist/editor/extensions/code-block-view.d.ts.map +1 -0
- package/dist/editor/extensions/code-block.d.ts +6 -0
- package/dist/editor/extensions/code-block.d.ts.map +1 -0
- package/dist/editor/extensions/image-upload.d.ts +12 -0
- package/dist/editor/extensions/image-upload.d.ts.map +1 -0
- package/dist/editor/extensions/image-view.d.ts +2 -0
- package/dist/editor/extensions/image-view.d.ts.map +1 -0
- package/dist/editor/extensions/index.d.ts +27 -0
- package/dist/editor/extensions/index.d.ts.map +1 -0
- package/dist/editor/extensions/obsidian-markdown.d.ts +9 -0
- package/dist/editor/extensions/obsidian-markdown.d.ts.map +1 -0
- package/dist/editor/extensions/qingwu-ui.d.ts +28 -0
- package/dist/editor/extensions/qingwu-ui.d.ts.map +1 -0
- package/dist/editor/extensions/relative-media.d.ts +28 -0
- package/dist/editor/extensions/relative-media.d.ts.map +1 -0
- package/dist/editor/extensions/search-highlight.d.ts +34 -0
- package/dist/editor/extensions/search-highlight.d.ts.map +1 -0
- package/dist/editor/extensions/slash-command.d.ts +28 -0
- package/dist/editor/extensions/slash-command.d.ts.map +1 -0
- package/dist/editor/extensions/table-toolbar.d.ts +7 -0
- package/dist/editor/extensions/table-toolbar.d.ts.map +1 -0
- package/dist/editor/i18n/en-US.d.ts +197 -0
- package/dist/editor/i18n/en-US.d.ts.map +1 -0
- package/dist/editor/i18n/index.d.ts +7 -0
- package/dist/editor/i18n/index.d.ts.map +1 -0
- package/dist/editor/i18n/zh-CN.d.ts +197 -0
- package/dist/editor/i18n/zh-CN.d.ts.map +1 -0
- package/dist/editor/icons.d.ts +15 -0
- package/dist/editor/icons.d.ts.map +1 -0
- package/dist/editor/index.d.ts +40 -0
- package/dist/editor/index.d.ts.map +1 -0
- package/dist/editor/storage/index.d.ts +67 -0
- package/dist/editor/storage/index.d.ts.map +1 -0
- package/dist/editor/storage/providers/cos.d.ts +32 -0
- package/dist/editor/storage/providers/cos.d.ts.map +1 -0
- package/dist/editor/storage/providers/local.d.ts +3 -0
- package/dist/editor/storage/providers/local.d.ts.map +1 -0
- package/dist/editor/storage/providers/oss.d.ts +29 -0
- package/dist/editor/storage/providers/oss.d.ts.map +1 -0
- package/dist/editor/storage/providers/s3.d.ts +24 -0
- package/dist/editor/storage/providers/s3.d.ts.map +1 -0
- package/dist/editor/storage/remove-resource.d.ts +3 -0
- package/dist/editor/storage/remove-resource.d.ts.map +1 -0
- package/dist/editor/storage/signed-fetch.d.ts +25 -0
- package/dist/editor/storage/signed-fetch.d.ts.map +1 -0
- package/dist/editor/utils/delete-confirm-dialog.d.ts +18 -0
- package/dist/editor/utils/delete-confirm-dialog.d.ts.map +1 -0
- package/dist/editor/utils/delete-confirm.d.ts +13 -0
- package/dist/editor/utils/delete-confirm.d.ts.map +1 -0
- package/dist/editor/utils/import-choice-dialog.d.ts +10 -0
- package/dist/editor/utils/import-choice-dialog.d.ts.map +1 -0
- package/dist/editor/utils/local-media.d.ts +119 -0
- package/dist/editor/utils/local-media.d.ts.map +1 -0
- package/dist/editor/utils/render-probe.d.ts +6 -0
- package/dist/editor/utils/render-probe.d.ts.map +1 -0
- package/dist/editor/utils/resolve-local-media.d.ts +71 -0
- package/dist/editor/utils/resolve-local-media.d.ts.map +1 -0
- package/dist/editor/utils/sanitize.d.ts +24 -0
- package/dist/editor/utils/sanitize.d.ts.map +1 -0
- package/dist/export-dialog-DLCACwRK.js +162 -0
- package/dist/export-dialog-JUHUKqo-.cjs +13 -0
- package/dist/index.cjs +9 -0
- package/dist/index.d.ts +4 -0
- package/dist/index.js +7069 -0
- package/dist/local-B20eAPCo.js +93 -0
- package/dist/local-D4481lUa.cjs +3 -0
- package/dist/md-import-dialog-Cf3ZOwA_.js +129 -0
- package/dist/md-import-dialog-CnstzrIK.cjs +1 -0
- package/dist/sanitize-BLVk_EcE.cjs +1 -0
- package/dist/sanitize-OUn05c7P.js +451 -0
- package/dist/signed-fetch-CPPWCUUS.js +102 -0
- package/dist/signed-fetch-D8Rk6R5t.cjs +5 -0
- package/dist/storage-B6LsdlnG.js +37 -0
- package/dist/storage-raz9BRoZ.cjs +2 -0
- package/dist/storage-settings-dialog-BA8QlSw7.js +385 -0
- package/dist/storage-settings-dialog-Dojhp-Uo.cjs +1 -0
- package/dist/styles.css +3 -0
- package/dist/video-embed-dialog-AeGcMb4X.js +269 -0
- package/dist/video-embed-dialog-BbVHq51W.cjs +1 -0
- package/package.json +206 -0
- package/styles.d.ts +1 -0
package/README.md
ADDED
|
@@ -0,0 +1,460 @@
|
|
|
1
|
+
# 青梧 · QingWu Editor
|
|
2
|
+
|
|
3
|
+
> 一款面向中文用户的智能富文本编辑器,基于 Tiptap + React 构建,支持 DeepSeek、通义千问、OpenAI 等大模型接入。
|
|
4
|
+
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## 特性
|
|
10
|
+
|
|
11
|
+
- **智能辅助写作** - 续写、润色、精简、扩写、修正、翻译、自定义指令,基于 Vercel AI SDK 统一接口
|
|
12
|
+
- **丰富的媒体嵌入** - 图片、视频(B站 / 直链 / 小红书)、音频、附件(支持 206+ 格式在线预览)
|
|
13
|
+
- **Markdown 粘贴** - Obsidian 风格的 `[[链接]]` 和 `![[图片]]` 语法支持
|
|
14
|
+
- **多存储后端** - 本地存储 / 阿里云 OSS / 腾讯云 COS / S3 兼容存储,配置持久化
|
|
15
|
+
- **中英双语** - 运行时可切换,无需刷新页面
|
|
16
|
+
- **斜杠命令** - `/` 快速插入标题、列表、图片、视频等
|
|
17
|
+
- **代码高亮** - 支持 30+ 编程语言语法高亮(lowlight),Mermaid 图表渲染
|
|
18
|
+
- **视频播放** - [xgplayer](https://h5player.bytedance.com/)
|
|
19
|
+
- **文件预览** - 基于 @file-viewer/react-full,支持 Office / PDF / CAD / 压缩包等 206+ 格式
|
|
20
|
+
- **导出** - HTML / Markdown / JSON / 纯文本 / PDF
|
|
21
|
+
- **可编辑** - readonly 模式用于纯展示场景
|
|
22
|
+
|
|
23
|
+
## 安装
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
npm install @qingwu-ui/ai-editor
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
> **包名说明:** 对外发布的 npm 包名是 scoped 名 **`@qingwu-ui/ai-editor`**,`npm install` 与所有 `import` 都用它(含样式子路径 `@qingwu-ui/ai-editor/styles`、Node 子入口 `@qingwu-ui/ai-editor/clipper`)。包名历史:`qingwu-ai-editor`(unscoped)→ `@qingwu/editor` → `@qingwu/ai-editor` → **`@qingwu-ui/ai-editor`**(现名,公开 npm 发布用);若你在旧文档/示例里看到前两者,请替换为 `@qingwu-ui/ai-editor`。
|
|
30
|
+
|
|
31
|
+
或直接克隆仓库(qingwu-ui monorepo,位于 `packages/ai-editor`):
|
|
32
|
+
|
|
33
|
+
```bash
|
|
34
|
+
git clone https://github.com/apricotdream/qingwu-ui.git
|
|
35
|
+
cd qingwu-ui/packages/ai-editor
|
|
36
|
+
bun install
|
|
37
|
+
bun run dev
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
## 快速开始
|
|
41
|
+
|
|
42
|
+
### 作为 npm 依赖使用
|
|
43
|
+
|
|
44
|
+
```tsx
|
|
45
|
+
import { QingWuAIEditor, t, setLocale } from "@qingwu-ui/ai-editor";
|
|
46
|
+
|
|
47
|
+
function App() {
|
|
48
|
+
return (
|
|
49
|
+
<QingWuAIEditor
|
|
50
|
+
placeholder="开始写作吧…"
|
|
51
|
+
onChange={(html, json) => console.log(html)}
|
|
52
|
+
// 附件上传限制(必填):单文件 50MB,文档附件总大小 100MB
|
|
53
|
+
maxAttachmentSize={50 * 1024 * 1024}
|
|
54
|
+
maxTotalAttachmentSize={100 * 1024 * 1024}
|
|
55
|
+
/>
|
|
56
|
+
);
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### 引入样式
|
|
61
|
+
|
|
62
|
+
> **必需且不会自动加载。** 本库打包时把 CSS 抽成独立文件 `dist/styles.css`,`import { QingWuAIEditor }` 只含 JS,**不会**注入任何样式。漏引样式的典型症状:编辑器排版/边框/配色异常,并且**在桌面端错误出现「移动端」的悬浮目录按钮或目录抽屉**(桌面/移动的显隐依赖样式表里的响应式断点 class,样式没加载就会全部裸露)。一旦看到这些现象,先检查下面这行 `import` 是否存在、是否生效。
|
|
63
|
+
|
|
64
|
+
```tsx
|
|
65
|
+
// 编辑器核心样式(必需,放在入口文件顶层,且必须在组件 import 之后能被打包器收集到)
|
|
66
|
+
import "@qingwu-ui/ai-editor/styles";
|
|
67
|
+
|
|
68
|
+
// 代码块语言图标(可选:先 npm i devicon,未安装时图标位留空、不影响功能)
|
|
69
|
+
import "devicon/devicon.min.css";
|
|
70
|
+
// 视频播放器样式(用到视频嵌入时按需引入)
|
|
71
|
+
import "xgplayer/dist/index.min.css";
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
> **不要依赖引用方自己的 Tailwind 来「顺带」生成样式。** 编辑器的 class 在编译后已固化进 `dist/styles.css`,而 Tailwind 默认不扫描 `node_modules`,所以宿主项目即使也用了 Tailwind,也不会为库里的断点/工具类生成规则——必须引入上面的 `styles`。
|
|
75
|
+
|
|
76
|
+
> **TypeScript 类型:** 本包已为样式子路径提供类型声明(`styles.d.ts`,经 `exports` 的 `./styles` 暴露),`import "@qingwu-ui/ai-editor/styles"` 通常**无需**额外配置即可通过类型检查。若你的 TS 仍报 `2307 找不到模块`,可在项目任意 `.d.ts` 补一行兜底,**不要**因此删掉样式 `import`:
|
|
77
|
+
> ```ts
|
|
78
|
+
> declare module "@qingwu-ui/ai-editor/styles";
|
|
79
|
+
> ```
|
|
80
|
+
|
|
81
|
+
### Next.js / SSR 集成
|
|
82
|
+
|
|
83
|
+
编辑器依赖浏览器环境,Next.js 等 SSR 场景需用 `dynamic` 关闭 SSR,并传 `immediatelyRender` 以避免 hydration 警告:
|
|
84
|
+
|
|
85
|
+
```tsx
|
|
86
|
+
import dynamic from "next/dynamic";
|
|
87
|
+
|
|
88
|
+
const Editor = dynamic(
|
|
89
|
+
() => import("@qingwu-ui/ai-editor").then((m) => m.QingWuAIEditor),
|
|
90
|
+
{ ssr: false }
|
|
91
|
+
);
|
|
92
|
+
|
|
93
|
+
export default function Page() {
|
|
94
|
+
return <Editor immediatelyRender={true} placeholder="开始写作…" />;
|
|
95
|
+
}
|
|
96
|
+
```
|
|
97
|
+
|
|
98
|
+
### Peer 依赖
|
|
99
|
+
|
|
100
|
+
依赖按角色分层:内部实现库(dompurify、lowlight、xgplayer、cmdk 等)声明在 `dependencies`,安装本包时自动带入;与宿主共享实例的库声明为 peerDependencies(npm 7+ 会自动安装必需项)。
|
|
101
|
+
|
|
102
|
+
**必需**(不装无法运行):
|
|
103
|
+
|
|
104
|
+
- `react` / `react-dom` `^19`
|
|
105
|
+
- `@tiptap/*` `^3.28.0`
|
|
106
|
+
- `ai` `^7`
|
|
107
|
+
|
|
108
|
+
> 若项目已直接使用 @tiptap,请确保版本落在上述范围内,避免多份实例导致 `Adding different instances of a keyed plugin` 冲突。
|
|
109
|
+
|
|
110
|
+
**可选**(`peerDependenciesMeta` 已标记 optional,不装不影响其他功能):
|
|
111
|
+
|
|
112
|
+
| 依赖 | 影响的功能 | 不装时的行为 |
|
|
113
|
+
|---|---|---|
|
|
114
|
+
| `@ai-sdk/openai` | `createAILanguageModelProvider()` 默认 provider | 调用该函数时报错并提示安装;用 `setAIProvider()` 自定义 provider 则完全不需要 |
|
|
115
|
+
| `@file-viewer/react`、`@file-viewer/preset-office`、`@file-viewer/renderer-archive`、`@file-viewer/renderer-text` | 附件在线预览(206+ 格式) | 附件块无法预览(需同时配置 worker/wasm 资源,见下节) |
|
|
116
|
+
| `devicon` | 代码块语言图标 | 图标位留空,语言选择与高亮正常 |
|
|
117
|
+
|
|
118
|
+
### 附件预览资源
|
|
119
|
+
|
|
120
|
+
附件预览(PDF / Word / Excel / 压缩包等)依赖 `@file-viewer` 的 worker / wasm 资源,需保证 `/file-viewer/vendor/...` 路径可访问(默认配置见 `FILE_VIEWER_OPTIONS`)。Vite 项目可用 `@file-viewer/vite-plugin` 的 `copyAssets: { mode: "dev", baseDir: "file-viewer" }` 自动生成;其他环境需手动将资源放置到静态目录。
|
|
121
|
+
|
|
122
|
+
### 配置写作助手服务
|
|
123
|
+
|
|
124
|
+
```ts
|
|
125
|
+
import {
|
|
126
|
+
setAIProvider,
|
|
127
|
+
createAILanguageModelProvider,
|
|
128
|
+
} from "@qingwu-ui/ai-editor";
|
|
129
|
+
|
|
130
|
+
// 通用接口 - 支持任意 OpenAI 兼容 API
|
|
131
|
+
const provider = await createAILanguageModelProvider({
|
|
132
|
+
apiKey: "sk-xxx",
|
|
133
|
+
baseURL: "https://api.deepseek.com/v1", // DeepSeek
|
|
134
|
+
model: "deepseek-v4-flash",
|
|
135
|
+
});
|
|
136
|
+
setAIProvider(provider);
|
|
137
|
+
|
|
138
|
+
// 切换为通义千问只需改 baseURL 和 model:
|
|
139
|
+
// baseURL: "https://dashscope.aliyuncs.com/compatible-mode/v1"
|
|
140
|
+
// model: "qwen3.7-plus"
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
### 配置云存储
|
|
144
|
+
|
|
145
|
+
```ts
|
|
146
|
+
import { setStorageProvider, createOSSStorage } from "@qingwu-ui/ai-editor";
|
|
147
|
+
|
|
148
|
+
setStorageProvider(
|
|
149
|
+
createOSSStorage({
|
|
150
|
+
region: "oss-cn-hangzhou",
|
|
151
|
+
bucket: "my-bucket",
|
|
152
|
+
accessKeyId: "xxx",
|
|
153
|
+
accessKeySecret: "xxx",
|
|
154
|
+
})
|
|
155
|
+
);
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
### 中英切换
|
|
159
|
+
|
|
160
|
+
```ts
|
|
161
|
+
import { setLocale } from "@qingwu-ui/ai-editor";
|
|
162
|
+
|
|
163
|
+
setLocale("en-US"); // 切换到英文
|
|
164
|
+
setLocale("zh-CN"); // 切换到中文
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
## 浏览器扩展(青梧 Web Clipper)
|
|
168
|
+
|
|
169
|
+
[青梧 Web Clipper](./extension) 是配套的浏览器剪藏扩展,一键把网页内容剪藏到青梧编辑器,支持 Chrome / Edge / Firefox。
|
|
170
|
+
|
|
171
|
+
### 功能
|
|
172
|
+
|
|
173
|
+
- **多模式剪藏** - 整页 / 选区 / 链接书签 / 图片地址
|
|
174
|
+
- **AI 摘要与标签** - 自动生成摘要和标签(需配置 AI)
|
|
175
|
+
- **模板渲染** - 自定义 Markdown 模板,支持变量
|
|
176
|
+
- **历史管理** - 本地 IndexedDB 存储剪藏记录,支持搜索 / 收藏 / 删除
|
|
177
|
+
- **推送编辑器** - 通过本地接收器或浏览器通道把剪藏推送到青梧编辑器
|
|
178
|
+
- **多种触发** - 悬浮球、右键菜单、快捷键
|
|
179
|
+
|
|
180
|
+
### 安装
|
|
181
|
+
|
|
182
|
+
```bash
|
|
183
|
+
# 一键构建全部浏览器扩展包(Windows / Linux / Mac)
|
|
184
|
+
cd extension
|
|
185
|
+
./build-extension.bat # Windows
|
|
186
|
+
./build-extension.sh # Linux / Mac
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
构建产物在 `extension/dist/`:
|
|
190
|
+
|
|
191
|
+
- `qingwu-clipper-chrome-v*.zip` / `edge` / `firefox` - 可上传商店的打包
|
|
192
|
+
- `dist/chrome` / `edge` / `firefox` - 可直接「加载已解压扩展」调试
|
|
193
|
+
|
|
194
|
+
#### 加载已解压扩展(开发调试)
|
|
195
|
+
|
|
196
|
+
| 浏览器 | 步骤 |
|
|
197
|
+
|--------|------|
|
|
198
|
+
| **Chrome** | 访问 `chrome://extensions` -> 打开「开发者模式」->「加载已解压」-> 选 `extension/dist/chrome` |
|
|
199
|
+
| **Edge** | 访问 `edge://extensions` -> 打开「开发人员模式」->「加载解压缩的扩展」-> 选 `extension/dist/edge` |
|
|
200
|
+
| **Firefox** | 访问 `about:debugging#/runtime/this-firefox` ->「临时载入附加组件」-> 选 `extension/dist/firefox/manifest.json` |
|
|
201
|
+
|
|
202
|
+
加载成功后浏览器工具栏出现青梧扩展图标。
|
|
203
|
+
|
|
204
|
+
### 使用
|
|
205
|
+
|
|
206
|
+
#### 快捷入口
|
|
207
|
+
|
|
208
|
+
| 操作 | 入口 |
|
|
209
|
+
|------|------|
|
|
210
|
+
| 剪藏当前页面 | 快捷键 `Alt+Shift+C` / 右键菜单 / 悬浮球 |
|
|
211
|
+
| 剪藏选区 | 选中文本后右键菜单 |
|
|
212
|
+
| 打开侧边栏 | 快捷键 `Alt+Shift+P` / 点击扩展图标 |
|
|
213
|
+
|
|
214
|
+
#### 首次使用教程
|
|
215
|
+
|
|
216
|
+
1. **加载扩展** - 按上方「加载已解压扩展」步骤把构建产物加载到浏览器
|
|
217
|
+
2. **触发剪藏** - 打开任意网页,鼠标移到右侧边缘出现悬浮球(或按 `Alt+Shift+C`),点击后自动提取正文
|
|
218
|
+
3. **编辑草稿** - 剪藏后内容进入侧边栏草稿,可编辑标题 / 路径 / 标签
|
|
219
|
+
4. **保存与推送** - 点「保存」后可「推送到编辑器」(需编辑器开启接收器)或「下载 Markdown」
|
|
220
|
+
|
|
221
|
+
> 推送到编辑器需在编辑器侧开启「接收剪藏」开关(首页横幅 -> 了解扩展),扩展通过本地接收器 `http://127.0.0.1:7321` 或浏览器通道推送。
|
|
222
|
+
|
|
223
|
+
### 与编辑器对接
|
|
224
|
+
|
|
225
|
+
编辑器侧启动接收器,接收扩展推送的剪藏:
|
|
226
|
+
|
|
227
|
+
> **Node / 桌面壳专用子入口:** `startClipperReceiver` / `stopClipperReceiver` 依赖 `node:http`,已从浏览器主入口移除,请从 `@qingwu-ui/ai-editor/clipper` 导入,避免把 Node 模块打进浏览器 / SSR 客户端产物。纯浏览器场景仍从主入口用 `startBrowserClipperReceiver`(见下文)。
|
|
228
|
+
|
|
229
|
+
```ts
|
|
230
|
+
import { startClipperReceiver } from "@qingwu-ui/ai-editor/clipper";
|
|
231
|
+
|
|
232
|
+
await startClipperReceiver({
|
|
233
|
+
port: 7321,
|
|
234
|
+
onClip: (clip) => {
|
|
235
|
+
editor.commands.setContent(clip.markdown);
|
|
236
|
+
},
|
|
237
|
+
});
|
|
238
|
+
```
|
|
239
|
+
|
|
240
|
+
HTTP 接口 `POST http://127.0.0.1:7321/clip`,请求体(`IncomingClip`):
|
|
241
|
+
|
|
242
|
+
| 字段 | 类型 | 必填 | 说明 |
|
|
243
|
+
|------|------|------|------|
|
|
244
|
+
| `markdown` | string | 是 | 剪藏的 Markdown 正文 |
|
|
245
|
+
| `title` | string | 是 | 标题 |
|
|
246
|
+
| `path` | string | 否 | 笔记路径 |
|
|
247
|
+
| `tags` | string[] | 否 | 标签 |
|
|
248
|
+
| `sourceUrl` | string | 否 | 来源 URL |
|
|
249
|
+
| `capturedAt` | string | 否 | 捕获时间(ISO) |
|
|
250
|
+
|
|
251
|
+
**统一响应格式**(消除旧版字段冗余 / 错误码不一致):
|
|
252
|
+
|
|
253
|
+
- 成功:`{ ok: true, data?: { at: string } }`
|
|
254
|
+
- 失败:`{ ok: false, error: { code: ClipperErrorCode; message: string } }`
|
|
255
|
+
|
|
256
|
+
错误码(稳定不变,扩展侧可据此精确处理):
|
|
257
|
+
|
|
258
|
+
| code | HTTP | 说明 |
|
|
259
|
+
|------|------|------|
|
|
260
|
+
| `UNAUTHORIZED` | 401 | token 校验失败 |
|
|
261
|
+
| `INVALID_JSON` | 400 | 请求体不是合法 JSON |
|
|
262
|
+
| `MARKDOWN_REQUIRED` | 422 | 缺少 `markdown` 字段 |
|
|
263
|
+
| `NOT_FOUND` | 404 | 路由不存在 |
|
|
264
|
+
| `INTERNAL` | 500 | 内部错误 |
|
|
265
|
+
|
|
266
|
+
纯浏览器场景(无 Node 运行时)使用 `startBrowserClipperReceiver`,通过 `window.postMessage` 接收,无需 HTTP:
|
|
267
|
+
|
|
268
|
+
```ts
|
|
269
|
+
import { startBrowserClipperReceiver } from "@qingwu-ui/ai-editor";
|
|
270
|
+
|
|
271
|
+
startBrowserClipperReceiver({
|
|
272
|
+
onClip: (clip) => editor.commands.setContent(clip.markdown),
|
|
273
|
+
});
|
|
274
|
+
```
|
|
275
|
+
|
|
276
|
+
### 配置
|
|
277
|
+
|
|
278
|
+
在扩展侧边栏「设置」中:
|
|
279
|
+
|
|
280
|
+
- **推送方式** — HTTP(默认,推送到本地接收器)/ 文件(下载 Markdown 到指定目录)
|
|
281
|
+
- **HTTP endpoint** — 默认 `http://127.0.0.1:7321/clip`
|
|
282
|
+
- **编辑器页面 URL** — HTTP 不可达时降级打开的编辑器地址(默认 `http://localhost:5173`)
|
|
283
|
+
|
|
284
|
+
## API
|
|
285
|
+
|
|
286
|
+
### `<QingWuAIEditor>` Props
|
|
287
|
+
|
|
288
|
+
| 参数 | 类型 | 默认值 | 说明 |
|
|
289
|
+
|------|------|--------|------|
|
|
290
|
+
| `initialContent` | `string` | `""` | 初始 HTML 内容(自动安全清洗) |
|
|
291
|
+
| `onChange` | `(html: string, json: object) => void` | - | 内容变化回调 |
|
|
292
|
+
| `placeholder` | `string` | `"输入 '/' 打开菜单…"` | 占位文本 |
|
|
293
|
+
| `mode` | `"edit" \| "view"` | `"edit"` | 编辑模式;`"view"` 为只读查看 |
|
|
294
|
+
| `readonly` | `boolean` | `false` | **已废弃**,请用 `mode="view"` |
|
|
295
|
+
| `maxLength` | `number` | - | 最大字符限制 |
|
|
296
|
+
| `maxAttachmentSize` | `number` | **必填** | 单文件上传大小上限(字节);超限文件被拦截并经 `onToast` 提示 |
|
|
297
|
+
| `maxTotalAttachmentSize` | `number` | **必填** | 文档内所有附件总大小上限(字节);超限拒绝新附件上传 |
|
|
298
|
+
| `onToast` | `(message: string, type: `"success"` \| `"error"` \| `"info"`, options?) => void` | - | 全局提示回调(附件超限拦截 / 文档附件超限警告等)。由宿主接入自己的 Toast 组件;第三参 `options` 透传展示选项(`persist`/`maxLines`/`duration`),旧二参签名自动兼容 |
|
|
299
|
+
| `className` | `string` | `""` | 自定义样式类名 |
|
|
300
|
+
| `style` | `React.CSSProperties` | - | 容器自定义样式 |
|
|
301
|
+
| `borderless` | `boolean` | `false` | 隐藏编辑器外边框 |
|
|
302
|
+
| `showToolbar` | `boolean` | `true` | 显示顶部工具栏(导出) |
|
|
303
|
+
| `showToc` | `boolean` | `true` | 显示目录侧栏 |
|
|
304
|
+
| `showSearch` | `boolean` | `true` | 启用全文搜索(Ctrl+F) |
|
|
305
|
+
| `onEditorReady` | `(editor: Editor) => void` | - | 编辑器实例就绪回调 |
|
|
306
|
+
| `immediatelyRender` | `boolean` | - | 是否立即渲染编辑器;SSR/Next.js 配合 `dynamic` ssr:false 传 `true` |
|
|
307
|
+
|
|
308
|
+
#### Toast 提示通道
|
|
309
|
+
|
|
310
|
+
超限拦截等提示**默认内置渲染**:未接入任何自定义 Toast 时,自动使用随包内置的 `@qingwu-ui/toast`(样式随包发布,零额外配置)。渲染优先级:`onToast` 实例回调 > `setToastProvider()` 全局渲染器 > 内置 `@qingwu-ui/toast`。
|
|
311
|
+
|
|
312
|
+
**onToast 实例级接入示例(推荐 @qingwu-ui/toast)**:
|
|
313
|
+
|
|
314
|
+
```tsx
|
|
315
|
+
import { toast } from "@qingwu-ui/toast";
|
|
316
|
+
import "@qingwu-ui/toast/style.css";
|
|
317
|
+
|
|
318
|
+
<QingWuAIEditor
|
|
319
|
+
maxAttachmentSize={50 * 1024 * 1024}
|
|
320
|
+
maxTotalAttachmentSize={100 * 1024 * 1024}
|
|
321
|
+
onToast={(message, type) => {
|
|
322
|
+
if (type === "success") toast.success(message);
|
|
323
|
+
else if (type === "info") toast.info(message);
|
|
324
|
+
else toast.error(message);
|
|
325
|
+
}}
|
|
326
|
+
/>
|
|
327
|
+
```
|
|
328
|
+
|
|
329
|
+
**setToastProvider 全局替换**(与 `setStorageProvider` / `setAIProvider` 同款模式,对所有编辑器实例生效;传 `null` 恢复内置默认):
|
|
330
|
+
|
|
331
|
+
```ts
|
|
332
|
+
import { setToastProvider } from "@qingwu-ui/ai-editor";
|
|
333
|
+
|
|
334
|
+
setToastProvider((message, type) => {
|
|
335
|
+
// 接入宿主自己的 Toast 组件
|
|
336
|
+
if (type === "success") myToast.success(message);
|
|
337
|
+
else if (type === "info") myToast.info(message);
|
|
338
|
+
else myToast.error(message);
|
|
339
|
+
});
|
|
340
|
+
```
|
|
341
|
+
|
|
342
|
+
#### 删除确认 / 导入选择
|
|
343
|
+
|
|
344
|
+
- **删除确认**:默认使用内置项目 `DeleteConfirmDialog`(图片/视频/音频/附件/代码块/表格删除均走它)。宿主可经 `setConfirmProvider()` 全局替换为自定义确认 UI(如接入自己的 Dialog 组件);传 `null` 恢复内置默认:
|
|
345
|
+
|
|
346
|
+
```ts
|
|
347
|
+
import { setConfirmProvider } from "@qingwu-ui/ai-editor";
|
|
348
|
+
import type { DeleteConfirmDialogProps } from "@qingwu-ui/ai-editor";
|
|
349
|
+
|
|
350
|
+
setConfirmProvider(({ title, message, confirmText, cancelText, onConfirm, onCancel }) => {
|
|
351
|
+
// 渲染宿主自己的确认框,确认时调用 onConfirm(),取消时调用 onCancel()
|
|
352
|
+
myConfirm({
|
|
353
|
+
title,
|
|
354
|
+
message,
|
|
355
|
+
confirmText,
|
|
356
|
+
cancelText,
|
|
357
|
+
onOk: () => void onConfirm(),
|
|
358
|
+
onCancel,
|
|
359
|
+
});
|
|
360
|
+
});
|
|
361
|
+
```
|
|
362
|
+
|
|
363
|
+
- **导入选择**:拖入 MD 文件时优先走宿主 `chooseMd`(内置 `MdImportDialog`);未接入时回退到内置项目风格选择弹窗(渲染 / 附加 / 取消),不再使用原生 `window.confirm`。
|
|
364
|
+
|
|
365
|
+
### 写作助手相关
|
|
366
|
+
|
|
367
|
+
```ts
|
|
368
|
+
setAIProvider(provider: AIProvider): void
|
|
369
|
+
getAIProvider(): AIProvider
|
|
370
|
+
createAILanguageModelProvider(config: AILanguageModelConfig): Promise<AIProvider>
|
|
371
|
+
```
|
|
372
|
+
|
|
373
|
+
### 存储相关
|
|
374
|
+
|
|
375
|
+
```ts
|
|
376
|
+
setStorageProvider(provider: StorageProvider, config?: StorageConfig): void
|
|
377
|
+
getStorageProvider(): StorageProvider
|
|
378
|
+
getStorageInfo(): { name, type, config } | null
|
|
379
|
+
loadStorageConfig(): StorageConfig | null
|
|
380
|
+
|
|
381
|
+
// 内置 Provider
|
|
382
|
+
createLocalStorage(): StorageProvider
|
|
383
|
+
createOSSStorage(config: OSSStorageConfig): StorageProvider
|
|
384
|
+
createCOSStorage(config: COSStorageConfig): StorageProvider
|
|
385
|
+
createS3Storage(config: S3StorageOptions): StorageProvider
|
|
386
|
+
```
|
|
387
|
+
|
|
388
|
+
### i18n
|
|
389
|
+
|
|
390
|
+
```ts
|
|
391
|
+
setLocale(locale: "zh-CN" | "en-US"): void
|
|
392
|
+
getLocale(): Locale
|
|
393
|
+
t(path: string): string
|
|
394
|
+
tf(path: string, ...args): string // 命名 / 位置占位符插值
|
|
395
|
+
```
|
|
396
|
+
|
|
397
|
+
### 扩展相关
|
|
398
|
+
|
|
399
|
+
```ts
|
|
400
|
+
getEditorExtensions(config?: EditorExtensionsConfig): Extension[]
|
|
401
|
+
createSlashCommandExtension(getItems: () => SlashCommandItem[]): Extension
|
|
402
|
+
getDefaultSlashCommands(t: (key: string) => string): SlashCommandItem[]
|
|
403
|
+
getBubbleMenuActions(t: (key: string) => string): BubbleMenuAction[]
|
|
404
|
+
setSearchEngine(template: string): void
|
|
405
|
+
getSearchEngine(): string
|
|
406
|
+
```
|
|
407
|
+
|
|
408
|
+
## AI 合规提示
|
|
409
|
+
|
|
410
|
+
本编辑器接入大模型(DeepSeek / 通义千问 / OpenAI 等)时使用**集成方自行配置的 API Key**,库本身不提供生成服务。依据中国《生成式人工智能服务管理暂行办法》等法规,集成方在使用时应注意:
|
|
411
|
+
|
|
412
|
+
- **AI 生成内容标识**:对 AI 生成的内容(续写 / 润色 / 翻译等输出)按适用要求进行标识,明示其由 AI 生成;
|
|
413
|
+
- **内容安全**:对 AI 输出建立必要的审核与过滤机制,避免生成或传播违法违规内容;
|
|
414
|
+
- **用户告知**:在应用隐私政策 / 用户协议中说明 AI 能力的接入方式与数据流向。
|
|
415
|
+
|
|
416
|
+
## 开发
|
|
417
|
+
|
|
418
|
+
```bash
|
|
419
|
+
# 安装依赖
|
|
420
|
+
npm install
|
|
421
|
+
|
|
422
|
+
# 启动开发服务器
|
|
423
|
+
npm run dev
|
|
424
|
+
|
|
425
|
+
# 类型检查
|
|
426
|
+
npm run typecheck
|
|
427
|
+
|
|
428
|
+
# 构建
|
|
429
|
+
npm run build
|
|
430
|
+
|
|
431
|
+
# 测试
|
|
432
|
+
npm test
|
|
433
|
+
```
|
|
434
|
+
|
|
435
|
+
## 技术栈
|
|
436
|
+
|
|
437
|
+
| 层面 | 技术 |
|
|
438
|
+
|------|------|
|
|
439
|
+
| 编辑器核心 | [Tiptap](https://tiptap.dev/) (ProseMirror) |
|
|
440
|
+
| UI 框架 | React 19 |
|
|
441
|
+
| 命令面板 | [cmdk](https://cmdk.paco.me/) |
|
|
442
|
+
| AI 接口 | [Vercel AI SDK](https://sdk.vercel.ai/) |
|
|
443
|
+
| 代码高亮 | [lowlight](https://github.com/wooorm/lowlight) |
|
|
444
|
+
| 数学公式 | [KaTeX](https://katex.org/) |
|
|
445
|
+
| 视频播放 | [xgplayer](https://h5player.bytedance.com/) |
|
|
446
|
+
| 文件预览 | [FileViewer](https://doc.file-viewer.app/) |
|
|
447
|
+
| 动画 | [Framer Motion](https://www.framer.com/motion/) |
|
|
448
|
+
| 构建 | [Vite](https://vitejs.dev/) |
|
|
449
|
+
| 样式 | [Tailwind CSS](https://tailwindcss.com/) |
|
|
450
|
+
|
|
451
|
+
## License
|
|
452
|
+
|
|
453
|
+
[Apache-2.0](./LICENSE) © 2026 QingWu Contributors
|
|
454
|
+
|
|
455
|
+
---
|
|
456
|
+
|
|
457
|
+
<p align="center">
|
|
458
|
+
<sub>致敬 <a href="https://github.com/steven-tey/novel">Novel</a> (steven-tey/novel),青梧编辑器受其启发而构建。</sub>
|
|
459
|
+
</p>
|
|
460
|
+
|
package/dist/clipper.cjs
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});async function e(e){let t=e.port??7321,n=e.host??`127.0.0.1`,r=null;try{r=await import(`node:http`)}catch{throw Error(`Clipper 接收器需要 Node.js 运行时(在 Electron 主进程 / Tauri / Node 中可用)`)}let i=(e,t,n)=>{e.writeHead(t,{"Content-Type":`application/json`}),e.end(JSON.stringify(n))},a=(e,t)=>i(e,200,{ok:!0,data:t}),o=(e,t,n,r)=>i(e,t,{ok:!1,error:{code:n,message:r}}),s=r.createServer(async(t,n)=>{if(n.setHeader(`Access-Control-Allow-Origin`,`*`),n.setHeader(`Access-Control-Allow-Methods`,`GET, POST, OPTIONS`),n.setHeader(`Access-Control-Allow-Headers`,`Content-Type, Authorization`),t.method===`OPTIONS`){n.writeHead(204),n.end();return}let r=t.url??`/`;if(t.method===`GET`&&(r===`/`||r===`/health`)){try{let t=await(e.onHealth?.()??{service:`qingwu-clipper`});a(n,t)}catch(e){o(n,500,`INTERNAL`,e.message)}return}if(t.method===`POST`&&r===`/clip`){if(e.token&&(t.headers.authorization??``)!==`Bearer ${e.token}`){o(n,401,`UNAUTHORIZED`,`token 校验失败`);return}let r=[];for await(let e of t)r.push(Buffer.isBuffer(e)?e:Buffer.from(e));let i=Buffer.concat(r).toString(`utf-8`),s;try{s=JSON.parse(i)}catch{o(n,400,`INVALID_JSON`,`请求体不是合法 JSON`);return}if(!s.markdown){o(n,422,`MARKDOWN_REQUIRED`,`缺少 markdown 字段`);return}try{await e.onClip(s,t),a(n,{at:new Date().toISOString()})}catch(e){o(n,500,`INTERNAL`,e.message)}return}o(n,404,`NOT_FOUND`,`路由不存在`)});return await new Promise(e=>s.listen(t,n,e)),{url:`http://${n}:${t}`,close:()=>new Promise((e,t)=>{s.close(n=>n?t(n):e())})}}async function t(e){await e.close()}exports.startClipperReceiver=e,exports.stopClipperReceiver=t;
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 青梧编辑器 · Web Clipper 接收器 —— Node 子入口
|
|
3
|
+
*
|
|
4
|
+
* 通过 `@qingwu-ui/ai-editor/clipper` 访问,供 Node / Electron / Tauri 等
|
|
5
|
+
* 带 Node 运行时的消费者使用。把 HTTP 接收器与浏览器主入口隔离,
|
|
6
|
+
* 避免 `node:http` 被打包进浏览器/SSR 客户端产物。
|
|
7
|
+
*
|
|
8
|
+
* 纯浏览器场景请改从主入口 `@qingwu-ui/ai-editor` 使用 startBrowserClipperReceiver。
|
|
9
|
+
*/
|
|
10
|
+
export { startClipperReceiver, stopClipperReceiver } from "./editor/clipper/receiver-node";
|
|
11
|
+
export type { ClipperErrorBody, ClipperErrorCode, ClipperErrResponse, ClipperOkResponse, ClipperReceiver, ClipperReceiverOptions, ClipperResponse, IncomingClip, } from "./editor/clipper/types";
|
|
12
|
+
//# sourceMappingURL=clipper.d.ts.map
|
package/dist/clipper.js
ADDED
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
//#region src/editor/clipper/receiver-node.ts
|
|
2
|
+
async function e(e) {
|
|
3
|
+
let t = e.port ?? 7321, n = e.host ?? "127.0.0.1", r = null;
|
|
4
|
+
try {
|
|
5
|
+
r = await import("node:http");
|
|
6
|
+
} catch {
|
|
7
|
+
throw Error("Clipper 接收器需要 Node.js 运行时(在 Electron 主进程 / Tauri / Node 中可用)");
|
|
8
|
+
}
|
|
9
|
+
let i = (e, t, n) => {
|
|
10
|
+
e.writeHead(t, { "Content-Type": "application/json" }), e.end(JSON.stringify(n));
|
|
11
|
+
}, a = (e, t) => i(e, 200, {
|
|
12
|
+
ok: !0,
|
|
13
|
+
data: t
|
|
14
|
+
}), o = (e, t, n, r) => i(e, t, {
|
|
15
|
+
ok: !1,
|
|
16
|
+
error: {
|
|
17
|
+
code: n,
|
|
18
|
+
message: r
|
|
19
|
+
}
|
|
20
|
+
}), s = r.createServer(async (t, n) => {
|
|
21
|
+
if (n.setHeader("Access-Control-Allow-Origin", "*"), n.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS"), n.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization"), t.method === "OPTIONS") {
|
|
22
|
+
n.writeHead(204), n.end();
|
|
23
|
+
return;
|
|
24
|
+
}
|
|
25
|
+
let r = t.url ?? "/";
|
|
26
|
+
if (t.method === "GET" && (r === "/" || r === "/health")) {
|
|
27
|
+
try {
|
|
28
|
+
let t = await (e.onHealth?.() ?? { service: "qingwu-clipper" });
|
|
29
|
+
a(n, t);
|
|
30
|
+
} catch (e) {
|
|
31
|
+
o(n, 500, "INTERNAL", e.message);
|
|
32
|
+
}
|
|
33
|
+
return;
|
|
34
|
+
}
|
|
35
|
+
if (t.method === "POST" && r === "/clip") {
|
|
36
|
+
if (e.token && (t.headers.authorization ?? "") !== `Bearer ${e.token}`) {
|
|
37
|
+
o(n, 401, "UNAUTHORIZED", "token 校验失败");
|
|
38
|
+
return;
|
|
39
|
+
}
|
|
40
|
+
let r = [];
|
|
41
|
+
for await (let e of t) r.push(Buffer.isBuffer(e) ? e : Buffer.from(e));
|
|
42
|
+
let i = Buffer.concat(r).toString("utf-8"), s;
|
|
43
|
+
try {
|
|
44
|
+
s = JSON.parse(i);
|
|
45
|
+
} catch {
|
|
46
|
+
o(n, 400, "INVALID_JSON", "请求体不是合法 JSON");
|
|
47
|
+
return;
|
|
48
|
+
}
|
|
49
|
+
if (!s.markdown) {
|
|
50
|
+
o(n, 422, "MARKDOWN_REQUIRED", "缺少 markdown 字段");
|
|
51
|
+
return;
|
|
52
|
+
}
|
|
53
|
+
try {
|
|
54
|
+
await e.onClip(s, t), a(n, { at: (/* @__PURE__ */ new Date()).toISOString() });
|
|
55
|
+
} catch (e) {
|
|
56
|
+
o(n, 500, "INTERNAL", e.message);
|
|
57
|
+
}
|
|
58
|
+
return;
|
|
59
|
+
}
|
|
60
|
+
o(n, 404, "NOT_FOUND", "路由不存在");
|
|
61
|
+
});
|
|
62
|
+
return await new Promise((e) => s.listen(t, n, e)), {
|
|
63
|
+
url: `http://${n}:${t}`,
|
|
64
|
+
close: () => new Promise((e, t) => {
|
|
65
|
+
s.close((n) => n ? t(n) : e());
|
|
66
|
+
})
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
async function t(e) {
|
|
70
|
+
await e.close();
|
|
71
|
+
}
|
|
72
|
+
//#endregion
|
|
73
|
+
export { e as startClipperReceiver, t as stopClipperReceiver };
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ai-settings-dialog.d.ts","sourceRoot":"","sources":["../../src/components/ai-settings-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAoC,MAAM,OAAO,CAAC;AA0ClE,UAAU,KAAK;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAcD,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,KAAK,CAwNtC,CAAC"}
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { Editor } from "@tiptap/core";
|
|
2
|
+
import { type FC } from "react";
|
|
3
|
+
interface ExportDialogProps {
|
|
4
|
+
open: boolean;
|
|
5
|
+
onClose: () => void;
|
|
6
|
+
editor: Editor | null;
|
|
7
|
+
}
|
|
8
|
+
export declare const ExportDialog: FC<ExportDialogProps>;
|
|
9
|
+
export {};
|
|
10
|
+
//# sourceMappingURL=export-dialog.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"export-dialog.d.ts","sourceRoot":"","sources":["../../src/components/export-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,EAAyB,MAAM,OAAO,CAAC;AAIvD,UAAU,iBAAiB;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAID,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAkM9C,CAAC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import { type FC } from "react";
|
|
2
|
+
interface ImageUploadDialogProps {
|
|
3
|
+
open: boolean;
|
|
4
|
+
onClose: () => void;
|
|
5
|
+
onInsert: (url: string) => void;
|
|
6
|
+
/** 上传前校验回调(单文件/总大小限制),返回错误消息则拒绝上传;缺省时回退硬编码 20MB 限制 */
|
|
7
|
+
validate?: (file: File) => string | null;
|
|
8
|
+
}
|
|
9
|
+
export declare const ImageUploadDialog: FC<ImageUploadDialogProps>;
|
|
10
|
+
export {};
|
|
11
|
+
//# sourceMappingURL=image-upload-dialog.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"image-upload-dialog.d.ts","sourceRoot":"","sources":["../../src/components/image-upload-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,EAAE,EAAiC,MAAM,OAAO,CAAC;AAI/E,UAAU,sBAAsB;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,sDAAsD;IACtD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC;CAC1C;AAID,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CAgWxD,CAAC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { FC } from "react";
|
|
2
|
+
interface Props {
|
|
3
|
+
open: boolean;
|
|
4
|
+
filename: string;
|
|
5
|
+
onRender: () => void;
|
|
6
|
+
onAttach: () => void;
|
|
7
|
+
onClose: () => void;
|
|
8
|
+
}
|
|
9
|
+
export declare const MdImportDialog: FC<Props>;
|
|
10
|
+
export {};
|
|
11
|
+
//# sourceMappingURL=md-import-dialog.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"md-import-dialog.d.ts","sourceRoot":"","sources":["../../src/components/md-import-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAEhC,UAAU,KAAK;IACb,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,KAAK,CAoGpC,CAAC"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import type { Editor } from "@tiptap/core";
|
|
2
|
+
import { type FC } from "react";
|
|
3
|
+
interface SearchBarProps {
|
|
4
|
+
editor: Editor | null;
|
|
5
|
+
onClose: () => void;
|
|
6
|
+
}
|
|
7
|
+
/**
|
|
8
|
+
* 编辑器内搜索浮层
|
|
9
|
+
* - Ctrl+F / Cmd+F 唤起,ESC 关闭
|
|
10
|
+
* - Enter 下一个,Shift+Enter 上一个
|
|
11
|
+
* - 实时显示匹配数与当前位置
|
|
12
|
+
*
|
|
13
|
+
* 搜索触发策略:
|
|
14
|
+
* - keyword/caseSensitive/wholeWord 变化 -> 用 rAF 合并同帧多次调用,下一帧前执行 setSearch
|
|
15
|
+
* - 不再用 composingRef 跳过 composition 期间搜索(这会导致中文输入法最后一步 setKeyword
|
|
16
|
+
* 因值未变化而不触发 useEffect,搜索永远不执行)
|
|
17
|
+
* - input 事件 stopPropagation 防止冒泡到 ProseMirror contenteditable
|
|
18
|
+
*/
|
|
19
|
+
export declare const SearchBar: FC<SearchBarProps>;
|
|
20
|
+
export {};
|
|
21
|
+
//# sourceMappingURL=search-bar.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"search-bar.d.ts","sourceRoot":"","sources":["../../src/components/search-bar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,EAAqD,MAAM,OAAO,CAAC;AAGnF,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,EAAE,EAAE,CAAC,cAAc,CAoPxC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"storage-settings-dialog.d.ts","sourceRoot":"","sources":["../../src/components/storage-settings-dialog.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAoC,MAAM,OAAO,CAAC;AAUlE,UAAU,KAAK;IACb,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AASD,eAAO,MAAM,qBAAqB,EAAE,EAAE,CAAC,KAAK,CAic3C,CAAC"}
|