Release list

CSA v0.1.3 r2 — 六状态存储辅助、模型工具适配与增量升级 Latest

Latest

Dalaoyuan2020 released this 12 Jul 01:42

v0.1.3-r2

7dac596

CSA v0.1.3 — 启动器稳定性、磁盘防护与 Key 切换一致性修复

这是一个启动器稳定性、存储体检、模型协议和并排升级版本，重点解决“窗口能打开但显示又用不了 / 实验写满 WSL 宿主盘 / 中转模型输出与工具调用变弱 / 换包后仍由旧 Bridge 提供服务”等问题。

验证边界：本版本已在 Windows 11 10.0.22631 + Ubuntu-24.04 完成端到端验证；309/其他差异环境尚未完成本版本 DeepSeek thinking 全链路复测。

中转说明：https://10521052.xyz/v1 是 CSA 项目方自建中转服务，不是模型厂商官方 API；使用前仍需确认域名与服务条款。

四项核心变化

1. 2×3 六状态界面与 WSL 存储体检

首页固定为可折叠的 2 行 × 3 列六项状态：WSL2、运行时、Bridge、Claude Science、WSL 存储和当前 API Key。
“WSL 存储”显示 VHDX 的 Windows 位置、宿主盘余量、Linux 根分区余量和 VHDX 大小。
空间不足、根文件系统只读、临时目录不可写或 inode 紧张时给出警告；达到阻断阈值时不再盲目重启服务。
Bridge 日志超过 50 MB 时只轮转自身日志并保留一份备份，避免日志持续挤占 VHDX。
r2 在 C 盘或低空间场景显示“推荐迁移 / 辅助迁移”，弹窗展示本机存储证据并生成可复制给 Codex 的只读体检与迁移计划 Prompt。

r2 的启动器只生成 Prompt，不执行迁移。实际 Move/export/import/unregister 仍未进入 v0.1.3 EXE，迁移执行继续保持 BUILD NO-GO；该入口可以忽略，不阻断启动或并排增量升级。

2. 输出参数与工具调用适配

正式请求不再注入统一的小 max_tokens；调用方没有传预算时，让上游模型采用自身默认值。
OpenAI o-series 使用 max_completion_tokens；明确模型上限只在显式配置或上游明确返回限制时应用。
Anthropic tool_choice、强制函数选择和 disable_parallel_tool_use 会转换到对应 OpenAI-compatible 参数，并保留并行工具调用偏好。
只有明确 HTTP 400/422 参数错误才做一次受限兼容重试；认证、额度、模型、网络和 5xx 不会被伪装成参数问题。

3. DeepSeek、MiniMax 与更多 Provider

MiniMax 使用中国区 Anthropic-compatible 地址；DeepSeek 使用官方 Anthropic-compatible 地址。
DeepSeek 原生请求会把 thinking.type=auto 转为 adaptive，避免有效 Key 被 400 误判不可用。
Provider 初始模型保持为空；优先读取真实 /models，只有经过核验的官方候选且真实短对话成功后才允许保存。
自动映射支持“单模型映射全部 Claude 角色”和“多模型区分主力/快速模型”，第三方中转不会套用官方候选回退。

4. 从重装改为并排增量升级

从 v0.1.2/更早版本升级时，不卸载 WSL、Ubuntu 或 Claude Science 运行时。
下载完整新 ZIP 到新目录，由新版识别旧目录 Bridge、执行受控接管并校验 source_path 与配置版本。
同一电脑、同一 Windows 用户继续读取 APPDATA 设置和 DPAPI Key；验收成功前保留旧目录作为回退。
这是可回退的并排升级流程，不是静默下载和自动替换 EXE 的应用内更新器。

稳定性与一致性修复

