docs: 精简长期规划文档，去除技术实现细节，保留方向性内容

- 技术与交付模块：去除具体技术栈/部署方案/文件路径，仅保留技术方向 - 个人开发者创业计划：去除当前技术开发状态、文档索引 - 产品与用户模块：去除具体页面清单、文档引用 - 商业化与支付模块：去除技术实现细节、文档引用 - 运营与客服：去除 API 路由/具体技术栈引用，保留服务策略 - 其余模块：去除交叉文档引用 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-21 13:23:09 +08:00 · 2026-05-21 13:23:09 +08:00 · a1113df50c
commit a1113df50c
parent 587f5e7ace
9 changed files with 51 additions and 428 deletions
--- a/长期规划/[参考]-产品与用户模块.md
+++ b/长期规划/[参考]-产品与用户模块.md
@ -76,13 +76,6 @@

 ---

-## 核心页面（14 页）
-
-| 优先级 | 页面 |
-|--------|------|
-| P0 | 登录页、学习方向选择页、学习路径页、今日学习任务页、内容阅读页、主动回忆/笔记输入页、AI 分析结果页、AI 对话页、复习计划页 |
-| P1 | 学习进度页、设置页、反馈页、欢迎页、语言偏好页 |
-
 ---

 ## 账号体系
@ -92,8 +85,3 @@

 ---

-## 相关文档
-
- [阶段路线图](../../技术设计/阶段路线图.md)
- [技术与交付模块](./[参考]-技术与交付模块.md)
- [商业化与支付模块](./[进行中]-商业化与支付模块.md)
--- a/长期规划/[参考]-技术与交付模块.md
+++ b/长期规划/[参考]-技术与交付模块.md
@ -2,76 +2,36 @@

 ## 模块目标

-确定技术栈、开发流程、交付节奏和质量标准。
+确定技术方向和交付策略。

 ---

-## 技术选型（已决策）
+## 技术方向

-| 层级 | 选型 | 说明 |
-|------|------|------|
-| iOS | Swift / SwiftUI | Apple 原生，MVVM + Service + Repository |
-| 后端 | NestJS + TypeScript | 模块化单体架构 |
-| ORM | Prisma | 类型安全，自动生成 TS 类型 |
-| 数据库 | MySQL | 服务器已部署 |
-| 缓存/队列 | Redis + BullMQ | 缓存 + 队列 + 限流 + 临时状态 |
-| AI | Provider 抽象 + Mock + 真实模型 | MiniMax / DeepSeek / OpenAI 等可替换 |
-| 部署 | Docker Compose + Nginx | 4核4G 轻量云，域名 api.longde.cloud |
-| 官网 | Astro | SEO 友好，静态生成 |
-| 后台管理 | Vite + React + Ant Design + ProComponents + TanStack Query | 预留 |
+- **Apple-first**：优先 iOS（Swift/SwiftUI），后续扩展 iPad/Mac
+- **后端**：模块化架构，按业务域拆分
+- **AI**：Provider 抽象层，按任务分级路由模型（轻任务用便宜模型，核心分析用主力模型）
+- **部署**：单服务器起步，后续按需扩展
+- **官网**：静态生成，SEO 友好

 ---

-## 前后端协作流程
+## 交付节奏

-1. 选一个业务流程
-2. 根据流程拆接口
-3. 后端设计表结构、DTO、接口、Swagger
-4. 前端根据 Swagger 写 Model / Service
-5. 前端接页面 → 联调 → 发现问题 → 回头改接口/DTO/表结构
-6. 稳定后再做下一个流程
+按业务流程逐个交付，每个流程走通前后端联调后再做下一个。

 ---

-## iOS 多设备工程策略
+## 第一版范围

-| 设备 | 策略 |
-|------|------|
-| iPhone + iPad | 同一个 Xcode Project，同一个 iOS App Target |
-| Mac | 单独 Mac 版本 Target |
-| Watch | watchOS Target |
+**做：** iOS 客户端、核心学习闭环、AI 分析、Apple IAP
+
+**暂不做：** 安卓、Web 学习端、复杂后台

 ---

