# @conscience-technology/ctds 中文文档 规范地址：https://npmcn.com/package/%40conscience-technology/ctds/ 版本：0\.6\.3 npm 元数据更新时间：2026-10-27T09:11:30.471Z 中文译文更新时间：2026-11-10T15:58:07.633Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40conscience-technology/ctds 原文对照：https://npmcn.com/package/%40conscience-technology/ctds/?lang=original 项目主页：https://github.com/Conscience-Technology/CTDS#readme 源码仓库：https://github.com/Conscience-Technology/CTDS ## 关键信息（来自 npm 元数据） - 包体积（解压后）：3.2 MB，453 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=18 - 运行依赖：0 个 - peer 依赖：cmdk ^1\.1\.1，next \>=14\.0\.0 \<17\.0\.0，react \>=18\.2\.0 \<20\.0\.0，react-dom \>=18\.2\.0 \<20\.0\.0，lottie-react ^3\.1\.2，lucide-react ^1\.47\.0，@dnd-kit/core ^6\.3\.1，solar-icon-set ^2\.0\.1，@dnd-kit/sortable ^10\.0\.0，@dnd-kit/utilities ^3\.2\.2，@radix-ui/react-slot ^1\.3\.3，@phosphor-icons/react ^2\.1\.10，@radix-ui/react-toast ^1\.2\.24，react-aria-components ^1\.22\.1，@radix-ui/react-dialog ^1\.2\.0，@radix-ui/react-select ^2\.3\.7，@radix-ui/react-slider ^1\.6\.1，@radix-ui/react-popover ^1\.1\.23，@radix-ui/react-tooltip ^1\.2\.16，@radix-ui/react-accordion ^1\.3\.1，@radix-ui/react-context-menu ^2\.3\.7，@radix-ui/react-dropdown-menu ^2\.1\.25 - 首次发布：2026-10-08T07:27:26.523Z - 最新版本发布：2026-10-27T09:11:29.961Z - 近 30 天下载量：3408（2026-10-11 至 2026-11-09，npm 官方下载统计） - 已发布版本数：42（近 12 个月 42 个） ## 中文简介 CTDS — ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ ## 安装 ```sh npm install @conscience-technology/ctds ``` 也可以使用：`pnpm add @conscience-technology/ctds`、`yarn add @conscience-technology/ctds`、`bun add @conscience-technology/ctds` ## README # 数字 安装并上载CTDS的CLI,即混合设计系统. ## 所需资源 - 节点.js 18+ - A Next.js App 路由器项目(一个 `app/` 或者说 `src/app/` 目录) ### 兼容性和核查 CLI 宣布节点.js 18+, 反应 `>=18.2 <20`下一个.js `>=14 <17` 兼容性。 这些是宣布的相容范围,而不是一个经过充分测试的版本矩阵. 安装当前的目标 Next.js App Router; Vite 尚未被验证为安装目标. Repository CI使用Node.js 24(包括测试中的本土类型Script执行)和准确的Next.js/React版本 `web/package-lock.json`它运行林特、源码/登记/目录检查、单元测试、TypeScript、文档建设、闸门集成和孤立的柏油球安装。 套装烟雾测试核实了套装资产;它们尚未证明每个申报的同级版本都有全新的消费者应用程序。 扩大的消费者/版本测试另行计划. 发行门使用精确的Playwright Chromium版本并运行Core键盘/状态/轴/回流测试. Ubuntu CI在烟雾模式下制作精确的模板;一个单独的macOS 26 arm64任务比较了经过审查的Core和模板像素基线,并在失败时保留可视的diffs/跟踪. 基线使用定型OS倒置字体,远程请求被屏蔽,并被平台/建筑相隔. 基线缺失。 这些检查不会取代真实的屏幕阅读器或下载-webfont审查. 见 `web/tests/quality/README.md` 用于命令和范围. **自动下一个.js 16相容修补.** 这个 `turbopack.rules["*.css"] + @tailwindcss/turbopack` 组合 `create-next-app@latest` 发射绕过涡轮包的内置闪电 CSS CSS 模块路径,这使得 `.module.css` 分类名称解析到 `undefined`。 。 。 . `ctds init` 探测到这个和 **自动**数字 : 1. 删除 `turbopack.rules["*.css"]` 块从 `next.config.ts` 2. 创建新 `postcss.config.mjs` 并登记 `@tailwindcss/postcss` 插件 3. 打印控制台倒置 解释如何删除 `@tailwindcss/turbopack` 在接下来的15个LTS项目上,这些改动都没有被应用,设置工作是按原样进行的. ## 安装( 终端用户) ```bash cd my-next-app npx @conscience-technology/ctds init ``` 什麽 `init` 是否为: 1. 检测项目(检查) `package.json` 加一个 `app/` 目录) 2. 复制这些资产: - `components/` → `components/ctds/` (或 `src/components/ctds/`(中文(简体) ) (可重复使用的组件加 **`tokens.css`** 带有字体、符号和每个轴选择器) - `prompts/` → `prompts/` - `.claude/skills/ctds/` → `.claude/skills/ctds/` 3. 创建 `app/ctds/page.tsx` (登机路线) 4. 印刷品 **两个人工步骤** 转到控制台 : - 添加 `@import "../components/ctds/tokens.css";` 到顶端 `app/globals.css` - 环绕 `app/layout.tsx` 与 `` 安装后 : ```bash npm run dev # Open http://localhost:3000/ctds, finish onboarding, click "Apply" ``` 点击“ Apply” 将两个文件写入工程根 : - `ctds.config.json`: 轴值。 由AI代理商(Claude Code和朋友)和 `ThemeController`。 。 。 . - `DESIGN.md`:主题和轴的散文摘要. 由人类和AI共同阅读. **提交两个文件 .** 其他开发商和AI代理商需要阅读. ## 选项 ```bash npx @conscience-technology/ctds init # default npx @conscience-technology/ctds init --dry # print planned writes without touching disk npx @conscience-technology/ctds init --force # overwrite existing files ``` 调试 : ```bash CTDS_DEBUG=1 npx @conscience-technology/ctds init ``` ## 地方发展(捐助者) 为了编辑和测试CTDS repo内部的CLI: ```bash cd packages/ctds-cli npm link # symlink the `ctds` binary globally cd /tmp/test-next-app # a Next.js project to test against ctds init --dry # assets are pulled from the CTDS repo directly (no bundle step needed) ``` 何时 `assets/components` 失踪了, `getAssetSources()` 自动倒回还原根 (单位:千美元)`../../web/components`, (中文(简体) ), `../../prompts`, (中文(简体) ), `../../.claude/skills/ctds`) (中文(简体) ). ## 发布 从寄存器根 : ```bash npm run check:release npm run pack:cli npm run verify:cli-tarball ``` `pack:cli` 创建前重生资产 `packages/ctds-cli/ctds-package.tgz`. 核查安装了精确的线下沥青并检查清单投影、公共出口/即时、目录、WIP排除和私人食谱界限。 Tag Plash 运行与 PR 相同的要求的质量工作流程,然后包装,校验,并发布已禁用寿命周期脚本的柏克球. 不在核查和公布之间重新包装. 安装测试浏览器 `cd web && npx playwright install chromium`。用于本地模板烟雾检查,设置 `CTDS_VISUAL_MODE=smoke`;没有烟雾模式,经过审查的特定平台像素比较运行. 根部保持组件状态和稳定的ID `component-manifest.json`。在有意变更后,运行 `npm run build:registry`;运行时间注册和目录生成. 内部运行时间帮助器仍被安装,但被排除在UI目录之外. ## 已知差距(在端到端阶段2前已解决) **现状.** 内幕 `/ctds` 应用流程(第1阶段)工程。 运行 `ctds init` 在一个单独的Next.js项目(第2阶段)中,用来弥补以下差距。 每一个问题都得到了解决. ### ~1\. 联合国. `tokens.css` 未取出~ (已解决2026-10-07) 符号和轴选择器块(1至718行)已移出 `web/app/globals.css` 输入 `web/components/tokens.css`,包括字体加载。 在CLI复制资产后,单曲 `@import "../components/ctds/tokens.css";` 在顶端 `app/globals.css` 使 CTDS 完全活动. ### ~2\. 联合国. `ThemeController` 引用 `web/app/data.ts`~ (已解决2026-10-07) `web/app/data.ts` 被批发移动到 `web/components/_data.ts`,同时包含轴类型和预设数据。 每个进口商(Theme Captain、登机轴板、图标等)现在都指向 `@/components/_data` 或者说 `../_data`因此复制 `components/` 自动携带数据文件. ### ~3\. 所复制的部件 `@/components/*` 别名~ (已解决2026-10-07) 全体 `@/components/` 进口 `components/` 被重写到相对路径( e)`../`) (中文(简体) ). 这个 `@/lib/cn` 财务报告和审定财务报表 `@/lib/color` 水电费移至 `components/_cn.ts` 财务报告和审定财务报表 `components/_color.ts` 以及所有与相对进口相关的参考文献。 复制的树现在不管消费者项目的tsconfig别名如何都有效. ### ~4.四. `OnboardingPage` 导出形状~ (已解决2026-10-07) 整个登机UI从 `web/app/onboarding/` 改为 `web/components/Onboarding/`。 。 。 . `OnboardingPage` 现在是一个命名导出。 CTDS雷波号 `/onboarding` 路由仍然通过默认出口包装程序运行. `ThemeController` 财务报告和审定财务报表 `axisOptions` 移动到下面 `web/components/` 我也一样。 复制的项目导入通过 `../../components/ctds/Onboarding`。 。 。 . ### ~5\. 依赖兼容性~ (已解决2026-10-07) 现在的CLI读消费者 `package.json` 文档和打印 an `npm install ...` 命令任何缺失的 CTDS 运行时软件包。 见 `CTDS_RUNTIME_DEPS` 内 `src/utils/deps.js`. 端到端测试通过"下16"和"回放"18.3. ### ~6\. 服务器动作 `process.cwd()` 假设~ (已解决2026-10-07) `findProjectRoot()` 内 `actions.ts` 现在从当前工作目录上走出来并选择 **最外侧目录** 包含 `package.json`。这解决了在repo测试案例(web/ vs root)和端到端测试项目的右根. * * * ## 已知小缺口(在端到端测试中发现,无阻断) ### 7\. 联合国. `.visually-hidden` 全球效用(已解决) `SelectableCard` 参考文献 `className="visually-hidden"`但那个班级只住 `globals.css` 因此没有复制。 它现在生活在一个新的 `web/components/_utils.css` 存档 `tokens.css` 车通过 `@import "./_utils.css"`。本地收音机和复选框输入现已正确隐藏. ### 8\. 联合国. `web/public/onboarding/*.png` 未复制( 已解决) 登入主题徘徊预览( O)`pure.png`, (中文(简体) ), `spare.png`, (中文(简体) ), `expressive.png`)被添加到复制计划. 捆绑者`bundle-assets.mjs`)和后退(`getAssetSources`两者均包括 `public/onboarding`。 。 。 . * * * ## 端到端测试结果 (2026-10-07) 小兰 `node bin/ctds.js init` 在新的 Next.js 16 工程中,遵循 CLI 的手动步骤,打开 `/ctds`,并点击"Apply". - 复制资产`components/ctds/`, (中文(简体) ), `prompts/`, (中文(简体) ), `.claude/skills/ctds/`, (中文(简体) ), `public/onboarding/`(中文(简体) ) - `/ctds/page.tsx` 创建 - 手动设置已打印( globals.css 导入,布局.tsx 包装, npm 安装道克) - Dev 服务器已正确渲染( 辐射、 标题、 背景) - 应用已写 `ctds.config.json` 财务报告和审定财务报表 `DESIGN.md` 到测试项目根 - `findProjectRoot()` 选择 cwd (`/private/tmp/ctds-e2e`(按预期) * * * ## 许可证 麻省理工学院 ## 常见问题 ### @conscience-technology/ctds 是什么？ CTDS — \+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+\+ ### 如何安装 @conscience-technology/ctds？ 在项目目录运行 npm install @conscience-technology/ctds，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=18\.2\.0 \<20\.0\.0）、react-dom（\>=18\.2\.0 \<20\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 ctds，可以用 npx ctds 直接运行。 ### @conscience-technology/ctds 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/conscience-technology\_\_ctds 是否存在。 ### @conscience-technology/ctds 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @conscience-technology/ctds 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @conscience-technology/ctds 可以商用吗？ @conscience-technology/ctds 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @conscience-technology/ctds 的下载量有多少？ 根据 npm 官方下载统计，@conscience-technology/ctds 在 2026/10/11 – 2026/11/09 这 30 天内被下载 3,408 次，日均约 114 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @conscience-technology/ctds 还在维护吗？ 最新版本 0\.6\.3 发布于 2026/10/27（14 天前）；至今共发布 42 个版本，其中过去 12 个月发布了 42 个；首次发布于 2026/10/08。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。