# 变更记录

## 1.7.0

### 新增

- 新增 `aios-product` 建筑行业产品经理 Skill，把已确认的产品方向转成产品体检、版本范围、PRD、优先级、验收指标、试点 / UAT 和设计 / 架构 / 交付交接。

### 调整

- 明确 Janus 的三种任务模式：`aios-ceo` 负责立项、商业边界和停损，`aios-product` 负责版本产品契约与反馈闭环，`aios-design` 负责界面任务和交互状态。
- 补齐 AIOS 总路由、runtime manifest、CLI 自动识别、项目模板、Feature 开发 Workflow 和公共发现元数据中的产品经理入口。
- 将 `aios-ceo` + `aios-arch` 固化为不强制插入 Product 的战略技术联合评审，并明确 CEO -> Product 的顺序交接、Product <-> Arch 的迭代握手、技术 HOLD 与项目停损的裁决边界。
- 版本同步到 1.7.0，覆盖 npm package、Gemini extension、Claude plugin、runtime manifest 和 CLI / MCP clientInfo。

### 验证

- `npm run validate:skills`
- `python -X utf8 C:\Users\white\.codex\skills\.system\skill-creator\scripts\quick_validate.py skills\aios-product`
- `npm run smoke:project`
- `npm test`
- `npm pack --dry-run --json`
- `git diff --check`

## 1.6.0

### 发布说明

本版本在 Knowledge Pack 与本地 Reference Runtime 主线之上，新增可复验的架构健康门禁和历史技术标 DOCX 母版保真改写流程。AIOS 现在既能把架构债治理为带基线、证据和受保护约束的机器可读结果，也能在成熟 Word 母版上按受控阶段完成技术标改写，避免把保真改写退化为从零生成。

### 新增

- 新增 `aios-arch-health` 架构健康 Skill、`architecture.health_scan` Capability、0.1 契约与 JSON Schema、参考分析器、项目 profile / 输入模板和自动化测试，用于输出可复验的架构事实、基线差分、棘轮门禁和 SARIF。
- 新增历史技术标 DOCX 母版保真改写 workflow，固定 `inspect-template -> collect-evidence -> plan-rewrite -> rewrite-in-place -> inspect-output -> revision-cycle -> release-candidate` 七步流程。
- 补齐技术标 DOCX 保真改写在 runtime manifest、Skill 路由、项目 workflow 模板、用户指南和公共技能说明中的发现入口。

### 调整

- 架构健康门禁新增证据来源、产物摘要、受保护约束和独立审批校验；只有可复验的 measured 新增或恶化债务可以硬阻断，推断项和未验证项继续进入人工解释。
- `aios-plan` 与 `aios-exec` 补充 Goal 连续推进、未上线边界收口、脏工作区保护、源仓库与安装缓存区分，以及高价值客户端资产的威胁模型和验证要求。
- 技术标写作入口明确区分“Markdown 工作母版从零写作”和“历史 DOCX 母版保真改写”，并继续保留资料来源、残留扫描、审核门禁和人工定稿边界。
- 版本同步到 1.6.0，覆盖 npm package、Gemini extension、Claude plugin、runtime manifest 和 CLI / MCP clientInfo。

### 验证

- `npm run validate:skills`
- `npm run validate:prompts`
- `npm run validate:knowledge-pack`
- `npm run smoke:project`
- `npm test`
- `npm pack --dry-run`
- `git diff --check`

## 1.5.1

### 发布说明

本版本是 v1.5.0 的维护修复版，保持 Knowledge Pack + 本地 Reference Runtime 主线不变，主要同步 npm patch 包元数据并收紧提示词评测与工程资料输入边界。

### 调整

- 版本同步到 1.5.1，覆盖 npm package、Gemini extension、Claude plugin、runtime manifest 和 CLI clientInfo。
- 提示词评测辅助脚本改为读取本地忽略配置，避免开发环境配置进入源码或发布包。
- 工程资料类提示词补充输入边界：资料应先在本地脱敏，未授权客户、人员、联系方式、证件、账号或完整内部原文不应直接进入实质分析。

