# tokenless-omarchy

**Repository Path**: cucdtl/tokenless-omarchy

## Basic Information

- **Project Name**: tokenless-omarchy
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-15
- **Last Updated**: 2026-10-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Tokenless for Omarchy

原生 Omarchy Shell 状态栏插件。首次打开提供安装向导；安装 Tokenless 核心、接入 Qoder、执行可恢复压缩自检，随后展示当前用户的工具内容压缩统计。

版本 **0.2.0**。第三方实验项目，不是 Omarchy 官方插件。支持 Quickshell 版 Omarchy 4、Python 3.11+、Linux x86_64/glibc。

## 安装与首次使用

插件仓库根目录有 `manifest.json`，通过官方命令安装：

```bash
omarchy plugin add https://gitee.com/cucdtl/tokenless-omarchy.git --enable
```

若使用已经配置 Gitee SSH 权限的账号，也可以：

```bash
omarchy plugin add git@gitee.com:cucdtl/tokenless-omarchy.git --enable
```

开发时已用下列虚拟机本地 Git 源验证相同流程：

```bash
omarchy plugin add "$HOME/tokenless-omarchy-lab/repos/omarchy-tokenless.git" --enable
```

已安装时使用 `omarchy plugin update community.tokenless`，不要重复 add。

1. 点击状态栏 **Tokenless** → **安装并配置**。已经初始化则按钮叫 **配置 / 修复**。
2. 在打开的配置终端选择：**1** 只安装核心并自检；**2** 安装核心并接入 Qoder（缺少时可一起安装）；**3** Qoder 浏览器登录或输入隐藏的 PAT。
3. 确认安装，等待自检通过。已有 Qoder 会话需要重新打开才能加载新 hooks。
4. 返回面板点击刷新。使用 Qoder 后，在 **Agent 统计** 查看记录。

Omarchy 的 `plugin add` 不执行仓库里的安装脚本。本项目没有静默的启动安装任务：下载和 Agent 配置由用户明确点击、在终端启动。

## 安装了什么

| 组件 | 版本 / 来源 | 安装方式 |
| --- | --- | --- |
| 本插件 | 0.2.0 / 本仓库 | Git 克隆，由 Omarchy 加载 QML |
| Tokenless | 0.8.6 / 官方 npm 平台包 | 下载校验后的二进制，不运行 npm postinstall |
| RTK | 0.49.0 / 同一平台包 | 与 Tokenless 一起解压 |
| Agent 适配器 | anolisa-tokenless 0.8.6 npm 包 | 使用上游 Qoder 安装脚本和 hooks |
| Qoder CLI | 1.1.71 / 官方发布渠道，可选 | 有现成 CLI 则复用；没有时经确认下载 |

所有 URL 与 SHA-256 固定在 `dependencies.lock.json`。本版只接入 Qoder。Tokenless 本地压缩不需要密钥，Qoder 真实模型调用需要个人认证。

安装器不请求 sudo，不修改系统软件包或全局 CA，不覆盖已有 `tokenless`、`rtk`、`qodercli` 命令；插件调用自己管理的核心路径。已有 ANOLISA 共享适配器若内容不同会停止，不强行替换。

## 自动化与离线缓存

以下在插件目录运行。`--yes` 表示你已明确选择安装内容：

```bash
# 核心 + 自检（在线自动下载）
python3 setup.py install --yes

# 核心 + Qoder 接入；缺少 Qoder 时一起安装
python3 setup.py install --yes --agent qoder --install-qoder

# 提前下载的固定版本归档，仍然校验 SHA-256
python3 setup.py install --yes --agent qoder --install-qoder --cache /path/to/archives --offline

# 状态；重新验证 Qoder hooks，无模型调用
python3 setup.py status
python3 setup.py check

# 打开首次安装向导 / 认证向导
python3 setup.py wizard
python3 setup.py auth
```

中断后重跑原命令：已校验的归档和完整的核心目录会被复用。下载残片不当作完成；损坏的核心会重新暂存安装。多个配置终端通过文件锁互斥。事件只记录步骤名称，不记录密钥或工具原文。

若 HTTPS 受企业代理影响，请正确配置当前进程 CA/代理，或用离线缓存；不要关闭 TLS 验证。

## 使用与数据范围

- **Agent 统计**：真实 Agent 工具调用的正常统计。
- **本地自检 / 自检统计**：独立合成数据，验证压缩、对照和原文取回，不调用模型。
- **终端详情**：汇总与最近记录，不默认显示工具原文。
- **Qoder**：通过带核心 PATH 的专用启动器打开；未接入则打开向导。

```bash
omarchy-shell community.tokenless open
omarchy-shell community.tokenless close
omarchy-shell community.tokenless setup
omarchy-shell community.tokenless selftest
omarchy-shell community.tokenless status
```

统计为最新最多 10,000 条正收益工具内容记录的估算，不代表整个会话用量或账单。取回原文的量单独显示，不与毛缩减量混淆。没有记录也不能直接断言 hooks 失效。

## 用户目录

| 位置 | 内容 |
| --- | --- |
| `~/.config/omarchy/plugins/community.tokenless/` | Git 管理的插件源码 |
| `~/.local/share/omarchy-tokenless/` | 核心、可选 Qoder、启动器 |
| `~/.local/share/anolisa/adapters/tokenless/` | 上游缓存 hooks 的共享资源；已有相同资源复用 |
| `~/.local/state/tokenless-omarchy/install.json` | 安装回执与文件校验值 |
| `~/.local/state/tokenless-omarchy/setup-events.jsonl` | 不含认证信息的步骤事件 |
| `~/.cache/omarchy-tokenless/` | 校验后的下载缓存 |
| `~/.config/tokenless-omarchy/qoder-auth.json` | 可选 PAT，权限 0600，不进入 Git |
| `~/.tokenless/` | 正常统计和可取回原文，可能敏感 |
| `~/.local/state/tokenless-omarchy/selftest/` | 独立合成自检数据 |

不要在 Git 仓库中保存 PAT、运行时、个人 CA 或数据库。

## 更新与卸载

```bash
omarchy plugin update community.tokenless
```

Git 更新只更新插件文件。核心或接入需要修复时，再运行 **配置 / 修复**。依赖版本由维护者更新锁定清单后发布；本版尚未提供跨核心版本自动迁移。

只隐藏面板，不改变压缩接入：

```bash
omarchy plugin disable community.tokenless
```

先撤销安装器创建的接入和运行时，再移除插件：

```bash
python3 ~/.config/omarchy/plugins/community.tokenless/setup.py uninstall --yes
omarchy plugin remove community.tokenless
```

卸载只撤销本安装器拥有的注册/软链接；复用的已有 Qoder 插件和程序保留。核心目录移到带时间戳的备份。统计、可恢复原文与认证始终保留。撤销接入失败时不要先删除核心文件。

## 开发验证

```bash
python3 -m unittest discover -s tests -v
omarchy plugin validate .
```

QML 使用 Omarchy 主题及 UI 组件，Shell 更新可能影响接口。若 QML 缓存没有刷新，在解锁桌面执行 `omarchy restart shell`，等待状态栏恢复。

## 许可与来源

本插件 MIT。上游 Tokenless 来自 [ANOLISA](https://github.com/agentic-os-org/ANOLISA/tree/main/src/tokenless)，各组件保留自己的许可。详见 `NOTICE.md`。