chatenv 0.2.7__tar.gz → 0.2.8__tar.gz

chatenv-0.2.8/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: chatenv
+Version: 0.2.8
+Summary: ChatArch typed environment profile manager
+Author-email: rexwzh <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://arch.gh.wzhecnu.cn/ChatEnv/
+Project-URL: Documentation, https://arch.gh.wzhecnu.cn/ChatEnv/
+Project-URL: Repository, https://github.com/ChatArch/ChatEnv
+Keywords: chatenv,chatarch,env
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: chatstyle<0.2.0,>=0.1.0
+Requires-Dist: click<9.0,>=8.4.2
+Requires-Dist: python-dotenv<2.0,>=1.2.2
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs<2.0,>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material<10.0,>=9.5; extra == "docs"
+Requires-Dist: mkdocs-static-i18n<2.0,>=1.2; extra == "docs"
+Requires-Dist: mkdocs-minify-plugin<1.0,>=0.8; extra == "docs"
+Requires-Dist: mkdocs-redirects<2.0,>=1.2; extra == "docs"
+Requires-Dist: mike<3.0,>=2.1; extra == "docs"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/chatenv">
+        <img src="https://img.shields.io/pypi/v/chatenv.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://pypi.python.org/pypi/chatenv">
+        <img src="https://img.shields.io/pypi/pyversions/chatenv.svg" alt="Python versions" />
+    </a>
+    <a href="LICENSE">
+        <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" />
+    </a>
+</div>
+
+<div align="center">
+
+# ChatEnv
+
+ChatArch typed env/profile runtime.
+
+</div>
+
+ChatEnv 是 ChatArch / chatxxx 系列项目共用的 typed env/profile 底层包。它提供字段描述、配置基类、registry、路径、profile 文件读写、mask、paste 解析，以及 runtime token-store 的通用能力；具体业务变量、登录刷新和连通性语义由各项目自己定义并注册。
+
+文档入口：https://arch.gh.wzhecnu.cn/ChatEnv/
+
+## 安装
+
+```bash
+pip install chatenv --upgrade
+chatenv --version
+chatenv --tree
+```
+
+支持 Python `>=3.10`。
+
+## 目录
+
+```text
+CHATARCH_HOME=${CHATARCH_HOME:-~/.chatarch}
+$CHATARCH_HOME/envs/      # stable typed env/profile files
+$CHATARCH_HOME/tokens/    # generated runtime tokens/sessions, parallel to env profiles
+```
+
+ChatEnv 只负责 stable env/profile 与 runtime token-store 的存储规则，不额外创建 config/cache/data/state，也不把 `tokens/` 当作第二个手工维护 secret/env 层。
+
+## CLI 树
+
+`chatenv --tree` 从当前安装包的 Click 注册表实时输出完整命令面：
+
+```text
+chatenv [--home <HOME>]  # Manage typed env profiles under $CHATARCH_HOME/envs.
+├── --help  # Show this help message.
+├── --version  # Show the installed package version.
+├── --tree  # Print the registered command tree.
+├── init [--type <CONFIG-TYPES>] [--interactive/--no-interactive]  # Create or update active typed env files.
+├── new [NAME] [--type <CONFIG-TYPES>] [--yes] [--interactive/--no-interactive]  # Create a named typed profile without activating it.
+├── paste [--value <VALUE>] [--stdin] [--profile <PROFILE>] [--yes] [--interactive/--no-interactive]  # Paste loose env text and import recognized keys.
+├── use [NAME] [--type <CONFIG-TYPES>] [--interactive/--no-interactive]  # Activate a named profile for one config type.
+├── list [--type <CONFIG-TYPES>]  # List active default and named profiles grouped by config type.
+├── status [--type <CONFIG-TYPES>] [--detail]  # Show registered config platforms and provider ownership.
+├── token  # Manage generic runtime token profiles.
+│   ├── status <SERVICE> [PROFILE] [--format <OUTPUT-FORMAT>]  # Show safe runtime token metadata for SERVICE/PROFILE.
+│   ├── refresh <SERVICE> [PROFILE] [--format <OUTPUT-FORMAT>]  # Refresh SERVICE/PROFILE through a registered service refresh provider.
+│   ├── import <SERVICE> [PROFILE] [--stdin] [--file <VALUE-FILE>] [--token-type <TOKEN-TYPE>] [--summary <SUMMARY>] [--expires-at <EXPIRES-AT>] [--format <OUTPUT-FORMAT>]  # Explicitly import externally refreshed runtime token JSON.
+│   ├── list [SERVICE] [--format <OUTPUT-FORMAT>]  # List runtime token profiles grouped by service.
+│   └── clear <SERVICE> [PROFILE] [--execute] [--format <OUTPUT-FORMAT>]  # Clear a generic runtime token file for SERVICE/PROFILE.
+├── cat [NAME] [--no-mask] [--type <CONFIG-TYPES>]  # Print active values, or a named typed profile with -t TYPE NAME.
+├── get [KEY] [--interactive/--no-interactive]  # Get a configuration value from active typed env files.
+├── set [KEY-VALUE] [--interactive/--no-interactive]  # Set a configuration value in the matching active typed env file.
+├── save [NAME] [--type <CONFIG-TYPES>] [--yes] [--interactive/--no-interactive]  # Save current active values as a named profile.
+├── delete [NAME] [--type <CONFIG-TYPES>] [--yes] [--interactive/--no-interactive]  # Delete a named profile for one config type.
+└── test [--target <TARGET>] [--interactive/--no-interactive]  # Test a registered configuration schema.
+```
+
+## 常用命令
+
+```bash
+chatenv init -t example
+chatenv status --detail
+chatenv cat -t example
+chatenv paste --stdin --profile work --yes
+chatenv set EXAMPLE_API_KEY=sk-xxx
+chatenv get EXAMPLE_API_KEY
+chatenv token refresh PyPI RexWzh
+chatenv token status PyPI RexWzh
+```
+
+敏感值默认 mask；`token status/list/clear` 只输出 safe metadata，不输出 raw token/cookie/CSRF values。
+
+## Python API
+
+```python
+from chatenv import BaseEnvConfig, EnvField, EnvStore, get_paths
+
+class ExampleConfig(BaseEnvConfig):
+    _title = "Example Configuration"
+    _aliases = ["example"]
+    _storage_dir = "Example"
+
+    EXAMPLE_API_KEY = EnvField("EXAMPLE_API_KEY", is_sensitive=True)
+
+paths = get_paths()
+store = EnvStore(paths.envs_dir)
+store.save_active(ExampleConfig, {"EXAMPLE_API_KEY": "sk-..."})
+```
+
+## 文档
+
+- https://arch.gh.wzhecnu.cn/ChatEnv/
+- `docs/cli.md`：CLI 用法
+- `docs/design.md`：路径、数据布局与注册策略
+- `docs/developer-guide.md`：chatxxx 项目接入和 provider 开发指南
+- `docs/development.md`：测试、构建与发布
+
+## 开发
+
+```bash
+python -m pip install -e .[dev,docs]
+python -m pytest -q
+python -m mkdocs build --strict
+python -m build
+python -m twine check dist/*
+```
+
+## 开源协议
+
+MIT License