### 验证

- npm run validate:prompts
- npm run validate:skills
- npm run test
- git diff --check
- npm pack --dry-run

## 1.5.0

### 发布说明

本版本把 AIOS 从“能写工程文档”推进到“能治理工程知识”。新增 Knowledge Pack 作为 AIOS 原生知识资产，把来源、授权、版本、标准、条文、实体、关系、lookup 规则、评估问题和人工复核状态编译为可查询、可评估、可由 Skill / Runtime 消费的工程知识包。

### 新增

- 新增 `templates/knowledge-pack/` 工程知识治理工作台模板。
- 新增 `templates/knowledge-pack-samples/scheme-review/` 端到端合成样板，覆盖 found / not_found / conflict / inapplicable / need_context。
- 新增 `archsight-aios knowledge:init`、`knowledge:validate`、`knowledge:compile`、`knowledge:inspect`、`knowledge:lookup` 和 `knowledge:eval`。
- 新增 `knowledge.norm_lookup` 本地 stdio MCP Reference Runtime，可查询编译后的 Knowledge Pack 并输出 Capability 仲裁证据。
- 新增 `prompts/evaluations/engineering-knowledge-pack-scorecard.json` 和 `npm run validate:knowledge-pack`，固定来源治理、版本适用性、条文结构、图谱追溯、Runtime 查询、eval gate 和人工复核边界。
- 新增 [v1.5.0 Knowledge Pack 与本地 Reference Runtime](docs/v1.5.0-knowledge-pack-runtime.md) 和 v1.5.0 release readiness 清单。
- 新增建筑行业自助试用指南 `docs/industry-user-trial-guide.md`，面向非开发者说明 WorkBuddy 安装、试用指令、资料脱敏、样例任务和人工复核边界。
- 新增短名任务型入口 `aios-tender`、`aios-tender-audit`、`aios-scheme` 和 `aios-scheme-audit`；原 `aios-commercial-*` 与 `aios-construction-*` 领域型入口继续保留原意。
- 扩充正式工程业务技能包：新增 `aios-contract-audit` / `aios-contract-draft`、`aios-daily` / `aios-daily-write`、`aios-meeting` / `aios-meeting-write`，分别覆盖合同审核与草拟、施工日报生成与复核路由、工程会议纪要生成与闭环路由。

### 调整

- `knowledge.norm_lookup` 从 declared interface 升级为 implemented reference runtime。
- `aios-knowledge`、`aios-runtime`、`aios-review` 和 `aios-construction-scheme` 增加 Knowledge Pack 使用、复核和发布门禁。
- `aios-tender-write` 和 `aios-scheme-write` 的默认审核门禁更新为 `aios-tender-audit` 与 `aios-scheme-audit`，旧流程仍可交回 `aios-commercial-tender` 与 `aios-construction-scheme`。
- RAG / GraphRAG workflow 明确行业知识输入优先治理为 Knowledge Pack。
- 版本升级到 `1.5.0`，同步更新 npm package、Gemini extension、Claude plugin、runtime manifest 和 CLI MCP clientInfo。

### 验证

- `npm run validate:knowledge-pack`

## 1.4.0

### 新增

