与 AI 一起使用

NoteDeck 可以接入 AI，但是否使用完全由你决定。只有接入 AI 提供商的 API 密钥、或把本地 CLI 用作 AI 时才会启用，不接入时其他功能也都能正常使用。

应用本身没有代你支付 AI 使用费的机制。费用由你签约的提供商直接收取。

AI 的本体（智能体循环和 HEARTBEAT）运行在独立于应用的进程中。平时无需在意，机制请参阅 AI 的独立进程。

接入

1. 在设置菜单的连接（接続）中登记提供商的 API 密钥
2. 在设置菜单的智能体（エージェント）中选择已登记的连接

Anthropic、OpenAI、xAI、Google、OpenRouter 和 OpenCode Go 已内置模板，只需选择并粘贴 API 密钥即可接入。

支持 Anthropic Messages 兼容和 OpenAI Chat Completions 兼容两种格式。即使是模板中没有的服务，比如自建的 LLM 网关，只要使用其中一种格式，就可以手动登记并接入。

API 密钥保存在操作系统的钥匙串中。它不会写入设置文件，插件和 AI 本身也无法读取其内容。

使用本地的 Ollama

如果连接的 URL 指向你自己的设备（例如 http://127.0.0.1:11434/v1），该连接就会成为“本设备内”的本地连接，模型推理不会离开设备（无需认证，也不需要 API 密钥）。连接的内置模板中有 Ollama。

• 小模型可能不支持 tool，在这样的连接上 AI 无法在聊天中执行操作，也无法报告 HEARTBEAT 巡查
• 输入过长会超出模型的 context，从开头被截断而丢失指令。Ollama 的 context 上限可以用环境变量 OLLAMA_CONTEXT_LENGTH 或模型的 num_ctx 调高
• 与本地连接最搭配的是后文的 HEARTBEAT：聊天继续用云端的强模型，只把巡查放在本地运行

把本地 CLI 用作 AI

可以不用 API 密钥，而是把本机上已安装并已登录的 AI CLI（Claude Agent (Claude Code) / Codex / OpenCode / Hermes Agent / Grok Build）直接用作 AI。在连接中选择“本地 CLI”（手元の CLI），就会列出找到的 CLI。

• 来自 CLI 的许可请求会作为聊天的确认对话框显示。权限由“AI 聊天”那一行决定
• “关于你的记忆”默认也会传给 CLI。不想传的话，请关闭“记忆”（メモリー）中的“也传给本地 CLI”（会被发送到 CLI 的提供方，并可能留在 CLI 自身的记忆中）
• HEARTBEAT 不会通过这条路径运行。若想让聊天继续用 CLI、只把巡查交给 API 连接或本地的 Ollama，请在 HEARTBEAT 的“巡查使用的 AI”里选择另一个连接

能做什么

除了在 AI 列中对话，还可以直接从帖子菜单把帖子交给 AI（摘要、翻译等）。

AI 也能操作应用。添加列、切换账户、制作主题、修改快捷键 — 都可以在对话中提出。AI 操作过的位置会在界面上高亮显示，让你知道发生了什么。

发帖、回应等影响外部的操作之前，一定会弹出确认对话框。不会擅自发帖。

决定让它看到什么

传给 AI 的信息可以在设置中选择。

• 当前使用的账户
• 打开的列
• 界面上可见的帖子
• 对话历史

不需要的可以关闭。

备忘不会一直传给 AI。AI 延续下去的记忆在“记忆”（メモリー，见下文）中，具体的备忘由 AI 在需要时搜索并读取。

人格与记忆

AI 拥有切换角色也不会改变的人格，以及两种记忆。在智能体设置的“人格设定”（ペルソナ）和“记忆”（メモリー）中可以随时查看。

• 人格（人格设定）：价值观、边界和语气的核心。AI 不会自行改写，而是提出建议并等待你的批准。直接编辑正文要在开发者模式的标签页或外部编辑器中进行
• 关于你的记忆（记忆）：称呼方式、说话风格偏好等你在对话中告诉它的内容。可以逐行修改或删除。关闭“记住关于我的事”（あなたのことを覚える）后，既不会传给 AI，也不会记住新的内容（“全部忘记”是另一个操作）
• 笔记（记忆）：AI 自己捕捉到的小事实和做出的决定。可以逐行修改或删除

AI 行为的指导方针写在同一界面的“规则”（ルール）中。语气和角色设定可以通过技能的“角色”（キャラクター）更换，人格在切换技能后依然保留。

