跳到正文

Changelog

RSS

新功能、改进与修复。

Changelog 双语化 · 英文为主、中文为译文

docsi18n

Changelog 条目现在是双语文档对:主文件 docs/changelog/<date>-<slug>.md 为英文,<date>-<slug>.zh.md 为中文翻译。同步脚本从主文件生成英文树(/changelog/<slug>),从 .zh.md 生成中文树(/zh/changelog/<slug>);RSS、llms 分区与 markdown alternate 均按各树语言输出。

  • 回退:某一侧缺失时,用另一语言的条目补位并标记 untranslated,页面与 feed 条目显示提示横幅(This page has not been translated yet. / 本页暂未提供中文。)并链接到对侧页面。
  • 同步 / collectionscripts/sync-docs.mjs 按基础文件名配对,分别写入 src/content/changelog/**changelog collection)与 src/content/changelog-zh/**changelog-zh collection);生成的目录保持 gitignore。
  • 路由:英文路由读取 changelog/zh 路由与 feed 读取 changelog-zh;首页「最近 changelog」仍展示最新条目,标题为英文。

默认语言翻转为英文 · 中文移至 /zh

docsi18n

英文成为站点主语言:根路径(//docs/**/dev/**/changelog)直接提供英文内容,中文整体迁到 /zh/**/zh/zh/docs/**/zh/dev/**/zh/changelog);顶栏 EN / 中文 切换保持当前路径(/docs/overview/zh/docs/overview)。

  • 机制docs collection 承载英文树(Nimbus versions.current: "en"),docs-zh 通过 versions.others 挂载到 /zh;旧的 /en/** 路由与 docs-en collection 移除。
  • 未翻译页面:英文树中的 spec / PRD / ADR 仍显示中文源,页面顶部显示 This page has not been translated yet.;反向情况(英文页缺中文)在 /zh 树显示 本页暂未提供中文。。两个提示均不可关闭。
  • 生成scripts/sync-docs.mjs 改为把仓库中文源同时生成到两棵树(英文树带 untranslated 标记,中文树干净);英文架构页写入根树,中文架构页写入 /zh 树。
  • 元数据:根 llms.txt 描述英文树并链接 /zh/llms.txt,根 llms-full.txt 改为英文内容;sitemap / canonical / markdown alternate / RSS 按树各自正确;Pagefind 仍索引两种语言。

文档站:/docs 与 /dev 重排 · 双语切换 · mermaid 预渲染

docsi18ndiagrams
  • 内容重排/docs 用户文档(overview / quickstart)、/dev 开发者与审计(architecture / spec / ADR)、/changelog 顶层;两个域名(botharness.ai / .dev)服务同一份站点。顶栏新增 HugeIcons 图标+文字导航(文档 / 开发与审计 / Changelog)并高亮当前区块。
  • 双语:英文挂 /en/**docs-en collection + Nimbus versions 挂载机制);顶栏 中/EN 切换会保持路径(/docs/overview/en/docs/overview);用户向页面英译,/en/dev/** 与 changelog 回退中文并显示「本页暂未提供英文。」;Pagefind 双语言索引(en / zh-hans)。
  • mermaid 改为预渲染 SVGdocs/architecture/diagrams/*.mmd 为源,pnpm diagrams 本地渲染 light + dark 两版到 rendered/*.svg(已提交,CI 不需要浏览器);站点用 <Diagram> 组件 + 灯箱放大,不再运行时加载 mermaid。
  • 遗留:SVG 标签使用 foreignObject(多行 <br/> 所需),Safari 的 <img> 可能不显示文字;og:locale/JSON-LD 仍固定 zh。

站点改用 coss ui(landing 重做)

docsdesign
  • landing 从 Astryx 切到 coss ui(Cal.com 官方设计系统:shadcn registry + Base UI + Tailwind v4);Astryx 相关依赖全部移除。
  • COSS 组件以 copy-in 落在 apps/docs/src/components/coss/(54 个),aliases.ui 指向该目录,避免与 Nimbus 自带组件冲突。
  • 样式对账保持 additive:只补 dark: 变体(对齐 Nimbus 的 [data-mode="dark"])与少量缺失色映射,不改动任何 --nb-* token。
  • 首页结构收敛为克制门户:hero(一句话 + 快速开始命令 + CTA)→ 三张路径卡 → 紧凑能力区(六态徽章)→ 最近 changelog;纯 SSR、零 hydration。
  • 导航图标引入 HugeIcons(@iconify-json/hugeicons)。

Astryx 首页(landing)

docsdesign
  • 站点首页改用 Meta Astryx 设计系统:React 19 组件、SSR 静态输出、零客户端 hydration;docs 页面继续用 Nimbus 自带组件(按环境分工)。
  • 新增品牌 token 单一来源 design/tokens.css,Astryx 侧经 apps/docs/src/styles/astryx.css 显式声明 layer 顺序(reset, theme, base, astryx-base, astryx-theme, components, utilities, landing)。
  • Astryx CSS 只在首页路由加载(构建验证:181 KB,仅 index.html 引用);docs 页面零额外体积。后续若需要更瘦,可切 Astryx source build 只打包用到的组件。
  • 首页内容:hero(Badge / H1 / Lead / CTA)、四张能力卡(PersonaBot / 记忆即文件 / 状态可见 / 不 fork)、为什么、文档入口、footer。

v1.0 基线 · M1 骨架 · 文档站上线

milestonedocscore

v1.0 基线

  • 规格重组:平台层(PersonaBot / 记忆 / 状态 / 工作方式)独立为 docs/botharness.mdPRD.md 只描述 DeepSeekBot 应用。
  • 新决策:ADR-0015(BotHarness 是 DSH 插件层,不 fork)、ADR-0016(PersonaBot 一等实体 + 双层状态)、ADR-0017(工作 = 会话,无 Task 实体)、ADR-0018(Workspace = 单目录)。
  • 仓库更名 BotHarness/BotHarness;词表重写(PersonaBot / Agent / Session / Workspace / 六态)。

M1:BotHarness 骨架(PR #13)

  • @botharness/core:PersonaBot registry(原子写 bot.json、slug 唯一、记忆目录可配)、bot home、状态模型(Session 五态 → 聚合 + 三事件)、settings 命名空间与 provide('botharness')
  • 原 M1 脚手架迁入 packages/core;workspace→bot 解析降级为 IM 绑定助手。
  • 38 个测试全绿;三轴 code review(Standards / Spec / Test economy)修正后合入。

文档站

  • 采用 Nimbus(Astro 7)搭建 apps/docs,部署 Cloudflare Workers,域名 botharness.ai.dev 301)。
  • 架构与数据流持续维护于 docs/architecture/botharness-architecture.md,本页与站点由其自动同步。

输入以搜索…

↑↓ 导航↵ 选择Esc 关闭