-## 第一版技术范围
+## 核心原则

-**必须：** iOS 客户端、核心功能、简单后端、AI API 调用、本地数据存储、Apple IAP
-
-**暂不做：** 安卓客户端、微信/支付宝支付、复杂后台管理系统、Web 学习端
-
---
-
-## AI 架构
-
-> 详见：[AI架构设计](../../技术设计/api-server/AI架构设计.md)
-
-核心原则：从"业务分级工作流"开始，暂不做完全自治 Agent。后期通过用户学习画像、长期记忆和受控 Skill 系统逐步演进。
-
-模型按任务分级：轻任务用便宜模型，核心分析用主力模型，复杂推理用强模型。
-
---
-
-## 后端开发路线
-
-> 详见：[后端开发优先级](../../技术设计/api-server/后端开发路线图.md)
-
-核心开发顺序：**身份权限 → 知识系统 → 学习闭环 → AI 基础设施 → 文件导入 → 商业化 → 后台 → 客服 → 学习画像 → 公开分享 → 增长归因**
-
---
-
-## 相关文档
-
- [阶段路线图](../../技术设计/阶段路线图.md)
- [产品与用户模块](./[参考]-产品与用户模块.md)
- [AI架构设计](../../技术设计/api-server/AI架构设计.md)
- [后端开发优先级](../../技术设计/api-server/后端开发路线图.md)
+- 从"业务分级工作流"开始，暂不做完全自治 Agent
+- 先验证核心闭环，再扩展平台
+- 模型路由：基础档不默认使用高价模型，高级推理作为 Pro 权益
--- a/长期规划/[设计中]-合规与公司化模块.md
+++ b/长期规划/[设计中]-合规与公司化模块.md
@ -42,11 +42,3 @@
 - 退款政策
 - 免责声明

-## 相关文档
-
- [阶段路线图](../../技术设计/阶段路线图.md)
- [商业化与支付模块](./[进行中]-商业化与支付模块.md)
-
-## 负责人
-
-[待定]
--- a/长期规划/[设计中]-数据反馈与迭代模块.md
+++ b/长期规划/[设计中]-数据反馈与迭代模块.md
@ -40,11 +40,3 @@
 - 产品改进
 - 用户通知

-## 相关文档
-
- [阶段路线图](../../技术设计/阶段路线图.md)
- [运营与客服模块](./运营与客服/[进行中]-运营与客服模块.md)
-
-## 负责人
-
-[待定]
--- a/长期规划/[进行中]-个人开发者创业计划.md
+++ b/长期规划/[进行中]-个人开发者创业计划.md
@ -41,7 +41,7 @@
 ├── 2. 技术与交付模块     → 技术栈、AI 架构、工程策略
 ├── 3. 商业化与支付模块   → 定价、订阅、权益
 ├── 4. 营销与增长模块     → 获客、内容、冷启动
