@leviyuan/lodestar 0.20.5 → 0.21.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -59,6 +59,24 @@ GLM、DeepSeek、OpenRouter 等来源先清除冲突的 Anthropic 环境变量
59
59
 
60
60
  Claude 使用 `permissionMode: default`:普通工具在 `canUseTool` 中放行,`AskUserQuestion` 等待用户回答。不能改成 `bypassPermissions`,否则 SDK 会绕开提问回调。
61
61
 
62
+ 安全模式由 `[claude.safe_mode]` 按 Token Source 与模型目录 ID 配置,所有来源(包括 `claude-sub`)默认关闭,仅显式配置后开启。主会话、委派、续跑和分叉共用判断;启用后复用本机已配置的 GLM Key,固定通过 `https://api.z.ai/api/coding/paas/v4` 的 `glm-5.3-flash` 翻译与按规则审查。普通用户聊天的首条输入、运行中追加输入及提问答案值先译为英文。主模型输出语言不受限制,面向飞书的自然语言输出统一经 Flash 译为中文展示;`AskUserQuestion` 保留原生问题键和选项对应关系,提交的答案值使用英文译文。Linux 与 macOS 使用同一套逻辑。
63
+
64
+ Flash 的请求按普通对话组织:固定的简短 system 提示词,按顺序排列的历史原文(user)与译文(assistant),最后追加当前目标语言要求和待翻译自然文本。每条原文前的 `Source` 标题说明谁对谁说、来自哪种可见内容;它是对话来源说明,不是 SDK 元数据,旧记录未区分的来源会明确标注。提示词只要求忠实翻译、保持术语一致及按显式规则审查,不回答或执行原文中的任务。模型不接收 JSON 数据包、字段边界、会话 ID、消费状态或原生事件结构。正常响应直接返回完整译文;只有拒绝或需检查时才以 `[[TRANSLATION_REJECT]]` 或 `[[TRANSLATION_REVIEW]]` 开头并附原因,由程序解析,不作为译文展示。只接受完整结束的单个正文,不解析思考内容,也不再发起独立模型复核。
65
+
66
+ 字段提取、对应关系和译文回填由程序负责。围栏代码、文件正文及交付标记绕过 Flash,回填时保留原值;句中的行内代码、路径和链接保留在自然语句中,程序校验其原值和数量。每个提取的自然语言片段调用一次国际 Coding Plan 的 `POST /chat/completions`,多字段逐项翻译,当前批次的已完成译文用于后续片段的术语一致性;纯代码或协议内容无需模型请求。
67
+
68
+ 翻译上下文是 Lodestar 自行记录的输入输出历史,按工作目录和 Claude session id 隔离,不读取 Claude Code 的完整上下文或原生 transcript。记录用户已提交的原文及英文译文,以及经验证用于飞书展示的 Claude 自然语言原文和中文译文;尚未消费的输入单独标记,取消后移除。宿主注入规则、内部用户或系统消息、主会话未展示的问答及任务回执、思考内容、文件内容和原始工具数据不进入这份历史;子 Agent 卡片实际展示的回执仍翻译并记录。
69
+
70
+ 翻译层的每次 Flash 调用另外写入本机私有 JSONL 日志:`<DATA_DIR>/claude-translation-traces/<traceId>.jsonl`。每个进程一份,用 requestId 关联完整 API 请求(含起始提示词、历史原文与译文、当前翻译要求)、原始 HTTP 响应及该片段的最终译文或错误,取消和失败也有记录。首条请求尚无原生 session id 时先记 null,随后用 session_bound 记录关联;这些关联信息仅用于本机日志,不加入模型提示词。目录权限为 0700、文件为 0600;Key 和认证字段脱敏,不向普通 daemon 日志打印正文,不截断内容或自动删除文件。日志写入失败明确报告,不继续放行无法记录的调用。它与原生会话、卡片记录联合用于核验实际执行的链路;取消竞态及写入失败等边界仍由隔离测试覆盖。
71
+
72
+ 续跑恢复本地保存的翻译历史;分叉只继承指定 checkpoint 及以前的记录,再绑定新 session id。私有记录使用 v2 的独立原文和译文字段;v1 仅按已知且无歧义的双语包装格式迁移,不猜测、不读取原生历史重建。旧会话尚无本地翻译记录时,从本次启用开始积累。已有记录损坏、归属不符、旧格式歧义或分叉锚点缺失时明确报错。
73
+
74
+ 每次翻译操作读取一份不可变的输入输出历史快照,仅用于理解指代和术语。模型历史只使用原文与译文,保留已记录的自然语言,不按条数或长度静默裁剪;围栏代码和交付协议直接排除,不插入省略占位说明。翻译失败或取消后未发出的内容不记作已展示输出;若上游拒绝请求,按实际错误报告。
75
+
76
+ 翻译只覆盖飞书原有的自然语言展示,包括主 Agent 正文、命令首行 `# desc:` 说明、Task/Todo 任务文字、MCP 已知自然语言字段、后台 `task_*` 说明与结果、Cron 触发提示词、原生错误,以及委派任务的说明、结果和问答。子 Agent 仍通过原有后台进度、完成通知和工具步骤展示,原先隐藏的逐条正文继续隐藏。展示使用独立的已验证译文;执行命令、工具参数、任务状态和 ID、原始 API 结果与问答键保持原值,委派 API 不返回中文展示字段,也不为卡片译文新增委派历史产物。代码、文件内容、路径、链接、命令 stdout/stderr 和文件交付标记不翻译。静态中文界面、翻译服务自身错误及宿主系统诊断直接展示,不递归调用翻译器。
77
+
78
+ 可通过 `[claude].translation_validation_rules` 指定输入内容规则;缺省只做忠实翻译,不自动按身份或地区拦截。拒绝、需检查标记、接口失败或本地标记/字面量校验失败均明确报错,不放行未通过的文本,不切换模型或端点。此模式不改写原生历史、项目文件或工具执行数据。指令类内容明确不送 Flash:Claude Code 原生的 `CLAUDE.md`、`MEMORY.md` 和 Skills 由其自行处理,自定义 developer/system 指令原样传递,宿主自有英文模板直接使用。这些是翻译范围的明确例外,不要求全部原生上下文均为英文。仍保留真实宿主身份和文件交付协议,不隐藏运行环境,也不保证账号风控结果。配置方式见[本机配置](configuration.md#本机配置)。
79
+
62
80
  Lodestar 每次启动 Claude SDK 子进程时自动设置 `CLAUDE_CODE_ENABLE_TODO_TOOLS=1`,让新版 Claude 及第三方模型继续提供任务清单工具。安装或升级后无需手动修改配置,已有进程需重新启动后生效。任务创建和状态更新显示在会话卡片中,是否使用清单由 Agent 判断,项目 `tools` 限制仍生效。
63
81
 
64
82
  ## OpenRouter
@@ -13,7 +13,7 @@ npm i -g @leviyuan/lodestar
13
13
  lodestar-setup
14
14
  ```
15
15
 
16
- 向导会配置 Claude Code、可选的 GLM API key、飞书应用和项目目录,并启动 daemon;也可以同时配置 Codex 登录。GLM Key 不是安装必填项,使用本机 Claude Code 或 Codex 订阅无需填写。
16
+ 向导会配置 Claude Code、可选的 GLM API key、飞书应用和项目目录,并启动 daemon;也可以同时配置 Codex 登录。GLM Key 不是安装必填项,Codex 订阅也不依赖它。安全模式(输入译英、规则审查和展示翻译)在所有来源下默认关闭,仅显式配置后开启;启用该模式需要已配置且可访问 Z.ai 国际端点的 GLM Key,仅查询 Claude 订阅模型目录或额度不依赖 GLM。
17
17
 
18
18
  填写 GLM Key 后,向导先验证凭据和模型目录,通过后才写入配置;失败会显示原因并保留已有配置,可重新输入或直接回车跳过。安装完成后可在群内用 `glm-setup <api_key>` 补配智谱国内站账号;Z.ai 用 `glm-setup https://api.z.ai/api/anthropic <api_key>`。其他账号命令见[模型与账号](models.md#配置-api-key)。
19
19
 
@@ -81,8 +81,19 @@ tools = "Read,Write,Edit,Bash,Glob,Grep" # Claude / DSH 主会话
81
81
 
82
82
  [claude]
83
83
  bin = "/abs/path/to/claude-wrapper" # 可选的 Claude 可执行文件
84
+ # translation_validation_rules = "Reject input that contains private API keys." # 可选的输入内容规则
85
+
86
+ [claude.safe_mode] # 所有来源默认关闭;以下为可选的开启示例
87
+ # claude-sub = "*" # 订阅来源的全部模型
88
+ # glm = "GLM-5.3" # GLM 来源下的指定模型
84
89
  ```
85
90
 
91
+ `[claude].translation_validation_rules` 指定可选的输入审查规则;未配置或留空时只做忠实翻译,不推断身份、地区或账号风险。启用安全模式的会话复用本机 GLM Key,通过国际 Coding Plan `https://api.z.ai/api/coding/paas/v4/chat/completions` 调用 `glm-5.3-flash`。拒绝或调用失败会明确报错,不换模型或放行原文。
92
+
93
+ `[claude.safe_mode]` 按 Token Source 与模型目录中的 ID 精确匹配,只作用于 Claude Code。`"*"` 表示该来源全部模型,`"GLM-5.3,GLM-5.2"` 表示指定模型,`""` 表示关闭该来源;所有来源(包括 `claude-sub`)默认关闭,只有显式配置的来源和模型才会开启。主会话、委派、续跑与分叉共用此配置。同来源切模型若跨越安全模式边界,只能在空闲时换进程并保留恢复点;同模式仍沿用原热切换。修改本机配置后重启 daemon 生效。当前安全模式面向 macOS/Linux,Windows 的日志文件权限检查尚未适配;Windows 上需保持关闭,已配置开启的来源需删除对应条目或设为空串,例如 `claude-sub = ""`。
94
+
95
+ 上下文自动按 Claude 会话保存,只包含带来源说明的可见原文与译文,不读取原生完整上下文。用户输入译为英文,已有的飞书自然语言展示译为中文;主模型输出语言不限,代码、文件与指令保持原样。调用日志保存在本机 `claude-translation-traces` 目录。完整边界见 [Claude 启动配置](claude-agent-backend.md#claude-启动配置)。
96
+
86
97
  项目名用于定位工作目录;工具、MCP 等启动配置按实际目录匹配。同目录的 BTW/FK 与项目别名共享配置,别名配置冲突时明确报错。WT 的目录独立,不自动套用主目录的启动配置;需要配置某个 WT 时,可新增一个项目配置项,将 `cwd` 指向该 WT 的实际路径。工作目录内的 Agent 原生配置仍由相应后端读取。
87
98
 
88
99
  Claude 后端启用项目 MCP 时,缺少 `.mcp.json` 表示未配置;文件存在但无法读取、JSON 损坏或缺少有效的 `mcpServers` 对象会阻止会话启动,并显示具体错误。修正配置后再启动会话。
package/docs/usage.md CHANGED
@@ -54,21 +54,23 @@ Codex 和 Claude 执行任务时,可以直接发消息补充要求或纠正方
54
54
 
55
55
  激活使用当前成本最低的 `gpt-6-luna`、原生目录提供的最低推理档位和标准速度,发送前校验属于主额度;模型缺失或被分配到独立计量桶时不换用其他模型。请求只包含问候,不创建 Codex thread,不加载会话历史、项目指令、Skill 或工具,不在群聊输出问候。只有成功终态及真实 token 用量才记为成功,随后重新读取上游重置时间,不在本地推算。失败诊断写入日志和 `codex-accounts`,下一次检查重新随机等待 30–60 分钟;已确认用量后的刷新失败不会重发。当前零上下文通道需要 Codex 原生文件登录态,令牌刷新仍由原生接口完成;钥匙串等无法通过原生接口导出令牌的存储会显示后台激活 MISS,不改变认证存储,普通会话仍可使用。
56
56
 
57
- 其余账号按分数从高到低选择,同分优先当前可连续使用额度更多的账号。Plus、Pro 5×、Pro 20× 的周额度分别按 1、5、20 份折算(原生套餐标识为 `plus`、`prolite`、`pro`),周分数为 **周剩余份额 ÷(距周重置小时数 − 5)**,提前 5 小时安排消耗;临期账号直接按优先级处理,不做零或负分母计算。Plus 的满 5h 窗口按 0.15 份计算,短窗分数仍为 **5h 剩余份额 ÷ 距5h重置小时数**,普通评分取周分数和短窗分数的较小值;Pro 使用周分数。两种窗口约束同一份消耗,不相加。
57
+ 其余账号按分数从高到低选择,同分优先当前可连续使用额度更多的账号。Plus、Pro 5×、Pro 20× 的周额度分别按 1、5、20 份折算(原生套餐标识为 `plus`、`prolite`、`pro`),周分数为 **周剩余份额 ÷(距周重置小时数 − 5)**,提前 5 小时安排消耗;临期账号直接按优先级处理,不做零或负分母计算。Plus 仅在接口返回 5h 窗口时按完整窗口 0.15 份计算,短窗分数为 **5h 剩余份额 ÷ 距5h重置小时数**,普通评分取周分数和短窗分数的较小值。未返回 5h 窗口的 Plus 和 Pro 使用周分数。两种窗口约束同一份消耗,不相加。
58
58
 
59
59
  启动和换号优先使用最近一次成功的额度缓存,能选出账号就直接启动,不等待额外查询。所有来源、群和 Agent 的额度查询共用一分钟惰性缓存,并合并同账号并发请求;过期后按需查询,失败冷却依次为 1、2、4、5 分钟,并遵守上游更长的等待时间。这不是每分钟自动刷新全部账号。`hi`、`codex-accounts` 也遵守缓存与冷却,网络或限流导致刷新失败时,额度区域保留同账号的成功缓存,账号列表仍展示本次调度失败原因。回复底部刷新失败或进程已退出时,按原格式显示本条回复所属账号的成功缓存,没有缓存仍显示 `MISS`。重新登录、删除账号及额度重置会清空对应缓存,认证失败也不会继续显示旧额度;已由实际请求确认耗尽的账号,必须通过实时查询确认恢复,不能用旧缓存解除耗尽记录。
60
60
 
61
61
  自动选号成功后,其他账号的缓存过期、模型档位不支持或查询失败不会单独发送警告卡或消息;具体原因保留在日志中,也可用 `codex-accounts` 主动查看。此规则同时适用于首次启动、恢复会话和自动换号。无法选出账号、任务必须等待额度恢复或当前账号实际执行失败时,仍会明确提示。
62
62
 
63
- 成功读取 Plus 额度但未返回 5h 窗口时,按满额 0.15 份、完整 5 小时计算短窗分数;界面显示满额,但不编造具体重置时刻。整个请求失败、已返回窗口缺百分比或缺重置时间仍显示 MISS。自动 Ultra 只用 Pro;启动或换号时,有可用消费积分即可通过周余量门槛,没有积分则仍要求周余量至少 0.5 份(Pro 5× 剩 10%,Pro 20× 剩 2.5%)。周余量不足且积分未知时显示 MISS。运行中跌破该门槛不立即切号。没有合格 Pro 时等待额度恢复或积分补充,不自动用 Plus。其他实际限额、登录状态、目标模型与 effort、账号身份和查询错误仍参与自动选择。
63
+ 额度以接口实际返回为准。成功响应未返回 5h 窗口时,不显示该窗口,不补出满额、5 小时时长或重置时间。查询失败仍保留错误,已返回窗口缺百分比或缺重置时间仍显示 MISS,不能当作窗口不存在。
64
+
65
+ 没有 5h 窗口且实际订阅额度可用的 Plus 可参与 Ultra 自动选择,无需消费积分,也不受 Pro 的 0.5 份周余量门槛限制;仍有 5h 窗口的 Plus 须有当前模型计量桶可用积分,无积分时排除,积分未知时显示 MISS。Pro 启动或换号时,有可用积分即可通过周余量门槛,没有积分则仍要求周余量至少 0.5 份(Pro 5× 剩 10%,Pro 20× 剩 2.5%);周余量不足且积分未知时显示 MISS。运行中跌破该门槛不立即切号。订阅额度仍可用时沿用订阅评分,仅剩积分时按积分余额排序。没有合格账号时等待额度恢复或积分补充。模型与 effort 权限、登录状态、消费及工作区限制、真实请求耗尽记录仍参与选择;是否消耗订阅额度或积分由上游决定,Lodestar 不强制切换计费来源。
64
66
 
65
67
  手动指定最高优先级:`hi 工作` 直接使用该账号启动,不读额度、不限制 Plus/Ultra、不检查 0.5 份门槛,也不因本地目录失败或未收录模型而阻挡,真实登录及请求错误由 Codex 返回。只覆盖本次启动,不改变原有群偏好;同一账号正在运行时展示状态,换号会重启并恢复原 thread。`hi default` 指定设备原生账号。需要持久指定时仍可用 `codex-account 工作` 后 `restart`,`codex-auto` 清除该设置。运行过程中确认耗尽后按自动规则换号续跑。临时会话继承持久策略,委派任务按自己的 effort 自动选号。重新登录仍与实际占用账号的原生进程互斥,添加其他备注账号可独立进行。
66
68
 
67
- 订阅窗口达到 100% 且消费积分也确认耗尽,才判为额度用光;积分未知显示 MISS,上游明确禁止使用或达到消费限制仍会阻止调度。运行中的账号可在订阅额度用完后继续消费积分,不因百分比达到 100% 主动切号。原生主 turn 确认额度耗尽后,Lodestar 自动确认会话落盘、停止旧 Codex 进程,用下一账号恢复同一 thread 并继续任务;已接受的原始输入不重放,明确拒绝的输入才重新提交。连续耗尽会继续换号,所有可用账号耗尽则等待接口确认恢复,`stop` 可取消。网络、认证、普通 HTTP 429 和模型满载不触发换号;模型满载保留原来的同模型重试。额度耗尽记录保存在私有 `codex-quota-blocks.json`,防止重启后使用尚未恢复的账号。新的后台查询须确认订阅窗口恢复可用或积分增加才解除实际失败记录;旧正余额不能反复解封,确认积分耗尽后的补充可以恢复调度。退出或落盘确认失败会显示错误,并阻止新进程接管。
69
+ 订阅窗口达到 100% 且消费积分也确认耗尽,才判为额度用光;积分未知显示 MISS,上游明确禁止使用或达到消费限制仍会阻止调度。运行中的账号可在订阅额度用完后继续消费积分,不因百分比达到 100% 主动切号。原生主 turn 确认额度耗尽后,Lodestar 自动确认会话落盘、停止旧 Codex 进程,用下一账号恢复同一 thread 并继续任务;已接受的原始输入不重放,明确拒绝的输入才重新提交。连续耗尽会继续换号,所有可用账号耗尽则等待接口确认恢复,`stop` 可取消。网络、认证、普通 HTTP 429 和模型满载不触发换号;模型满载保留原来的同模型重试。额度耗尽记录保存在私有 `codex-quota-blocks.json`,防止重启后使用尚未恢复的账号。新的后台查询须确认订阅窗口恢复可用或积分增加才解除实际失败记录;若新查询确认旧短窗已不再返回、剩余实际窗口可用且无需积分,同样可以解除;旧正余额不能反复解封,确认积分耗尽后的补充可以恢复调度。退出或落盘确认失败会显示错误,并阻止新进程接管。
68
70
 
69
71
  Linux/macOS 下,额外账号通过软链接共用默认账号的配置、会话、Skills、插件文件和会话写锁,SQLite 状态使用共享目录;认证文件、模型缓存和临时运行文件保持独立。Windows 创建文件软链接需要系统允许;失败直接报告,不自动改用复制。账号备注与群选择位于 Lodestar 数据目录的 `codex-accounts.json`,额外认证位于 `codex-accounts/<内部 ID>/auth.json`。这些文件不应进入项目仓库。
70
72
 
71
- 账号命令统一回复简洁卡片:长错误可展开查看;`codex-accounts` 按调度顺序排列,每页显示 4 个记录,标题为 `#1·备注「0.111/h」`;距离重置不超过 5 小时且有订阅额度的账号显示「临期优先」,仅剩积分的账号显示「积分」。正文依次显示“邮箱:…”、周额度和可选的 5h 额度,每个窗口一行,包含六格进度条、已用百分比和「5.2d」这样的真实重置倒计时;有消费积分时追加余额,未读到积分数据时显示 `积分 MISS`。后续页用 `codex-accounts 2` 等命令查看。每页底部的折叠面板列出全部 Codex 账号命令,包括登录、取消登录、查看、使用重置卡、指定、自动选择、删除及 `hi` 用法。列表按账号身份去重,未知身份或查询失败显示 `MISS`。
73
+ 账号命令统一回复简洁卡片:长错误可展开查看;`codex-accounts` 按调度顺序排列,每页显示 4 个记录,标题为 `#1·备注「0.111/h」`;距离重置不超过 5 小时且有订阅额度的账号显示「临期优先」,仅剩积分的账号显示「积分」。正文先显示“邮箱:…”,再按接口实际返回显示周额度和可选的 5h 额度,每个窗口一行,包含六格进度条、已用百分比和「5.2d」这样的真实重置倒计时;有消费积分时追加余额,未读到积分数据时显示 `积分 MISS`。后续页用 `codex-accounts 2` 等命令查看。每页底部的折叠面板列出全部 Codex 账号命令,包括登录、取消登录、查看、使用重置卡、指定、自动选择、删除及 `hi` 用法。列表按账号身份去重,未知身份或查询失败显示 `MISS`。
72
74
 
73
75
  `hi` 的额度区紧凑展示全部账号,一账号一行;DeepSeek、GLM 的跨 Agent 入口不重复展示。Codex 使用账号备注,有消费积分时显示 `积分 62.5k`;所有消费积分统一用小写 `k` / `m` 缩写千和百万,最多一位小数、去除尾零;积分未知显示 MISS、确认没有则省略;重置卡另显示为“重置 N”,GLM 月工具只显示百分比,不显示次数与重置时间。活跃项目中的 Codex 会话在行尾标注进程实际使用的账号备注,账号尚未确定时省略该备注,自动换号后再次查看会显示新账号;待下次启动生效的指定不会提前改变该标注。`hi` 的各 Codex 账号与回复 footer 都只显示主额度自身的短时窗口和周窗口,不展示 Spark、gpt-reserve 等附加额度;footer 只显示当前实际使用账号,footer 保留 `4.1h·7%·[6.9d·17%]` 紧凑格式并在其后追加消费积分,自动换号后跟随新账号;已结束回复始终显示该回复所属账号的积分。重置卡次数出现在 `hi` 和 `codex-reset` 回执中。
74
76
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@leviyuan/lodestar",
3
- "version": "0.20.5",
3
+ "version": "0.21.1",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },