dsh-code 0.6.1 → 0.8.0

package/README.en.md

@@ -34,15 +34,15 @@ The interface follows familiar terminal conventions, while runtime behavior cont
 
 ## 2. Quick start
 
-Requires Node `^22.19 || >=24`, the preview `dsh` CLI, and `DEEPSEEK_API_KEY`.
+Requires Node `^22.19 || >=24` and the preview `dsh` CLI. `DEEPSEEK_API_KEY` is not a startup prerequisite: the TUI, sessions, and non-model features remain available without it; press `a` in `/model` to add an API key through the Harness credentials service.
 
 ```sh
 npm install -g @deepseek-ai/dsh dsh-code
 npm install -g pnpm
-dsh plugin --profile cli add dsh-code@0.6.1
+dsh plugin --profile cli add dsh-code@0.8.0
 ```
 
-> Note: pnpm ignores packages published less than 24 hours ago, so pin `dsh-code@0.6.1` on the release day; the version can be omitted afterwards. npm installs are not affected.
+> Note: pnpm ignores packages published less than 24 hours ago, so pin `dsh-code@0.8.0` on the release day; the version can be omitted afterwards. npm installs are not affected.
 
 Available launch commands:
 
@@ -91,7 +91,7 @@ Inside the TUI:
 | `/new [preset]` | Create and enter another session without restarting the terminal |
 | `/resume [id\|prefix]` | Search root sessions or all conversations; filter by cwd, order, and density |
 | `/mode [preset]` | Inspect or select the blank session's Agent composition |
-| `/model` | Switch among models advertised by the live LLM registry |
+| `/model` | Switch among models from the live LLM registry; press `a` to manage providers and API keys |
 | `/plugin [query]` | Inspect loader entries, enabled state, module identity, and fiber phase |
 | `/permission <name>` | Change the permission preset; Shift+Tab cycles presets |
 | `/help` | Browse local commands, Harness commands, skills, and key bindings |
@@ -100,6 +100,8 @@ Inside the TUI:
 | `@` | Mention workspace files or bounded snapshots of persisted sessions |
 | `Esc` / `Ctrl+C` | Close the topmost surface or interrupt the active turn |
 
+The `/model` provider panel reads only credential configuration, source, and writability facts. Typed keys stay masked and are handed directly to Harness persistence. Keys supplied by the launch environment are shown as read-only and cannot be overwritten or removed in the TUI.
+
 ## 4. Features
 
 ### 1. Agent and extensions
@@ -107,7 +109,7 @@ Inside the TUI:
 - Per-session Agent Presets for tools, prompt sections, skills, compaction, plan mode, and delegation
 - Live slash-command and skill discovery from shared Harness registries
 - Read-only Cordis loader diagnostics through `/plugin`
-- Model routing through the live LLM registry, restored per persisted session
+- Model routing through the live LLM registry, restored per persisted session; `/model` can add or rotate keys, remove writable keys, and delete user-added provider profiles
 - Plans, goals, todos, permissions, sandbox state, subagents, and runtime steering
 
 ### 2. Sessions and context
@@ -133,11 +135,23 @@ Inside the TUI:
 - Folded thinking, terminal Markdown, compact tool summaries, and full structured details
 - Two-row status bar with mode and context on the second row, a blue context-occupancy meter, and all-blue accents
 - Submissions while a turn runs appear immediately as ordinary prompt rows; Delete cancels the newest queued message, and busy states use the web StateDot chase animation
-- Replies align with the input cursor, and the welcome wordmark is brighter
+- Replies align with the input cursor, and the welcome header shows the installed version with the bilingual slogan “Into the Unknown  探索未至之境”
 - Ctrl+O exclusive history inspection with entry navigation and complete vertical scrolling
 - Width-safe CJK/control-character handling, compact-terminal degradation, and debounced resize replay
 - Stable bottom order: content or panel → notice → composer → status
 
+#### DeepSeek model-switch animations
+
+Switching to a DeepSeek route, or changing reasoning effort on the same route, randomly plays Wave, Aurora, or Pulse across the composer without repeating the previous style. Flash models use the single-band tier; other DeepSeek models use the richer multi-band tier.
+
+| Style | Flash | DeepSeek |
+| --- | --- | --- |
+| Wave | One blue crest sweeps left to right, 1.2s | Two offset crests, 1.5s |
+| Aurora | Two blue light bands drift sinusoidally, 1.5s | Three differently hued bands, 1.8s |
+| Pulse | One ring expands from the composer center, 1.1s | Two sequential expanding rings, 1.45s |
+
+The animation runs locally in the composer at about 30 FPS. Its background and border return to rest afterward while the DeepSeek-tier prompt marker remains.
+
 ## 5. How DSH-Code integrates with DSH
 
 ### 1. Runtime composition

package/README.md

@@ -34,15 +34,15 @@ DSH-Code 保留这套结构，并补充适合编码任务的终端工作流。
 
 ## 二、快速开始
 