修复状态显示矛盾：Claude Science 已由端口检测到时，不再显示“已停止”。
修复启动脚本假成功：WSL 启动脚本失败时，Windows 包装层会返回真实失败，不再把失败当成功。
状态探测改为一次只读体检并设置总超时，WSL/VHDX 异常时窗口不再无限转圈。
增强 WSL 只读诊断：如果 /tmp、Linux 用户目录或根文件系统异常，停止自动重启，避免扩大损坏。
改进非 systemd Bridge fallback：进程会可靠脱离启动 shell，并验证连续健康，而不是短暂监听后消失。
Bridge 健康检查会验证 source_path，旧解压目录的进程不能再冒充当前版本。
API Key/模型切换采用“预写 Windows 设置 → 更新并重启 Bridge → 验证配置版本 → 原子提交”的事务流程；失败会回滚。
默认模型、Provider 面板预设和示例配置改为空状态；用户输入模型或获取实时模型列表后再映射。
/v1/models 正式支持空列表，不再因零模型触发崩溃。
自定义中转可填写自己的名称；留空时按“自定义中转 + 当前日期 + 当日序号”生成，不再出现多条同名配置。
API Key 连通测试不再用极小的固定输出长度；先以 256 tokens 测试，仅在 reasoning/长度截断时对同一模型重试到 1024，避免把有效模型误判失败并擅自切换。
Thinking/effort 采用“平台优先、模型家族其次”的显式请求适配；没有 caller 信号时不擅自开启，明确 400/422 参数错误最多兼容重试一次。
修复 DeepSeek/MiniMax 原生 Anthropic 兼容接口的推理参数：Claude Science 发出的 thinking.type=auto 会转换为上游支持的 adaptive，并移除与自适应模式冲突的固定预算；显式 enabled / disabled 保持不变。
DeepSeek 在 /models 不提供可用列表时，可尝试经过官方资料核验的候选模型，但只有真实短对话成功后才会写入模型与映射，初始状态仍为空。
新增 scripts/probe-provider-capabilities.ps1，可在用户明确需要时检查已保存 Provider 的模型列表、短文本、输出参数、函数调用和 reasoning 控制；它会产生真实请求，不在日常启动中自动运行。

从 v0.1.2 / 更早版本升级

不需要卸载 WSL、Ubuntu 或旧版运行时。把 v0.1.3 完整 ZIP 解压到新目录，从新目录启动并让新版接管 Bridge；确认六项状态和模型连通测试正常后，再删除旧解压目录。不要只替换 exe，也不要把新包散文件覆盖进正在运行的旧目录。

同一台电脑、同一 Windows 用户下，CSA 会继续读取 %APPDATA%\ClaudeScienceAssistant\settings.json。旧版目录可暂时保留作为回退；若新版接管失败，停止新版后仍可从旧目录恢复。当前版本不执行静默自动更新或自动迁移 WSL 虚拟磁盘。

当前已知故障含义

如果诊断出现类似：

WSL filesystem is read-only or not writable
Sandbox unavailable: cannot create the seccomp live-exec probe dir under /tmp
Read-only file system
Input/output error

这不是 API Key 或模型映射问题，而是 WSL 发行版进入了不可写状态。建议先执行：

wsl --shutdown

然后重新打开 Ubuntu 和 CSA。若仍然只读，需要修复或重建该 WSL 发行版。

防止实验再次写满系统盘

启动器首页的“WSL 存储”会显示发行版实际位置。例如 E:\WSL\Ubuntu-24.04 表示 Linux 根文件系统主要占用 E 盘，而不是 C 盘。运行大实验前同时确认：

WSL 虚拟磁盘所在宿主盘有足够空间；
WSL Linux 根分区有足够空间和 inode；
Windows 配置盘（通常为 C 盘）仍有余量；
大型数据集和实验输出写入专门的数据盘目录。

CSA v0.1.3 r2 提供位置检测、容量/可写性告警、危险操作阻断和只读辅助迁移 Prompt，不会自动迁移、注销、压缩或重建用户的 WSL 发行版。Codex 会先重新体检、判断迁移是否对症、推荐候选目标盘并输出计划；实际执行仍需后续关闭兼容矩阵和异机验收门槛。

r2 发布后补丁

修复 Windows DrvFs 路径仅大小写不同却被判定为“其他或旧包 Bridge”的问题。/mnt/c/.../New project 5 与 /mnt/c/.../new project 5 现在按 Windows 路径身份比较；Linux 原生路径仍保持大小写敏感。
Release EXE 的项目根优先来自当前 EXE/argv 路径，不再静默使用开发机编译期源码目录兜底。
Bridge 归属失败时诊断会同时输出 expected、actual 和 source_match，便于异机定位。
当 WSL VHDX 位于 C: 时，“WSL 存储”会直接显示警告；该警告不等于授权迁移，也不会阻断普通启动。
新增存储辅助迁移弹窗与本机化 Codex Prompt；Prompt 生成器是纯前端只读逻辑，不调用 Tauri 服务命令、网络请求或文件写入。
包内 self-test 现在会检查现有 .venv 的依赖是否完整；首次安装依赖中断后可以直接重跑修复，不会因为半成品 venv 跳过安装。

Assets 4

CSA v0.1.3 — Claude Science Assistant

Dalaoyuan2020 released this 11 Jul 18:40

