diff --git a/packages/bailian-kb-dsh/src/index.ts b/packages/bailian-kb-dsh/src/index.ts
index 6489521..c7f3508 100644
--- a/packages/bailian-kb-dsh/src/index.ts
+++ b/packages/bailian-kb-dsh/src/index.ts
@@ -186,11 +186,11 @@ export const Config: z<Config> = z.object({
 });
 
 /**
- * Register the three knowledge tools over one shared client, plus the
+ * Register the two knowledge tools over one shared client, plus the
  * management skill when a skills registry is composed. The Config doubles as
  * the `bailian-kb` settings section (entry config as the base layer), so
  * every value is read through the live source thunk per call — tool schemas
- * are static (agent_id stays optional regardless), so a settings edit needs
+ * are static (agent_id stays required regardless), so a settings edit needs
  * no re-registration.
  * @param ctx - registrant context carrying tools and credentials.
  * @param config - deployment's workspace, host, pinning, and timeout choices.
diff --git a/packages/bailian-kb-dsh/src/web/bailian-card-controller.ts b/packages/bailian-kb-dsh/src/web/bailian-card-controller.ts
index ac8a431..5470fad 100644
--- a/packages/bailian-kb-dsh/src/web/bailian-card-controller.ts
+++ b/packages/bailian-kb-dsh/src/web/bailian-card-controller.ts
@@ -177,7 +177,7 @@ export class BailianCardController {
   private readonly store: SnapshotStore<BailianCardState>;
 
   /**
-   * @param api - wire face used for the three credential references.
+   * @param api - wire face used for the four credential references.
    */
   constructor(private readonly api: Pick<IApiClient, "credentials">) {
     this.store = createSnapshotStore<BailianCardState>({
@@ -625,7 +625,7 @@ export class BailianCardController {
   }
 
   /**
-   * Ask the credentials domain about all three references and publish the
+   * Ask the credentials domain about all four references and publish the
    * answer. A failed read keeps the last known state: the page stays usable
    * and a write still reaches the Host.
    */