CJY 知识工作台博客写作使用指南这是我在Github上的第一个项目我决定给其中一个功能——博客创作出一篇单独的教程希望能够对使用这个项目的人提供帮助。一、推荐打开方式日常使用请打开https://cjy0722.github.io/cjy-knowledge-workbench/#blog这个网页长期在线。电脑上只需要运行本地桥接不需要运行开发服务器。127.0.0.1:3000是开发地址关闭开发终端后就无法继续访问。二、首次准备1. 安装项目git clone https://github.com/CJY0722/cjy-knowledge-workbench.git cd cjy-knowledge-workbench npm install2. 启动桥接在 PowerShell 中执行npm run bridge----vaultE:\自生长知识库桥接窗口需要保持运行。每位使用者连接自己的 Obsidian 后再在工作台“设置”中填写自己的 DeepSeek API Key。密钥只保存在当前桥接进程内存中关闭桥接即清除不要把真实密钥写进源码、Markdown、截图或 GitHub。也可以在启动桥接前临时设置DEEPSEEK_API_KEY环境变量但公开项目不附带任何人的密钥$env:DEEPSEEK_API_KEY YOUR_API_KEY_HEREnpm run bridge----vaultE:\自生长知识库3. 连接 Obsidian打开公网工作台并进入“博客写作”。在“开始前检查”中点击“连接 Obsidian”。核对知识库名称和网页来源点击“允许连接”。返回工作台后打开“设置”填写自己的 DeepSeek API Key 并点击“保存到本机”。确认博客页显示“Obsidian 已连接”和“DeepSeek 已配置”。授权只在当前标签页会话中保存。关闭标签页或重启桥接后需要重新连接。三、从知识库生成 AI 初稿请按以下顺序操作写作方式选择“AI 从知识源写”。材料类型选择“Markdown / 代码”。在“写作材料”中输入关键词并搜索然后点击一篇笔记。修改“文章重点”和“本次要求”。点击“确认重点”如果确实不需要重点约束可点击“明确跳过讨论”。点击“执行五类预检”。即使没有命中也会记录为已完成。点击“AI 生成初稿”。在确认窗口核对 DeepSeek 状态然后点击“同意并生成”。在编辑区检查并修改生成结果。点击“审核检查”。如果出现阻塞项点击“修正阻塞项”DeepSeek 会按审核结果改写并自动复检仍有阻塞时可人工修改后再次审核。点击“DeepSeek 去 AI 味”检查改写后的事实、代码、链接和表达。此操作不会自动保存或通过人工检查。审核无阻塞后点击“确认后写入”把当前版本保存到 Obsidian。在“人工确认”中选择“已完成人工表达检查”或“明确跳过”再点击“确认文章定稿”。生成推广文案或五平台物料。选择或更换知识源后系统会清除旧的重点确认和预检结果。因此正确顺序是先选知识源再确认重点和执行预检。四、自己创作选择“自己创作”或点击“新建原创”。输入标题和 Markdown 正文也可以导入.md、.markdown或.txt文件。确认重点并执行五类预检。审核需要时使用“修正阻塞项”和“DeepSeek 去 AI 味”复核后保存并定稿。生成五平台物料。自己创作正文默认不调用 DeepSeek只有主动点击“修正阻塞项”或“DeepSeek 去 AI 味”时才会调用。预检、打开草稿、保存和生成平台物料仍需连接本地桥接。五、修改已有文章选择“修改已有文章”。点击“导入 Markdown”或“打开已有文章”。填写修改要求。确认重点并执行预检。点击“AI 辅助修改”确认后生成完整修改稿。审核并保存新版本。同名文件覆盖前会再次确认旧版本会归档。六、PDF、板书和图片材料材料类型选择“PDF / 板书 / 图片”。先自行渲染或执行 OCR。在“渲染 / OCR 核验记录”中填写核对过的页码、图示要点或笔记路径。勾选“我已真正核对图像”。再确认重点、执行预检并生成或审核。工作台不会把一个复选框冒充 OCR也不会自动把未经核对的图片内容写成事实。七、多平台发布CSDN、掘金生成标准 Markdown。知乎、微信公众号生成富文本兼容稿。小红书长文生成去除 Markdown 标记的纯文本。小红书图文按内容拆成 1080 × 1440 的 PNG 图卡。点击“生成五平台物料”后可分别复制标题和正文并打开官方编辑器。账号登录、图片重新上传、封面、标签和最终发布都需要人工完成。八、常见问题现象原因与处理显示“等待本地桥接”桥接未启动或当前标签页未授权。启动桥接后点击“连接 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。九、安全说明DeepSeek 密钥只发送到已配对的127.0.0.1本机桥接并保存在进程内存中关闭桥接即清除。GitHub 项目不包含维护者或任何使用者的密钥每位使用者必须填写自己的密钥。网页不会读取或保存发布平台密码、Cookie 或 Token。GitHub Pages 不保存知识库内容。最终写入 Obsidian 和发布到外部平台前都保留人工确认。 CJY 知识工作台：博客写作使用指南
CJY 知识工作台博客写作使用指南这是我在Github上的第一个项目我决定给其中一个功能——博客创作出一篇单独的教程希望能够对使用这个项目的人提供帮助。一、推荐打开方式日常使用请打开https://cjy0722.github.io/cjy-knowledge-workbench/#blog这个网页长期在线。电脑上只需要运行本地桥接不需要运行开发服务器。127.0.0.1:3000是开发地址关闭开发终端后就无法继续访问。二、首次准备1. 安装项目git clone https://github.com/CJY0722/cjy-knowledge-workbench.git cd cjy-knowledge-workbench npm install2. 启动桥接在 PowerShell 中执行npm run bridge----vaultE:\自生长知识库桥接窗口需要保持运行。每位使用者连接自己的 Obsidian 后再在工作台“设置”中填写自己的 DeepSeek API Key。密钥只保存在当前桥接进程内存中关闭桥接即清除不要把真实密钥写进源码、Markdown、截图或 GitHub。也可以在启动桥接前临时设置DEEPSEEK_API_KEY环境变量但公开项目不附带任何人的密钥$env:DEEPSEEK_API_KEY YOUR_API_KEY_HEREnpm run bridge----vaultE:\自生长知识库3. 连接 Obsidian打开公网工作台并进入“博客写作”。在“开始前检查”中点击“连接 Obsidian”。核对知识库名称和网页来源点击“允许连接”。返回工作台后打开“设置”填写自己的 DeepSeek API Key 并点击“保存到本机”。确认博客页显示“Obsidian 已连接”和“DeepSeek 已配置”。授权只在当前标签页会话中保存。关闭标签页或重启桥接后需要重新连接。三、从知识库生成 AI 初稿请按以下顺序操作写作方式选择“AI 从知识源写”。材料类型选择“Markdown / 代码”。在“写作材料”中输入关键词并搜索然后点击一篇笔记。修改“文章重点”和“本次要求”。点击“确认重点”如果确实不需要重点约束可点击“明确跳过讨论”。点击“执行五类预检”。即使没有命中也会记录为已完成。点击“AI 生成初稿”。在确认窗口核对 DeepSeek 状态然后点击“同意并生成”。在编辑区检查并修改生成结果。点击“审核检查”。如果出现阻塞项点击“修正阻塞项”DeepSeek 会按审核结果改写并自动复检仍有阻塞时可人工修改后再次审核。点击“DeepSeek 去 AI 味”检查改写后的事实、代码、链接和表达。此操作不会自动保存或通过人工检查。审核无阻塞后点击“确认后写入”把当前版本保存到 Obsidian。在“人工确认”中选择“已完成人工表达检查”或“明确跳过”再点击“确认文章定稿”。生成推广文案或五平台物料。选择或更换知识源后系统会清除旧的重点确认和预检结果。因此正确顺序是先选知识源再确认重点和执行预检。四、自己创作选择“自己创作”或点击“新建原创”。输入标题和 Markdown 正文也可以导入.md、.markdown或.txt文件。确认重点并执行五类预检。审核需要时使用“修正阻塞项”和“DeepSeek 去 AI 味”复核后保存并定稿。生成五平台物料。自己创作正文默认不调用 DeepSeek只有主动点击“修正阻塞项”或“DeepSeek 去 AI 味”时才会调用。预检、打开草稿、保存和生成平台物料仍需连接本地桥接。五、修改已有文章选择“修改已有文章”。点击“导入 Markdown”或“打开已有文章”。填写修改要求。确认重点并执行预检。点击“AI 辅助修改”确认后生成完整修改稿。审核并保存新版本。同名文件覆盖前会再次确认旧版本会归档。六、PDF、板书和图片材料材料类型选择“PDF / 板书 / 图片”。先自行渲染或执行 OCR。在“渲染 / OCR 核验记录”中填写核对过的页码、图示要点或笔记路径。勾选“我已真正核对图像”。再确认重点、执行预检并生成或审核。工作台不会把一个复选框冒充 OCR也不会自动把未经核对的图片内容写成事实。七、多平台发布CSDN、掘金生成标准 Markdown。知乎、微信公众号生成富文本兼容稿。小红书长文生成去除 Markdown 标记的纯文本。小红书图文按内容拆成 1080 × 1440 的 PNG 图卡。点击“生成五平台物料”后可分别复制标题和正文并打开官方编辑器。账号登录、图片重新上传、封面、标签和最终发布都需要人工完成。八、常见问题现象原因与处理显示“等待本地桥接”桥接未启动或当前标签页未授权。启动桥接后点击“连接 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。九、安全说明DeepSeek 密钥只发送到已配对的127.0.0.1本机桥接并保存在进程内存中关闭桥接即清除。GitHub 项目不包含维护者或任何使用者的密钥每位使用者必须填写自己的密钥。网页不会读取或保存发布平台密码、Cookie 或 Token。GitHub Pages 不保存知识库内容。最终写入 Obsidian 和发布到外部平台前都保留人工确认。