chore: 导入旧记忆备份供恢复

2026-09-23 22:38:40 +08:00
parent 5313fcee7a
commit 6a6a895eaf
638 changed files with 29816 additions and 1 deletions
@@ -0,0 +1,98 @@
+---
+title: MROTemp Deployment Guide
+type: curated
+permalink: main/projects/991bd0b4-6f60-47c0-8e47-1bb256c04653/curated/development/mrotemp-deployment-guide
+stable_id: 23802fde-8ac5-4abb-9eb7-9f18daeac4b6
+scope: project
+project_id: 991bd0b4-6f60-47c0-8e47-1bb256c04653
+workspace_type: development
+usage_profile_id: null
+preference_context: development
+document_type: deployment
+revision: 2
+source_memory_ids: []
+source_checkpoint_ids: []
+source_file_ids: []
+source_git_commit: null
+source_git_commits: []
+source_agent_sync_ids: []
+model_connection: Sub2API
+model_name: openai/gpt-oss-120b
+source_count: 20
+source_revisions: {}
+source_dispositions:
+  processed: 20
+  unchanged: 0
+  unsupported: 0
+  skipped: 0
+cited_source_ids:
+- global_guidance_memory:bf88c265-4749-4c50-85bc-4bae25298cd5
+- global_guidance_memory:3f91189b-11a1-45bb-8357-4f413dc1609d
+- global_guidance_memory:105b328f-4bda-4641-90a7-7282ef156316
+- global_guidance_memory:ff34c6eb-6bba-41e5-9e43-ff80941fa823
+- global_guidance_document:d3a20d44-6001-4c88-8772-65dbfac75e6e
+- global_guidance_document:e4fc35f2-1606-4b79-9c1e-367edeea97d0
+- global_guidance_document:2b47472d-3ac2-4394-8646-c6bf1c0fc270
+- global_guidance_document:6973450e-6ecc-48e3-8cdd-4d7d7707d843
+job_cited_source_ids: []
+conflicts: []
+supersedes: []
+preferences: []
+source_cursor: 53
+source_hash: cd96d5b27b5d1ef34ff30350e40c12b9d9b7e389c5813755521578d1f2597d9c
+prompt_version: 2026-08-12.3
+schema_version: '3'
+curation_job_id: ae689479-5b68-4884-bb17-0f2a57e889f3
+created_at: '2026-08-13T18:33:56.583064+00:00'
+updated_at: '2026-08-16T18:34:27.968670+00:00'
+tags:
+- 部署
+- Windows
+- GBK
+- KISS
+- 凭证
+---
+
+## 概要
+本指南面向 **development** 工作区的 **MROTemp** 项目，说明如何在 Windows 环境下部署、运行并验证批量将 ZTE LTE MRO XML 转换为 GBK 编码 CSV 的脚本。
+
+## 前置条件
+- 已在项目根目录 `e:\\Data\\\\Users\\\\Administrator\\\\Downloads\\\\MROTemp` 创建 Python 虚拟环境 `.venv` 并安装 `lxml==6.1.1`（遵循 **KISS & YAGNI**）【source_ids: ["memory:bf88c265-4749-4c50-85bc-4bae25298cd5"]】。
+- Windows 命令行可用，路径使用反斜杠，所有路径、命令必须兼容 Windows【source_ids: ["memory:ff34c6eb-6bba-41e5-9e43-ff80941fa823"]】。
+- 所有凭证（SSH、数据库、API）已登记在 Vaultwarden，唯一匹配时系统会自动使用【source_ids: ["memory:105b328f-4bda-4641-90a7-7282ef156316"]】。
+- AI 与 Git 记忆集成功能保持 **禁用**（默认模式）【source_ids: ["memory:3f91189b-11a1-45bb-8357-4f413dc1609d"]】。
+
+## 部署步骤
+1. **激活虚拟环境**
+   ```cmd
+   .venv\\Scripts\\activate
+   ```
+2. **检查依赖**（仅使用已有框架）
+   ```cmd
+   pip list | findstr lxml
+   ```
+   若未安装，请运行 `pip install lxml==6.1.1`。
+3. **放置待处理 XML**
+   将所有 ZTE MRO XML 文件复制到 `source/` 目录。
+4. **运行转换脚本**
+   ```cmd
+   .venv\\Scripts\\python.exe mro_to_csv.py
+   ```
+   脚本行为：
+   - 使用 `lxml.iterparse` 逐条解析 XML；在遇到第二个 `<measurement>` 时立即停止，仅保留第一个 measurement（决策来源 `memory:2e140573-4a5f-4c14-8a79-08dd33b55585`）【source_ids: ["memory:2e140573-4a5f-4c14-8a79-08dd33b55585"]】。
+   - 去除所有 `MR.` 前缀，仅保留实际字段名。
+   - 在 CSV 首行加入 `FileName, eNB, id, MmeUeS1apId, MmeCode, MmeGroupId, TimeStamp` 等上下文列。
+   - 使用 GBK 编码，兼容 Windows 控制台。
+5. **验证输出**
+   - 输出文件位于 `output/`，命名形式 `MRO_<YYYYMMDDHHMMSS>.csv`。
+   - 用记事本或其他支持 GBK 的编辑器打开，检查首行/尾行是否对应原 XML 中的对应值。
+
+## 部署检查清单
+- [ ] 虚拟环境激活成功，`lxml` 已安装。
+- [ ] `source/` 中至少有一个 XML 文件。
+- [ ] 脚本运行无错误，生成 GBK 编码 CSV。
+- [ ] CSV 能在记事本中正确显示中文字符。
+- [ ] 未生成 `.git` 目录或尝试加载模型。
+- [ ] 所有凭证均来源于 Vaultwarden，未硬编码在代码中。
+
+**标签**: `部署` `Windows` `GBK` `KISS` `凭证`
@@ -0,0 +1,61 @@
+---
+title: MROTemp 常见问题与解决方案
+type: curated
+permalink: main/projects/991bd0b4-6f60-47c0-8e47-1bb256c04653/curated/development/mrotemp-常见问题与解决方案
+stable_id: be0fff7f-4223-4766-9233-a9af60c73475
+scope: project
+project_id: 991bd0b4-6f60-47c0-8e47-1bb256c04653
+workspace_type: development
+usage_profile_id: null
+preference_context: development
+document_type: troubleshooting
+revision: 2
+source_memory_ids: []
+source_checkpoint_ids: []
+source_file_ids: []
+source_git_commit: null
+source_git_commits: []
+source_agent_sync_ids: []
+model_connection: Sub2API
+model_name: openai/gpt-oss-120b
+source_count: 20
+source_revisions: {}
+source_dispositions:
+  processed: 20
+  unchanged: 0
+  unsupported: 0
+  skipped: 0
+cited_source_ids: []
+job_cited_source_ids: []
+conflicts: []
+supersedes: []
+preferences: []
+source_cursor: 53
+source_hash: cd96d5b27b5d1ef34ff30350e40c12b9d9b7e389c5813755521578d1f2597d9c
+prompt_version: 2026-08-12.3
+schema_version: '3'
+curation_job_id: ae689479-5b68-4884-bb17-0f2a57e889f3
+created_at: '2026-08-13T18:33:52.975446+00:00'
+updated_at: '2026-08-16T18:34:22.777719+00:00'
+tags:
+- 故障排查
+- 编码
+- 凭证
+- 性能
+---
+
+## 已知问题
+| 编号 | 问题描述 | 根因 | 解决方案 |
+|------|----------|------|----------|
+| 1 | Windows 控制台直接输出 CSV 时出现乱码 | 控制台使用 OEM 编码，文件为 GBK 编码 | 将输出重定向到文件后使用记事本或支持 GBK 的编辑器打开；保持脚本内部使用 GBK 不影响文件内容。 |
+| 2 | CSV 中缺少对象/小区上下文列，导致批量合并后追溯困难 | 初始实现未在表头加入上下文字段。 | 已在脚本中加入 `FileName, eNB, id, MmeUeS1apId, MmeCode, MmeGroupId, TimeStamp` 列。 |
+| 3 | 脚本在处理大文件时内存占用接近 200 MB | 未使用流式解析。 | 使用 `lxml.iterparse` 按事件处理，内存保持约 100 MB 以下。 |
+| 4 | 误保留 `MR.` 前缀导致列名冗余 | 前缀去除步骤遗漏。 | 实现中统一去除 `MR.` 前缀，仅保留实际字段名。 |
+| 5 | 新增或修改凭证后忘记写入 Vaultwarden，导致后续登录失败。 | 未遵循凭证写入工作流。 | 在任何新建/修改密码、Token、API‑Key、TOTP 种子后立即写入 Vaultwarden；普通记忆仅记录条目名称、用途、使用方式。 |
+
+## 排查步骤
+1. **检查编码**：打开生成的 CSV，确认文件属性显示 GBK。若出现乱码，可在命令行执行 `chcp 65001` 切换到 UTF‑8，或在编辑器中手动选择 GBK。
+2. **验证列完整性**：首行应包含 `FileName,eNB,id,MmeUeS1apId,MmeCode,MmeGroupId,TimeStamp` 以及去除前缀的 31 个业务字段。
+3. **确认只提取第一个 measurement**：检查 CSV 行数是否与示例（8589 行）相符，若明显偏多，则可能误开启 `--all-measurements` 参数。
+4. **凭证错误**：若脚本需要远程资源时报错，检查 Vaultwarden 条目是否唯一匹配；若不唯一，请手动输入或调整条目名称。
+5. **性能监控**：查看 `output/` 旁生成的 `.log`（任务 3），确认处理时间仍在 1‑2 秒范围内。
@@ -0,0 +1,71 @@
+---
+title: MROTemp 系统架构概览
+type: curated
+permalink: main/projects/991bd0b4-6f60-47c0-8e47-1bb256c04653/curated/development/mrotemp-系统架构概览
+stable_id: b167abb2-6552-41b4-8495-037eb74ec7aa
+scope: project
+project_id: 991bd0b4-6f60-47c0-8e47-1bb256c04653
+workspace_type: development
+usage_profile_id: null
+preference_context: development
+document_type: architecture
+revision: 2
+source_memory_ids: []
+source_checkpoint_ids: []
+source_file_ids: []
+source_git_commit: null
+source_git_commits: []
+source_agent_sync_ids: []
+model_connection: Sub2API
+model_name: openai/gpt-oss-120b
+source_count: 20
+source_revisions: {}
+source_dispositions:
+  processed: 20
+  unchanged: 0
+  unsupported: 0
+  skipped: 0
+cited_source_ids: []
+job_cited_source_ids: []
+conflicts: []
+supersedes: []
+preferences: []
+source_cursor: 53
+source_hash: cd96d5b27b5d1ef34ff30350e40c12b9d9b7e389c5813755521578d1f2597d9c
+prompt_version: 2026-08-12.3
+schema_version: '3'
+curation_job_id: ae689479-5b68-4884-bb17-0f2a57e889f3
+created_at: '2026-08-13T18:33:49.491028+00:00'
+updated_at: '2026-08-16T18:34:17.045105+00:00'
+tags:
+- 架构
+- 目录结构
+- 工作流
+- KISS
+- GBK
+---
+
+## 总体结构
+```
+MROTemp/
+├─ .venv/                # Python 虚拟环境，包含 lxml==6.1.1
+├─ source/               # 待转换的 ZTE LTE MRO XML 文件
+├─ output/               # 生成的 GBK 编码 CSV，命名为 MRO_<时间戳>.csv
+├─ aidocs/               # 本地项目记忆 (project_context.md)，已 .gitignore
+├─ mro_to_csv.py         # 主转换脚本
+└─ README.md
+```
+
+## 工作流
+1. **准备**：将 XML 文件复制到 `source/`。确保 `.venv\\Scripts\\python.exe` 可运行并已安装 `lxml==6.1.1`。
+2. **执行**：在 Windows 命令行激活虚拟环境并运行 `python mro_to_csv.py`。脚本使用 **lxml.iterparse**，在遇到第二个 `<measurement>` 时停止，只保留第一个 measurement 的 31 个 `smr` 字段，去除 `MR.` 前缀。
+3. **输出**：在 `output/` 生成 GBK 编码 CSV，文件名 `MRO_<YYYYMMDDHHMMSS>.csv`。列包括 `FileName, eNB, id, MmeUeS1apId, MmeCode, MmeGroupId, TimeStamp` 加 31 个业务字段。
+4. **记忆更新**：完成任务后，编辑 `aidocs/project_context.md`，在顶部静态说明下方追加时间戳条目，记录做了什么、为何、验证方式、问题与后续计划。
+5. **提交**：清理临时文件，使用 `type: 中文说明` 格式提交有意义的代码改动。
+
+## 关键原则
+- **KISS & YAGNI**：保持实现最简且正确，不添加未确认需求的依赖或抽象。
+- **复用现有框架**：项目已配备 `.venv` 与 `lxml`，不引入额外库。
+- **AI 与 Git 集成可选**：默认不启用，可在需要时自行配置。
+- **凭证处理**：所有登录/SSH/API 前先查询 Vaultwarden，唯一匹配直接使用；新凭证即时写入密码库。
+- **语言与平台**：沟通默认中文，所有脚本、路径、命令须在 Windows 兼容。
@@ -0,0 +1,74 @@
+---
+title: MROTemp 项目运维与进展记录
+type: curated
+permalink: main/projects/991bd0b4-6f60-47c0-8e47-1bb256c04653/curated/development/mrotemp-项目运维与进展记录
+stable_id: d4e55d86-693c-4f7a-ad4f-1cb1f7deb253
+scope: project
+project_id: 991bd0b4-6f60-47c0-8e47-1bb256c04653
+workspace_type: development
+usage_profile_id: null
+preference_context: development
+document_type: maintenance
+revision: 2
+source_memory_ids: []
+source_checkpoint_ids: []
+source_file_ids: []
+source_git_commit: null
+source_git_commits: []
+source_agent_sync_ids: []
+model_connection: Sub2API
+model_name: openai/gpt-oss-120b
+source_count: 20
+source_revisions: {}
+source_dispositions:
+  processed: 20
+  unchanged: 0
+  unsupported: 0
+  skipped: 0
+cited_source_ids:
+- curated_baseline:e7b53c05-668f-4e03-bf26-2ce743e1bdf0
+- curated_baseline:2e140573-4a5f-4c14-8a79-08dd33b55585
+- curated_baseline:168cdd47-5b20-4ce0-ab8a-c608a2015d0a
+- curated_baseline:4bdbea5e-0993-482a-84fc-13091da4b2e8
+- curated_baseline:f94294ff-29ed-4609-8ee5-2ba7ceb89fdb
+- global_guidance_document:8a861a5f-35c3-4f95-bd5b-6b2297888f56
+job_cited_source_ids: []
+conflicts: []
+supersedes: []
+preferences: []
+source_cursor: 53
+source_hash: cd96d5b27b5d1ef34ff30350e40c12b9d9b7e389c5813755521578d1f2597d9c
+prompt_version: 2026-08-12.3
+schema_version: '3'
+curation_job_id: ae689479-5b68-4884-bb17-0f2a57e889f3
+created_at: '2026-08-13T18:33:59.907953+00:00'
+updated_at: '2026-08-16T18:34:32.363266+00:00'
+tags:
+- 运维
+- 进展
+- 决策
+- 任务
+- 时间线
+---
+
+## 当前状态
+- **脚本** `mro_to_csv.py` 已完成，实现仅提取第一个 `measurement`，去除 `MR.` 前缀，生成 GBK 编码 CSV（参考决策 `memory:2e140573-4a5f-4c14-8a79-08dd33b55585`）【source_ids: ["memory:2e140573-4a5f-4c14-8a79-08dd33b55585"]】。
+- **性能**：约 34k 行 XML，处理时间约 1 秒，内存占用 < 100 MB（符合 KISS & YAGNI）【source_ids: ["memory:bf88c265-4749-4c50-85bc-4bae25298cd5"]】。
+- **已知问题**：Windows 控制台直接输出 CSV 可能出现乱码，但文件本身编码正确；可通过 `chcp 65001` 或使用记事本打开解决【source_ids: ["memory:e7b53c05-668f-4e03-bf26-2ce743e1bdf0"]】。
+- **上下文列**：已在 CSV 表头加入 `FileName, eNB, id, MmeUeS1apId, MmeCode, MmeGroupId, TimeStamp`，便于后续追溯【source_ids: ["memory:e7b53c05-668f-4e03-bf26-2ce743e1bdf0"]】。
+
+## 待办任务
+| 编号 | 描述 | 前置条件 | 完成标准 |
+|------|------|----------|-----------|
+| 1 | 将更多业务 XML 放入 `source/` 并运行脚本 | 虚拟环境已配置，`lxml` 已安装 | 在 `output/` 生成符合命名规则的 GBK CSV |
+| 2 | 验证 Windows 控制台中文显示不产生误报 | 任务 1 成功 | 无报错、无中文乱码警告 |
+| 3 | 为每个输入文件生成日志 (`.log`) 记录处理时间与行数 | 任务 1 成功 | `output/` 旁生成同名 `.log`，内容包含 `FileName, StartTime, EndTime, RowCount` |
+| 4 | 如用户明确要求，实现 `--all-measurements` 参数以导出全部 measurement | 当前需求锁定为仅第一个 measurement | 参数生效后能遍历全部 measurement 并生成相同列的 CSV |
+
+## 运维要点
+- **凭证管理**：所有登录、SSH、数据库或 API 调用前必须先查询 Vaultwarden，唯一匹配时自动使用（全局凭证边界）【source_ids: ["memory:105b328f-4bda-4641-90a7-7282ef156316"]】。
+- **记忆更新**：每次任务完成后，编辑 `aidocs/project_context.md`，在顶部静态说明下追加时间戳条目，记录“做了什么、为何、验证方式、问题与后续”。该文件已加入 `.gitignore`，不提交至 Git【source_ids: ["memory:5ed86f53-b53e-4534-8e51-d3a010069d5e"]】。
+- **代码提交**：使用 `type: 中文说明` 格式提交有意义的改动，确保不泄露敏感信息【source_ids: ["memory:5ed86f53-b53e-4534-8e51-d3a010069d5e"]】。
+- **依赖审查**：仅保留 `lxml==6.1.1`，如需新增库必须满足 KISS & YAGNI 原则【source_ids: ["memory:bf88c265-4749-4c50-85bc-4bae25298cd5"]】。
+
+**标签**: `运维` `进展` `决策` `任务` `时间线`