dsh-client-ui-second-brain

🧠 AI 第二大脑（AI Second Brain）

把每天和各种 AI 的对话（豆包 / ChatGPT / DeepSeek / Kimi / 通义千问 / 文心一言…）提炼成结构化 Markdown 笔记，写入你的 Obsidian 库。提炼引擎跑在本机 DeepSeek Harness 里，模型服务商、版式、视觉识别均可配置。

功能特性

• 三种录入方式：粘贴文本 / 导入对话文件 / 分享链接（豆包、ChatGPT、Kimi、DeepSeek、通义千问、智谱、文心一言）
• 浏览器扩展「通用提炼」：任意 AI 网页右下角悬浮按钮一键提炼当前对话
• Harness 会话直接提炼：在设置页「📚 Harness 会话」或会话头部 ✨ 按钮，一键把本机 Harness 会话归档为笔记
• 服务端统一提炼管线（单一事实源）：
  • 内容类型自动识别（知识 / 方法流程 / 分析讨论 / 创作产物 / 问题解决）
  • 版式偏好：自动识别 / 生词卡片式 / 概念分层式 / 目标·过程·成效式 / 产物归档式 / 复盘式 / 学习笔记
  • 多课题自动分篇：一个对话含多份独立内容产物时，自动拆成「一课题一篇」+ 索引页
  • 无限续写防截断（长对话/长产物不再被 max_tokens 截断）
  • 提炼后自检：对照原文查漏，发现问题自动带反馈重提炼一次（可开关）
• 图片处理：
  • ChatGPT 分享链接的图片可抓取保存（依赖本机 Edge/Chrome + puppeteer-core，可选）；抓取时自动压缩为 JPEG（最长边 1280），显著减小附件与视觉调用体积
  • 配置视觉模型（豆包 / 通义 / 任意 OpenAI 兼容）后，图片内容会被识别并写入笔记 / 索引附图说明（图片多时自动分批调用，避免一次发送过多导致超时）
  • 图片保存上限可配置（默认 50）
• 自定义整理要求：填写后优先按你的规则整理，覆盖默认类型体系

图片抓取与取舍标准

ChatGPT 分享对话里常有一边生成一边重画的情况，中间草稿不该进第二大脑。架构为 「AI 语义分类 + 程序确定性执行」——AI 只负责理解语义，去留由程序按规则算出来（可复现、不漂移）：

1. 抓取与描述：无头浏览器抓取全部图片（自动压缩为 JPEG），豆包视觉模型逐张写内容描述
2. AI 语义分类：主模型对「每条用户反馈」分类（approve / extend / modify / negate / uncertain）+ 分配修改链（lineageId），只输出 图片标识 + 用户原话证据 + 置信度，不直接输出去留
3. 程序确定性执行（lib/judge.js，纯逻辑、16 项单元测试覆盖）按四条规则计算：
   • 明确认可 / 基于它延伸 → 保留
   • 明确否定（高置信 + 原文强否定证据）→ 即使无替代也排除
   • 修改 + 存在同一修改链的替代图 → 排除旧图（新口味/延伸/其他任务不算替代）
   • 修改但无同链替代 / 无法确定 / 低置信（<0.8）/ 证据非原文 → 默认保留（宁可多留）
   • 明确认可过的版本锁定保留（优先于其它规则）
4. 只保存保留的图（废图不落盘）；分类结果按「对话哈希 + 图片 hex」缓存到本机，重复导入同一链接结果稳定
5. 兜底：模型不可用时保守保留全部（避免误删）；关键词规则仅兜底处理「不要这张 / 这版不行 / 重画这张」等强否定
6. 不抓的图：用户上传的参考图默认排除；ChatGPT 分享页未渲染的图无法抓取（平台限制）

项目结构

second-brain/
├── dsh-client-ui-second-brain/   # DSH 插件（本仓库主体）
│   ├── package.json              # 插件清单（node 半端 + 浏览器半端入口）
│   └── lib/
│       ├── index.js              # node 半端：同源代理路由 + 提炼管线 + Obsidian 写入
│       ├── client.js             # 浏览器半端：设置面板 + 录入界面 + 归档记录
│       └── judge.js              # 图片去留的确定性规则引擎（纯逻辑，不调模型）
├── doubao-extension/             # 浏览器扩展（无构建，直接加载解压目录）
│   ├── manifest.json
│   ├── content.js                # 任意 AI 网页的对话抓取
│   ├── background.js             # 转发到本机 /api/second-brain/distill
│   └── popup.html / popup.js     # 状态检查
├── tests/
│   └── apply-rules.test.mjs      # 规则引擎离线单元测试（16 项，不联网）
└── config.example.json           # 共享配置模板（真实配置在本机 ~/.dsh/plugins/second-brain/config.json）

安装

前置条件

• 本机运行 DeepSeek Harness（Web 界面，默认 http://127.0.0.1:3080）
• Node.js ≥ 18

方式 A：本地源码安装（开发 / 自用）

1. 克隆或复制仓库，例如放到 ~/deepseek harness/second-brain
2. 建立软链，让 Harness 的 profile 能解析到插件：

   mkdir -p ~/.dsh/profiles/node_modules
   ln -s /absolute/path/to/second-brain/dsh-client-ui-second-brain ~/.dsh/profiles/node_modules/dsh-client-ui-second-brain
   

3. 在 profile 补丁层注册插件（~/.dsh/profiles/web/cordis.patch.yml）：

   - insert:
       - id: second-brain
         name: 'dsh-client-ui-second-brain'
   

4. 重启 Harness，浏览器打开设置 ⚙️ → AI 第二大脑

方式 B：npm 安装（发布后可用）

dsh plugin add dsh-client-ui-second-brain

浏览器扩展安装

1. 打开 edge://extensions（Chrome 用 chrome://extensions）
2. 开启「开发人员模式」
3. 「加载解压缩的扩展」→ 选择 doubao-extension 目录
4. 在任意 AI 对话页右下角点 「✨ 提炼本对话」

配置（设置 → AI 第二大脑）

隐私与安全

• API 密钥仅保存在本机 ~/.dsh/plugins/second-brain/config.json，不在仓库内（见 .gitignore）；请勿把你的真实配置提交到任何仓库
• 所有本地路由仅监听 127.0.0.1，浏览器扩展也仅请求 http://127.0.0.1:3080
• 对话内容只在本机处理后写入你的 Obsidian 库；唯一的外发请求是发给你在设置里配置的模型服务商（提炼 / 视觉识别）
• ChatGPT 分享图片抓取需要本机安装 Edge/Chrome 与 puppeteer-core（可选能力，缺失时自动降级为纯文字总结）

开发

• 改 node 半端（lib/index.js）后需重启 Harness 生效
• 改浏览器半端（lib/client.js）后硬刷新页面即可
• 插件通过软链直接指向工作区源码，改完无需拷贝
• 测试：规则引擎离线单测 node tests/apply-rules.test.mjs（不联网、纯逻辑）；真实对话/图片夹具放在 git 忽略的 tests-local/（隐私），不入仓库
• 图片分类缓存：本机 ~/.dsh/plugins/second-brain/judge-cache/（不入仓库），删除可强制重新分类

License

MIT