Akashic Agent
Akashic 是一个会主动找你的 AI 伙伴。它可以对话，也能根据订阅的信息源判断何时主动发消息，并在空闲时执行后台任务。
快速开始
只需要 Docker（Compose 2.20+）。Windows 和 macOS 使用 Docker Desktop 即可。
mkdir akashic && cd akashic
curl -fsSLO https://github.com/kachofugetsu09/akashic-agent/releases/latest/download/compose.yaml
docker compose up -d --wait
首次启动会拉取镜像并安装默认功能，需要几分钟。命令返回后打开 http://localhost:2236，在“功能设置”→“初始配置”里连接模型，然后开始对话。
启动失败时查看 docker compose logs --tail=200，处理后重新运行同一条启动命令。
日常使用
docker compose stop # 停止
docker compose up -d --wait # 启动
docker compose logs -f # 查看日志
- 配置、会话和插件都保存在
data 数据卷里。不要运行 docker compose down -v，它会删除所有数据。
- 端口 2236 被占用时，在同一目录创建
.env，写入 AKASHIC_PORT=2237，再重新启动。
- 更新：先停止并备份数据，再下载新版
compose.yaml 覆盖旧文件，运行启动命令。
docker compose stop
docker run --rm -v akashic_data:/data -v "$PWD":/backup alpine tar czf /backup/akashic-data.tgz -C /data .
curl -fsSLO https://github.com/kachofugetsu09/akashic-agent/releases/latest/download/compose.yaml
docker compose up -d --wait
数据卷名是“目录名_data”，上例目录为 akashic。
通过域名访问
网页默认只在本机开放：在运行 Akashic 的机器上打开 http://localhost:2236 即可，不需要额外配置。
想在其他设备上通过域名访问时，用 Cloudflare Tunnel、nginx、Caddy 等工具把域名转发到这台机器的 localhost:2236。
网页登录
网页可以执行 Shell 和读写文件，所以默认带登录门（web-auth 插件），只有主人能进：
-
第一次：启动时随机生成初始密码，只写在启动日志里（docker compose logs akashic | grep 初始密码），不会发到任何聊天渠道。用户名 akashic。首次登录后需要设置自己的密码（至少 10 个字符）。
-
本机免密：在运行 Akashic 的机器上，./start 会自动帮浏览器登录。也可以运行下面的命令，得到一条 2 分钟内有效、只能用一次的登录链接：
python main.py web-login # ./start 安装
docker compose exec akashic python main.py web-login # Docker
-
记住设备：默认 90 天内免登录，到期后重新登录一次。在别人的电脑上登录时，取消勾选“记住这台设备”。
-
忘记密码：运行 python main.py web-passwd（Docker 前面加 docker compose exec akashic），会重置为临时密码，所有设备退出。也可以在 Telegram/QQ 里让 Akashic 帮你执行。
程序调用（SDK、CLI、programmatic）走本机 unix socket，不经过这道门。反向代理需要把原始 Host 转给 Akashic，例如 nginx 写 proxy_set_header Host $host;，否则网页的写操作和实时连接会被同源检查拒绝。公网访问请用 HTTPS。
其他启动方式
需要 Git、Python 3.12+ 和 Node.js 20+。
git clone --branch v0.2.0 https://github.com/kachofugetsu09/akashic-agent.git
cd akashic-agent
./start
首次运行会安装依赖并构建网页，就绪后自动打开 http://127.0.0.1:2236。按 Ctrl+C 停止；--no-browser 不打开浏览器，--port 2237 换端口。运行数据在 ~/.akashic。
源码构建镜像、开发调试与升级细节见启动与部署说明；已有 Host Bridge 部署见部署操作手册。
文档
