# @forsion/clip 中文文档 规范地址：https://npmcn.com/package/%40forsion/clip/ 版本：2\.2\.0 npm 元数据更新时间：2026-11-06T03:59:52.489Z 中文译文更新时间：2026-11-15T09:58:05.263Z 软件包许可：未声明 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40forsion/clip 原文对照：https://npmcn.com/package/%40forsion/clip/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：2.3 MB，24 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - 运行依赖：0 个 - 首次发布：2026-10-19T13:02:20.184Z - 最新版本发布：2026-11-06T03:59:52.324Z - 近 30 天下载量：3630（2026-10-16 至 2026-11-14，npm 官方下载统计） - 已发布版本数：4（近 12 个月 4 个） ## 中文简介 Forsion Clip: 本地浏览器抓取、注释和读取连接到 Forsion 账户和金库 ## 安装 ```sh npm install @forsion/clip ``` 也可以使用：`pnpm add @forsion/clip`、`yarn add @forsion/clip`、`bun add @forsion/clip` ## README # Forsion Clip 2.2.0 / +++ Chrome和Microsoft Edge的 Express V3 扩展名,与 Forsion 账户,云库和 Forsion 桌面连接. 这个独立的存放处住在 `Forsion/Forsion-Clip`,同时 `Forsion-Genesis`。旧的倒置工程参考文献存档于 `apps/Archived/Forsion-Clip-reference` 而不是这个仓库的一部分. · 创世纪 · 德莫 · · · 克罗梅侧面小组,服务工人 · · 单位: 。 ## 2.2.0 / 2.2.0 o o 零 - **连接到福森只是工作.** 没有欢迎页面和地址可以输入 : Clip find Forsion 自己在这个计算机上, 第一次打开侧面板, 它要求 Forsion 连接—— 单击 **允许** 在Forsion中,你完成了(Tangu浏览器控制在同一步骤中出现). 安装的和并排运行的dev建筑都列出;您选择一个。 需要一个带有固定 Clip 入口( Changan-Su/Forsion #473)的 Forsion 版本; 一个连接端口已移动的更古老的Forsion, 在 Sets QQ 连接高级 下添加该地址 . - **拯救了福森所在的土地.** 剪刀去金库 福森已经打开。 如果你一看就换了保险库 Clip就停了下来 告诉你一次 而不是去你没看见的地方写. - **一个更冷静的侧面板.** 一张页面的纸卡,一张Chat Box – system作曲家在底部(QQ ask Tangu,QQ savers),一个在"其他地"下有更不常见位置的目的地药丸,一次显示出错误,内含后一步骤按钮. - **设置像福森的.** 连接,目的地,模板,读取和其余部分在一个整页窗口;版本号坐落在左下方. - **看起来像福斯通.** 主题颜色,背景,轻/暗和语言跟随被连接的Forsion,在断开时保持原样. - **\* \* \* \* \* \* \* \***\-=YTET -伊甸园字幕组=- 翻译:。 - **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢**{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}这太过分了 {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我..。 - **侧栏更安静**{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}=========================================================================================================================================================。 - **{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢**时。**{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}我要你来**时。 ## 装入 Chrome 或边缘 / QQ 1. 以 `npm ci && npm run build`,或解开所提供的Chrome ZIP. 2. 打开 `chrome://extensions` (标题: `edge://extensions`),启用开发者模式(Edge:左侧栏下方的开关),选择 **装入已卸出**选择 `.output/chrome-mv3` (目录中包含 `manifest.json`) (中文(简体) ). 将文件夹拖入扩展页, 在开发者模式打开时也会工作 . 3. 打开正常的 HTTP( S) 页并单击 **伪造剪接**。浏览器的保护页面(`chrome://`, (中文(简体) ), `edge://`)和扩展商店无法被剪接. 4. 连接到Forsion不需要设置:安装 Clip 时悄悄地在这个计算机上寻找Forsion,第一次打开侧面板时,连接弹出器会自己打开. 如果一个Forsion正在运行, Clip 请它连接—— 点击 **允许** 在 Forsion 中,您已完成(Tangu 浏览器控制在同一步骤中启用)。 安装一个并同时运行的dev building同时运行,两者都列出(首先安装),您选择一个. 设置在 **设置 QQ 连接** (QQ 设置); 手动地址在下面 _高级_。语言和外观遵循连接的Forsion(在断开时保留了最后的外观),除非您在设置 QQ 常规中选择它们. : 连接; 第一次打开侧栏时连接浮层自动弹出; 第一次打开侧栏时连接浮层自动弹出; 第一次打开侧栏时连接浮层自动弹出; 第一次打开侧栏时连接浮层自动弹出; 第一次打开侧栏时连接浮层自动弹出; 里点「允许」即连上; 。安装版和开发版同时开着时两个都列出、安装版在前; 由你选。更新后的; 由你选。更新后的; 由你选。更新后的; 安装版; 安装版; 安装版; 安装版; 安装版; 安装版; 安装版; 安装版; 安装版; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 安装版; 安装版; 第8791; 第8793; 第8792; 第8794; 互联口漂到别的端口也找得到。; 第8794; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。; 互联口漂到别的端口也找得到。。 边上加载相同的构造不变:扩展ID来自 `manifest.key`,Edge仍然报告 `chrome-extension://` 源代码,因此桌面对接和Tangu浏览器控制工作与Chrome一样。 Forsion桌面的设置 QQ浏览器为每个已安装的浏览器提供了文件夹和"打开扩展"按钮. 在Windows上,浏览器拒绝从另一个应用程序打开他们的扩展页,因此按钮打开了一个新的浏览器窗口并复制地址来粘贴. / 边缘 + (+ ID,Origin + ) `chrome-extension://`{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢。 福斯通-吉尼斯语 `@lcl/components` ChatBox、 安排Row/ 安排Switch ===== `FORSION_GENESIS_ROOT` CDN (中文(简体) )。 ## 伪造帐户/ 设置 → Forsion 账户 → 在打开 Forsion 的官方设备授权页面中签名 。 在那里完成签名,批准显示的代码,然后扩展检查身份,并在当地存储自己的会话. 扩展名从不要求账户密码 . 登录后在剪藏底部选择 **福斯通云库**刷新并选择有写权限的智库及文件夹。默认仅新建笔记; 云端成功回执和桌面本地保存是两个独立结果。登出会请求撤销当前会话并清除本地凭据。更换服务地址会清除旧会话。 ## 桌面 / QQ 1. 剪接探测器 Forsion的固定回路入口(已安装) `127.0.0.1:8791` 编号 : `8793`, dev 构建 `8792` 编号 : `8794`),任何手动地址,以及它之前配对的福森的地址. 案件分别由 `instanceId` 和建设. 2. 首次打开侧面板显示连接弹出;用一个精确的Forsion运行它要求立即对接. 比较六位数代码并单击 **允许** 在福尔森。 配对使该股拥有现有的金库能力;取消在Forsion中的这种能力,以取消访问。 每个Forsion是分别对齐的;设置 QQ连接列出了它们. 3. 存粮去金库了 找到Forsion换了保险库的储物 自上次看面板以来 停止了通知 而不是写到另一个保险库. 4. 经过确认的节省, **添加读取任务** 创建一个与备注相链接的单独的 Markdown 任务 . **继续聊天** 使用桌面模式启动真实的 Chat 会话/运行; 启用桌面远程会话, 并在请求时批准此设备 。 开始运行不是完成的模型答案. 单位RPC, 并对同一客户端的库操作串行化。原协议不支持原子的 `expectedRoot` 日历.db, 不会用只负责导航的 `forsion://` 链接假装上传。 ## Tangu 浏览器控制 / Tangu QQ 由于 2.1.0 此扩展还包含 Tagu 浏览器控制( 原为单独的) _Chrome 的探戈_ 扩展)。 在 Forsion 中批准 Clip 也交出连接代码;要进行人工连接,请从 Forsion → Sets → 浏览器复制并粘贴在 Sets → Connection → 高级. 然后,Tangu可以列出您的分页,在背景分页中读取和动作,并在橙色"Tangu"分页组中打开自己的分页. 桥是 `src/lib/tanguBridge.ts`;协议(loopback WebSocket,双向HMAC握手,信使从不过线)不变. 2.1.0 克罗梅的丹古 `gpajikakdmhjebadgcbmhidkkajclfoi`(单位:千美元)`manifest.key`(原始内容存档于2019-09-21) (中文(简体) ). Tangu; `key.pem` 身份证。 Forsion 桌面从 npm 包中捆绑构建 `@forsion/clip` (仅建扩展线,源头保密); `npm publish` 运行 `prepack`,用于构建和复制 `.output/chrome-mv3` 改为 `chrome-mv3/`。 。 。 . ## 抓取和阅读 / +++ - 文章,选择,多区域和只链接抓取;完整Markdown编辑,源属性,标签和每页草稿. - Defuddle 0.19.5站点适配器,bilibili part/CID/子标题,WeChat图像倒置,表格,公式,代码,脚注和子/sup保存. 只捕捉到该页面可访问的内容;漏出字幕. - 五色文本和图像突出显示,注释,上下文恢复,全局搜索/管理以及JSON/Markdown备份. - 在 2. 0.1 中,选择文本或点击已保存的突出显示打开页面工具栏:复制、突出显示、保存、翻译、解释、语法、元音和词汇。 Google/Bing/当前AI翻译支持12种目标语言,一个单独的结果窗口,重试/停止,复制和保存. 设置 – 选择工具栏控制顺序,能见度,颜色,站点排除和提示. 自动词汇仅限于200个字符的词/句. / 2.0.1 补齐划词与已有划线菜单、独立翻译结果窗和选区设置; 200 字符以上段落仍可翻译与保存; 但不会自动加入生词本。 - Forsion AI并配置了OpenAI兼容,Anthropic,双子座或Ollama供应商. 摘要,完整翻译,解释,语法,提问和读取卡片流入共享创世纪ChatBox. 只有在您按下发送时才会发送源和问题 。 完整的翻译被分割;不完整的流/输出限制被报告,部分文本被保存. 超过35万个字符的来源需要选择一个较小的区域. - 词汇含义,上下文,搜索,审查卡,语音和Markdown导出. - 从 URL 、 所选标签和所选书签中连续批发; 每日和明确的自动剪接域 。 纸币(1至5美元)和去向币(1至6美元)可以计算。 安全瞬间故障重试持续指数截止( 默认 1/2/ 4 秒); 取消胜过等待重试 。 发送不确定或已经创建的部分对象的请求需要明确重试 。 已经发出的请求可以完成并保留其确认。 中断的工作需要明确重试。 已确认的目标被跳过, 重复重用抓取的文件 . ### 2.0.2 增加的对等数/ - 一个可拖曳的页面界面启动器:快速抓取,预览,AI读取,词汇卡,选择菜单切换,区域抓取和突出导出. 行动可以重新排序/隐藏;位置和地点排斥现象持续存在。 打开AI读取不会发送模型请求. - 预览打字法(拉丁文/中文字体家族,大小,宽度和间距)和从实际渲染标题中衍生出可点击的大纲. /预览支持字体、字号、宽度、行距和正文标题提纲。。 - 独立的长 PNG 和 Print / 从当前已编辑文档中保存 PDF, 包括选定的前题/高亮点 。 仅会话一次性快照;图像装入失败可见. PNG超过32,760 px或64 MP明显失败,并提供了PDF;没有无声短音. - 跨节点白空间耐力突出恢复; WeChat懒惰图像恢复; 完整的公式/表/脚注和视频部分元数据保存. 重点回归测试 : `node --import tsx --test tests/background.test.ts tests/queuePolicy.test.ts tests/floatingLauncher.test.ts tests/exportParity.test.ts tests/extractionParity.test.ts tests/paritySettingsUI.test.ts tests/documentExport.test.ts tests/core.test.ts tests/security.test.ts tests/imageBodyCancellation.test.ts tests/obsidianClipboard.test.ts`。 。 。 . 可复制的可真实组件UI仪器 : `node scripts/ui-fixture.mjs`, (中文(简体) ), `node scripts/floating-ui-fixture.mjs` (8777), (中文(简体) ), `node scripts/document-export-fixture.mjs` (8776) (英语). 这些使用合成的局部状态,不访问已安装的扩展的证书. 现场公众提取 : `node --import tsx scripts/public-extraction-acceptance.mts`;其报告将公页结果与安装的Chrome和经认证的服务接受分开. ## 目标 / QQ 18个相容的目标:Markdown下载,剪贴板,Obsidian,Notion,GitHub,flomo,SiYuan,Logseq,Joplin,Feishu,Yuque,Memos,Wolai,FlowUs,GetBiji,S3,OSS和COS. 福斯通云和桌面是额外的本土目标. 在设置 → 保存同步; 中配置证书, 允许额外目标接收每个手动保存 。 每个目的地都有自己的结果. 图像托管支持S3,OSS,COS和Cloudinary. 上传失败保留了原始图像链接并返回了警告 。 外部目的执行使用其已记录的API;API可用和账户权限仍需要真实账户验证. Notion/Wolai/FlowUs支持打字属性映射;GitHub/SiYuan/Joplin/Memos支持选入本地图像附件,而Joplin可以同步标记. 图像获取/上载失败保留了原始链接和警告;部分创建的远程文档保留了它的ID,从未自动复制. 参考议定书和明确格式限制: [导出适配符注释](https://npmcn.com/package/%40forsion/clip/src/lib/exports/README.md)。 。 。 . Markdown下载也可以产生离线ZIP(`Save & sync → Markdown → Attachments`) (中文(简体) ). 它保存了完整的文档,并将公共的HTTP(S)Markdown和HTML图像捆绑到可配置的资产目录中;失败的图像保留了原始链接并被列出在存档报告中. 极限:每幅图像有20个米B,总共有100个米B,200个图像. HTML图像,相片/相片和相對相像網址相對於出自源頁被解析;用报告来保存数据/相片網址. (原始内容存档于2018-09-26) (英语). Markdown QQ ZIP,QQ;。 Absidian/Logseq 返回时 **移交**,不是确认保存的文件。 手动 Obsidian 保存超过 30,000 个编码的 URI 字符将完整的文档写入剪贴板, 然后打开正式文件 `clipboard=true` 写成功之后的URI. 大型 Obsidian 队列任务和超大小的 Logseq URI 明显失败而无需切换;队列工人不能覆盖对方剪贴板的交接. Chrome下载返回下载ID;完成情况可见于Chrome的下载页面. Wolai 不支持的丰富构造将源保存为文本并带有警告. ## MCP 磁共振 大桥选入. 它只听回回回转,需要至少24个字符的随机符号. 扩展和MCP进程必须使用相同的同义词. 不需要浏览器调试端口或本地主机安装 . 示例 MCP 客户端配置( 本地替换路径和令牌; 从不承诺真实令牌 ) : ```json { "mcpServers": { "forsion-clip": { "command": "node", "args": ["/absolute/path/forsion-clip/scripts/mcp-server.mjs"], "env": { "FORSION_CLIP_BRIDGE_TOKEN": "replace-with-a-long-random-token", "FORSION_CLIP_BRIDGE_PORT": "18365" } } } } ``` 在启动服务器前安装此工程的依赖性 。 在扩展设置中,使用 `ws://127.0.0.1:18365`并启用连接。 已曝光的工具 : `browser_tabs`, (中文(简体) ), `clip_extract`, (中文(简体) ), `clip_save`. 使桥梁授权连接的本地AI客户端使用这些能力. 未使用时继续禁用 . 交货中还包括最低限度的 `forsion-clip-2.0.0-mcp.zip` 伴侣 把它打开,快跑 `npm ci --omit=dev`; 使用它 `mcp-server.mjs` 路径在同一配置中。 / 。 ## 许可和隐私 / Q | 权限 | 目的 | | --- | --- | | HTTP( S) 主机访问、 脚本、 活动 Tab | 在普通的 HTTP( S) 页面上显示启用的选择工具栏, 但已禁用的网站除外; 隐藏/已禁用的工具栏使用已配置的持久站点 。 仅在明确行动之后,才将所选文本发送给翻译/AI提供者. | | 选项卡 | 当前页面身份和选定标签批次抓取 | | 书签 | 导入前显示用户选择的书签 | | 下载、剪贴板、剪贴板 | 在 Chrome MV3 中保存 Markdown/存档和副本 | | 存储, 无限量 | 本地证书、草稿、词汇表、说明、历史和持久队列 | | 侧面板, 上下文 | 原生面板和页面/文本/图像行动 | | 提醒 | 恢复已排队的工作并排定每天抓取; 重新连接 Tangu 浏览器控制 | | 选项卡组 | 保留 Tagu 在自己的" Tangu" 组中打开的标签 | | 调试器 | 仅取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 Chrome不允许作为可选权限 | 页面脚本无法访问本地扩展存储 。 包含token的呼叫仅限于可信任的扩展上下文;页面数据跨越一个狭义的,源认证的信息界面. 合成网页点击不能触发特权工具栏保存 。 证书不在正常配置出口之外;进口后重新进入目的地/图像证书. 没有使用 SmartClip 私人账户服务, 遥测, 远程可执行代码, 或浏览器历史 API 。 Chrome将标签宽广地标注为浏览访问权限. ## 核查/ ```sh npm run check npm test npm run build npm run package npm audit --omit=dev ``` 测试包括实际的Dfuddle DOM取出,源忠性,恶意合成点击,账户/单位合同定着,云源种族,一能性,队列取消/重新开始,流出,18个适配器和图像签名,UI词汇/注释互动,以及实际的Node MCP stdio QQ认证回回回WebSocket传输. 合成装置不是活账户,也不是第三方接受。 交货报告分别记录了Chrome/台式计算机/账户的真实检查情况. 新测试从不加载浏览器配置文件, 也不执行真实的帐号写入 . `tests/fixtures/article.html` 是一种人工合成的非私人物品,用于明示现场接受. 用于孤立选择 UI 校验, 运行 `node scripts/selection-ui-fixture.mjs` 并打开其回转 URL。 它使用真实的生产工具栏/结果模块,并配有合成的存储和交付. 可选活的Google/Bing模式只接受固定文章文本;它不连接到一个账户或AI提供者. (原始内容存档于2019-09-21). Google/Bing 翻译,。 ### 继续维持2.0.2平价(未解除) - 词汇表现在从原相兼容的 CSV 原子上导入重复跳过,编辑源句,按时间/来源过滤,并安全地导出当前选择的电子表格. - 文档属性支持启用/ 可见字段, 重新命名密钥, 自定义键盘和日期格式化 。 新的抓取可以快取定义;旧的草稿保留了原来的字段名称. - 读取预设支持创建/编辑/重排/失效/重置. 长译在每个源段保留自定义指令. 所选信件或完整的读取对话可以保存而无需更改源草稿. - 现在的Illustrated Cards通过Forsion账户图像模型或配置的OpenAI相容图像提供者,拥有一个真正的计划/审查/生成/下载工作流程. 呼叫是串行的,故障不自动重试,完成的图像在本页会话内幸存了取消和面板导航. 在关闭/重新加载扩展页前下载 . - YouTube字幕在Defuddle sanitization幸存,有章节和时间戳链接. 公共制作单元接收保留了129个标题部分和12个章节. - 标记下的文件名支持 `{date}`, (中文(简体) ), `{time}`, (中文(简体) ), `{slug}`, (中文(简体) ), `{title}`, (中文(简体) ), `{site}`; 资产文件夹支持 `{fileName}`。图像可以保存、拉链或单独下载。 所有相对下载都停留在浏览器下载目录以下. 证据界限:生产-模块测试和HTTP组件固定装置不同于已安装的Chrome. 浏览器工具拒绝扩展管理/内部页面,因此此修订没有被自动重新装入用户的Chrome. Cloud账户图像生成,第三方账户写作和MV3在实际慢图像生成情况下的寿命不被宣称为已核实. 确切证据见当前HTML验收报告. ## 常见问题 ### @forsion/clip 是什么？ Forsion Clip: 本地浏览器抓取、注释和读取连接到 Forsion 账户和金库 ### 如何安装 @forsion/clip？ 在项目目录运行 npm install @forsion/clip，或使用 pnpm add / yarn add / bun add。 ### @forsion/clip 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/forsion\_\_clip 是否存在。 ### @forsion/clip 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @forsion/clip 可以商用吗？ @forsion/clip 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。 ### @forsion/clip 的下载量有多少？ 根据 npm 官方下载统计，@forsion/clip 在 2026/10/16 – 2026/11/14 这 30 天内被下载 3,630 次，日均约 121 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @forsion/clip 还在维护吗？ 最新版本 2\.2\.0 发布于 2026/11/06（9 天前）；至今共发布 4 个版本，其中过去 12 个月发布了 4 个；首次发布于 2026/10/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。