跳转到内容

技能:MediaWiki TCM Editor 安装使用指南

来自MyWiki

模板:理论信息

基本概念[编辑 | 编辑源代码]

技能包定位[编辑 | 编辑源代码]

MediaWiki TCM Editor是为中医知识库建设量身定制的工具包，基于OpenClaw技能系统，提供从数据准备到MediaWiki发布的端到端自动化流程。

核心特性[编辑 | 编辑源代码]

  1. 专业中医模板：医案、方剂、理论专用模板系统
  2. 圆运动理论整合：内置彭子益圆运动理论分析框架
  3. 批量处理能力：支持大量内容的一次性上传和管理
  4. 智能分类系统：自动为内容添加多维度分类标签
  5. 格式自动转换：Markdown/JSON到MediaWiki格式的智能转换

适用场景[编辑 | 编辑源代码]

  • 中医医案数据库建设
  • 经方方剂库管理
  • 中医理论体系整理
  • 个人或机构中医知识库构建

理论体系[编辑 | 编辑源代码]

🚀 安装方法[编辑 | 编辑源代码]

方式C：从ClawHub技能市场安装（最推荐）[编辑 | 编辑源代码]

方式A：从GitHub直接安装（推荐）[编辑 | 编辑源代码]

== 1. 进入OpenClaw工作目录 ==
cd /root/.openclaw/workspace

== 2. 从GitHub仓库安装 ==
npx skills add https://github.com/delong2003/mediawiki-tcm-editor.git

方式B：从本地目录安装[编辑 | 编辑源代码]

== 1. 克隆仓库到本地 ==
cd /root/.openclaw/workspace
git clone https://github.com/delong2003/mediawiki-tcm-editor.git

== 2. 安装技能 ==
npx skills add ./mediawiki-tcm-editor

🔧 配置步骤[编辑 | 编辑源代码]

1. 创建配置文件[编辑 | 编辑源代码]

== 进入技能目录 ==
cd mediawiki-tcm-editor

== 复制配置模板 ==
cp config/mediawiki-config-template.sh config/mediawiki-config.sh

== 编辑配置文件（设置您的凭据） ==
nano config/mediawiki-config.sh

2. 配置文件内容示例[编辑 | 编辑源代码]

#!/bin/bash
== MediaWiki 配置 ==
export MEDIAWIKI_URL="https://您的wiki站点.com"  # 您的wiki站点URL
export MEDIAWIKI_USERNAME="您的用户名"            # 登录用户名
export MEDIAWIKI_PASSWORD="您的密码"              # 登录密码
export MEDIAWIKI_API_PATH="/api.php"             # API路径（可能是/w/api.php）
export MEDIAWIKI_TIMEOUT="30"                    # 超时设置

3. 加载配置[编辑 | 编辑源代码]

== 每次使用前加载配置 ==
source config/mediawiki-config.sh

== 或添加到bashrc（永久生效） ==
echo 'source /root/.openclaw/workspace/mediawiki-tcm-editor/config/mediawiki-config.sh' >> ~/.bashrc
source ~/.bashrc

🧪 测试安装[编辑 | 编辑源代码]

1. 测试网络连接[编辑 | 编辑源代码]

== 检查网络连通性 ==
cd mediawiki-tcm-editor
./scripts/mediawiki-api.sh test

== 或手动测试API ==
curl -I "${MEDIAWIKI_URL}${MEDIAWIKI_API_PATH}?action=query&meta=siteinfo"

2. 测试登录[编辑 | 编辑源代码]

== 测试账号登录 ==
./scripts/mediawiki-api.sh login

3. 查看技能文档[编辑 | 编辑源代码]

== 列出技能命令 ==
npx skills list | grep mediawiki

== 查看技能详细文档 ==
cat mediawiki-tcm-editor/SKILL.md

📁 技能包结构[编辑 | 编辑源代码]

mediawiki-tcm-editor/
├── SKILL.md                    # 技能主文档
├── README.md                   # 使用说明
├── config/
│   ├── categories.json         # 分类配置（50+中医分类）
│   ├── mediawiki-config.sh     # 站点配置
│   └── templates/              # 模板文件
├── scripts/
│   ├── converter.js           # 内容转换器（Markdown→MediaWiki）
│   ├── upload_medical_case.sh # 医案上传脚本
│   ├── upload_prescription.sh # 方剂上传脚本
│   ├── upload_腰痛理论.sh      # 理论上传脚本
│   ├── create_categories.sh   # 分类创建脚本
│   └── mediawiki-api.sh       # API工具
├── cases/
│   ├── pending/               # 待处理文件
│   └── processed/             # 已处理文件
└── docs/
    └── 中医理论框架参考.md     # 彭子益圆运动理论文档

临床应用[编辑 | 编辑源代码]

现代发展[编辑 | 编辑源代码]

⚠️ 重要注意事项[编辑 | 编辑源代码]

1. 内部网络访问[编辑 | 编辑源代码]

如果您的wiki站点位于内部网络（如企业内网、私有云）：

解决方案：

  • 确保OpenClaw运行机器能访问目标网络
  • 可能需要配置VPN或SSH隧道
  • 参考INTERNAL_NETWORK_GUIDE.md文档

2. 凭据安全[编辑 | 编辑源代码]

安全最佳实践：

  1. 不要提交包含真实密码的配置文件到Git
  2. 将config/mediawiki-config.sh添加到.gitignore
  3. 使用环境变量替代硬编码密码
  4. 定期更新密码和访问令牌

