nexforge-cli 0.4.0__tar.gz → 0.5.0__tar.gz

{nexforge_cli-0.4.0 → nexforge_cli-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: nexforge-cli
-Version: 0.4.0
+Version: 0.5.0
 Summary: NexForgeCLI — 一个面向 DeepSeek V4 的终端智能体(TUI + CLI 双模式)
 Project-URL: Homepage, https://gitee.com/Lighthorn/nexforgecli
 Author: NexForge
@@ -51,13 +51,14 @@ Description-Content-Type: text/markdown
 
 NexForgeCLI 是一个运行在终端里的智能体助手，既支持 DeepSeek/千问等多模型，也是**插件宿主**（plugins 目录即插即用）。既能作为全屏 TUI 交互式对话/编码，也能作为 one-shot 命令行工具嵌进脚本和管道。
 
-> 当前版本:**v0.4.0** · PyPI: `pip install nexforge-cli`
+> 当前版本:**v0.5.0** · PyPI: `pip install nexforge-cli`
 
-**v0.4.0 要点**：语音播报接入**本机 TTS**（如本地部署的 CosyVoice）——本机优先、
-失败自动回退微软 Windows 语音；用 nf 时让本机模型**常驻显存**、nf 全部退出即释放
-（租约机制，被强杀也能自愈回收）。新增 `/voice full|brief` 切换播报范围（默认**全量播报**）。
-另修：配置里的残留值（失效 provider / 旧档位）自动收敛并给出可定位告警，
-不再让启动失败或报假警。
+**v0.4.1 要点（重要修复）**：会话重建时，**内容里出现的 `<!-- nf-msg … -->` 不再被当成消息边界**。
+此前若工具结果 dump 过会话文件（或粘贴过会话内容），加载时那些标记会被解码成额外消息、
+插进工具块中间，导致**每轮请求 400、项目再也打不开**。
+修法：读侧标记识别改为**行首锚定**，写侧对内容里的标记前缀做转义；同时把工具序列修复
+从"只修尾部"升级为"修全序列"（中段违规也能纠正）。
+另含 0.4.0 推出的：本机 TTS 优先/回退、模型随 nf 常驻、`/voice full|brief`、配置残留值自动收敛。
 
 ---
 

{nexforge_cli-0.4.0 → nexforge_cli-0.5.0}/README.md

@@ -8,13 +8,14 @@
 
 NexForgeCLI 是一个运行在终端里的智能体助手，既支持 DeepSeek/千问等多模型，也是**插件宿主**（plugins 目录即插即用）。既能作为全屏 TUI 交互式对话/编码，也能作为 one-shot 命令行工具嵌进脚本和管道。
 
-> 当前版本:**v0.4.0** · PyPI: `pip install nexforge-cli`
-
-**v0.4.0 要点**：语音播报接入**本机 TTS**（如本地部署的 CosyVoice）——本机优先、
-失败自动回退微软 Windows 语音；用 nf 时让本机模型**常驻显存**、nf 全部退出即释放
-（租约机制，被强杀也能自愈回收）。新增 `/voice full|brief` 切换播报范围（默认**全量播报**）。
-另修：配置里的残留值（失效 provider / 旧档位）自动收敛并给出可定位告警，
-不再让启动失败或报假警。
+> 当前版本:**v0.5.0** · PyPI: `pip install nexforge-cli`
+
+**v0.4.1 要点（重要修复）**：会话重建时，**内容里出现的 `<!-- nf-msg … -->` 不再被当成消息边界**。
+此前若工具结果 dump 过会话文件（或粘贴过会话内容），加载时那些标记会被解码成额外消息、
+插进工具块中间，导致**每轮请求 400、项目再也打不开**。
+修法：读侧标记识别改为**行首锚定**，写侧对内容里的标记前缀做转义；同时把工具序列修复
+从"只修尾部"升级为"修全序列"（中段违规也能纠正）。
+另含 0.4.0 推出的：本机 TTS 优先/回退、模型随 nf 常驻、`/voice full|brief`、配置残留值自动收敛。
 
 ---
 

{nexforge_cli-0.4.0 → nexforge_cli-0.5.0}/config.example.toml

@@ -16,6 +16,14 @@ thinking = true                            # 思考模式,默认开
 reasoning_effort = "high"                  # high | max
 max_output_tokens = 32768                  # 含思考 token; 别写 8192(思考会吃满 → 正文截断秒停)
 
+# 上下文窗口(压缩预算的依据)。**默认不写 = 自动跟随当前模型**:
+#   用户声明(models.toml 的本项 / config.toml 的 context_window)> 实测学习
+#   (上游报错里的窗口数字 / 失败请求体量 / 成功响应的 prompt_tokens)> 内置表
+#   > 未知模型兜底(1,000,000)。
+# 只有需要**强制覆盖**自动判断时才在这里写(>0 即视为声明, 优先级最高;
+# 但上游若用报错证明窗口更小, 实测值仍会压低它 —— 物理事实优先)。
+# context_window = 1000000
+
 # 定价(每百万 token,USD)—— 已核实
 [models.pricing.flash]
 input_cache_hit = 0.0028

{nexforge_cli-0.4.0 → nexforge_cli-0.5.0}/doc//351/241/271/347/233/256/346/200/273/347/233/221/345/276/252/347/216/257-/345/274/200/345/217/221/350/256/241/345/210/222.md

@@ -1,172 +1,187 @@
-# 项目总监循环 开发计划
-
-> 版本: v1.0 · 创建: 2026-07-16 · 状态: 设计完成,待实现
-
----
-
-## 概述
-
-在目标模式(`/goal`)下,引入"项目总监 + 开发者"双角色架构。项目总监负责制定计划、审核进展、分发任务;开发者负责具体执行。目标是让 AI 能够自主完成复杂的多轮开发任务,同时保证质量和可追溯性。
-
----
-
-## 角色定义
-
-### 项目总监 (Director)
-
-- **职责**:审核开发者报告 → 判断进展 → 发布下一条指令
-- **审核维度**:代码质量、性能瓶颈、稳定性、用户体验、逻辑流程
-- **防僵局策略**:当开发者反复说"任务完成"时,从以下方向主动寻找新工作:
-  - 边界情况覆盖
-  - 测试补充
-  - 性能优化
-  - 文档/代码注释
-  - 代码重构整理
-  - 是否真正满足核心需求
-- **停止判断**:若目标已达成,回复 `GOAL_ACHIEVED` 关键词
-
-### 开发者 (Developer)
-
-- **职责**:执行项目总监的指令 → 完成后提交总结报告
-- **行为约束**:专注执行指令,不做多余的事
-
----
-
-## 启动流程 (二步确认)
-
-```
-用户输入 /goal
-  → Step 1: 弹出风险警告弹窗(GoalModeModal)
-  → Step 2: 弹出多行输入框,用户输入目标描述
-  → Step 3: 显示目标预览,提示"回复确认开始"
-  → Step 4: 用户回复"确认"/"开始"/"ok"/"yes"
-  → Step 5: 正式启动
-```
-
-### 启动时操作
-1. `self.config.ui.goal_mode = True`
-2. `self.config.ui.mode = "auto"` (强制全自动)
-3. 保存到项目级 `config.toml`
-4. 创建 `.nexforge/goal/nfgoal.md` (记录最终目标)
-5. 发送首轮指令给 AI:"[项目总监] 制定开发计划并发布第一条指令"
-
----
-
-## 循环流程
-
-```
-每个 AI 回合结束 (TURN_DONE)
-  → 如果 goal_mode == True:
-      → 调用 _goal_cycle_continue(last_response)
-      → 检查停止条件
-      → 显示项目总监金色消息
-      → 构造总监 prompt(包含目标+计划+开发者报告)
-      → 启动下一轮 AI
-```
-
-### 停止条件 (任一满足即停止)
-
-| 条件 | 检测方式 | 操作 |
-|------|---------|------|
-| 余额耗尽 | `_balance == "0.00"` | 显示"账户余额耗尽",退出目标模式 |
-| 总监判断达成 | `last_response` 含 `GOAL_ACHIEVED` | 显示"项目总监判断目标达成" |
-| 达到最大轮数 | `current >= max_rounds` (默认 100,可通过 `/max N` 设置) | 显示"达到最大轮数" |
-
----
-
-## UI 显示
-
-### 项目总监消息 (金色)
-```python
-class DirectorNote(Static):
-    """👔 项目总监: 消息内容 (金色 #FFD700 加粗)"""
-```
-
-- 每轮开始前在聊天区显示金色提示条
-- 格式:`第 N/M 轮:项目总监审核`
-
-### 状态栏
-- 目标模式开启时显示 `🎯 目标`
-- 运维模式开启时显示 `🔧 运维`
-
----
-
-## 快捷键
-
-| 快捷键 | 功能 |
-|--------|------|
-| F7 | 切换运维模式 |
-| F8 | 切换目标模式(开启时强制全自动) |
-| Esc | 目标模式三级停止:停总监 → 停开发者 → 退出 |
-
-### Esc 三级停止逻辑
-```
-Esc 第1次:停止项目总监(goal_mode=False,开发者继续当前工作)
-Esc 第2次:取消开发者 worker
-Esc 第3次:弹出退出确认
-```
-
----
-
-## 文件体系 (项目隔离,仅目标模式)
-
-```
-<项目>/.nexforge/goal/
-├── nfgoal.md           ← 最终目标
-├── plan.md             ← 项目总监编写的计划
-└── rounds/
-    ├── 001.md           ← 第1轮:开发者报告 + 总监审核
-    ├── 002.md           ← 第2轮
-    └── ...
-```
-
-- 非目标模式不创建此目录
-- 离开目标模式后不自动清理(保留历史)
-
----
-
-## 配置项
-
-| 配置 | 默认 | 说明 |
-|------|------|------|
-| `ui.goal_mode` | `false` | 是否处于目标模式 |
-| `ui.ops_mode` | `false` | 是否处于运维模式 |
-| `ui.max_rounds` | `100` | 目标模式最大轮数,通过 `/max N` 修改 |
-| `ui.mode` | `review` | 审批模式(review/auto) |
-
----
-
-## 涉及文件
-
-| 文件 | 改动 |
-|------|------|
-| `src/nexforge/core/goal_manager.py` | **已创建** — GoalManager 类 |
-| `src/nexforge/ui/screens/chat.py` | 加 `_start_goal_mode`、`_confirm_goal_start`、`_goal_cycle_continue` |
-| `src/nexforge/ui/widgets/messages.py` | **已创建** — DirectorNote 金色组件 |
-| `src/nexforge/ui/widgets/mode_warning.py` | 已有 GoalModeModal、OpsModeModal |
-| `src/nexforge/config.py` | goal_mode/ops_mode/max_rounds 字段 |
-| `src/nexforge/store/session_store.py` | 会话保存过滤系统消息(已实现) |
-
----
-
-## 实现注意事项
-
-1. **不要用 heredoc/多行字符串替换编辑 chat.py**——该文件已因反复编辑损坏多次
-2. **使用 `edit_file` 工具逐个精准替换**,每次编辑后编译验证
-3. **`_goal_cycle_continue` 必须独立为类方法**,不能嵌入其他方法中
-4. **字符串拼接用 `+` 而非 f-string 跨行**,避免语法错误
-5. **`save_config` 按项目保存**(`<cwd>/.nexforge/config.toml`),不污染全局
-6. **系统消息不保存到会话文件**(已在 session_store.py 实现)
-
----
-
-## 测试验证
-
-- [ ] `/goal` → 弹窗 → 输入目标 → "确认" → 项目总监启动
-- [ ] F8 一键切换目标模式
-- [ ] F7 一键切换运维模式
-- [ ] Esc 三级停止(目标模式)
-- [ ] `GOAL_ACHIEVED` 自动停止
-- [ ] `/max 50` 修改轮数上限
-- [ ] 不同项目独立模式状态
-- [ ] 余额耗尽自动停止
+# 项目总监循环 开发计划
+
+> 版本: v1.0 · 创建: 2026-07-16 · 状态: 设计完成,待实现
+
+---
+
+## 概述
+
+在目标模式(`/goal`)下,引入"项目总监 + 开发者"双角色架构。项目总监负责制定计划、审核进展、分发任务;开发者负责具体执行。目标是让 AI 能够自主完成复杂的多轮开发任务,同时保证质量和可追溯性。
+
+---
+
+## 角色定义
+
+### 项目总监 (Director)
+
+- **职责**:审核开发者报告 → 判断进展 → 发布下一条指令
+- **审核维度**:代码质量、性能瓶颈、稳定性、用户体验、逻辑流程
+- **防僵局策略**:当开发者反复说"任务完成"时,从以下方向主动寻找新工作:
+  - 边界情况覆盖
+  - 测试补充
+  - 性能优化
+  - 文档/代码注释
+  - 代码重构整理
+  - 是否真正满足核心需求
+- **停止判断**:若目标已达成,回复 `GOAL_ACHIEVED` 关键词
+
+### 开发者 (Developer)
+
+- **职责**:执行项目总监的指令 → 完成后提交总结报告
+- **行为约束**:专注执行指令,不做多余的事
+
+---
+
+## 启动流程 (二步确认)
+
+```
+用户输入 /goal
+  → Step 1: 弹出风险警告弹窗(GoalModeModal)
+  → Step 2: 弹出多行输入框,用户输入目标描述
+  → Step 3: 显示目标预览,提示"回复确认开始"
+  → Step 4: 用户回复"确认"/"开始"/"ok"/"yes"
+  → Step 5: 正式启动
+```
+
+### 启动时操作
+1. `self.config.ui.goal_mode = True`
+2. `self.config.ui.mode = "auto"` (强制全自动)
+3. 保存到项目级 `config.toml`
+4. 创建 `.nexforge/goal/nfgoal.md` (记录最终目标)
+5. 发送首轮指令给 AI:"[项目总监] 制定开发计划并发布第一条指令"
+
+---
+
+## 循环流程
+
+```
+每个 AI 回合结束 (TURN_DONE)
+  → 如果 goal_mode == True:
+      → 调用 _goal_cycle_continue(last_response)
+      → 检查停止条件
+      → 显示项目总监金色消息
+      → 构造总监 prompt(包含目标+计划+开发者报告)
+      → 启动下一轮 AI
+```
+
+### 停止条件 (任一满足即停止)
+
+| 条件 | 检测方式 | 操作 |
+|------|---------|------|
+| 余额耗尽 | `_balance == "0.00"` | 显示"账户余额耗尽",退出目标模式 |
+| 总监判断达成 | `last_response` 含 `GOAL_ACHIEVED` | 显示"项目总监判断目标达成" |
+| 达到最大轮数 | `current >= max_rounds` (默认 100,可通过 `/max N` 设置) | 显示"达到最大轮数" |
+
+---
+
+## UI 显示
+
+### 项目总监消息 (金色)
+```python
+class DirectorNote(Static):
+    """👔 项目总监: 消息内容 (金色 #FFD700 加粗)"""
+```
+
+- 每轮开始前在聊天区显示金色提示条
+- 格式:`第 N/M 轮:项目总监审核`
+
+### 状态栏
+- 目标模式开启时显示 `🎯 目标`
+- 运维模式开启时显示 `🔧 运维`
+
+---
+
+## 快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| F7 | 切换运维模式 |
+| F8 | 切换目标模式(开启时强制全自动) |
+| Esc | 目标模式三级停止:停总监 → 停开发者 → 退出 |
+
+### Esc 三级停止逻辑
+```
+Esc 第1次:停止项目总监(goal_mode=False,开发者继续当前工作)
+Esc 第2次:取消开发者 worker
+Esc 第3次:弹出退出确认
+```
+
+---
+
+## 文件体系 (项目隔离,仅目标模式)
+
+```
+<项目>/.nexforge/goal/
+├── nfgoal.md           ← 最终目标
+├── plan.md             ← 项目总监编写的计划
+└── rounds/
+    ├── 001.md           ← 第1轮:开发者报告 + 总监审核
+    ├── 002.md           ← 第2轮
+    └── ...
+```
+
+- 非目标模式不创建此目录
+- 离开目标模式后不自动清理(保留历史)
+
+---
+
+## 配置项
+
+| 配置 | 默认 | 说明 |
+|------|------|------|
+| `ui.goal_mode` | `false` | 是否处于目标模式 |
+| `ui.ops_mode` | `false` | 是否处于运维模式 |
+| `ui.max_rounds` | `100` | 目标模式最大轮数,通过 `/max N` 修改 |
+| `ui.mode` | `review` | 审批模式(review/auto) |
+
+---
+
+## 涉及文件
+
+| 文件 | 改动 |
+|------|------|
+| `src/nexforge/core/goal_manager.py` | **已创建** — GoalManager 类 |
+| `src/nexforge/ui/screens/chat.py` | 加 `_start_goal_mode`、`_confirm_goal_start`、`_goal_cycle_continue` |
+| `src/nexforge/ui/widgets/messages.py` | **已创建** — DirectorNote 金色组件 |
+| `src/nexforge/ui/widgets/mode_warning.py` | 已有 GoalModeModal、OpsModeModal |
+| `src/nexforge/config.py` | goal_mode/ops_mode/max_rounds 字段 |
+| `src/nexforge/store/session_store.py` | 会话保存过滤系统消息(已实现) |
+
+---
+
+## 实现注意事项
+
+1. **不要用 heredoc/多行字符串替换编辑 chat.py**——该文件已因反复编辑损坏多次
+2. **使用 `edit_file` 工具逐个精准替换**,每次编辑后编译验证
+3. **`_goal_cycle_continue` 必须独立为类方法**,不能嵌入其他方法中
+4. **字符串拼接用 `+` 而非 f-string 跨行**,避免语法错误
+5. **`save_config` 按项目保存**(`<cwd>/.nexforge/config.toml`),不污染全局
+6. **系统消息不保存到会话文件**(已在 session_store.py 实现)
+
+---
+
+## 测试验证
+
+- [ ] `/goal` → 弹窗 → 输入目标 → "确认" → 项目总监启动
+- [ ] F8 一键切换目标模式
+- [ ] F7 一键切换运维模式
+- [ ] Esc 三级停止(目标模式)
+- [ ] `GOAL_ACHIEVED` 自动停止
+- [ ] `/max 50` 修改轮数上限
+- [ ] 不同项目独立模式状态
+- [ ] 余额耗尽自动停止
+
+---
+
+## 实现现状补充(2026-09-12)
+
+本节记录与上面设计稿**不一致**的最终实现，避免后来者按设计稿误判代码。
+
+| 设计稿 | 实现现状 | 原因 |
+|------|---------|------|
+| Esc 三级停止(停总监 → 停开发者 → 退出) | **一次 Esc 停整个目标模式**(停总监循环 + 取消开发者 worker + 关双栏 + 关 goal_mode)；空闲时才是退出确认 | 三级停止需记"第几次 Esc"状态，实际使用中用户按第一次没停住会反复按；一次停干净更可预期 |
+| 离开目标模式不自动清理(保留历史) | 停止/关闭/切换时把现场**归档**到 `.nexforge/goal_archive/<时间戳>-<标签>/`，现场清空 | "保留现场"会让下次开启把旧目标误判为"插话"(note_20260825_214722)；归档同时满足可回看与不误判 |
+| 余额耗尽检测 `_balance == "0.00"` | `parse_balance()` 数值化，`<=0` 才算耗尽；解析不出则不停止 | 子串匹配会把 `¥100.00`/`¥20.00`/`¥1,000.00` 误判为耗尽 |
+| 总监/开发者回合失败无约定 | 失败必可见：开发者异常结束补"失败回执"交总监决策；总监回合失败重试一次后**暂停**(保留现场，回一句话即续跑) | 失败没有回执通道时，循环停在 `await _wake_event.wait()`，用户看到的是"AI 不动了" |
+
+详见 ADR `docs/decisions/2026-09-12-目标模式失败可见与历史保全.md`。

nexforge_cli-0.5.0/docs/decisions/2026-09-12-/345/206/205/345/256/271/351/207/214/347/232/204/346/240/207/350/256/260/344/270/215/345/276/227/345/275/223/346/210/220/346/266/210/346/201/257/350/276/271/347/225/214.md

@@ -0,0 +1,65 @@
+# 决策：内容里的 `<!-- nf-msg … -->` 不得被当成消息边界
+
+> 日期：2026-09-12 · 状态：生效
+
+## 背景
+
+会话重建的权威是每行消息末尾的结构化标记 `<!-- nf-msg <base64> -->`（`docs/session-invariant.md` §4.1）。
+但解析用的是**全文 `findall`**，于是"内容里出现的标记"与"真正的消息边界"无法区分。
+
+触发链（实测，NexForgeCLI 自己的 `session-122357`）：
+
+1. 工具结果 dump 了某个会话 `.md` 文件（`read_file .nexforge/sessions/session-…md`），
+   被 dump 的标记行作为**内容**落进新会话文件；
+2. 下次加载时，这些"内容里的标记"被解码成**额外消息**，且插在
+   `assistant(tool_calls)` 与它的 `tool` 响应之间（实测多出 10 份重复助手消息）；
+3. 请求违反 OpenAI/DeepSeek 规则——"带 tool_calls 的 assistant 后必须紧跟覆盖全部
+   tool_call_id 的 tool 消息"——返回 400
+   `insufficient tool messages following tool_calls message`；
+4. `_repair_incomplete_tail` 只修**尾部**，看不见中段违规 → 每轮请求都 400。
+   用户侧现象：**"项目再也打不开"**（打开后说什么都报错）。
+
+## 决策
+
+三层一起上（缺任一层都有残留口子）：
+
+1. **写侧转义**（`_escape_marker_prefix`）：人读部分里出现的 `<!-- nf-msg` 一律插入零宽空格
+   `\u200b` 转义。标记内的 base64 负载不受影响 → 重建权威无损
+   （§4.1 本就允许人读部分变形/截断）。
+2. **读侧锚定**（`_MARKER_RE` 加 `re.M` 与行首 `^`）：只有**独立成行**的标记才是边界。
+   真标记必然在行首（所有人类可读块都以换行结尾），全仓库历史会话文件实测零反例。
+3. **全序列修复**（`_repair_incomplete_tail` → `_repair_tool_sequence`，旧名保留为别名）：
+   修复**整条序列**而不是尾部 —— 夹层消息**保序后移**、缺响应的 tool_call 补"已取消"、
+   重复响应与无主孤儿 tool 删除。修复后的序列对 API **恒合法**。
+   配套：`agent.py` 的防死循环提示改为在整块工具响应**之后**追加，不再插进 tool 之间。
+
+## 理由
+
+- **只修尾部不够**：违规可能在中段（本次实测），尾部修复完全看不到。
+- **只加读侧锚定不够**：不带行号前缀的内容（用户把会话文件整段粘进对话、shell 直接
+  `type` 出文件）仍能伪造出行首标记。
+- **只加写侧转义不够**：修复前落盘的历史文件里已有的镶嵌标记仍会被解码 → 需要读侧 +
+  全序列修复兜底（已用真机 `session-122357` 验证：修复后非法点 0）。
+- **否决"按人读格式严格比对，再判定某个标记是否可信"**：人读格式一旦演进，旧文件会被
+  整段判成伪标记 → **静默丢历史**，代价远高于收益（不变量只禁止一件事：无声地丢失）。
+
+## 代价与边界
+
+- 人读部分与原始内容有肉眼不可见的差异（零宽空格）；工具结果原文仍由标记负载精确重建。
+- 夹层消息只"后移"不删除：已积累的重复消息仍占上下文（必要时人工清理）。
+- **复用注意**：`_repair_tool_sequence` 为兼容旧行为会弹出**尾部未配对 user**；因此它之后必须
+  紧跟 `add_user`（app 的 `run_turn` 顺序）。若单独调用后直接发请求，列表会以 assistant 结尾，
+  thinking 模式下会触发另一条 400 `reasoning_content ... must be passed back`
+  （见 `docs/evidence/session-marker-boundary_report.md` §5 坑 1）。
+- **已知未覆盖（本次不改，另行决策）**：`save_session` 不清理"陈旧分段"（列表变短时，
+  旧的高编号分段文件仍会被 `load_session` 追加 → 陈旧内容混入 + 可能非法序列）。
+  机制已在证据脚本里复现（3 条被加载成 130 条）；全序列修复能兜住 400，但内容冗余仍在。
+
+## 关联
+
+- 模块：`store/session_store.py`（`_MARKER_RE` / `_escape_marker_prefix` / `_format_message`）、
+  `core/session.py`（`_repair_tool_sequence`）、`core/agent.py`（提示位置）
+- 文档：`docs/session-invariant.md` §4.1
+- 测试：`tests/test_session_store.py`（往返）、`tests/test_session_repair.py`（全序列）、
+  `tests/test_session_invariant.py`
+- 证据：`docs/evidence/session-marker-boundary_report.md` / `.log`