一条管道
任意 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,脚本本身不写密钥。
- 安装
@larksuite/cli,在飞书开放平台建自建应用并lark-cli auth login。 - 建「Mycel 进料」文件夹(或知识库节点),共享给该应用。
- 循环:列目录 → 增量游标跳过已见文档 → 拉 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 不暴露此工具)。 |