与 AI 一起使用
NoteDeck 可以接入 AI，但是否使用完全由你决定。只有接入你自己的 API 密钥时才会启用，不接入时其他功能也都能正常使用。
应用本身没有代你支付 AI 使用费的机制。费用由你签约的提供商直接收取。
接入
- 在连接管理窗口中登记提供商的 API 密钥
- 在 AI 设置中选择已登记的连接
Anthropic、OpenAI、xAI、Google、OpenRouter 和 OpenCode Go 已内置模板，只需选择并粘贴 API 密钥即可接入。
支持 Anthropic Messages 兼容和 OpenAI Chat Completions 兼容两种格式。即使是模板中没有的服务，比如自建的 LLM 网关，只要使用其中一种格式，就可以手动登记并接入。
API 密钥保存在操作系统的钥匙串中。它不会写入设置文件，插件和 AI 本身也无法读取其内容。
能做什么
除了在 AI 列中对话，还可以直接从帖子菜单把帖子交给 AI（摘要、翻译等）。
AI 也能操作应用。添加列、切换账户、制作主题、修改快捷键 — 都可以在对话中提出。AI 操作过的位置会在界面上高亮显示，让你知道发生了什么。
发帖、回应等影响外部的操作之前，一定会弹出确认对话框。不会擅自发帖。
决定让它看到什么
传给 AI 的信息可以在设置中选择。
- 当前使用的账户
- 打开的列
- 界面上可见的帖子
- 对话历史
不需要的可以关闭。
备忘不会一直传给 AI。AI 延续下去的记忆在“笔记”（见下文）中，具体的备忘由 AI 在需要时搜索并读取。
人格与记忆
AI 拥有切换角色也不会改变的人格，以及两种记忆。在 AI 设置的“AI 的人格与记忆”（AI の人格と記憶）中可以随时查看，并逐行修改或删除。
- 人格：价值观、边界和语气的核心。AI 不会自行改写，而是提出建议并等待你的批准
- 关于你的记忆：称呼方式、说话风格偏好等你在对话中告诉它的内容。关闭“记住关于我的事”（あなたのことを覚える）后，既不会传给 AI，也不会记住新的内容（“全部忘记”是另一个操作）
- 笔记：AI 自己捕捉到的小事实和做出的决定
第一次打开 AI 列时，可以从“告诉它怎么称呼你”开始。AI 会和你一起决定它自己的名字和氛围，只会询问该怎么称呼你。如果你不提，它不会主动问。
写入记忆时，如果刚读过他人的帖子，一定会弹出确认。确认中会附上读了哪些帖子，以及要写入的文字是否原样出现在他人的帖子中。在看家（HEARTBEAT）期间不会写入记忆。当本地 CLI 作为 AI 时，“关于你的记忆”默认不会传给 CLI（可以在 AI 连接的开关中允许）。
权限
AI 能做什么由权限设置控制。默认设置较为保守，以读取为主。
权限按用途相互独立。聊天中的 AI 与后文 HEARTBEAT 中运行的 AI 可以分别设置，放宽其中一个不会影响另一个。
你不在时运行（HEARTBEAT）
这是在应用运行期间定期运行 AI 的机制。可以让它帮你盯着，比如“如果新通知里有什么重要的，就告诉我”。
- 没有需要报告的内容时，它会保持沉默
- 结果会累积在指定的会话中
- 连续失败时会自动停止并发出警告（以免在你不知情的情况下一直出错）
由于是无人值守运行，它的权限与聊天分开设置，默认也更严格。
注意一直运行的成本
HEARTBEAT 会定期调用 API。请先确定间隔和权限再启用。
从外部 AI 智能体使用（MCP）
反过来，也可以让 Claude Code、Claude Desktop 等外部 AI 智能体把 NoteDeck 当作工具使用。NoteDeck 内置了 MCP（Model Context Protocol）服务器，会把搜索帖子、发帖等与 AI 聊天相同的 capability 作为 tool 提供。
- 在设置 → 权限 →“永久 API 令牌”（永続 API トークン）中签发令牌。签发后的界面会显示 Claude Code 用的注册命令和 Claude Desktop 用的配置 JSON，复制所需的那一个
- 外部可使用的范围，由同一界面中“外部应用”（外部アプリ）的权限决定。默认只能读取，发帖等写入操作需要逐项允许
- 写入操作一定会先在 NoteDeck 的界面上确认后才执行。外部 AI 不会擅自发帖
像 Claude Code 这样通过 HTTP 连接的应用，直接连接 http://127.0.0.1:19820/mcp。像 Claude Desktop、Cline 这样通过 stdio 启动服务器的应用，把内置的 notemaid 作为 notemaid mcp 交给它们，就会转发到正在运行的 NoteDeck。两种方式都只在 NoteDeck 运行期间可用。