-├── 5. 运营与客服模块     → Dify 客服、工单、用户运营
+├── 5. 运营与客服模块     → AI 客服、工单、用户运营
 ├── 6. 数据反馈与迭代模块 → 指标、埋点、迭代
 └── 7. 合规与公司化模块   → 上架合规、公司化时机
 ```
@ -62,42 +62,11 @@
 | 7 | iPad / Mac 扩展 | 🔲 |
 | 8 | 公司化与安卓扩展 | 🔲 |

-> 详见：[阶段路线图](../技术设计/阶段路线图.md)
-
 ---

-## 五、当前状态
-
-| 模块 | 进度 | 关键缺口 |
-|------|------|----------|
-| iOS App | 21 页面 UI 完成 | NavigationLink 编译问题、API Service 未接通、MVVM 未分层 |
-| 后端 API | 13 模块骨架 | Repository 未接 MySQL、BullMQ 未接 Redis、AI 走 Mock |
-| 官网 | 基础页面上线 | Waitlist/Support 表单未接后端、品牌名不统一、CSS 变量缺失 |
-| 数据库 | MySQL + Redis 已部署 | 代码未走 Prisma |
-| 方向验证 | 3 个候选方向 | 未打分选定，未准备知识库内容 |
-
-> 详见：[潜在问题清单](../技术设计/潜在问题清单.md)
-
---
-
-## 六、各模块文档索引
-
-| 模块 | 主文档 | 子文档 |
-|------|--------|--------|
-| 1. 产品与用户 | [产品与用户模块](./[参考]-产品与用户模块.md) | [产品方向深度评估](./[参考]-产品方向深度评估.md) |
-| 2. 技术与交付 | [技术与交付模块](./[参考]-技术与交付模块.md) | [AI架构设计](../技术设计/api-server/AI架构设计.md) / [后端开发优先级](../技术设计/api-server/后端开发路线图.md) |
-| 3. 商业化与支付 | [商业化与支付模块](./[进行中]-商业化与支付模块.md) | — |
-| 4. 营销与增长 | [营销与增长模块](./营销与增长/[进行中]-营销与增长模块.md) | [营销冷启动调研方案](./营销与增长/[参考]-营销冷启动调研方案.md) / [冷启动与增长深度调研](./营销与增长/[参考]-冷启动与增长深度调研.md) |
-| 5. 运营与客服 | [运营与客服模块](./运营与客服/[进行中]-运营与客服模块.md) | [客服设计详案](./运营与客服/[参考]-客服设计详案.md) |
-| 6. 数据反馈与迭代 | [数据反馈与迭代模块](./[设计中]-数据反馈与迭代模块.md) | — |
-| 7. 合规与公司化 | [合规与公司化模块](./[设计中]-合规与公司化模块.md) | — |
-
---
-
-## 七、下一步行动
+## 五、下一步行动

 1. **选定垂直知识库方向**（3 候选 → 打分 → 选 1）
 2. **准备第一个 7 天路径的内容**
-3. **修复 iOS 编译问题 + Repository 接 Prisma + iOS 换 HTTPS**
-4. **做 3-5 个竞品拆解**
-5. **跑一次真实用户触达**（小红书/B站发内容，收集等待名单）
+3. **做 3-5 个竞品拆解**
+4. **跑一次真实用户触达**（小红书/B站发内容，收集等待名单）
--- a/长期规划/[进行中]-商业化与支付模块.md
+++ b/长期规划/[进行中]-商业化与支付模块.md
@ -52,11 +52,7 @@

 ## 支付流程

-```
-用户在 iOS App 内付款 → Apple IAP 完成交易 → 后端记录用户权益 → 用户获 Pro 权益
-```
-
-核心是自己的 **用户系统 + 订单系统 + 权益系统**，Apple IAP 只是第一阶段的支付通道。
+用户在 iOS App 内通过 Apple IAP 完成交易，后端记录用户权益。第一阶段仅走 Apple 支付通道。

 ---

@ -83,7 +79,3 @@

 ---

-## 相关文档
-
- [阶段路线图](../../技术设计/阶段路线图.md)
- [合规与公司化模块](./[设计中]-合规与公司化模块.md)
--- a/长期规划/营销与增长/[进行中]-营销与增长模块.md
+++ b/长期规划/营销与增长/[进行中]-营销与增长模块.md
@ -75,7 +75,3 @@ AI 生成内容草稿 → 人审核修改 → 人手动发布 → AI 辅助分

 ---

-## 相关文档
-
- [阶段路线图](../../../技术设计/阶段路线图.md)
- [营销冷启动调研方案](./[参考]-营销冷启动调研方案.md)
--- a/长期规划/运营与客服/[参考]-客服设计详案.md
+++ b/长期规划/运营与客服/[参考]-客服设计详案.md
@ -1,51 +1,38 @@
-对，你这个判断是对的。**你一个人做产品，如果没有 App 内客服 / 自动答疑系统，后面会非常累，而且体验也会很怪。**
+对，你这个判断是对的。你一个人做产品，如果没有 App 内客服 / 自动答疑系统，后面会非常累，而且体验也会很怪。

-用户遇到问题时，他不一定想发邮件，也不一定愿意等你手动回复。尤其是这些基础问题：
-
-```text
-怎么创建知识库？
-为什么 Apple 登录失败？
-AI 分析结果怎么看？
-会员怎么取消？
-退款怎么处理？
-安卓什么时候上？
-数据会不会丢？
-上传文件失败怎么办？
-```
+用户遇到问题时，他不一定想发邮件，也不一定愿意等你手动回复。

 这些如果都靠你一个人回，肯定扛不住。

 所以这里应该做一个：

-```text
+```
 App 内智能客服 + 反馈工单 + 后台处理系统
 ```

