@doubao-apps/ai 0.0.27 → 0.0.28

package/README.md

@@ -28,7 +28,7 @@ doubao-cli add context --agent claude
 your-project/
 ├── AGENTS.md          # AI Agent 主入口文档
 ├── CLAUDE.md          # Claude 专用入口（--agent claude 时生成）
-└── .ai/               # 详细文档目录
+└── references/        # 详细文档目录
     ├── guides/        # 开发指南
     ├── rules/         # 开发规则
     ├── examples/      # 代码示例
@@ -53,7 +53,7 @@ doubao-cli skills add doubao-apps-dev --agent claude-code --global
 ```text
 .claude/skills/doubao-apps-dev/
 ├── SKILL.md
-└── .ai/
+└── references/
 ```
 
 ### 查看和更新 Skills

package/dist/994.js

@@ -1,12 +1,12 @@
-import l from"node:module";let o=l.createRequire(import.meta.url);import{fileURLToPath as e}from"node:url";import{dirname as t}from"node:path";import*as s from"node:fs";import*as a from"node:path";import{__webpack_require__ as i}from"./rslib-runtime.js";i.add({"node:fs"(l){l.exports=s},"node:path"(l){l.exports=a},"../../ai/dist/cli.js"(l,s,a){var i=t(e(import.meta.url));let n=a("node:fs"),r=a("node:path"),c={amp:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},"kimi-cli":{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},replit:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},universal:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},antigravity:{projectPath:".agent/skills/",globalPath:"~/.gemini/antigravity/skills/"},augment:{projectPath:".augment/skills/",globalPath:"~/.augment/skills/"},claude:{projectPath:".claude/skills/",globalPath:"~/.claude/skills/"},"claude-code":{projectPath:".claude/skills/",globalPath:"~/.claude/skills/"},openclaw:{projectPath:"skills/",globalPath:"~/.openclaw/skills/"},cline:{projectPath:".agents/skills/",globalPath:"~/.agents/skills/"},codebuddy:{projectPath:".codebuddy/skills/",globalPath:"~/.codebuddy/skills/"},codex:{projectPath:".agents/skills/",globalPath:"~/.codex/skills/"},"command-code":{projectPath:".commandcode/skills/",globalPath:"~/.commandcode/skills/"},continue:{projectPath:".continue/skills/",globalPath:"~/.continue/skills/"},cortex:{projectPath:".cortex/skills/",globalPath:"~/.snowflake/cortex/skills/"},crush:{projectPath:".crush/skills/",globalPath:"~/.config/crush/skills/"},cursor:{projectPath:".agents/skills/",globalPath:"~/.cursor/skills/"},droid:{projectPath:".factory/skills/",globalPath:"~/.factory/skills/"},"gemini-cli":{projectPath:".agents/skills/",globalPath:"~/.gemini/skills/"},"github-copilot":{projectPath:".agents/skills/",globalPath:"~/.copilot/skills/"},goose:{projectPath:".goose/skills/",globalPath:"~/.config/goose/skills/"},junie:{projectPath:".junie/skills/",globalPath:"~/.junie/skills/"},"iflow-cli":{projectPath:".iflow/skills/",globalPath:"~/.iflow/skills/"},kilo:{projectPath:".kilocode/skills/",globalPath:"~/.kilocode/skills/"},"kiro-cli":{projectPath:".kiro/skills/",globalPath:"~/.kiro/skills/"},kode:{projectPath:".kode/skills/",globalPath:"~/.kode/skills/"},mcpjam:{projectPath:".mcpjam/skills/",globalPath:"~/.mcpjam/skills/"},"mistral-vibe":{projectPath:".vibe/skills/",globalPath:"~/.vibe/skills/"},mux:{projectPath:".mux/skills/",globalPath:"~/.mux/skills/"},opencode:{projectPath:".agents/skills/",globalPath:"~/.config/opencode/skills/"},openhands:{projectPath:".openhands/skills/",globalPath:"~/.openhands/skills/"},pi:{projectPath:".pi/skills/",globalPath:"~/.pi/agent/skills/"},qoder:{projectPath:".qoder/skills/",globalPath:"~/.qoder/skills/"},"qwen-code":{projectPath:".qwen/skills/",globalPath:"~/.qwen/skills/"},roo:{projectPath:".roo/skills/",globalPath:"~/.roo/skills/"},trae:{projectPath:".trae/skills/",globalPath:"~/.trae/skills/"},"trae-cn":{projectPath:".trae/skills/",globalPath:"~/.trae-cn/skills/"},windsurf:{projectPath:".windsurf/skills/",globalPath:"~/.codeium/windsurf/skills/"},zencoder:{projectPath:".zencoder/skills/",globalPath:"~/.zencoder/skills/"},neovate:{projectPath:".neovate/skills/",globalPath:"~/.neovate/skills/"},pochi:{projectPath:".pochi/skills/",globalPath:"~/.pochi/skills/"},adal:{projectPath:".adal/skills/",globalPath:"~/.adal/skills/"}};function d(){try{let l=o.resolve("@byted-doubao-apps/ai-assets/manifest");return r.dirname(l)}catch{return r.join(i,"..","dist")}}function g(){return r.join(d(),"skills")}function k(l){return l.startsWith("~/")?r.join(process.env.HOME||process.env.USERPROFILE||"",l.slice(2)):l}function p(l,o){if(!n.existsSync(l))throw Error(`Source directory not found: ${l}`);for(let e of(n.mkdirSync(o,{recursive:!0}),n.readdirSync(l,{withFileTypes:!0}))){let t=r.join(l,e.name),s=r.join(o,e.name);e.isDirectory()?p(t,s):n.copyFileSync(t,s)}}function u(l){let o={agent:null,global:!1};for(let e=0;e<l.length;e++)("--agent"===l[e]||"-a"===l[e])&&l[e+1]?o.agent=l[++e]:("--global"===l[e]||"-g"===l[e])&&(o.global=!0);return o}function h(l){let o=r.join(r.join(d(),"contexts"),"doubao-apps-dev"),e=process.cwd();if(!n.existsSync(o))throw Error(`Knowledge source not found. Run build first: ${o}`);let t=r.join(o,"AGENTS.md");n.existsSync(t)&&(n.copyFileSync(t,r.join(e,"AGENTS.md")),console.log("  ✓ AGENTS.md"));let s=r.join(o,".ai");if(n.existsSync(s)&&(p(s,r.join(e,".ai")),console.log("  ✓ .ai/")),"claude"===l){let l=r.join(o,"CLAUDE.md");n.existsSync(l)&&(n.copyFileSync(l,r.join(e,"CLAUDE.md")),console.log("  ✓ CLAUDE.md"))}console.log("\nAI context installed successfully.")}function P(l,o,e){if(!c[o])throw Error(`Unknown agent: "${o}". Supported agents: ${Object.keys(c).join(", ")}`);let t=r.join(g(),l);if(!n.existsSync(t)){let o=g(),e=n.existsSync(o)?n.readdirSync(o).join(", "):"(none)";throw Error(`Skill "${l}" not found. Available skills: ${e}`)}let s=c[o],a=e?s.globalPath:s.projectPath,i=e?r.join(k(a),l):r.join(process.cwd(),a,l);for(let e of(console.log(`Installing skill "${l}" for ${o}...`),console.log(`  Target: ${i}`),n.existsSync(i)&&n.rmSync(i,{recursive:!0,force:!0}),n.mkdirSync(i,{recursive:!0}),n.readdirSync(t,{withFileTypes:!0}))){let l=r.join(t,e.name),o=r.join(i,e.name);e.isDirectory()?(p(l,o),console.log(`  ✓ ${e.name}/`)):(n.copyFileSync(l,o),console.log(`  ✓ ${e.name}`))}console.log("  ✓ Done")}l.exports={runCli:function(l={}){let o=l.commandName||"doubao-ai",[e,...t]=process.argv.slice(2);if(!e||"--help"===e||"-h"===e)return void console.log(`
-${o} - Doubao Apps SDK AI 工具
+import l from"node:module";let e=l.createRequire(import.meta.url);import{fileURLToPath as o}from"node:url";import{dirname as s}from"node:path";import*as t from"node:fs";import*as a from"node:path";import{__webpack_require__ as i}from"./rslib-runtime.js";i.add({"node:fs"(l){l.exports=t},"node:path"(l){l.exports=a},"../../ai/dist/cli.js"(l,t,a){var i=s(o(import.meta.url));let n=a("node:fs"),r=a("node:path"),c={amp:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},"kimi-cli":{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},replit:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},universal:{projectPath:".agents/skills/",globalPath:"~/.config/agents/skills/"},antigravity:{projectPath:".agent/skills/",globalPath:"~/.gemini/antigravity/skills/"},augment:{projectPath:".augment/skills/",globalPath:"~/.augment/skills/"},claude:{projectPath:".claude/skills/",globalPath:"~/.claude/skills/"},"claude-code":{projectPath:".claude/skills/",globalPath:"~/.claude/skills/"},openclaw:{projectPath:"skills/",globalPath:"~/.openclaw/skills/"},cline:{projectPath:".agents/skills/",globalPath:"~/.agents/skills/"},codebuddy:{projectPath:".codebuddy/skills/",globalPath:"~/.codebuddy/skills/"},codex:{projectPath:".agents/skills/",globalPath:"~/.codex/skills/"},"command-code":{projectPath:".commandcode/skills/",globalPath:"~/.commandcode/skills/"},continue:{projectPath:".continue/skills/",globalPath:"~/.continue/skills/"},cortex:{projectPath:".cortex/skills/",globalPath:"~/.snowflake/cortex/skills/"},crush:{projectPath:".crush/skills/",globalPath:"~/.config/crush/skills/"},cursor:{projectPath:".agents/skills/",globalPath:"~/.cursor/skills/"},droid:{projectPath:".factory/skills/",globalPath:"~/.factory/skills/"},"gemini-cli":{projectPath:".agents/skills/",globalPath:"~/.gemini/skills/"},"github-copilot":{projectPath:".agents/skills/",globalPath:"~/.copilot/skills/"},goose:{projectPath:".goose/skills/",globalPath:"~/.config/goose/skills/"},junie:{projectPath:".junie/skills/",globalPath:"~/.junie/skills/"},"iflow-cli":{projectPath:".iflow/skills/",globalPath:"~/.iflow/skills/"},kilo:{projectPath:".kilocode/skills/",globalPath:"~/.kilocode/skills/"},"kiro-cli":{projectPath:".kiro/skills/",globalPath:"~/.kiro/skills/"},kode:{projectPath:".kode/skills/",globalPath:"~/.kode/skills/"},mcpjam:{projectPath:".mcpjam/skills/",globalPath:"~/.mcpjam/skills/"},"mistral-vibe":{projectPath:".vibe/skills/",globalPath:"~/.vibe/skills/"},mux:{projectPath:".mux/skills/",globalPath:"~/.mux/skills/"},opencode:{projectPath:".agents/skills/",globalPath:"~/.config/opencode/skills/"},openhands:{projectPath:".openhands/skills/",globalPath:"~/.openhands/skills/"},pi:{projectPath:".pi/skills/",globalPath:"~/.pi/agent/skills/"},qoder:{projectPath:".qoder/skills/",globalPath:"~/.qoder/skills/"},"qwen-code":{projectPath:".qwen/skills/",globalPath:"~/.qwen/skills/"},roo:{projectPath:".roo/skills/",globalPath:"~/.roo/skills/"},trae:{projectPath:".trae/skills/",globalPath:"~/.trae/skills/"},"trae-cn":{projectPath:".trae/skills/",globalPath:"~/.trae-cn/skills/"},windsurf:{projectPath:".windsurf/skills/",globalPath:"~/.codeium/windsurf/skills/"},zencoder:{projectPath:".zencoder/skills/",globalPath:"~/.zencoder/skills/"},neovate:{projectPath:".neovate/skills/",globalPath:"~/.neovate/skills/"},pochi:{projectPath:".pochi/skills/",globalPath:"~/.pochi/skills/"},adal:{projectPath:".adal/skills/",globalPath:"~/.adal/skills/"}};function d(){try{let l=e.resolve("@byted-doubao-apps/ai-assets/manifest");return r.dirname(l)}catch{return r.join(i,"..","dist")}}function g(){return r.join(d(),"skills")}function k(l){return l.startsWith("~/")?r.join(process.env.HOME||process.env.USERPROFILE||"",l.slice(2)):l}function p(l,e){if(!n.existsSync(l))throw Error(`Source directory not found: ${l}`);for(let o of(n.mkdirSync(e,{recursive:!0}),n.readdirSync(l,{withFileTypes:!0}))){let s=r.join(l,o.name),t=r.join(e,o.name);o.isDirectory()?p(s,t):n.copyFileSync(s,t)}}function u(l){let e={agent:null,global:!1};for(let o=0;o<l.length;o++)("--agent"===l[o]||"-a"===l[o])&&l[o+1]?e.agent=l[++o]:("--global"===l[o]||"-g"===l[o])&&(e.global=!0);return e}function h(l){let e=r.join(r.join(d(),"contexts"),"doubao-apps-dev"),o=process.cwd();if(!n.existsSync(e))throw Error(`Knowledge source not found. Run build first: ${e}`);let s=r.join(e,"AGENTS.md");n.existsSync(s)&&(n.copyFileSync(s,r.join(o,"AGENTS.md")),console.log("  ✓ AGENTS.md"));let t=r.join(e,"references");if(n.existsSync(t)&&(p(t,r.join(o,"references")),console.log("  ✓ references/")),"claude"===l){let l=r.join(e,"CLAUDE.md");n.existsSync(l)&&(n.copyFileSync(l,r.join(o,"CLAUDE.md")),console.log("  ✓ CLAUDE.md"))}console.log("\nAI context installed successfully.")}function P(l,e,o){if(!c[e])throw Error(`Unknown agent: "${e}". Supported agents: ${Object.keys(c).join(", ")}`);let s=r.join(g(),l);if(!n.existsSync(s)){let e=g(),o=n.existsSync(e)?n.readdirSync(e).join(", "):"(none)";throw Error(`Skill "${l}" not found. Available skills: ${o}`)}let t=c[e],a=o?t.globalPath:t.projectPath,i=o?r.join(k(a),l):r.join(process.cwd(),a,l);for(let o of(console.log(`Installing skill "${l}" for ${e}...`),console.log(`  Target: ${i}`),n.existsSync(i)&&n.rmSync(i,{recursive:!0,force:!0}),n.mkdirSync(i,{recursive:!0}),n.readdirSync(s,{withFileTypes:!0}))){let l=r.join(s,o.name),e=r.join(i,o.name);o.isDirectory()?(p(l,e),console.log(`  ✓ ${o.name}/`)):(n.copyFileSync(l,e),console.log(`  ✓ ${o.name}`))}console.log("  ✓ Done")}l.exports={runCli:function(l={}){let e=l.commandName||"doubao-ai",[o,...s]=process.argv.slice(2);if(!o||"--help"===o||"-h"===o)return void console.log(`
+${e} - Doubao Apps SDK AI 工具
 
 用法：
-  ${o} add context [--agent <agent>]       安装 AI 上下文到当前项目
-  ${o} update context                      更新已安装的 AI 上下文
-  ${o} skills add <skill1> [skill2...] --agent <agent>  安装一个或多个 skill 到指定 Agent
-  ${o} skills list                         查看可用 skills
-  ${o} skills update [--global]            更新所有已安装的 skills
+  ${e} add context [--agent <agent>]       安装 AI 上下文到当前项目
+  ${e} update context                      更新已安装的 AI 上下文
+  ${e} skills add <skill1> [skill2...] --agent <agent>  安装一个或多个 skill 到指定 Agent
+  ${e} skills list                         查看可用 skills
+  ${e} skills update [--global]            更新所有已安装的 skills
 
 选项：
   --agent <agent>    指定 AI Agent（如 claude、claude-code、cursor）
@@ -14,28 +14,28 @@ ${o} - Doubao Apps SDK AI 工具
 
 示例：
   # 安装 AI 上下文（通用）
-  ${o} add context
+  ${e} add context
 
   # 安装 AI 上下文（Claude 专用，额外生成 CLAUDE.md）
-  ${o} add context --agent claude
+  ${e} add context --agent claude
 
   # 更新已安装的 AI 上下文
-  ${o} update context
+  ${e} update context
 
   # 安装一个或多个 skill 到 Claude Code
-  ${o} skills add doubao-apps-dev quality-gate --agent claude-code
+  ${e} skills add doubao-apps-dev quality-gate --agent claude-code
 
   # 全局安装 skill
-  ${o} skills add doubao-apps-dev --agent claude-code --global
+  ${e} skills add doubao-apps-dev --agent claude-code --global
 
   # 查看可用 skills
-  ${o} skills list
+  ${e} skills list
 
   # 更新所有已安装的 skills
-  ${o} skills update
+  ${e} skills update
 
 支持的 Agents：
   ${Object.keys(c).join(", ")}
-`);if("add"===e){let[l,...o]=t;"context"!==l&&(console.error(`Unknown target: "${l}". Supported: context`),process.exit(1));let{agent:e}=u(o);console.log(`Installing AI context${e?` (--agent ${e})`:""}...`),h(e);return}if("update"===e){let l,e,s,[a]=t;"context"!==a&&(console.error(`Unknown target: "${a}". Supported: context`),process.exit(1)),l=process.cwd(),e=n.existsSync(r.join(l,"AGENTS.md")),s=n.existsSync(r.join(l,"CLAUDE.md")),e||s?(console.log("Updating knowledge base..."),h(s?"claude":null)):console.log(`No AI context found in current directory. Run \`${o} add context\` first.`);return}if("skills"===e){let[l,...e]=t;if("list"===l)return void function(){let l=g();if(!n.existsSync(l))return console.log("No skills available. Run build first.");let o=n.readdirSync(l,{withFileTypes:!0}).filter(l=>l.isDirectory()).map(l=>l.name);if(0===o.length)return console.log("No skills available.");for(let e of(console.log("Available skills:"),o)){let o=r.join(l,e,"SKILL.md");console.log(`  - ${e}${n.existsSync(o)?"":" (not built)"}`)}}();if("add"===l){let{agent:l,global:t}=u(e),s=[];for(let l=0;l<e.length;l++){let o=e[l];if("--agent"===o||"-a"===o)l++;else{if("--global"===o||"-g"===o)continue;s.push(o)}}for(let e of(0===s.length&&(console.error(`Usage: ${o} skills add <skill-name>... --agent <agent>`),process.exit(1)),l||(console.error(`--agent is required. Example: ${o} skills add doubao-apps-dev --agent claude-code`),process.exit(1)),s))P(e,l,t);return}if("update"===l){let{global:l}=u(e);!function(l){let o=g();if(!n.existsSync(o))return console.log("No skills to update. Run build first.");let e=n.readdirSync(o,{withFileTypes:!0}).filter(l=>l.isDirectory()).map(l=>l.name),t=0;for(let[o,s]of Object.entries(c)){let a=l?s.globalPath:s.projectPath,i=l?k(a):r.join(process.cwd(),a);for(let s of e)n.existsSync(r.join(i,s))&&(P(s,o,l),t++)}0===t?console.log("No installed skills found to update."):console.log(`
-Updated ${t} skill installation(s).`)}(l);return}console.error(`Unknown skills subcommand: "${l}". Use: add, list, update`),process.exit(1)}console.error(`Unknown command: "${e}". Run \`${o} --help\` for usage.`),process.exit(1)}}}});
+`);if("add"===o){let[l,...e]=s;"context"!==l&&(console.error(`Unknown target: "${l}". Supported: context`),process.exit(1));let{agent:o}=u(e);console.log(`Installing AI context${o?` (--agent ${o})`:""}...`),h(o);return}if("update"===o){let l,o,t,[a]=s;"context"!==a&&(console.error(`Unknown target: "${a}". Supported: context`),process.exit(1)),l=process.cwd(),o=n.existsSync(r.join(l,"AGENTS.md")),t=n.existsSync(r.join(l,"CLAUDE.md")),o||t?(console.log("Updating knowledge base..."),h(t?"claude":null)):console.log(`No AI context found in current directory. Run \`${e} add context\` first.`);return}if("skills"===o){let[l,...o]=s;if("list"===l)return void function(){let l=g();if(!n.existsSync(l))return console.log("No skills available. Run build first.");let e=n.readdirSync(l,{withFileTypes:!0}).filter(l=>l.isDirectory()).map(l=>l.name);if(0===e.length)return console.log("No skills available.");for(let o of(console.log("Available skills:"),e)){let e=r.join(l,o,"SKILL.md");console.log(`  - ${o}${n.existsSync(e)?"":" (not built)"}`)}}();if("add"===l){let{agent:l,global:s}=u(o),t=[];for(let l=0;l<o.length;l++){let e=o[l];if("--agent"===e||"-a"===e)l++;else{if("--global"===e||"-g"===e)continue;t.push(e)}}for(let o of(0===t.length&&(console.error(`Usage: ${e} skills add <skill-name>... --agent <agent>`),process.exit(1)),l||(console.error(`--agent is required. Example: ${e} skills add doubao-apps-dev --agent claude-code`),process.exit(1)),t))P(o,l,s);return}if("update"===l){let{global:l}=u(o);!function(l){let e=g();if(!n.existsSync(e))return console.log("No skills to update. Run build first.");let o=n.readdirSync(e,{withFileTypes:!0}).filter(l=>l.isDirectory()).map(l=>l.name),s=0;for(let[e,t]of Object.entries(c)){let a=l?t.globalPath:t.projectPath,i=l?k(a):r.join(process.cwd(),a);for(let t of o)n.existsSync(r.join(i,t))&&(P(t,e,l),s++)}0===s?console.log("No installed skills found to update."):console.log(`
+Updated ${s} skill installation(s).`)}(l);return}console.error(`Unknown skills subcommand: "${l}". Use: add, list, update`),process.exit(1)}console.error(`Unknown command: "${o}". Run \`${e} --help\` for usage.`),process.exit(1)}}}});
 //# sourceMappingURL=994.js.map