-需要 Node `^22.19 || >=24`、预览版 `dsh` CLI，以及 `DEEPSEEK_API_KEY`。
+需要 Node `^22.19 || >=24` 和预览版 `dsh` CLI。`DEEPSEEK_API_KEY` 不是启动前置条件：未配置时仍可进入 TUI、查看会话和使用非模型功能；在 `/model` 中按 `a` 可通过 Harness credentials 服务添加 API key。
 
 ```sh
 npm install -g @deepseek-ai/dsh dsh-code
 npm install -g pnpm
-dsh plugin --profile cli add dsh-code@0.6.1
+dsh plugin --profile cli add dsh-code@0.8.0
 ```
 
-> 提示：pnpm 会忽略发布不足 24 小时的包，因此发布首日请使用精确版本 `dsh-code@0.6.1`；24 小时后可省略版本号。npm 安装不受此限制。
+> 提示：pnpm 会忽略发布不足 24 小时的包，因此发布首日请使用精确版本 `dsh-code@0.8.0`；24 小时后可省略版本号。npm 安装不受此限制。
 
 可用的启动指令：
 ```sh
@@ -90,7 +90,7 @@ dsh --profile cli --session my-id    # 使用指定 id 新建会话
 | `/new [preset]` | 不重启终端，创建并进入另一个会话 |
 | `/resume [id\|前缀]` | 搜索根会话或全部对话，并按 cwd、排序和密度筛选 |
 | `/mode [preset]` | 检查或选择空会话的 Agent 组合 |
-| `/model` | 在实时 LLM 注册表提供的模型间切换 |
+| `/model` | 在实时 LLM 注册表提供的模型间切换；按 `a` 管理 provider 与 API key |
 | `/plugin [query]` | 检查 loader 条目、启用状态、模块身份和 fiber 阶段 |
 | `/permission <name>` | 切换权限预设；Shift+Tab 可循环切换 |
 | `/help` | 浏览本地命令、Harness 命令、技能和快捷键 |
@@ -99,6 +99,8 @@ dsh --profile cli --session my-id    # 使用指定 id 新建会话
 | `@` | 引用工作区文件或持久会话的有界快照 |
 | `Esc` / `Ctrl+C` | 关闭最上层界面或中断当前 turn |
 
+`/model` 的 provider 面板只读取 credential 的已配置状态、来源和可写性；输入内容始终遮蔽并直接交给 Harness 持久化。由启动环境提供的 key 会标记为只读，不能在 TUI 中覆盖或移除。
+
 ## 四、功能
 
 ### 1. Agent 与扩展
@@ -106,7 +108,7 @@ dsh --profile cli --session my-id    # 使用指定 id 新建会话
 - 每会话 Agent Preset：组合工具、提示词、技能、上下文压缩、plan mode 与委派能力
 - 从共享 Harness 注册表实时发现斜杠命令和用户技能
 - 通过 `/plugin` 只读诊断 Cordis loader
-- 从实时 LLM 注册表路由模型，并按持久会话恢复选择
+- 从实时 LLM 注册表路由模型，并按持久会话恢复选择；`/model` 可添加或轮换 key、移除可写 key，以及删除用户添加的 provider profile
 - 支持 plan、goal、todo、权限、sandbox、subagent 与运行中 steering
 
 ### 2. 会话与上下文
@@ -132,11 +134,23 @@ dsh --profile cli --session my-id    # 使用指定 id 新建会话
 - 思考折叠、终端 Markdown、紧凑工具摘要与完整结构化详情
 - 双行状态栏：mode 与 context 在第二行，context 为蓝色进度条，全蓝强调
 - 运行中提交即时显示为普通提示词行，Delete 取消排队消息，busy 使用 web StateDot 八点追逐动画
-- 回复与输入框光标对齐，欢迎头字标提亮
+- 回复与输入框光标对齐，欢迎头显示已安装版本与双语 slogan“Into the Unknown  探索未至之境”
 - Ctrl+O 独占历史检查，支持切换条目与完整纵向滚动
 - CJK/控制字符宽度安全、短终端主动降级、缩放防抖重放
 - 固定底部顺序：内容或面板 → notice → 输入框 → 状态栏
 
+#### DeepSeek 模型切换动画
+
+切换到 DeepSeek 路由，或在同一路由切换 reasoning effort 时，输入框会随机播放 Wave、Aurora 或 Pulse；相邻两次不会重复同一种样式。Flash 模型使用单波段档位，其他 DeepSeek 模型使用更丰富的多波段档位。
+
+| 样式 | Flash | DeepSeek |
+| --- | --- | --- |
+| Wave | 单个蓝色波峰从左向右扫过，1.2s | 两个错开的波峰，1.5s |
+| Aurora | 两条蓝色光带正弦漂移，1.5s | 三条不同色调光带，1.8s |
+| Pulse | 一个圆环从输入框中心扩散，1.1s | 两个先后扩散的圆环，1.45s |
+
+动画以约 30 FPS 在输入框局部运行；结束后背景和边框恢复静态，DeepSeek 档位提示符继续保留。
+
 ## 五、DSH-Code 如何接入 DSH
 
 ### 1. 运行时组合