ChatGlance

ChatGlance 是 ChatArch/WZHECNU Glance dashboard 的 Python 生成与运维包，提供 chatglance CLI。

它不是 NPM 项目，也不是重新实现 Glance 后端：上游 Glance 仍然是 Go 单二进制 dashboard server；ChatGlance 负责把 ChatArch 项目清单、Glance YAML 页面、inline HTML 表格和安全运维补丁组织成可复用的 Python 包/CLI。

当前能力

  • 从 repository inventory JSON 生成 Glance 项目 page。
  • 当前 page tabs 固定为：最近提交、待处理 PR / Issue、分类、一览表。
  • 待处理 PR / Issue 只显示 PR/Issue 非 0 的仓库，并按 (PR, Issue, 最近提交) 降序。
  • 生成 config 副本时清理 legacy generated pages：Projects、ChatArch Projects、ChatArch Projects List。
  • 为 Glance server-stats 写入 root-only Disk 配置：hide-mountpoints-by-default: true + mountpoints: /，避免 snap/loop mount 出现在 Disk popover。
  • 维护 durable runtime：一次性 runtime maintain 可原子更新 live config、备份、校验，并在内容变化时可选重启 systemd user service。
  • 渲染 systemd user units：主服务仍直接启动 upstream Glance Go binary；维护任务是独立 oneshot/timer，不是 Python wrapper。

快速开始

pip install -e ".[dev]"
chatglance --help
chatglance --tree
chatglance --version
python -m pytest -q
python -m build

CLI 示例

只生成 项目 page YAML：

chatglance projects render-page \
  --data /path/to/chatarch-projects.json \
  --output playground/projects-page.yml

把生成页写入一个 Glance config 副本：

chatglance projects update-config \
  --data /path/to/chatarch-projects.json \
  --config /path/to/glance.yml \
  --output playground/glance.with-projects.yml

把 server-stats Disk 改成只显示 root 分区，写入 config 副本：

chatglance disks root-only \
  --config /path/to/glance.yml \
  --output playground/glance.root-disk.yml

维护一个 durable Glance runtime（默认 ~/.chatarch/glance）：

chatglance runtime maintain \
  --runtime-home ~/.chatarch/glance \
  --restart-service chatarch-glance.service

生成推荐 systemd user units：

chatglance runtime render-systemd \
  --runtime-home ~/.chatarch/glance \
  --chatglance-bin ~/.chatarch/venv/bin/chatglance \
  --output-dir playground/systemd

运行态边界

推荐拓扑是 systemd 直接运行 Glance，chatglance 只做维护：

  • 主服务：chatarch-glance.service 直接执行 ~/.chatarch/glance/bin/glance -config ~/.chatarch/glance/config/glance.yml。
  • 内容数据：repository inventory JSON、缓存和生成快照放在 ~/.chatarch/glance/data/ 或 ~/.chatarch/glance/cache/。
  • live config：~/.chatarch/glance/config/glance.yml；更新前写备份到 ~/.chatarch/glance/config/backups/。
  • 维护：chatglance runtime maintain 是 oneshot，可由 chatarch-glance-maintenance.timer 周期触发。
  • 不建议加 Python 长驻 wrapper：wrapper 会把 server 生命周期和内容生成耦合，反而不利于 systemd 重启、日志、健康检查和回滚。

安全边界

  • CLI 默认写 output file，不默认覆盖 live glance.yml。
  • 不保存或输出 Glance auth、password hash、GitHub token、proxy credential。
  • live runtime、logs、backups、全量实时 JSON 快照默认不进源码仓库。
  • 后续如需动态表格、搜索、中英文切换，再考虑增加小型静态前端层；当前 Python CLI 是基础层。

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.2)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for RexWzh from gravatar.com RexWzh

Credits

Author: ChatArch

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

dev

Tags

chatglance chatarch cli

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chatglance-0.1.0.tar.gz (15.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

chatglance-0.1.0-py3-none-any.whl (15.5 kB view details)

Uploaded Python 3

File details

Details for the file chatglance-0.1.0.tar.gz.

File metadata

  • Download URL: chatglance-0.1.0.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for chatglance-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b5c604d9a3bbba1b1a7ca41af373346763fefca51e013d1fec71fb93d6dd19e0
MD5 d01d9efb8af4242641c06833cac4dc41
BLAKE2b-256 c02e94bd1e16ecfdfebbd847805452e9603f4b1d37ab2881664a3f81d679e02c

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatglance-0.1.0.tar.gz:

Publisher: publish.yml on ChatArch/chatglance

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file chatglance-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: chatglance-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 15.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for chatglance-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4b7e9c5712f272b48db7a04b9054bf3555a1df818e6fe194c96279695a1e9670
MD5 8d3dc4a5d7143044cbda8e0f132ac308
BLAKE2b-256 15ef21fb45d6e3fb5b2e46f05b8030a211fc513c5f8583dd975fcf18a31c9b3f

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatglance-0.1.0-py3-none-any.whl:

Publisher: publish.yml on ChatArch/chatglance

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page