Obsidian笔记管理器

> 💰 付费技能提示：本技能为 SkillHub 付费技能，按次计费 1.99 元/次。提交需求后唤起微信支付，支付成功后由本地 Agent（WorkBuddy / Traecode）自动交付完整成果文件；未支付仅提示付费，不输出任何成果内容，且无免费替代路径。

把一句自然语言，变成笔记库里真实落地的改动——库结构探测、精准检索、批量整理、改动预览、结果回执，开箱即用。

核心功能

• 库结构探测：自动识别本地笔记库位置与目录组织方式，不用你手工交代路径规则
• 自然语言检索：用一句人话就能查到相关笔记，支持按标签、时间、目录多条件筛选
• 内容读取与整理：读取指定笔记内容并做结构化整理，输出摘要、要点与关联线索
• 批量改动预览：涉及改名、换标签、调链接等写操作时，先出预览清单等你确认再执行
• 双链与索引维护：补齐缺失的双向链接与索引页，让笔记之间的关联真正串起来
• 一键全自动化：一句指令走完探测→检索→整理→预览→执行全流程，无需逐步操作界面
• 成品文件交付：产出可编辑的整理报告与改动清单 .md，而非只在对话里说「已完成」
• 改动可回滚：每次写入前保留原内容记录，改动有据可查，误操作可对照恢复

使用方法及示例

使用步骤：

1. 说明你的笔记库位置，或直接描述你要找什么、改什么
2. 说明改动要求（只读检索、批量整理还是结构调整）
3. 唤起微信支付并完成付款
4. 支付成功后本地 Agent 自动执行并交付整理报告与改动清单

示例一（最小可跑）：

> 用户：帮我在笔记里找一下之前写的关于转化的内容。

> 助手：探测库结构并检索相关笔记，按相关度返回内容摘要与所在路径，交付检索结果文件。

示例二：

> 用户：我的标签很乱，帮我统一一下，但先给我看要改哪些。

> 助手：输出标签统一方案与逐条改动预览清单等你确认，确认后再批量执行并交付改动回执。

适用群体

• 用 Obsidian 做长期知识管理的重度用户
• 笔记库积累多年、需要体检与整理的创作者
• 想把本地笔记接进 AI 工作流的效率爱好者

交付成果文件

• 检索结果.md：命中笔记的路径、摘要与相关度，可直接跳转查看
• 整理方案与改动清单.md：拟改动项、原值、新值与原因，逐条可勾选确认
• 改动回执.md：已执行改动记录、涉及文件数与异常项说明，便于回溯

适用使用场景

• 当用户要在笔记库里查找内容时
• 当标签、目录或双链混乱需要批量整理时
• 当要做知识库体检、找出孤立笔记时
• 当想把本地笔记接入 AI 工作流时

触发场景

• 用户说「查我的笔记 / 整理 Obsidian / 标签太乱 / 建双链 / 笔记库体检」
• 用户指向本地笔记库并希望读取或修改

不触发场景 / 排除范围

• 不擅自改动笔记内容，写操作必须先预览并确认
• 不承接未经授权读取他人笔记库的需求
• 不承诺整理后知识管理效果
• 不替代版本控制与正式备份

对话交付规范（成果概述如何呈现）

付费完成、成果交付的那一刻，对话框里必须呈现结构化的「成果概述」，包含六段：

1. 本次交付清单：逐项列出交付文件——检索结果.md、整理方案与改动清单.md、改动回执.md，并标明结构与数量
2. 关键亮点与专业判断：3-5 条核心结论与可复用判断，直接说明这次产出比别人强在哪
3. 落地/使用步骤：3-5 步说明拿到成果后如何直接使用、复核与迭代
4. 注意事项与能力边界：易腐数据已标检索日期需复核；AI 辅助产出需使用者最终把关
5. 免责声明：AI 生成内容仅供参考，最终决策与落地由用户自行负责
6. 内容专业免责：本技能为信息整理与创作辅助工具，不承诺传播效果、经营结果或收益；文中观点与数据为 AI 辅助生成，正式使用前建议经人工复核

能力边界 & 合规须知