-而不是单纯一个“意见反馈表单”。
+而不是单纯一个"意见反馈表单"。

 ## 它在知习里的定位

 你可以这么定义：

-```text
-Dify 智能客服负责解决常见问题；
+```
+AI 智能客服负责解决常见问题；
 反馈系统负责收集真实问题；
 后台管理系统负责处理需要人工介入的问题。
 ```

-它不是学习 Agent，不参与主动回忆、薄弱点分析、复习计划这些核心学习闭环。核心学习 AI 还是走你自己的后端工作流。你的当前主线仍然是把 iOS App 从静态 UI 变成真实功能 App。
+它不是学习 Agent，不参与主动回忆、薄弱点分析、复习计划这些核心学习闭环。

 ## 我建议的客服流程

-可以这样设计：
-
-```text
-用户在 App 内点击“帮助与客服”
+```
+用户在 App 内点击"帮助与客服"
 → 先进入智能客服
-→ Dify 根据帮助知识库自动回答
+→ AI 根据帮助知识库自动回答
 → 如果解决了，结束
-→ 如果没解决，用户点击“转人工 / 提交反馈”
-→ 后端创建反馈工单
+→ 如果没解决，用户点击"转人工 / 提交反馈"
+→ 创建反馈工单
 → 后台显示待处理问题
 → 你有空再处理
 ```
@ -54,44 +41,9 @@ Dify 智能客服负责解决常见问题；

 ## 第一版客服应该回答什么

-第一版只回答官方固定内容：
+第一版只回答官方固定内容：功能使用说明、登录问题、知识库创建、文件上传、AI 分析说明、复习计划、订阅说明、退款流程、隐私政策、用户协议、常见错误处理、联系方式。

-```text
-功能使用说明
-登录问题
-知识库创建问题
-文件上传问题
-AI 分析说明
-复习计划说明
-订阅说明
-退款流程说明
-隐私政策
-用户协议
-备案信息
-常见错误处理
-联系方式
-```
-
-不要让客服 Bot 去读用户私人知识库内容。
-
-这点很重要。
-
-客服 Bot 只应该读：
-
-```text
-官方帮助中心知识库
-```
-
-不要读：
-
-```text
-用户上传的学习资料
-用户的主动回忆回答
-用户的私人知识库
-用户的学习分析结果
-```
-
-除非以后你专门做了授权机制。
+不要让客服 Bot 去读用户私人知识库内容。客服 Bot 只应该读官方帮助中心知识库，不要读用户上传的学习资料、主动回忆回答、私人知识库、学习分析结果（除非以后专门做了授权机制）。

 ## 你真正需要的是三层系统

@ -99,202 +51,33 @@ AI 分析说明

 用户问基础问题，机器人自动回。

-比如：
-
-```text
-“怎么取消订阅？”
-“怎么导入知识点？”
-“为什么我的 AI 分析失败？”
-```
-
-机器人可以直接回答流程。
-
 ### 第二层：反馈 / 工单系统

