# @astrale-domains/issues 中文文档

规范地址：https://npmcn.com/package/%40astrale-domains/issues/

版本：0\.6\.6
npm 元数据更新时间：2026-11-07T02:22:18.525Z
中文译文更新时间：2026-11-07T00:55:09.694Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40astrale-domains/issues
原文对照：https://npmcn.com/package/%40astrale-domains/issues/?lang=original
项目主页：https://github.com/astrale-os/domains#readme
源码仓库：https://github.com/astrale-os/domains

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：154 kB，170 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=24
- 运行依赖：1 个
- peer 依赖：@astrale-os/sdk \>=0\.6\.0-beta\.62 \<1\.0\.0
- 首次发布：2026-08-26T13:09:40.215Z
- 最新版本发布：2026-11-07T02:22:18.270Z
- 近 30 天下载量：4131（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：48（近 12 个月 48 个）

## 中文简介

`issues.astrale.ai` 拥有协作项目,编号为"问题","评论"和"项目-局部标记". 它是一个Astrale应用,与Schema Policy,接收器方法,原子突变,以及收件箱的第一个壳视图.

## 安装

```sh
npm install @astrale-domains/issues
```

也可以使用：`pnpm add @astrale-domains/issues`、`yarn add @astrale-domains/issues`、`bun add @astrale-domains/issues`

## README

# 问题领域

`issues.astrale.ai` 拥有协作项目,编号为"问题","评论"和"项目-局部标记". 它与Schema政策、接收方法、原子突变和 收件箱-第一贝壳视图.

图表Schema 仅依赖于 Kernel: 协作边缘目标为任意 `Identity` 子类型. Shell是一个前端集成,而不是被钉住的Schema依赖或核心组数据的来源.

```text
Project
  owned by one Identity; shared with member Identities
  key, name, optional description, private owner/member execution index and nextIssueNumber, archived
  contains Issues and Tags

Issue
  immutable reference; title (100 characters); optional Markdown description (50,000 characters)
  status: open | accepted | resolved | deferred | closed
  priority: 0..4; optional assignee; optional acyclic parent; Tags

Comment
  body; immutable author; belongs to one Issue

Tag
  name; Project-local slug; optional color; belongs to one Project
```

公共可调用表面保持变异接收器的拥有;呼叫者观察项目、问题和 根据自己的权限阅读该图时的评论:

```text
Project.create
Project.update | addMember | removeMember | createIssue | receiveReport | createTag | archive
Issue.update | edit | transition | assign | setTags | setParent | addComment | archive
Comment.edit | delete
Tag.edit | delete
```

`Tag.delete` 通过连接的2 046个问题(目前得到支持的Kernel),仍是一个原子突变 封装和节点清除后执行上限。 大一点 标记必须首先从 足够的问题通过 `Issue.setTags`;行动明确拒绝 (单位:千美元)`TAG_TOO_LARGE_TO_DELETE`)而不是提交带有后端依赖的超大突变 失败.

`Project.create` 需要认证。 项目的业主和成员观察项目及其 自行授权通过图表发布和评论。 一个记者观察自己 问题相同:从身份到 `issue_reported_by`,然后每个问题的评论. 项目负责人管理元数据、成员、标签、, ; 所有人和成员对问题作出贡献; 问题记者编辑其标题和 描述通过 `Issue.edit` 并存档;只有注释作者编辑或删除它. 优先权、地位、, 任务、标记、父和注释仍为协作者操作。 问题及其评论是: 通过调用者拥有的或已经加入的项目可见,也可以通过调用者的记者看到。 删除一个 身份,例如将拥有域的域名解开,只去除其域名 `issue_reported_by`, (中文(简体) ), `comment_authored_by` 财务报告和审定财务报表 `project_owned_by` 边缘:问题、评论和项目保持不变 他们的 `reporterId`, (中文(简体) ), `authorId` 财务报告和审定财务报表 `ownerId`其所有人被删除的一个项目保留其成员, 作者被删除的评论 更长时间的编辑或删除.

一个问题的标题是它的内核 `Named` 名称,包含100个字符。 它的描述是 问题自主 `body`,因为内核 `Descriptable` 只有1000个字符。 所描述的问题 在此之前 `body` 将描述保存在 `Descriptable` 直至下一次修订时 `body`; 读者接受 `body` 首先,然后是 `Descriptable` 说明。 标题和说明 存储时没有包围白空间。 之前每个可调用者拒绝较长的标题或描述 它运行,并拒绝空白标题或修改,因为该标题或修订没有指定已声明错误的字段.

