feat: autonomous SOP refactor + helper.py with auto date/numbering

- Refactored autonomous_operation_sop.md with clearer path warnings and workflow
- Added helper.py: complete_task() auto-prepends R-number + date to history
- Updated scheduled_task_sop.md and web_setup_sop.md

memory/autonomous_operation_sop/helper.py

@@ -0,0 +1,143 @@
+"""
+autonomous_task.py - 自主行动任务管理API
+放置: memory/autonomous_operation_sop/
+用法: import autonomous_task (或 from autonomous_operation_sop import autonomous_task)
+
+4个函数:
+  get_todo()        → 返回TODO内容
+  get_history(n)    → 返回最近n条历史
+  complete_task()   → 移报告+编号+写history+返回改TODO指令
+  set_todo()        → 返回TODO真实路径
+"""
+
+import os
+import re
+import shutil
+from pathlib import Path
+from datetime import datetime
+
+# ── 路径计算（基于模块自身位置） ──
+_MODULE_DIR = Path(__file__).resolve().parent          # memory/autonomous_operation_sop/
+_MEMORY_DIR = _MODULE_DIR.parent                       # memory/
+_AGENT_DIR = _MEMORY_DIR.parent                        # GenericAgent/
+_TEMP_DIR = _AGENT_DIR / "temp"                        # GenericAgent/temp/
+_REPORTS_DIR = _TEMP_DIR / "autonomous_reports"
+_HISTORY_FILE = _REPORTS_DIR / "history.txt"
+_TODO_FILE = _TEMP_DIR / "TODO.txt"
+
+
+def _next_report_number() -> int:
+    """扫 history.txt 第一行提取最大 RXX 编号，返回下一个"""
+    if not _HISTORY_FILE.exists():
+        return 1
+    with open(_HISTORY_FILE, "r", encoding="utf-8") as f:
+        content = f.read()
+    # 匹配所有 R 后跟数字的模式
+    nums = [int(m) for m in re.findall(r'R(\d+)', content)]
+    if not nums:
+        return 1
+    return max(nums) + 1
+
+
+def get_todo() -> str:
+    """返回 TODO.txt 的内容。若文件不存在返回提示。"""
+    if not _TODO_FILE.exists():
+        return f"[autonomous_task] TODO.txt 不存在，路径: {_TODO_FILE}"
+    with open(_TODO_FILE, "r", encoding="utf-8") as f:
+        return f.read()
+
+
+def get_history(n: int = 20) -> str:
+    """返回 history.txt 的前 n 行（最新在前）。"""
+    if not _HISTORY_FILE.exists():
+        return f"[autonomous_task] history.txt 不存在，路径: {_HISTORY_FILE}"
+    with open(_HISTORY_FILE, "r", encoding="utf-8") as f:
+        lines = f.readlines()
+    return "".join(lines[:n])
+
+
+def set_todo(*args, **kwargs) -> str:
+    """返回 TODO.txt 的真实绝对路径，供 agent/子agent 自行读写。"""
+    return f'路径: {str(_TODO_FILE)}'
+
+
+def complete_task(taskname: str, historyline: str, report_path: str) -> str:
+    """
+    完成任务的原子操作：
+    1. 移动 report_path → autonomous_reports/R{XX}_{taskname}.md（自动编号）
+    2. prepend historyline 到 history.txt（校验必须单行）
+    3. 返回字符串指示 agent 自己去改 TODO
+
+    Args:
+        taskname: 任务简短名称（用于报告文件名，如 "晨间简报"）
+        historyline: 历史记录内容（必须单行，日期自动添加，如 "工程 | 晨间简报 | 完成7模块聚合"）
+        report_path: agent 已写好的报告文件路径（绝对或相对于cwd）
+
+    Returns:
+        成功消息 + 改TODO指令，或错误消息
+    """
+    errors = []
+
+    # ── 校验 ──
+    if "\n" in historyline.strip():
+        return "[ERROR] historyline 必须是单行，不能包含换行符"
+
+    report = Path(report_path).resolve()
+    if not report.exists():
+        return f"[ERROR] 报告文件不存在: {report_path}"
+
+    if not _REPORTS_DIR.exists():
+        _REPORTS_DIR.mkdir(parents=True, exist_ok=True)
+
+    # ── 1. 移动报告 ──
+    rnum = _next_report_number()
+    # 清理 taskname 中的非法文件名字符
+    safe_name = re.sub(r'[<>:"/\\|?*]', '_', taskname).strip()
+    dest_name = f"R{rnum}_{safe_name}.md"
+    dest_path = _REPORTS_DIR / dest_name
+
+    try:
+        shutil.move(str(report), str(dest_path))
+    except Exception as e:
+        return f"[ERROR] 移动报告失败: {e}"
+
+    # ── 2. prepend history ──
+    # 自动加编号 + 日期（剥离 agent 可能已写的编号/日期，统一重建）
+    line = historyline.strip()
+    line = re.sub(r'^R\d+\s*\|\s*', '', line)           # 剥离 R 编号
+    line = re.sub(r'^\d{4}-\d{2}-\d{2}\s*\|\s*', '', line)  # 剥离日期
+    today = datetime.now().strftime('%Y-%m-%d')
+    line = f"R{rnum} | {today} | {line}"
+
+    try:
+        existing = ""
+        if _HISTORY_FILE.exists():
+            with open(_HISTORY_FILE, "r", encoding="utf-8") as f:
+                existing = f.read()
+        with open(_HISTORY_FILE, "w", encoding="utf-8") as f:
+            f.write(line + "\n" + existing)
+    except Exception as e:
+        # 回滚：把报告移回去
+        try:
+            shutil.move(str(dest_path), str(report))
+        except:
+            pass
+        return f"[ERROR] 写入 history 失败: {e}（报告已回滚）"
+
+    # ── 3. 返回改 TODO 指令 ──
+    return (
+        f"✅ 完成！报告已保存: {dest_name}\n"
+        f"历史已记录: {line}\n"
+        f"👉 请在 {_TODO_FILE} 中将对应任务标记为 [x] R{rnum}"
+    )
+
+
+# ── 快速自检 ──
+if __name__ == "__main__":
+    print(f"TEMP_DIR:    {_TEMP_DIR}")
+    print(f"REPORTS_DIR: {_REPORTS_DIR}")
+    print(f"HISTORY:     {_HISTORY_FILE}")
+    print(f"TODO:        {_TODO_FILE}")
+    print(f"Next R#:     R{_next_report_number()}")
+    print(f"\n--- TODO ---\n{get_todo()[:200]}")
+    print(f"\n--- History (5) ---\n{get_history(5)}")