chatenv-0.2.8/README.md

@@ -0,0 +1,129 @@
+<div align="center">
+    <a href="https://pypi.python.org/pypi/chatenv">
+        <img src="https://img.shields.io/pypi/v/chatenv.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://pypi.python.org/pypi/chatenv">
+        <img src="https://img.shields.io/pypi/pyversions/chatenv.svg" alt="Python versions" />
+    </a>
+    <a href="LICENSE">
+        <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" />
+    </a>
+</div>
+
+<div align="center">
+
+# ChatEnv
+
+ChatArch typed env/profile runtime.
+
+</div>
+
+ChatEnv 是 ChatArch / chatxxx 系列项目共用的 typed env/profile 底层包。它提供字段描述、配置基类、registry、路径、profile 文件读写、mask、paste 解析，以及 runtime token-store 的通用能力；具体业务变量、登录刷新和连通性语义由各项目自己定义并注册。
+
+文档入口：https://arch.gh.wzhecnu.cn/ChatEnv/
+
+## 安装
+
+```bash
+pip install chatenv --upgrade
+chatenv --version
+chatenv --tree
+```
+
+支持 Python `>=3.10`。
+
+## 目录
+
+```text
+CHATARCH_HOME=${CHATARCH_HOME:-~/.chatarch}
+$CHATARCH_HOME/envs/      # stable typed env/profile files
+$CHATARCH_HOME/tokens/    # generated runtime tokens/sessions, parallel to env profiles
+```
+
+ChatEnv 只负责 stable env/profile 与 runtime token-store 的存储规则，不额外创建 config/cache/data/state，也不把 `tokens/` 当作第二个手工维护 secret/env 层。
+
+## CLI 树
+
+`chatenv --tree` 从当前安装包的 Click 注册表实时输出完整命令面：
+
+```text
+chatenv [--home <HOME>]  # Manage typed env profiles under $CHATARCH_HOME/envs.
+├── --help  # Show this help message.
+├── --version  # Show the installed package version.
+├── --tree  # Print the registered command tree.
+├── init [--type <CONFIG-TYPES>] [--interactive/--no-interactive]  # Create or update active typed env files.
+├── new [NAME] [--type <CONFIG-TYPES>] [--yes] [--interactive/--no-interactive]  # Create a named typed profile without activating it.
+├── paste [--value <VALUE>] [--stdin] [--profile <PROFILE>] [--yes] [--interactive/--no-interactive]  # Paste loose env text and import recognized keys.
+├── use [NAME] [--type <CONFIG-TYPES>] [--interactive/--no-interactive]  # Activate a named profile for one config type.
+├── list [--type <CONFIG-TYPES>]  # List active default and named profiles grouped by config type.
+├── status [--type <CONFIG-TYPES>] [--detail]  # Show registered config platforms and provider ownership.
+├── token  # Manage generic runtime token profiles.
+│   ├── status <SERVICE> [PROFILE] [--format <OUTPUT-FORMAT>]  # Show safe runtime token metadata for SERVICE/PROFILE.
+│   ├── refresh <SERVICE> [PROFILE] [--format <OUTPUT-FORMAT>]  # Refresh SERVICE/PROFILE through a registered service refresh provider.
+│   ├── import <SERVICE> [PROFILE] [--stdin] [--file <VALUE-FILE>] [--token-type <TOKEN-TYPE>] [--summary <SUMMARY>] [--expires-at <EXPIRES-AT>] [--format <OUTPUT-FORMAT>]  # Explicitly import externally refreshed runtime token JSON.
+│   ├── list [SERVICE] [--format <OUTPUT-FORMAT>]  # List runtime token profiles grouped by service.
+│   └── clear <SERVICE> [PROFILE] [--execute] [--format <OUTPUT-FORMAT>]  # Clear a generic runtime token file for SERVICE/PROFILE.
+├── cat [NAME] [--no-mask] [--type <CONFIG-TYPES>]  # Print active values, or a named typed profile with -t TYPE NAME.
+├── get [KEY] [--interactive/--no-interactive]  # Get a configuration value from active typed env files.
+├── set [KEY-VALUE] [--interactive/--no-interactive]  # Set a configuration value in the matching active typed env file.
+├── save [NAME] [--type <CONFIG-TYPES>] [--yes] [--interactive/--no-interactive]  # Save current active values as a named profile.
+├── delete [NAME] [--type <CONFIG-TYPES>] [--yes] [--interactive/--no-interactive]  # Delete a named profile for one config type.
+└── test [--target <TARGET>] [--interactive/--no-interactive]  # Test a registered configuration schema.
+```
+
+## 常用命令
+
+```bash
+chatenv init -t example
+chatenv status --detail
+chatenv cat -t example
+chatenv paste --stdin --profile work --yes
+chatenv set EXAMPLE_API_KEY=sk-xxx
+chatenv get EXAMPLE_API_KEY
+chatenv token refresh PyPI RexWzh
+chatenv token status PyPI RexWzh
+```
+
+敏感值默认 mask；`token status/list/clear` 只输出 safe metadata，不输出 raw token/cookie/CSRF values。
+
+## Python API
+
+```python
+from chatenv import BaseEnvConfig, EnvField, EnvStore, get_paths
+
+class ExampleConfig(BaseEnvConfig):
+    _title = "Example Configuration"
+    _aliases = ["example"]
+    _storage_dir = "Example"
+
+    EXAMPLE_API_KEY = EnvField("EXAMPLE_API_KEY", is_sensitive=True)
+
+paths = get_paths()
+store = EnvStore(paths.envs_dir)
+store.save_active(ExampleConfig, {"EXAMPLE_API_KEY": "sk-..."})
+```
+
+## 文档
+
+- https://arch.gh.wzhecnu.cn/ChatEnv/
+- `docs/cli.md`：CLI 用法
+- `docs/design.md`：路径、数据布局与注册策略
+- `docs/developer-guide.md`：chatxxx 项目接入和 provider 开发指南
+- `docs/development.md`：测试、构建与发布
+
+## 开发
+
+```bash
+python -m pip install -e .[dev,docs]
+python -m pytest -q
+python -m mkdocs build --strict
+python -m build
+python -m twine check dist/*
+```
+
+## 开源协议
+
+MIT License

