CJY 知识工作台：博客写作使用指南

这是我在Github上的第一个项目，我决定给其中一个功能------博客创作出一篇单独的教程，希望能够对使用这个项目的人提供帮助。

这个网页长期在线。电脑上只需要运行本地桥接，不需要运行开发服务器。127.0.0.1:3000 是开发地址，关闭开发终端后就无法继续访问。

powershell 复制代码

git clone https://github.com/CJY0722/cjy-knowledge-workbench.git
cd cjy-knowledge-workbench
npm install

在 PowerShell 中执行：

powershell 复制代码

npm run bridge -- --vault "E:\自生长知识库"

桥接窗口需要保持运行。每位使用者连接自己的 Obsidian 后，再在工作台"设置"中填写自己的 DeepSeek API Key。密钥只保存在当前桥接进程内存中，关闭桥接即清除；不要把真实密钥写进源码、Markdown、截图或 GitHub。

也可以在启动桥接前临时设置 DEEPSEEK_API_KEY 环境变量，但公开项目不附带任何人的密钥：

powershell 复制代码

$env:DEEPSEEK_API_KEY = "YOUR_API_KEY_HERE"
npm run bridge -- --vault "E:\自生长知识库"

授权只在当前标签页会话中保存。关闭标签页或重启桥接后，需要重新连接。

请按以下顺序操作：

选择或更换知识源后，系统会清除旧的重点确认和预检结果。因此正确顺序是：先选知识源，再确认重点和执行预检。

自己创作正文默认不调用 DeepSeek；只有主动点击"修正阻塞项"或"DeepSeek 去 AI 味"时才会调用。预检、打开草稿、保存和生成平台物料仍需连接本地桥接。

工作台不会把一个复选框冒充 OCR，也不会自动把未经核对的图片内容写成事实。

点击"生成五平台物料"后，可分别复制标题和正文，并打开官方编辑器。账号登录、图片重新上传、封面、标签和最终发布都需要人工完成。

现象	原因与处理
显示"等待本地桥接"	桥接未启动或当前标签页未授权。启动桥接后点击"连接 Obsidian"。
显示"DeepSeek 未配置"	打开工作台"设置"，填写自己的 DeepSeek API Key 并点击"保存到本机"。
DeepSeek 返回余额不足	登录自己的 DeepSeek 账户检查 API 余额；不同使用者不能共用项目维护者的密钥。
提示 DeepSeek API Key 无效或已失效	工作台会自动清除无效密钥。请到 DeepSeek 官方控制台撤销旧密钥、创建新密钥，再回到"设置"填写；不要把密钥发到聊天或截图中。
AI 生成提示先选择知识源	先在"写作材料"中搜索并点击一篇笔记。
AI 生成提示先预检	选择材料后重新确认重点，再执行五类预检。
图片材料无法审核	填写核验记录并勾选"我已真正核对图像"。
"修正阻塞项"没有出现	先点击"审核检查"；仅在存在阻塞项时显示修正按钮。
去 AI 味或阻塞修正无法执行	确认本地桥接已连接、DeepSeek 已配置，并且已完成预检、重点确认和材料核验。
自动修正后仍有阻塞项	按复检结果人工修改，再点"审核检查"；系统不会编造缺失资料来强行通过。
无法确认定稿	必须先保存最新草稿、通过审核，并完成或明确跳过去 AI 味检查。
`127.0.0.1:3000` 无法访问	这是开发地址。改用公网工作台，或另开终端运行 `npm run dev -- --hostname 127.0.0.1 --port 3000`。