dsh-plugin-yolo

dsh plugin --profile web add dsh-plugin-yolo

<div align="center">

<img src="docs/logo.svg" width="120" alt="YOLO logo"/>

YOLO

交代一次，持续跟进。

为 deepseek-harness 打造的个人智能助理：从对话中整理事项、跟踪变化，并在需要时提醒你。

[English](README.en.md) · [文档中心](docs/README.md)





</div>

---

待办、截止时间和阶段目标经常散落在不同对话里。会话一多，你很难记住哪些事情还没完成、哪些安排已经变化。YOLO 会从对话中识别需要继续跟进的内容，整理成跨会话可查看、可更新、会提醒的计划。

长期方向是成为面向工作与生活的个人智能助理：在用户授权范围内持续理解会话中的事项、决定和约束，并逐步连接用户与受托 Agent。当前版本先专注于跨会话整理、提醒和用户控制。

<p align="center">

<img src="docs/assets/readme/dashboard-home.png" width="100%" alt="YOLO 助手看板首页：显示今日摘要、助手判断、快速记录和待处理事项"/>

</p>

<p align="center">_{真实 dsh 宿主中的 YOLO 助手看板 · 演示数据}</p>

YOLO 负责整理信息和提醒进度；是否执行、如何执行仍由你决定。它会：

• 自动整理：从包含明确后续安排的对话中识别待办、目标、里程碑和提醒规则。
• 跨会话保存：按工作区保存并支持搜索，不必在新会话里重复交代。
• 同步变化：当你说「完成了」「推迟到周五」或「已经进行一半」，对应事项会更新并留下记录。
• 按时提醒：到期提醒进入 YOLO 的通知和专属对话，不会插入正在进行的工作会话；dsh 再次运行后会补上离线期间到期的提醒。
• 集中查看和处理：从侧栏打开助手看板，在首页处理当下关注，在计划中组织全部安排，在历史中按时间或按事项回看变化。
• 明确取消与删除：取消事项会保留变化记录并可重新打开；“按日期删除事项”可按截止日期或创建日期预览并批量取消，也可在强确认后永久删除事项及相关数据。
• 通知完整可追溯：顶部通知数字只表示尚未查看的新投递；提醒和简报进入可分页的通知记录，阅读通知不会误改事项状态。记录可以随时清理：单条用卡片上的 × 删除，堆积多了用「一键清除」在确认后清空。
• 保留来源证据：事项会保存有界的用户原话、关联会话、轮次和助手操作证据，可先预览来源，再按宿主能力打开原会话。
• 抑制重复记录：同一轮抽取、同一次助手调用或同一个看板动作重试不会重复创建事项；已合并的历史副本不会重新进入提醒。
• 版本提醒：插件配置卡会显示是否已发布更新版本，并给出一条可直接执行的更新命令。
• 连接 Agent（规划中）：未来支持带有明确权限、结果和验收标准的 Agent 任务；当前版本不会自动执行外部操作。

YOLO 会理解对话里的计划信息，而不是要求你使用固定关键词。它只保留需要管理的事项和规则，

并过滤「好的」「收到」等寒暄、人物画像与通用知识，减少无关内容进入长期记录。

<p align="center">

<img src="docs/assets/readme/workflow.svg" width="100%" alt="YOLO 工作流：对话、整理、跟进、提醒"/>

</p>

快速开始

YOLO 需要运行在 dsh 0.1.5-rc.1 或更新版本的宿主上；更旧的宿主无法加载本版的

浏览器面板，插件设置页也不会出现这一版的配置卡（用 npx @deepseek-ai/dsh --version 确认，必要时

npm install -g @deepseek-ai/dsh@latest 升级）。

安装 Node.js 22 LTS（至少 22.19）或 Node.js 24，并确保 pnpm 命令可用。

如果尚未启用 pnpm，先运行 corepack enable。然后执行：

npx @deepseek-ai/dsh plugin --profile web add dsh-plugin-yolo@0.5.0
npx @deepseek-ai/dsh web

这会安装 YOLO 并启动 dsh。页面默认在

http://127.0.0.1:3080 打开。进入页面后选择工作区并开始对话；

左侧边栏底部的 YOLO 按钮用于打开助手看板。

如果不希望自动打开浏览器，使用：

npx @deepseek-ai/dsh web --no-open

如果 3080 端口已被占用，可以追加 --port 4080，然后打开

http://127.0.0.1:4080。GitHub 安装、固定版本和常见问题见

[使用指南](docs/usage.md)。

也可以直接从源码安装当前稳定版：

git clone https://github.com/hanshanyike/dsh-yolo.git
cd dsh-yolo
git checkout v0.5.0
corepack enable
pnpm install --frozen-lockfile
pnpm build
npx @deepseek-ai/dsh plugin --profile web add .
npx @deepseek-ai/dsh web

一个典型流程

你可以在任意 dsh 对话中说「明天下午三点提醒我把客户访谈纪要发给产品组」。YOLO 会在本轮完成后整理事项，

之后你既可以在对话里说「改到周五」或「已经完成」，也可以直接在看板中处理。到期提醒只进入 YOLO 的通知

和专属对话，不打断当前工作会话。

<details>

<summary>查看可追溯的历史时间线</summary>

<p align="center">

<img src="docs/assets/readme/dashboard-history.png" width="100%" alt="YOLO 历史时间线：按时间展示事项的新增、完成和字段变化"/>

</p>

</details>

数据与隐私

数据保存在工作区的 .dsh/yolo/ 目录，并按工作区隔离；同一工作区切换 Git 分支仍共享一份计划。YOLO 使用本地数据库保存

计划，同时生成便于查看和备份的 Markdown 快照。理解对话时会调用你在 dsh 中配置的模型，

数据处理方式取决于所使用的模型服务。详细位置和备份建议见

[使用指南](docs/usage.md#六数据与隐私)。

路线图

YOLO 分四个阶段发展：记得 → 组织 → 管理 → 协同。当前已经具备跨会话记录、计划整理、

到期提醒和看板处理能力；后续会继续改进优先级判断、提醒体验和授权下的 agent 协作。完整方向见

[产品愿景](docs/VISION.md)。

文档

• [使用指南](docs/usage.md) —— 安装、设置、功能与常见问题
• [产品愿景](docs/VISION.md) —— YOLO 要解决的问题、边界和长期方向
• [版本记录](CHANGELOG.md) —— 每个版本的主要变化
• [文档中心](docs/README.md) —— 查看完整的用户文档入口

参与贡献

如果 YOLO 解决了你的跨会话跟进问题，欢迎点一个 Star，让更多有相同困扰的人看到它。

也欢迎[参与贡献](CONTRIBUTING.md)：遇到问题或有新想法可以提交 issue；安全问题请通过

[安全政策](SECURITY.md)中的私密渠道报告。

许可证

[MIT](LICENSE) © dsh-yolo contributors

---

<p align="center">_{为 deepseek-harness 而做 —— <i>把对话里说过的重要事情，变成持续可跟进的计划。</i>}</p>