3. 权限要求[编辑 | 编辑源代码]

MediaWiki用户需要以下权限：

  • 创建页面：创建新内容页面
  • 编辑页面：修改现有页面
  • 上传文件：如果需要附加文件
  • 创建分类：创建新的分类页面

4. API路径差异[编辑 | 编辑源代码]

不同MediaWiki安装的API路径可能不同：

🔄 标准工作流[编辑 | 编辑源代码]

完整操作流程[编辑 | 编辑源代码]

  1. 准备数据：创建医案/方剂/理论JSON文件
  2. 测试连接：./scripts/mediawiki-api.sh test
  3. 上传内容：使用相应的上传脚本
  4. 管理分类：./scripts/create_categories.sh
  5. 验证结果：访问生成的页面链接

数据准备模板[编辑 | 编辑源代码]

技能包提供多种模板文件：

  • templates/medical_case_template.json：医案模板
  • examples/medical_case_example.json：医案示例
  • examples/prescription_example.json：方剂示例
  • examples/theory_example.json：理论示例

🛠️ 故障排除[编辑 | 编辑源代码]

常见问题与解决方案[编辑 | 编辑源代码]

问题 可能原因 解决方案
网络连接失败 DNS解析失败、防火墙阻挡 ping 您的wiki站点.com
curl -I https://您的wiki站点.com
登录失败 用户名/密码错误、API路径错误 检查配置文件凭据
测试API路径：/w/api.php或/api.php
权限不足 用户缺少必要权限 检查MediaWiki用户权限设置
JSON格式错误 JSON语法错误、字段缺失 jq . cases/pending/文件.json
使用模板文件参考
表格显示异常 Markdown表格转换问题 已修复的converter.js支持自动转换

调试模式[编辑 | 编辑源代码]

== 启用调试输出 ==
bash -x ./scripts/upload_medical_case.sh "标题" "文件.json"

== 查看详细日志 ==
tail -f /tmp/upload_*.log

日志文件位置[编辑 | 编辑源代码]

  • 上传日志：/tmp/upload_*.log
  • API调用日志：/tmp/mediawiki-api-*.log
  • 转换调试：/tmp/converter-*.log

📚 相关文档与资源[编辑 | 编辑源代码]

内置文档[编辑 | 编辑源代码]

  • SKILL.md：技能详细说明与命令参考
  • README.md：安装使用快速指南
  • INTERNAL_NETWORK_GUIDE.md：内部网络访问指南
  • DATA_PREPARATION_GUIDE.md：数据准备指南
  • 中医理论框架参考.md：彭子益圆运动理论文档

在线资源[编辑 | 编辑源代码]

已成功案例[编辑 | 编辑源代码]

  1. 腰痛理论分析：页面ID 650，包含完整的圆运动理论分析
  2. 范中林医案：页面ID 597，太阳风湿医案完整记录
  3. 张志民医案：页面ID 596，潮热腑实医案
  4. 50+分类页面：页面ID 598-649，完整的中医分类体系

🚀 快速开始脚本[编辑 | 编辑源代码]

#!/bin/bash
== mediawiki-tcm-editor 快速安装脚本 ==

set -e

echo "=== 安装MediaWiki TCM Editor ==="

== 1. 克隆仓库 ==
cd /root/.openclaw/workspace
git clone https://github.com/delong2003/mediawiki-tcm-editor.git
cd mediawiki-tcm-editor

== 2. 安装依赖（如果需要） ==
npm install 2>/dev/null || echo "跳过npm安装"

== 3. 配置 ==
cp config/mediawiki-config-template.sh config/mediawiki-config.sh
echo "请编辑 config/mediawiki-config.sh 设置您的凭据"
echo "然后运行: source config/mediawiki-config.sh"

== 4. 测试 ==
source config/mediawiki-config.sh 2>/dev/null || true
echo "测试连接: ./scripts/mediawiki-api.sh test"

echo "安装完成！"

💡 专业提示[编辑 | 编辑源代码]

  1. 版本控制：定期git pull获取最新更新
  2. 配置备份：备份您的config/mediawiki-config.sh文件
  3. 测试环境：先在测试wiki站点上验证所有功能
  4. 批量优化：准备好所有JSON文件后一次性批量上传
  5. 分类规划：提前规划分类体系，参考config/categories.json
  6. 模板定制：根据需要修改config/templates/中的模板文件

📞 支持与反馈[编辑 | 编辑源代码]

  • 问题报告：GitHub Issues页面
  • 功能请求：通过GitHub或联系开发者
  • 使用交流：OpenClaw社区讨论

安装完成后，您就可以在任何OpenClaw实例中使用完整的中医医案编辑功能，构建专业的中医知识库！

相关理论[编辑 | 编辑源代码]

OpenClaw技能系统,MediaWiki API,彭子益圆运动理论,中医医案整理,知识库管理,自动化工作流

参考文献[编辑 | 编辑源代码]

  • ClawHub技能市场: https://clawhub.com/skills/mediawiki-editor
  • GitHub仓库: https://github.com/delong2003/mediawiki-tcm-editor
  • OpenClaw文档: https://docs.openclaw.ai
  • MediaWiki API文档: https://www.mediawiki.org/wiki/API:Main_page
  • 《圆运动的古中医学》，彭子益著
检索自“https://wiki.chsoc.com/index.php?title=技能:MediaWiki_TCM_Editor_安装使用指南&oldid=1011”