dsh-lite-memory

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-01），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

# dsh-lite-memory — DSH 简化版记忆插件

参考 [dsh-auto-memory](https://github.com/Aik358/dsh-auto-memory) 裁剪的轻量记忆插件：

- **条目化记忆**（SQLite `~/.dsh/memory/memory.db`）：每条记忆含标题 / 内容 / 重要程度（高·中·低）/ 来源（工作区-会话）/ 创建更新时间，按条目增删改查
- **记忆工具**：`memory_recall`（关键词检索条目）/ `memory_entry`（条目增删改查）
- **日历与提醒**：`calendar_add` / `calendar_list` / `calendar_done` / `calendar_remove`；到点后通过 `agent.followup` 把提醒投递到注册会话（会话被移除则新建会话投递）
- **定时任务**：cron 表达式（5 字段「分 时 日 月 周」）驱动的**进程内调度**——到点由 DSH 拉起会话执行提示词，执行记录落库
  - 工具：`cron_add` / `cron_list` / `cron_run`（立即运行）/ `cron_toggle` / `cron_remove`
  - 面板：任务列表（状态点 · 表达式 · 人话描述 · 下次运行 · 启停）+ 详情表单 + **表达式实时预览未来 5 次** + 执行记录，支持手动新增 / 编辑 / 删除 / 立即运行
  - 表单尽量少填：**工作区**与**模型**都是下拉选择（工作区来自 `workspaceRegistry` 的真实目录，模型来自 `llm` 的 provider/模型目录；选中某个模型后再按它真正支持的推理强度给下拉），任务名可留空自动取提示词前 20 字；表达式原文、超时、preset、触发落点收进「高级设置」
  - 触发落点可选「新建会话」（缺省，跑完即卸载、会话日志保留）或「投递到指定会话」（活着直接投递，否则在原会话上续跑）
  - **任务级模型路由**：`provider` / `model` / `reasoningEffort` + `preset` + `cwd`。路由**只对「新建会话」生效**，投递型沿用目标会话自身的模型；留空则用部署默认模型（`agentDefaultModel`），不会出现「没模型就跑」的情况
  - 同一分钟内最多触发一次；同任务不重入、全局并发上限 2、单次超时缺省 600 秒（超时取消并记为 `timeout`）
- **对话面板「记忆」tab**：条目化记忆面板（卡片列表 + 新增/编辑/删除，重要程度色标、来源角标）
- **设置页「记忆」分区**：二级菜单（记忆 / 日历 / 定时）——日历为月视图 + 当天 07:00-22:00 时间轴 + 浮层编辑，面板下方「待执行」「已完成」双 tab 纵向列表
- **中英双语**：跟随 DSH 设置的语言，无手动外观设置、默认字号

## 界面预览

设置 → 记忆 → 定时。工作区与模型都是下拉；推理强度在选中具体模型后才出现；表达式原文、超时、preset、触发落点收进「高级设置」。

![定时任务配置](docs/cron-form.png)

## 兼容性 / 支持的 DSH 版本

- **实测版本**：DSH `0.1.5-rc.1`（`@deepseek-ai/dsh-tools` / `dsh-base` 均为 `0.1.5-rc.2`），Node `24.12`
- **声明范围**：`engines.dsh: >=0.1.5-rc.1` —— 插件市场按 package.json 的 `engines.dsh`（或 `dsh.engines.dsh`）判定宿主兼容性；未声明的插件在市场里显示为「未声明」
- **Node**：`>=22.5.0`（用到 `node:sqlite`；22.5–23.3 需 `--experimental-sqlite`，24 起默认可用）
- **用到的宿主能力**（据此可自行判断其他 DSH 版本是否可用）：
  - `agents.create` / `resume` / `get` / `followup`、`agent.whenIdle`、`agent.cancel`
  - 事件 `agent/status`、`agent/error`、`session/event`（`turn/end`、`assistant/message`）
  - `timer.interval`、`webServer.register`、`systemPrompt.context`、`tools.register` + `@deepseek-ai/dsh-tools` 的 `defineTool`
  - 面板下拉数据源：`workspaceRegistry.list`、`llm.listProviders` / `listModels` / `resolveModelInfo`、`agentDefaultModel.currentSelection`
  - 上述可选服务缺失时都能降级（下拉退回手填），但缺 `agentDefaultModel` 会让新建会话的 prompt 装配失败

## 定时任务的触发边界

调度器跑在 `dsh web` 进程内，**没有守护进程，不读写系统 crontab**：

- 只在 `dsh web` 运行期间触发；进程关闭时错过的时刻**不会补跑**（错过即丢）
- 每次触发会新建一个会话（`cwd` 缺省为 dsh web 进程的工作目录），跑完即从内存卸载，会话日志保留可回看
- 每次触发是一轮真实的 agent 会话，会消耗 token；请给任务设置合理的超时
- 成本与权限控制：用**任务级模型路由**（provider / model / effort）选便宜的模型，用 **preset** 限定工具集与人格
- 无人值守执行：请在任务里指定 preset 并确认其审批策略与工具限制，否则任务可能卡在审批上

## 安装

```bash
cd ~/.dsh/profiles/web
pnpm add dsh-lite-memory
# 或 npm install dsh-lite-memory
```

然后在 `package.json` 的 `dsh.profile.bundles` 数组追加 `"dsh-lite-memory"`，重启 dsh web 生效。

## 存储

| 数据 | 位置 |
|---|---|
| 记忆条目 | `~/.dsh/memory/memory.db`（表 `entries`） |
| 日历事项 | `~/.dsh/memory/memory.db`（表 `calendar`） |
| 定时任务 | `~/.dsh/memory/memory.db`（表 `cron_jobs`） |
| 定时任务执行记录 | `~/.dsh/memory/memory.db`（表 `cron_runs`，滚动保留最近 500 条） |

旧版 `MEMORY.md` / `calendar.json` 数据不再读写。

## License

BSD-3-Clause