- 新增 `aios-tender-write` 写作型 Skill，用于工程标书、技术标、投标响应章节生成 / 改写和历史标书素材复用；生成后必须交回 `aios-commercial-tender` 做响应性、废标风险、评分点缺口和人工复核门禁。
- 新增 `aios-scheme-write` 写作型 Skill，用于专项施工方案、施工技术措施和交底材料生成 / 改写和历史方案素材复用；生成后必须交回 `aios-construction-scheme` 做危险源、规范 / 计算书、专家意见和交底要点门禁。
- 新增 `templates/document-writing/` Markdown 工作母版，覆盖 `source-normalized.md`、`material-index.md`、`writing-brief.md`、`draft.md`、`review-notes.md` 和 `final.md`。
- 新增 `archsight-aios writing:init`，可在业务项目中一键创建标书 / 方案写作工作台；默认不覆盖已有工作文件。
- 新增 `archsight-aios writing:validate`，用于检查写作工作台的文件链、来源、历史素材复用、待补占位、审核门禁和人工定稿边界。
- `writing:init` 支持 `--sample`，可生成技术标和专项施工方案的端到端脱敏样板工作台。
- 新增 `prompts/evaluations/engineering-document-writing-fixtures.json` 及 `validate:document-writing-run-pack` / `build:document-writing-run-pack`，用于验证写作型 Skill 的脱敏 weak/basic 对照输入。
- 新增 `engineering-document-writing-scorecard.json`，固定来源链、素材复用、初稿可操作性、边界安全、审核门禁和交接可读性评分维度。
- 新增 `prompts/evaluations/skill-runtime/` 归档规范和 `validate:skill-runtime-evidence`，用于区分真实 Skill 触发、blocked 状态和 prompt paste 结果。
- 新增 Codex / WorkBuddy 写作型 Skill raw output 归档和 scorecard 复核记录，覆盖 `aios-tender-write` / `aios-scheme-write` 四个宿主样板 case。
- 新增 WorkBuddy-first 写作工作流快速使用说明、写作能力边界和 v1.4.0 release readiness 清单。

### 调整

- `aios` / `archsight-aios` 总入口、CLI 自动识别、manifest、Skill 路由和项目接入模板补充写作型 Skill。
- CLI Skill 自动识别改为对更具体的写作短语加权，减少“技术标生成 / 施工方案生成”误落到审核型 Skill 的概率。
- v1.4.0 发布门槛明确：Codex / WorkBuddy 写作型 Skill raw output 与 scorecard 复核已具备；版本号已同步，正式发布仍需 tag、push 和 GitHub Release。
- v1.4.0 路线图明确“工程文档生成、改写与复核闭环”：Markdown 是工作母版，Word / PDF / PPT 是交付格式；现有审核型 Skill 继续作为质量门禁。

## 1.3.2

### 发布说明

本版本修复 v1.3.1 后在不同宿主中出现的 Skill 遵从度不一致问题。重点强化“短指令触发 AIOS”时的默认输出契约：用户只说“用 AIOS 分析该文档”且没有要求摘要时，默认输出标准详版报告，而不是几段概括性摘要。

### 调整

- 版本升级到 `1.3.2`，同步更新 npm package、Gemini extension、Claude plugin、runtime manifest 和 CLI MCP clientInfo。
- `aios` / `archsight-aios` 总入口明确短指令默认走“标准详版报告”，路由后仍要展开专项 Skill 的主表、清单或台账。
- 工程业务管理 Skill 增加“标准详版报告与输出自检”约束，覆盖招投标、合同、施工日报、会议纪要、变更签证和专项施工方案。
- 各工程业务 Skill 的 `openai.yaml` 默认提示补充“不要压缩成摘要”“资料来源”“主分析表或台账”“资料缺口”“人工复核”“AI 不应下结论事项”和“输出自检”。
- Prompt 评估策略新增“宿主遵从度受控评测”，用于区分 WorkBuddy、Codex、Gemini、Antigravity 等宿主差异和模型能力差异。

### 验证

- `npm run validate:skills`
- `npm test`
- `git diff --check`
- `npm pack --dry-run`

## 1.3.1

### 发布说明

本版本聚焦使用者体验：用户只需要记住 `aios` / `archsight-aios` 总入口，AIOS 自动按资料类型分流到合适 Skill；同时把工程业务管理 Skill 的用户可见输出模板改为中文字段，减少 `Source Map`、`Arbitration`、`Evidence`、`Decision`、`Need verify` 等英文标签对业务用户的干扰。