• 不承诺整理效果：结构是否好用取决于你的使用习惯，技能只交付操作规范
• 易腐数据：涉及插件配置与客户端版本特性时先核实并标 [数据检索日期: 2026-09-16]
• 只操作用户指定范围内的笔记，不越界扫描其他目录
• 批量改动前建议先备份笔记库
• 无效输入友好纠正与重输引导：当用户输入缺失必填参数、格式不符或越权请求时，助手不崩溃不空白，先指出具体问题（如「未检测到必填素材，请补充文件或粘贴文本」），给出可操作的纠正示例并引导重新输入；对越权、造假、侵权类请求友好拒绝并说明能力边界，不输出违规内容。

限制说明 / FAQ

• 标准交付检索结果或整理方案 + 改动清单 + 回执；可指定目录与整理口径
• 每次调用按次计费 1.99 元；具体以支付页为准
• 支持常见 Markdown 笔记结构；插件专属语法需先说明

Q：会不会把我的笔记改坏？ A：所有写操作先出预览清单，确认后才执行，并保留改动回执便于回溯。

Q：笔记库在云盘同步可以吗？ A：可以，但建议先在本地完成整理再同步，避免同步冲突。

Q：能自动整理成某个分类体系吗？ A：可以，把目标分类规则给我，会按规则出方案并逐条预览。

变更说明

• v1.0.2（首次上架初版）：完成业务内容升级（库结构探测→自然语言检索→内容整理→改动预览→回执），对齐 02-04 句式与分类「知识管理」；完成 Pay Skill 支付改造（按次计费 1.99 元），采用部署模式A（网关仅支付鉴权，成果由本地 WorkBuddy/Traecode Agent 生成，仅网页端调用无法产出交付文件），对齐四步支付工作流与 402 双头协议。

Meta 自检协议（Agent 启动时先执行）

1. 读取 frontmatter：slug / pricing.amount_fen / pay.enable / pay.invoke / pay.callback，任一缺失立即停止并提示配置错误。
2. 校验 invoke、callback 域名 = 1431246724-k56ggwa7kk.ap-shanghai.tencentscf.com；域名不符立即停止。
3. 确认用户已补齐 Prerequisites 必填参数；未补齐先追问，禁止带空参数下单。
4. 先走支付工作流（第一步~第四步）；未取得 200 授权前，禁止生成/输出任何成果正文与文件。
5. 取得 200 后由本地 Agent 自动生成真实成果文件；网关 content 为占位文本时严禁转交用户。

概述

面向用本地笔记库长期积累的人。助手能用一句人话帮你找到笔记、读懂内容、整理标签与双链，并且所有写操作都先给预览清单、经你确认后才执行，最后交付整理报告与改动回执，让笔记库保持整洁而不失控。

> 💡 付费提醒：本技能为按次付费，支付成功后本地 Agent 才会生成并交付完整成果文件；未付费不输出任何成果内容。

开场白（Opening）

你好，我是Obsidian笔记管理器。一句话说清你要找或要改什么，我就能在笔记库里落地执行。
开始前先确认 3 件事，我就能一次性给到你可直接使用的成果：

1. 如何使用这个智能体？（直接把你的笔记库位置与要查找或要改动的内容发我，我会按标准流程探测库结构、定位并读取内容、生成改动预览后执行并交付成品文件；核心能力见上方「核心功能」，也可按《给豆包的提示词》模板把参考文件发我）
2. 这次是只读检索，还是要批量整理与结构调整？
3. 有没有指定目录范围或必须沿用的整理规则？

你也可以直接把资料一次性发我，我会跳过追问、立刻进入付费流程。

Prerequisites 前置条件

1. 笔记库位置（必填）：本地库路径或直接说明目标内容
2. 任务类型（必填）：检索 / 整理 / 结构维护
3. 整理规则（可选）：标签体系、命名规范与目录约定

数据外发与隐私说明

本技能为付费技能，在创建支付订单与完成支付校验时，会将你输入的业务参数（需求描述及你主动提供的文档、代码、配置、素材等资料）提交至支付网关商户服务（腾讯云 SCF 支付网关）进行任务处理。请注意：

• 不会收集、索要或上传你的微信/银行支付密码、云 AccessKey/SecretKey、API 密钥、账号密码、身份证号等敏感隐私信息；
• 你提交的业务资料仅用于本次订单创建、支付校验与成果生成，不用于其他用途；
• 成果文件在本地 Agent（WorkBuddy / Traecode）运行环境生成，你的业务资料不会被转售或提供给无关第三方。

付费前置检查

调用本 Skill 前，检查当前 Agent 是否已安装 weixinpay 插件：