第一次打开 AI 列时，可以从“告诉它怎么称呼你”开始。AI 会和你一起决定它自己的名字和氛围，只会询问该怎么称呼你。如果你不提，它不会主动问。

写入记忆时，如果刚读过他人的帖子，一定会弹出确认。确认中会附上读了哪些帖子，以及要写入的文字是否原样出现在他人的帖子中。对人格的提议每次都需要批准，不能省略。在看家（HEARTBEAT）期间不会写入记忆。

权限

AI 能做什么由权限设置控制。默认设置较为保守，以读取为主。

权限按用途相互独立。聊天中的 AI 与后文 HEARTBEAT 中运行的 AI 可以分别设置，放宽其中一个不会影响另一个。插件和外部应用的行也在同一界面中。

你不在时运行（HEARTBEAT）

这是定期运行 AI 的机制。可以让它帮你盯着，比如“如果新通知里有什么重要的，就告诉我”。在智能体设置的 HEARTBEAT 中启用，并通过“编辑巡查步骤”（巡回の手順を編集）写下要做什么。

• 没有需要报告的内容时，它会保持沉默
• 结果会累积在指定的会话中。AI 标记为“请通知”的报告、等待确认的操作、自动停止，也会留在应用的通知（收件箱）中，点击即可打开对应的界面
• 打开“先轻量检查”（まず軽く確認）后，自上次以来没有变化期间就不会调用 AI
• 可以为每天的 AI 启动次数设置上限，达到上限后自动停止
• 连续失败时会自动停止并发出警告（以免在你不知情的情况下一直出错）
• 如果只是连接目标没有启动（例如停掉了本地的 Ollama），不计为失败，启动后会在下一次巡查时恢复
• 在“巡查使用的 AI”里可以选择与聊天不同的连接（默认与聊天相同）。聊天用云端的强模型、巡查用本地的 Ollama，就在这里配置。巡查的连接会收到与聊天相同的人格、关于你的记忆、巡查步骤，以及巡查中读到的内容。在报告目标会话里继续对话时用的是聊天的连接
• “试试这个连接”会用与巡查相同的内容发送一次，确认能否报告（消耗 token 预算）。小模型可能不支持 tool，或输入过长导致指令被截断，此时会显示“不行”。Ollama 的 context 上限可以用 OLLAMA_CONTEXT_LENGTH 或模型的 num_ctx 调高
• “上一次巡查”一行会显示何时、以什么结果结束以及下一次的预定时间。“立即巡查”即使在停用状态下也会运行一次

基本上只在应用运行期间运行。打开“退出应用后继续运行”（アプリを終了しても続ける）后，AI 的独立进程会常驻，关闭期间的报告会在下次打开应用时汇总为一条送达。

由于是无人值守运行，它的权限与聊天分开设置，默认也更严格。无人期间不会写入记忆，需要确认的操作不会执行，而是作为“稍后确认再执行”的卡片留在报告目标会话中。

注意一直运行的成本

HEARTBEAT 会定期调用 API。请先确定间隔和权限再启用。也可以为每个连接设置每天的 token 预算。

从外部 AI 智能体使用（MCP）

反过来，也可以让 Claude Code、Claude Desktop 等外部 AI 智能体把 NoteDeck 当作工具使用。NoteDeck 内置了 MCP（Model Context Protocol）服务器，会把搜索帖子、发帖等与 AI 聊天相同的 capability 作为 tool 提供。

1. 在设置 → 权限 →“永久 API 令牌”（永続 API トークン）中签发令牌。签发后的界面会显示 Claude Code 用的注册命令和 Claude Desktop 用的配置 JSON，复制所需的那一个
2. 签发时选择该令牌可以执行的操作（令牌的权限）。默认只能读取，发帖等写入操作需要逐项允许。上限是同一界面中“外部应用”（外部アプリ）的权限，实际生效的是两者的交集。为每个集成分别签发令牌，权限和归属（确认对话框中显示的名称）就会按集成分开
3. 写入操作一定会先在 NoteDeck 的界面上确认后才执行，确认时会显示令牌名称。不过，这并不是针对以同一 OS 用户运行的程序的安全边界（同一用户的程序可以获得与 NoteDeck 本体相同的权限）。令牌的权限用于防止行为规范的集成出现事故，以及分辨是谁做了什么

像 Claude Code 这样通过 HTTP 连接的应用，直接连接 http://127.0.0.1:19820/mcp。像 Claude Desktop、Cline 这样通过 stdio 启动服务器的应用，把内置的 notemaid 作为 notemaid mcp 交给它们，就会转发到正在运行的 NoteDeck。两种方式都只在 NoteDeck 运行期间可用。