通过自动提及和标签创建功能，增强文章编辑功能

- 在文章编辑过程中，实现了自动创建不存在的@提及和#标签的功能，确保它们被添加到相应的数据库中。
- 更新了内容处理逻辑，以利用新创建的提及和标签，从而改善用户体验和内容管理。
- 增强了人物和链接标签创建的后端处理能力，使文章编辑过程中能够实现无缝集成。

.cursor/agent/开发助理/经验清单.md

@@ -42,6 +42,10 @@
 | 2026-03-13 | 小程序、后端、团队 | 业务规则 | api-dev SKILL、miniprogram-dev SKILL、three-tier-arch SKILL | 文章详情预览统一由后端按 50% 截取，小程序按 accessState 使用预览/全文，外层 content 与 data.content 始终一致以避免泄露全文 |
 | 2025-03-14 | 小程序 | 最佳实践 | miniprogram-dev SKILL §10 | 阅读页文本长按选中复制：text 组件 user-select（selectable 已废弃），正文/标题/预览均加 user-select |
 | 2026-03-14 | 后端、管理端、小程序、团队 | 业务规则/bug 修复 | - | 内容排名算法修正（排名分公式）；保存权重后 loadRanking 刷新；我的页设置隐藏；资料引导场景梳理 |
+| 2026-03-16 | 软件测试 | 知识沉淀 | testing SKILL | scripts 目录与测试关联：本地启动.sh 联调必备、飞书脚本非回归范围、soul-api/scripts 与根 scripts 区分 |
+| 2026-03-16 | 软件测试 | 目录约定 | testing SKILL §5 | scripts/test：miniapp 小程序接口测试、web 管理端测试；测试工程师在此编写用例 |
+| 2026-03-16 | 软件测试 | 目录约定 | testing SKILL §5 | scripts/test/process：流程测试，跨端多接口串联（下单→支付→分润等） |
+| 2026-03-16 | 软件测试 | 配置约定 | testing SKILL | pytest 架构、配置从 soul-api/.env* 读取、SOUL_TEST_ENV 必显；运行前报告头部显示测试环境，避免误测正式库 |
 
 ---
 

.cursor/agent/开发助理/项目索引/测试.md

@@ -21,6 +21,10 @@
 | 2026-03-05 | 文章详情@某人加好友方案讨论：@ 展示与添加好友用例、联调与回归 | 待续 |
 | 2026-03-10 | 会议：管理端迁移 Mycontent-temp；回归重点为菜单一致性、隐藏路由可达性、鉴权跳转 | 待续 |
 | 2026-03-16 | 乘风发起例行开发进度同步 | 已完成 |
+| 2026-03-16 | scripts 目录知识吸收：本地启动、飞书脚本、联调环境准备 | 已完成 |
+| 2026-03-16 | scripts/test 测试用例目录约定：miniapp 小程序接口、web 管理端 | 已完成 |
+| 2026-03-16 | scripts/test/process 流程测试目录：跨端业务流程 | 已完成 |
+| 2026-03-16 | pytest 架构、配置从项目读取、运行前显示测试环境 | 已完成 |
 
 ---
 

.cursor/agent/软件测试/evolution/2026-03-16-scripts目录与测试关联.md

