# 知识记录格式规范

## 文件结构

```
~/myWorkAssistantCrossagentYm/
├── userProfile.md          ← 用户画像（小文件，每次必加载）
├── domains/                ← 领域知识目录
│   ├── index.md            ← 领域索引（小文件，每次必加载）
│   ├── [领域1].md          ← 领域知识文件（按需加载）
│   ├── [领域2].md
│   └── ...
├── changelog.md            ← 变更日志（不加载，仅供回溯）
├── config.txt              ← 配置
└── errorRecord.md          ← 错误日志
```

## userProfile.md 格式

```markdown
# 用户画像

### 职位与角色
- 技术部门经理 / 带团队

### 核心职责
- 新媒体业务提效产品创新（抖音、快手、小红书）
- 内部业务部门提效系统开发

### 负责业务
- 商家侧提效产品
- 团长侧提效产品（兴选官 SaaS）

### 工作风格与偏好
- 偏好桌面端产品化方案（Electron）
- 喜欢结构化输出（表格呈现关键数据）
- 使用中文沟通，偏好简洁表达

### 技术栈
- 后端：Spring Boot 2.6+、Swagger 2
- 桌面端：Electron、EasyClaw
- 开发语言：Java（主）、Python（脚本）
```

## domains/index.md 格式

```markdown
# 领域索引

### 新媒体电商提效
> 围绕抖音、快手、小红书等新媒体平台，为商家、团长、达人提供业务效率工具
**关键词：** 抖音, 快手, 小红书, 商家, 团长, 达人, 电商, 提效
**文件：** 新媒体电商提效.md

### 兴选官 SaaS 系统
> 面向团长和达人的提效 SaaS，覆盖授权、选品、达人管理、寄样跟踪、带货出单全链路
**关键词：** 兴选官, SaaS, 团长, 达人, CRM, 寄样, 选品, 百应ID, SSO, 权限, QPS
**文件：** 兴选官SaaS系统.md

### 抖音种草达人匹配
> 服务商为商家快速找到匹配的种草达人，提升寻人效率和合作转化率
**关键词：** 种草, 达人匹配, 粉丝画像, 蝉妈妈, 达人CRM, 标签, 筛选
**文件：** 抖音种草达人匹配.md
```

## domains/[领域名].md 格式

```markdown
# 新媒体电商提效

> 领域描述：围绕抖音、快手、小红书等新媒体平台，为商家、团长、达人三类角色提供业务效率工具

**关键诀窍：**
- 业务知识储备四大类：平台规则与生态、电商链路、角色运营、合规风控
- 佣金/结算是高风险区——涉及多方分账，理解偏差会导致财务事故
- 平台规则变化快，需安排专人每周跟踪形成内部速报
- 三类角色核心关注点：商家看 ROI、团长看人效和规模、达人看省事和赚钱
```

## changelog.md 格式

```markdown
# 变更日志

### 2026-05-29
- [新增] 用户画像：技术部门经理，从事新媒体提效产品
- [新增] 兴选官SaaS：百应ID固定，应作为系统主键
- [更新] 用户画像：补充工作风格偏好和技术栈
```

**日志管理规则：**
- 保留最近 30 天的详细日志
- 超过 30 天的日志压缩为月度摘要（如 `### 2026-04 摘要：新增X条知识，更新Y条`）
- 此文件不参与对话加载，仅在用户需要回溯时查阅

## errorRecord.md 格式

```markdown
# 错误记录

- [2026-05-28 14:30] [文件读取] userProfile.md 解析失败 | 上下文：用户提问关于达人筛选
- [2026-05-29 09:15] [文件写入] 写入 domains/ 失败：目标目录不存在 | 上下文：首次创建领域文件
```

## config.txt 格式

```
autoUpdate=on
```

| 字段 | 值 | 说明 |
|------|------|------|
| `autoUpdate` | `on` | 自动更新知识（默认） |
| `autoUpdate` | `off` | 手动确认模式，每次写入需用户确认 |

文件不存在时视为 `autoUpdate=on`。

## 格式规则

1. **userProfile.md**：每条信息用 `-` 开头，一行一条，保持精炼（目标 < 2KB）
2. **index.md**：每个领域一个 `###` 标题 + 描述 + 关键词 + 文件路径，保持精炼（目标 < 2KB）
3. **领域文件**：每个领域一个文件，关键诀窍用无序列表，每条一句话说清
4. **changelog.md**：按日期倒序（最新在前），每条用 `[操作类型] 类别：内容` 格式
5. **精炼原则**：每条记录控制在一行，不超过50字

---

## 🔄 迁移指南（从旧版 knowledgeRecord.md 拆分）

如果 `~/myWorkAssistantCrossagentYm/` 下存在旧版 `knowledgeRecord.md` 单文件，首次使用时执行以下迁移：

1. 从 `knowledgeRecord.md` 中提取 `## 用户画像` 部分 → 写入 `userProfile.md`
2. 从 `## 领域知识` 中提取每个 `### 领域名` 部分 → 各创建一个 `domains/[领域名].md` 文件
3. 为每个领域提取关键词 → 创建 `domains/index.md` 索引
4. 从 `## 变更日志` 部分 → 写入 `changelog.md`
5. 迁移完成后，将 `knowledgeRecord.md` 重命名为 `knowledgeRecord.md.bak` 保留备份
6. 后续对话使用新文件结构

**迁移时自动执行敏感信息检查**，确保不将敏感数据带入新文件。