登录墨栈
默认账号 admin / admin123，首次登录请改密码
操作步骤
- 浏览器打开 H5：
http://localhost:8080（本地 dev） - 输入用户名
admin+ 密码admin123 - 点击「登入」按钮
- 自动跳转到工作台（首页）
首次登录要做
- 「我的 → 设置」改默认密码（admin123 是 demo 密码）
- 上传头像、改昵称（默认是
墨栈主理人） - 设置个性签名（用作对外展示）
localStorage.moke_token。
看工作台 · 心中有数
每日打开先看这一页：今日营收、订单、待办、趋势
4 个核心指标
- 本月营收：所有 status='shipped' 订单金额
- 订单数 (30天)：含 awaiting_pay / pending / shipped 全状态
- 总售书单：已上架且产生过订单的书单数
- 私域客户：积累的所有下单客户
快速操作 4 个按钮
藏/册/文/传 4 个水墨字图标，分别对应：
- 藏（新建书单）→ 书单编辑页
- 册（添加电子书）→ 手动添加书
- 文（写营销文案）→ AI 文案生成页
- 传（发资源链接）→ 资源分发页
今日待办（按优先级排）
系统自动识别出需要你处理的事项：
- 已发货订单 / 待支付订单 / 草稿书单 / 缺链接书单
- 点击可跳到对应页面直接处理
30 天销售趋势
底部柱状图，每天一柱，鼠标悬停看具体金额。零基础启动时柱子是空的，连续 7 天有订单后开始有起伏感。
录入电子书库
所有书先入库，再被书单引用。一本书可以挂在多个书单里
两种录入方式
方式 ① ISBN 批量导入（推荐）
最省事，10 个 ISBN 一行粘贴，自动从豆瓣拉元数据（标题/作者/封面/简介）。
- 书单 tab → 电子书库 → 右上「批量 ISBN 导入」
- 粘贴 ISBN 列表（每行一个 或 空格分隔）
- 点「AI 智能导入」，等 5-10 秒
- 看到导入成功数 + 失败数（失败的多半是 ISBN 错或豆瓣没收录）
方式 ② 手动单本添加
在书库里点右下角「+」号，手填书名/作者/出版社/封面/简介。封面支持 3 选 1：
- 贴豆瓣/百度图书的图片 URL（系统会走防 403 代理）
- AI 搜封面（按书名搜豆瓣）
- 本地图片上传（白名单：jpg/png/webp，最大 50MB）
关键原则
- 一本书只入库一次，多个书单复用同一份
- 先按「领域/主题」分批导入，每批 5-10 本
- 导入后回到书库看一眼，确认封面没破图
douban.lookupByIsbn()，不要让 AI 帮你猜 ISBN（AI 在 ISBN 上 100% 瞎猜）。如果豆瓣没收录（少数新书/绝版书），就只能手动填书名走 AI 搜。
创建书单 · 关联书 + 价格 + 分发链接
书单 = 你要卖的"商品 SKU"，可以挂多本书 + 多个分发链接
必填字段（5 个）
| 字段 | 说明 |
|---|---|
| 书单标题 * | 20 字内，能讲清主题。例如「程序员精进之路 · 5 本必读」 |
| 简介 | 2-3 句话钩子，知乎/朋友圈风格 |
| 封面 URL | 9:13 竖版封面，从豆瓣拉或 AI 搜 |
| 价格 (元) | 单书总定价。9.9 / 19.9 / 29.9 / 39.9 心理价位 |
| 分类 + 标签 | tech / cognition / growth / business / other；标签逗号分隔 |
关联电子书（5-10 本最佳）
点「+ 从电子书库选择」多选已录入的书。书单是 1 对多（多本电子书），可以拖动调整顺序。
3 种状态
- 草稿 (draft)：在编辑但还没上架，不会在 C 端显示
- 上架 (active)：客户能扫码下单
- 归档 (archived)：停售，但历史订单还在
AI 一键写营销文案
选书单 → 选平台 → AI 自动生成 3 平台版本，10 秒出稿
怎么用
- 工作台快速操作点「文」，或营销 tab → AI 写文案
- 顶部下拉选书单（这里用「程序员精进之路 · 5 本必读」）
- 3 个平台 tab 切换：知乎 / 朋友圈 / 小红书
- 点「AI 生成」，等 5-15 秒
- 右侧文案区出现 3-5 段话术，点「复制」
3 个平台的写法差异
| 平台 | 风格 | 长度 |
|---|---|---|
| 知乎 | 理性 + 干货密度 + 信任背书 | 800-1500 字 |
| 朋友圈 | 口语 + 表情 + 短句 + 个人感受 | 100-300 字 |
| 小红书 | 种草 + emoji 标题党 + 标签党 | 300-600 字 |
二次加工的 SOP
- AI 出的稿是"80 分"基线，一定要人工改一遍，加你的真实经历
- 朋友圈版至少要改一处体现你最近在读 / 用的细节
- 小红书版要把标题改成"2 个感叹号 + 1 个 emoji + 数字"
utils/ai.js 走 OpenAI 兼容协议，你可以换成 DeepSeek / Qwen / MiniMax 任意一家，按 token 计费 1 本书单 ~ ¥0.05。
发布 + 录入效果数据
把 AI 文案贴到知乎/小红书/朋友圈，发完把数据回填
对外发布（手工）
- 在 AI 文案页点「复制」
- 手动贴到知乎回答 / 小红书笔记 / 朋友圈
- 发文时带上书单 C 端链接（用 H5 链接或短链）
回填效果数据（重要！）
这是「工作台 30 天趋势图」和「RFM 客户分层」的数据来源。发完 24 小时内回填：
- 点击「+」新增发布记录
- 填：平台 / 标题 / 链接 / 浏览 / 点赞 / 评论 / 转化数
- 转化数 = 链接带来的订单数（从订单管理里反查）
为什么必须回填？
独立运营者最缺的"决策依据"——你发 5 篇知乎，哪篇转化好？没有数据就只能凭感觉。回填后工作台会显示：
- 30 天趋势图（按平台分组）
- Top10 帖子（按转化率排序）
- 客户来源分布（知乎 60% / 小红书 30% / 朋友圈 10%）
客户下单 · C 端 H5 自动发货
公开 H5 详情页 + 支付 + 自动发货，全程不需要人工介入
分发链接加在哪
书单编辑只是配元数据，真正的"客户能访问的 H5 链接"要去「资源分发」tab 加：
- 分发 tab → 顶部「+ 添加」
- 选书单 + 平台（OSS / 百度网盘 / 知识星球 / 阿里云盘 / 夸克 / 迅雷 / 其他）
- 填分享链接 + 提取码 + 过期时间（30 / 90 天）
- 一个书单可加多个链接（先 OSS 直链优先用，网盘备用）
客户访问流程
- 你在小红书发"扫码下单"卡片，附 H5 链接（
/pages/shop/index?id=书单ID） - 客户打开 → 看到书单详情（5 本书 + 价格 + 简介）
- 客户填微信号 + 昵称 + 来源渠道 → 点「立即下单」
- 跳到支付页，订单进入
awaiting_pay状态 - 客户付款（开发模式是 mock-paid）→
shipped状态 - 客户回到成功页，自动看到资源链接
订单 7 天自动关闭
如果客户下单后 7 天没付款，scripts/cron.js 定时任务会自动关闭订单释放链接（避免链接被占住别人拿不到）。
routes/public.js 内置了 IP 限流（每分钟 60 次），防爬虫防刷单。
私域沉淀 · 客户档案 + RFM 分层
客户不是"一次性交易"，是"长期复购对象"
订单管理看哪些
分发 tab → 订单管理。5 态状态机：
| 状态 | 含义 | 你要做什么 |
|---|---|---|
| awaiting_pay | 已下单未付款 | 7 天内客户付了就自动转；不付就自动关 |
| pending | 已付款待你确认 | 回客户微信发送资源链接 |
| shipped | 已发货（系统自动） | 无需操作，链接已发到客户手机 |
| refunded | 已退款 | 查售后原因，记录到客户 tag |
| cancelled | 已取消 | 系统自动关单，无需操作 |
客户自动入库
任何完成 shipped 的订单，客户的微信号会自动写入 distribution_clients 表，附带：
- 总消费金额 / 订单数 / 最后活跃时间
- 来源平台（知乎 / 小红书 / 朋友圈 / 闲鱼）
- 自动打 RFM 标签
RFM 8 象限
基于 R(Recency 最近一次消费) / F(Frequency 频次) / M(Monetary 金额) 三维打分：
| 分层 | 含义 | 运营动作 |
|---|---|---|
| 重要价值 | 高频高额 + 最近买过 | VIP 群 + 优先新书推送 |
| 重要发展 | 高频低额 + 最近买过 | 推关联书单提升客单 |
| 重要保持 | 高频高额 + 很久没买 | 主动召回，发优惠 |
| 重要挽留 | 低频高额 + 很久没买 | 大额优惠券 + 一对一 |
| 一般价值/发展/保持/流失 | 中低频 | 通用触达策略 |
附录 · 常见问题 & 踩坑清单
实操中容易卡住的 8 个点，提前看一眼
Q1: 工作台统计是 0/为空？
检查 3 件事：① 订单 status 必须是 'shipped' 或 'completed' 才计入营收；② 客户档案要等订单 shipped 才自动入库；③ 浏览器开 DevTools 看 Network，确认 /api/stats/overview 返回 200。
Q2: 客户扫码打开 H5 看到白屏？
9 成是 BASE_URL 配错。H5 在手机上跑时，api/request.js 里的 BASE_URL 必须是 LAN IP（如 http://192.168.1.5:3002），不能用 localhost。改完重新 npm run dev。
Q3: ISBN 导入失败率高？
豆瓣 API 限流——单批 10 个以内成功率最高，间隔 1 秒。失败的多半是 ISBN 错位（少一位/多一位）或豆瓣没收录（绝版书）。
Q4: 封面图在手机上不显示？
豆瓣有防盗链，绝对不能在 :src 直接用豆瓣 URL。墨栈内置 coverUrl() 走 /api/cover/proxy 代理（白名单只允许 douban 域名）。
Q5: AI 文案生成 5 秒超时？
前端的 uni.request 默认 timeout 60s，但 AI 大模型生成偶尔会 30-90s。在 api/request.js 里改 timeout: 120000（2 分钟）。
Q6: 想发"邀好友返现"但邀请人收不到？
referral_rewards 表当前是空表，需要后端加触发逻辑（订单 shipped 时检查 referred_by 字段）。这是 Phase 3 计划内的事。
Q7: 想接真实微信支付？
当前是 mock-paid 模拟按钮。接真支付要：① 申请微信商户号（个体工商户 / 企业）；② 在 routes/public.js 加 /api/public/payment/wechat 调统一下单接口；③ 改成功页跳回逻辑。约 2-3 天开发。
Q8: 部署到线上要改哪些？
① 后端 .env 的 DB / JWT 改生产值；② 前端 api/request.js 的 BASE_URL 改 https://api.your-domain.com；③ 前端 HBuilderX 编译 dist/build/h5 上传服务器；④ Nginx 加 location /api/ 反代到 3002；⑤ 跑 sql/init.sql 和 sql/upgrade_v2.sql；⑥ PM2 启动 ecosystem.config.js + scripts/cron.js。详细步骤见 AGENTS.md 部署清单。