# tips_dc

**Repository Path**: daigao/tips_dc

## Basic Information

- **Project Name**: tips_dc
- **Description**: 桌面端便签
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-28
- **Last Updated**: 2026-06-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 桌面便签

一款基于 Electron 的 Windows 桌面便签软件。

项目目标是提供轻量、快速、易用的桌面便签能力，并重点支持便签窗口置顶，方便用户在多窗口工作时持续查看重要内容。

## 功能特性

- 新建便签
- 编辑便签
- 删除便签
- 自动保存
- 多便签窗口
- 窗口置顶
- 窗口位置和尺寸恢复
- 系统托盘
- 有序列表
- 无序列表
- 加粗
- 斜体
- 下划线
- 删除线

## 环境要求

- Windows 10 或 Windows 11
- Node.js 16 或更高版本
- npm 8 或更高版本

当前项目使用 Electron 39.8.5。

## 安装依赖

在项目根目录执行：

```bash
npm install
```

如果 Electron 下载失败，可以临时使用镜像：

```powershell
$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
npm install
```

## 启动项目

```bash
npm start
```

启动后会打开一个便签窗口。

软件运行时会在 Windows 系统托盘显示图标，可以通过托盘菜单新建、显示、隐藏或退出便签。

## 项目结构

```text
desktop-sticky-notes/
├─ README.md
├─ desktop-sticky-notes-prd.md
├─ DEVELOPMENT.md
├─ PACKAGING.md
├─ package.json
├─ package-lock.json
├─ scripts/
│  └─ start.js
└─ src/
   ├─ main.js
   ├─ preload.js
   └─ renderer/
      ├─ index.html
      ├─ renderer.js
      └─ styles.css
```

## 核心文件

| 文件 | 说明 |
| --- | --- |
| `src/main.js` | Electron 主进程，负责窗口、托盘、置顶和本地存储 |
| `src/preload.js` | 安全暴露 IPC API 给渲染进程 |
| `src/renderer/index.html` | 便签窗口结构 |
| `src/renderer/renderer.js` | 便签编辑、保存、置顶等交互逻辑 |
| `src/renderer/styles.css` | 便签窗口样式 |
| `scripts/start.js` | 开发启动脚本 |

## 常用命令

安装依赖：

```bash
npm install
```

启动开发版：

```bash
npm start
```

检查依赖安全：

```bash
npm audit
```

检查 JavaScript 语法：

```bash
node --check src/main.js
node --check src/preload.js
node --check src/renderer/renderer.js
node --check scripts/start.js
```

## 数据存储

便签数据保存在 Electron 的 `userData` 目录下，文件名为：

```text
notes.json
```

保存内容包括：

- 便签内容
- 标题
- 窗口位置
- 窗口尺寸
- 是否置顶
- 是否显示
- 创建时间
- 更新时间

工具栏中的“清空本地数据”按钮会删除 `notes.json` 中保存的所有便签内容和窗口状态。清空后应用会自动创建一张新的空白便签。

## 文档

- [产品设计文档](./desktop-sticky-notes-prd.md)
- [开发文档](./DEVELOPMENT.md)
- [打包文档](./PACKAGING.md)

## 后续开发方向

- 便签颜色
- 搜索便签
- 回收站
- 图片粘贴
- Markdown 支持
- 快捷键配置
- 开机自启动
- 安装包打包
- 数据导入导出