内容
# lsFusion AI 技能
[代理技能](https://docs.claude.com/docs/claude-code/skills) 用于处理
[lsFusion](https://lsfusion.org)，作为 Claude Code 插件打包，并与官方的 **`ai.lsfusion.org` MCP 服务器**捆绑。
## 内容
| 技能 | 目的 |
|-------|---------|
| **lsfusion-dev** | 在本地（Windows）设置、运行和验证 lsFusion 应用程序。编写/编辑 `.lsf`，搭建项目，启动应用服务器，诊断启动/表单问题。 |
| **lsfusion-deploy** | 将 lsFusion 应用程序部署到远程 Linux 服务器：提供服务，打包 jar，systemd 单元，通过 certbot 实现 HTTPS，拉取生产 PostgreSQL 数据库到本地。 |
| **lsfusion-eval** | 在运行的服务器上通过 HTTP（`/eval`，`/exec`，`/eval/action`）运行 lsFusion 代码，并检查实际部署的内容。 |
```
ai-skills/
├── .claude-plugin/
│ ├── marketplace.json # 市场化清单（仓库根目录 → /plugin 市场化添加）
│ └── plugin.json # 插件定义
├── .mcp.json # 捆绑 ai.lsfusion.org MCP 服务器
└── skills/
├── lsfusion-dev/
├── lsfusion-deploy/
└── lsfusion-eval/
```
## 在 Claude Code 中安装（交互式）
```
/plugin marketplace add lsfusion/ai-skills
/plugin install lsfusion-ai-skills
```
这将安装所有三个技能 **和** 注册 `lsfusion-ai` MCP 服务器
（`https://ai.lsfusion.org/mcp`）。在首次使用时，Claude Code 可能会提示您与服务器进行身份验证。
## 在 `/plugin` 无法使用时安装（CLI）
某些环境（嵌入式客户端，Cowork 等）不提供交互式
`/plugin` 命令 — 您将看到 *"/plugin 在此环境中不可用。"* `claude` CLI 可以以非交互方式执行完全相同的操作：
```bash
claude plugin marketplace add lsfusion/ai-skills
claude plugin install lsfusion-ai-skills@lsfusion
```
验证和管理：
```bash
claude plugin list # 确认已启用
claude plugin details lsfusion-ai-skills@lsfusion # 显示技能 + MCP 库存
claude plugin marketplace update lsfusion # 稍后拉取最新提交
```
卸载 / 删除：
```bash
claude plugin uninstall lsfusion-ai-skills@lsfusion
claude plugin marketplace remove lsfusion
```
技能和 `lsfusion-ai` MCP 服务器在 **新** Claude Code 会话中变得可用（MCP 服务器在首次使用时可能会提示身份验证）。
> **在 `claude plugin update` / `marketplace update` 之后：** 已经打开的会话保留了它在启动时加载的 **旧** SKILL.md — 只有在新会话中指令才会刷新。然而，更新的 *脚本*（例如
> `scripts/lsfdev.ps1`）立即可用：它们在调用时从插件缓存中解析路径，并且缓存路径随版本变化（`...\lsfusion-ai-skills\<version>\skills\...`）— 因此重新解析脚本路径而不是重用早期在对话中缓存的路径。
## 在没有插件的情况下使用技能
`skills/` 文件夹遵循开放的代理技能格式，因此在任何地方都可以使用：
- **Claude Code（手动）：** 将技能文件夹复制到 `~/.claude/skills/`（全局）或
`.claude/skills/`（每个项目）。使用 `claude mcp add --transport http lsfusion-ai https://ai.lsfusion.org/mcp` 单独添加 MCP 服务器。
- **Claude.ai / Claude Desktop：** 压缩技能文件夹并在设置 → 功能 → 技能下上传。
- **Claude API / 代理 SDK：** 将技能文件夹挂载到代理的工作目录中。
## 其他工具中的 MCP 服务器
通过插件捆绑 MCP 是 Claude Code 的一个功能。在其他地方，手动添加
`https://ai.lsfusion.org/mcp`:
- **Claude.ai / Desktop：** 设置 → 连接器 → 添加自定义连接器。
- **ChatGPT：** 连接器设置。
- **Codex：** 在 `~/.codex/config.toml` 中添加 `[mcp_servers.lsfusion-ai]` 部分。
## 许可证
Apache-2.0
