# ZM

**Repository Path**: rlmyfs/ZM

## Basic Information

- **Project Name**: ZM
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-28
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 技术合伙人平台 · 工作区索引与文件规则

本文件是工作区的唯一入口：先看目录结构，再照命名规则执行。所有文件改动由 git 全程追溯，旧版本不删除。

## 一、目录结构

```
Z_H/
├── README.md          # 本文件（目录索引 + 命名规则，唯一入口）
├── docs/              # 文档
│   ├── 对外/          # 面向客户 / 合伙人的交付物
│   ├── 模板/          # 填写用模板（协议、结算单）
│   └── 内部/          # 定位、作战手册、完整对话记录、拍摄包、制作规范
├── model/             # 决策模型脚本（平台价值模型、账号名扫描）
├── tools/             # 处理脚本（命名用 snake_case）
└── assets/            # 素材（音视频、卡片、生成脚本）
```

`tasks/` 任务系统（往下一层）：
```
tasks/
├── 总任务清单.md      # 总表：T0~T6 目标 / 验收 / 状态（往下一层层拆）
├── 看板.html          # 自动生成：总任务 + 每天时间线 + 每步进度
└── YYYY-MM-DD/        # 每天一个文件夹，分任务 md 放这里（如 T2-01-xxx.md）
```

**换机无缝续接**：主脑记忆的真相源在 `docs/内部/主脑记忆.md`（随 git 同步）。
新电脑 `git clone` 后打开工作区，让新对话里的主脑读这份文件，即可像上次一样续上。
换机零差异的环境/插件/授权步骤见《技术合伙人平台-换机环境准备清单》。

## 二、命名规则

### 1. 文档类（docs/ 下，中文品牌全称）
```
技术合伙人平台-<分类词>-<主题>-v<版本>.docx/.html/.xlsx/.md
```
- 分隔符统一用 `-`（不用 `·`、`_`、`（）`）。
- 版本号写完整 `v1.0`，不用 `V1`。
- 括号内容并入主题主体，如「平台简介-三种合作身份」而不写"定稿"。
- 例：`技术合伙人平台-合作招募手册-v1.0.docx`
- 对外文档统一带品牌前缀 `技术合伙人平台-`，与对外形象一致。

### 2. 脚本类（.py，python snake_case）
```
<动词或名词>_<描述>.py
```
- 全小写 + 下划线，不用中文、不带版本号（版本靠 git）。
- 例：`fix_contract.py`、`platform_value_model.py`、`scan_forbidden_terms.py`。

### 3. 素材类（assets/ 下）
- 保留既有清晰前缀：`gen_`（生成脚本）、`seg/`（分段视频）、`sXX`（分段音频）、`cardXX`（卡片帧）、`tech_`（底图层）、`sliceX`（切片）。
- 临时/校验产物统一以 `_` 开头，并写入对应 `.gitignore`。

## 三、引用约定（重要，避免改一漏十）

- **文档间文字引用一律用"稳定名"**（品牌前缀 + 主题，不写版本号），例：`《技术合伙人平台-四平台账号配置清单》`。
- 版本升级时只改实际文件名，文字引用保持稳定，无需跟着改。
- 脚本内硬编码的文件路径，在文件移动 / 改名后**必须同步更新**（见 tools/*.py 顶部 PATH / 列表）。

## 四、多端协作提醒

- 本仓库可能多人多端同时写入；提交前先 `git fetch`，冲突时以 `git pull --rebase` 对齐，再 push。
- **自动同步（零操作铁律）**：每次对话开始，主脑先跑 `python tools/auto_sync.py check` 检查对端是否有新提交、落后则 rebase 拉取，再开始干活；每批交付后由主脑 `git add/commit/push ZM main` 自动推送。真人全程无需碰命令。
- 移动 / 改名文件一律用本规则的思路，git 会自动识别为 rename 保留历史，不要用内容复制粘贴的方式换代。
- 原始素材与工具全部保留入库，不删文件；`.gitignore` 只排除一次性临时质检产物。
- 一键脚本：`python tools/auto_sync.py`（auto / check / pull / push），封装 fetch + rebase 拉取 + 推送 + 状态提示；不自动提交未暂存改动，遇 rebase 冲突会停下请人处理。

## 五、任务执行与看板

- **总表**：`tasks/总任务清单.md`（T0~T6 目标 / 验收 / 状态）。
- **每天**：在 `tasks/YYYY-MM-DD/` 建当天文件夹，为当天推进的分任务各写一个 md；
  每步拆成「做什么 + 怎么做」，做一步勾一步（`- [x]`）。
- **每日复核**：分任务 md 底部填「做到哪了 / 是否完成 / 卡点」，只看做了没做，不追结果。
- **看板**：改完任务 md 后运行 `python tools/build_tasks_board.py` 重新生成 `tasks/看板.html`，
  用浏览器打开即看到总任务 + 每天时间线 + 每步进度。