# PersonAgent

**Repository Path**: ichang1636/person-agent

## Basic Information

- **Project Name**: PersonAgent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-15
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个人任务 Agent（Person Agent）

解决「事情多而杂、多线程工作、经常忘记正在做的事和几天前的进度」的问题。

核心思路：**每个任务一份 Markdown 记忆文件 + 一个当前任务指针**。
开始任务自动「存档」上一个任务，恢复任务自动「读档」，每天早晨一份报告帮你想起所有线索。

## 桌面应用（主要入口）

```
┌─ 桌面应用（Electron）───────────────────┐
│  ● 系统托盘常驻，开机自启                │
│  ● 任务面板：开始/暂停/恢复/完成/记进度   │
│  ● 待办勾选、思路备忘直接编辑             │
│  ● Ctrl+Shift+Space 全局呼出快速记录小窗 │
│  ● 每天 09:00 自动弹出每日报告           │
└──────────────┬─────────────────────────┘
               │ 复用同一数据层
┌──────────────▼─────────────────────────┐
│  ~/.person-agent/                      │
│    tasks/<id>.md   每个任务一份记忆      │
│    state.json      当前任务指针          │
│    inbox.md        收件箱（快速记录）     │
│    reports/        历史每日报告存档       │
│    config.json     提醒时间/自启/主题     │
└─────────────────────────────────────────┘
```

### 六个视图

| 视图 | 内容 |
|---|---|
| 任务 | 列表 + 详情；置顶、归档折叠、双击改名、点击编辑标签、↑↓ 键导航、AI 总结/拆解 |
| 收件箱 | 快速记录；一键转为任务；处理清除 |
| 时间线 | 跨任务按时间轴看所有进度；近 7 天活动条图；按任务筛选 |
| 回顾 | 周统计（记录/完成/停滞/投入）、12 周热力图、本周完成、停滞告警、历史报告回看、AI 周总结 |
| 每日报告 | 昨日进度 + 昨日完成 + 未完成任务 + 待办 + 收件箱；查看即存档；AI 简报 |
| 设置 | 提醒时间、开机自启、深浅主题、AI 服务、打开数据目录、备份、导出汇总 |

### AI 能力（可选）

在「设置 → AI 服务」填入 API Key 即可启用（任选一家，模型名可自定义）：

- **DeepSeek**：`https://api.deepseek.com`，默认模型 `deepseek-chat`
- **Kimi（月之暗面）**：`https://api.moonshot.cn`，默认模型 `kimi-k2-turbo-preview`
- **GLM（智谱）**：`https://open.bigmodel.cn`，默认模型 `glm-4-plus`
- **自定义**：任意 OpenAI 兼容端点，填 API 地址 + 模型名

功能：🤖 AI 总结（任务进度+下一步，可写入思路）、AI 拆解（生成待办，一键填入）、AI 简报（每日报告的自然语言简报）、AI 周总结。数据通过主进程直连官方 API，不经过任何第三方服务器；Key 保存在本地 `config.json`。

命令行同样可用：`node dist/cli.js ai summarize <任务>`。

### 使用

双击 `release\PersonAgent.exe` 即可。首次启动建议：

1. 托盘菜单（任务栏右下角图标）勾选「开机自启」（默认已开）
2. 随时按 `Ctrl+Shift+Space` 呼出快速记录小窗，记一句就走，不打断工作
3. `Ctrl+Shift+A` 随时呼出/收起主面板
4. 关闭窗口 = 收进托盘继续运行；托盘菜单「退出」才真正退出
5. 新任务支持 `#标签` 语法，例如「写周报 #工作 #周五前」

每日提醒时间、主题等在「设置」视图里改（也保存在 `~/.person-agent/config.json`）。

### 重新打包

```bash
npm run dist    # 输出 release\PersonAgent.exe
```

## Claude Code 技能（可选，与桌面应用共享同一份数据）

```bash
npm run setup   # 编译 + 安装技能到 ~/.claude/skills
```

在任意目录的 Claude Code 中可用：

| 命令 | 作用 |
|---|---|
| `/pa-start 任务名` | 开始新任务，自动暂停并保存当前任务 |
| `/pa-pause [进度说明]` | 暂停当前任务，记下进度/思路 |
| `/pa-resume 任务名` | 恢复任务，加载完整上下文 |
| `/pa-done [任务名] [总结]` | 标记完成 |
| `/pa-tasks` | 任务列表 |
| `/pa-capture 内容` | 快速记录到收件箱 |
| `/pa-review [任务名]` | 回顾进度 |
| `/pa-daily` | 每日报告 |

也可以直接说人话：「修复登录bug 做到哪了？」「记一下：周五前给甲方回邮件」。

## 命令行

```bash
node dist/cli.js <命令>    # start / pause / resume / done / capture / log / show / list / daily / review / timeline / weekly / rename / pin / inbox / delete
```

## 数据

所有数据在 `~/.person-agent/`（即 `C:\Users\<你>\.person-agent\`）：

- `tasks/<id>.md` — 每个任务一份，Markdown 可直接手动编辑。`## 进度日志` 由程序追加；`## 待办` 和 `## 思路 / 备忘` 可在应用里编辑。
- `inbox.md` — 快速记录，每日报告会提醒处理。

备份 = 复制整个 `~/.person-agent/` 文件夹。

## 常见问题

- **移动了本项目目录？** 重新运行 `npm run setup`，技能和 CLAUDE.md 中的路径会更新（桌面应用 exe 不受影响）。
- **改提醒时间？** 编辑 `~/.person-agent/config.json` 的 `reminderTime`，或直接在应用里改。
- **不想开机自启？** 托盘菜单取消勾选「开机自启」。