连接AI应用(测试版)
更新日期:2026-11-20
你电脑上的AI应用——Claude Code、Claude Desktop、Cursor、VS Code以及其他支持Model Context Protocol(MCP)的应用——可以通过Plainva读取你的仓库:搜索它,读取笔记及其段落、大纲、反向链接、数据库、任务和最近的笔记,并在Plainva中打开笔记。它们自己不会更改任何内容:经你允许的应用可以提出修改建议,这些建议会一直等待,直到你做出决定(见下文)。这是实验性AI功能的一部分,只在桌面端可用。
相反的方向——由Plainva的助手使用你自己连接的服务器所提供的工具——见AI助手中的外部工具。
第三种方式——由Plainva在仓库的文件夹中启动其他厂商的AI智能体,并在AI标签页中显示它的会话——见外部智能体。
工作原理
Plainva在应用旁边附带一个小型辅助程序plainva-mcp。AI应用启动它,辅助程序再通过此电脑的私有通道连接正在运行的Plainva——在Windows上是命名管道,在macOS和Linux上是私有文件夹中的套接字。从不打开任何网络端口。Plainva必须在运行并打开了仓库;否则应用会收到明确的提示。
开启
- 打开设置 → AI,开启在此设备上使用AI。此电脑上的AI应用的各行位于页面下方的其他程序卡片中。
- 在卡片此电脑上的AI应用中开启允许此电脑上的AI应用读取这个仓库。
- 设置应用(见下文)。第一次连接时,Plainva会询问这是哪个应用、由哪个程序启动,以及它可以读取哪些文件夹。默认什么都没有勾选:从仓库的顶层文件夹中选择,或选择整个仓库,然后点允许。点拒绝会拒绝该应用,并且Plainva在十分钟内不会再询问它。文件夹下方是可以提出修改建议,不勾选就保持关闭;它允许什么,见下文。
应用会把一个密钥保存在系统钥匙串中,供下次使用。文件夹按应用和仓库分别授权:在另一个仓库中,应用会再次询问。打开另一个仓库时,连接到之前仓库的应用会被断开;它们重新连接后才能读取新仓库。完全本地开启期间(见AI助手),服务器处于停歇状态:任何应用都无法读取仓库,前来连接的应用会被拒绝。
设置应用
- Claude Code: 从设置中复制Claude Code的命令,并在终端中运行。
- Claude Desktop: 创建安装包… 会写出一个
plainva.mcpb文件;打开它,Claude Desktop就会安装Plainva。 - 其他应用(JSON): 复制配置,并添加到应用的MCP设置中,例如Cursor的
mcp.json。
应用能看到什么
只有你允许的文件夹,而且只有你的隐私规则允许发送给可以访问互联网的云端模型的内容——应用被视为这样的模型,因为Plainva看不到它如何处理读到的内容:带有cloud: deny或web: deny的笔记,或位于带有其中一条规则的文件夹中的笔记,对应用来说并不存在——既看不到正文,也看不到标题——;指向它们的链接会被隐去,日志中的地点从不发送。允许的文件夹中名称无法按原样判断的笔记——以空格或句点结尾、含有冒号,或不是组合形式的Unicode——同样会被省略,回答会说明有多少条笔记被省略。Plainva自己的文件夹(.plainva、.agent)和规则本身永远无法读取。请求和回答中的每个路径都会检查两次:在应用窗口中,以及在Plainva的原生部分中。允许的文件夹中指向别处的文件夹链接不会被跟随;数据库只用应用可以读取的笔记计算出的值来回答:跨越指向其他文件夹的链接的计数或求和会略去那些笔记。应用读取的内容中,只有指向应用可以读取的笔记的链接才会保留;其他链接(包括指向不存在的笔记的链接)都会被隐去。搜索不会通过被隐去的链接文字找到笔记,如有疑问会略去该笔记;会触及被隐去的链接、或把它的占位符写进笔记的更改会被拒绝。
设置中会列出你在此电脑上已允许的应用及其在此仓库中的文件夹(只在别处获得允许的应用显示在这个仓库中没有)和最近的请求。移除会在所有仓库中收回某个应用的权限。这会立即生效,对当时已连接的应用也是如此。
当已打开仓库的加密工作区在此设备上未打开时(它已锁定,或此设备上没有它的密钥),Plainva 不会回答任何应用:每个请求(包括列表或搜索)都会被拒绝,并附上说明属于哪种情况的消息;在你锁定时正在进行的请求得不到它找到的任何内容;正在连接的应用会立即得知这一点。解锁工作区或在此设备上设置它之后,同一连接会重新回答。权限按文件夹名称授予:重命名已允许的文件夹后,应用将看不到它,直到你再次允许;而使用旧名称新建的文件夹对它可见。
除了工具之外,Plainva还以Plainva自己的语言把五个技能作为提示词提供,并把文件格式参考作为资源(plainva://format)提供:提示词是daily-orientation、weekly-review、project-status、meeting-prep和task-triage;project-status会询问项目名称,meeting-prep会询问会议。支持提示词的应用会把它们列在自己的命令中。
让应用提出修改建议
允许读取绝不等于允许写入。应用是否还可以提出修改建议,是一个单独的回答:首次连接时询问中的可以提出修改建议,或之后设置中的开关 …可以提出修改建议——按应用、按仓库分别设置,在你开启之前保持关闭。它从应用的下一次请求起生效;Plainva 会立即告知已连接的应用其工具已更改(使用最新协议修订版的应用,只有在它要求被告知时才会收到该通知)——它随后是否无需重新连接就显示这些工具,取决于该应用。
获得允许的应用会多出六个工具,但它们都不会更改仓库:
- 对笔记的修改(正文或某个属性)会成为笔记页边的建议,署名为应用的名称和“(AI应用)”。你可以在那里逐条采纳或拒绝,与其他建议一样(参见评论与建议)。
- 新笔记会成为AI标签页中待决定下的草稿。在那里选择创建后,笔记才会存在。
- 重命名、移动和删除会先询问。Plainva会在自己的窗口中显示将会发生什么(重命名时还会显示链接会随之更新的笔记),应用则显示Plainva正在等待的提示。只有在Plainva中点允许并且应用继续之后,Plainva才会按照你手动操作时的方式执行;应用只会得知是否已执行。删除时,Plainva随后会打开自己的删除对话框,在你确认之前不会有任何内容消失。无法显示这类提示的应用——它需要MCP协议修订版2026-07-28或更新,并且必须能够以表单的形式向你提问——不会获得这三个工具。
应用带入的网址会以不会被打开或加载的形式写入(https[://]…),与助手相同。笔记自身的隐私规则(plainva.ai)不能由应用设置,在加密的工作区中也不会提出建议、起草或计划。设置中的最近请求列表会显示最新的八个请求,并标出Plainva曾向你询问的请求(已询问)、你已否决的请求(已否决)和没有通过的请求(已拒绝);通过的请求不带任何这样的词。
限制
- 仅限桌面端:手机上不运行这类应用,而且iOS和Android都不允许一个应用为另一个应用提供私有通道。
- 浏览器中的ChatGPT和claude.ai无法访问它:它们只能连接互联网上的服务器,而Plainva并不运行这样的服务器。
- 应用不会自行更改仓库:它写入的内容会作为建议或草稿等待,重命名、移动或删除需要你在Plainva中同意。