@dsh-workbench/shared 1.1.0 → 1.1.2

package/dist/i18n/zh.d.ts

@@ -297,12 +297,19 @@ export declare const zh: {
     readonly 'panels.discover.addingSource': "正在添加…";
     readonly 'panels.discover.addFirstSource': "添加索引源";
     readonly 'panels.discover.removeSource': "移除";
-    readonly 'panels.discover.removeSourceNamed': "移除 {url}";
-    readonly 'panels.discover.useSource': "使用";
-    readonly 'panels.discover.useSourceNamed': "使用 {label}";
-    readonly 'panels.discover.sourceCurrent': "当前使用";
+    readonly 'panels.discover.removeTitle': "移除这个索引源？";
+    readonly 'panels.discover.removeBody': "会把「{label}」从这份列表里移除；仓库本身不会被删，之后还能再添加。";
+    readonly 'panels.discover.sourceActions': "「{label}」的操作";
+    readonly 'panels.discover.sourceStateWritable': "可发布";
+    readonly 'panels.discover.sourceStateReadOnly': "仅读取模块列表";
+    readonly 'panels.discover.sourceEnable': "设为可发布";
+    readonly 'panels.discover.sourceDisable': "设为只读";
+    readonly 'panels.discover.sourceWorking': "设置中…";
+    readonly 'panels.discover.sourceEnabled': "已把「{label}」设为可发布";
+    readonly 'panels.discover.sourceReadOnly': "已把「{label}」设为只读";
     readonly 'panels.discover.refresh': "刷新";
     readonly 'panels.discover.search': "搜索模块";
+    readonly 'panels.discover.clearSearch': "清除搜索";
     readonly 'panels.discover.all': "全部";
     readonly 'panels.discover.sourceLabel': "名字";
     readonly 'panels.discover.sourceKind': "类型";
@@ -326,7 +333,7 @@ export declare const zh: {
     readonly 'panels.discover.missingIndex': "仓库里还没有索引文件 {path}";
     readonly 'panels.discover.initTitle': "把这个仓库初始化成模块市场索引？";
     readonly 'panels.discover.initCta': "初始化成市场索引";
-    readonly 'panels.discover.initWhat': "会在 {branch} 分支写 market.json 与 README.md，提交一次并推上去；之后从这个工作台发布的模块会把打包好的文件提交到 packages/<unit>/。仓库的写权限归它的所有者。";
+    readonly 'panels.discover.initWhat': "会在 {branch} 分支写 market.json 与 README.md，提交一次并推上去；之后从这个工作台发布的模块会把打包好的文件提交到按包名分的 packages/<包名>/。仓库的写权限归它的所有者。";
     readonly 'panels.discover.initBranch': "分支";
     readonly 'panels.discover.initBranchHint': "索引和打包文件都发到这个分支；空仓库会新建它。";
     readonly 'panels.discover.initBranchBad': "分支名只能用字母、数字、点、下划线、斜杠或短横线";
@@ -636,6 +643,13 @@ export declare const zh: {
     readonly 'approval.publish.version': "版本";
     readonly 'approval.publish.author': "作者";
     readonly 'approval.publish.authorMissing': "未署名";
+    readonly 'approval.publish.owner': "认领人";
+    readonly 'approval.publish.ownerUnowned': "原来没署名";
+    readonly 'approval.publish.ownerTaken': "已有主人：{owner}";
+    readonly 'approval.publish.unit': "模块 id";
+    readonly 'approval.publish.unitTaken': "已被 {entry} 占用";
+    readonly 'approval.publish.path': "产物目录";
+    readonly 'approval.publish.pathTaken': "已被 {entry} 占用";
     readonly 'approval.publish.registry': "源";
     readonly 'approval.publish.repo': "仓库";
     readonly 'approval.publish.branch': "分支";
@@ -646,6 +660,7 @@ export declare const zh: {
     readonly 'approval.publish.twoCommits': "打包文件 + market.json 两次提交，一次推送";
     readonly 'approval.publish.reading': "读取中…";
     readonly 'approval.publish.changelog': "{version} 的更新日志";
+    readonly 'approval.publish.changelogPending': "{version} 这一版会写进更新日志，随包发布";
     readonly 'approval.publish.changelogMissing': "这一版还没有更新日志（{version}），发布会被拦下";
     readonly 'approval.publish.targetAuto': "按配置默认";
     readonly 'approval.publish.targetTeam': "团队源";
@@ -654,6 +669,15 @@ export declare const zh: {
     readonly 'approval.publish.targetGit': "git 仓库";
     readonly 'approval.publish.targetMarket': "模块市场索引";
     readonly 'approval.publish.targetLocal': "留在本机";
+    readonly 'approval.market.source': "索引源";
+    readonly 'approval.market.url': "地址";
+    readonly 'approval.market.action': "这次操作";
+    readonly 'approval.market.policy': "当前状态";
+    readonly 'approval.market.enable': "设为可发布";
+    readonly 'approval.market.disable': "改回只读";
+    readonly 'approval.market.writable': "可发布";
+    readonly 'approval.market.readOnly': "仅读取模块列表";
+    readonly 'approval.market.reading': "正在读取…";
     readonly 'markdown.copy': "复制";
     readonly 'markdown.copied': "已复制";
     readonly 'markdown.footnotes': "脚注";

package/dist/i18n/zh.js

@@ -289,12 +289,19 @@ export const zh = {
     'panels.discover.addingSource': '正在添加…',
     'panels.discover.addFirstSource': '添加索引源',
     'panels.discover.removeSource': '移除',
-    'panels.discover.removeSourceNamed': '移除 {url}',
-    'panels.discover.useSource': '使用',
-    'panels.discover.useSourceNamed': '使用 {label}',
-    'panels.discover.sourceCurrent': '当前使用',
+    'panels.discover.removeTitle': '移除这个索引源？',
+    'panels.discover.removeBody': '会把「{label}」从这份列表里移除；仓库本身不会被删，之后还能再添加。',
+    'panels.discover.sourceActions': '「{label}」的操作',
+    'panels.discover.sourceStateWritable': '可发布',
+    'panels.discover.sourceStateReadOnly': '仅读取模块列表',
+    'panels.discover.sourceEnable': '设为可发布',
+    'panels.discover.sourceDisable': '设为只读',
+    'panels.discover.sourceWorking': '设置中…',
+    'panels.discover.sourceEnabled': '已把「{label}」设为可发布',
+    'panels.discover.sourceReadOnly': '已把「{label}」设为只读',
     'panels.discover.refresh': '刷新',
     'panels.discover.search': '搜索模块',
+    'panels.discover.clearSearch': '清除搜索',
     'panels.discover.all': '全部',
     'panels.discover.sourceLabel': '名字',
     'panels.discover.sourceKind': '类型',
@@ -318,7 +325,7 @@ export const zh = {
     'panels.discover.missingIndex': '仓库里还没有索引文件 {path}',
     'panels.discover.initTitle': '把这个仓库初始化成模块市场索引？',
     'panels.discover.initCta': '初始化成市场索引',
-    'panels.discover.initWhat': '会在 {branch} 分支写 market.json 与 README.md，提交一次并推上去；之后从这个工作台发布的模块会把打包好的文件提交到 packages/<unit>/。仓库的写权限归它的所有者。',
+    'panels.discover.initWhat': '会在 {branch} 分支写 market.json 与 README.md，提交一次并推上去；之后从这个工作台发布的模块会把打包好的文件提交到按包名分的 packages/<包名>/。仓库的写权限归它的所有者。',
     'panels.discover.initBranch': '分支',
     'panels.discover.initBranchHint': '索引和打包文件都发到这个分支；空仓库会新建它。',
     'panels.discover.initBranchBad': '分支名只能用字母、数字、点、下划线、斜杠或短横线',
@@ -628,6 +635,13 @@ export const zh = {
     'approval.publish.version': '版本',
     'approval.publish.author': '作者',
     'approval.publish.authorMissing': '未署名',
+    'approval.publish.owner': '认领人',
+    'approval.publish.ownerUnowned': '原来没署名',
+    'approval.publish.ownerTaken': '已有主人：{owner}',
+    'approval.publish.unit': '模块 id',
+    'approval.publish.unitTaken': '已被 {entry} 占用',
+    'approval.publish.path': '产物目录',
+    'approval.publish.pathTaken': '已被 {entry} 占用',
     'approval.publish.registry': '源',
     'approval.publish.repo': '仓库',
     'approval.publish.branch': '分支',
@@ -638,6 +652,7 @@ export const zh = {
     'approval.publish.twoCommits': '打包文件 + market.json 两次提交，一次推送',
     'approval.publish.reading': '读取中…',
     'approval.publish.changelog': '{version} 的更新日志',
+    'approval.publish.changelogPending': '{version} 这一版会写进更新日志，随包发布',
     'approval.publish.changelogMissing': '这一版还没有更新日志（{version}），发布会被拦下',
     'approval.publish.targetAuto': '按配置默认',
     'approval.publish.targetTeam': '团队源',
@@ -646,6 +661,15 @@ export const zh = {
     'approval.publish.targetGit': 'git 仓库',
     'approval.publish.targetMarket': '模块市场索引',
     'approval.publish.targetLocal': '留在本机',
+    'approval.market.source': '索引源',
+    'approval.market.url': '地址',
+    'approval.market.action': '这次操作',
+    'approval.market.policy': '当前状态',
+    'approval.market.enable': '设为可发布',
+    'approval.market.disable': '改回只读',
+    'approval.market.writable': '可发布',
+    'approval.market.readOnly': '仅读取模块列表',
+    'approval.market.reading': '正在读取…',
     'markdown.copy': '复制',
     'markdown.copied': '已复制',
     'markdown.footnotes': '脚注',

package/dist/testing/needs.js

@@ -1,3 +1,4 @@
+import { unitTitleKey } from '../contract/unit.js';
 export const fakeNpmSource = {
     kind: 'npm',
     registryEnv: 'WB_TEST_REGISTRY',
@@ -23,9 +24,11 @@ export function envNeedOf(name, extra = {}) {
     return { kind: 'env', name, purpose: '测试', ...extra };
 }
 export function manifestOf(options = {}) {
+    const id = options.id ?? 'fixture';
     return {
-        id: options.id ?? 'fixture',
-        card: options.card === undefined ? { titleKey: `${options.id ?? 'fixture'}.mine`, order: 10 } : options.card,
+        id,
+        titleKey: unitTitleKey(id),
+        card: options.card === undefined ? { order: 10 } : options.card,
         tools: [],
         host: { inject: [] },
         ...(options.needs === undefined ? {} : { needs: options.needs }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",

package/src/contract/__tests__/unit-declaration.test.ts

@@ -79,6 +79,7 @@ describe('清单里的名字（v3 起名字在顶层，是字面量）', () => {
 
     expect(read.problems).toEqual([]);
     expect(read.manifest?.title).toEqual({ zh: '演示', en: 'Demo' });
-    expect(read.manifest?.card).toEqual({ titleKey: unitTitleKey('demo'), order: 7 });
+    expect(read.manifest?.titleKey).toBe(unitTitleKey('demo'));
+    expect(read.manifest?.card).toEqual({ order: 7 });
   });
 });

package/src/contract/__tests__/unit.test.ts

@@ -5,7 +5,7 @@ import { needsOf, provisionableNeedsOf, type UnitManifest } from '../unit.js';
 function manifest(needs?: readonly Need[]): UnitManifest {
   return {
     id: 'issues',
-    card: { titleKey: 'issues.mine', order: 10 },
+    titleKey: 'issues.mine', card: { order: 10 },
     tools: [],
     host: { inject: [] },
     ...(needs === undefined ? {} : { needs }),

package/src/contract/protocol/market-index.ts

@@ -56,6 +56,8 @@ export interface MarketIndexVersion {
 }
 
 export interface MarketIndexEntryMetadata {
+  readonly workbench?: boolean;
+  readonly unit?: string;
   readonly category?: string;
   readonly labels?: readonly string[];
   readonly keywords?: readonly string[];
@@ -67,12 +69,22 @@ export interface MarketIndexEntry {
   readonly title?: MarketLocalizedText;
   readonly description?: MarketLocalizedText;
   readonly author?: string;
+  readonly owner?: string;
   readonly homepage?: string;
   readonly icon?: string;
   readonly metadata?: MarketIndexEntryMetadata;
   readonly versions: readonly MarketIndexVersion[];
 }
 
+export type MarketClaim =
+  | { readonly state: 'new' }
+  | { readonly state: 'owned'; readonly owner: string }
+  | { readonly state: 'unowned' }
+  | { readonly state: 'conflict'; readonly owner: string }
+  | { readonly state: 'unit-taken'; readonly entry: string }
+  | { readonly state: 'path-taken'; readonly entry: string }
+  | { readonly state: 'unknown' };
+
 export interface MarketIndexCategory {
   readonly title?: MarketLocalizedText;
 }
@@ -114,7 +126,9 @@ export type MarketIndexProblemKind =
   | 'source'
   | 'git-commit'
   | 'timestamp'
-  | 'icon';
+  | 'icon'
+  | 'owner'
+  | 'unit';
 
 export interface MarketIndexProblem {
   readonly kind: MarketIndexProblemKind;
@@ -213,6 +227,7 @@ export interface PublishChangelog {
   readonly version: string;
   readonly text?: string;
   readonly missing?: boolean;
+  readonly pending?: boolean;
 }
 
 export interface PublishPreview {
@@ -221,6 +236,7 @@ export interface PublishPreview {
   readonly author?: string;
   readonly registry?: string;
   readonly market?: MarketPublishDestination;
+  readonly claim?: MarketClaim;
   readonly changelog?: PublishChangelog;
 }
 
@@ -245,4 +261,5 @@ export type MarketSourcesAction =
   | { readonly action: 'save'; readonly source: MarketSourceConfig; readonly select?: boolean }
   | { readonly action: 'remove'; readonly id: string }
   | { readonly action: 'select'; readonly id: string | null }
-  | { readonly action: 'init'; readonly id: string; readonly ref?: string };
+  | { readonly action: 'init'; readonly id: string; readonly ref?: string; readonly stampOnly?: boolean }
+  | { readonly action: 'read-only'; readonly id: string };

package/src/contract/unit-declaration.ts

@@ -298,13 +298,8 @@ export function readDeclaration(subject: string, raw: unknown): DeclarationRead
     manifest: {
       id,
       title: { zh: text(declaration.title.zh), en: text(declaration.title.en) },
-      card:
-        card === null
-          ? null
-          : {
-              titleKey: unitTitleKey(id),
-              order: card.order,
-            },
+      titleKey: unitTitleKey(id),
+      card: card === null ? null : { order: card.order },
       tools: declaration.tools.map((tool) => ({
         name: text(tool.name),
         writes: tool.writes,

package/src/contract/unit.ts

@@ -18,10 +18,9 @@ export function unitTitleKey(unit: string): string {
 }
 
 /**
- * 一张卡片在清单里的静态声明（文案键加排序位）；默认显不显示由运行期面板配置定。
+ * 一张卡片在清单里的静态声明：只剩排序位；显不显示由运行期面板配置定。
  */
 export interface UnitCard {
-  readonly titleKey: string;
   readonly order: number;
 }
 
@@ -50,11 +49,13 @@ export interface PluginRelease {
 }
 
 /**
- * 装配期用的模块清单：单元 id、名字、卡片、工具、宿主服务与环境需要，比声明少一层协议包装。
+ * 装配期用的模块清单：单元 id、名字、名字键、卡片、工具、宿主服务与环境需要，比声明少一层协议包装。
+ * titleKey 恒等于 unitTitleKey(id)：有没有卡片都指向同一个词表键，展示方照它取名字。
  */
 export interface UnitManifest {
   readonly id: string;
   readonly title?: UnitTitle;
+  readonly titleKey: string;
   readonly card: UnitCard | null;
   readonly tools: readonly UnitTool[];
   readonly host: UnitHostNeeds;

package/src/host/__tests__/changelog.test.ts

@@ -6,6 +6,7 @@ import {
   changelogSectionOf,
   changelogSkeleton,
   parseChangelog,
+  planChangelog,
 } from '../changelog.js';
 
 const SAMPLE = [
@@ -100,3 +101,35 @@ describe('changelogSkeleton', () => {
     expect(changelogSkeleton()).toBe('# 更新日志\n');
   });
 });
+
+describe('planChangelog', () => {
+  it('这一版已有内容就 kept，不追加也不改原文', () => {
+    const plan = planChangelog(SAMPLE, { version: '1.2.0', kind: 'fixed', note: '又修了一条' });
+    expect(plan?.action).toBe('kept');
+    expect(plan?.text).toBe(SAMPLE);
+    expect(plan?.section).toContain('模块详情能看说明与更新日志');
+    expect(plan?.section).not.toContain('又修了一条');
+  });
+
+  it('缺这一版且有 note 就 written：空文件从骨架起，段里就是这条', () => {
+    const plan = planChangelog('', { version: '0.1.0', kind: 'added', note: '第一次发布', date: '2026-10-27' });
+    expect(plan?.action).toBe('written');
+    expect(plan?.version).toBe('0.1.0');
+    expect(plan?.text.startsWith('# 更新日志')).toBe(true);
+    expect(plan?.section).toContain('- 第一次发布');
+    expect(changelogHasEntry(plan?.text ?? '', '0.1.0')).toBe(true);
+  });
+
+  it('缺这一版又没有 note 就 undefined（发布前先要一句话）', () => {
+    expect(planChangelog(SAMPLE, { version: '9.9.9', note: '   ' })).toBeUndefined();
+    expect(planChangelog('', { version: '9.9.9', note: '' })).toBeUndefined();
+  });
+
+  it('只有版本标题没有条目时算缺，补进去而不是再开一段', () => {
+    const empty = '# 更新日志\n\n## v0.2.0\n\n`2026-10-26`\n';
+    const plan = planChangelog(empty, { version: '0.2.0', kind: 'fixed', note: '修一条' });
+    expect(plan?.action).toBe('written');
+    expect(parseChangelog(plan?.text ?? '').filter((one) => one.version === '0.2.0')).toHaveLength(1);
+    expect(plan?.section).toContain('- 修一条');
+  });
+});

package/src/host/__tests__/market-index.test.ts

@@ -1,5 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import type { MarketIndex, MarketIndexEntry } from '../../contract/protocol/market-index.js';
+import { claimOf, claimOfEntry, entryOwnerOf, entryUnitOf, marketArtifactPath, samePublisher } from '../market-index-claim.js';
 import {
   filterMarketIndex,
   marketInstallTarget,
@@ -39,6 +40,13 @@ describe('parseMarketIndex', () => {
     expect(parsed.index.title).toEqual({ zh: '工作台模块' });
   });
 
+  it('★ metadata.workbench 是身份标记，labels 可以为空（不再靠 workbench 标签）', () => {
+    const parsed = parseMarketIndex(indexOf([entry({ metadata: { workbench: true } })]));
+    expect(parsed.ok).toBe(true);
+    if (!parsed.ok) return;
+    expect(parsed.index.plugins[0]?.metadata).toEqual({ workbench: true });
+  });
+
   it('format 不是 1 就整份拒', () => {
     const parsed = parseMarketIndex({ format: 2, plugins: [] });
     expect(parsed.ok).toBe(false);
@@ -78,6 +86,31 @@ describe('parseMarketIndex', () => {
     if (parsed.ok) return;
     expect(parsed.problems[0]?.kind).toBe('not-json');
   });
+
+  it('收下 owner，原样写回', () => {
+    const parsed = parseMarketIndex(indexOf([entry({ owner: '陈康 <kang@example.com>' })]));
+    expect(parsed.ok).toBe(true);
+    if (!parsed.ok) return;
+    expect(parsed.index.plugins[0]?.owner).toBe('陈康 <kang@example.com>');
+  });
+
+  it('owner 只收一行：带换行整份拒', () => {
+    const parsed = parseMarketIndex(indexOf([entry({ owner: '陈康\n<b>' })]));
+    expect(parsed.ok).toBe(false);
+    if (parsed.ok) return;
+    expect(parsed.problems[0]?.kind).toBe('owner');
+  });
+
+  it('收下 metadata.unit；不是合法模块 id 整份拒', () => {
+    const parsed = parseMarketIndex(indexOf([entry({ metadata: { unit: 'inventory' } })]));
+    expect(parsed.ok).toBe(true);
+    if (!parsed.ok) return;
+    expect(parsed.index.plugins[0]?.metadata?.unit).toBe('inventory');
+    const bad = parseMarketIndex(indexOf([entry({ metadata: { unit: 'Not A Unit' } })]));
+    expect(bad.ok).toBe(false);
+    if (bad.ok) return;
+    expect(bad.problems[0]?.kind).toBe('unit');
+  });
 });
 
 describe('upsertMarketEntry', () => {
@@ -101,6 +134,139 @@ describe('upsertMarketEntry', () => {
     expect(next.plugins[0]?.versions).toHaveLength(1);
     expect(next.plugins[0]?.versions[0]?.source.type).toBe('git');
   });
+
+  it('已有 owner 就翻不过来：后来的条目只加版本', () => {
+    const owned = upsertMarketEntry(
+      { format: 1, plugins: [entry({ owner: '甲 <a@example.com>' })] },
+      entry({ owner: '乙 <b@example.com>', versions: [{ version: '0.2.0', source: { type: 'npm' } }] }),
+    );
+    expect(owned.plugins[0]?.owner).toBe('甲 <a@example.com>');
+    expect(owned.plugins[0]?.versions[0]?.version).toBe('0.2.0');
+  });
+});
+
+describe('认领', () => {
+  const owned = entry({ owner: '陈康 <kang@example.com>' });
+
+  it('没有条目是 new，条目没 owner 也没 author 是 unowned', () => {
+    expect(claimOfEntry(undefined, '陈康')).toEqual({ state: 'new' });
+    expect(claimOfEntry(entry(), '陈康')).toEqual({ state: 'unowned' });
+  });
+
+  it('邮箱相同就算同一人，大小写不影响', () => {
+    expect(samePublisher('陈康 <KANG@example.com>', '陈康 <kang@example.com>')).toBe(true);
+  });
+
+  it('两边都有邮箱时邮箱说了算：姓名不同也算同一人', () => {
+    expect(samePublisher('陈康 <kang@example.com>', 'Kang Chen <kang@example.com>')).toBe(true);
+  });
+
+  it('只有一边有邮箱就比姓名：格式漂了也认', () => {
+    expect(samePublisher('陈康', '陈康 <kang@example.com>')).toBe(true);
+  });
+
+  it('姓名和邮箱都不同就是冲突', () => {
+    expect(claimOfEntry(owned, '乙 <yi@example.com>')).toEqual({
+      state: 'conflict',
+      owner: '陈康 <kang@example.com>',
+    });
+  });
+
+  it('原主自己发是 owned；没给身份时是 unknown', () => {
+    expect(claimOfEntry(owned, '陈康 <kang@example.com>')).toEqual({
+      state: 'owned',
+      owner: '陈康 <kang@example.com>',
+    });
+    expect(claimOfEntry(owned, '')).toEqual({ state: 'unknown' });
+  });
+
+  it('老条目只有 author：把它当 owner 认', () => {
+    const legacy = entry({ author: '陈康 <kang@example.com>' });
+    expect(entryOwnerOf(legacy)).toBe('陈康 <kang@example.com>');
+    expect(claimOf({ format: 1, plugins: [legacy] }, { name: '@scope/module-x', publisher: '陈康' })).toEqual({
+      state: 'owned',
+      owner: '陈康 <kang@example.com>',
+    });
+  });
+
+  it('别的条目用了同一个 unit：unit-taken；老条目从产物目录认出 unit', () => {
+    const other = entry({ name: '@scope/other', owner: '乙', metadata: { unit: 'inventory' } });
+    expect(claimOf({ format: 1, plugins: [other] }, { name: '@scope/module-x', publisher: '甲', unit: 'inventory' })).toEqual({
+      state: 'unit-taken',
+      entry: '@scope/other',
+    });
+    const legacy = entry({
+      name: '@scope/legacy',
+      versions: [
+        {
+          version: '0.1.0',
+          source: {
+            type: 'git',
+            url: 'https://git.company.com/wb/market.git',
+            commit: 'a'.repeat(40),
+            path: 'packages/inventory',
+          },
+        },
+      ],
+    });
+    expect(entryUnitOf(legacy)).toBe('inventory');
+    expect(claimOf({ format: 1, plugins: [legacy] }, { name: '@scope/module-x', publisher: '甲', unit: 'inventory' }).state).toBe(
+      'unit-taken',
+    );
+  });
+
+  it('同一个条目自己再用同 unit / 同产物目录，不算撞', () => {
+    const mine = entry({
+      owner: '甲',
+      metadata: { unit: 'inventory' },
+      versions: [
+        {
+          version: '0.1.0',
+          source: {
+            type: 'git',
+            url: 'https://git.company.com/wb/market.git',
+            commit: 'a'.repeat(40),
+            path: marketArtifactPath('@scope/module-x'),
+          },
+        },
+      ],
+    });
+    expect(
+      claimOf(
+        { format: 1, plugins: [mine] },
+        {
+          name: '@scope/module-x',
+          publisher: '甲',
+          unit: 'inventory',
+          artifactPath: marketArtifactPath('@scope/module-x'),
+        },
+      ).state,
+    ).toBe('owned');
+  });
+
+  it('别的条目占了同一个产物目录：path-taken', () => {
+    const other = entry({
+      name: '@scope/other',
+      owner: '乙',
+      versions: [
+        {
+          version: '0.1.0',
+          source: {
+            type: 'git',
+            url: 'https://git.company.com/wb/market.git',
+            commit: 'a'.repeat(40),
+            path: marketArtifactPath('@scope/module-x'),
+          },
+        },
+      ],
+    });
+    expect(
+      claimOf(
+        { format: 1, plugins: [other] },
+        { name: '@scope/module-x', publisher: '甲', unit: 'x', artifactPath: marketArtifactPath('@scope/module-x') },
+      ),
+    ).toEqual({ state: 'path-taken', entry: '@scope/other' });
+  });
 });
 
 describe('filterMarketIndex', () => {

package/src/host/changelog.ts

@@ -202,6 +202,25 @@ export function appendChangelogEntry(text: string, options: ChangelogEntryOption
   return `${normalizeWhitespace(out)}\n`;
 }
 
+export interface ChangelogPlan {
+  readonly action: 'kept' | 'written';
+  readonly version: string;
+  readonly text: string;
+  readonly section: string;
+}
+
+export function planChangelog(text: string, options: ChangelogEntryOptions): ChangelogPlan | undefined {
+  const source = normalizeChangelogText(text);
+  const version = changelogVersion(options.version);
+  const section = changelogSectionOf(source, version);
+  if (section !== undefined && changelogHasEntry(source, version)) {
+    return { action: 'kept', version, text: source, section };
+  }
+  if (bulletsOf(options.note).length === 0) return undefined;
+  const next = appendChangelogEntry(source, options);
+  return { action: 'written', version, text: next, section: changelogSectionOf(next, version) ?? '' };
+}
+
 function normalizeWhitespace(rows: readonly string[]): string {
   const out: string[] = [];
   for (const row of rows) {

package/src/host/market-index-claim.ts

@@ -0,0 +1,91 @@
+import type { MarketClaim, MarketIndex, MarketIndexEntry } from '../contract/protocol/market-index.js';
+
+export interface PublisherIdentity {
+  readonly name: string;
+  readonly email?: string;
+}
+
+function foldedName(name: string): string {
+  return name.replace(/\s+/gu, ' ').trim().toLowerCase();
+}
+
+export function publisherIdentityOf(text: string | undefined): PublisherIdentity | undefined {
+  const raw = (text ?? '').trim();
+  if (raw === '') return undefined;
+  const match = /^(.*?)\s*<([^<>]*)>\s*$/u.exec(raw);
+  const name = (match === null ? raw : match[1]).trim();
+  const email = match === null ? '' : match[2].trim().toLowerCase();
+  if (name === '') return undefined;
+  return email === '' ? { name } : { name, email };
+}
+
+export function samePublisher(left: string, right: string): boolean {
+  const a = publisherIdentityOf(left);
+  const b = publisherIdentityOf(right);
+  if (a === undefined || b === undefined) return false;
+  if (a.email !== undefined && b.email !== undefined) return a.email === b.email;
+  return foldedName(a.name) === foldedName(b.name);
+}
+
+export function entryOwnerOf(entry: MarketIndexEntry): string | undefined {
+  const owner = (entry.owner ?? '').trim();
+  if (owner !== '') return owner;
+  const author = (entry.author ?? '').trim();
+  return author === '' ? undefined : author;
+}
+
+export function claimOfEntry(entry: MarketIndexEntry | undefined, publisher: string | undefined): MarketClaim {
+  if (entry === undefined) return { state: 'new' };
+  const owner = entryOwnerOf(entry);
+  if (owner === undefined) return { state: 'unowned' };
+  if (publisher === undefined || publisher.trim() === '') return { state: 'unknown' };
+  return samePublisher(owner, publisher) ? { state: 'owned', owner } : { state: 'conflict', owner };
+}
+
+export interface MarketClaimInput {
+  readonly name: string;
+  readonly publisher: string | undefined;
+  readonly unit?: string | undefined;
+  readonly artifactPath?: string | undefined;
+}
+
+export function marketArtifactPath(name: string): string {
+  return `packages/${name}`;
+}
+
+export function entryUnitOf(entry: MarketIndexEntry): string | undefined {
+  const unit = entry.metadata?.unit?.trim();
+  if (unit !== undefined && unit !== '') return unit;
+  for (const version of entry.versions) {
+    if (version.source.type !== 'git') continue;
+    const match = /^packages\/([^/]+)$/u.exec(version.source.path ?? '');
+    const legacy = match?.[1];
+    if (legacy !== undefined) return legacy;
+  }
+  return undefined;
+}
+
+export function claimOf(index: MarketIndex, input: MarketClaimInput): MarketClaim {
+  const base = claimOfEntry(
+    index.plugins.find((one) => one.name === input.name),
+    input.publisher,
+  );
+  if (base.state === 'conflict' || base.state === 'unknown') return base;
+  const unit = (input.unit ?? '').trim();
+  if (unit !== '') {
+    for (const other of index.plugins) {
+      if (other.name === input.name) continue;
+      if (entryUnitOf(other) !== unit) continue;
+      return { state: 'unit-taken', entry: other.name };
+    }
+  }
+  const path = (input.artifactPath ?? '').trim();
+  if (path !== '') {
+    for (const other of index.plugins) {
+      if (other.name === input.name) continue;
+      if (!other.versions.some((one) => one.source.type === 'git' && (one.source.path ?? '') === path)) continue;
+      return { state: 'path-taken', entry: other.name };
+    }
+  }
+  return base;
+}