{chatenv-0.2.7 → chatenv-0.2.8}/pyproject.toml

@@ -22,9 +22,9 @@ classifiers = [
 ]
 
 [project.urls]
-Homepage = "https://github.com/ChatArch/ChatEnv"
+Homepage = "https://arch.gh.wzhecnu.cn/ChatEnv/"
+Documentation = "https://arch.gh.wzhecnu.cn/ChatEnv/"
 Repository = "https://github.com/ChatArch/ChatEnv"
-Documentation = "https://chatarch.github.io/ChatEnv/"
 
 [tool.setuptools.dynamic]
 version = {attr = "chatenv.__version__"}
@@ -46,7 +46,8 @@ dev = [
 ]
 docs = [
     "mkdocs>=1.6,<2.0",
-    "mkdocs-material>=9.5,<9.7",
+    "mkdocs-material>=9.5,<10.0",
+    "mkdocs-static-i18n>=1.2,<2.0",
     "mkdocs-minify-plugin>=0.8,<1.0",
     "mkdocs-redirects>=1.2,<2.0",
     "mike>=2.1,<3.0",

{chatenv-0.2.7 → chatenv-0.2.8}/src/chatenv/__init__.py

@@ -24,4 +24,4 @@ __all__ = [
     "__version__",
 ]
 
-__version__ = "0.2.7"
+__version__ = "0.2.8"

chatenv-0.2.8/src/chatenv.egg-info/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: chatenv
+Version: 0.2.8
+Summary: ChatArch typed environment profile manager
+Author-email: rexwzh <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Homepage, https://arch.gh.wzhecnu.cn/ChatEnv/
+Project-URL: Documentation, https://arch.gh.wzhecnu.cn/ChatEnv/
+Project-URL: Repository, https://github.com/ChatArch/ChatEnv
+Keywords: chatenv,chatarch,env
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: chatstyle<0.2.0,>=0.1.0
+Requires-Dist: click<9.0,>=8.4.2
+Requires-Dist: python-dotenv<2.0,>=1.2.2
+Provides-Extra: dev
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: twine>=5.0; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: mkdocs<2.0,>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material<10.0,>=9.5; extra == "docs"
+Requires-Dist: mkdocs-static-i18n<2.0,>=1.2; extra == "docs"
+Requires-Dist: mkdocs-minify-plugin<1.0,>=0.8; extra == "docs"
+Requires-Dist: mkdocs-redirects<2.0,>=1.2; extra == "docs"
+Requires-Dist: mike<3.0,>=2.1; extra == "docs"
+Dynamic: license-file
+
+<div align="center">
+    <a href="https://pypi.python.org/pypi/chatenv">
+        <img src="https://img.shields.io/pypi/v/chatenv.svg" alt="PyPI version" />
+    </a>
+    <a href="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml">
+        <img src="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml/badge.svg" alt="Tests" />
+    </a>
+    <a href="https://pypi.python.org/pypi/chatenv">
+        <img src="https://img.shields.io/pypi/pyversions/chatenv.svg" alt="Python versions" />
+    </a>
+    <a href="LICENSE">
+        <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" />
+    </a>
+</div>
+
+<div align="center">
+
+# ChatEnv
+
+ChatArch typed env/profile runtime.
+
+</div>
+
+ChatEnv 是 ChatArch / chatxxx 系列项目共用的 typed env/profile 底层包。它提供字段描述、配置基类、registry、路径、profile 文件读写、mask、paste 解析，以及 runtime token-store 的通用能力；具体业务变量、登录刷新和连通性语义由各项目自己定义并注册。
+
+文档入口：https://arch.gh.wzhecnu.cn/ChatEnv/
+
+## 安装
+
+```bash
+pip install chatenv --upgrade
+chatenv --version
+chatenv --tree
+```
+
+支持 Python `>=3.10`。
+
+## 目录
+
+```text
+CHATARCH_HOME=${CHATARCH_HOME:-~/.chatarch}
+$CHATARCH_HOME/envs/      # stable typed env/profile files
+$CHATARCH_HOME/tokens/    # generated runtime tokens/sessions, parallel to env profiles
+```
+
+ChatEnv 只负责 stable env/profile 与 runtime token-store 的存储规则，不额外创建 config/cache/data/state，也不把 `tokens/` 当作第二个手工维护 secret/env 层。
+
+## CLI 树
+
+`chatenv --tree` 从当前安装包的 Click 注册表实时输出完整命令面：
+
+```text
+chatenv [--home <HOME>]  # Manage typed env profiles under $CHATARCH_HOME/envs.
+├── --help  # Show this help message.
+├── --version  # Show the installed package version.
+├── --tree  # Print the registered command tree.
+├── init [--type <CONFIG-TYPES>] [--interactive/--no-interactive]  # Create or update active typed env files.
+├── new [NAME] [--type <CONFIG-TYPES>] [--yes] [--interactive/--no-interactive]  # Create a named typed profile without activating it.
+├── paste [--value <VALUE>] [--stdin] [--profile <PROFILE>] [--yes] [--interactive/--no-interactive]  # Paste loose env text and import recognized keys.
+├── use [NAME] [--type <CONFIG-TYPES>] [--interactive/--no-interactive]  # Activate a named profile for one config type.
+├── list [--type <CONFIG-TYPES>]  # List active default and named profiles grouped by config type.
+├── status [--type <CONFIG-TYPES>] [--detail]  # Show registered config platforms and provider ownership.
+├── token  # Manage generic runtime token profiles.
+│   ├── status <SERVICE> [PROFILE] [--format <OUTPUT-FORMAT>]  # Show safe runtime token metadata for SERVICE/PROFILE.
+│   ├── refresh <SERVICE> [PROFILE] [--format <OUTPUT-FORMAT>]  # Refresh SERVICE/PROFILE through a registered service refresh provider.
+│   ├── import <SERVICE> [PROFILE] [--stdin] [--file <VALUE-FILE>] [--token-type <TOKEN-TYPE>] [--summary <SUMMARY>] [--expires-at <EXPIRES-AT>] [--format <OUTPUT-FORMAT>]  # Explicitly import externally refreshed runtime token JSON.
+│   ├── list [SERVICE] [--format <OUTPUT-FORMAT>]  # List runtime token profiles grouped by service.
+│   └── clear <SERVICE> [PROFILE] [--execute] [--format <OUTPUT-FORMAT>]  # Clear a generic runtime token file for SERVICE/PROFILE.
+├── cat [NAME] [--no-mask] [--type <CONFIG-TYPES>]  # Print active values, or a named typed profile with -t TYPE NAME.
+├── get [KEY] [--interactive/--no-interactive]  # Get a configuration value from active typed env files.
+├── set [KEY-VALUE] [--interactive/--no-interactive]  # Set a configuration value in the matching active typed env file.
+├── save [NAME] [--type <CONFIG-TYPES>] [--yes] [--interactive/--no-interactive]  # Save current active values as a named profile.
+├── delete [NAME] [--type <CONFIG-TYPES>] [--yes] [--interactive/--no-interactive]  # Delete a named profile for one config type.
+└── test [--target <TARGET>] [--interactive/--no-interactive]  # Test a registered configuration schema.
+```
+
+## 常用命令
+
+```bash
+chatenv init -t example
+chatenv status --detail
+chatenv cat -t example
+chatenv paste --stdin --profile work --yes
+chatenv set EXAMPLE_API_KEY=sk-xxx
+chatenv get EXAMPLE_API_KEY
+chatenv token refresh PyPI RexWzh
+chatenv token status PyPI RexWzh
+```
+
+敏感值默认 mask；`token status/list/clear` 只输出 safe metadata，不输出 raw token/cookie/CSRF values。
+
+## Python API
+
+```python
+from chatenv import BaseEnvConfig, EnvField, EnvStore, get_paths
+
+class ExampleConfig(BaseEnvConfig):
+    _title = "Example Configuration"
+    _aliases = ["example"]
+    _storage_dir = "Example"
+
+    EXAMPLE_API_KEY = EnvField("EXAMPLE_API_KEY", is_sensitive=True)
+
+paths = get_paths()
+store = EnvStore(paths.envs_dir)
+store.save_active(ExampleConfig, {"EXAMPLE_API_KEY": "sk-..."})
+```
+
+## 文档
+
+- https://arch.gh.wzhecnu.cn/ChatEnv/
+- `docs/cli.md`：CLI 用法
+- `docs/design.md`：路径、数据布局与注册策略
+- `docs/developer-guide.md`：chatxxx 项目接入和 provider 开发指南
+- `docs/development.md`：测试、构建与发布
+
+## 开发
+
+```bash
+python -m pip install -e .[dev,docs]
+python -m pytest -q
+python -m mkdocs build --strict
+python -m build
+python -m twine check dist/*
+```
+
+## 开源协议
+
+MIT License

{chatenv-0.2.7 → chatenv-0.2.8}/src/chatenv.egg-info/SOURCES.txt

@@ -22,4 +22,6 @@ src/chatenv.egg-info/requires.txt
 src/chatenv.egg-info/top_level.txt
 src/chatenv/presets/__init__.py
 tests/test_chatenv_core.py
-tests/test_version.py
+tests/test_docs_contract.py
+tests/test_version.py
+tests/test_workflow_contract.py

{chatenv-0.2.7 → chatenv-0.2.8}/src/chatenv.egg-info/requires.txt

@@ -9,7 +9,8 @@ twine>=5.0
 
 [docs]
 mkdocs<2.0,>=1.6
-mkdocs-material<9.7,>=9.5
+mkdocs-material<10.0,>=9.5
+mkdocs-static-i18n<2.0,>=1.2
 mkdocs-minify-plugin<1.0,>=0.8
 mkdocs-redirects<2.0,>=1.2
 mike<3.0,>=2.1

chatenv-0.2.8/tests/test_docs_contract.py

@@ -0,0 +1,66 @@
+from pathlib import Path
+
+from chatenv.cli import cli, render_cli_tree
+
+
+PUBLIC_DOCS = (
+    "README.md",
+    "README.en.md",
+    "docs/index.md",
+    "docs/index.en.md",
+    "docs/cli.md",
+    "docs/cli.en.md",
+    "docs/design.md",
+    "docs/design.en.md",
+    "docs/developer-guide.md",
+    "docs/developer-guide.en.md",
+    "docs/development.md",
+    "docs/development.en.md",
+)
+
+
+def test_mkdocs_chatarch_i18n_material_contract() -> None:
+    mkdocs = Path("mkdocs.yml").read_text(encoding="utf-8")
+    pyproject = Path("pyproject.toml").read_text(encoding="utf-8")
+
+    assert "site_url: https://arch.gh.wzhecnu.cn/ChatEnv/" in mkdocs
+    assert 'Homepage = "https://arch.gh.wzhecnu.cn/ChatEnv/"' in pyproject
+    assert 'Documentation = "https://arch.gh.wzhecnu.cn/ChatEnv/"' in pyproject
+    assert 'Repository = "https://github.com/ChatArch/ChatEnv"' in pyproject
+    assert "mkdocs-material>=9.5,<10.0" in pyproject
+    assert "mkdocs-static-i18n>=1.2,<2.0" in pyproject
+    assert "name: material" in mkdocs
+    assert "pymdownx.emoji" in mkdocs
+    assert "material.extensions.emoji.twemoji" in mkdocs
+    assert "material.extensions.emoji.to_svg" in mkdocs
+    assert "i18n:" in mkdocs
+    assert "locale: en" in mkdocs
+    assert "/ChatEnv/en/" in mkdocs
+
+
+def test_public_docs_are_bilingual_and_use_chatarch_domain() -> None:
+    for rel in PUBLIC_DOCS:
+        path = Path(rel)
+        assert path.exists(), rel
+        text = path.read_text(encoding="utf-8")
+        assert "chatarch.github.io" not in text, rel
+        assert "github.io" not in text, rel
+        assert "template `hello`" not in text, rel
+
+
+def test_public_docs_keep_live_cli_tree_contract() -> None:
+    live_tree = render_cli_tree(cli)
+    required = [
+        "chatenv [--home <HOME>]  # Manage typed env profiles",
+        "├── token  # Manage generic runtime token profiles.",
+        "│   ├── refresh <SERVICE> [PROFILE]",
+        "│   ├── import <SERVICE> [PROFILE]",
+        "└── test [--target <TARGET>]",
+    ]
+    for rel in ("README.md", "README.en.md", "docs/cli.md", "docs/cli.en.md"):
+        text = Path(rel).read_text(encoding="utf-8")
+        for line in required:
+            assert line in text, f"{rel} missing {line!r}"
+    for line in required:
+        assert line in live_tree
+    assert "hello" not in live_tree.lower()

{chatenv-0.2.7 → chatenv-0.2.8}/tests/test_version.py

@@ -4,7 +4,7 @@ from click.testing import CliRunner
 
 
 def test_version_present():
-    assert __version__ == "0.2.7"
+    assert __version__ == "0.2.8"
 
 
 def test_cli_version_option():

chatenv-0.2.8/tests/test_workflow_contract.py

@@ -0,0 +1,46 @@
+from pathlib import Path
+
+
+def test_ci_workflow_runs_matrix_and_installed_cli_smoke() -> None:
+    workflow = Path(".github/workflows/ci.yml").read_text(encoding="utf-8")
+
+    assert "python-version: [\"3.10\", \"3.11\", \"3.12\"]" in workflow
+    assert "python -m pytest -q" in workflow
+    assert "chatenv --version" in workflow
+    assert "chatenv --tree" in workflow
+    assert "python -m build" in workflow
+    assert "python -m twine check dist/*" in workflow
+    assert "mkdocs build --strict" in workflow
+
+
+def test_publish_workflow_uses_oidc_with_main_release_guard() -> None:
+    workflow = Path(".github/workflows/publish.yml").read_text(encoding="utf-8")
+
+    assert "id-token: write" in workflow
+    assert "pypa/gh-action-pypi-publish@release/v1" in workflow
+    assert "Publish to PyPI (OIDC)" in workflow
+    assert "workflow_dispatch" in workflow
+    assert "Check release commit is on default branch" in workflow
+    assert "git fetch --no-tags origin main:refs/remotes/origin/main" in workflow
+    assert 'git merge-base --is-ancestor "${GITHUB_SHA}" "origin/main"' in workflow
+    assert "git fetch origin main --tags" not in workflow
+    assert "git fetch origin master --tags" not in workflow
+    assert "environment: pypi" not in workflow
+    assert "TWINE_PASSWORD" not in workflow
+    assert "PYPI_API_TOKEN" not in workflow
+    assert "secrets.PYPI" not in workflow
+    assert "https://pypi.org/pypi/chatenv/" in workflow
+
+
+def test_docs_workflows_target_chatarch_pages() -> None:
+    preview = Path(".github/workflows/preview.yaml").read_text(encoding="utf-8")
+    deploy = Path(".github/workflows/deploy.yaml").read_text(encoding="utf-8")
+
+    assert "Preview Docs" in preview
+    assert "CHATARCH_PREVIEW_URL" in preview
+    assert "mike deploy dev" in preview
+    assert "https://arch.gh.wzhecnu.cn/${{ github.event.repository.name }}/dev/" in preview
+    assert "Deploy Docs" in deploy
+    assert "mkdocs gh-deploy --force" in deploy
+    assert "github.io" not in preview
+    assert "github.io" not in deploy

chatenv-0.2.7/PKG-INFO

@@ -1,194 +0,0 @@
-Metadata-Version: 2.4
-Name: chatenv
-Version: 0.2.7
-Summary: ChatArch typed environment profile manager
-Author-email: rexwzh <1073853456@qq.com>
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/ChatArch/ChatEnv
-Project-URL: Repository, https://github.com/ChatArch/ChatEnv
-Project-URL: Documentation, https://chatarch.github.io/ChatEnv/
-Keywords: chatenv,chatarch,env
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: chatstyle<0.2.0,>=0.1.0
-Requires-Dist: click<9.0,>=8.4.2
-Requires-Dist: python-dotenv<2.0,>=1.2.2
-Provides-Extra: dev
-Requires-Dist: build>=1.0; extra == "dev"
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: twine>=5.0; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: mkdocs<2.0,>=1.6; extra == "docs"
-Requires-Dist: mkdocs-material<9.7,>=9.5; extra == "docs"
-Requires-Dist: mkdocs-minify-plugin<1.0,>=0.8; extra == "docs"
-Requires-Dist: mkdocs-redirects<2.0,>=1.2; extra == "docs"
-Requires-Dist: mike<3.0,>=2.1; extra == "docs"
-Dynamic: license-file
-
-<div align="center">
-    <a href="https://pypi.python.org/pypi/chatenv">
-        <img src="https://img.shields.io/pypi/v/chatenv.svg" alt="PyPI version" />
-    </a>
-    <a href="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml">
-        <img src="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml/badge.svg" alt="Tests" />
-    </a>
-    <a href="https://pypi.python.org/pypi/chatenv">
-        <img src="https://img.shields.io/pypi/pyversions/chatenv.svg" alt="Python versions" />
-    </a>
-    <a href="LICENSE">
-        <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" />
-    </a>
-</div>
-
-<div align="center">
-
-# ChatEnv
-
-ChatArch typed env/profile runtime.
-
-</div>
-
-ChatEnv 是 ChatArch / chatxxx 系列项目共用的 typed env/profile 底层包。它提供字段描述、配置基类、registry、路径、profile 文件读写、mask 和 paste 解析等通用能力；同时内置少量跨工具共享 schema（当前为 OpenAI / Feishu）。工具私有变量仍由 ChatTool、ChatDNS 等项目自己定义并注册。
-
-当前设计保持减法：只使用一个根变量 `CHATARCH_HOME`，只管理 env/profile 文件，不额外创建 config/cache/data/state。
-
-支持 Python `>=3.10`。
-
-## 安装
-
-```bash
-pip install chatenv --upgrade
-pip install -e .[dev]       # 仓库开发
-```
-
-## 目录
-
-```text
-CHATARCH_HOME=${CHATARCH_HOME:-~/.chatarch}
-$CHATARCH_HOME/envs/      # stable typed env/profile files
-$CHATARCH_HOME/tokens/    # generated runtime tokens/sessions, parallel to env profiles
-```
-
-实际布局由业务项目注册的 schema 决定，例如：
-
-```text
-~/.chatarch/envs/
-  Example/
-    .env
-    work.env
-```
-
-- `.env` 是当前 active profile；
-- `name.env` 是 named profile；
-- `use` 会把 named profile 复制为 active `.env`。
-
-## CLI 概览
-
-`chatenv` CLI 基于已注册 schema 工作。单独安装且没有项目注册 schema 时，它会提示需要先注册配置类型。业务项目通常会在自己的 CLI 中导入 schema 后复用这些能力。
-
-```bash
-chatenv --version
-chatenv --tree
-chatenv init -t example
-chatenv status
-chatenv status --detail
-chatenv cat -t example
-chatenv cat -t example --no-mask | chatenv paste --stdin --profile work --yes
-chatenv set EXAMPLE_API_KEY=sk-xxx
-chatenv get EXAMPLE_API_KEY
-chatenv new -t example work
-chatenv save -t example work
-chatenv use -t example work
-chatenv delete -t example work
-```
-
-单次命令可通过 `--home` 覆盖根目录：
-
-```bash
-chatenv --home /tmp/chatarch cat -t example
-```
-
-缺少必要命令参数时，ChatEnv 默认会在可交互终端中自动补问；显式 `-i` 始终强制补问，`-I` 始终禁用补问。自动化环境可设置：
-
-```bash
-export CHATARCH_AUTO_PROMPT=false
-```
-
-此时只有缺少必要参数的命令会直接报错；参数已经足够的命令行为不变。
-
-`chatenv --tree` 可从当前安装包的 Click 注册表实时输出完整命令树，用于验收和脚本 readback。
-
-更多用法见 `docs/cli.md`。
-
-## Runtime tokens
-
-ChatEnv 区分 stable env/profile 和动态 runtime token：
-
-- `envs/<Service>/<profile>.env` 保存可长期维护的稳定配置，例如 base URL、账号、API key 或 refresh/login 所需输入；
-- `tokens/<Service>/<profile>.json` 保存由登录或刷新流程生成的 access token、session、cookie/CSRF 等运行态；
-- `chatenv token refresh SERVICE PROFILE` 会调用服务包通过 `chatenv.token_refreshers` 注册的刷新器，自动生成并更新 token-store；
-- 手工 JSON 写入只保留为显式 `chatenv token import ... --stdin/--file`，用于迁移、调试或外部刷新器交接，不应作为日常维护入口。
-
-ChatEnv 只负责路径、profile 校验、原子写入和 safe status/list/clear；具体登录、OAuth refresh、cookie 刷新等业务语义仍由 leaf package 负责。
-
-## Paste
-
-`paste` 是跨设备复制密钥的核心入口。输入不要求是严格 dotenv 文件，会从终端日志、shell prompt、复制文本里提取已注册 key；同一行里用空格分隔的多个 `KEY='VALUE'` 片段也会被逐个识别。
-
-```bash
-chatenv paste
-chatenv paste --stdin --profile work
-chatenv paste --value "EXAMPLE_API_KEY='sk-xxx'" --yes
-chatenv paste --value "EXAMPLE_MODEL='gpt example' EXAMPLE_API_KEY='sk-xxx'" --yes
-```
-
-写入前会输出识别概要：识别到哪些类型、哪些 key、未知 key 被忽略。
-
-## Python API
-
-```python
-from chatenv import BaseEnvConfig, EnvField, EnvStore, get_paths
-
-class ExampleConfig(BaseEnvConfig):
-    _title = "Example Configuration"
-    _aliases = ["example"]
-    _storage_dir = "Example"
-
-    EXAMPLE_API_KEY = EnvField("EXAMPLE_API_KEY", is_sensitive=True)
-
-paths = get_paths()
-store = EnvStore(paths.envs_dir)
-store.save_active(ExampleConfig, {"EXAMPLE_API_KEY": "sk-..."})
-```
-
-## 文档
-
-- `docs/cli.md`：CLI 用法
-- `docs/design.md`：路径、数据布局与注册策略
-- `docs/developer-guide.md`：chatxxx 项目接入和 provider 开发指南
-- `docs/development.md`：测试、构建与发布
-- `mkdocs.yml`：Material for MkDocs 文档站点配置
-
-## 开发
-
-```bash
-python -m pytest -q
-python -m build
-python -m twine check dist/*
-python -m pip install -e .[docs]
-python -m mkdocs serve
-```
-
-也可以用 ChatTool helper：
-
-```bash
-chattool pypi build --project-dir .
-chattool pypi check --project-dir .
-```
-
-## 开源协议
-
-MIT License

chatenv-0.2.7/README.md

@@ -1,164 +0,0 @@
-<div align="center">
-    <a href="https://pypi.python.org/pypi/chatenv">
-        <img src="https://img.shields.io/pypi/v/chatenv.svg" alt="PyPI version" />
-    </a>
-    <a href="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml">
-        <img src="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml/badge.svg" alt="Tests" />
-    </a>
-    <a href="https://pypi.python.org/pypi/chatenv">
-        <img src="https://img.shields.io/pypi/pyversions/chatenv.svg" alt="Python versions" />
-    </a>
-    <a href="LICENSE">
-        <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" />
-    </a>
-</div>
-
-<div align="center">
-
-# ChatEnv
-
-ChatArch typed env/profile runtime.
-
-</div>
-
-ChatEnv 是 ChatArch / chatxxx 系列项目共用的 typed env/profile 底层包。它提供字段描述、配置基类、registry、路径、profile 文件读写、mask 和 paste 解析等通用能力；同时内置少量跨工具共享 schema（当前为 OpenAI / Feishu）。工具私有变量仍由 ChatTool、ChatDNS 等项目自己定义并注册。
-
-当前设计保持减法：只使用一个根变量 `CHATARCH_HOME`，只管理 env/profile 文件，不额外创建 config/cache/data/state。
-
-支持 Python `>=3.10`。
-
-## 安装
-
-```bash
-pip install chatenv --upgrade
-pip install -e .[dev]       # 仓库开发
-```
-
-## 目录
-
-```text
-CHATARCH_HOME=${CHATARCH_HOME:-~/.chatarch}
-$CHATARCH_HOME/envs/      # stable typed env/profile files
-$CHATARCH_HOME/tokens/    # generated runtime tokens/sessions, parallel to env profiles
-```
-
-实际布局由业务项目注册的 schema 决定，例如：
-
-```text
-~/.chatarch/envs/
-  Example/
-    .env
-    work.env
-```
-
-- `.env` 是当前 active profile；
-- `name.env` 是 named profile；
-- `use` 会把 named profile 复制为 active `.env`。
-
-## CLI 概览
-
-`chatenv` CLI 基于已注册 schema 工作。单独安装且没有项目注册 schema 时，它会提示需要先注册配置类型。业务项目通常会在自己的 CLI 中导入 schema 后复用这些能力。
-
-```bash
-chatenv --version
-chatenv --tree
-chatenv init -t example
-chatenv status
-chatenv status --detail
-chatenv cat -t example
-chatenv cat -t example --no-mask | chatenv paste --stdin --profile work --yes
-chatenv set EXAMPLE_API_KEY=sk-xxx
-chatenv get EXAMPLE_API_KEY
-chatenv new -t example work
-chatenv save -t example work
-chatenv use -t example work
-chatenv delete -t example work
-```
-
-单次命令可通过 `--home` 覆盖根目录：
-
-```bash
-chatenv --home /tmp/chatarch cat -t example
-```
-
-缺少必要命令参数时，ChatEnv 默认会在可交互终端中自动补问；显式 `-i` 始终强制补问，`-I` 始终禁用补问。自动化环境可设置：
-
-```bash
-export CHATARCH_AUTO_PROMPT=false
-```
-
-此时只有缺少必要参数的命令会直接报错；参数已经足够的命令行为不变。
-
-`chatenv --tree` 可从当前安装包的 Click 注册表实时输出完整命令树，用于验收和脚本 readback。
-
-更多用法见 `docs/cli.md`。
-
-## Runtime tokens
-
-ChatEnv 区分 stable env/profile 和动态 runtime token：
-
-- `envs/<Service>/<profile>.env` 保存可长期维护的稳定配置，例如 base URL、账号、API key 或 refresh/login 所需输入；
-- `tokens/<Service>/<profile>.json` 保存由登录或刷新流程生成的 access token、session、cookie/CSRF 等运行态；
-- `chatenv token refresh SERVICE PROFILE` 会调用服务包通过 `chatenv.token_refreshers` 注册的刷新器，自动生成并更新 token-store；
-- 手工 JSON 写入只保留为显式 `chatenv token import ... --stdin/--file`，用于迁移、调试或外部刷新器交接，不应作为日常维护入口。
-
-ChatEnv 只负责路径、profile 校验、原子写入和 safe status/list/clear；具体登录、OAuth refresh、cookie 刷新等业务语义仍由 leaf package 负责。
-
-## Paste
-
-`paste` 是跨设备复制密钥的核心入口。输入不要求是严格 dotenv 文件，会从终端日志、shell prompt、复制文本里提取已注册 key；同一行里用空格分隔的多个 `KEY='VALUE'` 片段也会被逐个识别。
-
-```bash
-chatenv paste
-chatenv paste --stdin --profile work
-chatenv paste --value "EXAMPLE_API_KEY='sk-xxx'" --yes
-chatenv paste --value "EXAMPLE_MODEL='gpt example' EXAMPLE_API_KEY='sk-xxx'" --yes
-```
-
-写入前会输出识别概要：识别到哪些类型、哪些 key、未知 key 被忽略。
-
-## Python API
-
-```python
-from chatenv import BaseEnvConfig, EnvField, EnvStore, get_paths
-
-class ExampleConfig(BaseEnvConfig):
-    _title = "Example Configuration"
-    _aliases = ["example"]
-    _storage_dir = "Example"
-
-    EXAMPLE_API_KEY = EnvField("EXAMPLE_API_KEY", is_sensitive=True)
-
-paths = get_paths()
-store = EnvStore(paths.envs_dir)
-store.save_active(ExampleConfig, {"EXAMPLE_API_KEY": "sk-..."})
-```
-
-## 文档
-
-- `docs/cli.md`：CLI 用法
-- `docs/design.md`：路径、数据布局与注册策略
-- `docs/developer-guide.md`：chatxxx 项目接入和 provider 开发指南
-- `docs/development.md`：测试、构建与发布
-- `mkdocs.yml`：Material for MkDocs 文档站点配置
-
-## 开发
-
-```bash
-python -m pytest -q
-python -m build
-python -m twine check dist/*
-python -m pip install -e .[docs]
-python -m mkdocs serve
-```
-
-也可以用 ChatTool helper：
-
-```bash
-chattool pypi build --project-dir .
-chattool pypi check --project-dir .
-```
-
-## 开源协议
-
-MIT License

chatenv-0.2.7/src/chatenv.egg-info/PKG-INFO

@@ -1,194 +0,0 @@
-Metadata-Version: 2.4
-Name: chatenv
-Version: 0.2.7
-Summary: ChatArch typed environment profile manager
-Author-email: rexwzh <1073853456@qq.com>
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/ChatArch/ChatEnv
-Project-URL: Repository, https://github.com/ChatArch/ChatEnv
-Project-URL: Documentation, https://chatarch.github.io/ChatEnv/
-Keywords: chatenv,chatarch,env
-Classifier: Programming Language :: Python :: 3
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: chatstyle<0.2.0,>=0.1.0
-Requires-Dist: click<9.0,>=8.4.2
-Requires-Dist: python-dotenv<2.0,>=1.2.2
-Provides-Extra: dev
-Requires-Dist: build>=1.0; extra == "dev"
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: twine>=5.0; extra == "dev"
-Provides-Extra: docs
-Requires-Dist: mkdocs<2.0,>=1.6; extra == "docs"
-Requires-Dist: mkdocs-material<9.7,>=9.5; extra == "docs"
-Requires-Dist: mkdocs-minify-plugin<1.0,>=0.8; extra == "docs"
-Requires-Dist: mkdocs-redirects<2.0,>=1.2; extra == "docs"
-Requires-Dist: mike<3.0,>=2.1; extra == "docs"
-Dynamic: license-file
-
-<div align="center">
-    <a href="https://pypi.python.org/pypi/chatenv">
-        <img src="https://img.shields.io/pypi/v/chatenv.svg" alt="PyPI version" />
-    </a>
-    <a href="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml">
-        <img src="https://github.com/ChatArch/ChatEnv/actions/workflows/ci.yml/badge.svg" alt="Tests" />
-    </a>
-    <a href="https://pypi.python.org/pypi/chatenv">
-        <img src="https://img.shields.io/pypi/pyversions/chatenv.svg" alt="Python versions" />
-    </a>
-    <a href="LICENSE">
-        <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License" />
-    </a>
-</div>
-
-<div align="center">
-
-# ChatEnv
-
-ChatArch typed env/profile runtime.
-
-</div>
-
-ChatEnv 是 ChatArch / chatxxx 系列项目共用的 typed env/profile 底层包。它提供字段描述、配置基类、registry、路径、profile 文件读写、mask 和 paste 解析等通用能力；同时内置少量跨工具共享 schema（当前为 OpenAI / Feishu）。工具私有变量仍由 ChatTool、ChatDNS 等项目自己定义并注册。
-
-当前设计保持减法：只使用一个根变量 `CHATARCH_HOME`，只管理 env/profile 文件，不额外创建 config/cache/data/state。
-
-支持 Python `>=3.10`。
-
-## 安装
-
-```bash
-pip install chatenv --upgrade
-pip install -e .[dev]       # 仓库开发
-```
-
-## 目录
-
-```text
-CHATARCH_HOME=${CHATARCH_HOME:-~/.chatarch}
-$CHATARCH_HOME/envs/      # stable typed env/profile files
-$CHATARCH_HOME/tokens/    # generated runtime tokens/sessions, parallel to env profiles
-```
-
-实际布局由业务项目注册的 schema 决定，例如：
-
-```text
-~/.chatarch/envs/
-  Example/
-    .env
-    work.env
-```
-
-- `.env` 是当前 active profile；
-- `name.env` 是 named profile；
-- `use` 会把 named profile 复制为 active `.env`。
-
-## CLI 概览
-
-`chatenv` CLI 基于已注册 schema 工作。单独安装且没有项目注册 schema 时，它会提示需要先注册配置类型。业务项目通常会在自己的 CLI 中导入 schema 后复用这些能力。
-
-```bash
-chatenv --version
-chatenv --tree
-chatenv init -t example
-chatenv status
-chatenv status --detail
-chatenv cat -t example
-chatenv cat -t example --no-mask | chatenv paste --stdin --profile work --yes
-chatenv set EXAMPLE_API_KEY=sk-xxx
-chatenv get EXAMPLE_API_KEY
-chatenv new -t example work
-chatenv save -t example work
-chatenv use -t example work
-chatenv delete -t example work
-```
-
-单次命令可通过 `--home` 覆盖根目录：
-
-```bash
-chatenv --home /tmp/chatarch cat -t example
-```
-
-缺少必要命令参数时，ChatEnv 默认会在可交互终端中自动补问；显式 `-i` 始终强制补问，`-I` 始终禁用补问。自动化环境可设置：
-
-```bash
-export CHATARCH_AUTO_PROMPT=false
-```
-
-此时只有缺少必要参数的命令会直接报错；参数已经足够的命令行为不变。
-
-`chatenv --tree` 可从当前安装包的 Click 注册表实时输出完整命令树，用于验收和脚本 readback。
-
-更多用法见 `docs/cli.md`。
-
-## Runtime tokens
-
-ChatEnv 区分 stable env/profile 和动态 runtime token：
-
-- `envs/<Service>/<profile>.env` 保存可长期维护的稳定配置，例如 base URL、账号、API key 或 refresh/login 所需输入；
-- `tokens/<Service>/<profile>.json` 保存由登录或刷新流程生成的 access token、session、cookie/CSRF 等运行态；
-- `chatenv token refresh SERVICE PROFILE` 会调用服务包通过 `chatenv.token_refreshers` 注册的刷新器，自动生成并更新 token-store；
-- 手工 JSON 写入只保留为显式 `chatenv token import ... --stdin/--file`，用于迁移、调试或外部刷新器交接，不应作为日常维护入口。
-
-ChatEnv 只负责路径、profile 校验、原子写入和 safe status/list/clear；具体登录、OAuth refresh、cookie 刷新等业务语义仍由 leaf package 负责。
-
-## Paste
-
-`paste` 是跨设备复制密钥的核心入口。输入不要求是严格 dotenv 文件，会从终端日志、shell prompt、复制文本里提取已注册 key；同一行里用空格分隔的多个 `KEY='VALUE'` 片段也会被逐个识别。
-
-```bash
-chatenv paste
-chatenv paste --stdin --profile work
-chatenv paste --value "EXAMPLE_API_KEY='sk-xxx'" --yes
-chatenv paste --value "EXAMPLE_MODEL='gpt example' EXAMPLE_API_KEY='sk-xxx'" --yes
-```
-
-写入前会输出识别概要：识别到哪些类型、哪些 key、未知 key 被忽略。
-
-## Python API
-
-```python
-from chatenv import BaseEnvConfig, EnvField, EnvStore, get_paths
-
-class ExampleConfig(BaseEnvConfig):
-    _title = "Example Configuration"
-    _aliases = ["example"]
-    _storage_dir = "Example"
-
-    EXAMPLE_API_KEY = EnvField("EXAMPLE_API_KEY", is_sensitive=True)
-
-paths = get_paths()
-store = EnvStore(paths.envs_dir)
-store.save_active(ExampleConfig, {"EXAMPLE_API_KEY": "sk-..."})
-```
-
-## 文档
-
-- `docs/cli.md`：CLI 用法
-- `docs/design.md`：路径、数据布局与注册策略
-- `docs/developer-guide.md`：chatxxx 项目接入和 provider 开发指南
-- `docs/development.md`：测试、构建与发布
-- `mkdocs.yml`：Material for MkDocs 文档站点配置
-
-## 开发
-
-```bash
-python -m pytest -q
-python -m build
-python -m twine check dist/*
-python -m pip install -e .[docs]
-python -m mkdocs serve
-```
-
-也可以用 ChatTool helper：
-
-```bash
-chattool pypi build --project-dir .
-chattool pypi check --project-dir .
-```
-
-## 开源协议
-
-MIT License