# Changelog ## 1.19.0 — 商业拆成两个模式:判断一个方向,或者找出几十个方向 商业本来就是两种活:**手里有一个方向,判断它靠不靠谱**;**手里什么都没有,要找方向**。上一版只做了前者,逼着后者用同一套六阶段流程,结果它只能审一个自己想出来的点子。现在分成两个模式: | 模式 | 什么时候用 | 产出 | |---|---|---| | **商业**(`venture`) | 已经有一个具体项目/产品方向 | 六阶段取证,最后给出六档结论(值得验证 / 进入小范围 / 缩小 / 暂缓 / 不适合 / 停止) | | **找方向**(`scout`) | 还没有方向,要先扫一批 | 20+ 个可复刻的付费产品,覆盖 8+ 个行业,一份明确的排除清单,最后 3–7 个候选和每个的第一个实验 | **找方向模式专门用来对抗惯性思维**,而且不是靠提示词劝说,是靠工具拒绝: - **每个类别最多 3 个候选**。第四个同类的 `scout_candidate` 直接被拒并列出当前分布:二十个"又一个 SaaS 面板"这条路被堵死。 - **候选清单要 20+ 候选、8+ 类别、5+ 条排除记录**。缺哪一样,`scout_shortlist` 一次把缺口全列出来,不接受"先给我五个想法"。 - **必须写排除清单**(`scout_exclude`)。模型要把自己第一反应想到的那些东西(AI 套壳聊天、又一个 Notion 模板、通用 CRM…)明确写下来并说清为什么不值得做,输出成 `excluded.md` 给人看。 - **每个候选必须写 `why_not_obvious` 和 `risk`**:它为什么不是第一反应那个东西,它最可能怎么死。写不出这两条就不算候选。 - **每个候选必须挂一条已登记的产品页/定价页**,还要有价格、买家、可复刻理由和工期(days/weeks/months)。 - **最后必须给每个候选配一个最小实验**(问谁、给谁看、试什么价、什么算失败),否则只是一份清单。 两个模式都是**只读项目 + 联网由模式预先同意**,产出都在 `.eca/` 里(`.eca/business`、`.eca/scout`),可以读、可以 diff、可以备份。 界面:模式菜单多一项「找方向」(罗盘图标);输入框上方一条四阶段条 `立标准 → 扫样本 → 筛与排除 → 候选清单`,右侧 `候选 N · 类别 N · 排除 N · 清单 未出|已出`,点文件图标展开 `.eca/scout` 制品。阶段条依旧只读,推进只能靠工具。 验证:`tests/test_scout.py` 11 项(类别配额拒绝第四个、候选必须挂已登记来源、工期枚举、扫样本前要 criteria.md、筛前排要 12 个候选、清单门槛逐条点名、3–7 个且必须是已登记候选、排除清单去重并写成 md、提示词带配额与排除规则);`desktop/tests/scout-mode-e2e.cjs` 用隐藏窗口 + 本地模拟模型跑通「模式可选 → 四阶段条 → 未写 criteria 时越级被拒 → 写入后阶段前进 → 同类第四个被配额拒绝(含 leave the obvious pool 原文)→ 排除一条 → 清单门槛同时点名 candidates/categories/excluded」13 次本地请求、0 付费 API。 **边界**:这两个模式都不替你决定"做不做"之外的事——访谈、投放、付费、发布仍需单独授权;登记的页面只证明记录存在,不证明公司健康或模式可复制;"可复刻"是模型根据公开信息做的判断,没有代码和资质核查。 ## 1.18.0 — 商业模式:大规模查市场,判断这个项目值不值得做 新增工作模式 **商业**(内部 `venture`)。它不是"再多读几个网页":**定题 → 需求与证据 → 竞争与获客 → 商业模型 → 尽调 → 结论** 六个阶段,每一阶段的前进都要上一阶段的制品真的在磁盘上,结论没有证据就写不出来。方法来自 `商业化思维` 与 `市场调研与产品可行性` 两套笔记里的四条主线:第一次为什么买、第二次为什么回来、被复制后为什么留下、每次交付赚多少。 **联网是模式的默认行为,不是每页问一次。** 和网络调研模式一样,进入这个模式就等于同意大规模读取公开页面,不再逐页弹批准;竞品定价页、应用商店/市场页、评论与社区帖、行业数字都算来源。**只读项目**:它不改你的代码,也跑不了命令,写出来的只有 `.eca/business/` 里的制品。 **闸门落在磁盘上**(`eca/venture.py`):`business_source` 登记来源(https、分类、可记发布日期);`business_claim` 只能引用已登记的来源,标 verified 必须挂来源;`business_doc` 只能写 `brief.md` / `competitors.md` / `unit.md` / `diligence.md` / `evidence.md`;`business_verdict` 在少一条来源、少一条带证据的断言、少 `unit.md` 或 `diligence.md`、或还有断言停在 `asserted` 时直接拒绝,并说明缺什么。 **结论是结构化的,不是一句"可行"。** `business_verdict` 只能从六档里选一个——值得验证 / 值得进入小范围开发 / 缩小方向 / 暂缓 / 不适合当前资源 / 停止该产品假设——并且必须填四个问题的答案、风险清单、一个最小验证实验(成本、截止、成败标准)和"什么会翻案"。写出来的是 `verdict.md`(人读)加 `verdict.json`(机读),同时记下来源数、断言数、置信度。 **界面**:模式菜单多一项「商业」;输入框上方一条六阶段条,右侧 `源 N · 断言 N/N核 · 反证 N · 结论 未出|值得验证…`,点文件图标展开 `.eca/business` 制品清单。阶段条只读——推进与回退都由模型通过工具完成,回退必须写原因。 **边界**:只做公开资料研究。访谈、投放、付费注册、公开发布、联系第三方都是单独的动作,需要另外授权;这个模式不会把它们写成"已经做过"。来源登记的是"这条记录存在",不等于它支持你的判断;置信度是模型对证据的判断,不是成功率预测。 验证:`tests/test_venture.py` 13 项(阶段闸门、来源三类、断言必须挂已登记来源、文档白名单、回退要原因、结论拒绝 asserted、四个问题/风险/翻案缺一不可、枚举封闭、`verdict.md` 内容、公共状态、提示词只给当前阶段);`desktop/tests/venture-mode-e2e.cjs` 用隐藏窗口 + 本地模拟模型跑通「模式可选 → 六阶段条 → 未写 brief 时 business_stage 被拒并点名 brief → 写入后阶段真的前进 → 制品清单出现 brief.md」5 次本地请求、0 付费 API。 ## 1.17.0 — 附件能读 PDF 和 Office,长回答不再被截断丢弃 **文档附件**(`eca/documents.py`)。以前只能贴图片、UTF-8 文本和代码:论文、需求文档、财报要么拖不进去,要么只能当图片发给模型——图片里的字既不能引用也不能事后核对。现在 PDF / Word / Excel / PowerPoint 在附件边界就被抽成**文本**,带页码 / 工作表 / 幻灯片标记进对话,可引用、可 diff、可搜索。PDF 走 `pypdf`(唯一的解析依赖,纯 Python);docx/xlsx/pptx 用标准库直接解 zip + XML,不引入三个重依赖。上限:单文档 8 MB、抽取文本 12 万字符(截断会写明"已截断"),扫描件没有文本层会明确提示"请改用图片并选择支持看图的模型"。文件名后缀和真实字节都要对得上:改名成 `.pdf` 的 docx 会被拒,损坏的 zip 会被点名。 **磁盘与权限错误说人话**(`eca/fsguard.py`)。以前往满盘的磁盘写文件,模型和用户看到的是 `[Errno 28] No space left on device: '...'`。现在按 errno 分类给出「磁盘空间不足 / 没有权限 / 所在磁盘是只读的 / 路径不存在 / 文件被占用」,带上路径和下一步动作,并明确"这不是模型或任务的问题"。覆盖四处最常撞墙的写入:工具写文件(`atomic_write`)、附件快照、科研制品、打开项目会话库(顺带修了一个真 bug:`.eca` 目录建失败时把项目锁一起漏掉了,下一次打开会误报"另一个 ECA 正在使用")。 验证:`tests/test_documents.py` 13 项(PDF 页码标记、扫描件提示、docx/xlsx/pptx 抽取、改名文件被拒、损坏 zip 被点名、超大拒绝、截断标记、附件边界只产生一个文本块而不产生图片块);`tests/test_fsguard.py` 7 项(ENOSPC/EACCES/EROFS/ENOENT 文案、`atomic_write`、附件写入、工具结果、打开项目)。新增 `desktop/tests/documents-e2e.cjs` 用隐藏窗口 + 本地模拟模型跑通「贴入 PDF → 请求里出现页文本 → 没有 image_url → 损坏 PDF 被拒」,2 次本地请求、0 次付费 API。 边界:PDF 只抽文本层,不 OCR;表格按行转成制表符分隔,合并单元格与公式只保留显示值;不支持旧版 `.doc`/`.xls`/`.ppt`;抽取结果进会话历史,原文不入库(附件目录里不会多出二进制快照)。 **长回答不再被截断丢弃**(`eca/errors.py`、`eca/provider.py`、`eca/anthropic.py`、`eca/responses.py`、`eca/agent.py`)。以前模型一次响应撞到输出上限(`finish_reason: length` / `stop_reason: max_tokens` / `incomplete: max_output_tokens`)时整段回答被丢掉,只留一句"拆小一点重来"——用户看到的是写了一半突然消失,长文、长代码、调研总结都中招。现在三个适配器都把已经流式输出的正文带上来,Agent 把它留作本轮回答、追加一条隐藏的运行提示让模型从断点接着写,续写结果**合并进同一个回答气泡**,会话历史里也是一条完整消息。截断发生在写工具调用参数中途时,那个调用不完整、不会执行,正文保留并提示"同一操作拆小重发"。`output_recovery_limit` 仍是连续续写次数(0 = 不限)。 工具日志 `output_limit` 默认从 24000 字符提到 48000,抓网页长文更容易一次读完。验证:`tests/test_output_continuation.py` 5 项;`desktop/tests/output-continuation-e2e.cjs` 用隐藏窗口 + 本地模拟模型跑通「第一次响应被 length 截断 → 下一次请求里出现续写提示 → 界面只有一个回答气泡且含两段文字 → 历史只有一条 assistant」,3 次本地请求、0 付费 API。 ## 1.16.0 — 科研模式:七阶段工作流,闸门在磁盘上 新增工作模式 **科研**(内部 `scholar`),把 cs-research-skills 那类「科研阶段之间怎么交接证据」做进产品,而不是搬 177 个工具说明书:**选题 → 检索 → 精读 → 复现 → 实验 → 写作 → 汇报**,每一步的产出落在 `.eca/research/` 里。 **为什么是模式不是技能**:技能最多同时挂 3 个(`tools.py` 里 `active_skills` 有上限),7 阶段会互相挤掉;而"现在在第几阶段、证据够不够下结论"必须跨轮次存在。模式带工具权限、状态机和界面,技能带某一段的详细打法。 **状态机**(`eca/research.py`):`research_stage` 前进要求前一阶段的制品真的在磁盘上(没 `proposal.md` 不许进检索,没来源不许进精读……),回退允许但必须写原因,每次移动镜像到 `.eca/research/stage.json`,阶段历史进会话状态。 **六条闸门**,全部读文件而不是听话术:`research_source` 用 Crossref / arXiv 公开元数据在线核验 DOI/arXiv id,失败就不许标 verified;`research_claim` 拒绝没有证据的 verified、拒绝引用未登记的 source、拒绝只靠"登记时没核验过"的 source 支撑 verified;`research_run` 在 `matches_paper=false` 时必须给 note;`research_report` 检查 `report.md` 里的每个 `[src:ID]` 都已登记、没有无证据的 verified、没有仍是 asserted 的 claim、有了不一致的 run 却没有 `deviations.md` 就直接拒绝生成结论;`research_doc` 是唯一能写 `.eca/research` 的工具(`.eca` 对 write/edit 是受保护路径),文件名走白名单,`reading/.md` 还要求该来源已登记。 **复现结论只有四档**:reproduced / partial / incomparable / uncertain。没有"证明了论文正确"。 **界面**:模式菜单多一项「科研」;输入框上方一条 7 步阶段条(当前高亮、已完成打勾、回退显示原因),右侧 `源 N/N核 · 断言 N/N核 · 运行 N`,点文件图标展开制品清单。阶段条只读——推进与回退都由模型通过工具完成,界面不替它打勾。 验证:`tests/test_research.py` 19 项(阶段闸门、回退留痕、无证据 verified 被拒、未登记引用被拒、偏差未记录被拒、写作工具白名单、阅读卡要求已登记来源、stage.json 镜像);`desktop/tests/scholar-mode-e2e.cjs` 用隐藏窗口 + 本地模拟模型跑通「模式可选 → 阶段条读真实状态 → 先被闸门拒绝 → 写入 proposal.md 后阶段真的前进 → 制品清单出现该文件」,5 次本地请求、0 次付费 API。既有桌面包单测与 `mode-goal-e2e.cjs` 同时通过。 边界:登记成功只证明"这条记录存在",不证明它支持你的论点;复现成功不等于结论成立;不判断伦理审批、数据授权与受试者合规;不自动批量执行论文附带的未知脚本。 ## 1.15.0 — 会话跑完有绿点,清单跑完会说实话 两件事都是"看起来像卡住"的不同版本。 **会话行三态**(`Sidebar.tsx`)。以前只有"运行中",跑完就变回和从没跑过一模一样的静态文字——多会话并行时,谁刚跑完完全看不出来。现在跨项目扫描所有会话,在 `busy:true → false` 那一刻标一个绿点(`aria-label="本轮已完成"`),点开该行即清除,重新运行时也清除;从没跑过的会话不标。结束状态取自后端 `status`:`error` / `interrupted` / `limit` 判为**红点**,不冒充完成。 **执行清单收尾**(`PlanChecklist.tsx`)。以前回合结束后,`in_progress` 的步骤还在画转圈,头部只有"阻塞/失败"两种计数,于是"6 步做完 1 步"看起来像还在跑。现在回合结束就不再画转圈(改空心圈 + `未完成` 徽标),头部补 `N 未完成`,未完成项置灰;底部写明"本轮已结束,还有 N 项没勾选"。**界面不会替模型打勾**——清单是模型写的,自动补勾等于伪造进度。 **根因一半在提示词**(`agent.py`)。只要会话里有清单,就在系统提示里要求:最终回答前用 todo 工具把清单更新到当前状态,真正做完的标 completed,停机时不留 `in_progress`,仍有 pending 的在回答里说明是哪项、为什么。plan 模式不注入这条(那里本就什么都没做)。 验证:新增 `desktop/tests/plan-leftover-e2e.cjs`——模型写 3 步(1 done / 1 in_progress / 1 pending)就停,断言 `1/3`、`2 未完成`、提示语出现、清单里 `ph-circle-dashed` 数量为 0;第二轮全部标完成后断言 `3/3`、徽标与提示消失。新增 `desktop/tests/session-done-dot.cjs`——断言未跑过的会话无标记、运行中显示"运行中"且无绿点、跑完绿点可见且计算色为 `rgb(38, 115, 75)`、点击后清除、模型返回 500 时为红点。均为隐藏窗口 + 本地模拟模型,0 次付费 API。既有 `mode-goal-e2e.cjs`、桌面 28 项单测、Python 定向 66 项(1 跳过)同时通过。 ## 1.14.1 — 侧边聊天并入右侧工作区 1.14.0 的侧聊是一块**浮层**,独立于右边的工作区面板,等于同一个东西在两个地方出现。这次改成复用工作区里已有的侧聊(`workspace/SideChat.tsx`):选文字 → **在侧边聊天中提问** → 右侧工作区直接切到「侧边聊天」标签,顶部是**任务上下文**(来自主对话的最近记录 + 你选中的那段,标注「只读」),下面才聊。浮层整个删掉,事件改由工具条直接派发 `eca:sidechat`,工作区接管;顺带把 1.14.0 里为浮层加的 `sidechat.*` 白名单条目撤回(`main/index.ts` 早有专门分支放行)。 同时修掉一个真 bug:侧聊的发送键**在附件草稿读完之前一直是禁用的**。`useAttachments()` 的 `busy = disabled || loading || reading`,而 `loading` 要等 IndexedDB 草稿读回来;主输入框在应用启动时就挂载,等不到这个窗口,侧聊却是刚打开就让人输入——所以按 Enter 没反应、按钮是灰的。现在 `busy` 里把 `loading` 与 `reading` 分开暴露,侧聊只挡真正在读文件(`reading`)的时候,草稿还没读回来不再挡发送。 验证:`desktop/tests/selection-toolbar-e2e.cjs` 重写为断言真实布局——`.workspace-panel` 打开、`.workspace-tabs` 里出现「侧边聊天」、`.side-chat` 显示「任务上下文」、提问后流式回答出现在面板里、且夹具模型收到的请求里带着选中的那段文字;dev 与打包版各跑一遍,0 次付费 API 调用。 边界:右栏仍然是标签式的(侧聊和预览/终端并列),不是独立第三栏;讨论记录跟着侧聊会话落库,主任务继续跑。 ## 1.14.0 — 选中一段话,直接引用它或就它提问 在对话里选中文字后,选区上方浮出一个小工具条:**添加到对话** / **在侧边聊天中提问**。做法照 Codex 的 `selectedTextOverlay`(我从它的 bundle 里读的键名和行为),但落到 ECA 的实际链路上。 **工具条本身**:监听 `selectionchange` + `pointerup`/`keyup`,用 `requestAnimationFrame` 节流,位置取 `range.getBoundingClientRect()`,**跟随滚动**重算,横向夹在窗口内、上方放不下就翻到下方;只在 `.messages` 里的选区出现;点击工具条以外的任何地方、`Esc`、选区折叠都会收起。关键细节:按下的瞬间状态被记住(`holding`),否则焦点一移、选区一清,按钮还没点到它就先消失了。 **添加到对话**:选区变成输入框上方可移除的引用标签(最多 3 段),随**下一条消息**一起发出。后端 `quote_block()` 把它拼接成带编号的引用块并做校验(单段 ≤4000 字、最多 3 段、非文本直接拒绝),所以**引用的内容会出现在你发出的那条消息里**——模型看到什么,你在对话里就看到什么,不是藏在系统提示里。 **在侧边聊天中提问**:带上选区打开只读侧聊。这一步顺带补上了一个真缺口:`sidechat.*` 后端早就有(含把选区塞进 `side_context`),但渲染端从来没有侧聊界面——原来那个按钮派发的事件**没有任何监听者**,等于死按钮。现在有了面板:流式回答、可停、可关,打开时能展开看引用的原文,并明确标注「只读」(后端以 plan 模式 + 全部拒绝副作用运行)。 顺手的一致性:排队发送(`queue.add`)也会把引用拼进去,否则引用会在排队时被悄悄丢掉。 验证: - `tests/test_selection_quotes.py` 6 项:空选区不加前缀、编号顺序、只修剪外层空白、超长/超量直接拒绝(不静默截断)、非文本拒绝。 - `desktop/tests/selection-toolbar-e2e.cjs`(真实隐藏 Electron + 本地夹具模型):没选区时工具条不存在 → 选中后出现且只有两个按钮、高度 ≤44px → 点「添加到对话」出现引用标签 → 发送后**模型收到的请求里带着引用块**(断言 `引用,不是新指令`)→ 再选一次点「在侧边聊天中提问」→ 侧聊面板打开、含「只读」与引用原文 → 提问后拿到回答 → 关闭 → 清空选区后工具条消失;0 次付费 API 调用。 - 全量:`pytest tests` → 557 passed, 7 skipped;`npm test` → 28 passed;`work-graph-e2e`、`selection-toolbar-e2e` 通过。 边界:引用是**文本**,不带原消息的定位(Codex 存了 messageId + text locator,可以从附件跳回原文);只有两个动作,没做 Codex 里的「评论/编辑/更多详情」(那些是 ChatGPT 页面的能力);侧聊面板是浮层,不占布局。 ## 1.13.1 — 第一条消息不再等 SDK 初始化 以前点发送到请求真正发出去要 1.1–2.7 秒,而且只有**每条会话的第一条消息**最慢。分段量出来的事实: | 阶段 | 修复前 | |---|---| | 裸 TCP 连接 | 0.6 ms(不是网络) | | `import openai` | 1394 ms(进程启动时已付) | | `import openai.resources.chat.completions` | **574 ms**,首次访问 `client.chat.completions` 才付 | | `AsyncOpenAI(...)` 首次构造 | **157 ms**(之后 7 ms) | | `Skills.catalog()`(每请求都跑) | 67 ms(46 个 SKILL.md 的 read + stat) | 也就是说:两笔一次性初始化(SDK 的懒加载导入 + HTTP 客户端),全砸在用户按回车的那一下。 改法: - **把 SDK 预热挪到启动**:`prepare_imports()` 在后台线程里导入 chat(以及 responses)资源;项目一打开就在事件循环上 `provider.warm()` 把 HTTP 客户端建好。**不发任何请求**,不消耗 token。 - **`Provider` 抽出 `_build_client()`**,`complete()` 复用它;`warm()` 已有客户端时直接返回。 - **技能目录按目录 mtime 缓存**:命中时只 stat 5 个目录(约 4 ms),新增/删除/改名技能立刻失效;`load()` 仍然读当前正文。改 SKILL.md 里的一行描述要重启才生效,这一点写在代码注释里。 结果(同一台机器,本地 fixture 模型,不花钱): | 指标 | 修复前 | 修复后 | |---|---|---| | 第一条消息:点击 → 服务端收到 | 2207–2852 ms | **189–229 ms** | | 后续消息 | 323–405 ms | **35 ms**(中位) | | 渲染端 + IPC(click → backend preparing) | 146 ms | 18–29 ms | | 后端准备(preparing → dispatch) | 111–161 ms | 15–21 ms | | `Skills.catalog()` / `system_prompt()` | 67 / 58 ms | **4.7 / 3.5 ms** | 新增回归测试,防止这两笔成本偷偷搬回来: - `desktop/tests/send-latency.cjs`:四段打点(click / preparing / waiting_model / 服务端首字节),断言**第一条消息 < 900 ms**、稳态 < 200 ms、且发送消息不会顺带去拉模型列表。 - `tests/test_provider_warmup.py` 7 项:`warm()` 建客户端但不连不发、已有客户端不重建、无 key 时跳过、`prepare()` 幂等且导入失败不影响请求、`complete()` 复用预热客户端。 - `tests/test_skills_catalog.py` 新增 3 项:第二次读取**零文件读**、新增技能让缓存失效、缓存后项目技能仍优先。 验证:`pytest tests` → 551 passed, 7 skipped;`npm test` → 28 passed;`automations-e2e` 与 `work-graph-e2e` 通过;`send-latency` 通过(首条 189 ms、稳态 35/18 ms)。 边界:首次真实请求仍比后续多约 150 ms(首个请求要现场构建一次请求体),已经不再影响手感;其余优化属于渲染端之外的领域。 ## 1.13.0 — 定时任务:到点自己开会话干活 照 Codex 的 Automations 做的,但落在 ECA 的会话模型上:每个计划是一份本机文件,到点在**它绑定的项目里新开一个真会话**执行,跑完的结论写进它自己的记忆文件。 **存储**(`~/.ecs/automations`,桌面端在应用数据目录下的 `automations/`): ``` /automation.toml 计划本身:name / prompt / status / rrule / permission / project / notification /state.json 下次运行、上次运行、上次结果 /memory.md 跨轮记忆(每轮自动追加) /runs.jsonl 运行流水 .run-jitter-salt 一个盐值,让同一计划的抖动可复现 ``` `automation.toml` 是可以手改的:改完下一轮调度就会读到,格式与 Codex 的 automations 一致(`rrule = "DTSTART;TZID=…\nRRULE:…"`、`status = ACTIVE/PAUSED`)。 **调度语义**(和 Codex 对齐,全部有测试): - 每 **30 秒**检查一次,每次最多启动 **3** 个,同一计划两次运行间隔 ≥ **60 秒**,同一计划永不并发 - `next_run_at = 名义时间 ± 抖动`,抖动对 `salt:id:名义时间` 取 SHA256(每日/每周 ±300 秒、每小时同分钟内多时间点 ±119 秒、一次性不抖动),`next_run_nominal_at` 保留名义时间用于显示 - **启动立即检查一次**:应用关着时错过的周期任务只补跑一次,然后跳到下一个未来的点——离线一周不会补跑一周;一次性任务过期后没有下次 - 崩溃留下的「运行中」记录在下次启动时改记为 `interrupted`,不会被算成成功 - 支持每天 / 每周(可多选星期)/ 每 N 小时 / 每 N 分钟 / 单次 **权限:无人值守不等人。** 每个计划显式声明权限,超出范围的操作直接拒绝并在活动里说明: - `read_only`:研究模式,能读文件、能联网,不能改文件、不能跑命令(默认) - `accept_edits`:可改文件,不能跑命令 - `allow_shell`:可改文件、可跑命令 **记忆由脚手架写,不由模型写。** ECA 的写文件工具被限制在项目内,无法让模型去写 `~/.ecs/.../memory.md`;所以每轮结束后由 harness 把模型自己的收尾结论(≤1500 字)追加到记忆文件,并在下一轮的提示词里带上最近 3000 字。提示词同时注入 `Automation ID`、本次运行时间、上次运行时间,并要求结尾写清「做了什么、发现了什么、下次注意什么」。 **界面**:左侧栏「定时任务」→ 计划列表(状态点、日程、下次运行、上次结果、运行中标记),新建/编辑表单(名称、频率、时间、星期、间隔、权限、通知,实时预览「计划:每周一、三 08:30」),行内「立即运行 / 暂停 / 编辑 / 删除」,点名字展开运行历史(时间、成功/失败/中断、打开会话、记忆文件)。 顺手修掉一个真实缺陷:`Store` 的项目占用锁原来是「一个项目只能有一个句柄」,而定时运行必须打开应用已打开的项目,于是必然报 `Another ECA process is using this project`。现在锁按进程内共享引用计数管理,普通 `Store(root)` 仍然拒绝第二个持有者(原有测试照旧通过),只有显式 `Store(root, shared=True)` 才加入本进程已有的持有者——定时运行走这条路。 验证:`tests/test_automations.py` 23 项(日程构建/解析、各频率的下一次时间、抖动边界与确定性、一次性无下次、文件往返与手改生效、暂停清空下次、校验报错、历史与记忆追加、tick 只跑一次并前移、错过只补一次、间隔内不重复、运行中拒绝重复、崩溃记中断、提示词内容、失败运行记为数据);真实隐藏 Electron 冒烟 `desktop/tests/automations-e2e.cjs`:建「每 1 分钟」计划 → 面板出现 → **真调度器到点触发** → 运行成功 → 会话出现在项目里 → 历史与 `memory.md` 落盘 → 手动运行记 `manual`,0 次付费 API 调用。 边界:只做 `cron` 类计划,没做 Codex 那种「续同一个会话」的 heartbeat;没有云端执行;通知字段已存储但界面只做标记,不弹系统通知。 ## 1.12.0 — 计划变成有依赖的工作图 `todo` 以前是一份平铺清单:模型可以随手把任何一条标成 `completed`,包括前置步骤还没做完、或者已经失败的那条。清单在这种情况下不提供信息,只提供安慰。 现在每步可以带 `id` 和 `depends_on`,提交时**先校验再落库**: - 唯一 id(1–32 字符,小写字母/数字/`.`/`_`/`-`,重复即拒) - 依赖必须指向同一份计划里存在的 id,不能依赖自己 - **不许成环**(报错会打印环本身:`a -> b -> a`) - 规模上限 50 步、每步最多 8 个依赖 落库后每步派生一个状态: - 依赖里只要有一条不是 `completed`,这步就是 **blocked**,并给出 `blocked_by` - 依赖里有一条 `failed`,额外给 `failed_by` - **blocked 的步骤不能标成 `completed`**:整份提交被拒,错误里点名是哪几个前置、它们当前的状态,并给出两条出路(先修好前置,或把它从 `depends_on` 里去掉) 新增 `failed` 状态:失败的前置不会自动放行下游,只会一直挡着——这正是「失败阻塞」要的效果。 界面上:被阻塞的步骤换成锁图标 + 「阻塞」标签,标题行显示「N 阻塞」,悬停能看到在等哪些 id;失败步骤划线 + 「失败」标签。模型的 system prompt 里也会写明「blocked 的步骤不要报成完成」。 兼容性:不带 `id` 的老计划完全照旧,`state['tasks']` 的消费者(恢复检查点、压缩摘要、桌面快照、CLI `/tasks`)都不需要改格式。 顺带修掉一个自己引入的成本问题:1.11.0 把整份技能清单塞进 system prompt,装了 30 个技能时提示词从 2.8k 涨到 7.8k 字符。现在按**字符预算**(1200)截断、描述截到 90 字,剩余的提示「还有 N 个用 skills() 列」,`tests/test_skills_catalog.py` 加了守门测试。`tests/test_web.py` 里那条断言「未配置就说 not configured」也改成打桩 keyless 搜索——它之前会真的联网。 验证:`tests/test_work_graph.py` 16 项(环、未知依赖、自依赖、重复 id、上限、blocked 完成被拒、失败依赖、前置完成后解阻、无 id 兼容、工具层拒绝后旧计划不被覆盖、prompt 标注);真实隐藏 Electron 冒烟 `desktop/tests/work-graph-e2e.cjs`:1 个阻塞项、锁图标、「1 阻塞」、`completed` 计数 0、模型强推完成时转写里出现 `cannot be completed`。 边界:这是计划语义,不是执行器——它不会自动帮你跑下一步,也不会因为失败自动重试;它只保证「计划里的顺序和失败不会被谎报成完成」。 ## 1.11.0 — 直接用上其他工具已经装好的技能 ECA 早就支持 `<名称>/SKILL.md`,但只认自己的 `~/.ecs/skills` 和项目 `.agents/skills`。这台机器上 Codex 有 27 个、Claude 有 17 个、WorkBuddy 有 2 个技能,格式完全一样,却用不上。 现在统一发现,按顺序合并(同名前一个赢): ``` 项目 .agents/skills → ~/.ecs/skills → ~/.codex/skills → ~/.claude/skills → ~/.workbuddy/skills ``` - 左侧栏「技能」可以只读浏览:按来源筛选,点开看 `SKILL.md` 前 4000 字。 - **输入 `/` 弹出技能面板**:`↑↓` 选择、`Enter`/`Tab` 插入、`Esc` 取消;选中变成输入框上方的技能标签,随本轮请求一起发出(不是插一段 `/名字` 文字)。最多三个。 - system prompt 的技能清单也包含这些技能,描述截到 90 字、整块限 1200 字符(1.12.0 补的预算);正文仍靠 `skills(name)` 按需加载。 - 仍然只是说明文字,不带来任何权限;读技能不会让写文件、跑命令或联网更容易。 实机:46 个含 `SKILL.md` 的目录去重后 **30 条**(16 个同名被优先级合并)。 验证:`tests/test_skills_catalog.py` 6 项(四个来源、同名优先级、无项目也能列、脏条目被拒、`load` 标来源、未知技能报错);真实 Electron 冒烟列出 30 条并渲染正文。顺带修掉 `test_runtime` 依赖开发机技能目录的问题。 边界:只认 `<名称>/SKILL.md`,Claude 那边 2 个只有 `README.md` 的目录不会出现;不做启用/禁用开关。 ## 1.10.0 — 在 ECA 里看其他工具的历史会话 侧栏底部新增「其他工具的历史」:只读列出本机 Codex、Claude、WorkBuddy 的会话,点开看完整对话。**不导入、不续跑、不写对方的目录**。 三家格式完全不同,各自解析: | 来源 | 索引 | 正文 | |---|---|---| | Codex | `~/.codex/sessions/年/月/日/rollout-*.jsonl` | 同文件,取 `response_item` 里的 `payload.role` 与 `content` | | Claude | `~/.claude/projects/<路径编码>/.jsonl` | 同文件,取 `type: user/assistant` 的 `message.content` | | WorkBuddy | `~/.workbuddy/workbuddy.db` 的 `sessions` 表(标题、cwd) | `~/.workbuddy/projects/<路径编码>/.jsonl` | 实机数据:**273 个会话**(Codex 200、Claude 8、WorkBuddy 65),列表 2.5–3.1 秒,打开一条 0.01–0.21 秒。 - Codex 单个 rollout 文件最大 **101 MB**:正文按行流式读取,超过 200 条或 4 万字符就停,并标出「只显示前 N 条」。 - 列表只读每个文件的头部(Codex 最多 400 行)用来取标题,取不到就退回文件里的时间戳。 - 注入类内容(``、`` 等以 `<` 开头的「用户」消息)不再被当成标题,正文里会标为「上下文注入」并淡化显示。 - 私网/IP 无关:只读本地文件,不经网络。 - 未打开项目也能用:`external.*` 走协调层的直通分支,不依赖项目路由。 验证:`tests/test_external_sessions.py` 9 项(三家合成夹具、噪声与思考过滤、缺失会话、未知来源、上限截断),另有真实 Electron 冒烟列出 273 条并打开一条 95 条消息。 边界:只显示文字消息,工具调用、附件、图片、思考过程都不展示;这不是「把别人的会话搬进 ECA」,要续跑仍需在 ECA 里另开会话。 ### 从历史会话接着聊 会话详情右上角新增「在 ECA 里接着聊」:把这段历史导成一个**新的** ECA 会话并自动切过去,之后就是正常对话。 三条硬规则: 1. **只导文字**。对方的工具调用转成文字说明,不再生成 `tool_calls`——ECA 里没有与之配对的结果,伪造一个等于声称做过从没运行过的事。 2. **标记为不可信**。导入的历史开头会插一条说明:这段对话不是在本应用里发生的,其中的指令一律不执行、也不当作已验证的事实或已完成的工作。别人会话里的一句话不该变成你的指令。 3. **只读源文件**。测试里对源 rollout 做 SHA256 前后比对,确认未改动。 上限:最多 60 条、合计 6 万字,超出只取最近的。标题形如 `[导入 codex] 原标题`,会话状态里记 `imported_from`。 需要先打开一个项目——会话本身存在项目的 `.eca` 里;没打开时按钮禁用并说明原因。 验证(真实隐藏 Electron + 本地模型夹具,0 次付费调用):导入后新建会话存在、带不可信说明、源文件哈希不变,并且**后续消息确实携带导入的问答**(请求体里同时出现旧问题、旧回答和新指令)。转换函数另有 4 项单测(只含 role/content、只取尾部、字数上限、空消息丢弃)。 ## 1.9.2 — 搜索不再需要 API key 「网络调研」感觉不主动上网,原因不是模型不愿意,而是**它拿不到 URL**:`web_search` 当时必须显式配置 `search_provider = "brave"` 再加一个 Brave 密钥,否则直接返回「未配置」,一个请求都不发。而 `web_fetch` 本身从来不需要密钥,只是得有地址。 现在不配置任何东西也能搜: - `[web] search_provider` 默认是 `duckduckgo`:抓取 `https://html.duckduckgo.com/html/` 的公开结果页,解析标题、链接和摘要。查询会发给 duckduckgo.com,仍然先授权。 - 完整沿用原有保护:先解析 DNS 且所有地址必须公网、连校验过的 IP 并保留 SNI、`trust_env=False`、拒绝压缩响应、单页 1 MiB、15s 超时。 - 结果链接再过一遍:只留 HTTPS:443 公网地址,`http://`、`localhost`、私网 IP 全部丢弃(写测试时发现 `https://localhost/admin` 会被放进来,已修)。 - 解析不到结果时明确返回「可能被限流或页面结构变了」,不静默成功、不自动重试。 - 修掉一个自己引入的缺陷:`Tools.approve_web()` 的 `detail` 原本是必填参数,免密钥搜索只传了消息,于是工具在深处抛 `TypeError` 并显示为「Tool failed」。现在 `detail` 可省略,搜索会把查询作为 detail 交给审批层。 - 想用回 Brave:`search_provider = "brave"` 加 `search_api_key_env`,行为与之前一致;未知 provider 会列出可选值。 验证: - 本机真实请求 `html.duckduckgo.com`,解析出三条带标题、解码链接、摘要的结果,**未使用任何 API key**。 - `tests/test_web_search.py` 8 项离线测试:跳转链接解码、非 HTTPS 与 localhost 过滤、条数上限、空页面、provider 分派、拒绝时不发请求。 边界:这是非官方接口,依赖对方页面结构,可能被限流或改版。失败会给可读提示,但不会假装搜到了。 ## 1.9.1 — 调研模式默认先确认「这是什么」 网络调研模式原本要求「先搜索、再读多个来源」,但没有说清第一步该搜什么。遇到一个不熟悉的名字时,模型容易直接按记忆下结论,或者跳过检索去读别的。现在把第一步固定下来: - system prompt 里改成编号流程,第 1 步就是「一次检索确认这是什么」:准确名称、谁维护、是否仍然存在和更新。明确写了「不要凭记忆回答,也不要先用别的工具」。 - 每轮第一次模型调用时再注入一条运行时提醒(不落库、不进历史),措辞更直接;只在 `research` 模式的第一轮出现,不会在后面每轮反复催。 - 例外只保留一个:请求里点名了本项目内的路径或文件时,先读那个文件。 - 已经在本次对话里确立过的对象不再重复检索——这也是写进提示词的,避免追问时反复「这是什么」。 验证:`tests/test_research_mode.py` 新增两项,直接跑一轮对话并检查第一次发给模型的消息里确实带这条指令,同时确认 `code` 模式没有;提示词顺序也做了断言(确认「先检索」排在「多来源」之前)。 ## 1.9.0 — 长命令边跑边看,加一个联网调研模式 两件事:让「命令跑了很久」不再是黑箱,以及补上一个以读网页为主的第五种模式。 ### 长命令的实时输出 上一版修的是模型输出的卡顿,这次修工具输出。之前 `drain()` 一直读到 EOF 才返回,所以一条跑两分钟的命令,界面上两分钟都是空白,只有计时器在动——「真慢」和「卡死」长得一模一样。 - `run_process` 现在每 ≤500ms 回传最近约 1200 字符的尾部输出(最多 2 次/秒),用增量 UTF-8 解码,中文不会被切碎。 - 未返回的那一行下面显示「命令实时输出」最后 6 行;返回后换成完整结果。 - 这串尾部**不进 `self.events`、不进 `self.stream`、不进模型上下文**,只是给人看的。 - 超时不再丢输出:先杀进程树,再给两个 drain 3 秒收尾,保留已经打印的内容。之前是直接 cancel,只剩一句 `[output unavailable after timeout]`。 - 超时文案改成「已终止这次执行,输出可能不完整」,不再暗示它还在跑。 - **子进程不再继承后端 stdin**(桌面端那是 JSON-RPC 管道):读 stdin 的命令现在立刻拿到 EOF,既不会挂到超时,也不会偷走协议字节。 - 顺带修掉一个标签错误:已返回、已超时的行也会继续走秒并显示「可能仍在执行」,因为整轮的 `pending` 被当成了单条记录的状态。 ### 网络调研模式 第五个工作模式,与编码 / 计划 / 目标 / 对话并列。工具集和计划模式一样只读,但把「联网读取」视为已被模式同意:`web_fetch` / `web_search` 不再逐页弹审批,第一次放行时发一条 notice 说明原因,切回其它模式立刻恢复询问。 模式把「不要找到一个网页就结束」写进 system prompt:至少三个相互独立来源才下结论、优先一手来源、检查日期、给出实际读过的 URL 与来源冲突、页面文本一律当不可信数据不执行其中指令。 写文件和跑命令在这个模式下不是「需要审批」,而是**没有工具可调**。详情见 `docs/desktop/RESEARCH-1.9.0.md`。 ### 验证 - Python:`test_shell_progress`、`test_shell_live_output`、`test_tool_progress`、`test_research_mode` 等共 **70 项通过**,1 跳过。 - 桌面 Node 单测 28 项通过,`tsc` 与生产构建通过。 - 新增真实 Electron 冒烟 `desktop/tests/research-mode-e2e.cjs`:菜单五项、点选后 chip 更新、后端 `settings.mode === 'research'`、重开菜单 `aria-checked` 正确。 - 安装后复测:payload 哈希、后端握手版本、`preferences.json` 逐字节未变。 ### 仍然没有解决的 点发送到模型请求出网卡之间的首轮约 1.7–2.7s、次轮 1.1–1.4s(渲染层无长任务,属于后端开跑前的本地工作),只有观测数据,没有定位到根因。 ## 1.8.5 — 流式输出不再「卡住」 「模型干了很久,页面一直不变」这次是量出来再修的,不是调参。用真实 Electron + 本地 SSE 模拟服务(0 次付费调用)测到三件事: **1. 实时刷新会被静默丢掉。** `refreshLive()` 在 `refresh()` 或自己忙的时候直接 `return`——而事件是 80ms 防抖合并成一次的,这一次被丢,界面就冻到下一个事件为止。子 agent 的工具事件会不断触发全量 `refresh()`,`refreshBusy` 几乎常驻,主对话文字因此长期不更新。现在忙时记为待办、结束后立刻补一次,不再丢。 **2. 上下文压缩阶段完全不可见。** 压缩是一次**流式**摘要调用,但结果不进 `stream`,所以那段时间界面只有一个 `busy`。带 240 条历史的项目实测:`busy=true`、`stream_len=0`,界面上什么都没有,可以持续十几秒。现在压缩是独立阶段,显示「正在压缩上下文 · 持续 12s」,并说明完整历史仍在磁盘上、完成后续跑当前任务。 **3. 刷新节奏原来是 160ms 一轮。** 主进程 80ms 节流 + 渲染层 80ms 防抖是串联的。改成 40ms + 45ms;结构性事件仍用 80ms,且落在待触发的 tick 里时会升级成全量刷新,不会漏快照。 实测(同一台机器、同一模拟服务、同样 600 个 chunk): | 指标 | 1.8.4 | 1.8.5 | |---|---|---| | 可见刷新次数 | 76 | 154 | | 刷新间隔 p50 | 94ms | 47ms | | p95 | 198ms | 95ms | | 最大停顿 | 200ms | 96ms | 新增 `desktop/tests/stream-freshness.cjs`:真实隐藏 Electron,断言首字可见、刷新次数 ≥20、最大停顿 ≤500ms。 **还没解决的**:点发送到模型请求真正出网卡之间首轮约 2.7s、第二轮约 1.1s(渲染层无长任务,属于后端开跑前的本地工作)。这块只有观测数据,没有定位到根因。 ## 1.8.4 — 后端进程也有自己的名字和图标 任务管理器里除了「ECA Desktop」,还有一个没有任何描述、图标是 PyInstaller 默认样的 `eca-backend`——看起来像是系统里某个来路不明的进程,其实是我们的本地运行时。 - `build-runtime.py` 现在给后端 exe 传 `--icon`(就是产品自己的 `icon.ico`)和 `--version-file`:ProductName `ECA Desktop`、FileDescription `ECA Desktop backend runtime`、CompanyName `ECA contributors`、FileVersion/ProductVersion 跟着 `eca/__init__.py` 走、OriginalFilename 指向新名字。 - 产物从 `eca-backend.exe` 改名成 **`ECA Desktop Backend.exe`**:Windows 的任务管理器显示的就是文件名,所以现在那一行是「ECA Desktop Backend」。 - 主进程按新名字启动,同时保留旧文件名作为回退,避免升级到一半(旧 exe 还在目录里)时后端起不来。 - 验证:重新构建运行时后读元数据,ProductName/FileDescription/公司/版本全部正确;提取 exe 图标与旧版对比,哈希不同(旧版是 PyInstaller 默认图标 `4d2da047…`,新版 `58fdb059…`);装完后再查一次实际进程名与元数据。 ## 1.8.3 — 「已中断」不再像报错 「读取 xxx」下面突然出现一行红字 `Interrupted: outcome unknown. Inspect current files/processes before retrying.`,看起来像读取失败了。它其实不是错误:这一轮被中断时,工具调用已经发出但没拿到结果,后端必须给模型一条"结果未知"的回答,否则协议里的调用和结果对不上。 什么时候会出现:点停止、任务跑着时切换/关闭项目、发「立即发送」打断当前任务、或者在任务运行中直接关掉应用。每次中断,凡是没回结果的调用各留一条,所以一次能冒出好几条。 - 现在按工具类型分开说:`read`、`glob`、`grep`、`code_search`、`web_fetch` 这类只读工具,写的是「只读操作没有改变任何东西,可以直接重试」;`write`、`edit`、`shell` 这类会改文件或跑命令的,才保留原来那句"结果未知,重试前先核对当前文件和进程状态"。 - 界面不再把给模型看的英文原句直接甩出来:改成中文一句话,并把颜色从危险红降为次要灰;只有真正的失败还是红的。停下状态本身仍是「已中断」+ 减号图标,不伪装成成功。 - 验证:`tests/test_recovery.py` 新增一项(同一个中断里 read 与 write 拿到不同的说明,状态仍为 interrupted),`desktop/tests/transcript.test.cjs` 新增一项(只读中断给中文提示且不出现英文原句、写操作提示核对状态、非中断的 Stopped 保持原文)。桌面单测 28 项、Python 定向 125 项通过。 ## 1.8.2 — 点「修改重发」直接回输入框,去掉中间确认 1.8.1 点「修改重发」会先弹一个窗,再点一次「放回输入框」。那一步是多余的:想改就直接改。 - 点「修改重发」→ 这一轮的原文立刻回到主输入框并聚焦,没有弹窗、没有二次确认。 - 其余行为不变:输入框上方仍有「发送时会先撤回上一轮」的提示,右侧可点「只是发一条新消息」取消撤回;带附件、任务进行中、已排队时按普通新消息发送。 - 验证:端到端删掉弹窗相关断言,改为「点修改重发 → 断言没有 dialog、输入框已是原文、提示条在 → 改成新文本 → 发送 → 断言旧指令消失、新指令进入会话、提示条消失」,13 次请求、无页面报错。 ## 1.8.1 — 改完先回到输入框,发送时才撤回 1.8.0 的「修改重发」点保存就立刻发出去,等于不给你在发之前再看一眼的机会。改成两段: - 弹窗主按钮现在是**「放回输入框」**:改完的文字回到主输入框并自动聚焦,弹窗关闭,什么都不会被撤回,你可以继续改、加附件、或者干脆不发。 - 真正的撤回发生在**你按发送时**:这时走 `session.resend`,先删掉那一轮的指令和回答再跑新内容。输入框上方会出现一条提示「发送时会先撤回上一轮」,右边有「只是发一条新消息」可以取消撤回。 - 状态只属于当前会话:切换会话时未发送的撤回标记会被清掉,不会在另一个会话里误删消息。 - 带附件、任务进行中、已排队这三种情况下不撤回,按普通新消息发送。 - 验证:端到端改成「点修改重发 → 弹窗预填 → 改成新文本 → 点放回输入框 → 断言输入框内容与提示条 → 点发送 → 断言旧指令消失、新指令进入会话、提示条消失」,13 次请求、无页面报错;Python 定向 125 项、桌面单测 27 项继续通过。 ## 1.8.0 — 最近一轮指令可以改完重发 发错一句话,之前只能整段重新输入,或者用「重新生成」把同一句话再跑一遍。现在最新那条指令上有「修改重发」:改文字,保存,这一轮先被撤回再按新内容重跑。 - 撤回是真的撤回:`session.resend` 把这条指令和它之后的回答一起从会话里删掉(`rewind`),再按编辑后的文本起新的一轮。不留 orphans,也不会出现「回答还在回答旧问题」。 - 只认人写的指令:「修改重发」和「重新生成」共用一段选取逻辑,会跳过运行时自己塞的 `[Runtime guidance]`、验证命令和修复指令。顺手修掉一个老问题——重新生成过去可能挑中目标模式塞进去的续跑提示。 - 带附件的指令不参与:附件没法从会话里重放,按钮直接置灰并说明「请在输入框里重新发送」,后端也会再拦一次,拒绝时不改动任何消息。 - 交互:悬停在最新指令上出现「修改重发」,弹窗预填原文、Ctrl/Enter 直接发送、任务进行中按钮禁用;空文本和超长文本(>20000 字)都有明确提示。 - 验证:`tests/test_desktop_rpc.py` 新增 3 项(撤回后按编辑文本重跑、只认人写的指令、空文本与附件被拒且消息不变),该文件 34 项全过;端到端在真实窗口里点按钮、改文本、保存,断言旧指令已从会话消失、新指令已进入下一轮(`requests` 13 次、无页面报错)。 ## 1.7.0 — 用 GitHub 账号登录,不再只靠粘贴令牌 1.5.0 的 GitHub 只有一栏「访问令牌」,等于把创建令牌的活儿推给了用户。现在它先是登录:点一下,浏览器里确认,回来就是登录状态。 - 走 GitHub 的 **OAuth 设备码流程**(没有自己的服务器时官方推荐的方式):应用给出 8 位验证码并打开 `github.com/login/device`,用户在浏览器同意,应用按 GitHub 给的间隔轮询换取 access token。账号密码不经过 ECA。 - 轮询遵守 GitHub 的节奏:`authorization_pending` 继续等,`slow_down` 按新间隔放慢,过期、拒绝、未启用 Device Flow 各有明确中文提示,不会无限转圈。验证码可点击复制,界面上有剩余时间。 - 需要 OAuth App 的 Client ID(不是密钥,可随产品分发)。来源优先级:构造参数(构建期注入)→ 设置里填的 → `ECA_GITHUB_CLIENT_ID` 环境变量。没配置时界面明说「暂时不可用」,并给出一行说明怎么建,不会摆一个按不动的按钮。 - 附带一条零配置路径:本机装了 `gh` 并 `gh auth login` 过,就直接点「使用本机 gh 登录」,复用它的令牌。 - 令牌仍然只存在主进程:`safeStorage` 加密后写进 `github.json`,界面只看到账号名;Client ID 是公开值,明文保存,断开登录也不会丢。 - 验证:`desktop/tests/github.test.cjs` 新增 5 项(设备码全流程、没 Client ID 不发请求、slow_down/过期/拒绝/未启用、Client ID 增删改、gh 令牌登录),12 项全过;桌面单测 27 项通过。 ## 1.6.2 — 标题栏去掉杂项 顶部那条 34px 的窗口标题栏,原来放了一颗 9px 的圆角色块加一行浅灰小字,看起来像屏幕上沾了个点。中途试过把它做成 17px 的陶土小瓦片加双色 wordmark,实际效果更像一颗「停止按钮」,更难看,已经撤掉。 - 结论是这块地方本来就不该有品牌:侧边栏顶部的品牌区已经有 logo 和 `ECA Desktop`,标题栏再写一遍就是第二个抬头。现在标题栏只剩拖拽区和三个窗口按钮。 - 高度 34 → 32px,底色从 `--surface` 换成更深一档的 `--canvas`,和下面的内容区分开,但不再抢视线。 - 窗口按钮 32×24 → 31×22,图标色用 muted,悬停才转正文色,关闭按钮保留红色悬停并补了按下态。 - 验证:`tsc --noEmit` 通过,桌面单测 22 项通过,Playwright 在打包后的 exe 里实测标题栏高 31.99px、按钮 31×22、左侧没有品牌节点、横向无溢出、无页面报错。 ## 1.6.1 — 修 Token 活动报错,热力图对齐参考样式 1.6.0 的个人信息页里,「Token 活动」直接显示 `Error: 不支持的桌面操作。` - 根因:`usage.stats` 没进主进程的白名单。我在清理重复的 `allowed` 声明时,删掉的恰是带 `usage.stats` 的那一份,剩下旧版本,所有该方法的调用都撞到兜底错误。 - 没有打开项目时,卡片不再把后端原文吐给用户,改为「打开一个项目后,这里会显示这个项目的用量统计。」 - 热力图按参考样式调整:月份标签移到网格下方、悬停文案改成「8月12日 · 11.7 亿 Token」、新增**每天 / 每周**切换(每周是整列求和)。周列现在从周一开始,不会出现半截列。 - 验证:端到端新增三条断言——个人信息页不含「不支持的桌面操作」与「Error:」,以及跑完一轮后 `usage.stats` 返回 `requests >= 1`;桌面单测 22 项、Python 定向 63 项继续通过。 ## 1.6.0 — 个人信息页变成真正的个人主页 1.4.0 的个人信息只是一张表单。现在它先是一个主页:大头像、称呼、账号,然后一排真实统计、Token 活动热力图、洞察,最后才是可编辑的字段。 - 头像用圆形大字号,取称呼首字;下方是称呼和账号(接了 GitHub 就显示 `@login`,否则写「本地账号」)。 - 统计五格:累计 Token、活跃天数、当前连续、最长连续、请求数——全部来自当前项目的本地用量账本,未回报 token 的请求不计入,也没有伪造的"估算"。 - Token 活动:近 26 周、按周列 × 星期行的网格,颜色按当日 token 分五档,悬停显示日期与数量。 - 洞察:平均每次请求 token、最常用模型及次数、单日峰值。 - 数据来源:`eca/usage.py` 新增 `statistics()`,读 `usage_requests` 表(`created` 时间戳 + `tokens`),RPC 新增 `usage.stats`。统计范围是**当前项目**,不是所有项目汇总——这点在页面上写明了。 - 验证:`tests/test_usage_stats.py` 5 项(空账本、总量/峰值/模型排序、连续天数只算相邻、未回报 token 跳过、pending 不计数);端到端断言头像区存在、统计格恰为 5 个且含「累计 Token」。 - 未验证:真实多日数据下的热力图观感(测试数据是单日),macOS/Linux。 ## 1.5.1 — 修设置左栏被撑开与重复标题 1.5.0 的左栏五个分区之间被撑到约 100px 一格,下面还重复出现一次「模型连接」标题,看着很散。 - 根因:连接列表用的是 `.connection-sidebar nav button {min-height:76px}`,而分区导航也是 `.connection-sidebar` 里的 `