使用手册

此页面针对一些功能的使用和配置方法进行说明。

使用 Arkose Endpoint

实验性功能

该功能仍在测试中，可能会有不稳定的情况。如果你遇到问题，请及时反馈自己先研究一下吧，文档目前没有任何问题，别着急问了。

在 v0.4.8 版本后在前端支持了 Arkose 验证。如果启用此功能，生成 Arkose Token 的工作将在前端完成，无需提供 har 给 ninja。启用后，前端用户可能会遇到需要手动打码的情况。不过还是推荐启用。

你可以通过如下步骤启用该功能：

1. 去域名 DNS 服务商处添加一个二级域名，指向你的 CWS 服务器。然后，在你的 VPS 的 Caddyfile 或其它反代配置中，为 Ninja 反代到一个单独的子域名，例如：

   ninja.yourdomain.com {
       reverse_proxy localhost:7999
   }
   

   如果你想先调试一下，也可以直接使用 <你的服务器 IP>:7999 代替 ninja.yourdomain.com。

2. 修改 Ninja 的配置：在 docker-compose.yaml 中，为启动项增加 --arkose-endpoint https://ninja.yourdomain.com，然后重启 Ninja。例如：

   version: '3'
   
   services:
     ninja:
       image: ghcr.io/gngpp/ninja:latest
       container_name: ninja
       restart: unless-stopped
       command: run --arkose-endpoint https://ninja.yourdomain.com
       ports:
         - "7999:7999"
       environment:
         - TZ=Asia/Shanghai
       #volumes:
       #  - "./har:/root/.ninja"    # <--- 已经不再需要
       networks:
         - cwsnetwork
   
   networks:
     cwsnetwork:
       name: cwsnetwork
       external: true
   

3. 在 CWS 的设置页面中，勾选“启用前端 Arkose 验证”，并在下方 Arkose Endpoint Base 处填入 https://ninja.yourdomain.com/v2/。注意，这个地址必须是前端可以访问到的地址，不可以是内网地址。你应当让这个地址指向 ninja。不要漏了末尾的 /v2/。

4. 保存配置后，点击页面最上方的“测试Arkose”按钮。如果成功的话，将会显示获取到的 Arkose Token 内容。

使用 ChatGPT Team 订阅

在 v0.4.6 版本后增加了对 Team 订阅的支持。可以通过如下方法启用 Team 订阅。

全局开启 Team 订阅

1. 启用配置项 enable_team_subscription 并保存。
2. 确保 access token 有效，然后使用上方的检查可用性按钮。
3. 如果一切正常，Team Account ID 应当会自动填写。

如果你加入了多个组织，可以手动输入 Team Account ID。目前只支持一个 Team 组织。

保存配置后，请去对话管理页面同步一次对话。

为需要的用户开启 Team 订阅

在全局开启后，用户仍然会默认使用 Personal 订阅。如果希望某个用户使用 Team 订阅，仍需要在用户设置中启用 Use Team 选项。

此功能具体的行为说明

目前对 Team 订阅的支持仍在完善中。当前的一些策略为：

1. 如果 enable_team_subscription 为 true，则新创建的用户默认使用 Team 订阅。
2. 对话数据表新增了 source_id 字段，该字段当前用于标记对话所属的 chatgpt-account-id 也就是 team_account_id。该字段在首次创建对话或更新对话时被确定。
3. 如果修改了 team_account_id，原先的对话仍然会使用原来的组织，因而可以被正常访问和回复。

对话排队机制

CWS 默认对 ChatGPT 对话进行排队，以避免同时提问。如果要修改此行为，可以尝试修改 max_completion_concurrency 配置项。