package/dist/contexts/doubao-apps-dev/AGENTS.md

@@ -82,7 +82,7 @@ my-doubao-app/
 
 页面/卡片目录下的入口文件必须命名为 **`index.tsx`**，样式文件为 **`index.scss`**。
 
-**详细规则** → [.ai/rules/dos-and-donts.md](.ai/rules/dos-and-donts.md)
+**详细规则** → [references/rules/dos-and-donts.md](references/rules/dos-and-donts.md)
 
 ---
 
@@ -127,7 +127,7 @@ export default definePage({
 });
 ```
 
-**开发指南** → [.ai/guides/component-development.md](.ai/guides/component-development.md)
+**开发指南** → [references/guides/component-development.md](references/guides/component-development.md)
 
 ### Widget（卡片）
 
@@ -170,9 +170,9 @@ export default defineWidget({
 });
 ```
 
-**开发指南** → [.ai/guides/component-development.md](.ai/guides/component-development.md)
+**开发指南** → [references/guides/component-development.md](references/guides/component-development.md)
 
-**基础示例对比** → [.ai/examples/component-basics.md](.ai/examples/component-basics.md)
+**基础示例对比** → [references/examples/component-basics.md](references/examples/component-basics.md)
 
 ---
 
@@ -184,10 +184,10 @@ export default defineWidget({
 
 | 任务类型 | 文档 | 适用场景 |
 |---------|-----------|---------|
-| 组件开发 | [component-development.md](.ai/guides/component-development.md) | Page 和 Widget 完整开发指南 |
-| 最佳实践 | [best-practices.md](.ai/guides/best-practices.md) | 代码规范、架构设计 |
-| 性能优化 | [performance-optimization.md](.ai/guides/performance-optimization.md) | 渲染优化、内存管理 |
-| 问题排查 | [troubleshooting.md](.ai/guides/troubleshooting.md) | 调试技巧、常见问题 |
+| 组件开发 | [component-development.md](references/guides/component-development.md) | Page 和 Widget 完整开发指南 |
+| 最佳实践 | [best-practices.md](references/guides/best-practices.md) | 代码规范、架构设计 |
+| 性能优化 | [performance-optimization.md](references/guides/performance-optimization.md) | 渲染优化、内存管理 |
+| 问题排查 | [troubleshooting.md](references/guides/troubleshooting.md) | 调试技巧、常见问题 |
 
 ---
 
@@ -195,9 +195,9 @@ export default defineWidget({
 
 完整的 Framework API（框架核心）和 Bridge API（系统能力）列表：
 
-- **[Framework API 快速参考](.ai/reference/framework-api-quick-ref.md)** - 核心 Framework API 速查
-- **[Open API 目录](.ai/reference/open-api/README.md)** - 公开可用的端能力（系统能力）目录与详细文档
-- **[组件库快速参考](.ai/reference/components-quick-ref.md)** - SDK 内置组件（Button、Switch、Swiper 等）
+- **[Framework API 快速参考](references/reference/framework-api-quick-ref.md)** - 核心 Framework API 速查
+- **[Open API 目录](references/reference/open-api/README.md)** - 公开可用的端能力（系统能力）目录与详细文档
+- **[组件库快速参考](references/reference/components-quick-ref.md)** - SDK 内置组件（Button、Switch、Swiper 等）
 
 包含：
 - **Framework API**：组件定义（definePage、defineWidget）、生命周期、状态管理
@@ -218,8 +218,8 @@ Lynx 组件库完整参考文档请访问官方文档：
 
 | 场景 | 示例文档 | 说明 |
 |-----|---------|------|
-| 组件基础 | [component-basics.md](.ai/examples/component-basics.md) | Page 和 Widget 基础示例对比 |
-| 常用模式 | [common-patterns.md](.ai/examples/common-patterns.md) | API 集成、状态管理、页面导航 |
+| 组件基础 | [component-basics.md](references/examples/component-basics.md) | Page 和 Widget 基础示例对比 |
+| 常用模式 | [common-patterns.md](references/examples/common-patterns.md) | API 集成、状态管理、页面导航 |
 
 ---
 
@@ -229,9 +229,9 @@ Lynx 组件库完整参考文档请访问官方文档：
 
 API 参考文档
 
-- **[Framework API](.ai/reference/framework-api-quick-ref.md)** - 核心 Framework API 速查
-- **[组件库](.ai/reference/components-quick-ref.md)** - SDK 内置组件速查
-- **[Open API](.ai/reference/open-api/README.md)** - 系统能力 API 目录与详细文档
+- **[Framework API](references/reference/framework-api-quick-ref.md)** - 核心 Framework API 速查
+- **[组件库](references/reference/components-quick-ref.md)** - SDK 内置组件速查
+- **[Open API](references/reference/open-api/README.md)** - 系统能力 API 目录与详细文档
 
 ### 依赖包
 
@@ -247,19 +247,19 @@ API 参考文档
 
 遇到问题？先查看故障排查指南：
 
-👉 **[故障排查指南](.ai/guides/troubleshooting.md)**
+👉 **[故障排查指南](references/guides/troubleshooting.md)**
 
 ### 最佳实践
 
 想要提升代码质量？查看最佳实践：
 
-👉 **[最佳实践指南](.ai/guides/best-practices.md)**
+👉 **[最佳实践指南](references/guides/best-practices.md)**
 
 ### 性能优化
 
 应用性能不佳？查看性能优化指南：
 
-👉 **[性能优化指南](.ai/guides/performance-optimization.md)**
+👉 **[性能优化指南](references/guides/performance-optimization.md)**
 
 ---
 
@@ -268,7 +268,7 @@ API 参考文档
 ```
 项目根目录/
 ├── AGENTS.md            # 主入口文档（AI Agent 必读）
-└── .ai/                 # 详细文档目录
+└── references/          # 详细文档目录
     ├── guides/          # 开发指南
     ├── rules/           # 开发规则
     ├── examples/        # 代码示例

package/dist/contexts/doubao-apps-dev/CLAUDE.md

@@ -10,18 +10,18 @@
 
 | 开发任务 | 参考文档 |
 |---------|---------|
-| 创建 Page（页面组件） | [.ai/guides/component-development.md](.ai/guides/component-development.md) |
-| 创建 Widget（卡片组件） | [.ai/guides/component-development.md](.ai/guides/component-development.md) |
-| 最佳实践 | [.ai/guides/best-practices.md](.ai/guides/best-practices.md) |
-| 性能优化 | [.ai/guides/performance-optimization.md](.ai/guides/performance-optimization.md) |
-| 问题排查 | [.ai/guides/troubleshooting.md](.ai/guides/troubleshooting.md) |
-| Framework API | [.ai/reference/framework-api-quick-ref.md](.ai/reference/framework-api-quick-ref.md) |
-| Bridge API / 系统能力 | [.ai/reference/open-api/README.md](.ai/reference/open-api/README.md) |
+| 创建 Page（页面组件） | [references/guides/component-development.md](references/guides/component-development.md) |
+| 创建 Widget（卡片组件） | [references/guides/component-development.md](references/guides/component-development.md) |
+| 最佳实践 | [references/guides/best-practices.md](references/guides/best-practices.md) |
+| 性能优化 | [references/guides/performance-optimization.md](references/guides/performance-optimization.md) |
+| 问题排查 | [references/guides/troubleshooting.md](references/guides/troubleshooting.md) |
+| Framework API | [references/reference/framework-api-quick-ref.md](references/reference/framework-api-quick-ref.md) |
+| Bridge API / 系统能力 | [references/reference/open-api/README.md](references/reference/open-api/README.md) |
 
 ## 知识库结构
 
 ```
-.ai/
+references/
 ├── guides/           # 开发指南（组件开发、最佳实践、性能优化、故障排除）
 ├── rules/            # 框架规则（dos-and-donts）
 ├── examples/         # 代码示例（组件基础、常用模式）