Skip to content

dsh-temp-note

Verified

dsh-temp-note · v0.1.0 · MIT · Web UI

A temp note in the DeepSeek Harness right sidebar, with session, workspace, and global scopes, one-click copy, and LLM polish.

Install

dsh plugin add dsh-temp-note

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-temp-note

DeepSeek Harness 右侧边栏里的一张临时笔记。 那个刚要忘掉的念头、一段要复用的片段、一个刚做的决定,随手记下来,不用离开当前会话——可以只属于这个会话、这个工作区,或者所有地方。

English · 安装 · 使用 · 一键优化怎么工作

npm DSH 0.2.x license: MIT dependencies: none


痛点

DeepSeek Harness 很适合和 Agent 一起想事情,但没有地方在旁边想自己的事。

  • 输入框是麦克风,不是便签纸。 在里面打一句只给自己看的提醒,会发给模型、写进会话日志。有些笔记是给自己的,不是给这一轮的。
  • 工作区文件是项目的,不是你的。 往仓库里丢一个 scratch.md,会带来 diff 噪音、评审评论,以及一个活过头的文件。.gitignore 是绕路,不是工作流。
  • 切到另一个笔记应用,上下文就断了。 跳去 Notion、Obsidian 或者便签小组件,回来时对话、文件和刚才那条线索都不在原地了。
  • 一个桶永远不够用。 「这个会话里记一下」「这个项目一直这么做」「这段代码我到处都要粘」是三种不同的生命周期。只有一层的草稿本,最后会变成垃圾场。

功能

dsh-temp-note 在右侧边栏——和 Files、Chat、Terminal 同一个 dock——加一个 临时笔记 标签页,并在会话头部加一个笔记按钮。

一篇笔记,三种范围 会话级 / 工作区级 / 全局。默认工作区级,切换范围即切换笔记。
没有笔记管理 没有「新建」按钮,没有目录树,不用起标题。每个范围只有一篇,自动存在、一直在。
自动保存 每次输入即写入本地存储。刷新、切标签页、切会话,内容都还在。
一键复制 整篇笔记写入剪贴板,可以直接粘进提示词、issue 或 PR 描述。
一键优化 用 Harness 的默认模型把笔记整理成更清晰的 Markdown 并覆盖,一眼不满意可以「撤销优化」。
默认本地 笔记不进入会话日志,也不会发给 Agent。只有你主动点「一键优化」时,内容才会发给已配置的模型。

三种范围

范围 按什么归档 适合放什么
会话 当前会话 id 「只在这个对话里」:私人的提醒、一个假设、这轮结束前要验证的事
工作区 当前工作区目录 项目约定、已做的决定、可复用命令——同一工作区的所有会话共享
全局 所有工作区共一篇 到处都要粘的个人片段

范围选择按会话记住:新会话默认 工作区级,之后回到上次的选择。这里刻意没有「新建笔记」:每个范围永远只有一篇。

安装

需要带 Web GUI 的 DeepSeek Harness 0.2.x(已在 0.2.1-rc.2 上验证)。

桌面端

设置 → 插件 → 添加插件,粘贴:

dsh-temp-note

桌面端独占 desktop profile,请用它的界面安装,不要用 CLI。

dsh web / CLI

dsh plugin --profile web add dsh-temp-note

把 web 换成你实际使用的 profile。也可以直接从源码安装:

dsh plugin --profile web add github:GuihaiHU/dsh-temp-note
# 或本地 checkout
git clone https://github.com/GuihaiHU/dsh-temp-note.git
dsh plugin --profile web add /absolute/path/to/dsh-temp-note

已发布到 npm:dsh-temp-note。

安装后刷新 Web 页面。插件没有构建步骤,也没有运行时依赖。

使用

  1. 打开。 点会话头部的笔记图标,或点右侧边栏的 +,在向导里选「临时笔记」。它和普通侧边栏标签页一样,可以停靠、拆分、拖成浮动面板或全屏。
  2. 选范围。 会话 · 工作区 · 全局。默认工作区级,切换器下方的说明会告诉你当前范围覆盖什么。
  3. 写。 每次输入自动保存,底部显示字数与最近保存时间。
  4. 复制。 一键把整篇笔记放进剪贴板。
  5. 优化。 一键用默认模型重写为更清晰的 Markdown;上一版留在「撤销优化」里。

一键优化怎么工作

插件的 Host 半只注册一个路由:

POST /api/dsh-temp-note/optimize
{ "text": "<笔记>" }  ->  { "ok": true, "text": "<整理后的笔记>" }
  • 它用设置 → 模型里选定的默认模型调用 ctx.llm.stream(),并使用一段固定指令:保留全部事实、保持原语言、用 Markdown 组织、只输出笔记正文。
  • 只接受本机、同源的请求;路由不保存任何内容,也不记录笔记文本。笔记本身存在浏览器里,不在 Host 上。
  • 没有配置默认模型时,按钮会直接说明,而不是猜一个。
  • 这个路由要求页面通过 HTTP 提供(dsh web 或桌面端的 Web GUI)。如果渲染层是 file://,优化按钮会提示接口不可达;笔记、范围、自动保存和复制不受影响。

数据与隐私

内容 位置
笔记正文 浏览器 localStorage:dsh.temp-note.v1.global、…workspace.<编码后的路径>、…session.<会话 id>
范围选择 dsh.temp-note.v1.scope.<会话 id>
笔记写入会话日志 从不
笔记被发送 仅在你主动点「一键优化」时,发给已配置的模型提供方

清除浏览器站点数据会清掉笔记。笔记按浏览器隔离,不跨设备同步。

兼容性

  • 在 DSH 0.2.1-rc.2(macOS)上构建并验证。
  • 使用右侧边栏类型注册表(sidebarRightTabs、sidebarRight)和 conversation.session.header.utilities 插槽,需要带右侧边栏的 0.2.x 构建。
  • Host 半依赖 llm 和 webServer 服务,二者都在 Web profile 中。
  • 无运行时依赖、无安装脚本、无构建步骤;浏览器半是单个手写的 client.js,通过 __ModuleLoader__.load 加载。

开发

git clone https://github.com/GuihaiHU/dsh-temp-note.git
cd dsh-temp-note

# 语法检查
node --check index.js
node --check client.js
node -e "JSON.parse(require('fs').readFileSync('package.json','utf8'))"

# 把当前 checkout 装进 profile
dsh plugin --profile web add "$PWD"

仓库结构:

index.js            Host 半:仅本机可用的 /api/dsh-temp-note/optimize
client.js           浏览器半:侧边栏标签页、头部按钮、范围、存储
cordis.patch.yml    profile 中插入的 Host 插件行
locale/en.json      插件管理器显示元数据
locale/zh.json
icon.svg

限制

  • 只存浏览器本地,不跨设备同步。
  • 每个范围只有一篇笔记,这是设计选择。
  • 编辑器是纯文本 textarea,整理后的 Markdown 不在标签页内预览。
  • 一键优化依赖已配置的默认模型和可访问的 HTTP Host。

License

MIT