LoosePlan

LoosePlan 使用文档

一、安装与初始化

1. 下载GitHub Release中的Inno Setup安装包，运行后选择安装目录（建议默认），勾选“开机自启”选项。

2. 首次启动需完成初始化流程：

• 确认数据目录（默认%LOCALAPPDATA%\LoosePlan\），支持后续在设置页修改（自动复制旧数据）。
• 配置Kimi API Key（必填），飞书App ID/Secret为可选（仅启用手机端需要）。
• 完成机器人称呼与用户称呼配置，参与15~20题用户画像问答（非直接询问MBTI）。
• 生成用户画像报告并写入本地，未完成初始化将无法使用后续功能。

二、核心功能使用

1. 桌面挂件操作：

• 默认显示在桌面右下角，支持拖拽、贴边吸附，可用全局快捷键快速打开聊天页。
• 点击挂件展开功能环：聊天/日程/记忆图谱/每周回顾/设置/退出/隐藏。
• 聊天页关闭时收到新消息会显示角标提醒，打开聊天页自动清零。

2. 日程管理：

• 日程页左侧显示月历、计划统计、待办/成果，右侧为时间块视图（周/日切换）。
• 支持添加任务/事件/时间块，设置重复规则、依赖关系、优先级、截止时间。
• 点击“一键重排”可自动调整日程，查看延期风险、冲突时间块与替代方案。

3. 记忆图谱：

• 左侧为分类导航（用户画像/日程偏好/行为习惯等），右侧为条目编辑区。
• AI自动提取的记忆条目支持手动编辑，可添加来源、关联场景、修改时间。
• 支持导入/导出记忆数据，所有修改均记录变更日志。

4. 飞书联动：

• 仅支持1v1私聊，首次收到飞书消息时绑定Owner OpenID，仅处理该用户消息。
• 桌面端离线时飞书端不可用，消息与桌面端合并为同一条会话流。

三、数据管理

1. 导出/导入：

• 在设置页点击“一键导出”，选择是否包含Kimi/飞书密钥，生成zip包存储在export目录。
• 导入时选择zip包，自动解压到当前数据目录，重启后生效。

2. 变更日志：

• 所有日程/记忆/订阅/画像变更均写入schedule/changes.jsonl，包含时间戳、操作人、摘要、JSON Patch。
• 日志支持审计与回放，可追溯任意数据修改记录。

四、自动订阅与每周回顾

1. 自动订阅：在设置页配置关键词、检索频率、发送时间，结果自动写入订阅库并去重，支持桌面/飞书推送。

2. 每周回顾：按设置时间自动生成Markdown（详细）+JSON（概括）文件，桌面端可查历史，飞书端仅接收摘要，离线时跳过当次生成。

五、常见问题

Q1: 飞书端无法接收消息？

A1: 检查桌面端是否运行、飞书App ID/Secret配置是否正确、是否已绑定Owner OpenID，未完成初始化也会导致飞书端拒绝服务。

Q2: Kimi调用失败怎么办？

A2: 检查API Key是否有效，网络是否正常，失败时会提示重试，且不会写入日程变更。

Q3: 如何迁移数据到新电脑？

A3: 在旧电脑导出zip包（建议不包含密钥），新电脑安装后完成初始化，再导入zip包即可。