v0.1.3

4525584

CSA v0.1.3 — 启动器稳定性、磁盘防护与 Key 切换一致性修复

这是一个启动器稳定性修复版，重点解决“窗口能打开但显示又用不了 / 接入模型状态混乱 / 修复按钮执行后仍失败”的问题。

验证边界：本版本已在 Windows 11 10.0.22631 + Ubuntu-24.04 完成端到端验证；309/其他差异环境尚未完成本版本 DeepSeek thinking 全链路复测。

中转说明：https://10521052.xyz/v1 是 CSA 项目方自建中转服务，不是模型厂商官方 API；使用前仍需确认域名与服务条款。

这一版修复了什么

修复状态显示矛盾：Claude Science 已由端口检测到时，不再显示“已停止”。
修复启动脚本假成功：WSL 启动脚本失败时，Windows 包装层会返回真实失败，不再把失败当成功。
状态探测改为一次只读体检并设置总超时，WSL/VHDX 异常时窗口不再无限转圈。
启动器会显示 WSL 虚拟磁盘的 Windows 位置、宿主盘余量、Linux 根分区余量和 VHDX 大小。
增强 WSL 只读诊断：如果 /tmp、Linux 用户目录或根文件系统异常，停止自动重启，避免扩大损坏。
改进非 systemd Bridge fallback：进程会可靠脱离启动 shell，并验证连续健康，而不是短暂监听后消失。
Bridge 健康检查会验证 source_path，旧解压目录的进程不能再冒充当前版本。
API Key/模型切换采用“预写 Windows 设置 → 更新并重启 Bridge → 验证配置版本 → 原子提交”的事务流程；失败会回滚。
默认模型、Provider 面板预设和示例配置改为空状态；用户输入模型或获取实时模型列表后再映射。
/v1/models 正式支持空列表，不再因零模型触发崩溃。
Bridge 日志超过 50 MB 时仅轮转自身日志并保留一份备份，避免日志长期挤占 VHDX。
首页环境状态固定为 2 行 × 3 列的六项状态栏，并可折叠；折叠偏好不会影响诊断和后台刷新。
自定义中转可填写自己的名称；留空时按“自定义中转 + 当前日期 + 当日序号”生成，不再出现多条同名配置。
API Key 连通测试不再用极小的固定输出长度；先以 256 tokens 测试，仅在 reasoning/长度截断时对同一模型重试到 1024，避免把有效模型误判失败并擅自切换。
正式对话不注入统一输出长度：Bridge 透传调用方的 max_tokens；调用方未传时让 OpenAI-compatible 上游采用自身默认，只有显式模型上限配置才会夹取。
OpenAI o-series 自动使用 max_completion_tokens；并行工具偏好会转换为 parallel_tool_calls。
Thinking/effort 采用“平台优先、模型家族其次”的显式请求适配；没有 caller 信号时不擅自开启，明确 400/422 参数错误最多兼容重试一次。
修复 DeepSeek/MiniMax 原生 Anthropic 兼容接口的推理参数：Claude Science 发出的 thinking.type=auto 会转换为上游支持的 adaptive，并移除与自适应模式冲突的固定预算；显式 enabled / disabled 保持不变。
DeepSeek 在 /models 不提供可用列表时，可尝试经过官方资料核验的候选模型，但只有真实短对话成功后才会写入模型与映射，初始状态仍为空。
新增 scripts/probe-provider-capabilities.ps1，可在用户明确需要时检查已保存 Provider 的模型列表、短文本、输出参数、函数调用和 reasoning 控制；它会产生真实请求，不在日常启动中自动运行。

从 v0.1.2 / 更早版本升级

当前已知故障含义

如果诊断出现类似：

WSL filesystem is read-only or not writable
Sandbox unavailable: cannot create the seccomp live-exec probe dir under /tmp
Read-only file system
Input/output error

这不是 API Key 或模型映射问题，而是 WSL 发行版进入了不可写状态。建议先执行：

wsl --shutdown

然后重新打开 Ubuntu 和 CSA。若仍然只读，需要修复或重建该 WSL 发行版。

防止实验再次写满系统盘

启动器首页的“WSL 存储”会显示发行版实际位置。例如 E:\WSL\Ubuntu-24.04 表示 Linux 根文件系统主要占用 E 盘，而不是 C 盘。运行大实验前同时确认：

WSL 虚拟磁盘所在宿主盘有足够空间；
WSL Linux 根分区有足够空间和 inode；
Windows 配置盘（通常为 C 盘）仍有余量；
大型数据集和实验输出写入专门的数据盘目录。

