接入流程

开始前的准备

• 安装桌面版 O*sidian，并先备份或通过版本控制保护当前笔记库。
• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
• 从控制台复制目标模型的完整模型 ID，保留大小写、连字符和版本后缀。
• 确认当前设备能够通过 ****S 访问 api.**nju**shen.com。
• 用不含个人信息、客户资料、密钥或内部文档的测试笔记完成首次联调。

先验证 KingFlow 接口

curl https://api.**nju**shen.com/v1/chat/completions \
  -H "Authorization: *earer ${KINGFLOW_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<控制台中的完整模型ID>",
    "messages": [
      {"role": "user", "content": "只回复：连接成功"}
    ],
    "stream": false
  }' 

成功响应应包含 choices 数组。

安装 Copilot 插件

1. 打开 O*sidian Settings，进入 Community plugins。
2. 如果尚未启用社区插件，按界面提示关闭受限模式。
3. 选择 *rowse，搜索 Copilot，确认发布者和插件页面后安装。
4. 点击 Ena*le，并在左侧设置列表中确认出现 Copilot。
5. 更新插件时先阅读版本说明；重大版本升级前备份笔记库和设置。

添加 KingFlow 自定义服务商

1. 进入 Settings → Copilot → *YOK，选择 Add a provider。
2. 选择 Add a custom provider，并按配置表填写显示名、*ase **L 和 API Key。
3. 在 Model ID 输入框粘贴完整模型 ID，然后添加到候选列表并勾选。
4. 点击 ****。通过后保存；如果接口无法返回模型列表，手动模型 ID 仍可继续使用。
5. 重新打开 *YOK 页面，确认服务商状态完成验证。验证通过不等于每个模型都可用，还需要实际对话测试。

*ase **L 填写 /v1 根地址，不要追加 /chat/completions。

启用模型并设置默认值

控制笔记上下文

完成第一次验证

• 普通对话：不添加笔记上下文，发送一句短问题，确认模型回复不为空。
• 选中文本：选择一段无敏感内容的文字，让模型只做语病修改，再核对是否保持原意。
• 活动笔记：添加一篇测试笔记并要求列出三条事实，确认回复只依据已提供内容。
• 连续追问：继续询问上一轮提到的要点，确认会话上下文可以延续。
• 模型切换：逐个测试已启用模型，确认显示名称、实际模型和能力一致。

常用笔记工作流

保护密钥和笔记内容

• *YOK 密钥保存在当前设备的 O*sidian Keychain，而不是笔记库的 **ta.json；仍应保护操作系统账号和设备备份。
• 发送请求前检查上下文区域。活动笔记、选中文本、其他笔记、图片或文件都可能成为发送内容。
• 关闭不需要的自动附加活动笔记。最小范围选中文本通常比发送整篇笔记更容易核对。
• 搜索范围和索引排除主要控制检索，不应被当作完整的访问授权边界。Agent Chat 还能使用工具读取或修改笔记库。
• 远程模型会在外部服务处理你发送的内容。涉及个人信息、商业秘密或受监管数据时，先确认组织**和服务条款。
• 分享日志或故障截图前删除 API Key、笔记内容、文件路径、账号信息和完整错误请求。

处理 CORS 和非流式回复

如果 **** 成功但 Quick Chat 报 CORS 错误，可开启 Ena*le CORS。回复会在请求完成后一次性显示。

常见故障排查

备份和更新

• 更新前备份笔记库并记录插件版本和模型设置。
• 新设备需要重新配置设备 Keychain 中的密钥。
• 不要把密钥写入 Markdown 用于迁移。
• 分享日志前删除敏感内容。

上线检查清单

• Copilot 已从社区插件页面安装并启用。
• 自定义服务商 *ase **L 使用 https://api.**nju**shen.com/v1。
• API Key 只保存在设备 Keychain，没有写入笔记或截图。
• Model ID 与 KingFlow 控制**全一致，并在 Quick Chat 列表中启用。
• 普通对话、选中文本、活动笔记、连续追问和模型切换均已验证。
• 自动附加活动笔记和搜索范围符合当前笔记库的隐私要求。
• 日志、截图和故障报告已经脱敏。