diff --git a/README.md b/README.md index e7c3e3a..79e47ca 100644 --- a/README.md +++ b/README.md @@ -113,16 +113,36 @@ codex mcp add limbus --env PYTHONUTF8=1 -- D:\lc-mcp\vendor\aalc\.venv\Scripts\p ## 无人值守 +有两套独立的自动化,按需要各自启用: + +### 1. 刷取循环(打关卡) + `scripts/auto_cycle.py` 每次跑一轮,流程是:刷材料(daily)→ 镜牢(`--mirror N`)→ 把队内人格升级、同步到 `--target`。 AALC 卡死时,脚本会停掉任务并重跑一次。每轮在 `~/lc_mcp/cycles/` 写一份 `cycle_*.log` 和一份 `cycle_*.json` 报告。 ```powershell # 先手动跑一轮确认 vendor\aalc\.venv\Scripts\python.exe scripts\auto_cycle.py --mirror 1 -# 再注册计划任务: 每 5 分钟的会话看门狗 + 每天 05:30 一轮 -powershell -ExecutionPolicy Bypass -File scripts\install_unattended.ps1 -At 05:30 -Mirror 1 +# 再注册计划任务: 每 1 分钟的会话看门狗 + 每 N 小时一轮 +powershell -ExecutionPolicy Bypass -File scripts\install_unattended.ps1 -EveryHours 2.5 -Mirror 1 ``` +### 2. 只需挂机攒模块(不打任何关卡) + +`scripts/convert_modules.py` 到点自己启动游戏 → 把体力合成为模块 → 关掉游戏。 +每 4 小时一轮,用 `scripts/install_convert_task.ps1` 注册。 + +```powershell +vendor\aalc\.venv\Scripts\python.exe scripts\convert_modules.py # 手动跑一次 +powershell -ExecutionPolicy Bypass -File scripts\install_convert_task.ps1 -EveryHours 4 +``` + +看历史:`python scripts/modules_status.py` + +**⚠️ 挂机值守前先读 [`docs/WATCH.md`](docs/WATCH.md)** —— 那里记着环境事实、 +界面坐标、狂气的三道防线、六种已知失败模式及处置,以及几条踩过的坑 +(比如 OCR 会把 `LUNACY` 读成 `UNACY`,曾让整条狂气防线静默失效)。 + `scripts/levelup.py` 和 `auto_cycle.py` 里的坐标都按 1600×900 客户区书写,运行时会按实际客户区大小缩放。 ## 环境变量 diff --git a/tests/test_doc_refs.py b/tests/test_doc_refs.py new file mode 100644 index 0000000..9e03fda --- /dev/null +++ b/tests/test_doc_refs.py @@ -0,0 +1,54 @@ +# -*- coding: utf-8 -*- +"""文档里引用的脚本/文件必须真实存在。 + +文档漂移是最难发现的一类问题: README 说"跑 install_xxx.ps1",而那个脚本早改名了 —— +读到的人会直接卡住, 而代码测试全绿。这个仓库的 README 就曾经写着 +"每 5 分钟的会话看门狗 + 每天 05:30 一轮", 而实际早改成了 1 分钟 + 每 N 小时一轮。 + +这里只做机械检查: 文档中形如 scripts/xxx 或 docs/xxx.md 的路径必须存在。 +判断"描述是否过时"做不到, 但"引用的东西还在不在"是能查的。 +""" +import re +import unittest +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +DOCS = ['README.md', 'docs/WATCH.md'] +# 只认仓库内的 scripts/ 与 docs/ 路径。 +# 不要收 lc_mcp/ —— 文档里的 ~/lc_mcp/modules/convert.log 之类是**运行期产物**, +# 在用户主目录下, 本来就不该出现在仓库里(第一版这么写导致误报)。 +PATH_RE = re.compile(r'\b((?:scripts|docs)/[A-Za-z0-9_./-]+\.\w+)\b') + + +class DocReferenceTest(unittest.TestCase): + + def refs(self, path): + text = (ROOT / path).read_text(encoding='utf-8') + return sorted(set(PATH_RE.findall(text))) + + def test_docs_exist(self): + for d in DOCS: + self.assertTrue((ROOT / d).exists(), '%s 不见了' % d) + + def test_referenced_files_exist(self): + missing = [] + for d in DOCS: + for ref in self.refs(d): + if not (ROOT / ref).exists(): + missing.append('%s -> %s' % (d, ref)) + self.assertFalse(missing, + '文档引用了不存在的文件:\n ' + '\n '.join(missing)) + + def test_readme_points_at_the_watch_guide(self): + """值守手册必须能从入口找到, 否则写了等于没写。""" + text = (ROOT / 'README.md').read_text(encoding='utf-8') + self.assertIn('docs/WATCH.md', text) + + def test_watch_guide_mentions_both_tasks(self): + text = (ROOT / 'docs/WATCH.md').read_text(encoding='utf-8') + for name in ('LcMCPConvertModules', 'LcKeepDisplay', 'LcMCPServer', 'LcMCPDailyCycle'): + self.assertIn(name, text, '值守手册没提到 %s' % name) + + +if __name__ == '__main__': + unittest.main()