小医系统整改计划

版本：v1.0

编制时间：2026-04-28 14:12

编制依据：《建档流程与架构分析报告》

状态：待审批

---

一、问题汇总

1.1 问题来源

根据《建档流程与架构分析报告》（2026-04-28），共识别出 **7 个问题**：

1.2 新增问题（本次发现）

---

二、整改计划总览

2.1 整改阶段划分

---

2.2 整改任务清单

---

三、详细整改方案

3.1 第一阶段：紧急修复（第 1 周）

---

任务 T001：增强 user_index.json 同步脚本健壮性

**关联问题：** P001 — user_index.json 同步风险

**问题描述：**

**整改目标：**

**技术方案：**

# 修改 skills/user-onboard/scripts/sync_user_index.py

def call_update_script(contact_id, *args):
    """调用 update_user_index.py（增加重试机制）"""
    max_retries = 3
    for attempt in range(max_retries):
        try:
            cmd = ["python3", str(UPDATE_SCRIPT), contact_id] + list(args)
            result = subprocess.run(
                cmd,
                stdout=subprocess.PIPE,
                stderr=subprocess.PIPE,
                universal_newlines=True,
                timeout=10,
                env=env
            )
            if result.returncode == 0:
                return True
            else:
                if attempt == max_retries - 1:
                    return False
                time.sleep(1)  # 重试前等待
        except Exception as e:
            if attempt == max_retries - 1:
                return False
            time.sleep(1)
    return False

**修改文件清单：**

**验收标准：**

**风险评估：**

---

任务 T002：增加渠道状态监控机制

**关联问题：** P002 — 渠道激活依赖用户主动发消息

**问题描述：**

**整改目标：**

**技术方案：**

# 新增脚本：scripts/check_channel_status.sh

#!/bin/bash
# 渠道状态监控脚本

USER_INDEX="/home/admin/.openclaw/workspace/user_index.json"
OUTPUT_FILE="/home/admin/.openclaw/workspace/logs/channel_status_$(date +%Y%m%d).json"

# 读取所有 contactId
contactIds=$(cat "$USER_INDEX" | jq -r 'keys[]')

results=()
for contactId in $contactIds; do
    # 调用 tutu API 检查渠道状态
    status=$(curl -s -X POST "https://tutu-gateway.lovebenefits.com/tutu-api/api/jkzl/mcp/chat/contact/status" \
        -H "Content-Type: application/json" \
        -d "{\"tenant\":\"jkzl\",\"contactId\":\"$contactId\"}" | jq -r '.status')
    
    if [ "$status" != "active" ]; then
        results+=("{\"contactId\":\"$contactId\",\"status\":\"inactive\"}")
    fi
done

# 输出结果
echo "{\"timestamp\":\"$(date -Iseconds)\",\"unactivated\":[$(IFS=,; echo "${results[*]}")]}" > "$OUTPUT_FILE"

**新增文件清单：**

**修改文件清单：**

**验收标准：**

**风险评估：**

---

任务 T003：修复云部署脚本越权问题

**关联问题：** P008 — 云部署脚本硬编码 contactId

**问题描述：**

**整改目标：**

**技术方案：**

# 修改 scripts/update-reports.sh

# 从环境变量或会话标识获取当前用户 contactId
CONTACT_ID="${DEPLOY_CONTACT_ID:-}"

if [ -z "$CONTACT_ID" ]; then
    # 尝试从会话标识解析
    CONTACT_ID=$(python3 -c "
import os
# 从环境变量或会话标识获取
session_key = os.environ.get('SESSION_KEY', '')
if ':' in session_key:
    contact_id = session_key.split(':')[-1]
    print(contact_id)
")
fi

if [ -z "$CONTACT_ID" ]; then
    echo "❌ 错误：无法获取当前用户 contactId"
    echo "请设置环境变量 DEPLOY_CONTACT_ID 或从会话中自动获取"
    exit 1
fi

# 权限检查
ROLE=$(python3 -c "
import json
user_index = json.load(open('/home/admin/.openclaw/workspace/user_index.json'))
info = user_index.get('$CONTACT_ID', {})
print(info.get('role', 'unknown'))
")

if [ "$ROLE" = "owner" ]; then
    echo "👤 当前用户：$CONTACT_ID (owner)"
elif [ "$ROLE" = "employee" ]; then
    echo "👤 当前用户：$CONTACT_ID (employee)"
else
    echo "👤 当前用户：$CONTACT_ID (other-contacts)"
fi

# 记录审计日志
echo "{\"timestamp\":\"$(date -Iseconds)\",\"contactId\":\"$CONTACT_ID\",\"role\":\"$ROLE\",\"action\":\"deploy\",\"project\":\"$PROJECT_NAME\"}" >> ~/.openclaw/cloud-deploy-audit.log

**修改文件清单：**

**新增文件清单：**

**验收标准：**

**风险评估：**

---

3.2 第二阶段：中期优化（第 2-3 周）

---

任务 T004：统一档案目录结构

**关联问题：** P003 — 档案目录结构不统一

**问题描述：**

**整改目标：**

**修改文件清单：**

**新增文件清单：**

**验收标准：**

---

任务 T005：优化活动名称映射管理

**关联问题：** P004 — 活动名称映射维护成本高

**问题描述：**

**整改目标：**

**修改文件清单：**

**新增文件清单：**

**验收标准：**

---

任务 T006：统一 SESSION_STATE 文件位置

**关联问题：** P005 — SESSION_STATE 文件分散

**问题描述：**

**整改目标：**

**修改文件清单：**

**新增文件清单：**

**验收标准：**

---

3.3 第三阶段：长期完善（第 4-6 周）

---

任务 T007：规范文档版本管理

**关联问题：** P006 — 文档版本管理不规范

**整改目标：**

**新增文件清单：**

**验收标准：**

---

任务 T008：清理测试档案

**关联问题：** P007 — 测试档案未清理

**整改目标：**

**新增文件清单：**

**验收标准：**

---

任务 T009：引入数据库存储（长期）

**整改目标：**

**新增文件清单：**

---

任务 T010：建立自动化测试体系

**整改目标：**

**新增文件清单：**

---

四、风险评估

4.1 风险矩阵

4.2 回滚方案

---

五、验收标准

5.1 第一阶段验收（第 1 周末）

5.2 第二阶段验收（第 3 周末）

5.3 第三阶段验收（第 6 周末）

---

六、资源需求

6.1 人力资源

---

七、审批流程

---

八、附录

A. 相关文件清单

B. 术语表

---

_整改计划版本：v1.0_

_编制时间：2026-04-28 14:12_

_编制依据：《建档流程与架构分析报告》_

_状态：待审批_

_保存位置：/home/admin/.openclaw/workspace/docs/architecture-analysis/整改计划-v1.0.md_