-如果机器人解决不了，就创建反馈。
-
-反馈字段可以有：
-
-```text
-用户 ID
-联系方式
-问题类型
-问题内容
-截图
-设备型号
-系统版本
-App 版本
-当前页面
-处理状态
-创建时间
-```
-
-问题类型可以先分成：
-
-```text
-功能问题
-登录问题
-订阅问题
-退款问题
-AI 分析问题
-上传问题
-数据问题
-建议反馈
-其他
-```
+如果机器人解决不了，就创建反馈。反馈字段包括用户 ID、联系方式、问题类型、问题内容、截图、设备型号、系统版本、App 版本、处理状态。

 ### 第三层：后台处理

-你在后台看到：
+你在后台看到待处理反馈、高频问题、用户对话记录、是否已解决、是否需要回复、是否需要更新帮助文档。这样你不是被动被消息轰炸，而是集中处理。

-```text
-待处理反馈
-高频问题
-用户对话记录
-是否已解决
-是否需要回复
-是否需要更新帮助文档
-```
+## 哪些问题机器人可以处理 / 哪些必须转人工

-这样你不是被动被消息轰炸，而是集中处理。
+可自动处理：功能怎么用、按钮在哪里、复习计划怎么理解、AI 分析结果是什么意思、会员权益说明、取消订阅流程、退款流程说明、隐私政策说明、常见错误排查。

-## 哪些问题机器人可以处理
-
-可以自动处理：
-
-```text
-功能怎么用
-按钮在哪里
-复习计划怎么理解
-AI 分析结果是什么意思
-会员权益说明
-取消订阅流程
-退款流程说明
-隐私政策说明
-常见错误排查
-```
-
-## 哪些问题必须转人工
-
-这些不要让机器人自己处理：
-
-```text
-退款争议
-账号删除
-数据丢失
-订阅权益异常
-用户投诉
-隐私问题
-内容违规问题
-支付失败但扣款
-Apple / Google 订单问题
-```
+必须转人工：退款争议、账号删除、数据丢失、订阅权益异常、用户投诉、隐私问题、内容违规、支付失败但扣款、Apple/Google 订单问题。

 机器人可以先收集信息，然后创建工单。

-比如：
-
-```text
-这个问题可能需要人工处理。我已经帮你记录反馈，请补充你的订阅平台、订单时间和问题截图。
-```
-
-## 技术上怎么接
-
-推荐结构是：
-
-```text
-iOS App
-→ 你的 NestJS 后端
-→ Dify API
-→ Dify 知识库
-```
-
-不要让 iOS 直接调用 Dify。
-
-原因是：
-
-```text
-Dify API Key 不能暴露在客户端
-客服会话需要绑定 userId
-问题记录要进你的数据库
-后续要接后台工单
-要做限流和审计
-```
-
-后端接口可以先设计成：
-
-```text
-POST /api/support/chat
-POST /api/support/feedback
-GET  /api/support/conversations
-GET  /api/support/feedbacks/my
-```
-
-后台接口：
-
-```text
-GET   /api/admin/support/tickets
-GET   /api/admin/support/tickets/:id
-PATCH /api/admin/support/tickets/:id
-POST  /api/admin/support/tickets/:id/reply
-```
-
 ## 第一版页面建议

-App 里做 3 个页面就够：
+App 里做 3 个页面：帮助与客服页、智能客服聊天页、提交反馈页。"我的"页面里放入口：帮助与客服、问题反馈、隐私政策、用户协议、关于知习。

