helloagents 3.0.28 → 3.0.30

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.28",
+  "version": "3.0.30",
   "description": "HelloAGENTS — The orchestration kernel that makes any AI CLI smarter. Adds intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloagents",
-  "version": "3.0.28",
+  "version": "3.0.30",
   "description": "HelloAGENTS — Quality-driven orchestration kernel for AI CLIs with intelligent routing, quality verification (Ralph Loop), safety guards, and notifications.",
   "author": {
     "name": "HelloWind",

package/README.md

@@ -8,7 +8,7 @@
 
 **A workflow layer for AI coding CLIs: skills, project knowledge, delivery checks, safer config writes, and resumable execution.**
 
-[![Version](https://img.shields.io/badge/version-3.0.28-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.30-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](./package.json)
 [![Skills](https://img.shields.io/badge/skills-14-6366f1.svg)](./skills)
@@ -47,7 +47,7 @@
 
 AI coding CLIs can move fast, but they can also stop at advice, skip checks, lose project context, or report completion before the work is really done.
 
-HelloAGENTS adds a workflow layer on top of Claude Code, Gemini CLI, and Codex CLI. It helps the agent choose the right path, use task-specific quality skills, keep a project knowledge base, and verify work before delivery.
+HelloAGENTS adds a workflow layer on top of Claude Code, Gemini CLI, Codex CLI, and DeepSeek TUI. It helps the agent choose the right path, use task-specific quality skills, keep a project knowledge base, and verify work before delivery.
 
 <table>
 <tr>
@@ -100,7 +100,7 @@ HelloAGENTS includes 14 `hello-*` skills. They are loaded only when the current
 | `hello-reflect` | reusable lessons and knowledge updates |
 
 All UI work first follows the shared UI quality baseline.
-In global mode, activated projects, or explicit UI workflows, `hello-ui` adds deeper design-contract execution, design-system mapping, and visual validation on top of that baseline.
+In global mode, in initialized projects, or in explicit UI workflows, `hello-ui` adds deeper design-contract execution, design-system mapping, and visual validation on top of that baseline.
 When visual evidence is required, HelloAGENTS records it in the current session `artifacts/visual.json`.
 
 ### 2) Commands for different work styles
@@ -116,7 +116,8 @@ Commands run inside the AI CLI chat with a `~` prefix. The command skill is read
 | `~prd` | Modern product requirements document through guided dimension-by-dimension exploration |
 | `~loop` | Iterative improvement with metric, guard command, keep/revert decisions |
 | `~wiki` | Create or sync only the project knowledge base |
-| `~init` | Full project setup: knowledge base plus project-level rule files and package-root links |
+| `~init` | Same as `~wiki` |
+| `~global` | Initialize project-level global mode |
 | `~test` | Write tests for a target module or recent change |
 | `~verify` | Review, run verification commands, fix failures, and close out |
 | `~commit` | Generate a conventional commit message and sync knowledge |
@@ -146,9 +147,9 @@ The knowledge base helps future turns understand the repo without re-discovering
 | `plans/<feature>/` | active plan packages |
 | `archive/` | archived plan packages |
 
-`~wiki` creates or updates the knowledge base only.
+`~wiki` and `~init` create or update the knowledge base only.
 
-`~init` does more: it creates or updates the knowledge base, writes project-level rule files, and refreshes project-level HelloAGENTS package-root links for supported hosts.
+`~global` does more: it creates or updates the knowledge base, writes the project-level global-mode marker, and refreshes project-level HelloAGENTS package-root links for supported hosts.
 
 ### 4) Structured plan packages
 
@@ -264,7 +265,7 @@ Type:
 ~help
 ```
 
-You should see the 13 chat commands and the current settings.
+You should see the 14 chat commands and the current settings.
 
 ### 4) Create project knowledge
 
@@ -274,10 +275,10 @@ For knowledge base only:
 ~wiki
 ```
 
-For full project setup:
+For project-level global mode:
 
 ```text
-~init
+~global
 ```
 
 ## CLI Management
@@ -305,13 +306,14 @@ Supported targets:
 - `claude`
 - `gemini`
 - `codex`
+- `deepseek`
 - `--all`
 
 If you omit `--standby` or `--global`, HelloAGENTS first reuses the tracked/detected mode for that CLI, then falls back to `standby`.
 
 ### npm and one-shot script entries
 
-Use these when you do not want to depend on the `helloagents` binary being available during package updates. In `HELLOAGENTS=target[:mode]`, target can be `all`, `claude`, `gemini`, or `codex`; mode can be `standby` or `global`. For install, an omitted mode is treated as `standby`. For update, cleanup, uninstall, and branch switching, an omitted mode is forwarded unchanged so HelloAGENTS can reuse the tracked or detected mode for that CLI first.
+Use these when you do not want to depend on the `helloagents` binary being available during package updates. In `HELLOAGENTS=target[:mode]`, target can be `all`, `claude`, `gemini`, `codex`, or `deepseek`; mode can be `standby` or `global`. For install, an omitted mode is treated as `standby`. For update, cleanup, uninstall, and branch switching, an omitted mode is forwarded unchanged so HelloAGENTS can reuse the tracked or detected mode for that CLI first.
 
 Host configs use the stable `helloagents-js` entrypoint and runtime root `~/.helloagents/helloagents`, so Node global package paths can change without breaking managed hooks or Codex `notify`. Codex hooks use standalone `~/.codex/hooks.json` instead of adding large hook blocks to `config.toml`, and Codex global plugin roots plus plugin cache now link back to that same stable runtime root.
 
@@ -330,7 +332,7 @@ HELLOAGENTS=codex:global npm install -g helloagents
 HELLOAGENTS=claude:standby npm update -g helloagents
 
 # Switch to the beta branch and sync all CLIs in standby mode
-HELLOAGENTS=all:standby npm install -g github:hellowind777/helloagents#beta
+HELLOAGENTS=all:standby npm install -g https://github.com/hellowind777/helloagents/archive/refs/heads/beta.tar.gz
 
 # Clean Gemini integration before package uninstall
 npm explore -g helloagents -- npm run uninstall -- gemini --standby
@@ -350,7 +352,7 @@ $env:HELLOAGENTS="codex:global"; npm install -g helloagents
 $env:HELLOAGENTS="claude:standby"; npm update -g helloagents
 
 # Switch to the beta branch and sync all CLIs in standby mode
-$env:HELLOAGENTS="all:standby"; npm install -g github:hellowind777/helloagents#beta
+$env:HELLOAGENTS="all:standby"; npm install -g https://github.com/hellowind777/helloagents/archive/refs/heads/beta.tar.gz
 
 # Clean Gemini integration before package uninstall
 npm explore -g helloagents -- npm run uninstall -- gemini --standby
@@ -415,13 +417,13 @@ The PowerShell wrapper now forwards the same npm arguments as `install.sh`, so i
 ```bash
 helloagents switch-branch beta
 helloagents switch-branch beta claude --global
-helloagents branch github:hellowind777/helloagents#beta --all --standby
+helloagents branch beta --all --standby
 ```
 
 Use normal npm commands when you only want to change the package and not sync host CLIs immediately:
 
 ```bash
-npm install -g github:hellowind777/helloagents#beta
+npm install -g https://github.com/hellowind777/helloagents/archive/refs/heads/beta.tar.gz
 npm update -g helloagents
 npm explore -g helloagents -- npm run uninstall -- --all --standby
 npm uninstall -g helloagents
@@ -434,6 +436,7 @@ npm uninstall -g helloagents
 | Claude Code | `~/.claude/CLAUDE.md`, `~/.claude/settings.json`, `~/.claude/helloagents -> ~/.helloagents/helloagents` | removes managed marker block, HelloAGENTS hooks/permissions, and symlink |
 | Gemini CLI | `~/.gemini/GEMINI.md`, `~/.gemini/settings.json`, `~/.gemini/helloagents -> ~/.helloagents/helloagents` | removes managed marker block, HelloAGENTS hooks, and symlink |
 | Codex CLI | `~/.codex/AGENTS.md`, `~/.codex/config.toml`, `~/.codex/hooks.json`, `~/.codex/helloagents -> ~/.helloagents/helloagents`, managed backups | removes managed marker block, managed config keys, managed hooks, symlink, and the latest managed backup |
+| DeepSeek TUI | `~/.deepseek/AGENTS.md`, `~/.deepseek/helloagents -> ~/.helloagents/helloagents` | removes managed marker block and symlink |
 
 ### Global mode files
 
@@ -442,6 +445,7 @@ npm uninstall -g helloagents
 | Claude Code | native plugin install | managed by Claude Code plugin system |
 | Gemini CLI | native extension install | managed by Gemini extension system |
 | Codex CLI | native local-plugin chain | `~/.agents/plugins/marketplace.json`, `~/plugins/helloagents/ -> ~/.helloagents/helloagents`, `~/.codex/plugins/cache/local-plugins/helloagents/local/ -> ~/.helloagents/helloagents`, `~/.codex/config.toml`, `~/.codex/hooks.json`, `~/.codex/helloagents -> ~/.helloagents/helloagents` |
+| DeepSeek TUI | managed AGENTS carrier | `~/.deepseek/AGENTS.md`, `~/.deepseek/helloagents -> ~/.helloagents/helloagents` |
 
 In global mode, HelloAGENTS now attempts the host-native install commands automatically. If a host command is unavailable, run the same commands manually:
 
@@ -455,6 +459,8 @@ For Claude Code, the CLI also tries the equivalent `claude plugin marketplace ad
 
 Codex global mode is installed by HelloAGENTS automatically through the local-plugin path.
 
+DeepSeek TUI follows its native `AGENTS.md` model. Standby writes the lite carrier to `~/.deepseek/AGENTS.md`; global writes the full carrier plus `<!-- HELLOAGENTS_PROFILE: full -->`. HelloAGENTS doctor also reads `deepseek doctor --json` when the `deepseek` command is available and surfaces its summary next to HelloAGENTS-managed checks.
+
 ## Commands in Chat
 
 ### Typical flows
@@ -467,14 +473,14 @@ Codex global mode is installed by HelloAGENTS automatically through the local-pl
 | Implement from a clear request or active plan | `~build "finish task 2 in the plan"` |
 | Build a full product requirement document | `~prd "modern dashboard for operations team"` |
 | Iterate toward a metric | `~loop "reduce bundle size" --metric "npm run size" --direction lower` |
-| Create or refresh project knowledge only | `~wiki` |
-| Fully activate project workflow | `~init` |
+| Create or refresh project knowledge only | `~wiki` / `~init` |
+| Initialize project-level global mode | `~global` |
 | Validate current work | `~verify` |
 | Generate commit message and sync knowledge | `~commit` |
 
-### Activated vs unactivated projects
+### Knowledge base vs project-level global mode
 
-In standby mode, unactivated projects get lighter rules and explicit `~command` entry points. A project becomes activated when `.helloagents/` exists, usually through `~wiki` or `~init`.
+In standby mode, projects that are not initialized get lighter rules and explicit `~command` entry points. A project enters project-level global mode after `~global` writes `<!-- HELLOAGENTS_PROFILE: full -->`.
 
 In global mode, HelloAGENTS applies full rules by default.
 
@@ -488,16 +494,13 @@ By default, project knowledge lives in the project:
 .helloagents/
 ```
 
-This directory acts as both:
-
-- the activation signal
-- the local knowledge, plan, state, and runtime directory
+This directory is the local knowledge, plan, state, and runtime directory.
 
 ### Repo-shared mode
 
 When `project_store_mode = "repo-shared"`:
 
-- local `.helloagents/` keeps activation and runtime files
+- local `.helloagents/` keeps project-local state and runtime files
 - stable knowledge and plan files move to `~/.helloagents/projects/<repo-key>/`
 - multiple worktrees of the same git repo can share the same stable knowledge
 
@@ -510,9 +513,9 @@ Runtime state and evidence remain local to the working project:
 - `.helloagents/sessions/<workspace>/<session>/artifacts/*.json`
 - `.helloagents/sessions/<workspace>/<session>/artifacts/loop-results.tsv`
 
-### Unactivated or temporary sessions
+### Temporary sessions outside project-local storage
 
-If neither the current directory nor its parents contain an activated `.helloagents/` directory, HelloAGENTS does not write project files automatically. Temporary runtime state is kept under the user-level directory:
+For read-only work with no local output, if neither the current directory nor its parents contain a project-local `.helloagents/` directory, HelloAGENTS keeps short-lived runtime state under the user-level directory:
 
 ```text
 ~/.helloagents/runtime/<scope-key>/
@@ -520,15 +523,17 @@ If neither the current directory nor its parents contain an activated `.helloage
 
 This only stores short-lived `capsule.json`, `events.jsonl`, and `artifacts/`. It is not project knowledge. Expired transient sessions are removed by TTL cleanup.
 
+Once the task creates or modifies local files, or otherwise leaves local output in the current project, HelloAGENTS creates the project-local `.helloagents/sessions/.../STATE.md` automatically instead of keeping that task only in the user-level transient runtime.
+
 ### Knowledge creation rules
 
 | Command or setting | Behavior |
 |--------------------|----------|
-| `~wiki` | creates or syncs the knowledge base only |
-| `~init` | creates knowledge base plus project-level rule files and package-root links |
+| `~wiki` / `~init` | creates or syncs the knowledge base only |
+| `~global` | creates knowledge base plus project-level global-mode marker and package-root links |
 | `kb_create_mode = 0` | disables automatic knowledge updates |
-| `kb_create_mode = 1` | updates knowledge automatically for coding tasks in activated projects or global mode |
-| `kb_create_mode = 2` | updates knowledge more aggressively in activated projects or global mode |
+| `kb_create_mode = 1` | syncs knowledge automatically only when the KB already exists |
+| `kb_create_mode = 2` | for coding tasks, auto-creates or syncs the KB when it already exists or the project is in global mode |
 
 ## Workflow and Delivery
 
@@ -616,7 +621,7 @@ Default shape:
 | `notify_level` | `0` | `0` off, `1` desktop, `2` sound, `3` both |
 | `ralph_loop_enabled` | `true` | run verification for explicit `~verify` / `~loop` or required closeout gates |
 | `guard_enabled` | `true` | block dangerous commands |
-| `kb_create_mode` | `1` | control automatic knowledge base updates |
+| `kb_create_mode` | `1` | `0` off, `1` sync existing KB automatically, `2` auto-create or sync the KB for coding tasks |
 | `project_store_mode` | `"local"` | `local` or `repo-shared` |
 | `auto_commit_enabled` | `true` | auto-create a local commit at closeout when verification passed and the working tree changed; `false` skips only the automatic commit |
 | `commit_attribution` | `""` | optional text appended to commit messages |
@@ -660,6 +665,14 @@ Codex is rules-file driven by default.
 - `/goal` remains Codex-native. Enable it explicitly with `helloagents codex goals enable` when long-running plan execution is needed
 - Goal-aware commands resume from `tasks.md`, `contract.json`, and `state_path`; they do not create goals automatically or mark them complete before HelloAGENTS verification and closeout
 
+### DeepSeek TUI
+
+- standby writes `~/.deepseek/AGENTS.md`
+- standby creates `~/.deepseek/helloagents -> ~/.helloagents/helloagents`
+- global keeps using `~/.deepseek/AGENTS.md`, but writes the full HelloAGENTS carrier with `<!-- HELLOAGENTS_PROFILE: full -->`
+- project-level initialized projects still rely on the project carrier marker, so DeepSeek follows the same initialized-project behavior as Codex
+- `helloagents doctor` merges HelloAGENTS-managed checks with the summary from `deepseek doctor --json` when that command exists
+
 ## Verification
 
 Run all tests:
@@ -668,15 +681,15 @@ Run all tests:
 npm test
 ```
 
-The current suite includes 124 tests and covers:
+The current suite covers:
 
 - install, update, cleanup, uninstall, branch switching, and mode switching
 - one-shot shell and PowerShell lifecycle dispatch, plus wrapper mode-routing rules for install, update, cleanup, uninstall, and branch switching
-- Claude, Gemini, and Codex config merge, restore, and native/global cleanup behavior
+- Claude, Gemini, Codex, and DeepSeek host integration behavior
 - Codex managed `model_instructions_file`, `notify`, `hooks.json`, hook trust state, local plugin, marketplace, and cache behavior
 - Codex cleanup of legacy managed notify variants on Windows and canonical managed notify restoration rules
 - Codex `/goal` feature toggles, long-running route context, and goal-aware command contracts
-- `helloagents doctor`
+- `helloagents doctor`, including DeepSeek native doctor summary handling
 - project storage and `repo-shared` behavior
 - session-scoped `state_path`, runtime signals, and evidence
 - runtime injection, routing, guard, verification, visual evidence, delivery gates, closeout de-duplication, and successful-mode tracking after native install failures
@@ -697,15 +710,15 @@ Both.
 - `skills/` defines task-specific behavior
 - `scripts/` provides runtime helpers for routing, guard, notify, verification, state, and evidence
 
-### Should I use `~wiki` or `~init`?
+### Should I use `~wiki`, `~init`, or `~global`?
 
-Use `~wiki` when you only want project knowledge.
+Use `~wiki` or `~init` when you only want project knowledge.
 
-Use `~init` when you also want project-level rule files and project-level HelloAGENTS package-root links.
+Use `~global` when you also want project-level global mode.
 
 ### What is the difference between standby and global?
 
-`standby` is lighter and explicit. It deploys rules to selected CLIs and keeps full project workflow behind project activation.
+`standby` is lighter and explicit. It deploys rules to selected CLIs and keeps project-level global mode behind `~global`.
 
 `global` applies full rules broadly. Claude and Gemini use native plugin/extension installs. Codex uses the local-plugin path.
 

package/README_CN.md

@@ -8,7 +8,7 @@
 
 **面向 AI 编码 CLI 的工作流层：技能、知识库、交付检查、更安全的配置写入，以及可恢复的执行流程。**
 
-[![Version](https://img.shields.io/badge/version-3.0.28-orange.svg)](./package.json)
+[![Version](https://img.shields.io/badge/version-3.0.30-orange.svg)](./package.json)
 [![npm](https://img.shields.io/npm/v/helloagents.svg)](https://www.npmjs.com/package/helloagents)
 [![Node](https://img.shields.io/badge/node-%3E%3D18-339933.svg)](./package.json)
 [![Skills](https://img.shields.io/badge/skills-14-6366f1.svg)](./skills)
@@ -47,7 +47,7 @@
 
 AI 编码 CLI 写代码很快，但也容易停在建议、跳过检查、丢失项目上下文，或在真正完成前就报告完成。
 
-HelloAGENTS 叠加在 Claude Code、Gemini CLI 和 Codex CLI 之上，帮助模型选择合适流程、使用任务相关的质量技能、维护项目知识库，并在交付前完成验证。
+HelloAGENTS 叠加在 Claude Code、Gemini CLI、Codex CLI 和 DeepSeek TUI 之上，帮助模型选择合适流程、使用任务相关的质量技能、维护项目知识库，并在交付前完成验证。
 
 <table>
 <tr>
@@ -100,7 +100,7 @@ HelloAGENTS 内置 14 个 `hello-*` 技能。技能只在当前阶段需要时
 | `hello-reflect` | 可复用经验和知识更新 |
 
 所有 UI 任务都会先受共享的 UI 质量基线约束。
-在全局模式、已激活项目或明确的 UI 工作流里，`hello-ui` 会在该基线之上补充设计契约执行、设计系统映射与视觉验收。
+在全局模式、已初始化项目或明确的 UI 工作流里，`hello-ui` 会在该基线之上补充设计契约执行、设计系统映射与视觉验收。
 当需要视觉证据时，HelloAGENTS 会写入当前会话的 `artifacts/visual.json`。
 
 ### 2）面向不同工作方式的命令
@@ -116,7 +116,8 @@ HelloAGENTS 内置 14 个 `hello-*` 技能。技能只在当前阶段需要时
 | `~prd` | 通过逐维度讨论生成现代产品需求文档 |
 | `~loop` | 设置指标和守卫命令，循环改进、保留或回滚 |
 | `~wiki` | 只创建或同步项目知识库 |
-| `~init` | 完整项目初始化：知识库、项目级规则文件和包根链接 |
+| `~init` | 同 `~wiki` |
+| `~global` | 初始化项目级全局模式 |
 | `~test` | 为指定模块或最近变更编写测试 |
 | `~verify` | 审查、运行验证命令、修复失败并收尾 |
 | `~commit` | 生成规范化提交信息并同步知识库 |
@@ -146,9 +147,9 @@ HelloAGENTS 可以在 `.helloagents/` 下创建和维护项目知识库。
 | `plans/<feature>/` | 活跃方案包 |
 | `archive/` | 已归档方案包 |
 
-`~wiki` 只创建或更新知识库。
+`~wiki` 和 `~init` 只创建或更新知识库。
 
-`~init` 做得更多：创建或更新知识库、写入项目级规则文件，并刷新各宿主项目级 HelloAGENTS 包根链接。
+`~global` 做得更多：创建或更新知识库、写入项目级全局模式标记，并刷新各宿主项目级 HelloAGENTS 包根链接。
 
 ### 4）结构化方案包
 
@@ -264,7 +265,7 @@ helloagents install --all --global
 ~help
 ```
 
-应能看到 13 个对话命令和当前设置。
+应能看到 14 个对话命令和当前设置。
 
 ### 4）创建项目知识
 
@@ -274,10 +275,10 @@ helloagents install --all --global
 ~wiki
 ```
 
-完整初始化项目：
+初始化项目级全局模式：
 
 ```text
-~init
+~global
 ```
 
 ## CLI 管理
@@ -305,13 +306,14 @@ helloagents codex goals enable
 - `claude`
 - `gemini`
 - `codex`
+- `deepseek`
 - `--all`
 
 省略 `--standby` 或 `--global` 时，HelloAGENTS 会先复用该 CLI 已记录或检测到的模式，再回退到 `standby`。
 
 ### npm 和一键脚本入口
 
-当你不想依赖更新过程中的 `helloagents` 可执行文件时，用 npm 或一键脚本。`HELLOAGENTS=目标[:模式]` 中，目标支持 `all`、`claude`、`gemini`、`codex`；模式支持 `standby`、`global`。用于安装时，省略模式按 `standby` 处理；用于更新、清理、卸载和切换分支时，省略模式会原样下传，让 HelloAGENTS 先复用该 CLI 已记录或检测到的模式。
+当你不想依赖更新过程中的 `helloagents` 可执行文件时，用 npm 或一键脚本。`HELLOAGENTS=目标[:模式]` 中，目标支持 `all`、`claude`、`gemini`、`codex`、`deepseek`；模式支持 `standby`、`global`。用于安装时，省略模式按 `standby` 处理；用于更新、清理、卸载和切换分支时，省略模式会原样下传，让 HelloAGENTS 先复用该 CLI 已记录或检测到的模式。
 
 宿主配置使用稳定的 `helloagents-js` 入口和运行根目录 `~/.helloagents/helloagents`，Node 全局包路径变化不会破坏受管 hooks 或 Codex `notify`。Codex hooks 使用独立 `~/.codex/hooks.json`，不把大段配置写入 `config.toml`；Codex 全局插件根目录和插件缓存也会回链到这个稳定运行根目录。
 
@@ -330,7 +332,7 @@ HELLOAGENTS=codex:global npm install -g helloagents
 HELLOAGENTS=claude:standby npm update -g helloagents
 
 # 切换到 beta 分支并同步全部 CLI，标准模式
-HELLOAGENTS=all:standby npm install -g github:hellowind777/helloagents#beta
+HELLOAGENTS=all:standby npm install -g https://github.com/hellowind777/helloagents/archive/refs/heads/beta.tar.gz
 
 # 卸载包前清理 Gemini 集成
 npm explore -g helloagents -- npm run uninstall -- gemini --standby
@@ -350,7 +352,7 @@ $env:HELLOAGENTS="codex:global"; npm install -g helloagents
 $env:HELLOAGENTS="claude:standby"; npm update -g helloagents
 
 # 切换到 beta 分支并同步全部 CLI，标准模式
-$env:HELLOAGENTS="all:standby"; npm install -g github:hellowind777/helloagents#beta
+$env:HELLOAGENTS="all:standby"; npm install -g https://github.com/hellowind777/helloagents/archive/refs/heads/beta.tar.gz
 
 # 卸载包前清理 Gemini 集成
 npm explore -g helloagents -- npm run uninstall -- gemini --standby
@@ -415,13 +417,13 @@ PowerShell 包装脚本现在会传递与 `install.sh` 相同的 npm 参数，
 ```bash
 helloagents switch-branch beta
 helloagents switch-branch beta claude --global
-helloagents branch github:hellowind777/helloagents#beta --all --standby
+helloagents branch beta --all --standby
 ```
 
 如果只想切换包本身，暂不同步宿主 CLI，可以直接使用 npm：
 
 ```bash
-npm install -g github:hellowind777/helloagents#beta
+npm install -g https://github.com/hellowind777/helloagents/archive/refs/heads/beta.tar.gz
 npm update -g helloagents
 npm explore -g helloagents -- npm run uninstall -- --all --standby
 npm uninstall -g helloagents
@@ -434,6 +436,7 @@ npm uninstall -g helloagents
 | Claude Code | `~/.claude/CLAUDE.md`、`~/.claude/settings.json`、`~/.claude/helloagents -> ~/.helloagents/helloagents` | 删除受管标记块、HelloAGENTS hooks / 权限和符号链接 |
 | Gemini CLI | `~/.gemini/GEMINI.md`、`~/.gemini/settings.json`、`~/.gemini/helloagents -> ~/.helloagents/helloagents` | 删除受管标记块、HelloAGENTS hooks 和符号链接 |
 | Codex CLI | `~/.codex/AGENTS.md`、`~/.codex/config.toml`、`~/.codex/hooks.json`、`~/.codex/helloagents -> ~/.helloagents/helloagents`、受管备份 | 删除受管标记块、受管配置键、受管 hooks、符号链接和最近一次受管备份 |
+| DeepSeek TUI | `~/.deepseek/AGENTS.md`、`~/.deepseek/helloagents -> ~/.helloagents/helloagents` | 删除受管标记块和符号链接 |
 
 ### 全局模式文件
 
@@ -442,6 +445,7 @@ npm uninstall -g helloagents
 | Claude Code | 原生插件安装 | 由 Claude Code 插件系统管理 |
 | Gemini CLI | 原生扩展安装 | 由 Gemini 扩展系统管理 |
 | Codex CLI | 原生本地插件流程 | `~/.agents/plugins/marketplace.json`、`~/plugins/helloagents/ -> ~/.helloagents/helloagents`、`~/.codex/plugins/cache/local-plugins/helloagents/local/ -> ~/.helloagents/helloagents`、`~/.codex/config.toml`、`~/.codex/hooks.json`、`~/.codex/helloagents -> ~/.helloagents/helloagents` |
+| DeepSeek TUI | 受管 AGENTS 载体 | `~/.deepseek/AGENTS.md`、`~/.deepseek/helloagents -> ~/.helloagents/helloagents` |
 
 全局模式下，HelloAGENTS 会自动尝试宿主原生命令。若宿主命令不可用，再手动执行：
 
@@ -455,6 +459,8 @@ Claude Code 会自动尝试等价的 `claude plugin marketplace add ...` 和 `cl
 
 Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 
+DeepSeek TUI 走原生 `AGENTS.md` 规则模型。standby 会把轻量载体写到 `~/.deepseek/AGENTS.md`；global 会写入完整载体并附带 `<!-- HELLOAGENTS_PROFILE: full -->`。如果系统中存在 `deepseek` 命令，`helloagents doctor` 还会额外读取 `deepseek doctor --json` 的摘要，并与 HelloAGENTS 自己的受管检查一起展示。
+
 ## 对话命令
 
 ### 常见流程
@@ -467,14 +473,14 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 | 按明确请求或活跃方案实现 | `~build "finish task 2 in the plan"` |
 | 生成完整产品需求文档 | `~prd "modern dashboard for operations team"` |
 | 按指标迭代优化 | `~loop "reduce bundle size" --metric "npm run size" --direction lower` |
-| 只创建或刷新项目知识 | `~wiki` |
-| 完整激活项目工作流 | `~init` |
+| 只创建或刷新项目知识 | `~wiki` / `~init` |
+| 初始化项目级全局模式 | `~global` |
 | 验证当前工作 | `~verify` |
 | 生成提交信息并同步知识库 | `~commit` |
 
-### 已激活项目与未激活项目
+### 知识库与项目级全局模式
 
-标准模式下，未激活项目只获得轻量规则和显式 `~command` 入口。项目中出现 `.helloagents/` 后才进入项目级工作流，通常由 `~wiki` 或 `~init` 创建。
+标准模式下，未初始化的项目只获得轻量规则和显式 `~command` 入口。执行 `~global` 后，项目级规则文件会写入 `<!-- HELLOAGENTS_PROFILE: full -->`，项目才进入项目级全局模式。
 
 全局模式下，HelloAGENTS 默认启用完整规则。
 
@@ -488,9 +494,8 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 .helloagents/
 ```
 
-这个目录同时承担：
+这个目录承担：
 
-- 激活信号
 - 本地知识库目录
 - 方案目录
 - 状态与运行态目录
@@ -499,7 +504,7 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 
 当 `project_store_mode = "repo-shared"` 时：
 
-- 本地 `.helloagents/` 保留激活和运行态文件
+- 本地 `.helloagents/` 保留项目本地状态和运行态文件
 - 稳定知识和方案文件写到 `~/.helloagents/projects/<repo-key>/`
 - 同一 git 仓库的多个 worktree 可以共享这些稳定资料
 
@@ -512,9 +517,9 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 - `.helloagents/sessions/<workspace>/<session>/artifacts/*.json`
 - `.helloagents/sessions/<workspace>/<session>/artifacts/loop-results.tsv`
 
-### 未激活或临时会话
+### 项目本地存储之外的临时会话
 
-如果当前目录及其父级没有项目激活目录 `.helloagents/`，HelloAGENTS 不会自动写入项目目录。临时运行态写到用户级目录：
+如果当前任务是只读、且当前目录及其父级还没有项目本地 `.helloagents/` 目录，HelloAGENTS 会把短期运行态写到用户级目录：
 
 ```text
 ~/.helloagents/runtime/<scope-key>/
@@ -522,15 +527,17 @@ Codex 全局模式由 HelloAGENTS 通过本地插件路径自动安装。
 
 这里仅保存短期的 `capsule.json`、`events.jsonl` 和 `artifacts/`，不作为项目知识库。过期临时会话会按 TTL 清理。
 
+一旦任务会创建或修改本地文件，或会在当前项目留下本地输出，HelloAGENTS 就会自动创建项目本地 `.helloagents/sessions/.../STATE.md`，而不是只停留在用户级临时运行态。
+
 ### 知识创建规则
 
 | 命令或配置 | 行为 |
 |------------|------|
-| `~wiki` | 只创建或同步知识库 |
-| `~init` | 创建知识库，同时写入项目级规则文件和包根链接 |
+| `~wiki` / `~init` | 只创建或同步知识库 |
+| `~global` | 创建知识库，同时写入项目级全局模式标记和包根链接 |
 | `kb_create_mode = 0` | 关闭自动知识更新 |
-| `kb_create_mode = 1` | 已激活项目或全局模式中，编码任务自动更新知识 |
-| `kb_create_mode = 2` | 已激活项目或全局模式中，更积极地更新知识 |
+| `kb_create_mode = 1` | 仅在知识库已存在时自动同步 |
+| `kb_create_mode = 2` | 编码任务在知识库已存在或全局模式下自动创建或同步 |
 
 ## 工作流与交付
 
@@ -618,7 +625,7 @@ UI 任务遵循以下优先级：
 | `notify_level` | `0` | `0` 关闭，`1` 桌面通知，`2` 声音，`3` 两者 |
 | `ralph_loop_enabled` | `true` | 显式 `~verify` / `~loop` 或收尾要求时运行验证 |
 | `guard_enabled` | `true` | 拦截危险命令 |
-| `kb_create_mode` | `1` | 控制知识库自动更新 |
+| `kb_create_mode` | `1` | `0` 关闭，`1` 自动同步已有知识库，`2` 编码任务自动创建或同步知识库 |
 | `project_store_mode` | `"local"` | `local` 或 `repo-shared` |
 | `auto_commit_enabled` | `true` | 验证完成且工作区有变更时自动创建本地提交；`false` 只跳过自动提交 |
 | `commit_attribution` | `""` | 提交信息附加署名 |
@@ -662,6 +669,14 @@ Codex 默认走规则文件驱动。
 - `/goal` 保持 Codex 原生能力；需要长程执行时，用 `helloagents codex goals enable` 显式启用
 - 感知 goal 的命令从 `tasks.md`、`contract.json` 和 `state_path` 恢复；不会自动创建 goal，也不会在 HelloAGENTS 验证和收尾前标记完成
 
+### DeepSeek TUI
+
+- 标准模式写入 `~/.deepseek/AGENTS.md`
+- 标准模式创建 `~/.deepseek/helloagents -> ~/.helloagents/helloagents`
+- 全局模式仍使用 `~/.deepseek/AGENTS.md`，但写入带 `<!-- HELLOAGENTS_PROFILE: full -->` 的完整载体
+- 项目级已初始化项目仍以项目规则文件中的 full 标记判断，因此 DeepSeek 与 Codex 共享同一套已初始化项目语义
+- `helloagents doctor` 会在 `deepseek` 命令存在时合并 `deepseek doctor --json` 摘要
+
 ## 验证
 
 运行全部测试：
@@ -670,15 +685,15 @@ Codex 默认走规则文件驱动。
 npm test
 ```
 
-当前测试共 124 项，覆盖：
+当前测试覆盖：
 
 - 安装、更新、清理、卸载、分支切换和模式切换
 - shell 与 PowerShell 一键脚本分发链路，以及包装脚本在安装、更新、清理、卸载和分支切换中的模式传递规则
-- Claude、Gemini、Codex 的配置合并、恢复，以及原生全局清理行为
+- Claude、Gemini、Codex、DeepSeek 的宿主集成行为
 - Codex 受管 `model_instructions_file`、`notify`、`hooks.json`、hook trust 状态、本地插件、marketplace 和缓存行为
 - Windows 下 Codex 旧式受管 notify 变体的清理，以及受管 notify 恢复规则
 - Codex `/goal` 功能开关、长程路由上下文和 goal 感知命令契约
-- `helloagents doctor`
+- `helloagents doctor`，包括 DeepSeek 原生 doctor 摘要处理
 - 项目存储和 `repo-shared`
 - 会话级 `state_path`、运行态信号和证据
 - 运行时注入、选路、Guard、验证、视觉证据、交付门控、收尾去重，以及原生安装失败后的模式记录
@@ -699,15 +714,15 @@ npm test
 - `skills/` 定义任务类型相关行为
 - `scripts/` 提供选路、Guard、通知、验证、状态和证据等运行时辅助能力
 
-### 应该用 `~wiki` 还是 `~init`？
+### 应该用 `~wiki`、`~init` 还是 `~global`？
 
-只想创建项目知识库，用 `~wiki`。
+只想创建项目知识库，用 `~wiki` 或 `~init`。
 
-还想写入项目级规则文件和宿主项目级 HelloAGENTS 包根链接，用 `~init`。
+还想初始化项目级全局模式，用 `~global`。
 
 ### standby 和 global 有什么区别？
 
-`standby` 更轻量、更显式。它只把规则部署到指定 CLI，完整项目流程由项目激活触发。
+`standby` 更轻量、更显式。它只把规则部署到指定 CLI，项目级全局模式由 `~global` 触发。
 
 `global` 默认更广泛地启用完整规则。Claude 和 Gemini 使用原生插件 / 扩展；Codex 使用本地插件路径。
 

package/bootstrap-lite.md

@@ -20,13 +20,13 @@
 ### 执行纪律
 - 一次做完：用户需求明确且已获得执行授权时，必须持续执行到完成；只有符合下文“阻塞判定”的情况，才可中途停下
 - 直接推进：用户已明确同意方案、修改方向或继续执行时，直接执行；不得把可执行动作改写为建议、可选项、等待确认，也不用“下一步建议”代替实际执行
-- 普通问答、解释、分析、改写、邮件回复和其他一次性交付，不进入完整实现/验证流程，但仍属于交付；请求已满足时直接结束，不追加无执行价值的延伸、第二版或邀约式收尾，除非用户明确要求
+- 普通问答、解释、分析、改写、邮件回复和其他一次性交付，不进入完整实现/验证流程，但仍属于交付；默认只交付与当前请求直接对应的一版最终结果。请求已满足时直接结束，不主动追加无执行价值的延伸、派生版本、不同写法、第二版或邀约式收尾，除非用户明确要求
 - 回复末尾只保留结论、风险、限制、已完成状态、阻塞项或真实下一步动作；不得用条件式邀约、自我能力陈述或“如果需要 / 如需 / 我可以继续”这类表述替代交付
 
 ### 表达与语气
 - 所有用户可见文本，包括回复、生成文件、CLI 输出、运行时提示、模板内容、文档与说明，都必须同时遵守本节全部规则：
 - 说话像成熟同事，不像客服、销售或咨询顾问
-- 直接回答，少铺垫；需要先给结论时先给结论，再补必要细节
+- 直接回答，少铺垫；需要先给结论时先给结论，再补必要细节。能用一版说清就只给一版，不主动提供多个备选、补充改写或派生版本，除非用户明确要求比较、多方案或不同风格版本
 - 用词用语和表述方式保持简洁、自然、清晰、准确、合理、统一，不赘述、不冗余、不过度精简
 - 优先使用普通、易懂、贴近用户的表达；必要术语先解释，再补原名
 - 准确优先于压缩：不得为了更短而省略必要的条件、边界、风险、状态、路径、验证结论或下一步动作
@@ -198,8 +198,8 @@
 - `T3` — 高风险或不可逆操作（权限、安全、支付、数据库、生产发布等）→ 先 `~plan` / `~prd`，再 `~build` / `~verify`
 
 ### 完成判定
-- 未激活项目且未进入方案包 / `contract.json` / 证据文件时，声称完成前必须完成与任务类型匹配的必要检查；无法执行的检查必须明确说明，不得直接宣称完成
-- 当前项目已激活，或已存在方案包 / `contract.json` / 证据文件时，以完整流程、对应 skill 与运行时交付约束为准，不得降级为本节
+- 当前项目未初始化，且未进入方案包 / `contract.json` / 证据文件时，声称完成前必须完成与任务类型匹配的必要检查；无法执行的检查必须明确说明，不得直接宣称完成
+- 当前项目已初始化，或已存在方案包 / `contract.json` / 证据文件时，以完整流程、对应 skill 与运行时交付约束为准，不得降级为本节
 - 只读分析、创意探索、方案比较、中间进度和阻塞汇报不适用本节
 - Codex `/goal` 只作为外层长程续跑与预算控制；HelloAGENTS 仍负责方案、执行、验证和收尾。若 active goal 的目标已全部完成，先完成 HelloAGENTS 验证、收尾检查与本地版本检查点，再调用 `update_goal` 标记 complete；不得因预算接近耗尽、单轮结束或准备停下而标记 complete
 - 本地版本检查点：非只读任务完成验证且产生工作区变更时，若 `auto_commit_enabled=true`，最终收尾前自动执行本地提交；若 `auto_commit_enabled=false`，跳过这一步。先检查 `git status --short`；若不是 git 仓库或无变更则跳过。若发现 `.env`、密钥、凭据、明显不应提交的大文件或二进制产物，停止提交并说明风险；否则执行 `git add -A`，使用当前回复语言生成简洁 conventional commit message 后执行 `git commit`。显式 `~commit` 不受这个开关影响。不自动远程 `git push`，除非用户明确要求
@@ -211,7 +211,7 @@
 - `~command` 路由：用户输入 `~xxx` 时，立即读取对应的 SKILL.md 并按其流程执行，不要自行探索或猜测。若当前上下文已解析出具体命令技能文件路径，直接使用它；否则先确定当前技能根目录：
   - 优先使用当前上下文中已注入的“本轮 HelloAGENTS 读取根目录”
   - 若当前上下文未注入，则使用稳定运行根目录 `~/.helloagents/helloagents`
-  - 宿主固定链接（Codex `~/.codex/helloagents`、Claude `~/.claude/helloagents`、Gemini `~/.gemini/helloagents`）只作为兼容别名，不作为优先探测路径
+- 宿主固定链接（Codex `~/.codex/helloagents`、Claude `~/.claude/helloagents`、Gemini `~/.gemini/helloagents`、DeepSeek `~/.deepseek/helloagents`）只作为兼容别名，不作为优先探测路径
   - 仍无法确定时，明确说明缺少 HelloAGENTS 读取根目录；不要递归扫描 `$HOME`、`Downloads`、项目目录或旧版本目录
   确定根目录后读取其中的 `skills/commands/{name}/SKILL.md`；标准模式下即使项目目录存在本地 HelloAGENTS skills，也不要读取项目路径。不要扫描整个目录，也不要对同一命令重复探测多个路径。
 包内脚本优先使用稳定命令入口；涉及 turn-state 时按“收尾状态信号”执行。
@@ -220,7 +220,7 @@
 ### .helloagents/ 目录
 路径: {CWD}/.helloagents/
 所有文件的创建和更新必须按 templates/ 目录中对应模板的格式执行，不可自由发挥格式。
-- `.helloagents/` 表示项目级存储路径，也是标准模式的项目激活信号
+- `.helloagents/` 表示项目本地存储路径，负责知识、方案、状态与运行态；它不再作为项目是否已初始化的判定信号
 - `state_path` 指向的状态文件、当前会话 `capsule.json`、`events.jsonl`、`artifacts/*.json`、`artifacts/loop-results.tsv` 等运行态文件始终保留在项目本地 `.helloagents/sessions/{workspace}/{session}/`
 - `state_path` 是状态文件的唯一位置。宿主提供会话标识时，写入 `.helloagents/sessions/{workspace}/{session}/STATE.md`；没有稳定会话标识时，写入 `.helloagents/sessions/{workspace}/default/STATE.md`
 - `{workspace}` 为当前 Git 分支、`detached-{sha}` 或非 Git 项目的 `workspace`；`.helloagents/sessions/active.json` 只记录当前活跃会话索引，避免同一会话被拆成多个目录
@@ -232,7 +232,7 @@ templates/ 查找路径（按优先级；首次确定模板根目录后，本轮
 - 状态文件（`state_path`）— ≤70 行，用来记录“上次做到哪里”。判断当前任务时，当前用户消息、显式命令、活跃方案包 / PRD、代码与验证证据优先于状态文件
   内容：主线目标、正在做什么、关键上下文（决策/变更/假设）、下一步（具体可执行动作含文件路径）、阻塞项
   适用边界：
-  - 强制创建并持续更新：`~wiki`、`~init`、`~plan`、`~build`、`~auto`、`~prd`、`~loop`，以及已激活项目的连续任务
+  - 强制创建并持续更新：`~wiki`、`~init`、`~global`、`~plan`、`~build`、`~auto`、`~prd`、`~loop`，以及任何会创建/修改本地文件、会在当前工作区留下实际输出或操作记录的非只读任务
   - 强制更新，不要求首次创建：`~clean`，主代理汇总子代理结果后
   - 已有则更新：`~verify`、`~review`（兼容别名）、`~test`、`~commit`
   - 不创建：`~help`、`~idea`、普通问答、一次性只读任务、子代理自身执行过程、压缩/恢复钩子
@@ -253,7 +253,7 @@ templates/ 查找路径（按优先级；首次确定模板根目录后，本轮
 - archive/_index.md — 归档索引
 
 ### 知识记录（受 `kb_create_mode` 控制）
-- 0=关闭；1=已激活项目或全局模式中的编码任务自动同步；2=已激活项目或全局模式中始终同步
+- 0=关闭；1=知识库已存在时自动同步；2=编码任务在知识库已存在或全局模式下自动创建或同步
 - context.md — 项目架构、技术栈、目录结构、模块索引
 - guidelines.md — 编码约定（仅含非显而易见的约定）
 - CHANGELOG.md — 变更历史