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

{{理论信息
|名称 = MediaWiki TCM Editor 安装使用指南
|提出者 = 
|出处 = 
|核心观点 = MediaWiki TCM Editor是OpenClaw的一个技能扩展，提供完整的中医医案、方剂、理论内容管理与发布工作流，包含内容转换、批量上传、分类管理、模板系统等功能。
|应用领域 = &#x3D;&#x3D;&#x3D; 🏥 核心功能与使用 &#x3D;&#x3D;&#x3D;

&#x3D;&#x3D;&#x3D;&#x3D; 1. 医案处理流程 &#x3D;&#x3D;&#x3D;&#x3D;

&#39;&#39;&#39;数据准备&#39;&#39;&#39;：创建医案JSON文件
&lt;syntaxhighlight lang&#x3D;&quot;json&quot;&gt;
{
  &quot;title&quot;: &quot;医案:1974-08-太阳风湿（范中林医案）&quot;,
  &quot;patient&quot;: &quot;杨某某，女性，60岁，农民。既往有风湿痛史&quot;,
  &quot;chief_complaint&quot;: &quot;腰痛如割，不能转侧&quot;,
  &quot;symptoms&quot;: [&quot;腰痛如割，不能转侧&quot;, &quot;身觉阵阵畏寒发热&quot;],
  &quot;prescription&quot;: &quot;桂枝附子汤主之；桂枝15克，制附片60克...&quot;,
  &quot;effect&quot;: &quot;上方连服四剂后，诸证悉减...&quot;,
  &quot;doctor&quot;: &quot;范中林&quot;,
  &quot;categories&quot;: [&quot;中医医案&quot;, &quot;外感病证&quot;, &quot;经方&quot;, &quot;现代医家&quot;]
}
&lt;&#x2F;syntaxhighlight&gt;

&#39;&#39;&#39;上传医案&#39;&#39;&#39;
&lt;syntaxhighlight lang&#x3D;&quot;bash&quot;&gt;
.&#x2F;scripts&#x2F;upload_medical_case.sh &quot;医案:1974-08-太阳风湿（范中林医案）&quot; \
  cases&#x2F;pending&#x2F;1974-08-太阳风湿-范中林医案.json
&lt;&#x2F;syntaxhighlight&gt;

&#x3D;&#x3D;&#x3D;&#x3D; 2. 方剂上传 &#x3D;&#x3D;&#x3D;&#x3D;

&#39;&#39;&#39;方剂数据格式&#39;&#39;&#39;
&lt;syntaxhighlight lang&#x3D;&quot;json&quot;&gt;
{
  &quot;title&quot;: &quot;方剂:逍遥散&quot;,
  &quot;name&quot;: &quot;逍遥散&quot;,
  &quot;source&quot;: &quot;《太平惠民和剂局方》&quot;,
  &quot;composition&quot;: &quot;柴胡、当归、白芍、白术、茯苓、生姜、薄荷、炙甘草&quot;,
  &quot;indications&quot;: &quot;肝郁血虚脾弱证。两胁作痛，头痛目眩，口燥咽干...&quot;,
  &quot;categories&quot;: [&quot;方剂&quot;, &quot;和解剂&quot;, &quot;调和肝脾剂&quot;, &quot;逍遥散类方&quot;]
}
&lt;&#x2F;syntaxhighlight&gt;

&#39;&#39;&#39;上传方剂&#39;&#39;&#39;
&lt;syntaxhighlight lang&#x3D;&quot;bash&quot;&gt;
.&#x2F;scripts&#x2F;upload_prescription.sh &quot;方剂:逍遥散&quot; \
  cases&#x2F;pending&#x2F;逍遥散-圆运动分析.json
&lt;&#x2F;syntaxhighlight&gt;

&#x3D;&#x3D;&#x3D;&#x3D; 3. 理论分析上传 &#x3D;&#x3D;&#x3D;&#x3D;

&#39;&#39;&#39;理论数据格式&#39;&#39;&#39;
&lt;syntaxhighlight lang&#x3D;&quot;json&quot;&gt;
{
  &quot;title&quot;: &quot;理论:腰痛-圆运动理论分析&quot;,
  &quot;name&quot;: &quot;腰痛圆运动理论分析&quot;,
  &quot;core_concepts&quot;: &quot;彭子益圆运动理论将人体气机运动归纳为&#39;中气如轴、四维如轮&#39;的模型...&quot;,
  &quot;theoretical_system&quot;: &quot;### 🌀 圆运动腰痛分类总览...&quot;,
  &quot;categories&quot;: [&quot;中医理论&quot;, &quot;彭子益圆运动理论&quot;, &quot;腰痛&quot;]
}
&lt;&#x2F;syntaxhighlight&gt;

&#39;&#39;&#39;上传理论&#39;&#39;&#39;
&lt;syntaxhighlight lang&#x3D;&quot;bash&quot;&gt;
.&#x2F;scripts&#x2F;upload_腰痛理论.sh &quot;理论:腰痛-圆运动理论分析&quot; \
  cases&#x2F;pending&#x2F;腰痛-圆运动理论分析.json
&lt;&#x2F;syntaxhighlight&gt;

&#x3D;&#x3D;&#x3D;&#x3D; 4. 分类管理 &#x3D;&#x3D;&#x3D;&#x3D;

&#39;&#39;&#39;自动创建分类&#39;&#39;&#39;
&lt;syntaxhighlight lang&#x3D;&quot;bash&quot;&gt;
&#x3D;&#x3D; 创建所有缺失的分类页面 &#x3D;&#x3D;
.&#x2F;scripts&#x2F;create_categories.sh

&#x3D;&#x3D; 此脚本会自动： &#x3D;&#x3D;
&#x3D;&#x3D; 1. 分析所有医案中的分类标签 &#x3D;&#x3D;
&#x3D;&#x3D; 2. 检查wiki上是否已存在 &#x3D;&#x3D;
&#x3D;&#x3D; 3. 批量创建缺失的分类页面 &#x3D;&#x3D;
&#x3D;&#x3D; 4. 为每个分类添加描述性内容 &#x3D;&#x3D;
&lt;&#x2F;syntaxhighlight&gt;

&#39;&#39;&#39;分类配置文件&#39;&#39;&#39;（config&#x2F;categories.json）
&lt;syntaxhighlight lang&#x3D;&quot;json&quot;&gt;
{
  &quot;medical_cases&quot;: {
    &quot;中医医案&quot;: &quot;所有中医医案页面&quot;,
    &quot;外感病证&quot;: &quot;外感病证医案&quot;,
    &quot;经方&quot;: &quot;经典方剂医案&quot;,
    &quot;现代医家&quot;: &quot;现代医家医案&quot;
  },
  &quot;prescriptions&quot;: {
    &quot;方剂&quot;: &quot;所有中药方剂&quot;,
    &quot;经方&quot;: &quot;经典方剂（伤寒论、金匮要略等）&quot;
  },
  &quot;theories&quot;: {
    &quot;中医理论&quot;: &quot;所有中医理论&quot;,
    &quot;彭子益圆运动理论&quot;: &quot;彭子益圆运动理论相关内容&quot;
  }
}
&lt;&#x2F;syntaxhighlight&gt;

&#x3D;&#x3D;&#x3D;&#x3D; 5. 批量处理 &#x3D;&#x3D;&#x3D;&#x3D;

&#39;&#39;&#39;批量上传所有待处理文件&#39;&#39;&#39;
&lt;syntaxhighlight lang&#x3D;&quot;bash&quot;&gt;
&#x3D;&#x3D; 使用批量上传脚本 &#x3D;&#x3D;
.&#x2F;scripts&#x2F;batch_upload_all.sh

&#x3D;&#x3D; 或手动批量处理 &#x3D;&#x3D;
for file in cases&#x2F;pending&#x2F;*.json; do
  if [[ $file &#x3D;&#x3D; &#39;&#39;医案&#39;&#39; ]]; then
    .&#x2F;scripts&#x2F;upload_medical_case.sh &quot;医案:$(basename $file .json)&quot; &quot;$file&quot;
  elif [[ $file &#x3D;&#x3D; &#39;&#39;方剂&#39;&#39; ]]; then
    .&#x2F;scripts&#x2F;upload_prescription.sh &quot;方剂:$(basename $file .json)&quot; &quot;$file&quot;
  elif [[ $file &#x3D;&#x3D; &#39;&#39;理论&#39;&#39; ]]; then
    .&#x2F;scripts&#x2F;upload_腰痛理论.sh &quot;理论:$(basename $file .json)&quot; &quot;$file&quot;
  fi
done
&lt;&#x2F;syntaxhighlight&gt;
}}
== 基本概念 ==
==== 技能包定位 ====
MediaWiki TCM Editor是为中医知识库建设量身定制的工具包，基于OpenClaw技能系统，提供从数据准备到MediaWiki发布的端到端自动化流程。

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

==== 适用场景 ====
* 中医医案数据库建设
* 经方方剂库管理
* 中医理论体系整理
* 个人或机构中医知识库构建
== 理论体系 ==
=== 🚀 安装方法 ===

==== 方式C：从ClawHub技能市场安装（最推荐） ====


==== 方式A：从GitHub直接安装（推荐） ====
<syntaxhighlight lang="bash">
== 1. 进入OpenClaw工作目录 ==
cd /root/.openclaw/workspace

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

==== 方式B：从本地目录安装 ====
<syntaxhighlight lang="bash">
== 1. 克隆仓库到本地 ==
cd /root/.openclaw/workspace
git clone https://github.com/delong2003/mediawiki-tcm-editor.git

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

=== 🔧 配置步骤 ===

==== 1. 创建配置文件 ====
<syntaxhighlight lang="bash">
== 进入技能目录 ==
cd mediawiki-tcm-editor

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

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

==== 2. 配置文件内容示例 ====
<syntaxhighlight lang="bash">
#!/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"                    # 超时设置
</syntaxhighlight>

==== 3. 加载配置 ====
<syntaxhighlight lang="bash">
== 每次使用前加载配置 ==
source config/mediawiki-config.sh

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

=== 🧪 测试安装 ===

==== 1. 测试网络连接 ====
<syntaxhighlight lang="bash">
== 检查网络连通性 ==
cd mediawiki-tcm-editor
./scripts/mediawiki-api.sh test

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

==== 2. 测试登录 ====
<syntaxhighlight lang="bash">
== 测试账号登录 ==
./scripts/mediawiki-api.sh login
</syntaxhighlight>

==== 3. 查看技能文档 ====
<syntaxhighlight lang="bash">
== 列出技能命令 ==
npx skills list | grep mediawiki

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

=== 📁 技能包结构 ===
<syntaxhighlight lang="">
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     # 彭子益圆运动理论文档
</syntaxhighlight>
== 临床应用 ==

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

==== 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实例中使用完整的中医医案编辑功能，构建专业的中医知识库！'''
== 相关理论 ==
OpenClaw技能系统,MediaWiki API,彭子益圆运动理论,中医医案整理,知识库管理,自动化工作流
== 参考文献 ==
* ClawHub技能市场: https:&#x2F;&#x2F;clawhub.com&#x2F;skills&#x2F;mediawiki-editor
* GitHub仓库: https:&#x2F;&#x2F;github.com&#x2F;delong2003&#x2F;mediawiki-tcm-editor
* OpenClaw文档: https:&#x2F;&#x2F;docs.openclaw.ai
* MediaWiki API文档: https:&#x2F;&#x2F;www.mediawiki.org&#x2F;wiki&#x2F;API:Main_page
* 《圆运动的古中医学》，彭子益著
[[Category:中医理论]]
[[Category:技能文档]]
[[Category:OpenClaw]]
[[Category:MediaWiki]]
[[Category:中医信息化]]
[[Category:知识管理]]
[[Category:自动化工具]]
[[Category:安装指南]]