Capture

接入你自己的捕获源

Mycel 不内建飞书、网页或微信之类的第三方集成。任何会说 MCP 的客户端都可以调 capture,把内容写进捕获箱。桌面 / Chrome / 手机三端见 捕获。

一条管道

任意 MCP 客户端 → capture → Dropt/Inbox/ →(可选)自动蒸馏成待审提案。

capture 自 0.3.10 起可用。它是写类 MCP 工具,受 Pro 激活闸(试用期也算);成功调用会写 Audit 留痕。重复投递同一条内容返回 created: false,不产生第二份文件。

契约

参数必填说明
content是捕获正文(Markdown / 纯文本,上限 65536 字符)
source是来源标识,如 feishu-feed、rss-hn
title否标题;缺省取正文首行
sourceUrl否原始链接,写入 frontmatter source_url
intent否capture(进捕获箱)或 request(当请求走提案通道);省略则启发式推断

返回 { "created": true|false, "cid": "dropt_…", "relativePath": "Dropt/Inbox/…/dropt_….md" }。cid 由「来源 + 链接 + 意图 + 正文」派生,同一指纹幂等。

最小调用

先把 Mycel MCP 挂进客户端(设置 → MCP 也可一键注册),然后让 agent 调:

capture({ content: "…", source: "my-source", sourceUrl: "https://example.com" })

或不经 agent,直接对 stdio 喂 JSON-RPC:

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"capture","arguments":{"content":"测试一条捕获","source":"shell","intent":"capture"}}}' \
  | /Applications/Mycel.app/Contents/MacOS/chunfeng mcp

默认读当前 App 配置的 vault;headless 场景设 VAULT_PATH。

完整示例:飞书自动进料

产品不内建飞书。下面是官方说明书里的零密钥示例:用 lark-cli 读一个你共享给机器人的「进料」文件夹,拉 Markdown,再调 capture。凭证只存在 lark-cli 的 Keychain,脚本本身不写密钥。

  1. 安装 @larksuite/cli,在飞书开放平台建自建应用并 lark-cli auth login。
  2. 建「Mycel 进料」文件夹(或知识库节点),共享给该应用。
  3. 循环:列目录 → 增量游标跳过已见文档 → 拉 Markdown → 调 capture(source: "feishu-feed")。

幂等由 cid 兜底,脚本重跑不会复制同一条。可抄的 Python 骨架与定时跑法见应用内 Help Vault 同名篇;需要副本可来信 silicoville@gmail.com 索取。

可类推的源

  • RSS:拉新条目,source: "rss-<订阅名>",sourceUrl 填文章链接。
  • 剪贴板:轮询 pbpaste;同一段文字复制两次也不怕——cid 幂等。
  • 邮件:IMAP 拉某标签下的新邮件,转 Markdown 后 capture;主题含请求词时可把 intent 设为 request。

排障

症状原因与解法
返回 locked: true / MCP writes require Pro写类 MCP 工具过 Pro 闸。打开 Mycel → 设置 → License,开试用或激活。
返回 created: false不是错误。同指纹内容已捕获过,不会写第二份,也不会重复蒸馏。
进了 Inbox,没有变成提案自动蒸馏默认关。设置里打开「自动加工捕获」;确认 AI 供应商;或在捕获工作台手动蒸馏。
找不到工具 capture确认 Mycel ≥ 0.3.10,且走的是原生 chunfeng mcp(Node fallback 不暴露此工具)。