### 新增

- 新增 `aios` 和 `archsight-aios` 顶层路由 Skill，支持“请用 aios skill 分析该文档”这类短指令触发资料类型识别和自动分流。
- 新增 `aios-compare` 用户侧对比 Skill，用于比较两份文档、两个版本或两个 AI 输出哪份更专业、更适合交付。

### 调整

- 版本升级到 `1.3.1`，同步更新 npm package、Gemini extension、Claude plugin、runtime manifest 和 CLI MCP clientInfo。
- 将 `aios-prompt-compare` 收紧为内部 Prompt 测试工具，仅在明确调用 `aios-prompt-compare` 时触发，避免普通“对比”任务误路由。
- 工程业务管理 Skill 输出模板统一中文化：`资料来源清单`、`证据仲裁`、`证据`、`工具结果`、`处理建议：可继续 / 需核验 / 转人工复核`。
- README、WorkBuddy 适配说明、Skill 总览、运行时路由和项目模板补充总入口、对比 Skill 与内部测试 Skill 的边界说明。

### 验证

- `npm run validate:skills`
- `npm test`
- `git diff --check`

## 1.3.0

### 发布说明

本版本把 AIOS 从通用建筑行业技能包进一步扩展为可评测、可对比、可初始化到项目上下文的工程业务管理与 Prompt 治理工具包。重点补齐工程商务、合同、施工日报、会议、变更签证和专项方案场景的基础提示词资产，并新增 prompt 对比与评测脚本，让团队可以用同一套 fixture、run pack、结果校验和 scorecard 判断提示词是否值得沉淀为正式 Skill。

### 新增

- 新增 `aios-prompt-compare` Skill，用于对比弱提示词、便携强提示词和真实 Skill runtime 输出，并把结果纳入质量准入判断。
- 新增工程业务管理基础提示词资产，覆盖招投标、合同履约、施工日报、工程会议、变更签证和专项施工方案。
- 新增 Hestia、Plutus、Themis 等工程业务协同角色入口，强化行政人事协同、商务造价财务内控、法务合规的边界说明。
- 新增 prompt 评测 fixtures、公开咨询样例、run pack 构建、结果校验、模型输出校验、scorecard 校验和分析脚本。

### 调整

- 版本升级到 `1.3.0`，同步更新 npm package、Gemini extension、Claude plugin、runtime manifest 和 CLI MCP clientInfo。
- `init` 相关模板和 CLI 能力增强，可更好地根据项目线索推断 AIOS 项目上下文、profile 和入口文件。
- README、quickstart、glossary、公共发现文档和 runtime 路由补充工程业务管理与 prompt 治理说明。
- `validate:skills` 扩展校验范围，覆盖新增 skill、manifest、npm metadata 和工程业务管理资产。

### 验证

- `npm run validate:skills`
- `npm run validate:prompts`
- `npm run validate:prompt-run-pack`
- `npm run validate:public-advisory-run-pack`
- `npm run validate:prompt-run-results`
- `npm run validate:prompt-outputs`
- `npm run validate:prompt-scorecard`
- `npm run doctor`
- `npm run smoke:project`
- `npm test`
- `npx skills add . --list`
- `npm pack --dry-run`

## 1.2.0

### 发布说明

本版本把 AIOS 的定位从单纯“建筑 AI 研发工具包”扩展为面向建筑行业知识工作从业者与 AI 研发团队的技能包。除了 BIM / IFC、RAG / GraphRAG、智能审图、Runtime 和代码治理，也覆盖招投标、合同履约、施工日报、工程会议、变更签证和专项施工方案等工程资料证据链工作。

### 新增

