deepseek-team 0.8.1__tar.gz

deepseek_team-0.8.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 kirill31337
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

deepseek_team-0.8.1/MANIFEST.in

@@ -0,0 +1,8 @@
+include LICENSE README.md
+include README.ru.md docs/ROUTING.md docs/ROUTING.ru.md
+include docs/PUBLISHING.md
+recursive-include docs/releases *.md
+include scripts/check_installation.py
+recursive-include tests *.py
+recursive-include src/codex_deepseek_team/data *.md
+recursive-include src/codex_deepseek_team/data/apparmor *

deepseek_team-0.8.1/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: deepseek-team
+Version: 0.8.1
+Summary: Delegate bounded coding tasks from Codex and/or Claude Code to isolated DeepSeek workers.
+Author: kirill31337
+License-Expression: MIT
+Project-URL: Documentation, https://github.com/kirill31337/deepseek-team#quick-start
+Project-URL: Changelog, https://github.com/kirill31337/deepseek-team/releases
+Project-URL: Repository, https://github.com/kirill31337/deepseek-team
+Project-URL: Issues, https://github.com/kirill31337/deepseek-team/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: Software Development
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+![DeepSeek Team banner](https://raw.githubusercontent.com/kirill31337/deepseek-team/main/assets/deepseek-team-banner-4b37ec05.jpg)
+
+# DeepSeek Team
+
+**English** | [Русский](https://github.com/kirill31337/deepseek-team/blob/main/README.ru.md)
+
+DeepSeek Team lets **Codex and Claude Code** delegate implementation, tests, documentation and research to isolated **DeepSeek workers**. The coordinator plans the work, reviews the results and integrates accepted changes. Workers handle independent tasks; full-access jobs use their own development copies.
+
+Workers always run the `deepseek-flash` model. Effort policy is `auto`, so the coordinator chooses `low`, `medium` or `high` for each assignment unless you save a fixed level. Live delegation needs its own **DeepSeek API key**; DeepSeek Team does not reuse the credentials your coordinator already has.
+
+This README describes version **0.8.1** of the `deepseek-team` package, which installs the single `deepseek-team` executable.
+
+## Prerequisites
+
+- **Linux.** Native Windows and macOS are not supported.
+- **Python 3.11 or newer** and **Git** on `PATH`.
+- **Codex CLI and/or Claude Code CLI** on `PATH`, normally configured. Install whichever coordinator you intend to use; `both` covers both.
+- **Bubblewrap** (`bwrap`) and a working Linux OS sandbox. Every worker needs it before any credential is read, and it cannot be turned off.
+
+On Ubuntu, `setup --with-sandbox` can install the required system components (see below). On other distributions, install Bubblewrap and any AppArmor prerequisites with your own package manager first, then check `deepseek-team sandbox status`.
+
+## Install
+
+Version 0.8.1 is published on [PyPI](https://pypi.org/project/deepseek-team/), so install the released package by name. [pipx](https://pipx.pypa.io/latest/how-to/install-pipx.html) keeps the CLI in its own environment and is the recommended route:
+
+```bash
+sudo apt-get install pipx      # Ubuntu, once
+pipx ensurepath
+# Open a new terminal so PATH is refreshed.
+pipx install deepseek-team
+```
+
+Compact alternatives, if you already prefer another manager:
+
+```bash
+# uv
+uv tool install deepseek-team
+
+# pip inside a virtual environment only
+python3 -m venv ~/venvs/deepseek-team
+. ~/venvs/deepseek-team/bin/activate
+python -m pip install deepseek-team
+```
+
+To install from a local checkout instead:
+
+```bash
+git clone https://github.com/kirill31337/deepseek-team.git
+cd deepseek-team
+pipx install .
+```
+
+## Quick start
+
+`setup` prepares your user-level integration. `init` then attaches the Git project where you want to use delegation.
+
+```bash
+# 1. Prepare the user-level integration for Codex. --no-key defers the credential.
+deepseek-team setup --runtime codex --no-key
+
+# 2. Store the DeepSeek API key. The prompt is hidden; the key is never echoed.
+deepseek-team auth set
+
+# 3. Attach a project so its coordinator reads the delegation instructions.
+cd /path/to/project
+deepseek-team init --coordinator codex .
+
+# 4. Optional: allow implementation inside an isolated development copy.
+deepseek-team config set --project --access full-access
+
+# 5. Confirm local readiness. This stays offline: no key is read and no request is sent.
+deepseek-team doctor --runtime codex --offline
+```
+
+A few notes:
+
+- `--no-key` deliberately defers authentication so `setup` never prompts for or reads a secret. Store the key separately with `deepseek-team auth set`, or omit `--no-key` on a terminal when you are ready.
+- Fresh access defaults are **read-only**. Step 4 lets Auto delegate implementation by explicitly granting write access. Full-access means a private, owned development copy, not the host system.
+- On Ubuntu, the very first setup may need to install the sandbox package and a named AppArmor profile. Use `deepseek-team setup --runtime codex --with-sandbox --no-key` for that explicit, administrator-authorized step. Ordinary setup never invokes `sudo`; on other distributions install the system prerequisites yourself.
+- For Claude Code, substitute `claude` for `codex` in `--runtime` and `--coordinator`, or pass `both` to prepare both coordinators.
+- Codex owns native hook trust: review and trust the installed hook once with `/hooks`. In Claude Code, start a fresh session and check `/hooks` there.
+
+## What gets delegated
+
+Auto delegation admits suitable work immediately; it does not wait for prior history to accumulate. A task is a good candidate when it is:
+
+- small or medium, with low or medium risk;
+- localized to a known or partially known place, with local or component-level coupling;
+- clear about acceptance, with a way to check the result.
+
+Implementation needs an executable check - tests, a build or a reproducer. Review, research and documentation tasks may use manual acceptance criteria instead. Unknown costs never block eligible work, and the coordinator keeps anything whose measured economics do not justify delegation.
+
+The coordinator records what actually happened after reviewing the real diff and the declared checks. One rework is recorded without pausing anything; a rejection, or three distinct recent reworks, pauses only that task family for 300 seconds. Failed implementation is never retried automatically.
+
+Access is independent of effort and history:
+
+- **Read-only** (fresh default): workers inspect and report, and cannot modify the project.
+- **Full-access** (explicit): workers implement, run local checks and write documentation inside an isolated copy owned by the job.
+
+Workers never commit, push, publish, deploy, touch production services or spawn further agents. Those remain coordinator actions.
+
+## Asking for help in a session
+
+Once setup and attachment are done, you do not run workers by hand. Ask in your normal coordinator session, in plain language:
+
+> Implement the new cache layer under `src/cache/`. Delegate the independent implementation and its tests to DeepSeek workers, run the test suite inside the worker copies, and integrate only what you have verified. Keep the public API stable and show me the final diff before you commit.
+
+The coordinator splits that into bounded assignments, runs them through the worker queue and reports the accepted work.
+
+Final-summary guidance ships with the package for both Codex and Claude Code. While DeepSeek Team is enabled, summaries of performed work include short bullets separating the coordinator's personal work from accepted DeepSeek results, including any rework or failed attempts. They cover the reported task across turns; native subagents are credited separately, and no delegation is stated explicitly.
+
+After the list comes an approximate coordinator/DeepSeek split in whole-number percentages totaling 100, labelled **“subjective estimate, not measured.”** It reflects accepted scope, complexity, review and rework, never counts of calls, tasks, files, lines, tokens, time or bullets, and never the configured 25/50/75 target or claimed savings. Without accepted worker work the split is 100/0; if evidence is insufficient, the estimate is unavailable. Status-only and no-work replies need no report, and `off` disables the requirement. Updating the package refreshes hook guidance; refresh existing project instructions with `deepseek-team init --coordinator both /path/to/project` (use `codex` or `claude` for a single coordinator).
+
+## Current defaults
+
+| Setting | Current default | Notes |
+| --- | --- | --- |
+| Delegation | `auto` | Chooses the executor per task; no fixed quota. |
+| Access | `auto` -> read-only in Auto | Full-access enables isolated implementation. |
+| Model | `deepseek-flash` | Fixed for all workers. |
+| Effort | `auto` | Coordinator picks `low`/`medium`/`high` per assignment. |
+| Workers | `8` | Configurable 1-64; further jobs queue FIFO. |
+| Total timeout | unlimited | An explicit timeout also includes queue time. |
+
+Inspect or change the settings per project:
+
+```bash
+deepseek-team config show --effective
+deepseek-team config set --project --max-workers 8
+deepseek-team on      # enable delegation for this project
+deepseek-team off     # disable it without deleting settings
+deepseek-team status  # show the saved and effective state
+```
+
+The optional manual **25/50/75** profiles are target distributions, not measured quotas. With `access=auto`, profile 25 uses read-only and profiles 50/75 use full-access. An explicitly saved `read-only` setting always takes priority. See the [routing guide](https://github.com/kirill31337/deepseek-team/blob/main/docs/ROUTING.md) for how admission, evidence and feedback work.
+
+## Isolation
+
+Workers require the Linux OS sandbox. Full-access work runs in an owned development copy with restricted filesystem and network access. The coordinator retains architecture, security decisions, final verification and integration.
+
+Read-only and full-access workers have different isolation boundaries; see [Hardening](https://github.com/kirill31337/deepseek-team/blob/main/docs/HARDENING.md) for the exact filesystem, credential and network rules.
+
+## Diagnostics
+
+```bash
+deepseek-team doctor --runtime codex --offline   # local readiness; no key read
+deepseek-team hooks status --runtime codex      # whether managed hooks are installed
+deepseek-team sandbox status                    # Bubblewrap and AppArmor backend
+deepseek-team auth status                       # whether a saved key exists
+```
+
+These checks make no provider requests. Local readiness does not validate the key with DeepSeek; live worker requests use your DeepSeek API account.
+
+## Update and uninstall
+
+Upgrade the released package through the same manager, then re-run the local setup steps:
+
+```bash
+pipx upgrade deepseek-team
+deepseek-team setup --runtime codex --no-key
+cd /path/to/project
+deepseek-team init --coordinator codex .
+deepseek-team doctor --runtime codex --offline
+```
+
+Run `init` for each attached project to refresh its managed instructions; your own instruction text and saved preferences are preserved. With uv, use `uv tool upgrade deepseek-team`. In a virtual environment, use its `python -m pip install --upgrade deepseek-team`. Keep one install channel per machine; a local-clone pipx installation is refreshed with `pipx install --force .` from the updated clone.
+
+To remove DeepSeek Team, detach each project before uninstalling. If you also want to delete the saved DeepSeek key, run `deepseek-team auth remove` while the command is still installed.
+
+```bash
+deepseek-team detach --coordinator codex /path/to/project   # for each attached project
+deepseek-team reset --runtime codex                         # remove managed integration
+pipx uninstall deepseek-team
+```
+
+`detach` preserves your own instruction content, and `reset` removes only the package-owned provider block and hooks; your primary authentication and unrelated configuration are kept. Saved keys are **not** deleted by uninstall. For uv use `uv tool uninstall deepseek-team`; for a venv use its `python -m pip uninstall deepseek-team`. Substitute `claude` or `both` for `codex` wherever your runtime differs.
+
+## Further reading
+
+- [Routing guide](https://github.com/kirill31337/deepseek-team/blob/main/docs/ROUTING.md) - admission, evidence and feedback.
+- [Hardening](https://github.com/kirill31337/deepseek-team/blob/main/docs/HARDENING.md) - coordinator and worker boundaries.
+- [Publishing](https://github.com/kirill31337/deepseek-team/blob/main/docs/PUBLISHING.md) - release-maintainer details.
+- [0.8.1 release notes](https://github.com/kirill31337/deepseek-team/blob/main/docs/releases/0.8.1.md)
+- Russian README: [README.ru.md](https://github.com/kirill31337/deepseek-team/blob/main/README.ru.md)
+
+## License
+
+[MIT](https://github.com/kirill31337/deepseek-team/blob/main/LICENSE), copyright 2026 kirill31337.

deepseek_team-0.8.1/README.md

@@ -0,0 +1,188 @@
+![DeepSeek Team banner](https://raw.githubusercontent.com/kirill31337/deepseek-team/main/assets/deepseek-team-banner-4b37ec05.jpg)
+
+# DeepSeek Team
+
+**English** | [Русский](https://github.com/kirill31337/deepseek-team/blob/main/README.ru.md)
+
+DeepSeek Team lets **Codex and Claude Code** delegate implementation, tests, documentation and research to isolated **DeepSeek workers**. The coordinator plans the work, reviews the results and integrates accepted changes. Workers handle independent tasks; full-access jobs use their own development copies.
+
+Workers always run the `deepseek-flash` model. Effort policy is `auto`, so the coordinator chooses `low`, `medium` or `high` for each assignment unless you save a fixed level. Live delegation needs its own **DeepSeek API key**; DeepSeek Team does not reuse the credentials your coordinator already has.
+
+This README describes version **0.8.1** of the `deepseek-team` package, which installs the single `deepseek-team` executable.
+
+## Prerequisites
+
+- **Linux.** Native Windows and macOS are not supported.
+- **Python 3.11 or newer** and **Git** on `PATH`.
+- **Codex CLI and/or Claude Code CLI** on `PATH`, normally configured. Install whichever coordinator you intend to use; `both` covers both.
+- **Bubblewrap** (`bwrap`) and a working Linux OS sandbox. Every worker needs it before any credential is read, and it cannot be turned off.
+
+On Ubuntu, `setup --with-sandbox` can install the required system components (see below). On other distributions, install Bubblewrap and any AppArmor prerequisites with your own package manager first, then check `deepseek-team sandbox status`.
+
+## Install
+
+Version 0.8.1 is published on [PyPI](https://pypi.org/project/deepseek-team/), so install the released package by name. [pipx](https://pipx.pypa.io/latest/how-to/install-pipx.html) keeps the CLI in its own environment and is the recommended route:
+
+```bash
+sudo apt-get install pipx      # Ubuntu, once
+pipx ensurepath
+# Open a new terminal so PATH is refreshed.
+pipx install deepseek-team
+```
+
+Compact alternatives, if you already prefer another manager:
+
+```bash
+# uv
+uv tool install deepseek-team
+
+# pip inside a virtual environment only
+python3 -m venv ~/venvs/deepseek-team
+. ~/venvs/deepseek-team/bin/activate
+python -m pip install deepseek-team
+```
+
+To install from a local checkout instead:
+
+```bash
+git clone https://github.com/kirill31337/deepseek-team.git
+cd deepseek-team
+pipx install .
+```
+
+## Quick start
+
+`setup` prepares your user-level integration. `init` then attaches the Git project where you want to use delegation.
+
+```bash
+# 1. Prepare the user-level integration for Codex. --no-key defers the credential.
+deepseek-team setup --runtime codex --no-key
+
+# 2. Store the DeepSeek API key. The prompt is hidden; the key is never echoed.
+deepseek-team auth set
+
+# 3. Attach a project so its coordinator reads the delegation instructions.
+cd /path/to/project
+deepseek-team init --coordinator codex .
+
+# 4. Optional: allow implementation inside an isolated development copy.
+deepseek-team config set --project --access full-access
+
+# 5. Confirm local readiness. This stays offline: no key is read and no request is sent.
+deepseek-team doctor --runtime codex --offline
+```
+
+A few notes:
+
+- `--no-key` deliberately defers authentication so `setup` never prompts for or reads a secret. Store the key separately with `deepseek-team auth set`, or omit `--no-key` on a terminal when you are ready.
+- Fresh access defaults are **read-only**. Step 4 lets Auto delegate implementation by explicitly granting write access. Full-access means a private, owned development copy, not the host system.
+- On Ubuntu, the very first setup may need to install the sandbox package and a named AppArmor profile. Use `deepseek-team setup --runtime codex --with-sandbox --no-key` for that explicit, administrator-authorized step. Ordinary setup never invokes `sudo`; on other distributions install the system prerequisites yourself.
+- For Claude Code, substitute `claude` for `codex` in `--runtime` and `--coordinator`, or pass `both` to prepare both coordinators.
+- Codex owns native hook trust: review and trust the installed hook once with `/hooks`. In Claude Code, start a fresh session and check `/hooks` there.
+
+## What gets delegated
+
+Auto delegation admits suitable work immediately; it does not wait for prior history to accumulate. A task is a good candidate when it is:
+
+- small or medium, with low or medium risk;
+- localized to a known or partially known place, with local or component-level coupling;
+- clear about acceptance, with a way to check the result.
+
+Implementation needs an executable check - tests, a build or a reproducer. Review, research and documentation tasks may use manual acceptance criteria instead. Unknown costs never block eligible work, and the coordinator keeps anything whose measured economics do not justify delegation.
+
+The coordinator records what actually happened after reviewing the real diff and the declared checks. One rework is recorded without pausing anything; a rejection, or three distinct recent reworks, pauses only that task family for 300 seconds. Failed implementation is never retried automatically.
+
+Access is independent of effort and history:
+
+- **Read-only** (fresh default): workers inspect and report, and cannot modify the project.
+- **Full-access** (explicit): workers implement, run local checks and write documentation inside an isolated copy owned by the job.
+
+Workers never commit, push, publish, deploy, touch production services or spawn further agents. Those remain coordinator actions.
+
+## Asking for help in a session
+
+Once setup and attachment are done, you do not run workers by hand. Ask in your normal coordinator session, in plain language:
+
+> Implement the new cache layer under `src/cache/`. Delegate the independent implementation and its tests to DeepSeek workers, run the test suite inside the worker copies, and integrate only what you have verified. Keep the public API stable and show me the final diff before you commit.
+
+The coordinator splits that into bounded assignments, runs them through the worker queue and reports the accepted work.
+
+Final-summary guidance ships with the package for both Codex and Claude Code. While DeepSeek Team is enabled, summaries of performed work include short bullets separating the coordinator's personal work from accepted DeepSeek results, including any rework or failed attempts. They cover the reported task across turns; native subagents are credited separately, and no delegation is stated explicitly.
+
+After the list comes an approximate coordinator/DeepSeek split in whole-number percentages totaling 100, labelled **“subjective estimate, not measured.”** It reflects accepted scope, complexity, review and rework, never counts of calls, tasks, files, lines, tokens, time or bullets, and never the configured 25/50/75 target or claimed savings. Without accepted worker work the split is 100/0; if evidence is insufficient, the estimate is unavailable. Status-only and no-work replies need no report, and `off` disables the requirement. Updating the package refreshes hook guidance; refresh existing project instructions with `deepseek-team init --coordinator both /path/to/project` (use `codex` or `claude` for a single coordinator).
+
+## Current defaults
+
+| Setting | Current default | Notes |
+| --- | --- | --- |
+| Delegation | `auto` | Chooses the executor per task; no fixed quota. |
+| Access | `auto` -> read-only in Auto | Full-access enables isolated implementation. |
+| Model | `deepseek-flash` | Fixed for all workers. |
+| Effort | `auto` | Coordinator picks `low`/`medium`/`high` per assignment. |
+| Workers | `8` | Configurable 1-64; further jobs queue FIFO. |
+| Total timeout | unlimited | An explicit timeout also includes queue time. |
+
+Inspect or change the settings per project:
+
+```bash
+deepseek-team config show --effective
+deepseek-team config set --project --max-workers 8
+deepseek-team on      # enable delegation for this project
+deepseek-team off     # disable it without deleting settings
+deepseek-team status  # show the saved and effective state
+```
+
+The optional manual **25/50/75** profiles are target distributions, not measured quotas. With `access=auto`, profile 25 uses read-only and profiles 50/75 use full-access. An explicitly saved `read-only` setting always takes priority. See the [routing guide](https://github.com/kirill31337/deepseek-team/blob/main/docs/ROUTING.md) for how admission, evidence and feedback work.
+
+## Isolation
+
+Workers require the Linux OS sandbox. Full-access work runs in an owned development copy with restricted filesystem and network access. The coordinator retains architecture, security decisions, final verification and integration.
+
+Read-only and full-access workers have different isolation boundaries; see [Hardening](https://github.com/kirill31337/deepseek-team/blob/main/docs/HARDENING.md) for the exact filesystem, credential and network rules.
+
+## Diagnostics
+
+```bash
+deepseek-team doctor --runtime codex --offline   # local readiness; no key read
+deepseek-team hooks status --runtime codex      # whether managed hooks are installed
+deepseek-team sandbox status                    # Bubblewrap and AppArmor backend
+deepseek-team auth status                       # whether a saved key exists
+```
+
+These checks make no provider requests. Local readiness does not validate the key with DeepSeek; live worker requests use your DeepSeek API account.
+
+## Update and uninstall
+
+Upgrade the released package through the same manager, then re-run the local setup steps:
+
+```bash
+pipx upgrade deepseek-team
+deepseek-team setup --runtime codex --no-key
+cd /path/to/project
+deepseek-team init --coordinator codex .
+deepseek-team doctor --runtime codex --offline
+```
+
+Run `init` for each attached project to refresh its managed instructions; your own instruction text and saved preferences are preserved. With uv, use `uv tool upgrade deepseek-team`. In a virtual environment, use its `python -m pip install --upgrade deepseek-team`. Keep one install channel per machine; a local-clone pipx installation is refreshed with `pipx install --force .` from the updated clone.
+
+To remove DeepSeek Team, detach each project before uninstalling. If you also want to delete the saved DeepSeek key, run `deepseek-team auth remove` while the command is still installed.
+
+```bash
+deepseek-team detach --coordinator codex /path/to/project   # for each attached project
+deepseek-team reset --runtime codex                         # remove managed integration
+pipx uninstall deepseek-team
+```
+
+`detach` preserves your own instruction content, and `reset` removes only the package-owned provider block and hooks; your primary authentication and unrelated configuration are kept. Saved keys are **not** deleted by uninstall. For uv use `uv tool uninstall deepseek-team`; for a venv use its `python -m pip uninstall deepseek-team`. Substitute `claude` or `both` for `codex` wherever your runtime differs.
+
+## Further reading
+
+- [Routing guide](https://github.com/kirill31337/deepseek-team/blob/main/docs/ROUTING.md) - admission, evidence and feedback.
+- [Hardening](https://github.com/kirill31337/deepseek-team/blob/main/docs/HARDENING.md) - coordinator and worker boundaries.
+- [Publishing](https://github.com/kirill31337/deepseek-team/blob/main/docs/PUBLISHING.md) - release-maintainer details.
+- [0.8.1 release notes](https://github.com/kirill31337/deepseek-team/blob/main/docs/releases/0.8.1.md)
+- Russian README: [README.ru.md](https://github.com/kirill31337/deepseek-team/blob/main/README.ru.md)
+
+## License
+
+[MIT](https://github.com/kirill31337/deepseek-team/blob/main/LICENSE), copyright 2026 kirill31337.

deepseek_team-0.8.1/README.ru.md

@@ -0,0 +1,195 @@
+![DeepSeek Team banner](https://raw.githubusercontent.com/kirill31337/deepseek-team/main/assets/deepseek-team-banner-4b37ec05.jpg)
+
+# DeepSeek Team
+
+[English](https://github.com/kirill31337/deepseek-team/blob/main/README.md) | **Русский**
+
+DeepSeek Team — пакет для Linux, который подключает координаторов **Codex и/или Claude Code** к изолированным воркерам DeepSeek. Координатор распределяет работу, проверяет результат и вносит принятые изменения в основной проект. Воркеры DeepSeek выполняют отдельные порученные задачи: исследование, ревью, а в режиме записи — реализацию, локальные тесты и документацию. Дистрибутив называется `deepseek-team`, единственная запускаемая команда — `deepseek-team`.
+
+Это руководство для версии **0.8.1**. Воркеры используют модель `deepseek-flash`; глубину рассуждений (`effort`) выбирает координатор. Для работы нужен отдельный ключ DeepSeek API.
+
+Права воркеров выбираются отдельно. Свежая установка работает в профиле Auto с доступом **только для чтения**: воркер исследует и проверяет код, но не изменяет файлы. Чтобы разрешить реализацию в отдельной копии проекта, нужно явно выбрать `full-access` (см. ниже). Установка сама по себе права записи не даёт.
+
+## Требования
+
+- Linux. Поддержка Windows и macOS не заявляется.
+- Python 3.11 или новее.
+- Git.
+- Codex CLI и/или Claude Code CLI, уже установленные в `PATH` и настроенные обычным образом.
+- Bubblewrap (песочница обязательна, её нельзя отключить). В Ubuntu первый `setup` может установить пакет и профиль AppArmor через `--with-sandbox`.
+
+Версия 0.8.1 опубликована в [PyPI](https://pypi.org/project/deepseek-team/), поэтому установка выполняется по имени пакета.
+
+## Возможности
+
+- **Автоматическое делегирование.** Auto сразу допускает подходящую ограниченную работу, не ожидая истории, и учится на принятых результатах, доработках и отклонениях.
+- **Ручные профили.** Профили 25/50/75 задают целевой ориентир распределения, если нужен предсказуемый режим.
+- **Отдельные права.** `read-only` и `full-access` выбираются независимо от профиля делегирования.
+- **Изолированные копии.** Каждое задание с записью получает собственную копию проекта.
+- **Очередь и параллелизм.** До 8 воркеров одновременно (от 1 до 64), лишние запуски ждут в очереди FIFO.
+- **Общий ключ.** Codex и Claude Code используют один приватный ключ DeepSeek.
+- **Один переключатель.** `on`/`off` включают и выключают делегирование в проекте для обоих координаторов.
+
+## Установка и первый запуск
+
+Основной способ — `pipx`; пакет ставится по имени из PyPI:
+
+```bash
+# Ubuntu: pipx устанавливается один раз
+sudo apt-get install pipx
+pipx ensurepath          # затем открыть новый терминал
+pipx install deepseek-team
+```
+
+Компактные альтернативы:
+
+```bash
+# uv
+uv tool install deepseek-team
+
+# venv + pip (только внутри виртуального окружения)
+python3 -m venv ~/venvs/deepseek-team
+. ~/venvs/deepseek-team/bin/activate
+python -m pip install deepseek-team
+```
+
+Установка из локальной копии репозитория:
+
+```bash
+git clone https://github.com/kirill31337/deepseek-team.git
+cd deepseek-team
+pipx install .
+```
+
+Не используйте `sudo pip` и не устанавливайте пакет в системное окружение Python.
+
+### Подготовка и подключение проекта
+
+Шаги ниже выполняются один раз; нужный проект подключается по его пути.
+
+```bash
+deepseek-team setup --runtime codex --no-key
+deepseek-team auth set
+cd /path/to/project
+deepseek-team init --coordinator codex .
+deepseek-team config set --project --access full-access   # необязательно
+deepseek-team doctor --runtime codex --offline
+```
+
+Что делает каждый шаг:
+
+- `setup --no-key` проверяет готовность (Git, доступность команд, песочницу) и не читает и не запрашивает ключ.
+- `auth set` запрашивает ключ DeepSeek скрытым вводом и сохраняет его только для вашего пользователя. Отдельный ключ DeepSeek нужен для реальной работы.
+- `init --coordinator codex .` подключает текущий каталог как проект.
+- `config set --project --access full-access` — **необязательная** команда. Её выполняют только если нужно разрешить воркерам реализацию и тесты в изолированной копии. В свежем профиле Auto без неё доступ остаётся read-only.
+- `doctor --runtime codex --offline` выполняет локальные проверки без сети и без платных запросов.
+
+В Ubuntu при первой настройке может потребоваться `deepseek-team setup --runtime codex --with-sandbox --no-key`: эта команда явно разрешает установить пакет и именованный профиль AppArmor. Обычный `setup` никогда не вызывает `sudo` — при нехватке компонентов он лишь сообщает, что нужно установить. На других дистрибутивах Linux установите системные компоненты (например, Bubblewrap) заранее.
+
+Для Claude Code замените `codex` на `claude` в параметрах (`--runtime claude`, `--coordinator claude`), а для обоих координаторов укажите `both`. В Codex откройте `/hooks`, проверьте установленный хук и подтвердите доверие к нему. В Claude Code начните новую сессию и проверьте `/hooks`. Пакет не может подтвердить доверие вместо вас.
+
+## Делегирование и текущие настройки
+
+По умолчанию действует профиль **Auto** с `effort=auto`. Он сразу допускает подходящую ограниченную работу, не ожидая накопления истории: небольшие и средние задачи с низким или средним риском, известной или частично известной локализацией, связями внутри участка или компонента, ясными требованиями и указанными проверками. Реализация требует исполняемых проверок и доступа `full-access`; для ревью, исследования и документации достаточно явных критериев приёмки.
+
+Значения `effort` для воркера: `low` — ограниченная или механическая работа, `medium` — обычный случай, `high` — сложная отладка, рассуждения по нескольким файлам и требовательное независимое ревью. Пока действует `auto`, уровень выбирает координатор для каждого поручения.
+
+Все подходящие независимые задачи можно регистрировать: количество параллельных воркеров ограничивает только `max_workers`. Занятые слоты не отменяют назначение — лишние запуски встают в очередь FIFO. По умолчанию одновременно работают не более 8 воркеров (настраивается от 1 до 64), общего ограничения по времени нет. Явно заданный таймаут включает время ожидания в очереди.
+
+Неизвестная стоимость не мешает назначению; измеренная невыгодность может оставить задачу за координатором. Одна доработка учитывается без паузы. Отклонение результата или три разных случая доработки за окно наблюдения приостанавливают только соответствующее семейство задач на 300 секунд по умолчанию. Неудачная реализация автоматически не повторяется.
+
+### Права доступа
+
+- `read-only` — режим по умолчанию для свежего Auto: воркер читает и анализирует, но не пишет.
+- `full-access` — разрешает изменения в рабочей копии; включается настройкой доступа или ручным профилем 50/75 при `access=auto`. Это доступ на разработку **в принадлежащей воркеру изолированной копии проекта**, а не доступ ко всему хосту. Воркер изменяет свою копию; координатор проверяет и переносит принятые изменения в основной проект.
+
+### Ключевые параметры
+
+| Параметр | По умолчанию | Смысл |
+| --- | --- | --- |
+| Профиль делегирования | Auto | Адаптивный выбор исполнителя по задаче |
+| Права доступа | read-only | `full-access` — только по явному выбору |
+| Модель воркеров | `deepseek-flash` | Всегда, без выбора |
+| `effort` | `auto` | Координатор выбирает `low`/`medium`/`high` |
+| Параллелизм | 8 (от 1 до 64) | Лишние задачи ждут в очереди FIFO |
+| Общий таймаут | без ограничения | Явный таймаут включает время в очереди |
+
+Ручные профили **25/50/75** остаются поддерживаемыми необязательными целевыми ориентирами распределения работы. Это не измеряемые квоты на токены, время или строки кода. Если вы уже сохранили такой профиль, он имеет приоритет над Auto. При `access=auto` профиль 25 использует read-only, а 50/75 — full-access. Явно сохранённый `read-only` всегда имеет приоритет. Подробнее: [руководство по маршрутизации](https://github.com/kirill31337/deepseek-team/blob/main/docs/ROUTING.ru.md).
+
+## Пример задания координатору
+
+В обычной сессии координатора достаточно описать задачу словами и попросить передать независимую работу воркерам:
+
+> Делегируй независимую реализацию этой задачи и её тесты воркерам DeepSeek, затем сам проверь и интегрируй принятые изменения в основной проект.
+
+Координатор определит объём, разобьёт работу на независимые части, запустит воркеров и проверит полученный результат.
+
+Инструкция для итоговой сводки входит в устанавливаемый пакет для Codex и Claude Code. При включённом DeepSeek Team сводка выполненной работы содержит короткие пункты: что координатор сделал лично, что принято от DeepSeek и какие потребовались доработки или были сбои. Учитывается вся описываемая задача, включая предыдущие сообщения. Работа собственных субагентов указывается отдельно; если делегирования не было, это прямо отмечается.
+
+После списка идёт приблизительное соотношение координатор/DeepSeek в целых процентах с суммой 100 и пометкой **«субъективная оценка, не измерение»**. Оно учитывает принятый объём, сложность, проверку и доработки; его не выводят из количества вызовов, задач, файлов, строк, токенов, времени или пунктов и не подменяют профилем 25/50/75 либо оценкой экономии. Без принятого вклада DeepSeek соотношение — 100/0; если данных недостаточно, оценка недоступна. Для ответов только о статусе и без выполненной работы сводка не нужна; `off` отключает требование. Обновление пакета обновляет контекст хуков; инструкции уже подключённого проекта обновляются командой `deepseek-team init --coordinator both /path/to/project` (для одного координатора укажите `codex` или `claude`).
+
+## Полезные команды
+
+Диагностика:
+
+```bash
+deepseek-team doctor --runtime codex --offline   # локальные проверки, без сети
+deepseek-team hooks status --runtime codex
+deepseek-team sandbox status
+deepseek-team auth status                        # только наличие ключа
+```
+
+Настройки и включение:
+
+```bash
+deepseek-team config show --effective            # эффективные значения и их источник
+deepseek-team config set --project --max-workers 8
+deepseek-team on                                 # включить новые задания в проекте
+deepseek-team off                                # отключить новые задания
+deepseek-team status                             # текущее состояние
+```
+
+`on`/`off`/`status` работают из каталога проекта или принимают путь. Состояние сохраняется для вашего пользователя, не попадает в Git и не меняет ключи или файлы инструкций.
+
+## Изоляция
+
+Воркеры работают с обязательной OS-изоляцией. Задания с записью выполняются в собственных копиях проекта с ограниченным доступом к файловой системе и сети. Архитектура, решения по безопасности, итоговая проверка, интеграция и публикация остаются за координатором. Воркеры не коммитят, не публикуют и не запускают других агентов.
+
+У режимов чтения и разработки разные границы изоляции. Правила доступа к файлам, ключам и сети описаны в [руководстве по изоляции](https://github.com/kirill31337/deepseek-team/blob/main/docs/HARDENING.md).
+
+## Обновление и удаление
+
+Обновление выполняется через тот же менеджер пакетов:
+
+```bash
+pipx upgrade deepseek-team
+deepseek-team setup --runtime codex --no-key
+cd /path/to/project
+deepseek-team init --coordinator codex .
+deepseek-team doctor --runtime codex --offline
+```
+
+Повторите `init` в каждом подключённом проекте, чтобы обновить управляемые инструкции. Ваш собственный текст и сохранённые настройки сохраняются. Для uv используйте `uv tool upgrade deepseek-team`; в venv — его `python -m pip install --upgrade deepseek-team`. Держите на машине один канал установки; установку pipx из локального клона обновляют командой `pipx install --force .` из обновлённого клона.
+
+Если нужно удалить и сохранённый ключ DeepSeek, выполните `deepseek-team auth remove` до удаления пакета.
+
+Удаление:
+
+```bash
+deepseek-team detach --coordinator codex /path/to/project   # для подключённых проектов
+deepseek-team reset --runtime codex                          # удаляет интеграцию пакета
+pipx uninstall deepseek-team
+```
+
+Сначала отсоедините проекты командой `detach`, затем удалите принадлежащую пакету интеграцию командой `reset`, и только потом удаляйте сам пакет. `reset` не трогает ваши основные настройки и модель координатора. Сохранённый ключ DeepSeek при этом не удаляется. Для uv используйте `uv tool uninstall deepseek-team`, для venv — его `python -m pip uninstall deepseek-team`. Для Claude замените `codex` на `claude` или используйте `both`.
+
+## Дополнительная документация
+
+- [Руководство по маршрутизации](https://github.com/kirill31337/deepseek-team/blob/main/docs/ROUTING.ru.md)
+- [docs/HARDENING.md](https://github.com/kirill31337/deepseek-team/blob/main/docs/HARDENING.md) — изоляция и границы безопасности
+- [docs/PUBLISHING.md](https://github.com/kirill31337/deepseek-team/blob/main/docs/PUBLISHING.md) — выпуск для сопровождающих
+- [docs/releases/0.8.1.md](https://github.com/kirill31337/deepseek-team/blob/main/docs/releases/0.8.1.md) — заметки о выпуске 0.8.1
+
+## Лицензия
+
+[MIT](https://github.com/kirill31337/deepseek-team/blob/main/LICENSE). Авторские права: kirill31337, 2026.