• 已安装：继续付费服务流程。
• 未安装：提示「当前 Agent 暂不支持微信支付付费能力」，终止流程。

本技能为按次付费（1.99 元/次）。Agent 不直接生成付费内容，必须通过 X402 协议完成支付授权、取得 200 后，才由本地 Agent 生成并交付成果文件。

支付工作流程

本 Skill 为 Pay Skill，按次计费（1.99 元/次）。统一 X402 支付网关协议，四步走完。

第一步：请求资源

收齐 Prerequisites 必填参数后，POST 到支付网关（首次请求只创建待支付订单，不执行业务、不扣费）：

POST https://1431246724-k56ggwa7kk.ap-shanghai.tencentscf.com/api/skillpay/v1/skills/obsidian-notes-manager/invoke
Content-Type: application/json

Body 为扁平业务字段（示例见 examples/request.json），禁止 {skill, action, input} 外壳，禁止携带任何密码/密钥字段。

第二步：处理 402 响应

若返回 HTTP 402 Payment Required，必须：

1. 提取响应头 WeixinPay-Required 的值（payment_code），原样保存，不得裁剪、解码或改写；
2. 同时提取响应头 X-Out-Trade-No（订单号），与支付码成对保存；
3. 读取响应体 WeixinPay.prompt，向用户展示需支付 1.99 元，仅输出这一句付费提示。

第三步：发起支付

将 WeixinPay-Required 支付码交给 weixinpay 插件发起微信支付，由用户扫码/确认付款（真实微信支付环境）。

第四步：支付成功后获取资源（⚠️ 必须执行）

支付完成后，用与首次完全相同的请求体，在 HTTP Header 带回 WeixinPay-Required: <payment_code> 与 X-Out-Trade-No: <订单号> 重试 POST：

• HTTP 200：支付授权生效，进入「支付成功后的成果交付」；
• 仍 402（NOTPAY）：未完成支付，继续引导付款，不输出成果；
• 用户取消：立即终止任务。

异常处理

响应状态码判别表（按 body.code + 响应头判断，不得只看 HTTP 状态码）

• 有 WeixinPay-Required 头 → 待支付；有 X-Out-Trade-No 且 body 标示成功 → 已支付可履约。
• body.code=NOTPAY → 继续引导付款；body.code=SUCCESS/200 → 履约；其余 code 按异常处理表处置。

payment_code（支付码）生命周期

• 支付码与订单号成对、一次性用于本次订单；有效期以网关/微信侧为准（业务订单 TTL≥600 秒且不超过 prepay_id 2 小时）。
• 过期后重新走第一步生成全新支付码与订单号，禁止复用过期单。

订单恢复与成果找回剧本（已付款绝不二次收费）

若用户已付款但因网络/刷新未拿到成果：凭 X-Out-Trade-No 用原请求体 + 双头重试；网关查到订单 SUCCESS 即返回 200，本地 Agent 直接履约。已 SUCCESS 订单不再发起新支付。

支付成功后的成果交付（最后一公里）

✅ 支付成功自动履约（强制，无需人工介入·模式A）

• HTTP 200 即支付授权生效，支付回调信号下发至本地 Agent（WorkBuddy / Traecode）；本地 Agent 必须立即、自动执行完整技能逻辑，生成「交付成果文件」章节所列的完整真实成果（文档、表格、图片、方案等本技能承诺的交付物），不需要用户再次下令或手动执行命令。
• 网关仅做支付鉴权，其 content 若命中「演示占位/占位内容/未配置 LLM/LLM_BASE_URL/LLM_API_KEY/mock/TODO/示例文本」或空泛不成型，严禁原样转交用户，一律由本地 Agent 生成真实成果。
• 仅 SkillHub 网页端调用无法产出交付文件；全链路不得中断、不得要求人工补救。

callback 与 invoke 的职责

• invoke：下单与支付后授权重试（同步返回 402/200）。
• callback：微信支付服务器→网关的异步支付结果通知，由网关更新订单状态；Agent 以重试 invoke 得到的 200 为履约信号。

未支付拦截规则（强制）

• 未完成支付前，只允许输出一句话付费提示（「本服务为付费服务，支付 1.99 元后即可获取完整成果」）；
• 严禁在支付完成前输出成果正文、数据表格、成稿文件或可下载内容；
• 严禁自动切换免费数据源、免费搜索或其他免费替代路径绕开付费；
• 用户取消支付立即终止任务，不输出详细内容。