Skip to content

ardentl/plainspeak

v0.7.0MIT

Plain writing skills and optional local translation round trips.

GitHub

Changelog

0.7.0 — 带背景回译 / Contextual round trips

  • 每段携带同一助手回答的邻近前后文，两次翻译均参考背景，保留逐段显示和原始 Markdown。
  • 流式期间不因背景 token 反复重跑；完成后最多刷新一次最终背景，取消与清空仍阻止旧任务回写。
  • Host/bridge 校验可选 context 字符串；缓存 schema 4 纳入背景，不另存背景明文，保留既有设置和历史。
  • 本地五组有无背景对比保留原始输出：标题和地名有改善，截图台词仍存在模型语义错误。普通数字保护保持关闭。

0.6.1 — 取消普通数字保护 / Remove plain-number guard

  • 按用户选择取消普通正文数字的值、写法和出现次数检查，包括百分比与科学计数法；不再因“十一年”改为“11年”而回退原文。
  • 代码、链接、公式、指定保护词及异常输出检查继续保留；公式和代码内的数字仍随整体内容保护。
  • 已有设置和记录保留，旧版因数字检查回退的结果不会作为成功缓存复用。

0.6.0 — 桌面安装与审查修复 / Desktop installation and review fixes

  • 新增 --client desktop：先启动 Harness 初始化 profile，安装器再合并原生 bundle 激活字段，重启桌面版即可加载。保留 profile JSON 其他字段和已有用户 YAML 原始字节；web 默认仍通过外置 --patch 启动。
  • F1：自有 API 增加严格 loopback Host、可用远端地址、Fetch-Site 与同源 HTTP(S) Origin 校验；静态请求标记不作为身份认证。
  • F2：数字保护纳入科学计数法的 e/E 指数和符号，改变数量级时保留原文；旧保护版本的记录保留，但不作为新规则下的成功缓存复用。
  • F3：含未支持图片、SVG、音视频等媒体的段落或单元格保留原样，避免译文隐藏原图。
  • F4：清空通知当前页面所有段落 controller，取消未入队 debounce 和旧请求，阻止旧块重新提交；保留已显示译文，继续处理新文本。
  • F5：安装/升级改用可恢复事务，覆盖应用、profile 插件和桌面激活信息；中断后按相同参数重试可恢复，同时继续保护用户修改。
  • F6：自有 HTTP 路由注册纳入插件生命周期，卸载时注销，避免重载残留与重复注册。
  • F7：外部兼容 API 拒绝重定向，防止将 Authorization 转发到其他源。
  • F8：请求 ID 和独立取消请求连接前后端，分块及两次翻译调用之间检查取消。已启动的单次 provider 调用等待返回，不再启动下一次；禁用、语言变化、清空及卸载均可停止旧工作。
  • F9：SQLite 每次连接启用 secure_delete，迁移时回收旧空闲页，覆盖清空和记录淘汰路径。该处理针对当前数据库文件，不承诺擦除备份、快照或存储介质。
  • 本轮使用 Windows 上已安装的 @deepseek-ai/dsh 0.2.1-rc.5 桌面 Host 及其网页前端，完成 12/12 段 Hy-MT2 Q4 实际回译。保存隐藏原文并刷新后，12 个输出仍就绪、12 个原文块隐藏，Python 代码 print("hello") 不变，记录面板显示 12 条；接口返回 200，未见控制台错误。Electron 原生外壳 GUI 受工具限制尚未验收；Linux/macOS 未验收。详细结果见验证记录。

0.5.1 — 减少重复对照 / Cleaner comparison

  • 表格默认显示一个译文版本，通过表格上方的“译文 / 原文”切换，单元格不再上下重复。
  • 译文与原文完全相同时只显示原文一次；切换表格版本不重新翻译。
  • 普通段落对照移除额外竖线，并让译文使用较浅、略小的文字；真正的引用块保留原有结构。
  • 全局隐藏原文时收起表格切换按钮；关闭自动翻译恢复原表格并移除按钮。

0.5.0 — 原生 Markdown 译文 / Native Markdown translations

  • 译文复用 Harness 原生 Markdown 组件，保留标题、加粗、斜体、删除线、链接、行内代码与公式排版。
  • 翻译简单表格单元格中的说明文字，保留行列、代码块和纯技术值。
  • 从 KaTeX 注解恢复一次公式原文；增加公式字面量保护和缓存版本，旧记录保留但不作为新保护规则下的成功缓存复用。
  • 隐藏原文时移除额外的引用竖线与缩进，修正列表符号与译文的对齐。
  • 实际 Harness / Hy-MT Q4 固定样例：13 个文字块完成回译，代码、公式、链接与 4×2 表格结构通过检查。详见实验记录。

0.4.1 — 跟随 Harness 蓝色主题 / Harness blue accents

  • 按钮、开关、标签页、标记与译文装饰跟随宿主 --dsw-alias-state-business-primary，缺省色为 #4176e6。
  • 保留所有阅读设置与本地记录。

0.4.0 — 首个公开预览版 / Initial public preview

发布目标：Windows 上的 DeepSeek Harness，实际验收版本 @deepseek-ai/dsh 0.1.1-rc.2。远程仓库、标签与 Release 的发布状态见发布说明。

面向用户的变化

  • 原生助手段落增强：保留原文，完整段落下显示较浅的本地译文，跳过代码、表格、工具输出、用户消息和思考过程。
  • 重做阅读面板：双线标记、阅读设置 / 本地记录标签页、固定保存栏与未保存提示；原始答案继续由 Harness 组件渲染。
  • 可见的 PlainSpeak 设置 入口，控制自动译文、七种输出语言、默认清晰表达规则和记录保存；写作规则从下一条回复生效。
  • 可选“隐藏原文”，默认关闭并在本地保存：译文就绪后只显示译文，翻译中或失败保留原文；关闭自动翻译恢复原文。
  • 本机 SQLite 持久设置与最多 1000 条段落记录，支持刷新 / 重启后复用成功结果、查看、JSON 导出和两步确认清空；关闭保存停止持久写入与复用。
  • 单条 PowerShell 安装命令，使用经过哈希核验的 llama.cpp 运行时与默认 1.13 GB Hy-MT2 1.8B Q4 模型，无需 Ollama。保留已有宿主设置和会话。
  • 六个腾讯官方 GGUF 模型选项及本地安装 / 切换命令；升级模型按需获取。
  • 首发入口文档集中到 Harness；其他客户端留作后续适配与开发者实验。

已知范围

  • Windows 的上述 Harness 版本已有实际运行记录；其他系统与宿主版本未验收。
  • 已有 GGUF 的安装复用与推理已运行，干净机器的全量网络下载安装尚未跑完。
  • 更大的模型及全部语言尚未做本项目质量比较；翻译仍可能改变含义，原文保留供核对。
  • 本地记录含用户段落，由用户选择保存；独立于 Harness 会话，不上传，不包含在源码包中。
  • 使用源码 ZIP 安装，未发布宿主市场条目或 npm 插件。Codex / Claude 暂不在首发界面适配范围。

实际测试与 GUI 证据见验证记录。此前 0.1–0.3 为本地开发与体验实验，相关证据保留在该文档。