前言¶
在 DeepSeek Harness（DSH）里和模型对话时，常常会出现一句值得留下的原话，或者一个还没成形的想法。若每次都要先起标题、选分类、再切到别的工具保存，摩擦会打断思考节奏。乱记（thomas-zz/dsh-luanji）是面向这一场景的 DSH 插件：划选对话原文即可引用并记录，侧栏一行即可弹出速记便签，数据默认只写在本机 JSON，需要时再可选接入自建云端。下面介绍其定位、能力与安装用法。
这是什么¶
乱记由维护者 Thomas-zz 发布，在 SkillHub 社区目录中归类为「记忆」。插件全名为 @dsh-external/dsh-luanji，当前 package 版本为 0.5.0，采用 MIT 许可证。它长在「你和 AI 碰撞想法」的界面里：左侧面板一行「乱记」，点一下弹出记录便签；划选对话里的原话，可在 DSH 原生浮动条上直接「记录 / 引用并记录 / 引用文本」。默认不联网、不需要账号，所有内容落在本机 ~/.dsh/luanji/notes.json。
核心功能¶
本地优先与数据文件¶
默认完全本地。记录、引用与草稿写入：
~/.dsh/luanji/notes.json # 记录 + 引用 + 草稿
~/.dsh/luanji/notes.json.bak # 上一次写入前的备份
~/.dsh/luanji/cloud-sync.json # 可选云端同步的时间/结果（不存凭据）
写入先写临时文件、fsync，再原子替换；读取损坏文件时保留原文件并报错，不会用空记录覆盖。v2 格式将 records（自己的想法）与 quotes（原始引用 + 来源）分开，用 quoteId 关联。
划选即记与引用结构¶
选中一句话后，浮动条提供：记录 直接存；引用并记录 先写想法；引用文本 放回输入框（DSH 原行为）。引用保留来源（模型、对话、文本锚点），想法单独编辑；展示时引用在上、想法在下。原句在对话里以淡底 + 下划线标记，刷新或回到对话仍能恢复；记录可「回到对话」。
便签、面板与快捷键¶
| 入口 | 操作 |
|---|---|
| 左侧面板「乱记」 | 点整行 → 就近弹出记录便签；点行尾小按钮 → 进入乱记面板 |
| 划选对话原文 | 原生浮动条：记录 / 引用并记录 / 引用文本 |
| 乱记面板 | 直接记录、图片、搜索、编辑/删除、导入导出、云端同步 |
| 快捷键 | 作用 |
|---|---|
⌘ / Ctrl + Shift + L |
打开记录便签 |
⌘ / Ctrl + Enter |
保存当前输入 |
Esc |
收起便签，保留草稿 |
⌘ / Ctrl + K |
在面板聚焦搜索 |
便签、面板、引用分别保留草稿；输入停止约 400 ms 后写入本机。一条记录最多 6 张图片（PNG/JPEG/WebP/GIF，单文件 ≤ 20 MB，保存前缩到最长边 1600），正文最多 20,000 字。搜索覆盖正文、引用原文、模型名和对话名，为文字/模糊匹配，不是语义搜索。
可选云端同步¶
默认不上传。若在 profile 的 cordis.patch.yml 中配置自己的「乱记兼容」数据服务，面板会出现「从云端拉取 / 推到云端」；端点契约、合并规则等见仓库内 docs/cloud-sync.md。示例配置：
- id: dsh-luanji
name: '@dsh-external/dsh-luanji'
config:
cloud:
url: https://zjuan.club
token: '<你的长期 token>' # 或 cookie / headers
timeoutMs: 15000
也可使用 node scripts/sync-now.mjs 从命令行触发同步。
安装与启用¶
环境要求：DeepSeek Harness 桌面端或 web profile。插件是 Host + Client 两半的 bundle，Host 需要 webServer 等平台服务。
方式一：命令行（README 推荐）
git clone https://github.com/Thomas-zz/dsh-luanji.git
# macOS 桌面端的 dsh CLI 在 app 内：
DSH="/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
# 安装到你的 profile（link 方式，改代码即生效）
"$DSH" plugin --profile desktop add "$PWD/dsh-luanji"
安装后重启 DSH 桌面端（Host 改动需要重启；client.js 改动保存后热更新）。
方式二：插件管理器
设置 → 插件 → 从本地目录安装 dsh-luanji，并确认 profile 的 dsh.profile.bundles 包含该 bundle。
卸载：设置 → 插件里禁用/移除，或 "$DSH" plugin --profile <profile> remove dsh-luanji。
典型用法¶
- 对话中划选模型回复里的一句话，点浮动条「引用并记录」，在便签里写下自己的想法后保存。
- 无需引用时，用
Ctrl + Shift + L（macOS 为⌘ + Shift + L）打开速记便签，先记下念头，不必先起标题。 - 点侧栏「乱记」行尾按钮进入管理面板，搜索历史记录，或通过导入/导出 JSON（含图片）备份与迁移。
- 若已配置
cloud，在面板中手动拉取或推送，避免默认把数据发到未审核的第三方。
适用场景与注意¶
适合需要在 DSH 内闭环「对话 → 摘录 → 自己的笔记」、且希望默认数据留在本机的开发者或重度对话用户。插件以当前 DSH 进程权限运行，安装前应自行查看 GitHub 源码 与 MIT 许可证；社区目录与 DeepSeek / 幻方无官方从属关系，SkillHub 为独立插件站点。
仓库提供 npm test（32 项：store / routes / cloud）及隔离开发页 node test/dev-server.mjs 8129，便于自验行为。
结尾¶
乱记把「先记住、后整理」落在 DSH 侧栏与划选流程里，本地 JSON 为主、云端可选。进一步了解可访问目录页 SkillHub · dsh-luanji 与仓库 github.com/Thomas-zz/dsh-luanji。
