更新

wenzijiaoben/.workbuddy/memory/2026-08-21.md

@@ -0,0 +1,42 @@
+# 2026-08-21 工作日志
+
+## universal_tool.py 改造（两项）
+
+### 1. 直接读取 xlsx，不再转 csv
+- 新增 `read_table(filepath)` 统一入口 + `_read_xlsx` / `_read_csv`。(`read_csv` 兼容别名后已删除)
+- `find_file` 改为优先 `.xlsx`，其次 `.csv`。
+- `get_csv_list_data` / `get_csv_table_data` / `get_player_names` 去掉 `.csv` 限制，支持任意表格格式。
+- `build_document` 删除 `xlsx_to_csv_batch` 自动转换逻辑，直接从 config_dir / csv_dir 读 xlsx。
+- `xlsx_to_csv_batch` 函数定义后已在第二轮清理中删除。
+
+### 2. Word 自动编号替代硬编码数字
+- 新增 `_get_numbering_element` / `_create_decimal_numbering` / `_apply_numbering`。
+- 重写 `add_numbered_items`：每次调用新建独立 numId（decimal, "1." 格式），段落用 numPr，文本不再带 "1." 前缀。
+- 效果：在 Word 中增删条目后编号自动重排。
+- 章节标题 `add_section_heading` 仍用硬编码中文数字（"一、""二、"），因章节固定不增删。
+
+## 验证
+- 用 managed python venv (3.13.12) + python-docx/openpyxl 实测：
+  - 6 个编号段落均带 numPr；2 个章节用 2 个不同 numId 独立从 1 计数；无硬编码数字前缀。
+- venv 位置：C:\Users\Administrator\.workbuddy\binaries\python\envs\default
+
+## 项目清理（第二轮：删无用 + 更新文档）
+
+### 删除
+- `py/generate_doc.py`（旧硬编码版，路径写死）、`py/xlsx_to_csv.py`（不再需要转 csv）、`py/__pycache__`。
+- 清理后 `py/` 仅剩 `universal_tool.py`。
+
+### 清理 universal_tool.py
+- 删除 `xlsx_to_csv_batch` 函数、`read_csv` 兼容别名、`import glob`。
+- 更新文件头/章节注释：去除 "CSV 缓存" 说法，注明直接读 xlsx、Word 自动编号。
+- py_compile + import 验证通过（read_table 存在，xlsx_to_csv_batch/read_csv 已无）。
+
+### 更新 memories/*.json
+- `data_source_mapping.json`：`csv_base_dir`→`table_base_dir`，各 source `.csv`→`.xlsx/csv`，`csv_format`→`table_format` 补充 xlsx 直读。
+- `project_config.json`：去掉被删脚本引用，路径改为示例说明，补充 data_reading 策略。
+- `system_prompts.json`：`source_file`→`source_file_example` + note（自动解析说明）。
+- `icon_resource_mapping.json`：`base_dir`→示例，`csv_field`→`table_field` (.xlsx/csv)。
+- `doc_format_spec.json`：标题改示例标注（格式规范本身通用，numbering 已是 Word 自动编号）。
+
+### 更新 使用请看.txt
+- 改为准确说明：自动扫描项目结构、直接读 xlsx、Word 自动编号、memories 仅为参考不被脚本读取。

wenzijiaoben/.workbuddy/memory/MEMORY.md

@@ -0,0 +1,15 @@
+# 项目长期记忆
+
+## 项目概述
+游戏文字脚本文档生成工具：扫描项目目录，从配置表(xlsx/csv)和 GameTextConst.cs 提取文本，生成 Word 文档。
+入口：`py/universal_tool.py`（通用版）；`py/generate_doc.py` 为早期硬编码版（路径写死，仅参考）。
+
+## 关键约定
+- **数据读取**：直接读取 xlsx（优先），无需先转 csv。表头结构固定为第3行英文字段名、第4行起数据。
+- **文档编号**：正文条目用 Word 自动编号（numPr + decimal），每章节独立 numId 从 1 开始；段落文本不硬编码 "1."，便于增删后自动重排。章节标题仍用硬编码中文数字。
+- **字体**：标题宋体二号加粗居中；章节标题/正文仿宋四号。
+- **图标**：表格图标列高 3cm 锁定纵横比，按 atlas_* 目录匹配，支持末尾数字补零。
+
+## 环境
+- 推荐用 managed python 3.13.12 + venv（C:\Users\Administrator\.workbuddy\binaries\python\envs\default），依赖：python-docx、openpyxl。
+- 项目配置记忆在 `memories/*.json`（数据源映射、格式规范、图标映射、项目配置）。