前言¶

在 DSH（DeepSeek Harness）里给 agent 接上大量工具以后，常见局面是：能力够了，但它仍等你下一句，窗口一关就像一段静止的代码。另一类做法会通过破甲等插件放开沙箱和审批，解决的是「能不能做」。鱼跃（dsh-yuyue）走另一条线：不预填人格和任务种类，只提供可写的账本原语和按时唤醒，让 agent 自己排活、记账，并在到点时由时钟触发一轮，而不是由模型情绪决定何时「想起来干活」。

下面按定位、能力、安装、账本结构、配置与边界说明该插件。事实以仓库 README 与 package.json 为准。

这是什么¶

鱼跃 是维护者 Ding200602 发布的 DSH 插件，社区目录分类为工作流，当前版本 0.1.0，许可证 MIT。

一句话定位：装上后 agent 拥有自己的账本目录（身份、日记、自派任务、下次醒来时间），并支持按间隔到点自动递一句唤醒提示；写什么、做什么是 agent 读账本后的自决，插件不塞任务模板、不写说话风格。

• 目录页：https://www.skillhub.cn/plugins/Ding200602/dsh-yuyue
• 源码：https://github.com/Ding200602/dsh-yuyue

核心功能¶

四个账本工具¶

插件向 agent 注册四个工具，均为空壳原语，README 中无预填内容：

到点自动唤醒¶

除上述工具外，宿主侧会按配置间隔向 agent 递固定文案的 followup（默认每 90 分钟一次，可配置）。文案只说明账本路径与文件含义，不包含具体任务；本轮做不做、写不写由 agent 决定。

默认提示大意：到点了；账本在 ~/.dsh/yuyue；soul.md 写身份，journal/ 是日记，tasks.json 是自派任务。

安装与启用¶

在 DSH 环境中任选其一（出自 README）：

# 在你的 DSH 里
dsh plugin install dsh-yuyue

或从仓库 URL 安装：

dsh plugin install https://github.com/Ding200602/dsh-yuyue

装完后重启 DSH。首次醒来时账本目录为空，这是设计行为。

运行要求（package.json）：Node >= 18，对等依赖 @deepseek-ai/cordis ^4.0.1。README 记载曾在 dsh-plugin-desktop 2.0.17 / cordis 4.0.4 上实测通过。

账本目录结构¶

默认根目录为 ~/.dsh/yuyue（可通过配置 home 覆盖）。典型布局：

~/.dsh/yuyue/
├── soul.md          ← 装上时仅「# 我是谁」一行
├── tasks.json       ← {"tasks": []}
├── wake.json        ← 下次醒来时间与当日唤醒次数等
└── journal/
    └── 2026-11-11.md

均为普通文件，用户可直接查看或修改。删除后下次醒来会再生成空结构，内容由 agent 自行填写。

配置¶

在 profile 的 patch 或插件 config 中（README 示例）：

- id: dsh-yuyue
  config:
    wake: true        # 总开关
    everyMin: 90      # 隔多久醒一次
    maxPerDay: 8      # 一天最多醒几次（防刷屏）
    tickSec: 30       # 检查间隔
    home: ""          # 账本目录，空 = ~/.dsh/yuyue

everyMin 与 maxPerDay 是上限而非 KPI：到点若 agent 想不出要做的事，可以不做事，README 明确这是正常情况。

工程行为与边界¶

README 归纳的四条实现取向（非道德宣言）：

1. 断电不丢：写入采用临时文件再改名，进程被杀不残留半文件。
2. 可续跑：状态在 wake.json，重启后接续计算。
3. 可回滚：日记按日分文件；soul.md 覆盖前用户可自行留底。
4. 可观测：wake.json 记录唤醒次数、发送条数、上次时间，便于排查。

插件不负责：权限与审批（README 建议搭配破甲等插件）、人格话术（soul.md 初始空白）、任务类型分支、限制其他工具（仅注册自身四工具，不 restrict 他人）。

与 破甲（dsh-purge 一类） 的分工：破甲偏「能不能」；鱼跃偏「想不想」——账本、时钟、自派任务入口。两者可组合使用，README 表述为手松开且 agent 知道往哪游。

典型用法思路¶

文档未给出单独的业务场景剧本，可复现路径如下：

1. 安装并重启，确认 ~/.dsh/yuyue 已生成空账本。
2. 在对话中让 agent 用 yuyue_soul 写入身份，用 yuyue_tasks 添加待办，用 yuyue_journal 记录当日进展。
3. 用 yuyue_wake 设置 afterMin 或 at，或依赖默认 everyMin 等待到点 followup。
4. 到点后 agent 先读 journal/ 与 tasks.json，再决定本轮行动。

唤醒文案与工具语义以仓库 README 为准，勿编造额外 API。

适用场景与注意¶

适合：希望在 DSH 里试验 agent 自主排程与持久化「自我叙事 / 任务队列」，又不希望插件替 agent 写好人格或任务清单的开发者。

注意：

• 插件以当前 DSH 进程权限运行，账本落在本机明文路径；安装前应阅读源码与 MIT 许可证，并评估本机数据暴露面。
• 不做沙箱与白名单；若需免审批、改 system prompt 等，需另选插件（README 以破甲为例）。
• 社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无 README 所称的官方从属关系；星标等以 GitHub 实时为准（线索中为 0）。

结尾¶

鱼跃把 DSH agent 从「仅响应输入」推到「有账本、有时钟、可自派活」：能力仍来自宿主与其它插件，它补的是可写状态与到点唤醒。若要试用，可从目录页了解归类，并按上文命令安装后观察 ~/.dsh/yuyue 与四个工具的落盘行为。

• 目录：https://www.skillhub.cn/plugins/Ding200602/dsh-yuyue
• GitHub：https://github.com/Ding200602/dsh-yuyue