ErisPulse-CYOA
CYOA（Choose Your Own Adventure，选择你自己的旅途）— 基于 inkpython 的多平台 Ink 互动小说播放器。
特性
- Ink 原生格式 — 用 Ink 编写，Inky/inklecate 编译
- 跨平台按钮 — Telegram / 云湖 / QQBot 按钮 +
event.choose()回退 - 仓库分发 — 添加 Git 仓库自动获取故事
- 独立存档 — 每用户每故事多槽位
安装
epsdk install CYOA
Docker 部署
docker compose（推荐）
# 复制配置模板
cp -r config/ ./docker-config/
# 编辑配置（填写适配器 token 等）
# vim docker-config/config.toml
# 设置 Dashboard Token（可选）
export ERISPULSE_DASHBOARD_TOKEN=your-token
# 启动
docker compose up -d
docker run
docker run -d \
--name cyoa-bot \
-p 8000:8000 \
-v $(pwd)/config:/app/config \
-e TZ=Asia/Shanghai \
-e ERISPULSE_DASHBOARD_TOKEN=your-token \
--restart unless-stopped \
ghcr.io/wsu2059q/erispulse-cyoa:latest
命令
/cyoa 帮助
/cyoa list 故事列表
/cyoa play <ID> 开始
/cyoa import <URL> 导入 .ink.json
/cyoa save|load|restart|quit 游戏管理
/cyoa repo list|add|remove|update 仓库管理
快速开始
导入编译好的 .ink.json 直接玩：
/cyoa import https://example.com/my_story.ink.json
/cyoa play my_story
或添加小说仓库，一次更新就能获取全部故事：
/cyoa repo add <名称> https://raw.githubusercontent.com/<用户>/<仓库>/main
/cyoa repo update
/cyoa list
/cyoa play <故事ID>
推荐仓库
我们维护的官方故事合集：
/cyoa repo add official https://raw.githubusercontent.com/wsu2059q/cyoa-stories/main
贡献请 Fork cyoa-stories。
编写故事
用 Inky 编写 .ink 文件，导出为 .ink.json 后导入。
详见 FORMAT.md。
平台兼容
| 平台 | 交互 |
|---|---|
| Telegram | Inline Keyboard |
| 云湖 | Buttons (actionType=3) |
| QQBot | Keyboard |
| 其他 | event.choose() |
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file erispulse_cyoa-1.1.3.tar.gz.
File metadata
- Download URL: erispulse_cyoa-1.1.3.tar.gz
- Upload date:
- Size: 22.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
483d0553b3c0f5d285e905761593ce46af4b2c37e1e4b85895e8f769ed13c324
|
|
| MD5 |
e46c329be0fcf30ca9c17dfee6992040
|
|
| BLAKE2b-256 |
d59c6f95c6fdabdb5e954054e7a9db6d7c252f19fcd32b2ed6a5e33eeaec001a
|
Provenance
The following attestation bundles were made for erispulse_cyoa-1.1.3.tar.gz:
Publisher:
python-publish.yml on wsu2059q/ErisPulse-CYOA
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
erispulse_cyoa-1.1.3.tar.gz -
Subject digest:
483d0553b3c0f5d285e905761593ce46af4b2c37e1e4b85895e8f769ed13c324 - Sigstore transparency entry: 1681260147
- Sigstore integration time:
-
Permalink:
wsu2059q/ErisPulse-CYOA@e89cc4bc9660c4d120d46668a6f9d6bd87c40f55 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/wsu2059q
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@e89cc4bc9660c4d120d46668a6f9d6bd87c40f55 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file erispulse_cyoa-1.1.3-py3-none-any.whl.
File metadata
- Download URL: erispulse_cyoa-1.1.3-py3-none-any.whl
- Upload date:
- Size: 24.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
781b6d614b39f30f41565be5bc98966f3480a97cbb6c7fb543d54c1ea19fa729
|
|
| MD5 |
57c0b03388ea0f1673a85ad0d76e1507
|
|
| BLAKE2b-256 |
6bd7229edc9cd5cc7136ca7951a819482be67ca7a3ed20111fc247555891c272
|
Provenance
The following attestation bundles were made for erispulse_cyoa-1.1.3-py3-none-any.whl:
Publisher:
python-publish.yml on wsu2059q/ErisPulse-CYOA
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
erispulse_cyoa-1.1.3-py3-none-any.whl -
Subject digest:
781b6d614b39f30f41565be5bc98966f3480a97cbb6c7fb543d54c1ea19fa729 - Sigstore transparency entry: 1681260281
- Sigstore integration time:
-
Permalink:
wsu2059q/ErisPulse-CYOA@e89cc4bc9660c4d120d46668a6f9d6bd87c40f55 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/wsu2059q
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
python-publish.yml@e89cc4bc9660c4d120d46668a6f9d6bd87c40f55 -
Trigger Event:
workflow_dispatch
-
Statement type:
