Skip to content

兼容性说明.md

Latest commit

 

History

History
213 lines (154 loc) · 4.14 KB

兼容性说明.md

File metadata and controls

213 lines (154 loc) · 4.14 KB

Research Report Skill - 兼容性说明

📋 支持的平台

✅ 原生支持（推荐）

Claude Code（官方）

⚠️ 通过适配器支持

Cursor

  • 支持：通过 .cursorrules 调用外部命令
  • 配置：在项目根目录创建 .cursorrules 文件
  • 详见下方 Cursor 配置章节

Antigravity

  • 支持：需要测试其技能系统格式
  • 配置：可能需要格式转换
  • 状态：待验证

Chatbox / Cherry Studio / OpenCat

  • 支持：通过 HTTP API 调用
  • 配置：需要启动 HTTP 服务器
  • 详见下方 HTTP API 配置章节

❌ 不支持

代码补全类工具

  • 通义灵码
  • CodeGeeX
  • 百度 Comate
  • 豆包 MarsCode

原因：这些工具主要用于代码补全，不支持运行自定义脚本

🔧 配置方法

方法1：Claude Code（最简单）

步骤：

  1. 确保 skill 文件在 .claude/skills/research-report/
  2. 打开 Claude Code
  3. 直接对话： 
    运行 research-report 的 help 命令

无需任何配置！

方法2：命令行直接运行

任何终端都可以：

cd .claude/skills/research-report
node run.js help
node run.js topics "AI教育"
node run.js status

适用于：

  • Windows CMD / PowerShell
  • macOS Terminal
  • Linux Shell

方法3：Cursor 适配

步骤：

  1. 在项目根目录创建 .cursorrules 文件
  2. 添加以下内容：
# Research Report Skill
当用户询问研报相关任务时，使用以下命令：

生成选题：运行 `node .claude/skills/research-report/run.js topics "主题"`
搭建框架：运行 `node .claude/skills/research-report/run.js outline "选题"`
撰写内容：运行 `node .claude/skills/research-report/run.js write`
查看状态：运行 `node .claude/skills/research-report/run.js status`
  1. 在 Cursor 中直接对话即可

方法4：HTTP API（通用方案）

适用场景：

  • Chatbox
  • Cherry Studio
  • OpenCat
  • 任何支持 HTTP 请求的 AI 应用

步骤：

  1. 安装依赖
cd .claude/skills/research-report
npm install express cors
  1. 启动服务器
node server.js
  1. 在其他应用中调用

示例：使用 Chatbox

  • 在 Chatbox 中添加自定义工具
  • 配置 API 端点：http://localhost:3456/execute
  • 请求格式：
{
  "command": "help"
}

示例：使用 Cherry Studio

  • 添加外部命令
  • 配置 curl 命令：
curl -X POST http://localhost:3456/execute \
  -H "Content-Type: application/json" \
  -d '{"command": "help"}'

🌐 国内 AI 应用使用建议

推荐组合

如果你想用... 推荐方案
Claude Code ✅ 原生支持，最简单
Cursor ⚠️ 使用 .cursorrules 适配
Antigravity ❓ 需要测试兼容性
其他聊天应用 ⚠️ 使用 HTTP API 方案
纯代码编辑器 ❌ 直接运行命令行脚本

📌 关键注意事项

1. Node.js 环境要求

# 检查是否安装了 Node.js
node --version  # 应该 >= v18

如果没有安装，去 https://nodejs.org 下载

2. 端口冲突（HTTP API 模式）

如果 3456 端口被占用，修改 server.js 中的 PORT 变量

3. 权限问题

某些系统可能需要授权脚本运行权限：

# macOS / Linux
chmod +x .claude/skills/research-report/run.js

# Windows 一般不需要

🚀 快速测试兼容性

测试你的环境是否支持：

# 1. 测试 Node.js
node --version

# 2. 测试 skill 能否运行
cd .claude/skills/research-report
node run.js help

# 3. 如果成功，说明你的环境兼容！

📞 需要帮助？

如果遇到兼容性问题：

  1. 确认 Node.js 版本 >= 18
  2. 确认 skill 文件完整
  3. 尝试命令行直接运行
  4. 查看错误信息

常见的兼容性问题：

  • ❌ "Cannot find module" → 运行 npm install
  • ❌ "Permission denied" → 检查文件权限
  • ❌ "Port already in use" → 修改端口号

最后更新：2025年1月 版本：兼容性说明 v1.0