← 返回主页

工具管理平台使用说明

访问地址

JSON管理工具使用说明

功能概述

JSON管理工具是一个基于GitHub私有仓库的可视化JSON文件管理系统，支持：

首次使用配置

1. 创建GitHub App

  1. 访问 https://github.com/settings/apps
  2. 点击 New GitHub App
  3. 填写基本信息：
    • GitHub App name: json-manager-app（或其他名称）
    • Homepage URL: https://tanyi.chat
    • Webhook: 取消勾选 Active
  4. 设置权限（Repository permissions）：
    • Contents: Read and write
  5. 点击 Create GitHub App
  6. 创建后进入App详情页：
    • 记录 App ID
    • 生成 Private Key（下载.pem文件）
    • 点击 Install App → 选择仓库 TY-JsonData
    • 安装完成后，从URL中获取 Installation ID
      格式：https://github.com/settings/installations/xxxxx （xxxxx即为ID）

2. 配置Cloudflare Pages环境变量

  1. 登录 https://dash.cloudflare.com
  2. Workers & Pages → 选择 json-manager 项目
  3. Settings → Environment variables
  4. 添加以下变量：
GITHUB_APP_ID = 你的App ID
GITHUB_APP_INSTALLATION_ID = 你的Installation ID
GITHUB_APP_PRIVATE_KEY = -----BEGIN RSA PRIVATE KEY-----\n完整私钥内容\n-----END RSA PRIVATE KEY-----
GITHUB_USER = tan857867043
GITHUB_REPO = TY-JsonData
AUTH_PASSWORD = 你的管理密码

重要提示：

  1. 保存后，重新部署项目（Deployments → Retry deployment）

日常使用流程

1. 登录

  1. 访问 https://tanyi.chat/tools/json-manager/
  2. 输入管理密码
  3. 点击"验证登录"

2. 浏览文件

3. 编辑文件

  1. 点击左侧文件树中的文件名
  2. 在右侧编辑器中修改内容
    • Tree模式：树形视图，直观操作
    • Code模式：代码视图，快速编辑
  3. 点击顶部"保存"按钮
  4. 修改自动提交到GitHub

4. 新建文件

  1. 点击左侧"新建文件"按钮（📄图标）
  2. 输入文件名（自动添加.json后缀）
  3. 在编辑器中编辑内容
  4. 点击"保存"

5. 新建文件夹

  1. 点击左侧"新建文件夹"按钮（📁图标）
  2. 输入文件夹名称
  3. 系统会在文件夹中创建.gitkeep.json占位文件
  4. 后续可在该文件夹中创建其他文件

快捷键

快捷键 功能
Ctrl+K 聚焦搜索框（主页）
Esc 清空搜索/关闭弹窗

常见问题

Q1: 登录失败，提示"认证失败"

原因： 环境变量配置错误或密码不正确

解决方案：

  1. 检查Cloudflare Pages环境变量是否完整
  2. 确认AUTH_PASSWORD与输入密码一致
  3. 确认GITHUB_APP_PRIVATE_KEY格式正确
  4. 重新部署项目

Q2: 无法加载文件列表，显示500错误

原因： GitHub App权限不足或配置错误

解决方案：

  1. 检查GitHub App是否已安装到TY-JsonData仓库
  2. 确认App权限包含 Contents: Read and write
  3. 检查GITHUB_APP_ID和GITHUB_APP_INSTALLATION_ID是否正确

Q3: 保存文件时提示"SHA mismatch"

原因： 文件已被其他人修改，本地版本过期

解决方案：

  1. 刷新文件列表
  2. 重新加载该文件
  3. 再次编辑并保存

添加新工具

1. 创建工具目录

mkdir -p public/tools/new-tool

2. 创建工具页面

在 public/tools/new-tool/index.html 中编写工具页面，引入共享资源：

<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <link rel="stylesheet" href="/assets/css/common.css">
  <script src="/assets/js/config.js"></script>
  <title>新工具</title>
</head>
<body>
  <!-- 工具内容 -->
</body>
</html>

3. 更新工具配置

编辑 public/tools/tools.json，添加工具信息到对应分类中。

4. 提交部署

git add .
git commit -m "feat: add new tool"
git push

版本: 1.0.0 | 最后更新: 2025-12-25