Birdview v0.2.0

中文

用 Birdview 来改变开发的流程！真正地从关注代码到关注架构！解决 AI coding 的黑盒！

• 增加 Codex、Claude Code 的统一 skills CLI 安装说明，以及 DeepSeek Harness 原生技能目录安装适配。
• 模式命令新增 --agent codex|claude-code|deepseek，分别管理对应的 AGENTS.md 或 CLAUDE.md。
• 新增只读 doctor，检查依赖、模板资源和示例渲染。
• 保留自动默认和显式按需配置，中英文文档同步。

安装后在技能目录运行 npm ci 和 node scripts/birdview.mjs doctor。请保留完整源码目录。详见中文安装指南。

已通过 48 项测试、示例校验、可复现示例构建、3 项浏览器检查和 18 对文档检查；已验证临时目录的 skills CLI 安装及 doctor。未进行 Claude Code、DeepSeek Harness 实际会话触发的端到端验证。

English

Use Birdview to change the development workflow: shift attention from code to architecture and open up the AI coding black box.

• Document shared skills CLI installation for Codex and Claude Code, plus native skill-directory installation for DeepSeek Harness.
• Add --agent codex|claude-code|deepseek to mode commands, selecting the corresponding AGENTS.md or CLAUDE.md.
• Add read-only doctor checks for dependencies, template assets and example rendering.
• Preserve the auto default and explicit on-demand settings; synchronize bilingual documentation.

Run npm ci and node scripts/birdview.mjs doctor inside the installed skill directory. Keep the complete source bundle. See the installation guide.

Verified: 48 tests, example validation, reproducible demo build, 3 browser checks, 18 documentation pairs, and a temporary skills CLI installation followed by doctor. Claude Code and DeepSeek Harness live-session activation has not been tested end to end.

Birdview displays agent-declared activity; it does not independently observe edits or enforce the workflow. GitHub source distribution only; no npm publication.

Full changelog

Birdview v0.1.1

Birdview 0.1.1

English

简化查看器品牌区域，保持画布工具可见，按视图显示活动历史，并明确指引步骤状态。工作区保留一条页眉分隔线。

新增 DeepSeek Harness 示例，包含双语架构数据和模拟会话时间线任务。这是文档概览，不是经过源码审计的架构或已实现功能。

按照安装指南安装发布源码包，然后运行 npm ci。本版本通过 GitHub 分发，不发布到 npm。

验证结果记录在 GitHub 发布说明中。Birdview 展示声明式快照，不独立观测代码改动；示例中的修改和验证阶段均为虚构。

Birdview 0.1.1

中文

Simpler viewer branding, visible canvas controls, view-specific activity history and explicit guide step states. The workspace now retains one header divider.

The new DeepSeek Harness example includes bilingual architecture data and a simulated session-timeline task. It is a documentation overview, not a verified source audit or implemented feature.

Install the release source archive using the installation guide, then run npm ci. This release is distributed on GitHub, not npm.

Validation results are recorded in the GitHub release. Birdview displays declared snapshots, not independently observed edits; the example's editing and verification phases are fictional.

Validation / 验证：npm ci (0 vulnerabilities), 46 tests passed, examples validated, 17 documentation pairs verified, demo build passed; viewer, guide and viewport browser checks passed (Chinese/English, desktop/mobile).
Install / 安装：https://github.com/Qiuner/birdview/blob/v0.1.1/docs/installation.md

Birdview v0.1.0

Birdview v0.1.0

Transform your development workflow with Birdview! Shift your focus from code to architecture—and break open the black box of AI coding!

See AI changes before they happen. Birdview is an MIT-licensed skill that shows planned changes on an evidence-linked architecture map.

Features

• Standalone HTML with architecture, changes and side-by-side comparison views.
• Module evidence, ownership, dependencies, activity history and guided walkthroughs.
• Chinese and English controls, documentation and bird branding.
• Schema and semantic validation with explicit module classifications.
• Auto and on-demand modes; the distributed skill defaults to auto, while explicit project settings take precedence.

Install

Download the source ZIP below and follow the installation guide. Requires Node.js 18 or newer and npm ci in the skill directory. This release is not published to npm.

Verification

Release commit: 39febad2439161900f70b8bf8ba7422daddfbc94.

• GitHub CI passed on Windows/Linux with Node.js 18/24.
• Local clean dependency installation, 44 tests, 15 documentation pairs and example validation passed.
• All three browser check scripts passed, covering viewer behavior, Chinese/English guides and desktop/tablet/mobile viewport containment.
• Rebuilding the demo produced no changes. Dependency audit reported zero known vulnerabilities.
• Fresh agent-session activation and existing-map reuse were not independently acceptance-tested for this release.

Limitations

Activity is agent-declared, not independently observed. Modes guide the agent; they do not intercept writes or guarantee compliance. Updates require regenerating HTML and refreshing the browser. Examples are fictional. A completed event does not prove checks passed.

---

中文说明

用 Birdview 来改变开发的流程！真正地从关注代码到关注架构！解决 AI coding 的黑盒！

先看清 AI 改什么，再让它动手。Birdview 首版提供带源码证据的架构图、变更高亮、并排对照、模块详情、活动历史和使用指引，采用 MIT 许可证。

支持中英文界面与文档。分发版本默认自动模式，项目显式的按需设置优先。下载下方源码压缩包，按照安装指南安装；需要 Node.js 18+，并在技能目录执行 npm ci，未发布到 npm。

发布提交为 39febad2439161900f70b8bf8ba7422daddfbc94。Windows/Linux、Node.js 18/24 的 GitHub CI 通过；本地干净安装、44 项测试、15 对双语文档、示例校验及三组浏览器检查通过。演示重建无变化，依赖审计无已知漏洞。本版未独立完成全新 Agent 会话触发与已有地图复用的验收。

活动由 Agent 声明，模式不强制拦截写入或保证遵守。更新需要重新生成 HTML 并刷新浏览器；示例为虚构内容，完成事件不代表测试通过。