CSA 只提供诊断、告警和危险操作阻断，不会自动迁移、注销、压缩或重建用户的 WSL 发行版。

Assets 4

CSA v0.1.2 — Bridge detection portability fix

Dalaoyuan2020 released this 07 Jul 08:04

v0.1.2

882c008

CSA v0.1.2 — Bridge detection portability fix

这是 CSA（Claude Science Assistant）的第二个公开 Release，重点修复异地电脑/不同 WSL 环境下的 Bridge 状态误判问题，并补齐发布包完整性检查。

下载

请只从本仓库 GitHub Releases 下载：

claude-science-assistant-v0.1.2-release-portable.zip
claude-science-assistant-v0.1.2-release-portable.zip.sha256

发布时请同时上传同名 .sha256 文件，并在 Release 页面复制其中的值：

SHA256: e6875a445f10414600171b384d1ef6ce7ec01336af178f2a01d3b97fbbe42c81

这一版修复了什么

修复 Bridge 健康检测误判：不再把 /health 成功与某个脆弱的进程命令行正则绑定。
适配 Ubuntu-22.04 / WSL2 / wslrelay.exe 等异地电脑场景：只要本地 Bridge 健康检查通过，UI 就能正确识别 Bridge 运行状态。
新增 scripts/status-probe.ps1，作为 UI 之外的“裁判线”诊断脚本，用于判断：
- Bridge 是否健康；
- Claude Science 是否运行；
- systemd unit 是否指向当前解压目录；
- 9876 / 8765 / 8766 等端口证据是否一致。
修复 Windows 路径转 WSL 路径时反斜杠导致的跨盘符/异地路径问题。
修复旧版解压目录残留时，systemd service 可能仍指向旧目录的问题；启动脚本会检查并按当前项目目录修复。
Release ZIP 打包时强制要求包含 vendor/claude-science/linux-x64/claude-science，同时排除 .rar / .zip / .7z 临时压缩包。

安全说明

Git 源码仓库不提交用户 API Key、OAuth token、Cookie 或控制 token。
Release ZIP 包含启动器、脚本、Skill、文档、Bridge 依赖以及 Claude Science Linux 二进制。
用户自己的 API Key 仍由本机 DPAPI/WSL runtime 配置管理，不会随便携包迁移到其他电脑。
如果提交 issue 或截图，请先检查是否含有真实 API Key 或私密路径。

验证建议

下载 ZIP 后可用同名 .sha256 文件核对哈希。解压后至少确认以下文件存在：

claude-science-assistant.exe
scripts/status-probe.ps1
scripts/start-claude-science-wsl.ps1
scripts/start-claude-science-wsl.sh
skills/bootstrap-claude-science-wsl/scripts/inspect-wsl.sh
vendor/claude-science/linux-x64/claude-science
vendor/claude-science/linux-x64/manifest.json

Assets 4

CSA v0.1.1 — Claude Science Assistant

Dalaoyuan2020 released this 06 Jul 13:29

v0.1.1

abe4dce

CSA v0.1.1 — Claude Science Assistant

首个 GitHub 公开版本：面向 Windows 用户的 Claude Science 启动器、WSL Bridge 管理器与国产模型接入助手。

CSA 是 Claude Science 绿皮书第二章“装上你的科研搭档”的配套工具。它的目标不是让读者学习系统运维，而是帮读者把 Claude Science 跑起来，并接入 GLM、LongCat、DeepSeek、MiniMax、OpenCode Go、OpenRouter 或自定义中转。

下载

请只从本仓库 GitHub Releases 下载：

claude-science-assistant-v0.1.1-release-portable.zip
claude-science-assistant-v0.1.1-release-portable.zip.sha256

发布时请同时上传同名 .sha256 文件，并在 GitHub Release 页面复制其中的值：

SHA256: <从 claude-science-assistant-v0.1.1-release-portable.zip.sha256 复制>

不要从网盘、群文件或第三方镜像下载带 claude-science-assistant.exe 的压缩包。

这一版解决了什么

