dsh-plugin-yolo

Readme

<div align="center">

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

# YOLO

**交代一次，持续跟进。**

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

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

[![GitHub Stars](https://img.shields.io/github/stars/hanshanyike/dsh-yolo?style=flat-square&logo=github&label=Stars&color=4176E6)](https://github.com/hanshanyike/dsh-yolo/stargazers)
[![npm Release](https://img.shields.io/npm/v/dsh-plugin-yolo?style=flat-square&logo=npm&label=Release&color=CB3837)](https://www.npmjs.com/package/dsh-plugin-yolo)
[![npm Downloads](https://img.shields.io/npm/dm/dsh-plugin-yolo?style=flat-square&logo=npm&label=Downloads&color=CB3837)](https://www.npmjs.com/package/dsh-plugin-yolo)
[![License](https://img.shields.io/github/license/hanshanyike/dsh-yolo?style=flat-square&label=License&color=4176E6)](LICENSE)

</div>

---

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

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

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

<p align="center"><sub>真实 dsh 宿主中的 YOLO 助手看板 · 演示数据</sub></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](https://nodejs.org/) 22 LTS（至少 22.19）或 Node.js 24，并确保 `pnpm` 命令可用。
如果尚未启用 pnpm，先运行 `corepack enable`。然后执行：

```bash
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](http://127.0.0.1:3080) 打开。进入页面后选择工作区并开始对话；
左侧边栏底部的 **YOLO** 按钮用于打开助手看板。

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

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

如果 3080 端口已被占用，可以追加 `--port 4080`，然后打开
[http://127.0.0.1:4080](http://127.0.0.1:4080)。GitHub 安装、固定版本和常见问题见
[使用指南](docs/usage.md)。

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

```bash
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"><sub>为 deepseek-harness 而做 —— <i>把对话里说过的重要事情，变成持续可跟进的计划。</i></sub></p>