- 新增 WorkBuddy 支持：`npx @archsight/aios install --target workbuddy --scope user` 会把 `aios-*` skills 安装到 `~/.workbuddy/skills/`。
- `install --target all --scope user` 现在会同时安装 WorkBuddy skills。
- 新增 `adapters/workbuddy/README.md`，说明 WorkBuddy 安装位置、调用示例和维护边界。
- 新增公共 skill 发现支撑：`gemini-extension.json`、`.claude-plugin/plugin.json`、`.claude-plugin/marketplace.json`、`docs/PUBLIC_DISCOVERY.md` 和 `scripts/validate-skills.mjs`。
- `package.json` 增加 `agent-skills`、`skills-sh`、`gemini-cli`、`workbuddy`、`building-ai`、`project-evidence-work` 等检索关键词。

### 调整

- 版本升级到 `1.2.0`，同步更新 npm package、Gemini extension、Claude plugin 和 runtime manifest。
- About / marketplace / manifest 描述改为默认中文、附带英文检索短语：面向建筑行业知识工作从业者与 AI 研发团队。
- README 增加 WorkBuddy 安装位置、公共发现说明和发布前验证命令。

### 验证

- `npm run validate:skills`
- `npm test`
- `npx skills add . --list`
- `node --check scripts\validate-skills.mjs`
- `npm pack --dry-run`

## 1.1.0

### 发布说明

本版本把 AIOS 从“规则 / Skill / Workflow 工具包”扩展到可调用本地确定性工具证据的治理闭环。重点新增 Capability Registry、Capability Adapter 和仲裁协议，并与 `archsight-solver` 的本地 stdio MCP tools 对齐，让 Euclid / `aios-structural` 在结构力学任务中能够要求或调用梁、平面框架、平面桁架求解结果，而不是由 LLM 直接口算工程结论。

本版本同时完成开源许可证和商业边界调整，为后续公开发布、商业使用和二次分发提供更清晰的法律与责任边界。

### 新增

- 新增 Capability Registry、Capability Registry Schema 和本地 Capability Adapter 配置，定义工具权限、输入 / 输出契约、证据字段和阻断规则。
- 新增 `governance/arbitration-protocol.md`，按人工硬约束、确定性工具、项目事实、结构化知识和 Agent 判断的证据等级仲裁交付结论。
- 新增 `aios-structural` Skill 和 Euclid 结构力学路由，用于梁、荷载、边界条件、FEM 输入输出、结构计算工具链和签审风险评审。
- 新增 `archsight-aios capability:call` 本地调用闭环：校验 Agent / Skill 权限、校验输入 schema、调用 stdio MCP tool、校验输出证据契约并返回仲裁 Decision。
- 新增对 `archsight-solver` 本地 MCP tools 的 AIOS Capability 对接：
  - `solver.beam_deflection`
  - `solver.beam_deflection_serviceability_check`
  - `solver.frame_displacement`
  - `solver.truss_member_force`
- 新增 CLI 测试覆盖 Capability 调用、MCP tool 映射、未授权 Agent 拒绝和项目模板校验。

### 调整

- 项目许可证从 MIT 升级为 Apache-2.0。
- README 增加商业边界说明，明确商业使用、二次分发、商标 / 品牌、托管服务、专有素材、支持和交付责任不随开源许可证自动授权。
- README 增加本地调用 `archsight-solver` 的 Capability 示例，并避免写死个人机器路径。
- `aios-arch`、`aios-review`、`aios-runtime`、`aios-exec` 等 Skill 增加 Capability / Tool Result / Evidence / Decision 的证据链要求。
- 架构评审、Feature 开发和 RAG Pipeline workflow 增加 Capability-backed arbitration 要求。
- 结构力学挠度限值校核统一使用 `solver.beam_deflection_serviceability_check`，不再暴露容易误读为强度或稳定承载力校核的 `solver.beam_capacity_check` 命名，明确它是正常使用挠度校核。

### 兼容性说明