@@ -0,0 +1,83 @@
+# 软件测试 经验记录 - 2026-03-16
+
+## scripts 目录与测试关联
+
+测试工程师需了解项目根目录 `scripts/` 下的辅助脚本，以便在联调、回归、环境准备时正确使用。
+
+---
+
+### 1. 本地启动脚本（联调必备）
+
+| 脚本 | 用途 | 测试关联 |
+|------|------|----------|
+| `本地启动.sh` | 一键启动 soul-api（8080）+ soul-admin（5174） | **三端联调前**：先执行此脚本，确保后端与管理端在本地运行；小程序需配置本地 API 地址 |
+
+**用法**：`./scripts/本地启动.sh` 或 `bash scripts/本地启动.sh`  
+**前置**：Mac/Linux 环境；soul-api 需能连接数据库；首次会编译 `soul-api-mac`  
+**验证**：访问 http://localhost:5174，默认账号 admin / admin123
+
+---
+
+### 2. 飞书相关脚本（非核心业务，可了解）
+
+| 脚本/目录 | 用途 | 测试关联 |
+|-----------|------|----------|
+| `feishu_export/` | 书稿导出 md，供飞书知识库同步 | 与 Soul 三端业务无直接关系，回归可不覆盖 |
+| `sync_book_to_feishu_export.py` | 从书稿目录导出 md 到 feishu_export | 同上 |
+| `feishu_wiki_upload.py` | 上传全书到飞书知识库 | 同上 |
+| `send_chapter_poster_to_feishu.py` | 生成章节海报并推送到飞书群 | 若海报含小程序码，可顺带验证二维码可访问性 |
+
+---
+
+### 3. Git 推送脚本
+
+| 脚本 | 用途 | 测试关联 |
+|------|------|----------|
+| `gitea_push_once.sh` | 首次推送到 Gitea 仓库 | 与功能测试无关，部署/发布流程用 |
+
+---
+
+### 4. 测试工程师使用建议
+
+- **联调前**：优先使用 `本地启动.sh` 启动后端与管理端，再测小程序、管理端功能
+- **回归范围**：scripts 内飞书、Gitea 脚本不纳入三端功能回归清单
+- **环境依赖**：`本地启动.sh` 依赖 Go 编译、pnpm、数据库可连；测试环境需提前确认
+
+---
+
+### 5. 测试用例目录 `scripts/test/`（测试工程师主战场）
+
+| 子目录 | 用途 | 对应端 |
+|--------|------|--------|
+| **miniapp/** | 小程序接口测试 | miniprogram，API：/api/miniprogram/* |
+| **web/** | 管理端测试 | soul-admin，API：/api/admin/*、/api/db/* |
+| **process/** | 流程测试 | 跨端，多接口串联 |
+
+**约定**：测试工程师在此编写与维护测试用例，miniapp 放小程序接口、web 放管理端、process 放跨端业务流程。
+
+**环境配置**：必须明确指定测试环境（SOUL_TEST_ENV=local|souldev|soulapi 或 SOUL_API_BASE），运行前会打印「测试环境: xxx」横幅，避免误测正式库。配置可来自 soul-api/.env* 或 scripts/test/.env.test。
+
+---
+
+### 6. pytest + requests 架构与配置约定
+
+| 文件 | 说明 |
+|------|------|
+| config.py | 从项目 soul-api/.env* 或 .env.test 读取；SOUL_TEST_ENV / SOUL_API_BASE |
+| conftest.py | base_url、admin_token、miniapp_token；pytest_report_header 显示环境横幅 |
+| util.py | admin_headers、miniapp_headers |
+| requirements-test.txt | pytest、requests |
+
+**配置优先级**：SOUL_TEST_ENV > SOUL_API_BASE > .env.test > soul-api/.env* > 默认 local。
+
+**运行前必看**：pytest 报告头部会显示「测试环境: 本地/测试/正式 (URL)」，确认无误后再执行。
+
+---
+
+### 7. 与 soul-api/scripts 的区别
+
+| 位置 | 内容 | 测试关联 |
+|------|------|----------|
+| `scripts/`（项目根） | 本地启动、飞书同步、Gitea 推送、**test/** | 见上文 |
+| `scripts/test/` | **测试用例**：miniapp、web、process；pytest 架构 | 测试工程师在此写用例 |
+| `soul-api/scripts/` | SQL 迁移、Python 脚本等 | 数据库迁移、后端运维；测试时若涉及表结构变更，需关注对应 SQL |

.cursor/agent/软件测试/evolution/索引.md

@@ -5,3 +5,7 @@
 | 2026-03-05 | 分支合并后回归清单制定；三端联调验证 | [2026-03-05.md](./2026-03-05.md) |
 | 2026-03-05 | 文章详情@某人：@ 展示与添加好友用例、联调与回归点 | [2026-03-05.md](./2026-03-05.md) |
 | 2026-03-10 | 管理端迁移 Mycontent-temp：菜单一致性、隐藏路由可达性、鉴权与跳转回归 | [2026-03-10.md](./2026-03-10.md) |
+| 2026-03-16 | scripts 目录与测试关联：本地启动、飞书脚本、联调前环境准备 | [2026-03-16-scripts目录与测试关联.md](./2026-03-16-scripts目录与测试关联.md) |
+| 2026-03-16 | scripts/test 测试用例目录：miniapp 小程序接口、web 管理端 | [2026-03-16-scripts目录与测试关联.md](./2026-03-16-scripts目录与测试关联.md) |
+| 2026-03-16 | scripts/test/process 流程测试：跨端多接口串联 | [2026-03-16-scripts目录与测试关联.md](./2026-03-16-scripts目录与测试关联.md) |
+| 2026-03-16 | pytest 架构、配置从项目读取、运行前显示测试环境 | [2026-03-16-scripts目录与测试关联.md](./2026-03-16-scripts目录与测试关联.md) |