桑丘 · 目标拆解插件 产品需求规格说明书（Spec 最终版）
文档版本：V1.0
生效日期：2026.05.03
适配范围：Obsidian 桌面端 v1.4.0 及以上版本（Windows/macOS/Linux）
一、文档概述
1.1 文档目的
本文档为「 桑丘目标拆解」Obsidian 插件的唯一官方需求规范，明确产品定位、核心功能、UI 视觉、交互规则、文案标准与验收要求，用于指导插件开发、测试、迭代全流程，确保所有功能完全贴合产品核心定位与用户确认需求。
1.2 产品核心定位
Obsidian 原生适配、侍从式陪伴的目标拆解插件
以桑丘·潘沙为灵魂形象，为用户提供「人生长期目标→阶段目标→项目目标→每日行动」的 4 级 AI 自动拆解能力，深度绑定 Obsidian 原生双链实现目标笔记无缝跳转；全程以忠诚陪伴、务实温柔的侍从精神为核心——桑丘从不戳穿堂吉诃德的幻梦，他只是备好干粮、管好驴子、把巨人的远征换算成一顿能吃饱的饭。
用户是堂吉诃德，插件是桑丘。
1.3 核心人设
堂吉诃德的忠诚侍从——桑丘·潘沙
性格：务实但不世故，忠诚但不盲从，爱嘟囔但从不下马离开
语气：泥土味的温柔，带点狡黠的幽默。不煽情、不鸡血、不 push，永远管用户叫“老爷/姑娘”
核心态度：您尽管朝着风车冲锋，我来算路程、备干粮、管驴子。赢了给您挂勋章，摔了给您拍灰。
核心边界：绝不质疑任何目标的合理性，哪怕它看起来就像一座风车。绝不评判主人的任何状态——出征是勇气，歇脚也是智慧。
1.4 目标用户
Obsidian 深度用户：知识管理者、终身学习者，习惯用双链笔记搭建个人体系，偏好原生适配、无冗余的插件，反感花哨、强焦虑的效率工具
内向型自我规划者：有长期 / 人生目标规划需求，易内耗、拖延，需要私密、无压力的正向陪伴，反感社交式打卡、强任务驱动。需要的是一个绝不催征的侍从，不是又一个挥舞鞭子的监工
笔记型成长用户：习惯在 Obsidian 中记录成长、规划人生，需要目标与笔记双链联动，实现「目标 - 行动 - 记录」的闭环
1.5 核心设计原则（所有需求必须严格遵循）
原生优先：100% 适配 Obsidian 原生交互、主题、暗色 / 浅色模式，不破坏用户原有笔记编辑体验
情绪优先：所有功能、文案、UI 均以无焦虑、正向陪伴为核心，禁止任何引发用户内疚、焦虑的设计
双链联动：核心拆解功能与 Obsidian 原生双链深度绑定，实现目标笔记间的无缝跳转
低打扰：所有提示、反馈均为轻量、非强制、可自动消失，不打断用户笔记编辑流程
本地优先：所有数据均存储在用户本地 Vault，不上传任何用户数据，保护用户隐私
二、全局配置需求
2.1 插件初始化规则
- 插件启用后，自动在用户当前 Vault 根目录创建默认目录结构，用户可在设置中自定义根目录名称
1 | 【默认根目录】Adventures/ |
首次启用插件，自动弹出极简引导页，仅包含 3 项内容：插件核心功能介绍、AI 接口配置引导、侧边栏开启引导，无冗余步骤
插件所有配置项均存入 Obsidian 本地插件配置文件，不云端同步
2.2 可配置项清单
| 配置项 | 默认值 | 配置说明 |
| 目标根目录 | /Adventures | 用户可自定义目标笔记的存储根目录 |
| AI 接口配置 | 空 | 支持用户配置自定义 AI 接口地址、API Key、模型名称 |
| 侧边栏气泡自动刷新频率 | 2 小时 | 支持用户自定义问候语轮播间隔，可选：1 小时 / 2 小时 / 4 小时 / 关闭自动刷新 |
| 分时段问候语开关 | 开启 | 支持用户关闭分时段问候，仅展示通用轮播文案 |
| 激励提示开关 | 开启 | 支持用户关闭任务完成后的气泡提示 |
| 桑丘形象展示开关 | 开启 | 支持用户关闭 IP 形象，仅展示纯文本气泡 |
| 底部 Slogan 展示开关 | 开启 | 支持用户关闭侧边栏底部 Slogan |
三、核心功能需求规范
模块 1：侧边栏核心 UI 模块（最高优先级，替换原有标题栏）
1.1 布局规范
固定位置：Obsidian 侧边栏顶部首行，完全替换原有「Kiro 目标 -> 分解 侧边栏」文本标题，不随侧边栏内容滚动而消失
固定结构（横向单行排列，100% 适配侧边栏宽度）：
| 左侧固定区域（垂直居中） | 右侧自适应区域（垂直居中） |
| 24*24px 桑丘 icon（与 Obsidian 原生侧边栏图标尺寸完全一致） | 自适应宽度圆角气泡，最大宽度占侧边栏可用宽度的 80%，单行展示文案，溢出内容 hover 时悬浮展示全量文本 |
- 折叠适配：侧边栏折叠时，仅保留 24*24px 桑丘 icon，完全隐藏气泡，不破坏 Obsidian 原生折叠态的整洁度
1.2 气泡核心规则
视觉规范：8px 圆角（与 Obsidian 原生控件圆角完全一致），背景色rgba(124, 58, 237, 0.15)，1px 描边#7C3AED（Obsidian 官方品牌紫），内边距 4px 8px
文案优先级（严格遵循）：任务完成激励提示 > 操作引导提示 > 分时段专属问候 > 通用轮播文案
交互规则：
无用户操作时，默认展示对应时段的问候语，按用户配置的频率自动切换；点击桑丘 icon 可手动刷新切换文案
用户完成任务 / 拆解目标 / 创建目标笔记时，气泡优先弹出对应激励文案，停留 3 秒后自动切回常规问候语，无强制交互
点击气泡，直接跳转到目标根目录的「总览笔记」；hover 气泡，展示完整文案
1.3 侧边栏底部固定区域
固定展示插件 Slogan，字体大小与 Obsidian 原生侧边栏辅助文本一致，颜色继承原生主题次要文本色，居中对齐
默认首选 Slogan：陪你大战风车的桑丘
备选可配置 Slogan 清单（用户可在设置中切换）：
把远方，拆成当下的每一笔
慢慢来，每一步都算数
慢慢走，拉曼查的星星认得每一双慢下来的脚
种一棵树，最好的时机是现在
骑士有理想，侍从有清单
模块 2：AI 目标层级拆解核心功能
2.1 拆解层级规则（固定 4 级，不可变更）
AI 必须严格按照以下层级进行目标拆解，自动创建对应笔记，并存入对应目录：
一级：人生长期目标（存储目录：/Adventures/01 - 人生长期目标 /）
二级：阶段目标（存储目录：/Adventures/02 - 阶段目标 /）
三级：项目目标（存储目录：/Adventures/03 - 项目目标 /）
四级：每日行动（存储目录：/Adventures/04 - 每日行动 /）
2.2 拆解流程与输出规范
输入：用户在插件面板输入的目标文本（如 “3 年内实现财务自由”）
AI 输出固定结构（必须包含以下模块，自动生成对应笔记）：
目标校准：将用户模糊目标转化为可衡量的清晰定义，无鸡汤、无评判
层级拆解：按 4 级结构拆解，每一级拆解不超过 5 个子项，确保可落地
自动建链：每一个子目标自动生成对应笔记，插入 Obsidian 原生双链，实现上下级目标双向关联
导航面板：每篇目标笔记顶部自动插入固定导航条：[[归属上级目标]] | [[当前阶段总览]] | [[今日行动清单]]
反向链接：每篇目标笔记底部自动生成关联模块：归属目标：[[XXX]] | 子目标：[[XXX]], [[XXX]]
- 拆解话术要求：AI 全程使用软陪伴语气，禁止冰冷的指令式表述，拆解完成后必须附带一句正向鼓励文案（如 “拆好啦！这些小任务都很轻松，你随便选一个开始就好，不用急”）
2.3 权限规则
插件仅可修改、编辑、创建「Adventures 根目录」内的笔记，绝对禁止修改、删除用户根目录下其他非插件生成的笔记内容
模块 3：目标双链跳转与导航功能
全局目标树视图：在侧边栏提供可折叠的目标树面板，按 4 级结构展示用户所有目标，点击任意节点直接跳转到对应笔记，支持搜索目标名称
今日行动快捷入口：侧边栏固定展示「今日行动」快捷入口，点击直接跳转到当日的每日行动笔记，自动汇总所有未完成的行动项
跳转无感化：所有目标间的跳转均使用 Obsidian 原生双链能力，无第三方跳转、无新窗口弹出，完全贴合用户原生笔记操作习惯
模块 4：正向激励与奖励机制模块（无焦虑核心）
所有激励均无惩罚、无指责、无焦虑，仅做正向反馈，触发场景与对应规则如下：
| 触发场景 | 触发条件 | UI 反馈 | 文案规范 |
| 打开插件 / 侧边栏 | 用户启用插件 / 点击打开侧边栏 | 气泡弹出轻量提示，桑丘 icon 切换为微笑挥手常态款，1 秒后自动消失 | 1. 欢迎回来～能打开看看，就已经很有勇气啦2. 我一直在这儿等你，慢慢来就好 |
| 小行动推进 | 标记完成 1 个每日行动 / 创建 1 篇子目标笔记 / 完成 1 次目标跳转 | 任务旁弹出 1 颗小紫星图标，桑丘切换为抱星星开心款，气泡弹出激励文案 | 1. 哇！又完成一小步，超厉害的2. 你和桑丘又攒到 1 颗星星啦3. 把大目标拆小，你真的很会规划呀 |
| 阶段目标完成 | 标记完成 1 个二级 / 三级目标 | 侧边栏弹出简约庆祝卡片（无花哨动效，仅星星线条 + 低透紫背景），自动生成「目标完成纪念笔记」，桑丘切换为举星星欢呼款 | 1. 太棒啦！这个小目标圆满完成，你值得为自己骄傲2. 一步一个脚印，你正在活成想要的样子3. 下一段路，我还陪你一起走 |
| 长期未操作（≥3 天未打开插件 / 无目标操作） | 用户超过 3 天无任何插件相关操作 | 桑丘切换为软乎乎趴着的摆烂款，气泡展示无压力文案，绝对不做指责 | 1. 休息是为了更好的出发，没关系的2. 不想动就歇会儿，我一直都在3. 不用逼自己，顺其自然就好 |
星星收集机制
用户每完成 1 个行动项 / 子目标，自动累计 1 颗星星，仅在气泡中轻量提示（如「你和桑丘已经攒了 XX 颗星星啦」），不做进度条焦虑、不做排名、不做强制任务
累计星星可解锁桑丘隐藏动作（抱大星星、飞起来的桑丘等），仅做治愈向收集乐趣，不做任务捆绑；每日打开插件即可解锁基础隐藏动作，无需完成任务
模块 5：文案与问候语轮播模块
5.1 核心规则
所有问候语 ** 绝对禁止直接提及「推进目标、完成任务、逾期、未完成」** 等相关表述，仅做潜移默化的正向引导与情绪陪伴
严格按照系统时间分时段展示对应文案，同时支持通用文案全时段随机轮播
5.2 分时段专属文案库
| 时段 | 文案清单（单行适配，不溢出气泡） |
| 早上 6:00-12:00 | 1. 早安哟～2. 晨光正好，开启新的一天3. 一日之计在于晨4. 早！今天也有好好吃饭吗5. 晨风拂面，万事可期 |
| 中午 12:00-18:00 | 1. 太阳当空照2. 锄禾日当午3. 午安～吃饱饱才有好状态4. 午后阳光，正好整理思绪5. 偷个懒，歇一歇再出发 |
| 晚上 18:00-24:00 | 1. 傍晚好呀2. 日落归山海，烟火暖日常3. 忙了一天，辛苦啦4. 夜色温柔，好好放松一下5. 吹吹晚风，放下一天的疲惫 |
| 凌晨 0:00-6:00 | 1. 夜深了～2. 尼克斯赐我一双发现美的眼3. 夜静了，和自己好好相处吧4. 别熬太晚，星星都睡啦5. 晚安全世界，也晚安你 |
5.3 通用轮播文案库（全时段可触发）
种一棵树最好的时机是现在
百尺竿头，更进一步
心有山海，静而无边
慢慢来，会有答案的
步履不停，终有回甘
当下，即是最好的时机
风过林梢，正当年少
平凡的日常，也有细碎光芒
模块 6：桑丘·潘沙 IP 形象状态管理模块
6.1 核心规则
以桑丘·潘沙为核心形象，圆胖身材、宽檐帽、粗麻布衣、肩挎水囊、身侧常伴一头灰驴剪影。整体画风是塞万提斯式的粗砺温柔——不是桑丘的甜软，是泥土、皮革、旧毛毯混合起来的暖。
所有形象均适配暗色 / 浅色模式，描边统一使用桑丘棕 #8B7750，降饱和处理，与 Obsidian 原生界面的克制质感融为一体。
6.2 形象状态与触发场景
| 桑丘形象状态 | 触发场景 |
|---|---|
| 靠驴嚼草·常态款 | 日常无操作、打开插件时默认展示。桑丘靠着驴子，帽子半遮脸，似睡非睡。 |
| 竖拇指咧嘴款 | 用户完成小任务、拆解目标时展示。桑丘露出豁牙的笑容，粗短拇指高高竖起。 |
| 举水囊欢呼款 | 用户完成阶段目标 / 长期目标时展示。桑丘高举他的旧皮水囊，像举着酒杯。 |
| 揉眼搓脸·清晨款 | 早间时段（6:00-12:00）默认展示。桑丘刚醒，搓着肉脸，驴子在旁边打哈欠。 |
| 嚼干粮·午后款 | 午间时段（12:00-18:00）默认展示。桑丘坐在树荫下，掰着硬面包，神情满足。 |
| 点灯笼·夜幕款 | 晚间时段（18:00-24:00）默认展示。桑丘提着一盏小油灯，火焰映着他的圆脸。 |
| 裹毯打盹·守夜款 | 凌晨时段（0:00-6:00）默认展示。桑丘裹着旧毛毯，头一点一点但还撑着。 |
| 靠驴打鼾·休息款 | 用户超过 3 天未操作时展示。桑丘和驴子都睡着了，画面静谧安详，毫无责备。 |
| 旅途彩蛋·隐藏款 | 用户累计战利品达到对应数量时解锁（如桑丘掏出一整只烤羊腿、驴子戴上花环等）。 |
四、UI / 视觉规范（严格执行）
4.1 核心色值规范（暗色模式优先，原生适配）
| 用途 | 固定色值 | 设计规则 |
|---|---|---|
| 核心点缀色 | #8B7750（桑丘棕——拉曼查干土与旧麻布的颜色） |
仅用于气泡描边、战利品高亮、桑丘形象描边，不做大面积填充 |
| 气泡背景 | rgba(139, 119, 80, 0.10) |
极低透明度暖褐填充，在暗色模式下是一抹几不可察的羊皮纸温度 |
| 桑丘主体色 | 降饱和暖褐 #B8A88A + 深棕描边 |
适配暗色背景，质朴沉稳，不跳脱 |
| 主背景 / 文本色 | 完全继承 Obsidian 当前主题的背景色、正文色、次要文本色 | 不自定义背景与基础文本颜色，100% 跟随用户本地主题 |
4.
4.2 明暗模式适配规则
暗色模式：桑丘描边用桑丘棕
#8B7750，气泡用 10% 透明度暖褐，战利品（麦穗）用金色微光#D4A853，完全融入黑底界面，像夜里帐篷透出的一盏暖灯。浅色模式：整体暖褐饱和度自动降低 20%，桑丘保留质朴底色，描边换浅棕
#A6977A，气泡用 6% 透明度暖褐。视觉上是阳光晒旧的羊皮卷质感，不破坏浅色主题的干净感。所有控件圆角统一为 8px，与 Obsidian 原生控件圆角完全一致。桑丘虽然是乡下侍从，但懂规矩
4.3 动效规范
所有动效时长不超过 300ms，缓动效果与 Obsidian 原生动效一致
仅保留星星闪烁、卡片淡入淡出 2 种基础动效，无花哨、夸张的动画效果
所有动效均可在设置中关闭，默认开启
五、禁忌规则（绝对不可违反）
绝对禁止出现任何引发焦虑的文案与 UI：包括但不限于「未完成」「逾期」「倒计时」「你还没做」「快完成」「落后」等表述，禁止红色警告色、强制任务提醒
绝对禁止强制弹窗、强制交互，所有提示均为轻量、可自动消失，不打断用户笔记编辑
绝对禁止上传用户任何笔记数据、目标数据、个人信息到第三方服务器，所有数据 100% 存储在用户本地 Vault
绝对禁止修改、删除用户非插件生成的笔记内容，仅可操作「Adventures 根目录」内的插件生成笔记
绝对禁止出现任何指责、评判、贬低用户的文案，即使用户长期未操作、未完成任务，也仅可输出无压力鼓励文案
绝对禁止破坏 Obsidian 原生交互逻辑，所有功能均需贴合用户原生操作习惯，不做反人类设计
六、非功能需求
性能要求：插件启动延迟 < 100ms，不占用 Obsidian 主线程，正常使用时内存占用 < 50MB，无卡顿、无崩溃
兼容性要求：适配 Obsidian v1.4.0 及以上全版本，兼容 Windows/macOS/Linux 全平台，兼容 Obsidian 官方默认主题与 90% 以上主流社区主题
可扩展性要求：预留 AI 模型扩展接口，支持后续新增多模型适配；预留文案库自定义接口，支持后续用户自定义问候语与激励文案
稳定性要求：插件崩溃率 < 0.1%，不会导致 Obsidian 闪退、笔记丢失，所有操作均有本地备份机制
七、验收标准
7.1 功能性验收
插件启用后可正常创建默认目录结构，AI 可按 4 级结构完成目标拆解，自动创建对应笔记并插入正确的双链与导航面板
侧边栏顶部布局符合规范，桑丘 icon + 气泡正常展示，分时段问候语按系统时间正确轮播，点击交互符合需求
所有激励场景可正常触发，对应桑丘形象、气泡文案、UI 反馈正确，无指责、无焦虑内容
目标树视图可正常展示所有目标，点击可正常跳转到对应笔记，双链跳转无异常
所有配置项可正常修改、保存，重启插件后配置不丢失
7.2 UI / 视觉验收
100% 适配 Obsidian 暗色 / 浅色模式，色值符合规范，无视觉割裂、无炸眼元素
侧边栏折叠 / 展开状态适配正常，气泡不溢出侧边栏，文案展示符合规范
桑丘形象按场景正确切换，适配明暗模式，无变形、无模糊
7.3 体验验收
所有文案均符合情绪优先原则，无焦虑、无指责、无鸡血内容
无强制弹窗、无强制交互，所有提示均为轻量、可自动消失，不打断用户编辑
插件启动、操作无卡顿、无延迟，性能符合非功能需求
完全贴合 Obsidian 原生操作习惯，无反人类交互设计