docs: 新增工具发布投稿文档(说明书/测试报告 Word + 详细介绍 md)

按平台模板在 docs/upload 下新增工具说明书.docx、测试报告.docx、工具详细介绍.md。
This commit is contained in:
2026-06-26 17:07:48 +08:00
parent 12bfda653a
commit fd35fcee98
4 changed files with 89 additions and 0 deletions
+9
View File
@@ -1,5 +1,14 @@
# 项目上下文记录
## 2026-06-26:新增工具发布平台投稿文档(docs/upload)
- 按工具平台投稿模板新增 `docs/upload/` 三份文档:`工具说明书.docx`、`测试报告.docx`、`工具详细介绍.md`。
- Word 文档用 python-docx 生成(一次性脚本写在 tmp/docs 下,生成后已删除,依赖装在 .venv,未写入 requirements.txt)。设置了中文字体(微软雅黑)、标题/章节层级、蓝色表头底纹的表格样式。
- 工具说明书:介绍(名称/版本 3.0.0/作者 NIXEVOL)、安装与配置、使用指南(6 模块)、常见问题(含桌面版闪退=9081 占用、默认账号 root/Capacity 等)。
- 测试报告:介绍/测试目的/测试环境/测试用例/测试结果/改进规划/性能评估/总结;测试人员与联系信息留「(请填写)」占位,测试日期 2026-06-26。
- 内容均以实际项目为准;本机无 LibreOffice,无法自动渲染 PNG,改用 python-docx 回读校验结构(章节数、表格行列、表头正确)。
- 提示:`.docx`/`.md` 不在 .gitignore 忽略范围,会随仓库提交。
## 2026-06-26:新增使用说明 USAGE.md + 文档去 Metrix
- 新增根目录 `USAGE.md`(Web 端使用说明):登录(`root`/`Capacity`)、整体流程与数据处理管线 Mermaid 图、准备工作/各功能页/系统设置标签页/注意事项均用表格。内容以实际代码为准:处理阶段取 `FileWorkflow.vue` 的 `stageLabels`(远程下载/更新 CellData/授权校验/解压/转换 Excel/导入/运行脚本);系统设置 6 个标签(数据库、远程数据源、自动调度、规则映射、修改密码,及仅 Metrix 启用时的「数据源/仓库」);数据处理含容量数据 + CellData 两区、本地上传 vs 远程下载;任务锁串行、文件名时间戳、每目录 7 天、授权按数据日期等注意事项。`README.md` 增加指向 USAGE.md 的链接。