前言¶
在 DeepSeek Harness（DSH）里和模型来回讨论，结论往往散在消息流里：过几天想找回某段话，只能翻会话；复制到外部笔记又丢了「来自哪条消息、哪段上下文」的锚点。常见做法是整段复制到 Notion 或本地 Markdown，但索引、回跳原文、和当前会话绑定都要自己维护。
下面介绍社区插件 dsh-memo-guojc（维护者 stellar-dream），分类为「记忆」。它在 DSH 桌面端旁挂一层「对话切片 / 备忘录 / 经验库」：划词即记，用 SQLite FTS5 做中文检索，并能一键跳回原文；运行时零第三方依赖。插件目录页：https://www.skillhub.cn/plugins/stellar-dream/dsh-memo-guojc，源码：https://github.com/stellar-dream/dsh-memo-guojc（MIT，当前发布包版本 0.3.1）。
这是什么¶
dsh-memo-guojc 是 DSH 的单体桌面端插件，不是独立笔记应用。它在对话里选中文字 → 存成「切片」→ 自动记住 session_id 与消息区间；原文不复制进库，只记位置和引文，需要时从本机会话 transcript 取回并高亮。
收起时界面右侧保留「大肥鱼」入口（DeepSeek 蓝鲸梗的二创），点一下展开面板；展开后可浏览全局树、备忘录、经验库并搜索。
核心功能¶
资料中列出的能力如下，安装前可按需对照。
| 能力 | 说明 |
|---|---|
| 划词建切片 | 选中文字 → 浮动条「✂ 切片」→ 填标题 / 摘要 / 类型 / 标签，自动挂到当前会话 |
| 全局树 | 项目 → 会话 → 切片 → 子话题，可关键词裁剪、按标签过滤 |
| 备忘录 | 只列 ★ 重点切片，可钉重点或取消 |
| 经验库 | 切片标为「经验候选」→ 人工确认后落库（结论 / 情境 / 适用性 / 来源切片），可检索并导出 Markdown |
| 全文检索 | SQLite FTS5；中文写入索引前切成二元组，两字词也能命中；单字查询退化为 LIKE |
| 跳回原文 | 按消息区间定位，或按引用文字在页面查找并闪烁高亮 |
| AI 协同 | 可调 DeepSeek：消息区间 → 切片提议；切片 → 经验提炼；一律先进确认界面，点了才落库 |
| AI 工具 | 8 个工具：slice_write slice_search slice_list slice_tree slice_mark_key experience_write experience_search experience_export |
| 斜杠命令 | /slice list\|add\|search\|tree\|key、/exp list\|add\|search\|export |
| 数据迁移 | 从 v2 的 entries 表自动迁移：exp → 经验库、memo → 重点切片 |
HTTP API 挂在 /dsh-memo 下，仅接受回环 Host 与同源请求；健康检查、树、切片 CRUD、FTS 搜索、经验导出等路径见仓库 README 的「HTTP API」一节。
安装与启用¶
前提：DSH 桌面端 0.2.x，Node ≥ 22.5（插件使用 node:sqlite）。
方式一：插件面板（推荐）¶
插件面板 → 安装 → 选择 dsh-memo-guojc-0.3.1.tgz → 按提示确认 → 重启一次桌面端。
方式二：一行命令¶
先完全退出 DSH 桌面端（CLI 会在 profile 目录跑 pnpm，与桌面端占用同一批文件），再执行：
dsh plugin --profile desktop add ./dsh-memo-guojc-0.3.1.tgz
这条命令等价于在 profile 目录执行 pnpm add <spec>，成功后会同时写入 dependencies 与 dsh.profile.bundles。
调试时可链本地源码目录（路径换成你的绝对路径）：
dsh plugin --profile desktop add link:/absolute/path/to/dsh-memo-guojc
方式三：手工装进 profile¶
离线或面板不可用时，可按 README 用 PowerShell 解包 tgz 到 node_modules、复制到 vendor、并改 package.json 的 dependencies 与 dsh.profile.bundles。手工装后不要再跑 pnpm install；更细的安装 / 升级 / 卸载见仓库 docs/install.md。
装完务必重启桌面客户端：宿主只在启动时收集页面注入行，插件模块也在启动时装载。
典型用法¶
划词建切片¶
在对话里选中一段文字 → 浮出「✂ 切片」或「✨ AI 切片」→ 填标题（摘要、类型、标签可选）→ 保存。保存时自动挂到当前会话并记下消息区间。
面板与快捷键¶
- 全局树：点切片行进详情（局部树 + 动作），「← 返回全局树」回到顶层。
- 备忘录：仅 ★ 重点切片。
- 经验库：上半为经验候选切片，下半为已确认经验；右上角可导出 Markdown。
- 顶部搜索框：搜标题 / 摘要 / 原文，切 Tab 保留关键词。
- 标签 chips：点一下按标签过滤，再点取消。
- 置顶与拖动：钉住后面板外点击不会自动收起；拖标题栏可挪位置（记在
localStorage）。
| 键 | 作用 |
|---|---|
Ctrl/Cmd + Shift + M |
展开 / 收起面板 |
Ctrl/Cmd + N |
面板内新建切片 |
Esc |
关弹窗 → 退出详情 → 清搜索 → 收起面板（逐级） |
让助手直接记¶
对助手用自然语言即可，由工具落库，例如：
- 「把刚才那段存成切片，标题叫……」→
slice_write - 「我之前记过关于 FTS5 的切片吗」→
slice_search - 「我有哪些重点切片」→
slice_list或/slice list - 「导出经验库」→
experience_export或/exp export
斜杠命令示例：
/slice 列出最近切片
/slice add 标题 | 摘要 手动建一条切片
/slice search FTS5 全文检索
/slice tree 打印全局树
/slice key <id 前 8 位> 钉为重点
/exp 列出经验（含候选）
/exp add 结论 | 情境 手动写一条经验
/exp search 中文 检索经验
/exp export 导出 Markdown
数据、隐私与适用注意¶
- 库文件：默认
$DSH_HOME/memo-guojc/memo.db（WAL）；环境变量MEMO_GUOJC_DIR可改目录。 - 会话原文：不复制进 memo 库；切片存
session_id、message_start、message_end、quote_text，从$DSH_HOME/sessions/**/session.v4.jsonl.zstd现场解压取回。 - 出网：除你自行配置的 DeepSeek API（仅在「AI 切片 / 提炼经验」时）外，插件不向第三方发请求；无遥测、无账号。API Key 存本机 SQLite
meta.settings，接口只回apiKeySet；也可用DEEPSEEK_API_KEY/DSH_DEEPSEEK_API_KEY。
适合谁：长期在 DSH 里做方案推演、需要把对话里的结论钉成可检索切片、并偶尔沉淀成经验 Markdown 的开发者。
安装前注意：DSH 生态是「一切皆插件」；SkillHub 等社区目录与 DeepSeek / 幻方无官方从属关系。插件以当前 DSH 进程权限运行，安装前应自行查看源码与 MIT 许可证，确认数据路径与 AI Key 策略可接受。
结尾¶
经过上面的步骤，dsh-memo-guojc 把「划词 → 索引 → 跳回原文 → 重点与经验」收进 DSH 侧边，减少在会话与外部笔记之间来回搬运。若要进一步了解接口与架构，可直接读 GitHub README 与 docs/。
