|
1 | | -# StackFerry v0.1.17 |
| 1 | +# StackFerry v0.1.18 |
| 2 | + |
| 3 | +> 自 v0.1.17 发布以来的更新。 |
2 | 4 |
|
3 | 5 | ## 简体中文 |
4 | 6 |
|
5 | | -### MCP 与发布稳定性 |
| 7 | +### Pi 扩展管理 |
| 8 | + |
| 9 | +- 新增完整的 Pi 扩展工作台,可查看扩展、Packages、运行时状态、来源、版本、启用状态和异常信息。 |
| 10 | +- 支持安装和移除 npm、Git 与本地 Pi Packages,注册和取消注册本地扩展,并可直接启用或禁用单个扩展。 |
| 11 | +- 新增 npm Package 发现页,支持搜索、查看 Manifest、识别已安装状态并选择安装目标。 |
| 12 | +- Pi MCP Adapter 改为由用户明确安装;安装完成后,StackFerry 可通过该 Adapter 管理 Pi MCP。 |
| 13 | +- 新增 Adapter 缺失、安装中、可用、失效和部分成功等状态,并提供恢复与重试操作。 |
| 14 | +- 安装前静态检测扩展注册的 Tool、Command 和 Flag;发现名称冲突时阻止危险启用或自动禁用冲突扩展,避免 Pi 启动失败。 |
| 15 | +- 扩展详情改为独立全屏页面,集中展示路径、Package、资源、冲突和可执行操作。 |
| 16 | + |
| 17 | +### Pi 全局与项目作用域 |
| 18 | + |
| 19 | +- Pi 扩展、Packages 和本地资源现在同时支持全局作用域与项目作用域。 |
| 20 | +- 新增项目目录选择、最近项目持久化、项目信任确认、作用域筛选和目标明确的安装操作。 |
| 21 | +- 未信任项目不会读取或修改项目 `.pi` 内容;所有项目写操作都会重新校验规范化路径和信任状态。 |
| 22 | +- 对齐 Pi 的 Package 去重、项目覆盖、`autoload: false` delta、Manifest Pattern、Package Filter 和资源优先级规则。 |
| 23 | +- 补齐 extensions、skills、prompts、themes 的递归发现、glob、ignore 文件和目录入口规则。 |
| 24 | +- 改进 Windows、macOS 与 Linux 的 Pi CLI 和路径兼容性,包括 Windows `.cmd` 调用、Unix 可执行文件以及 macOS Homebrew 常见路径。 |
| 25 | + |
| 26 | +### MCP 管理与导入 |
6 | 27 |
|
7 | | -- 修复 Pi MCP 投影失败后数据库启用状态未恢复的问题。 |
8 | | -- 发布工作流现在要求完整 CI 全部成功后才开始构建和发布。 |
| 28 | +- “导入已有”扩展到 Claude、Codex、Gemini、GrokBuild、OpenCode、Hermes、Pi 和 Cursor。 |
| 29 | +- 新增 Cursor MCP 配置读取与导入。 |
| 30 | +- 改进 Codex 远程 MCP、OpenCode V2 配置结构、环境变量和不同 Agent 配置格式的兼容性。 |
| 31 | +- 相同 MCP 已存在时合并应用启用状态,不覆盖已有定义;导入数量只统计真正新增的服务器。 |
| 32 | +- Pi MCP 导入会检测与 StackFerry 中同 ID 服务器的配置冲突,避免静默覆盖。 |
| 33 | +- MCP 管理页改为统一工作台,优化长路径截断、应用状态、批量操作、导入反馈和窄屏布局。 |
9 | 34 |
|
10 | | -### MCP 与 Skills 管理 |
| 35 | +### Provider 导入与路由 |
11 | 36 |
|
12 | | -- MCP 和 Skills 列表新增本地搜索。 |
13 | | -- 支持按应用批量启用和禁用 MCP、Skills,并正确处理部分启用状态。 |
| 37 | +- Provider Routing 支持从 CC Switch 扫描并导入多个 Agent 的 Provider。 |
| 38 | +- 新增导入预览、按 Agent 或 Provider 选择、来源与端点展示、冲突提示和重新扫描;预览不会显示密钥。 |
| 39 | +- Agent 选择器移至侧边栏并优化尺寸,使路由页面在常规和窄屏窗口中保持稳定。 |
| 40 | +- 修复 Codex 故障转移到 DeepSeek 等第三方 Provider 时,Codex 模型目录覆盖真实上游模型的问题。 |
| 41 | +- 故障转移现在保留 Provider 配置的上游模型,同时继续支持第三方 Provider 自身的多模型目录选择。 |
14 | 42 |
|
15 | | -### Codex 会话用量 |
| 43 | +### 管理页面重新设计 |
16 | 44 |
|
17 | | -- Codex 会话日志按最多 1000 条分批写入 SQLite,复用 prepared statement,提升大量会话导入速度。 |
18 | | -- 批量导入失败时回滚当前批次,文件 cursor 只在全部批次成功后推进,重试不会产生重复记录。 |
19 | | -- Codex 会话请求详情现在正确显示 `responses` API 协议。 |
| 45 | +- 重新设计 MCP、Pi 扩展、Skills、Prompts、Sessions 和 Provider 导入工作区,统一工具栏、列表、筛选、空状态和详情导航。 |
| 46 | +- Skills 恢复仓库管理入口,发现页使用更易浏览的大卡片,Skill 详情改为独立全屏页面。 |
| 47 | +- Prompt 新建和编辑改为独立页面,移除重复入口,并修复保存或取消后页面未关闭的问题。 |
| 48 | +- Session Manager 重构列表、消息目录和阅读区域,修复滚轮不可用、窄屏头部异常以及调整窗口时布局跳动。 |
| 49 | +- 统一响应式布局规则,修复中窄屏下按钮、计数、徽标、路径和工具栏溢出。 |
20 | 50 |
|
21 | | -### 稳定性与兼容性 |
| 51 | +### 思考强度与请求日志 |
22 | 52 |
|
23 | | -- OAuth 配置写入改用 Windows 原子写入,降低配置文件损坏和并发覆盖风险。 |
24 | | -- 数据库备份和恢复改用批处理与事务,提升 Windows 环境下的处理效率和一致性。 |
25 | | -- Codex Responses 工具调用和会话 token 统计兼容性得到增强。 |
26 | | -- 修复应用集成测试在高负载下因默认超时过短导致的级联失败。 |
| 53 | +- 新增跨协议思考强度识别与记录,兼容 `reasoning.effort`、thinking budget 及不同 Agent 的对应字段。 |
| 54 | +- 请求日志和详情页现在显示思考强度及其来源。 |
| 55 | +- 修正请求用时和首字时间的采集与显示,统一毫秒和秒的格式。 |
| 56 | +- 无法从会话文件获得网络时序时显示为不可用,不再将未知值误显示为 `0`。 |
| 57 | +- 优化请求日志表格、详情面板和用量概览的响应式布局与长内容展示。 |
27 | 58 |
|
28 | | -### CI 稳定性 |
| 59 | +### 稳定性与测试 |
29 | 60 |
|
30 | | -- 修复 Codex 会话用量批处理代码触发严格 Clippy 检查失败的问题。 |
31 | | -- 测试专用的单条插入 helper 不再进入生产构建,避免无用代码警告。 |
| 61 | +- 增加 Pi 扩展安装、Adapter 恢复、冲突处理、项目信任、双作用域和跨平台路径的回归测试。 |
| 62 | +- 增加 MCP/Provider 跨 Agent 导入、响应式管理工作台、Prompt/Skill 导航、Session 滚动和请求时序测试。 |
| 63 | +- 修复 Unix 平台 Pi 路径测试、Windows CLI 参数引用和严格 Clippy 检查问题。 |
| 64 | +- 恢复 Windows、macOS 与 Linux 后端 CI 检查的一致通过。 |
32 | 65 |
|
33 | 66 | ## English |
34 | 67 |
|
35 | | -### MCP and Release Stability |
| 68 | +> Changes since the v0.1.17 release. |
| 69 | +
|
| 70 | +### Pi Extension Management |
| 71 | + |
| 72 | +- Added a complete Pi extension workspace for extensions, packages, runtime health, sources, versions, enabled states, and diagnostics. |
| 73 | +- Added installation and removal for npm, Git, and local Pi packages, local extension registration, and per-extension enable controls. |
| 74 | +- Added npm package discovery with search, manifest inspection, installed-state detection, and install-target selection. |
| 75 | +- Made the Pi MCP Adapter an explicit user installation. Once installed, StackFerry can manage Pi MCP through the adapter. |
| 76 | +- Added missing, installing, ready, invalid, and partial-success adapter states with recovery and retry actions. |
| 77 | +- Added static detection for registered tools, commands, and flags. Conflicting extensions are blocked or disabled before they can prevent Pi from starting. |
| 78 | +- Moved extension details into a dedicated full-page view for paths, packages, resources, conflicts, and actions. |
| 79 | + |
| 80 | +### Global and Project Pi Scopes |
| 81 | + |
| 82 | +- Added global and project scopes for Pi extensions, packages, and local resources. |
| 83 | +- Added project selection, recent-project persistence, trust confirmation, scope filters, and target-aware installation. |
| 84 | +- Untrusted projects are never read from or written to, and project mutations revalidate canonical paths and trust. |
| 85 | +- Aligned package deduplication, project overrides, `autoload: false` deltas, manifest patterns, package filters, and resource precedence with Pi behavior. |
| 86 | +- Added recursive discovery, glob expansion, ignore-file handling, and directory entry rules for extensions, skills, prompts, and themes. |
| 87 | +- Improved Pi CLI and path compatibility across Windows, macOS, and Linux, including Windows `.cmd`, Unix executables, and common Homebrew locations. |
| 88 | + |
| 89 | +### MCP Management and Import |
36 | 90 |
|
37 | | -- Fixed the database enabled state not being restored after a failed Pi MCP projection. |
38 | | -- Release builds now start only after the complete CI workflow succeeds. |
| 91 | +- Expanded “Import Existing” to Claude, Codex, Gemini, GrokBuild, OpenCode, Hermes, Pi, and Cursor. |
| 92 | +- Added Cursor MCP configuration discovery and import. |
| 93 | +- Improved compatibility with Codex remote MCP servers, OpenCode V2 configuration, environment variables, and agent-specific formats. |
| 94 | +- Existing MCP definitions now retain their configuration while gaining the imported app assignment; import counts include only newly inserted servers. |
| 95 | +- Pi imports detect configuration conflicts with StackFerry servers that use the same ID instead of silently overwriting them. |
| 96 | +- Rebuilt MCP management as a unified workspace with better long-path handling, app status, batch actions, import feedback, and narrow-screen behavior. |
39 | 97 |
|
40 | | -### MCP and Skills Management |
| 98 | +### Provider Import and Routing |
41 | 99 |
|
42 | | -- Added local search for installed MCP and Skills lists. |
43 | | -- Added per-application batch enable and disable actions with partial-state handling. |
| 100 | +- Provider Routing can now scan and import CC Switch providers across supported agents. |
| 101 | +- Added import previews, agent/provider selection, source and endpoint details, warnings, and rescanning without exposing secrets. |
| 102 | +- Moved agent selection into the sidebar and refined its size for stable desktop and narrow layouts. |
| 103 | +- Fixed Codex failover to third-party providers such as DeepSeek when the Codex catalog model incorrectly shadowed the configured upstream model. |
| 104 | +- Failover now preserves the provider's configured upstream model while retaining genuine multi-model catalog selection. |
44 | 105 |
|
45 | | -### Codex Session Usage |
| 106 | +### Redesigned Management Workspaces |
46 | 107 |
|
47 | | -- Codex session logs are imported in batches of up to 1,000 rows with prepared statement reuse for faster large-session imports. |
48 | | -- Failed batches roll back, the file cursor advances only after all batches succeed, and retries avoid duplicate records. |
49 | | -- Codex session request details now correctly display the `responses` API protocol. |
| 108 | +- Redesigned MCP, Pi Extensions, Skills, Prompts, Sessions, and Provider Import with consistent toolbars, lists, filters, empty states, and detail navigation. |
| 109 | +- Restored the Skills repository-management entry, introduced larger discovery cards, and moved Skill details to a full-page view. |
| 110 | +- Moved Prompt creation and editing to dedicated pages, removed duplicate entry points, and fixed Save or Cancel leaving the editor open. |
| 111 | +- Rebuilt Session Manager lists, message navigation, and reading panes; fixed missing wheel scrolling, awkward narrow headers, and resize-induced layout jumping. |
| 112 | +- Standardized responsive behavior for buttons, counts, badges, paths, and toolbars across medium and narrow windows. |
50 | 113 |
|
51 | | -### Stability and Compatibility |
| 114 | +### Thinking Effort and Request Logs |
52 | 115 |
|
53 | | -- OAuth configuration writes now use atomic replacement on Windows to reduce corruption and concurrent overwrite risks. |
54 | | -- Database backup and restore now use batching and transactions for better Windows performance and consistency. |
55 | | -- Improved Codex Responses tool-call and session token accounting compatibility. |
56 | | -- Fixed cascading integration-test failures caused by an overly short default timeout under load. |
| 116 | +- Added cross-protocol thinking-effort detection and persistence for `reasoning.effort`, thinking budgets, and agent-specific equivalents. |
| 117 | +- Request logs and details now expose the thinking level and its source. |
| 118 | +- Corrected request duration and time-to-first-token capture and formatting with consistent millisecond and second units. |
| 119 | +- Session records without network timing now show unavailable values instead of misleading zeroes. |
| 120 | +- Improved responsive layouts and long-content handling across the request table, detail panel, and usage overview. |
57 | 121 |
|
58 | | -### CI Stability |
| 122 | +### Stability and Tests |
59 | 123 |
|
60 | | -- Fixed strict Clippy failures in the Codex session-usage batching implementation. |
61 | | -- Test-only single-record insert helpers no longer compile into production builds, avoiding dead-code warnings. |
| 124 | +- Added regression coverage for Pi package installation, adapter recovery, conflict handling, project trust, scoped workflows, and cross-platform paths. |
| 125 | +- Added coverage for cross-agent MCP/provider imports, responsive management workspaces, Prompt/Skill navigation, Session scrolling, and request timing. |
| 126 | +- Fixed Unix Pi path tests, Windows CLI argument quoting, and strict Clippy failures. |
| 127 | +- Restored consistent backend CI coverage across Windows, macOS, and Linux. |
0 commit comments