# Clip2MD 产品使用说明（面向 AI Agent）
本文是 Clip2MD 面向普通用户的产品使用手册，也供 AI Agent 阅读后协助用户完成剪藏、Obsidian 安装与本地扩展配置、模板设置、知识库同步和故障排查。
更新日期：2026-10-30。
本文只描述终端用户可见的产品能力。开发者接口、部署方式、内部架构和数据库不属于本手册范围。回答时优先使用用户当前页面、任务详情和服务状态；本文与实时页面不一致时，以实时页面为准。
## 0. AI Agent 回答规则
### 0.1 基本要求
1. 使用用户提问的语言回答，先给最短可执行步骤，再解释原因和限制。
2. 使用页面上的准确中文名称，例如“开始剪藏”“立即同步”“同步成功后删除”，不要虚构菜单或按钮。
3. 明确区分“内容已提交”“任务已完成”和“已同步到知识库”，三者不是同一状态。
4. 需要判断账号权益、额度、服务开关或订单状态时，引导用户查看对应实时页面；不要凭历史截图、旧版本或本文猜测。
5. 条件入口只有在用户当前页面明确展示且可用时才可回答“可用”。隐藏、灰显、“即将开放”“暂未开放”或资格检查不通过，都应按当前不可用处理。
6. 不要承诺具体完成时间、一定解析成功、永久保存或一定能退款。失败退款以任务详情、额度流水或订单状态实际显示为准。
7. 无法从本文和用户提供的信息确定时，明确说明不确定点，只索取排查所需的最少信息；不要编造接口响应或内部状态。
### 0.2 敏感信息与内容边界
- 不要索取 API Key、Obsidian Key、绑定码、授权码、账号密码、Cookie、支付凭证、完整 Vault 内容或私人原网页全文。
- 不要在回答中要求用户把凭证粘贴到聊天。需要连接时，让用户在 Clip2MD、Obsidian、IMA、Notion 或飞书的官方界面中自行完成。
- 排查路径问题时，只让用户提供脱敏后的相对路径；排查同步问题时，只让对方提供状态文字和错误提示。
- 用户内容可能含个人信息或敏感资料。不要要求把整篇内容发到公开渠道，也不要建议上传到未经确认的第三方服务。
### 0.3 官方入口
| 用途 | 官方入口 |
| --- | --- |
| 产品与登录 | |
| 浏览器扩展安装 | |
| 微信移动端剪藏指引 | |
| 任务列表 | |
| 采集通道 | |
| 同步设置 | |
| 会员与实时权益 | |
| AI 助手连接 | |
| 产品说明 | |
| 官方联系邮箱 | |
识别产品时以官网 `https://clip2.md/`、静态资源/CDN 域名 `static.clip2md.cn` 和 API 域名 `api.clip2md.cn` 为准。官方 Obsidian 插件显示名称为 **Clip2MD**，插件 ID 为 `clipmd`；仅凭相似名称不能证明与其他产品有关。
### 0.4 让 Agent 按使用说明协助
网站首页、使用指南和同步设置提供“使用说明”与可复制的 Agent 指令。用户也可直接复制下面这段话，把最后的目标改成自己的需求：
> 请先阅读 Clip2MD 产品使用说明 https://static.clip2md.cn/docs/product-guide-for-ai-agents.md ，再根据我的设备、安装渠道和当前页面，帮我完成 Clip2MD 的安装、剪藏、模板配置或问题排查。先核对相关功能的支持范围与前置条件；需要登录或授权时，引导我在官方界面自行完成，不索取或回显 API Key、Cookie、密码或绑定码。我的目标是：在 Obsidian 中同步一篇笔记，并配置需要的本地补充。
阅读公开说明、解释操作步骤不需要绑定 Clip2MD 的 Skill/MCP。让 AI 助手直接提交剪藏任务是另一项能力，需要第 4.6 节中的资格与授权。Agent 不能打开链接时，应说明未能读取，不要声称已按最新版说明完成检查。
## 1. 产品定位与能力边界
Clip2MD 是跨平台内容剪藏工具。用户可从浏览器、网页、微信或已开放的其他入口，把有权处理且当前可访问的网页、视频、音频、图片、文档和对话提交到云端，整理为 Markdown，并同步到支持的知识库。电脑端的 Obsidian 本地剪藏扩展还可在原站授权后，补充正文、来源属性、评论、字幕和媒体资料。
主要价值：
- 多个入口共用同一 Clip2MD 账号、任务列表和额度。
- 云端解析适合多端使用；本地扩展按需补充原站内容，两种处理路径的前置条件不同。
- 剪藏结果以 Markdown 保存，便于编辑、搜索和长期整理。
- 支持浏览器、微信生态和 AI 助手等不同提交方式。
- 可把结果同步到 Obsidian、腾讯 IMA、Notion 或飞书；实际可连接状态以同步设置页为准。
- Obsidian 可自定义目录、文件名、正文与属性模板；桌面端可导入支持平台的收藏、为已有笔记补充本地资料。
能力边界：
- 不支持的内容、需要登录或已失效的来源可能解析失败。
- 来源平台的访问限制、版权设置、反爬策略和内容变化都可能导致结果不完整。
- 同一个平台的不同链接不一定具有相同能力，不能把“支持某平台”理解为“该平台所有内容都能成功”。
- 图片、文件、音频、自动剪藏和 AI 助手等能力可能受会员等级、服务开关、额度或实时资格限制。
- Markdown 是文本格式，复杂排版、动态内容、受保护媒体或无法公开访问的资源不保证完整保留。
产品支持范围和权益会持续调整。需要回答“现在是否支持”时，应检查当前入口是否展示、用户账号是否满足资格，以及任务详情是否允许操作。
## 2. 问题路由
| 用户问题 | 首选入口 | 继续阅读 |
| --- | --- | --- |
| 第一次使用，不知道从哪里开始 | `/app/tasks` 或 `/install` | 第 3、4 节 |
| 想剪藏当前网页 | 浏览器扩展或 `/app/tasks` | 第 4.1、4.2 节 |
| 想在手机上剪藏 | `/mobile` | 第 4.3 节 |
| 想通过 QQ、邮件或 AI 助手提交 | `/app/channels` 或 `/app/skills` | 第 4.4 至 4.6 节 |
| 任务一直排队、解析中或失败 | `/app/tasks` 的任务详情 | 第 5 节 |
| 网页里能看到结果，但知识库没有 | `/app/sync` | 第 6 节 |
| Obsidian 插件无法连接或没有新文件 | Obsidian 的 Clip2MD 设置 | 第 6.1.1、6.1.2、6.1.7 节 |
| 工具安装失败、原站登录或本地采集失败 | “本地剪藏扩展” | 第 6.1.3、6.1.4、6.1.7 节 |
| 想修改目录、文件名、正文或属性 | “命名与目录”“笔记内容” | 第 6.1.5 节 |
| 想导入 B站、小红书或抖音收藏 | “从平台收藏导入” | 第 6.1.6 节 |
| 想自动收集网页或订阅博主 | `/app/settings/auto-clip` 或 `/app/bloggers` | 第 7 节 |
| 不知道用了哪种额度、为什么额度不足 | `/app/membership` | 第 8 节 |
| 担心自动删除、想清理任务 | `/app/sync` 或任务详情 | 第 9 节 |
| 想改标题、Emoji 或提交反馈 | `/app/settings/content`、`/app/feedback` | 第 10 节 |
| 想购买、续费或退款 | `/pricing` 或 `/app/membership/orders` | 第 8.4 节 |
## 3. 核心工作流
### 3.1 标准流程
1. **选择入口提交内容。** 电脑可使用浏览器扩展或网页；手机可使用微信入口；满足资格时也可使用 QQ、邮件或 AI 助手。
2. **在任务列表查看进度。** 提交成功只表示任务已创建，不代表解析完成。
3. **打开已完成任务检查结果。** 查看标题、原文、智能笔记、图片和失败提示；必要时编辑、重试或提交反馈。
4. **在同步设置中连接知识库。** 任务完成不会自动出现在每个知识库；需要为目标通道完成连接和同步。
5. **确认结果已落到目标位置。** 以知识库中的文件或文档为准，不以“可同步任务数”代替逐台设备或逐个目标的写入结果。
6. **按需保留或删除。** 普通删除和“同步成功后删除”都可能不可恢复；开启自动删除前必须确认所有其他目标已经需要的内容。
### 3.2 三个容易混淆的状态
- **提交成功**：Clip2MD 已接受输入并创建任务，额度可能已经扣除。
- **任务完成**：Clip2MD 已完成解析，用户可以查看或编辑 Markdown；此时未必已同步。
- **同步完成**：某个目标知识库已成功写入。其他通道、设备或 Vault 仍可能尚未完成。
回答问题时不要用“任务完成”代替“已同步”，也不要用“账号内有可同步任务”证明某台 Obsidian 设备已经写入。
## 4. 提交入口
### 4.1 网页剪藏台
登录后进入 ，可使用“链接”输入框提交网页链接。满足会员和功能条件时，桌面端还可使用“文件”或页面当前展示的其他模式。
适用建议：
- 只有链接，没有安装扩展时，可在网页中直接提交。
- 文件类型、大小和能力限制以当前添加入口为准。
- 文件剪藏是 Pro 能力；非 Pro 用户应升级会员后再试。
- 音频文件入口只有在能力探测显示可用时才可提交，不能承诺所有账号或所有时间都开放。
### 4.2 浏览器扩展
安装说明见 。扩展适用于桌面浏览器，负责在浏览网页时提交内容；剪藏结果仍在 Clip2MD 中查看。
推荐操作：
1. 从安装页选择当前浏览器的官方安装方式。
2. 在扩展中登录并连接 Clip2MD 账号。
3. 打开可正常访问的目标网页，点击扩展中的剪藏操作。
4. 返回任务列表确认任务已创建，不要连续重复提交。
5. 需要自动检测匹配页面时，在账号设置和扩展中分别开启。
浏览器扩展、网页剪藏台和知识库插件承担不同职责。扩展负责提交，Clip2MD 负责解析，Obsidian 等插件或连接负责同步。
### 4.3 微信移动端
移动端入口见 。常见路径是关注 Clip2MD 服务号，按欢迎指引添加企业微信剪藏助手，再把支持的链接、图片、文件或聊天记录发送给助手。
**Clip2MD 服务号**
用微信扫码或长按识别二维码关注服务号。关注后可接收使用指引和任务通知，并按欢迎指引添加企业微信剪藏助手。
**Clip2MD 微信小程序**
用微信扫码打开小程序的新手引导页，完成微信剪藏相关设置；查看任务、会员、消息和设置时，也可从首页或服务号底部“开始剪藏”进入。无法扫码时，可从公开指南 或服务号底部“开始剪藏”进入。
- 服务号负责关注、指引和通知。
- 企业微信剪藏助手负责接收内容。
- 微信小程序用于查看任务、会员、消息和设置。
- 微信内无法直接分享时，可复制链接后发送。
- 视频号卡片无法处理时，可尝试分享菜单中的“复制链接”。
- 企业微信入口是否开放以公开指南和 `/app/channels` 的实时状态为准；显示“即将开放”时不要声称可添加。
- 加入用户群不等于开通剪藏。用户群用于交流和反馈，剪藏仍需按指引添加正确的助手。
### 4.4 QQ 剪藏助手
QQ 入口位于 `/app/channels`，当前状态由服务端公开状态控制。
- 页面显示“可用”并展示绑定入口时，才能指导用户绑定。
- 页面显示“即将开放”“暂未开放”或没有入口时，按当前不可用回答，并建议使用浏览器扩展或微信移动端。
- 绑定码有效期短，用户应在 QQ 与 Clip2MD 页面之间直接完成，不要把绑定码发给 AI Agent。
- QQ 支持的内容类型以其页面说明和实际回复为准；视频通常应发送链接，而不是直接发送视频文件。
### 4.5 邮件剪藏
邮件剪藏是有效 Pro 能力，入口位于 `/app/channels`。
1. 在“邮件剪藏”中添加发件邮箱。
2. 到该邮箱查收验证码并完成验证。
3. 按页面分配的官方收件地址发送邮件。
4. 在任务列表查看正文和附件生成的任务。
绑定邮箱、官方收件地址和验证状态都应以页面为准。邮件处理策略可能按批次保存正文或附件，不要根据一封历史邮件推断所有邮件都会以相同方式处理。撤销绑定后，不再接收该发件人的新邮件。
### 4.6 AI 助手 Skill 与远程 MCP
入口位于 。适用于支持官方 Skill 的 Claude Code、Codex、OpenClaw，以及支持远程 MCP 和 OAuth 的 AI 助手。
资格规则：
- 仅有效 Pro 年卡符合基础资格。
- Pro 月卡、赠送或试用 Pro 权益通常不包含该资格。
- 服务暂停、退款处理中或实时资格检查失败时不可用。
- Skill 与 MCP 共用自动剪藏额度；每次提交任务还会按实际内容使用账号剪藏额度。
- 授权码、绑定码和设备凭证都由用户亲自在官方页面完成，AI Agent 不应索取或回显。
Skill 通常支持提交单个链接、查询任务进度并按偏好读取 Markdown；不要承诺批量提交、任意文件上传或超出当前工具声明的新能力。远程 MCP 客户端是否出现 Clip2MD 连接器，以该客户端的连接器目录和 OAuth 授权页为准。
## 5. 任务状态、编辑与重试
### 5.1 状态含义
| 状态 | 用户可见含义 | 建议动作 |
| --- | --- | --- |
| `PENDING` | 排队中 | 等待；不要重复提交 |
| `PROCESSING` | 解析中 | 等待；可稍后刷新 |
| `WAITING_SERVICE` | 待处理 | Clip2MD 正在等待外部服务或后续处理；先等待，不要频繁重试 |
| `SUCCESS` | 已完成 | 检查原文和智能笔记，再同步 |
| `FAILED` | 失败 | 阅读具体错误；页面允许时可重试或反馈 |
| `FAILED_AUTH_EXPIRED` | 授权失效 | 重新登录或重新授权相关服务后，再按页面允许的方式重试 |
| `FAILED_SERVICE_UNAVAILABLE` | 服务异常 | 稍后再试；不要建议用户反复消耗额度 |
| `MANUAL_REVIEW` | 人工审核 | 等待或查看消息/反馈；不要承诺审核结论和时限 |
页面可能显示平台化文案或补充说明。回答时应同时引用任务详情中的具体错误，而不是只翻译内部状态码。
### 5.2 重复提交
同一链接或文件在系统判定为重复时，Clip2MD 会返回已有任务，不会因该次重复提交再次创建任务或再次扣额。用户应从提示直接打开原任务。
如果用户不确定是否重复，先查看任务列表和原链接，不要连续多次提交来“试试看”。
### 5.3 查看和编辑
任务完成后，在任务详情中可以：
- 在原文和智能笔记之间切换。
- 编辑标题、原文或智能笔记，并按页面状态保存。
- 复制 Markdown 或下载 `.md`。
- 查看历史版本并恢复允许恢复的版本。
- 管理标签和与任务相关的反馈。
自动保存遇到版本冲突时，应先比较服务器版本与当前草稿，再选择保留内容。不要把浏览器本地恢复草稿当作已保存内容。
### 5.4 重试与失败退款
- 只有任务详情或列表明确提供“重试”时才可重试。
- 手动重试可能再次消耗额度；页面提示或确认信息应优先于一般规则。
- 自动恢复不应向用户解释为重新扣费；后台恢复是否扣费以任务详情和额度提示为准。
- 失败任务的额度返还是异步的。只有任务详情或额度流水明确显示已返还时，才能回答“已退回”。
- 尚未到账时应回答“返还处理中，到账后再按页面允许重试”，不要承诺到账时间。
- 额度不足时，检查每日额度、永久额度和会员权益；不要用直接修改数据或购买链接之外的方式承诺绕过额度。
### 5.5 删除任务
用户在任务列表或详情中主动删除任务前，页面会提示不可恢复。删除可能影响任务正文、托管素材、同步回执和后续补同步能力。
- 删除任务不会自动返还已经使用的额度，服务错误退款流程除外。
- 删除前先确认目标知识库已经保存需要的内容。
- 删除任务与关闭订单、取消会员、撤销同步连接是不同操作，不能互相替代。
## 6. 同步到知识库
统一入口是 。先登录与提交任务相同的 Clip2MD 账号，再选择目标平台。
同步通用规则：
- 只有已完成的剪藏才应出现在可同步记录中。
- 新任务是否自动同步取决于该通道连接状态、暂停状态和功能设置。
- 历史任务可按页面提供的选择方式手动补同步。
- 暂停同步不会删除已有目标文档；暂停期间的新任务可能需要手动补同步。
- 更换目标文件夹、页面或知识库通常不会移动已有内容。
- 每个通道独立保存连接状态和自动删除设置。
### 6.1 Obsidian
Obsidian 云端同步支持 Windows、macOS、Linux、iOS 和 Android 客户端。本地剪藏扩展仅在电脑端运行；云端同步可用不代表该设备可以自动安装本地工具。
操作指南：。下载入口：。
#### 6.1.1 选择渠道、安装与更新
| 渠道 | 安装方式 | 本地剪藏与工具 |
| --- | --- | --- |
| 社区市场版 | 在 Obsidian 社区插件中搜索 **Clip2MD**（ID `clipmd`），安装并启用 | 主插件负责云端同步；电脑端的独立 Clip2MD Desktop Tools 需另行安装启用，并按说明准备工具 |
| 网站整合版 | 在同步设置页下载 ZIP，把其中的 `clipmd/` 放到当前 Vault 的 `.obsidian/plugins/`，重新加载 Obsidian 后在“社区插件”启用 | 一个插件目录内已整合桌面运行时；需手动开启“本地剪藏扩展”，在支持的系统上自动准备工具 |
注意安装位置应是 `.obsidian/plugins/clipmd/manifest.json`，不要把 ZIP 外层目录再次套进去。使用自定义配置目录的 Vault 应放在实际配置目录下的 `plugins/`。版本与最低 Obsidian 要求以下载页显示为准。
- 两种渠道使用同一个主插件 ID；不要安装两个不同名称的主插件目录来尝试共存。
- 更换渠道前停用旧插件，只替换安装包中的程序文件，保留现有配置、账号绑定和运行数据。若此前启用了独立桌面扩展，切换网站整合版前先停用它，避免重复运行。
- 网站版通过主插件检查更新，更新后需重启 Obsidian；市场版按社区市场的更新方式操作。不要混用不同发布包中的文件。
- 安装或更新完成不等于开启本地采集。首次安装默认关闭本地扩展；原有配置恢复后应检查当前开关和状态。
#### 6.1.2 先完成云端连接与一条笔记同步
1. 打开 Clip2MD 插件设置，优先使用“微信扫码绑定”，也可在官方设置界面手动填写 Clip2MD 生成的 Key。
2. 在“保存位置”中选择当前 Vault 内的目标文件夹。
3. 点击“测试连接”，通过后点击“立即同步”。
4. 在当前 Vault 打开一篇笔记，确认正文、属性和需要的图片已经写入。
5. 再按需设置“启动后自动同步”和“同步间隔”。自动拉取依赖 Obsidian 与该 Vault 正在运行。
每个设备和 Vault 独立写入；网页有可同步任务或其他客户端已同步，不代表当前 Vault 已完成。连接失效时在官方界面重新绑定，不向 Agent 提供 Key。
#### 6.1.3 开启本地扩展与准备工具
1. 电脑端打开 Clip2MD 设置中的“本地剪藏扩展”，打开“启用本地剪藏扩展”。
2. 展开“工具准备”，等待 Whisper、FFmpeg、yt-dlp 和内置转写资源检查完成。
3. 以工具状态显示“已就绪”和真实转写自检通过为准；只有下载完成还不算工具可用。
4. 再到“平台与登录”开启需要的平台、完成原站登录，选择采集能力。
网站版自动安装支持 **macOS Apple Silicon（arm64）、macOS Intel（x64）、Windows x64**；Linux、Windows ARM 与其他架构不提供这一自动安装流程。手机和平板不执行本地工具与本地采集。不要把架构不支持误判为账号未登录。
工具先尝试复用本机可用安装；需要下载时使用 Clip2MD 自有 CDN `https://static.clip2md.cn/downloads/obsidian-tools/v1/`，校验下载资源的 SHA-256 后才安装。下载不成功时会停止并给出错误，不应跳过校验。macOS 编译 Whisper 还需要 Apple 命令行开发工具；缺失时按提示准备后重试。
首次准备包含约 **148 MB** 的固定多语言转写资源，无需选择模型。工具和资源保存在本机的 Clip2MD 工具目录，不进入 Vault；Windows 通常位于 `%LOCALAPPDATA%/Clip2MD/tools/`，macOS 位于 `~/Library/Application Support/Clip2MD/tools/`。下载素材则保存在 Vault，二者不要混淆。
准备失败时查看具体失败项；网站版可点击“重试安装与检查”，市场版可点击“重试检查”，已准备好时可“重新检查”。也可点击“复制 Agent 修复说明”，交给可操作本机的 Agent；指令要求先阅读本说明、检查系统架构和工具能力。原站账号授权仍由用户在官方窗口完成。
#### 6.1.4 平台、采集能力和本地队列
扩展提供 B站、抖音、小红书、CSDN、知乎、豆瓣、微信公众号、微信视频号、微博、YouTube、X、快手、今日头条、小宇宙、荔枝 FM、Apple Podcasts 与通用网页的配置入口。**平台入口不等于每类链接、每种素材都能取得**；能力以对应卡片实际显示和目标内容为准。
- 专用平台开启后，在“原站账号”使用“登录 / 重新登录”，完成后“刷新状态”。首次登录成功会开启该平台支持的采集项，用户可再关闭不需要的项。
- 通用网页需先添加有效的 HTTPS 网址或域名；公开页面可直接采集，需要授权的页面再提示登录。已有专用卡片的平台应使用对应卡片。
- 原站登录与 Clip2MD 账号绑定是两件事。原站 Cookie 和登录凭据保存在本机；不要交给 Agent 或上传到聊天。
| 采集项 | 结果与限制 |
| --- | --- |
| 补充来源属性 | 标题、作者、发布时间、互动数据等；互动数是采集时的快照，未取得的字段可能为空 |
| 正文图文 | 取得原站正文及可用图片，形成补充资料；登录页、验证页不应被当成正文成功 |
| 视频／音频 | 保存页面中能探测、获取的媒体；图文笔记、封面或链接不等于视频或音频下载成功 |
| 评论 | 仅在平台和来源允许时取得；空评论或提示文字不代表完整评论列表 |
| 字幕与本地转写 | 优先使用原站字幕，无字幕时尝试本地转写；音轨损坏、解码失败、超时会影响结果 |
| 封面／原图 | 保存可取得的图片；不保证平台上的全部原图均可访问 |
新同步笔记按当前平台设置补充；已有笔记在“保存与处理”→“已有笔记补充”点击“选择笔记”。在“资料存放目录”留空时，资料默认位于主笔记目录下的 `_local/剪藏ID`；设置其他目录只影响之后保存的资料，不移动历史文件。
本地任务可查看状态、重试失败和待写入项、暂停全部任务或停止当前任务。等待授权时先完成原站登录；待写入时先检查路径、文件权限和笔记是否被改动。清空队列不是完成任务，也不等于删除已保存素材。以最终文件内容与可打开的素材为验收依据，不仅看队列“完成”。
主笔记、补充笔记与素材是不同文件。保留用户对笔记和来源属性的修改；出现冲突或需要“确认刷新并替换”时，先核对内容，不应由 Agent 静默覆盖。
“云端失败自动走本地解析”位于网页同步设置：仅在本地实例已准备好并由用户开启后，处理之后新失败且允许重试的链接任务。它会**回传取得的原文并在云端生成智能笔记**，仍按任务规则使用额度、处理失败返还；这与只在本机补充素材不同。电脑离线、未授权或额度不足时查看等待原因，不要宣称完全离线或免费重试。
#### 6.1.5 目录、命名与模板
目标文件夹在“保存位置”中配置；文件名、标题和评论目录在“命名与目录”中配置；正文与属性在“笔记内容”→“自定义模板”中配置。建议先保留默认值，只修改一项，检查预览与“已保存 / 未保存”提示，再同步一条内容验证。不要只凭输入框仍显示文字就认为保存成功。
| 设置 | 填写方式与例子 |
| --- | --- |
| 目标文件夹 | Vault 相对路径，如 `Clip2MD` 或 `Clip2MD/{{source}}/{{created_date}}` |
| 文件名模板 | 默认 `{{created_date}}-{{note_title}}`；可用 `{{task_id}}-{{note_title}}`，文件名和笔记标题可分别设置 |
| 笔记标题 | 可跟随网站、使用原标题或 AI 标题，也可填单行自定义模板 |
| 正文模板 | 非空 Markdown；通过 `{{content}}` 放入所选同步内容，不能以 YAML `---` 属性区开头 |
| 笔记属性 | 独立的 YAML 属性模板，使用完整的开头和结尾 `---` 以及合法键值字段 |
| 合并文件属性 | 用于按日合并文件的 YAML，与单篇笔记属性分别设置 |
| 资料存放目录 | 留空跟随主笔记；也可填写 Vault 相对目录，已有资料不会自动移动 |
不要填写 `/Users/...`、Windows 盘符、`..` 或其他系统路径。不同设置接受的变量不同，优先点击该设置旁的变量说明或插入按钮；不能把正文变量任意复制到标题、目录或属性中。文件名中的非法字符会被处理，渲染后的文件名也可能截短，不承诺任意长标题保持原样。
自定义标题只允许单行，支持 `{{title}}`、`{{source_title}}`、`{{source_title_or_title}}`、`{{display_title}}`、`{{source}}`、`{{date}}`、`{{source_date}}`、`{{created_at}}`、`{{created_date}}`、`{{task_id}}`。它不接受 `{{content}}`；界面显示“未保存”时先改正再离开设置。
可直接用于**正文**的例子：
```markdown
# {{note_title}}
{{content}}
[原文]({{url}})
```
可用于**笔记属性**的基础例子（不要粘贴到正文输入框）：
```yaml
---
title: "{{note_title}}"
url: "{{url}}"
task_id: {{task_id}}
---
```
- “同步内容”的“完整内容 / 仅智能笔记 / 仅原文”决定 `{{content}}` 的内容；删除这个变量后，该下拉选项会禁用。需要恢复时可点击“恢复标准正文”，或“撤销恢复”撤回刚才的恢复。
- 如果明确使用 `{{note_content}}` 或 `{{source_content}}`，它们分别代表智能笔记和原文，不受 `{{content}}` 的选择替代。
- 桌面变量 `{{local_…}}` 需相应扩展和能力就绪；未取得的字段会留空。关闭扩展会提示清除模板中的桌面变量，历史笔记和素材保留。
- “消息按日合并”仅用于微信、QQ、邮件；其他来源仍生成单篇笔记。单篇与按日合并的预览和属性分别检查。
- 评论补充可与主笔记同级或放到独立目录，目录变更只影响新评论。图片与本地素材有各自的保存策略，不要只改正文路径就假定所有附件会移动。
- 模板与目录变更通常影响之后的新建或重建内容，不会批量改写、重命名或移动已有笔记；重建前先确认已有人工修改。
本地“处理上限”的当前范围：转写 1–240 分钟（默认 60）、一级评论 1–1000 条（默认 100）、单任务下载 1–10240 MiB（默认 1024）、单任务时间 1–120 分钟（默认 15）。这些设置填写范围内的整数，完成输入或按 Enter 后保存；无效值会提示未保存并保留上次有效值。上限是处理预算，不代表保证取得相同数量的评论、完成全部媒体或在该时间内成功。
#### 6.1.6 从平台收藏导入
1. 在本地扩展中登录 B站、小红书或抖音，再打开“从平台收藏导入”。
2. 主动读取收藏，检查列表和读取状态。B站范围为全部自建收藏夹；小红书、抖音使用各自收藏入口。
3. 检查默认选中的可识别单条作品，取消不想导入的项。
4. 导入前检查已有云端任务和可用额度；确认后才把选中的链接提交为云端剪藏任务。
5. 等待云端任务处理与同步，再按配置执行本地补充。
没有固定 100 条导入上限，但原站分页、限流、超时、队列容量和额度仍会限制一次处理结果。额度不足的部分不导入并显示数量；中断后可继续未导入项。读取不完整、0 条或超时时不应说“全部收藏已导入”。收藏导入会创建云端任务并使用额度，不是只下载一份本地收藏清单。原站 Cookie 不上传。
#### 6.1.7 常见校验与排查
| 提示或现象 | 下一步 |
| --- | --- |
| 安装后找不到插件 | 检查是否放在当前 Vault 的实际配置目录、是否多套一层文件夹，重新加载并检查社区插件开关与最低版本 |
| 需要主插件 / 尚未绑定 | 先启用兼容主插件并完成 Clip2MD 绑定；整合版不再单独运行另一份桌面扩展 |
| 工具下载 HTTP 404、超时或校验失败 | 记录失败工具和脱敏错误，网络恢复后重试；404 可能是官方资源未发布，反复登录原站无效，反馈给维护者或使用 Agent 修复说明 |
| 缺 Apple 命令行工具 / 系统架构不支持 | 按工具准备提示处理系统环境，不要更换账号或跳过校验 |
| 原站授权过期 / 等待授权 | 在该平台卡片重新登录并刷新状态，确认目标内容在原站可访问 |
| 通用网页域名无效 / 已有定制配置 | 填写有效 HTTPS 网址或域名；专用平台改用其平台卡片 |
| 标题模板不支持、正文为空或 YAML 无效 | 按该输入框的变量范围和分区修复，等待保存成功并检查预览 |
| 素材目录创建失败 / 待写入 | 检查相对目录、同名文件与写入权限；保留现有文件，记录任务 ID 和错误后重试或反馈，不要清空 Vault |
| 媒体不支持、解码不完整或无字幕 | 检查原站是否有可访问音视频，降低处理范围或使用可取得的正文；不能把空文件或封面当成媒体成功 |
| 没有新笔记 / 文件又被补回 | 检查同步连接、目标目录、自动同步开关、“本地删除或改名后不再补回”和待确认任务 |
| 修改模板后旧笔记没有变化 | 模板主要影响新写入；需要重建时先核对并保留人工编辑内容 |
排查时提供插件版本、系统架构、任务 ID、失败项和脱敏提示即可，不提供账号凭据或完整 Vault。
### 6.2 腾讯 IMA
IMA 连接入口位于 `/app/sync?platform=ima`。
- 用户需先在 IMA 开放平台创建或获取所需凭证，再在 Clip2MD 官方页面填写并验证。
- 选择可添加的目标知识库后启用同步。
- 新投递按当前版本通常只保存文字，不包含图片；界面有特殊说明时以界面为准。
- 历史任务可在 IMA 记录列表中手动补同步。
- 暂停自动同步后，新任务不会自动投递；恢复后按页面规则处理。
- 已有 IMA 文件不会因为更换知识库或版本变化自动迁移。
### 6.3 Notion
Notion 连接入口位于 `/app/sync?platform=notion`。
1. 点击连接 Notion。
2. 在 Notion 官方授权页选择 Clip2MD 可以访问的页面。
3. 返回 Clip2MD 选择目标父页面。
4. 按需同步新任务或手动补同步历史任务。
Notion 写入会创建对应页面并处理支持的图片。用户可以暂停、恢复或断开连接。已有 Notion 文档不会因更换父页面而自动移动。更新同步可能覆盖 Clip2MD 管理的内容，用户手动编辑前应先查看页面提示。
### 6.4 飞书
飞书连接入口位于 `/app/sync?platform=feishu`。
1. 按页面指引创建或选择授权应用。
2. 在飞书页面确认所需权限。
3. 返回 Clip2MD，设置具有编辑权限的云文档文件夹链接。
4. 启用自动同步，或在历史记录中手动补同步。
Clip2MD 不要求用户在聊天中提交应用密钥；授权由飞书页面完成。更换文件夹不会移动已有文档。暂停期间的新剪藏可能需要手动补同步。
### 6.5 条件通道判断
腾讯 IMA、Notion 和飞书可能由服务开关控制。出现下列任一情况时，应回答“当前不可用或暂未开放”：
- `/app/sync` 不展示该平台标签。
- 状态显示“暂未开放”或“不可用”。
- 连接按钮、授权入口或设置表单不存在。
- 后端返回服务不可用或维护提示。
不要仅因为本文提到某个平台，就承诺用户账号现在可以连接。
## 7. 自动化与订阅
### 7.1 浏览器自动剪藏
浏览器自动剪藏是有效 Pro 能力，规则入口为 `/app/settings/auto-clip`。
1. 在 Clip2MD 设置关键词和排除域名。
2. 在浏览器扩展中主动开启本机检测与提交权限。
3. 浏览页面时由扩展判断是否与关键词高度相关。
4. 命中后创建剪藏任务，用户仍需在任务列表检查结果。
规则可同步到支持的客户端，但“浏览页面”的检测依赖浏览器扩展正在运行。自动剪藏不是保证收集所有相关内容：
- 关键词为空表示暂停检测。
- 排除域名及其子域名不会提交。
- 仅高度相关的页面才会命中。
- 永久额度开关默认关闭；关闭时，永久额度专用链接会被跳过。
- 开启后普通链接在每日额度用尽时可能使用永久额度。
### 7.2 博主订阅
博主订阅是有效 Pro 能力，入口为 `/app/bloggers`。当前页面支持的目标平台以功能页展示为准，常见包括抖音、B站、YouTube 和小红书。
能力包括：
- 定时发现订阅开始后发布的新作品。
- 按设置自动创建作品剪藏，或在作品动态中手动选择。
- 可选延迟采集评论与互动数据，生成独立评论补充笔记。
- 免费生成订阅日报，支持预览和下载。
规则与限制：
- 每位博主单独购买订阅期限，不自动续购。
- Pro 到期后停止扫描和新建任务，已购订阅期限不会顺延。
- 订阅扫描、作品剪藏和评论采集分别按页面展示的永久额度或普通额度规则计费。
- 只处理订阅开始后的新作品，不保证补剪全部历史内容。
- 平台限制、作品访问状态和列表覆盖范围都可能造成遗漏。
- 重复添加同一有效订阅通常不会重复创建关系；是否扣额以当前提示为准。
## 8. 会员、额度与订单
### 8.1 会员等级
Clip2MD 提供 Free、Plus 和 Pro 三个稳定层级，具体名称、实时价格和可购周期以 和登录后的会员页为准。
| 层级 | 稳定定位 |
| --- | --- |
| Free | 可用于基础体验和有限日常剪藏；文件剪藏和 Pro 自动化等能力不可用 |
| Plus | 提供付费会员的每日额度与数据保留权益；不包含 Pro 专属自动化能力 |
| Pro | 包含 Plus 基础权益以及文件、邮件、自动剪藏、博主订阅等 Pro 能力；部分能力仍受服务开关控制 |
有效 Pro 年卡还可能包含 AI 助手 Skill/MCP 资格。Pro 月卡不能满足 Skill/MCP 的年卡资格要求。新人赠送、活动赠送或渠道试用权益是否包含某项能力，以实时资格检查为准。
### 8.2 每日额度与永久额度
- **每日额度**按上海时区每天零点重置，不结转到次日，也不跨账号共享。
- **永久额度**不随每日重置，但会因购买、活动赠送、邀请奖励、退款回收和失败返还发生变化。
- 普通链接通常优先使用每日额度；每日额度不足且页面允许时，可能改用永久额度。
- 视频、音频和特定媒体来源可能按专用规则直接使用永久额度。
- 每次提交实际使用哪一种额度，以提交前提示、提交结果、任务详情或额度流水为准。
- 永久额度本身不等于开通全部会员能力。没有 Pro 时，永久额度不会自动解锁文件、自动剪藏或邮件等功能。
2026 年 10 月 26 日附近存在双十一活动，但活动状态、价格、赠送和名额会变化。不要从本文推断活动仍在进行；必须查看活动页或会员页的实时状态。
### 8.3 常见额度问题
- **每日额度不足**：次日零点后恢复；也可按页面允许方式购买或使用永久额度。
- **永久额度不足**：可购买永久额度，或在符合条件时通过邀请奖励获得。
- **任务失败**：退款异步处理；到账前不要承诺可用余额已恢复。
- **重复提交**：返回原任务时不重复扣额。
- **手动重试**：可能再次消耗额度，必须按确认提示执行。
- **媒体任务成本不同**：不要用普通网页任务的扣费规则解释视频或音频任务。
- **退款欠额**：如果用户曾退款且额度已使用，后续获得的永久额度可能先抵扣欠额；以会员额度页为准。
### 8.4 购买、续费与退款
- 会员与永久额度订单只通过 Clip2MD 官方页面或微信小程序完成。
- 月卡和年卡通常不会自动续费；到期前是否可续费和能否切换周期以购买页为准。
- 手机网页不支持永久额度购买时，应按页面提示前往微信小程序。
- 首笔符合条件的会员订单可能支持页面上展示的无理由退款；永久额度包、后续订单、Apple 内购和特殊活动是否适用，以订单详情和规则为准。
- Apple 内购退款必须在 Apple 提供的页面申请；Clip2MD 不能代替 Apple 发起或批准。
- 退款处理中可能暂时按 Free 使用、冻结相应权益或禁止新购，以会员页和订单状态为准。
- 退款是否成功必须看订单状态和权益处理结果，不能只看用户提交了申请。
### 8.5 邀请奖励
每个账号有独立邀请链接或邀请码。好友通过邀请完成注册并满足“首次成功剪藏”等页面写明的条件后，奖励才可能发放。
- “已邀请”不等于奖励已到账。
- 奖励通常在邀请记录显示“奖励已到账”后才算完成。
- 邀请获得的永久额度不因会员到期而失效。
- 奖励金额、有效条件、风控规则和活动期限以邀请页实时说明为准。
### 8.6 数据保留
- Free 用户创建的任务原则上保留 30 天。
- Plus 和 Pro 用户在会员有效期内保留任务，并在会员到期后额外保留 30 天。
- 活动、订单、账号注销和争议处理可能有不同或更长的法定保留期限。
- 用户主动删除、同步自动删除或超期清理后，内容可能无法恢复。
回答数据保留问题时，同时提醒用户以当前隐私政策和任务显示为准，不要把本地知识库副本与 Clip2MD 云端保留混为一体。
## 9. 删除与自动删除
### 9.1 普通删除
在任务列表或详情中删除任务前，先确认：
1. Markdown、图片和评论补充已经保存到需要的位置。
2. 没有其他目标知识库等待同步。
3. 用户不再需要从 Clip2MD 重新下载或补同步。
任务删除通常不可恢复，已消耗额度不会因普通删除返还。
### 9.2 同步成功后删除
“同步成功后删除”位于 `/app/sync`，每个目标通道独立设置，默认关闭。
启用前必须明确告知用户：
- 任一已开启通道先同步成功，就可能删除 Clip2MD 原任务及托管素材。
- 删除发生在 Clip2MD 云端；不会删除已经写入 Obsidian、IMA、Notion 或飞书的内容。
- 其他通道、其他 Obsidian Vault 或其他设备可能尚未同步。
- 原任务、原图和未同步内容删除后无法恢复。
- 普通删除和自动删除都不返还已消费额度。
- IMA 等文字-only 投递可能没有包含图片；开启自动删除后，Clip2MD 原图也可能被清理。
- 只有页面要求的本地 Markdown、图片、内容核验或成功回执满足后才应触发删除；用户不应伪造或手动提交回执。
关闭某个通道的自动删除不会删除其他通道的设置。已有目标文件不会因为关闭自动删除而被移除。
### 9.3 排查删除问题
- 若页面显示“待确认任务”，让用户在同步设置中处理重新导入或保留忽略，不要建议直接删除同步状态文件。
- 若同步显示成功但自动删除没有发生，先检查该通道是否开启、成功回执或远端核验是否完成，以及是否存在其他待处理和退款状态。
- 若用户担心误删，立即建议关闭所有通道的自动删除，并先备份知识库中的目标内容；不要要求用户删除整个 Vault。
## 10. 内容偏好、消息与支持
### 10.1 内容偏好
入口：。
- “显示 AI标题”关闭后优先显示原标题；没有原标题时显示任务标题。
- “显示智能笔记中的 Emoji”控制显示、复制、Markdown 下载和同步结果中的表情显示。
- Emoji 偏好不会修改底层笔记原文，代码和链接地址也不受过滤。
- 已保存设置无法加载时，页面可能显示暂不可用；此前保存的偏好在恢复后继续生效。
### 10.2 站内消息
入口：。消息可能通知任务结果、额度不足、退款、会员到期或其他业务状态。消息中的操作按钮只在当前消息支持时显示。不要根据旧消息里的链接推断当前仍可操作。
### 10.3 反馈与人工支持
用户可进入 ，或从任务详情提交针对该剪藏的反馈。
建议提供：
- 任务 ID，而不是完整私人内容。
- 页面显示的错误文字或状态名称。
- 问题发生的入口、时间和是否能稳定复现。
- 已尝试的脱敏步骤。
不要提供：
- API Key、Obsidian Key、绑定码或授权码。
- 账号密码、Cookie、支付凭证。
- 完整 Vault 文件、私人网页全文或无关个人信息。
需要人工处理或隐私请求时，可联系 。会员订单问题应同时提供订单号；不要在邮件中发送支付密码或完整银行卡信息。
### 10.4 用户交流群
用微信扫码可加入 Clip2MD 用户交流群，用于交流使用技巧、获取更新信息和反馈问题。加群不等于开通微信剪藏；剪藏内容仍需按第 4.3 节发送给企业微信剪藏助手。无法加群时，优先使用站内反馈或联系 。
## 11. 故障排查决策树
### 11.1 任务没有完成
1. 查看任务状态和具体错误。
2. `PENDING`、`PROCESSING`、`WAITING_SERVICE`：等待并稍后刷新，不要立即重复提交。
3. `FAILED_AUTH_EXPIRED`：重新登录或重新授权相关服务。
4. `FAILED_SERVICE_UNAVAILABLE`：稍后再试，避免连续消耗额度。
5. `MANUAL_REVIEW`：等待审核或查看反馈，不承诺处理时限。
6. `FAILED`：检查来源是否可访问、内容是否受限制、是否需要永久额度、页面是否允许重试。
7. 退款尚未到账时，先等待额度流水更新，再按页面权限重试。
### 11.2 任务完成但知识库没有
1. 确认知识库连接的是同一个 Clip2MD 账号。
2. 在 `/app/sync` 检查目标平台是否连接、暂停、需重新授权或暂未开放。
3. 检查是否只开启了手动同步、目标文件夹为空或筛选条件排除了该任务。
4. 检查是否在其他 Vault、其他设备、其他知识库或旧目录中。
5. 查看同步记录中的错误，不要先删除任务或同步状态。
6. 批量补同步前先选一条验证路径和权限。
### 11.3 额度不足
1. 判断是每日额度、永久额度，还是会员能力不满足。
2. 每日额度等待上海零点重置；永久额度需购买、奖励或等待失败返还到账。
3. 检查内容是否属于永久额度专用媒体任务。
4. 文件、邮件、自动剪藏和 Skill/MCP 还要检查会员资格和功能开关。
5. 不要建议用户切换到未验证的入口来绕过额度或会员规则。
### 11.4 自动剪藏没有创建任务
1. 确认账号有有效 Pro 资格。
2. 确认关键词非空、当前页面未被排除域名命中。
3. 确认浏览器扩展已开启本机检测和提交权限。
4. 确认相关能力在当前页面或服务端开关可用。
5. 永久额度专用链接是否因“允许使用永久额度”关闭而被跳过。
6. 关键词只匹配高度相关的页面，不保证所有浏览页面都被剪藏。
### 11.5 AI 助手 Skill/MCP 不可用
1. 在 `/app/skills` 查看实时资格，而不是只看会员名称。
2. 确认是否为有效 Pro 年卡；Pro 月卡、赠送 Pro 和退款处理中可能不符合。
3. 检查服务是否暂停、账号是否被风控或客户端 OAuth 是否失效。
4. Skill 设备与 Obsidian Key 分开计数，不能用 Obsidian Key 代替 Skill 连接。
5. 重新授权前先撤销不再信任的旧设备，避免继续保留不需要的访问。
### 11.6 重复任务或重复扣费
1. 先按任务 ID、标题和时间找到原任务。
2. 确认提示是否为“相同链接/文件已提交，本次未创建新任务”。
3. 重复提交返回原任务时不应再次扣额。
4. 若用户认为发生重复扣费，让对方提供任务 ID 和额度流水时间，不要索取凭证。
5. 无法确认账本时说明需要人工核对，不凭页面缓存推断退款结果。
## 12. AI Agent 最终回答检查清单
回答发送前确认：
- 是否先给出了用户当前最该执行的一步？
- 是否区分提交、解析和同步？
- 是否对条件入口写了“以当前页面状态为准”？
- 是否引用了准确页面名称和入口？
- 是否避免承诺固定时长、一定能成功或一定退款？
- 是否避免索取任何 Key、绑定码、账号凭证或完整私人内容？
- 是否在信息不足时明确说明不确定点，并只索取最少排查信息？
如果用户只问“能不能”“支持吗”之类的是非问题，先回答“当前可用/当前不可用/需要满足什么条件”，再补充最短说明。