前言¶
在 DeepSeek Harness（DSH）里和模型长聊，结论往往散在对话历史里：待办、分工、表格草稿很难单独整理成可编辑、可搜索的文档。外接云笔记又和对话脱节，还要担心数据出本机。社区插件 随记 Jot（dsh-jot）把笔记面板嵌在对话右侧，支持清单、表格、附件与导入导出；可选开启 AI 协作，让模型在你说清楚需求后再读、写笔记，改过的位置可标记并撤回。下面介绍它是什么、能做什么，以及如何安装与典型用法。
这是什么¶
随记 Jot 是维护者 Totoro-qaq 发布的 DSH 插件，npm 包名 dsh-jot，当前版本 0.2.14（MIT 许可证）。SkillHub 分类为「记忆」；GitHub 仓库 totoro-qaq/dsh-jot 简介为：Human-editable notes, todos and documents for DeepSeek Harness, with search, tables, attachments, export and optional agent collaboration.
定位可以概括为：对话旁边的笔记本——边聊边记，也能在开启协作后让 AI 把讨论结果写入指定笔记；数据默认保存在本机 DSH 数据目录，不上传云端。
核心功能¶
以下能力均来自项目 README 与 package.json 描述，可按需选用。
边聊边记与完整编辑¶
- 随记开在对话右侧；输入
/jot可打开、新建或定位一篇笔记。长文可从左侧导航进入完整页面。 - 支持标题、清单、表格、链接、图片和附件；空行输入
/插入内容，按?查看快捷键（README 说明不必会 Markdown 也能写）。
搜索、整理与进度¶
- 标题与正文均可搜索；常用笔记可置顶，按文件夹归类；清单在列表中显示完成进度。
AI 协作（默认关闭）¶
- 在笔记列表底部打开「AI 协作」后，可在对话中用自然语言让 AI 查找、新建或修改笔记。
- AI 只改需要改的部分；对已有笔记的修改会标「AI 修改」，可撤回该轮修改。
- 协作关闭时，随记不会出现在对话可用工具中；开启后，AI 也只在用户提出需求时才读笔记。
导入导出与本机存储¶
- 可导入 Obsidian 等 Markdown 笔记库（列表「排序与选项」→「导入笔记」，选中整个文件夹，图片与附件一并导入）。
- 整个笔记库可导出为 Word、PDF 或 Markdown；导出压缩包可原样导回。
- 默认路径：
~/.dsh/jot；若设置了DSH_HOME，则为$DSH_HOME/jot。桌面版与 Web 版指向同一目录时笔记共用。卸载插件不会删除笔记。
兼容性说明（节选）¶
- 0.2.14：修复旧 profile 中 PDF 依赖损坏导致插件无法启动的问题；PDF/Word 导出异常时提前提示并仅停用对应格式。
- 0.2.13：支持官方 DSH 0.2.1-alpha.3 Web；此前已验收 macOS 桌面 0.2.0-rc.2 等版本。完整验收范围见仓库
docs/VALIDATION.md。
插件声明的 DSH 引擎范围：^0.2.0-rc.2 || ^0.2.1-alpha.1；Node.js：^22.19.0 || >=24.0.0。
安装与启用¶
DSH 生态采用「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。安装前建议查看 GitHub 源码 与 MIT 许可证；插件以当前 dsh 进程权限运行，请自行评估信任边界。
npm / CLI¶
尚未安装 dsh 命令时，可在官方桌面应用菜单「管理 dsh 命令…」中安装（需 Node.js 满足上述版本要求）。
桌面客户端与 Web 需分别安装；装好后重启 DSH，左侧导航会出现「随记」。
# 桌面客户端
dsh plugin --profile desktop add dsh-jot
# DSH Web
dsh plugin --profile web add dsh-jot
README 注明：DSH 0.2.1-alpha.3 Web 升级时需先移除随记再重新安装，笔记与附件保留；CLI 操作前先停止对应 Host。升级、卸载与备份细节见仓库 使用指南（中文）。
Discover（DSH 0.2.1-alpha.4 起）¶
- 打开 插件 → 实验性插件 → 更多，启用 自定义插件市场。
- 发现（Discover）→ 添加索引源，粘贴：
https://raw.githubusercontent.com/Totoro-qaq/dsh-plugin-index/main/index.json
- 选择 随记 Jot，核对包名
dsh-jot、版本及 npm 来源https://registry.npmjs.org/，确认后 立即启用。
该索引为作者维护的第三方源，不代表 DSH 官方认证；看不到 Discover 时仍可用上面的 npm 方式安装。
典型用法¶
对话内快速打开笔记¶
在会话中输入 /jot，打开或切换到目标笔记，在右侧面板继续编辑。
与 AI 协作写待办（协作已开启）¶
README 示例话术：
把刚才定的三件事记到随记「周会」，写上负责人。
把「周会」里的第一条待办勾掉。
从 Obsidian 迁入¶
在随记列表使用「排序与选项」→「导入笔记」，选择 Obsidian 笔记库根目录即可。
导出备份¶
通过导出 Word、PDF 或 Markdown（及可回导的压缩包）做离线备份；PDF/Word 依赖异常时插件会隔离对应格式，Markdown 等仍可用（见 0.2.14 说明）。
适用场景与注意¶
适合谁： 希望在 DSH 内完成「讨论 → 结构化记录 → 待办跟踪」、且偏好本地优先存储的开发者与用户；需要表格、附件、全文搜索与可选 Agent 改笔记的场景。
注意：
- 桌面与 Web 各装一次；两端共用目录需配置指向同一
jot路径。 - AI 协作默认关，避免模型无意读取笔记；开启后仍建议用明确指令限定范围。
- 社区插件星标与验收范围以 README 为准（当前 GitHub 1 star）；未在资料中声明的组合环境（如任意插件混装、热替换等）勿视为已认证。
结尾¶
随记 Jot 把可编辑笔记、待办与文档能力放进 DSH 对话流，并保留本机存储与导入导出链路；需要 AI 写笔记时再打开协作即可。更多细节见 SkillHub 目录页、GitHub 仓库 与 npm 包 dsh-jot。
