思源笔记集成 DeepSeek API：在 awesome-deepseek-integration 中配置块级 AI 问答的完整指南
思源笔记集成 DeepSeek API在 awesome-deepseek-integration 中配置块级 AI 问答的完整指南【免费下载链接】awesome-deepseek-integrationIntegrate the DeepSeek API into popular software项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-integration本文以 docs/SiYuan/README.md 为核心讲解如何在思源笔记SiYuan中接入 DeepSeek API完成从申请密钥到 AI 设置页配置、再到对文档块直接发起 AI 问答的完整流程。读完后你将掌握思源笔记 AI 设置页中各项参数API 基础地址、模型、温度、超时、最大上下文数等的取值与含义并能把 DeepSeek 作为知识块背后的问答引擎。一、为什么是思源笔记 × DeepSeek根据官方文档对项目本身的描述SiYuan思源笔记是一款注重隐私的个人知识管理系统支持完全离线使用并提供端到端加密的数据同步功能其核心是通过融合**块Block、大纲Outline和双向链接Bidirectional Links**来重构知识组织方式见 docs/SiYuan/README_cn.md。把这个定位与 DeepSeek API 结合得到的使用形态是笔记数据本身可以完全留在本地或走端到端加密同步而问 AI的能力则按需调用远端 DeepSeek 模型——对选中的笔记块发起问答、续写或概念解释AI 的回复直接以块的形式落回文档中。这正是 README.md 的 Applications 分类中收录 SiYuan 的动机。需要说明的前提本仓库是 awesome-deepseek-integration 集成清单仓库docs/SiYuan/目录下只有集成说明文档与截图docs/SiYuan/README.md、docs/SiYuan/README_cn.md 及assets/截图不含思源笔记本体源码因此下文的界面与参数均来自该文档及其配图而非仓库内源码。二、第一步申请 DeepSeek 令牌集成第一步README 中的 STEP1前往 DeepSeek 开放平台DeepSeek Open Platform申请一个 API 令牌API Key。该 Key 是后续在思源笔记 AI 设置页中API Key输入框的唯一凭证从截图界面描述看思源提示建议为思源单独分配 API Key 以便于后续管理——即建议为思源单独创建一枚 Key而不是复用其他工具的 Key便于按应用维度做用量追踪和权限回收该输入框留空则禁用 AI 相关功能也就是说思源笔记的 AI 能力完全以配置了 API Key为开关。三、第二步进入设置界面按照 docs/SiYuan/README.md 的 STEP 2点击思源笔记主界面右上角的设置入口快捷键AltJ打开设置界面。上图为文档配图红框标出了设置菜单的位置。四、第三步配置 AI 选项卡进入设置后导航到左侧的AI选项卡。这是整个集成流程的核心页面。根据文档 STEP 3 与配套截图需要填写的项如下设置项截图界面说明建议取值API 提供商选择后将使用该提供商的 API 服务实现 AI 相关功能下拉框中选择OpenAIOpenAIDeepSeek 提供 OpenAI 兼容接口API 基础地址发起请求的基础地址https://api.deepseek.com/v1/模型请求 API 时传入的model参数用于控制生成的文本风格使用 Azure OpenAI 服务时需填入 Deployment IDdeepseek-chatAPI Key建议单独分配一枚 Key留空则禁用 AI 功能第一步申请的令牌温度请求 API 时传入的temperature参数用于控制生成的文本随机性1.3文档推荐值超时时间发起请求的超时时间单位秒30截图中默认值最大 Token 数请求 API 时传入的max_tokens参数用于控制生成的文本长度0截图中默认值即不显式限制最大上下文数请求 API 时传入的最大上下文数7截图中默认值网络代理发起请求的网络代理留空即可示例格式为socks://user:pass127.0.0.1:1080关键参数解析API 基础地址URI的写法。英文文档 docs/SiYuan/README.md 中写的是URI: https://api.deepseek.com而中文文档 docs/SiYuan/README_cn.md 与设置页截图中实际填入的值是带/v1/路径的https://api.deepseek.com/v1/。从截图看后者的写法与思源API 基础地址字段的语义请求基础地址类比https://api.openai.com/v1一致实操时建议以带/v1/的完整路径为准。为什么 API 提供商选 OpenAI。DeepSeek API 采用 OpenAI 兼容的接口协议因此思源笔记无需为 DeepSeek 提供专门的提供商适配——只要基础地址指向https://api.deepseek.com/v1/走 OpenAI 兼容请求格式即可。这是通用 OpenAI 兼容字段 自定义基础地址这一类接入方式的典型用法。模型与温度。模型固定填deepseek-chat即 DeepSeek 的对话模型。温度temperature文档推荐1.3用于控制生成文本的随机性数值越高输出越发散、有创意数值越低输出越稳定、收敛。截图中思源 AI 页默认显示1.2按文档建议改为1.3属于可选调优不是必填项。最大上下文数。该字段控制发起请求时携带的最大上下文数截图默认值为7。在笔记场景下它影响 AI 能看到多少周边块/上下文——值越大模型对笔记结构的理解越完整但请求也随之变长。网络代理。如果所在网络需要代理才能访问 DeepSeek API可在该字段按socks://user:passhost:port格式填写直连网络留空即可。配置完成后的界面配置完成后AI 选项卡中应能看到模型一栏为deepseek-chat、API 基础地址为https://api.deepseek.com/v1/API Key 以掩码形式显示文档以红框标注了copy your API与put the url两处关键填写位。五、如何使用对块发起 AI 问答配置保存后实际使用方式README 中的 how to use 部分是将光标置于某个文档块上从块的操作菜单中展开人工智能AI子菜单即可发起请求。上图为文档配图红框标出了块菜单中的人工智能入口右侧显示了对多模态大模型MLMs和世界模型WMs两个概念的一段 AI 生成解释——生成结果以普通文本块的形式插入笔记可继续参与后续编辑、双向链接与大纲导航。结合 SiYuan 的块级架构这意味着 DeepSeek 的输出不是浮层对话而是成为文档的一部分可以像其他块一样被引用、移动、折叠也可以再次选中作为下一轮提问的上下文。六、注意事项与排错要点AI 功能的开关是 API KeyKey 留空时所有 AI 相关功能被禁用若填入后仍不可用优先检查 Key 是否有效、是否欠费。URI 写法以https://api.deepseek.com/v1/为准中文文档与截图一致英文文档中的无路径写法是同一端点的简写。隐私边界思源笔记本体支持离线与端到端加密同步但一旦启用 DeepSeek所选块的文本会随 API 请求发送到远端服务。对敏感内容发起 AI 请求前应自行评估数据外发风险。参数默认值来源表中超时 30 秒、最大 Token 0、最大上下文数 7、温度 1.2等默认值取自官方文档配图 docs/SiYuan/assets/image-20250122162241-32a4oma.png不同版本客户端的默认值可能略有差异以实际界面为准。文档语言版本本集成同时提供英文 docs/SiYuan/README.md 与中文 docs/SiYuan/README_cn.md 两个版本两者步骤一致仅 URI 写法上存在前述差异。七、延伸阅读完整集成清单入口README.mdSiYuan 收录于 Applications 分类同一目录下可直接查看三张原始配图设置菜单入口image-20250122163007-hkuruoe.png、AI 设置页image-20250122162241-32a4oma.png、块级 AI 使用image-20250122162425-wlsgw0u.png均位于 docs/SiYuan/assets 目录。【免费下载链接】awesome-deepseek-integrationIntegrate the DeepSeek API into popular software项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-deepseek-integration创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考