把 CSA 定位为 Windows 上的 Claude Science 启动器，而不是一堆散落脚本。
首页只显示当前 API Key、当前状态和启动动作；新增 Key 放到“添加 API Key”入口里选择。
API Key 按添加顺序保存，一次只激活一条，避免所有 Provider 平铺到主面板。
添加“测试 API Key”和“自动映射”能力，减少跑到项目内部试错。
修正 DeepSeek 兼容：
- 默认 deepseek-v4-pro
- 快速/Haiku 映射 deepseek-v4-flash
- 兼容旧名或误填：Deep-chat、deep-chat、deepseek-chat、deepseek-reasoner
新增或修正 Provider 模板：
- GLM-5.2
- LongCat：LongCat-2.0
- MiniMax：MiniMax-M3 / MiniMax-M2.7-highspeed
- OpenCode Go：默认 glm-5.2，主力优先 glm-5.2 → qwen3.7-max → deepseek-v4-pro，快速 deepseek-v4-flash
- OpenRouter
- 内置第三方中转 https://10521052.xyz/v1
- 自定义 OpenAI-compatible 中转
WSL 策略从“硬锁 Ubuntu-24.04”改为“推荐 Ubuntu-24.04，兼容已安装 Ubuntu/WSL 发行版”。
保留 PowerShell 脚本，同时提供可双击的 BAT 入口，降低新手门槛。

Provider 默认顺序

官方直连：GLM-5.2、LongCat、DeepSeek、MiniMax、Claude、OpenAI / GPT
聚合平台：OpenCode Go、OpenRouter
第三方中转：内置 https://10521052.xyz/v1、自定义 Base URL

第三方中转不会默认信任。CSA 会要求确认域名后，才会把 API Key 发往该地址。

自动映射逻辑

CSA 会把 Claude 侧模型分成主力和快速两类：

Claude 侧角色	映射意图
`byok-model-0001`	主力模型
`claude-sonnet-*`	主力模型
`claude-opus-*`	主力模型
`claude-haiku-*`	快速/低延迟模型

如果 API Key 的 /models 只能读取到一个聊天模型，CSA 会把所有 Claude 角色统一映射到这个模型；如果有多个模型，则优先选择 Pro/Max/大型模型作为主力，Fast/Flash/Highspeed/Mini/Lite/Air 作为快速模型。

安全说明

CSA 不会把明文 API Key 写入发布包、README、Release 说明或日志。
API Key 使用 Windows 当前用户 DPAPI 加密保存。
DPAPI 绑定当前 Windows 用户和当前电脑；复制便携包到另一台电脑不会带走 API Key。
当前激活 Key 会写入 WSL Bridge 运行时配置，供本地 Bridge 调用上游模型；该配置应保持 0600 权限。
CSA 默认不修改 Clash、VPN、DNS、hosts、系统代理、根证书或 443 端口。

已知限制

v0.1.1 是首个公开版本，建议先在测试电脑或可回滚环境中验证。
第三方中转的稳定性、模型列表和响应格式取决于上游平台。
OpenRouter 等动态模型平台建议先测试连通，再保存映射。
如果上游返回 HTTP 200 但内容为空，通常是模型不可用、限流、余额或中转兼容问题，不一定是 CSA 本地映射失败。

文档

新手教程：docs/quick-start.zh-CN.md
架构与产品任务书：docs/architecture-and-product-plan.zh-CN.md
Provider 矩阵：docs/provider-access-matrix.zh-CN.md
绿皮书联动：docs/green-book-integration.zh-CN.md

Assets 4

Releases: Dalaoyuan2020/claude-science-assistant

Release list

CSA v0.1.3 r2 — 六状态存储辅助、模型工具适配与增量升级

CSA v0.1.3 — 启动器稳定性、磁盘防护与 Key 切换一致性修复

四项核心变化

1. 2×3 六状态界面与 WSL 存储体检

2. 输出参数与工具调用适配

3. DeepSeek、MiniMax 与更多 Provider

4. 从重装改为并排增量升级

稳定性与一致性修复

从 v0.1.2 / 更早版本升级

当前已知故障含义

防止实验再次写满系统盘

r2 发布后补丁

Uh oh!

CSA v0.1.3 — Claude Science Assistant

CSA v0.1.3 — 启动器稳定性、磁盘防护与 Key 切换一致性修复

这一版修复了什么

从 v0.1.2 / 更早版本升级

当前已知故障含义

防止实验再次写满系统盘

Uh oh!

CSA v0.1.2 — Bridge detection portability fix

CSA v0.1.2 — Bridge detection portability fix

下载

这一版修复了什么

推荐使用流程

安全说明

验证建议

Uh oh!

CSA v0.1.1 — Claude Science Assistant

CSA v0.1.1 — Claude Science Assistant

下载

这一版解决了什么

推荐使用流程

Provider 默认顺序

自动映射逻辑

安全说明

已知限制

文档

Uh oh!