-```text
-帮助与客服页
-智能客服聊天页
-提交反馈页
-```
-
-“我的”页面里放入口：
-
-```text
-帮助与客服
-问题反馈
-隐私政策
-用户协议
-关于知习
-```
-
-后台第一版加：
-
-```text
-反馈列表
-反馈详情
-客服会话记录
-问题分类统计
-```
-
-## Dify 知识库你可以先准备这些文档
-
-```text
-知习是什么
-如何创建知识库
-如何添加知识点
-如何开始主动回忆
-AI 分析结果怎么看
-待巩固项是什么
-复习计划是什么
-如何修改个人资料
-如何取消订阅
-如何申请退款
-Apple 登录失败怎么办
-上传文件失败怎么办
-数据安全说明
-隐私政策摘要
-联系客服方式
-```
-
-这些文档以后也可以直接变成 App 内帮助中心内容。
+后台第一版加：反馈列表、反馈详情、客服会话记录、问题分类统计。

 ## 最重要的一点

-智能客服不是为了“假装有人回复”，而是为了：
+智能客服不是为了"假装有人回复"，而是为了：

-```text
+```
 基础问题自动解决
 复杂问题收集完整信息
 你只处理真正需要人工判断的问题
@ -302,7 +85,7 @@ Apple 登录失败怎么办

 你一个人做产品，合理的客服策略应该是：

-```text
+```
 机器人先答
 答不了再建工单
 你集中处理高价值问题
@ -311,29 +94,8 @@ Apple 登录失败怎么办

 这样系统会越来越省你的时间。

-## 我的建议
-
-你现在可以把它加入规划，而且我建议尽早预留后端模块：
-
-```text
-support
-feedback
-support_tickets
-support_conversations
-admin_support
-```
-
-但第一版不要做复杂在线客服。先做：
-
-```text
-Dify FAQ 客服
-+ App 内反馈
-+ 后台工单列表
-+ 人工状态处理
-```
-
 一句话总结：

-```text
+```
 你确实应该做 App 内智能客服；它的价值就是替你挡住基础问题，把真正需要人工处理的问题变成后台工单，而不是让所有用户消息都直接压到你一个人身上。
 ```
--- a/长期规划/运营与客服/[进行中]-运营与客服模块.md
+++ b/长期规划/运营与客服/[进行中]-运营与客服模块.md
@ -8,17 +8,17 @@

 ## 客服体系（已决策）

-采用 **Dify 智能客服 + 反馈工单 + 后台处理** 三层架构：
+采用 **智能客服 + 反馈工单 + 后台处理** 三层架构：

 ```
 用户在 App 内点击"帮助与客服"
-→ Dify 根据帮助知识库自动回答 FAQ
+→ AI 客服根据帮助知识库自动回答 FAQ
 → 解决了 → 结束
 → 未解决 → 用户点"转人工 / 提交反馈"
-→ 后端创建工单 → 后台显示 → 你有空再处理
+→ 创建工单 → 后台显示 → 人工处理
 ```

-Dify 只读官方帮助知识库，不读用户私人数据（学习资料、回忆回答、私人知识库、分析结果）。
+AI 客服只读官方帮助知识库，不读用户私人数据（学习资料、回忆回答、私人知识库、分析结果）。

 ---

@ -56,36 +56,8 @@ Dify 只读官方帮助知识库，不读用户私人数据（学习资料、回

 ---

-## 技术架构
-
-```
-iOS App → NestJS 后端 → Dify API → Dify 知识库
-```
-
-后端接口：
- `POST /api/support/chat`
- `POST /api/support/feedback`
- `GET /api/support/conversations`
- `GET /api/support/feedbacks/my`
-
-后台接口：
- `GET /api/admin/support/tickets`
- `GET /api/admin/support/tickets/:id`
- `PATCH /api/admin/support/tickets/:id`
- `POST /api/admin/support/tickets/:id/reply`
-
---
-
 ## 用户运营

 - 新用户引导、激活策略、留存计划
 - 内测用户群管理
 - 知识库内容更新和质量把控
-
---
-
-## 相关文档
-
- [阶段路线图](../../../技术设计/阶段路线图.md)
- [数据反馈与迭代模块](../[设计中]-数据反馈与迭代模块.md)
- [客服设计详案](./[参考]-客服设计详案.md)