- `solver.beam_capacity_check` 未进入正式发布接口；新接入必须使用 `solver.beam_deflection_serviceability_check`。
- `archsight-solver` 仍是本地可选 Adapter，不是 AIOS 安装的强依赖。没有相邻 solver 仓库或未设置 `ARCHSIGHT_SOLVER_HOME` 时，Capability 调用会报告本地 adapter cwd 不存在。
- 当前 MCP 对接仅声明本地 stdio 调用，不开放远程 HTTP / SSE / Gateway 鉴权模型。

### 验证

- `npm test`
- `npm run doctor`
- `npm run smoke:project`
- `npm pack --dry-run`
- 真实本地 MCP smoke：`solver.beam_deflection`、`solver.beam_deflection_serviceability_check`、`solver.frame_displacement`、`solver.truss_member_force`

## 1.0.1

### 发布说明

本版本优化 AIOS 的适用性边界：AIOS 明确作为建筑行业增强层，而不是通用任务替代器。安装 AIOS 后，建筑行业相关任务应获得更专业的证据链、工程边界、验证路径和行业判断；普通非建筑任务不再被强制套用 BIM、IFC、规范、审图或工程证据链假设。

### 调整

- 为所有 `aios-*` Skill 增加统一的适用性门槛：只有项目 profile、项目上下文或任务事实明确涉及建筑行业语义时，才启用行业增强。
- 强化 `aios-ceo` 的深度评审能力：默认要求先取证再判断，区分工程进展、生产可信度和商业验证。
- 更新 Skill、Workflow、Agent 路由和项目模板，避免泛用工程任务被错误路由到 AIOS 行业增强流程。
- 同步 Codex、Gemini 和 Antigravity 用户级安装资产，使本地工具读取新版边界规则。

### 验证

- `npm test`
- `npm run doctor`
- `npm run install:user`

## 1.0.0

首个面向开源准备的版本。

### 发布说明

本版本发布 ArchSight AIOS 的首批规则、Skill、Workflow、Runtime 路由和项目接入模板，重点服务 BIM / IFC / Revit / CAD、施工视觉 AI、建筑规范知识库、GraphRAG、智能审图和 AI Coding 治理。它让 Codex、Claude Code、Gemini 和 Antigravity 2.0 等工具在建筑行业 AI 研发项目中读取同一套规则、上下文和验收要求。

本版本同时明确 `aios-design` 的行业边界：它不是通用视觉美化或前端设计技能，而是建筑行业平台界面方案评审技能，用于判断审图工作台、BIM Viewer、规范检索、报告复核、构件问题列表和数据看板是否能支撑审查、定位、复核、追溯和交付。

### 新增

- `archsight-aios` CLI，包含 `install`、`doctor`、`init`、`validate` 和 Hermes 校验命令。
- 项目接入模板，覆盖 `AGENTS.md`、`CLAUDE.md`、`GEMINI.md`、`AI_CODING_RULES.md` 和 `.ai/`。
- 三类项目 profile：BIM / CAD / Revit 平台、施工视觉 AI、RAG / GraphRAG 规范知识库。
- 面向业务专家的参与指南、快速上手、术语表、贡献说明、安全策略、行为准则和 MIT 许可证。
- `aios-design` 和 `design-review` workflow，支持实现前评审建筑行业平台界面方案、证据定位、复核追溯和前端实现交接。

### 调整

- README 改为外部读者优先，先说明用途、适用人群、三步开始、项目生成内容和常用命令。
- `package.json` 补充 repository、keywords、homepage、issue tracker 和 MIT license。
- `aios-design` 将原先偏通用的视觉细节检查，调整为面向建筑行业工作台的“界面决策清晰度”，强调任务入口、证据定位、复核动作、状态反馈、长任务进度、失败恢复和实现验收。
- `design-review` workflow 补强图纸定位、模型定位、审查结论、长任务和专家复核检查项，并明确不替代通用 `frontend-design` 或 `frontend-generation`。