编辑“︁技能:MediaWiki TCM Editor 安装使用指南”︁（章节）

== 现代发展 ==
=== ⚠️ 重要注意事项 ===

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

'''解决方案'''：
* 确保OpenClaw运行机器能访问目标网络
* 可能需要配置VPN或SSH隧道
* 参考<code>INTERNAL_NETWORK_GUIDE.md</code>文档

==== 2. 凭据安全 ====
'''安全最佳实践'''：
# '''不要提交'''包含真实密码的配置文件到Git
# 将<code>config/mediawiki-config.sh</code>添加到<code>.gitignore</code>
# 使用环境变量替代硬编码密码
# 定期更新密码和访问令牌

==== 3. 权限要求 ====
MediaWiki用户需要以下权限：
* '''创建页面'''：创建新内容页面
* '''编辑页面'''：修改现有页面
* '''上传文件'''：如果需要附加文件
* '''创建分类'''：创建新的分类页面

==== 4. API路径差异 ====
不同MediaWiki安装的API路径可能不同：
* '''标准路径'''：<code>/w/api.php</code>（多数MediaWiki安装）
* '''自定义路径'''：<code>/api.php</code>（某些自定义安装）
* '''测试方法'''：访问<code>https://您的wiki站点.com/w/api.php</code>查看响应

=== 🔄 标准工作流 ===

==== 完整操作流程 ====
# '''准备数据'''：创建医案/方剂/理论JSON文件
# '''测试连接'''：<code>./scripts/mediawiki-api.sh test</code>
# '''上传内容'''：使用相应的上传脚本
# '''管理分类'''：<code>./scripts/create_categories.sh</code>
# '''验证结果'''：访问生成的页面链接

==== 数据准备模板 ====
技能包提供多种模板文件：
* <code>templates/medical_case_template.json</code>：医案模板
* <code>examples/medical_case_example.json</code>：医案示例
* <code>examples/prescription_example.json</code>：方剂示例
* <code>examples/theory_example.json</code>：理论示例

=== 🛠️ 故障排除 ===

==== 常见问题与解决方案 ====


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

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

==== 日志文件位置 ====
* '''上传日志'''：<code>/tmp/upload_*.log</code>
* '''API调用日志'''：<code>/tmp/mediawiki-api-*.log</code>
* '''转换调试'''：<code>/tmp/converter-*.log</code>

=== 📚 相关文档与资源 ===

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

==== 在线资源 ====
* '''GitHub仓库'''：https://github.com/delong2003/mediawiki-tcm-editor
* '''OpenClaw文档'''：https://docs.openclaw.ai
* '''MediaWiki API文档'''：https://www.mediawiki.org/wiki/API:Main_page

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

=== 🚀 快速开始脚本 ===
<syntaxhighlight lang="bash">
#!/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 "安装完成！"
</syntaxhighlight>

=== 💡 专业提示 ===

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

=== 📞 支持与反馈 ===

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

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