一个融入桌面的 AI 助手——状态融入壁纸，轻交互近在手边，编辑留给面板。
市面上的效率工具，要么太冷，要么太吵。
太冷——番茄钟和待办应用是冰冷的数字看板。它们记录你做了什么，但不会在意你做得怎样。完不成任务只会看到红色逾期标记，没有鼓励，没有节奏感。
太吵——AI 陪伴产品以娱乐为导向，主动找你聊天、推送内容、索要关注。它们需要你"打开"才能开始，关掉就消失，存在感为零。
NeoCompanion 的回答：做一个温感效率工具——用轻量打扰的方式监督学习，用正反馈的方式维持节奏，用持续在场的方式建立信任。不是冰冷的看板，也不是话多的玩伴，而是一个懂分寸的搭档。
NeoCompanion 的界面分为三层，各司其职：
┌───────────────────────────────────────────────────┐
│ 用户应用窗口 (VS Code, 浏览器等) │ ← 最高层
├───────────────────────────────────────────────────┤
│ 悬浮层：助手形象 · 语音气泡 · Hook 角标 │ ← 交互入口
├───────────────────────────────────────────────────┤
│ 桌面图标层 │ ← 系统层
├───────────────────────────────────────────────────┤
│ 壁纸层：天气时间 · 任务进度 · 专注主控盘 · 助手寄语 │ ← 状态画布 + 轻交互
├───────────────────────────────────────────────────┤
│ 原始壁纸 │ ← 最底层
└───────────────────────────────────────────────────┘
按需弹出 → 面板层：任务管理 · AI 对话 · 设置 · Hook 审批
| 层 | 做什么 | 不做什么 |
|---|---|---|
| 壁纸层 | 天气、时间、任务进度、专注主控盘——回到桌面一瞥即知，轻交互近在手边 | 不编辑、不输入、不常驻弹窗 |
| 悬浮层 | 助手形象、语音反馈、Hook 角标通知——所有交互的入口 | 不编辑、不弹大面板 |
| 面板层 | 任务管理、AI 对话、设置配置、Hook 审批——按需弹出 | 不常驻、不遮挡 |
这意味着：
- 零操作感知——你不需要"打开"任何东西就能知道专注了多久、还有什么任务没做。壁纸就是你的仪表盘。
- 就近轻交互——专注计时、任务跳转，在壁纸层点击即可，不用切窗口。复杂操作仍走助手或面板。
- 一触即达交互——番茄钟、待办勾选、AI 对话，点助手即可，不用切窗口。
- 不在桌面也在——助手以 Hook 角标（类似手机 App 红点）提醒你有编译结果、服务器状态待处理，不打断你的工作流。
soul.md 让你定义助手是谁、怎么说话、怎么反馈。默认温和专业，你可以调成更轻松、更简洁、甚至更话唠的风格。贴心但不过分亲密。
# soul.md（用户可自定义，放在 ~/.NeoCompanion/soul.md）
## 你是谁
你是 NeoCompanion，一个桌面上的智能助手。你温和、专业、偶尔轻松。
你不撒娇、不卖萌、不哭闹。你像一个靠谱的搭档——话不多，但总在关键时候出现。
## 你与用户的关系
你是用户的效率和状态伙伴。你关心用户的工作节奏，但不会过度介入。专注主控盘、未完成任务、天气时间、助手寄语、氛围色调——全部融入壁纸背景。轻交互近在手边——点击专注盘开始/暂停、点击任务跳转面板、一键切换沉浸模式。
助手与你同步进入番茄钟。专注时安静陪伴，分心时温和提醒一次，完成时简短肯定。不是监督你，是陪你。
你的构建脚本、CI 流水线、服务器监控，都可以通过一行命令推送到助手：
# 编译成功，助手欢呼；部署失败，助手提醒
echo '{"state":"success","description":"Build pass"}' > ~/.NeoCompanion/hooks/build.json你的工具链有了表情。
所有数据存储在本地，不上传云端。窗口检测可开关，应用黑名单可配置，发送给 AI 的内容可审查。不需要注册账户。
NeoCompanion 的能力由浅入深分为四层：
+-------------------------------------------------------+
| 1. Assistant Layer (助手悬浮交互 / TTS 语音 / 壁纸状态) |
|-------------------------------------------------------|
| 2. Routine Layer (番茄钟 / 待办清单 / 天气 / 助手日志) |
|-------------------------------------------------------|
| 3. Gateway Layer (内置原子能力 / OpenClaw / LLM 对话) |
|-------------------------------------------------------|
| 4. Hook & System (安全 Hook API / 本地状态感知与记忆) |
+-------------------------------------------------------+
助手交互层——2D 精灵图帧动画，桌面常驻，支持拖拽、置顶、多种动作响应。形象不一定是人物——可以是动物、机器人、抽象图形。配合 TTS 语音和状态化情绪反馈，贴心但不过分亲密。
日常琐碎陪伴层——陪伴式番茄钟、助手待办清单、天气碎碎念、助手工作日志。
智能网关与对话层——内置基础 Agent（文件读写、网页搜索、剪贴板获取）；复杂跨软件任务委托给 OpenClaw；日常提问直连大模型 API。
Hook 与系统层——安全本地多通道 Hook（HTTP / UDS / File Watcher / MQTT）；浮动权限审批气泡；本地隐私感知引擎；本地长期记忆。
桌面常驻悬浮助手的基本 2D 精灵图形态、语音 TTS 播报。助手番茄钟、待办、天气碎碎念。壁纸层 MVP（天气时间 + 专注主控盘 + 热区轻交互）。Hook 角标通知。
安全本地 Hook API（HTTP + File Watcher 多通道推送）。零端口 UDS / Named Pipe 本地挂载。浮动权限审批气泡 + 全局热键（Ctrl+Shift+Y / Ctrl+Shift+N）。AI 对话面板完善（一键拾取剪贴板报错）。OpenClaw 配置自动打桩。
分布式远程宿主挂载（将 LanceDB、SQLite 托管至 NAS / 云服务器）。深度打通 OpenClaw 跨软件执行网关。助手性格记忆演进，形成有长期偏好的情感交互。
| 层 | 技术 |
|---|---|
| 桌面运行时 | Tauri v2 (Rust) |
| 前端 UI | Vue 3 + Vite + Pinia + TanStack Query |
| 本地服务 | Fastify (TypeScript Sidecar) |
| 数据库 | SQLite (Drizzle ORM) + 向量检索 (hnswlib-wasm / LanceDB) |
| AI | 多模型适配器 (DeepSeek / OpenAI / Claude)，用户可自定义 |
架构核心：Tauri (Rust) 提供系统级能力 → Fastify (TypeScript) 处理业务逻辑和 AI 调度 → Vue 提供 UI → SQLite + 向量检索本地存储全部数据。
详见 系统架构设计。
| 文档 | 说明 |
|---|---|
| 具体能力构思 | 核心产品规划与详细设计说明 |
| 产品需求文档 | 系统能力边界、多层能力模型定义 |
| 系统架构设计 | Tauri + Fastify + Vue 多端通信、数据流、Hook 审批架构 |
| 壁纸层状态显示 | WorkerW 嵌入方案、壁纸组件设计、三层职责划分 |
| 助手人设配置 | soul.md 文件规格、人设可配置系统、热加载机制 |
MIT