所有权、成员资格、报告、分配和著作权仍然是图表化的政策事实。 这个 拥有 Project, Project, issue, 或 注释 也可以私下存储相应的身份标识, 更新于 与每个边缘相同的原子突变 因此,查询和行动可以验证当前 协作状态,不要求授权 每一种可能的具体身份子类型 另一个域. 这些私人执行领域不是第二个公共模式,绝不取代政策边缘.

`Project.receiveReport` 是Admin等可信集成的独所有者录入。 拥有者 供应经核实的 `reporterId`,不透明 `requestId`, (中文(简体) ), `title`, (中文(简体) ), `body`,可选结构 `context`。公共管理员的外观必须来自记者的认证;普通发件人 不得获得这种特权所有者的能力或参加项目.

一个原子突变分配数字,创建"问题"和"记者/娱乐"边缘,保留 报告原文与收到原文完全相同,并用其修剪的机体描述了这一问题。 查询 v7 守卫围栏 准确的项目/记者/请求三分之一。 内容相同的重试返回正本 `{ id, reference }`, (中文(简体) ), 即使经过分解编辑或存档;在同一密钥下更改的内容也会被拒绝. 独立 身份识别文件仍为独立报告。 已知的反证/关键辩词经过8次重审; 未知结果传播,所以发送者必须保留原始有效载荷和密钥直至确认. 杜威可来自图收和原子先决条件.

背景描述当前的客户端观察,与可变的问题文本相分离. 缺少版本和 实例坐标未知。 创建报告使发件人成为问题记者,其中 (b) 它不给予项目成员资格,也不允许使用其他问题或标记. 通用域无管理依赖. 收到报告后,没有进行自动分类, 重复匹配,或背景处理.

其他的创作方法保留了现有的重试语义. 设置式变化自然地趋同; 通过原子突变的前提条件来拒绝同步编辑.

挂载的视图默认为有队列进度和键盘或按钮的有重点的开关信箱 导航 接受的工作有专门的讨论视图,而浏览过滤可见的问题 在服务器上一次读取一个页面。 搜索时将“问题”读取至今 并说,当更多的可能匹配。 房间的元数据抽屉暴露了近距离 德弗, 解析并接受区分动作加优先级、任务、标记和母控 模糊了主视图. 四个结果显示并尊重 `C`, (中文(简体) ), `D`, (中文(简体) ), `R`,以及 `A` 键盘 用户不输入时的快捷键。 选定的问题描述及其评论线索仍保留在以下 收件箱作为Markdown的连续对话,带有严格的美人鱼图. 项目、问题和标签 项目成员管理仍为API第一.

## 发展

依赖变化必须同时刷新 `issues/pnpm-lock.yaml` 和工作空间 `pnpm-lock.yaml`· ; 仓库 CI 用被冻结的锁文件安装后者.

```bash
pnpm install
pnpm typecheck
pnpm test
pnpm lint
pnpm frontend:build
pnpm build
pnpm package
```

通过语义导入源域概念 `@astrale-os/sdk/*` 外观和拥有否 `.spec` 树.

## 常见问题

### @astrale-domains/issues 是什么？

issues\.astrale\.ai 拥有协作项目,编号为"问题","评论"和"项目-局部标记"\. 它是一个Astrale应用,与Schema Policy,接收器方法,原子突变,以及收件箱的第一个壳视图\.

### 如何安装 @astrale-domains/issues？

在项目目录运行 npm install @astrale-domains/issues，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@astrale-os/sdk（\>=0\.6\.0-beta\.62 \<1\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @astrale-domains/issues 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @astrale-domains/issues 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @astrale-domains/issues 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=24。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @astrale-domains/issues 可以商用吗？

@astrale-domains/issues 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @astrale-domains/issues 的下载量有多少？

根据 npm 官方下载统计，@astrale-domains/issues 在 2026/10/07 – 2026/11/05 这 30 天内被下载 4,131 次，日均约 138 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @astrale-domains/issues 还在维护吗？

最新版本 0\.6\.6 发布于 2026/11/07（今天）；至今共发布 48 个版本，其中过去 12 个月发布了 48 个；首次发布于 2026/08/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。